由两部分组成:一个 TypeScript 库,用 generator 函数编写动画;一个编辑器,对动画做实时预览。面向信息型矢量动画,尤其适合配合旁白做讲解视频。生成器函数把动画过程写成可读的代码,预览窗口随代码改动刷新,编辑器实时渲染同一份代码的结果,除了预览,还能调整一些手工做起来枯燥的参数,让代码负责时间线与图形逻辑,界面负责微调。项目以 monorepo 维护,包含多个包,分别承担库与编辑器等职责;文档的入门指南说明如何配置。许可为 MIT。适合做技术演示、教学视频,且愿意用代码而非关键帧控制动画的人。
Motion Canvas is two things:
It's a specialized tool designed to create informative vector animations and synchronize them with voice-overs.
Aside from providing the preview, the editor allows you to edit certain aspects of the animation which could otherwise be tedious.
Check out our getting started guide to learn how to use Motion Canvas.
The project is maintained as one monorepo containing the following packages:
| Name | Description |
|---|---|
2d |
The default renderer for 2D motion graphics |
core |
All logic related to running and rendering animations. |
create |
A package for bootstrapping new projects. |
docs |
Our documentation website. |
e2e |
End-to-end tests. |
examples |
Animation examples used in documentation. |
internal |
Internal helpers used for building the packages. |
player |
A custom element for displaying animations in a browser. |
template |
A template project included for developer's convenience. |
ui |
The user interface used for editing. |
vite-plugin |
A plugin for Vite used for developing and bundling animations. |
After cloning the repo, run npm install in the root of the project to install
all necessary dependencies. Then run npx lerna run build to build all the
packages.
When developing the editor, run the following command:
npm run template:dev
It will start a vite server that watches the core, 2d, ui, and
vite-plugin packages. The template package itself contains a simple Motion
Canvas project that can be used during development.
To develop the player, first build the template: npm run template:build. Then,
start npm run player:dev.
It can be useful to install a local version of Motion Canvas in a standalone project. For example, when you want to use your own fork with some custom-made features to create your animations.
Let's assume the following project structure:
projects/
├── motion-canvas/ <- your local monorepo
└── my-project/ <- a bootstrapped project
└── package.json
You can link the local packages from the monorepo by updating the package.json
of your project. Simply replace the version with a file: followed by a
relative path to the package you want to link:
"dependencies": {
- "@motion-canvas/core": "^3.11.0",
+ "@motion-canvas/core": "file:../motion-canvas/packages/core",
// ...
},
If you're linking the ui package, you'll also need to modify vite.config.ts
to allow vite to load external files:
import {defineConfig} from 'vite';
import motionCanvas from '@motion-canvas/vite-plugin';
export default defineConfig({
server: {
fs: {
// let it load external files
strict: false,
},
},
plugins: [motionCanvas()],
});
This is necessary because the editor styles are loaded using the /@fs/ prefix
and since the linked ui package is outside the project, vite needs permission
to access it.
Then run npm install in to apply the changes and that's it.
You can use the same technique to test out any custom package you're working on.
Read through our Contribution Guide to learn how you can help make Motion Canvas better.
| 日期 | 榜单 | 排名 | 周期新增 | 总 STAR |
|---|