O que Gertie faz?
Gertie transforma um pequeno arquivo de cena que você escreve em uma animação finalizada, como Lottie JSON e como SVG animado. Você decide o que desenhar e como se move. Gertie compila, verifica e renderiza.
Esta versão cobre escrita, compilação, validação e verificação de qualidade de cenas, com ambas as saídas, e exportação para GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 e um arquivo .lottie, ou diretamente para uma plataforma com seus limites (Telegram, Discord, Slack, WhatsApp e mais), e construção de vídeos com várias cenas, legendas, transições e música a partir de um storyboard, e animação em caracteres de texto (ASCII). Leia references/export.md antes de exportar, references/video.md antes de fazer um vídeo e references/ascii.md antes de fazer animação ASCII.
Regras
- Nunca escreva Lottie JSON manualmente. Escreva um arquivo de cena e compile-o.
- Nunca apresente um resultado que não tenha passado em
qacom zero erros. - Leia
references/scene.mdantes de escrever sua primeira cena. Modelos que pulam isto inventam campos que não existem. - Se o usuário fornecer um SVG, importe-o em vez de redesenhá-lo: leia
references/import.md. - Se o usuário fornecer um arquivo Lottie, leia
references/lottie.md. Não o reescreva manualmente. - Se o usuário fornecer um logotipo PNG ou JPEG, ícone ou ilustração plana, trace-o: leia
references/trace.md. Se for uma pintura ou foto com textura e o usuário quiser que ela se mova um pouco (uma piscada, uma inclinação de cabeça, um fundo flutuante), leiareferences/cutout.md. - Se o usuário mostrar um vídeo ou GIF e quiser "algo que se mova assim", leia
references/motion-reference.md. - Se o usuário quiser um vídeo de várias cenas (uma introdução, um reel, um explicador, um anúncio) com legendas, transições ou música, leia
references/video.md. Escreva uma cena por arquivo, depois um.story.json, e executestory. - Se o usuário quiser animação ASCII ou de caracteres de texto (um banner de README, um carregador de terminal, um visual retrô, um clipe denso e colorido de caracteres ou pontos), ou mostrar um clipe ASCII para imitar, leia
references/ascii.md. É um motor separado com seu próprio arquivo de cena (.ascii.json) e comandos. Assuntos pequenos: escreva quadros em um arquivo de texto ou gere-os. Qualquer coisa densa ou suave: construa uma cena vetorial, passe porqae converta-a como uma receita. Várias coisas se movendo: camadas. Para imitar um clipe:ascii probepara sua grade e cores. Nunca desenhe formas grandes em caracteres. - Antes de desenhar algo além de algumas formas (um personagem, uma ilustração, uma cena), leia
references/artwork.md: ordem de construção, caminhos curvos, sombreamento, paleta, tamanho da tela. Cenas feitas apenas de primitivas ou cor sólida levantamW-ART-PRIMITIVEeW-ART-FLAT. - Leia
references/motion.mdantes de escrever keyframes para algo além de uma rotação ou deslizamento simples, e sempre para um personagem. Use predefinições de movimento e predefinições de rig em vez de keyframes colocados manualmente: elas dão à animação sua suavidade, antecipação, ultrapassagem e compressão.
Fluxo de Trabalho
-
Entenda a solicitação. Defina o assunto, o movimento, o tamanho e se ele faz loop. Pergunte apenas se uma resposta ausente mudaria o resultado. Caso contrário, use os padrões: tela 512 por 512, 30 fps, 2 segundos, looping, fundo transparente.
-
Escreva a cena como
<nome>.gertie.json. Se o usuário forneceu um SVG, executenode scripts/gertie.mjs import <arquivo.svg> --jsonprimeiro e inclua o resultado (vejareferences/import.md). Os tempos estão em segundos. Nós posteriores desenham sobre os anteriores. Dê às coisas uma predefinição demotiononde uma se encaixar. Para um personagem, construa um rig e use predefinições de rig (references/motion.md). -
Verifique-a. Execute o script em
scripts/gertie.mjsdentro da pasta desta skill:node scripts/gertie.mjs qa <nome>.gertie.json --jsonIsto compila a cena, valida a saída, renderiza quadros amostrados em um navegador e executa as verificações de renderização. Os arquivos vão para
out/ao lado da cena:<nome>.lottie.json,<nome>.svge<nome>.sheet.png. A verificação renderiza o Lottie e o SVG separadamente e os compara, quadro a quadro. -
Corrija cada diagnóstico. Cada um tem um
code, umpathpara sua cena, umamessagee umfix. Aplique a correção, edite a cena e executeqanovamente. Corrija os erros primeiro, depois leia os avisos.W-LOOP-JUMPeW-R-LOOPsignificam que o loop salta visivelmente;W-R-CLIPPEDsignifica que algo está cortado pela borda da tela.W-SYNCsignifica que três ou mais filhos de um grupo executam o mesmo loop em sincronia, o que parece mecânico: dê ao grupo umstaggercom umphase, ou dê a cada entrada seu própriophase.E-R-PARITYsignifica que o Lottie e o SVG parecem diferentes, então uma das duas saídas está errada: nomeia o quadro, um nó e uma imagem de diferença (outputs.parity). Simplifique a animação desse nó para encontrar a causa e informe ao usuário se for um bug no Gertie. -
Observe-a. Abra a imagem da folha de contato nomeada em
outputs.sheet. Ela mostra oito quadros em ordem, cada um rotulado com seu número de quadro e tempo, desenhados em um tabuleiro de xadrez para que a transparência seja visível. Verifique se as coisas certas estão presentes, as cores estão corretas, o movimento entre os quadros faz sentido e nada está cortado ou sobreposto. Se não estiver certo, edite a cena e volte ao passo 3. Pare após três rodadas de revisão visual. Use--sheet-frames 16para mais detalhes ao depurar temporização. -
Meça contra o padrão de qualidade para qualquer coisa além de um ícone rápido. Defina o
"tier"de nível superior da cena para o que você está fazendo, depois executenode scripts/gertie.mjs profile <cena>. Veja "Níveis de qualidade" abaixo. -
Exporte apenas se o usuário precisar de outro formato:
node scripts/gertie.mjs export <cena> --to <formatos>ou--for <destino>. Vejareferences/export.md. Precisa de ffmpeg para tudo excetolottie,svgelottie-zip. -
Entregue os arquivos
.lottie.jsone.svg, o arquivo de cena e a folha de contato. Diga o que foi verificado. Se o relatório tiver uma listabaked, o SVG carrega um keyframe por quadro para essas propriedades; está correto, mas maior, e simplificá-las (mesma suavização e tempos em trim start, end e offset; sem suavização de ultrapassagem em um morph ou em tamanho de rect e ellipse) o reduz.
Outros comandos:
node scripts/gertie.mjs qa <cena> --thorough renderiza todos os quadros e também verifica flashes de um quadro
node scripts/gertie.mjs compile <cena> --json apenas compila, sem navegador; --lottie ou --svg escreve apenas uma saída
node scripts/gertie.mjs validate <arquivo> --json verifica uma cena ou qualquer arquivo Lottie
node scripts/gertie.mjs export <cena> --to webm --json escreve outros formatos; veja references/export.md
node scripts/gertie.mjs import <arquivo.svg> --json transforma um SVG em um fragmento com um resumo e uma pré-visualização rotulada; veja references/import.md
node scripts/gertie.mjs trace <logo.png> --json traça um PNG ou JPEG plano para formas; depois agrupa; veja references/trace.md
node scripts/gertie.mjs cutout <pintura.png> <partes.json> --json corta uma pintura em camadas ao longo de contornos; veja references/cutout.md
node scripts/gertie.mjs grid <imagem.png> --step 50 desenha uma grade rotulada em uma imagem para ler coordenadas de pixels
node scripts/gertie.mjs render <arquivo.lottie.json> --times 0.6,1.1 --out quadros renderiza quadros em tamanho real em tempos escolhidos
node scripts/gertie.mjs story <video.story.json> --json constrói um MP4 a partir de cenas com legendas, transições e música; veja references/video.md
node scripts/gertie.mjs ascii lint|render|export|gen|from|fx|play ... animação em caracteres de texto; veja references/ascii.md
node scripts/gertie.mjs ascii probe <clipe.mp4> --json lê a grade, cores e taxa de quadros de um clipe ASCII para imitar
node scripts/gertie.mjs study <clipe.mp4> --json mede o movimento em um vídeo ou GIF e desenha uma folha de contato; veja references/motion-reference.md
node scripts/gertie.mjs study <clipe.mp4> --crop x,y,w,h --rate source --json o mesmo em um assunto na própria taxa de quadros do clipe, com uma lista de inatividade para pequenas oscilações
node scripts/gertie.mjs sample <imagem-ou-clipe> --at x,y --at x,y imprime a cor em cada ponto como hex, a partir dos pixels; --time segundos escolhe o quadro de um clipe
node scripts/gertie.mjs profile <cena ou arquivo.json> [--tier icon|character|scene] --json mede caminhos, cores, keyframes e suavização contra as faixas de qualidade
node scripts/gertie.mjs inspect <arquivo.json> --json descreve um arquivo Lottie; também recolorir, reajustar tempo e renderizar, veja references/lottie.md
node scripts/gertie.mjs doctor relata se Node, um navegador e ffmpeg estão disponíveis e quais formatos de exportação funcionam
Código de saída 0 significa sem erros, 1 significa que erros foram encontrados, 2 significa que o comando não pôde ser executado.
Níveis de qualidade
Animações feitas profissionalmente do mesmo tipo parecem semelhantes quando medidas. profile mede sua animação compilada da mesma forma e marca cada medida como inside, below ou above a faixa para seu nível. Nunca falha; diz onde está a lacuna. validate --json e qa --json incluem o mesmo relatório sob profile.
| Nível | O que é | O que mais precisa |
|---|---|---|
icon | Um ícone ou carregador, cerca de 512 pixels, 1.5 a 3 segundos | Poucas formas (5 a 20 caminhos, 2 a 5 cores), mas cada movimento suavizado, com ultrapassagem e um loop limpo |
character | Um personagem ou ilustração, 800 a 1024 pixels, 2 a 6 segundos | Um desenho real: 40 a 80 caminhos, 6 a 12 cores e movimento denso (25 a 60 keyframes por segundo, 4 ou mais suavizações diferentes) |
scene | Uma cena completa, 1080 pixels, 5 a 10 segundos | Muito mais desenho (120 a 250 caminhos, 12 a 20 cores), mas não mais movimento que um personagem: anime algumas coisas bem |
Declare o nível na cena com "tier": "icon" (ou "character", "scene") para que o relatório marque uma faixa; sem ele, profile relata todas as três. Em todos os níveis, busque pelo menos três quartos dos segmentos suavizados e pelo menos um quarto das propriedades animadas começando em um quadro próprio (offset, não sincronize). Um below em caminhos ou cores significa que o desenho é muito simples; um below em keyframes por segundo significa que as coisas param de se mover entre as poses.
O que cada saída pode e não pode fazer
- Lottie JSON toca em lottie-web, players dotlottie e players móveis nativos. Use-o para aplicativos.
- GIF, APNG, WebP, WebM, ProRes, HEVC, MP4 são feitos por
export. São imagens da animação, não vetores. - SVG animado não precisa de player nem JavaScript. Toca quando aberto em um navegador, em uma tag
<img>e em um README (verificado no Chromium e WebKit; Firefox não foi verificado). Não pode ser pausado ou arrastado, e aplicativos móveis nativos não podem tocá-lo. Sobprefers-reduced-motionmostra um quadro estático, escolhido peloposteropcional de nível superior da cena (segundos). Morphs e alterações de tamanho de rect ou ellipse continuam se movendo sob movimento reduzido.
Se você não pode ver imagens
Pule o passo 5. Confie nas verificações automáticas e diga ao usuário que o resultado foi verificado automaticamente, mas não foi visualizado.
Se não houver navegador
qa ainda compila e valida, e relata "render": "skipped" com o comando que o corrige. Execute node scripts/gertie.mjs doctor, siga o que ele diz e informe ao usuário que as verificações de renderização não foram executadas até que o façam.
Se você não pode executar comandos
Escreva o arquivo de cena seguindo references/scene.md e entregue-o ao usuário com o comando de compilação.