Que fait Gertie ?
Gertie transforme un petit fichier de scène que vous écrivez en une animation terminée, au format Lottie JSON et SVG animé. Vous décidez quoi dessiner et comment cela bouge. Gertie compile, vérifie et effectue le rendu.
Cette version couvre l'écriture, la compilation, la validation et le contrôle qualité des scènes, avec les deux sorties, et l'export vers GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 et une archive .lottie, ou directement vers une plateforme avec ses limites (Telegram, Discord, Slack, WhatsApp et plus), ainsi que la construction de vidéos multi-scènes avec légendes, transitions et musique à partir d'un storyboard, et la création d'animations en caractères (ASCII). Lisez references/export.md avant d'exporter, references/video.md avant de créer une vidéo et references/ascii.md avant de faire une animation ASCII.
Règles
- N'écrivez jamais de Lottie JSON à la main. Écrivez un fichier de scène et compilez-le.
- Ne présentez jamais un résultat qui n'a pas passé
qaavec zéro erreur. - Lisez
references/scene.mdavant d'écrire votre première scène. Les modèles qui l'ignorent inventent des champs qui n'existent pas. - Si l'utilisateur fournit un SVG, importez-le au lieu de le redessiner : lisez
references/import.md. - Si l'utilisateur fournit un fichier Lottie, lisez
references/lottie.md. Ne le réécrivez pas à la main. - Si l'utilisateur fournit un logo PNG ou JPEG, une icône ou une illustration plate, tracez-le : lisez
references/trace.md. S'il s'agit d'une peinture ou d'une photo avec texture et que l'utilisateur souhaite qu'elle bouge un peu (un clin d'œil, une inclinaison de tête, un arrière-plan flottant), lisezreferences/cutout.md. - Si l'utilisateur montre une vidéo ou un GIF et veut "quelque chose qui bouge comme ça", lisez
references/motion-reference.md. - Si l'utilisateur veut une vidéo de plusieurs scènes (une intro, un reel, un explicatif, une pub) avec légendes, transitions ou musique, lisez
references/video.md. Écrivez une scène par fichier, puis un.story.json, et exécutezstory. - Si l'utilisateur veut une animation ASCII ou en caractères (une bannière README, un chargeur de terminal, un look rétro, un clip dense et coloré de caractères ou de points), ou montre un clip ASCII à imiter, lisez
references/ascii.md. Il s'agit d'un moteur séparé avec son propre fichier de scène (.ascii.json) et ses propres commandes. Petits sujets : écrivez les frames dans un fichier texte ou générez-les. Tout ce qui est dense ou fluide : construisez une scène vectorielle, passezqa, et convertissez-la en recette. Plusieurs choses en mouvement : des couches. Pour imiter un clip :ascii probepour sa grille et ses couleurs. Ne dessinez jamais de grandes formes en caractères. - Avant de dessiner quoi que ce soit au-delà de quelques formes (un personnage, une illustration, une scène), lisez
references/artwork.md: ordre de construction, courbes, ombrage, palette, taille du canevas. Les scènes composées uniquement de primitives ou de couleurs unies lèventW-ART-PRIMITIVEetW-ART-FLAT. - Lisez
references/motion.mdavant d'écrire des images clés pour quoi que ce soit au-delà d'une simple rotation ou glissade, et toujours pour un personnage. Utilisez des préréglages de mouvement et de rig plutôt que des images clés placées manuellement : ils donnent à l'animation son assouplissement, son anticipation, son dépassement et son écrasement.
Workflow
-
Comprendre la demande. Déterminez le sujet, le mouvement, la taille et si cela boucle. Ne demandez que si une réponse manquante changerait le résultat. Sinon, utilisez les valeurs par défaut : canevas 512 par 512, 30 ips, 2 secondes, bouclage, fond transparent.
-
Écrire la scène sous la forme
<nom>.gertie.json. Si l'utilisateur a fourni un SVG, exécutez d'abordnode scripts/gertie.mjs import <fichier.svg> --jsonet incluez le résultat (voirreferences/import.md). Les temps sont en secondes. Les nœuds ultérieurs se dessinent par-dessus les précédents. Donnez aux choses un préréglagemotionlà où il convient. Pour un personnage, construisez un rig et utilisez des préréglages de rig (references/motion.md). -
Vérifier. Exécutez le script
scripts/gertie.mjsdans le dossier de cette compétence :node scripts/gertie.mjs qa <nom>.gertie.json --jsonCela compile la scène, valide la sortie, effectue le rendu d'images échantillonnées dans un navigateur et exécute les contrôles de rendu. Les fichiers vont dans
out/à côté de la scène :<nom>.lottie.json,<nom>.svget<nom>.sheet.png. La vérification effectue le rendu du Lottie et du SVG séparément et les compare, image par image. -
Corriger chaque diagnostic. Chacun a un
code, unpathdans votre scène, unmessageet unfix. Appliquez le correctif, modifiez la scène et relancezqa. Corrigez d'abord les erreurs, puis lisez les avertissements.W-LOOP-JUMPetW-R-LOOPsignifient que la boucle saute visiblement ;W-R-CLIPPEDsignifie que quelque chose est coupé par le bord du canevas.W-SYNCsignifie que trois enfants ou plus d'un même groupe exécutent la même boucle à l'unisson, ce qui semble mécanique : donnez au groupe unstaggeravec unphase, ou donnez à chaque entrée son proprephase.E-R-PARITYsignifie que le Lottie et le SVG ont un rendu différent, donc l'une des deux sorties est erronée : elle nomme l'image, un nœud et une image de différence (outputs.parity). Simplifiez l'animation de ce nœud pour trouver la cause, et informez l'utilisateur s'il s'agit d'un bug dans Gertie. -
Regarder. Ouvrez l'image de la planche contact nommée dans
outputs.sheet. Elle montre huit images dans l'ordre, chacune étiquetée avec son numéro d'image et son temps, dessinée sur un damier pour que la transparence soit visible. Vérifiez que les bonnes choses sont présentes, que les couleurs sont correctes, que le mouvement entre les images a du sens et que rien n'est coupé ou ne se chevauche. Si ce n'est pas correct, modifiez la scène et revenez à l'étape 3. Arrêtez après trois cycles de révision visuelle. Utilisez--sheet-frames 16pour plus de détails lors du débogage du timing. -
Mesurer par rapport au niveau de qualité pour tout ce qui dépasse une icône rapide. Définissez le
"tier"de premier niveau de la scène sur ce que vous fabriquez, puis exécuteznode scripts/gertie.mjs profile <scène>. Voir "Niveaux de qualité" ci-dessous. -
Exporter uniquement si l'utilisateur a besoin d'un autre format :
node scripts/gertie.mjs export <scène> --to <formats>ou--for <destination>. Voirreferences/export.md. Il nécessite ffmpeg pour tout sauflottie,svgetlottie-zip. -
Livrer les fichiers
.lottie.jsonet.svg, le fichier de scène et la planche contact. Dites ce qui a été vérifié. Si le rapport a une listebaked, le SVG porte une image clé par image pour ces propriétés ; c'est correct mais plus volumineux, et les simplifier (même assouplissement et mêmes temps sur le début, la fin et le décalage de coupe ; pas d'assouplissement de dépassement sur une morphose ou sur la taille d'un rectangle et d'une ellipse) le réduit.
Autres commandes :
node scripts/gertie.mjs qa <scène> --thorough effectue le rendu de chaque image et vérifie également les flashs d'une seule image
node scripts/gertie.mjs compile <scène> --json compilation seule, sans navigateur ; --lottie ou --svg écrit une seule sortie
node scripts/gertie.mjs validate <fichier> --json vérifie une scène ou tout fichier Lottie
node scripts/gertie.mjs export <scène> --to webm --json écrit d'autres formats ; voir references/export.md
node scripts/gertie.mjs import <fichier.svg> --json transforme un SVG en un fragment avec un résumé et un aperçu étiqueté ; voir references/import.md
node scripts/gertie.mjs trace <logo.png> --json trace un PNG ou JPEG plat en formes ; puis groupe ; voir references/trace.md
node scripts/gertie.mjs cutout <peinture.png> <parts.json> --json découpe une peinture en couches le long des contours ; voir references/cutout.md
node scripts/gertie.mjs grid <image.png> --step 50 dessine une grille étiquetée sur une image pour lire les coordonnées des pixels
node scripts/gertie.mjs render <fichier.lottie.json> --times 0.6,1.1 --out frames effectue le rendu d'images pleine taille à des temps choisis
node scripts/gertie.mjs story <vidéo.story.json> --json construit un MP4 à partir de scènes avec légendes, transitions et musique ; voir references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ... animation en caractères ; voir references/ascii.md
node scripts/gertie.mjs ascii probe <clip.mp4> --json lit la grille, les couleurs et la fréquence d'images d'un clip ASCII à imiter
node scripts/gertie.mjs study <clip.mp4> --json mesure le mouvement dans une vidéo ou un GIF et dessine une planche contact ; voir references/motion-reference.md
node scripts/gertie.mjs study <clip.mp4> --crop x,y,w,h --rate source --json la même chose sur un seul sujet à la fréquence d'images du clip, avec une liste d'arrêt pour les petites oscillations
node scripts/gertie.mjs sample <image-ou-clip> --at x,y --at x,y affiche la couleur à chaque point en hexadécimal, à partir des pixels ; --time secondes sélectionne l'image d'un clip
node scripts/gertie.mjs profile <scène ou fichier.json> [--tier icon|character|scene] --json mesure les chemins, les couleurs, les images clés et l'assouplissement par rapport aux bandes de qualité
node scripts/gertie.mjs inspect <fichier.json> --json décrit un fichier Lottie ; également recolorer, re-temporiser et effectuer le rendu, voir references/lottie.md
node scripts/gertie.mjs doctor signale si Node, un navigateur et ffmpeg sont disponibles, et quels formats d'export fonctionnent
Le code de sortie 0 signifie aucune erreur, 1 signifie que des erreurs ont été trouvées, 2 signifie que la commande n'a pas pu s'exécuter.
Niveaux de qualité
Les animations fabriquées professionnellement du même type se ressemblent une fois mesurées. profile mesure votre animation compilée de la même manière et marque chaque mesure inside, below ou above la bande pour son niveau. Il n'échoue jamais ; il vous indique où se trouve l'écart. validate --json et qa --json incluent le même rapport sous profile.
| Niveau | Ce que c'est | Ce dont il a le plus besoin |
|---|---|---|
icon | Une icône ou un chargeur, environ 512 pixels, 1,5 à 3 secondes | Peu de formes (5 à 20 chemins, 2 à 5 couleurs), mais chaque mouvement assoupli, avec dépassement et une boucle propre |
character | Un personnage ou une illustration, 800 à 1024 pixels, 2 à 6 secondes | Un vrai dessin : 40 à 80 chemins, 6 à 12 couleurs, et un mouvement dense (25 à 60 images clés par seconde, 4 assouplissements différents ou plus) |
scene | Une scène complète, 1080 pixels, 5 à 10 secondes | Beaucoup plus de dessin (120 à 250 chemins, 12 à 20 couleurs) mais pas plus de mouvement qu'un personnage : animez bien quelques choses |
Déclarez le niveau dans la scène avec "tier": "icon" (ou "character", "scene") pour que le rapport marque une bande ; sans cela, profile signale les trois. Dans chaque niveau, visez au moins les trois quarts des segments assouplis et au moins un quart des propriétés animées commençant sur leur propre image (décalage, ne pas synchroniser). Un below sur les chemins ou les couleurs signifie que le dessin est trop simple ; un below sur les images clés par seconde signifie que les choses arrêtent de bouger entre les poses.
Ce que chaque sortie peut et ne peut pas faire
- Lottie JSON se lit dans lottie-web, les lecteurs dotlottie et les lecteurs mobiles natifs. Utilisez-le pour les applications.
- GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 sont fabriqués par
export. Ce sont des images de l'animation, pas des vecteurs. - SVG animé ne nécessite ni lecteur ni JavaScript. Il se lit lorsqu'il est ouvert dans un navigateur, dans une balise
<img>et dans un README (vérifié dans Chromium et WebKit ; Firefox n'a pas été vérifié). Il ne peut pas être mis en pause ou parcouru, et les applications mobiles natives ne peuvent pas le lire. Sousprefers-reduced-motion, il affiche une seule image fixe, choisie par leposterfacultatif de premier niveau de la scène (en secondes). Les morphoses et les changements de taille de rect ou d'ellipse continuent de bouger en mouvement réduit.
Si vous ne pouvez pas voir les images
Sautez l'étape 5. Fiez-vous aux contrôles automatiques et dites à l'utilisateur que le résultat a été vérifié automatiquement mais pas regardé.
S'il n'y a pas de navigateur
qa compile et valide toujours, et signale "render": "skipped" avec la commande qui le corrige. Exécutez node scripts/gertie.mjs doctor, suivez ce qu'il dit, et dites à l'utilisateur que les contrôles de rendu n'ont pas été exécutés jusqu'à ce qu'ils le soient.
Si vous ne pouvez pas exécuter de commandes
Écrivez le fichier de scène en suivant references/scene.md et donnez-le à l'utilisateur avec la commande de compilation.