Modulate Toolpath

The Toolpath-aware sibling of Modulate Path. Displaces every point of every segment of a Toolpath by a scalar field, with per-segment normals and a global resampling of the field across the flattened point count.

Node

Interactive preview is available in the interactive reader.

Sockets

toolpath (in): Toolpath. Required.
values (in): PointArray. Required — scalar stream.
direction (in): Vector3. Optional override used only in custom mode.
gain (in): Float. Optional multiplier.
toolpath (out): Toolpath — the displaced toolpath, preserving segment metadata (isTravel, color, etc.).

Parameters

Direction mode: Normal (2D) / Z axis / Radial (XY) / Custom vector — same semantics as Modulate Path.
Direction: Custom direction vector for custom mode. Default: [0, 0, 1].
Gain: Field multiplier. Default: 1.
Skip travels: If on, segments flagged as travel are copied through unchanged. Default: on.

How It Works

Every segment contributes its points to a global count. The field is sampled once across u ∈ [0, 1] globally, so a 64-point noise field can smoothly drive a multi-thousand-point toolpath with no visible seam between the segments.

Normals are computed per segment; tangent continuity across segment boundaries isn't maintained — which is consistent with the compiler later emitting discrete travel moves between segments.