`simvx.core.scene`¶

Scene serialization — save/load node trees as JSON or pickle.

Both backends serialize to the same plain-dict intermediate format. Pickle stores the dict (not raw Node objects), avoiding class-path brittleness and GPU state issues.

Public API: save_scene(node, path) # format inferred from extension (.py/.json/.pkl) load_scene(path, format=None) # auto-detects from extension

Module Contents¶

Classes¶

PackedScene

Reusable scene resource that loads once and can be instanced many times.

Functions¶

`save_scene`	Save a node tree to disk.
`load_scene`	Load a node tree from disk.

Data¶

`log`
`CURRENT_FORMAT_VERSION`
`MIGRATIONS`

API¶

simvx.core.scene.log[source]¶: ‘getLogger(…)’

simvx.core.scene.CURRENT_FORMAT_VERSION¶: 1

simvx.core.scene.MIGRATIONS: dict[tuple[int, int], collections.abc.Callable[[dict], dict]]¶: None

simvx.core.scene.save_scene(node: simvx.core.node.Node, path: str | pathlib.Path, format: str | None = None)[source]¶

Save a node tree to disk.

Scenes are Python. When saving a scene, use a .py extension so the format auto-detects as "python" and the tree is emitted as Python source (the editor’s canonical scene format). "json" and "pickle" remain available for non-scene serialization (save files, checkpoints).

Args: node: Root node to serialize. path: Output file path. format: "python", "json", or "pickle". If None (default), inferred from the path’s extension.

simvx.core.scene.load_scene(path: str | pathlib.Path, format: str | None = None) → simvx.core.node.Node[source]¶

Load a node tree from disk.

For .py scene files, imports the module and instantiates the primary Node subclass. .json / .pkl are supported for save-file deserialization.

Args: path: Input file path. format: "python", "json", "pickle", or None to auto-detect from extension.

Returns: Reconstructed root Node.

class simvx.core.scene.PackedScene(path: str | pathlib.Path)[source]¶