Blockout de Peones en Blender → Previsualización para Vídeo con IA
Esta habilidad hace dos cosas:
- Recrea el aspecto de previsualización de referencia de Ido en Blender: personajes peón puros (un torso de caja y una cabeza esférica, sin extremidades, sin rostro y sin extras) dentro de entornos primitivos de colores planos.
- Exporta cada escena como un paquete de referencia para vídeo con IA: un MP4, el primer y último fotograma, fotogramas clave y el archivo .blend.
El renderizado usa Workbench (estilo ventana gráfica), por lo que es lo suficientemente rápido para animáticas.
Configuración (ajusta las rutas a tu máquina)
- Blender 5.2 está en
<BLENDER_EXE>. La variable de entorno de usuarioBLENDER_PATHapunta a él. - El archivo del kit está en
<BLOCKOUTS_DIR>\_kit\blockout_kit.py. Contiene el mismo código que la sección KIT a continuación. Si falta o está desactualizado, escribe la sección KIT de nuevo en esa ruta. - Raíz de salida es
<BLOCKOUTS_DIR>\<NombreEscena>\. La carpeta<BLOCKOUTS_DIR>debe estar conectada a la sesión. Si no lo está, solicita acceso condevice_request_folder_access. - Scripts de escena van en
<BLOCKOUTS_DIR>\_scripts\<NombreEscena>.py.
Modos de ejecución — usa A por defecto
A. En segundo plano (probado y funciona; no es necesario tener Blender abierto)
- Escribe el script de la escena en el contenedor. Debe comenzar con:
Luego añade las llamadas de construcción, seguidas deimport math exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())r = export_for_ai()orender_still(), y finalmenteprint("RESULT", r). - Copia el script a
_scripts\<NombreEscena>.py. Ponlo en/mnt/user-data/outputs/y luego usadevice_commit_files. - Ejecútalo a través del shell de Desktop Commander en el PC:
& '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<NombreEscena>.py' 2>&1 | Select-String 'RESULT|Error|Traceback'Usa un tiempo de espera de aproximadamente 300 s. Una toma de 5 s a 720p se renderiza en menos de un minuto. - Recupera
preview.pngofirst.png/last.pngcondevice_stage_filesy míralos conRead. Luego itera.
El execute_blender_code_for_cli del conector de Blender lee BLENDER_PATH. Solo funciona después de que la aplicación de escritorio de Claude se haya reiniciado desde que se configuró esa variable. Si dice que no se encontró el ejecutable, usa la ruta del shell anterior.
B. En vivo, dentro de Blender abierto (el execute_blender_code del conector, con el servidor MCP add-on en ejecución). Úsalo cuando Ido quiera ver o ajustar en la ventana gráfica.
- En la primera llamada, ejecuta
exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()), luego las llamadas de construcción. new_scene()siempre crea una nueva escena, por lo que las escenas propias de Ido nunca se tocan.- Si una llamada posterior genera
NameError, ejecuta la líneaexecde nuevo.
Los dos estilos
look="previs" (por defecto) | look="toy" | |
|---|---|---|
| Sensación | Pasteles apagados y polvorientos. Cada objeto es de un color diferente | Colores de equipo saturados, como piezas de juego de mesa |
| Cabeza | Esfera lisa que flota unos 6 cm sobre el cuerpo | Esfera de baja poligonización (16×10) que descansa / se hunde ligeramente en el cuerpo |
| Color | El color de la cabeza difiere del color del cuerpo | La cabeza y el cuerpo comparten un color de equipo (blanco/negro/rojo/azul/amarillo/naranja/verde) |
| Iluminación | Luz de estudio, sin sombras, cavidad suave mundial | Luz de estudio más sombras suaves proyectadas, sin cavidad (la cavidad dibuja líneas de cuadrícula en cabezas de baja poligonización) |
| Conjunto típico | Habitaciones con techo ciruela oscuro, cama, escritorio y puertas; maquetas sobre pedestales | Pasillos, mesas redondas de fieltro, sillas, barandillas; multitudes coloreadas por rol |
| Exposición | +0.45 | +0.75 |
El cuerpo del peón mide 0.48 an × 0.40 prof m, y la altura estándar es 1.86 m con la cabeza incluida. Los niños miden aproximadamente 1.2 y los gigantes unos 3. seated=True da un torso más corto elevado a la altura del asiento, para combinar con chair(). Regla de Ido: mantén el peón puro. Solo varía el color, height= y seated=True. Nunca añadas narices, extremidades, sombreros o accesorios unidos a él.
Cuando Ido no lo especifique, usa previs. Usa toy cuando mencione equipos, un casino, un juego, una multitud o colores fuertes.
Construcción de una toma
- Llama a
new_scene(nombre, look, aspect="16:9"). Opciones de aspecto:16:9=1280×720,9:16=720×1280 (Reels/TikTok),1:1,4:5,21:9. Que coincida con el aspecto del vídeo con IA que estás creando. - Construye el set con
room(), luego los muebles conblock(),bed(),table(),chair()ycylinder(). Usa de 10 a 40 objetos; el estilo necesita muy poco detalle. Usaopen_walls=(1,)para que la cámara pueda estar dentro de la habitación. - Añade peones con
character(). Anímalos conmove(), que los desliza y los gira en las esquinas. Planifica las rutas alrededor de los accesorios, porque los peones atraviesan los muebles. - Añade la cámara con
camera(loc, look_at, lens=20–28)a la altura de los ojos 1.5–1.7 m, ligeramente descentrada, como una cámara de previsualización manual. Otros dos encuadres: una vista alta de 3/4 mirando hacia abajo a una maqueta, o sobre el hombro detrás de dos peones. Para un movimiento de cámara, establece fotogramas clave encam.locationycam.rotation_euleral inicio y al final. Mantén los movimientos simples (acercamiento, paneo, órbita), porque los modelos de IA copian mejor los movimientos simples. - Establece la duración. Una toma suele ser de 5 a 10 s:
KIT["scene"].frame_end = 120(5 s a 24 fps).move()ya extiendeframe_endpara cubrir la caminata. - Llama a
render_still()y revísalo. Cuando el encuadre funcione, llama aexport_for_ai(). - Informa el nombre de la escena, la carpeta de salida y el primer y último fotograma.
Reglas de composición tomadas de los vídeos de referencia
- Las paredes, el suelo y el techo tienen cada uno su propio color. En previs, el techo es de un ciruela muy oscuro (#3A3442), por lo que se lee como una banda oscura en la parte superior del encuadre.
- La cámara suele estar dentro de la habitación. Usa
open_wallspara omitir la pared detrás de la cámara. - Las puertas son losas delgadas entreabiertas. El parámetro
door=deroom()corta la abertura y añade la losa. - El desorden se compone de cajas planas y delgadas, como papeles esparcidos sobre un escritorio o notas adhesivas en una pared (cajas de 0.15 × 0.01 × 0.2 en colores pastel aleatorios).
- Multitudes: coloca peones en anillos alrededor de mesas, filas detrás de mostradores, o pares como guardias. En el estilo toy, colorea por rol.
- Los accesorios comparten la escala del peón, por lo que la cabeza de un peón está aproximadamente al nivel del tercio superior de una puerta.
Entrega para vídeo con IA
export_for_ai(every=24) escribe estos archivos en Videos\Blockouts\<Escena>\:
<Escena>.mp4es la referencia de movimiento y estructura. Es para vídeo a vídeo, control de movimiento, o la entrada de "vídeo de referencia" en Seedance o idoGen.first.pngylast.pngson entradas de composición. Para trabajo fotorrealista, alimentan el modelo de imagen que construye el fotograma real de inicio/fin (consulta las anulaciones a continuación); úsalos directamente solo para pruebas de borrador.keys/key_####.pnges un fotograma fijo por segundo. Úsalos para la referencia múltiple de omni (como @Image1…) o guiones gráficos.<Escena>.blendes la escena, guardada para ediciones posteriores.
Al escribir el prompt de generación, dile al modelo que mantenga el diseño, el bloqueo y el movimiento de cámara de la referencia. Luego describe el aspecto final: personas reales en lugar de los peones, con materiales, iluminación y vestuario. Asigna cada color de peón a un personaje, por ejemplo "la figura de cuerpo rosa = la mujer del vestido rojo". Para prompts de Seedance de múltiples tomas, pasa la mano a la habilidad seedance-25.
Entrega para vídeo con IA fotorrealista: anulaciones del manual de jugadas (2026-10-06)
Los estilos anteriores son para animáticas. Cuando un clip es un clip de control para Seedance 2.5 / idoGen fotorrealista, estas reglas del manual de previsualización de Ido tienen prioridad (detalle completo: idogen-video-brain → references/previs-to-seedance-playbook.md; elección de lente: cinematography → references/camera-directing-playbook.md):
- Set gris neutro. Las paredes/techos de colores sangran el tono en la generación [campo]. Mantén el color plano solo en los peones principales y accesorios de la historia.
- Cada referente identificable por dos señales (color + altura/forma/posición); el mapeo solo por color no es fiable [campo]. Si un color de peón puede filtrarse en el vestuario, pinta el peón del color del vestuario [no verificado].
- Accesorios críticos para la historia (botella, bandeja, vasos) obtienen su propio primitivo simple.
- Escala real, suelo presente, nada que se mueva que no deba, sin superposiciones (rutas, gizmos, cuadrícula, contador de fotogramas, texto) y sin pista de audio.
- Un movimiento de cámara dominante por toma, un clip por toma. Hornea solo un flotador lento de hombro; solicita una sacudida rápida en el texto o añádela en la edición.
- La lente es una decisión cinematográfica, no un valor fijo predeterminado de 20–28 mm: se hornea en el clip. Para 9:16, ajusta el sensor a 36.7 mm (puerta ALEXA Mini LF girada) para que los mm de Blender equivalgan a mm reales.
- Especificaciones del clip: 24 fps, aspecto de salida, segundos completos, ≥4 s (mínimo de Seedance), duración del clip = duración de la generación, con una cola de animación real después de la parte utilizable.
first.pngno es un fotograma de inicio. Es una entrada de composición para el modelo de imagen, que construye el fotograma de inicio fotorrealista junto con las hojas. Úsalo directamente solo para pruebas de borrador.- También exporta un fotograma fijo del set vacío por dirección de cámara y una vista superior (plano de ubicación).
KIT — el contenido de blockout_kit.py
# ---- KIT DE BLOCKOUT (pegar una vez por sesión, luego llamar a los ayudantes) ----
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' (videos 1-2: Workbench, pasteles aleatorios apagados, sin sombras proyectadas)
'toy' (video 3: colores de equipo saturados, sombras suaves, cabezas de baja poligonización)"""
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):
"""Caja alineada a los ejes. size=(x,y,z) en metros, loc = centro de la cara 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 pared es su propio objeto para que cada pared tenga su propio color.
door=(indice_muro 0..3, desplazamiento_a_lo_largo_del_muro, ancho, alto) corta una abertura dividiendo ese muro."""
fc = floor_color or ("#8EBFAE" if KIT["look"] == "previs" else TOY["floor"])
block(name + "_suelo", (w, d, t), (0, 0, -t), fc)
if ceiling: block(name + "_techo", (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
block(name + f"_pared_{i}", (sx, sy, h), (x, y, 0), wall_colors[i] if wall_colors else None)
...