OpenUSD_Layer
Mapped https://mapped.com/schema/mapped/1.0/openusd#OpenUSD_Layer
A durable, resolvable OpenUSD artifact. Root layers additionally carry the stage metadata (units, up axis, handedness, time-code rate), which is where USD stores it. Runtime stages, prims and coordinate frames are deliberately not modelled; bindings resolve in a layer.
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_Layer |
| Source | Mapped |
| Protobuf | OPEN_USD_LAYER |
| Deprecated | No |
Properties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
contentHash | string | Content digest with algorithm prefix, e.g. sha256:<hex>. A resolved digest must match it. | ||
description | string | |||
glassMaterialPaths | Array<string> | Absolute Sdf paths of authored materials a renderer should treat as reviewed transparent glass, lenses, or display covers, so that clearance helpers are not classified as glass merely for having low authored opacity. Paths rather than names because material names are not unique across scopes under composition. Which materials count as reviewed glass is a Mapped curation decision OpenUSD cannot express. | ||
glassMinimumOpacity | double | Minimum presentation opacity applied to the materials named by glassMaterialPaths, preventing physically present glass from becoming invisible after renderer transparency processing. Between 0 and 1 inclusive; 0 permits full transparency and 1 forces opacity. Renderer policy rather than a fact about the layer, admitted here because the graph must drive it. | ||
mimeType | Object | |||
name | string | |||
openUSDAssetIdentifier | string | OpenUSD resolver identifier of the layer: a URI, URN, repository key or other identifier understood by the configured resolver. Must be absolute, canonical or otherwise context-independent; authored relative paths stay inside USD. Not named assetIdentifier because asset already means physical equipment in this ontology; not filePath because a URN names content rather than locating a file. | ||
openUSDHandedness | string | Coordinate system handedness: RIGHT_HANDED or LEFT_HANDED. Required at the fusion boundary. | ||
openUSDKilogramsPerUnit | double | Mass scale in kilograms per authored unit. Root layers only. | ||
openUSDMetersPerUnit | double | Linear scale in metres per authored unit. Root layers only; UsdStage::GetMetersPerUnit() reads the root layer. | ||
openUSDTimeCodesPerSecond | double | USD time-code rate. v1 bindings resolve only the static composed transform at the default time code; a rate is not a timeline mapping. | ||
openUSDUpAxis | string | Authored up axis: Y or Z. Root layers only. | ||
resolverContext | string | Non-secret resolver context identifier under which the layer's asset identifiers resolve. | ||
schemaProfile | string | Versioned Mapped/Fusion OpenUSD profile the layer conforms to. Declares the resolver context, load, population and variant policy used when resolvesInLayer opens a stage. |
exactType is always OpenUSD_Layer.
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 |
|---|---|---|---|---|
hasFile | File | 0..* | transitive, canonical | |
hasFileSize | FileSize | 0..1 | transitive, canonical | |
isGeneratedFrom | Entity | hasGeneratedArtifact | 0..* | transitive, canonical Provenance for a converted or generated layer, e.g. from an IFC or DWG File or a floorplan. mapped:isDerivedFrom is not reused because it is defined as Point value lineage. |
isReferencedByLayer | OpenUSD_Layer | referencesLayer | 0..* | The layers that depend on this layer. |
referencesLayer | OpenUSD_Layer | isReferencedByLayer | 0..* | transitive, canonical Dependency on another durable layer, covering sublayer, reference and payload arcs with one predicate. Kept for impact analysis, pinning and cache warming, which are arc-kind agnostic. |
resolvesPrimBinding | OpenUSD_Prim_Binding | resolvesInLayer | 0..* | The bindings that resolve through this layer. |
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_Layer.
- hasGeneratedArtifact (1): Entity
- isReferencedByLayer (1): OpenUSD_Layer
- referencesLayer (1): OpenUSD_Layer
- resolvesInLayer (1): OpenUSD_Prim_Binding
Something wrong or missing on this page? Propose a change to OpenUSD_Layer.