polyxios.read_scene#

polyxios.read_scene(path: str | PathLike[str] | IO[Any], *, fmt: str | None = None, registry: dict | None = None, **opts: object) → SceneData[source]#

Read a scene-graph file and return a SceneData.

Parameters:

path: Path to the scene file (e.g. .gltf or .glb).
fmt: Format override (e.g. '.glb'). Inferred from the file extension when None.
registry: Custom codec registry. Uses the built-in registry if None.
**opts: Format-specific options passed to the codec’s read_scene function.

Returns:

SceneData: Full scene graph with meshes, nodes, materials, textures, and images.

Raises:

UnsupportedFormatError: If the format does not carry scene data. Use read() for flat single-mesh formats.