O que Cut the Curve — catálogo de técnicas faz?
Cinco técnicas SEAM, um princípio: cortar no pico de velocidade, combinando direção e velocidade
em ambos os lados do corte — mais duas técnicas intra-cena (§6 chegadas, §7 slides).
A LEI da costura — lei vetorial, a corrente, o razão, o Portão da Costura — vive em
motion-doctrine; leia-a primeiro. Este skill são os parâmetros e a mecânica.
Todos os modelos de código GSAP (worker + registry): examples/gsap-implementation.md.
Catálogo
| # | Técnica | Escopo | Eixo | Uso para |
|---|---|---|---|---|
| 1 | Zoom-Through (avanço) | Troca de texto intra-cena | Z, em direção ao espectador | progredindo mais profundamente no mesmo pensamento |
| 2 | Inverse Zoom-Through | Batida de chegada / recompensa | Z, para longe do espectador | algo maior aterrissa |
| 3 | Cut the Curve | Entre cenas | X / Y | o limite padrão, a corrente do filme |
| 4 | Waterfall Cut | Costura texto-para-texto | X, por palavra | handoff em nível de palavra entre batidas de texto grandes |
| 5 | Rack-Focus Blur-Cut | Troca de estado na mesma superfície | X / Y / Z | o corte que você QUER VER — um floreio de foco puxado de DSLR |
| 6 | Waterfall Entry | CHEGADA intra-cena (sem costura) | Y, de baixo | cartões de título, aberturas de segmento, intros de lista |
| 7 | Nudge Curve | Slide de grupo intra-cena (sem costura) | X / Y | reposicionando um grupo composto para abrir espaço |
Direção Z é um sinal
"Mesmo eixo" não é suficiente em Z — o sinal de d(escala)/dt deve corresponder através do corte:
| Vetor Z | Escala de saída | Escala de entrada | Variante |
|---|---|---|---|
| Empurrar (avanço) | crescendo 1 → 1.2 | crescendo 0.75 → 1 | zoom-through |
| Puxar (recuo) | diminuindo 1 → 0.8 | diminuindo 1.25 → 1 | inverse zoom-through |
Espelhos proibidos: uma saída recuando respondida por uma entrada crescendo do pequeno (puxar vira empurrar — o comum, já que crescer do pequeno é a entrada padrão de elemento), e uma saída empurrando respondida por uma retração exagerada. Isso vincula as PRÓPRIAS entradas da cena que chega durante a janela da costura (corte + ~0.5s), não apenas o tween wrapper: segure o quadro de entrada composto, ou crie sua entrada para corresponder ao sinal. Verifique por regra 7 do Portão da Costura.
Lógica de desfoque (todas as variantes Z)
| Sujeito | Pico de desfoque | Por que |
|---|---|---|
| Escala de texto (manchete, grupo de palavras) | 10px | 20px borra letras — o corte é lido como uma falha, não velocidade |
| Superfície de tela cheia (janela, cartão, captura de tela) | 18–20px | desfoque mais leve em uma superfície grande é lido como um soluço de renderização |
Mesmo pico de desfoque em ambos os lados no quadro de troca. Desfoque o WRAPPER, nunca filhos.
1. Zoom-Through (avanço)
Corte com correspondência de velocidade no eixo Z; nunca ambos os textos visíveis. Tudo CRESCE: o texto que sai acelera em direção à câmera, uma troca dura esconde no pico do desfoque, o texto que entra continua crescendo para o plano focal. Apenas manchetes e frases curtas. Total ≈ 0.4s.
| Fase | Escala | Desfoque | Opacidade | Ease | Duração |
|---|---|---|---|---|---|
| Saída | 1 → 1.2 | 0 → 10px | 1 → 0.15 | power3.in (opacidade: tween none separado) | 0.2s |
Corte (tl.set) | entrada: 0.75 | 10px | saída: 0 / entrada: 0.15 | — | — |
| Entrada | 0.75 → 1 | 10 → 0px | 0.15 → 1 | expo.out | 0.5s |
A opacidade de saída DEVE ser seu próprio tween linear — power3.in segura a opacidade perto de 1 por muito tempo.
Na entrada, todas as propriedades compartilham expo.out.
2. Inverse Zoom-Through (reverso)
O espelho de puxar para trás: o elemento que sai RECUA; o que chega chega EXAGERADO (como se logo atrás da câmera) e retrai para o plano focal. Tudo DIMINUI. Gaste em batidas de CHEGADA/recompensa — uma linha de recompensa, uma resposta gigante, um estado final sustentado — nunca limites comuns. Total ≈ 0.7s (30% saída / 70% entrada).
| Fase | Escala | Desfoque | Opacidade | Ease | Duração |
|---|---|---|---|---|---|
| Saída | 1 → 0.8 | 0 → 10px | 1 → 0.15 | power3.in (opacidade: tween none separado) | ~0.2s |
Corte (tl.set) | entrada: 1.25 | 10px | saída: 0 / entrada: 0.15 | — | — |
| Entrada | 1.25 → 1 | 10 → 0px | 0.15 → 1 | expo.out | ~0.5s |
Desfoque é 10px para escala de texto; 18–20px apenas quando ambos os lados são superfícies de sangria total.
Disciplina de sinal: a cena que chega entra como um quadro composto dentro do wrapper que retrai — sem introdução crescendo do pequeno na janela da costura. Entradas em estágios acontecem após a retração se estabilizar, ou começam em ≥1 e retraem.
3. Cut the Curve (limite de cena padrão)
Corte com correspondência de velocidade em X/Y — o padrão para TODOS os limites de cena-para-cena, na corrente do filme, não um acento. O herói que sai acelera em uma direção, o corte aterrissa no meio do movimento, o herói que entra continua na MESMA direção e desacelera. Total ≈ 0.6s; direções ESQUERDA / DIREITA / CIMA / BAIXO (padrão ESQUERDA).
Deslocamento parcial: ~12% do quadro (≈230px a 1920) — nunca movimentos completos para fora da tela.
| Direção | Saída | Início → fim da entrada |
|---|---|---|
| Para a esquerda | x: 0 → −230 | x: +230 → 0 |
| Para a direita | x: 0 → +230 | x: −230 → 0 |
| Para cima | y: 0 → −230 | y: +230 → 0 |
| Para baixo | y: 0 → +230 | y: −230 → 0 |
Mecânica:
- Eases espelhados: saída
power4.in+ entradapower4.out, mesma distância e duração — as duas metades de umpower4.inOut, então a velocidade corresponde exatamente no corte. - O truque do desvanecimento: a opacidade de saída completa em ~25–30% do seu deslocamento (desvanecimento ≈ 0.18–0.3s vs movimento 0.3–0.34s); a entrada acende em ~0.35 de opacidade no meio do caminho. Cronometre o último elemento que desvanece para morrer exatamente no corte — uma lacuna onde nada se move é lida como ar morto.
- Saída 0.2–0.4s; entrada ≥ saída. Desfoque opcional 8–10px.
- Fundo de palco:
#rootdeve ser opaco (background: var(--canvas-deep, var(--canvas, #000))) — o corte no meio da janela abre uma janela de opacidade somada < 1 que pisca em branco caso contrário (vejaseam-craft).
push-slide existe, mas viola o deslocamento parcial e a fase de meio movimento; prefira cut-the-curve.
4. Waterfall Cut (cut-the-curve palavra por palavra)
Cut-the-curve em granularidade de PALAVRA — o corte mais forte para a esquerda para costuras texto-para-texto. Palavras que saem aceleram em suas próprias curvas; palavras que entram entram em cascata no meio do voo — uma onda que o olho monta através da costura.
Escopo: criado por worker dentro de uma composição de múltiplas batidas (camadas .beat empilhadas em tela cheia),
NÃO um tipo registry/injector — ele faz tweens em spans de palavras, não em wrappers de clipe. O limite para dentro
e para fora do bloco de batida de texto ainda recebe uma transição de registry normal. Não conta
contra o orçamento de 2–3 transições.
| Parâmetro | Valor | Por que |
|---|---|---|
| Deslocamento | ±230px (~12% quadro) | deslocamento parcial + velocidade > empurrão de tela cheia |
| Saída | 0.34s power4.in | a aceleração É o corte |
| Desvanecimento de saída | 0.18s, começa com x | palavra desaparece em ~25–30% do deslocamento — sem borrão |
| Escalonamento de saída | +0.022s ordem de leitura | a linha descasca, não um slide de bloco |
| Entrada | 0.3s power4.out | metade de trás do composto — correspondência de velocidade |
| Opacidade inicial de entrada | 0.35 | ignição no meio do caminho; binário 0→1 estala |
| Lacunas de entrada | 0.05s × 0.84 decaimento | cascata acelerando, resolve composto |
Regras:
- Uma direção por cadeia, montando a corrente. Zoom inverso é apenas a batida de CHEGADA da cadeia.
- Pré-ajuste todas as palavras para
x: +230, opacity: 0no tempo de construção —immediateRender: falsesozinho deixa palavras não iniciadas visíveis em repouso. - Uma primeira batida curta pode sair em linha inteira: seu desvanecimento termina ~0.02s antes do corte para que ainda esteja em movimento quando as próximas palavras acenderem — sem lacuna morta.
- Apenas transform/opacidade (seguro para seek); fundo de palco opaco se aplica.
5. Rack-Focus Blur-Cut (o corte visível)
A única variante onde o corte é VISTO: um pico de desfoque de desfocagem ESCONDE uma troca dura de um único quadro — um foco puxado estilo DSLR de mão. Use como um floreio ocasional para uma troca de estado da MESMA superfície dentro de um tema visual; nunca o limite padrão.
Diferenças dos outros: a saída fica TOTALMENTE OPACA até o corte (o desfoque esconde
a troca — sem desvanecimento precoce); eases power2.in / power2.out (óptica suave, não momentum).
Regras:
- Acione apenas em uma batida narrativa, ≤ uma vez a cada ~8s; nunca no meio de uma legenda ou durante uma pausa.
- Corte no PICO do desfoque (≥6px; pico 8–12px, ≤16–18px máximo) — trocar na subida mostra o corte.
- Uma escala sutil (~1.06 respiração de lente) vende como óptica.
- Mesma direção em ambos os lados — a lei vetorial ainda vale. Entrada ≥ duração da saída.
- Desfoque o wrapper; nunca desfoque + opacidade em um tween em um elemento (erro de
composição sem cabeça); nunca desfoque um
<video>diretamente (envolva-o).
6. Waterfall Entry (chegada intra-cena — não é uma costura)
Cascata de CHEGADA escalonada: palavras/elementos entram de baixo (uma direção consistente), cada um começando antes do anterior se estabilizar — uma onda acelerando que se resolve em um layout composto. Cartões de título, aberturas de segmento, intros de lista/recurso. O irmão de costura é §4; não misture suas regras:
| §6 Entrada (chegada) | §4 Waterfall Cut (costura) | |
|---|---|---|
| Opacidade | BINÁRIA 0→1 via tl.set na entrada — nunca desvanecer | acende em 0.35 no meio do caminho — o desvanecimento É o truque de velocidade |
| Eixo padrão | Y, de baixo | X, montando a corrente |
| Lado de saída | nenhum | palavras saem em power4.in espelhado |
Coreografia:
- Sobreponha, não enfileire — o próximo elemento começa dentro de ±2 quadros do anterior se estabilizando; lacunas ENCOLHEM através da cascata; o último elemento estala.
- A velocidade varia por peso — elementos pesados/âncora viajam mais longe e por mais tempo; palavras leves/pontuação entram rapidamente:
| Parâmetro | Âncora/pesado | Palavra normal | Leve/pontuação |
|---|---|---|---|
| Deslocamento Y | 60–80px | 40–50px | 30–48px |
| Duração | 0.16–0.20s | 0.13–0.16s | 0.10–0.13s |
| Sobreposição | lacuna 0–2f | sobreposição 1f | sobreposição 1–2f |
- Ease
power4.out(expo.out para estalo extra); nunca.inOutem uma entrada. - Uma direção por cascata.
- Divida a palavra FINAL em fragmentos para estender o clímax; fragmentos viajam mais longe.
- Após a estabilização, o grupo geralmente desliza para abrir espaço para a próxima batida — isso é §7.
7. Nudge Curve (slide de grupo intra-cena — não é uma costura)
Reposicionamento lento-rápido-lento de um grupo composto (linhas de palavras, pilhas de cartões, listas) para
revelar conteúdo ou abrir espaço. Nenhum ease embutido único produz isso — power4.inOut
para com um solavanco. Encadeie três tweens em uma propriedade:
| Fase | Ease | Distância | Tempo | Sensação |
|---|---|---|---|---|
| 1 ramp-in | power3.in | ~10% | ~20% | mal se move — o movimento registra, sem solavanco |
| 2 burst | none (linear) | ~65% | ~18% | ~2× px/quadro médio — intencional |
| 3 tail | power4.out | ~25% | ~62% | rastejamento decadente para repouso — elimina o tranco |
Regras:
- A tail é ≥3× o ramp-in em TEMPO. Se ainda tranco: estenda o tempo da tail (não
a distância) ou use
power5.out. - A fase 2 permanece linear — suavizá-la perde o contraste do burst.
- Revele novo conteúdo DURANTE a fase 2 — o burst mascara sua aparência.
- Mesmas proporções na vertical; escale distâncias proporcionalmente, mantenha as proporções de tempo.
Escolhendo uma Variante
| Zoom-Through | Inverse Zoom | Cut the Curve | Waterfall Cut | |
|---|---|---|---|---|
| Escopo | Troca de texto intra-cena | Batida de chegada/recompensa | Entre cenas | Costura texto-para-texto |
| Sinal Z / eixo | crescendo (empurrar) | diminuindo (puxar) | X / Y | X, por palavra |
| Deslocamento/escala | 1→1.2, depois 0.75→1 | 1→0.8, depois 1.25→1 | ±230px | ±230px |
| Pico de desfoque | 10px texto / 18–20 tela cheia | 10px texto / 18–20 tela cheia | 8–10px opcional | nenhum |
| Eases | power3.in / expo.out | power3.in / expo.out | power4.in / power4.out | power4.in / power4.out |
| Sensação | progredindo através | chegando em | carregado lateralmente | uma onda através da costura |
Anti-Padrões
| Não faça
…
[truncado para tradução]