Skip to content

Wrinkle Mover Wrinkle Mover

Solves coherent compression-driven folds on an already deformed mesh.

Node type RigExecWrinkleMover
Example wrinkle_mover.usda

On this page:

Overview

Adds fine folds after skinning or other mesh deformation by comparing the posed mesh with its reference lengths. A deterministic fold guide keeps the wrinkle pattern consistent as compression changes. Each pose solves independently, so forward playback, reverse playback, and direct frame seeking give the same result. See Wrinkle deformation for the supported method and algorithm references for its sources.

Adds automatic quasistatic wrinkles to one native mesh points property. Reference lengths and a deterministic fold guide define target edge vectors. Iterative projection adjusts the incoming shape in three dimensions, subject to attachment bounds, pins, and optional local tangent-plane collisions. The guide follows smooth compression without previous-frame state, so playback and seeking agree. The common mover envelope blends the result once.

How it works

The cloth topology builds links from a triangulated surface and weak bending links across neighboring triangles. Surface struts retain the structural edges and replace the bending links with weak links at exactly neighborDistance hops through triangulated adjacency. Vertex-index phase values are smoothed along less compressed edges to guide the folds. Compression and the guide define fixed target edge vectors for the current pose. Iterations adjust points in three dimensions toward those targets while keeping them within an attachment radius of the incoming shape. Explicit and boundary pins hold their incoming positions. Optional tangent-plane collisions restrict inward motion relative to the incoming surface. The solved displacement can be scaled and smoothed before the attachment bound and common mover envelope are applied. Displacement averaging does not transport rest detail like Delta Mush. Topology changes and degenerate surface normals can interrupt fold continuity. There is no external-object or self-collision solve.

Wiring

Relationship Points to Required
rigExec:moves One native mesh points property. 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: uniform point3f[]. Default: [].

Static, unconnected reference points in target mesh local space, with the same ordering and count as the target. Empty uses the target's authored base points at the evaluation time, before its mover chain.

inputs:iterations

Type: int. Default: 80.

Constraint solver iteration count in [0,1000]. Zero passes through.

inputs:topology

Type: uniform token. Default: "cloth".

Valid values: cloth, surfaceStruts.

Static, unconnected constraint topology. Both modes use triangulated surface edges. Cloth adds weak across-triangle bend links; surfaceStruts replaces these with weak links at exactly neighborDistance hops through triangulated edge adjacency.

inputs:neighborDistance

Type: int. Default: 2.

Exact triangulated-edge graph distance for surfaceStruts, in [1,8].

inputs:restLengthScale

Type: float. Default: 1.

Finite positive scale on reference constraint lengths.

inputs:stretchStiffness

Type: float. Default: 1.

Correction strength for structural links stretched in the incoming pose, finite and in [0,1].

inputs:compressionStiffness

Type: float. Default: 1.

Correction strength for structural links compressed in the incoming pose, finite and in [0,1].

inputs:bendStiffness

Type: float. Default: 0.1.

Bend-link and surface-strut correction strength, finite and in [0,1].

inputs:maxDisplacement

Type: float. Default: 0.2.

Finite nonnegative attachment radius around each incoming point in mesh local units. The final displacement remains inside this radius, including after wrinkleScale and displacement smoothing.

inputs:pinBorders

Type: bool. Default: true.

Keep vertices incident to a boundary edge at their incoming position.

inputs:pinPoints

Type: uniform int[]. Default: [].

Static, unconnected, unique nonnegative indices of additional pinned vertices.

inputs:tangentPlaneCollisions

Type: bool. Default: true.

Prevent inward movement through each incoming vertex's local tangent plane, offset inward by tangentPlaneInset. This is a local surface approximation; there is no external or self-collision solve.

inputs:tangentPlaneInset

Type: float. Default: 0.

Finite nonnegative inward tangent-plane offset in mesh local units.

inputs:wrinkleScale

Type: float. Default: 1.

Finite nonnegative scale on solved displacement, still bounded by maxDisplacement.

inputs:smoothingIterations

Type: int. Default: 0.

Displacement-field averaging passes in [0,100]; not rest-detail transport.

Example

A 33-by-17 quad sheet starts flat. An upstream matrix mover animates its width from full size to 65% and back. The wrinkle mover responds to that changing compression with bounded folds while keeping its border pinned. The authored base sheet supplies rest points and the envelope stays at one. One displacement-smoothing pass softens the transition to pinned borders.

Open it live with:

bin\launch_usdview.bat docs\examples\wrinkle_mover.usda

Tips

  • Run after deformation; with the Builder, add the wrinkle mover before the earlier deformer because sibling application order is reversed.
  • Mesh resolution, constraint neighborhood, and maximum displacement set the available fold shapes.
  • Use cloth for across-triangle bending or surfaceStruts for weak connections at the selected edge-graph distance.
  • Rest points, topology, and explicit pins must be static and unconnected. Empty rest points use the target's authored base points before its mover chain.
  • The attachment radius also bounds the final result when wrinkleScale exceeds one.
  • Keep vertex correspondence, topology, and normals consistent through animation.

See also


UsdRig