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: 1行目;
キャラA: 2行目;
キャラA: 3行目;
; 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;