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-surfaceGroup
Fold and Unroll
Plugin
Fold and UnrollKeywords
Unroll Surface
Fold and Unroll
10
What the node takes in, from wires or typed values.
Geometry
Solid or multi-face Surface to unroll
Join
Default true
Keep pieces joined along fold lines (off: every face is a separate piece)
Mesh Unfold
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
Default 0
Gap between laid-out pieces (0 = automatic)
Tolerance
Default 0
Vertex matching tolerance (0 = automatic, relative to part size)
Panels
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
Default 0
Height of the engraved joinery numbers (0 = automatic); numbers are shrunk if needed to stay inside the piece
Single-Curve Sides
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
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
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
5
What the node gives out, to wire into other nodes.
Pieces
Flat faces / joined islands laid out on XY, in the order of their names (P1, P2 ...)
Cuts
Lines to cut, one list per piece (branch i = piece i of Pieces)
Folds
Lines to fold or score (dashed), one list per piece
Engrave
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
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.
First documented in v0.6.5
Nov 20, 2026
Versions before it were published before changes were recorded.