スクリプトリファレンス([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」は設定しないで下さい(配列外参照例外が出ます)。