7.0 KiB
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 (bibliotecasrc/hands.tsxcom formasrelaxed,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:
- 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.
- A emenda pulso → manga às vezes mostra corte ou degrau quando o braço gira.
- 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).
- 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
- Estude a referência (abra as imagens) e liste, por item acima, o que muda no desenho.
- Reescreva o que precisar em
src/CharacterFigure.tsx,src/hands.tsxesrc/limbs.ts(e, se necessário, presets de pose emsrc/rig.ts) para chegar ao nível da referência. Pode criar arquivos novos emsrc/. - Use
npx tsx render-sheet.tsx(corpo inteiro) enpx tsx render-sheet.tsx close(close) para gerarout/sheet-*.svg/.pnge olhe as imagens a cada rodada. Acrescente poses aoCELLSdo script se precisar (ex.: apontar para o outro lado, acenar com a outra mão, mãos na cintura, segurando celular). - 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 440com 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,BodyParamse 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
feGaussianBlurou 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).
- nada de
Entrega
- A pasta
workspace/src/com os arquivos alterados ou novos (vou copiá-los de volta para o projeto). out/sheet-full.pngeout/sheet-close.pngfinais, 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.