image_packer_mdk.h

概述

声明用于将图像编码到缓冲区或文件的api。可用于将像素数据编码到目标缓冲区或文件中。

编码过程如下：

通过OH_ImagePacker_Create方法创建编码器实例对象。

然后通过OH_ImagePacker_InitNative将编码器实例对象转换为编码器原生实例对象。

接下来用OH_ImagePacker_PackToData或者OH_ImagePacker_PackToFile将源以特定的编码选项编码进目标区域。

最后通过OH_ImagePacker_Release释放编码器实例对象。

库： libimage_packer_ndk.z.so

系统能力： SystemCapability.Multimedia.Image

起始版本： 11

相关模块： Image

汇总

结构体

|名称|typedef关键字|描述| |–|–|–| |ImagePackerOpts|ImagePacker_Opts|定义图像编码选项信息。| |ImagePackerNative|ImagePacker_Native|为编码器方法定义native层编码器对象。|

函数

|名称|描述| |–|–| |int32_t OH_ImagePacker_Create(napi_env env, napi_value *res)|获取JavaScript native层ImagePacker对象。| |ImagePacker_Native* OH_ImagePacker_InitNative(napi_env env, napi_value packer)|从输入JavaScript native层ImagePacker对象中，转换成ImagePacker_Native值。| |int32_t OH_ImagePacker_PackToData(ImagePacker_Native* native, napi_value source,ImagePacker_Opts* opts, uint8_t* outData, size_t* size)|通过一个给定的选项ImagePacker_Opts结构体，将输入JavaScript native层PixelMap对象或者ImageSource对象编码并输出到指定的缓存区outData中。| |int32_t OH_ImagePacker_PackToFile(ImagePacker_Native* native, napi_value source,ImagePacker_Opts* opts, int fd)|通过一个给定的选项ImagePacker_Opts结构体，将输入JavaScript native层PixelMap对象或者ImageSource对象编码并输出到指定的文件中。| |int32_t OH_ImagePacker_Release(ImagePacker_Native* native)|释放native层编码器对象ImagePacker_Native。
此API不用于释放JavaScript原生API ImagePacker对象，它用于释放native层对象ImagePacker_Native。|

函数说明

OH_ImagePacker_Create()

int32_t OH_ImagePacker_Create(napi_env env, napi_value *res)

描述

获取JavaScript native层ImagePacker对象。

起始版本： 11

参数：

|参数项|描述| |–|–| |napi_env env|表明JNI环境的指针。| |napi_value *res|表明JavaScript native层ImagePacker对象的指针。|

返回：

|类型|说明| |–|–| |int32_t|IRNdkErrCode：
IMAGE_RESULT_SUCCESS：执行成功。
IMAGE_RESULT_INVALID_PARAMETER：参数无效。|

OH_ImagePacker_InitNative()

ImagePacker_Native* OH_ImagePacker_InitNative(napi_env env, napi_value packer)

描述

从输入JavaScript native层ImagePacker对象中，转换成ImagePacker_Native值。

起始版本： 11

参数：

|参数项|描述| |–|–| |napi_env env|表明JNI环境的指针。| |napi_value packer|表明JavaScript native层ImagePacker对象。|

返回：

|类型|说明| |–|–| |ImagePacker_Native*|如果操作成功则返回ImagePacker_Native指针，否则返回空指针。|

参考：

OH_ImagePacker_Release

OH_ImagePacker_PackToData()

int32_t OH_ImagePacker_PackToData(ImagePacker_Native* native, napi_value source,ImagePacker_Opts* opts, uint8_t* outData, size_t* size)

描述

通过一个给定的选项ImagePacker_Opts结构体，将输入JavaScript native层PixelMap对象或者ImageSource对象编码并输出到指定的缓存区outData中。

起始版本： 11

参数：

|参数项|描述| |–|–| |ImagePacker_Native* native|表明指向native层ImagePacker的指针。| |napi_value source|表明待编码JavaScript native层PixelMap对象或者ImageSource对象。| |ImagePacker_Opts* opts|表明位图编码的选项。| |uint8_t* outData|输出的指定缓存区。| |size_t* size|输出的指定缓存区大小。|

返回：

|类型|说明| |–|–| |int32_t|IRNdkErrCode：
IMAGE_RESULT_SUCCESS：执行成功。
IMAGE_RESULT_INVALID_PARAMETER：参数无效。
ERR_IMAGE_DATA_ABNORMAL：输出缓冲区异常。
ERR_IMAGE_MISMATCHED_FORMAT：格式不匹配。
ERR_IMAGE_MALLOC_ABNORMAL：malloc内部缓冲区错误。
ERR_IMAGE_DECODE_ABNORMAL：init编解码器内部错误。
ERR_IMAGE_ENCODE_FAILED：编码器在编码过程中出现错误。|

参考：

OH_ImagePacker_PackToFile

OH_ImagePacker_PackToFile()

int32_t OH_ImagePacker_PackToFile(ImagePacker_Native* native, napi_value source,ImagePacker_Opts* opts, int fd)

描述

通过一个给定的选项ImagePacker_Opts结构体，将输入JavaScript native层PixelMap对象或者ImageSource对象编码并输出到指定的文件中。

起始版本： 11

参数：

|参数项|描述| |–|–| |ImagePacker_Native* native|表明指向native层ImagePacker的指针。| |napi_value source|表明待编码JavaScript native层PixelMap对象或者ImageSource对象。| |ImagePacker_Opts* opts|表明位图编码的选项。| |int fd|输出的指定文件描述符。|

返回：

|类型|说明| |–|–| |int32_t|IRNdkErrCode：
IMAGE_RESULT_SUCCESS：执行成功。
IMAGE_RESULT_INVALID_PARAMETER：参数无效。
ERR_IMAGE_DATA_ABNORMAL：输出缓冲区异常。
ERR_IMAGE_MISMATCHED_FORMAT：格式不匹配。
ERR_IMAGE_MALLOC_ABNORMAL：malloc内部缓冲区错误。
ERR_IMAGE_DECODE_ABNORMAL：init编解码器内部错误。
ERR_IMAGE_ENCODE_FAILED：编码器在编码过程中出现错误。|

参考：

OH_ImagePacker_PackToData

OH_ImagePacker_Release()

int32_t OH_ImagePacker_Release(ImagePacker_Native* native)

描述

释放native层编码器对象ImagePacker_Native。

此API不用于释放JavaScript原生API ImagePacker对象，它用于释放native层对象ImagePacker_Native。

通过调用OH_ImagePacker_InitNative解析。

起始版本： 11

参数：

|参数项|描述| |–|–| |ImagePacker_Native* native|表明native层ImagePacker_Native值的指针。|

返回：

|类型|说明| |–|–| |int32_t|IRNdkErrCode：
IMAGE_RESULT_SUCCESS：执行成功。|

参考：

OH_ImagePacker_InitNative

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Image Kit（图片处理服务）

harmony 鸿蒙Interface (AuxiliaryPicture)

harmony 鸿蒙Interface (Image)

harmony 鸿蒙Interface (ImageCreator)

harmony 鸿蒙Interface (ImagePacker)

harmony 鸿蒙Interface (ImageReceiver)

harmony 鸿蒙Interface (ImageSource)

harmony 鸿蒙Interface (Metadata)

harmony 鸿蒙Interface (Picture)

harmony 鸿蒙Interface (PixelMap)