open_scene
Opens a USD file as the active stage, replacing the current scene and discarding unsaved changes. Use it to load a scene from disk, URL, or asset library before editing or saving.
Instructions
Open a USD file as the stage, in place of the open one, which goes with its unsaved changes.
Use it to work on a scene from a file; new_scene starts an empty stage instead, and save_scene writes the open one, so call save_scene first to keep it. Opening the stage's own file reloads it from disk. It stops the simulation first; a recording that runs stops taking frames, and draw_debug's drawings go. Refused, with the open stage kept, for a file that isn't there or can't be reached, a type USD doesn't open, a local file that holds no USD (a Git LFS pointer, say), or while Kit opens or closes a stage. A file that passes those checks and still fails to load leaves no stage open, and the error says so; an open that takes over 80 s goes on in Kit after the error. Answers the path opened, the stage it replaced, and the stage's up axis, meters_per_unit, default prim and prim count, with a note for an axis or units the file leaves to USD's fallbacks.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | The USD file: a path on Kit's machine, a relative one read from the folder Kit was started in; a URL (omniverse://, https://, file:///); or a path in Isaac Sim's asset library (/Isaac/...) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |