Pions de Blockout Blender → Prévisualisation pour IA vidéo
Cette compétence fait deux choses :
- Elle recrée le look de prévisualisation de référence d'Ido dans Blender : des personnages pion purs (un torse cubique et une tête sphérique, sans membres, sans visage et sans rien de plus) dans des environnements primitifs aux couleurs unies.
- Elle exporte chaque scène sous forme de package de référence pour l'IA vidéo : un MP4, les première et dernière images, des images clés et le fichier .blend.
Le rendu utilise Workbench (style viewport), donc il est assez rapide pour des animatiques.
Configuration (ajustez les chemins à votre machine)
- Blender 5.2 se trouve dans
<BLENDER_EXE>. La variable d'environnement utilisateurBLENDER_PATHy pointe. - Le fichier kit se trouve dans
<BLOCKOUTS_DIR>\_kit\blockout_kit.py. Il contient le même code que la section KIT ci-dessous. S'il est manquant ou obsolète, réécrivez la section KIT à ce chemin. - Le répertoire de sortie est
<BLOCKOUTS_DIR>\<NomDeLaScène>\. Le dossier<BLOCKOUTS_DIR>doit être connecté à la session. Si ce n'est pas le cas, demandez l'accès avecdevice_request_folder_access. - Les scripts de scène vont dans
<BLOCKOUTS_DIR>\_scripts\<NomDeLaScène>.py.
Modes d'exécution — utilisez A par défaut
A. Arrière-plan (prouvé ; Blender n'a pas besoin d'être ouvert)
- Écrivez le script de la scène dans le conteneur. Il doit commencer par :
Ajoutez ensuite les appels de construction, suivis deimport math exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read())r = export_for_ai()ourender_still(), et enfinprint("RESULT", r). - Copiez le script dans
_scripts\<NomDeLaScène>.py. Placez-le dans/mnt/user-data/outputs/puis utilisezdevice_commit_files. - Exécutez-le via le shell Desktop Commander sur le PC :
& '<BLENDER_EXE>' --background --factory-startup --python '<BLOCKOUTS_DIR>\_scripts\<NomDeLaScène>.py' 2>&1 | Select-String 'RESULT|Error|Traceback'Utilisez un délai d'environ 300 s. Un plan de 5 s en 720p se rend en moins d'une minute. - Récupérez
preview.pngoufirst.png/last.pngavecdevice_stage_fileset regardez-les avecRead. Puis itérez.
Le execute_blender_code_for_cli du connecteur Blender lit BLENDER_PATH. Il ne fonctionne qu'après avoir redémarré l'application de bureau Claude depuis que cette variable a été définie. S'il dit que l'exécutable n'a pas été trouvé, utilisez la route shell ci-dessus.
B. En direct, dans Blender ouvert (le execute_blender_code du connecteur, avec le serveur MCP add-on en cours d'exécution). Utilisez ceci quand Ido veut regarder ou ajuster dans le viewport.
- Dans le premier appel, exécutez
exec(open(r'<BLOCKOUTS_DIR>\_kit\blockout_kit.py', encoding='utf-8').read()), puis les appels de construction. new_scene()crée toujours une nouvelle scène, donc les propres scènes d'Ido ne sont jamais touchées.- Si un appel ultérieur lève
NameError, exécutez à nouveau la ligneexec.
Les deux looks
look="previs" (par défaut) | look="toy" | |
|---|---|---|
| Sensation | Pastels doux et poussiéreux. Chaque objet a une couleur différente | Couleurs d'équipe saturées, comme des pièces de jeu de société |
| Tête | Sphère lisse qui flotte à environ 6 cm au-dessus du corps | Sphère basse poly (16×10) qui repose sur / s'enfonce légèrement dans le corps |
| Couleur | La couleur de la tête diffère de celle du corps | La tête et le corps partagent une couleur d'équipe (white/black/red/blue/yellow/orange/green) |
| Éclairage | Lumière de studio, pas d'ombres, cavité mondiale douce | Lumière de studio plus ombres portées douces, pas de cavité (la cavité dessine des lignes de grille sur les têtes basses poly) |
| Ensemble typique | Pièces avec un plafond prune foncé, un lit, un bureau et des portes ; maquettes sur socles | Halls, tables rondes en feutre, chaises, rampes ; foules colorées par rôle |
| Exposition | +0.45 | +0.75 |
Le corps du pion mesure 0.48 l × 0.40 p m, et la hauteur standard est de 1.86 m avec la tête incluse. Les enfants mesurent environ 1.2 et les géants environ 3. seated=True donne un torse plus court surélevé à hauteur d'assise, pour s'associer à chair(). La règle d'Ido : garder le pion pur. Ne variez que la couleur, height= et seated=True. N'ajoutez jamais de nez, de membres, de chapeaux ou d'accessoires attachés.
Quand Ido ne dit rien, utilisez previs. Utilisez toy quand il mentionne des équipes, un casino, un jeu, une foule ou des couleurs fortes.
Construire un plan
- Appelez
new_scene(name, look, aspect="16:9"). Choix d'aspects :16:9=1280×720,9:16=720×1280 (Reels/TikTok),1:1,4:5,21:9. Faites correspondre l'aspect de la vidéo IA que vous créez. - Construisez le décor avec
room(), puis le mobilier avecblock(),bed(),table(),chair()etcylinder(). Utilisez 10 à 40 objets ; le look a besoin de très peu de détails. Utilisezopen_walls=(1,)pour que la caméra puisse se trouver à l'intérieur de la pièce. - Ajoutez des pions avec
character(). Animez-les avecmove(), qui les fait glisser et les tourne aux coins. Planifiez les chemins autour des accessoires, car les pions traversent directement les meubles. - Ajoutez la caméra avec
camera(loc, look_at, lens=20–28)à hauteur des yeux 1.5–1.7 m, légèrement décalée par rapport à l'axe, comme une caméra de prévisualisation portée. Deux autres cadrages : une vue haute 3/4 regardant vers le bas sur une maquette, ou par-dessus l'épaule derrière deux pions. Pour un mouvement de caméra, image-clécam.locationetcam.rotation_euleraux images de début et de fin. Gardez les mouvements simples (push-in, panoramique, orbite), car les modèles d'IA copient le mieux les mouvements simples. - Définissez la durée. Un plan est généralement de 5 à 10 s :
KIT["scene"].frame_end = 120(5 s à 24 fps).move()étend déjàframe_endpour couvrir la marche. - Appelez
render_still()et révisez-la. Quand le cadrage fonctionne, appelezexport_for_ai(). - Rapportez le nom de la scène, le dossier de sortie et les première et dernière images.
Règles de composition tirées des vidéos de référence
- Les murs, le sol et le plafond ont chacun leur couleur. En previs, le plafond est d'un prune très foncé (#3A3442), donc il apparaît comme une bande sombre en haut du cadre.
- La caméra se trouve généralement à l'intérieur de la pièce. Utilisez
open_wallspour laisser de côté le mur derrière la caméra. - Les portes sont des plaques minces laissées entrouvertes. Le paramètre
door=deroom()découpe l'ouverture et ajoute la plaque. - Le fouillis est fait de boîtes plates et minces, comme des papiers éparpillés sur un bureau ou des notes autocollantes sur un mur (boîtes 0.15 × 0.01 × 0.2 dans des couleurs pastel aléatoires).
- Foules : placez les pions en anneaux autour des tables, en lignes derrière les comptoirs, ou par paires comme gardes. Dans le look toy, coloriez par rôle.
- Les accessoires partagent l'échelle des pions, donc la tête d'un pion est à peu près au niveau du tiers supérieur d'une porte.
Remise à l'IA vidéo
export_for_ai(every=24) écrit ces fichiers dans Videos\Blockouts\<Scene>\ :
<Scene>.mp4est la référence de mouvement et de structure. Il est destiné à la vidéo-vers-vidéo, au contrôle de mouvement ou à l'entrée "vidéo de référence" dans Seedance ou idoGen.first.pngetlast.pngsont des entrées de composition. Pour un travail photoréaliste, ils alimentent le modèle d'image qui construit la vraie image de début/fin (voir les surcharges ci-dessous) ; utilisez-les directement uniquement pour les tests de brouillon.keys/key_####.pngest une image par seconde. Utilisez-les pour la référence omni multi-image (@Image1…) ou les storyboards.<Scene>.blendest la scène, conservée pour les modifications ultérieures.
Lors de la rédaction de l'invite de génération, dites au modèle de garder la disposition, le blockout et le mouvement de la caméra de la référence. Décrivez ensuite le look final : de vraies personnes à la place des pions, avec des matériaux, un éclairage et une garde-robe. Associez chaque couleur de pion à un personnage, par exemple "la figure au corps rose = la femme en robe rouge". Pour les invites multi-image de Seedance, passez à la compétence seedance-25.
Remise à l'IA vidéo photoréaliste : surcharges du playbook (2026-10-06)
Les looks ci-dessus sont pour les animatiques. Quand un clip est un clip de contrôle pour Seedance 2.5 / idoGen photoréaliste, ces règles du playbook de prévisualisation d'Ido prévalent (détail complet : idogen-video-brain → references/previs-to-seedance-playbook.md ; choix de l'objectif : cinematography → references/camera-directing-playbook.md) :
- Décor gris neutre. Les murs/plafonds colorés font saigner la teinte dans la génération [champ]. Gardez la couleur unie uniquement sur les pions principaux et les accessoires de l'histoire.
- Chaque proxy identifiable par deux indices (couleur + hauteur/forme/position) ; le mappage par couleur uniquement n'est pas fiable [champ]. Si une couleur de pion peut fuir dans la garde-robe, peignez le pion de la couleur de la garde-robe [non vérifié].
- Accessoires essentiels à l'histoire (bouteille, plateau, verres) obtiennent leur propre primitive simple.
- Échelle réelle, sol présent, rien qui ne bouge qui ne devrait pas, pas de superpositions (chemins, gizmos, grille, compteur d'images, texte) et pas de piste audio.
- Un mouvement de caméra dominant par plan, un clip par plan. Ne cuisez qu'un lent flottement d'épaule ; demandez une secousse rapide en texte ou ajoutez-la au montage.
- L'objectif est une décision cinématographique, pas un défaut fixe de 20–28 mm : il est cuit dans le clip. Pour le 9:16, réglez le capteur sur 36.7 mm (portail ALEXA Mini LF tourné) pour que les mm de Blender soient égaux aux mm réels.
- Spécifications du clip : 24 fps, aspect de sortie, secondes entières, ≥4 s (minimum Seedance), durée du clip = durée de la génération, avec une queue d'animation réelle après la partie utilisable.
first.pngn'est pas une image de début. C'est une entrée de composition pour le modèle d'image, qui construit l'image de début photoréaliste avec les feuilles. Utilisez-la directement uniquement pour les tests de brouillon.- Exportez également une image du décor vide par direction de caméra et une vue de dessus (plan de localisation).
KIT — le contenu de blockout_kit.py
# ---- BLOCKOUT KIT (à coller une fois par session, puis à utiliser les 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' (vidéos 1-2 : Workbench, pastels aléatoires atténués, pas d'ombres portées)
'toy' (vidéo 3 : couleurs d'équipe saturées, ombres douces, têtes basses 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" # la palette est cuite dans les matériaux (stable entre les rendus)
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 # la cavité dessine des lignes de grille sur les têtes facetées
sc.view_settings.view_transform = "Standard"
sc.view_settings.exposure = 0.45 if look == "previs" else 0.75 # correspondant à la luminosité de l'image de référence
return sc
def block(name, size, loc, color=None, rot_z=0.0, bevel=0.0):
"""Boîte alignée sur les axes. size=(x,y,z) en mètres, loc = centre de la face INFÉRIEURE."""
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=()):
"""Chaque mur est son propre objet pour que chaque mur ait sa propre couleur.
door=(indice_mur 0..3, décalage_le_long_du_mur, largeur, hauteur) découpe une ouverture en divisant ce mur."""
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 arrière, 1=-Y avant, 2=+X droite, 3=-X
(Le code a été tronqué pour la traduction)