setTransform

変換とエフェクトを設定します。

ステートメント内容

変換・エフェクトの 1 行 JSON 文字列を指定します。

関連情報

このコマンドは 1 つのアニメーション片だけを生成します。多段アニメーションを設定する必要がある場合は、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: 右立ち絵
• fig-left13、fig-right13、fig-left14、fig-right14: 対応する位置の立ち絵
• 自由立ち絵の 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;

ease

• 文字列

アニメーションのイージング種別を指定します。デフォルト値は easeInOut です。使用できる値は次のとおりです。

• linear: 線形
• easeIn: イーズイン
• easeOut: イーズアウト
• easeInOut: イーズイン・アウト
• circIn: 円形イーズイン
• circOut: 円形イーズアウト
• circInOut: 円形イーズイン・アウト
• backIn: 開始側の戻り
• backOut: 終了側の戻り
• backInOut: 開始・終了側の戻り
• bounceIn: 開始側バウンス
• bounceOut: 終了側バウンス
• bounceInOut: 開始・終了側バウンス
• anticipate: 予備動作

その他の文字列はデフォルト値にフォールバックします。

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

transformFrom

• 文字列
• 指定可能な値：current、default
• デフォルト値：current

アニメーションの変換の起点、つまりアニメーションに書かれていない変換・エフェクトプロパティの扱いを指定します。

• current：オブジェクトの現在の変換を起点とします。アニメーションは書かれたプロパティのみを変更し、書かれていないプロパティは現在の値を保持します。同じオブジェクト上で他の並行アニメーションが変更中のプロパティも上書きしません。
• default：デフォルトの変換を起点とし、書かれていないプロパティはデフォルト値にリセットされます。

このパラメータを指定した場合、旧パラメータ writeDefault は無視されます。

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

writeDefault

• 真偽値

注意

このパラメータは非推奨です。代わりに transformFrom を使用してください。-writeDefault は -transformFrom=default と同じです。transformFrom を指定した場合、このパラメータは無視されます。

値が 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 -keep -next;
キャラA: 1行目;
キャラA: 2行目;
キャラA: 3行目;
; aaa のステートメントをまたぐアニメーションを中断し、新しいアニメーションを再生します
setTransform:{"scale":{"x":1,"y":1}} -target=aaa -duration=10000 -keep -next;

parallel

• ブール値

同じ対象で再生中の他のアニメーションと並行して再生します。

通常、同じ対象に新しい setTransform setAnimation setTempAnimation を実行すると、その対象で再生中のアニメーションは中断されます。-parallel を付けると、新しいアニメーションは既存のアニメーションを中断せず、同時に再生されます。その後に -parallel なしで実行したアニメーションは、並行アニメーションを含め、再生中のアニメーションをすべて中断します。

並行するアニメーションは、それぞれ異なる属性を変更してください。複数の並行アニメーションが同じ属性を変更すると、結果は予測できません。-parallel を使うと、アニメーションは記述した属性のみを変更します。

changeFigure:1/open_eyes.png -id=aaa;
; 移動と明るさの変化を同時に行う
setTransform:{"position":{"x":-500}} -target=aaa -duration=1000 -next;
setTransform:{"brightness":0.5} -target=aaa -duration=1000 -parallel;