Blender Blockout Pawns → AI動画プリビズ
このスキルは2つのことを行います。
- BlenderでIdoの参照プリビズルックを再現します。純粋なポーンキャラクター(箱型胴体と球体頭部、四肢、顔、その他は一切なし)を、フラットカラーのプリミティブ環境内に配置します。
- 各シーンをAI動画用の参照パッケージとしてエクスポートします。MP4、最初と最後のフレーム、キーフレーム静止画、.blendファイルを含みます。
レンダリングはWorkbench(ビューポートスタイル)を使用するため、アニマティックには十分な速さです。
セットアップ(パスはご自身の環境に合わせて調整してください)
- Blender 5.2 は
<BLENDER_EXE>にあります。ユーザー環境変数BLENDER_PATHがそれを指しています。 - キットファイルは
<BLOCKOUTS_DIR>\_kit\blockout_kit.pyにあります。これには後述のKITセクションと同じコードが含まれています。もし存在しない、または古い場合は、KITセクションをそのパスに書き戻してください。 - 出力ルートは
<BLOCKOUTS_DIR>\<SceneName>\です。フォルダ<BLOCKOUTS_DIR>はセッションに接続されている必要があります。接続されていない場合は、device_request_folder_accessでアクセスを要求してください。 - シーンスクリプトは
<BLOCKOUTS_DIR>\_scripts\<SceneName>.pyに配置します。
実行モード — デフォルトではAを使用
A. バックグラウンド(動作確認済み。Blenderを開く必要はありません)
- シーンスクリプトをコンテナに書き込みます。先頭は以下で始まる必要があります。
次にビルド呼び出しを追加し、続けてimport math exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())r = export_for_ai()またはrender_still()を呼び出し、最後にprint("RESULT", r)を記述します。 - スクリプトを
_scripts\<SceneName>.pyにコピーします。/mnt/user-data/outputs/にステージし、その後device_commit_filesを使用します。 - PCのDesktop Commanderシェル経由で実行します。
& '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<SceneName>.py' 2>&1 | Select-String 'RESULT|Error|Traceback'タイムアウトは約300秒に設定します。720pの5秒ショットは1分未満でレンダリングされます。 device_stage_filesでpreview.pngまたはfirst.png/last.pngを取得し、Readで確認します。その後、反復します。
Blenderコネクタの execute_blender_code_for_cli は BLENDER_PATH を読み取ります。これは、その変数が設定されてからClaudeデスクトップアプリが再起動された後にのみ機能します。実行ファイルが見つからなかったと表示された場合は、上記のシェルルートを使用してください。
B. ライブ、開いているBlender内(コネクタの execute_blender_code、MCPアドオンサーバー実行時)。Idoがビューポートで監視または調整したい場合に使用します。
- 最初の呼び出しで
exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())を実行し、次にビルド呼び出しを行います。 new_scene()は常に新しいシーンを作成するため、Ido自身のシーンが影響を受けることはありません。- 後の呼び出しで
NameErrorが発生した場合は、exec行を再度実行してください。
2つのルック
look="previs" (デフォルト) | look="toy" | |
|---|---|---|
| 雰囲気 | 落ち着いたダスティパステル。すべてのオブジェクトが異なる色 | 鮮やかなチームカラー、ボードゲームの駒のよう |
| 頭部 | 胴体から約6cm浮いている滑らかな球体 | 胴体に載っている/少し沈み込んでいる低ポリ球体(16×10) |
| 色 | 頭部と胴体は異なる色 | 頭部と胴体は1つのチームカラー(white/black/red/blue/yellow/orange/green)を共有 |
| 照明 | スタジオ照明、シャドウなし、ソフトなワールドキャビティ | スタジオ照明+ソフトキャストシャドウ、キャビティなし (キャビティは低ポリ頭部にグリッド線を描く) |
| 典型的なセット | 暗いプラム色の天井、ベッド、机、ドアのある部屋。台座上のマケット | ホール、丸いフェルトのテーブル、椅子、手すり。役割ごとに色分けされた群衆 |
| 露出 | +0.45 | +0.75 |
ポーンの胴体のサイズは0.48m×0.40m、標準身長は頭部を含めて1.86mです。子供は約1.2m、巨人は約3mです。seated=True は、chair() と組み合わせるために、座面の高さまで上げられた短い胴体を提供します。Idoのルール: ポーンは純粋に保つこと。 色、height=、seated=True のみを変更してください。鼻、手足、帽子、プロップを取り付けないでください。
Idoが指定しない場合は previs を使用します。チーム、カジノ、ゲーム、群衆、または強い色について言及する場合は toy を使用します。
ショットの構築
new_scene(name, look, aspect="16:9")を呼び出します。アスペクト比の選択肢:16:9=1280×720、9:16=720×1280 (Reels/TikTok)、1:1、4:5、21:9。作成するAI動画のアスペクト比に合わせてください。room()でセットを構築し、次にblock()、bed()、table()、chair()、cylinder()で家具を配置します。10〜40のオブジェクトを使用します。ルックには非常に細かいディテールは必要ありません。open_walls=(1,)を使用すると、カメラを部屋の中に配置できます。character()でポーンを追加します。move()でアニメーションさせます。これはポーンを滑らせ、角で方向転換させます。プロップの周りのパスを計画してください。 ポーンは家具をすり抜けます。- カメラを
camera(loc, look_at, lens=20–28)で追加します。アイハイトは1.5〜1.7mで、軸を少しずらし、ハンドヘルドプリビズカメラのようにします。他の2つのフレーミング: マケットを見下ろす高い3/4ビュー、または2人のポーンの後ろからのオーバー・ザ・ショルダーショット。カメラを動かす場合は、開始フレームと終了フレームでcam.locationとcam.rotation_eulerをキーフレーム設定します。動きはシンプルに(プッシュイン、パン、オービット)保ちます。AIモデルはシンプルな動きを最もよくコピーするためです。 - 長さを設定します。ショットは通常5〜10秒:
KIT["scene"].frame_end = 120(24fpsで5秒)。move()は歩行をカバーするためにframe_endをすでに延長しています。 render_still()を呼び出して確認します。フレーミングが決まったら、export_for_ai()を呼び出します。- シーン名、出力フォルダ、最初と最後のフレームを報告します。
参照動画から取った構図ルール
- 壁、床、天井はそれぞれ独自の色を持ちます。プリビズでは、天井は非常に暗いプラム色(#3A3442)で、フレーム上部に暗い帯として読み取られます。
- カメラは通常、部屋の内部に配置します。
open_wallsを使用して、カメラの後ろの壁を除外します。 - ドアは薄い板で、半開きにします。
room()のdoor=パラメータは開口部を切り取り、ドア板を追加します。 - 散らかりは、机の上に散らばった紙や壁の付箋紙など、平らで薄い箱で構成されます(ランダムなパステルカラーの0.15×0.01×0.2の箱)。
- 群衆: ポーンをテーブルの周りにリング状に、カウンターの後ろに一列に、または警備員としてペアで配置します。トイルックでは、役割ごとに色分けします。
- プロップはポーンのスケールを共有します。そのため、ポーンの頭部はドアの上部3分の1とほぼ同じ高さになります。
AI動画への受け渡し
export_for_ai(every=24) は以下のファイルを Videos\Blockouts\<Scene>\ に書き込みます:
<Scene>.mp4はモーションと構造の参照です。ビデオ・トゥ・ビデオ、モーションコントロール、またはSeedanceやidoGenの「参照動画」入力用です。first.pngとlast.pngは構図入力です。フォトリアルな作業では、実際の開始/終了フレームを構築するイメージモデルにこれらを供給します(以下のオーバーライドを参照)。ドラフトテストでのみ直接使用してください。keys/key_####.pngは1秒あたり1枚の静止画です。これらを全方位参照マルチショット(@Image1…)やストーリーボードに使用します。<Scene>.blendはシーンファイルで、後で編集するために保存されます。
生成プロンプトを作成するときは、モデルに対して参照のレイアウト、ブロッキング、カメラ移動を維持するように指示します。次に、最終的なルックを説明します。ポーンを実際の人間に置き換え、マテリアル、照明、ワードローブを追加します。各ポーンの色をキャラクターにマッピングします。例: "ピンク色の胴体のフィギュア = 赤いドレスの女性"。マルチショットSeedanceプロンプトの場合は、seedance-25 スキルに引き継ぎます。
フォトリアルAI動画への受け渡し: プレイブックオーバーライド (2026-10-06)
上記のルックはアニマティック用です。クリップがフォトリアルなSeedance 2.5 / idoGenのコントロールクリップである場合、Idoのプリビズプレイブックからの以下のルールが優先されます(詳細: idogen-video-brain → references/previs-to-seedance-playbook.md; レンズ選択: cinematography → references/camera-directing-playbook.md):
- ニュートラルグレーのセット。 色付きの壁/天井は生成に色味をにじませます[現場]。フラットカラーはメインのポーンとストーリープロップにのみ残します。
- すべてのプロキシは2つの手がかりで識別可能(色+高さ/形状/位置)。色のみのマッピングは信頼できません[現場]。ポーンの色がワードローブににじむ可能性がある場合は、ポーンをワードローブの色に塗ります[未確認]。
- ストーリー上重要なプロップ(ボトル、トレイ、グラス)には、独自のシンプルなプリミティブを割り当てます。
- 実際のスケール、床の存在、動いてはいけないものは動かさない、オーバーレイなし(パス、ギズモ、グリッド、フレームカウンター、テキスト)、オーディオトラックなし。
- ショットごとに1つの支配的なカメラ移動、クリップごとに1つのショット。 ゆっくりとした肩のフロートのみをベイクします。速い揺れはテキストで要求するか、編集で追加します。
- レンズは映画撮影上の決定事項であり、固定の20〜28mmのデフォルトではありません。クリップにベイクされます。9:16の場合は、センサーを36.7mm(回転させたALEXA Mini LFゲート)に設定し、Blenderのmmが実際のmmと一致するようにします。
- クリップ仕様: 24fps、出力アスペクト比、秒単位の整数、≥4秒(Seedance最小値)、クリップ長 = 生成長、使用可能部分の後に実際のアニメーションのテールを含む。
first.pngは開始フレームではありません。 これは、シートと一緒にフォトリアルな開始フレームを構築するイメージモデルへの構図入力です。ドラフトテストでのみ直接使用してください。- また、カメラ方向ごとに空のセットの静止画と上面図(位置計画)をエクスポートします。
KIT — blockout_kit.py の内容
# ---- BLOCKOUT KIT (セッションごとに1回ペーストし、その後ヘルパーを呼び出す) ----
import bpy, math, random, os, glob
from mathutils import Vector
OUT_ROOT = os.path.join(os.path.expanduser("~"), "Videos", "Blockouts")
ASPECTS = {"16:9": (1280, 720), "9:16": (720, 1280), "1:1": (1080, 1080), "4:5": (1080, 1350), "21:9": (1680, 720)}
PREVIS = ["#9C7393", "#8DB59A", "#88BDB0", "#C48DAA", "#ADB277", "#88A2B5",
"#8E78AA", "#BFAE94", "#7FA393", "#B28AA1", "#A2C0AA", "#D6A9B8",
"#B3A28A", "#7E5A70", "#9FA6C2"]
TOY = {"white": "#E8E8E2", "black": "#0B0C0E", "blue": "#1667A8", "yellow": "#C9A20E",
"red": "#B0122E", "orange": "#C27A12", "green": "#2E6B4A", "felt": "#2A6A48",
"cream": "#E6DDC4", "wood": "#5A3218", "brass": "#9C8240", "floor": "#E3D2B0",
"wall_teal": "#4E7468", "wall_wine": "#5C3740", "wall_taupe": "#6B5E4C"}
KIT = {"look": "previs", "rng": random.Random(7), "col": None}
def _rgba(h):
h = h.lstrip("#"); c = [int(h[i:i+2], 16) / 255 for i in (0, 2, 4)]
lin = [x / 12.92 if x <= 0.04045 else ((x + 0.055) / 1.055) ** 2.4 for x in c]
return (*lin, 1.0)
def _mat(hexcol, rough=0.85):
name = "BK_" + hexcol.lstrip("#")
m = bpy.data.materials.get(name)
if m: return m
m = bpy.data.materials.new(name); m.diffuse_color = _rgba(hexcol); m.roughness = rough
m.use_nodes = True
b = m.node_tree.nodes.get("Principled BSDF")
if b: b.inputs["Base Color"].default_value = _rgba(hexcol); b.inputs["Roughness"].default_value = rough
return m
def _pick(color):
if color is None:
return KIT["rng"].choice(PREVIS) if KIT["look"] == "previs" else TOY["cream"]
return TOY.get(color, color)
def _link(ob):
for c in ob.users_collection: c.objects.unlink(ob)
KIT["col"].objects.link(ob); return ob
def new_scene(name="Blockout", look="previs", seed=7, fps=24, aspect="16:9", res=None):
"""look: 'previs' (ビデオ1-2: Workbench、落ち着いたランダムパステル、キャストシャドウなし)
'toy' (ビデオ3: 鮮やかなチームカラー、ソフトシャドウ、低ポリ頭部)"""
KIT["look"] = look; KIT["rng"] = random.Random(seed)
sc = bpy.data.scenes.new(name); KIT["scene"] = sc
if bpy.context.window: bpy.context.window.scene = sc
col = bpy.data.collections.new(name + "_SET"); sc.collection.children.link(col); KIT["col"] = col
sc.render.fps = fps; sc.render.resolution_x, sc.render.resolution_y = res or ASPECTS[aspect]
sc.render.resolution_percentage = 100; sc.frame_start = 1; sc.frame_end = 1
sc.render.engine = "BLENDER_WORKBENCH"
sh = sc.display.shading
sh.light = "STUDIO"; sh.show_specular_highlight = False
if look == "previs":
sh.color_type = "MATERIAL" # パレットはマテリアルにベイクされる(レンダリング間で安定)
sh.show_shadows = False; sh.show_cavity = True
sh.cavity_type = "WORLD"; sh.cavity_ridge_factor = 0.3; sh.cavity_valley_factor = 0.6
sh.show_object_outline = False
else:
sh.color_type = "MATERIAL"; sh.show_shadows = True; sh.shadow_intensity = 0.35
sc.display.shadow_focus = 0.6; sc.display.light_direction = (0.35, -0.45, 0.82)
sh.show_cavity = False # キャビティはファセット頭部にグリッド線を描く
sc.view_settings.view_transform = "Standard"
sc.view_settings.exposure = 0.45 if look == "previs" else 0.75 # 参照フレームの明るさに一致
return sc
def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
"""軸に平行な箱。size=(x,y,z) メートル単位、loc = 底面の中心。"""
bpy.ops.mesh.primitive_cube_add(size=1, location=(loc[0], loc[1], loc[2] + size[2] / 2))
ob = bpy.context.active_object; ob.name = name; ob.scale = size; ob.rotation_euler.z = rot_z
bpy.ops.object.transform_apply(scale=True)
if bevel:
m = ob.modifiers.new("Bevel", "BEVEL"); m.width = bevel; m.segments = 3
bpy.ops.object.shade_auto_smooth(angle=math.radians(35))
ob.data.materials.append(_mat(_pick(color))); return _link(ob)
def cylinder(name, r, h, loc, color=None, verts=32):
bpy.ops.mesh.primitive_cylinder_add(radius=r, depth=h, vertices=verts, location=(loc[0], loc[1], loc[2] + h / 2))
ob = bpy.context.active_object; ob.name = name; ob.data.materials.append(_mat(_pick(color))); return _link(ob)
def room(name="Room", w=6, d=5, h=2.8, t=0.1, ceiling=True, door=None, floor_color=None, wall_colors=None, open_walls=()):
"""各壁は独自のオブジェクトなので、各壁は独自の色を持ちます。
door=(壁インデックス0..3、壁に沿ったオフセット、幅、高さ) は、その壁を分割して開口部を切ります。"""
fc = floor_color or ("#8EBFAE" if KIT["look"] == "previs" else TOY["floor"])
block(name + "_floor", (w, d, t), (0, 0, -t), fc)
if ceiling: block(name + "_ceiling", (w, d, t), (0, 0, h), "#3A3442" if KIT["look"] == "previs" else "#5A5650")
specs = [((w, t), (0, d / 2)), ((w, t), (0, -d / 2)), ((t, d), (w / 2, 0)), ((t, d), (-w / 2, 0))]
for i, ((sx, sy), (x, y)) in enumerate(specs):
if i in open_walls: continue # 0=+Y 奥, 1=-Y 手前, 2=+X 右, 3=-X 左
…
[以下、省略されたセクションの翻訳は原文の完全性を保つために継続する必要があります]