Overview#

The omni.kit.property.adapter.fabric extension enables the Property Window to read and write attributes to Fabric stages by providing adapter classes that translate between USDRT data types and USD Python API equivalents.

Concepts#

Fabric stages use a different runtime representation (USDRT) that requires special handling to work with existing USD-based property tools. This extension bridges that gap by wrapping USDRT objects with adapter classes that present a familiar USD interface while maintaining compatibility with Fabric’s high-performance data structures.

Functionality#

Adapter classes create a unified interface that allows property window components to work seamlessly with both traditional USD stages and high-performance Fabric stages. The extension provides three core adapters:

FabricStageAdapter - Wraps usdrt.Usd.Stage objects to present them as standard USD stages
FabricPrimAdapter - Adapts usdrt.Usd.Prim objects for compatibility with USD property workflows
FabricAttributeAdapter - Handles usdrt.Usd.Attribute and usdrt.Usd.Relationship objects and their property operations

Data type conversion handles the translation between USDRT types (vectors, matrices, paths, quaternions) and their USD Python API counterparts through the [convert_usdrt_to_usd](omni.kit.property.adapter.fabric/omni.kit.property.adapter.fabric.convert_usdrt_to_usd) function. This conversion preserves data integrity while ensuring compatibility across different property editing workflows.

Priority-based processing allows configuration of read and write priorities through extension settings, enabling fine-tuned control over how Fabric adapters interact with other property adapters in the system.

Relationships#

This extension depends on omni.kit.property.adapter.core for the base adapter interfaces and registration system. It integrates with omni.usd for USD context management and uses usdrt.scenegraph for accessing Fabric stage data structures.