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>
100 lines
8.4 KiB
Markdown
100 lines
8.4 KiB
Markdown
# 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.
|