changeBg

背景入场, 替换背景, 背景退场的三合一命令。

语句内容

填写背景图片的路径。当文件路径为空或为 none 时，表示背景退场。
详情请见背景与立绘。

; 如果没有背景存在，则此句表示背景入场。
changeBg:bg.png;
; 如果已有背景存在，则此句表示替换背景。
changeBg:WebGAL_New_Enter_Image.png;
; 如果填写 none 或者不填，则此句表示背景退场。
changeBg:none;

如果背景图片的路径与 id 保持不变，则不会触发入场或退场动画。

参数

transform

• 字符串

填写 json 字符串，控制舞台对象的变换与效果。详情请见 变换效果参考 。

注意

此参数仅在对象入场，或替换对象时生效。如果需要修改在场对象的变换效果，请使用 setTransform、setAnimation、setTempAnimation 等命令。

changeBg:bg.png -transform={"position":{"x":-50,"y":-20},"rotation":0.1,"scale":{"x":1.2,"y":1.2},"brightness":0.5,"blur":10};

enter

• 字符串

填写动画名称，对象出场时将播放该动画，顶替默认的透明度淡入的入场动画。

changeBg:bg.png -enter=enter-from-left;

exit

• 字符串

填写动画名称，对象退场时将播放该动画，顶替默认的透明度淡出的退场动画。

changeBg:bg.png -exit=exit-to-right;

duration

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

动画的持续时间。

作用于默认入场退场动画，默认值为 1000。

changeBg:bg.png -duration=200;

ease

• 字符串

填写缓动类型，控制动画的缓动效果，默认值为 easeInOut，可选值包括

• linear：线性
• easeIn：缓入
• easeOut：缓出
• easeInOut：缓入缓出
• circIn：圆形缓入
• circOut：圆形缓出
• circInOut：圆形缓入缓出
• backIn：起点回弹
• backOut：终点回弹
• backInOut：起止回弹
• bounceIn：起点弹跳
• bounceOut：终点弹跳
• bounceInOut：起止弹跳
• anticipate：预先反向

任何其他字符串都会回退到默认值。

作用于默认入场退场动画。

changeBg:bg.png -ease=easeOut;

unlockname

• 字符串

填写一个名称，CG 鉴赏将收录该图片，并以该名称进行展示。如果不填写该参数，或名称为空，则不会收录此图片。

同一张图片（严格来说是同路径的图片）只能拥有一个展示名称。如果同一张图片以不同的名称被收录多次，仅保留最后一次收录时填写的名称。

changeBg:bg.png -unlockname=MyCg01;

series

• 字符串

填写一个名称，CG 鉴赏将收录该图片到指定名称的系列中，如果不填写该参数，或系列名称为空，则会将该图片收录到默认系列中。

默认系列
  | - CG 名称 1
  | - CG 名称 2
系列名称 1
  | - CG 名称 3
  | - CG 名称 4
  | - CG 名称 5
系列名称 2
  | - CG 名称 6

同一张图片（严格来说是同路径的图片）只能拥有存在于一个系列。如果同一张图片被收录在多个系列中，该图片只会存在于最后一次收录时填写的系列中。

单独填写 series 不会进行收录，请确保同时填写了 unlockname。

changeBg:bg.png -unlockname=MyCg01 -series=MySeries01;