信号
信号表示可能随时间变化的值。 它们可用于定义动画各状态之间的依赖关系。这样,当某个值发生变化时, 所有依赖于它的其他值都会自动更新。
概述
基本类型的信号通过 createSignal()
函数创建,
其中第一个参数指定其初始值:
import {createSignal} from '@motion-canvas/core';
const signal = createSignal(0);
此外,每个复杂类型都有一个静态的 createSignal()
方法,可用于为该类型创建信号:
import {Vector2} from '@motion-canvas/core';
const signal = Vector2.createSignal(Vector2.up);
每个节点的属性也由信号表示:
const circle = <Circle />;
const signal = circle.fill;
创建后, 可以调用信号来执行以下三种操作之一(具体操作根据参数数量决定):
- 获取值:
const value = signal();
- 更新值:
signal(3);
- 为该值创建一个补间:
yield * signal(2, 0.3);
除了传入实际的值, 还可以为信号提供一个动态计算该值的函数。请看以下示例:
const radius = createSignal(1);
const area = createSignal(() => Math.PI * radius() * radius());
console.log(area()); // 3.141592653589793
radius(2);
console.log(area()); // 12.566370614359172
这里,area 信号使用 radius 信号来计算其值。
原理解析
为了更好地理解信号的工作原理,我们来修改前面的示例, 看看面积究竟是在什么时候计算的:
const radius = createSignal(1);
const area = createSignal(() => {
console.log('area recalculated!');
return Math.PI * radius() * radius();
});
area(); // area recalculated!
area();
radius(2);
area(); // area recalculated!
radius(3);
radius(4);
area(); // area recalculated!
这展示了信号的三个重要特性:
惰性
只有在请求信号的值时才会计算信号。
第一条 "area recalculated!"
消息只有在调用 area() 之后才会输出到控制台。
缓存
信号一经计算,其值就会被保存,并在后续调用 area()
时直接返回。
这就是第二次调用时控制台没有任何输出的原因。
信号的这一特性使其非常适合缓存计算量较大的操作。事实上,
Motion Canvas 在内部使用信号来缓存矩阵等内容。
依赖追踪
area 信号会追踪它所依赖的其他信号。
当我们改变 radius 信号时,area 信号会收到通知,
但不会立即重新计算——惰性仍在起作用。
我们可以随意多次修改半径,但只有通过再次调用 area()
请求其值时,area 才会重新计算。
DEFAULT 值
信号会记录在创建时指定的初始值。在任何时候,
我们都可以通过向信号传入 DEFAULT
符号来将其重置为初始值:
import {DEFAULT, createSignal} from '@motion-canvas/core';
const signal = createSignal(3); // <- initial value is 3
signal(2);
signal(); // <- value is now 2
signal(DEFAULT);
signal(); // <- value is reset back to 3
yield * signal(DEFAULT, 2);
重置为默认值对节点属性尤其有用。在下面的示例中,
我们将 Txt 节点的
lineHeight 设置为 150%。
这会覆盖其默认值——该值原本会直接从父节点继承:
const text = createRef<Txt>();
view.add(
<Txt lineHeight={'150%'} ref={text}>
Hello world!
</Txt>,
);
如果我们想将 lineHeight
重置为默认的继承值,
可以使用 DEFAULT:
text().lineHeight(DEFAULT);
复杂示例
我们可以利用节点属性由信号表示这一特性, 构建在数据变化时自动更新的场景。沿用前面的示例, 我们来为圆的面积创建一个可视化效果:
下面列出了创建这个动画所用的代码。 我们高亮显示了所有使用信号的位置:
import {Circle, Line, Txt, makeScene2D} from '@motion-canvas/2d';
import {Vector2, createSignal, waitFor} from '@motion-canvas/core';
export default makeScene2D(function* (view) {
const radius = createSignal(3);
const area = createSignal(() => Math.PI * radius() * radius());
const scale = 100;
const textStyle = {
fontWeight: 700,
fontSize: 56,
offsetY: -1,
padding: 20,
cache: true,
};
view.add(
<>
<Circle
width={() => radius() * scale * 2}
height={() => radius() * scale * 2}
fill={'#e13238'}
/>
<Line
points={[
Vector2.zero,
() => Vector2.right.scale(radius() * scale),
]}
lineDash={[20, 20]}
startArrow
endArrow
endOffset={8}
lineWidth={8}
stroke={'#242424'}
/>
<Txt
text={() => `r = ${radius().toFixed(2)}`}
x={() => (radius() * scale) / 2}
fill={'#242424'}
{...textStyle}
/>
<Txt
text={() => `A = ${area().toFixed(2)}`}
y={() => radius() * scale}
fill={'#e13238'}
{...textStyle}
/>
</>,
);
yield* radius(4, 2).to(3, 2);
yield* waitFor(1);
});
有了这样的设置,我们只需为 radius
信号制作动画,场景的其余部分就会随之相应调整:
yield * radius(4, 2).to(3, 2);