スクリプトリファレンス([Lib]動的パーツカラー) - SpriteStudio/SS6PlayerForUnity GitHub Wiki

SS6Player for Unity(以降「SS6PU」)のライブラリ部(Library_SpriteStudio6)内の動的パーツカラー制御機能群のスクリプトリファレンスです。


合成色の設定(均一色指定型)

関数(動的)

void SetOverall(
        Library_SpriteStudio6.KindOperationBlend operationBlend,
        Color32 color
    )

引数

  • operationBlend : 指定合成方法
  • color : 指定色

返値

解説

動的カラーパラメータに単一色を設定します。

operationBlendには下記を設定可能です。

  • NON : なし
    動的パーツカラーの適用を一時的に停止して、アニメーションデータに従います。
  • MIX : ミックス
  • ADD : 加算
  • SUB : 減算
  • MUL : 乗算

※「MASK_PRE」「MASK」「MUL_NA」「SCR」「EXC」「INV」は設定できません(指定エラーとして無視されます)。

colorにLibrary_SpriteStudio6.Color.AdditionalColor.ColorClear[operationBlend]を与えると、動的パーツカラーを一切かけない(何も影響させない・アニメーションデータも無視する)状態にすることができます。


合成色の設定(各4頂点指定型)

関数(動的)

void SetVertex(
        Library_SpriteStudio6.KindOperationBlend operationBlend,
        Color32 colorLU,
        Color32 colorRU,
        Color32 colorRD,
        Color32 colorLD
    )

引数

  • operationBlend : 指定合成方法
  • colorLU : 指定色 頂点:左上
  • colorRU : 指定色 頂点:右上
  • colorRD : 指定色 頂点:右下
  • colorLD : 指定色 頂点:左下

返値

解説

動的カラーパラメータに頂点毎に色を設定します。
※頂点間は補間色になります。

「エフェクト」オブジェクトの動的パーツカラーで本関数を使用した場合、colorLUで指定した色の均一色指定になります(エフェクトのパーツには頂点毎のパーツカラー指定はできません)。
※ですので、エフェクトオブジェクトに対しては、本関数を使用しないことを推奨します。

operationBlendには下記を設定可能です。

  • NON : なし
    動的パーツカラーの適用を一時的に停止して、アニメーションデータに従います。
  • MIX : ミックス
  • ADD : 加算
  • SUB : 減算
  • MUL : 乗算

※「MASK_PRE」「MASK」「MUL_NA」「SCR」「EXC」「INV」は設定できません(指定エラーとして無視されます)。

colorLU・colorRU・colorRD・colorLDにLibrary_SpriteStudio6.Color.AdditionalColor.ColorClear[operationBlend]を与えると、各頂点に動的パーツカラーを一切かけない(何も影響させない・アニメーションデータも無視する)状態にすることができます。


描画順強制指定

変数(動的)

Color32[] ColorClear

設定値

各合成種別毎の無効果色

解説

動的パーツカラーの各合成種別毎で無効果にする色です。

配列添字はLibrary_SpriteStudio6.KindOperationBlend型の合成種別(をintにキャストした値)で、下記の指定が可能です。

  • MIX : ミックス
  • ADD : 加算
  • SUB : 減算
  • MUL : 乗算

※「MASK_PRE」「MASK」「MUL_NA」「SCR」「EXC」「INV」は設定しないで下さい(配列外参照例外が出ます)。