スプライトの制御

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

- 目次 -

スプライトの色設定

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

- 関数の形式 -
void setSpriteColor (
  int spriteID,
  int red, int green, int blue, int alpha
)

引数は以下の通りです:

RGBA形式とは

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 )

引数は以下の通りです: