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关键字 | 描述 |
|---|---|---|
| ImagePacker_Opts_ | ImagePacker_Opts | 定义图像编码选项信息。 |
| ImagePacker_Native_ | 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_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()
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_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：执行成功。 |
参考：
你可能感兴趣的鸿蒙文章
harmony 鸿蒙Interface (AuxiliaryPicture)
harmony 鸿蒙Interface (ImageCreator)
harmony 鸿蒙Interface (ImagePacker)
harmony 鸿蒙Interface (ImageReceiver)
harmony 鸿蒙Interface (ImageSource)