跳到主要内容

摄像机

Motion Canvas 内置一个简单的正交摄像机,让你可以平移、缩放和旋转 场景的视口,而无需变换场景中的 各个对象。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();
const rect = createRef<Rect>();
const circle = createRef<Circle>();

view.add(
<>
<Camera ref={camera}>
<Rect
ref={rect}
fill={'lightseagreen'}
size={100}
position={[100, -50]}
/>
<Circle
ref={circle}
fill={'hotpink'}
size={120}
position={[-100, 50]}
/>
</Camera>
</>,
);

yield* all(
camera().centerOn(rect(), 3),
camera().rotation(180, 3),
camera().zoom(1.8, 3),
);
yield* camera().centerOn(circle(), 2);
yield* camera().reset(1);
});

基本用法​

最快的入门方法是将场景包裹在 Camera 组件中, 并获取对它的引用。

import {makeScene2D, Camera, Rect, Circle} from '@motion-canvas/2d';
import {createRef} from '@motion-canvas/core';

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();

view.add(
<Camera ref={camera}>
<Rect size={100} fill={'lightseagreen'} position={[-100, -30]} />
<Circle size={80} fill={'hotpink'} position={[100, 30]} />
</Camera>,
);
});

然后你可以使用该摄像机引用在场景中操控摄像机。

默认情况下,Camera 组件是完全透传的。 在开始对其设置动画之前,它不会对场景产生任何可见效果。

移动摄像机​

移动摄像机有两种方式。你可以像使用其他组件一样, 直接使用摄像机的 position 信号。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();

view.add(
<Camera ref={camera}>
<Rect size={100} fill={'lightseagreen'} position={[-100, -30]} />
<Circle size={80} fill={'hotpink'} position={[100, 30]} />
</Camera>,
);

yield* camera().position([-100, -30], 1);
yield* camera().position([100, -30], 1);
yield* camera().position(0, 1);
});

或者,你可以使用 centerOn 方法将摄像机居中于特定位置或对象。 如果直接将对象传递给 centerOn,摄像机将 以该对象的位置为中心。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();
const rect = createRef<Rect>();
const circle = createRef<Circle>();

view.add(
<Camera ref={camera}>
<Rect
ref={rect}
size={100}
fill={'lightseagreen'}
position={[-100, -30]}
/>
<Circle ref={circle} size={80} fill={'hotpink'} position={[100, 30]} />
</Camera>,
);

yield* camera().centerOn(rect(), 1);
yield* camera().centerOn(circle(), 1);
});

你也可以直接将位置传递给 centerOn。在这种情况下, 摄像机将以指定位置为中心,且该位置位于世界坐标系中。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();

view.add(
<Camera ref={camera}>
<Rect size={100} fill={'lightseagreen'} position={[-100, -30]} />
<Circle size={80} fill={'hotpink'} position={[100, 30]} />
</Camera>,
);

yield* camera().centerOn([-200, 50], 1);
yield* camera().centerOn([150, -30], 1.5);
yield* camera().centerOn(0, 1);
});

缩放​

要放大或缩小摄像机,可以使用 zoom 方法。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();

view.add(
<Camera ref={camera}>
<Rect size={100} fill={'lightseagreen'} position={[-100, -30]} />
<Circle size={80} fill={'hotpink'} position={[100, 30]} />
</Camera>,
);

yield* camera().zoom(2, 1);
yield* camera().zoom(0.5, 1.5);
yield* camera().zoom(1, 1);
});

不应直接操作摄像机的 scale 属性。这是因为 Camera 组件 内部会执行一些额外工作,以确保在与其他摄像机动画 结合时,摄像机缩放级别的动画能够 正常工作。

你还可以使用 to 方法流畅地串联多个动画。

- yield* camera().zoom(2, 1);
- yield* camera().zoom(0.5, 1.5);
- yield* camera().zoom(1, 1);
+ yield* camera().zoom(2, 1).to(0.5, 1.5).to(1, 1);

旋转摄像机​

由于 Camera 是一个普通组件,你可以像使用其他组件一样, 通过 rotation 信号来更改其旋转。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();

view.add(
<Camera ref={camera}>
<Rect size={100} fill={'lightseagreen'} position={[-100, -30]} />
<Circle size={80} fill={'hotpink'} position={[100, 30]} />
</Camera>,
);

yield* camera().rotation(50, 1).to(-120, 2).to(0, 1);
});

请注意,这会使用摄像机当前的位置作为旋转中心。

重置摄像机​

要将摄像机的位置、缩放级别和旋转重置为默认值, 可以使用 reset 方法。

// Resets the camera's position to [0, 0], zoom to 1, and rotation to 0.
camera().reset(1);

沿路径移动​

你可以使用 followCurve 方法让摄像机沿路径移动。该方法接受 任何扩展自 Curve 类的对象。Motion Canvas 自带的许多形状, 如 Rect、Circle、Polygon 和 Spline,都扩展自 Curve 类, 可用作路径。

以下示例展示摄像机沿二次贝塞尔曲线 定义的路径移动。请注意,该路径不必可见, 甚至不必属于场景的一部分。此处仅出于演示目的 将其显示出来。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera = createRef<Camera>();
const path = createRef<QuadBezier>();

view.add(
<Camera ref={camera}>
<QuadBezier
ref={path}
lineWidth={6}
stroke={'lightseagreen'}
p0={[-200, 0]}
p1={[0, 200]}
p2={[200, 0]}
/>
</Camera>,
);

yield* camera().followCurve(path(), 2.5, linear);
});

在场景中使用多个摄像机​

Motion Canvas 还提供了一种将同一场景渲染到多个 摄像机的方法。这对于创建分屏视图,或从不同 视角渲染同一场景非常有用。

将同一场景渲染到多个摄像机需要稍作 不同的设置。

首先,不要将要渲染的场景直接添加到视图中, 而是将其存储在一个变量里。

const scene = (
<Node>
<Rect size={70} fill={'lightseagreen'} position={[-100, -30]} />
<Circle size={50} fill={'hotpink'} position={[100, 30]} />
</Node>
);

接下来,对于要显示的每个摄像机,向视图添加一个 Camera.Stage 组件,并将场景传递给 scene 属性。

const scene = /* ... */

const camera1 = createRef<Camera>();
const camera2 = createRef<Camera>();

view.add(
<>
<Camera.Stage
cameraRef={camera1}
size={[300, 200]}
position={[-180, 0]}
scene={scene}
/>
<Camera.Stage
cameraRef={camera2}
size={[300, 200]}
position={[180, 0]}
scene={scene}
/>
</>,
);

cameraRef 属性提供对该舞台摄像机的引用。 随后你可以使用这些引用分别操控每个摄像机。

Camera.Stage 要求其 scene 属性为单个顶层节点。 一个常见的错误来源是在定义场景时使用片段(<></>)。

以下场景在传递给 Camera.Stage 时会引发错误:

const scene = (
<>
<Circle />
<Rect />
</>
);

相反,应将场景包裹在单个节点中,如下所示:

const scene = (
<Node>
<Circle />
<Rect />
</Node>
);

与 Camera 组件不同,Camera.Stage 需要显式设置尺寸。 舞台会自动将场景裁剪为指定的尺寸。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera1 = createRef<Camera>();
const camera2 = createRef<Camera>();
const rect = createRef<Rect>();
const circle = createRef<Circle>();

const scene = (
<Node>
<Rect
ref={rect}
size={70}
fill={'lightseagreen'}
position={[-100, -30]}
/>
<Circle ref={circle} size={50} fill={'hotpink'} position={[100, 30]} />
</Node>
);

view.add(
<>
<Camera.Stage
cameraRef={camera1}
scene={scene}
size={[300, 200]}
position={[-180, 0]}
fill={'#ccc'}
radius={10}
smoothCorners
/>
<Camera.Stage
cameraRef={camera2}
scene={scene}
size={[300, 200]}
position={[180, 0]}
fill={'#ccc'}
radius={10}
smoothCorners
/>
</>,
);

yield* all(camera1().centerOn(rect(), 1), camera2().centerOn(circle(), 1));
yield* all(camera1().centerOn(circle(), 1), camera2().centerOn(rect(), 1));
yield* all(camera1().zoom(1.5, 1), camera2().zoom(0.5, 1));
yield* all(camera1().reset(1), camera2().reset(1));
});

与简单地渲染同一场景两次相比,这样做的好处在于, 对场景所做的任何更改都会同时反映在两个摄像机中。

Press play to preview the animation
import ...

export default makeScene2D(function* (view) {
const camera1 = createRef<Camera>();
const camera2 = createRef<Camera>();
const rect = createRef<Rect>();
const circle = createRef<Circle>();

const scene = (
<Node>
<Rect
ref={rect}
size={70}
fill={'lightseagreen'}
position={[-100, -30]}
/>
<Circle ref={circle} size={50} fill={'hotpink'} position={[100, 30]} />
</Node>
);

view.add(
<>
<Camera.Stage
cameraRef={camera1}
scene={scene}
size={[300, 200]}
position={[-180, 0]}
fill={'#ccc'}
radius={10}
smoothCorners
/>
<Camera.Stage
cameraRef={camera2}
scene={scene}
size={[300, 200]}
position={[180, 0]}
fill={'#ccc'}
radius={10}
smoothCorners
/>
</>,
);

yield* all(
camera1().centerOn(rect(), 1),
camera2().centerOn(circle(), 1),
rect().fill('lightcoral', 1),
circle().fill('steelblue', 1),
);
yield* all(camera1().reset(1), camera2().reset(1));
yield* all(rect().fill('lightseagreen', 1), circle().fill('hotpink', 1));
});