FREAcquireBitmapData()

AIR 3.0 和更高版本

用法

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()