構文リファレンス

概要

PolyScriptはパイプベースのパラメトリックCADモデリング言語です。プリミティブで形状を作り、パイプ操作のチェーンで変形します。

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

複数の形状を続けて書くと、自動的に1つの形状に結合（union）されます。

box 10 10 10
sphere 8
# → 2つの形状が自動結合される

明示的に結合したい場合は union [...] を使います。

プリミティブ

3D

box width height depth
cylinder radius height
sphere radius
cone r1 r2 height
torus r1 r2
wedge dx dy dz ltx

cone r1 r2 h は截頭円錐（frustum）を作ります。r1 が底面半径、r2 が上面半径、h が高さです。r2 を0にすると完全な円錐になります。

cone 10 5 20       # 截頭円錐（底面R10、上面R5、高さ20）
cone 10 0 20       # 完全な円錐

torus r1 r2 はドーナツ形状を作ります。r1 は中心からチューブ中心までの主半径、r2 はチューブの管半径です。

torus 20 5          # 主半径20、管半径5のトーラス

wedge dx dy dz ltx はくさび形（テーパー付きボックス）を作ります。底面がdxxdz、上面がltxxdzに狭まり、dyが高さです。

wedge 20 10 15 5    # 底面20x15、上面5x15、高さ10

位置規約

3Dプリミティブとextrudeでは、形状の配置ルールが異なります。混在するとズレの原因になるので要注意。

つまり box 10 10 10 の底面は z=-5 にあり、rect 10 10 | extrude 10 の底面は z=0 にあります。両者を同じシーンで使うとき、底面の高さが揃いません。

対処法は3つ:

1. | floor – 底面をz=0に揃える（一番かんたん）
2. center:(true,true,false) – プリミティブのZ軸だけ非センタリング
3. | translate 0 0 h/2 – 手動で持ち上げる

# NG: 本体(box)の上に蓋(extrude)を乗せたいが、底面がズレる
$body = box 80 60 100             # z = -50..+50
$lid  = rect 80 60 | extrude 20  # z = 0..20
# $lid は本体の真ん中あたりに浮いてしまう

# OK: floor で本体の底面を揃えてから積む
$body = box 80 60 100 | floor               # z = 0..100
$lid  = rect 80 60 | extrude 20            # z = 0..20
$body | union ($lid | translate 0 0 100)    # 蓋を本体の上に

2D

rect width height
circle radius
ellipse rx ry
polygon n r
polyline points
text content size
sketch [segments]

2Dプリミティブはワイヤプロファイルを生成します。| extrude、| cut、| revolve、| loft でソリッドにできます。

polygon n r は外接円半径 r の正n角形を作ります。polyline points は頂点リストから閉じたワイヤを作ります。

polygon 6 10            # 正六角形（外接円半径10）
polyline [(0,0), (10,0), (5,10)]   # 頂点リストから閉じたワイヤ

sketch – 複合ワイヤ

直線・円弧・ベジエ曲線を組み合わせて、自由な形の閉じた2Dプロファイルを作ります。rect や circle では表現できない形状に便利です。

sketch [
  (5, 0),                              # 開始点（タプル）
  arc (5, 0) (0, -5) (-5, 0),          # 円弧: 開始点 → 通過点 → 終点
  (0, 7),                              # 直線（タプルのみ）
  (5, 0)                               # 直線（最初の点に戻って自動close）
]

セグメントの種類:

最初の要素は必ずタプル（開始点）です。最後のセグメントが開始点に戻れば自動的に閉じます。arcの開始点が前セグメントの終点と一致しない場合は、自動的に直線が挿入されて接続されます。結果はextrudeやcutでソリッドにできます。

どのアークを使えばいい?

# 涙形 (teardrop) を押し出す
sketch [
  (5, 0),
  arc (5, 0) (0, -5) (-5, 0),
  (0, 7),
  (5, 0)
] | extrude 10

# D字穴
$r = 3
sketch [
  (-$r, $r),
  (-$r, -$r),
  arc (-$r, -$r) (0, -$r - 1) ($r, -$r),
  ($r, $r),
  (-$r, $r)
]

# 真の1/4円弧（中心指定）
sketch [
  ($r, 0),
  arc ($r, 0) (0, $r) center:(0, 0),
  (0, 0),
  ($r, 0)
]

# 角丸長方形（半径指定が最も簡潔）
$w = 20
$h = 10
$cr = 2
sketch [
  ($w/2 - $cr, -$h/2),
  arc ($w/2 - $cr, -$h/2) ($w/2, -$h/2 + $cr) radius:$cr,
  ($w/2, $h/2 - $cr),
  arc ($w/2, $h/2 - $cr) ($w/2 - $cr, $h/2) radius:$cr,
  (-$w/2 + $cr, $h/2),
  arc (-$w/2 + $cr, $h/2) (-$w/2, $h/2 - $cr) radius:$cr,
  (-$w/2, -$h/2 + $cr),
  arc (-$w/2, -$h/2 + $cr) (-$w/2 + $cr, -$h/2) radius:$cr
] | extrude 5

パス

line start end
arc start through end
arc start end center:(cx,cy)
arc start end radius:radius
bezier points
helix pitch height radius
spline points

spline は制御点を通る滑らかなBスプライン曲線を作ります。sweep のパスとして使えます。

spline [(0,0,0), (10,5,5), (20,0,10)] | sweep (circle 3)

注意: bezier/spline のリスト規約は文脈によって異なります。standaloneコマンド（bezier [...] | sweep 等）ではリスト先頭に開始点を含めます。一方、sketch/wire セグメント内では開始点は前セグメント終端(current)から暗黙に引き継がれるため、リストには制御点/通過点と末尾の終点のみを指定します。これはCadQueryやSVGパスの業界標準と同じ規約です。

パイプ操作

操作は | でつなぎます:

box 50 50 10 | fillet 2 | diff cylinder 5 10

修飾

| fillet expr              # 全エッジをフィレット
| chamfer expr             # 全エッジを面取り
| shell expr               # 薄肉化（先に面を選択すると開口面になる）
| offset d                 # ワイヤまたは面の外形をオフセット（正=外側、負=内側）

box 100 60 40
 | edges =Z | fillet 3
 | faces >Z | shell 2

fillet は2Dワイヤにも使えます。角丸の2Dプロファイルを作れます:

rect 40 20 | fillet 3 | extrude 10     # 角丸の四角形を押し出し

offset は2つのコンテキストで動作します:

• Face選択コンテキスト: 選択された面の外形ワイヤーを抽出し、workplaneを作成してオフセットします。→ 2Dコンテキストへ遷移
• 2Dコンテキスト: 既存のワイヤーをオフセットします。→ 2Dコンテキストを維持

# Face選択 → offset → cut
box 80 60 10
 | faces >Z
 | offset -10
 | cut 3

# 2D → offset
rect 80 60 | offset -10 | extrude 5

色指定

形状に色を付けます。色はエクスポート時（glTF/STEP）にパーツ単位で反映されます。

| color "red"                    # 名前付き色
| color "#FF0000"                # HEXカラー（文字列リテラル）
| color "#F00"                   # HEX短縮形
| color 0.8 0.2 0.1             # RGB float (0..1)
| color 255 128 0               # RGB int (0..255、自動正規化)
| color "red" alpha:0.5         # 透明度付き

色の指定方法は3種類です:

• 名前付き色: "red", "blue", "steel" など
• HEXカラー: "#FF0000" または短縮形 "#F00"（# はコメント記号と衝突するため、必ず文字列リテラルとして書きます）
• RGB値: 3つの数値を並べます。全て1以下なら 0..1 範囲、いずれかが1を超えれば 0..255 範囲として自動的に正規化されます

alpha: キーワード引数で透明度を指定できます（0..1、デフォルト 1.0）。

パーツごとに色を分けることもできます:

union [
  box 10 10 10 | color "red"
  cylinder 15 3 | color "blue"
]

名前付き色パレット

3段階の色パレットを使えます:

未知の色名を指定するとエラーになります。

ブーリアン

| diff shape               # 形状を引く
| union shape              # 形状を足す
| inter shape              # 形状と交差

at: で配置できます:

box 50 50 10
 | diff cylinder 3 10 at:15 15

配置（Place）

変数に格納した2D形状をパイプラインで配置します。diff/union/inter と同様に、変数参照やインラインの2Dプリミティブを引数に取れます。

| place $shape                # 変数の2D形状を配置
| place (circle 3)            # インライン2Dプリミティブ

面を選択した後、あらかじめ定義したプロファイルを置いてカットや押し出しに使えます。同じ形状を何度も使い回したいときに便利です。

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

$profile = rect 5 5
box 10 10 10 | faces >Z | place $profile | cut

box 10 10 10 | faces >Z | place (circle 3) | cut

押し出し / 回転体 / スイープ / ロフト

| extrude height draft:angle
| revolve axis [deg]         # axis: X/Y/Z、deg省略で360°
| sweep profile              # pipeline側が path(spine)、引数が profile(断面)
| loft [sections] height
| loft [sections] [offsets]
| loft [sections] height ruled:true

rect 60 40 | extrude 15
rect 10 30 at:(15, 0) | revolve Y
circle 5 | loft [rect 8 8] 10
circle 5 | loft [rect 8 8, circle 3] [5, 15]

draft: は抜き勾配（テーパー角）を度数で指定します。正値は押し出し方向に向かって外側に広がります。

ruled:true を指定すると、断面間を直線で補間します（デフォルトは滑らかな曲面）。

revolve – 回転体

2Dプロファイルを指定軸まわりに回転してソリッドを作ります。

| revolve axis         # 360°回転（axis: X, Y, Z のいずれか）
| revolve axis deg     # 指定角度で回転

プロファイルは回転軸の片側に配置する必要があります。 軸をまたぐプロファイル（例: 原点中心の circle 20）は退化形状エラーになります。原点から離すには at:(x, y) を使うか、sketchで軸の片側にワイヤを描きます。

# リング（トーラス様）
rect 10 30 at:(15, 0) | revolve Y

# 花瓶/お椀（半周）
sketch [(0, 0), (15, 0), (15, 3), (3, 20), (0, 20)]
  | revolve Y 180

# X軸周りの回転
circle 5 at:(0, 20) | revolve X

sweep – パススイープ

パイプラインで渡したパス（spine）に沿って、引数のプロファイル（断面）を押し出して3D形状を作ります。pathにもprofileにも任意のwireが使えます。

構文: path | sweep profile

• 開いたwire: line, arc, bezier, spline, helix
• 閉じたwire: circle, rect, ellipse, polygon, polyline(閉形), sketch [...]

pathとprofileの組み合わせで、生成される形状が変わります:

# 通常の管: 曲線パスに沿って円を掃引
arc (0, -25) (25, 0) center:(0, 0) | sweep (circle 5)

# トーラス: 大半径50、小半径10
circle 50 | sweep (circle 10)

# スプラインに沿ったパイプ
spline [(0,0,0), (10,5,5), (20,0,10)] | sweep (circle 3)

注意: sketch [...] は常に自動closeされる（閉じたwireを生成する）ため、sweepのpathには使えません。開いた複数セグメントのパスが必要なら、wire [...] リテラルか、line/arc/splineなどのpathプリミティブを使ってください。

path – open wireリテラル

sketch [...] の「開いた版」です。複数セグメントをつないだ開いたwire（auto-closeしない）を作ります。sweepのpath(spine)に複合的な経路が必要なとき、これ1つで書けます。

wire [
  segment1,
  segment2,
  ...
]

セグメントは sketch と同じ書き方が使えます（tarc を除く）。さらに2D座標だけでなく3D座標も使えます。

sketchとの違い:

# 基本: 直線 + 円弧を組み合わせた経路
wire [
  (0, 0),
  (10, 0),
  arc (10, 0) (15, 5) radius:5,
  (15, 20)
]

# sweepと組み合わせ: L字パイプ（wire がpath、circleがprofile）
wire [
  (0, 0),
  (10, 0),
  arc (10, 0) (15, 5) radius:5
] | sweep (circle 5)

# 3Dパスもそのまま書ける
wire [(0, 0, 0), (10, 0, 5), (20, 10, 10)]

# workplane経由: XZ平面上にパスを描き、円断面で掃引
workplane XZ | wire [(0,0),(10,0),(10,10),(0,10),(0,0)] | sweep (circle 2)

sketchと同様に、wireもパイプでworkplaneを受け取れます。デフォルトのXY平面以外にもパスを描けます。

sweepでの使い分けガイド

カット / 穴あけ

| cut depth                # 貫通カットまたは指定深さまでカット
| hole radius depth:d      # 穴あけ（半径指定、直径ではない）

hole はFaceSelectionとPointSelectionの両方から使えます。

• FaceSelectionから: 選択した面の中心に穴を開けます。faces >Z | hole 5 は faces >Z | circle 5 | cut と同等です。複数面を選択した場合は各面の中心にそれぞれ穴が開きます。
• PointSelectionから: 各ポイントの位置に穴を開けます（従来の動作）。

深さ（depth:）を省略すると貫通穴になります。

at: で穴の位置を指定できます。origin: で座標基準を制御します（後述「座標指定の基準」参照）。

# Face選択から: 面の中心に穴
box 80 60 10 | faces >Z | hole 5

# Point選択から: 各ポイントに穴
box 80 60 10 | faces >Z | points (polar 4 15) | hole 5

# WP座標 (10,20) に穴
box 80 60 10 | faces >Z | hole 5 at: 10 20

# ワールド原点を面に投影して穴
box 80 60 10 | faces >Z | hole 5 at: 0 0 origin:"world"

# ワールド座標 (10,20,0) に穴（3成分はワールド基準）
box 80 60 10 | faces >Z | hole 5 at: 10 20 0

rect 60 40 | extrude 15
 | faces top
 | rect 40 20 | cut 10

面 / エッジ / 頂点選択

| faces selector           # 面を選択
| edges selector           # エッジを選択
| verts selector           # 頂点を選択

セレクタは短い記号または名前エイリアスを使います:

複合セレクタ

複数のセレクタをスペース区切りで並べるとAND（絞り込み）になります:

| edges >Z >X          # Z最大位置 かつ X最大位置のエッジ

リスト構文で囲むとOR（和集合）になります:

| edges [>Z, <Z]       # Z最大位置 または Z最小位置のエッジ

名前付け（as）

as で面やエッジに名前を付けて後から参照できます:

| faces <X as $left
| edges =Z as $top_edges

面を選択するとワークプレーンが暗黙的に作られるため、2Dプリミティブを直接パイプできます:

box 50 50 10
 | faces top
 | circle 5 | cut
 | edges <Z | fillet 1

2Dコンテキストでは、verts は現在の形状の頂点をVertex selectionとして返します。 Vertex selectionは2D/3Dプリミティブの両方に対応しており、各頂点にプリミティブが配置されます:

box 80 60 10
 | faces top
 | rect 70 50 | verts | circle 1 | cut

3Dプリミティブも同様です。各頂点が配置ポイントになります:

rect 100 100 | verts | box 1 1 1       # 4つの頂点にboxを配置
rect 100 100 | verts | sphere 2         # 4つの頂点にsphereを配置

Vertex selectionは translate で全頂点の位置をオフセットでき、選択コンテキストを維持します。Points selection (points) も同様です:

rect 80 60 | verts | translate 10 10 10 | cone 2 0 6
box 80 60 10 | faces >Z | points (polar 4 15) | translate 5 5 0 | hole 3

ワークプレーン / ポイント

面選択は暗黙的にワークプレーンを作成します。明示的な workplane は特定の向きが必要な場合にのみ使います:

| workplane XZ              # 軸を明示したワークプレーン
| points (polar 6 20)       # 円形にポイントを配置
| points (grid nx ny 20)    # 格子状にポイントを配置（第3引数=ピッチ）

ソースコマンドとして workplane を使うと、2Dプリミティブ・sketch・wireの初期平面を指定できます:

workplane XZ | circle 10 | extrude 10       # XZ平面上に円
workplane XZ | sketch [...] | extrude 5     # XZ平面上にsketch
workplane XZ | wire [...] | sweep (circle 2) # XZ平面上にpath

# Face選択から直接 hole（面の中心に穴）
cylinder 30 5 | faces top | hole 3

# Point選択から hole（各ポイントに穴）
cylinder 30 5
 | faces top
 | points (polar 4 10)
 | hole 3

polar / grid 省略形

FaceSelectionまたはPointSelectionコンテキストでは、points を省略して polar / grid を直接パイプできます。

# 省略形（面選択の後で使える）
cylinder 30 5 | faces top | polar 4 10 | hole 3
box 80 60 10 | faces top | grid 3 2 15 | circle 2 | cut

上記は以下と同じ意味です:

cylinder 30 5 | faces top | points (polar 4 10) | hole 3
box 80 60 10 | faces top | points (grid 3 2 15) | circle 2 | cut

3Dコンテキストでは polar / grid は従来通り配列複製として動作します。コンテキストによって意味が変わる点に注意してください。

変形

| translate x y z
| rotate rx ry rz
| scale sx sy sz             # 非一様スケール（各軸個別）
| scale s                    # 一様スケール（全軸同じ倍率）
| mirror "X"/"Y"/"Z"
| floor                      # 底面を z=0 に揃える
| move dx dy           # ワークプレーン上の2Dオフセット
| moveto x y           # ワークプレーン上の2D絶対位置

mirror は指定した軸に垂直な平面で鏡像反転します。"X" はYZ平面、"Y" はXZ平面、"Z" はXY平面です。

box 30 20 10 | mirror "X"    # YZ平面でミラー

floor – 底面をz=0に揃える

任意の3D形状のバウンディングボックス下端(zmin)を z=0 に揃えます。引数なし。

| floor

内部的には translate 0 0 -bbox.zmin と同等の処理を行います。centeredなプリミティブを底面合わせにしたいとき、center:(true,true,false) の代わりにパイプ1つで済むのが利点です。

# box (centered) の底面を z=0 に
box 10 10 10 | floor           # z=-5..+5 → z=0..10

# sphere でも同様
sphere 15 | floor              # z=-15..+15 → z=0..30

# 合成形状にも使える
union [box 20 20 10, cylinder 5 20] | floor

注意: floor はパイプ操作（形状を移動する）です。数学関数の floor(x)（切り捨て）とは別物です。

move はワークプレーン上で描画位置を相対移動、moveto は絶対位置に移動します。origin: で座標基準を切り替えられます（後述「座標指定の基準」参照）。

box 80 60 10
 | faces top
 | move 10 10 | circle 5 | cut      # 面の中心から(10,10)ずらした位置に穴
 | moveto 30 20 | rect 5 5 | cut    # ワークプレーン原点から(30,20)にポケット

# ワールドXY座標を面に投影
| moveto 10 20 origin:"world"

# 任意のワールド点を新原点にして相対移動
| moveto 5 5 origin:(10,20,0)

# ワールドXYのデルタで移動
| move 10 0 origin:"world"

origin: キーワード引数

translate、rotate、scale は origin: キーワード引数で基準点を指定できます。

# ワールド原点中心に回転（デフォルト）
box 10 10 10 | translate 20 0 0 | rotate 0 0 45

# オブジェクト中心で回転
box 10 10 10 | translate 20 0 0 | rotate 0 0 45 origin:"local"

# 任意の点を中心に回転
box 10 10 10 | rotate 0 0 45 origin:(10, 20, 0)

# 一様スケール（原点基準で2倍）
box 10 10 10 | scale 2

# 非一様スケール
box 10 10 10 | scale 2 1 0.5

# オブジェクト中心を基準にスケール
box 10 10 10 | translate 20 0 0 | scale 3 origin:"local"

move、moveto、hole、プリミティブのat: でも origin: が使えます。詳しくは次の節を参照してください。

座標指定の基準（at: と origin:）

at: で位置を指定するとき、座標の解釈基準は成分数で暗黙的に決まります。origin: を使えば明示的に切り替えられます。

既定の基準（origin: 省略時）:

明示指定:

ワールド座標（3成分、または origin:"world" 指定の2成分）は、現在のワークプレーンの面に法線方向で投影されます。

origin: は以下の操作で使用できます:

• at: を持つプリミティブ: circle, rect, ellipse, polygon, box, cylinder, sphere, cone, torus, wedge
• 穴あけ: hole（at: と組み合わせ）
• カーソル移動: moveto, move
• 変形: translate, rotate, scale

# 2成分 at: はWP原点基準（既定）
faces >Z | circle 5 at: 10 20                   # WP座標 (10,20) に配置

# 3成分 at: はワールド座標（既定）
faces >Z | circle 5 at: 10 20 0                 # ワールド(10,20,0) を投影

# origin:"world" で2成分もワールド基準に
faces >Z | circle 5 at: 10 20 origin:"world"    # ワールドXY (10,20) を投影

# origin:(ox,oy,oz) で任意のワールド点を基準に
faces >Z | circle 5 at: 5 5 origin:(10,20,0)    # (10,20,0) から相対WP(5,5)

# hole でも同様
faces >Z | hole 5 at: 0 0 origin:"world"        # ワールド原点に穴

変数

変数名の $ プレフィックスはオプションです。$w = 80 でも w = 80 でも動作します。予約語（box, cylinder, if, for など）は変数名に使えません。

w = 80
h = 60
box w h 10

# $付きも有効（後方互換）
$w = 80
box $w $h 10

@paramアノテーション

変数に @param を付けると、GUIカスタマイザーでスライダーやドロップダウンとして操作できるパラメーターになります。変数宣言の直前の行に書きます。

@param 10..200 step:5 desc:"Box width"
$width = 80

box $width 60 10

これだけで、GUIには10から200まで5刻みのスライダーが表示されます。

基本構文

@param オプション...
$変数名 = デフォルト値

範囲ショートハンド

よく使うmin/max/stepパターンを短く書けます:

ショートハンドの後にオプションを追加することもできます:

@param 1..100 desc:"Height"

オプション一覧

type を省略すると、デフォルト値から自動推論されます（42 ならint、2.5 ならfloat、"PLA" ならstring、true ならbool）。

選択肢（ドロップダウン）

choices を使うと、ドロップダウンメニューとして表示されます:

@param choices:["M3", "M4", "M5", "M6"] desc:"Bolt size"
$bolt = "M4"

実用的な例

@param 40..200 step:5 group:"Dimensions" desc:"Case width"
$case_w = 100

@param 30..150 step:5 group:"Dimensions" desc:"Case depth"
$case_d = 60

@param 1..5 step:0.5 group:"Wall" desc:"Wall thickness"
$wall = 2

@param type:"bool" group:"Features" desc:"Add ventilation holes"
$vents = true

box $case_w $case_d 40
 | color "steel"
 | faces >Z | shell $wall

パラメーターセット（JSON）

PolyScriptファイル model.ps に対して model.ps.params.json を同じディレクトリに置くと、パラメーターのメタ情報やプリセットを外部から定義できます:

{
  "params": {
    "width": { "min": 10, "max": 200, "step": 5 }
  },
  "parameterSets": {
    "Default": {},
    "Small": { "width": 30, "height": 20 },
    "Large": { "width": 150, "height": 80 }
  }
}

JSON側の設定はソース内の @param より優先されます。ただし、ソースに変数宣言がないパラメーターはJSON側に記述があっても無視されます。

CLIからの上書き

poly build コマンドの -D key=value オプションで、ビルド時にパラメータを上書きできます。--params-file でJSONファイルからまとめて指定することもできます。

poly build model.poly -D width=100 -D height=50
poly build model.poly --params-file presets/large.json

-D の値は型推論されます(100 → int, 1.5 → float, true → bool, PLA → string)。同じキーが複数のソースで指定された場合の優先順位は次のとおりです。

1. CLI -D
2. --params-file
3. .poly.params.json の parameterSets.default
4. @param のデフォルト値

ソースに定義されていないパラメータ名を -D で渡した場合は警告が表示されますが、実行は続行します。

詳しくは「はじめに」を参照してください。

関数

def で単一式の関数を定義します:

def standoff($r, $h, $hole_r) = cylinder $r $h | diff cylinder $hole_r $h

box 80 60 3
 | union standoff 4 10 1.5 at:10 10

インポート

別の .poly ファイルから関数定義を読み込みます:

import "gear"

spur_gear 12 2 | extrude 8

インポートは読み込み元ファイルのディレクトリからの相対パスで解決されます。

式

算術演算

+  -  *  /  //  %  **

注意: マイナス記号 - は数値にくっつけて書きます。-1 は有効ですが、- 1（スペースあり）はエラーになります。

比較と論理演算

==  !=  <  >  <=  >=
and  or

条件式

if condition then expr else expr

if/then/else は式なので、インラインで使えます:

$use_round = true
$shape = if $use_round then circle 10 else rect 20 15
$shape | extrude 5

リスト内包表記

[$expr for $var in range($n)]

実用例:

# 15mm間隔で6個のボックスを配列
union [box 10 10 10 at:($i * 15, 0) for $i in range(6)]

# 同心円
[$r * 5 for $r in range(1, 6)]

数学関数

sin, cos, tan, asin, acos, atan, atan2, sqrt, radians（別名: rad）, degrees（別名: deg）, floor, ceil

定数: pi

タプルとリスト

(10, 20, 30)              # タプル
[(0,0), (10,5), (20,0)]   # リスト

ブーリアン演算（ソースコマンド）

union、diff、inter はパイプなしのソースコマンドとして複数形状を結合できます:

union [box 10 10 10, sphere 7]     # 形状を結合
diff [box 10 10 10, sphere 7]      # 2番目を1番目から引く
inter [box 10 10 10, sphere 7]     # 交差部分のみ残す

パイプ操作としても使えます:

box 10 10 10 | union (sphere 7)
box 10 10 10 | diff (cylinder 3 20)

注意: [] は常にリストリテラルです。形状を結合するには union [...] と明示的に書きます。

配置

at: は形状を指定位置に配置する名前付き引数です。at の直後にコロン : を付けて書きます。

カッコのルール:

• 単純な座標（リテラル・変数）: カッコ省略可（推奨）。at:20 0 0
• 式を含む場合: カッコ必須。at:($x+1, $y+1)
• 座標リスト: ブラケット必須。at:[(0,0), (10,0)]
• カッコ付き at:(x, y) も常に有効。
• 配列複製には | grid や | polar パイプ操作を使います。

sphere 5 at:20 0 0                      # 単純な位置（カッコ省略推奨）
sphere 5 at:$x $y                       # 変数もOK
sphere 5 at:($x+1, $y+1)               # 式を含む場合はカッコ必須
sphere 5 at:[(0,0), (10,0), (20,0)]    # 複数位置（ブラケット必須）
sphere 5 | polar 6 20                   # 円形配列（パイプ操作）
sphere 5 | grid 3 3 20                  # 格子配列（パイプ操作）

同様に、angle: 名前付き引数で形状を回転配置できます:

rect 10 5 angle:45                      # 45度回転した矩形

コメント

# これはコメントです