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>
8.4 KiB
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.
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(íconehouse|generator|fuel|battery|phone|door|eye|bulb|solar|warning|money|clock,label,toneinfo|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) ouplace(por peças).palette(night|sepia|day|dusk|gray,PALETTESemplaces.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}]};z0 = frente, 1 = fundo. 24 peças emELEMENTS: 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 emELEMENTS+ desenho emcartoon/src/places.tsx.actors:personcomcharacter {name, caption, look},expression,pose,item(objeto na mão),flip(campos antigoslabel/hair/glasses/pointingainda 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,schemaVersion1):id,name,caption,description,kindcartoon|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),viewBox200×440, pés em (100,440);tanima respirar, piscar e acenar. O painel importa o mesmo componente (prévia ao vivo): dependência"cenaforge-cartoon": "workspace:*"empanel/package.json,transpilePackagesempanel/next.config.ts,exportsdo pacote./character,./figure,./spec. - Arquivos:
assets/characters/<id>/character.json; elenco da históriastories/<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+captionpor 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.tsmanda ler SÓdoc/cartoon/personagens.mde gravar a ficha). - Para testar a API com acento use Python/UTF-8 (gotchas 153); o
idsai 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)comPlanContext {hud, cast, palette}por regras do texto:- Lugar:
LOCATIONSpor 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/poseOfpelo 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;varianttroca arranjo e seed. wordTimings(transcreve o áudio comdetail: "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 emstories/<id>/cartoon/, MP4 emoutput/cartoon/<story>-<file_key>/.
- Lugar:
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; embuildSegmento trecho cartoon não recebe texto na tela nem legenda do FFmpeg (já vêm na cena). Mudar a paleta, ouPATCH {replanCartoon: true}, apaga o plano dos trechos Cartoon automáticos (replanejados na próxima geração); "Gerar de novo" trocacartoonVariant;hudFor= 2 primeiras palavras do título + "Ep. N".- UI (
montage-editor.tsx, recebestoryId): opção de estilo, blocoCartoonSetup(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.