Blender を AI に動かしてもらう入門
— 環境構築からサイコロ・ドーナツまで

brew install --cask blender

winget install BlenderFoundation.Blender

blender --version

# 最初の1本：立方体を置いて、画像に書き出すだけ
import bpy, os

bpy.ops.wm.read_factory_settings(use_empty=True)        # 空のシーンから始める
bpy.ops.mesh.primitive_cube_add(size=1, location=(0, 0, 0.5))   # 立方体
bpy.ops.object.camera_add(location=(3, -3, 2.5), rotation=(1.1, 0, 0.785))
bpy.context.scene.camera = bpy.context.object             # このカメラで撮る
bpy.ops.object.light_add(type="SUN", rotation=(0.7, 0.3, 0.6))  # 斜めから差す太陽光
bpy.context.object.data.energy = 4
world = bpy.data.worlds.new("World")                      # 空（背景）の明るさ
bpy.context.scene.world = world
world.use_nodes = True
world.node_tree.nodes["Background"].inputs["Color"].default_value = (0.15, 0.17, 0.2, 1)

scn = bpy.context.scene
scn.render.engine = "BLENDER_EEVEE"                       # 速い描画方式
scn.render.resolution_x, scn.render.resolution_y = 800, 600
scn.render.filepath = os.path.join(os.path.dirname(__file__), "cube.png")  # 台本と同じ場所に保存
bpy.ops.render.render(write_still=True)

blender -b --python first_cube.py

bpy.ops.mesh.primitive_cube_add(size=S, location=(0, 0, h))
die = bpy.context.object; die.name = "Die"
bv = die.modifiers.new("bevel", "BEVEL"); bv.width = 0.09; bv.segments = 6

ivory = mat("ivory", (0.93, 0.91, 0.86), rough=0.25, sss=0.05)
black = mat("pip_black", (0.02, 0.02, 0.02), rough=0.3)
red = mat("pip_red", (0.7, 0.02, 0.02), rough=0.3)
# …（目の配置表と、各面への球の配置は省略）…

# 目をひとつにまとめてからくり抜く（くぼみの面に目の色が移る）
bpy.ops.object.select_all(action="DESELECT")
for s in pips: s.select_set(True)
bpy.context.view_layer.objects.active = pips[0]
bpy.ops.object.join()
cutter = bpy.context.object; cutter.name = "Pips"
bo = die.modifiers.new("pips", "BOOLEAN")
bo.object = cutter; bo.operation = "DIFFERENCE"; bo.material_mode = "TRANSFER"
cutter.hide_render = True; cutter.hide_viewport = True
bpy.ops.object.select_all(action="DESELECT")
die.select_set(True); bpy.context.view_layer.objects.active = die
# 角を丸めてから（bevel）くり抜く（boolean）順に確定させる
bpy.ops.object.modifier_apply(modifier="bevel")
bpy.ops.object.modifier_apply(modifier="pips")

R, r = 1.0, 0.45  # 大半径（中心から管の中心まで）・小半径（管の太さ）
bpy.ops.mesh.primitive_torus_add(major_radius=R, minor_radius=r,
                                 major_segments=96, minor_segments=32, location=(0, 0, r * 0.8))
dough = bpy.context.object; dough.name = "Dough"
dough.scale.z = 0.8  # 少し平たく
# 手作り感：表面をわずかに凸凹させる
tex = bpy.data.textures.new("lumps", "CLOUDS"); tex.noise_scale = 0.35
dp = dough.modifiers.new("lumps", "DISPLACE"); dp.texture = tex; dp.strength = 0.04

# アイシング：生地を複製して上側だけ残す
bmesh.ops.delete(bm, geom=[v for v in bm.verts if v.co.z < -0.08 * r + 0.06 * math.sin(8 * math.atan2(v.co.y, v.co.x))], context="VERTS")
sol = icing.modifiers.new("thick", "SOLIDIFY"); sol.thickness = 0.03; sol.offset = 1
dp2 = icing.modifiers.new("lumps", "DISPLACE"); dp2.texture = tex; dp2.strength = 0.04
sub = icing.modifiers.new("smooth", "SUBSURF"); sub.levels = 1; sub.render_levels = 2

Blender 5.2 を blender -b --python で動かして、サイコロを作ってほしい。
- 角を丸めた立方体に、球でくり抜いた目をつける
- 向かい合う面の和は7。1の目だけ赤く大きく
- 画像（PNG）と .blend を out/ に保存
- できたら、目の数を台本で数えて報告して
- 画像を自分で見て、おかしいところがあれば直して

blender -b --python dice.py
blender -b --python donut.py