摄像机
Motion Canvas 内置一个简单的正交摄像机,让你可以平移、缩放和旋转 场景的视口,而无需变换场景中的 各个对象。
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 信号。
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,摄像机将
以该对象的位置为中心。
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。在这种情况下,
摄像机将以指定位置为中心,且该位置位于世界坐标系中。
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 方法。
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 信号来更改其旋转。
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 类,
可用作路径。
以下示例展示摄像机沿二次贝塞尔曲线 定义的路径移动。请注意,该路径不必可见, 甚至不必属于场景的一部分。此处仅出于演示目的 将其显示出来。
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 需要显式设置尺寸。
舞台会自动将场景裁剪为指定的尺寸。
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));
});
与简单地渲染同一场景两次相比,这样做的好处在于, 对场景所做的任何更改都会同时反映在两个摄像机中。
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));
});