110 lines
7.0 KiB
Markdown
110 lines
7.0 KiB
Markdown
# 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.
|