动画效果
动画效果
为背景或立绘设置动画
使用语句 setAnimation:动画名 -target=作用目标;
示例:
; // 为中间立绘设置一个从下方进入的动画,并转到下一句
setAnimation:enter-from-bottom -target=fig-center -next;
目前,预制的动画有:
动画效果 | 动画名 | 持续时间(毫秒) |
---|---|---|
渐入 | enter | 300 |
渐出 | exit | 300 |
左右摇晃一次 | shake | 1000 |
从下侧进入 | enter-from-bottom | 500 |
从左侧进入 | enter-from-right | 500 |
从右侧进入 | enter-from-right | 500 |
前后移动一次 | move-front-and-back | 1000 |
目前,动画的作用目标有:
target | 实际目标 |
---|---|
fig-left | 左立绘 |
fig-center | 中间立绘 |
fig-right | 右侧立绘 |
bg-main | 背景 |
id | 某个有id的立绘 |
自定义动画
创建动画
动画文件在 game/animation
,你可以创建自己的自定义动画。
动画文件使用 JSON 描述,你可以在 参考文档 参考JSON语法。
每一个动画文件都代表一个动画序列,使用一个 JSON 数组来描述。下面是一个示例,描述了一个从左侧进入的动画:
示例: enter-from-left.json
[
{
"alpha": 0,
"scale": {
"x": 1,
"y": 1
},
"position": {
"x": -50,
"y": 0
},
"rotation": 0,
"blur": 5,
"duration": 0
},
{
"alpha": 1,
"scale": {
"x": 1,
"y": 1
},
"position": {
"x": 0,
"y": 0
},
"rotation": 0,
"blur": 0,
"duration": 500
}
]
其中各个属性代表的释义为:
属性名 | 释义 |
---|---|
alpha | 透明度,范围0-1 |
scale | 缩放 |
position | 位置偏移 |
rotation | 旋转角度,单位为弧度 |
blur | 高斯模糊半径 |
duration | 这个时间片的持续时间,单位为毫秒(ms) |
oldFilm | 老电影效果,0代表关闭,1代表开启 |
dotFilm | 点状电影效果,0代表关闭,1代表开启 |
reflectionFilm | 反射电影效果,0代表关闭,1代表开启 |
glitchFilm | 故障电影效果,0代表关闭,1代表开启 |
rgbFilm | RGB电影效果,0代表关闭,1代表开启 |
godrayFilm | 光辉效果,0代表关闭,1代表开启 |
然后,你需要在 animationTable
中加上你的自定义动画的文件名(不需要后缀名)
在文件 animationTable.json
:
["enter-from-left","enter-from-bottom","enter-from-right"]
然后,你就可以在脚本中调用:
setAnimation:enter-from-left -target=fig-left -next;
省略部分属性
如果你的动画只需要操作部分属性,你可以将其他不参与动画的属性留空,使它们保持默认。
示例:enter.json
[
{
"alpha": 0,
"duration": 0
},
{
"alpha": 1,
"duration": 300
}
]
使用变换
一个持续时间为0毫秒,且只有一个时间片的动画就是变换。
示例:
[
{
"alpha": 0,
"duration": 0
}
]
设置进出场效果
你还可以覆盖 WebGAL 默认的渐变进出场效果,替换为自己的动画效果,例如:
setTransition: -target=fig-center -enter=enter-from-bottom -exit=exit;
注意:只有当立绘或背景被设置后,你才能为其设置进出场效果。设置进出场效果的代码写在立绘或背景的设置代码后。并且,设置进出场效果的语句必须紧随设置立绘或背景的语句连续执行,否则无法被正确应用。
提示
为什么要这样做?
在设置立绘或背景时,会为立绘或背景默认设置一个进出场动画。在设置了立绘或背景后,立绘和背景不会立即展示在舞台上,而是会等待进出场效果的设置。
如果在立绘或背景设置后,立即执行设置进出场效果的语句,就可以覆盖掉默认的进出场动画,进而实现进出场效果的自定义。如果没有设置,则在进出场时执行默认动画。
如果不在立绘或背景设置后立即执行进出场效果的设置,等到图像已经进场了,再覆盖进场动画就没有意义了。但如果此时图像还没有出场,设置的出场动画仍有意义。其会在立绘或背景出场时正确地被应用。