z1fex/3d-cartoon-animation

Animation 3D Cartoon

Version 1.0.1 (édition publique) · méthode et apparence approuvées par le propriétaire au premier tour (« Comment la gravité a été découverte », v3, 26 octobre 2026). La version 1.0.1 permet aux outils de fonctionner sur n'importe quel ordinateur ; les films rendent de la même manière qu'en 1.0.0.

« Le propriétaire » dans ces fichiers est la personne pour qui les films sont réalisés : celui ou celle qui demande le film et l'approuve.

Storyboard d'abord (règle du propriétaire, 27 octobre 2026). Chaque film, et chaque nouvelle version, commence par un storyboard dans le cadre du propriétaire. Rien n'est dit, construit en détail ou rendu avant qu'il ou elle ne l'approuve (skill 4).

Ce paquet est une façon complète et réutilisable de réaliser un type de vidéo : un court métrage d'explication 3D cartoon rapide et chaleureux. Il fonctionne pour n'importe quel sujet. L'exemple concret porte sur la gravité, mais rien dans la méthode n'en dépend : les skills expliquent comment trouver l'accroche, distribuer les personnages, construire les lieux, transformer chaque nombre en objet, synchroniser chaque geste avec la voix, concevoir le son et vérifier chaque image, quel que soit le sujet suivant.

À quoi ressemble une vidéo terminée

• Format : 1080×1920, 30 ips, 30–60 s. Une proposition de narration = un plan (une nouvelle image toutes les 1,1 à 1,5 s environ). La dernière ligne boucle sur la première image.
• Histoire : une accroche dans les 2 premières secondes qui ouvre une question ; une récompense rapide ; des enjeux racontés à « vous » ; une escalade ; une ré-accroche aux deux tiers ; un rebondissement présenté comme une image littérale ; une fin en boucle.
• Apparence : ombrage cartoon doux, contours à l'encre, lumières pratiques chaudes, rim light, profondeur de champ, lumière de bloom et grain. Visages avec des tons de peau ; couleurs de la marque (Rouge Noir, Bleu Corail, Cognac, Sable Blanc, Anthracite) sur les vêtements, accessoires et décors. Les choses réelles ont l'air réelles (la Terre est bleue et verte).
• Personnages : tête ronde, corps en haricot, membres en bâtonnets, mains en mitaines ; visages peints sans synchronisation labiale ; les visages s'échangent par un clignement juste avant le mot accentué ; les poses au repos sont parfaitement immobiles.
• Caméra : toujours en mouvement, rampant entre les déplacements, accélérant dans des fondus de 6 images sur le premier mot de chaque phrase.
• Les faits sont des objets : chaque nombre prononcé atterrit sur son image sous forme de compteur, calendrier, mètre ruban, jauge ou panneau lumineux.
• Texte : une question sur le sujet en haut pendant les 2 à 3 premières secondes (« Comment la gravité a-t-elle été découverte ? »), et des légendes éditoriales verrouillées à 70 % de hauteur (TOUT sur vous savez).
• Son : une voix (ElevenLabs), un fond musical original à 18 LU en dessous, un bruitage foley discret sur chaque action visible et un accent sur chaque temps fort narratif, masterisé à −14 LUFS.

Le pipeline (chaque étape est un skill)

#	Étape	Skill	Résultat
1	Transformer le sujet en idée de film	sujet-vers-film	angle, accroche, distribution, lieux, liste de nombres, vue d'ensemble
2	Écrire le script	script-et-rétention	script.md avec sources
3	Enregistrer la voix et chronométrer chaque mot	voix-et-timing	vo/voice-final.wav, vo/words-final.json
4	Storyboard de chaque plan ; le propriétaire approuve	storyboard-et-plan-de-tournage	storyboard.md, images du storyboard, le tableau du propriétaire (storyboard/<v>/<Titre> - storyboard <n>.png et .html)
5	Définir l'apparence	look-éclairage-et-marque	préréglage d'éclairage, palette, objectif par plan
6	Construire la distribution	personnages-et-visages	armatures, tenues, échanges de visages
7	Animer chaque proposition	mouvement-et-jeu-d'acteur	clés de pose, gags, physique
8	Déplacer la caméra	caméra-et-transitions	un mouvement orbital par plan
9	Rendre les nombres physiques	faits-en-objets	un dispositif par nombre
10	Construire et habiller les lieux	décors-et-accessoires	lieux du kit, habillés
11	Écrire le texte à l'écran	légendes-et-accroche-titre	légendes verrouillées, question du titre
12	Concevoir le son	conception-sonore-et-mixage	liste de repérage, mixage, stems
13	Rendre et vérifier chaque image	rendu-et-contrôle-qualité	le MP4, le rapport de QA
14	Révision avec le propriétaire et apprentissage	cycles-de-révision-et-apprentissage	feedback, version suivante, mise à jour du paquet

Effectuez les étapes dans cet ordre. Les étapes 4 à 11 se déroulent toutes à l'intérieur d'un seul fichier par film (film.mjs), donc en pratique vous planifiez le storyboard, puis construisez plan par plan, en rendant des images au fur et à mesure.

Non-négociables

1. Storyboard d'abord. Le propriétaire approuve le tableau (skill 4) avant que la voix ne soit enregistrée, que les plans ne soient construits en détail ou que quoi que ce soit soit rendu.
2. Copiez la technique, jamais le contenu. Chaque personnage, décor, panneau, blague et nom de marque inventé est le nôtre. Les personnages historiques réels sont dessinés comme nos propres personnages cartoon ; ne dessinez jamais un personnage protégé par le droit d'auteur.
3. Accroche d'abord. Les 2 premières secondes doivent ouvrir une question ; la question du titre nomme le sujet.
4. Chaque nombre devient un objet, tombant sur le mot parlé. Jamais de superposition de texte simple.
5. Les gestes arrivent 4 images avant leur mot ; les visages s'échangent 2 images avant, par un clignement.
6. Chaque action visible a un son ; pas de son sans action.
7. Chaque image est vérifiée (vérification de cadrage automatique et détection de saut, puis à l'œil) avant que le propriétaire ne la voie.
8. Les faits sont sourcés. Lorsque les sources divergent, atténuez en termes simples.
9. La marque du propriétaire : visages aux tons de peau, les cinq couleurs de la marque plus le Rouge de Marque, et les polices incluses : TeX Gyre Heros Bold + Instrument Serif Italic pour les légendes, Titan One pour les étiquettes (ou Helvetica Bold sous licence + Editorial New Italic si le propriétaire les ajoute ; précisez lesquelles). Le tout dans brand/.

Démarrage rapide pour un nouveau sujet

1. Copiez templates/new-film/ vers examples/<slug-du-sujet>/.
2. Remplissez la feuille de travail du nouveau sujet (skill 1) et écrivez le script (skill 2) dans SCRIPT de film.mjs.
3. Construisez les plans avec un timing provisoire et rendez les images du storyboard : node recipe/tools/render.mjs examples/<slug>/film.mjs <outDir> --stills shots --qa
4. Storyboard d'abord.
   • Copiez templates/storyboard.json vers examples/<slug>/storyboard/v1/storyboard-1.json, avec un panneau par plan et son image.
   • Dessinez le tableau : node recipe/tools/storyboard-board.mjs examples/<slug>/storyboard/v1/storyboard-1.json.
   • Donnez le tableau au propriétaire, et révisez-le (storyboard-2, …) jusqu'à ce qu'il ou elle l'approuve.
   • Ensuite, enregistrez la voix : ELEVENLABS_API_KEY=… node recipe/tools/voiceover.mjs examples/<slug> (après avoir écrit vo/text.txt).
5. Resynchronisez avec les mots réels (automatique), rendez la vidéo, puis le son : node recipe/tools/render.mjs examples/<slug>/film.mjs <out> --video --name silent.mp4 python -I recipe/tools/sound.py examples/<slug> <out>/silent.mp4 <out>/shots.json "<out>/<Titre>.mp4"
6. Vérifiez : rapport de cadrage, node recipe/tools/jump-scan.mjs <video> <out>/shots.json, python -I recipe/tools/sfx-levels.py <out> <out>/cue-sheet.txt, puis chaque image à l'œil (skill 13).

Où se trouvent les choses

Chemin	Quoi
skills/	les 14 skills d'étape
recipe/engine/	le moteur de rendu : core.mjs (look, post-traitement, légendes, composition, vérifications), faces.mjs, character.mjs, props.mjs, props2.mjs, kit.mjs (lieux et préréglages d'éclairage neutres), places.mjs / places2.mjs (les lieux habillés de l'exemple), index.html, vendor/three (three.js r186, MIT), fonts/
recipe/tools/	storyboard-board.mjs (le tableau du propriétaire, en PNG et page HTML cliquable), render.mjs, voiceover.mjs, sound.py, jump-scan.mjs, sfx-levels.py, paths.mjs (où se trouvent FFmpeg, Chrome et Playwright)
templates/	new-film/film.mjs (un squelette neutre qui tourne avec un timing provisoire) et les feuilles de travail
examples/how-gravity-was-found/	le film approuvé : source, voix, vidéo finale, storyboard, feuille de repérage, stems, versions antérieures
references/	l'étude de référence, les directives du propriétaire, l'API du moteur, le catalogue des bugs, l'historique des feedbacks, les notes sur le moteur
brand/	les couleurs et polices du film approuvé : palette.json, palette.css, style-sheet.png (dessiné par recipe/tools/style-sheet.mjs)
evaluation/	liste de contrôle de livraison, critères d'acceptation, limites connues
preview/	style-card.json : le nom, l'apparence et le format du style en une carte, pointant vers l'affiche, le film et le storyboard de l'exemple

Installation sur une nouvelle machine

Les outils nécessitent :

• Node 22+ ;
• FFmpeg 6+ avec ffprobe, dans le PATH ;
• Python 3.10+ avec NumPy ;
• une carte graphique que Chrome peut utiliser pour WebGL2.

Dans le dossier du paquet, exécutez npm install, npx playwright install chromium et pip install -r requirements.txt ; le README contient les étapes complètes. Si FFmpeg se trouve ailleurs, définissez CARTOON_FFMPEG. Pour utiliser un autre Chrome, définissez CARTOON_CHROME (voir recipe/tools/paths.mjs).

Les films doivent se trouver dans le dossier du paquet (examples/<slug>/), car le moteur de rendu sert le paquet au navigateur. La voix nécessite une clé API ElevenLabs avec autorisation de synthèse vocale, passée comme ELEVENLABS_API_KEY pour la seule commande et jamais écrite dans un fichier.