Cartoon: rig, movimento e lip sync dos personagens
- cartoon/src/rig.ts, motion.ts e lipsync.ts: esqueleto do personagem, curvas de movimento e sincronia labial no estilo Cartoon (Remotion) - CharacterFigure/CharacterCard/Shot/overlays e spec atualizados - Painel: estúdio de personagens e montagem cartoon ajustados - Documentação em doc/cartoon/animacao.md e personagens.md; skill atualizada Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
# Expressões, movimento e fala do estilo Cartoon
|
||||
|
||||
Nada aqui é animação pronta: o personagem tem um **rig** (rosto e corpo por parâmetros) e uma **linha do
|
||||
tempo** de ações que se combinam. Expressões e poses com nome são só atalhos — ajuste qualquer valor por cima
|
||||
ou crie combinações novas. Código: `cartoon/src/rig.ts`, `motion.ts`, `lipsync.ts`, `CharacterFigure.tsx`.
|
||||
|
||||
## Rosto (FaceParams)
|
||||
|
||||
| Parâmetro | Faixa | Efeito |
|
||||
|---|---|---|
|
||||
| `browL` / `browR` `{ y, tilt }` | y −10…6 px · tilt −25…25° | y negativo sobe; tilt + = ponta de dentro sobe (triste), − = desce (bravo) |
|
||||
| `eyeL` / `eyeR` | 0…1,35 | 0 fechado · 1 normal · 1,35 arregalado (fechado + sorriso = olho de riso em arco) |
|
||||
| `pupil` | 0,4…1,3 | pupila pequena = pavor |
|
||||
| `gazeX` / `gazeY` | −1…1 | para onde olha |
|
||||
| `mouthOpen` | 0…1 | abertura |
|
||||
| `smile` | −1…1 | cantos para baixo (triste/bravo) ou para cima (feliz) |
|
||||
| `mouthWidth` | 0,5…1,4 | estreita (O de susto) ou larga |
|
||||
| `mouthRound` | 0…1 | bico de "o/u" (a fala usa) |
|
||||
| `teeth` | sim/não | dentes à mostra |
|
||||
| `blush`, `sweat`, `tears`, `anger` | 0…1 / sim/não | rubor, gota de suor, lágrimas escorrendo, veia de raiva |
|
||||
|
||||
Atalhos (`expression`): neutral, smile, happy, laugh, proud, sad, cry, worried, angry, furious, surprised,
|
||||
scared, shocked, suspicious, smirk, confused, disgusted, sleepy, determined, embarrassed.
|
||||
Ajuste fino no ator: `"face": { "smile": 0.3, "browL": { "y": -6 } }` (aceita `brows` e `eyes` para os dois
|
||||
lados). Expressão nova = combinação de parâmetros; não precisa de desenho novo.
|
||||
|
||||
## Corpo (BodyParams)
|
||||
|
||||
Braços e pernas em dois segmentos: `raise` (abre a partir do corpo: 0 baixo, 90 horizontal, 180 para cima) e
|
||||
`bend` (dobra o cotovelo/joelho para dentro). Mais `lean` (tronco), `headTilt`, `headTurn` (−1…1, finge 3/4),
|
||||
`headNod` (−1 olha para cima … 1 para baixo) e `crouch` (0 em pé … 1 sentado).
|
||||
|
||||
Atalhos (`pose`): stand, point, wave, hold, arms_up, celebrate, shrug, think, hands_on_hips, cross_arms,
|
||||
facepalm, cover_mouth, defend, reach, sit, kneel, lean_in. Ajuste: `"body": { "armR": { "raise": 60 } }`.
|
||||
|
||||
## Linha do tempo (`timeline` do ator)
|
||||
|
||||
Cada ação começa em `at` (segundos), `atP` (fração do trecho) ou **`cue`** (a palavra da narração: começa quando
|
||||
a voz diz essa palavra — o jeito preferido). `dur` muda a duração.
|
||||
|
||||
| Ação | Efeito | Campos |
|
||||
|---|---|---|
|
||||
| `express` | troca de expressão (suave, fica) | `expression` e/ou `face` |
|
||||
| `pose` | troca de pose (com leve passada do ponto) | `pose` e/ou `body` |
|
||||
| `walk` / `run` | anda/corre até `to` (x), virando para o lado | `to` |
|
||||
| `enter` / `exit` | entra de fora do quadro / sai | `to` |
|
||||
| `jump` | preparação, salto com esticada, aterrissagem | `height` |
|
||||
| `nod` / `shake_head` | sim / não com a cabeça | `times` |
|
||||
| `tremble` · `bounce` | tremer · quicar de alegria | `times` |
|
||||
| `fall` | cai de lado (cara de choque) | `dir` |
|
||||
| `sit` / `stand_up` | senta / levanta | — |
|
||||
| `turn` | vira (espelha passando pelo perfil) | — |
|
||||
| `look` | olhar e cabeça para um lado | `dir` left/right/up/down |
|
||||
| `wave` | acena | `times` |
|
||||
| `emote` | balão sobre a cabeça | `text` "!", "?", "…" |
|
||||
| `talk` | fala: boca pelas letras e volume | `cue` + `cueEnd` (palavras) ou `text` + `dur` |
|
||||
|
||||
Sempre há "vida": piscar em intervalos variados, respirar e balanço leve de cabeça.
|
||||
|
||||
## Fala com expressão
|
||||
|
||||
`talk` usa os tempos de cada palavra (transcrição do áudio do trecho) e o volume do áudio quadro a quadro
|
||||
(`audioEnv`, gerado pelo painel). A boca segue as letras — "a" abre, "e/i" esticam, "o/u" arredondam,
|
||||
"m/b/p" fecham, "f/v" mostram os dentes —, fecha nas pausas e abre mais nas sílabas fortes. **A expressão
|
||||
continua**: os cantos da boca, as sobrancelhas e os olhos são dela (bravo falando segue bravo).
|
||||
Para um personagem dizer uma fala da narração: `{ "do": "talk", "cue": "primeira", "cueEnd": "ultima" }`.
|
||||
|
||||
## Como o plano automático usa isso (panel/src/lib/montage-cartoon.ts → `timelineFor`)
|
||||
|
||||
- Emoção na palavra: "medo" → `express scared` com `cue: "medo"` (o personagem começa neutro).
|
||||
- Verbos viram ações: andou/correu/pulou/caiu/sentou/levantou/negou/concordou/tremeu/riu/chorou/olhou/virou/
|
||||
pensou/acenou/apontou/cruzou os braços/comemorou; "de repente" → balão "!"; "por que/será" → "?".
|
||||
- Fala entre aspas ou depois de travessão → `talk` do personagem de `cue` (1ª palavra) a `cueEnd` (última).
|
||||
|
||||
## Boas práticas
|
||||
|
||||
- Uma mudança de expressão por frase basta; muitas trocas parecem tique.
|
||||
- Ação no verbo, emoção na palavra da emoção: o público vê acontecer quando ouve.
|
||||
- Movimento grande (correr, cair) pede câmera parada; parado falando pede `push` lento.
|
||||
@@ -46,6 +46,12 @@ cria (pela descrição), ajusta e apaga. O elenco de cada história fica em `sto
|
||||
| `top.style` | `shirt`, `jacket`, `hoodie`, `dress`, `uniform` (`accent` = faixa/gola) |
|
||||
| `bottom.style` | `pants`, `shorts`, `skirt` |
|
||||
| cores | sempre `#rrggbb` |
|
||||
| `head` (opcional) | `round`, `oval`, `square`, `wide` |
|
||||
| `nose` (opcional) | `button`, `curve` (de perfil, tipo C), `round`, `long`, `wide` |
|
||||
| `lids` (opcional) | 0 a 0,6 — pálpebra de cima de base: olhar caído, experiente (o que mais dá "cara de ilustração") |
|
||||
| `wrinkles` (opcional) | 0 a 1 — testa, canto dos olhos e bigode chinês |
|
||||
| `belly` (opcional) | barriga saliente |
|
||||
| `accessories` (opcional) | `towel`, `whistle`, `tie`, `vest`, `helmet`, `watch`, `badge`, `apron`, `scarf`, `headset`, `chain` (+ `accessoryColor`) |
|
||||
|
||||
`kind: "3d"` reserva o personagem para a Godot (pessoa articulada de `godot/kits/`, parâmetros em `godot`);
|
||||
o Cartoon ignora esses.
|
||||
@@ -54,13 +60,19 @@ o Cartoon ignora esses.
|
||||
|
||||
No spec do trecho (`cartoon/src/spec.ts`), um ator `person` com `character` (nome, legenda, look) e:
|
||||
|
||||
- `expression`: `neutral`, `happy`, `sad`, `worried`, `angry`, `surprised`, `scared`
|
||||
- `pose`: `stand`, `point`, `wave`, `hold`, `arms_up`, `shrug`, `think`
|
||||
- `expression` e `pose`: atalhos do rig (20 expressões, 17 poses) com ajuste fino `face`/`body`, e
|
||||
`timeline` com movimento e fala — tudo em `doc/cartoon/animacao.md`.
|
||||
- `item` (com `hold`/`point`): ícone na mão — `phone`, `fuel`, `battery`, `money`, `bulb`, `clock`, …
|
||||
- `flip`: olha para a esquerda.
|
||||
|
||||
## Como criar um bom personagem
|
||||
|
||||
Nível de acabamento de ilustração (referência estudada em 17/11/2026: ilustrações de série no Instagram):
|
||||
pálpebra caída (`lids` 0,25–0,35) + nariz + rugas para os mais velhos, uma marca de profissão nos acessórios
|
||||
(apito do técnico, capacete e colete do operário, avental da merendeira), corpo com formato (barriga, ombro) e,
|
||||
quando ele é o centro da cena, enquadramento `medium` ou `close`. A cena inteira ganha textura de papel (`grain`).
|
||||
A descrição em texto já preenche tudo isso por regras (idade, profissão, "barrigudo", "narigudo", "cansado"…).
|
||||
|
||||
- Uma silhueta reconhecível de longe: **uma** marca forte (careca + barba grisalha, coque branco, boné vermelho).
|
||||
- Roupa de cor chapada que contraste com a paleta da série (sépia pede verde/azul; noite pede amarelo/roxo).
|
||||
- `caption` curta, com função e idade ("Engenheiro de minas · 58 anos"): aparece na 1ª cena.
|
||||
|
||||
Reference in New Issue
Block a user