Cheat Sheet

Print this out and keep it handy. Probably.

Primitives

3D

Position convention: box/cylinder/sphere/cone/torus are centered at the origin. extrude h is bottom-aligned (z=0..h). When mixing both, use | floor / translate / center:(true,true,false) to align them.

2D

sketch segments: tuple = line, arc start through end = 3-point arc, arc start end center:(cx,cy) = center arc, arc start end radius:radius = radius arc, bezier [control points] = Bezier (start point is implicit from the preceding segment; list contains control points and the end point), spline [through points] = spline (likewise). First element is the start point; auto-close.

Paths

wire is the open version of sketch (no auto-close). Joins multiple segments into an open wire. Supports both 2D and 3D coordinates. Ideal for sweep paths:

wire [(0,0), (10,0), arc (10,0) (15,5) radius:5] | sweep (circle 5)

Like sketch, wire works with workplane to draw on any plane:

workplane XZ | wire [(0,0),(10,0),(10,10),(0,10),(0,0)] | sweep (circle 2)

Pipe Operations

Modifiers

Boolean

Pipe operation: box 10 10 10 | diff (sphere 7) Source command: union [box 10 10 10, sphere 7] / diff [...] / inter [...]

Place

Place a 2D shape stored in a variable onto a face, then cut or extrude:

$s = sketch [(5,0), arc (5,0) (0,-5) (-5,0), (0,7), (5,0)]
box 10 10 10 | faces >Z | place $s | cut

2D → 3D

Machining

Transform

translate, rotate, scale accept origin: keyword: "world" (default), "local" (bbox center), or (x,y,z).

rotate 0 0 45 origin:"local"    # rotate around object center
scale 2 origin:(10, 0, 0)       # scale from arbitrary point

Selection and Workplane

Selection

| faces sel        # select faces
| edges sel        # select edges
| verts sel        # select vertices (in 2D, returns shape vertices; can place 2D/3D primitives)
| verts | translate x y z   # offset vertex positions (stays in selection)
| points [...]     # specify points by coordinates
| points (polar n r)     # circular arrangement
| points (grid nx ny p)  # grid arrangement
| points ... | translate x y z  # offset point positions (stays in selection)

After face selection, polar / grid can be written directly (omitting points):

| faces top | polar 6 20 | hole 3     # same as points (polar 6 20)
| faces top | grid 2 3 20 | hole 3    # same as points (grid 2 3 20)

Selector symbols

Name aliases

Compound selectors

| edges >Z >X          # AND: Z-max AND X-max
| edges [>Z, <Z]       # OR: Z-max OR Z-min

Tagging (as)

| faces <X as $left     # name a face for later reference
| edges =Z as $top_edges

Workplane

| faces top | rect 50 30      # draw 2D directly from face selection (implicit workplane)
| faces top | workplane XZ    # use workplane only when you need a specific axis

Placement at:

at: is a named argument. Omit parentheses for simple coordinates. Parentheses are required for expressions.

cylinder 2.5 10 at:20 10                 # single position (omit parentheses)
cylinder 2.5 10 at:(20, 10)              # parenthesized form also valid
cylinder 2.5 10 at:[(0,0), (20,10)]      # list (brackets required)
rect 10 5 angle:45                       # rotation (angle: named argument)
box 10 10 3 | polar 6 20                 # circular array (3D context)
box 10 10 3 | grid 4 3 20               # grid array (3D context)

In a face selection context, polar/grid are interpreted as points:

box 10 10 10 | faces top | polar 6 20 | circle 3 | cut   # circular point arrangement
box 10 10 10 | faces top | grid 2 3 20 | circle 3 | cut  # grid point arrangement

Syntax

Variables

$w = 80
box $w $w/2 10

Function definition

def name($args) = pipeline

Import

import "gear"

Conditional expression

if $x > 0 then $x else -$x

List comprehension

[$i * 10 for $i in range(6)]

Operators (highest to lowest precedence)

** → * / // % → + - → comparison → and → or → |

CLI Options

-D type inference: 100 -> int, 1.5 -> float, true/false -> bool, anything else -> string

When -D and --params-file are combined, -D wins. Precedence: -D > --params-file > .poly.params.json > @param defaults

poly build box.poly -D width=100 -D height=50
poly build box.poly --params-file presets/small.json -D width=120

Context Transitions

3D ─→ faces/edges ─→ 2D ─→ extrude/cut ─→ 3D
              │        │
              │        └── hole ──→ 3D (hole at face center)
              │
              └── fillet/chamfer ──→ 3D

2D ─→ verts ──→ 2D primitive ─→ 2D
       │    └─→ 3D primitive ─→ 3D
       │    └─→ translate ─→ verts (offset and stay in selection)
       │
points ──→ hole ──→ 3D (hole at each point)
       └─→ translate ─→ points (offset and stay in selection)

Remember: create → select → draw → return (workplane is optional – just select a face and draw directly)

With verts, both 2D and 3D primitives can be placed at each vertex. Use translate to offset positions before placement:

rect 100 100 | verts | circle 1      # place circles at each vertex → 2D
rect 100 100 | verts | box 1 1 1     # place boxes at each vertex → 3D
rect 80 60 | verts | translate 10 10 10 | cone 2 0 6   # offset vertices then place