Fold and Unroll

Fold and Unroll

Unroll Surface

Unroll Surface

Fold and Unroll

Flattens a Solid or multi-face Surface into a cut-and-fold net laid out on the XY plane. Planar faces unroll exactly; curved faces become flat triangles that bend into each other. Nothing is stretched: doubly curved faces are split into strips that unroll exactly (set their number with Panels). Fold lines are dashed. Both sides of every cut edge that joins another edge get the same number, engraved inside the piece next to that edge. Every piece is named P1, P2 ... and every face of a piece P1.1, P1.2 ..., engraved in its roomiest spot, so the panels are easy to find when arranging and assembling. A list wired into Geometry is unrolled item by item and laid out side by side. Every piece that unrolls exactly carries fold data (its flat triangles with their 3D corners, joint numbers and engraved numbers) so the Fold Back Check can fold it back into the shape and test the numbering; pieces with a stretched face carry none. Single-Curve Sides draws every side of a piece as one curve (cut lines, Edges and the piece outline); a curve wired into Tab Shape adds interlocking tabs along every seam; the Edges output gives each piece outline as separate curves (strips: left, right, start, end). With Mesh Unfold on, the part is read as the simplest mesh instead (planar faces whole, cylinders and cones as straight strips, spheres as gores) and unfolded papercraft-style into as few pieces as possible, with mountain (blue) and valley (purple) folds - best for origami and paper products.

Docs for v0.6.6, the latest version.

ID

fold-and-unroll-fold-and-unroll-unroll-surface

Group

Fold and Unroll

Keywords

unroll
unfold
flatten
net
develop
papercraft
fold
cut
fabrication
engrave
joinery
number
10 inputs, 5 outputs

Ports

Inputs

10

What the node takes in, from wires or typed values.

Geometry

Geometry

Solid or multi-face Surface to unroll

Join

Boolean

Default true

Keep pieces joined along fold lines (off: every face is a separate piece)

Mesh Unfold

Boolean

Default false

On: unfold the part as a mesh, papercraft style - fewest pieces, straight fold strips on cylinders and cones, gores on spheres, mountain / valley folds. Off: face-by-face unroll with strips for doubly curved faces

Spacing

Number

Default 0

Gap between laid-out pieces (0 = automatic)

Tolerance

Number

Default 0

Vertex matching tolerance (0 = automatic, relative to part size)

Panels

Number

Default 0

Doubly curved faces: the number of strips they are split into (0 = automatic, from the curvature). Strips unroll exactly without stretching and bend between their triangles; more strips follow the shape more closely

Text Size

Number

Default 0

Height of the engraved joinery numbers (0 = automatic); numbers are shrunk if needed to stay inside the piece

Single-Curve Sides

Boolean

Default false

Every side of a piece comes out as one curve instead of a chain of short straight segments: in Cuts, in Edges and in the piece outline in Pieces (exploding a strip outline gives its 4 sides). Fold lines stay straight. With Single-Curve Sides on or a Tab Shape wired, the rows along curved strips are placed from the curvature: more where the surface bends sharply, fewer where it is flat

Tab Shape

Curve

Optional tab profile added along every seam, alternating between the two sides so neighbouring pieces interlock. Open curve: its base runs from its start to its end point. Closed curve (a circle, an oval): centred on the edge. Each tab gets a dashed fold line along its base. Drawn at real size on XY

Tab Count

Number

Default 0

Tabs on each long edge of a strip, spaced evenly and alternating between the two pieces (0 = as many as fit). Tabs go on the long sides only

Outputs

5

What the node gives out, to wire into other nodes.

Pieces

Surface

Flat faces / joined islands laid out on XY, in the order of their names (P1, P2 ...)

Cuts

Curve

Lines to cut, one list per piece (branch i = piece i of Pieces)

Folds

Curve

Lines to fold or score (dashed), one list per piece

Engrave

Curve

Everything to engrave, one list per piece: joinery numbers (the same number on both sides of every joined cut edge, single-line digits), panel names and the dashed fold lines

Edges

Curve

Every piece outline split into separate curves, one list per piece (P1, P2 ...). A strip of a doubly curved face gives [left, right, start, end]: long edges run from start to end, and left of strip k meets right of strip k-1. Other pieces are split at their corners

This node has no documentation beyond its description and ports yet.

History

First documented in v0.6.5

Nov 20, 2026

Versions before it were published before changes were recorded.