Communitygithub.com

craft-2d-animation

Mostra ao agente como planejar, construir ou editar 'animação 2D artesanal' para que o resultado concreto seja um movimento que o agente possa defender quadro a quadro. O procedimento percorre Animação 2D Artesanal (EffectCraft + FilmCraft), 1. Direção visual e legibilidade da cena, 2. Enquadramentos e gramática visual. Use quando uma nova tarefa exigir esse ofício.

O que é craft-2d-animation?

Este guia capacita um agente de IA a projetar, animar e montar animações 2D curtas (intros, demonstrações de produto, cenas, curtas) usando as ferramentas EffectCraft (animação) e FilmCraft (montagem/exportação). Ele se concentra em garantir clareza visual, ritmo e movimento com peso, mesmo sem áudio. O guia detalha princípios de direção visual (uso de cor, silhuetas preenchidas, contraste), uma gramática de enquadramentos (plano geral, over-the-shoulder, plano médio, close-up) e regras de animação (antecipação, ação, rebote/manutenção). Para evitar bugs comuns no EffectCraft, são fornecidas regras rígidas para hierarquia de âncoras de personagens, câmeras null e ordem de empilhamento, além de orientações para separar texto diegético (V1, integrado ao cenário) de texto sobreposto (V2, para legendas/títulos). Por fim, inclui procedimentos de verificação visual com renderizações de frames-chave e um fluxo de renderização sequencial de baixo consumo de recursos, compatível com máquinas de 8 GB de RAM e CPU modesta. O agente pode usar scripts Python reutilizáveis (ec_runtime.py, render_ec_batch.sh, assemble_filmcraft.py) para automatizar a maior parte do trabalho.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Animação 2D Artesanal (EffectCraft + FilmCraft)

Método geral e reutilizável para conceber, animar e montar intros, demonstrações de produto, cenas curtas ou curtas-metragens 2D no EffectCraft (com montagem/exportação opcional no FilmCraft), com ou sem trilha sonora.

Referência CLI/MCP e permissões Flatpak compartilhadas: ../craft-music-video/references/mcp-and-commands.md.


1. Direção visual e legibilidade da cena

  1. Locais identificáveis pela cor: limitar uma cena curta a 2 ou 3 locais no máximo, cada um com uma luz dominante e uma paleta dedicada (ex.: corredor quente/noturno, posto de trabalho iluminado por uma tela, sala clara com uma única cor de destaque reservada para erros ou alertas).
  2. Silhuetas preenchidas em vez de contornos vazios: construir personagens e cenários com formas geométricas preenchidas (curvas de Bézier ou retângulos arredondados) com rostos minimalistas (olhos, sobrancelhas, boca simples) e um leve contorno de contraluz (rim light) do lado da fonte de luz.
  3. Contraste de silhuetas: distinguir cada personagem já no esboço (ex.: silhueta arredondada que se encolhe vs. silhueta ereta de ombros quadrados e gestos secos).
  4. Cenários superdimensionados para movimentos de câmera: desenhar fundos/paredes mais largos que o quadro (2200–2400 px para um zoom/shake em 1920×1080, ou 3600+ px para um travelling panorâmico) a fim de evitar qualquer borda preta de 10–20 px nas bordas do quadro.

2. Enquadramentos e gramática visual

Variar os valores de plano para narrar a ação sem texto supérfluo:

Valor de planoPapel narrativoBoas práticas técnicas
Plano geral (Establishing)Apresentar o local, a iluminação e a posição relativa dos elementosManter um ponto de referência espacial fixo (mesa, tela, painel, porta) ao retornar ao mesmo local
Sobre o ombro (OTS)Mostrar o objetivo do personagem e seu ponto de vista sobre uma interface ou objetoReutilizar exatamente o mesmo enquadramento OTS entre a primeira tentativa e o sucesso final para criar uma lembrança visual imediata
Plano médio / PerfilAcompanhar a postura, os deslocamentos e a evolução física de uma cenaIdeal para mostrar um encurvamento progressivo, um recuo na cadeira ou um gesto amplo
Close-upIsolar uma intenção, um detalhe de interface, uma mão em uma tecla, um olhar ou uma piada visualManter os movimentos curtos e legíveis; aproveitar o close-up para liberar áreas negativas limpas

Cálculo de enquadramento de câmera (cam_focus)

Com um nulo de câmera de âncora [0, 0], centralizar um ponto do mundo (tx, ty) no meio de um quadro W × H na escala sc % obedece exatamente a: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (disponível diretamente via cam_focus(tx, ty, scale_pct, width, height) em ec_runtime.py).


3. Mudanças de pose, peso e ritmo visual

  1. Antecipação → Ação → Rebote / Manutenção:
    • Nunca passar linearmente de uma pose A para uma pose B.
    • Adicionar uma pequena antecipação de sentido oposto antes da ação (ex.: dedo que se levanta e hesita antes de bater em uma tecla, porta que se abre ligeiramente antes de bater, corpo que se apoia antes de recuar).
    • Terminar com um leve excesso (overshoot) ou uma pausa legível (hold) para dar peso (ex.: personagem que recua um passo e faz uma pausa para admirar seu trabalho).
  2. Patamares de postura progressivos: durante uma espera ou aumento de tensão, fazer a postura evoluir por patamares nítidos entre dois planos (inclinação do tronco, abaixamento da cabeça, relaxamento dos braços) em vez de um balanço contínuo.
  3. Segurar os planos entre duas ações: deixar a composição respirar entre os acentos (piscadas de olhos, micro-zoom lento, cursor que pisca) em vez de agitar todas as camadas continuamente.
  4. Teste mudo obrigatório: assistir qualquer cena de ação, introdução ou demonstração sem som (ou via 3–5 quadros-chave render-frame). O objetivo do personagem e a progressão da cena devem permanecer 100% compreensíveis apenas pela imagem.

4. Âncoras de personagens, câmeras e ordem de empilhamento (Armadilhas do EffectCraft)

Estas regras evitam bugs de deslocamento, membros soltos ou elementos ocultos no EffectCraft (comportamento compatível com After Effects):

A. Nulos e câmeras

  • comp.layers.addNull() cria por padrão uma âncora em [50, 50] e uma posição em [960, 540]. Sempre forçar anchorPoint.setValue([0, 0]) antes de posicionar ou parentear o nulo (é o que makeCamNull faz em ec_runtime.py).
  • Sempre atribuir child.parent = parent ANTES de child.position.setValue(...), para que as coordenadas de child sejam interpretadas diretamente no sistema de coordenadas local do pai.

B. Regra absoluta sobre parentesco e transformações

  • Anexar TODOS os filhos enquanto o pai estiver em pose neutra (rotation = 0°, scale = [100, 100]).
  • Aplicar as rotações iniciais, zooms de câmera ou keyframes do pai somente APÓS a criação completa de toda a hierarquia filha.
  • Por quê: modificar parent.rotation ou parent.scale antes de atribuir child.parent = parent aciona uma compensação inversa no estilo AE que projeta a cabeça/braços para fora do corpo ou encolhe todo um cenário em um canto do quadro.

C. Hierarquia de âncoras de um personagem 2D articulado

  • Personagem sentado: Root nos quadris (hip_pos) → Cadeira, Pernas, TorsoNull (pivô cintura [0, 0]) → BraçoSuperiorTraseiro (ombro) → BraçoAnteTraseiro (cotovelo) → TorsoCorpo → Cabeça (base do pescoço) → BraçoSuperior → BraçoAnte.
  • Personagem em pé: Root no chão entre os pés (foot_pos) para manter os sapatos plantados no chão durante um zoom ou um passo para trás → PernaTraseira / PernaDianteira (pivô quadris) + PivôTorso (pivô quadris) → Braços, Blazer/Corpo, Cabeça.
  • Junção pescoço / gola: sempre adicionar uma forma preenchida de gola / pescoço sobrepondo o topo do tronco e a parte inferior da cabeça para que uma inclinação forte (25°–35°) nunca abra uma lacuna entre o queixo e os ombros.

D. Ordem de empilhamento (Stacking Order)

  • Dentro de uma mesma camada de forma (ADBE Root Vectors Group): o primeiro grupo adicionado é desenhado ACIMA, o último ABAIXO (ordem frente → trás).
  • Entre camadas distintas de uma composição: cada nova camada é inserida no índice 1 (ACIMA). Construir as camadas na ordem trás → frente (fundo → brilho → cenário → personagem → primeiro plano).

5. Legibilidade do texto e separação diegética / overlay

  1. Nenhuma faixa preta permanente: colocar títulos, subtítulos ou legendas no espaço negativo livre de cada plano (acima de uma tela, em um canto escuro da parede, abaixo de uma linha do horizonte), sem nunca sobrepor um rosto, uma borda de tela ou um painel do cenário.
  2. Contraste e margens de segurança:
    • Aplicar uma sombra projetada suave (ADBE Drop Shadow, opacidade 190–230, distância 4–6 px, desfoque 14–18 px) para garantir a leitura em fundo claro ou escuro.
    • Respeitar margens horizontais de segurança (>= 70 px em 1920×1080) e um tempo de manutenção legível (>= 0.35 s após o fim da ação ou da última palavra, inclusive através de um corte de plano).
  3. Separação estrita Texto diegético (V1) vs. Texto sobreposto (V2):
    • Texto integrado ao cenário (V1): letreiros, interfaces de tela, folhas, quadros, teclas de teclado. Ele faz parte do mundo animado e permanece presente em todas as exportações.
    • Texto sobreposto (V2, ProRes 4444 RGBA): títulos, cartelas, legendas, falas ou anotações de UI. Colocá-lo em composições transparentes separadas permite exportar com um clique uma versão com títulos e uma versão limpa na montagem rigorosamente idêntica.

6. Verificação visual e renderização econômica em recursos

  1. Controle por quadros-chave antes de qualquer renderização de vídeo: usar effectcraft-cli render-frame --max-side 960 em 1 a 2 instantes-chave por plano (e --transparent para os overlays V2) para verificar enquadramentos, encaixes de articulações e legibilidade do texto em poucos segundos.
  2. Renderização sequencial segura (máquinas 8 GB RAM / CPU modesta):
    • Renderizar 1 única composição por vez (nunca renderizações ProRes 4444 RGBA em paralelo com 8 GB de RAM).
    • Limitar as threads (RAYON_NUM_THREADS=2, OMP_NUM_THREADS=2), executar com prioridade baixa (nice -n 15 ionice -c 3), evitar --gpu se a VRAM for compartilhada com a RAM do sistema, e deixar 2 s entre duas renderizações para liberar a memória.

7. Ferramentas compartilhadas T3 Code e Dependências

Os scripts reutilizáveis estão em ~/.t3/shared/craft-video/:

FerramentaCaminhoUso em animação 2D
Runtime JSX EffectCraft~/.t3/shared/craft-video/ec_runtime.pyImportar JsxBuilder, cam_focus, hex_to_rgba, run_effectcraft_script para gerar corretamente um .ecproj (âncora [0,0], Bézier, glows, keyframes suavizadas/hold)
Renderização batch sequencial~/.t3/shared/craft-video/render_ec_batch.shRenderizar as cenas V* (ProRes HQ RGB) e overlays L*/T* (ProRes 4444 RGBA) em baixa carga com retomada automática via ffprobe
Montagem e Exportação FilmCraft~/.t3/shared/craft-video/assemble_filmcraft.pyMontar V1 (+ V2 alpha e A1 áudio opcionais) em Rec.709 em um .fcproj e exportar Master + Clean

Dependências necessárias

  • Python 3.9+ (apenas biblioteca padrão)
  • ffmpeg e ffprobe
  • EffectCraft CLI (effectcraft-cli ou Flatpak ai.storyteller.effectcraft com acesso --filesystem)
  • FilmCraft CLI (filmcraft-cli ou Flatpak ai.storyteller.filmcraft) para montagem/exportação multi-pistas
  • Opcionais Linux : nice, ionice, taskset

Comandos de exemplo

# Verificar dependências disponíveis (nenhuma renderização)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# Pré-visualizar o plano de renderização sequencial de baixa carga (cena + títulos alpha)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# Pré-visualizar a montagem FilmCraft sem música (intro/demo muda, Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas