クラス _GLGraphics

OpenGL ES を使用して、イメージ、シェイプを描画する機能を提供するクラスです。

クラスメソッド

getColorOfRGB:::

+ (int)getColorOfRGB:(int)r :(int)g :(int)b

RGB値を指定して、対応するカラーを表す整数値を取得します。

パラメータ:
r赤要素の輝度を指定します(0〜255)。
g緑要素の輝度を指定します(0〜255)。
b青要素の輝度を指定します(0〜255)。

戻り値:
カラーを表す値を返します。

インスタンスメソッド

initWithTexture:

- (id)initWithTexture:(_GLTexture*)glt

_GLGraphics オブジェクトを生成します。

パラメータ:
glt_GLTexture クラスを継承したクラスオブジェクトを指定します。

戻り値:
_GLGraphics オブジェクト

reset

- (void)reset

_GLGraphics オブジェクトの再設定を行います。

補足説明:
_Canvas3D クラスを継承したクラスの _reset3D メソッド内で、本メソッドを呼び出す必要があります。

setSize::

- (void)setSize:(int)width :(int)height

描画領域のサイズを設定します。

パラメータ:
width描画領域の幅を指定します。
height描画領域の高さを指定します。

getWidth

- (int)getWidth

描画領域の幅を取得します。

戻り値:
描画領域の幅を返します。

getHeight

- (int)getHeight

描画領域の高さを取得します。

戻り値:
描画領域の高さを返します。

setLineWidth:

- (void)setLineWidth:(float)width

線幅を設定します。

パラメータ:
width線幅を指定します。

補足説明:
drawLine:::: メソッドでのみ有効です。

setColor:

- (void)setColor:(int)col

描画に使用する色を設定します。

パラメータ:
col描画に使用する色を指定します。

setAlpha:

- (void)setAlpha:(int)a

描画で参照されるα値を設定します。

パラメータ:
aα値を指定します(0〜255)。

補足説明:
α値とは、255 で不透明、0 で完全な透明になる値です。

setROP:

- (void)setROP:(int)mode

ラスタオペレーションを設定します。

パラメータ:
modeラスタオペレーションを指定します。次のいずれかを指定します。

ROP_COPY 通常合成。
ROP_ADD 加算合成。

setFlipMode:

- (void)setFlipMode:(int)flipmode

テクスチャの描画時に反転または回転して描画を行うかどうかを設定します。

パラメータ:
flipmodeテクスチャの描画時の反転または回転方法を指定します。次のいずれかを指定します。

FLIP_NONE 反転しないことを表します。
FLIP_HORIZONTAL 横方向に鏡像反転することを表します。
FLIP_VERTICAL 縦方向に鏡像反転することを表します。
FLIP_ROTATE 縦横方向に鏡像反転(180度回転)することを表します。

setOrigin::

- (void)setOrigin:(int)x :(int)y

描画の際の座標原点を設定します。

パラメータ:
xX方向のオフセット値を指定します。
yY方向のオフセット値を指定します。

drawLine::::

- (void)drawLine:(int)x1 :(int)y1 :(int)x2 :(int)y2

直線を描画します。

パラメータ:
x1直線の描画開始点のX座標を指定します。
y1直線の描画開始点のY座標を指定します。
x2直線の描画終了点のX座標を指定します。
y2直線の描画終了点のY座標を指定します。

補足説明:
_Canvas3D クラスの lock3D メソッドから unlock3D メソッドの間で有効です。

drawRect::::

- (void)drawRect:(int)x :(int)y :(int)width :(int)height

矩形を描画します。

パラメータ:
x矩形の左上のX座標を指定します。
y矩形の左上のY座標を指定します。
width矩形の幅を指定します。
height矩形の高さを指定します。

補足説明:
_Canvas3D クラスの lock3D メソッドから unlock3D メソッドの間で有効です。
横方向には x 番目から x + w 番目のピクセル(w + 1 個)が描画され、縦方向には y 番目から y + h 番目のピクセル(h + 1 個)が描画されます。

fillRect::::

- (void)fillRect:(int)x :(int)y :(int)width :(int)height

矩形領域を塗りつぶします。

パラメータ:
x矩形の左上のX座標を指定します。
y矩形の左上のY座標を指定します。
width矩形の幅を指定します。
height矩形の高さを指定します。

補足説明:
_Canvas3D クラスの lock3D メソッドから unlock3D メソッドの間で有効です。
横方向には x 番目から x + w - 1 番目のピクセル(w 個)が塗りつぶされ、縦方向には y 番目から y + h - 1 番目のピクセル(h 個)が塗りつぶされます。

lockTexture:

- (void)lockTexture:(int)tex_index

テクスチャの使用を宣言します。

パラメータ:
tex_index使用宣言するテクスチャ・リソースのインデックスを指定します。

補足説明:
同じテクスチャに対して描画メソッドを連続して呼び出す場合、本メソッドでテクスチャの使用を宣言してから、描画メソッドを連続して呼び出した後、unlockTexture メソッドで使用宣言を解除することで、処理の高速化が図れます。

unlockTexture

- (void)unlockTexture

テクスチャの使用宣言を解除します。

drawTexture:::
drawTexture:::::::

- (void)drawTexture:(int)tex_index :(int)x :(int)y
- (void)drawTexture:(int)tex_index :(int)dx :(int)dy :(int)sx :(int)sy :(int)width :(int)height

テクスチャを描画します。

パラメータ:
tex_index描画するテクスチャ・リソースのインデックスを指定します。
xX座標を指定します。
yY座標を指定します。
dx描画先のX座標を指定します。
dy描画先のY座標を指定します。
sx描画元の矩形の左上のX座標を指定します。
sy描画元の矩形の左上のY座標を指定します。
width描画元の矩形の幅を指定します。
height描画元の矩形の高さを指定します。

補足説明:
_Canvas3D クラスの lock3D メソッドから unlock3D メソッドの間で有効です。
lockTexture: メソッドから unlockTexture メソッドの間では、tex_index パラメータは無視されます。

drawScaledTexture:::::::::

- (void)drawScaledTexture:(int)tex_index :(int)dx :(int)dy :(int)width :(int)height :(int)sx :(int)sy :(int)swidth :(int)sheight

テクスチャを拡大・縮小して描画します。

パラメータ:
tex_index描画するテクスチャ・リソースのインデックスを指定します。
dx描画先の矩形の左上のX座標を指定します。
dy描画先の矩形の左上のY座標を指定します。
width描画先の矩形の幅を指定します。
height描画先の矩形の高さを指定します。
sx描画元の矩形の左上のX座標を指定します。
sy描画元の矩形の左上のY座標を指定します。
swidth描画元の矩形の幅を指定します。
sheight描画元の矩形の高さを指定します。

補足説明:
_Canvas3D クラスの lock3D メソッドから unlock3D メソッドの間で有効です。
lockTexture: メソッドから unlockTexture メソッドの間では、tex_index パラメータは無視されます。

drawTransTexture::::::::::::

- (void)drawTransTexture:(int)tex_index :(float)dx :(float)dy :(int)sx :(int)sy :(int)width :(int)height :(float)cx :(float)cy :(float)r360 :(float)z128x :(float)z128y

テクスチャを回転・拡大・縮小して描画します。

パラメータ:
tex_index描画するテクスチャ・リソースのインデックスを指定します。
dx描画先のアンカーX座標を指定します。アンカー座標とは、回転・拡大・縮小の基準となる座標です。
dy描画先のアンカーY座標を指定します。アンカー座標とは、回転・拡大・縮小の基準となる座標です。
sx描画元の矩形の左上のX座標を指定します。
sy描画元の矩形の左上のY座標を指定します。
width描画元の矩形の幅を指定します。
height描画元の矩形の高さを指定します。
cx描画元の矩形の左からの相対X座標を指定します。この座標点とアンカー座標が一致するように描画されます。
cy描画元の矩形の上からの相対Y座標を指定します。この座標点とアンカー座標が一致するように描画されます。
r360回転角度を指定します。時計回りで、単位は「度」です。
z128xX方向の拡大率を指定します。128.0f で拡大率100%(等倍)です。
z128yY方向の拡大率を指定します。128.0f で拡大率100%(等倍)です。

補足説明:
_Canvas3D クラスの lock3D メソッドから unlock3D メソッドの間で有効です。
lockTexture: メソッドから unlockTexture メソッドの間では、tex_index パラメータは無視されます。