Skip to content

Surface Binding Mover Surface Binding Mover

Follows fixed barycentric attachments with vector offsets.

Node type RigExecSurfaceBindingMover

On this page:

Overview

Each affected point blends one or more persistent surface bindings. The mover stores the binding indices, generalized barycentric weights and three-component offsets as attributes. It reads the driver's selected point revision and never searches again for a nearest point. Offsets rotate in a local tangent, bitangent, normal frame.

Persistent generalized barycentric attachments. Each affected vertex blends one or more bindings. Offsets are vectors in the current surface's tangent, bitangent, normal frame. Polygon bindings and optional limit position/derivative stencils are immutable authored attributes; evaluation rebinds nothing and reads the driver points at the rigExec:surface read phase. Of the inherited RigExecSurfaceMover settings it reads rigExec:surface, rigExec:mask and rigExec:frames; rigExec:mode, rigExec:snapMode, rigExec:offset, rigExec:triangles, rigExec:pointSpace, rigExec:surfaceMatrix and rigExec:targetMatrix are not read.

How it works

vertexOffsets groups bindings by affected vertex; polygonOffsets groups pointIndices and barycentricWeights by binding. bindingWeights combines their positions. Polygon mode uses a Newell normal and the first nonzero polygon edge as its tangent. Smooth normal mode uses area-weighted vertex normals interpolated by the binding weights, with the tangent projected into that normal's plane. Degenerate frames contribute zero in their collapsed offset directions. deltaMultiplier and optional per-target-point deltaMultipliers scale the transported three-component offset: zero binds directly to the surface, one preserves the saved offset, and negative finite values are allowed. These are independent of the envelope. Optional masks and strength blend the resulting position over the incoming point revision.

Limit mode reads authored, factored control-point position and u/v derivative stencils (limitOffsets, limitIndices, limitWeights, limitDuWeights, limitDvWeights). These stencils must come from the chosen subdivision surface and parameter coordinates; ordinary polygon weights are not limit stencils. Geometric limit normals come from the derivative cross product. Topology edits require rebinding and regenerating limit stencils.

With optional frames, surfaceRestMatrix times the first provider's rest-to-pose map converts driver points back to surface-local coordinates; surfaceToBinding maps them into binding space. targetRestMatrix times the second provider's map returns bound positions to target point space. Without frames, the authored matrices alone perform this conversion. Evaluation never writes to the stage. Native evaluation, frame-cache workers and .rigexec playback apply the same immutable payload; a .rigexec plays it through the mover's external playback kernel.

Wiring

Relationship Points to Required
rigExec:surface Driver point-based prim; final phase follows its completed modifier chain. yes
rigExec:moves One exact native point3f[] points property. yes
rigExec:frames Optional surface and target rest-to-pose providers, in that order. no

Parameters

Node parameters

rigExec:vertices

Type: int[]. Default: [].

rigExec:vertexOffsets

Type: int[]. Default: [0].

rigExec:polygonOffsets

Type: int[]. Default: [0].

rigExec:pointIndices

Type: int[]. Default: [].

rigExec:barycentricWeights

Type: float[]. Default: [].

rigExec:offsets

Type: vector3f[]. Default: [].

rigExec:bindingWeights

Type: float[]. Default: [].

rigExec:deltaMultiplier

Type: float. Default: 1.

Finite signed scale applied only to transported binding offsets; zero attaches to the surface and one preserves the offsets.

rigExec:deltaMultipliers

Type: float[]. Default: [].

Optional finite signed offset multipliers indexed by target vertex; empty supplies one at every vertex.

rigExec:mask

Type: float[]. Default: [].

rigExec:strength

Type: float. Default: 1.

rigExec:surfaceMode

Type: uniform token. Default: "polygon".

Valid values: polygon, limit.

rigExec:normalMode

Type: uniform token. Default: "geometric".

Valid values: geometric, smooth.

rigExec:limitOffsets

Type: int[]. Default: [0].

rigExec:limitIndices

Type: int[]. Default: [].

rigExec:limitWeights

Type: float[]. Default: [].

rigExec:limitDuWeights

Type: float[]. Default: [].

rigExec:limitDvWeights

Type: float[]. Default: [].

rigExec:frames

Relationship.

Optional surface and target rest-to-pose providers: none, or exactly these two in that order, composed after rigExec:surfaceRestMatrix and rigExec:targetRestMatrix.

rigExec:surfaceRestMatrix

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

rigExec:targetRestMatrix

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

rigExec:surfaceToBinding

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

Example

For one triangle binding, author vertices = [0], vertexOffsets = [0, 1], polygonOffsets = [0, 3], pointIndices = [0, 1, 2], barycentricWeights = [0.2, 0.3, 0.5], bindingWeights = [1] and offsets = [(0.1, 0.2, 0.4)]. Wire rigExec:surface to the driver mesh, with a final read phase when other movers deform it, and rigExec:moves to the driven points property. Apply RigExecMoverAPI.

Tips

  • Use polygon/geometric settings for barycentric bindings on the control mesh.
  • Limit mode requires position and derivative stencils; missing arrays are diagnosed.
  • Surface binding does not replace modifiers that deform the driver cage.

See also


UsdRig