迁移到 v3
安装
通过运行以下命令,将所有 @motion-canvas 包更新到 3.x.x 版本:
npm install --save @motion-canvas/2d@3 @motion-canvas/core@3 @motion-canvas/ui@3 @motion-canvas/vite-plugin@3
名称变更
此版本引入了多项名称变更,旨在使代码更具可读性,并减少与现有类型发生冲突的 可能性。请务必在代码库中替换以下名称:
| 旧名称 | 新名称 |
|---|---|
Image | Img |
Text | Txt |
Rect(类型,而非节点) | BBox |
Node.getCacheRect | Node.getCacheBBox |
Node.cacheRect | Node.cacheBBox |
Node.fullCacheRect | Node.fullCacheBBox |
CodeBlock.selectionOpacity | CodeBlock.unselectedOpacity |
项目配置
现在,大多数项目设置通过编辑器进行配置,并存储在 meta 文件中。首次运行项目后, meta 文件将自动更新以包含这些新设置。
你可以将配置从项目文件迁移过来:
src/project.tsimport {makeProject} from '@motion-canvas/core';
import example from './scenes/example?scene';
export default makeProject({
scenes: [example],
background: '#141414',
audioOffset: 2,
});
转移到 meta 文件:
src/project.meta{
"version": 1,
"shared": {
"background": "rgb(20,20,20)",
"range": [0, null],
"size": {
"x": 1920,
"y": 1080
},
"audioOffset": 2
},
"preview": {
"fps": 30,
"resolutionScale": 1
},
"rendering": {
"fps": 30,
"resolutionScale": 1,
"colorSpace": "srgb",
"fileType": "image/png",
"quality": 1
}
}
CodeBlock 回退
由于技术问题,PR #401 已被回退。
CodeBlock应再次使用完整路径导入:import {CodeBlock} from '@motion-canvas/2d/lib/components/CodeBlock';- 目前暂不支持
stockTheme属性。
请持续关注,我们将努力寻找更好的解决方案。