Help guide

Soft Mesh Debug Render node

Updated June 21, 2026

Soft Mesh Debug Render node

Product media placeholder

Replace this area with a screenshot or short walkthrough video during the media sweep.

Second renderer type for softMesh — F381 P1.5. Proves the typed-port output of `softMesh` is renderer-agnostic by consuming the IDENTICAL set of typed ports as `softMeshRender` (vertices, subpathStarts, sharpFlags, bodyCenterX/Y) but rendering a STROKED outline instead of a filled subpath. Also consumes `restVertices` for an optional rest-pose ghost overlay underneath the live outline — useful as a debug aid to see how far the live silhouette has drifted from its rest pose. Wire one softMesh into both renderers (softMeshRender for fill, softMeshDebugRender for outline / rest ghost) and you have a fill + wireframe debug view from a single sim, demonstrating that swapping renderers requires zero changes to the sim.

Type softMeshDebugRenderCategory effectsContext sharedDynamic ports noCompound no

Inputs

PortTypeDescription
verticesfloat32bufferWire from `softMesh.vertices`. Live concatenated vertex buffer in body coords.
restVerticesfloat32bufferWire from `softMesh.restVertices` for the rest-pose ghost. Optional — set `restOpacity: 0` if unwired.
subpathStartsuint16bufferWire from `softMesh.subpathStarts`. Same layout for both vertices and restVertices.
sharpFlagsuint16bufferWire from `softMesh.sharpFlags`. Sharp-corner flag per vertex.
bodyCenterXfloatWire from `softMesh.bodyCenterX`.
bodyCenterYfloatWire from `softMesh.bodyCenterY`.
opacityfloatStroke opacity for the live outline, 0..1.

Outputs

PortTypeDescription
--No ports declared.

Parameters

ParameterTypeDefaultDescription
selectorelementSelector""Required. Match the linked softMesh's `selector`.
colourcolorString"#1a1a1a"Live Outline Colour
restColourcolorString"#888888"Rest Ghost Colour
restOpacityfloat0.40 = hide rest ghost (live outline only). 0.3-0.5 = visible ghost beneath live deformation. min 0; max 1; step 0.05
strokeWidthfloat1.5Stroke Width (px) min 0.5; max 10; step 0.5

Use cases

  • Fill + outline debug overlay — pair with `softMeshRender` on the same softMesh; fill renders the silhouette, debug renders the stroked outline.
  • Rest-pose ghost — wire `softMesh.restVertices` into `restVertices`; set `restOpacity: 0.4`. Shows the original rest silhouette ghosted under the live deformation.
  • Wireframe-only view — set `restOpacity: 0` and omit the fill renderer to render only the deforming outline.

Related nodes

Envelope

Use softMeshDebugRender as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.

Generated source

Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-effects/

Was this guide helpful?

Sunny Arora

Written by

Sunny Arora

Get technical deep dives delivered to your inbox

Join creators and developers who get exclusive insights, tutorials, and behind-the-scenes content every week.

No spam. Unsubscribe anytime.

Continue Exploring

You might also enjoy