¿Qué hace gertie?
Gertie convierte un pequeño archivo de escena que escribes en una animación terminada, como Lottie JSON y como SVG animado. Tú decides qué dibujar y cómo se mueve. Gertie compila, verifica y renderiza.
Esta versión cubre escritura, compilación, validación y control de calidad de escenas, con ambas salidas, y exportación a GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 y un archivo .lottie, o directamente a una plataforma con sus límites (Telegram, Discord, Slack, WhatsApp y más), y construcción de videos multi-escena con subtítulos, transiciones y música desde un storyboard, y creación de animaciones de caracteres de texto (ASCII). Lee references/export.md antes de exportar, references/video.md antes de hacer un video y references/ascii.md antes de hacer animación ASCII.
Reglas
- Nunca escribas Lottie JSON a mano. Escribe un archivo de escena y compílalo.
- Nunca presentes un resultado que no haya pasado
qacon cero errores. - Lee
references/scene.mdantes de escribir tu primera escena. Los modelos que lo omiten inventan campos que no existen. - Si el usuario proporciona un SVG, impórtalo en lugar de redibujarlo: lee
references/import.md. - Si el usuario proporciona un archivo Lottie, lee
references/lottie.md. No lo reescribas a mano. - Si el usuario proporciona un logotipo PNG o JPEG, icono o ilustración plana, calcarlo: lee
references/trace.md. Si es una pintura o foto con textura y el usuario quiere que se mueva un poco (un parpadeo, una inclinación de cabeza, un fondo flotante), leereferences/cutout.md. - Si el usuario muestra un video o GIF y quiere "algo que se mueva así", lee
references/motion-reference.md. - Si el usuario quiere un video de varias escenas (una introducción, un reel, un explicativo, un anuncio) con subtítulos, transiciones o música, lee
references/video.md. Escribe una escena por archivo, luego un.story.json, y ejecutastory. - Si el usuario quiere animación ASCII o de caracteres de texto (un banner para README, un loader de terminal, un aspecto retro, un clip denso y colorido de caracteres o puntos), o muestra un clip ASCII para imitar, lee
references/ascii.md. Es un motor separado con su propio archivo de escena (.ascii.json) y comandos. Asuntos pequeños: escribe fotogramas en un archivo de texto o genera. Algo denso o suave: construye una escena vectorial, pasaqay convierte como receta. Varias cosas en movimiento: capas. Para imitar un clip:ascii probepara su cuadrícula y colores. Nunca dibujes formas grandes en caracteres. - Antes de dibujar algo más que unas pocas formas (un personaje, una ilustración, una escena), lee
references/artwork.md: orden de construcción, curvas, sombreado, paleta, tamaño del lienzo. Las escenas hechas solo de primitivas o color plano generanW-ART-PRIMITIVEyW-ART-FLAT. - Lee
references/motion.mdantes de escribir fotogramas clave para algo más que un giro o deslizamiento simple, y siempre para un personaje. Usa preajustes de movimiento y preajustes de rig en lugar de fotogramas clave colocados a mano: le dan a la animación su suavidad, anticipación, sobreimpulso y compresión.
Flujo de trabajo
-
Entiende la solicitud. Acuerda el tema, el movimiento, el tamaño y si es un bucle. Pregunta solo si una respuesta faltante cambiaría el resultado. Si no, usa valores predeterminados: lienzo 512 por 512, 30 fps, 2 segundos, bucle, fondo transparente.
-
Escribe la escena como
<nombre>.gertie.json. Si el usuario proporcionó un SVG, ejecuta primeronode scripts/gertie.mjs import <file.svg> --jsone incluye el resultado (verreferences/import.md). Los tiempos están en segundos. Los nodos posteriores se dibujan encima de los anteriores. Asigna un preajustemotiondonde corresponda. Para un personaje, construye un rig y usa preajustes de rig (references/motion.md). -
Verifica. Ejecuta el script en
scripts/gertie.mjsdentro de la carpeta de esta habilidad:node scripts/gertie.mjs qa <nombre>.gertie.json --jsonEsto compila la escena, valida la salida, renderiza fotogramas de muestra en un navegador y ejecuta las comprobaciones de renderizado. Los archivos van a
out/junto a la escena:<nombre>.lottie.json,<nombre>.svgy<nombre>.sheet.png. La comprobación renderiza el Lottie y el SVG por separado y los compara, fotograma por fotograma. -
Corrige cada diagnóstico. Cada uno tiene un
code, unpatha tu escena, unmessagey unfix. Aplica la corrección, edita la escena y ejecutaqade nuevo. Corrige primero los errores, luego lee las advertencias.W-LOOP-JUMPyW-R-LOOPsignifican que el bucle salta visiblemente;W-R-CLIPPEDsignifica que algo está cortado por el borde del lienzo.W-SYNCsignifica que tres o más hijos de un grupo ejecutan el mismo bucle al unísono, lo que se ve mecánico: dale al grupo unstaggercon unphase, o dale a cada entrada su propiophase.E-R-PARITYsignifica que el Lottie y el SVG se ven diferentes, por lo que una de las dos salidas es incorrecta: nombra el fotograma, un nodo y una imagen de diferencia (outputs.parity). Simplifica la animación de ese nodo para encontrar la causa e informa al usuario si es un error en Gertie. -
Míralo. Abre la imagen de la hoja de contactos nombrada en
outputs.sheet. Muestra ocho fotogramas en orden, cada uno etiquetado con su número de fotograma y tiempo, dibujado sobre un tablero de ajedrez para que la transparencia sea visible. Verifica que las cosas correctas estén presentes, los colores sean correctos, el movimiento entre fotogramas tenga sentido y nada esté cortado o superpuesto. Si no está bien, edita la escena y vuelve al paso 3. Detente después de tres rondas de revisión visual. Usa--sheet-frames 16para más detalle al depurar el tiempo. -
Mide contra el nivel de calidad para algo más que un icono rápido. Establece el
"tier"de nivel superior de la escena a lo que estás haciendo, luego ejecutanode scripts/gertie.mjs profile <scene>. Ver "Niveles de calidad" más abajo. -
Exporta solo si el usuario necesita otro formato:
node scripts/gertie.mjs export <scene> --to <formats>o--for <destination>. Verreferences/export.md. Necesita ffmpeg para todo exceptolottie,svgylottie-zip. -
Entrega los archivos
.lottie.jsony.svg, el archivo de escena y la hoja de contactos. Di qué se verificó. Si el informe tiene una listabaked, el SVG lleva un fotograma clave por fotograma para esas propiedades; es correcto pero más grande, y simplificarlos (misma suavización y tiempos en inicio, fin y desplazamiento de recorte; sin suavización de sobreimpulso en una morph o en tamaño de rect y elipse) lo reduce.
Otros comandos:
node scripts/gertie.mjs qa <scene> --thorough renderiza cada fotograma y también verifica destellos de un fotograma
node scripts/gertie.mjs compile <scene> --json solo compila, sin navegador; --lottie o --svg escribe solo una salida
node scripts/gertie.mjs validate <file> --json verifica una escena o cualquier archivo Lottie
node scripts/gertie.mjs export <scene> --to webm --json escribe otros formatos; ver references/export.md
node scripts/gertie.mjs import <file.svg> --json convierte un SVG en un fragmento con un resumen y una vista previa etiquetada; ver references/import.md
node scripts/gertie.mjs trace <logo.png> --json calcografiar un PNG o JPEG plano a formas; luego agrupar; ver references/trace.md
node scripts/gertie.mjs cutout <painting.png> <parts.json> --json cortar una pintura en capas a lo largo de contornos; ver references/cutout.md
node scripts/gertie.mjs grid <image.png> --step 50 dibujar una cuadrícula etiquetada en una imagen para leer coordenadas de píxeles
node scripts/gertie.mjs render <file.lottie.json> --times 0.6,1.1 --out frames dibujar fotogramas a tamaño completo en momentos elegidos
node scripts/gertie.mjs story <video.story.json> --json construir un MP4 a partir de escenas con subtítulos, transiciones y música; ver references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ... animación de caracteres de texto; ver references/ascii.md
node scripts/gertie.mjs ascii probe <clip.mp4> --json leer la cuadrícula, colores y velocidad de fotogramas de un clip ASCII para imitar
node scripts/gertie.mjs study <clip.mp4> --json medir el movimiento en un video o GIF y dibujar una hoja de contactos; ver references/motion-reference.md
node scripts/gertie.mjs study <clip.mp4> --crop x,y,w,h --rate source --json lo mismo sobre un sujeto a la propia velocidad de fotogramas del clip, con una lista de inactividad para pequeños movimientos
node scripts/gertie.mjs sample <image-or-clip> --at x,y --at x,y imprimir el color en cada punto como hexadecimal, de los píxeles; --time seconds selecciona el fotograma de un clip
node scripts/gertie.mjs profile <scene or file.json> [--tier icon|character|scene] --json medir caminos, colores, fotogramas clave y suavización contra las bandas de calidad
node scripts/gertie.mjs inspect <file.json> --json describir un archivo Lottie; también recolorear, reajustar tiempo y renderizar, ver references/lottie.md
node scripts/gertie.mjs doctor informar si Node, un navegador y ffmpeg están disponibles y qué formatos de exportación funcionan
El código de salida 0 significa sin errores, 1 significa que se encontraron errores, 2 significa que el comando no pudo ejecutarse.
Niveles de calidad
Las animaciones hechas profesionalmente del mismo tipo se ven igual al medirlas. profile mide tu animación compilada de la misma manera y marca cada medida inside, below o above de la banda para su nivel. Nunca falla; te dice dónde está la brecha. validate --json y qa --json incluyen el mismo informe bajo profile.
| Nivel | Qué es | Qué necesita más |
|---|---|---|
icon | Un icono o loader, de unos 512 píxeles, 1.5 a 3 segundos | Pocas formas (5 a 20 caminos, 2 a 5 colores), pero cada movimiento suavizado, con sobreimpulso y un bucle limpio |
character | Un personaje o ilustración, de 800 a 1024 píxeles, 2 a 6 segundos | Un dibujo real: 40 a 80 caminos, 6 a 12 colores y movimiento denso (25 a 60 fotogramas clave por segundo, 4 o más suavizaciones diferentes) |
scene | Una escena completa, 1080 píxeles, 5 a 10 segundos | Mucho más dibujo (120 a 250 caminos, 12 a 20 colores) pero no más movimiento que un personaje: anima bien unas pocas cosas |
Declara el nivel en la escena con "tier": "icon" (o "character", "scene") para que el informe marque una banda; sin él profile informa los tres. En cada nivel, apunta a al menos tres cuartos de segmentos suavizados y al menos un cuarto de propiedades animadas comenzando en un fotograma propio (desplazamiento, no sincronizar). Un below en caminos o colores significa que el dibujo es demasiado simple; un below en fotogramas clave por segundo significa que las cosas dejan de moverse entre poses.
Qué puede y no puede hacer cada salida
- Lottie JSON se reproduce en lottie-web, reproductores dotlottie y reproductores móviles nativos. Úsalo para aplicaciones.
- GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 se crean con
export. Son imágenes de la animación, no vectores. - SVG animado no necesita reproductor ni JavaScript. Se reproduce al abrirse en un navegador, en una etiqueta
<img>y en un README (verificado en Chromium y WebKit; Firefox no ha sido verificado). No se puede pausar ni desplazar, y las aplicaciones móviles nativas no pueden reproducirlo. Bajoprefers-reduced-motionmuestra un solo fotograma fijo, elegido por elposteropcional de nivel superior de la escena (segundos). Las morphs y los cambios de tamaño de rect o elipse siguen moviéndose bajo movimiento reducido.
Si no puedes ver imágenes
Omite el paso 5. Confía en las comprobaciones automáticas e informa al usuario que el resultado fue verificado automáticamente pero no visualmente.
Si no hay navegador
qa aún compila y valida, e informa "render": "skipped" con el comando que lo soluciona. Ejecuta node scripts/gertie.mjs doctor, sigue lo que dice e informa al usuario que las comprobaciones de renderizado no se ejecutaron hasta que lo hagan.
Si no puedes ejecutar comandos
Escribe el archivo de escena siguiendo references/scene.md y entrégalo al usuario con el comando de compilación.