Skip to content

Layered Skin Mover Layered Skin Mover

Applies masked linear or dual-quaternion skin over a point revision.

Node type RigExecLayeredSkinMover

On this page:

Overview

Supports sequential skin revisions with explicit candidate and incoming point spaces.

Masked linear or dual-quaternion skin revision. Candidate skin input may be the base or incoming points. transformInput maps incoming points before mask blending; influences produce candidate points. The common mover envelope remains independent. A .rigexec plays it through the mover's runtime kernel, which usdview playback takes from the mover registry and a standalone host supplies at Open.

How it works

The influence palette skins incoming points, or base points when useBaseInput. transformInput separately maps incoming points through rigExec:transform before blending the candidate by inputs:mask. The common mover envelope then applies independently. Empty masks mean full strength; populated masks have one finite [0,1] value per point. Joint index and weight arrays follow the elementSize skin layout.

The computation and handler live in core. A .rigexec export carries it as an external revision: its playback kernel rebuilds the skin from the declared inputs and the influence frames playback evaluated, so playback matches native evaluation. A host that plays the file supplies that kernel; without it the revision passes its points through.

Wiring

Relationship Points to Required
rigExec:moves One exact point3f[] points property. yes
rigExec:influences Native joint/control influence providers. yes
rigExec:transform Incoming point map when transformInput is enabled. no

Parameters

Common mover envelope

rigExec:moves

Relationship.

Reserved write-set relationship: exact prim/property targets.

inputs:enabled

Type: bool. Default: true.

Shape-preserving enable. Disabled movers pass their preceding revision through unchanged (value-only edit).

inputs:defaultWeight

Type: float. Default: 1.

Normalized common mover envelope in [0, 1]. With no bound rigExec:weightObject it broadcasts over every logical element: zero passes the incoming value through bit-for-bit and one applies the mover's full-strength result. A non-finite value or one outside [0, 1] passes the incoming value through with a diagnostic.

rigExec:weightObject

Relationship.

Optional compatible total weight field, at most one target. When bound, the weight object's values (including its own sparse or constant fallback) supply the common envelope instead of inputs:defaultWeight. Target, domain, and cardinality must match each mover application; an incompatible binding is a compile error. A multi-target mover may bind only a constant operation envelope whose weightTarget is the mover prim itself; that one value broadcasts to every application of the atomic mover.

Node parameters

rigExec:influences

Relationship.

rigExec:jointIndices

Type: int[]. Default: [].

rigExec:jointWeights

Type: float[]. Default: [].

rigExec:elementSize

Type: uniform int. Default: 1.

rigExec:skinningMethod

Type: uniform token. Default: "classicLinear".

inputs:mask

Type: float[]. Default: [].

inputs:useBaseInput

Type: uniform bool. Default: false.

inputs:transformInput

Type: uniform bool. Default: false.

rigExec:transform

Relationship.

Example

Two points with a single translation influence of two units in X and masks [0.25,0.75] move by 0.5 and 1.5 units. Apply RigExecMoverAPI and bind the exact points property.

Tips

  • The per-point mask and common mover envelope are independent.
  • A .rigexec player needs this mover's playback kernel; without it the revision passes its points through.

See also


UsdRig