迁移到 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 (the type, not the node)	BBox
Node.getCacheRect	Node.getCacheBBox
Node.cacheRect	Node.cacheBBox
Node.fullCacheRect	Node.fullCacheBBox
CodeBlock.selectionOpacity	CodeBlock.unselectedOpacity

项目配置

现在大多数项目设置都是通过编辑器配置的，并存储在元文件中。首次运行项目后，元文件将自动更新以包含这些新设置。

您可以从项目文件中转移配置：

src/project.ts
import {makeProject} from '@motion-canvas/core';

import example from './scenes/example?scene';

export default makeProject({
  scenes: [example],
  background: '#141414',
  audioOffset: 2,
});

转到元文件：

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 属性暂时不支持。

请继续关注，因为我们将尝试找到更好的解决方案。