样条(Spline)
import ...
export default makeScene2D(function* (view) {
const spline = createRef<Spline>();
view.add(
<Spline ref={spline} lineWidth={4} fill={'#e13238'} closed>
<Knot position={[-120, -30]} startHandle={[0, 70]} />
<Knot
position={[0, -50]}
startHandle={[-40, -60]}
endHandle={[40, -60]}
/>
<Knot position={[120, -30]} startHandle={[0, -70]} />
<Knot position={[0, 100]} startHandle={[5, 0]} />
</Spline>,
);
yield* spline().scale(0.9, 0.6).to(1, 0.4);
});
Spline 组件使我们能够绘制平滑曲线并为其制作动画,这些曲线会穿过一系列控制点。
如果你只想绘制一条简单的贝塞尔曲线,请改用贝塞尔曲线组件。
定义控制点
要绘制样条,我们需要指定其结点。Spline 组件提供了多种指定这些控制点的方式,我们将在本节中逐一介绍。
使用 points 属性
定义样条结点最简单的方法是通过样条的 points 属性传入一个位置数组。每个点都将被视为样条其中一个结点的位置。
import ...
export default makeScene2D(function* (view) {
view.add(
<Spline
lineWidth={6}
stroke={'lightseagreen'}
points={[
[-300, 0],
[-150, -100],
[150, 100],
[300, 0],
]}
/>,
);
});
结果是一条平滑穿过每个所提供点的曲线。
请务必为样条提供 lineWidth 和 stroke,否则它将不可见。或者,你也可以指定 fill 颜色。
我们可以通过向 smoothness 属性传入一个介于 0 和 1 之间的值来改变曲线的形状。
import ...
export default makeScene2D(function* (view) {
const spline = createRef<Spline>();
view.add(
<Spline
ref={spline}
lineWidth={6}
stroke={'lightseagreen'}
smoothness={0.4}
points={[
[-300, 0],
[-150, -100],
[150, 100],
[300, 0],
]}
/>,
);
yield* spline().smoothness(0, 1).to(1, 1).to(0.4, 1);
});
虽然以这种方式定义结点非常简单,对于简单曲线也足够用,但此方法有一个重要限制:我们无法更改结点控制柄的位置。相反,控制柄会自动计算,使曲线平滑地穿过每个点,而不会出现任何尖锐或突兀的转折。
自动控制柄是根据结点两侧相邻两个结点的位置计算得出的。以这种方式计算结点控制柄位置的样条称为基数样条(Cardinal Spline)。
让我们看看定义结点的第二种方式,以了解如何更精细地控制样条的形状。
使用 Knot 节点
定义结点的第二种方式是——恰如其分地——使用 Knot 节点。上面那条样条也可以这样写。
import ...
export default makeScene2D(function* (view) {
view.add(
<Spline lineWidth={6} stroke={'lightseagreen'}>
<Knot position={[-300, 0]} />
<Knot position={[-150, -100]} />
<Knot position={[150, 100]} />
<Knot position={[300, 0]} />
</Spline>,
);
});
如你所见,我们得到的形状与使用 points 属性时完全相同。使用 Knot 节点定义结点的优点在于,它还允许我们通过 startHandle 和 endHandle 属性控制每个结点控制柄的位置。
import ...
export default makeScene2D(function* (view) {
view.add(
<Spline lineWidth={6} stroke={'lightseagreen'}>
<Knot position={[-300, 0]} />
<Knot position={[-150, -100]} endHandle={[-100, 0]} />
<Knot position={[150, 100]} startHandle={[100, 0]} />
<Knot position={[300, 0]} />
</Spline>,
);
});
请注意,控制柄位置是相对于结点位置的。
与使用 points 属性类似,如果没有为结点提供显式的控制柄,控制柄将自动计算,使曲线平滑地穿过该结点。
镜像控制柄
控制柄默认是镜像的。这意味着当我们只提供结点的其中一个控制柄时,另一个控制柄将隐式设置为所提供控制柄的翻转版本。
<Knot startHandle={[100, 50]} />
// Is the same as
<Knot startHandle={[100, 50]} endHandle={[-100, -50]} />
断开的结点
同时提供 startHandle 和 endHandle 会产生所谓的断开的结点。断开的结点非常有用,因为它们使我们能够为样条添加尖角。
import ...
export default makeScene2D(function* (view) {
view.add(
<Spline lineWidth={16} stroke={'lightseagreen'} closed>
<Knot position={[-50, -80]} startHandle={[0, 20]} endHandle={[90, 0]} />
<Knot position={[50, 0]} />
<Knot position={[-50, 80]} startHandle={[90, 0]} endHandle={[0, -20]} />
</Spline>,
);
});
在用户控制柄与计算控制柄之间混合
默认情况下,当提供了 startHandle 或 endHandle 属性中的至少一个时,自动计算的控制柄将被忽略。不过,可以通过 auto 属性在用户提供的控制柄与自动计算的控制柄之间进行混合。
<Spline lineWidth={16} stroke={'lightseagreen'} closed>
<Knot
position={[-50, -80]}
startHandle={[0, 20]}
endHandle={[90, 0]}
auto={0.5}
/>
<Knot position={[50, 0]} />
<Knot
position={[-50, 80]}
startHandle={[90, 0]}
endHandle={[0, -20]}
auto={0.5}
/>
</Spline>
auto 应是一个介于 0 和 1 之间的值,表示在用户提供的控制柄(0)与自动计算的控制柄(1)之间混合的比例。
auto 是一个复合信号,这意味着你可以指定 startHandleAuto 和 endHandleAuto 来分别控制每个控制柄的混合程度。
<Knot
position={[0, 0]}
startHandle={[-50, -50]}
endHandle={[30, 0]}
startHandleAuto={0.3}
endHandleAuto={0.8}
/>
由于 auto 是一个信号,它也可以制作动画。
import ...
export default makeScene2D(function* (view) {
const knots: Knot[] = [];
view.add(
<Spline lineWidth={16} stroke={'lightseagreen'} lineJoin={'round'} closed>
<Knot
ref={makeRef(knots, 0)}
position={[-50, -80]}
startHandle={[0, 20]}
endHandle={[90, 0]}
/>
<Knot position={[50, 0]} />
<Knot
ref={makeRef(knots, 1)}
position={[-50, 80]}
startHandle={[90, 0]}
endHandle={[0, -20]}
/>
</Spline>,
);
yield* all(...knots.map(knot => knot.auto(1, 1).to(0, 1)));
});
为样条制作动画
虽然为样条制作动画与为其他任何节点制作动画差别不大,但本节旨在说明一些最常见的用例。
绘制样条
与 Line 组件类似,Spline 节点提供 start 和 end 信号,使我们能够控制曲线中应可见的区段。start 和 end 都是介于 0 和 1 之间的值,表示从样条弧长的百分之多少处开始绘制。
<Spline
points={[
[-300, 0],
[-150, -100],
[150, 100],
]}
start={0.4}
end={0.8}
/>
上面的示例将从样条弧长的 40% 处开始绘制样条(start={0.4}),并一直绘制到样条弧长的 80% 处(end={0.8})。
当将 start 和 end 与 startOffset 和 endOffset 结合使用时,start 和 end 将相对于考虑偏移后样条的_剩余_长度。
然后,我们可以通过对这些属性进行补间来制作绘制样条的动画:
import ...
export default makeScene2D(function* (view) {
const spline = createRef<Spline>();
view.add(
<Spline
ref={spline}
lineWidth={6}
stroke={'lightseagreen'}
points={[
[-300, 0],
[-150, -100],
[150, 100],
[300, 0],
]}
end={0}
/>,
);
yield* spline().end(1, 1.5);
yield* spline().start(1, 1.5).to(0.5, 1);
yield* spline().end(0.5, 1);
yield* all(spline().start(0, 1.5), spline().end(1, 1.5));
});
为样条的结点制作动画
Knot 的制作动画方式与其他组件大致相同。
只有在使用 Knot 组件时,才能为样条的结点制作动画;使用 points 属性时则不行。
下面是通过为结点的不同属性制作动画可以实现的一些有趣效果的示例。
你可以将 startHandle 和 endHandle 视为 Knot 的子对象——更改结点的位置、旋转和缩放也会同时变换控制柄。唯一的例外是 auto 控制柄,它们不受这些变换的影响。
import ...
export default makeScene2D(function* (view) {
const knotPositions: PossibleVector2[] = [
[-200, 0],
[-100, -80],
[0, 80],
[100, -80],
[200, 0],
];
const knots: Knot[] = [];
view.add(
<Spline lineWidth={6} stroke={'lightseagreen'}>
{knotPositions.map((pos, i) => (
<Knot ref={makeRef(knots, i)} position={pos} />
))}
</Spline>,
);
yield* all(
knots[1].position.y(80, 1).to(-80, 1),
knots[2].position.y(-80, 1).to(80, 1),
knots[3].position.y(80, 1).to(-80, 1),
);
});
沿样条为对象制作动画
样条可用于模拟对象应遵循的路径。你可以使用 getPointAtPercentage 方法来实现这一点。
import ...
export default makeScene2D(function* (view) {
const spline = createRef<Spline>();
const progress = createSignal(0);
view.add(
<>
<Spline
ref={spline}
lineWidth={6}
stroke={'lightgray'}
points={[
[-300, 0],
[-150, -100],
[150, 100],
[300, 0],
]}
/>
<Rect
size={26}
fill={'lightseagreen'}
position={() => spline().getPointAtPercentage(progress()).position}
rotation={() =>
spline().getPointAtPercentage(progress()).tangent.degrees
}
/>
</>,
);
yield* progress(1, 2).to(0, 2);
});
getPointAtPercentage 方法返回一个 CurvePoint 对象,其中包含位于样条弧长给定百分比处的点的位置,以及该点的切向量。