跳到主要内容

信号

信号表示可能随时间变化的值。 它们可用于定义动画各状态之间的依赖关系。这样,当某个值发生变化时, 所有依赖于它的其他值都会自动更新。

概述​

基本类型的信号通过 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;

创建后, 可以调用信号来执行以下三种操作之一(具体操作根据参数数量决定):

  1. 获取值:
    const value = signal();
  2. 更新值:
    signal(3);
  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

我们还可以将 DEFAULT 符号用于补间动画:

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);