一辺の大きさが1の立方体を追加する (Python for Blender クックブック)
Pythonを使ってBlenderでできる事をまとめています。解説もあります。
Pythonの難易度: ★☆☆☆☆
動機
普通の立方体追加で追加される立方体は一辺の長さが2です。
スクリプトを使うことで、最初から長さ1の立方体を追加してみましょう。
細かい仕様
- オブジェクトモードのとき、一辺の長さが1の立方体を追加してください。
- スケールは1にしてください。
- 3Dカーソルの位置に立方体を追加してください。
サンプルコード
import bpy
bpy.ops.mesh.primitive_cube_add(radius=0.5)
上記サンプルコードを、Blender内蔵のテキストエディタに貼り付けた後、Alt-Pを実行してください。
解説
import bpy
PythonからBlenderを使うにはbpyというライブラリを使います。
例えば、bpy.opsにはBlenderで編集するための関数が入っています。
内蔵Python Consoleで実行するときは既にimportされていますが、テキストエディタや外部ファイルの時はimport文が必要です。
bpy.ops.mesh.primitive_cube_add(radius=0.5)
まず、Shift-Aから、立方体を追加してみましょう。（被るので適宜消してください）
次に、infoバーを引き下げると現れるコマンド履歴を見てみてください。
bpy.ops.mesh.primitive_cube_add(radius=1, view_align=False, enter_editmode=False, location=(0, 0, 0), layers=(True, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False))
というコマンドがあると思いますので、コピーしてBlender内蔵のPython Consoleに貼り付けてください。
すると、先ほどと同じ位置に同じ大きさの立方体が追加されました。
今度は、
bpy.ops.mesh.primitive_cube_add(
のように、閉じカッコなしで貼り付けたあと、AutoCompleteを押してください。すると、
>>> bpy.ops.mesh.primitive_cube_add(
primitive_cube_add()
bpy.ops.mesh.primitive_cube_add(radius=1, calc_uvs=False, view_align=False,
enter_editmode=False, location=(0, 0, 0), rotation=(0, 0, 0),
layers=(False, False, False, False, False, False, False, False, False, False, False,
False, False, False, False, False, False, False, False, False
))
のように、様々な引数とそのデフォルト値が表示されます。
| 引数 | 内容 | 型 |
|---|---|---|
| radius | 立方体の大きさ | float |
| calc_uvs | UVを自動生成するか | bool |
| view_align | 立方体の配置を視点と合わせるか | bool |
| enter_editmode | 追加後、編集モードに切り替えるか | bool |
| location | 座標 | floatのtuple（長さ3） |
| rotation | 回転 | floatのtuple（長さ3） |
| layers | どのレイヤーに追加するか（Trueのレイヤーにだけ追加) | boolのtuple（長さ20） |
この中で大きさに関係するのは、radiusですが、デフォルト値の1では2倍も大きすぎます。
これを半分にすると、一辺の大きさが1の立方体が追加できます。
bpy.ops.mesh.primitive_cube_add(radius=0.5)