スプライトの制御

ここでは、配置後のスプライトの各種設定や制御を扱います。

- 目次 -

スプライトの色設定

スプライトの色は、生成後に設定します。一度設定した後も自由に変更する事が可能です。スプライトの色設定にはsetSpriteColor 関数を使用します。

- 関数の形式 -

void setSpriteColor (
int spriteID,
int red, int green, int blue, int alpha
)

引数は以下の通りです：

RGBA 形式とは、色の三原色である赤（Red）、緑（Green）、青(Blue)の色成分に、アルファ値（Alpha）を加えた形式です。アルファ値は色の透明度を表す数値で、 0 で完全透明になり、最大にすると不透明になります。

それぞれの色成分からの色の合成は、加法混色によって行われます。これは光の重ね合わせと同じ混色方式であり、絵の具の混ぜ合わせ（減法混色）では無い事にご注意ください。例として：

スプライトは、「深度」という値を持っています。複数のスプライトを重ねて描画する際、深度の大きいほうが奥に隠れ、深度の浅いものが手前に描画されます。この深度を設定するにはsetSpriteDepth 関数を使用します。

- 関数仕様 -

void setSpriteDepth ( int spriteID, float depth )

引数は以下の通りです：

スプライトの描画位置を変更するには、setSpriteLocation 関数を使用します。

- 関数の形式 -

void setSpriteLocation ( int spriteID, int x, int y )

引数は以下の通りです：

この関数は、長方形スプライト、楕円スプライト、テキストスプライト、画像スプライトに対して使用可能です。

スプライトの描画サイズを変更するには、setSpriteSize 関数を使用します。

これには、引数にいくつかのバリエーションがあります。まずは点スプライト用のものです：

- 関数の形式 -

void setSpriteSize ( int spriteID, int radius )

引数は以下の通りです：

長方形スプライト、楕円スプライト、テキストスプライト、画像スプライトに対しては、以下の引数パターンのものを使用します：

- 関数の形式 -

void setSpriteSize ( int spriteID, int width, int height )

引数は以下の通りです：