Blender Blockout Pawns → Previs para vídeo de IA
Esta skill faz duas coisas:
- Recria o look de referência de previs do Ido no Blender: personagens pawn puros (um torso em caixa e uma cabeça esférica, sem membros, sem rosto e sem extras) dentro de ambientes de primitivas de cores sólidas.
- Exporta cada cena como um pacote de referência para vídeo de IA: um MP4, o primeiro e o último quadro, quadros-chave e o arquivo .blend.
A renderização usa o Workbench (estilo viewport), então é rápido o suficiente para animatics.
Configuração (ajuste os caminhos para sua máquina)
- Blender 5.2 está em
<BLENDER_EXE>. A variável de ambienteBLENDER_PATHaponta para ele. - O arquivo kit está em
<BLOCKOUTS_DIR>\_kit\blockout_kit.py. Ele contém o mesmo código da seção KIT abaixo. Se estiver faltando ou desatualizado, escreva a seção KIT de volta nesse caminho. - Raiz de saída é
<BLOCKOUTS_DIR>\<SceneName>\. A pasta<BLOCKOUTS_DIR>deve estar conectada à sessão. Se não estiver, peça acesso comdevice_request_folder_access. - Scripts da cena vão em
<BLOCKOUTS_DIR>\_scripts\<SceneName>.py.
Modos de execução — use A por padrão
A. Background (comprovado que funciona; não precisa ter o Blender aberto)
- Escreva o script da cena no contêiner. Ele deve começar com:
Depois adicione as chamadas de construção, seguidas porimport math exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())r = export_for_ai()ourender_still(), e finalmenteprint("RESULT", r). - Copie o script para
_scripts\<SceneName>.py. Coloque-o em/mnt/user-data/outputs/e depois usedevice_commit_files. - Execute-o via shell do Desktop Commander no PC:
& '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<SceneName>.py' 2>&1 | Select-String 'RESULT|Error|Traceback'Use um timeout de cerca de 300 s. Uma tomada de 5 s em 720p renderiza em menos de um minuto. - Recupere
preview.pngoufirst.png/last.pngcomdevice_stage_filese veja-as comRead. Depois itere.
O execute_blender_code_for_cli do conector do Blender lê BLENDER_PATH. Ele só funciona depois que o aplicativo desktop Claude foi reiniciado desde que essa variável foi definida. Se ele disser que o executável não foi encontrado, use a rota do shell acima.
B. Ao vivo, dentro do Blender aberto (o execute_blender_code do conector, com o servidor MCP add-on em execução). Use isso quando Ido quiser assistir ou ajustar no viewport.
- Na primeira chamada, execute
exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()), depois as chamadas de construção. new_scene()sempre cria uma nova cena, então as cenas do Ido nunca são tocadas.- Se uma chamada posterior gerar
NameError, execute a linhaexecnovamente.
Os dois estilos visuais
look="previs" (padrão) | look="toy" | |
|---|---|---|
| Sensação | Pastéis suaves e empoeirados. Cada objeto é de uma cor diferente | Cores saturadas de time, como peças de jogo de tabuleiro |
| Cabeça | Esfera lisa que flutua cerca de 6 cm acima do corpo | Esfera low-poly (16×10) que repousa / afunda levemente no corpo |
| Cor | Cor da cabeça difere da cor do corpo | Cabeça e corpo compartilham uma cor de time (white/black/red/blue/yellow/orange/green) |
| Iluminação | Luz de estúdio, sem sombras, cavity suave mundial | Luz de estúdio mais sombras suaves projetadas, sem cavity (cavity desenha linhas de grade em cabeças low-poly) |
| Cenário típico | Salas com teto ameixa escuro, cama, mesa e portas; maquetes em pedestais | Corredores, mesas redondas de feltro, cadeiras, corrimãos; multidões coloridas por função |
| Exposição | +0.45 | +0.75 |
O corpo pawn tem 0.48 m de largura × 0.40 m de profundidade, e a altura padrão é 1.86 m com a cabeça incluída. Crianças têm cerca de 1.2 e gigantes cerca de 3. seated=True dá um torso mais curto elevado à altura do assento, para combinar com chair(). Regra do Ido: mantenha o pawn puro. Varie apenas cor, height= e seated=True. Nunca adicione narizes, membros, chapéus ou adereços presos a ele.
Quando Ido não disser, use previs. Use toy quando ele mencionar times, um cassino, um jogo, uma multidão ou cores fortes.
Construindo uma tomada
- Chame
new_scene(name, look, aspect="16:9"). Opções de aspecto:16:9= 1280×720,9:16= 720×1280 (Reels/TikTok),1:1,4:5,21:9. Combine o aspecto do vídeo de IA que você está fazendo. - Construa o cenário com
room(), depois móveis comblock(),bed(),table(),chair()ecylinder(). Use 10–40 objetos; o visual precisa de muito pouco detalhe. Useopen_walls=(1,)para que a câmera possa ficar dentro da sala. - Adicione pawns com
character(). Anime-os commove(), que os desliza e os vira nas esquinas. Planeje caminhos ao redor de adereços, porque os pawns passam direto pelos móveis. - Adicione a câmera com
camera(loc, look_at, lens=20–28)na altura dos olhos 1.5–1.7 m, levemente fora do eixo, como uma câmera de previs manual. Dois outros enquadramentos: uma visão alta 3/4 olhando para baixo para uma maquete, ou por cima do ombro atrás de dois pawns. Para um movimento de câmera, keyframecam.locationecam.rotation_eulernos quadros inicial e final. Mantenha os movimentos simples (push-in, pan, orbit), porque os modelos de IA copiam melhor movimentos simples. - Defina a duração. Uma tomada geralmente é de 5–10 s:
KIT["scene"].frame_end = 120(5 s a 24 fps).move()já estendeframe_endpara cobrir a caminhada. - Chame
render_still()e revise. Quando o enquadramento estiver bom, chameexport_for_ai(). - Relate o nome da cena, a pasta de saída e o primeiro e último quadros.
Regras de composição extraídas dos vídeos de referência
- Paredes, piso e teto têm cada um sua própria cor. Em previs, o teto é muito escuro ameixa (#3A3442), então aparece como uma faixa escura no topo do quadro.
- A câmera geralmente fica dentro da sala. Use
open_wallspara deixar de fora a parede atrás da câmera. - Portas são placas finas deixadas entreabertas. O parâmetro
door=deroom()corta a abertura e adiciona a placa. - Bagunça é feita de caixas finas e planas, como papéis espalhados em uma mesa ou notas adesivas em uma parede (caixas de 0,15 × 0,01 × 0,2 em cores pastéis aleatórias).
- Multidões: coloque pawns em anéis ao redor de mesas, filas atrás de balcões, ou pares como guardas. No estilo toy, colora por função.
- Adereços compartilham a escala do pawn, então a cabeça de um pawn está aproximadamente nivelada com o terço superior de uma porta.
Entrega para vídeo de IA
export_for_ai(every=24) escreve estes arquivos em Videos\Blockouts\<Scene>\:
<Scene>.mp4é a referência de movimento e estrutura. É para vídeo-para-vídeo, controle de movimento, ou a entrada de "vídeo de referência" no Seedance ou idoGen.first.pngelast.pngsão entradas de composição. Para trabalhos fotorrealistas, alimentam o modelo de imagem que constrói o quadro inicial/final real (veja as substituições abaixo); use-os diretamente apenas para testes de rascunho.keys\key_####.pngé um quadro por segundo. Use-os para referência múltipla omni (@Image1…) ou storyboards.<Scene>.blendé a cena, mantida para edições posteriores.
Ao escrever o prompt de geração, diga ao modelo para manter o layout, o bloqueio e o movimento da câmera da referência. Depois descreva o visual final: pessoas reais no lugar dos pawns, com materiais, iluminação e guarda-roupa. Mapeie cada cor de pawn para um personagem, por exemplo "a figura de corpo rosa = a mulher no vestido vermelho". Para prompts multishot do Seedance, passe para a skill seedance-25.
Entrega fotorrealista para vídeo de IA: substituições do guia (2026-10-06)
Os estilos visuais acima são para animatics. Quando um clipe é um clipe de controle para Seedance 2.5 / idoGen fotorrealista, estas regras do guia de previs do Ido têm precedência (detalhe completo: idogen-video-brain → references/previs-to-seedance-playbook.md; escolha de lente: cinematography → references/camera-directing-playbook.md):
- Cenário cinza neutro. Paredes/ tetos coloridos sangram matiz na geração [campo]. Mantenha cor sólida apenas nos pawns principais e adereços da história.
- Cada proxy identificável por duas pistas (cor + altura/forma/posição); mapeamento apenas por cor não é confiável [campo]. Se uma cor de pawn pode vazar para o guarda-roupa, pinte o pawn com a cor do guarda-roupa [não verificado].
- Adereços críticos para a história (garrafa, bandeja, copos) ganham sua própria primitiva simples.
- Escala real, piso presente, nada se movendo que não deveria, sem sobreposições (caminhos, gizmos, grade, contador de quadros, texto) e sem trilha de áudio.
- Um movimento de câmera dominante por tomada, um clipe por tomada. Cozinhe apenas flutuação lenta do ombro; peça movimento rápido no texto ou adicione na edição.
- A lente é uma decisão de cinematografia, não um padrão fixo de 20–28 mm: é cozida no clipe. Para 9:16, defina o sensor para 36,7 mm (gate ALEXA Mini LF rotacionado) para que os mm do Blender sejam iguais aos mm reais.
- Especificação do clipe: 24 fps, aspecto de saída, segundos inteiros, ≥4 s (mínimo do Seedance), duração do clipe = duração da geração, com uma cauda de animação real após a parte utilizável.
first.pngnão é um quadro inicial. É uma entrada de composição para o modelo de imagem, que constrói o quadro inicial fotorrealista junto com as folhas. Use-o diretamente apenas para testes de rascunho.- Também exporte um still do cenário vazio por direção de câmera e uma visão superior (planta baixa).
KIT — o conteúdo de blockout_kit.py
# ---- BLOCKOUT KIT (cole uma vez por sessão, depois chame os helpers) ----
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' (vídeos 1-2: Workbench, pastéis aleatórios suaves, sem sombras projetadas)
'toy' (vídeo 3: cores saturadas de time, sombras suaves, cabeças low-poly)"""
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" # a paleta está cozida nos materiais (estável entre renderizações)
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 # cavity desenha linhas de grade em cabeças facetadas
sc.view_settings.view_transform = "Standard"
sc.view_settings.exposure = 0.45 if look == "previs" else 0.75 # igual ao brilho do quadro de referência
return sc
def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
"""Caixa alinhada ao eixo. size=(x,y,z) em metros, loc = centro da face INFERIOR."""
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=()):
"""Cada parede é seu próprio objeto para que cada parede tenha sua própria cor.
door=(wall_index 0..3, offset_along_wall, width, height) corta uma abertura dividindo aquela parede."""
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 fundo, 1=-Y frente, 2=+X direita, 3=-X esquerda
…
block(name + f"_wall{i}", (sx, t, sy), (x, y, h / 2), (wall_colors or [None])[i] if wall_colors else None)
if door and door[0] == i:
_, off, dw, dh = door; block(name + f"_door_{i}", (dw, t, dh), (x + off, y, 0), "#A07050")
# (código truncado para tradução)