Delta Mush Mover¶
Smooths deformation and restores transported rest detail.
| Node type | RigExecDeltaMushMover |
| Example | delta_mush_mover.usda |
On this page:
Overview¶
Smooths rest and incoming mesh points, then transports rest detail into the smoothed deformed surface. Method reference: Mancewicz, Derksen, and Wilson (2014), Delta Mush.
Native detail-preserving smoothing. Smooth reference and incoming points, then transport reference detail in surface frames. Smoothing masks apply within every iteration; the common mover envelope blends the candidate once. The target must be a Mesh. inputs:restPoints, inputs:smoothing, inputs:frameTransport and inputs:edges must be static and unconnected; empty restPoints use the target's base points.
How it works¶
The shared kernel builds edge adjacency from mesh topology and applies
the same smoothing settings to rest and incoming points. It transports the
rest-to-smoothed offset into the deformed local surface frame. Native,
frozen and binary evaluation share libs/rigExecMath/deltaMushKernel.h.
A point whose result is not finite, or whose transport frame is degenerate,
keeps its incoming position while the rest of the mesh deforms. Invalid rest
data, a displacement out of range or an invalid computationToTarget passes
the whole mesh through. With fixed topology, edges and iterations, each
vertex group runs on its own and reads only the groups its smoothing reaches.
The defaults are rest-weighted smoothing (smoothing = rest) and
vertex-frame transport (frameTransport = vertex). Choose smoothing = simple or lengthWeighted with
frameTransport = corner for deformation-dependent smoothing and corner-frame
detail restoration.
smoothWeights participates inside every smoothing iteration, separate from
the final envelope. Explicit edges preserve loose edges, onlySmooth
disables detail restoration, and displacement scales restored detail.
restPoints stores the actual reference or saved bind coordinates.
computationToTarget, optionally followed by the rigExec:frame provider,
keeps smoothing in the original object's coordinate space under nonuniform
scale. Saved rest points stay in that computation space.
.rigexec exports carry these settings from format revision 21. A revision
20 file has none of them and plays the default smoothing and transport.
Wiring¶
| Relationship | Points to | Required |
|---|---|---|
rigExec:moves |
Mesh points property to deform. | yes |
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¶
inputs:restPoints¶
Type: point3f[].
inputs:iterations¶
Type: int. Default: 10.
inputs:step¶
Type: float. Default: 0.5.
inputs:pinBorders¶
Type: bool. Default: true.
inputs:distanceWeight¶
Type: float. Default: 0.
inputs:displacement¶
Type: float. Default: 1.
inputs:smoothing¶
Type: uniform token. Default: "rest".
Valid values: rest, simple, lengthWeighted.
Rest uses fixed reference edge weights, each edge's reference length to the power -distanceWeight (uniform at the default 0), and needs step and displacement in [0,1]. Simple averages incident edge displacements. LengthWeighted recomputes current edge lengths per iteration and divides by length sum times edge valence, using twice the step. The latter modes permit any finite step and detail scale.
inputs:frameTransport¶
Type: uniform token. Default: "vertex".
Valid values: vertex, corner.
Vertex uses an averaged surface normal and reference edge. Corner transports detail in each directed face-corner frame and combines posed corner-angle weights. Degenerate corners contribute zero weight.
inputs:smoothWeights¶
Type: float[]. Default: [].
Empty means one at every vertex; otherwise one finite value in [0,1] per vertex, multiplying the smoothing step in both reference and incoming iterations. Distinct from the common final envelope.
inputs:edges¶
Type: uniform int[]. Default: [].
Optional flattened unique undirected edge pairs, including all polygon edges and any loose edges. Empty derives polygon edges. Border pinning uses polygon incidence.
inputs:onlySmooth¶
Type: bool. Default: false.
Return the smoothed incoming shape without restoring detail.
inputs:computationToTarget¶
Type: matrix4d. Default: ((1,0,0,0),(0,1,0,0),(0,0,1,0),(0,0,0,1)).
Nonsingular affine row-vector map from the reference/smoothing coordinate space into the target points space. Reference points remain in computation space; incoming points transform back before smoothing. Explicit restPoints are required for a nonidentity map or frame provider, except in onlySmooth mode.
rigExec:frame¶
Relationship.
Optional single rest-to-pose frame provider composed after computationToTarget, read at its base or final phase; a checkpoint is a compile error.
Example¶
The animated mesh demonstrates smoothing with rest-detail restoration.
Open it live with:
Tips¶
- Place after the deformation to smooth.
- Use compatible rest geometry and topology.