Motion Canvas — Motor de Animação TypeScript para Vídeos Explicativos
Uma biblioteca TypeScript que usa generators para programar animações com um editor em tempo real. Ideal para vídeos explicativos, demonstrações de código e conteúdo educacional.
Visão Geral
- Repositório: github.com/motion-canvas/motion-canvas (18K+ estrelas)
- Linguagem: TypeScript
- Licença: MIT
- Instalação:
npm create @motion-canvas@latest - Documentação: motioncanvas.io/docs
Conceitos Principais
Configuração do Projeto
npm create @motion-canvas@latest my-animation
cd my-animation
npm install
npm start # Abre o editor em localhost:9000
Cenas
Cada animação é composta por cenas. Uma cena é uma função generator:
import { makeScene2D } from "@motion-canvas/2d";
import { createRef } from "@motion-canvas/core";
import { Circle } from "@motion-canvas/2d/lib/components";
export default makeScene2D(function* (view) {
const circle = createRef<Circle>();
view.add(<Circle ref={circle} size={100} fill="#e13238" />);
// Anima o círculo
yield* circle().scale(2, 0.6);
yield* circle().opacity(0, 0.3);
});
Animação com Generators
A palavra-chave yield* impulsiona as animações quadro a quadro:
// Animações sequenciais (uma após a outra)
yield* rect().position.x(300, 1); // Move para direita em 1 segundo
yield* rect().fill("#00ff00", 0.5); // Muda cor em 0,5 segundos
// Animações paralelas (simultâneas)
yield* all(
rect().position.x(300, 1),
rect().rotation(360, 1),
);
// Encadeadas com atraso
yield* chain(
rect().opacity(1, 0.3),
waitFor(0.5),
rect().scale(2, 0.6),
);
// Espera por duração
yield* waitFor(2); // Espera 2 segundos
Nodes (Elementos Visuais)
import { Rect, Circle, Line, Txt, Img, Video, Layout } from "@motion-canvas/2d/lib/components";
// Retângulo
<Rect width={200} height={100} fill="#333" radius={10} />
// Texto
<Txt text="Olá" fontSize={48} fill="white" fontFamily="monospace" />
// Círculo
<Circle size={80} fill="#e13238" />
// Imagem
<Img src={myImage} width={400} />
// Layout (flexbox)
<Layout direction="column" gap={20} alignItems="center">
<Txt text="Título" />
<Rect width={200} height={50} />
</Layout>
Sinais (Valores Reativos)
import { createSignal } from "@motion-canvas/core";
const progress = createSignal(0);
// Uso em componentes
<Rect width={() => progress() * 400} height={20} fill="blue" />
// Animar sinal
yield* progress(1, 2); // Anima de 0 a 1 em 2 segundos
Easing
import { easeInOutCubic, easeOutBounce, linear } from "@motion-canvas/core";
yield* rect().position.x(300, 1, easeInOutCubic);
yield* circle().scale(2, 0.8, easeOutBounce);
Destaque de Código
import { Code, lines, word } from "@motion-canvas/2d/lib/components";
const code = createRef<Code>();
view.add(
<Code
ref={code}
fontSize={24}
code={`function hello() {\n console.log("world");\n}`}
/>
);
// Destacar linhas específicas
yield* code().selection(lines(1, 2), 0.3);
// Animar mudanças no código
yield* code().code(
`function hello() {\n return "world";\n}`,
0.6,
);
Comandos
# Iniciar editor (preview ao vivo)
npm start
# Renderizar para vídeo
npx motion-canvas render
# Renderizar cena específica
npx motion-canvas render --scene=myScene
Melhores Práticas
- Use refs para alvos de animação:
createRef<Circle>()para qualquer node que você animar - Fluxo baseado em generator: Pense sequencialmente —
yield*é sua linha do tempo - Use
all()para paralelo: Agrupe animações simultâneas - Sinais para dados reativos: Valores dos quais múltiplos nodes dependem
- Componente Layout para flexbox: Posiciona automaticamente os filhos
- Mantenha cenas curtas: Divida animações longas em várias cenas
- Use o editor: O preview em tempo real com scrub é inestimável
Quando Usar Motion Canvas vs Remotion
| Motion Canvas | Remotion | |
|---|---|---|
| Melhor para | Educacional, explicativo | Produto, marketing |
| Estilo de animação | Imperativo (generators) | Declarativo (React) |
| Editor | Embutido em tempo real | Remotion Studio |
| Animação de código | Suporte de primeira classe | Implementação manual |
| Ecossistema | Crescendo | Grande (pacotes npm) |
| Sincronização de voz | Sincronização de áudio embutida | Sincronização manual |
Fonte
- Repositório: github.com/motion-canvas/motion-canvas
- Documentação: motioncanvas.io/docs
- Exemplos: motioncanvas.io/docs/examples