Files
CenaForge/.claude/skills/cenaforge/references/cartoon.md
T
MateuusandClaude Opus 5.5 0050cf60a7 Estilo Cartoon (Remotion), personagens reaproveitáveis e hashtags do TikTok
Estilo Cartoon (novo, sem Godot)
- Pacote cartoon/ (Remotion 4.0.535): cada trecho é um spec JSON desenhado
  em React/SVG e renderizado em MP4; render em lote (empacota uma vez) e
  imagem parada (--still).
- Cenas montadas por peças, sem cenário pronto: paletas (noite, sépia, dia,
  entardecer, cinza), lugar com chão, interno/externo, névoa e 24 peças
  posicionadas por profundidade, foco de luz e vinheta; etiquetas,
  onomatopeias, ondas de som, X vermelho, painel do topo e legenda palavra
  por palavra.
- Montagem documental: "Cartoon" como estilo do vídeo e tipo de visual do
  trecho; plano por regras pelo texto (lugar, objetos, expressão, pose),
  tempos das palavras pela transcrição do áudio, "Gerar de novo" por trecho,
  paleta da série e elenco da história.

Personagens
- Aba Personagens: criar pela descrição, ajustar peça por peça com prévia
  ao vivo, refinar com o agente (tarefa nova "Personagem"); fichas em
  assets/characters/ e elenco em stories/<id>/cast.json. O mesmo personagem
  sai igual em qualquer cena, mudando expressão, pose e objeto na mão.

TikTok
- Hashtags passam a ser digitadas e confirmadas na lista de sugestões do
  TikTok Studio (coladas, viravam texto). Diagnóstico de alcance em
  doc/publicacao/TIKTOK_DIAGNOSTICO.md.

Docs: estudo das referências, doc/cartoon/ (personagens e cenas) e skill
cenaforge 1.46.0.

Testes: painel 77/77, cartoon 5/5, Publicador 87/87.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 21:36:48 -03:00

100 lines
8.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Estilo Cartoon (`cartoon/`, Remotion, sem Godot)
Pacote do workspace (`pnpm-workspace.yaml`: `panel` + `cartoon`; nome `cenaforge-cartoon`). Cada trecho da montagem
documental vira um MP4 de desenho 2D com a duração do áudio. Versões e medição: [tools.md](tools.md).
**Princípio (dono, 17/11/2026): a ferramenta "sabe como faz".** Nada de cenário ou template pronto reaproveitado: cada
cena é montada **por peças** a partir do texto (parque de dia, cemitério, bunker…). **Personagens** são o contrário:
criados uma vez, na biblioteca, e reaproveitados em várias histórias. Não crie "cena pronta" nova; crie peça ou regra.
Guias do projeto (fonte de detalhe, não duplicar aqui): `doc/cartoon/cenas.md` (camadas, receitas por situação,
composição), `doc/cartoon/personagens.md` (ficha, agente), estudo de referência `doc/estudo-estilo-cartoon-explicativo.md`.
## Contrato da cena (`cartoon/src/spec.ts`, `schemaVersion` 1; `validateSpec` recusa o resto)
- `width`/`height`/`fps`/`durationS`/`seed`; `camera {push, panX}`; `hud {badge, label, clock, clockMinutesPerSecond}`;
`props` (ícone `house|generator|fuel|battery|phone|door|eye|bulb|solar|warning|money|clock`, `label`, `tone`
`info|danger|ok`, `shake`, `rings`, `crossed`); `texts` (`onomatopoeia|tag|counter|big`); `words [{text, startS, endS,
tone key|danger}]`; `card`. Posições em fração do quadro (0–1).
- `scene.kind`: `street|house|plain|blueprint|card` (cenas antigas) ou **`place`** (por peças). `palette`
(`night|sepia|day|dusk|gray`, `PALETTES` em `places.tsx`), `place`, `light` (`none|spot|vignette`).
- `place {ground grass|street|dirt|floor|sand|water|none, indoor, fog, horizon, elements[{kind, x, z, scale, flip, color}]}`;
`z` 0 = frente, 1 = fundo. 24 peças em `ELEMENTS`: tree, deadtree, pine, bush, rock, mountain, cloud, bench, lamp,
gravestone, cross, fence, house, building, car, sign, door, window, table, bed, shelf, crate, tent, fire.
Peça nova = entrada em `ELEMENTS` + desenho em `cartoon/src/places.tsx`.
- `actors`: `person` com `character {name, caption, look}`, `expression`, `pose`, `item` (objeto na mão), `flip`
(campos antigos `label`/`hair`/`glasses`/`pointing` ainda valem); `crowd` (entra antes do personagem, atrás, pés em y 0,6).
## Peças (`cartoon/src/`)
`places.tsx` (paletas, chão, peças, `LightLayer`), `scenes.tsx` (fundos antigos, espaço 1080×1920), `actors.tsx` (multidão,
pessoa antiga), `CharacterFigure.tsx` (personagem), `icons.tsx`, `overlays.tsx` (etiqueta amarela, onomatopeia com tremor,
anéis de som, X vermelho, HUD com relógio, legenda palavra por palavra em blocos de até 3), `Shot.tsx` (empurrão de
câmera), `Root.tsx` (composições `Shot` = trecho **vazio**, `Sample` = exemplo do Studio, `Character` = cartão),
`colors.ts` (cores sem Remotion; `theme.ts` só carrega fontes). Fontes Anton e Bebas Neue de `assets/fonts/`.
## Render
`tsx cartoon/render.ts --jobs <json>` (`[{spec, out}]`) | `--spec x --out y` | `--sample --out y` | **imagem parada de
personagem:** `tsx cartoon/render.ts --still --props x.json --out y.png [--frame N]`. Empacota uma vez e renderiza todos;
**última linha do stdout = JSON `{ok, results|error}`**. O 1º render baixa o Chrome Headless Shell (~120 MB);
`CARTOON_CHROME` aponta outro Chrome. Studio: `pnpm --filter cenaforge-cartoon studio`. Testes (dentro de `cartoon/`):
`npx tsx --test tests/*.test.ts`; tipos: `pnpm --filter cenaforge-cartoon typecheck`.
## Personagens (biblioteca)
- **Contrato** `cartoon/src/character.ts` (`Character`, `schemaVersion` 1): `id`, `name`, `caption`, `description`,
`kind` `cartoon|3d`, `look {build slim|average|heavy, height 0,6–1,2, skin, hair{style short|side|bun|long|curly|spiky|
bald|cap, color}, beard none|stubble|mustache|full|goatee, glasses none|round|square|sun, brows thin|thick,
top{shirt|jacket|hoodie|dress|uniform, color, accent}, bottom pants|shorts|skirt, shoes}`. `EXPRESSIONS`: neutral, happy,
sad, worried, angry, surprised, scared. `POSES`: stand, point, wave, hold, arms_up, shrug, think. `validateLook`.
- **Desenho** `CharacterFigure.tsx`: SVG puro (sem Remotion), `viewBox` 200×440, pés em (100,440); `t` anima respirar,
piscar e acenar. O painel importa o mesmo componente (prévia ao vivo): dependência `"cenaforge-cartoon": "workspace:*"` em
`panel/package.json`, `transpilePackages` em `panel/next.config.ts`, `exports` do pacote `./character`, `./figure`, `./spec`.
- **Arquivos:** `assets/characters/<id>/character.json`; elenco da história `stories/<id>/cast.json` (`{"cast":[ids]}`).
- **Painel** `panel/src/lib/characters.ts`: `listCharacters`/`getCharacter`/`saveCharacter`/`deleteCharacter` (não apaga
quem está em elenco), `describeToLook` (descrição pt-BR → `look` + `caption` por regras: idade, gênero, criança,
profissão → uniforme/cor, cabelo, barba, óculos, corpo, cor de roupa), `getCast`/`setCast`. Rotas: `GET/POST
/api/characters`, `GET/PUT/DELETE /api/characters/[id]`, `POST /api/characters/[id]/agent`, `GET/PUT
/api/stories/[storyId]/cast`. Página `/characters` (aba "Personagens"; `components/character-studio.tsx`: criar pela
descrição, prévia com expressão/pose, formulário peça por peça, "Refinar com o agente", apagar).
- **Agente:** `AgentKind` `"character"` (`types.ts`; `agents.ts`: orçamento US$ 0,5, Sonnet, Claude preferido; `prompts.ts`
manda ler SÓ `doc/cartoon/personagens.md` e gravar a ficha).
- Para testar a API com acento use Python/UTF-8 (gotchas 153); o `id` sai do nome sem acento.
## Plano no painel (`panel/src/lib/montage-cartoon.ts`, sem banco)
- Tipos vêm de `"cenaforge-cartoon/spec"` (não há mais espelho). `planCartoon(shot, ctx, variant)` com
`PlanContext {hud, cast, palette}` por regras do texto:
- **Lugar:** `LOCATIONS` por palavra (cemitério, bunker/porão, hospital/escritório, casa/quarto, parque, floresta,
acampamento, praia, sítio, rua/cidade) → `placeFor` (peças espalhadas pela semente, longe do centro; cada lugar traz
paleta/luz própria). Sem lugar reconhecido cai nas cenas antigas.
- **Personagem:** `expressionOf`/`poseOf` pelo texto; quem é citado pelo nome entra com a aparência da biblioteca; com 1
personagem só, ele aparece nos trechos pares ou quando o texto diz "ele/ela"; objeto pequeno vai para a mão (`item`).
- Ícones por palavra-chave; "pessoas/vizinhos" vira multidão; "nunca/não" + perigo risca o objeto; sons viram
onomatopeia (motor só com gerador/motor/moto/carro perto; barulho genérico = "Crec"); texto na tela numérico vira `big`,
senão etiqueta; `variant` troca arranjo e seed.
- `wordTimings` (transcreve o áudio com `detail: "words"`; sem o serviço, reparte o texto pela duração; gotchas 156).
`cartoonKey(scene, duração, audio.key)` decide se está atual. `renderCartoonShots`: specs em
`stories/<id>/cartoon/`, MP4 em `output/cartoon/<story>-<file_key>/`.
- **`lib/montage.ts`:** `VisualKind` `"cartoon"`; `ShotVisual.cartoon`/`cartoonVariant`/`cartoonKey`;
`SavedMontage.cartoonPalette` (`CARTOON_PALETTES`); `cartoonCtx(ep)` monta o contexto com o elenco da história. O
automático planeja tudo em cartoon no estilo `"cartoon"`; a etapa 3b renderiza **todos** os trechos desatualizados numa
execução; em `buildSegment` o trecho cartoon **não** recebe texto na tela nem legenda do FFmpeg (já vêm na cena). Mudar a
paleta, ou `PATCH {replanCartoon: true}`, apaga o plano dos trechos Cartoon automáticos (replanejados na próxima
geração); "Gerar de novo" troca `cartoonVariant`; `hudFor` = 2 primeiras palavras do título + "Ep. N".
- **UI** (`montage-editor.tsx`, recebe `storyId`): opção de estilo, bloco `CartoonSetup` (paleta da série + elenco por chips,
só no estilo Cartoon), botão "Cartoon" no trecho, `CartoonPreview`.
- **Testes:** `panel/src/lib/montage-cartoon.test.ts` (9).
## Medido (17/11/2026)
Mesmo personagem em parque (`day`), cemitério (`dusk` + fog + `vignette`) e bunker (`sepia` + `spot` + indoor): 3 trechos de
4 s em ~2,6–2,8 s cada. Plano com elenco "Marta" → parque de dia (acenando) e cemitério (com medo, "Crec") renderizados.
Testes: painel 77/77, cartoon 5/5; `tsc` ok nos dois (informados pelo dono; cartoon 5/5 reexecutado na skill).
## Ainda não existe (próximo passo)
Vistas especiais da referência: corte do subsolo, mapa visto de cima, painel/gráfico, celular, tela dividida. Agente que
escreve o spec de cada trecho (em vez das regras de `planCartoon`). Personagem `kind: "3d"` existe só na ficha. Não prometa.