Files
CenaForge/.studies/cartoon-personagem-handoff/PROMPT.md
T

7.0 KiB
Raw Blame History

Tarefa: subir o personagem cartoon (corpo e MÃOS) ao nível de uma ilustração de referência

Você vai trabalhar num workspace isolado (pasta workspace/ deste pacote), sem acesso ao projeto original. Responda e comente em português do Brasil; nomes de código (variáveis, funções, tipos, arquivos) em inglês.

Contexto

Temos um gerador de vídeos curtos verticais (9:16) em estilo "cartoon explicativo". Cada personagem é um componente React que desenha SVG puro (workspace/src/CharacterFigure.tsx). Ele não é uma imagem pronta: é montado por peças a partir de uma ficha de aparência (CharacterLook, em src/character.ts) e animado por um rig de parâmetros contínuos (src/rig.ts: rosto FaceParams e corpo BodyParams, braços e pernas em dois segmentos). As poses e ações (src/motion.ts) mexem nesses parâmetros quadro a quadro, e a boca segue a fala (src/lipsync.ts). O vídeo final é renderizado quadro a quadro pela Remotion (Chrome headless), então tudo precisa ser função pura dos parâmetros (nada de aleatório sem semente, nada de relógio).

O mesmo personagem aparece em close (só rosto e tronco), meio corpo e corpo inteiro, de frente para a câmera.

Referência (o NÍVEL de acabamento que queremos)

Pasta referencia/: quadros de um vídeo de outra série (1080×1920) e recortes ampliados em referencia/recortes/ (mãos segurando, joinha, mão com prancheta, apontando, close de mãos, braços cruzados, rosto). 00-video-inteiro-…png mostra o vídeo todo.

Copie a qualidade, não o conteúdo. Não reproduza aqueles personagens, nomes, roupas, logotipos ou cenas. O que importa nelas:

  • Proporção: cabeça grande (≈ 1/3 da altura no corpo inteiro), pescoço visível e proporcional, ombros largos e arredondados, tronco em "pera".
  • Sombreado cel em 2 tons, luz de um lado só, sombra levemente fria, sem contorno preto (a borda é o tom mais escuro da própria cor).
  • Rosto: orelha com dobra interna; nariz como curva simples; rugas da testa como arcos suaves no tom da pele; sobrancelha como forma cheia; pálpebra pesada; olhos com esclera branca; óculos de aro grosso com reflexo.
  • Roupa com construção: gola, zíper ou botões, costuras, 2–3 dobras (manga, cotovelo, barriga), barra; pano pendurado (toalha) com dobras e sombra própria.
  • MÃOS (o problema principal): formas macias e orgânicas, dedos de comprimentos diferentes que afinam na ponta, nós em arco, polegar nascendo da base da palma, unhas visíveis quando a vista mostra, mão grande (≈ do nariz ao queixo). Segurando objeto: o polegar por cima e os dedos por trás (objeto entre as camadas da mão). Objeto largo (livro, camisa dobrada) com as duas mãos pelas bordas. Joinha com o punho de lado e os dedos dobrados em fileira. A mão sai de dentro da manga: a manga termina numa borda com espessura e abertura escura, o pulso afina e entra nela, e a manga faz sombra no pulso.

Onde estamos (pasta nosso/)

  • 01-folha-antes.png → 02-folha-atual.png: em cima a referência, embaixo o nosso, nos mesmos 6 enquadramentos. Melhoramos muito, mas um olhar rápido ainda separa os dois.
  • 03-maos-ref-antes-depois.png, 04-formas-de-mao-3-rotacoes.png: estado atual das mãos (biblioteca src/hands.tsx com formas relaxed, open, point, thumbs_up, grip, pinch_edge, pinch_low, fist, on_face, giradas pelo pulso).
  • 05-poses-camadas.png: a ordem das camadas do braço (src/limbs.ts, armLayer) para a mão nunca sumir atrás do corpo.
  • 08-folha-de-poses-do-workspace.png: saída do script deste workspace (12 poses).

O que o dono do projeto ainda reprova:

  1. Mãos ainda parecem recortadas/coladas: formas duras, sombra em cunha, dedos "salsicha". Exemplos na folha 08:
    • braços cruzados viram um losango de dedos;
    • no apontar, a mão some;
    • o martelo e o ramo atravessam a túnica, e o cabo não fica claramente dentro do punho;
    • no pensar e no tapar a boca, a mão parece um bloco.
  2. A emenda pulso → manga às vezes mostra corte ou degrau quando o braço gira.
  3. O corpo inteiro ainda parece "boneco de recorte" perto da referência:
    • pouco volume na roupa;
    • pernas e braços muito retos;
    • sapato simples;
    • sobrancelhas claras viram mancha (veja o idoso de barba branca).
  4. Falta textura de ilustração: a referência tem degradê suave dentro das áreas e um leve granulado. A sombra cel deve continuar, mas com transição menos "vetor de ícone".

O que fazer

  1. Estude a referência (abra as imagens) e liste, por item acima, o que muda no desenho.
  2. Reescreva o que precisar em src/CharacterFigure.tsx, src/hands.tsx e src/limbs.ts (e, se necessário, presets de pose em src/rig.ts) para chegar ao nível da referência. Pode criar arquivos novos em src/.
  3. Use npx tsx render-sheet.tsx (corpo inteiro) e npx tsx render-sheet.tsx close (close) para gerar out/sheet-*.svg/.png e olhe as imagens a cada rodada. Acrescente poses ao CELLS do script se precisar (ex.: apontar para o outro lado, acenar com a outra mão, mãos na cintura, segurando celular).
  4. Pare quando, lado a lado com os recortes da referência, a mão e o corpo não se separarem pela qualidade do desenho.

Regras que NÃO podem quebrar (o projeto real depende delas)

  • Mesma interface pública:
    • CharacterFigure({ look, expression?, pose?, item?, t?, state?, shadeSide?, gesture? });
    • viewBox 0 0 200 440 com os pés em (100, 440);
    • HandsInsert({ look, item?, t?, shadeSide? }) desenha o close de mãos num viewBox 1080×1080.
  • Tipos e campos: CharacterLook, FaceParams, BodyParams e os nomes de poses e expressões continuam existindo. Campo novo só opcional, porque personagens já salvos precisam continuar abrindo.
  • Rig: o desenho continua dirigido pelo rig. Expressões, poses, fala (boca) e movimento (andar, acenar, martelar, pular, sentar) precisam funcionar; a sombra acompanha a cabeça virando (headTurn) e as dobras acompanham o braço.
  • Sem dependências novas no desenho: só React e SVG, sem imagens rasterizadas e sem bibliotecas novas.
  • Sem custo alto de render: nada de feGaussianBlur ou filtros SVG pesados repetidos por quadro (o vídeo renderiza 30 quadros por segundo; hoje um trecho de 4 s leva ~4 s). Degradê linear ou radial e textura barata são aceitos.
  • Função pura e camadas:
    • nada de Math.random() nem relógio; mesmos parâmetros = mesmo desenho;
    • braço, mão e objeto na mão nunca somem atrás do tronco, da barba ou de acessório quando o personagem está de frente; mantenha a lógica de armLayer (ou melhore-a).

Entrega

  • A pasta workspace/src/ com os arquivos alterados ou novos (vou copiá-los de volta para o projeto).
  • out/sheet-full.png e out/sheet-close.png finais, e uma folha referência × seu resultado (os recortes da referência ao lado das mesmas situações no seu desenho).
  • Um resumo curto: o que mudou em cada arquivo, campos novos (se houver) e o que ainda não ficou igual.