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
- 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).
- 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. - 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).
- Cenários superdimensionados para movimentos de câmera: desenhar fundos/paredes mais largos que o quadro (
2200–2400 pxpara um zoom/shake em1920×1080, ou3600+ pxpara 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 plano | Papel narrativo | Boas práticas técnicas |
|---|---|---|
| Plano geral (Establishing) | Apresentar o local, a iluminação e a posição relativa dos elementos | Manter 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 objeto | Reutilizar exatamente o mesmo enquadramento OTS entre a primeira tentativa e o sucesso final para criar uma lembrança visual imediata |
| Plano médio / Perfil | Acompanhar a postura, os deslocamentos e a evolução física de uma cena | Ideal para mostrar um encurvamento progressivo, um recuo na cadeira ou um gesto amplo |
| Close-up | Isolar uma intenção, um detalhe de interface, uma mão em uma tecla, um olhar ou uma piada visual | Manter 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
- 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).
- 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.
- 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.
- 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çaranchorPoint.setValue([0, 0])antes de posicionar ou parentear o nulo (é o quemakeCamNullfaz emec_runtime.py).- Sempre atribuir
child.parent = parentANTES dechild.position.setValue(...), para que as coordenadas dechildsejam 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.rotationouparent.scaleantes de atribuirchild.parent = parentaciona 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:
Rootnos 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é:
Rootno 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
- 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.
- Contraste e margens de segurança:
- Aplicar uma sombra projetada suave (
ADBE Drop Shadow, opacidade190–230, distância4–6 px, desfoque14–18 px) para garantir a leitura em fundo claro ou escuro. - Respeitar margens horizontais de segurança (
>= 70 pxem1920×1080) e um tempo de manutenção legível (>= 0.35 sapós o fim da ação ou da última palavra, inclusive através de um corte de plano).
- Aplicar uma sombra projetada suave (
- 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.
- Texto integrado ao cenário (
6. Verificação visual e renderização econômica em recursos
- Controle por quadros-chave antes de qualquer renderização de vídeo: usar
effectcraft-cli render-frame --max-side 960em 1 a 2 instantes-chave por plano (e--transparentpara os overlaysV2) para verificar enquadramentos, encaixes de articulações e legibilidade do texto em poucos segundos. - 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--gpuse 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/:
| Ferramenta | Caminho | Uso em animação 2D |
|---|---|---|
| Runtime JSX EffectCraft | ~/.t3/shared/craft-video/ec_runtime.py | Importar 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.sh | Renderizar 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.py | Montar 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)
ffmpegeffprobe- EffectCraft CLI (
effectcraft-cliou Flatpakai.storyteller.effectcraftcom acesso--filesystem) - FilmCraft CLI (
filmcraft-cliou Flatpakai.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