チートシート

印刷して手元に置くとはかどる。たぶん。

プリミティブ

3D

位置規約: box/cylinder/sphere/cone/torus は原点中心（centered）。extrude h は z=0..h で底面合わせ。混在する場合は | floor / translate / center:(true,true,false) で揃える。

2D

sketch セグメント: タプル=直線, arc 開始点 通過点 終点=3点円弧, arc 開始点 終点 center:(cx,cy)=中心アーク, arc 開始点 終点 radius:半径=半径アーク, bezier [制御点]=ベジエ（開始点は前セグメント終端、制御点と末尾の終点のみ指定）, spline [通過点]=スプライン（同様）。最初の要素が開始点、自動close。

パス

wire は sketch のopen版（auto-closeなし）。複数セグメントを結合した開wireを作る。2D/3D両対応。sweepのspine(上流)に最適。型は Wire(曲線)で、閉じても面にはならない: extrude/cut/2Dブーリアンは不可、offset d で幅 2|d| の面(Face)にできる。sketch や rect など他の2Dプリミティブは Face(面):

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

sketchと同様に、workplaneと組み合わせて任意の平面上にパスを描ける:

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

パイプ操作

修飾

直線1本（2点）の wire は offset できない。 offsetWire2D: operation failed になる。 中間点を足して2セグメントにすれば通る: wire [(0,0),(20,0),(40,0)]。

ブーリアン

パイプ操作: box 10 10 10 | diff (sphere 7) ソースコマンド: union [box 10 10 10, sphere 7] / diff [...] / inter [...] 形状演算子: a + b（union）/ a - b（diff）/ a * b（inter）。変数か括弧の間だけ: (box 10 10 10) - (cylinder 3 20) は可、box 10 10 10 - cylinder 3 20 はパースエラー（引数の算術と衝突）。base - holes | fillet 2 は (base - holes) | fillet 2。* を +/- と混ぜるときは括弧を書く

配置

変数に格納した2D形状を面の上に配置してから cut や 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

加工

変形

translate, rotate, scale は origin: キーワードを受け付けます: "world"（デフォルト）, "local"（BBox中心）, (x,y,z)。

rotate 0 0 45 origin:"local"    # オブジェクト中心で回転
scale 2 origin:(10, 0, 0)       # 任意の点を基準にスケール

2D 形状は描いたワークプレーンから出られない。縦の面(XZ / YZ)にパスや輪郭を置くときは、 rotate で立てるのではなく最初からその面で描くか、3D 座標で書く:

workplane XZ | wire [arc (0,-25) (25,0) center:(0,0)] | sweep (circle 5)   # XZ 面の円弧パス
arc (0,0,-25) (25,0,0) center:(0,0,0) | sweep (circle 5)                  # 同じパスを 3D 座標で

選択とワークプレーン

選択

| faces sel        # 面を選択
| edges sel        # エッジを選択
| verts sel        # 頂点を選択（2Dでは形状の頂点を返す。2D/3Dプリミティブを配置可）
| verts | translate x y z   # 頂点位置をオフセット（選択を維持）
| points [...]     # 座標で点を指定
| points (polar n r)     # 円形配置
| points (grid nx ny p)  # 格子配置
| points ... | translate x y z  # ポイント位置をオフセット（選択を維持）

Face選択の後では polar / grid を直接書ける（points を省略可）:

| faces top | polar 6 20 | hole 3     # points (polar 6 20) と同じ
| faces top | grid 2 3 20 | hole 3    # points (grid 2 3 20) と同じ

セレクタ記号

>Z だけが「1枚」を選ぶ。=Z と +Z は面では2枚と4枚に分かれる (60×40×30 の箱なら面積 4800 と 6000)。

名前エイリアス

複合セレクタ

| edges >Z >X          # AND: Z最大 かつ X最大
| edges [>Z, <Z]       # OR: Z最大 または Z最小

名前付け（as）

| faces <X as $left     # 面に名前を付けて後から参照
| edges =Z as $top_edges

ワークプレーン

| faces top | rect 50 30      # Face選択から直接2D描画（暗黙workplane）
| faces top | workplane XZ    # 軸を明示したい場合のみ workplane を書く
# 平面名: XY(+Z) XZ(+Y) YZ(+X)。-XY/-XZ/-YZ は同じ平面で法線が逆(押し出しが負側)。ZX 等の逆順はエラー

配置 at:

at: は名前付き引数。単純な座標はカッコ省略推奨。式を含む場合はカッコ必須。

cylinder 2.5 10 at:20 10                 # 単一位置（カッコ省略推奨）
cylinder 2.5 10 at:(20, 10)              # カッコ付きも有効
cylinder 2.5 10 at:[(0,0), (20,10)]      # リスト（ブラケット必須）
rect 10 5 angle:45                       # 回転（angle: 名前付き引数）
box 10 10 3 | polar 6 20                 # 円形配列（3Dコンテキスト）
box 10 10 3 | grid 4 3 20               # 格子配列（3Dコンテキスト）

Face選択コンテキストでは polar/grid は points として解釈される:

box 10 10 10 | faces top | polar 6 20 | circle 3 | cut   # 点を円形配置
box 10 10 10 | faces top | grid 2 3 20 | circle 3 | cut  # 点を格子配置

構文

変数

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

関数定義

def name($args) = pipeline

インポート

import "gear"

条件式

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

リスト内包

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

演算子（優先順位 高→低）

** → * / // % → + - → 比較 → and → or → |

CLI

よく使うものだけ。全サブコマンドとオプションは CLI リファレンス にある。

-D の型推論: 100 → int, 1.5 → float, true/false → bool, その他 → string

-D と --params-file を併用すると -D が優先。優先順位: -D > --params-file > @param デフォルト値

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

断面 poly section

平面で切って輪郭を報告する。画像ではなく数値で形を確かめるためのもの。

poly section m.poly                      # 既定 xz,yz（bbox中心を通る）
poly section m.poly --plane Z=10         # 位置を明示
poly section m.poly --plane xz,yz,Z=10   # 複数
poly section m.poly --plane Y=0 -o cut.svg

平面は含む2軸で呼ぶ（xz の法線はY）。位置を省くとbbox中心を通る。

section XY @ Z=20: 2 loops
  loop 0: closed  bbox 39.999x39.9995 at (...)  area 1256.6371  length 125.6637  points 315
  loop 1: closed  bbox 15.999x15.9995 at (...)  area 201.0619   length 50.2655   points 199

ループが2つなら中空、1つなら充実。area と length は解析曲線から測るので厳密 （上はφ40の円柱にφ16の穴で、πr² と 2πr に桁まで一致）。bbox と points は 描画用にサンプリングした点由来なので、曲面ではわずかに内接する。 area に ~ が付くのは面が張れず多角形の面積を返した場合。

-o で書くSVGはパス座標がミリメートルで、表示倍率はgroup transformに置いてある。 d="M 45.25 0 L 15 0 L 15 2 ..." から床2mm・壁2mmが直接読める。

コンテキスト遷移

3D ─→ faces/edges ─→ 2D ─→ extrude/cut ─→ 3D
              │        │
              │        └── hole ──→ 3D（面の中心に穴）
              │
              └── fillet/chamfer ──→ 3D

Face/Wire ─→ verts ──→ 2Dプリミティブ ─→ Face/Wire
       │    └─→ 3Dプリミティブ ─→ 3D
       │    └─→ translate ─→ verts（位置をずらして選択維持）
       │
points ──→ hole ──→ 3D（各ポイントに穴）
       └─→ translate ─→ points（位置をずらして選択維持）

覚え方: 作る → 選ぶ → 描く → 戻る（workplane は省略可。面を選べばそのまま描ける）

verts で頂点を取ると、2D/3Dどちらのプリミティブも各頂点に配置できる。 translate で位置をずらしてから配置することもできる:

rect 100 100 | verts | circle 1      # 各頂点に円を配置 → 2D
rect 100 100 | verts | box 1 1 1     # 各頂点にboxを配置 → 3D
rect 80 60 | verts | translate 10 10 10 | cone 2 0 6   # 頂点をオフセットしてから配置