Que fait animationcinématographique ?
La voie premium à côté de robloxmaxxing. Ce skill fabrique des actifs de jeu et des mondes explicatifs lumineux et animés. Celui-ci crée un film : peu de personnages, des pièces sombres, une lampe, une histoire que l'on peut suivre sans le son, rendue dans Cycles (le look de référence) ou EEVEE (le même look en une fraction du temps, avec les règles détaillées dans la section « Moteur » ci-dessous).
SKILL = ce dossier. B = /Applications/Blender.app/Contents/MacOS/Blender (5.1). BP = Le Python de Blender (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13), nécessaire uniquement pour beatgrid.py. Autres scripts : python3 -I.
À lire une fois par session : references/craft.md (histoire, plans, montage, animation, son) et references/look.md (lumière, matériaux, objectif, étalonnage, temps de rendu). references/reference-films.md constitue la preuve : les deux films mesurés plan par plan. À lire avant de contester un chiffre dans ce fichier.
Le look en six lignes
- Personnages jouets, monde réel. Des blocs avec des visages dessinés ; tout autour d'eux est photoréaliste, usé et à petite échelle.
- Sombre. Luminosité médiane de l'image entre 0,10 et 0,26 de la plage totale. Une seule lampe visible est la lumière clé. Pas de lumière d'appoint, pas de ciel.
- Hauteur de la scène. La caméra est au niveau de la table, proche, avec une faible profondeur de champ et quelque chose de flou au premier plan.
- Les inserts racontent l'histoire. Mains, objets, accessoires lisibles. Environ la moitié des plans n'ont pas de visage.
- Couper sur la grille. Les durées des plans sont des temps entiers ou des demi-temps de la musique. La vitesse change avec l'histoire.
- Le silence est un plan. La musique s'arrête une fois, au tournant. La fin est un visage ou un objet, puis le noir.
Moteur : Cycles ou EEVEE
K.setup(..., engine="CYCLES" | "EEVEE"). Mesuré sur un M4 en 1080x1920 :
| moteur | par image | une bobine de 60 s (1 440 images, deux processus) | à utiliser quand |
|---|---|---|---|
| Cycles, 160 échantillons | 70-90 s | 28-36 h | une image héroïque, une couverture, un court teaser |
| Cycles, 16 échantillons, taille 40 % | 11 s | 2 h (doux : un aperçu, pas une livraison) | pour vérifier un montage |
| EEVEE, 64 échantillons, taille réelle, seul le décor du plan est chargé | 6-8 s | 1-1.5 h | la livraison de tout ce qui dépasse environ 15 s |
EEVEE conserve le look (brume, bokeh, plastique rétroéclairé, AgX) si ces règles sont respectées. Chacune a coûté un tour sur Negara Angin :
- Appeler
K.eevee_lights(keep=(...))après la construction de la scène. Seules les grandes lumières motivées projettent des ombres ; de nombreuses petites ombres débordent du pool d'ombres et scintillent d'une image à l'autre. - Une vitre est alpha, pas du verre. Le verre de transmission dans EEVEE réfracte l'espace écran (ce qui se trouve derrière devient flou) et la transmission blendée rend le noir. Utiliser l'alpha Principled ~0.14,
surface_render_method = "BLENDED", avec réflexion + bump. - EEVEE ne peut pas faire la mise au point à travers une vitre. La profondeur de champ lit la profondeur de la surface la plus proche, donc tout ce qui se trouve derrière la vitre est flou comme s'il était sur la vitre. Afficher la vitre seulement lorsqu'elle est le sujet (
K.visible), la cacher une fois que la mise au point la dépasse. - Le verre ne projette pas d'ombre (
eevee_lightss'en charge) : EEVEE le traite comme opaque, donc la lumière à travers une fenêtre ou un bocal s'arrêterait. - Rendre chaque plan avec uniquement son décor chargé (
--sets) : chaque décor chargé est évalué à chaque image (champs instanciés, pluie). Sur Negara Angin, cela a divisé le temps par deux. Deux ouvriers peuvent parcourir la même liste de tâches ;render_rangeréclame les images avec des fichiers de verrouillage. - Le flou de mouvement et la taille des tuiles de volume coûtent peu ; les échantillons au-dessus de 64 n'achètent rien qu'un passage de grain ne cache.
- Cycles a les caustiques désactivées : une lumière derrière une vitre n'atteint jamais la pièce. Placer la « lumière de fenêtre » à l'intérieur de la vitre.
Pipeline
| étape | faire | porte (gate) |
|---|---|---|
| 0. brief | logline, la boucle ou la chaîne, l'objet décisif, palette par lieu, le morceau et son BPM (beatgrid.py) | PORTE B : chaque ligne du brief est une chose observable |
| 1. plan de tournage | plans sous forme de lignes : taille, objectif, ce qui bouge, durée en temps ; un plan maître par scène | PORTE S : les règles de craft.md tiennent sur le papier |
| 2. monde + distribution | cine_kit : pièce/rue, accessoires, lampes, brume ; personnages K.Char | images du plan maître, décrire chacun en une phrase |
| 3. éclairage | clé depuis une lampe visible, accents, bord ; still pour chaque caméra en taille d'aperçu | PORTE L sur l'image de chaque plan (look_gate.py) |
| 4. performance | poses sur les temps (hit, pose, face, talk), mouvements de caméra, life() | une planche contact se lit comme l'histoire sans son |
| 5. rendu | render_range en 2-3 processus, PNG 16 bits, ignorer existants | nombre d'images = durée du film |
| 6. finition | finish.py (lueur, étalonnage, douceur, vignette, grain) + mixage son | PORTE L sur le film, PORTE E (shotlist.py --bpm), -14 LUFS |
Une porte qui échoue est corrigée à son propre stade : une image trop claire est un problème d'éclairage, jamais d'étalonnage.
PORTE B - le brief (un docstring en haut du script de construction)
- Logline en une phrase avec un désir et un prix.
- Forme : une boucle qui se raccourcit (règle montrée une fois, puis répétée plus vite) ou une chaîne (chaque scène se termine sur l'objet qui commence la suivante).
- L'objet décisif : une petite chose avec un visage ou un chiffre dessus (une photo, une facture, un ticket). Là où la caméra se rapproche.
- Palette par lieu : une couleur de lumière dominante, une couleur d'ombre, une couleur d'accent. Différente pour chaque endroit.
- Son : le morceau, son BPM, où la musique commence, la période de 3-8 s où elle s'arrête.
- Fin : la dernière image (un visage ou un objet) et le ou les deux mots sur fond noir après.
- Exclusions : ce à quoi ce film ne doit pas ressembler.
PORTE L - le look (chiffres issus des références ; scripts/look_gate.py)
| mesure (0-1 de la plage totale) | réussi | références |
|---|---|---|
| luminosité médiane de l'image | 0,10-0,26 | 0,20, 0,17 |
| niveau d'ombre (10e centile des pixels) | en dessous de 0,09 | 0,06, 0,04 |
| niveau clair (90e centile des pixels) | 0,22-0,56 | 0,46, 0,36 |
| pic (pixel le plus brillant) | au-dessus de 0,85 | 0,91, 0,98 |
| sol noir | en dessous de 0,05 | 0,02, 0,02 |
| saturation | ambre 0,10-0,30, noir 0,03-0,14 | 0,18, 0,07 |
L'exécuter sur l'image finie de chaque plan, puis sur l'ensemble du film. Un seul insert clair peut générer un AVERTISSEMENT ; un ÉCHEC est corrigé. « Pic en dessous de 0,85 » signifie qu'il n'y a pas de véritable point fort dans l'image : placer une lampe, un reflet ou un tube néon là où l'objectif peut le voir.
PORTE E - le montage (scripts/shotlist.py film.mp4 --bpm N)
Chaque plan a une durée qui est un nombre entier ou une demi-unité du temps. Durée moyenne des plans : 1-3,5 s. Les deux premiers plans sont les plus longs de leur scène. Aucun plan consécutif n'a la même taille et le même angle. Une séquence de 3-8 s n'a pas de musique. Le film se termine dans la seconde qui suit le noir.
Construire une scène
"$B" -b --factory-startup -P build.py -- --out out --stills # une image par plan, demi-taille, environ 10 s chacune
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look ambre
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look ambre
"$B" -b --factory-startup -P build.py -- --out out --frames --final & # le lancer 2 à 3 fois : les images existantes sont ignorées
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look ambre --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True) # "9:16" pour un reel ; preview=False pour la livraison
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()
examples/standoff/build.py est la version complète et testée (4 plans, 7.2 s) : la copier comme point de départ d'un nouveau film.
cine_kit en un tableau
| besoin | appel |
|---|---|
| scène | setup(aspect, height, samples, preview), world(), room(), haze(size, loc, density) |
| surfaces | plastic (peau de jouet, luit en rétro-éclairage), cloth(kind=tissé/tricot/cuir), wood(planks=), brick, asphalt(wet=), flat (feutre, plâtre, métal), glass, emit (néon, ampoules, écrans) |
| formes | box (toujours biseauté), cyl, torus(arc=), text (lettres 3D, mots en néon), paper (affiche/facture/carte avec lignes lisibles), round_table, chair |
| lampes | pendant (abat-jour visible + ampoule + spot), neon (tube + remplissage correspondant), bokeh_lights, light(kind, loc, power, color=kelvin ou hex, target, size) |
| distribution | Char(name, skin, shirt, pants, hat=hair/cap/fedora/beanie) : .pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw), .hit(frame, dur, ...) (snap + hold), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life() |
| personnages fournis | Rigged("bugis_man" / "bugis_woman" / path.blend, at, yaw) : un modèle de personnage depuis un fichier, à la hauteur de Char, avec les mêmes canaux de pose que Char (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head). Visages peints : pas de swaps, donc l'émotion vient de la tête, des bras et du montage. Un nouveau modèle d'une seule pièce est riggé une fois avec scripts/rig_block.py (mesurer d'abord le cou, la hanche et le bord du bras à partir de tranches) et ajouté à K.CAST ; le rig est rigide sauf le cou, que neck_blend.py adoucit (voir « Jointure du cou ») |
| l'avatar de l'utilisateur | Avatar(at, yaw, pose) : le personnage Roblox riggé d'Aksa (Roblox/blender/hero_face.blend) à la hauteur de Char. .pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head (cible de la caméra), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink, puis .finish() une fois. L'utilisateur est le héros de ses propres films : utiliser Avatar pour le personnage principal sauf indication contraire, Char pour tous les autres |
| visages | K.EXPRESSIONS : neutre, sourire en coin, grand sourire, en colère, cri, choc, triste, fermé, parler_a, parler_o, parler_m, côté. Uniquement des swaps, jamais de morphing |
| chant sur un visage peint | une fois : Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (trouve la bouche peinte sur un rendu orthographique de face, dessine un atlas de bouche à 10 formes dans ses couleurs sur sa propre peau, place une plaque sur le visage attachée à l'os de la tête ; cellule 0 = la peinture, donc au repos elle est invisible ; puis refusionne le cou pour que tout ce qui est sous la plaque repose sur la tête). Dans la scène : K.Rigged(".../x_sing.blend").sing(words, f0, f1) avec words = [{"word","start","end"}] issu d'une transcription du morceau (faster-whisper word times). Tourner la tête vers l'objectif pendant qu'elle chante : un profil cache la bouche |
| caméra | Cam(name, loc, target, lens, stop, focus, roll) : .at(frame, loc, target, focus, roll), .push(f0, f1, 0.06), .handheld(amount) ; Cam.distance_for(lens, height) = distance pour remplir le cadre avec un sujet de cette hauteur (placer les caméras rapprochées par taille, jamais par estimation) ; .clip_follow(f0, f1, subject) = plan de coupe clé, pour plonger au-dessus d'une tête dans le téléphone entre leurs mains |
| visibilité | K.visible(ob, [(f0, f1), ...]) : visible au rendu uniquement dans ces intervalles ; ne touche que la courbe de cache (ne jamais définir toutes les courbes d'un objet sur CONSTANT : son mouvement deviendrait par paliers) |
| montage | beats(bpm) -> image du temps n ; cut_list([(name, cam, beats), ...], bpm) lie les caméras aux marqueurs et renvoie les images de chaque plan |
| sortie | still(path, frame), render_range(dir, f0, f1) |
stop est le nombre f comme si la figure était un objet de collection de 40 cm : 2-2,8 pour les inserts, 4 pour les visages, 5,6-8 pour les plans maîtres. Plus petit = plus flou.
Compatibilité avec les autres compétences de l'utilisateur
- Script :
scriptmaxxingpour toute voix off indonésienne. Limiter à quelques lignes ; la référence avec 13,7 millions de vues n'en a pas. - Musique et effets :
~/Ngonten/Maxxing/audio-lib(CC0). Exécuterbeatgrid.pysur le morceau avant de planifier les plans. - L'avatar de l'utilisateur :
K.Avatar()le charge avec son rig facial (clignement, sourcils, synchronisation labiale indonésienne précise au mot depuisRoblox/blender/face/face_rig.py).K.Char.talk()est une animation limitée pour les autres intervenants uniquement. Essayer :build.py -- --avatar --stills. - Accessoires et décors :
robloxmaxxing/blender/rbx_kit.pyconstruit à la même échelle de studs ; Poly Haven (MCP pour Blendersearch_assets, ou le MCP 3d-assets) pour les textures PBR CC0 et les accessoires du monde réel ; Meshy pour un accessoire héros. Les accessoires réalistes sont l'essentiel. - Reels verticaux :
--aspect 9:16. Tout ici tient ; les plans maîtres passent à 24-28 mm et la profondeur est empilée le long de l'axe de l'objectif.
Règles durement acquises pour le travail en gros plan (Negara Angin, 2026-11-21)
- Mesurer, puis cadrer. Afficher les positions évaluées de la tête, des mains et de l'accessoire aux images du plan, puis placer la caméra avec
Cam.distance_for. Les caméras macro placées à l'œil se retrouvaient à 0,5 studs d'objets qui nécessitaient 2. - Les mains Roblox sont de gros blocs. Un téléphone tenu « dans » les mains serait enterré ; tenir les accessoires devant les mains le long de la normale de l'écran.
- Ne pas attacher un accessoire à un os puis définir sa matrice mondiale (il atterrit à l'origine). Garder l'accessoire fixe dans le monde pendant que la pose tient, ou l'attacher avec l'opérateur.
- Les images fixes ignorent les marqueurs de coupe. Un marqueur lié à une caméra remplace
scene.cameraà cette image : les effacer pour les images fixes. - L'accroche est une image et un événement. L'image 1 doit déjà être belle (Negara Angin : une goutte de pluie glissant sur la fenêtre en macro extrême, les lumières de la pièce réfractées à l'intérieur), et le premier temps doit la changer (la grosse caisse fait basculer la mise au point à travers la goutte).
- Les transitions sont conçues, pas ajoutées : traverser un écran dans le monde qu'il montre (rendre la première image du plan suivant comme image de l'écran), sortir d'un plan en fondu enchaîné dans le suivant en tournant la caméra autour d'un axe commun, ou couper sur le même accessoire à un endroit différent.