combining-scene-with-runtime-prims

Combine a base USD scene with inline runtime prims via subLayers composition.

201|25|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/ovrtx --skill combining-scene-with-runtime-prims
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: combining-scene-with-runtime-prims
Source: https://github.com/NVIDIA-Omniverse/ovrtx/tree/main/tests/docs/skills/sublayer-test-scenes
Command: npx skills add https://github.com/NVIDIA-Omniverse/ovrtx --skill combining-scene-with-runtime-prims

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ovrtx docs tests often need to combine a base USD scene with doc-specific prims such as RenderProduct or RenderVar, without duplicating the entire scene. The inline root layer approach keeps the base content intact while adding needed prims in the same root layer.

Core Features & Use Cases

  • Inline root USD string pattern that uses subLayers = [@/path/to/base_scene.usda@] to incorporate the base scene content and author the extra doc-specific prims in the same root layer.
  • Works with Python open_usd_from_string() or C ovrtx_open_usd_from_string() to load the single composed stage for testing.
  • Reduces test snippet complexity by enabling a single-root, composed scene for documentation examples.

Quick Start

Load an inline root USD that sublayers the base scene and any runtime prims, using a string loaded with open_usd_from_string (Python) or ovrtx_open_usd_from_string (C).

Frequently Asked Questions about combining-scene-with-runtime-prims

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add runtime prims to a USD scene without duplicating the base content?

You can add runtime prims by building an inline root USDA string with a subLayers composition that references the base scene, then loading it via open_usd_from_string to keep the base content intact.

How does the subLayers composition pattern work for combining USD scenes?

The subLayers pattern incorporates a base USD scene by setting subLayers = [@/path/to/base_scene.usda@] in an inline root layer, allowing you to author additional doc-specific prims in the same root layer.

Can I load a USD stage from an inline string in Python or C?

Yes, you can load a single composed stage from an inline string using open_usd_from_string in Python or ovrtx_open_usd_from_string in C.

What is the best way to test USD documentation snippets that require RenderProduct or RenderVar prims?

The best way is to use an inline root USD layer that sublayers the base scene and adds the required runtime prims, reducing test snippet complexity by enabling a single-root, composed scene.

When do I need to use an inline root layer for USD tests?

You need an inline root layer when documentation tests require runtime prims like RenderProduct or RenderVar that are not present in the original base USD scene.

Does combining scene with runtime prims require any external dependencies?

No external dependencies are required. This pattern relies solely on building an inline USDA string and loading it with open_usd_from_string or ovrtx_open_usd_from_string.