OpenSCADの使い方

オブジェクト操作

3Dオブジェクト生成

直方体
```
    cube([8,15,20]);
    
```
球体
```
    sphere(10);
    
```

柱や錐 cylinder

    cylinder(h=20, r=8); // 円柱
    cylinder(h=20, r1=8, r2=8); // 円柱
    cylinder(h=20, r1=10, r2=0); // 円錐
    cylinder(h=20, r1=8, r2=8, $fn=5); // 多角柱
    cylinder(h=20, r1=10, r2=0, $fn=5); // 多角錐

頂点列と面 polyhedron

    CubePoints=[[,,],[,,],[,,],[,,],[,,],[,,],[,,],[,,]]
    CubeFaces=[[,,,],[,,,],[,,,],[,,,],[,,,],[,,,]]	// 時計回り頂点番号
    polyhedron( CubePoints, CubeFaces );

移動 translate

  translate([20,0,0]) オブジェクト

色指定 color

  color([0.5,0,0]) オブジェクト
  color("cyan") オブジェクト
  module my_red() color([200/255,120/255,120/255]) children();
  % オブジェクト // 半透明グレー

合成（演算）

OR（結合） union

    union(){オブジェクト;オブジェクト;}

差分（減算） difference

    difference(){オブジェクト;オブジェクト;}

AND（交差） intersection

    intersection(){オブジェクト;オブジェクト;}

回転 rotate

  rotate(a=[0,20,0]) オブジェクト

拡大縮小 scale

  scale(v=[1,1,0.5]) オブジェクト

サイズ変更 resize

  resize(newsize=[1,1,0.5]) オブジェクト
  resize([2,2.0]) オブジェクト	// 0は元のまま

鏡像 mirror

  mirror(v=[x,y,z]) オブジェクト

アフィン変換 multmatrix

  multmatrix(m=[[,,,],[,,,],[,,,],[,,,]]) オブジェクト

ミンコフスキ和 minkowski
```
  minkowski() オブジェクト
  
```
凸包 hull
```
  hull() オブジェクト
  
```

2Dオブジェクト生成

正方形 square
```
    square(20)
    square([x,y])
    
```

ポリゴン polygon

    polygon(points=[[,],[,],[,],[,],[,],[,]]);

points

テキスト text

    text("テキスト", 20)

size

font

      font = str("Liberation Sans", ":style=Bold")

MS PGothic, MS Gothic, HGPGothicM

spacing
halign
valign
$fn

2Dオブジェクト操作

内部または外部に図形生成 offset

    offset(r=10) 2Dオブジェクト		// 外側（角円）
    offset(delta=10) 2Dオブジェクト	// 外側
    offset(r=-10) 2Dオブジェクト	// 内側（角円）
    offset(delta=-10) 2Dオブジェクト	// 内側

r
delta

塗りつぶし fill（開発スナップショット版が必要）
```
    fill() 2Dオブジェクト
    
```

押し出し（2Dから3D）

線形 linear_extrude

    linear_extrude(height=60, twist=90, slices=60) 2Dオブジェクト
    linear_extrude(10) 2Dオブジェクト
    linear_extrude(height=60, scale=3) 2Dオブジェクト	// 錐的に広がる

height
scale
twist
slices
center

回転 rotate_extrude（断面形状からドーナッツオブジェクト生成）

    rotate_extrude(convexity=10) 2Dオブジェクト
    rotate_extrude(angle=270, convexity=10) 2Dオブジェクト

angle
convexity
$fn

投影（3Dから2D） projection

  %import("projection.stl");
  projection(cut=true)

サーフェス surface

テキストファイルからサーフェス生成

    surface(file="surface.dat", center=true, convexity=5);
    %translate([0,0,5]) cube([10,10,10], center=true);

画像からサーフェス生成（PNG画像のグレー値を高さに変換）
```
    surface(file = "file.png", center = true, invert = false);
    
```

コーディング

モジュール module

  module 名前() { ... }

任意モジュール指定
```
    children()
    
```

任意モジュールインデックス指定

    for (i = [0:$children-1]) children(i);

  // コメント
  /* コメント */

繰り返し for

  for (i = [-10:10])
  for (i = [-10:3:10])
  for (c = "String") c

ローカル変数代入 let
```
  let(x=値)
  
```
特殊変数
- $fa フラグメントの最小角度（デフォルト12）
- $fs フラグメントの最小サイズ（デフォルト2）
- $fn フラグメントの数（デフォルト0、128以下、推奨50未満）
- $t アニメーション
- $vpr レンダリング時ビュー：回転
- $vpt レンダリング時ビュー：平行移動
- $vpf レンダリング時ビュー：FOV(Field of View)
- $vpd レンダリング時ビュー：カメラ距離
検索 search
```
  search
  
```

アサート assert

  assert(論理式);
  assert(論理式,メッセージ);

コンソール出力 echo
```
  echo("val: ", x, y)
  
```

関数 function

  function f1(x, y) = echo("f1: ", x, y)  x * y + 1;
  r1 = f1(3, 5);
  function f2(x) = let(y = pow(x, 3)) echo("f2: ", y) y;
  r2 = f2(4);
  function result(x) = echo("f3: ", x) x;
  function f3(x) = result(x * x - 5);
  r3 = f3(5);

リスト内包表記

  polygon([for (i=[0:num-1], a=i*360/num) [ r*cos(a), r*sin(a) ]]);

リスト
```
  concat(v1,v2,v3);
  
```

再帰

  function factorial(n) = n == 0 ? 1 : factorial(n - 1) * n;

乱数

  rands(min_value,max_value,value_count);
  rands(min_value,max_value,value_count,seed_value);

小数を整数に丸める
```
  int = round(float)
  
```

基本操作

プレビュー（描画）
- F5キーまたはメニューDesign/Preview
レンダリング（描画）
- F6キーまたはメニューDesign/Render
STLファイル書き出し
- レンダリング（F6キー）後に、F7キーまたはメニューFile/Export / Export as STL
テキストエディアでの数値対話的変更
- コード中の数値の後にカーソルを置き、ALT+上下矢印で数値を増減する、オブジェクトは自動的イン再描画（レンダリング）される
- ALT+左右矢印で数値の桁を移動する

その他

Export as Imageの背景色を変えるには、C:\Program Files\OpenSCAD\color-schemes\render\nature.jsonを複製して編集し、 OpenSCADを起動して、Edit/Preferencesで3D Viewで編集したColor schemeを指定する

参考

OpenSCAD User Manual