Skip to content

Bone Frame Bone Frame

Evaluates joint channels with explicit scale and location inheritance.

Node type RigExecBoneFrame

On this page:

Overview

Separate the rotation/scale parent map from the location map when a joint inherits them differently.

Joint channels with separate rotation/scale and location inheritance. Channel rotations are XYZ degrees; matrices use row vectors. The object provider places the evaluated pose in target space.

How it works

XYZ channel rotations are degrees. local and parentRest are saved joint-space transforms; sourceObject places the evaluated frame in target space. Inheritance supports FULL, NONE, AVERAGE, ALIGNED, FIX_SHEAR and NONE_LEGACY. Connected joints suppress channel translation. spaceKind selects the full pose or the rotation/translation parent map.

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:parent Live parent joint frame. no
rigExec:sourceObject Live object frame. no
rigExec:poseInputs All consumed frame providers. yes

Parameters

Node parameters

inputs:spaceKind

Type: uniform token. Default: "pose".

outputs:matrix

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

inputs:local

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

inputs:parentRest

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

inputs:hasParent

Type: uniform bool. Default: false.

inputs:inheritRotation

Type: uniform bool. Default: true.

inputs:localLocation

Type: uniform bool. Default: true.

inputs:connected

Type: uniform bool. Default: false.

inputs:inheritScale

Type: uniform token. Default: "FULL".

inputs:tx

Type: double. Default: 0.

inputs:ty

Type: double. Default: 0.

inputs:tz

Type: double. Default: 0.

inputs:rx

Type: double. Default: 0.

inputs:ry

Type: double. Default: 0.

inputs:rz

Type: double. Default: 0.

inputs:sx

Type: double. Default: 1.

inputs:sy

Type: double. Default: 1.

inputs:sz

Type: double. Default: 1.

rigExec:parent

Relationship.

rigExec:sourceObject

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

Set local translation to (0,1,0), tx to 2, and sourceObject to an object translated 2 in X. With no parent, the full pose origin is (4,1,0). Connect the output to a joint's posed:space.

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