スプライトの制御
ここでは、配置後のスプライトの各種設定や制御を扱います。
スプライトの色設定
スプライトの色は、生成後に設定します。 一度設定した後も自由に変更する事が可能です。 スプライトの色設定にはsetSpriteColor 関数を使用します。
- 関数仕様 -int spriteID,
int red, int green, int blue, int alpha
)
最初の引数spriteID でスプライトのID を、続く引数で描画色の色成分を指定します。 色成分はRGBA 形式で、それぞれ0.255 の範囲の値を指定します。
RGBA形式とは
RGBA 形式とは、色の三原色である赤（Red）、緑（Green）、青(Blue)の色成分に、 アルファ値（Alpha）を加えた形式です。アルファ値は色の透明度を表す数値で、 0 で完全透明になり、最大にすると不透明になります。
それぞれの色成分からの色の合成は、 加法混色によって行われます。これは光の重ね合わせと同じ混色方式であり、 絵の具の混ぜ合わせ（減法混色）では無い事にご注意ください。 例として、（赤,緑、青）=( 255, 255, 255 )は、黒ではなく白になります。 また、( 255, 255, 0 )は黄色に、( 0,255, 255 )は水色に、（ 255, 0, 255 ）はマゼンタになります。
スプライトの深度設定
スプライトは、「深度」という値を持っています。 複数のスプライトを重ねて描画する際、深度の大きいほうが奥に隠れ、 深度の浅いものが手前に描画されます。 この深度を設定するにはsetSpriteDepth 関数を使用します。
- 関数仕様 -スプライトの位置変更
スプライトの描画位置を変更するには、setSpriteLocation 関数を使用します。
- 関数仕様 -最初の引数spriteID でスプライトのID を、続く引数x、y で スプライト左上頂点の座標を指定します。 なおこの関数は、長方形スプライト、楕円スプライト、テキストスプライト、 画像スプライトに対してのみ使用可能です。線スプライト、多角形スプライト、 折れ線スプライトに関しては、後述するsetSpriteVector 関数を使用してください。
スプライトのサイズ変更
スプライトの描画サイズを変更するには、setSpriteSize 関数を使用します。
- 関数仕様 -これは点スプライトのためのもので、最初の引数spriteIDでスプライトのIDを、 続く引数raduisで点の半径を指定します。長方形スプライト、楕円スプライト、テキストスプライト、 画像スプライトに対しては以下を使用します。
- 関数仕様 -最初の引数spriteID でスプライトのID を、 続く引数width、height でスプライトの幅と高さを指定します。 なお、線スプライト、多角形スプライト、 折れ線スプライトに関しては、後述するsetSpriteVector 関数を使用してください。
