# 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.