Skip to content

Mapped Frame Mapped Frame

Transfers source rest-to-pose motion onto a target rest frame.

Node type RigExecMappedFrame

On this page:

Overview

A saved source/target rest pair makes the mapping explicit.

Maps a live source pose onto a target rest frame: targetRest * inverse(sourceRest) * source.

How it works

The row-vector result is targetRest * inverse(sourceRest) * source. Connect outputs:matrix to a joint or control's posed:space. Declare every frame provider the expression reads in rigExec:poseInputs, including object frames, parents and multi-target inputs. The relationship supplies pose dependency ordering and invalidation; the specific source/parent relationships supply numerical inputs. Keep the provider's rest frame separate from its evaluated pose.

These computations are operations in the shared evaluation graph: native evaluation, frame-cache workers and the .rigexec runtime run the same stage-free kernels from the provider's declared inputs, so editing an input re-runs the providers that read it and their dependents.

Wiring

Relationship Points to Required
rigExec:source Live source frame. yes
rigExec:poseInputs All consumed frame providers. yes

Parameters

Node parameters

outputs:matrix

Type: matrix4d. Default: ((1,0,0,0),(0,1,0,0),(0,0,1,0),(0,0,0,1)).

inputs:targetRest

Type: matrix4d. Default: ((1,0,0,0),(0,1,0,0),(0,0,1,0),(0,0,0,1)).

inputs:sourceRest

Type: matrix4d. Default: ((1,0,0,0),(0,1,0,0),(0,0,1,0),(0,0,0,1)).

rigExec:source

Relationship.

rigExec:poseInputs

Relationship.

All frame providers read by this expression, including object, parent, source and multi-target providers. Required for pose dependency ordering and invalidation; this list does not change the numerical inputs.

Example

An identity sourceRest, a targetRest translated one unit in Y, and a live source translated two units in X produce origin (2,1,0).

Tips

  • Keep rest and pose frames distinct; connecting a live matrix to rest:space changes the rest-to-pose map.
  • List every consumed provider in rigExec:poseInputs when using an affine frame expression.

See also


UsdRig