PAGE

The page to work on, made if the drawing has none of that name; and pages deleted and renamed. A drawing has one page or more, each with its own elements and its own points, all sharing the drawing's variables, functions, notes, layers and parts. See Pages.

Syntax

PAGE "name"
PAGE "name","page"[,"material"[,"model"[,"order"[,overlap]]]][,DATA="…" | ,EMBEDDED=FALSE][,MODE="modes"][,LAYOUT="layout"]
PAGE DELETE "name"
PAGE RENAME "old","new"

Form	Does
`PAGE "name"`	Works on the page of that name from now on, making it (after the last) if there is none. What is drawn, selected, edited and exported is then that page's, and points (`P5=…`) are that page's own. A page made starts with `P0` to `P3`, as a new drawing does.
`PAGE "name","page"`	A 3D page: the page named second, folded in the 3D viewer. Made if there is none of that name (else that page becomes a 3D page of it), and worked on. Nothing is drawn on it; it shows the other page folded, made again each time it is gone to.
`PAGE "name","page","material"`	The same, in that material: the `id` of an appearance (3D pages) (`"kraft"`, `"denim"`). Without one, or `""`, the material is chosen automatically from the drawing's.
`PAGE "name","page","material","model"`	The same, with a 3D model shown standing on its base panel: the path (or web address) of a glTF (`.glb`, `.gltf`), OBJ or STL file. Give `""` for the material to have it chosen automatically. Followed by `DATA="…"`, the model's file is kept in the drawing (base64url: a .glb or .stl); followed by `EMBEDDED=FALSE`, or by neither, it is linked: read from model whenever the drawing is read (Linked files and web addresses).
`PAGE "name","page","material","model","order",overlap`	The same, folding in that order: `"natural"` (the usual: walls, then their flaps, then the panels that close it), `"together"`, `"basefirst"` or `"tipsfirst"`; each step overlapping the next by `overlap`, a number from 0 (one after the other) to 0.9 (the usual is 0.35). Give `""` for the material to have it chosen automatically, and for the model to have none. Any other order is refused. A crease's own step (RULE STEP) comes first.
`…,MODE="modes"`	After the others on a 3D page's line: how the page is made 3D, a list of modes: `FOLD`, `EXTRUDE`, `ASSEMBLE`, `WRAP`, `SWEEP` (`"EXTRUDE,ASSEMBLE"`). Without it (or `"AUTO"`), every mode the drawing wants. See Making drawings 3D. Any other mode is refused. 3D › Build Mode writes it.
`…,LAYOUT="layout"`	Last on a 3D page's line: how the page is laid out for live editing, kept in the drawing: the parts shown (`variables`, `scene`, `timeline`, `hand` for Fold by Hand) and the Variables panel's share of the column (`"variables,scene;split=0.6"`). Written only when Save the 3D layout in the drawing is ticked in Drawing Properties; names it doesn't know are passed over.
`PAGE DELETE "name"`	Removes the page and everything on it, its points too. A drawing keeps at least one page. If it was the page worked on, the next one is (or the one before).
`PAGE RENAME "old","new"`	Renames the page. PART and NEST elements that place it, on any page, place it by the new name, and 3D pages of it fold it by the new name.

Page names are compared ignoring case, and no page may have the name of a part in the drawing's library.

Examples

LINE @1,P0,P1
PAGE "Artwork"
LINE @2,P1,P2
PAGE "Page 1"

The first line is on Page 1, the second on a new page, Artwork; then Page 1 is worked on again. Each line is drawn on its own page's P1: every page starts with P0 to P3, the corners of the L × W box, so they are in the same place.

P4=[0,100]
LINE @1,P0,P4
PAGE "Labels"
P4=[300,0]
LINE @2,P0,P4

Each page has its own P4: the line on Page 1 goes up, the one on Labels goes across.

PAGE "Die line"
LINE @1,P0,P1
PAGE "Nest"
P4=[0,-600]
P5=[100,-600]
PART @2,P4,P5,"Die line"
PAGE RENAME "Die line","Cutting"

The Die line page is placed on the Nest page as a part; renamed Cutting, the part places it by its new name.

PAGE "3D","Page 1","kraft"

A page called 3D showing Page 1 folded, in kraft board.

PAGE "3D","Page 1","","","basefirst",0

The same page in the drawing's own material, without a model, folding from its base out, one step after the other.

PAGE "Board","Page 1",MODE="EXTRUDE"

A page called Board showing Page 1's outlines made solid by their layers' depths (LAYER3D), not folded.

In a drawing file

A drawing is saved with what its pages share first (its variables, functions, layers and part library), then each page: a PAGE "name" line, the page's points (P4=…) and the elements on it. The first page is written the same way. The first page read takes the name of the first PAGE line. A 3D page is saved as its PAGE "name","page"[,"material"[,"model"[,"order"[,overlap]]]][,MODE="modes"][,LAYOUT="layout"] line. If the page worked on is not the last, a last PAGE line says which it is.

Notes

Each command can be undone; undoing a PAGE goes back to the page worked on before (and removes a page it made).
Pages are usually made, renamed and deleted with the tabs under the drawing, or Edit › Page: see Pages.
3D › Fold in 3D makes a 3D page of the drawing's first page. On it, 3D › Material chooses the material and 3D › Models and Products › Import Model… a 3D model to show in it, 3D › Folding › Fold Order and Overlap how it folds up, 3D › Display › Show Ground whether the floor is drawn, and 3D › Display › Renderer the graphics (Direct3D 11, on Windows only; OpenGL; Vulkan), which every 3D page then uses.