setAnimation

设置动画。

语句内容

填写自定义动画名称，驱动指定目标的舞台对象执行多段动画。
详情请见自定义动画和动画参考。

相关信息

如果您想直接在脚本里设置多段动画，请使用 setTempAnimation 命令。
如果您只想设置单段动画，请使用 setTransform 命令。

setAnimation:shake -target=aaa;

参数

target

• 字符串

动画作用目标。

可以填写的目标有:

• fig-center：中间立绘
• fig-left：左侧立绘
• fig-right：右侧立绘
• fig-left13、fig-right13、fig-left14、fig-right14：对应位置的立绘
• 自由立绘的 id
• bg-main：背景
• stage-main：舞台

changeFigure:1/open_eyes.png -id=aaa;
setAnimation:shake -target=aaa;

transformFrom

• 字符串
• 可选值：current、default
• 默认值：current

指定动画的变换起点，即动画中未写出的变换与效果属性如何处理。

• current：以对象当前的变换为起点。动画只修改其中写出的属性，未写出的属性保持当前值，也不会覆盖同一对象上其他并行动画正在修改的属性。
• default：以默认变换为起点，未写出的属性会重置为默认值。

填写此参数后，旧参数 writeDefault 将被忽略。

changeFigure:1/open_eyes.png -id=aaa;
setAnimation:shake -target=aaa -transformFrom=default;

writeDefault

• 布尔值

注意

此参数已不推荐使用，请改用 transformFrom：-writeDefault 等同于 -transformFrom=default。填写了 transformFrom 时，此参数会被忽略。

当值为 true 时，未被赋值的变换与效果属性都会写入默认值。
当值为 false 时，未被赋值的属性会继承现有的值。

changeFigure:1/open_eyes.png -id=aaa;
setAnimation:shake -target=aaa -writeDefault;

keep

• 布尔值

将该动画转换为跨语句动画。在执行接下来的语句的同时，保持播放当前动画，直至动画结束，或被下一个同目标的 setTransform setAnimation setTempAnimation 打断。
通常需要配合 next 参数一起使用。

; 假设这是一个特别长的动画
setAnimation:shake -target=aaa -keep -next;
角色A: 第一句话;
角色A: 第二句话;
角色A: 第三句话;
; 这会打断 aaa 的跨语句动画，并播放新动画
setAnimation:rotate -target=aaa -keep -next;

parallel

• 布尔值

与同一目标上正在播放的其他动画并行播放。

默认情况下，对同一目标执行新的 setTransform setAnimation setTempAnimation 时，会打断该目标上正在播放的动画。加上 -parallel 后，新动画不会打断已有的动画，两者同时播放。之后不带 -parallel 的动画仍会打断所有正在播放的动画，包括并行动画。

并行的动画应当修改不同的属性。如果多个并行动画修改了同一属性，最终效果无法预期。使用 -parallel 时，动画只会修改其中写出的属性。

changeFigure:1/open_eyes.png -id=aaa;
; 抖动和亮度变化同时进行
setAnimation:shake -target=aaa -next;
setTransform:{"brightness":0.5} -target=aaa -duration=1000 -parallel;