概要
JupyterからBlenderを使ってみたメモです。
JupyterからBlenderを使うには
記事「Jupyter NotebookからPythonのAPIでBlenderを操作する」の通りにしてできました。
以降では下記を実行しているとします。
from pathlib import Path
from subprocess import run
import bpy
from mathutils import Vector
from ipywidgets import interact
コマンドの関数を取得するには
メニューやボタンで、Ctrl + Cを押すと実行用のコードを取得できます。
あるいは、コマンドを実行すると、情報画面に実行したコードが出力されます。
これらのコードはメニューと同じ動作ですが、複数回実行する場合に効率的でないこともあります。
実際に立方体を作成して実行時間を比較してみましょう。
実行時間の比較
メニューのコード（立方体作成）
%timeit -n 5 -r 5 bpy.ops.mesh.primitive_cube_add()
>>>
1.02 ms ± 138 µs per loop (mean ± std. dev. of 5 runs, 5 loops each)
低レベルのコード（立方体作成）
%%timeit -n 5 -r 5
pts = [[-1, -1, -1], [-1, -1, 1], [-1, 1, -1], [-1, 1, 1], [1, -1, -1], [1, -1, 1], [1, 1, -1], [1, 1, 1]]
verts = [Vector(pt) for pt in pts]
faces = [[0, 1, 3, 2], [4, 5, 7, 6], [0, 1, 5, 4], [2, 3, 7, 6], [0, 2, 6, 4], [1, 3, 7, 5]]
mesh = bpy.data.meshes.new(name="Cube")
mesh.from_pydata(verts, [], faces)
obj = bpy.data.objects.new(mesh.name, mesh)
bpy.context.scene.collection.objects.link(obj)
>>>
58.7 µs ± 7.88 µs per loop (mean ± std. dev. of 5 runs, 5 loops each)
低レベルのコードの方が、ややこしいですが10倍以上速いです。
関数のヘルプを見るには
通常、Jupyterでは、カーソルを関数にあるところでCtrl + Tabを押すとヘルプが見れます。しかし、Blenderの関数だと、詳しくわからないことがあります。その場合は、関数の括弧をつけずに実行すると、デフォルトの引数を確認できることがあります。
引数の書き方
Blenderの関数のいくつかは、位置引数ではなくキーワード引数にしないといけないことがあります。
インタラクティブ操作
Jupyterでは、ipywidgetsを使って、関数の引数をインタラクティブに変更できます。
以下を実行すると、プルダウンから立方体の色を変更できるようになります。
@interact
def cube_color(color={"red": (1, 0, 0), "green": (0, 1, 0), "blue": (0, 0, 1)}):
if not (obj := bpy.data.objects.get("Cube")):
bpy.ops.mesh.primitive_cube_add()
obj = bpy.context.object
if not obj.active_material:
obj.active_material = bpy.data.materials.new("Material")
mat = obj.active_material
mat.use_nodes = False
mat.diffuse_color = color + (1,)
ちなみに、Jupyter Labだと、ipywidgetsが表示されませんでした。
複数のblendファイル
Jupyterから複数のblendファイルも扱えます。
下記は、特定のフォルダのblendファイルのオブジェクト数を出力するコードです。
%%time
for fnam in Path(特定のフォルダ).glob("*.blend"):
bpy.ops.wm.open_mainfile(filepath=str(fnam))
print(len(bpy.data.objects))
>>>
Wall time: 131 ms
blenderのコマンドで、同様のことができますが、時間がかかります。
%%time
cmd = "/Applications/Blender.app/Contents/MacOS/Blender"
for fnam in Path(特定のフォルダ).glob("*.blend"):
run([cmd, "-b", fnam, "--python-expr",
'print(len(__import__("bpy").data.objects))'])
>>>
Wall time: 2.98 s
20倍以上の時間がかかっています。
以上