Skip to content

Cross-domain inputs

The one-loop evaluator binds every computed input to a typed producer value. Property revisions can read pose matrices and selected geometry points. A Ribbon can read a revised driver curve. Volume and curve weights can read revised sample targets and curves.

Author rigExecReadPhase on the consuming attribute or relationship:

Value Selected producer
base or absent Authored property/points version zero; pose frame after solvers and before movers
preceding The value entering the consumer on its own chain, otherwise the last stack writer below it
final Last version of the named producer
Absolute prim path Newest usable version written at or below that prim

Connections retain typed traversal and input overrides. A matrix input connected to a provider's posed:space reads its asset-space frame matrix. There is no implicit points-array-to-vector conversion. To read one point, author a nonnegative integer rigExecInputElement on the consuming float3 attribute:

float3 inputs:value = (0, 0, 0) (
    rigExecInputElement = 1
    rigExecReadPhase = "final"
)
float3 inputs:value.connect = </Asset/Geom/Curve.points>

The array must contain the selected element in the current generation. A negative index or metadata on a different input type is rejected at compile. An unavailable producer or a shorter array produces a diagnostic naming the consumer, source and index and uses the existing typed input fallback. It never reuses a value from an earlier generation. Restoring the source count restores the read without changing the authoring contract. Selecting scalar components is not part of this contract.

On a Ribbon, put the phase on rigExec:driverCurve. Its driver uses the selected points version; the rest projection still uses authored default points. On weight objects, put it on rigExec:weightTarget, rigExec:sampleSource, or rigExec:curve. Explicit metadata selects that producer; unannotated weight inputs retain their original raw sampling and source fallback behavior. A declared missing producer differs from an available empty array.

All reads become ordinary edges in the same producer graph. Reverse reads such as geometry to property or geometry to Ribbon are allowed when that graph is acyclic. The common cycle diagnostic identifies a loop through property, pose, geometry or weights and sets aside its cyclic operators; independent operations still run. Exact output equality cuts off downstream work even when an upstream array changes outside the selected element. Compiled and binary execution consume value IDs and typed storage; operation bodies do not query the source stage.