Segment Unpack

Overview

Decomposes a Bézier segment into eight coordinate values (the reverse of segment_pack). This low-level component extracts coordinates from an editor-drawn shape so you can inspect and process them as numbers.

Usage tips

• Every output is an output-only parameter. Promote only the coordinates you need to output pins 📤 (having no pins initially is normal).
• The basic flow is: promote seg_N on bezier_path to an output pin 📤 → Unpack → process selected coordinates with waveforms → segment_pack → return to bezier_path.
• If you only need the coordinates of a point on a path, path_sample is a simpler, higher-level choice. This node is specifically for editing control points.
• Read-only outputs use the full Int range so coordinates from any Path source are not truncated. segment_pack limits editable values and promoted inputs to -1024..1024, so out-of-range coordinates are constrained when sent back to Pack.

Related nodes

• segment_pack — counterpart that reconstructs a segment

• bezier_path — source and return destination for the segment

• path_sample — simpler coordinate extraction

• motion — animate coordinates

• Version: 1

Parameters (output-only)

Every parameter has promotable: false, output_promotable: true. They cannot be edited with sliders or inputs; calculated values are displayed read-only.

UI behavior

• Node body: when parameters are expanded, each coordinate name and actual value appears as read-only purple text (no slider).
• Inspector: displays the calculated value in a badge. The 📌/🎚️🔢🎛️ buttons are hidden.
• Promote to an output pin (📤): add only the necessary coordinates as output pins for downstream connections.

Examples

Inspect coordinate values

1. Promote seg_N on Bézier Path to an output pin 📤.
2. Connect it to the Segment input of Segment Unpack.
3. Inspect each coordinate in the node body or Inspector.
4. Click 📤 on each required coordinate parameter to promote it to an output pin.

Coordinate-processing pipeline

1. Bézier Path seg_N → decompose with Segment Unpack.
2. Promote the required coordinate (for example, p0_x) to an output pin 📤.
3. Process the coordinate with Sine Wave or another animation node.
4. Reconstruct it with Segment Pack.
5. Promote seg_N on Bézier Path to an input pin 📌 and return the result.

Design notes

This node uses the output-only parameter pattern (see section 10 of NODE_DEVELOPMENT_GUIDE.md). By having no fixed output ports and managing every output through parameters, it provides a clean interface where users select only the coordinates they need.