changeBg

背景の登場、背景の置き換え、背景の退場を行う 3 in 1 コマンドです。

ステートメント内容

背景画像のパスを指定します。ファイルパスが空、または none の場合は背景が退場します。
詳しくは背景と立ち絵を参照してください。

; 背景が存在しない場合、この文は背景を登場させます。
changeBg:bg.png;
; すでに背景が存在する場合、この文は背景を置き換えます。
changeBg:WebGAL_New_Enter_Image.png;
; none を指定するか空にした場合、この文は背景を退場させます。
changeBg:none;

背景画像のパスと id が同じままの場合、登場・退場アニメーションは発火しません。

パラメータ

transform

• 文字列

ステージオブジェクトの変換とエフェクトを制御する JSON 文字列を指定します。詳しくは 変換・エフェクトリファレンス を参照してください。

注意

このパラメータは、オブジェクトの登場時または置き換え時にのみ有効です。すでに場に出ているオブジェクトの変換とエフェクトを変更する場合は、setTransform、setAnimation、setTempAnimation などのコマンドを使用してください。
enter パラメータで登場アニメーションを指定した場合、このパラメータは効果を持ちません。

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 から正の無限大
• 単位: ミリ秒

アニメーションの持続時間です。

デフォルトの登場アニメーションに適用されます。デフォルト値は 1500 です。

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 鑑賞はこの画像を収録し、この名前で表示します。

同じ画像（厳密には同じパスの画像）は 1 つの表示名だけを持てます。同じ画像が異なる名前で複数回収録された場合、最後に収録された名前だけが保持されます。

このパラメータを省略した場合、または名前が空の場合、この画像は収録されません。

changeBg:bg.png -unlockname=MyCg01;

series

• 文字列

CG 鑑賞で、この画像を収録するシリーズ名を指定します。このパラメータを省略した場合、またはシリーズ名が空の場合は、デフォルトシリーズに収録されます。

デフォルトシリーズ
  | - CG 名 1
  | - CG 名 2
シリーズ名 1
  | - CG 名 3
  | - CG 名 4
  | - CG 名 5
シリーズ名 2
  | - CG 名 6

同じ画像（厳密には同じパスの画像）は 1 つのシリーズにだけ存在できます。複数のシリーズに収録された場合、最後に収録されたシリーズだけが保持されます。

series だけを指定しても収録は行われません。必ず unlockname も指定してください。

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

enterDuration

• 数値
• 単位: ミリ秒
• 範囲: 0 から正の無限大

登場アニメーションの持続時間です。省略した場合は duration の値を使用します（デフォルト 1500）。

changeBg:bg.png -enterDuration=500;

exitDuration

• 数値
• 単位: ミリ秒
• 範囲: 0 から正の無限大

退場アニメーションの持続時間です。省略した場合のデフォルト値は 1500 です。

changeBg:bg.png -exitDuration=800;