Blender 블록아웃 폰 → AI 영상 프리비즈
이 스킬은 두 가지 작업을 수행합니다:
- Blender에서 Ido의 참조 프리비즈 룩을 재현합니다: 평면 색상의 기본 환경 내에서 순수 폰(pawm) 캐릭터(팔다리, 얼굴, 장식 없이 박스 몸통과 구체 머리로 구성).
- 각 장면을 AI 영상 참조 패키지로 내보냅니다: MP4, 첫 번째 및 마지막 프레임, 키프레임 스틸컷, .blend 파일.
렌더링은 워크벤치(뷰포트 스타일)를 사용하므로 애니매틱(animatic)에 충분히 빠릅니다.
설정 (사용자 환경에 맞게 경로 조정)
- 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라인을 다시 실행합니다.
두 가지 룩
look="previs" (기본값) | look="toy" | |
|---|---|---|
| 느낌 | 차분하고 먼지 낀 파스텔 색상. 모든 객체가 다른 색상 | 채도 높은 팀 색상, 보드 게임 조각처럼 |
| 머리 | 몸통 위 약 6cm 위에 떠 있는 부드러운 구체 | 몸통 위에 놓이거나 약간 파고드는 저폴리곤 구체 (16×10) |
| 색상 | 머리 색상이 몸통 색상과 다름 | 머리와 몸통이 하나의 팀 색상 공유 (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()로 애니메이션을 적용하면 폰이 미끄러지듯 움직이고 모퉁이에서 방향을 바꿉니다. 소품 주변 경로를 계획하십시오. 폰이 가구를 통과하기 때문입니다.- 시선 높이 1.5–1.7m에서
camera(loc, look_at, lens=20–28)로 카메라를 추가합니다. 핸드헬드 프리비즈 카메라처럼 축에서 약간 벗어나게 배치합니다. 다른 두 가지 프레이밍: 마케트를 내려다보는 높은 3/4 뷰, 또는 두 폰 뒤의 어깨 너머 뷰입니다. 카메라 움직임을 위해 시작 및 종료 프레임에서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 상자)).
- 군중: 테이블 주위에 폰을 고리 모양으로, 카운터 뒤에 줄을 서게 하거나, 쌍으로 경비병을 배치합니다. 장난감 룩에서는 역할별로 색상을 지정합니다.
- 소품은 폰의 스케일을 공유하므로 폰의 머리는 대략 문의 위쪽 1/3 높이와 같습니다.
AI 영상 핸드오프
export_for_ai(every=24)는 다음 파일을 Videos\Blockouts\<Scene>\에 기록합니다:
<Scene>.mp4는 모션 및 구조 참조 자료입니다. 비디오-투-비디오, 모션 제어, 또는 Seedance나 idoGen의 "참조 비디오" 입력용입니다.first.png와last.png는 구성 입력입니다. 사실적인 작업의 경우 실제 시작/종료 프레임을 구축하는 이미지 모델을 공급합니다(아래 오버라이드 참조); 초안 테스트에만 직접 사용하십시오.keys/key_####.png는 초당 하나의 스틸컷입니다. 옴니-레퍼런스 멀티샷(@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):
- 중성 회색 세트. 색상이 있는 벽/천장은 생성물에 색조를 번짐 [필드]. 주요 폰과 스토리 소품에만 평면 색상을 유지합니다.
- 모든 프록시는 두 가지 단서로 식별 가능 (색상 + 높이/모양/위치); 색상 단독 매핑은 신뢰할 수 없음 [필드]. 폰 색상이 의상에 번질 수 있는 경우, 폰을 의상 색상으로 칠합니다 [미확인].
- 스토리 중요 소품 (병, 쟁반, 안경)은 자체 단순 프리미티브를 얻습니다.
- 실제 스케일, 바닥이 존재하고, 움직이지 않아야 하는 것은 없음, 오버레이 없음(경로, 기즈모, 그리드, 프레임 카운터, 텍스트) 및 오디오 트랙 없음.
- 샷당 하나의 지배적인 카메라 움직임, 하나의 클립. 느린 어깨 플로트만 베이크하고, 빠른 흔들림은 텍스트로 요청하거나 편집에서 추가합니다.
- 렌즈는 영화 촬영술 결정이며, 고정된 20–28mm 기본값이 아닙니다: 클립에 베이크됩니다. 9:16의 경우 센서를 36.7mm(회전된 ALEXA Mini LF 게이트)로 설정하여 Blender mm가 실제 mm와 같도록 합니다.
- 클립 사양: 24fps, 출력 화면비, 정수초 단위, ≥4초 (Seedance 최소값), 클립 길이 = 생성 길이, 사용 가능한 부분 이후에 실제 애니메이션의 꼬리 포함.
first.png는 시작 프레임이 아닙니다. 이미지 모델에 대한 구성 입력으로, 시트와 함께 사실적인 시작 프레임을 구축합니다. 초안 테스트에만 직접 사용하십시오.- 또한 카메라 방향당 빈 세트의 스틸컷과 평면도(위치 계획)를 내보냅니다.
KIT — blockout_kit.py의 내용
# ---- 블록아웃 키트 (세션당 한 번 붙여넣은 후 헬퍼 호출) ----
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: 워크벤치, 차분한 랜덤 파스텔, 투사 그림자 없음)
'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 = BOTTOM 면의 중심."""
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=(wall_index 0..3, offset_along_wall, width, height)는 해당 벽을 분할하여 개구부를 자릅니다."""
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 왼쪽