setTransform

设置变换与效果。

语句内容

填写变换与效果的单行 JSON 字符串。

相关信息

此命令只生成一段动画，如果您需要设置多段动画，请使用 setAnimation 或 setTempAnimation 命令。

changeFigure:character_a/normal.png -id=aaa;
; 向左移动
setTransform:{"position":{"x":-500},"saturation":0.8} -target=aaa -duration=500;
; 降低亮度
setTransform:{"brightness":0.5,"contrast":1.2} -target=aaa -duration=500;

参数

target

• 字符串

动画作用目标。

可以填写的目标有:

• fig-center：中间立绘
• fig-left：左侧立绘
• fig-right：右侧立绘
• 自由立绘的 id
• bg-main：背景
• stage-main：舞台

changeFigure:1/open_eyes.png -id=aaa;
setTransform:{"brightness":0.5} -target=aaa -duration=500;

duration

• 数字
• 范围：0 到正无穷
• 单位：毫秒

动画的持续时间。

changeFigure:1/open_eyes.png -id=aaa;
setTransform:{"brightness":0.5} -target=aaa -duration=500;

writeDefault

• 布尔值

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

changeFigure:1/open_eyes.png -id=aaa;
setTransform:{"brightness":0.5} -target=aaa -duration=500 -writeDefault;

keep

• 布尔值

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

; 假设这是一个特别长的动画
setTransform:{"scale":{"x":2,"y":2}} -target=aaa -duration=10000;
角色A: 第一句话;
角色A: 第二句话;
角色A: 第三句话;
; 这会打断 aaa 的跨语句动画，并播放新动画
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000;