D'une illustration unique à un personnage vectoriel animé
Cette procédure permet d'ajouter un nouveau personnage à ce dépôt (vector-avator). À partir d'une illustration unique du personnage, créez une pose avant redessinée dans le même style artistique et une feuille de personnage, demandez à Fable 5.2 de dessiner les pièces en vecteurs, inspectez-les, puis animez-les dans le visualiseur.
Le personnage exemple est un lapin (ID de personnage usagi ; illustration originale dans inputs/kariusagi/). Les résultats complets de chaque étape se trouvent dans public/characters/usagi/vector/ et tools/vector/sheets/characters/usagi.* – comparez-les en cas de doute.
0. Prérequis
Le répertoire de travail est la racine de ce dépôt. Toutes les commandes ci-dessous sont des chemins relatifs par rapport à la racine.
| Outil | Utilisation | Étape | Vérification |
|---|---|---|---|
| Claude Code + Fable 5.2 | Obligatoire | 5. Découpage des pièces (sous-agent) | Le sous-agent doit pouvoir utiliser Fable 5.2 comme modèle |
| Codex CLI (imagegen) | Obligatoire | 2. Transformation du style, 4. Feuilles | codex --version, codex login effectué (fonctionne avec un abonnement ChatGPT, pas de clé API nécessaire) |
| Node 22, npm | Obligatoire | 7. Visualiseur, 8. Vidéo | npm install effectué |
| Python 3.10+ | Obligatoire | 2 à 6 | python3 -m venv .venv && .venv/bin/pip install -r requirements.txt |
| resvg | Obligatoire | 6. Images de vérification | resvg --version (via cargo install resvg ou autre) |
| Chromium de Playwright, ffmpeg | Obligatoire | 7-8. Capture, vidéo | npx playwright install chromium, ffmpeg -version |
| MiniMax H3 (ComfyUI) | Optionnel | 3. Échantillons d'angle | API ComfyUI (par défaut http://127.0.0.1:8188). Sinon, sautez l'étape 3 |
| TTS | Optionnel | 8. Audio pour synchronisation labiale | Sinon, utilisez la synchro labiale textuelle pour l'animation |
Si Fable 5.2 ou Codex imagegen ne sont pas disponibles, informez-en l'utilisateur et arrêtez-vous. Remplacer le découpage des pièces par un autre modèle conduit à une qualité insuffisante.
Port du serveur de développement : Par défaut 5280 (npm run dev). Si occupé, lancez npx vite --port <port> --strictPort et ajoutez VIEWER_URL=http://127.0.0.1:<port>/ à toutes les commandes de capture et d'export vidéo (viewer_shots.mjs, record.mjs). Indiquez également cette URL dans les instructions transmises à Fable.
Estimation des coûts et du temps (mesurée)
Mesures réelles pour le lapin exemple (47 pièces). Pour les personnages suivants (à partir du second), temps total 1 à 1,5 heure par personnage (y compris l'attente). Le travail humain se limite à la rédaction des caractéristiques et aux revues.
| Étape | Responsable | Durée | Nombre de passages |
|---|---|---|---|
| 1. Notes du personnage | Claude (principal) | environ 10 min | — |
| 2. Pose avant | Codex imagegen | environ 4,7 min | 2 générations, 1 retenue |
| 3. Échantillons d'angle (optionnel) | MiniMax H3 | environ 7 min | 1 passage |
| 4. 2 feuilles | Codex imagegen | environ 5 min | 1 chacune |
| 5. Découpage des pièces | Fable 5.2 | environ 16 min + environ 2,5 min de corrections | 1 passage + 1 correction |
| 6-7. Inspection, vérification, ajustements | Claude (principal) | environ 20 min | — |
- Codex imagegen prend environ 2 à 2,5 minutes par image. Atteindre la limite de votre abonnement ChatGPT peut entraîner plusieurs heures d'attente. Par personnage, il faut 1 à 2 images de face et 2 feuilles.
- Le découpage par Fable 5.2 a pris environ 22 min (49 pièces) et 24 min (61 pièces) pour deux autres personnages.
- Un agent ignorant le contexte a réalisé un personnage complet (63 pièces) en utilisant uniquement ce skill : environ 43 min (4 imagegen, 1 passage Fable : environ 24 min, 280k tokens), sans aucune correction.
- Les compteurs de tokens et les coûts n'ont pas été mesurés.
Vue d'ensemble du processus
| Étape | Contenu | Outil | Sortie |
|---|---|---|---|
| 1 | Rédiger les notes du personnage (caractéristiques à conserver) | Manuscrit | tools/vector/sheets/characters/<id>.md / .json |
| 2 | Transformer l'illustration originale dans le style commun, créer la pose avant en A | make.py gen <id> restyle | ref/front.png |
| 3 | Extraire les images d'une vidéo de rotation à 360° (optionnel) | turntable.sh <id> | ref/turntable.mp4, ref/angle_*.png |
| 4 | 2 feuilles (vues à 360° + formes des mains, variations faciales) | make.py gen <id> sheet_turnaround / sheet_face | ref/sheet_turnaround.png, ref/sheet_face.png |
| 5 | Pièces uniquement remplies, complétées jusqu'aux zones cachées | Fable 5.2 + references/fable-brief.md | vector.json |
| 6 | Inspection structurelle et vérification visuelle des images | check_parts.py <id> | 0 erreur |
| 7 | Tester et ajuster dans le visualiseur | npm run dev, viewer_shots.mjs | vector.json ajusté |
| 8 | Export vidéo et synchronisation labiale | record.mjs, lipsync.py | MP4 |
ref/ correspond à public/characters/<id>/vector/ref/. L'ID du personnage est en lettres minuscules (ex. usagi). Les images d'essai et les fichiers de travail de Fable sont stockés dans var/vector/<id>/ (non versionnés).
1. Rédiger les notes du personnage
Dans tools/vector/sheets/characters/<id>.md, notez en liste à puces les caractéristiques à conserver même après changement de style. Dans <id>.json, indiquez le chemin de l'illustration originale et son rôle. Placez l'original dans inputs/<id>/ ou similaire.
- Le format et l'exemple sont dans
references/character-notes.md. Exemple pour le lapin :tools/vector/sheets/characters/usagi.md/usagi.json. - Notez les couleurs approximatives (
#RRGGBB). - Le style commun (
tools/vector/sheets/style_base.md) dessine le personnage comme un « animal / créature ». Si cela modifie le personnage (ex. poils sur un personnage sans poils, réinterprétation en animal), annulez-le en notant explicitement dans les notes : « ne pas dessiner ~ », « ne pas appliquer ~ ». Ne modifiez pas le fichier de style commun. - Si l'original est dans une pose dynamique (torsion, bras pliés), le répertoire
layouts/restyle.mddemandera le dessin en pose avant en A. Inutile de le mentionner dans les notes ; ajouter dans<id>.jsonle rôle « ne pas se référer à la pose » stabilise le résultat.
Parallèlement, enregistrez le personnage dans le visualiseur. Nécessaire pour que Fable puisse vérifier à l'étape 5. data/characters/<id>.json :
{ "id": "<id>", "label": "<nom du personnage>", "vector": { "url": "characters/<id>/vector/vector.json" } }
2. Pose avant (Codex imagegen)
.venv/bin/python tools/vector/sheets/make.py gen <id> restyle --count 2
.venv/bin/python tools/vector/sheets/make.py log <id>
.venv/bin/python tools/vector/sheets/make.py adopt <id> restyle <numéro>
- Le prompt assemble « style commun + notes personnage + ce qui est dessiné (
layouts/restyle.md) » et le transmet à imagegen viacodex exec. Les essais sont stockés dansvar/vector/<id>/gen/avec le prompt et la durée. - Inspectez visuellement l'image générée et comparez-la à l'original. Points à vérifier : reconnaît-on le personnage ? Est-il en 2 à 2,5 têtes ? Pose avant en A avec un espace sous les aisselles ? Pas de reflet dans les yeux ? Pas de strabisme ?
- Si pas conforme, corrigez avec
--note "instruction supplémentaire"ou modifiez les notes du personnage (ex. le lapin ressemblait à un autre personnage à cause du « volume des poils » du style commun, annulé dans les notes). Conservez la correction dans les notes. adoptplace l'image retenue dansref/front.png(1024×1536).
3. Échantillons d'angle (optionnel : MiniMax H3)
bash tools/vector/sheets/turntable.sh <id> # COMFY_SERVER permet de changer l'URL ComfyUI
- Rédigez d'abord
tools/vector/sheets/h3/<id>.txt(prompt de la vidéo de rotation) en utilisanth3/usagi.txtcomme modèle. Remplacez uniquement la description du personnage. - Les sorties
angle_045.png,angle_090.png,angle_180.pngsont automatiquement ajoutées comme images de référence pour la génération des feuilles à l'étape 4. La rotation H3 n'étant pas à vitesse constante, les angles sont indicatifs. - Si vous n'avez pas ComfyUI ni H3, sautez cette étape. Le découpage des pièces reste possible avec les seules feuilles.
4. Deux feuilles de personnage (Codex imagegen)
.venv/bin/python tools/vector/sheets/make.py gen <id> sheet_turnaround
.venv/bin/python tools/vector/sheets/make.py adopt <id> sheet_turnaround 1
.venv/bin/python tools/vector/sheets/make.py gen <id> sheet_face
.venv/bin/python tools/vector/sheets/make.py adopt <id> sheet_face 1
- La première feuille comporte 4 vues (face, trois-quarts, profil, dos) et 4 formes de main (ouverte, index pointé, poing, paume) ; la seconde, les variations faciales (yeux : ouverts, mi-clos, fermés ; bouche : fermée, a, i, u, e, o ; expressions : normale, sourire, surprise, gênée).
- Les vues trois-quarts et profil doivent montrer le visage tourné vers la gauche de l'image (même orientation que la rotation H3).
- Vérifiez visuellement qu'il s'agit bien du même personnage que la pose avant et que les variations sont cohérentes (ex. les iris ne sont pas écrasés dans les yeux mi-clos). Si non, corrigez avec
--noteet regénérez.
5. Découpage des pièces (sous-agent Fable 5.2)
- À partir du modèle
references/fable-brief.md, insérez l'ID du personnage, son nom, les consignes spécifiques et l'URL du visualiseur (par défauthttp://127.0.0.1:5280/). Enregistrez le tout dansvar/vector/<id>/fable/brief.md. Le format et l'exemple (lapin) pour les consignes spécifiques sont dansreferences/character-notes.md. - Lancez un sous-agent configuré avec Fable 5.2 et transmettez-lui l'intégralité de
brief.md. Fable crée alorspublic/characters/<id>/vector/vector.jsonvia un script de dessin conforme àreferences/parts-spec.md, s'inspecte lui-même, puis fait rapport. - Lisez le rapport, puis effectuez l'inspection (étape 6) et la vérification (étape 7). Si des corrections sont nécessaires, demandez-les au même sous-agent (en ouvrir un nouveau perdrait le contexte).
Règles à faire respecter (déjà dans le modèle) :
- Les pièces sont dessinées à partir de zéro en unités sémantiques. Pas de découpage de pixels ni d'auto-tracé pour déterminer les formes.
- Dessiner uniquement en remplissage. Les contours sont ajoutés automatiquement au rendu.
- Compléter les parties cachées (front sous la frange, tête sous la base des oreilles, torse sans les bras, cou, base de la queue, etc.).
- Ne pas dessiner les bras (générés au rendu). À la place, mesurer et noter les marqueurs du squelette, l'épaisseur et la couleur des bras.
_L/_R: la gauche et la droite du personnage lui-même (dans la vue de face,_Lest à droite de l'image).
6. Inspection
.venv/bin/python tools/vector/check_parts.py <id>
- Réussite : 0 erreur. Les avertissements sont à juger.
- Inspectez visuellement les images de vérification (
var/vector/<id>/check/). Les points à vérifier sont dansreferences/visual-qa.md. Notamment : dans les images avec pièces avant masquées (qa_*.png), vérifiez l'absence de trous ou de coupures ; que les variations (variants.png,expressions.png) correspondent aux feuilles ; et que le squelette (skeleton.png) est cohérent avec le dessin. - Les images de vérification n'incluent pas les contours automatiques ni les bras générés. L'apparence finale sera vérifiée à l'étape 7.
7. Tester dans le visualiseur
-
Assurez-vous que
data/characters/<id>.json(créé à l'étape 1) existe. -
Lancez le serveur de développement avec
npm run devet ouvrezhttp://localhost:5280/?char=<id>(si plusieurs personnages, un sélecteur apparaît). -
Capturez pour vérifier (serveur de développement en cours) :
DSF=2 node tools/capture/viewer_shots.mjs var/vector/<id>/check/viewer \ neutral="char=<id>" face30="char=<id>&framing=face&yaw=30&blink=0" faceM30="char=<id>&framing=face&yaw=-30&blink=0" \ explain="char=<id>&motion=explain&t=1.0" spread="char=<id>&motion=spread&t=1.2" \ half="char=<id>&framing=face&eye=half&blink=0" point="char=<id>&motion=point&t=1.5" -
Points à vérifier : pas de lignes parasites aux jointures des pièces du personnage (notamment blanc sur blanc), les yeux ne dépassent pas du contour du visage à ±30° de rotation, la base des oreilles/cheveux ne se détache pas de la tête, l'épaisseur et la couleur des bras et des mains sont cohérentes, le mouvement des éléments pendants.
-
Les ajustements se font en modifiant les valeurs dans
vector.json. Testez d'abord avec les paramètres d'URL, puis mettez à jour le fichier. La liste des valeurs ajustables se trouve dansreferences/tuning.md, les problèmes courants et leurs solutions dansreferences/troubleshooting.md.
8. Export vidéo et synchronisation labiale
# Vidéo (serveur de développement en cours)
node tools/vector/record.mjs --out out/<id>_explain --motion explain --query "char=<id>"
# Synchronisation labiale : à partir d'un fichier WAV et du texte (en kana pour le japonais). Le type de TTS n'a pas d'importance
.venv/bin/python tools/lipsync/lipsync.py line.wav --text "こんにちは、よろしくおねがいします。" -o line.json
node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --lipsync line.json --audio line.wav --query "char=<id>"
- Sans TTS, vous pouvez créer une vidéo avec synchro labiale textuelle :
node tools/vector/record.mjs --out out/<id>_hello --motion talk_demo --seconds 6 --query "char=<id>&say=こんにちは、よろしくね。". Le texte est répété en boucle selon la durée de la vidéo (déterminée par la durée de la motion, ou par--secondspour les motions sans boucle). Pour une durée basée sur la longueur du texte, utilisez--seconds(estimation : 0,15 s par more, 0,3 s par ponctuation). - Pour un texte en anglais :
--lang en. Pour une analyse uniquement basée sur l'amplitude sans texte :--method rms. Si vous disposez de timings de mots issus de Whisper :--whisper whisper.json. - Couleur de fond :
--query "bg=ffd3e0". Lignes style dessin :vHand=0-4(aucune, faible, moyenne, forte, dessin à la main +). Fort par défaut. - Le visualiseur peut également charger le JSON de synchro labiale et le fichier audio pour lecture.
Une fois terminé
Rapportez à l'utilisateur :
- Les fichiers créés (images
ref/,vector.json,data/characters/<id>.json) et l'emplacement des images de vérification et vidéos - Les durées de chaque étape et le nombre de générations/corrections
- Les résultats de l'inspection et les problèmes restants (pièces dont vous n'êtes pas sûr, rendu non corrigé)