OpenUSD_Prim_Binding

Mapped https://mapped.com/schema/mapped/1.0/openusd#OpenUSD_Prim_Binding

A reified binding from a semantic vertex to one prim address in one layer. It exists because relationships carry no property bag and the association needs its own identity, provenance and validity window. Its properties describe the association (where it points, what it expects to find, whether it may drive pose), never intrinsic prim facts. A binding with hasLODItem edges is a level-of-detail root; an item binding is owned through its root.

Propose a change

Hierarchy

Parent classes: OpenUSD_Concept

Subclasses: none, this is a leaf class.

Facts

Fact	Value
URI	https://mapped.com/schema/mapped/1.0/openusd#OpenUSD_Prim_Binding
Source	Mapped
Protobuf	OPEN_USD_PRIM_BINDING
Deprecated	No

Properties

Property	Type	Required	Default	Description
coordinateFrameId	string			Opaque reference into the external coordinate frame registry, matching the Frame_Geometry decision that frames resolve outside the Mapped graph. On a Representation it is optional: absent means the subject entity's own frame.
description	string
isAuthoritativeForPose	boolean	Yes	false	Whether physical systems may consume this binding for pose. Normally false. At most one authoritative binding per entity and instant; it requires openUSDPurpose default and a coordinateFrameId exactly coincident with the composed prim-local basis.
lodDefaultIndex	integer		0	Level-of-detail roots only. Index of the item used when no supported heuristic yields a usable result; must name an existing item. Emitted as lod:default:index.
lodIndex	integer			Level-of-detail items only; required when the target of hasLODItem. Authored, zero-based ordering position under the root. Not emitted to USD: the projection authors child order from it. Not the currently selected level.
lodOverrideIndex	double			Requested index for an indexed override; meaningful only with lodOverrideMode indexedLOD. A number, not an integer: USD permits fractional indices for blending. Emitted as lod:override:index.
lodOverrideMode	string			Overrides heuristic selection for descendant level-of-detail roots, in USD's spelling: inherited, noOverride, indexedLOD, noLOD or allLOD. Applies UsdLodOverrideAPI to the bound prim; emitted as lod:override:mode.
lodValidThroughIndex	integer			Coarsest level-of-detail index at which this binding still resolves, for a prim dropped from collapsed lower-detail assets such as a wheel or an articulated part. Indices increase as detail decreases, so 0 means the binding exists only in the highest-detail item. Absent means the binding is valid wherever its prim path resolves. Assumes validity is contiguous from index 0; a prim absent at one level but present at a coarser one needs a set rather than a ceiling. Distinguished from lodIndex, which identifies an item, and lodDefaultIndex, which selects a fallback.
name	string
openUSDPurpose	string			USD purpose token in USD's spelling: default, render, proxy or guide. A render-visibility filter authored on the prim, so it lives on the binding. Render and proxy geometry need no representation class; they are purposes here.
primPath	string	Yes		Absolute Sdf prim path, e.g. /HallA/Row01/Rack001. Carries USD namespace hierarchy implicitly; the identity of a bound prim is the pair (primPath, resolvesInLayer), never the path alone.
primTypeName	string			Composed prim type the binding requires, e.g. Xform, Mesh, Cube. An expectation checked at resolve time, not an observed fact.
requiredAPISchemas	Array<string>			API schemas the binding requires on the composed prim, e.g. PhysicsCollisionAPI, LODRootAPI. An expectation, not an observation.
validFrom	dateTime			Start of validity.
validThrough	dateTime			End of validity.
variantSelections	string			Variant selections applied at resolve time, each naming a variantSet and selection on a primPath; primPath omitted means the bound prim. Replaces separate variant-set and variant classes: Mapped selects variants as policy rather than mirroring USD structure.

exactType is always OpenUSD_Prim_Binding.

Inherited properties (5)

Property	Type	Required	Default	Description
connectorIds	Array<string>			The ids of the connectors associated with the entity.
dateCreated	dateTime			Datetime when it is created.
dateUpdated	dateTime			Datetime when it is updated last time.
id	string	Yes		A globally unique ID in Mapped services.
organizationId	string	Yes		The id of the organization that owns the entity.

Relationships

Relationship	Targets	Inverse	Cardinality	Notes
hasLODHeuristic	OpenUSD_LOD_Heuristic	isLODHeuristicOf	0..*	transitive, canonical Associates a level-of-detail root binding with a heuristic definition; maps to lod:heuristics. Several per root, one per domain.
hasLODItem	OpenUSD_Prim_Binding	isLODItemOf	0..*	transitive, canonical Declares the target binding an immediate level-of-detail item of the source root binding. Authoring information, not emitted as a USD relationship: the projection sorts targets by lodIndex and authors that child order, applying UsdLodRootAPI to the root prim. In v1 an item belongs to exactly one root.
isLODBoundingVolumeOf	OpenUSD_LOD_Heuristic	hasLODBoundingVolume	0..*	The heuristics governed by this prim's extent.
isLODItemOf	OpenUSD_Prim_Binding	hasLODItem	0..*	The level-of-detail root this item belongs to.
isPrimBindingOf	OpenUSD_LOD_Heuristic, Entity, Representation, Kinematic_Joint	hasPrimBinding	0..*	The entity, representation or heuristic this binding addresses a prim for.
resolvesInLayer	OpenUSD_Layer	resolvesPrimBinding	1..1	transitive, canonical The layer a binding resolves through. Normative: open a stage with this layer as the root layer under the resolver context, load, population and variant policy of its schemaProfile, then evaluate the binding against the composed prim at primPath. Layers are durable; runtime stages are never vertices.

Inherited relationships (1)

Relationship	Targets	Inverse	Cardinality	Notes
contributesProperty	Meta	hasPropertyContributedFrom	0..*	transitive, canonical Mapped's internal relationship indicating that a vertex is contributing a property/value to another vertex.

Referenced by

Classes whose own relationships point at OpenUSD_Prim_Binding.

• hasLODBoundingVolume (1): OpenUSD_LOD_Heuristic
• hasLODItem (1): OpenUSD_Prim_Binding
• hasPrimBinding (4): Entity, Kinematic_Joint, OpenUSD_LOD_Heuristic, Representation
• isLODHeuristicOf (1): OpenUSD_LOD_Heuristic
• isLODItemOf (1): OpenUSD_Prim_Binding
• resolvesPrimBinding (1): OpenUSD_Layer

Something wrong or missing on this page? Propose a change to OpenUSD_Prim_Binding.