クラス _Image

イメージを保持するクラスです。

インスタンスメソッド

| attach:

- (void)attach:(UIImage*)image

UIImage オブジェクトをこのオブジェクトに割り当てます。

パラメータ：

image | 割り当てる UIImage オブジェクト

補足説明：
このオブジェクトを解放しても、割り当てた UIImage オブジェクトは解放されません。

| load:

- (BOOL)load:(NSString*)name

ファイルからイメージを生成します。

パラメータ：

name | リソースファイル名

戻り値：
正常に生成された場合 YES、生成に失敗した場合 NO

| create::: create::

- (BOOL)create:(int)width :(int)height :(BOOL)use_g
- (BOOL)create:(int)width :(int)height

指定サイズのイメージを生成します。

パラメータ：

width | 生成するイメージの幅を指定します。
height | 生成するイメージの高さを指定します。
use_g | _Graphics オブジェクトを構築する場合 YES を、構築しない場合 NO を指定します。省略時は YES になります。

戻り値：
正常に生成された場合 YES、生成に失敗した場合 NO

| mutable: mutable

- (void)mutable:(BOOL)use_g
- (void)mutable

ファイルから生成されたイメージを変更可能にします。

パラメータ：

use_g | _Graphics オブジェクトを構築する場合 YES を、構築しない場合 NO を指定します。省略時は YES になります。

| getWidth

- (int)getWidth

イメージの幅を取得します。

戻り値：
イメージの幅を返します。

| getHeight

- (int)getHeight

イメージの高さを取得します。

戻り値：
イメージの高さを返します。

| getGraphics

- (_Graphics*)getGraphics

イメージに描画するための _Graphics オブジェクトを取得します。

戻り値：
イメージに描画するための _Graphics オブジェクトを返します。

補足説明：
ファイルから生成された _Image オブジェクトでは、本メソッドを呼び出す前に mutable メソッドで変更可能にしておく必要があります。

| getImage

- (UIImage*)getImage

UIImage オブジェクトを取得します。

戻り値：
UIImage オブジェクトを返します。

| pixels

- (unsigned char*)pixels

ピクセルデータへのポインタを取得します。

戻り値：
ピクセルデータへのポインタを返します。

補足説明：
create:::／create:: メソッドで生成されたイメージまたは mutable:／mutable メソッドで変更可能にしたイメージでのみ有効です。

| getPixels:::::

- (void)getPixels:(int)x :(int)y :(int)width :(int)height :(unsigned char*)pixels

指定する領域のピクセル値を取得します。

パラメータ：

x | 領域の左上のX座標を指定します。
y | 領域の左上のY座標を指定します。
width | 領域の幅を指定します。
height | 領域の高さを指定します。
pixels | ピクセル値はここに書き込まれます。

補足説明：
1 ピクセル 4 バイト相当であらかじめ確保したメモリを引数 pixels に指定します。
create:::／create:: メソッドで生成されたイメージまたは mutable:／mutable メソッドで変更可能にしたイメージでのみ有効です。