Files
MateuusandClaude Opus 5.5 3f600c55b1 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>
2026-11-17 23:39:12 -03:00

80 lines
4.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.