Animated Map¶
One conditional table of an Animated Maps node, and its value.
| Node type | RigExecAnimatedMap |
| Example | animated_maps.usda |
On this page:
Overview¶
One map of its parent RigExecAnimatedMaps: parallel arrays of
rows (rigExec:rowInputs, rowFrom, rowTo, rowSlope, rowCut), the
primvar name its value is published under, and rigExec:clampOutput, whether
the sum is clamped to [0, 1] (true, RigLogic's rule) or published as is
(false).
One map of its parent RigExecAnimatedMaps, a conditional table. Each row reads input x = rigExec:driverAttributes[rowInputs[r]] and adds rowSlope[r] * x + rowCut[r] when rowFrom[r] <= x <= rowTo[r] (a reversed interval is swapped). Among consecutive rows on the same input only the first whose interval holds x contributes, so intervals sharing an endpoint count it once. The sum is clamped to [0, 1] unless rigExec:clampOutput is false.
How it works¶
Evaluated by its parent; see Animated Maps.
Wiring¶
| Relationship | Points to | Required |
|---|---|---|
outputs:value |
The map's value; connectable like a pose weight. | - |
Parameters¶
Node parameters¶
rigExec:clampOutput¶
Type: uniform bool. Default: true.
Whether the map's sum is clamped to [0, 1], RigLogic's rule. False publishes the sum as is, so a table of slope-0 rows (a step function) can carry any value to a property mover or blend input.
rigExec:rowInputs¶
Type: uniform int[]. Default: [].
Each row's input, an index into the parent's inputs.
rigExec:rowFrom¶
Type: uniform float[]. Default: [].
Each row's interval start.
rigExec:rowTo¶
Type: uniform float[]. Default: [].
Each row's interval end.
rigExec:rowSlope¶
Type: uniform float[]. Default: [].
Each row's slope.
rigExec:rowCut¶
Type: uniform float[]. Default: [].
Each row's intercept.
rigExec:primvarName¶
Type: uniform token. Default: "".
The primvar this map publishes on the parent's meshes, without the primvars: namespace. Empty uses the prim's name.
outputs:value¶
Type: float. Default: 0.
The map's value for the current pose.
Example¶
In the Animated Maps example frown has two rows on different
inputs, so both count and their sum is clamped; foreheadL and foreheadR
have one row each.
Open it live with:
Tips¶
- An empty
rigExec:primvarNamepublishes under the map's prim name. - For a step table set
rigExec:clampOutputfalse and author slope-0 rows: the first matching row of a same-input run wins a shared bound, and a shared bound is rounded to float toward the losing cell, so the winner's row holds the exact tie (see Animated Maps). - RigLogic behaviours covers the tables and their provenance.