FREAcquireBitmapData()

使用方法

FREResult FREAcquireBitmapData ( 
            FREObject                 object, 
            FREBitmapData*                 descriptorToSet 
);

パラメーター

object

FREObject。この FREObject パラメーターは、ActionScript BitmapData クラスオブジェクトを表します。

descriptorToSet

FREBitmapData 型の変数へのポインター。ネイティブ C 実装でこのメソッドを呼び出すと、ランタイムがこの構造体のフィールドを設定します。 FREBitmapData を参照してください。

戻り値

FREResult。戻り値には、以下が含まれます（ただし、これらに限定されません）。

FRE_OK

関数は成功しました。FREBitmapData パラメーターが設定されています。ActionScript BitmapData オブジェクトを使用して操作できます。

FRE_ILLEGAL_STATE

拡張コンテキストは既に ActionScript BitmapData または ByteArray オブジェクトを取得しています。この BitmapData または ByteArray オブジェクトを解放するまでは、コンテキストはこのメソッドを呼び出すことはできません。

FRE_INVALID_ARGUMENT

descriptorToSet パラメーターは NULL です。

FRE_INVALID_OBJECT

FREObject object パラメーターは無効です。

FRE_TYPE_MISMATCH

FREObject object パラメーターは ActionScript BitmapData クラスオブジェクトを表していません。

FRE_WRONG_THREAD

ランタイムにネイティブ拡張関数に対する未実行の呼び出しがあるスレッドとは別のスレッドから、メソッドが呼び出されました。

説明

ActionScript BitmapData クラスオブジェクトのビットマップを取得するには、この関数を呼び出します。この関数の呼び出しに成功すると、 FREReleaseBitmapData() を呼び出すまでは、他の C API 関数を正常に呼び出すことはできません。これが禁止されるのは、他の呼び出しの副作用として、ビットマップコンテンツへのポインターを無効にするコードが実行されるからです。

この関数を呼び出した後は、BitmapData オブジェクトのビットマップを操作できます。ビットマップは、ビットマップに関する他の情報と同様に、 descriptorToSet パラメーターで使用できます。ビットマップまたは長方形領域が変更されたことをランタイムに通知するには、 FREInvalidateBitmapDataRect() を呼び出します。ビットマップの操作を終了したら、 FREReleaseBitmapData() を呼び出します。