Cartoon: estudo de handoff do personagem (.studies) e AGENTS.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
215faa331c
commit
b923132a69
@@ -0,0 +1,109 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user