PolyScript

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

Try PolyScript

You can try it right now in your browser. Open the Playground and start typing code.

As you type code, the 3D model appears on the right in real time. Just copy and paste the examples on this page to get started.

What is PolyScript?

PolyScript is a CAD DSL for writing parametric 3D models concisely. The basic idea is simple: create a primitive, chain operations with |, and select only the parts you need to modify.

Tutorial

Mon, 01 Jan 0001 00:00:00 +0000

You’ve grasped the basics in “Getting Started.” Now let’s get hands-on and build some models.

Lesson 1: Building an Enclosure

We’ll make a case for an electronics board. Learn the golden pattern of CAD modeling – “create → select → modify” – by doing it yourself.

The finished model

box 100 60 40
 | faces >Z | shell 2
 | edges =Z | fillet 3
 | edges <Z | fillet 1
 | faces right
 | circle 4 | cut
 | faces left
 | points (grid 2 4 10)
 | hole 3

✎ Edit

Don’t try to take it all in at once. We’ll build it up one step at a time.

Language Reference

Mon, 01 Jan 0001 00:00:00 +0000

Overview

PolyScript is a pipe-based language for parametric CAD modeling. Shapes are created with primitives and transformed through a chain of pipe operations.

box 80 60 10 | fillet 2 | diff cylinder 10 10

When you write multiple shapes on separate lines, they are automatically combined (unioned) into a single shape.

box 10 10 10
sphere 8
# → the two shapes are automatically unioned

To combine shapes explicitly, use union [...].

Cheat Sheet

Mon, 01 Jan 0001 00:00:00 +0000

Print this out and keep it handy. Probably.

Primitives

3D

Function	Arguments	Example
`box`	w h d	`box 80 60 10`
`cylinder`	r h	`cylinder 5 10`
`sphere`	r	`sphere 10`
`cone`	r1 r2 h	`cone 10 0 20`
`torus`	r1 r2	`torus 20 5`
`wedge`	dx dy dz ltx	`wedge 20 10 15 5`

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.