1# Image_NativeModule 2 3 4## 概述 5 6提供图片处理的相关能力，包括图片编解码、从Native层获取图片数据等。 7 8使用该模块的接口，无需通过JS接口导入，可直接使用NDK完成功能开发。 9 10开发者可根据实际的开发需求，参考对应的开发指南及样例： 11 12- [使用Image_NativeModule完成图片解码](../../media/image/image-source-c.md) 13- [使用Image_NativeModule完成多图对象解码](../../media/image/image-source-picture-c.md) 14- [使用Image_NativeModule完成图片接收](../../media/image/image-receiver-c.md) 15- [使用Image_NativeModule完成位图操作](../../media/image/pixelmap-c.md) 16- [使用Image_NativeModule处理图像信息](../../media/image/image-info-c.md) 17- [使用Image_NativeModule完成图片编码](../../media/image/image-packer-c.md) 18- [使用Image_NativeModule完成多图对象编码](../../media/image/image-packer-picture-c.md) 19 20**起始版本：** 12 21 22 23## 汇总 24 25 26### 文件 27 28| 名称 | 描述 | 29| -------- | -------- | 30| [image_common.h](image__common_8h.md) | 声明图像接口使用的公共枚举和结构体。 | 31| [image_native.h](image__native_8h.md) | 声明图像的剪辑矩形、大小和组件数据的接口函数。 | 32| [image_packer_native.h](image__packer__native_8h.md) | 图片编码API。 | 33| [image_receiver_native.h](image__receiver__native_8h.md) | 声明从Native层获取图片数据的方法。 | 34| [image_source_native.h](image__source__native_8h.md) | 图片解码API。 | 35| [picture_native.h](picture__native_8h.md) | 提供获取picture数据和信息的API。 | 36| [pixelmap_native.h](pixelmap__native_8h.md) | 访问Pixelmap的API。 | 37 38 39### 结构体 40 41| 名称 | 描述 | 42| -------- | -------- | 43| struct [Image_Size](_image___size.md) | 图像大小结构体。 | 44| struct [Image_Region](_image___region.md) | 待解码的图像源区域结构体。 | 45| struct [Image_String](_image___string.md) | 字符串结构。 | 46| struct [OH_Pixelmap_HdrStaticMetadata](_o_h___pixelmap___hdr_static_metadata.md) | HDR_STATIC_METADATA关键字对应的静态元数据值。 | 47| struct [OH_Pixelmap_HdrDynamicMetadata](_o_h___pixelmap___hdr_dynamic_metadata.md) | DR_DYNAMIC_METADATA关键字对应的动态元数据值。 | 48| struct [OH_Pixelmap_HdrGainmapMetadata](_o_h___pixelmap___hdr_gainmap_metadata.md) | HDR_GAINMAP_METADATA关键字对应的gainmap相关元数据值，参考ISO 21496-1。 | 49| struct [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) | Pixelmap使用的HDR元数据值，和OH_Pixelmap_HdrMetadataKey关键字相对应。 | 50 51 52### 类型定义 53 54| 名称 | 描述 | 55| -------- | -------- | 56| typedef struct [Image_Size](_image___size.md) [Image_Size](#image_size) | 声明图像大小结构。 | 57| typedef struct [Image_Region](_image___region.md) [Image_Region](#image_region) | 声明要解码的图像源区域结构体类型名称。 | 58| typedef struct [OH_PictureMetadata](#oh_picturemetadata) [OH_PictureMetadata](#oh_picturemetadata) | 声明用于Picture的元数据。 | 59| typedef struct [Image_String](_image___string.md) [Image_String](#image_string) | 声明字符串结构的名称。 | 60| typedef struct [Image_String](_image___string.md) [Image_MimeType](#image_mimetype) | 声明一个图片格式类型的名称。 | 61| typedef struct [OH_ImageNative](#oh_imagenative) [OH_ImageNative](#oh_imagenative) | 为图像接口定义native层图像对象的别名。 | 62| typedef struct [OH_ImagePackerNative](#oh_imagepackernative) [OH_ImagePackerNative](#oh_imagepackernative) | ImagePacker结构体类型，用于执行ImagePacker相关操作。 | 63| typedef struct [OH_PackingOptions](#oh_packingoptions) [OH_PackingOptions](#oh_packingoptions) | 图像编码选项。 | 64| typedef struct [OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) [OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) | 图像序列编码选项。 | 65| typedef struct [OH_ImageReceiverNative](#oh_imagereceivernative) [OH_ImageReceiverNative](#oh_imagereceivernative) | 用于定义OH_ImageReceiverNative数据类型名称。 | 66| typedef struct [OH_ImageReceiverOptions](#oh_imagereceiveroptions) [OH_ImageReceiverOptions](#oh_imagereceiveroptions) | 用于定义OH_ImageReceiverOptions数据类型名称。 | 67| typedef void(\* [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver) | 定义native层图片的回调方法。 | 68| typedef struct [OH_ImageSourceNative](#oh_imagesourcenative) [OH_ImageSourceNative](#oh_imagesourcenative) | ImageSource结构体类型，用于执行ImageSource相关操作。 | 69| typedef struct [OH_ImageSource_Info](#oh_imagesource_info) [OH_ImageSource_Info](#oh_imagesource_info) | 图片源信息结构体 [OH_ImageSourceInfo_Create](#oh_imagesourceinfo_create)。 | 70| typedef struct [OH_DecodingOptions](#oh_decodingoptions) [OH_DecodingOptions](#oh_decodingoptions) | 解码选项参数结构体,被用于[OH_ImageSourceNative_CreatePixelmap](#oh_imagesourcenative_createpixelmap)。 | 71| typedef struct [OH_PictureNative](#oh_picturenative) [OH_PictureNative](#oh_picturenative) | Picture结构体类型，用于执行picture相关操作。 | 72| typedef struct [OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) [OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) | AuxiliaryPicture结构体类型，用于执行AuxiliaryPicture相关操作。 | 73| typedef struct [OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) [OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) | AuxiliaryPictureInfo结构体类型，用于执行AuxiliaryPictureInfo相关操作。 | 74| typedef struct [OH_PixelmapNative](#oh_pixelmapnative) [OH_PixelmapNative](#oh_pixelmapnative) | Pixelmap结构体类型，用于执行Pixelmap相关操作。 | 75| typedef struct [OH_NativeBuffer](#oh_nativebuffer) [OH_NativeBuffer](#oh_nativebuffer) | NativeBuffer结构体类型，用于执行NativeBuffer相关操作。 | 76| typedef struct [OH_NativeColorSpaceManager](#oh_nativecolorspacemanager) [OH_NativeColorSpaceManager](#oh_nativecolorspacemanager) | NativeColorSpaceManager结构体类型，用于执行NativeColorSpaceManager相关操作。 | 77| typedef struct [OH_Pixelmap_HdrStaticMetadata](_o_h___pixelmap___hdr_static_metadata.md) [OH_Pixelmap_HdrStaticMetadata](#oh_pixelmap_hdrstaticmetadata) | HDR_STATIC_METADATA关键字对应的静态元数据值。 | 78| typedef struct [OH_Pixelmap_HdrDynamicMetadata](_o_h___pixelmap___hdr_dynamic_metadata.md) [OH_Pixelmap_HdrDynamicMetadata](#oh_pixelmap_hdrdynamicmetadata) | DR_DYNAMIC_METADATA关键字对应的动态元数据值。 | 79| typedef struct [OH_Pixelmap_HdrGainmapMetadata](_o_h___pixelmap___hdr_gainmap_metadata.md) [OH_Pixelmap_HdrGainmapMetadata](#oh_pixelmap_hdrgainmapmetadata) | HDR_GAINMAP_METADATA关键字对应的gainmap相关元数据值，参考ISO 21496-1。 | 80| typedef struct [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) [OH_Pixelmap_HdrMetadataValue](#oh_pixelmap_hdrmetadatavalue) | Pixelmap使用的HDR元数据值，和OH_Pixelmap_HdrMetadataKey关键字相对应。 | 81| typedef struct [OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) [OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) | 初始化参数结构体。 | 82| typedef struct [OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) [OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) | 图像像素信息结构体。 | 83 84 85### 枚举 86 87| 名称 | 描述 | 88| -------- | -------- | 89| [Image_ErrorCode](#image_errorcode) {<br/>IMAGE_SUCCESS = 0, IMAGE_BAD_PARAMETER = 401, IMAGE_UNSUPPORTED_MIME_TYPE = 7600101, IMAGE_UNKNOWN_MIME_TYPE = 7600102,<br/>IMAGE_TOO_LARGE = 7600103, IMAGE_DMA_NOT_EXIST = 7600173, IMAGE_DMA_OPERATION_FAILED = 7600174, IMAGE_UNSUPPORTED_OPERATION = 7600201,<br/>IMAGE_UNSUPPORTED_METADATA = 7600202, IMAGE_UNSUPPORTED_CONVERSION = 7600203, IMAGE_INVALID_REGION = 7600204, IMAGE_UNSUPPORTED_MEMORY_FORMAT = 7600205,<br/>IMAGE_ALLOC_FAILED = 7600301, IMAGE_COPY_FAILED = 7600302, IMAGE_LOCK_UNLOCK_FAILED = 7600303, IMAGE_UNKNOWN_ERROR = 7600901,<br/>IMAGE_BAD_SOURCE = 7700101,<br/>IMAGE_SOURCE_UNSUPPORTED_MIME_TYPE = 7700102,<br/>IMAGE_SOURCE_TOO_LARGE = 7700103,<br/>IMAGE_SOURCE_UNSUPPORTED_ALLOCATOR_TYPE = 7700201,<br/>IMAGE_SOURCE_UNSUPPORTED_OPTIONS = 7700203, <br/>IMAGE_DECODE_FAILED = 7700301,<br/>IMAGE_SOURCE_ALLOC_FAILED = 7700302,<br/>IMAGE_ENCODE_FAILED = 7800301<br/>} | 错误码。 | 90| [Image_MetadataType](#image_metadatatype) { EXIF_METADATA = 1, FRAGMENT_METADATA = 2 } | 定义元数据类型。 | 91| [IMAGE_PACKER_DYNAMIC_RANGE](#image_packer_dynamic_range) {<br/>IMAGE_PACKER_DYNAMIC_RANGE_AUTO = 0,<br/>IMAGE_PACKER_DYNAMIC_RANGE_SDR = 1 } | 编码指定动态范围。 | 92| [IMAGE_DYNAMIC_RANGE](#image_dynamic_range) {<br/>IMAGE_DYNAMIC_RANGE_AUTO = 0,<br/>IMAGE_DYNAMIC_RANGE_SDR = 1,<br/>IMAGE_DYNAMIC_RANGE_HDR = 2 } | 解码指定期望动态范围。 | 93| [IMAGE_ALLOCATOR_TYPE](#image_allocator_type) {<br/>IMAGE_ALLOCATOR_TYPE_AUTO = 0,<br/>IMAGE_ALLOCATOR_TYPE_DMA = 1,<br/>IMAGE_ALLOCATOR_TYPE_SHARE_MEMORY = 2 } | 用于分配 PixelMap 内存的分配器类型。 | 94| [Image_CropAndScaleStrategy](#image_cropandscalestrategy) {<br/>IMAGE_CROP_AND_SCALE_STRATEGY_SCALE_FIRST = 1,<br/>IMAGE_CROP_AND_SCALE_STRATEGY_CROP_FIRST = 2 } | 在同时指定desiredSize和desiredRegion时执行裁剪和缩放的策略。 | 95| [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) {<br/>AUXILIARY_PICTURE_TYPE_GAINMAP = 1, AUXILIARY_PICTURE_TYPE_DEPTH_MAP = 2, AUXILIARY_PICTURE_TYPE_UNREFOCUS_MAP = 3, AUXILIARY_PICTURE_TYPE_LINEAR_MAP = 4,<br/>AUXILIARY_PICTURE_TYPE_FRAGMENT_MAP = 5<br/>} | 辅助图类型。 | 96| [PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type) {<br/>PIXELMAP_ALPHA_TYPE_UNKNOWN = 0,<br/>PIXELMAP_ALPHA_TYPE_OPAQUE = 1,<br/>PIXELMAP_ALPHA_TYPE_PREMULTIPLIED = 2, <br/>PIXELMAP_ALPHA_TYPE_UNPREMULTIPLIED = 3 } | Pixelmap透明度类型。 | 97| [PIXEL_FORMAT](#pixel_format) {<br/>PIXEL_FORMAT_UNKNOWN = 0, PIXEL_FORMAT_RGB_565 = 2,<br/>PIXEL_FORMAT_RGBA_8888 = 3, PIXEL_FORMAT_BGRA_8888 = 4,<br/>PIXEL_FORMAT_RGB_888 = 5, PIXEL_FORMAT_ALPHA_8 = 6,<br/>PIXEL_FORMAT_RGBA_F16 = 7, PIXEL_FORMAT_NV21 = 8,<br/>PIXEL_FORMAT_NV12 = 9, <br/>PIXEL_FORMAT_RGBA_1010102 = 10, <br/>PIXEL_FORMAT_YCBCR_P010 = 11, <br/>PIXEL_FORMAT_YCRCB_P010 = 12<br/>} | 图片像素格式。 | 98| [OH_PixelmapNative_AntiAliasingLevel](#oh_pixelmapnative_antialiasinglevel) { <br/>OH_PixelmapNative_AntiAliasing_NONE = 0, <br/>OH_PixelmapNative_AntiAliasing_LOW = 1, <br/>OH_PixelmapNative_AntiAliasing_MEDIUM = 2, <br/>OH_PixelmapNative_AntiAliasing_HIGH = 3 <br/>} | Pixelmap缩放时采用的缩放算法。 | 99| [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey) { <br/>HDR_METADATA_TYPE = 0, <br/>HDR_STATIC_METADATA = 1, <br/>HDR_DYNAMIC_METADATA = 2, <br/>HDR_GAINMAP_METADATA = 3 } | Pixelmap使用的HDR相关元数据信息的关键字，用于[OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata)及[OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata)。 | 100| [OH_Pixelmap_HdrMetadataType](#oh_pixelmap_hdrmetadatatype) { <br/>HDR_METADATA_TYPE_NONE = 0, <br/>HDR_METADATA_TYPE_BASE = 1, <br/>HDR_METADATA_TYPE_GAINMAP = 2, <br/>HDR_METADATA_TYPE_ALTERNATE = 3 } | HDR_METADATA_TYPE关键字对应的值。 | 101 102 103### 函数 104 105| 名称 | 描述 | 106| -------- | -------- | 107| [Image_ErrorCode](#image_errorcode) [OH_PictureMetadata_Create](#oh_picturemetadata_create) ([Image_MetadataType](#image_metadatatype) metadataType, [OH_PictureMetadata](#oh_picturemetadata) \*\*metadata) | 创建OH_PictureMetadata指针。 | 108| [Image_ErrorCode](#image_errorcode) [OH_PictureMetadata_GetProperty](#oh_picturemetadata_getproperty) ([OH_PictureMetadata](#oh_picturemetadata) \*metadata, [Image_String](_image___string.md) \*key, [Image_String](_image___string.md) \*value) | 根据key获取Metadata的单条属性。 | 109| [Image_ErrorCode](#image_errorcode) [OH_PictureMetadata_SetProperty](#oh_picturemetadata_setproperty) ([OH_PictureMetadata](#oh_picturemetadata) \*metadata, [Image_String](_image___string.md) \*key, [Image_String](_image___string.md) \*value) | 根据key修改Metadata的单条属性。 | 110| [Image_ErrorCode](#image_errorcode) [OH_PictureMetadata_Release](#oh_picturemetadata_release) ([OH_PictureMetadata](#oh_picturemetadata) \*metadata) | 释放OH_PictureMetadata指针。 | 111| [Image_ErrorCode](#image_errorcode) [OH_PictureMetadata_Clone](#oh_picturemetadata_clone) ([OH_PictureMetadata](#oh_picturemetadata) \*oldMetadata, [OH_PictureMetadata](#oh_picturemetadata) \*\*newMetadata) | 拷贝元数据。 | 112| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetImageSize](#oh_imagenative_getimagesize) ([OH_ImageNative](#oh_imagenative) \*image, [Image_Size](_image___size.md) \*size) | 获取Native [OH_ImageNative](#oh_imagenative) 对象的 [Image_Size](_image___size.md) 信息。 | 113| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetComponentTypes](#oh_imagenative_getcomponenttypes) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t \*\*types, size_t \*typeSize) | 获取Native [OH_ImageNative](#oh_imagenative) 对象的组件列表信息。 | 114| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetByteBuffer](#oh_imagenative_getbytebuffer) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, OH_NativeBuffer \*\*nativeBuffer) | 获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的缓冲区。 | 115| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetBufferSize](#oh_imagenative_getbuffersize) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, size_t \*size) | 获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的缓冲区的大小。 | 116| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetRowStride](#oh_imagenative_getrowstride) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, int32_t \*rowStride) | 获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的像素行宽。 | 117| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetPixelStride](#oh_imagenative_getpixelstride) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, int32_t \*pixelStride) | 获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的像素大小。 | 118| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetTimestamp](#oh_imagenative_gettimestamp) ([OH_ImageNative](#oh_imagenative) \*image, int64_t \*timestamp) | 获取Native [OH_ImageNative](#oh_imagenative) 对象中的时间戳信息。 | 119| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_Release](#oh_imagenative_release) ([OH_ImageNative](#oh_imagenative) \*image) | 释放native [OH_ImageNative](#oh_imagenative) 对象。 | 120| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_Create](#oh_packingoptions_create) ([OH_PackingOptions](#oh_packingoptions) \*\*options) | 创建PackingOptions结构体的指针。 | 121| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_GetMimeType](#oh_packingoptions_getmimetype) ([OH_PackingOptions](#oh_packingoptions) \*options, [Image_MimeType](#image_mimetype) \*format) | 获取MIME类型。 | 122| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_SetMimeType](#oh_packingoptions_setmimetype) ([OH_PackingOptions](#oh_packingoptions) \*options, [Image_MimeType](#image_mimetype) \*format) | 设置MIME类型。 | 123| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_GetQuality](#oh_packingoptions_getquality) ([OH_PackingOptions](#oh_packingoptions) \*options, uint32_t \*quality) | 获取编码质量。 | 124| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_SetQuality](#oh_packingoptions_setquality) ([OH_PackingOptions](#oh_packingoptions) \*options, uint32_t quality) | 设置编码质量。 | 125| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_GetDesiredDynamicRange](#oh_packingoptions_getdesireddynamicrange) ([OH_PackingOptions](#oh_packingoptions) \*options, int32_t \*desiredDynamicRange) | 获取编码时期望的图片动态范围。 | 126| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_SetDesiredDynamicRange](#oh_packingoptions_setdesireddynamicrange) ([OH_PackingOptions](#oh_packingoptions) \*options, int32_t desiredDynamicRange) | 设置编码时期望的图片动态范围。 | 127| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_Release](#oh_packingoptions_release) ([OH_PackingOptions](#oh_packingoptions) \*options) | 释放OH_PackingOptions指针。 | 128| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_Create](#oh_packingoptionsforsequence_create) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*\*options) | 创建OH_PackingOptionsForSequence结构体的指针。 | 129| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_SetFrameCount](#oh_packingoptionsforsequence_setframecount) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, uint32_t frameCount) | 设置编码时指定的帧数。 | 130| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_GetFrameCount](#oh_packingoptionsforsequence_getframecount) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, uint32_t \*frameCount) | 获取编码时指定的帧数。 | 131| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_SetDelayTimeList](#oh_packingoptionsforsequence_setdelaytimelist) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, int32_t \*delayTimeList, size_t delayTimeListLength) | 设定编码时图片的延迟时间数组。 | 132| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_GetDelayTimeList](#oh_packingoptionsforsequence_getdelaytimelist) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, int32_t \*delayTimeList, size_t delayTimeListLength) | 获取编码时图片的延迟时间数组。 | 133| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_SetDisposalTypes](#oh_packingoptionsforsequence_setdisposaltypes) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, uint32_t \*disposalTypes, size_t disposalTypesLength) | 设定编码时图片的过渡帧模式数组。 | 134| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_GetDisposalTypes](#oh_packingoptionsforsequence_getdisposaltypes) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, uint32_t \*disposalTypes, size_t disposalTypesLength) | 获取编码时图片的过渡帧模式数组。 | 135| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_SetLoopCount](#oh_packingoptionsforsequence_setloopcount) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, uint32_t loopCount) | 设定编码时图片循环播放次数。 | 136| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_GetLoopCount](#oh_packingoptionsforsequence_getloopcount) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, uint32_t \*loopCount) | 获取编码时图片循环播放次数。 | 137| [Image_ErrorCode](#image_errorcode) [OH_PackingOptionsForSequence_Release](#oh_packingoptionsforsequence_release) ([OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options) | 释放OH_PackingOptionsForSequence指针。 | 138| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_Create](#oh_imagepackernative_create) ([OH_ImagePackerNative](#oh_imagepackernative) \*\*imagePacker) | 创建OH_ImagePackerNative指针。 | 139| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToDataFromImageSource](#oh_imagepackernative_packtodatafromimagesource) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptions](#oh_packingoptions) \*options, [OH_ImageSourceNative](#oh_imagesourcenative) \*imageSource, uint8_t \*outData, size_t \*size) | 将ImageSource编码为指定格式的数据。 | 140| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToDataFromPixelmap](#oh_imagepackernative_packtodatafrompixelmap) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptions](#oh_packingoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint8_t \*outData, size_t \*size) | 将Pixelmap编码为指定格式的数据。 | 141| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToDataFromPicture](#oh_imagepackernative_packtodatafrompicture) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptions](#oh_packingoptions) \*options, [OH_PictureNative](#oh_picturenative) \*picture, uint8_t \*outData, size_t \*size) | 将Picture编码为指定格式的数据。 | 142| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToDataFromPixelmapSequence](#oh_imagepackernative_packtodatafrompixelmapsequence) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, [OH_ImagePackerNative](#oh_imagepackernative) \*\*pixelmapSequence, size_t sequenceLength, uint8_t \*outData, size_t \*outDataSize) | 将Pixelmap序列编码为数据。 | 143| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToFileFromImageSource](#oh_imagepackernative_packtofilefromimagesource) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptions](#oh_packingoptions) \*options, [OH_ImageSourceNative](#oh_imagesourcenative) \*imageSource, int32_t fd) | 将一个ImageSource编码到文件中。 | 144| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToFileFromPixelmap](#oh_imagepackernative_packtofilefrompixelmap) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptions](#oh_packingoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, int32_t fd) | 将一个Pixelmap编码到文件中。 | 145| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToFileFromPicture](#oh_imagepackernative_packtofilefrompicture) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptions](#oh_packingoptions) \*options, [OH_PictureNative](#oh_picturenative) \*picture, int32_t fd) | 将一个Picture编码到文件中。 | 146| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_PackToFileFromPixelmapSequence](#oh_imagepackernative_packtofilefrompixelmapsequence) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker, [OH_PackingOptionsForSequence](#oh_packingoptionsforsequence) \*options, [OH_ImagePackerNative](#oh_imagepackernative) \*\*pixelmapSequence, size_t sequenceLength, int32_t fd) | 将一个Pixelmap序列编码到文件中。 | 147| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_Release](#oh_imagepackernative_release) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker) | 释放OH_ImagePackerNative指针。 | 148| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_Create](#oh_imagereceiveroptions_create) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*\*options) | 创建应用层 OH_ImageReceiverOptions 对象。 | 149| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_GetSize](#oh_imagereceiveroptions_getsize) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, [Image_Size](_image___size.md) \*size) | 获取 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的 [Image_Size](_image___size.md) 信息。 | 150| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_SetSize](#oh_imagereceiveroptions_setsize) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, [Image_Size](_image___size.md) size) | 设置 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的 [Image_Size](_image___size.md) 信息。 | 151| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_GetCapacity](#oh_imagereceiveroptions_getcapacity) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, int32_t \*capacity) | 获取 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的图片缓存容量的信息。 | 152| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_SetCapacity](#oh_imagereceiveroptions_setcapacity) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, int32_t capacity) | 设置 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的图片缓存容量的信息。 | 153| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_Release](#oh_imagereceiveroptions_release) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options) | 释放 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象。 | 154| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_Create](#oh_imagereceivernative_create) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, [OH_ImageReceiverNative](#oh_imagereceivernative) \*\*receiver) | 创建应用层 OH_ImageReceiverNative 对象。 | 155| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_GetReceivingSurfaceId](#oh_imagereceivernative_getreceivingsurfaceid) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, uint64_t \*surfaceId) | 通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取receiver的id。 | 156| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_ReadLatestImage](#oh_imagereceivernative_readlatestimage) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [OH_ImageNative](#oh_imagenative) \*\*image) | 通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取最新的一张图片。 | 157| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_ReadNextImage](#oh_imagereceivernative_readnextimage) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [OH_ImageNative](#oh_imagenative) \*\*image) | 通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取下一张图片。 | 158| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_On](#oh_imagereceivernative_on) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) callback) | 注册一个[OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)回调事件。 | 159| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_Off](#oh_imagereceivernative_off) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver) | 关闭[OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)回调事件。 | 160| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_GetSize](#oh_imagereceivernative_getsize) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [Image_Size](_image___size.md) \*size) | 通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取ImageReceiver的大小。 | 161| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_GetCapacity](#oh_imagereceivernative_getcapacity) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, int32_t \*capacity) | 通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取ImageReceiver的容量。 | 162| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_Release](#oh_imagereceivernative_release) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver) | 释放native [OH_ImageReceiverNative](#oh_imagereceivernative) 对象。 | 163| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_Create](#oh_imagesourceinfo_create) ([OH_ImageSource_Info](#oh_imagesource_info) \*\*info) | 创建OH_ImageSource_Info指针。 | 164| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_GetWidth](#oh_imagesourceinfo_getwidth) ([OH_ImageSource_Info](#oh_imagesource_info) \*info, uint32_t \*width) | 获取图片的宽。 | 165| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_GetHeight](#oh_imagesourceinfo_getheight) ([OH_ImageSource_Info](#oh_imagesource_info) \*info, uint32_t \*height) | 获取图片的高。 | 166| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_GetDynamicRange](#oh_imagesourceinfo_getdynamicrange) ([OH_ImageSource_Info](#oh_imagesource_info) \*info, bool \*isHdr) | 获取图片是否为高动态范围的信息。 | 167| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_Release](#oh_imagesourceinfo_release) ([OH_ImageSource_Info](#oh_imagesource_info) \*info) | 释放OH_ImageSource_Info指针。 | 168| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_Create](#oh_decodingoptions_create) ([OH_DecodingOptions](#oh_decodingoptions) \*\*options) | 创建OH_DecodingOptions指针。 | 169| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetPixelFormat](#oh_decodingoptions_getpixelformat) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t \*pixelFormat) | 获取pixel格式。 | 170| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetPixelFormat](#oh_decodingoptions_setpixelformat) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t pixelFormat) | 设置pixel格式。 | 171| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetIndex](#oh_decodingoptions_getindex) ([OH_DecodingOptions](#oh_decodingoptions) \*options, uint32_t \*index) | 获取解码图片序号。 | 172| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetIndex](#oh_decodingoptions_setindex) ([OH_DecodingOptions](#oh_decodingoptions) \*options, uint32_t index) | 设置解码图片序号。 | 173| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetRotate](#oh_decodingoptions_getrotate) ([OH_DecodingOptions](#oh_decodingoptions) \*options, float \*rotate) | 获取旋转角度。 | 174| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetRotate](#oh_decodingoptions_setrotate) ([OH_DecodingOptions](#oh_decodingoptions) \*options, float rotate) | 设置旋转角度。 | 175| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetDesiredSize](#oh_decodingoptions_getdesiredsize) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Size](_image___size.md) \*desiredSize) | 获取期望输出大小。 | 176| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetDesiredSize](#oh_decodingoptions_setdesiredsize) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Size](_image___size.md) \*desiredSize) | 设置期望输出大小。 | 177| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetDesiredRegion](#oh_decodingoptions_getdesiredregion) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Region](_image___region.md) \*desiredRegion) | 获取解码区域。 | 178| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetDesiredRegion](#oh_decodingoptions_setdesiredregion) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Region](_image___region.md) \*desiredRegion) | 设置解码区域。 | 179| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetDesiredDynamicRange](#oh_decodingoptions_getdesireddynamicrange) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t \*desiredDynamicRange) | 获取解码时设置的期望动态范围。 | 180| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetDesiredDynamicRange](#oh_decodingoptions_setdesireddynamicrange) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t desiredDynamicRange) | 设置解码时的期望动态范围。 | 181| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetCropAndScaleStrategy](#oh_decodingoptions_setcropandscalestrategy) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t cropAndScaleStrategy) | 设置解码选项的裁剪和缩放策略。 | 182| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetCropAndScaleStrategy](#oh_decodingoptions_getcropandscalestrategy) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t \*cropAndScaleStrategy) | 获取解码选项的裁剪和缩放策略。 | 183| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_Release](#oh_decodingoptions_release) ([OH_DecodingOptions](#oh_decodingoptions) \*options) | 释放OH_DecodingOptions指针。 | 184| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromUri](#oh_imagesourcenative_createfromuri) (char \*uri, size_t uriSize, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | 通过uri创建OH_ImageSourceNative指针。 | 185| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromFd](#oh_imagesourcenative_createfromfd) (int32_t fd, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | 通过fd创建OH_ImageSourceNative指针。 | 186| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromData](#oh_imagesourcenative_createfromdata) (uint8_t \*data, size_t dataSize, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | 通过缓冲区数据创建OH_ImageSourceNative指针。 | 187| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromRawFile](#oh_imagesourcenative_createfromrawfile) (RawFileDescriptor \*rawFile, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | 通过图像资源文件的RawFileDescriptor创建OH_ImageSourceNative指针。 | 188| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreatePixelmap](#oh_imagesourcenative_createpixelmap) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, [OH_DecodingOptions](#oh_decodingoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*\*pixelmap) | 通过图片解码参数创建OH_PixelmapNative指针。 | 189| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreatePixelmapUsingAllocator](#oh_imagesourcenative_createpixelmapusingallocator) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, [OH_DecodingOptions](#oh_decodingoptions) \*options, [IMAGE_ALLOCATOR_TYPE](#image_allocator_type) allocator, [OH_PixelmapNative](#oh_pixelmapnative) \*\*pixelmap) | 根据解码参数创建一个PixelMap，PixelMap使用的内存类型可以通过allocatorType来指定。<br/>默认情况下，系统会根据图像类型、图像大小、平台能力等选择内存类型。 在处理通过此接口返回的PixelMap时，请始终考虑步幅（stride）的影响。 | 190| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreatePixelmapList](#oh_imagesourcenative_createpixelmaplist) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, [OH_DecodingOptions](#oh_decodingoptions) \*options, OH_PixelmapNative \*resVecPixMap[], size_t size) | 通过图片解码参数创建OH_PixelmapNative数组。 | 191| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreatePicture](#oh_imagesourcenative_createpicture) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, OH_DecodingOptionsForPicture \*options, [OH_PictureNative](#oh_picturenative) \*\*picture) | 通过图片解码创建OH_PictureNative指针。 | 192| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_GetDelayTimeList](#oh_imagesourcenative_getdelaytimelist) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, int32_t \*delayTimeList, size_t size) | 获取图像延迟时间数组。 | 193| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_GetImageInfo](#oh_imagesourcenative_getimageinfo) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, int32_t index, [OH_ImageSource_Info](#oh_imagesource_info) \*info) | 获取指定序号的图片信息。 | 194| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_GetImageProperty](#oh_imagesourcenative_getimageproperty) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, [Image_String](_image___string.md) \*key, [Image_String](_image___string.md) \*value) | 获取图片指定属性键的值。 | 195| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_ModifyImageProperty](#oh_imagesourcenative_modifyimageproperty) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, [Image_String](_image___string.md) \*key, [Image_String](_image___string.md) \*value) | 通过指定的键修改图片属性的值。 | 196| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, uint32_t \*frameCount) | 获取图像帧数。 | 197| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_Release](#oh_imagesourcenative_release) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source) | 释放OH_ImageSourceNative指针。 | 198| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptionsForPicture_Create](#oh_decodingoptionsforpicture_create) (OH_DecodingOptionsForPicture \*\*options) | 创建OH_DecodingOptionsForPicture指针。 | 199| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptionsForPicture_GetDesiredAuxiliaryPictures](#oh_decodingoptionsforpicture_getdesiredauxiliarypictures) (OH_DecodingOptionsForPicture \*options, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) \*\*desiredAuxiliaryPictures, size_t \*length) | 获取解码时设置的期望辅助图（期望解码出的picture包含的辅助图）。 | 200| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptionsForPicture_SetDesiredAuxiliaryPictures](#oh_decodingoptionsforpicture_setdesiredauxiliarypictures) (OH_DecodingOptionsForPicture \*options, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) \*desiredAuxiliaryPictures, size_t length) | 设置解码选项中的期望辅助图。 | 201| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptionsForPicture_Release](#oh_decodingoptionsforpicture_release) (OH_DecodingOptionsForPicture \*options) | 释放OH_DecodingOptionsForPicture指针。 | 202| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_CreatePicture](#oh_picturenative_createpicture) (OH_PixelmapNative \*mainPixelmap, [OH_PictureNative](#oh_picturenative) \*\*picture) | 创建OH_PictureNative指针。 | 203| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_GetMainPixelmap](#oh_picturenative_getmainpixelmap) ([OH_PictureNative](#oh_picturenative) \*picture, OH_PixelmapNative \*\*mainPixelmap) | 获取主图的OH_PixelmapNative指针。 | 204| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_GetHdrComposedPixelmap](#oh_picturenative_gethdrcomposedpixelmap) ([OH_PictureNative](#oh_picturenative) \*picture, OH_PixelmapNative \*\*hdrPixelmap) | 获取hdr图的OH_PixelmapNative指针。 | 205| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_GetGainmapPixelmap](#oh_picturenative_getgainmappixelmap) ([OH_PictureNative](#oh_picturenative) \*picture, OH_PixelmapNative \*\*gainmapPixelmap) | 获取增益图的OH_PixelmapNative指针。 | 206| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_SetAuxiliaryPicture](#oh_picturenative_setauxiliarypicture) ([OH_PictureNative](#oh_picturenative) \*picture, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) type, [OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture) | 设置辅助图。 | 207| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_GetAuxiliaryPicture](#oh_picturenative_getauxiliarypicture) ([OH_PictureNative](#oh_picturenative) \*picture, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) type, [OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*\*auxiliaryPicture) | 根据类型获取辅助图。 | 208| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_GetMetadata](#oh_picturenative_getmetadata) ([OH_PictureNative](#oh_picturenative) \*picture, [Image_MetadataType](#image_metadatatype) metadataType, [OH_PictureMetadata](#oh_picturemetadata) \*\*metadata) | 获取主图的元数据。 | 209| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_SetMetadata](#oh_picturenative_setmetadata) ([OH_PictureNative](#oh_picturenative) \*picture, [Image_MetadataType](#image_metadatatype) metadataType, [OH_PictureMetadata](#oh_picturemetadata) \*metadata) | 设置主图的元数据。 | 210| [Image_ErrorCode](#image_errorcode) [OH_PictureNative_Release](#oh_picturenative_release) ([OH_PictureNative](#oh_picturenative) \*picture) | 释放OH_PictureNative指针。 | 211| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_Create](#oh_auxiliarypicturenative_create) (uint8_t \*data, size_t dataLength, [Image_Size](_image___size.md) \*size, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) type, [OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*\*auxiliaryPicture) | 创建OH_AuxiliaryPictureNative指针。 | 212| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_WritePixels](#oh_auxiliarypicturenative_writepixels) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, uint8_t \*source, size_t bufferSize) | 读取缓冲区的图像像素数据，并将结果写入为辅助图中。 | 213| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_ReadPixels](#oh_auxiliarypicturenative_readpixels) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, uint8_t \*destination, size_t \*bufferSize) | 读取辅助图的像素数据，结果写入缓冲区。 | 214| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_GetType](#oh_auxiliarypicturenative_gettype) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) \*type) | 获取辅助图类型。 | 215| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_GetInfo](#oh_auxiliarypicturenative_getinfo) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, [OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*\*info) | 获取辅助图信息。 | 216| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_SetInfo](#oh_auxiliarypicturenative_setinfo) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, [OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info) | 设置辅助图信息。 | 217| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_GetMetadata](#oh_auxiliarypicturenative_getmetadata) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, [Image_MetadataType](#image_metadatatype) metadataType, [OH_PictureMetadata](#oh_picturemetadata) \*\*metadata) | 获取辅助图的元数据。 | 218| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_SetMetadata](#oh_auxiliarypicturenative_setmetadata) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*auxiliaryPicture, [Image_MetadataType](#image_metadatatype) metadataType, [OH_PictureMetadata](#oh_picturemetadata) \*metadata) | 设置辅助图的元数据。 | 219| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureNative_Release](#oh_auxiliarypicturenative_release) ([OH_AuxiliaryPictureNative](#oh_auxiliarypicturenative) \*picture) | 释放OH_AuxiliaryPictureNative指针。 | 220| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_Create](#oh_auxiliarypictureinfo_create) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*\*info) | 创建一个OH_AuxiliaryPictureInfo对象。 | 221| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_GetType](#oh_auxiliarypictureinfo_gettype) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) \*type) | 获取辅助图的图片信息的辅助图类型。 | 222| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_SetType](#oh_auxiliarypictureinfo_settype) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, [Image_AuxiliaryPictureType](#image_auxiliarypicturetype) type) | 设置辅助图的图片信息的辅助图类型。 | 223| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_GetSize](#oh_auxiliarypictureinfo_getsize) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, [Image_Size](_image___size.md) \*size) | 获取辅助图的图片尺寸。 | 224| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_SetSize](#oh_auxiliarypictureinfo_setsize) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, [Image_Size](_image___size.md) \*size) | 设置辅助图的图片尺寸。 | 225| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_GetRowStride](#oh_auxiliarypictureinfo_getrowstride) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, uint32_t \*rowStride) | 获取辅助图的图片信息的行跨距。 | 226| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_SetRowStride](#oh_auxiliarypictureinfo_setrowstride) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, uint32_t rowStride) | 设置辅助图的图片信息的行跨距。 | 227| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_GetPixelFormat](#oh_auxiliarypictureinfo_getpixelformat) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, PIXEL_FORMAT \*pixelFormat) | 获取辅助图的图片信息的像素格式。 | 228| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_SetPixelFormat](#oh_auxiliarypictureinfo_setpixelformat) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info, PIXEL_FORMAT pixelFormat) | 设置辅助图的图片信息的像素格式。 | 229| [Image_ErrorCode](#image_errorcode) [OH_AuxiliaryPictureInfo_Release](#oh_auxiliarypictureinfo_release) ([OH_AuxiliaryPictureInfo](#oh_auxiliarypictureinfo) \*info) | 释放OH_AuxiliaryPictureInfo指针。 | 230| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_Create](#oh_pixelmapinitializationoptions_create) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*\*options) | 创建OH_Pixelmap_InitializationOptions指针。 | 231| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetWidth](#oh_pixelmapinitializationoptions_getwidth) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t \*width) | 获取图片宽。 | 232| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetWidth](#oh_pixelmapinitializationoptions_setwidth) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t width) | 设置图片宽。 | 233| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetHeight](#oh_pixelmapinitializationoptions_getheight) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t \*height) | 获取图片高。 | 234| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetHeight](#oh_pixelmapinitializationoptions_setheight) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t height) | 设置图片高。 | 235| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetPixelFormat](#oh_pixelmapinitializationoptions_getpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*pixelFormat) | 获取像素格式。 | 236| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetPixelFormat](#oh_pixelmapinitializationoptions_setpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t pixelFormat) | 设置像素格式。 | 237| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetSrcPixelFormat](#oh_pixelmapinitializationoptions_getsrcpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*srcpixelFormat) | 获取源像素格式。 | 238| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetSrcPixelFormat](#oh_pixelmapinitializationoptions_setsrcpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t srcpixelFormat) | 设置源像素格式。 | 239| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetRowStride](#oh_pixelmapinitializationoptions_getrowstride) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*rowStride) | 获取行跨距。 | 240| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetRowStride](#oh_pixelmapinitializationoptions_setrowstride) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t rowStride) | 设置图像跨距。 | 241| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetAlphaType](#oh_pixelmapinitializationoptions_getalphatype) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*alphaType) | 获取透明度类型。 | 242| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetAlphaType](#oh_pixelmapinitializationoptions_setalphatype) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t alphaType) | 设置透明度类型。 | 243| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetEditable](#oh_pixelmapinitializationoptions_geteditable) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, bool \*editable) | 获取可编辑标志。 | 244| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetEditable](#oh_pixelmapinitializationoptions_seteditable) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, bool editable) | 设置可编辑标志。 | 245| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_Release](#oh_pixelmapinitializationoptions_release) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options) | 释放OH_Pixelmap_InitializationOptions指针。 | 246| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_Create](#oh_pixelmapimageinfo_create) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*\*info) | 创建OH_Pixelmap_ImageInfo指针。 | 247| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetWidth](#oh_pixelmapimageinfo_getwidth) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, uint32_t \*width) | 获取图片宽。 | 248| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetHeight](#oh_pixelmapimageinfo_getheight) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, uint32_t \*height) | 获取图片高。 | 249| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetRowStride](#oh_pixelmapimageinfo_getrowstride) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, uint32_t \*rowStride) | 获取行跨距。 | 250| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetPixelFormat](#oh_pixelmapimageinfo_getpixelformat) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, int32_t \*pixelFormat) | 获取像素格式。 | 251| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetAlphaType](#oh_pixelmapimageinfo_getalphatype) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, int32_t \*alphaType) | 获取透明度类型。 | 252| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetDynamicRange](#oh_pixelmapimageinfo_getdynamicrange) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, bool \*isHdr) | 获取Pixelmap是否为高动态范围的信息。 | 253| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_Release](#oh_pixelmapimageinfo_release) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info) | 释放OH_Pixelmap_ImageInfo指针。 | 254| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_CreatePixelmap](#oh_pixelmapnative_createpixelmap) (uint8_t \*data, size_t dataLength, [OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*\*pixelmap) | 通过属性创建PixelMap，默认采用BGRA_8888格式处理数据。 | 255| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ConvertPixelmapNativeToNapi](#oh_pixelmapnative_convertpixelmapnativetonapi) (napi_env env, [OH_PixelmapNative](#oh_pixelmapnative) \*pixelmapNative, napi_value \*pixelmapNapi) | 将nativePixelMap对象转换为PixelMapnapi对象。 | 256| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ConvertPixelmapNativeFromNapi](#oh_pixelmapnative_convertpixelmapnativefromnapi) (napi_env env, napi_value pixelmapNapi, [OH_PixelmapNative](#oh_pixelmapnative) \*\*pixelmapNative) | 将PixelMapnapi对象转换为nativePixelMap对象。 | 257| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ReadPixels](#oh_pixelmapnative_readpixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint8_t \*destination, size_t \*bufferSize) | 读取图像像素数据，结果写入ArrayBuffer里。 | 258| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_WritePixels](#oh_pixelmapnative_writepixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint8_t \*source, size_t bufferSize) | 读取缓冲区中的图片数据，结果写入PixelMap中。 | 259| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetArgbPixels](#oh_pixelmapnative_getargbpixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint8_t \*destination, size_t \*bufferSize) | 从PixelMap中读取ARGB格式的数据。 | 260| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ToSdr](#oh_pixelmapnative_tosdr) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap) | 将HDR的图像内容转换为SDR的图像内容。 | 261| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetImageInfo](#oh_pixelmapnative_getimageinfo) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*imageInfo) | 获取图像像素信息。 | 262| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Opacity](#oh_pixelmapnative_opacity) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float rate) | 通过设置透明比率来让PixelMap达到对应的透明效果。 | 263| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Scale](#oh_pixelmapnative_scale) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float scaleX, float scaleY) | 根据输入的宽高对图片进行缩放。 | 264| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ScaleWithAntiAliasing](#oh_pixelmapnative_scalewithantialiasing) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float scaleX, float scaleY, [OH_PixelmapNative_AntiAliasingLevel](#oh_pixelmapnative_antialiasinglevel) level) | 根据指定的缩放算法和输入的宽高对图片进行缩放。 | 265| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_CreateScaledPixelMap](#oh_pixelmapnative_createscaledpixelmap) ([OH_PixelmapNative](#oh_pixelmapnative) \*srcPixelmap, [OH_PixelmapNative](#oh_pixelmapnative) \*\*dstPixelmap, float scaleX, float scaleY) | 根据输入的宽高的缩放比例，创建一个新的缩放后的图片。 | 266| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_CreateScaledPixelMapWithAntiAliasing](#oh_pixelmapnative_createscaledpixelmapwithantialiasing) ([OH_PixelmapNative](#oh_pixelmapnative) \*srcPixelmap, [OH_PixelmapNative](#oh_pixelmapnative) \*\*dstPixelmap, float scaleX, float scaleY, [OH_PixelmapNative_AntiAliasingLevel](#oh_pixelmapnative_antialiasinglevel) level) | 根据指定的缩放算法和输入的宽高的缩放比例，创建一个新的缩放后的图片。 | 267| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Translate](#oh_pixelmapnative_translate) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float x, float y) | 根据输入的坐标对图片进行位置变换。 | 268| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Rotate](#oh_pixelmapnative_rotate) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float angle) | 根据输入的角度对图片进行旋转。 | 269| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Flip](#oh_pixelmapnative_flip) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, bool shouldFilpHorizontally, bool shouldFilpVertically) | 根据输入的条件对图片进行翻转。 | 270| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Crop](#oh_pixelmapnative_crop) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [Image_Region](_image___region.md) \*region) | 根据输入的尺寸对图片进行裁剪 | 271| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Release](#oh_pixelmapnative_release) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap) | 释放OH_PixelmapNative指针，推荐使用 [OH_PixelmapNative_Destroy](#oh_pixelmapnative_destroy)。 | 272| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Destroy](#oh_pixelmapnative_destroy) (OH_PixelmapNative \*\*pixelmap) | 释放OH_PixelmapNative指针。 | 273| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ConvertAlphaFormat](#oh_pixelmapnative_convertalphaformat) ([OH_PixelmapNative](#oh_pixelmapnative) \*srcpixelmap, [OH_PixelmapNative](#oh_pixelmapnative) \*dstpixelmap, const bool isPremul) | 将pixelmap的像素数据做预乘和非预乘之间的转换。 | 274| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_CreateEmptyPixelmap](#oh_pixelmapnative_createemptypixelmap) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*\*pixelmap) | 利用OH_Pixelmap_InitializationOptions创建空的pixelmap对象，内存数据为0。 | 275| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetNativeBuffer](#oh_pixelmapnative_getnativebuffer) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, OH_NativeBuffer \*\*nativeBuffer) | 从DMA内存的PixelMap中，获取NativeBuffer对象。 | 276| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey) key, [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) \*\*value) | 获取元数据。 | 277| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey) key, [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) \*value) | 设置元数据。 | 278| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_SetColorSpaceNative](#oh_pixelmapnative_setcolorspacenative) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_NativeColorSpaceManager](#oh_nativecolorspacemanager) \*colorSpaceNative) | 设置NativeColorSpaceManager对象。 | 279| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetColorSpaceNative](#oh_pixelmapnative_getcolorspacenative) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_NativeColorSpaceManager](#oh_nativecolorspacemanager) \*\*colorSpaceNative) | 获取NativeColorSpaceManager对象。 | 280| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_SetMemoryName](#oh_pixelmapnative_setmemoryname) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, char \*name, size_t \*size) | 设置pixelMap内存名字。 | 281| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetByteCount](#oh_pixelmapnative_getbytecount) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint32_t \*byteCount) | 获取Pixelmap中所有像素所占用的总字节数，不包含内存填充。 | 282| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetAllocationByteCount](#oh_pixelmapnative_getallocationbytecount) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint32_t \*allocationByteCount) | 获取Pixelmap用于储存像素数据的内存字节数。 | 283| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_AccessPixels](#oh_pixelmapnative_accesspixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, void \*\*addr) | 获取Pixelmap像素数据的内存地址，并锁定这块内存。<br/>当该内存被锁定时，任何修改或释放该Pixelmap的像素数据的操作均会失败或无效。 | 284| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_UnaccessPixels](#oh_pixelmapnative_unaccesspixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap) | 释放Pixelmap像素数据的内存锁。<br/>该函数需要与[OH_PixelmapNative_AccessPixels](#oh_pixelmapnative_accesspixels)匹配使用。 | 285 286 287### 变量 288 289| 名称 | 描述 | 290| -------- | -------- | 291| static const char \*[MIME_TYPE_BMP](#mime_type_bmp) = "image/bmp" | bmp图片格式。 | 292| static const char \*[MIME_TYPE_JPEG](#mime_type_jpeg) = "image/jpeg" | jpeg图片格式。 | 293| static const char \*[MIME_TYPE_HEIC](#mime_type_heic) = "image/heic" | heic图片格式。 | 294| static const char \*[MIME_TYPE_PNG](#mime_type_png) = "image/png" | png图片格式。 | 295| static const char \*[MIME_TYPE_WEBP](#mime_type_webp) = "image/webp" | webp图片格式。 | 296| static const char \*[MIME_TYPE_GIF](#mime_type_gif) = "image/gif" | gif图片格式。 | 297| static const char \*[MIME_TYPE_ICON](#mime_type_icon) = "image/x-icon" | ico图片格式。 | 298| static const char \*[OHOS_IMAGE_PROPERTY_BITS_PER_SAMPLE](#ohos_image_property_bits_per_sample) = "BitsPerSample" | 每个像素比特数。 | 299| static const char \*[OHOS_IMAGE_PROPERTY_ORIENTATION](#ohos_image_property_orientation) = "Orientation" | 图片方向。 | 300| static const char \*[OHOS_IMAGE_PROPERTY_IMAGE_LENGTH](#ohos_image_property_image_length) = "ImageLength" | 图片长度。 | 301| static const char \*[OHOS_IMAGE_PROPERTY_IMAGE_WIDTH](#ohos_image_property_image_width) = "ImageWidth" | 图片宽度。 | 302| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LATITUDE](#ohos_image_property_gps_latitude) = "GPSLatitude" | 图片纬度。 | 303| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LONGITUDE](#ohos_image_property_gps_longitude) = "GPSLongitude" | 图片经度。 | 304| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LATITUDE_REF](#ohos_image_property_gps_latitude_ref) = "GPSLatitudeRef" | 纬度引用，例如N或S。 | 305| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LONGITUDE_REF](#ohos_image_property_gps_longitude_ref) = "GPSLongitudeRef" | 经度引用，例如W或E。 | 306| static const char \*[OHOS_IMAGE_PROPERTY_DATE_TIME_ORIGINAL](#ohos_image_property_date_time_original) = "DateTimeOriginal" | 拍摄时间，例如2022:09:06 15:48:00。 | 307| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_TIME](#ohos_image_property_exposure_time) = "ExposureTime" | 曝光时间，例如1/33 sec。 | 308| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_TYPE](#ohos_image_property_scene_type) = "SceneType" | 拍摄场景模式，例如人像、风光、运动、夜景等。 | 309| static const char \*[OHOS_IMAGE_PROPERTY_ISO_SPEED_RATINGS](#ohos_image_property_iso_speed_ratings) = "ISOSpeedRatings" | ISO感光度，例如400。 | 310| static const char \*[OHOS_IMAGE_PROPERTY_F_NUMBER](#ohos_image_property_f_number) = "FNumber" | 光圈值，例如f/1.8。 | 311| static const char \*[OHOS_IMAGE_PROPERTY_COMPRESSED_BITS_PER_PIXEL](#ohos_image_property_compressed_bits_per_pixel) = "CompressedBitsPerPixel" | 用于压缩图像的压缩模式，单位为每像素位数。 | 312| static const char \*[OHOS_IMAGE_PROPERTY_COMPRESSION](#ohos_image_property_compression) = "Compression" | 图像压缩方案。 | 313| static const char \*[OHOS_IMAGE_PROPERTY_PHOTOMETRIC_INTERPRETATION](#ohos_image_property_photometric_interpretation) = "PhotometricInterpretation" | 像素构成，例如RGB或YCbCr。 | 314| static const char \*[OHOS_IMAGE_PROPERTY_STRIP_OFFSETS](#ohos_image_property_strip_offsets) = "StripOffsets" | 每个strip的字节偏移量。 | 315| static const char \*[OHOS_IMAGE_PROPERTY_SAMPLES_PER_PIXEL](#ohos_image_property_samples_per_pixel) = "SamplesPerPixel" | 每个像素的分量数。由于该标准适用于RGB和YCbCr图像，因此该标签的值设置为3。在JPEG压缩数据中，使用JPEG标记代替该标签。 | 316| static const char \*[OHOS_IMAGE_PROPERTY_ROWS_PER_STRIP](#ohos_image_property_rows_per_strip) = "RowsPerStrip" | 每个strip的图像数据行数。 | 317| static const char \*[OHOS_IMAGE_PROPERTY_STRIP_BYTE_COUNTS](#ohos_image_property_strip_byte_counts) = "StripByteCounts" | 每个图像数据带的总字节数。 | 318| static const char \*[OHOS_IMAGE_PROPERTY_X_RESOLUTION](#ohos_image_property_x_resolution) = "XResolution" | 图像宽度方向的分辨率。 | 319| static const char \*[OHOS_IMAGE_PROPERTY_Y_RESOLUTION](#ohos_image_property_y_resolution) = "YResolution" | 图像高度方向的分辨率。 | 320| static const char \*[OHOS_IMAGE_PROPERTY_PLANAR_CONFIGURATION](#ohos_image_property_planar_configuration) = "PlanarConfiguration" | 表示像素组件的记录格式，chunky格式或是planar格式。 | 321| static const char \*[OHOS_IMAGE_PROPERTY_RESOLUTION_UNIT](#ohos_image_property_resolution_unit) = "ResolutionUnit" | 用于测量XResolution和YResolution的单位。 | 322| static const char \*[OHOS_IMAGE_PROPERTY_TRANSFER_FUNCTION](#ohos_image_property_transfer_function) = "TransferFunction" | 图像的传递函数，通常用于颜色校正。 | 323| static const char \*[OHOS_IMAGE_PROPERTY_SOFTWARE](#ohos_image_property_software) = "Software" | 用于生成图像的软件的名称和版本。 | 324| static const char \*[OHOS_IMAGE_PROPERTY_ARTIST](#ohos_image_property_artist) = "Artist" | 创建图像的用户名称。 | 325| static const char \*[OHOS_IMAGE_PROPERTY_WHITE_POINT](#ohos_image_property_white_point) = "WhitePoint" | 图像的白点色度。 | 326| static const char \*[OHOS_IMAGE_PROPERTY_PRIMARY_CHROMATICITIES](#ohos_image_property_primary_chromaticities) = "PrimaryChromaticities" | 图像的主要颜色的色度。 | 327| static const char \*[OHOS_IMAGE_PROPERTY_YCBCR_COEFFICIENTS](#ohos_image_property_ycbcr_coefficients) = "YCbCrCoefficients" | 从RGB到YCbCr图像数据的转换矩阵系数。 | 328| static const char \*[OHOS_IMAGE_PROPERTY_YCBCR_SUB_SAMPLING](#ohos_image_property_ycbcr_sub_sampling) = "YCbCrSubSampling" | 色度分量与亮度分量的采样比率。 | 329| static const char \*[OHOS_IMAGE_PROPERTY_YCBCR_POSITIONING](#ohos_image_property_ycbcr_positioning) = "YCbCrPositioning" | 色度分量相对于亮度分量的位置。 | 330| static const char \*[OHOS_IMAGE_PROPERTY_REFERENCE_BLACK_WHITE](#ohos_image_property_reference_black_white) = "ReferenceBlackWhite" | 参考黑点值和参考白点值。 | 331| static const char \*[OHOS_IMAGE_PROPERTY_COPYRIGHT](#ohos_image_property_copyright) = "Copyright" | 图像的版权信息。 | 332| static const char \*[OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT](#ohos_image_property_jpeg_interchange_format) = "JPEGInterchangeFormat" | JPEG压缩缩略图数据开始字节（SOI）的偏移。 | 333| static const char \*[OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT_LENGTH](#ohos_image_property_jpeg_interchange_format_length) = "JPEGInterchangeFormatLength" | JPEG压缩缩略图数据的字节数。 | 334| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_PROGRAM](#ohos_image_property_exposure_program) = "ExposureProgram" | 拍照时相机用来设置曝光的程序的类别。 | 335| static const char \*[OHOS_IMAGE_PROPERTY_SPECTRAL_SENSITIVITY](#ohos_image_property_spectral_sensitivity) = "SpectralSensitivity" | 表示所用相机的每个通道的光谱灵敏度。 | 336| static const char \*[OHOS_IMAGE_PROPERTY_OECF](#ohos_image_property_oecf) = "OECF" | 表示ISO 14524中规定的光电转换函数（OECF）。 | 337| static const char \*[OHOS_IMAGE_PROPERTY_EXIF_VERSION](#ohos_image_property_exif_version) = "ExifVersion" | 支持的Exif标准版本。 | 338| static const char \*[OHOS_IMAGE_PROPERTY_DATE_TIME_DIGITIZED](#ohos_image_property_date_time_digitized) = "DateTimeDigitized" | 图像作为数字数据存储的日期和时间，格式为YYYY:MM:DD HH:MM:SS。 | 339| static const char \*[OHOS_IMAGE_PROPERTY_COMPONENTS_CONFIGURATION](#ohos_image_property_components_configuration) = "ComponentsConfiguration" | 压缩数据的特定信息。 | 340| static const char \*[OHOS_IMAGE_PROPERTY_SHUTTER_SPEED_VALUE](#ohos_image_property_shutter_speed_value) = "ShutterSpeedValue" | 快门速度，以APEX（摄影曝光的加法系统）值表示。 | 341| static const char \*[OHOS_IMAGE_PROPERTY_BRIGHTNESS_VALUE](#ohos_image_property_brightness_value) = "BrightnessValue" | 图像的亮度值，以APEX单位表示。 | 342| static const char \*[OHOS_IMAGE_PROPERTY_MAX_APERTURE_VALUE](#ohos_image_property_max_aperture_value) = "MaxApertureValue" | 最小F数镜头。 | 343| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE](#ohos_image_property_subject_distance) = "SubjectDistance" | 测量单位为米的主体距离。 | 344| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_AREA](#ohos_image_property_subject_area) = "SubjectArea" | 该标签指示整个场景中主要主体的位置和区域。 | 345| static const char \*[OHOS_IMAGE_PROPERTY_MAKER_NOTE](#ohos_image_property_maker_note) = "MakerNote" | Exif/DCF制造商使用的标签，用于记录任何所需信息。 | 346| static const char \*[OHOS_IMAGE_PROPERTY_SUBSEC_TIME](#ohos_image_property_subsec_time) = "SubsecTime" | 用于为DateTime标签记录秒的分数的标签。 | 347| static const char \*[OHOS_IMAGE_PROPERTY_SUBSEC_TIME_ORIGINAL](#ohos_image_property_subsec_time_original) = "SubsecTimeOriginal" | 用于为DateTimeOriginal标签记录秒的分数的标签。 | 348| static const char \*[OHOS_IMAGE_PROPERTY_SUBSEC_TIME_DIGITIZED](#ohos_image_property_subsec_time_digitized) = "SubsecTimeDigitized" | 用于为DateTimeDigitized标签记录秒的分数的标签。 | 349| static const char \*[OHOS_IMAGE_PROPERTY_FLASHPIX_VERSION](#ohos_image_property_flashpix_version) = "FlashpixVersion" | 该标签表示FPXR文件支持的Flashpix格式版本，增强了设备兼容性。 | 350| static const char \*[OHOS_IMAGE_PROPERTY_COLOR_SPACE](#ohos_image_property_color_space) = "ColorSpace" | 色彩空间信息标签，通常记录为色彩空间指定符。 | 351| static const char \*[OHOS_IMAGE_PROPERTY_RELATED_SOUND_FILE](#ohos_image_property_related_sound_file) = "RelatedSoundFile" | 与图像数据相关的音频文件的名称。 | 352| static const char \*[OHOS_IMAGE_PROPERTY_FLASH_ENERGY](#ohos_image_property_flash_energy) = "FlashEnergy" | 图像捕获时的闪光能量，以BCPS表示。 | 353| static const char \*[OHOS_IMAGE_PROPERTY_SPATIAL_FREQUENCY_RESPONSE](#ohos_image_property_spatial_frequency_response) = "SpatialFrequencyResponse" | 相机或输入设备的空间频率表。 | 354| static const char \*[OHOS_IMAGE_PROPERTY_FOCAL_PLANE_X_RESOLUTION](#ohos_image_property_focal_plane_x_resolution) = "FocalPlaneXResolution" | 图像宽度中每FocalPlaneResolutionUnit的像素。 | 355| static const char \*[OHOS_IMAGE_PROPERTY_FOCAL_PLANE_Y_RESOLUTION](#ohos_image_property_focal_plane_y_resolution) = "FocalPlaneYResolution" | 图像高度中每FocalPlaneResolutionUnit的像素。 | 356| static const char \*[OHOS_IMAGE_PROPERTY_FOCAL_PLANE_RESOLUTION_UNIT](#ohos_image_property_focal_plane_resolution_unit) = "FocalPlaneResolutionUnit" | 测量FocalPlaneXResolution和FocalPlaneYResolution的单位。 | 357| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_LOCATION](#ohos_image_property_subject_location) = "SubjectLocation" | 主要对象相对于左边缘的位置。 | 358| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_INDEX](#ohos_image_property_exposure_index) = "ExposureIndex" | 捕获时选定的曝光指数。 | 359| static const char \*[OHOS_IMAGE_PROPERTY_SENSING_METHOD](#ohos_image_property_sensing_method) = "SensingMethod" | 相机上的图像传感器类型。 | 360| static const char \*[OHOS_IMAGE_PROPERTY_FILE_SOURCE](#ohos_image_property_file_source) = "FileSource" | 表明图像来源。 | 361| static const char \*[OHOS_IMAGE_PROPERTY_CFA_PATTERN](#ohos_image_property_cfa_pattern) = "CFAPattern" | 图像传感器的色彩滤光片（CFA）几何图案。 | 362| static const char \*[OHOS_IMAGE_PROPERTY_CUSTOM_RENDERED](#ohos_image_property_custom_rendered) = "CustomRendered" | 指示图像数据上的特殊处理。 | 363| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_MODE](#ohos_image_property_exposure_mode) = "ExposureMode" | 拍摄时设置的曝光模式。 | 364| static const char \*[OHOS_IMAGE_PROPERTY_DIGITAL_ZOOM_RATIO](#ohos_image_property_digital_zoom_ratio) = "DigitalZoomRatio" | 捕获时的数字变焦比率。 | 365| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_CAPTURE_TYPE](#ohos_image_property_scene_capture_type) = "SceneCaptureType" | 捕获的场景类型。 | 366| static const char \*[OHOS_IMAGE_PROPERTY_GAIN_CONTROL](#ohos_image_property_gain_control) = "GainControl" | 整体图像增益调整的程度。 | 367| static const char \*[OHOS_IMAGE_PROPERTY_CONTRAST](#ohos_image_property_contrast) = "Contrast" | 相机应用的对比度处理方向。 | 368| static const char \*[OHOS_IMAGE_PROPERTY_SATURATION](#ohos_image_property_saturation) = "Saturation" | 相机应用的饱和度处理方向。 | 369| static const char \*[OHOS_IMAGE_PROPERTY_SHARPNESS](#ohos_image_property_sharpness) = "Sharpness" | 相机应用的锐度处理方向。 | 370| static const char \*[OHOS_IMAGE_PROPERTY_DEVICE_SETTING_DESCRIPTION](#ohos_image_property_device_setting_description) = "DeviceSettingDescription" | 特定相机模型的拍照条件信息。 | 371| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE_RANGE](#ohos_image_property_subject_distance_range) = "SubjectDistanceRange" | 表示主体到相机的距离范围。 | 372| static const char \*[OHOS_IMAGE_PROPERTY_IMAGE_UNIQUE_ID](#ohos_image_property_image_unique_id) = "ImageUniqueID" | 为每张图片唯一分配的标识符。 | 373| static const char \*[OHOS_IMAGE_PROPERTY_GPS_VERSION_ID](#ohos_image_property_gps_version_id) = "GPSVersionID" | GPSInfoIFD的版本。 | 374| static const char \*[OHOS_IMAGE_PROPERTY_GPS_ALTITUDE_REF](#ohos_image_property_gps_altitude_ref) = "GPSAltitudeRef" | 用于GPS高度的参照高度。 | 375| static const char \*[OHOS_IMAGE_PROPERTY_GPS_ALTITUDE](#ohos_image_property_gps_altitude) = "GPSAltitude" | 基于GPSAltitudeRef的高度。 | 376| static const char \*[OHOS_IMAGE_PROPERTY_GPS_SATELLITES](#ohos_image_property_gps_satellites) = "GPSSatellites" | 用于测量的GPS卫星。 | 377| static const char \*[OHOS_IMAGE_PROPERTY_GPS_STATUS](#ohos_image_property_gps_status) = "GPSStatus" | 录制图像时GPS接收器的状态。 | 378| static const char \*[OHOS_IMAGE_PROPERTY_GPS_MEASURE_MODE](#ohos_image_property_gps_measure_mode) = "GPSMeasureMode" | GPS测量模式。 | 379| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DOP](#ohos_image_property_gps_dop) = "GPSDOP" | GPS DOP（数据精度等级）。 | 380| static const char \*[OHOS_IMAGE_PROPERTY_GPS_SPEED_REF](#ohos_image_property_gps_speed_ref) = "GPSSpeedRef" | 用来表示GPS接收器移动速度的单位。 | 381| static const char \*[OHOS_IMAGE_PROPERTY_GPS_SPEED](#ohos_image_property_gps_speed) = "GPSSpeed" | GPS接收器的移动速度。 | 382| static const char \*[OHOS_IMAGE_PROPERTY_GPS_TRACK_REF](#ohos_image_property_gps_track_ref) = "GPSTrackRef" | GPS接收机移动方向的参照。 | 383| static const char \*[OHOS_IMAGE_PROPERTY_GPS_TRACK](#ohos_image_property_gps_track) = "GPSTrack" | GPS接收机的移动方向。 | 384| static const char \*[OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION_REF](#ohos_image_property_gps_img_direction_ref) = "GPSImgDirectionRef" | 图像方向的参照。 | 385| static const char \*[OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION](#ohos_image_property_gps_img_direction) = "GPSImgDirection" | 拍摄时图像的方向。 | 386| static const char \*[OHOS_IMAGE_PROPERTY_GPS_MAP_DATUM](#ohos_image_property_gps_map_datum) = "GPSMapDatum" | GPS接收器使用的大地测量数据。 | 387| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE_REF](#ohos_image_property_gps_dest_latitude_ref) = "GPSDestLatitudeRef" | 目的地点的纬度参照。 | 388| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE](#ohos_image_property_gps_dest_latitude) = "GPSDestLatitude" | 目的地点的纬度。 | 389| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE_REF](#ohos_image_property_gps_dest_longitude_ref) = "GPSDestLongitudeRef" | 目的地点的经度参照。 | 390| static const char \*[OHOS_IMAGE_PROPERTY_GPS_PROCESSING_METHOD](#ohos_image_property_gps_processing_method) = "GPSProcessingMethod" | 记录定位方法名的字符字符串。 | 391| static const char \*[OHOS_IMAGE_PROPERTY_GPS_AREA_INFORMATION](#ohos_image_property_gps_area_information) = "GPSAreaInformation" | 记录GPS区域名的字符字符串。 | 392| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DIFFERENTIAL](#ohos_image_property_gps_differential) = "GPSDifferential" | 此字段表示GPS数据是否应用了差分校正，对于精确的位置准确性至关重要。 | 393| static const char \*[OHOS_IMAGE_PROPERTY_BODY_SERIAL_NUMBER](#ohos_image_property_body_serial_number) = "BodySerialNumber" | 相机机身的序列号。 | 394| static const char \*[OHOS_IMAGE_PROPERTY_CAMERA_OWNER_NAME](#ohos_image_property_camera_owner_name) = "CameraOwnerName" | 相机所有者的姓名。 | 395| static const char \*[OHOS_IMAGE_PROPERTY_COMPOSITE_IMAGE](#ohos_image_property_composite_image) = "CompositeImage" | 表示图像是否为合成图像。 | 396| static const char \*[OHOS_IMAGE_PROPERTY_DNG_VERSION](#ohos_image_property_dng_version) = "DNGVersion" | DNG版本标签编码了符合DNG规范的四级版本号。 | 397| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE](#ohos_image_property_gps_dest_longitude) = "GPSDestLongitude" | 目的地点的经度。 | 398| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING_REF](#ohos_image_property_gps_dest_bearing_ref) = "GPSDestBearingRef" | 指向目的地点的方位参照。 | 399| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING](#ohos_image_property_gps_dest_bearing) = "GPSDestBearing" | 目的地方位。 | 400| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE_REF](#ohos_image_property_gps_dest_distance_ref) = "GPSDestDistanceRef" | 目标点距离的测量单位。 | 401| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE](#ohos_image_property_gps_dest_distance) = "GPSDestDistance" | 到目的地点的距离。 | 402| static const char \*[OHOS_IMAGE_PROPERTY_DEFAULT_CROP_SIZE](#ohos_image_property_default_crop_size) = "DefaultCropSize" | DefaultCropSize指定了原始坐标中的最终图像大小，考虑了额外的边缘像素。 | 403| static const char \*[OHOS_IMAGE_PROPERTY_GAMMA](#ohos_image_property_gamma) = "Gamma" | 表示系数伽马的值。 | 404| static const char \*[OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEYYY](#ohos_image_property_iso_speed_latitudeyyy) = "ISOSpeedLatitudeyyy" | 该标签指示摄像机或输入设备的ISO速度纬度yyy值，该值在ISO 12232中定义。 | 405| static const char \*[OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEZZZ](#ohos_image_property_iso_speed_latitudezzz) = "ISOSpeedLatitudezzz" | 该标签指示摄像机或输入设备的ISO速度纬度zzz值，该值在ISO 12232中定义。 | 406| static const char \*[OHOS_IMAGE_PROPERTY_LENS_MAKE](#ohos_image_property_lens_make) = "LensMake" | 镜头的制造商。 | 407| static const char \*[OHOS_IMAGE_PROPERTY_LENS_MODEL](#ohos_image_property_lens_model) = "LensModel" | 镜头的型号名称。 | 408| static const char \*[OHOS_IMAGE_PROPERTY_LENS_SERIAL_NUMBER](#ohos_image_property_lens_serial_number) = "LensSerialNumber" | 镜头的序列号。 | 409| static const char \*[OHOS_IMAGE_PROPERTY_LENS_SPECIFICATION](#ohos_image_property_lens_specification) = "LensSpecification" | 使用的镜头规格。 | 410| static const char \*[OHOS_IMAGE_PROPERTY_NEW_SUBFILE_TYPE](#ohos_image_property_new_subfile_type) = "NewSubfileType" | 在Exif中，"NewSubfileType"字段用于标识子文件的数据类型，如全分辨率图像、缩略图或多帧图像的一部分。其值是位掩码，0代表全分辨率图像，1代表缩略图，2代表多帧图像的一部分。 | 411| static const char \*[OHOS_IMAGE_PROPERTY_OFFSET_TIME](#ohos_image_property_offset_time) = "OffsetTime" | 在Exif中，OffsetTime字段表示与UTC（协调世界时）的时间偏移，格式为±HH:MM，用于确定照片拍摄的本地时间。 | 412| static const char \*[OHOS_IMAGE_PROPERTY_OFFSET_TIME_DIGITIZED](#ohos_image_property_offset_time_digitized) = "OffsetTimeDigitized" | 此标签记录图像数字化时的UTC偏移量，有助于准确调整时间戳。 | 413| static const char \*[OHOS_IMAGE_PROPERTY_OFFSET_TIME_ORIGINAL](#ohos_image_property_offset_time_original) = "OffsetTimeOriginal" | 此标签记录原始图像创建时的UTC偏移量，对于时间敏感的应用至关重要。 | 414| static const char \*[OHOS_IMAGE_PROPERTY_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE](#ohos_image_property_source_exposure_times_of_composite_image) = "SourceExposureTimesOfCompositeImage" | 合成图像的源图像曝光时间。 | 415| static const char \*[OHOS_IMAGE_PROPERTY_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE](#ohos_image_property_source_image_number_of_composite_image) = "SourceImageNumberOfCompositeImage" | 用于合成图像的源图像数量。 | 416| static const char \*[OHOS_IMAGE_PROPERTY_SUBFILE_TYPE](#ohos_image_property_subfile_type) = "SubfileType" | 此标签指示此子文件中的数据类型。标签已弃用，请使用NewSubfileType替代。 | 417| static const char \*[OHOS_IMAGE_PROPERTY_GPS_H_POSITIONING_ERROR](#ohos_image_property_gps_h_positioning_error) = "GPSHPositioningError" | 此标签指示水平定位误差，单位为米。 | 418| static const char \*[OHOS_IMAGE_PROPERTY_PHOTOGRAPHIC_SENSITIVITY](#ohos_image_property_photographic_sensitivity) = "PhotographicSensitivity" | 此标签指示拍摄图像时相机或输入设备的灵敏度。 | 419| static const char \*[OHOS_IMAGE_PROPERTY_BURST_NUMBER](#ohos_image_property_burst_number) = "HwMnoteBurstNumber" | 连拍次数。 | 420| static const char \*[OHOS_IMAGE_PROPERTY_FACE_CONF](#ohos_image_property_face_conf) = "HwMnoteFaceConf" | 人脸置信度。 | 421| static const char \*[OHOS_IMAGE_PROPERTY_FACE_LEYE_CENTER](#ohos_image_property_face_leye_center) = "HwMnoteFaceLeyeCenter" | 左眼中心。 | 422| static const char \*[OHOS_IMAGE_PROPERTY_FACE_MOUTH_CENTER](#ohos_image_property_face_mouth_center) = "HwMnoteFaceMouthCenter" | 嘴中心。 | 423| static const char \*[OHOS_IMAGE_PROPERTY_FACE_POINTER](#ohos_image_property_face_pointer) = "HwMnoteFacePointer" | 脸部指针。 | 424| static const char \*[OHOS_IMAGE_PROPERTY_FACE_RECT](#ohos_image_property_face_rect) = "HwMnoteFaceRect" | 脸部矩形。 | 425| static const char \*[OHOS_IMAGE_PROPERTY_FACE_REYE_CENTER](#ohos_image_property_face_reye_center) = "HwMnoteFaceReyeCenter" | 右眼中心。 | 426| static const char \*[OHOS_IMAGE_PROPERTY_FACE_SMILE_SCORE](#ohos_image_property_face_smile_score) = "HwMnoteFaceSmileScore" | FaceCount张人脸的笑脸分数。 | 427| static const char \*[OHOS_IMAGE_PROPERTY_FACE_VERSION](#ohos_image_property_face_version) = "HwMnoteFaceVersion" | 人脸算法版本信息。 | 428| static const char \*[OHOS_IMAGE_PROPERTY_FRONT_CAMERA](#ohos_image_property_front_camera) = "HwMnoteFrontCamera" | 是否是前置相机自拍。 | 429| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_POINTER](#ohos_image_property_scene_pointer) = "HwMnoteScenePointer" | 场景指针。 | 430| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_VERSION](#ohos_image_property_scene_version) = "HwMnoteSceneVersion" | 场景算法版本信息。 | 431| static const char \*[OHOS_IMAGE_PROPERTY_GIF_LOOP_COUNT](#ohos_image_property_gif_loop_count) = "GIFLoopCount" | GIF图片循环次数。 | 432| static const char \*[OHOS_IMAGE_PROPERTY_X_IN_ORIGINAL](#ohos_image_property_x_in_original) = "XInOriginal" | 水印裁剪图左上角在原始图中的X坐标。 | 433| static const char \*[OHOS_IMAGE_PROPERTY_Y_IN_ORIGINAL](#ohos_image_property_y_in_original) = "YInOriginal" | 水印裁剪图左上角在原始图中的Y坐标。 | 434| static const char \*[OHOS_IMAGE_PROPERTY_FRAGMENT_WIDTH](#ohos_image_property_fragment_width) = "FragmentImageWidth"| 水印裁剪图的宽。 | 435| static const char \*[OHOS_IMAGE_PROPERTY_FRAGMENT_HEIGHT](#ohos_image_property_fragment_height) = "FragmentImageHeight" | 水印裁剪图的高。 | 436 437 438## 类型定义说明 439 440 441### Image_MimeType 442 443``` 444typedef struct Image_String Image_MimeType 445``` 446**描述** 447声明一个图片格式类型的名称。 448 449**起始版本：** 12 450 451 452### Image_Region 453 454``` 455typedef struct Image_Region Image_Region 456``` 457**描述** 458声明要解码的图像源区域结构体类型名称。 459 460**起始版本：** 12 461 462 463### Image_Size 464 465``` 466typedef struct Image_Size Image_Size 467``` 468**描述** 469声明图像大小结构。 470 471**起始版本：** 12 472 473 474### Image_String 475 476``` 477typedef struct Image_String Image_String 478``` 479**描述** 480声明字符串结构的名称。 481 482**起始版本：** 12 483 484 485### OH_AuxiliaryPictureInfo 486 487``` 488typedef struct OH_AuxiliaryPictureInfo OH_AuxiliaryPictureInfo 489``` 490**描述** 491AuxiliaryPictureInfo结构体类型，用于执行AuxiliaryPictureInfo相关操作。 492 493**起始版本：** 13 494 495 496### OH_AuxiliaryPictureNative 497 498``` 499typedef struct OH_AuxiliaryPictureNative OH_AuxiliaryPictureNative 500``` 501**描述** 502AuxiliaryPicture结构体类型，用于执行AuxiliaryPicture相关操作。 503 504**起始版本：** 13 505 506 507### OH_DecodingOptions 508 509``` 510typedef struct OH_DecodingOptions OH_DecodingOptions 511``` 512**描述** 513OH_DecodingOptions是native层封装的解码选项参数结构体，用于设置解码选项参数，在创建Pixelmap时作为入参传入，详细信息见 [OH_ImageSourceNative_CreatePixelmap](#oh_imagesourcenative_createpixelmap)。 514 515OH_DecodingOptions结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。 516 517创建OH_DecodingOptions对象使用[OH_DecodingOptions_Create](#oh_decodingoptions_create)函数。 518 519释放OH_DecodingOptions对象使用[OH_DecodingOptions_Release](#oh_decodingoptions_release)函数。 520 521OH_DecodingOptions结构体内容和操作方式如下： 522| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 523| -------- | -------- | -------- | -------- | -------- | 524| int32_t | pixelFormat | 像素格式 | [OH_DecodingOptions_GetPixelFormat](#oh_decodingoptions_getpixelformat) |获取pixel格式。| 525| int32_t | pixelFormat | 像素格式 | [OH_DecodingOptions_SetPixelFormat](#oh_decodingoptions_setpixelformat) | 设置像素格式。| 526| uint32_t | index | 解码图片序号 | [OH_DecodingOptions_GetIndex](#oh_decodingoptions_getindex) | 获取解码图片序号。| 527| uint32_t | index | 解码图片序号 | [OH_DecodingOptions_SetIndex](#oh_decodingoptions_setindex) | 设置解码图片序号。| 528| float | rotate | 旋转角度 | [OH_DecodingOptions_GetRotate](#oh_decodingoptions_getrotate) | 获取旋转角度。| 529| float | rotate | 旋转角度 | [OH_DecodingOptions_SetRotate](#oh_decodingoptions_setrotate) | 设置旋转角度。| 530| Image_Size | desiredSize | 期望输出大小 | [OH_DecodingOptions_GetDesiredSize](#oh_decodingoptions_getdesiredsize) | 获取期望输出大小。| 531| Image_Size | desiredSize | 期望输出大小 | [OH_DecodingOptions_SetDesiredSize](#oh_decodingoptions_setdesiredsize) | 设置期望输出大小。| 532| Image_Region | desiredRegion | 解码区域 | [OH_DecodingOptions_GetDesiredRegion](#oh_decodingoptions_getdesiredregion) | 获取解码区域。| 533| Image_Region | desiredRegion | 解码区域 | [OH_DecodingOptions_SetDesiredRegion](#oh_decodingoptions_setdesiredregion) | 设置解码区域。| 534| int32_t | desiredDynamicRange | 期望动态范围 | [OH_DecodingOptions_GetDesiredDynamicRange](#oh_decodingoptions_getdesireddynamicrange) |获取解码时设置的期望动态范围。| 535| int32_t | desiredDynamicRange | 期望动态范围 | [OH_DecodingOptions_SetDesiredDynamicRange](#oh_decodingoptions_setdesireddynamicrange)|设置解码时的期望动态范围。| 536 537**起始版本：** 12 538 539 540### OH_ImageNative 541 542``` 543typedef struct OH_ImageNative OH_ImageNative 544``` 545**描述** 546为图像接口定义native层图像对象的别名。 547 548此结构体内容不可直接操作，采用函数调用方式操作具体字段，结构体内容和操作方式如下： 549 550| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 551| -------- | -------- | -------- | -------- | -------- | 552| Image_Size| imageSize | 图像大小 |[OH_ImageNative_GetImageSize](#oh_imagenative_getimagesize) | 获取 OH_ImageNative 对象的 Image_Size 信息。| 553| uint32_t | types |组件类型，用于描述图像颜色分量。 |[OH_ImageNative_GetComponentTypes](#oh_imagenative_getcomponenttypes) | 获取 OH_ImageNative 对象的组件列表信息。 | 554| OH_NativeBuffer | nativeBuffer | 组件缓冲区|[OH_ImageNative_GetByteBuffer](#oh_imagenative_getbytebuffer) | 获取 OH_ImageNative 对象中某个组件类型所对应的缓冲区。| 555| size_t | bufferSize | 缓冲区的大小 | [OH_ImageNative_GetBufferSize](#oh_imagenative_getbuffersize) | 获取 OH_ImageNative 对象中某个组件类型所对应的缓冲区的大小。| 556| int32_t | rowStride | 像素行宽 | [OH_ImageNative_GetRowStride](#oh_imagenative_getrowstride) | 获取 OH_ImageNative 对象中某个组件类型所对应的像素行宽。 | 557| int32_t | pixelStride | 像素大小 | [OH_ImageNative_GetPixelStride](#oh_imagenative_getpixelstride) | 获取 OH_ImageNative 对象中某个组件类型所对应的像素大小。 | 558 559释放OH_ImageNative对象使用[OH_ImageNative_Release](#oh_imagenative_release)函数。 560 561**起始版本：** 12 562 563 564### OH_ImagePackerNative 565 566``` 567typedef struct OH_ImagePackerNative OH_ImagePackerNative 568``` 569**描述** 570ImagePacker结构体类型，用于执行ImagePacker相关操作。 571 572此结构体内容不可直接操作，采用函数调用方式操作具体字段，结构体内容和操作方式如下： 573 574| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 575| -------- | -------- | -------- | -------- | -------- | 576| OH_ImageSourceNative | imageSource | 图片源 | [OH_ImagePackerNative_PackToDataFromImageSource](#oh_imagepackernative_packtodatafromimagesource) | 将ImageSource编码为指定格式的数据。 | 577|OH_PixelmapNative | pixelmap | native层的pixelmap | [OH_ImagePackerNative_PackToDataFromPixelmap](#oh_imagepackernative_packtodatafrompixelmap) | 将Pixelmap编码为指定格式的数据。| 578|int32_t | imagesourceFd | imagesource关联的文件描述符 | [OH_ImagePackerNative_PackToFileFromImageSource](#oh_imagepackernative_packtofilefromimagesource) | 将一个ImageSource编码到文件中。| 579|int32_t | pixelmapFd | pixelmap关联的文件描述符| [OH_ImagePackerNative_PackToFileFromPixelmap](#oh_imagepackernative_packtofilefrompixelmap) | 将一个Pixelmap编码到文件中。| 580 581创建OH_ImagePackerNative对象使用[OH_ImagePackerNative_Create](#oh_imagepackernative_create)函数。 582 583释放OH_ImagePackerNative对象使用[OH_ImagePackerNative_Release](#oh_imagepackernative_release)函数。 584 585**起始版本：** 12 586 587 588### OH_ImageReceiver_OnCallback 589 590``` 591typedef void(* OH_ImageReceiver_OnCallback) (OH_ImageReceiverNative *receiver) 592``` 593**描述** 594定义native层图片的回调方法。 595 596**起始版本：** 12 597 598 599### OH_ImageReceiverNative 600 601``` 602typedef struct OH_ImageReceiverNative OH_ImageReceiverNative 603``` 604**描述** 605OH_ImageReceiverNative是native层封装的图片接收器结构体，OH_ImageReceiverNative结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。 606 607创建OH_ImageReceiverNative对象使用[OH_ImageReceiverNative_Create](#oh_imagereceivernative_create)函数。 608 609释放OH_ImageReceiverNative对象使用[OH_ImageReceiverNative_Release](#oh_imagereceivernative_release)函数。 610 611OH_ImageReceiverNative结构体内容和操作方式如下： 612| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 613| -------- | -------- | -------- | -------- | -------- | 614| uint64_t | surfaceId | 接收器的surfaceId | [OH_ImageReceiverNative_GetReceivingSurfaceId](#oh_imagereceivernative_getreceivingsurfaceid) |通过OH_ImageReceiverNative获取receiver的id。| 615| OH_ImageNative | image | native层的image | [OH_ImageReceiverNative_ReadLatestImage](#oh_imagereceivernative_readlatestimage) | 通过OH_ImageReceiverNative获取最新的一张图片。| 616| OH_ImageNative | image | native层的image | [OH_ImageReceiverNative_ReadNextImage](#oh_imagereceivernative_readnextimage) |通过OH_ImageReceiverNative获取下一张图片。| 617| OH_ImageReceiver_OnCallback | callback| 图片接收器回调函数 | [OH_ImageReceiverNative_On](#oh_imagereceivernative_on) |注册一个OH_ImageReceiver_OnCallback回调事件。| 618| OH_ImageReceiver_OnCallback | callback| 图片接收器回调函数 | [OH_ImageReceiverNative_Off](#oh_imagereceivernative_off) |关闭OH_ImageReceiver_OnCallback回调事件。| 619| Image_Size | size | ImageReceiver的大小 | [OH_ImageReceiverNative_GetSize](#oh_imagereceivernative_getsize) |通过OH_ImageReceiverNative获取ImageReceiver的大小。| 620|int32_t | capacity| 图片接收器容量 | [OH_ImageReceiverNative_GetCapacity](#oh_imagereceivernative_getcapacity) |通过OH_ImageReceiverNative获取ImageReceiver的容量。| 621 622**起始版本：** 12 623 624 625### OH_ImageReceiverOptions 626 627``` 628typedef struct OH_ImageReceiverOptionsOH_ImageReceiverOptions 629``` 630**描述** 631用于定义OH_ImageReceiverOptions数据类型名称。 632 633OH_ImageReceiverOptions是native层封装的图片接收器选项设置器结构体，用于创建OH_ImageReceiverNative时传入设置参数。 634OH_ImageReceiverOptions结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。 635 636创建OH_ImageReceiverOptions对象使用[OH_ImageReceiverOptions_Create](../../reference/apis-image-kit/_image___native_module.md#oh_imagereceiveroptions_create)函数。 637 638释放OH_ImageReceiverOptions对象使用[OH_ImageReceiverOptions_Release](../../reference/apis-image-kit/_image___native_module.md#oh_imagereceiveroptions_release)函数。 639 640OH_ImageReceiverOptions结构体内容和操作方式如下： 641| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 642| -------- | -------- | -------- | -------- | -------- | 643| Image_Size | size | 图像大小 | [OH_ImageReceiverOptions_GetSize](../../reference/apis-image-kit/_image___native_module.md#oh_imagereceiveroptions_getsize) |获取 OH_ImageReceiverOptions 对象的 Image_Size 信息。| 644| Image_Size | size | 图像大小 | [OH_ImageReceiverOptions_SetSize](../../reference/apis-image-kit/_image___native_module.md#oh_imagereceiveroptions_setsize) |设置 OH_ImageReceiverOptions 对象的 Image_Size 信息。| 645| int32_t | capacity | 图片缓存容量 | [OH_ImageReceiverOptions_GetCapacity](../../reference/apis-image-kit/_image___native_module.md#oh_imagereceiveroptions_getcapacity) |获取 OH_ImageReceiverOptions 对象的图片缓存容量的信息。| 646| int32_t | capacity | 图片缓存容量 | [OH_ImageReceiverOptions_SetCapacity](../../reference/apis-image-kit/_image___native_module.md#oh_imagereceiveroptions_setcapacity) |设置 OH_ImageReceiverOptions 对象的图片缓存容量的信息。| 647 648**起始版本：** 12 649 650 651### OH_ImageSource_Info 652 653``` 654typedef struct OH_ImageSource_Info OH_ImageSource_Info 655``` 656**描述** 657OH_ImageSource_Info是native层封装的ImageSource信息结构体，OH_ImageSource_Info结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。 658 659创建OH_ImageSource_Info对象使用[OH_ImageSourceInfo_Create](#oh_imagesourceinfo_create)函数。 660 661释放OH_ImageSource_Info对象使用[OH_ImageSourceInfo_Release](#oh_imagesourceinfo_release)函数。 662 663OH_ImageSource_Info结构体内容和操作方式如下： 664| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 665| -------- | -------- | -------- | -------- | -------- | 666| uint32_t | width | 图片宽度 | [OH_ImageSourceInfo_GetWidth](#oh_imagesourceinfo_getwidth) |获取图片的宽。| 667| uint32_t | height | 图片高度 | [OH_ImageSourceInfo_GetHeight](#oh_imagesourceinfo_getheight) |获取图片的高。| 668| bool | isHdr | 是否为高动态范围的信息 | [OH_ImageSourceInfo_GetDynamicRange](#oh_imagesourceinfo_getdynamicrange) |获取图片是否为高动态范围的信息。| 669 670**起始版本：** 12 671 672 673### OH_ImageSourceNative 674 675``` 676typedef struct OH_ImageSourceNative OH_ImageSourceNative 677``` 678**描述** 679OH_ImageSourceNative是native层封装的ImageSource结构体，用于创建图片数据。OH_ImageSourceNative结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。 680 681有多种方式创建OH_ImageSourceNative，具体如下： 682| 函数 | 描述 | 683| -------- | -------- | 684| [OH_ImageSourceNative_CreateFromUri](#oh_imagesourcenative_createfromuri) |通过uri创建OH_ImageSourceNative对象。| 685| [OH_ImageSourceNative_CreateFromFd](#oh_imagesourcenative_createfromfd) |通过fd创建OH_ImageSourceNative对象。| 686| [OH_ImageSourceNative_CreateFromData](#oh_imagesourcenative_createfromdata) |通过缓冲区数据创建OH_ImageSourceNative对象。| 687| [OH_ImageSourceNative_CreateFromRawFile](#oh_imagesourcenative_createfromrawfile) |通过图像资源文件的RawFileDescriptor创建OH_ImageSourceNative对象。| 688| [OH_ImageSourceNative_CreatePixelmap](#oh_imagesourcenative_createpixelmap) |通过图片解码参数创建OH_PixelmapNative对象。| 689| [OH_ImageSourceNative_CreatePixelmapList](#oh_imagesourcenative_createpixelmaplist) |通过图片解码参数创建OH_PixelmapNative数组。| 690 691释放OH_ImageSourceNative对象使用[OH_ImageSourceNative_Release](#oh_imagesourcenative_release)函数。 692 693OH_ImageSourceNative结构体内容和操作方式如下： 694| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 695| -------- | -------- | -------- | -------- | -------- | 696| int32_t | delayTimeList | 图像延迟时间数组 | [OH_ImageSourceNative_GetDelayTimeList](#oh_imagesourcenative_getdelaytimelist) |获取图像延迟时间数组。 | 697| OH_ImageSource_Info | info | ImageSource信息 | [OH_ImageSourceNative_GetImageInfo](#oh_imagesourcenative_getimageinfo) |获取指定序号的图片信息。| 698| Image_String | value | 配置项 | [OH_ImageSourceNative_GetImageProperty](#oh_imagesourcenative_getimageproperty) |获取图片指定属性键的值。| 699| Image_String | value | 配置项 | [OH_ImageSourceNative_ModifyImageProperty](#oh_imagesourcenative_modifyimageproperty) |通过指定的键修改图片属性的值。| 700| uint32_t | frameCount | 图像帧数 | [OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount) |获取图像帧数。| 701 702**起始版本：** 12 703 704 705### OH_NativeColorSpaceManager 706 707``` 708typedef struct OH_NativeColorSpaceManager OH_NativeColorSpaceManager 709``` 710**描述** 711NativeColorSpaceManager结构体类型，用于执行NativeColorSpaceManager相关操作。 712 713**起始版本：** 13 714 715 716### OH_PackingOptions 717 718``` 719typedef struct OH_PackingOptions OH_PackingOptions 720``` 721**描述** 722OH_PackingOptions是native层封装的图像编码选项结构体，OH_PackingOptions结构体不可直接操作，而是采用函数调用方式创建、释放结构体以及操作具体字段。 723 724创建PackingOptions结构体的对象使用[OH_PackingOptions_Create](#oh_packingoptions_create)函数。 725 726释放OH_PackingOptions对象使用[OH_PackingOptions_Release](#oh_packingoptions_release)函数。 727 728OH_PackingOptions结构体内容和操作方式如下： 729| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 730| -------- | -------- | -------- | -------- | -------- | 731| Image_MimeType | mimeType | MIME类型 | [OH_PackingOptions_GetMimeType](#oh_packingoptions_getmimetype) | 获取MIME类型。| 732| Image_MimeType | mimeType | MIME类型 | [OH_PackingOptions_SetMimeType](#oh_packingoptions_setmimetype) | 设置MIME类型。| 733| uint32_t | quality | 编码质量 | [OH_PackingOptions_GetQuality](#oh_packingoptions_getquality) | 获取编码质量。| 734| uint32_t | quality | 编码质量 | [OH_PackingOptions_SetQuality](#oh_packingoptions_setquality) | 设置编码质量。| 735| int32_t | desiredDynamicRange | 图片动态范围 | [OH_PackingOptions_GetDesiredDynamicRange](#oh_packingoptions_getdesireddynamicrange) | 获取编码时期望的图片动态范围。| 736| int32_t | desiredDynamicRange | 图片动态范围 | [OH_PackingOptions_SetDesiredDynamicRange](#oh_packingoptions_setdesireddynamicrange) | 设置编码时期望的图片动态范围。| 737 738**起始版本：** 12 739 740 741### OH_PackingOptionsForSequence 742 743``` 744typedef struct OH_PackingOptionsForSequence OH_PackingOptionsForSequence 745``` 746**描述** 747图像序列编码选项。 748 749**起始版本：** 18 750 751 752### OH_PictureMetadata 753 754``` 755typedef struct OH_PictureMetadata OH_PictureMetadata 756``` 757**描述** 758声明用于Picture的元数据。 759 760**起始版本：** 13 761 762 763### OH_PictureNative 764 765``` 766typedef struct OH_PictureNativeOH_PictureNative 767``` 768**描述** 769Picture结构体类型，用于执行picture相关操作。 770 771**起始版本：** 13 772 773 774### OH_Pixelmap_HdrDynamicMetadata 775 776``` 777typedef struct OH_Pixelmap_HdrDynamicMetadata OH_Pixelmap_HdrDynamicMetadata 778``` 779**描述** 780DR_DYNAMIC_METADATA关键字对应的动态元数据值。 781 782**起始版本：** 12 783 784 785### OH_Pixelmap_HdrGainmapMetadata 786 787``` 788typedef struct OH_Pixelmap_HdrGainmapMetadata OH_Pixelmap_HdrGainmapMetadata 789``` 790**描述** 791HDR_GAINMAP_METADATA关键字对应的gainmap相关元数据值，参考ISO 21496-1。 792 793**起始版本：** 12 794 795 796### OH_Pixelmap_HdrMetadataValue 797 798``` 799typedef struct OH_Pixelmap_HdrMetadataValue OH_Pixelmap_HdrMetadataValue 800``` 801**描述** 802Pixelmap使用的HDR元数据值，和OH_Pixelmap_HdrMetadataKey关键字相对应。 803 804用于[OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata)及[OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata)，有相应[OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey)关键字作为入参时，设置或获取到本结构体中相对应的元数据类型的值。 805 806**起始版本：** 12 807 808 809### OH_Pixelmap_HdrStaticMetadata 810 811``` 812typedef struct OH_Pixelmap_HdrStaticMetadata OH_Pixelmap_HdrStaticMetadata 813``` 814**描述** 815HDR_STATIC_METADATA关键字对应的静态元数据值。 816 817**起始版本：** 12 818 819 820### OH_Pixelmap_ImageInfo 821 822``` 823typedef struct OH_Pixelmap_ImageInfo OH_Pixelmap_ImageInfo 824``` 825**描述** 826OH_Pixelmap_ImageInfo是native层封装的图像像素信息结构体，保存图像像素的宽高、行跨距、像素格式、是否是HDR。 827 828创建OH_Pixelmap_ImageInfo对象使用[OH_PixelmapImageInfo_Create](#oh_pixelmapimageinfo_create)函数。 829 830释放OH_Pixelmap_ImageInfo对象使用[OH_PixelmapImageInfo_Release](#oh_pixelmapimageinfo_release)函数。 831 832OH_Pixelmap_ImageInfo结构体内容和操作方式如下： 833| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 834| -------- | -------- | -------- | -------- | -------- | 835| uint32_t | width | 图片宽 | [OH_PixelmapImageInfo_GetWidth](#oh_pixelmapimageinfo_getwidth) | 获取图片宽。| 836| uint32_t | height | 图片高 | [OH_PixelmapImageInfo_GetHeight](#oh_pixelmapimageinfo_getheight) | 获取图片高。| 837| uint32_t | rowStride | 行跨距 | [OH_PixelmapImageInfo_GetRowStride](#oh_pixelmapimageinfo_getrowstride) | 获取行跨距。| 838| int32_t | pixelFormat| 像素格式 | [OH_PixelmapImageInfo_GetPixelFormat](#oh_pixelmapimageinfo_getpixelformat) |获取像素格式。| 839| int32_t | alphaType | 透明度类型 | [OH_PixelmapImageInfo_GetAlphaType](#oh_pixelmapimageinfo_getalphatype) |获取透明度类型。| 840| bool | isHdr | 是否为高动态范围的信息 | [OH_PixelmapImageInfo_GetDynamicRange](#oh_pixelmapimageinfo_getdynamicrange) |获取Pixelmap是否为高动态范围的信息。| 841 842**起始版本：** 12 843 844 845### OH_Pixelmap_InitializationOptions 846 847``` 848typedef struct OH_Pixelmap_InitializationOptions OH_Pixelmap_InitializationOptions 849``` 850**描述** 851OH_Pixelmap_InitializationOptions是native层封装的初始化参数结构体，用于设置Pixelmap的初始化参数。 852 853创建OH_Pixelmap_InitializationOptions对象使用[OH_PixelmapInitializationOptions_Create](#oh_pixelmapinitializationoptions_create)函数。 854 855释放OH_Pixelmap_InitializationOptions对象使用[OH_PixelmapInitializationOptions_Release](#oh_pixelmapinitializationoptions_release)函数。 856 857OH_Pixelmap_InitializationOptions结构体内容和操作方式如下： 858| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 859| -------- | -------- | -------- | -------- | -------- | 860| uint32_t | width | 图片宽 | [OH_PixelmapInitializationOptions_GetWidth](#oh_pixelmapinitializationoptions_getwidth) |获取图片宽。| 861| uint32_t | width | 图片宽 | [OH_PixelmapInitializationOptions_SetWidth](#oh_pixelmapinitializationoptions_setwidth) |设置图片宽。| 862| uint32_t | height | 图片高 | [OH_PixelmapInitializationOptions_GetHeight](#oh_pixelmapinitializationoptions_getheight) |获取图片高。| 863| uint32_t | height | 图片高 | [OH_PixelmapInitializationOptions_SetHeight](#oh_pixelmapinitializationoptions_setheight) |设置图片高。| 864| int32_t | pixelFormat | 像素格式 | [OH_PixelmapInitializationOptions_GetPixelFormat](#oh_pixelmapinitializationoptions_getpixelformat) |获取像素格式。| 865| int32_t | pixelFormat | 像素格式 | [OH_PixelmapInitializationOptions_SetPixelFormat](#oh_pixelmapinitializationoptions_setpixelformat) |设置像素格式。| 866| int32_t | alphaType | 透明度类型 | [OH_PixelmapInitializationOptions_GetAlphaType](#oh_pixelmapinitializationoptions_getalphatype) |获取透明度类型。| 867| int32_t | alphaType | 透明度类型 | [OH_PixelmapInitializationOptions_SetAlphaType](#oh_pixelmapinitializationoptions_setalphatype) |设置透明度类型。| 868 869**起始版本：** 12 870 871 872### OH_PixelmapNative 873 874``` 875typedef struct OH_PixelmapNative OH_PixelmapNative 876``` 877**描述** 878OH_PixelmapNative结构体是native层封装的图像解码后无压缩的位图格式结构体。 879 880函数创建OH_PixelmapNative使用[OH_PixelmapNative_CreatePixelmap](#oh_pixelmapnative_createpixelmap)函数，默认采用BGRA_8888格式处理数据。 881 882释放OH_PixelmapNative对象使用[OH_PixelmapNative_Release](#oh_pixelmapnative_release)函数。 883 884OH_PixelmapNative结构体内容和操作方式如下： 885| 字段类型| 字段名称 | 字段描述 |操作函数 | 函数描述 | 886| -------- | -------- | -------- | -------- | -------- | 887| uint8_t | data | 图像像素数据 | [OH_PixelmapNative_ReadPixels](#oh_pixelmapnative_readpixels) | 读取图像像素数据，结果写入ArrayBuffer里。| 888| uint8_t | data | 图像像素数据 | [OH_PixelmapNative_WritePixels](#oh_pixelmapnative_writepixels) | 读取缓冲区中的图片数据，结果写入PixelMap中。| 889| OH_Pixelmap_ImageInfo | imageInfo | 图像像素信息 | [OH_PixelmapNative_GetImageInfo](#oh_pixelmapnative_getimageinfo) | 获取图像像素信息。| 890| float | alphaRate | 透明度 | [OH_PixelmapNative_Opacity](#oh_pixelmapnative_opacity) | 通过设置透明比率来让PixelMap达到对应的透明效果。| 891|float, float, | scaleX, scaleY | scaleX沿X轴缩放比例，scaleY沿Y轴缩放比例 |[OH_PixelmapNative_Scale](#oh_pixelmapnative_scale) | 根据输入的宽高对图片进行缩放。| 892| float, float| x, y | x平移量，y平移量 | [OH_PixelmapNative_Translate](#oh_pixelmapnative_translate) | 根据输入的坐标对图片进行位置变换。| 893| float | angle | 旋转角度 |[OH_PixelmapNative_Rotate](#oh_pixelmapnative_rotate) | 根据输入的角度对图片进行旋转。| 894| bool, bool | shouldFilpHorizontally, shouldFilpVertically | 是否水平翻转，是否垂直翻转 | [OH_PixelmapNative_Flip](#oh_pixelmapnative_flip) | 根据输入的条件对图片进行翻转。| 895| Image_Region | region | 裁剪区间 | [OH_PixelmapNative_Crop](#oh_pixelmapnative_crop) | 根据输入的尺寸对图片进行裁剪。| 896 897**起始版本：** 12 898 899 900### OH_NativeBuffer 901 902``` 903typedef struct OH_NativeBuffer OH_NativeBuffer 904``` 905**描述** 906NativeBuffer结构体类型，用于执行NativeBuffer相关操作。 907 908**起始版本：** 12 909 910 911## 枚举类型说明 912 913 914### IMAGE_ALLOCATOR_TYPE 915 916``` 917enum IMAGE_ALLOCATOR_TYPE 918``` 919 920**描述** 921 922用于分配 PixelMap 内存的分配器类型。 923 924**起始版本：** 15 925 926| 枚举值 | 描述 | 927| -------- | -------- | 928| IMAGE_ALLOCATOR_TYPE_AUTO | 由系统决定使用DMA内存或共享内存来创建 PixelMap。 | 929| IMAGE_ALLOCATOR_TYPE_DMA | 使用 DMA 内存来创建 PixelMap。 | 930| IMAGE_ALLOCATOR_TYPE_SHARE_MEMORY | 使用共享内存来创建 PixelMap。 | 931 932 933### Image_AuxiliaryPictureType 934 935``` 936enum Image_AuxiliaryPictureType 937``` 938**描述** 939辅助图类型。 940 941**起始版本：** 13 942 943| 枚举值 | 描述 | 944| -------- | -------- | 945| AUXILIARY_PICTURE_TYPE_GAINMAP | 增益图，代表了一种增强SDR图像以产生具有可变显示调整能力的HDR图像的机制。它是一组描述如何应用gainmap元数据的组合。 | 946| AUXILIARY_PICTURE_TYPE_DEPTH_MAP | 深度图，储存图像的深度数据，通过捕捉每个像素与摄像机之间的距离，提供场景的三维结构信息，通常用于3D重建和场景理解。 | 947| AUXILIARY_PICTURE_TYPE_UNREFOCUS_MAP | 人像未对焦的原图，提供了一种在人像拍摄中突出背景模糊效果的方式，能够帮助用户在后期处理中选择焦点区域，增加创作自由度。 | 948| AUXILIARY_PICTURE_TYPE_LINEAR_MAP | 线性图，用于提供额外的数据视角或补充信息，通常用于视觉效果的增强，它可以包含场景中光照、颜色或其他视觉元素的线性表示。 | 949| AUXILIARY_PICTURE_TYPE_FRAGMENT_MAP | 水印裁剪图，表示在原图中被水印覆盖的区域，该图像用于修复或移除水印影响，恢复图像的完整性和可视性。 | 950 951 952### Image_CropAndScaleStrategy 953 954``` 955enum Image_CropAndScaleStrategy 956``` 957 958**描述** 959 960在同时指定desiredSize和desiredRegion时执行裁剪和缩放的策略。 961 962**起始版本：** 18 963 964| 枚举值 | 描述 | 965| -------- | -------- | 966| IMAGE_CROP_AND_SCALE_STRATEGY_SCALE_FIRST | 先裁剪，后缩放。 | 967| IMAGE_CROP_AND_SCALE_STRATEGY_CROP_FIRST | 先缩放，后裁剪。 | 968 969 970### IMAGE_DYNAMIC_RANGE 971 972``` 973enum IMAGE_DYNAMIC_RANGE 974``` 975**描述** 976解码指定期望动态范围。 977 978**起始版本：** 12 979 980| 枚举值 | 描述 | 981| -------- | -------- | 982| IMAGE_DYNAMIC_RANGE_AUTO | 根据图片自适应处理。 | 983| IMAGE_DYNAMIC_RANGE_SDR | 标准动态范围。 | 984| IMAGE_DYNAMIC_RANGE_HDR | 高动态范围。 | 985 986 987### Image_ErrorCode 988 989``` 990enum Image_ErrorCode 991``` 992**描述** 993错误码。 994 995**起始版本：** 12 996 997| 枚举值 | 描述 | 998| -------- | -------- | 999| IMAGE_SUCCESS | 操作成功。 | 1000| IMAGE_BAD_PARAMETER | 无效参数。 | 1001| IMAGE_UNSUPPORTED_MIME_TYPE | 不支持的MIME类型。 | 1002| IMAGE_UNKNOWN_MIME_TYPE | 未知的MIME类型。 | 1003| IMAGE_TOO_LARGE | 过大的数据或图片。 | 1004| IMAGE_DMA_NOT_EXIST | 内存不是DMA内存。 | 1005| IMAGE_DMA_OPERATION_FAILED | DMA内存操作失败。 | 1006| IMAGE_UNSUPPORTED_OPERATION | 不支持的操作。 | 1007| IMAGE_UNSUPPORTED_METADATA | 不支持的 metadata。 | 1008| IMAGE_UNSUPPORTED_CONVERSION | 不支持的转换。 | 1009| IMAGE_INVALID_REGION | 无效区域。 | 1010| IMAGE_UNSUPPORTED_MEMORY_FORMAT | 不支持的内存格式。<br/>**起始版本：** 13 | 1011| IMAGE_ALLOC_FAILED | 申请内存失败。 | 1012| IMAGE_COPY_FAILED | 内存拷贝失败。 | 1013| IMAGE_LOCK_UNLOCK_FAILED | 内存加锁或解锁失败。<br/>**起始版本：** 15 | 1014| IMAGE_UNKNOWN_ERROR | 未知错误。 | 1015| IMAGE_BAD_SOURCE | 解码数据源异常。 | 1016| IMAGE_SOURCE_UNSUPPORTED_MIME_TYPE | 不支持的 MIME 类型。<br/>**起始版本：** 15 | 1017| IMAGE_SOURCE_TOO_LARGE | 图像过大。<br/>**起始版本：** 15 | 1018| IMAGE_SOURCE_UNSUPPORTED_ALLOCATOR_TYPE | 不支持的分配器类型。例如，DMA支持HDR元数据，可以使用共享内存解码HDR图像。<br/>**起始版本：** 15 | 1019| IMAGE_SOURCE_UNSUPPORTED_OPTIONS | 不支持的选项。例如，无法将图像转换为所需的像素格式。<br/>**起始版本：** 15 | 1020| IMAGE_DECODE_FAILED | 解码失败。 | 1021| IMAGE_SOURCE_ALLOC_FAILED | 内存申请失败。<br/>**起始版本：** 15 | 1022| IMAGE_ENCODE_FAILED | 编码失败。 | 1023 1024 1025### Image_MetadataType 1026 1027``` 1028enum Image_MetadataType 1029``` 1030**描述** 1031定义元数据类型。 1032 1033**起始版本：** 13 1034 1035| 枚举值 | 描述 | 1036| -------- | -------- | 1037| EXIF_METADATA | EXIF元数据。 | 1038| FRAGMENT_METADATA | 水印裁剪图元数据。 | 1039 1040 1041### IMAGE_PACKER_DYNAMIC_RANGE 1042 1043``` 1044enum IMAGE_PACKER_DYNAMIC_RANGE 1045``` 1046**描述** 1047编码指定动态范围。 1048 1049**起始版本：** 12 1050 1051| 枚举值 | 描述 | 1052| -------- | -------- | 1053| IMAGE_PACKER_DYNAMIC_RANGE_AUTO | 编码动态范围根据图像信息自适应。 | 1054| IMAGE_PACKER_DYNAMIC_RANGE_SDR | 编码图片为标准动态范围。 | 1055 1056 1057### PIXEL_FORMAT 1058 1059``` 1060enum PIXEL_FORMAT 1061``` 1062 1063**描述** 1064 1065图片像素格式。 1066 1067**起始版本：** 12 1068 1069| 枚举值 | 描述 | 1070| -------- | -------- | 1071| PIXEL_FORMAT_UNKNOWN | 未知格式 | 1072| PIXEL_FORMAT_RGB_565 | RGB_565格式 | 1073| PIXEL_FORMAT_RGBA_8888 | RGBA_8888格式 | 1074| PIXEL_FORMAT_BGRA_8888 | BGRA_8888格式 | 1075| PIXEL_FORMAT_RGB_888 | RGB_888格式 | 1076| PIXEL_FORMAT_ALPHA_8 | ALPHA_8格式 | 1077| PIXEL_FORMAT_RGBA_F16 | RGBA_F16格式 | 1078| PIXEL_FORMAT_NV21 | NV21格式 | 1079| PIXEL_FORMAT_NV12 | NV12格式 | 1080| PIXEL_FORMAT_RGBA_1010102 | RGBA_1010102 格式 | 1081| PIXEL_FORMAT_YCBCR_P010 | YCBCR_P010 格式 | 1082| PIXEL_FORMAT_YCRCB_P010 | YCRCB_P010 格式 | 1083 1084 1085### OH_Pixelmap_HdrMetadataKey 1086 1087``` 1088enum OH_Pixelmap_HdrMetadataKey 1089``` 1090**描述** 1091Pixelmap使用的HDR相关元数据信息的关键字，用于[OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata)及[OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata)。 1092 1093**起始版本：** 12 1094 1095| 枚举值 | 描述 | 1096| -------- | -------- | 1097| HDR_METADATA_TYPE | Pixelmap使用的元数据类型。 | 1098| HDR_STATIC_METADATA | 静态元数据。 | 1099| HDR_DYNAMIC_METADATA | 动态元数据。 | 1100| HDR_GAINMAP_METADATA | Gainmap使用的元数据。 | 1101 1102 1103### OH_Pixelmap_HdrMetadataType 1104 1105``` 1106enum OH_Pixelmap_HdrMetadataType 1107``` 1108**描述** 1109HDR_METADATA_TYPE关键字对应的值。 1110 1111**起始版本：** 12 1112 1113| 枚举值 | 描述 | 1114| -------- | -------- | 1115| HDR_METADATA_TYPE_NONE | 无元数据内容。 | 1116| HDR_METADATA_TYPE_BASE | 表示用于基础图的元数据。 | 1117| HDR_METADATA_TYPE_GAINMAP | 表示用于Gainmap图的元数据。 | 1118| HDR_METADATA_TYPE_ALTERNATE | 表示用于合成后HDR图的元数据。 | 1119 1120 1121### OH_PixelmapNative_AntiAliasingLevel 1122 1123``` 1124enum OH_PixelmapNative_AntiAliasingLevel 1125``` 1126**描述** 1127Pixelmap缩放时采用的缩放算法。 1128 1129**起始版本：** 12 1130 1131| 枚举值 | 描述 | 1132| -------- | -------- | 1133| OH_PixelmapNative_AntiAliasing_NONE | 最近邻插值算法。 | 1134| OH_PixelmapNative_AntiAliasing_LOW | 双线性插值算法。 | 1135| OH_PixelmapNative_AntiAliasing_MEDIUM | 双线性插值算法，同时开启Mipmap。缩小图片时建议使用。 | 1136| OH_PixelmapNative_AntiAliasing_HIGH | 三次插值算法。 | 1137 1138 1139### PIXELMAP_ALPHA_TYPE 1140 1141``` 1142enum PIXELMAP_ALPHA_TYPE 1143``` 1144**描述** 1145Pixelmap透明度类型。 1146 1147**起始版本：** 12 1148 1149| 枚举值 | 描述 | 1150| -------- | -------- | 1151| PIXELMAP_ALPHA_TYPE_UNKNOWN | 未知格式。 | 1152| PIXELMAP_ALPHA_TYPE_OPAQUE | 不透明的格式。 | 1153| PIXELMAP_ALPHA_TYPE_PREMULTIPLIED | 预乘透明度格式。 | 1154| PIXELMAP_ALPHA_TYPE_UNPREMULTIPLIED | 非预乘透明度格式。 | 1155 1156 1157## 函数说明 1158 1159 1160### OH_AuxiliaryPictureInfo_Create() 1161 1162``` 1163Image_ErrorCode OH_AuxiliaryPictureInfo_Create(OH_AuxiliaryPictureInfo **info) 1164``` 1165**描述** 1166创建一个OH_AuxiliaryPictureInfo对象。 1167 1168**起始版本：** 13 1169 1170**参数：** 1171 1172| 名称 | 描述 | 1173| -------- | -------- | 1174| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1175 1176**返回：** 1177 1178如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，具体释义参考[Image_ErrorCode](#image_errorcode)。 1179 1180 1181### OH_AuxiliaryPictureInfo_GetPixelFormat() 1182 1183``` 1184Image_ErrorCode OH_AuxiliaryPictureInfo_GetPixelFormat(OH_AuxiliaryPictureInfo *info, PIXEL_FORMAT *pixelFormat) 1185``` 1186**描述** 1187获取辅助图的图片信息的像素格式。 1188 1189**起始版本：** 13 1190 1191**参数：** 1192 1193| 名称 | 描述 | 1194| -------- | -------- | 1195| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1196| pixelFormat | 获取的像素格式。 | 1197 1198**返回：** 1199 1200如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1201 1202 1203### OH_AuxiliaryPictureInfo_GetRowStride() 1204 1205``` 1206Image_ErrorCode OH_AuxiliaryPictureInfo_GetRowStride(OH_AuxiliaryPictureInfo *info, uint32_t *rowStride) 1207``` 1208**描述** 1209获取辅助图的图片信息的行跨距。 1210 1211**起始版本：** 13 1212 1213**参数：** 1214 1215| 名称 | 描述 | 1216| -------- | -------- | 1217| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1218| rowStride | 跨距，内存中每行像素所占的空间。 | 1219 1220**返回：** 1221 1222如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1223 1224 1225### OH_AuxiliaryPictureInfo_GetSize() 1226 1227``` 1228Image_ErrorCode OH_AuxiliaryPictureInfo_GetSize(OH_AuxiliaryPictureInfo *info, Image_Size *size) 1229``` 1230**描述** 1231获取辅助图的图片尺寸。 1232 1233**起始版本：** 13 1234 1235**参数：** 1236 1237| 名称 | 描述 | 1238| -------- | -------- | 1239| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1240| size | 获取的图片尺寸。 | 1241 1242**返回：** 1243 1244如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1245 1246 1247### OH_AuxiliaryPictureInfo_GetType() 1248 1249``` 1250Image_ErrorCode OH_AuxiliaryPictureInfo_GetType(OH_AuxiliaryPictureInfo *info, Image_AuxiliaryPictureType *type) 1251``` 1252**描述** 1253获取辅助图的图片信息的辅助图类型。 1254 1255**起始版本：** 13 1256 1257**参数：** 1258 1259| 名称 | 描述 | 1260| -------- | -------- | 1261| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1262| type | 获取的辅助图类型。 | 1263 1264**返回：** 1265 1266如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1267 1268 1269### OH_AuxiliaryPictureInfo_Release() 1270 1271``` 1272Image_ErrorCode OH_AuxiliaryPictureInfo_Release(OH_AuxiliaryPictureInfo *info) 1273``` 1274**描述** 1275释放OH_AuxiliaryPictureInfo指针。 1276 1277**起始版本：** 13 1278 1279**参数：** 1280 1281| 名称 | 描述 | 1282| -------- | -------- | 1283| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1284 1285**返回：** 1286 1287如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1288 1289 1290### OH_AuxiliaryPictureInfo_SetPixelFormat() 1291 1292``` 1293Image_ErrorCode OH_AuxiliaryPictureInfo_SetPixelFormat(OH_AuxiliaryPictureInfo *info, PIXEL_FORMAT pixelFormat) 1294``` 1295**描述** 1296设置辅助图的图片信息的像素格式。 1297 1298**起始版本：** 13 1299 1300**参数：** 1301 1302| 名称 | 描述 | 1303| -------- | -------- | 1304| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1305| pixelFormat | 将要设置的像素格式。 | 1306 1307**返回：** 1308 1309如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1310 1311 1312### OH_AuxiliaryPictureInfo_SetRowStride() 1313 1314``` 1315Image_ErrorCode OH_AuxiliaryPictureInfo_SetRowStride(OH_AuxiliaryPictureInfo *info, uint32_t rowStride) 1316``` 1317**描述** 1318设置辅助图的图片信息的行跨距。 1319 1320**起始版本：** 13 1321 1322**参数：** 1323 1324| 名称 | 描述 | 1325| -------- | -------- | 1326| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1327| rowStride | 跨距，内存中每行像素所占的空间。 | 1328 1329**返回：** 1330 1331如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1332 1333 1334### OH_AuxiliaryPictureInfo_SetSize() 1335 1336``` 1337Image_ErrorCode OH_AuxiliaryPictureInfo_SetSize(OH_AuxiliaryPictureInfo *info, Image_Size *size) 1338``` 1339**描述** 1340设置辅助图的图片尺寸。 1341 1342**起始版本：** 13 1343 1344**参数：** 1345 1346| 名称 | 描述 | 1347| -------- | -------- | 1348| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1349| size | 将要设置的图片尺寸。 | 1350 1351**返回：** 1352 1353如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1354 1355 1356### OH_AuxiliaryPictureInfo_SetType() 1357 1358``` 1359Image_ErrorCode OH_AuxiliaryPictureInfo_SetType(OH_AuxiliaryPictureInfo *info, Image_AuxiliaryPictureType type) 1360``` 1361**描述** 1362设置辅助图的图片信息的辅助图类型。 1363 1364**起始版本：** 13 1365 1366**参数：** 1367 1368| 名称 | 描述 | 1369| -------- | -------- | 1370| info | 将操作的OH_AuxiliaryPictureInfo指针。 | 1371| type | 将要设置的辅助图类型。 | 1372 1373**返回：** 1374 1375如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1376 1377 1378### OH_AuxiliaryPictureNative_Create() 1379 1380``` 1381Image_ErrorCode OH_AuxiliaryPictureNative_Create(uint8_t *data, size_t dataLength, Image_Size *size, Image_AuxiliaryPictureType type, OH_AuxiliaryPictureNative **auxiliaryPicture) 1382``` 1383**描述** 1384创建OH_AuxiliaryPictureNative指针。 1385 1386**起始版本：** 13 1387 1388**参数：** 1389 1390| 名称 | 描述 | 1391| -------- | -------- | 1392| data | 图像数据。 | 1393| dataLength | 图像数据长度。 | 1394| size | 辅助图尺寸。 | 1395| type | 辅助图类型。 | 1396| auxiliaryPicture | 被创建的OH_AuxiliaryPictureNative指针。 | 1397 1398**返回：** 1399 1400如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1401 1402 1403### OH_AuxiliaryPictureNative_GetInfo() 1404 1405``` 1406Image_ErrorCode OH_AuxiliaryPictureNative_GetInfo(OH_AuxiliaryPictureNative *auxiliaryPicture, OH_AuxiliaryPictureInfo **info) 1407``` 1408**描述** 1409获取辅助图信息。 1410 1411**起始版本：** 13 1412 1413**参数：** 1414 1415| 名称 | 描述 | 1416| -------- | -------- | 1417| auxiliaryPicture | 被操作的OH_AuxiliaryPictureNative指针。 | 1418| info | 辅助图信息。 | 1419 1420**返回：** 1421 1422如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1423 1424 1425### OH_AuxiliaryPictureNative_GetMetadata() 1426 1427``` 1428Image_ErrorCode OH_AuxiliaryPictureNative_GetMetadata(OH_AuxiliaryPictureNative *auxiliaryPicture, Image_MetadataType metadataType, OH_PictureMetadata **metadata) 1429``` 1430**描述** 1431获取辅助图的元数据。 1432 1433**起始版本：** 13 1434 1435**参数：** 1436 1437| 名称 | 描述 | 1438| -------- | -------- | 1439| auxiliaryPicture | 将操作的OH_AuxiliaryPictureNative指针。 | 1440| metadataType | 元数据类型。 | 1441| metadata | 获取的元数据。 | 1442 1443**返回：** 1444 1445如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的元数据类型，或者元数据类型与辅助图片类型不匹配返回 IMAGE_UNSUPPORTED_METADATA， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1446 1447 1448### OH_AuxiliaryPictureNative_GetType() 1449 1450``` 1451Image_ErrorCode OH_AuxiliaryPictureNative_GetType(OH_AuxiliaryPictureNative *auxiliaryPicture, Image_AuxiliaryPictureType *type) 1452``` 1453**描述** 1454获取辅助图类型。 1455 1456**起始版本：** 13 1457 1458**参数：** 1459 1460| 名称 | 描述 | 1461| -------- | -------- | 1462| auxiliaryPicture | 被操作的OH_AuxiliaryPictureNative指针。 | 1463| type | 辅助图类型。 | 1464 1465**返回：** 1466 1467如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1468 1469 1470### OH_AuxiliaryPictureNative_ReadPixels() 1471 1472``` 1473Image_ErrorCode OH_AuxiliaryPictureNative_ReadPixels(OH_AuxiliaryPictureNative *auxiliaryPicture, uint8_t *destination, size_t *bufferSize) 1474``` 1475**描述** 1476读取辅助图的像素数据，结果写入缓冲区。 1477 1478**起始版本：** 13 1479 1480**参数：** 1481 1482| 名称 | 描述 | 1483| -------- | -------- | 1484| auxiliaryPicture | 被操作的OH_AuxiliaryPictureNative指针。 | 1485| destination | 缓冲区，获取的辅助图像素数据写入到该内存区域内。 | 1486| bufferSize | 缓冲区大小。 | 1487 1488**返回：** 1489 1490如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果内存分配失败返回 IMAGE_ALLOC_FAILED，如果内存拷贝失败返回 IMAGE_COPY_FAILED， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1491 1492 1493### OH_AuxiliaryPictureNative_Release() 1494 1495``` 1496Image_ErrorCode OH_AuxiliaryPictureNative_Release(OH_AuxiliaryPictureNative *picture) 1497``` 1498**描述** 1499释放OH_AuxiliaryPictureNative指针。 1500 1501**起始版本：** 13 1502 1503**参数：** 1504 1505| 名称 | 描述 | 1506| -------- | -------- | 1507| picture | 将操作的OH_AuxiliaryPictureNative指针。 | 1508 1509**返回：** 1510 1511如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1512 1513 1514### OH_AuxiliaryPictureNative_SetInfo() 1515 1516``` 1517Image_ErrorCode OH_AuxiliaryPictureNative_SetInfo(OH_AuxiliaryPictureNative *auxiliaryPicture, OH_AuxiliaryPictureInfo *info) 1518``` 1519**描述** 1520设置辅助图信息。 1521 1522**起始版本：** 13 1523 1524**参数：** 1525 1526| 名称 | 描述 | 1527| -------- | -------- | 1528| auxiliaryPicture | 将操作的OH_AuxiliaryPictureNative指针。 | 1529| info | 将要设置的辅助图信息。 | 1530 1531**返回：** 1532 1533如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1534 1535 1536### OH_AuxiliaryPictureNative_SetMetadata() 1537 1538``` 1539Image_ErrorCode OH_AuxiliaryPictureNative_SetMetadata(OH_AuxiliaryPictureNative *auxiliaryPicture, Image_MetadataType metadataType, OH_PictureMetadata *metadata) 1540``` 1541**描述** 1542设置辅助图的元数据。 1543 1544**起始版本：** 13 1545 1546**参数：** 1547 1548| 名称 | 描述 | 1549| -------- | -------- | 1550| auxiliaryPicture | 将操作的OH_AuxiliaryPictureNative指针。 | 1551| metadataType | 元数据类型。 | 1552| metadata | 将要设置的元数据。 | 1553 1554**返回：** 1555 1556如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的元数据类型，或者元数据类型与辅助图片类型不匹配返回 IMAGE_UNSUPPORTED_METADATA， 具体释义参考[Image_ErrorCode](#image_errorcode)。 1557 1558 1559### OH_AuxiliaryPictureNative_WritePixels() 1560 1561``` 1562Image_ErrorCode OH_AuxiliaryPictureNative_WritePixels(OH_AuxiliaryPictureNative *auxiliaryPicture, uint8_t *source, size_t bufferSize) 1563``` 1564**描述** 1565读取缓冲区的图像像素数据，并将结果写入为辅助图中。 1566 1567**起始版本：** 13 1568 1569**参数：** 1570 1571| 名称 | 描述 | 1572| -------- | -------- | 1573| auxiliaryPicture | 被操作的OH_AuxiliaryPictureNative指针。 | 1574| source | 将被写入的图像像素数据。 | 1575| bufferSize | 图像像素数据长度。 | 1576 1577**返回：** 1578 1579如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果内存分配失败返回 IMAGE_ALLOC_FAILED，如果内存拷贝失败返回 IMAGE_COPY_FAILED， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1580 1581 1582### OH_DecodingOptions_Create() 1583 1584``` 1585Image_ErrorCode OH_DecodingOptions_Create(OH_DecodingOptions **options) 1586``` 1587**描述** 1588创建OH_DecodingOptions指针。 1589 1590**起始版本：** 12 1591 1592**参数：** 1593 1594| 名称 | 描述 | 1595| -------- | -------- | 1596| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1597 1598**返回：** 1599 1600如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1601 1602 1603### OH_DecodingOptions_GetCropAndScaleStrategy() 1604 1605``` 1606Image_ErrorCode OH_DecodingOptions_GetCropAndScaleStrategy(OH_DecodingOptions *options, int32_t *cropAndScaleStrategy) 1607``` 1608 1609**描述** 1610 1611获取解码选项的裁剪和缩放策略。 1612 1613**起始版本：** 18 1614 1615**参数:** 1616 1617| 名称 | 描述 | 1618| -------- | -------- | 1619| options | 被操作的OH_DecodingOptions指针。 | 1620| cropAndScaleStrategy | 指向在同时指定desiredSize和desiredRegion时执行裁剪和缩放策略的指针。 | 1621 1622**返回：** 1623 1624如果操作成功返回 IMAGE_SUCCESS，如果options或者cropAndScaleStrategy为空指针返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1625 1626 1627### OH_DecodingOptions_GetDesiredDynamicRange() 1628 1629``` 1630Image_ErrorCode OH_DecodingOptions_GetDesiredDynamicRange(OH_DecodingOptions *options, int32_t *desiredDynamicRange) 1631``` 1632**描述** 1633获取解码时设置的期望动态范围。 1634 1635**起始版本：** 12 1636 1637**参数：** 1638 1639| 名称 | 描述 | 1640| -------- | -------- | 1641| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1642| desiredDynamicRange | 期望的动态范围值 [IMAGE_DYNAMIC_RANGE](#image_dynamic_range)。 | 1643 1644**返回：** 1645 1646如果操作成功返回IMAGE_SUCCESS，参数校验错误返回IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 1647 1648 1649### OH_DecodingOptions_GetDesiredRegion() 1650 1651``` 1652Image_ErrorCode OH_DecodingOptions_GetDesiredRegion(OH_DecodingOptions *options, Image_Region *desiredRegion) 1653``` 1654**描述** 1655获取解码区域。 1656 1657**起始版本：** 12 1658 1659**参数：** 1660 1661| 名称 | 描述 | 1662| -------- | -------- | 1663| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1664| desiredRegion | 解码区域。 | 1665 1666**返回：** 1667 1668如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1669 1670 1671### OH_DecodingOptions_GetDesiredSize() 1672 1673``` 1674Image_ErrorCode OH_DecodingOptions_GetDesiredSize(OH_DecodingOptions *options, Image_Size *desiredSize) 1675``` 1676**描述** 1677获取期望输出大小。 1678 1679**起始版本：** 12 1680 1681**参数：** 1682 1683| 名称 | 描述 | 1684| -------- | -------- | 1685| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1686| desiredSize | 期望输出大小。 | 1687 1688**返回：** 1689 1690如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1691 1692 1693### OH_DecodingOptions_GetIndex() 1694 1695``` 1696Image_ErrorCode OH_DecodingOptions_GetIndex(OH_DecodingOptions *options, uint32_t *index) 1697``` 1698**描述** 1699获取解码图片序号。 1700 1701**起始版本：** 12 1702 1703**参数：** 1704 1705| 名称 | 描述 | 1706| -------- | -------- | 1707| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1708| index | 解码图片序号。 | 1709 1710**返回：** 1711 1712如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1713 1714 1715### OH_DecodingOptions_GetPixelFormat() 1716 1717``` 1718Image_ErrorCode OH_DecodingOptions_GetPixelFormat(OH_DecodingOptions *options, int32_t *pixelFormat) 1719``` 1720**描述** 1721获取pixel格式。 1722 1723**起始版本：** 12 1724 1725**参数：** 1726 1727| 名称 | 描述 | 1728| -------- | -------- | 1729| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1730| pixelFormat | pixel格式[PIXEL_FORMAT](#pixel_format)。 | 1731 1732**返回：** 1733 1734如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1735 1736 1737### OH_DecodingOptions_GetRotate() 1738 1739``` 1740Image_ErrorCode OH_DecodingOptions_GetRotate(OH_DecodingOptions *options, float *rotate) 1741``` 1742**描述** 1743获取旋转角度。 1744 1745**起始版本：** 12 1746 1747**参数：** 1748 1749| 名称 | 描述 | 1750| -------- | -------- | 1751| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1752| rotate | 旋转角度，单位为deg。 | 1753 1754**返回：** 1755 1756如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1757 1758 1759### OH_DecodingOptions_Release() 1760 1761``` 1762Image_ErrorCode OH_DecodingOptions_Release(OH_DecodingOptions *options) 1763``` 1764**描述** 1765释放OH_DecodingOptions指针。 1766 1767**起始版本：** 12 1768 1769**参数：** 1770 1771| 名称 | 描述 | 1772| -------- | -------- | 1773| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1774 1775**返回：** 1776 1777如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1778 1779 1780### OH_DecodingOptions_SetCropAndScaleStrategy() 1781 1782``` 1783Image_ErrorCode OH_DecodingOptions_SetCropAndScaleStrategy(OH_DecodingOptions *options, int32_t cropAndScaleStrategy) 1784``` 1785 1786**描述** 1787 1788设置解码选项的裁剪和缩放策略。 1789 1790**起始版本：** 18 1791 1792**参数:** 1793 1794| 名称 | 描述 | 1795| -------- | -------- | 1796| options | 被操作的OH_DecodingOptions指针。 | 1797| cropAndScaleStrategy | 在同时指定desiredSize和desiredRegion时执行裁剪和缩放的策略。 | 1798 1799**返回：** 1800 1801如果操作成功返回 IMAGE_SUCCESS，如果options空指针或者cropAndScaleStrategy取值不在Image_CropAndScaleStrategy枚举值定义之中返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1802 1803 1804### OH_DecodingOptions_SetDesiredDynamicRange() 1805 1806``` 1807Image_ErrorCode OH_DecodingOptions_SetDesiredDynamicRange(OH_DecodingOptions *options, int32_t desiredDynamicRange) 1808``` 1809**描述** 1810设置解码时的期望动态范围。 1811 1812**起始版本：** 12 1813 1814**参数：** 1815 1816| 名称 | 描述 | 1817| -------- | -------- | 1818| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1819| desiredDynamicRange | 期望的动态范围值 [IMAGE_DYNAMIC_RANGE](#image_dynamic_range)。 | 1820 1821**返回：** 1822 1823如果操作成功返回IMAGE_SUCCESS，参数校验错误返回IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 1824 1825 1826### OH_DecodingOptions_SetDesiredRegion() 1827 1828``` 1829Image_ErrorCode OH_DecodingOptions_SetDesiredRegion(OH_DecodingOptions *options, Image_Region *desiredRegion) 1830``` 1831**描述** 1832设置解码区域。 1833 1834**起始版本：** 12 1835 1836**参数：** 1837 1838| 名称 | 描述 | 1839| -------- | -------- | 1840| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1841| desiredRegion | 解码区域。 | 1842 1843**返回：** 1844 1845如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1846 1847 1848### OH_DecodingOptions_SetDesiredSize() 1849 1850``` 1851Image_ErrorCode OH_DecodingOptions_SetDesiredSize(OH_DecodingOptions *options, Image_Size *desiredSize) 1852``` 1853**描述** 1854设置期望输出大小。 1855 1856**起始版本：** 12 1857 1858**参数：** 1859 1860| 名称 | 描述 | 1861| -------- | -------- | 1862| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1863| desiredSize | 期望输出大小。 | 1864 1865**返回：** 1866 1867如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1868 1869 1870### OH_DecodingOptions_SetIndex() 1871 1872``` 1873Image_ErrorCode OH_DecodingOptions_SetIndex(OH_DecodingOptions *options, uint32_t index) 1874``` 1875**描述** 1876设置解码图片序号。 1877 1878**起始版本：** 12 1879 1880**参数：** 1881 1882| 名称 | 描述 | 1883| -------- | -------- | 1884| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1885| index | 解码图片序号。 | 1886 1887**返回：** 1888 1889如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1890 1891 1892### OH_DecodingOptions_SetPixelFormat() 1893 1894``` 1895Image_ErrorCode OH_DecodingOptions_SetPixelFormat(OH_DecodingOptions *options, int32_t pixelFormat) 1896``` 1897**描述** 1898设置pixel格式。 1899 1900**起始版本：** 12 1901 1902**参数：** 1903 1904| 名称 | 描述 | 1905| -------- | -------- | 1906| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1907| pixelFormat | pixel格式[PIXEL_FORMAT](#pixel_format)。 | 1908 1909**返回：** 1910 1911如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1912 1913 1914### OH_DecodingOptions_SetRotate() 1915 1916``` 1917Image_ErrorCode OH_DecodingOptions_SetRotate(OH_DecodingOptions *options, float rotate) 1918``` 1919**描述** 1920设置旋转角度。 1921 1922**起始版本：** 12 1923 1924**参数：** 1925 1926| 名称 | 描述 | 1927| -------- | -------- | 1928| options | 被操作的[OH_DecodingOptions](#oh_decodingoptions)指针。 | 1929| rotate | 旋转角度，单位为deg。 | 1930 1931**返回：** 1932 1933如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1934 1935 1936### OH_DecodingOptionsForPicture_Create() 1937 1938``` 1939Image_ErrorCode OH_DecodingOptionsForPicture_Create(OH_DecodingOptionsForPicture **options) 1940``` 1941**描述** 1942创建OH_DecodingOptionsForPicture指针。 1943 1944**起始版本：** 13 1945 1946**参数：** 1947 1948| 名称 | 描述 | 1949| -------- | -------- | 1950| options | 被操作的OH_DecodingOptionsForPicture指针。 | 1951 1952**返回：** 1953 1954如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1955 1956 1957### OH_DecodingOptionsForPicture_GetDesiredAuxiliaryPictures() 1958 1959``` 1960Image_ErrorCode OH_DecodingOptionsForPicture_GetDesiredAuxiliaryPictures(OH_DecodingOptionsForPicture *options, Image_AuxiliaryPictureType **desiredAuxiliaryPictures, size_t *length) 1961``` 1962**描述** 1963获取解码时设置的期望辅助图（期望解码出的picture包含的辅助图）。 1964 1965**起始版本：** 13 1966 1967**参数：** 1968 1969| 名称 | 描述 | 1970| -------- | -------- | 1971| options | 被操作的OH_DecodingOptionsForPicture指针。 | 1972| desiredAuxiliaryPictures | 解码选项中的期望辅助图。 | 1973| length | 期望辅助图长度。 | 1974 1975**返回：** 1976 1977如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1978 1979 1980### OH_DecodingOptionsForPicture_Release() 1981 1982``` 1983Image_ErrorCode OH_DecodingOptionsForPicture_Release(OH_DecodingOptionsForPicture *options) 1984``` 1985**描述** 1986释放OH_DecodingOptionsForPicture指针。 1987 1988**起始版本：** 13 1989 1990**参数：** 1991 1992| 名称 | 描述 | 1993| -------- | -------- | 1994| options | 要释放的OH_DecodingOptionsForPicture指针。 | 1995 1996**返回：** 1997 1998如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 1999 2000 2001### OH_DecodingOptionsForPicture_SetDesiredAuxiliaryPictures() 2002 2003``` 2004Image_ErrorCode OH_DecodingOptionsForPicture_SetDesiredAuxiliaryPictures(OH_DecodingOptionsForPicture *options, Image_AuxiliaryPictureType *desiredAuxiliaryPictures, size_t length) 2005``` 2006**描述** 2007设置解码选项中的期望辅助图。 2008 2009**起始版本：** 13 2010 2011**参数：** 2012 2013| 名称 | 描述 | 2014| -------- | -------- | 2015| options | 被操作的OH_DecodingOptionsForPicture指针。 | 2016| desiredAuxiliaryPictures | 将要设置的期望辅助图。 | 2017| length | 期望辅助图长度。 | 2018 2019**返回：** 2020 2021如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2022 2023 2024### OH_ImageNative_GetBufferSize() 2025 2026``` 2027Image_ErrorCode OH_ImageNative_GetBufferSize(OH_ImageNative *image, uint32_t componentType, size_t *size) 2028``` 2029**描述** 2030获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的缓冲区的大小。 2031 2032**起始版本：** 12 2033 2034**参数：** 2035 2036| 名称 | 描述 | 2037| -------- | -------- | 2038| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2039| componentType | 表示组件的类型。 | 2040| size | 表示作为获取结果的缓冲区大小的指针。 | 2041 2042**返回：** 2043 2044如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2045 2046 2047### OH_ImageNative_GetByteBuffer() 2048 2049``` 2050Image_ErrorCode OH_ImageNative_GetByteBuffer(OH_ImageNative *image, uint32_t componentType, OH_NativeBuffer **nativeBuffer) 2051``` 2052**描述** 2053获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的缓冲区。 2054 2055**起始版本：** 12 2056 2057**参数：** 2058 2059| 名称 | 描述 | 2060| -------- | -------- | 2061| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2062| componentType | 表示组件的类型。 | 2063| nativeBuffer | 表示作为获取结果的 **OH_NativeBuffer** 缓冲区对象的指针。 | 2064 2065**返回：** 2066 2067如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2068 2069 2070### OH_ImageNative_GetComponentTypes() 2071 2072``` 2073Image_ErrorCode OH_ImageNative_GetComponentTypes(OH_ImageNative *image, uint32_t **types, size_t *typeSize) 2074``` 2075**描述** 2076获取Native [OH_ImageNative](#oh_imagenative) 对象的组件列表信息。 2077 2078**起始版本：** 12 2079 2080**参数：** 2081 2082| 名称 | 描述 | 2083| -------- | -------- | 2084| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2085| types | 表示作为获取结果的组件列表对象的指针。 | 2086| typeSize | 表示作为获取结果的组件列表中，元素个数的指针。 | 2087 2088**返回：** 2089 2090如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2091 2092 2093### OH_ImageNative_GetImageSize() 2094 2095``` 2096Image_ErrorCode OH_ImageNative_GetImageSize(OH_ImageNative *image, Image_Size *size) 2097``` 2098**描述** 2099获取Native [OH_ImageNative](#oh_imagenative) 对象的 [Image_Size](_image___size.md) 信息。如果[OH_ImageNative](#oh_imagenative) 对象所存储的是相机预览流数据，即YUV图像数据，那么获取到的[Image_Size](_image___size.md)中的宽高分别对应YUV图像的宽高；如果[OH_ImageNative](#oh_imagenative) 对象所存储的是相机拍照流数据，即JPEG图像，由于已经是编码后的数据，[Image_Size](_image___size.md)中的宽等于JPEG数据大小，高等于1。[OH_ImageNative](#oh_imagenative) 对象所存储的数据是预览流还是拍照流，取决于应用将receiver中的surfaceId传给相机的previewOutput还是captureOutput。相机预览与拍照最佳实践请参考[预览流二次处理(C/C++)](../../media/camera/native-camera-preview-imageReceiver.md)与[拍照(C/C++)](../../media/camera/native-camera-shooting.md)。 2100 2101**起始版本：** 12 2102 2103**参数：** 2104 2105| 名称 | 描述 | 2106| -------- | -------- | 2107| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2108| size | 表示作为获取结果的 [Image_Size](_image___size.md) 对象的指针。 | 2109 2110**返回：** 2111 2112如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 如果未知原因错误返回 IMAGE_UNKNOWN_ERROR； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2113 2114 2115### OH_ImageNative_GetPixelStride() 2116 2117``` 2118Image_ErrorCode OH_ImageNative_GetPixelStride(OH_ImageNative *image, uint32_t componentType, int32_t *pixelStride) 2119``` 2120**描述** 2121获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的像素大小。 2122 2123**起始版本：** 12 2124 2125**参数：** 2126 2127| 名称 | 描述 | 2128| -------- | -------- | 2129| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2130| componentType | 表示组件的类型。 | 2131| pixelStride | 表示作为获取结果的像素大小的指针。 | 2132 2133**返回：** 2134 2135如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2136 2137 2138### OH_ImageNative_GetRowStride() 2139 2140``` 2141Image_ErrorCode OH_ImageNative_GetRowStride(OH_ImageNative *image, uint32_t componentType, int32_t *rowStride) 2142``` 2143**描述** 2144获取Native [OH_ImageNative](#oh_imagenative) 对象中某个组件类型所对应的像素行宽。读取相机预览流数据时，需要考虑按stride进行读取，具体用法见[C/C++预览流二次处理示例](../../media/camera/native-camera-preview-imageReceiver.md)。 2145 2146**起始版本：** 12 2147 2148**参数：** 2149 2150| 名称 | 描述 | 2151| -------- | -------- | 2152| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2153| componentType | 表示组件的类型。 | 2154| rowStride | 表示作为获取结果的像素行宽的指针。 | 2155 2156**返回：** 2157 2158如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2159 2160 2161### OH_ImageNative_GetTimestamp() 2162 2163``` 2164Image_ErrorCode OH_ImageNative_GetTimestamp(OH_ImageNative *image, int64_t *timestamp) 2165``` 2166**描述** 2167获取Native [OH_ImageNative](#oh_imagenative) 对象中的时间戳信息。时间戳以纳秒为单位，通常是单调递增的。时间戳的具体含义和基准取决于图像的生产者，在相机预览/拍照场景，生产者就是相机。来自不同生产者的图像的时间戳可能有不同的含义和基准，因此可能无法进行比较。 2168如果要获取某张照片的生成时间，可以通过[OH_ImageSourceNative_GetImageProperty](#oh_imagesourcenative_getimageproperty)接口读取相关的EXIF信息。 2169 2170**起始版本：** 12 2171 2172**参数：** 2173 2174| 名称 | 描述 | 2175| -------- | -------- | 2176| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2177| timestamp | 表示作为获取结果的时间戳信息的指针。 | 2178 2179**返回：** 2180 2181如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2182 2183 2184### OH_ImageNative_Release() 2185 2186``` 2187Image_ErrorCode OH_ImageNative_Release(OH_ImageNative *image) 2188``` 2189**描述** 2190释放Native [OH_ImageNative](#oh_imagenative) 对象。 2191 2192**起始版本：** 12 2193 2194**参数：** 2195 2196| 名称 | 描述 | 2197| -------- | -------- | 2198| image | 表示 [OH_ImageNative](#oh_imagenative) native对象的指针。 | 2199 2200**返回：** 2201 2202如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2203 2204 2205### OH_ImagePackerNative_Create() 2206 2207``` 2208Image_ErrorCode OH_ImagePackerNative_Create(OH_ImagePackerNative **imagePacker) 2209``` 2210**描述** 2211创建OH_ImagePackerNative指针。 2212 2213**起始版本：** 12 2214 2215**参数：** 2216 2217| 名称 | 描述 | 2218| -------- | -------- | 2219| options | 被操作的OH_ImagePackerNative指针。 | 2220 2221**返回：** 2222 2223如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2224 2225 2226### OH_ImagePackerNative_PackToDataFromImageSource() 2227 2228``` 2229Image_ErrorCode OH_ImagePackerNative_PackToDataFromImageSource(OH_ImagePackerNative *imagePacker, OH_PackingOptions *options, OH_ImageSourceNative *imageSource, uint8_t *outData, size_t *size) 2230``` 2231**描述** 2232将ImageSource编码为指定格式的数据。 2233 2234**起始版本：** 12 2235 2236**参数：** 2237 2238| 名称 | 描述 | 2239| -------- | -------- | 2240| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2241| options | 编码选项参数 [OH_PackingOptions](#oh_packingoptions)。 | 2242| imageSource | 用于编码的image source指针。 | 2243| outData | 用于存储编码图像输出数据的缓冲区。 | 2244| size | 用于存储编码图像输出数据的缓冲区大小。 | 2245 2246**返回：** 2247 2248如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码失败返回 IMAGE_DECODE_FAILED，如果申请内存失败返回 IMAGE_ALLOC_FAILED， 如果数据或图片过大返回 IMAGE_TOO_LARGE，如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2249 2250 2251### OH_ImagePackerNative_PackToDataFromPicture() 2252 2253``` 2254Image_ErrorCode OH_ImagePackerNative_PackToDataFromPicture(OH_ImagePackerNative *imagePacker, OH_PackingOptions *options, OH_PictureNative *picture, uint8_t *outData, size_t *size) 2255``` 2256**描述** 2257将Picture编码为指定格式的数据。 2258 2259**起始版本：** 13 2260 2261**参数：** 2262 2263| 名称 | 描述 | 2264| -------- | -------- | 2265| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2266| options | 编码选项参数 [OH_PackingOptions](#oh_packingoptions)。 | 2267| picture | 用于编码的Picture指针。 | 2268| outData | 用于存储编码图像输出数据的缓冲区。 | 2269| size | 用于存储编码图像输出数据的缓冲区大小。 | 2270 2271**返回：** 2272 2273如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码失败返回 IMAGE_DECODE_FAILED，具体请参考 [Image_ErrorCode](#image_errorcode)。 2274 2275 2276### OH_ImagePackerNative_PackToDataFromPixelmap() 2277 2278``` 2279Image_ErrorCode OH_ImagePackerNative_PackToDataFromPixelmap(OH_ImagePackerNative *imagePacker, OH_PackingOptions *options, OH_PixelmapNative *pixelmap, uint8_t *outData, size_t *size) 2280``` 2281**描述** 2282将Pixelmap编码为指定格式的数据。 2283 2284**起始版本：** 12 2285 2286**参数：** 2287 2288| 名称 | 描述 | 2289| -------- | -------- | 2290| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2291| options | 编码选项参数 [OH_PackingOptions](#oh_packingoptions)。 | 2292| pixelmap | 用于编码的Pixelmap指针。 | 2293| outData | 用于存储编码图像输出数据的缓冲区。 | 2294| size | 用于存储编码图像输出数据的缓冲区大小。 | 2295 2296**返回：** 2297 2298如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码失败返回 IMAGE_DECODE_FAILED，如果申请内存失败返回 IMAGE_ALLOC_FAILED， 如果数据或图片过大返回 IMAGE_TOO_LARGE，如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2299 2300 2301### OH_ImagePackerNative_PackToDataFromPixelmapSequence() 2302 2303``` 2304Image_ErrorCode OH_ImagePackerNative_PackToDataFromPixelmapSequence(OH_ImagePackerNative *imagePacker, OH_PackingOptionsForSequence *options, OH_PixelmapNative **pixelmapSequence, size_t sequenceLength, uint8_t *outData, size_t *outDataSize) 2305``` 2306**描述** 2307将Pixelmap序列编码为数据。 2308 2309**起始版本：** 18 2310 2311**参数：** 2312 2313| 名称 | 描述 | 2314| -------- | -------- | 2315| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2316| options | 编码选项参数 [OH_PackingOptionsForSequence](#oh_packingoptionsforsequence)。 | 2317| pixelmapSequence | 用于编码的Pixelmap序列指针。 | 2318| sequenceLength | 用于编码的Pixelmap序列长度。 | 2319| outData | 用于存储编码后图像输出数据的缓冲区。 | 2320| outDataSize | 用于存储编码后图像输出数据的缓冲区大小。 | 2321 2322**返回：** 2323 2324如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，如果解码失败返回 IMAGE_DECODE_FAILED， 具体请参考[Image_ErrorCode](#image_errorcode)。 2325 2326 2327### OH_ImagePackerNative_PackToFileFromImageSource() 2328 2329``` 2330Image_ErrorCode OH_ImagePackerNative_PackToFileFromImageSource(OH_ImagePackerNative *imagePacker, OH_PackingOptions *options, OH_ImageSourceNative *imageSource, int32_t fd) 2331``` 2332**描述** 2333将一个ImageSource编码到文件中。 2334 2335**起始版本：** 12 2336 2337**参数：** 2338 2339| 名称 | 描述 | 2340| -------- | -------- | 2341| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2342| options | 编码选项参数 [OH_PackingOptions](#oh_packingoptions)。 | 2343| imageSource | 用于编码的image source指针。 | 2344| fd | 可写的文件描述符。 | 2345 2346**返回：** 2347 2348如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码失败返回 IMAGE_DECODE_FAILED，如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2349 2350 2351### OH_ImagePackerNative_PackToFileFromPicture() 2352 2353``` 2354Image_ErrorCode OH_ImagePackerNative_PackToFileFromPicture(OH_ImagePackerNative *imagePacker, OH_PackingOptions *options, OH_PictureNative *picture, int32_t fd) 2355``` 2356**描述** 2357将一个Picture编码到文件中。 2358 2359**起始版本：** 13 2360 2361**参数：** 2362 2363| 名称 | 描述 | 2364| -------- | -------- | 2365| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2366| options | 编码选项参数 [OH_PackingOptions](#oh_packingoptions)。 | 2367| picture | 用于编码的picture指针。 | 2368| fd | 可写的文件描述符。 | 2369 2370**返回：** 2371 2372如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码失败返回 IMAGE_DECODE_FAILED，如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2373 2374 2375### OH_ImagePackerNative_PackToFileFromPixelmap() 2376 2377``` 2378Image_ErrorCode OH_ImagePackerNative_PackToFileFromPixelmap(OH_ImagePackerNative *imagePacker, OH_PackingOptions *options, OH_PixelmapNative *pixelmap, int32_t fd) 2379``` 2380**描述** 2381将一个Pixelmap编码到文件中。 2382 2383**起始版本：** 12 2384 2385**参数：** 2386 2387| 名称 | 描述 | 2388| -------- | -------- | 2389| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2390| options | 编码选项参数 [OH_PackingOptions](#oh_packingoptions)。 | 2391| pixelmap | 用于编码的pixelmap指针。 | 2392| fd | 可写的文件描述符。 | 2393 2394**返回：** 2395 2396如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码失败返回 IMAGE_DECODE_FAILED，如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2397 2398 2399### OH_ImagePackerNative_PackToFileFromPixelmapSequence() 2400 2401``` 2402Image_ErrorCode OH_ImagePackerNative_PackToFileFromPixelmapSequence(OH_ImagePackerNative *imagePacker, OH_PackingOptionsForSequence *options, OH_PixelmapNative **pixelmapSequence, size_t sequenceLength, int32_t fd) 2403``` 2404**描述** 2405将一个Pixelmap序列编码到文件中。 2406 2407**起始版本：** 18 2408 2409**参数：** 2410 2411| 名称 | 描述 | 2412| -------- | -------- | 2413| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2414| options | 编码选项参数 [OH_PackingOptionsForSequence](#oh_packingoptionsforsequence)。 | 2415| pixelmapSequence | 用于编码的Pixelmap序列指针。 | 2416| sequenceLength | 用于编码的Pixelmap序列长度。 | 2417| fd | 可写的文件描述符。 | 2418 2419**返回：** 2420 2421如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，如果解码失败返回 IMAGE_DECODE_FAILED， 具体请参考[Image_ErrorCode](#image_errorcode)。 2422 2423 2424### OH_ImagePackerNative_Release() 2425 2426``` 2427Image_ErrorCode OH_ImagePackerNative_Release(OH_ImagePackerNative *imagePacker) 2428``` 2429**描述** 2430释放OH_ImagePackerNative指针。 2431 2432**起始版本：** 12 2433 2434**参数：** 2435 2436| 名称 | 描述 | 2437| -------- | -------- | 2438| imagePacker | 被操作的OH_ImagePackerNative指针。 | 2439 2440**返回：** 2441 2442如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2443 2444 2445### OH_ImageReceiverNative_Create() 2446 2447``` 2448Image_ErrorCode OH_ImageReceiverNative_Create(OH_ImageReceiverOptions* options, OH_ImageReceiverNative** receiver) 2449``` 2450**描述** 2451创建应用层 OH_ImageReceiverNative 对象。 2452 2453**起始版本：** 12 2454 2455**参数：** 2456 2457| 名称 | 描述 | 2458| -------- | -------- | 2459| options | 表示 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2460| receiver | 表示作为获取结果的 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2461 2462**返回：** 2463 2464如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 如果申请内存失败返回 IMAGE_ALLOC_FAILED； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2465 2466 2467### OH_ImageReceiverNative_GetCapacity() 2468 2469``` 2470Image_ErrorCode OH_ImageReceiverNative_GetCapacity(OH_ImageReceiverNative* receiver, int32_t* capacity) 2471``` 2472**描述** 2473通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取ImageReceiver的容量。 2474 2475**起始版本：** 12 2476 2477**参数：** 2478 2479| 名称 | 描述 | 2480| -------- | -------- | 2481| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2482| capacity | 表示作为获取结果的图片缓存容量对象的指针。 | 2483 2484**返回：** 2485 2486如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2487 2488**参见：** 2489 2490[OH_ImageReceiverNative](#oh_imagereceivernative) 2491 2492 2493### OH_ImageReceiverNative_GetReceivingSurfaceId() 2494 2495``` 2496Image_ErrorCode OH_ImageReceiverNative_GetReceivingSurfaceId(OH_ImageReceiverNative* receiver, uint64_t* surfaceId) 2497``` 2498**描述** 2499通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取receiver的id。 2500 2501**起始版本：** 12 2502 2503**参数：** 2504 2505| 名称 | 描述 | 2506| -------- | -------- | 2507| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2508| surfaceId | 表示作为获取结果的id对象的指针。 | 2509 2510**返回：** 2511 2512如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 如果未知原因错误返回 IMAGE_UNKNOWN_ERROR； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2513 2514**参见：** 2515 2516[OH_ImageReceiverNative](#oh_imagereceivernative) 2517 2518 2519### OH_ImageReceiverNative_GetSize() 2520 2521``` 2522Image_ErrorCode OH_ImageReceiverNative_GetSize(OH_ImageReceiverNative* receiver, Image_Size* size) 2523``` 2524**描述** 2525通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取ImageReceiver的大小。 2526 2527**起始版本：** 12 2528 2529**参数：** 2530 2531| 名称 | 描述 | 2532| -------- | -------- | 2533| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2534| size | 表示作为获取结果的 [Image_Size](_image___size.md) 对象的指针。 | 2535 2536**返回：** 2537 2538如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2539 2540**参见：** 2541 2542[OH_ImageReceiverNative](#oh_imagereceivernative), [Image_Size](_image___size.md) 2543 2544 2545### OH_ImageReceiverNative_Off() 2546 2547``` 2548Image_ErrorCode OH_ImageReceiverNative_Off(OH_ImageReceiverNative* receiver) 2549``` 2550**描述** 2551关闭[OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)回调事件。 2552 2553关闭被 [OH_ImageReceiverNative_On](#oh_imagereceivernative_on) 开启的回调事件。 2554 2555**起始版本：** 12 2556 2557**参数：** 2558 2559| 名称 | 描述 | 2560| -------- | -------- | 2561| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2562 2563**返回：** 2564 2565如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2566 2567**参见：** 2568 2569[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageReceiverNative_On](#oh_imagereceivernative_on) 2570 2571 2572### OH_ImageReceiverNative_On() 2573 2574``` 2575Image_ErrorCode OH_ImageReceiverNative_On(OH_ImageReceiverNative* receiver, OH_ImageReceiver_OnCallback callback) 2576``` 2577**描述** 2578注册一个[OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)回调事件。 2579 2580每当接收到新的图片，该回调事件就会响应。 2581 2582**起始版本：** 12 2583 2584**参数：** 2585 2586| 名称 | 描述 | 2587| -------- | -------- | 2588| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2589| callback | 表示 [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) 事件的回调函数。 | 2590 2591**返回：** 2592 2593如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2594 2595**参见：** 2596 2597[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) 2598 2599 2600### OH_ImageReceiverNative_ReadLatestImage() 2601 2602``` 2603Image_ErrorCode OH_ImageReceiverNative_ReadLatestImage(OH_ImageReceiverNative* receiver, OH_ImageNative** image) 2604``` 2605**描述** 2606通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取最新的一张图片。 2607 2608**注意**：此接口需要在[OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)回调后调用，才能正常的接收到数据。并且此接口返回的[OH_ImageNative](#oh_imagenative)使用完毕后需要调用[OH_ImageNative_Release](#oh_imagenative_release)方法释放，释放后才可以继续接收新的数据。 2609 2610**起始版本：** 12 2611 2612**参数：** 2613 2614| 名称 | 描述 | 2615| -------- | -------- | 2616| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2617| image | 获取到的应用层的 OH_ImageNative 指针对象。 | 2618 2619**返回：** 2620 2621如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 如果未知原因错误返回 IMAGE_UNKNOWN_ERROR； 如果申请内存失败返回 IMAGE_ALLOC_FAILED； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2622 2623**参见：** 2624 2625[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageNative](#oh_imagenative) 2626 2627 2628### OH_ImageReceiverNative_ReadNextImage() 2629 2630``` 2631Image_ErrorCode OH_ImageReceiverNative_ReadNextImage(OH_ImageReceiverNative* receiver, OH_ImageNative** image) 2632``` 2633**描述** 2634通过[OH_ImageReceiverNative](#oh_imagereceivernative)获取下一张图片。 2635 2636**注意**：此接口需要在[OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)回调后调用，才能正常的接收到数据。并且此接口返回的[OH_ImageNative](#oh_imagenative)使用完毕后需要调用[OH_ImageNative_Release](#oh_imagenative_release)方法释放，释放后才可以继续接收新的数据。 2637 2638**起始版本：** 12 2639 2640**参数：** 2641 2642| 名称 | 描述 | 2643| -------- | -------- | 2644| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2645| image | 获取到的应用层的 OH_ImageNative 指针对象。 | 2646 2647**返回：** 2648 2649如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 如果未知原因错误返回 IMAGE_UNKNOWN_ERROR； 如果申请内存失败返回 IMAGE_ALLOC_FAILED； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2650 2651**参见：** 2652 2653[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageNative](#oh_imagenative) 2654 2655 2656### OH_ImageReceiverNative_Release() 2657 2658``` 2659Image_ErrorCode OH_ImageReceiverNative_Release(OH_ImageReceiverNative* receiver) 2660``` 2661**描述** 2662释放Native [OH_ImageReceiverNative](#oh_imagereceivernative) 对象。 2663 2664**起始版本：** 12 2665 2666**参数：** 2667 2668| 名称 | 描述 | 2669| -------- | -------- | 2670| receiver | 表示 [OH_ImageReceiverNative](#oh_imagereceivernative) 对象的指针。 | 2671 2672**返回：** 2673 2674如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2675 2676**参见：** 2677 2678[OH_ImageReceiverNative](#oh_imagereceivernative) 2679 2680 2681### OH_ImageReceiverOptions_Create() 2682 2683``` 2684Image_ErrorCode OH_ImageReceiverOptions_Create(OH_ImageReceiverOptions **options) 2685``` 2686**描述** 2687创建应用层 OH_ImageReceiverOptions 对象。 2688 2689**起始版本：** 12 2690 2691**参数：** 2692 2693| 名称 | 描述 | 2694| -------- | -------- | 2695| options | 表示作为获取结果的 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2696 2697**返回：** 2698 2699如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 如果申请内存失败返回 IMAGE_ALLOC_FAILED； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2700 2701 2702### OH_ImageReceiverOptions_GetCapacity() 2703 2704``` 2705Image_ErrorCode OH_ImageReceiverOptions_GetCapacity(OH_ImageReceiverOptions* options, int32_t* capacity) 2706``` 2707**描述** 2708获取 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的图片缓存容量的信息。 2709 2710**起始版本：** 12 2711 2712**参数：** 2713 2714| 名称 | 描述 | 2715| -------- | -------- | 2716| options | 表示 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2717| capacity | 表示作为获取结果的图片缓存容量对象的指针。 | 2718 2719**返回：** 2720 2721如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2722 2723 2724### OH_ImageReceiverOptions_GetSize() 2725 2726``` 2727Image_ErrorCode OH_ImageReceiverOptions_GetSize(OH_ImageReceiverOptions* options, Image_Size* size) 2728``` 2729**描述** 2730获取 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的 [Image_Size](_image___size.md) 信息。 2731 2732**起始版本：** 12 2733 2734**参数：** 2735 2736| 名称 | 描述 | 2737| -------- | -------- | 2738| options | 表示 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2739| size | 表示作为获取结果的 [Image_Size](_image___size.md) 对象的指针。 | 2740 2741**返回：** 2742 2743如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2744 2745 2746### OH_ImageReceiverOptions_Release() 2747 2748``` 2749Image_ErrorCode OH_ImageReceiverOptions_Release(OH_ImageReceiverOptions* options) 2750``` 2751**描述** 2752释放 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象。 2753 2754**起始版本：** 12 2755 2756**参数：** 2757 2758| 名称 | 描述 | 2759| -------- | -------- | 2760| options | 表示 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2761 2762**返回：** 2763 2764如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2765 2766**参见：** 2767 2768[OH_ImageReceiverOptions](#oh_imagereceiveroptions) 2769 2770 2771### OH_ImageReceiverOptions_SetCapacity() 2772 2773``` 2774Image_ErrorCode OH_ImageReceiverOptions_SetCapacity(OH_ImageReceiverOptions* options, int32_t capacity) 2775``` 2776**描述** 2777设置 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的图片缓存容量的信息。 2778 2779**起始版本：** 12 2780 2781**参数：** 2782 2783| 名称 | 描述 | 2784| -------- | -------- | 2785| options | 表示 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2786| capacity | 表示图片缓存容量对象的指针。 | 2787 2788**返回：** 2789 2790如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2791 2792 2793### OH_ImageReceiverOptions_SetSize() 2794 2795``` 2796Image_ErrorCode OH_ImageReceiverOptions_SetSize(OH_ImageReceiverOptions* options, Image_Size size) 2797``` 2798**描述** 2799设置 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的 [Image_Size](_image___size.md) 信息。 2800 2801**起始版本：** 12 2802 2803**参数：** 2804 2805| 名称 | 描述 | 2806| -------- | -------- | 2807| options | 表示 [OH_ImageReceiverOptions](#oh_imagereceiveroptions) 对象的指针。 | 2808| size | 表示 [Image_Size](_image___size.md) 对象的指针。 | 2809 2810**返回：** 2811 2812如果操作成功返回 IMAGE_SUCCESS； 如果参数错误返回 IMAGE_BAD_PARAMETER； 具体释义参考[Image_ErrorCode](#image_errorcode)。 2813 2814 2815### OH_ImageSourceInfo_Create() 2816 2817``` 2818Image_ErrorCode OH_ImageSourceInfo_Create(OH_ImageSource_Info **info) 2819``` 2820**描述** 2821创建OH_ImageSource_Info指针。 2822 2823**起始版本：** 12 2824 2825**参数：** 2826 2827| 名称 | 描述 | 2828| -------- | -------- | 2829| info | 被操作的OH_ImageSource_Info指针。 | 2830 2831**返回：** 2832 2833如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2834 2835 2836### OH_ImageSourceInfo_GetDynamicRange() 2837 2838``` 2839Image_ErrorCode OH_ImageSourceInfo_GetDynamicRange(OH_ImageSource_Info *info, bool *isHdr) 2840``` 2841**描述** 2842获取图片是否为高动态范围的信息。 2843 2844**起始版本：** 12 2845 2846**参数：** 2847 2848| 名称 | 描述 | 2849| -------- | -------- | 2850| info | 被操作的OH_ImageSource_Info指针。 | 2851| isHdr | 是否为hdr的布尔值。 | 2852 2853**返回：** 2854 2855如果操作成功返回IMAGE_SUCCESS，参数校验错误返回IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 2856 2857 2858### OH_ImageSourceInfo_GetHeight() 2859 2860``` 2861Image_ErrorCode OH_ImageSourceInfo_GetHeight(OH_ImageSource_Info *info, uint32_t *height) 2862``` 2863**描述** 2864获取图片的高。 2865 2866**起始版本：** 12 2867 2868**参数：** 2869 2870| 名称 | 描述 | 2871| -------- | -------- | 2872| info | 被操作的OH_ImageSource_Info指针。 | 2873| height | 图片的高，单位：像素。 | 2874 2875**返回：** 2876 2877如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2878 2879 2880### OH_ImageSourceInfo_GetWidth() 2881 2882``` 2883Image_ErrorCode OH_ImageSourceInfo_GetWidth(OH_ImageSource_Info *info, uint32_t *width) 2884``` 2885**描述** 2886获取图片的宽。 2887 2888**起始版本：** 12 2889 2890**参数：** 2891 2892| 名称 | 描述 | 2893| -------- | -------- | 2894| info | 被操作的OH_ImageSource_Info指针。 | 2895| width | 图片的宽，单位：像素。 | 2896 2897**返回：** 2898 2899如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2900 2901 2902### OH_ImageSourceInfo_Release() 2903 2904``` 2905Image_ErrorCode OH_ImageSourceInfo_Release(OH_ImageSource_Info *info) 2906``` 2907**描述** 2908释放OH_ImageSource_Info指针。 2909 2910**起始版本：** 12 2911 2912**参数：** 2913 2914| 名称 | 描述 | 2915| -------- | -------- | 2916| info | 被操作的OH_ImageSource_Info指针。 | 2917 2918**返回：** 2919 2920如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2921 2922 2923### OH_ImageSourceNative_CreateFromData() 2924 2925``` 2926Image_ErrorCode OH_ImageSourceNative_CreateFromData(uint8_t *data, size_t dataSize, OH_ImageSourceNative **res) 2927``` 2928**描述** 2929通过缓冲区数据创建OH_ImageSourceNative指针。 2930 2931data数据应该是未解码的数据，不要传入类似于RBGA，YUV的像素buffer数据，如果想通过像素buffer数据创建pixelMap，可以调用[OH_PixelmapNative_CreatePixelmap](./pixelmap__native_8h.md)这一类接口。 2932 2933**起始版本：** 12 2934 2935**参数：** 2936 2937| 名称 | 描述 | 2938| -------- | -------- | 2939| data | 图像缓冲区数据。 | 2940| dataSize | 图像缓冲区数据长度。 | 2941| res | 指向c++本地层创建的OH_ImageSourceNative对象的指针。 | 2942 2943**返回：** 2944 2945如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码数据源异常返回 IMAGE_BAD_SOURCE， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2946 2947 2948### OH_ImageSourceNative_CreateFromFd() 2949 2950``` 2951Image_ErrorCode OH_ImageSourceNative_CreateFromFd(int32_t fd, OH_ImageSourceNative **res) 2952``` 2953**描述** 2954通过fd创建OH_ImageSourceNative指针。 2955 2956**起始版本：** 12 2957 2958**参数：** 2959 2960| 名称 | 描述 | 2961| -------- | -------- | 2962| fd | 文件描述符fd。 | 2963| res | 指向c++本地层创建的OH_ImageSourceNative对象的指针。 | 2964 2965**返回：** 2966 2967如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2968 2969 2970### OH_ImageSourceNative_CreateFromRawFile() 2971 2972``` 2973Image_ErrorCode OH_ImageSourceNative_CreateFromRawFile(RawFileDescriptor *rawFile, OH_ImageSourceNative **res) 2974``` 2975**描述** 2976通过图像资源文件的RawFileDescriptor创建OH_ImageSourceNative指针。 2977 2978**起始版本：** 12 2979 2980**参数：** 2981 2982| 名称 | 描述 | 2983| -------- | -------- | 2984| rawFile | 指示raw文件的文件描述符。 | 2985| res | 指向c++本地层创建的OH_ImageSourceNative对象的指针。 | 2986 2987**返回：** 2988 2989如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 2990 2991 2992### OH_ImageSourceNative_CreateFromUri() 2993 2994``` 2995Image_ErrorCode OH_ImageSourceNative_CreateFromUri(char *uri, size_t uriSize, OH_ImageSourceNative **res) 2996``` 2997**描述** 2998通过uri创建OH_ImageSourceNative指针。 2999 3000**起始版本：** 12 3001 3002**参数：** 3003 3004| 名称 | 描述 | 3005| -------- | -------- | 3006| uri | 指向图像源URI的指针。只接受文件URI或Base64 URI。当前文件资源只支持绝对路径。 | 3007| uriSize | URI长度。 | 3008| res | 指向c++本地层创建的OH_ImageSourceNative对象的指针。 | 3009 3010**返回：** 3011 3012如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果解码数据源异常返回 IMAGE_BAD_SOURCE， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3013 3014 3015### OH_ImageSourceNative_CreatePicture() 3016 3017``` 3018Image_ErrorCode OH_ImageSourceNative_CreatePicture(OH_ImageSourceNative *source, OH_DecodingOptionsForPicture *options, OH_PictureNative **picture) 3019``` 3020**描述** 3021通过图片解码创建OH_PictureNative指针。 3022 3023**起始版本：** 13 3024 3025**参数：** 3026 3027| 名称 | 描述 | 3028| -------- | -------- | 3029| source | 被操作的OH_ImageSourceNative指针。 | 3030| options | 解码参数。 | 3031| picture | 指向c++本地层创建的OH_PictureNative对象的指针。 | 3032 3033**返回：** 3034 3035如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 解码失败返回 IMAGE_DECODE_FAILED， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3036 3037 3038### OH_ImageSourceNative_CreatePixelmap() 3039 3040``` 3041Image_ErrorCode OH_ImageSourceNative_CreatePixelmap(OH_ImageSourceNative *source, OH_DecodingOptions *options, OH_PixelmapNative **resPixMap) 3042``` 3043**描述** 3044通过图片解码参数创建OH_PixelmapNative指针。 3045 3046**起始版本：** 12 3047 3048**参数：** 3049 3050| 名称 | 描述 | 3051| -------- | -------- | 3052| source | 被操作的OH_ImageSourceNative指针。 | 3053| options | 解码参数。 | 3054| resPixMap | 指向c++本地层创建的OH_PixelmapNative对象指针的指针。 | 3055 3056**返回：** 3057 3058如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3059 3060 3061### OH_ImageSourceNative_CreatePixelmapList() 3062 3063``` 3064Image_ErrorCode OH_ImageSourceNative_CreatePixelmapList(OH_ImageSourceNative *source, OH_DecodingOptions *options, OH_PixelmapNative *resVecPixMap[], size_t size) 3065``` 3066**描述** 3067通过图片解码参数创建OH_PixelmapNative数组。 3068 3069> **注意：** 3070> 此接口会一次性解码全部帧，当帧数过多或单帧图像过大时，会占用较大内存，造成系统内存紧张，此种情况推荐使用Image组件显示动图，Image组件采用逐帧解码，占用内存比此接口少。 3071 3072**起始版本：** 12 3073 3074**参数：** 3075 3076| 名称 | 描述 | 3077| -------- | -------- | 3078| source | 被操作的OH_ImageSourceNative指针。 | 3079| options | 解码参数。 | 3080| resVecPixMap | 指向c++本地层创建的OH_PixelmapNative对象的指针数组。 | 3081| size | 数组长度。 用户可以使用[OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount)获取。 | 3082 3083**返回：** 3084 3085如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果不支持的操作返回 IMAGE_UNSUPPORTED_OPERATION， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3086 3087 3088### OH_ImageSourceNative_CreatePixelmapUsingAllocator() 3089 3090``` 3091Image_ErrorCode OH_ImageSourceNative_CreatePixelmapUsingAllocator (OH_ImageSourceNative *source, OH_DecodingOptions *options, IMAGE_ALLOCATOR_TYPE allocator, OH_PixelmapNative **pixelmap ) 3092``` 3093 3094**描述** 3095 3096根据解码参数创建一个PixelMap，PixelMap使用的内存类型可以通过allocatorType来指定。 3097 3098默认情况下，系统会根据图像类型、图像大小、平台能力等选择内存类型。 在处理通过此接口返回的PixelMap时，请始终考虑步幅（stride）的影响。 3099 3100**起始版本：** 15 3101 3102**参数：** 3103 3104| 名称 | 描述 | 3105| -------- | -------- | 3106| source | 被操作的OH_ImageSourceNative指针。 | 3107| options | 解码参数。 详情请参见 [OH_DecodingOptions](#oh_decodingoptions)。 | 3108| allocator | 指示返回的PixelMap将使用哪种内存类型。 | 3109| pixelmap | 指向c++本地层创建的OH_PixelmapNative对象的指针。 | 3110 3111**返回：** 3112 3113错误码。 3114 3115如果操作成功返回 IMAGE_SUCCESS。 3116 3117如果参数错误返回 IMAGE_BAD_PARAMETER。 3118 3119如果数据源异常返回 IMAGE_BAD_SOURCE。 3120 3121如果是不支持的MIME类型返回 IMAGE_SOURCE_UNSUPPORTED_MIMETYPE。 3122 3123如果图像过大返回 IMAGE_SOURCE_TOO_LARGE。 3124 3125如果是不支持的分配器类型返回 IMAGE_SOURCE_UNSUPPORTED_ALLOCATOR_TYPE。 例如，使用共享内存解码HDR图像，因为只有DMA支持HDR元数据。 3126 3127如果是不支持的选项返回 IMAGE_SOURCE_UNSUPPORTED_OPTIONS。 例如，无法将图像转换为所需的像素格式。 3128 3129如果解码失败返回 IMAGE_DECODE_FAILED。 3130 3131如果内存分配失败返回 IMAGE_SOURCE_ALLOC_FAILED。 3132 3133具体请参考 [Image_ErrorCode](#image_errorcode)。 3134 3135 3136### OH_ImageSourceNative_GetDelayTimeList() 3137 3138``` 3139Image_ErrorCode OH_ImageSourceNative_GetDelayTimeList(OH_ImageSourceNative *source, int32_t *delayTimeList, size_t size) 3140``` 3141**描述** 3142获取图像延迟时间数组。 3143 3144**起始版本：** 12 3145 3146**参数：** 3147 3148| 名称 | 描述 | 3149| -------- | -------- | 3150| source | 被操作的OH_ImageSourceNative指针。 | 3151| delayTimeList | 指向获得的延迟时间列表的指针。它不能是空指针。 | 3152| size | delayTimeList的大小。用户可以从[OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount)获得大小。 | 3153 3154**返回：** 3155 3156如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3157 3158 3159### OH_ImageSourceNative_GetFrameCount() 3160 3161``` 3162Image_ErrorCode OH_ImageSourceNative_GetFrameCount(OH_ImageSourceNative *source, uint32_t *frameCount) 3163``` 3164**描述** 3165获取图像帧数。 3166 3167**起始版本：** 12 3168 3169**参数：** 3170 3171| 名称 | 描述 | 3172| -------- | -------- | 3173| source | 被操作的OH_ImageSourceNative指针。 | 3174| frameCount | 图像帧数。 | 3175 3176**返回：** 3177 3178如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3179 3180 3181### OH_ImageSourceNative_GetImageInfo() 3182 3183``` 3184Image_ErrorCode OH_ImageSourceNative_GetImageInfo(OH_ImageSourceNative *source, int32_t index, OH_ImageSource_Info *info) 3185``` 3186**描述** 3187获取指定序号的图片信息。 3188 3189**起始版本：** 12 3190 3191**参数：** 3192 3193| 名称 | 描述 | 3194| -------- | -------- | 3195| source | 被操作的OH_ImageSourceNative指针。 | 3196| index | 图片序号。对GIF图片可传入[0,N-1],N表示GIF的帧数。对只有一帧数据的图片格式，可传入0。 | 3197| info | 指向获取的图像源信息的OH_ImageSource_Info指针。 | 3198 3199**返回：** 3200 3201如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3202 3203 3204### OH_ImageSourceNative_GetImageProperty() 3205 3206``` 3207Image_ErrorCode OH_ImageSourceNative_GetImageProperty(OH_ImageSourceNative *source, Image_String *key, Image_String *value) 3208``` 3209**描述** 3210获取图片指定属性键的值。 3211 3212**起始版本：** 12 3213 3214**参数：** 3215 3216| 名称 | 描述 | 3217| -------- | -------- | 3218| source | 被操作的OH_ImageSourceNative指针。 | 3219| key | 指示指向属性的指针，详情请参见[Image_String](_image___string.md)，key的取值范围参考[OHOS_IMAGE_PROPERTY_XXX](#变量)定义。 使用ImageSource后释放，参见[OH_ImageSourceNative_Release](#oh_imagesourcenative_release)。 | 3220| value | 指向获取的值的指针。用户可以传入一个空指针和零大小， 我们将分配内存，但用户必须在使用后释放内存。 | 3221 3222**返回：** 3223 3224如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3225 3226 3227### OH_ImageSourceNative_ModifyImageProperty() 3228 3229``` 3230Image_ErrorCode OH_ImageSourceNative_ModifyImageProperty(OH_ImageSourceNative *source, Image_String *key, Image_String *value) 3231``` 3232**描述** 3233通过指定的键修改图片属性的值。 3234 3235**起始版本：** 12 3236 3237**参数：** 3238 3239| 名称 | 描述 | 3240| -------- | -------- | 3241| source | 被操作的OH_ImageSourceNative指针。 | 3242| key | 指向属性键的指针，详情请参见[Image_String](_image___string.md)，key是一个exif常数。 使用ImageSource后释放，参见[OH_ImageSourceNative_Release](#oh_imagesourcenative_release)。 | 3243| value | 需要修改的属性值。 | 3244 3245**返回：** 3246 3247如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3248 3249 3250### OH_ImageSourceNative_Release() 3251 3252``` 3253Image_ErrorCode OH_ImageSourceNative_Release(OH_ImageSourceNative *source) 3254``` 3255**描述** 3256释放OH_ImageSourceNative指针。 3257 3258**起始版本：** 12 3259 3260**参数：** 3261 3262| 名称 | 描述 | 3263| -------- | -------- | 3264| source | 要释放的OH_ImageSourceNative指针。 | 3265 3266**返回：** 3267 3268如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3269 3270 3271### OH_PackingOptions_Create() 3272 3273``` 3274Image_ErrorCode OH_PackingOptions_Create(OH_PackingOptions **options) 3275``` 3276**描述** 3277创建PackingOptions结构体的指针。 3278 3279**起始版本：** 12 3280 3281**参数：** 3282 3283| 名称 | 描述 | 3284| -------- | -------- | 3285| options | 用于操作的PackingOptions指针。 | 3286 3287**返回：** 3288 3289如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3290 3291 3292### OH_PackingOptions_GetDesiredDynamicRange() 3293 3294``` 3295Image_ErrorCode OH_PackingOptions_GetDesiredDynamicRange(OH_PackingOptions *options, int32_t* desiredDynamicRange) 3296``` 3297**描述** 3298获取编码时期望的图片动态范围。 3299 3300**起始版本：** 12 3301 3302**参数：** 3303 3304| 名称 | 描述 | 3305| -------- | -------- | 3306| options | 被操作的OH_PackingOptions指针。 | 3307| desiredDynamicRange | 期望的动态范围 [IMAGE_PACKER_DYNAMIC_RANGE](#image_packer_dynamic_range)。 | 3308 3309**返回：** 3310 3311如果操作成功返回IMAGE_SUCCESS，参数校验错误返回IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3312 3313 3314### OH_PackingOptions_GetMimeType() 3315 3316``` 3317Image_ErrorCode OH_PackingOptions_GetMimeType (OH_PackingOptions * options, Image_MimeType * format ) 3318``` 3319**描述** 3320获取MIME类型。 3321 3322**起始版本：** 12 3323 3324**参数：** 3325 3326| 名称 | 描述 | 3327| -------- | -------- | 3328| options | 被操作的OH_PackingOptions指针。 | 3329| format | 图像格式。可传入一个空指针和零大小，系统将分配内存，但必须在使用后释放内存。 | 3330 3331**返回：** 3332 3333如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3334 3335 3336### OH_PackingOptions_GetQuality() 3337 3338``` 3339Image_ErrorCode OH_PackingOptions_GetQuality(OH_PackingOptions *options, uint32_t *quality) 3340``` 3341**描述** 3342获取编码质量。 3343 3344**起始版本：** 12 3345 3346**参数：** 3347 3348| 名称 | 描述 | 3349| -------- | -------- | 3350| options | 被操作的OH_PackingOptions指针。 | 3351| quality | 编码质量。 | 3352 3353**返回：** 3354 3355如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3356 3357 3358### OH_PackingOptions_Release() 3359 3360``` 3361Image_ErrorCode OH_PackingOptions_Release(OH_PackingOptions *options) 3362``` 3363**描述** 3364释放OH_PackingOptions指针。 3365 3366**起始版本：** 12 3367 3368**参数：** 3369 3370| 名称 | 描述 | 3371| -------- | -------- | 3372| options | 被操作的OH_PackingOptions指针。 | 3373 3374**返回：** 3375 3376如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3377 3378 3379### OH_PackingOptions_SetDesiredDynamicRange() 3380 3381``` 3382Image_ErrorCode OH_PackingOptions_SetDesiredDynamicRange(OH_PackingOptions *options, int32_t desiredDynamicRange) 3383``` 3384**描述** 3385设置编码时期望的图片动态范围。 3386 3387**起始版本：** 12 3388 3389**参数：** 3390 3391| 名称 | 描述 | 3392| -------- | -------- | 3393| options | 被操作的OH_PackingOptions指针。 | 3394| desiredDynamicRange | 期望的动态范围 [IMAGE_PACKER_DYNAMIC_RANGE](#image_packer_dynamic_range)。 | 3395 3396**返回：** 3397 3398如果操作成功返回IMAGE_SUCCESS，参数校验错误返回IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3399 3400 3401### OH_PackingOptions_SetMimeType() 3402 3403``` 3404Image_ErrorCode OH_PackingOptions_SetMimeType(OH_PackingOptions *options, Image_MimeType *format) 3405``` 3406**描述** 3407设置MIME类型。 3408 3409**起始版本：** 12 3410 3411**参数：** 3412 3413| 名称 | 描述 | 3414| -------- | -------- | 3415| options | 被操作的OH_PackingOptions指针。 | 3416| format | 图像格式。 | 3417 3418**返回：** 3419 3420如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3421 3422 3423### OH_PackingOptions_SetQuality() 3424 3425``` 3426Image_ErrorCode OH_PackingOptions_SetQuality(OH_PackingOptions *options, uint32_t quality) 3427``` 3428**描述** 3429设置编码质量。 3430 3431**起始版本：** 12 3432 3433**参数：** 3434 3435| 名称 | 描述 | 3436| -------- | -------- | 3437| options | 被操作的OH_PackingOptions指针。 | 3438| quality | 编码质量。 | 3439 3440**返回：** 3441 3442如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3443 3444 3445### OH_PackingOptionsForSequence_Create() 3446 3447``` 3448Image_ErrorCode OH_PackingOptionsForSequence_Create(OH_PackingOptionsForSequence **options) 3449``` 3450**描述** 3451创建OH_PackingOptionsForSequence结构体的指针。 3452 3453**起始版本：** 18 3454 3455**参数：** 3456 3457| 名称 | 描述 | 3458| -------- | -------- | 3459| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3460 3461**返回：** 3462 3463如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3464 3465 3466### OH_PackingOptionsForSequence_GetDelayTimeList() 3467 3468``` 3469Image_ErrorCode OH_PackingOptionsForSequence_GetDelayTimeList(OH_PackingOptionsForSequence *options, int32_t *delayTimeList, size_t delayTimeListLength) 3470``` 3471**描述** 3472获取编码时图片的延迟时间数组。 3473 3474**起始版本：** 18 3475 3476**参数：** 3477 3478| 名称 | 描述 | 3479| -------- | -------- | 3480| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3481| delayTimeList | 图片延迟时间数组的指针。 | 3482| delayTimeListLength | 图片延迟时间数组的长度。 | 3483 3484**返回：** 3485 3486如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3487 3488 3489### OH_PackingOptionsForSequence_GetDisposalTypes() 3490 3491``` 3492Image_ErrorCode OH_PackingOptionsForSequence_GetDisposalTypes(OH_PackingOptionsForSequence *options, uint32_t *disposalTypes, size_t disposalTypesLength) 3493``` 3494**描述** 3495获取编码时图片的过渡帧模式数组。 3496 3497**起始版本：** 18 3498 3499**参数：** 3500 3501| 名称 | 描述 | 3502| -------- | -------- | 3503| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3504| disposalTypes | 图片过渡帧模式数组的指针。 | 3505| disposalTypesLength | 图片过渡帧模式数组的长度。 | 3506 3507**返回：** 3508 3509如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3510 3511 3512### OH_PackingOptionsForSequence_GetFrameCount() 3513 3514``` 3515Image_ErrorCode OH_PackingOptionsForSequence_GetFrameCount(OH_PackingOptionsForSequence *options, uint32_t *frameCount) 3516``` 3517**描述** 3518获取编码时指定的帧数。 3519 3520**起始版本：** 18 3521 3522**参数：** 3523 3524| 名称 | 描述 | 3525| -------- | -------- | 3526| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3527| frameCount | 图片的帧数。 | 3528 3529**返回：** 3530 3531如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3532 3533 3534### OH_PackingOptionsForSequence_GetLoopCount() 3535 3536``` 3537Image_ErrorCode OH_PackingOptionsForSequence_GetLoopCount(OH_PackingOptionsForSequence *options, uint32_t *loopCount) 3538``` 3539**描述** 3540获取编码时图片循环播放次数。 3541 3542**起始版本：** 18 3543 3544**参数：** 3545 3546| 名称 | 描述 | 3547| -------- | -------- | 3548| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3549| loopCount | 图片循环播放次数。 | 3550 3551**返回：** 3552 3553如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3554 3555 3556### OH_PackingOptionsForSequence_Release() 3557 3558``` 3559Image_ErrorCode OH_PackingOptionsForSequence_Release(OH_PackingOptionsForSequence *options) 3560``` 3561**描述** 3562释放OH_PackingOptionsForSequence指针。 3563 3564**起始版本：** 18 3565 3566**参数：** 3567 3568| 名称 | 描述 | 3569| -------- | -------- | 3570| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3571 3572**返回：** 3573 3574如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3575 3576 3577### OH_PackingOptionsForSequence_SetDelayTimeList() 3578 3579``` 3580Image_ErrorCode OH_PackingOptionsForSequence_SetDelayTimeList(OH_PackingOptionsForSequence *options, int32_t *delayTimeList, size_t delayTimeListLength) 3581``` 3582**描述** 3583设定编码时图片的延迟时间数组。 3584 3585**起始版本：** 18 3586 3587**参数：** 3588 3589| 名称 | 描述 | 3590| -------- | -------- | 3591| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3592| delayTimeList | 图片延迟时间数组的指针，每帧输出图像的延迟时间，取值需大于0。<br>- 单位为10毫秒。例如，取值为10时，实际单帧延迟是100毫秒。<br>- 如果长度小于frameCount，不足的部分将使用delayTimeList中的最后一个值进行填充。| 3593| delayTimeListLength | 图片延迟时间数组的长度。 | 3594 3595**返回：** 3596 3597如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3598 3599 3600### OH_PackingOptionsForSequence_SetDisposalTypes() 3601 3602``` 3603Image_ErrorCode OH_PackingOptionsForSequence_SetDisposalTypes(OH_PackingOptionsForSequence *options, uint32_t *disposalTypes, size_t disposalTypesLength) 3604``` 3605**描述** 3606设定编码时图片的过渡帧模式数组。 3607 3608**起始版本：** 18 3609 3610**参数：** 3611 3612| 名称 | 描述 | 3613| -------- | -------- | 3614| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3615| disposalTypes | 图片过渡帧模式数组的指针，图片帧过渡模式的参数，如果长度小于frameCount，不足的部分将使用disposalTypes中的最后一个值进行填充，可取值如下：<br>- 0：不需要任何操作。<br>- 1：保持图形不变。<br>- 2：恢复背景色。<br>- 3：恢复到之前的状态。| 3616| disposalTypesLength | 图片过渡帧模式数组的长度。 | 3617 3618**返回：** 3619 3620如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3621 3622 3623### OH_PackingOptionsForSequence_SetFrameCount() 3624 3625``` 3626mage_ErrorCode OH_PackingOptionsForSequence_SetFrameCount(OH_PackingOptionsForSequence *options, uint32_t frameCount) 3627``` 3628**描述** 3629设置编码时指定的帧数。 3630 3631**起始版本：** 18 3632 3633**参数：** 3634 3635| 名称 | 描述 | 3636| -------- | -------- | 3637| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3638| frameCount | 图片的帧数。 | 3639 3640**返回：** 3641 3642如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3643 3644 3645### OH_PackingOptionsForSequence_SetLoopCount() 3646 3647``` 3648Image_ErrorCode OH_PackingOptionsForSequence_SetLoopCount(OH_PackingOptionsForSequence *options, uint32_t loopCount) 3649``` 3650**描述** 3651设定编码时图片循环播放次数，取值范围为[0，65535]，<br>0表示无限循环；若无此字段，则表示不循环播放。 3652 3653**起始版本：** 18 3654 3655**参数：** 3656 3657| 名称 | 描述 | 3658| -------- | -------- | 3659| options | 用于操作的OH_PackingOptionsForSequence指针。 | 3660| loopCount | 图片循环播放次数。 | 3661 3662**返回：** 3663 3664如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 3665 3666 3667### OH_PictureMetadata_Clone() 3668 3669``` 3670Image_ErrorCode OH_PictureMetadata_Clone(OH_PictureMetadata *oldMetadata, OH_PictureMetadata **newMetadata) 3671``` 3672**描述** 3673拷贝元数据。 3674 3675**起始版本：** 13 3676 3677**参数：** 3678 3679| 名称 | 描述 | 3680| -------- | -------- | 3681| oldMetadata | 被操作的OH_PictureMetadata指针。 | 3682| newMetadata | 拷贝得到的OH_PictureMetadata指针。 | 3683 3684**返回：** 3685 3686如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果内存分配失败返回 IMAGE_ALLOC_FAILED，如果内存拷贝失败返回 IMAGE_COPY_FAILED， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3687 3688 3689### OH_PictureMetadata_Create() 3690 3691``` 3692Image_ErrorCode OH_PictureMetadata_Create(Image_MetadataType metadataType, OH_PictureMetadata **metadata) 3693``` 3694**描述** 3695创建OH_PictureMetadata指针。 3696 3697**起始版本：** 13 3698 3699**参数：** 3700 3701| 名称 | 描述 | 3702| -------- | -------- | 3703| metadataType | 元数据的类型。 | 3704| metadata | 被操作的OH_PictureMetadata指针。 | 3705 3706**返回：** 3707 3708如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3709 3710 3711### OH_PictureMetadata_GetProperty() 3712 3713``` 3714Image_ErrorCode OH_PictureMetadata_GetProperty(OH_PictureMetadata *metadata, Image_String *key, Image_String *value) 3715``` 3716**描述** 3717根据key获取Metadata的单条属性。 3718 3719**起始版本：** 13 3720 3721**参数：** 3722 3723| 名称 | 描述 | 3724| -------- | -------- | 3725| metadata | 被操作的OH_PictureMetadata指针。 | 3726| key | 属性的键。 | 3727| value | 属性的值。 | 3728 3729**返回：** 3730 3731如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的元数据类型或元数据类型与辅助图类型不匹配返回 IMAGE_UNSUPPORTED_METADATA， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3732 3733 3734### OH_PictureMetadata_Release() 3735 3736``` 3737Image_ErrorCode OH_PictureMetadata_Release(OH_PictureMetadata *metadata) 3738``` 3739**描述** 3740释放OH_PictureMetadata指针。 3741 3742**起始版本：** 13 3743 3744**参数：** 3745 3746| 名称 | 描述 | 3747| -------- | -------- | 3748| metadata | 被操作的OH_PictureMetadata指针。 | 3749 3750**返回：** 3751 3752如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3753 3754 3755### OH_PictureMetadata_SetProperty() 3756 3757``` 3758Image_ErrorCode OH_PictureMetadata_SetProperty(OH_PictureMetadata *metadata, Image_String *key, Image_String *value) 3759``` 3760**描述** 3761根据key修改Metadata的单条属性。 3762 3763**起始版本：** 13 3764 3765**参数：** 3766 3767| 名称 | 描述 | 3768| -------- | -------- | 3769| metadata | 被操作的OH_PictureMetadata指针。 | 3770| key | 属性的键。 | 3771| value | 属性的值。 | 3772 3773**返回：** 3774 3775如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的元数据类型或元数据类型与辅助图类型不匹配返回 IMAGE_UNSUPPORTED_METADATA， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3776 3777 3778### OH_PictureNative_CreatePicture() 3779 3780``` 3781Image_ErrorCode OH_PictureNative_CreatePicture(OH_PixelmapNative *mainPixelmap, OH_PictureNative **picture) 3782``` 3783**描述** 3784创建OH_PictureNative指针。 3785 3786**起始版本：** 13 3787 3788**参数：** 3789 3790| 名称 | 描述 | 3791| -------- | -------- | 3792| mainPixelmap | 主图的OH_PixelmapNative指针。 | 3793| picture | 被创建的OH_PictureNative指针。 | 3794 3795**返回：** 3796 3797如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3798 3799 3800### OH_PictureNative_GetAuxiliaryPicture() 3801 3802``` 3803Image_ErrorCode OH_PictureNative_GetAuxiliaryPicture(OH_PictureNative *picture, Image_AuxiliaryPictureType type, OH_AuxiliaryPictureNative **auxiliaryPicture) 3804``` 3805**描述** 3806根据类型获取辅助图。 3807 3808**起始版本：** 13 3809 3810**参数：** 3811 3812| 名称 | 描述 | 3813| -------- | -------- | 3814| picture | 被操作的OH_PictureNative指针。 | 3815| type | 辅助图类型。 | 3816| auxiliaryPicture | 获取的OH_AuxiliaryPictureNative指针。 | 3817 3818**返回：** 3819 3820如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3821 3822 3823### OH_PictureNative_GetGainmapPixelmap() 3824 3825``` 3826Image_ErrorCode OH_PictureNative_GetGainmapPixelmap(OH_PictureNative *picture, OH_PixelmapNative **gainmapPixelmap) 3827``` 3828**描述** 3829获取增益图的OH_PixelmapNative指针。 3830 3831**起始版本：** 13 3832 3833**参数：** 3834 3835| 名称 | 描述 | 3836| -------- | -------- | 3837| picture | 被操作的OH_PictureNative指针。 | 3838| gainmapPixelmap | 获取的增益图OH_PixelmapNative指针。 | 3839 3840**返回：** 3841 3842如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3843 3844 3845### OH_PictureNative_GetHdrComposedPixelmap() 3846 3847``` 3848Image_ErrorCode OH_PictureNative_GetHdrComposedPixelmap(OH_PictureNative *picture, OH_PixelmapNative **hdrPixelmap) 3849``` 3850**描述** 3851获取hdr图的OH_PixelmapNative指针。 3852 3853**起始版本：** 13 3854 3855**参数：** 3856 3857| 名称 | 描述 | 3858| -------- | -------- | 3859| picture | 被操作的OH_PictureNative指针。 | 3860| hdrPixelmap | 获取的hdr图OH_PixelmapNative指针。 | 3861 3862**返回：** 3863 3864如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的操作，例如picture对象中不包含增益图返回 IMAGE_UNSUPPORTED_OPERATION， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3865 3866 3867### OH_PictureNative_GetMainPixelmap() 3868 3869``` 3870Image_ErrorCode OH_PictureNative_GetMainPixelmap(OH_PictureNative *picture, OH_PixelmapNative **mainPixelmap) 3871``` 3872**描述** 3873获取主图的OH_PixelmapNative指针。 3874 3875**起始版本：** 13 3876 3877**参数：** 3878 3879| 名称 | 描述 | 3880| -------- | -------- | 3881| picture | 被操作的OH_PictureNative指针。 | 3882| mainPixelmap | 获取的OH_PixelmapNative指针。 | 3883 3884**返回：** 3885 3886如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3887 3888 3889### OH_PictureNative_GetMetadata() 3890 3891``` 3892Image_ErrorCode OH_PictureNative_GetMetadata(OH_PictureNative *picture, Image_MetadataType metadataType, OH_PictureMetadata **metadata) 3893``` 3894**描述** 3895获取主图的元数据。 3896 3897**起始版本：** 13 3898 3899**参数：** 3900 3901| 名称 | 描述 | 3902| -------- | -------- | 3903| picture | 被操作的OH_PictureNative指针。 | 3904| metadataType | 元数据类型。 | 3905| metadata | 主图的元数据。 | 3906 3907**返回：** 3908 3909如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的元数据类型返回 IMAGE_UNSUPPORTED_METADATA， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3910 3911 3912### OH_PictureNative_Release() 3913 3914``` 3915Image_ErrorCode OH_PictureNative_Release(OH_PictureNative *picture) 3916``` 3917**描述** 3918释放OH_PictureNative指针。 3919 3920**起始版本：** 13 3921 3922**参数：** 3923 3924| 名称 | 描述 | 3925| -------- | -------- | 3926| picture | 被操作的OH_PictureNative指针。 | 3927 3928**返回：** 3929 3930如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3931 3932 3933### OH_PictureNative_SetAuxiliaryPicture() 3934 3935``` 3936Image_ErrorCode OH_PictureNative_SetAuxiliaryPicture(OH_PictureNative *picture, Image_AuxiliaryPictureType type, OH_AuxiliaryPictureNative *auxiliaryPicture) 3937``` 3938**描述** 3939设置辅助图。 3940 3941**起始版本：** 13 3942 3943**参数：** 3944 3945| 名称 | 描述 | 3946| -------- | -------- | 3947| picture | 被操作的OH_PictureNative指针。 | 3948| type | 辅助图的类型。 | 3949| auxiliaryPicture | 设置的OH_AuxiliaryPictureNative指针。 | 3950 3951**返回：** 3952 3953如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3954 3955 3956### OH_PictureNative_SetMetadata() 3957 3958``` 3959Image_ErrorCode OH_PictureNative_SetMetadata(OH_PictureNative *picture, Image_MetadataType metadataType, OH_PictureMetadata *metadata) 3960``` 3961**描述** 3962设置主图的元数据。 3963 3964**起始版本：** 13 3965 3966**参数：** 3967 3968| 名称 | 描述 | 3969| -------- | -------- | 3970| picture | 被操作的OH_PictureNative指针。 | 3971| metadataType | 元数据类型。 | 3972| metadata | 将设置的元数据。 | 3973 3974**返回：** 3975 3976如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果是不支持的元数据类型返回 IMAGE_UNSUPPORTED_METADATA， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3977 3978 3979### OH_PixelmapImageInfo_Create() 3980 3981``` 3982Image_ErrorCode OH_PixelmapImageInfo_Create(OH_Pixelmap_ImageInfo **info) 3983``` 3984**描述** 3985创建OH_Pixelmap_ImageInfo指针。 3986 3987**起始版本：** 12 3988 3989**参数：** 3990 3991| 名称 | 描述 | 3992| -------- | -------- | 3993| info | 被创建的OH_Pixelmap_ImageInfo指针。 | 3994 3995**返回：** 3996 3997如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 3998 3999 4000### OH_PixelmapImageInfo_GetAlphaType() 4001 4002``` 4003Image_ErrorCode OH_PixelmapImageInfo_GetAlphaType(OH_Pixelmap_ImageInfo *info, int32_t *alphaType) 4004``` 4005**描述** 4006获取透明度类型。 4007 4008**起始版本：** 12 4009 4010**参数：** 4011 4012| 名称 | 描述 | 4013| -------- | -------- | 4014| info | 被操作的OH_Pixelmap_ImageInfo指针。 | 4015| alphaType | 透明度类型[PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type)。 | 4016 4017**返回：** 4018 4019如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4020 4021 4022### OH_PixelmapImageInfo_GetDynamicRange() 4023 4024``` 4025Image_ErrorCode OH_PixelmapImageInfo_GetDynamicRange(OH_Pixelmap_ImageInfo *info, bool *isHdr) 4026``` 4027**描述** 4028获取Pixelmap是否为高动态范围的信息。 4029 4030**起始版本：** 12 4031 4032**参数：** 4033 4034| 名称 | 描述 | 4035| -------- | -------- | 4036| info | 被操作的OH_Pixelmap_ImageInfo指针。 | 4037| isHdr | 是否为hdr的布尔值。 | 4038 4039**返回：** 4040 4041如果操作成功返回IMAGE_SUCCESS，参数校验错误返回IMAGE_BAD_PARAMETER。具体请参考[Image_ErrorCode](#image_errorcode)。 4042 4043 4044### OH_PixelmapImageInfo_GetHeight() 4045 4046``` 4047Image_ErrorCode OH_PixelmapImageInfo_GetHeight(OH_Pixelmap_ImageInfo *info, uint32_t *height) 4048``` 4049**描述** 4050获取图片高。 4051 4052**起始版本：** 12 4053 4054**参数：** 4055 4056| 名称 | 描述 | 4057| -------- | -------- | 4058| info | 被操作的OH_Pixelmap_ImageInfo指针。 | 4059| height | 图片高，单位：像素。 | 4060 4061**返回：** 4062 4063如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4064 4065 4066### OH_PixelmapImageInfo_GetPixelFormat() 4067 4068``` 4069Image_ErrorCode OH_PixelmapImageInfo_GetPixelFormat(OH_Pixelmap_ImageInfo *info, int32_t *pixelFormat) 4070``` 4071**描述** 4072获取像素格式。 4073 4074**起始版本：** 12 4075 4076**参数：** 4077 4078| 名称 | 描述 | 4079| -------- | -------- | 4080| info | 被操作的OH_Pixelmap_ImageInfo指针。 | 4081| pixelFormat | 像素格式。 | 4082 4083**返回：** 4084 4085如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4086 4087 4088### OH_PixelmapImageInfo_GetRowStride() 4089 4090``` 4091Image_ErrorCode OH_PixelmapImageInfo_GetRowStride(OH_Pixelmap_ImageInfo *info, uint32_t *rowStride) 4092``` 4093**描述** 4094获取行跨距。 4095 4096**起始版本：** 12 4097 4098**参数：** 4099 4100| 名称 | 描述 | 4101| -------- | -------- | 4102| info | 被操作的OH_Pixelmap_ImageInfo指针。 | 4103| rowStride | 跨距，内存中每行像素所占的空间。 | 4104 4105**返回：** 4106 4107如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4108 4109 4110### OH_PixelmapImageInfo_GetWidth() 4111 4112``` 4113Image_ErrorCode OH_PixelmapImageInfo_GetWidth(OH_Pixelmap_ImageInfo *info, uint32_t *width) 4114``` 4115**描述** 4116获取图片宽。 4117 4118**起始版本：** 12 4119 4120**参数：** 4121 4122| 名称 | 描述 | 4123| -------- | -------- | 4124| info | 被操作的OH_Pixelmap_ImageInfo指针。 | 4125| width | 图片宽，单位：像素。 | 4126 4127**返回：** 4128 4129如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4130 4131 4132### OH_PixelmapImageInfo_Release() 4133 4134``` 4135Image_ErrorCode OH_PixelmapImageInfo_Release(OH_Pixelmap_ImageInfo *info) 4136``` 4137**描述** 4138释放OH_Pixelmap_ImageInfo指针。 4139 4140**起始版本：** 12 4141 4142**参数：** 4143 4144| 名称 | 描述 | 4145| -------- | -------- | 4146| info | 被释放的OH_Pixelmap_ImageInfo指针。 | 4147 4148**返回：** 4149 4150如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4151 4152 4153### OH_PixelmapInitializationOptions_Create() 4154 4155``` 4156Image_ErrorCode OH_PixelmapInitializationOptions_Create(OH_Pixelmap_InitializationOptions **options) 4157``` 4158**描述** 4159创建OH_Pixelmap_InitializationOptions指针。 4160 4161**起始版本：** 12 4162 4163**参数：** 4164 4165| 名称 | 描述 | 4166| -------- | -------- | 4167| options | 被创建的OH_Pixelmap_InitializationOptions指针。 | 4168 4169**返回：** 4170 4171如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4172 4173 4174### OH_PixelmapInitializationOptions_GetAlphaType() 4175 4176``` 4177Image_ErrorCode OH_PixelmapInitializationOptions_GetAlphaType(OH_Pixelmap_InitializationOptions *options, int32_t *alphaType) 4178``` 4179**描述** 4180获取透明度类型。 4181 4182**起始版本：** 12 4183 4184**参数：** 4185 4186| 名称 | 描述 | 4187| -------- | -------- | 4188| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4189| alphaType | 透明度类型[PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type)。 | 4190 4191**返回：** 4192 4193如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4194 4195 4196### OH_PixelmapInitializationOptions_GetEditable() 4197 4198``` 4199Image_ErrorCode OH_PixelmapInitializationOptions_GetEditable(OH_Pixelmap_InitializationOptions *options, bool *editable) 4200``` 4201 4202**描述** 4203 4204获取可编辑标志。 4205 4206**起始版本：** 18 4207 4208**参数：** 4209 4210| 名称 | 描述 | 4211| -------- | -------- | 4212| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4213| editable | 可编辑标志。 | 4214 4215**返回：** 4216 4217如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，具体请参考 [Image_ErrorCode](#image_errorcode)。 4218 4219 4220### OH_PixelmapInitializationOptions_GetHeight() 4221 4222``` 4223Image_ErrorCode OH_PixelmapInitializationOptions_GetHeight(OH_Pixelmap_InitializationOptions *options, uint32_t *height) 4224``` 4225**描述** 4226获取图片高。 4227 4228**起始版本：** 12 4229 4230**参数：** 4231 4232| 名称 | 描述 | 4233| -------- | -------- | 4234| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4235| height | 图片的高，单位：像素。 | 4236 4237**返回：** 4238 4239如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4240 4241 4242### OH_PixelmapInitializationOptions_GetPixelFormat() 4243 4244``` 4245Image_ErrorCode OH_PixelmapInitializationOptions_GetPixelFormat(OH_Pixelmap_InitializationOptions *options, int32_t *pixelFormat) 4246``` 4247**描述** 4248获取像素格式。 4249 4250**起始版本：** 12 4251 4252**参数：** 4253 4254| 名称 | 描述 | 4255| -------- | -------- | 4256| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4257| pixelFormat | 像素格式[PIXEL_FORMAT](#pixel_format)。 | 4258 4259**返回：** 4260 4261如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4262 4263 4264### OH_PixelmapInitializationOptions_GetRowStride() 4265 4266``` 4267Image_ErrorCode OH_PixelmapInitializationOptions_GetRowStride(OH_Pixelmap_InitializationOptions *options, int32_t *rowStride) 4268``` 4269**描述** 4270获取行跨距。 4271 4272跨距，图像每行占用的真实内存大小，单位为字节。跨距 = width \* 单位像素字节数 + padding，padding为每行为内存对齐做的填充区域。 4273 4274**起始版本：** 12 4275 4276**参数：** 4277 4278| 名称 | 描述 | 4279| -------- | -------- | 4280| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4281| rowStride | 跨距，单位：字节。 | 4282 4283**返回：** 4284 4285如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果options被释放返回 IMAGE_UNKNOWN_ERROR； 具体请参考[Image_ErrorCode](#image_errorcode)。 4286 4287 4288### OH_PixelmapInitializationOptions_GetSrcPixelFormat() 4289 4290``` 4291Image_ErrorCode OH_PixelmapInitializationOptions_GetSrcPixelFormat(OH_Pixelmap_InitializationOptions *options, int32_t *srcpixelFormat) 4292``` 4293**描述** 4294获取源像素格式。 4295 4296**起始版本：** 12 4297 4298**参数：** 4299 4300| 名称 | 描述 | 4301| -------- | -------- | 4302| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4303| srcpixelFormat | 源像素格式[PIXEL_FORMAT](#pixel_format)。 | 4304 4305**返回：** 4306 4307如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4308 4309 4310### OH_PixelmapInitializationOptions_GetWidth() 4311 4312``` 4313Image_ErrorCode OH_PixelmapInitializationOptions_GetWidth(OH_Pixelmap_InitializationOptions *options, uint32_t *width) 4314``` 4315**描述** 4316获取图片宽。 4317 4318**起始版本：** 12 4319 4320**参数：** 4321 4322| 名称 | 描述 | 4323| -------- | -------- | 4324| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4325| width | 图片的宽，单位：像素。 | 4326 4327**返回：** 4328 4329如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4330 4331 4332### OH_PixelmapInitializationOptions_Release() 4333 4334``` 4335Image_ErrorCode OH_PixelmapInitializationOptions_Release(OH_Pixelmap_InitializationOptions *options) 4336``` 4337**描述** 4338释放OH_Pixelmap_InitializationOptions指针。 4339 4340**起始版本：** 12 4341 4342**参数：** 4343 4344| 名称 | 描述 | 4345| -------- | -------- | 4346| options | 被释放的OH_Pixelmap_InitializationOptions指针。 | 4347 4348**返回：** 4349 4350如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4351 4352 4353### OH_PixelmapInitializationOptions_SetAlphaType() 4354 4355``` 4356Image_ErrorCode OH_PixelmapInitializationOptions_SetAlphaType(OH_Pixelmap_InitializationOptions *options, int32_t alphaType) 4357``` 4358**描述** 4359设置透明度类型。 4360 4361**起始版本：** 12 4362 4363**参数：** 4364 4365| 名称 | 描述 | 4366| -------- | -------- | 4367| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4368| alphaType | 透明度类型[PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type)。 | 4369 4370**返回：** 4371 4372如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4373 4374 4375### OH_PixelmapInitializationOptions_SetEditable() 4376 4377``` 4378Image_ErrorCode OH_PixelmapInitializationOptions_SetEditable(OH_Pixelmap_InitializationOptions *options, bool editable) 4379``` 4380 4381**描述** 4382 4383设置可编辑标志。 4384 4385**起始版本：** 18 4386 4387**参数：** 4388 4389| 名称 | 描述 | 4390| -------- | -------- | 4391| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4392| editable | 可编辑标志。 | 4393 4394**返回：** 4395 4396如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，具体请参考 [Image_ErrorCode](#image_errorcode)。 4397 4398 4399### OH_PixelmapInitializationOptions_SetHeight() 4400 4401``` 4402Image_ErrorCode OH_PixelmapInitializationOptions_SetHeight(OH_Pixelmap_InitializationOptions *options, uint32_t height) 4403``` 4404**描述** 4405设置图片高。 4406 4407**起始版本：** 12 4408 4409**参数：** 4410 4411| 名称 | 描述 | 4412| -------- | -------- | 4413| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4414| height | 图片的高，单位：像素。 | 4415 4416**返回：** 4417 4418如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4419 4420 4421### OH_PixelmapInitializationOptions_SetPixelFormat() 4422 4423``` 4424Image_ErrorCode OH_PixelmapInitializationOptions_SetPixelFormat(OH_Pixelmap_InitializationOptions *options, int32_t pixelFormat) 4425``` 4426**描述** 4427设置像素格式。 4428 4429**起始版本：** 12 4430 4431**参数：** 4432 4433| 名称 | 描述 | 4434| -------- | -------- | 4435| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4436| pixelFormat | 像素格式[PIXEL_FORMAT](#pixel_format)。 | 4437 4438**返回：** 4439 4440如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4441 4442 4443### OH_PixelmapInitializationOptions_SetRowStride() 4444 4445``` 4446Image_ErrorCode OH_PixelmapInitializationOptions_SetRowStride(OH_Pixelmap_InitializationOptions *options, int32_t rowStride) 4447``` 4448**描述** 4449设置图像跨距。 4450 4451跨距，图像每行占用的真实内存大小，单位为字节。跨距 = width \* 单位像素字节数 + padding，padding为每行为内存对齐做的填充区域。 4452 4453**起始版本：** 12 4454 4455**参数：** 4456 4457| 名称 | 描述 | 4458| -------- | -------- | 4459| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4460| rowStride | 跨距，单位：字节。 | 4461 4462**返回：** 4463 4464如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果options被释放返回 IMAGE_UNKNOWN_ERROR； 具体请参考 [Image_ErrorCode](#image_errorcode)。 4465 4466 4467### OH_PixelmapInitializationOptions_SetSrcPixelFormat() 4468 4469``` 4470Image_ErrorCode OH_PixelmapInitializationOptions_SetSrcPixelFormat(OH_Pixelmap_InitializationOptions *options, int32_t srcpixelFormat) 4471``` 4472**描述** 4473设置源像素格式。 4474 4475**起始版本：** 12 4476 4477**参数：** 4478 4479| 名称 | 描述 | 4480| -------- | -------- | 4481| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4482| srcpixelFormat | 源像素格式[PIXEL_FORMAT](#pixel_format)。 | 4483 4484**返回：** 4485 4486如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4487 4488 4489### OH_PixelmapInitializationOptions_SetWidth() 4490 4491``` 4492Image_ErrorCode OH_PixelmapInitializationOptions_SetWidth(OH_Pixelmap_InitializationOptions *options, uint32_t width) 4493``` 4494**描述** 4495设置图片宽。 4496 4497**起始版本：** 12 4498 4499**参数：** 4500 4501| 名称 | 描述 | 4502| -------- | -------- | 4503| options | 被操作的OH_Pixelmap_InitializationOptions指针。 | 4504| width | 图片的宽，单位：像素。 | 4505 4506**返回：** 4507 4508如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4509 4510 4511### OH_PixelmapNative_AccessPixels() 4512 4513``` 4514Image_ErrorCode OH_PixelmapNative_AccessPixels(OH_PixelmapNative *pixelmap, void **addr) 4515``` 4516 4517**描述** 4518 4519获取Pixelmap像素数据的内存地址，并锁定这块内存。 4520 4521当该内存被锁定时，任何修改或释放该Pixelmap的像素数据的操作均会失败或无效。 4522 4523**起始版本：** 15 4524 4525**参数：** 4526 4527| 名称 | 描述 | 4528| -------- | -------- | 4529| pixelmap | 被操作的Pixelmap指针。 | 4530| addr | Pixelmap内存地址的双指针。 | 4531 4532**返回：** 4533 4534如果操作成功则返回IMAGE_SUCCESS， 如果pixelmap或addr参数无效则返回IMAGE_BAD_PARAMETER， 如果内存锁定失败则返回IMAGE_LOCK_UNLOCK_FAILED。 具体请参考 [Image_ErrorCode](#image_errorcode)。 4535 4536 4537### OH_PixelmapNative_ConvertAlphaFormat() 4538 4539``` 4540Image_ErrorCode OH_PixelmapNative_ConvertAlphaFormat(OH_PixelmapNative* srcpixelmap, OH_PixelmapNative* dstpixelmap, const bool isPremul) 4541``` 4542**描述** 4543将pixelmap的像素数据做预乘和非预乘之间的转换。 4544 4545**起始版本：** 12 4546 4547**参数：** 4548 4549| 名称 | 描述 | 4550| -------- | -------- | 4551| srcpixelmap | 被操作的OH_PixelmapNative指针, 源pixelmap对象指针。 | 4552| dstpixelmap | 被操作的OH_PixelmapNative指针, 目标pixelmap对象指针。目标指针和源指针不能是同一个。 | 4553| isPremul | 转换方式，true为非预乘转预乘，false为预乘转非预乘。 | 4554 4555**返回：** 4556 4557如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4558 4559 4560### OH_PixelmapNative_ConvertPixelmapNativeFromNapi() 4561 4562``` 4563Image_ErrorCode OH_PixelmapNative_ConvertPixelmapNativeFromNapi(napi_env env, napi_value pixelmapNapi, OH_PixelmapNative **pixelmapNative) 4564``` 4565**描述** 4566将PixelMapnapi对象转换为nativePixelMap对象。 4567 4568**起始版本：** 12 4569 4570**参数：** 4571 4572| 名称 | 描述 | 4573| -------- | -------- | 4574| env | napi的环境指针。 | 4575| pixelmapNapi | 需要转换的PixelMapnapi对象。 | 4576| pixelmapNative | 转换出的OH_PixelmapNative对象指针。 | 4577 4578**返回：** 4579 4580如果操作成功返回 IMAGE_SUCCESS， 如果pixelmapNative是nullptr，或者pixelmapNapi不是PixelMapNapi对象返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4581 4582 4583### OH_PixelmapNative_ConvertPixelmapNativeToNapi() 4584 4585``` 4586Image_ErrorCode OH_PixelmapNative_ConvertPixelmapNativeToNapi(napi_env env, OH_PixelmapNative *pixelmapNative, napi_value *pixelmapNapi) 4587``` 4588**描述** 4589将nativePixelMap对象转换为PixelMapnapi对象。 4590 4591**起始版本：** 12 4592 4593**参数：** 4594 4595| 名称 | 描述 | 4596| -------- | -------- | 4597| env | napi的环境指针。 | 4598| pixelmapNative | 被操作的OH_PixelmapNative指针。 | 4599| pixelmapNapi | 转换出来的PixelMapnapi对象指针。 | 4600 4601**返回：** 4602 4603如果操作成功返回IMAGE_SUCCESS，如果pixelmapNative为空返回IMAGE_BAD_PARAMETER，具体请参考[Image_ErrorCode](#image_errorcode)。 4604 4605 4606### OH_PixelmapNative_CreateEmptyPixelmap() 4607 4608``` 4609Image_ErrorCode OH_PixelmapNative_CreateEmptyPixelmap(OH_Pixelmap_InitializationOptions *options, OH_PixelmapNative **pixelmap) 4610``` 4611**描述** 4612利用OH_Pixelmap_InitializationOptions创建空的pixelmap对象，内存数据为0。 4613 4614**起始版本：** 12 4615 4616**参数：** 4617 4618| 名称 | 描述 | 4619| -------- | -------- | 4620| options | 创建像素的属性。 | 4621| pixelmap | 被创建的OH_PixelmapNative对象指针。 | 4622 4623**返回：** 4624 4625如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4626 4627 4628### OH_PixelmapNative_CreatePixelmap() 4629 4630``` 4631Image_ErrorCode OH_PixelmapNative_CreatePixelmap(uint8_t *data, size_t dataLength, OH_Pixelmap_InitializationOptions *options, OH_PixelmapNative **pixelmap) 4632``` 4633**描述** 4634通过属性创建PixelMap，默认采用BGRA_8888格式处理数据，其他格式请参考[OH_PixelmapInitializationOptions_SetSrcPixelFormat](#oh_pixelmapinitializationoptions_setsrcpixelformat)。 4635 4636**起始版本：** 12 4637 4638**参数：** 4639 4640| 名称 | 描述 | 4641| -------- | -------- | 4642| data | BGRA_8888格式的颜色数组。 | 4643| dataLength | 数组长度。 | 4644| options | 创建像素的属性。 | 4645| pixelmap | 被创建的OH_PixelmapNative对象指针。 | 4646 4647**返回：** 4648 4649如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果不支持的操作返回 IMAGE_UNSUPPORTED_OPERATION， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4650 4651 4652### OH_PixelmapNative_CreateScaledPixelMap() 4653 4654``` 4655Image_ErrorCode OH_PixelmapNative_CreateScaledPixelMap(OH_PixelmapNative *srcPixelmap, OH_PixelmapNative **dstPixelmap, float scaleX, float scaleY) 4656``` 4657 4658**描述** 4659 4660根据输入的宽高的缩放比例，创建一个新的缩放后的图片。 4661 4662**起始版本：** 18 4663 4664**参数：** 4665 4666| 名称 | 描述 | 4667| -------- | -------- | 4668| srcpixelmap | 被操作的OH_PixelmapNative指针，源pixelmap对象指针。 | 4669| dstpixelmap | 被操作的OH_PixelmapNative指针，目标pixelmap对象指针。 | 4670| scaleX | 宽度的缩放比例。 | 4671| scaleY | 高度的缩放比例。 | 4672 4673**返回：** 4674 4675如果操作成功返回IMAGE_SUCCESS，如果参数错误返回IMAGE_BAD_PARAMETER，具体请参考[Image_ErrorCode](#image_errorcode)。 4676 4677 4678### OH_PixelmapNative_CreateScaledPixelMapWithAntiAliasing() 4679 4680``` 4681Image_ErrorCode OH_PixelmapNative_CreateScaledPixelMapWithAntiAliasing(OH_PixelmapNative *srcPixelmap, OH_PixelmapNative **dstPixelmap, float scaleX, float scaleY, OH_PixelmapNative_AntiAliasingLevel level) 4682``` 4683 4684**描述** 4685 4686根据指定的缩放算法和输入的宽高的缩放比例，创建一个新的缩放后的图片。 4687 4688**起始版本：** 18 4689 4690**参数：** 4691 4692| 名称 | 描述 | 4693| -------- | -------- | 4694| srcpixelmap | 被操作的OH_PixelmapNative指针，源pixelmap对象指针。 | 4695| dstpixelmap | 被操作的OH_PixelmapNative指针，目标pixelmap对象指针。 | 4696| scaleX | 宽度的缩放比例。 | 4697| scaleY | 高度的缩放比例。 | 4698| level | 缩放算法。 | 4699 4700**返回：** 4701 4702如果操作成功返回IMAGE_SUCCESS，如果参数错误返回IMAGE_BAD_PARAMETER，如果图片过大返回IMAGE_TOO_LARGE，如果内存申请失败返回IMAGE_ALLOC_FAILED，具体请参考[Image_ErrorCode](#image_errorcode)。 4703 4704 4705### OH_PixelmapNative_Crop() 4706 4707``` 4708Image_ErrorCode OH_PixelmapNative_Crop(OH_PixelmapNative *pixelmap, Image_Region *region) 4709``` 4710**描述** 4711根据输入的尺寸对图片进行裁剪 4712 4713**起始版本：** 12 4714 4715**参数：** 4716 4717| 名称 | 描述 | 4718| -------- | -------- | 4719| pixelmap | 被操作的OH_PixelmapNative指针。 | 4720| region | 裁剪的尺寸。 | 4721 4722**返回：** 4723 4724如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4725 4726 4727### OH_PixelmapNative_Destroy() 4728 4729``` 4730Image_ErrorCode OH_PixelmapNative_Destroy(OH_PixelmapNative **pixelmap) 4731``` 4732 4733**描述** 4734 4735释放OH_PixelmapNative指针。 4736 4737**起始版本：** 18 4738 4739**参数：** 4740 4741| 名称 | 描述 | 4742| -------- | -------- | 4743| pixelmap | 被释放的OH_PixelmapNative指针。 | 4744 4745**返回：** 4746 4747如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，具体请参考 [Image_ErrorCode](#image_errorcode)。 4748 4749 4750### OH_PixelmapNative_Flip() 4751 4752``` 4753Image_ErrorCode OH_PixelmapNative_Flip(OH_PixelmapNative *pixelmap, bool shouldFilpHorizontally, bool shouldFilpVertically) 4754``` 4755**描述** 4756根据输入的条件对图片进行翻转。 4757 4758**起始版本：** 12 4759 4760**参数：** 4761 4762| 名称 | 描述 | 4763| -------- | -------- | 4764| pixelmap | 被操作的OH_PixelmapNative指针。 | 4765| shouldFilpHorizontally | 是否水平翻转图像。 | 4766| shouldFilpVertically | 是否垂直翻转图像。 | 4767 4768**返回：** 4769 4770如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，具体请参考 [Image_ErrorCode](#image_errorcode)。 4771 4772 4773### OH_PixelmapNative_GetAllocationByteCount() 4774 4775``` 4776Image_ErrorCode OH_PixelmapNative_GetAllocationByteCount(OH_PixelmapNative *pixelmap, uint32_t *allocationByteCount) 4777``` 4778 4779**描述** 4780 4781获取Pixelmap用于储存像素数据的内存字节数。 4782 4783**起始版本：** 18 4784 4785**参数：** 4786 4787| 名称 | 描述 | 4788| -------- | -------- | 4789| pixelmap | 被操作的Pixelmap指针。 | 4790| allocationByteCount | 获取的内存字节数。 | 4791 4792**返回：** 4793 4794如果操作成功则返回IMAGE_SUCCESS， 如果pixelmap或allocationByteCount参数无效则返回IMAGE_BAD_PARAMETER。 具体请参考 [Image_ErrorCode](#image_errorcode)。 4795 4796 4797### OH_PixelmapNative_GetArgbPixels() 4798 4799``` 4800Image_ErrorCode OH_PixelmapNative_GetArgbPixels(OH_PixelmapNative *pixelmap, uint8_t *destination, size_t *bufferSize) 4801``` 4802**描述** 4803从PixelMap中读取ARGB格式的数据。 4804 4805**起始版本：** 13 4806 4807**参数：** 4808 4809| 名称 | 描述 | 4810| -------- | -------- | 4811| pixelmap | 被操作的OH_PixelmapNative指针。 | 4812| destination | 缓冲区，获取的图像像素数据写入到该内存区域内。 | 4813| bufferSize | 缓冲区大小。 | 4814 4815**返回：** 4816 4817如果操作成功返回IMAGE_SUCCESS，如果参数错误返回IMAGE_BAD_PARAMETER，如果PixelMap格式不支持读取ARGB数据，返回IMAGE_UNSUPPORTED_CONVERSION，如果内存申请失败，返回IMAGE_ALLOC_FAILED, 如果内存数据拷贝、读取、操作失败，返回IMAGE_COPY_FAILED。具体请参考 [Image_ErrorCode](#image_errorcode)。 4818 4819 4820### OH_PixelmapNative_GetByteCount() 4821 4822``` 4823Image_ErrorCode OH_PixelmapNative_GetByteCount(OH_PixelmapNative *pixelmap, uint32_t *byteCount) 4824``` 4825 4826**描述** 4827 4828获取Pixelmap中所有像素所占用的总字节数，不包含内存填充。 4829 4830**起始版本：** 18 4831 4832**参数：** 4833 4834| 名称 | 描述 | 4835| -------- | -------- | 4836| pixelmap | 被操作的Pixelmap指针。 | 4837| byteCount | 获取的总字节数。 | 4838 4839**返回：** 4840 4841如果操作成功则返回IMAGE_SUCCESS， 如果pixelmap或byteCount参数无效则返回IMAGE_BAD_PARAMETER。 具体请参考 [Image_ErrorCode](#image_errorcode)。 4842 4843 4844### OH_PixelmapNative_GetColorSpaceNative() 4845 4846``` 4847Image_ErrorCode OH_PixelmapNative_GetColorSpaceNative(OH_PixelmapNative *pixelmap, OH_NativeColorSpaceManager **colorSpaceNative) 4848``` 4849**描述** 4850获取NativeColorSpaceManager对象。 4851 4852**起始版本：** 13 4853 4854**参数：** 4855 4856| 名称 | 描述 | 4857| -------- | -------- | 4858| pixelmap | 获取到NativeColorSpaceManager的源PixelMap。 | 4859| colorSpaceNative | 获取到的NativeColorSpaceManager对象。 | 4860 4861**返回：** 4862 4863如果操作成功返回IMAGE_SUCCESS，如果参数错误返回IMAGE_BAD_PARAMETER。具体请参考 [Image_ErrorCode](#image_errorcode)。 4864 4865 4866### OH_PixelmapNative_GetImageInfo() 4867 4868``` 4869Image_ErrorCode OH_PixelmapNative_GetImageInfo(OH_PixelmapNative *pixelmap, OH_Pixelmap_ImageInfo *imageInfo) 4870``` 4871**描述** 4872获取图像像素信息。 4873 4874**起始版本：** 12 4875 4876**参数：** 4877 4878| 名称 | 描述 | 4879| -------- | -------- | 4880| pixelmap | 被操作的OH_PixelmapNative指针。 | 4881| imageInfo | 图像像素信息。 | 4882 4883**返回：** 4884 4885如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4886 4887 4888### OH_PixelmapNative_GetMetadata() 4889 4890``` 4891Image_ErrorCode OH_PixelmapNative_GetMetadata(OH_PixelmapNative *pixelmap, OH_Pixelmap_HdrMetadataKey key, OH_Pixelmap_HdrMetadataValue **value) 4892``` 4893**描述** 4894获取元数据。 4895 4896**起始版本：** 12 4897 4898**参数：** 4899 4900| 名称 | 描述 | 4901| -------- | -------- | 4902| pixelmap | 被操作的OH_PixelmapNative指针。 | 4903| key | 元数据的关键字，参见[OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey)。 | 4904| value | 元数据的值，参见[OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md)。 | 4905 4906**返回：** 4907 4908如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果不存在DMA内存返回 IMAGE_DMA_NOT_EXIST，如果内存拷贝失败返回 IMAGE_COPY_FAILED。具体请参考[Image_ErrorCode](#image_errorcode)。 4909 4910 4911### OH_PixelmapNative_GetNativeBuffer() 4912 4913``` 4914Image_ErrorCode OH_PixelmapNative_GetNativeBuffer(OH_PixelmapNative *pixelmap, OH_NativeBuffer **nativeBuffer) 4915``` 4916**描述** 4917从DMA内存的PixelMap中，获取NativeBuffer对象。 4918 4919**起始版本：** 12 4920 4921**参数：** 4922 4923| 名称 | 描述 | 4924| -------- | -------- | 4925| pixelmap | 要获取NativeBuffer的源PixelMap。 | 4926| nativeBuffer | 被创建的NativeBuffer对象指针。 | 4927 4928**返回：** 4929 4930如果操作成功返回IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER，如果不是DMA内存返回IMAGE_DMA_NOT_EXIST，如果DMA内存操作失败返回IMAGE_DMA_OPERATION_FAILED。具体请参考 [Image_ErrorCode](#image_errorcode)。 4931 4932 4933### OH_PixelmapNative_Opacity() 4934 4935``` 4936Image_ErrorCode OH_PixelmapNative_Opacity(OH_PixelmapNative *pixelmap, float rate) 4937``` 4938**描述** 4939通过设置透明比率来让PixelMap达到对应的透明效果 4940 4941**起始版本：** 12 4942 4943**参数：** 4944 4945| 名称 | 描述 | 4946| -------- | -------- | 4947| pixelmap | 被操作的OH_PixelmapNative指针。 | 4948| rate | 透明比率的值。 | 4949 4950**返回：** 4951 4952如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4953 4954 4955### OH_PixelmapNative_ReadPixels() 4956 4957``` 4958Image_ErrorCode OH_PixelmapNative_ReadPixels(OH_PixelmapNative *pixelmap, uint8_t *destination, size_t *bufferSize) 4959``` 4960**描述** 4961读取图像像素数据，并按照PixelMap的像素格式写入缓冲区中。 4962 4963**起始版本：** 12 4964 4965**参数：** 4966 4967| 名称 | 描述 | 4968| -------- | -------- | 4969| pixelmap | 被操作的OH_PixelmapNative指针。 | 4970| destination | 缓冲区，获取的图像像素数据写入到该内存区域内。 | 4971| bufferSize | 缓冲区大小。RGBA格式的缓冲区大小等于width * height * 4，NV21与NV12格式的缓冲区大小等于width * height+((width+1)/2) * ((height+1)/2) * 2。 | 4972 4973**返回：** 4974 4975如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4976 4977 4978### OH_PixelmapNative_Release() 4979 4980``` 4981Image_ErrorCode OH_PixelmapNative_Release(OH_PixelmapNative *pixelmap) 4982``` 4983**描述** 4984释放OH_PixelmapNative指针，推荐使用 [OH_PixelmapNative_Destroy](#oh_pixelmapnative_destroy)。 4985 4986**起始版本：** 12 4987 4988**参数：** 4989 4990| 名称 | 描述 | 4991| -------- | -------- | 4992| pixelmap | 被释放的OH_PixelmapNative指针。 | 4993 4994**返回：** 4995 4996如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 4997 4998 4999### OH_PixelmapNative_Rotate() 5000 5001``` 5002Image_ErrorCode OH_PixelmapNative_Rotate(OH_PixelmapNative *pixelmap, float angle) 5003``` 5004**描述** 5005根据输入的角度对图片进行旋转。 5006 5007**起始版本：** 12 5008 5009**参数：** 5010 5011| 名称 | 描述 | 5012| -------- | -------- | 5013| pixelmap | 被操作的OH_PixelmapNative指针。 | 5014| angle | 图片旋转的角度，单位为deg。 | 5015 5016**返回：** 5017 5018如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 5019 5020 5021### OH_PixelmapNative_Scale() 5022 5023``` 5024Image_ErrorCode OH_PixelmapNative_Scale(OH_PixelmapNative *pixelmap, float scaleX, float scaleY) 5025``` 5026**描述** 5027根据输入的宽高对图片进行缩放。 5028 5029**起始版本：** 12 5030 5031**参数：** 5032 5033| 名称 | 描述 | 5034| -------- | -------- | 5035| pixelmap | 被操作的OH_PixelmapNative指针。 | 5036| scaleX | 宽度的缩放比例。 | 5037| scaleY | 高度的缩放比例。 | 5038 5039**返回：** 5040 5041如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 5042 5043 5044### OH_PixelmapNative_ScaleWithAntiAliasing() 5045 5046``` 5047Image_ErrorCode OH_PixelmapNative_ScaleWithAntiAliasing(OH_PixelmapNative *pixelmap, float scaleX, float scaleY, OH_PixelmapNative_AntiAliasingLevel level) 5048``` 5049**描述** 5050根据指定的缩放算法和输入的宽高对图片进行缩放。 5051 5052**起始版本：** 12 5053 5054**参数：** 5055 5056| 名称 | 描述 | 5057| -------- | -------- | 5058| pixelmap | 被操作的OH_PixelmapNative指针。 | 5059| scaleX | 宽度的缩放比例。 | 5060| scaleY | 高度的缩放比例。 | 5061| level | 缩放算法。 | 5062 5063**返回：** 5064 5065如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果图片过大返回 IMAGE_TOO_LARGE，如果内存申请失败返回 IMAGE_ALLOC_FAILED， 如果pixelmap已经被释放返回 IMAGE_UNKNOWN_ERROR，具体请参考 [Image_ErrorCode](#image_errorcode)。 5066 5067 5068### OH_PixelmapNative_SetColorSpaceNative() 5069 5070``` 5071Image_ErrorCode OH_PixelmapNative_SetColorSpaceNative(OH_PixelmapNative *pixelmap, OH_NativeColorSpaceManager *colorSpaceNative) 5072``` 5073**描述** 5074设置NativeColorSpaceManager对象。 5075 5076**起始版本：** 13 5077 5078**参数：** 5079 5080| 名称 | 描述 | 5081| -------- | -------- | 5082| pixelmap | 要设置NativeColorSpaceManager的目标PixelMap。 | 5083| colorSpaceNative | 要设置的NativeColorSpaceManager对象。 | 5084 5085**返回：** 5086 5087如果操作成功返回IMAGE_SUCCESS，如果参数错误返回IMAGE_BAD_PARAMETER。具体请参考 [Image_ErrorCode](#image_errorcode)。 5088 5089 5090### OH_PixelmapNative_SetMemoryName() 5091 5092``` 5093Image_ErrorCode OH_PixelmapNative_SetMemoryName(OH_PixelmapNative *pixelmap, char *name, size_t *size) 5094``` 5095**描述** 5096设置pixelMap内存名字。 5097 5098**起始版本：** 13 5099 5100**参数：** 5101 5102| 名称 | 描述 | 5103| -------- | -------- | 5104| pixelmap | 被操作的OH_PixelmapNative指针。 | 5105| name | 需要被设置的PixelMap内存名称。 | 5106| size | 需要被设置的PixelMap内存名称的字节大小。 | 5107 5108**返回：** 5109 5110如果操作成功返回的是IMAGE_SUCCESS，如果名字长度超出31位或者小于1位会返回IMAGE_BAD_PARAMETER。 如果既不是DMA内存也不是ASHMEM内存返回IMAGE_UNSUPPORTED_MEMORY_FORMAT。具体请参考 [Image_ErrorCode](#image_errorcode)。 5111 5112 5113### OH_PixelmapNative_SetMetadata() 5114 5115``` 5116Image_ErrorCode OH_PixelmapNative_SetMetadata(OH_PixelmapNative *pixelmap, OH_Pixelmap_HdrMetadataKey key, OH_Pixelmap_HdrMetadataValue *value) 5117``` 5118**描述** 5119设置元数据。 5120 5121**起始版本：** 12 5122 5123**参数：** 5124 5125| 名称 | 描述 | 5126| -------- | -------- | 5127| pixelmap | 被操作的OH_PixelmapNative指针。 | 5128| key | 元数据的关键字，参见[OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey)。 | 5129| value | 元数据的值，参见[OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md)。 | 5130 5131**返回：** 5132 5133如果操作成功返回IMAGE_SUCCESS，如果参数错误返回IMAGE_BAD_PARAMETER，如果不存在DMA内存返回IMAGE_DMA_NOT_EXIST，如果内存拷贝失败返回IMAGE_COPY_FAILED。具体请参考 [Image_ErrorCode](#image_errorcode)。 5134 5135 5136### OH_PixelmapNative_ToSdr() 5137 5138``` 5139Image_ErrorCode OH_PixelmapNative_ToSdr(OH_PixelmapNative *pixelmap) 5140``` 5141**描述** 5142将HDR的图像内容转换为SDR的图像内容。 5143 5144**起始版本：** 12 5145 5146**参数：** 5147 5148| 名称 | 描述 | 5149| -------- | -------- | 5150| pixelmap | 被操作的OH_PixelmapNative指针。 | 5151 5152**返回：** 5153 5154如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果不支持的操作返回 IMAGE_UNSUPPORTED_OPERATION， 具体请参考 [Image_ErrorCode](#image_errorcode)。 5155 5156 5157### OH_PixelmapNative_Translate() 5158 5159``` 5160Image_ErrorCode OH_PixelmapNative_Translate(OH_PixelmapNative *pixelmap, float x, float y) 5161``` 5162**描述** 5163根据输入的坐标对图片进行位置变换。 5164 5165**起始版本：** 12 5166 5167**参数：** 5168 5169| 名称 | 描述 | 5170| -------- | -------- | 5171| pixelmap | 被操作的OH_PixelmapNative指针。 | 5172| x | 区域横坐标。 | 5173| y | 区域纵坐标。 | 5174 5175**返回：** 5176 5177如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 具体请参考 [Image_ErrorCode](#image_errorcode)。 5178 5179 5180### OH_PixelmapNative_UnaccessPixels() 5181 5182``` 5183Image_ErrorCode OH_PixelmapNative_UnaccessPixels(OH_PixelmapNative *pixelmap) 5184``` 5185 5186**描述** 5187 5188释放Pixelmap像素数据的内存锁。 5189 5190该函数需要与[OH_PixelmapNative_AccessPixels](#oh_pixelmapnative_accesspixels)匹配使用。 5191 5192**起始版本：** 15 5193 5194**参数：** 5195 5196| 名称 | 描述 | 5197| -------- | -------- | 5198| pixelmap | 被操作的Pixelmap指针。 | 5199 5200**返回：** 5201 5202如果操作成功则返回IMAGE_SUCCESS， 如果pixelmap参数无效则返回IMAGE_BAD_PARAMETER， 如果内存解锁失败则返回IMAGE_LOCK_UNLOCK_FAILED。 具体请参考 [Image_ErrorCode](#image_errorcode)。 5203 5204 5205### OH_PixelmapNative_WritePixels() 5206 5207``` 5208Image_ErrorCode OH_PixelmapNative_WritePixels(OH_PixelmapNative *pixelmap, uint8_t *source, size_t bufferSize) 5209``` 5210**描述** 5211读取缓冲区中的图像像素数据，并按照PixelMap的像素格式将结果写入PixelMap。 5212 5213**起始版本：** 12 5214 5215**参数：** 5216 5217| 名称 | 描述 | 5218| -------- | -------- | 5219| pixelmap | 被操作的OH_PixelmapNative指针。 | 5220| source | 图像像素数据。 | 5221| bufferSize | 图像像素数据长度。 | 5222 5223**返回：** 5224 5225如果操作成功返回 IMAGE_SUCCESS，如果参数错误返回 IMAGE_BAD_PARAMETER， 如果不支持的操作返回 IMAGE_UNSUPPORTED_OPERATION，如果未知错误返回 IMAGE_UNKNOWN_ERROR， 具体请参考 [Image_ErrorCode](#image_errorcode)。 5226 5227## 变量说明 5228 5229 5230### MIME_TYPE_BMP 5231 5232``` 5233static const char* MIME_TYPE_BMP = "image/bmp" 5234``` 5235 5236**描述** 5237 5238bmp图片格式。 5239 5240**起始版本：** 12 5241 5242 5243### MIME_TYPE_GIF 5244 5245``` 5246static const char* MIME_TYPE_GIF = "image/gif" 5247``` 5248 5249**描述** 5250 5251gif图片格式。 5252 5253**起始版本：** 12 5254 5255 5256### MIME_TYPE_HEIC 5257 5258``` 5259static const char* MIME_TYPE_HEIC = "image/heic" 5260``` 5261 5262**描述** 5263 5264heic图片格式。 5265 5266**起始版本：** 12 5267 5268 5269### MIME_TYPE_ICON 5270 5271``` 5272static const char* MIME_TYPE_ICON = "image/x-icon" 5273``` 5274 5275**描述** 5276 5277ico图片格式。 5278 5279**起始版本：** 12 5280 5281 5282### MIME_TYPE_JPEG 5283 5284``` 5285static const char* MIME_TYPE_JPEG = "image/jpeg" 5286``` 5287 5288**描述** 5289 5290jpeg图片格式。 5291 5292**起始版本：** 12 5293 5294 5295### MIME_TYPE_PNG 5296 5297``` 5298static const char* MIME_TYPE_PNG = "image/png" 5299``` 5300 5301**描述** 5302 5303png图片格式。 5304 5305**起始版本：** 12 5306 5307 5308### MIME_TYPE_WEBP 5309 5310``` 5311static const char* MIME_TYPE_WEBP = "image/webp" 5312``` 5313 5314**描述** 5315 5316webp图片格式。 5317 5318**起始版本：** 12 5319 5320 5321### OHOS_IMAGE_PROPERTY_ARTIST 5322 5323``` 5324static const char* OHOS_IMAGE_PROPERTY_ARTIST = "Artist" 5325``` 5326 5327**描述** 5328 5329创建图像的用户名称。 5330 5331**起始版本：** 12 5332 5333 5334### OHOS_IMAGE_PROPERTY_BITS_PER_SAMPLE 5335 5336``` 5337static const char* OHOS_IMAGE_PROPERTY_BITS_PER_SAMPLE = "BitsPerSample" 5338``` 5339 5340**描述** 5341 5342每个像素比特数。 5343 5344**起始版本：** 12 5345 5346 5347### OHOS_IMAGE_PROPERTY_BODY_SERIAL_NUMBER 5348 5349``` 5350static const char* OHOS_IMAGE_PROPERTY_BODY_SERIAL_NUMBER = "BodySerialNumber" 5351``` 5352 5353**描述** 5354 5355相机机身的序列号。 5356 5357**起始版本：** 12 5358 5359 5360### OHOS_IMAGE_PROPERTY_BRIGHTNESS_VALUE 5361 5362``` 5363static const char* OHOS_IMAGE_PROPERTY_BRIGHTNESS_VALUE = "BrightnessValue" 5364``` 5365 5366**描述** 5367 5368图像的亮度值，以APEX单位表示。 5369 5370**起始版本：** 12 5371 5372 5373### OHOS_IMAGE_PROPERTY_BURST_NUMBER 5374 5375``` 5376static const char* OHOS_IMAGE_PROPERTY_BURST_NUMBER = "HwMnoteBurstNumber" 5377``` 5378 5379**描述** 5380 5381连拍次数。 5382 5383**起始版本：** 12 5384 5385 5386### OHOS_IMAGE_PROPERTY_CAMERA_OWNER_NAME 5387 5388``` 5389static const char* OHOS_IMAGE_PROPERTY_CAMERA_OWNER_NAME = "CameraOwnerName" 5390``` 5391 5392**描述** 5393 5394相机所有者的姓名。 5395 5396**起始版本：** 12 5397 5398 5399### OHOS_IMAGE_PROPERTY_CFA_PATTERN 5400 5401``` 5402static const char* OHOS_IMAGE_PROPERTY_CFA_PATTERN = "CFAPattern" 5403``` 5404 5405**描述** 5406 5407图像传感器的色彩滤光片（CFA）几何图案。 5408 5409**起始版本：** 12 5410 5411 5412### OHOS_IMAGE_PROPERTY_COLOR_SPACE 5413 5414``` 5415static const char* OHOS_IMAGE_PROPERTY_COLOR_SPACE = "ColorSpace" 5416``` 5417 5418**描述** 5419 5420色彩空间信息标签，通常记录为色彩空间指定符。 5421 5422**起始版本：** 12 5423 5424 5425### OHOS_IMAGE_PROPERTY_COMPONENTS_CONFIGURATION 5426 5427``` 5428static const char* OHOS_IMAGE_PROPERTY_COMPONENTS_CONFIGURATION = "ComponentsConfiguration" 5429``` 5430 5431**描述** 5432 5433压缩数据的特定信息。 5434 5435**起始版本：** 12 5436 5437 5438### OHOS_IMAGE_PROPERTY_COMPOSITE_IMAGE 5439 5440``` 5441static const char* OHOS_IMAGE_PROPERTY_COMPOSITE_IMAGE = "CompositeImage" 5442``` 5443 5444**描述** 5445 5446表示图像是否为合成图像。 5447 5448**起始版本：** 12 5449 5450 5451### OHOS_IMAGE_PROPERTY_COMPRESSED_BITS_PER_PIXEL 5452 5453``` 5454static const char* OHOS_IMAGE_PROPERTY_COMPRESSED_BITS_PER_PIXEL = "CompressedBitsPerPixel" 5455``` 5456 5457**描述** 5458 5459用于压缩图像的压缩模式，单位为每像素位数。 5460 5461**起始版本：** 12 5462 5463 5464### OHOS_IMAGE_PROPERTY_COMPRESSION 5465 5466``` 5467static const char* OHOS_IMAGE_PROPERTY_COMPRESSION = "Compression" 5468``` 5469 5470**描述** 5471 5472图像压缩方案。 5473 5474**起始版本：** 12 5475 5476 5477### OHOS_IMAGE_PROPERTY_CONTRAST 5478 5479``` 5480static const char* OHOS_IMAGE_PROPERTY_CONTRAST = "Contrast" 5481``` 5482 5483**描述** 5484 5485相机应用的对比度处理方向。 5486 5487**起始版本：** 12 5488 5489 5490### OHOS_IMAGE_PROPERTY_COPYRIGHT 5491 5492``` 5493static const char* OHOS_IMAGE_PROPERTY_COPYRIGHT = "Copyright" 5494``` 5495 5496**描述** 5497 5498图像的版权信息。 5499 5500**起始版本：** 12 5501 5502 5503### OHOS_IMAGE_PROPERTY_CUSTOM_RENDERED 5504 5505``` 5506static const char* OHOS_IMAGE_PROPERTY_CUSTOM_RENDERED = "CustomRendered" 5507``` 5508 5509**描述** 5510 5511指示图像数据上的特殊处理。 5512 5513**起始版本：** 12 5514 5515 5516### OHOS_IMAGE_PROPERTY_DATE_TIME_DIGITIZED 5517 5518``` 5519static const char* OHOS_IMAGE_PROPERTY_DATE_TIME_DIGITIZED = "DateTimeDigitized" 5520``` 5521 5522**描述** 5523 5524图像作为数字数据存储的日期和时间，格式为YYYY:MM:DD HH:MM:SS。 5525 5526**起始版本：** 12 5527 5528 5529### OHOS_IMAGE_PROPERTY_DATE_TIME_ORIGINAL 5530 5531``` 5532static const char* OHOS_IMAGE_PROPERTY_DATE_TIME_ORIGINAL = "DateTimeOriginal" 5533``` 5534 5535**描述** 5536 5537拍摄时间，例如2022:09:06 15:48:00。 5538 5539**起始版本：** 12 5540 5541 5542### OHOS_IMAGE_PROPERTY_DEFAULT_CROP_SIZE 5543 5544``` 5545static const char* OHOS_IMAGE_PROPERTY_DEFAULT_CROP_SIZE = "DefaultCropSize" 5546``` 5547 5548**描述** 5549 5550DefaultCropSize指定了原始坐标中的最终图像大小，考虑了额外的边缘像素。 5551 5552**起始版本：** 12 5553 5554 5555### OHOS_IMAGE_PROPERTY_DEVICE_SETTING_DESCRIPTION 5556 5557``` 5558static const char* OHOS_IMAGE_PROPERTY_DEVICE_SETTING_DESCRIPTION = "DeviceSettingDescription" 5559``` 5560 5561**描述** 5562 5563特定相机模型的拍照条件信息。 5564 5565**起始版本：** 12 5566 5567 5568### OHOS_IMAGE_PROPERTY_DIGITAL_ZOOM_RATIO 5569 5570``` 5571static const char* OHOS_IMAGE_PROPERTY_DIGITAL_ZOOM_RATIO = "DigitalZoomRatio" 5572``` 5573 5574**描述** 5575 5576捕获时的数字变焦比率。 5577 5578**起始版本：** 12 5579 5580 5581### OHOS_IMAGE_PROPERTY_DNG_VERSION 5582 5583``` 5584static const char* OHOS_IMAGE_PROPERTY_DNG_VERSION = "DNGVersion" 5585``` 5586 5587**描述** 5588 5589DNG版本标签编码了符合DNG规范的四级版本号。 5590 5591**起始版本：** 12 5592 5593 5594### OHOS_IMAGE_PROPERTY_EXIF_VERSION 5595 5596``` 5597static const char* OHOS_IMAGE_PROPERTY_EXIF_VERSION = "ExifVersion" 5598``` 5599 5600**描述** 5601 5602支持的Exif标准版本。 5603 5604**起始版本：** 12 5605 5606 5607### OHOS_IMAGE_PROPERTY_EXPOSURE_INDEX 5608 5609``` 5610static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_INDEX = "ExposureIndex" 5611``` 5612 5613**描述** 5614 5615捕获时选定的曝光指数。 5616 5617**起始版本：** 12 5618 5619 5620### OHOS_IMAGE_PROPERTY_EXPOSURE_MODE 5621 5622``` 5623static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_MODE = "ExposureMode" 5624``` 5625 5626**描述** 5627 5628拍摄时设置的曝光模式。 5629 5630**起始版本：** 12 5631 5632 5633### OHOS_IMAGE_PROPERTY_EXPOSURE_PROGRAM 5634 5635``` 5636static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_PROGRAM = "ExposureProgram" 5637``` 5638 5639**描述** 5640 5641拍照时相机用来设置曝光的程序的类别。 5642 5643**起始版本：** 12 5644 5645 5646### OHOS_IMAGE_PROPERTY_EXPOSURE_TIME 5647 5648``` 5649static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_TIME = "ExposureTime" 5650``` 5651 5652**描述** 5653 5654曝光时间，例如1/33 sec。 5655 5656**起始版本：** 12 5657 5658 5659### OHOS_IMAGE_PROPERTY_F_NUMBER 5660 5661``` 5662static const char* OHOS_IMAGE_PROPERTY_F_NUMBER = "FNumber" 5663``` 5664 5665**描述** 5666 5667光圈值，例如f/1.8。 5668 5669**起始版本：** 12 5670 5671 5672### OHOS_IMAGE_PROPERTY_FACE_CONF 5673 5674``` 5675static const char* OHOS_IMAGE_PROPERTY_FACE_CONF = "HwMnoteFaceConf" 5676``` 5677 5678**描述** 5679 5680人脸置信度。 5681 5682**起始版本：** 12 5683 5684 5685### OHOS_IMAGE_PROPERTY_FACE_LEYE_CENTER 5686 5687``` 5688static const char* OHOS_IMAGE_PROPERTY_FACE_LEYE_CENTER = "HwMnoteFaceLeyeCenter" 5689``` 5690 5691**描述** 5692 5693左眼中心。 5694 5695**起始版本：** 12 5696 5697 5698### OHOS_IMAGE_PROPERTY_FACE_MOUTH_CENTER 5699 5700``` 5701static const char* OHOS_IMAGE_PROPERTY_FACE_MOUTH_CENTER = "HwMnoteFaceMouthCenter" 5702``` 5703 5704**描述** 5705 5706嘴中心。 5707 5708**起始版本：** 12 5709 5710 5711### OHOS_IMAGE_PROPERTY_FACE_POINTER 5712 5713``` 5714static const char* OHOS_IMAGE_PROPERTY_FACE_POINTER = "HwMnoteFacePointer" 5715``` 5716 5717**描述** 5718 5719脸部指针。 5720 5721**起始版本：** 12 5722 5723 5724### OHOS_IMAGE_PROPERTY_FACE_RECT 5725 5726``` 5727static const char* OHOS_IMAGE_PROPERTY_FACE_RECT = "HwMnoteFaceRect" 5728``` 5729 5730**描述** 5731 5732脸部矩形。 5733 5734**起始版本：** 12 5735 5736 5737### OHOS_IMAGE_PROPERTY_FACE_REYE_CENTER 5738 5739``` 5740static const char* OHOS_IMAGE_PROPERTY_FACE_REYE_CENTER = "HwMnoteFaceReyeCenter" 5741``` 5742 5743**描述** 5744 5745右眼中心。 5746 5747**起始版本：** 12 5748 5749 5750### OHOS_IMAGE_PROPERTY_FACE_SMILE_SCORE 5751 5752``` 5753static const char* OHOS_IMAGE_PROPERTY_FACE_SMILE_SCORE = "HwMnoteFaceSmileScore" 5754``` 5755 5756**描述** 5757 5758FaceCount张人脸的笑脸分数。 5759 5760**起始版本：** 12 5761 5762 5763### OHOS_IMAGE_PROPERTY_FACE_VERSION 5764 5765``` 5766static const char* OHOS_IMAGE_PROPERTY_FACE_VERSION = "HwMnoteFaceVersion" 5767``` 5768 5769**描述** 5770 5771人脸算法版本信息。 5772 5773**起始版本：** 12 5774 5775 5776### OHOS_IMAGE_PROPERTY_FILE_SOURCE 5777 5778``` 5779static const char* OHOS_IMAGE_PROPERTY_FILE_SOURCE = "FileSource" 5780``` 5781 5782**描述** 5783 5784表明图像来源。 5785 5786**起始版本：** 12 5787 5788 5789### OHOS_IMAGE_PROPERTY_FLASH_ENERGY 5790 5791``` 5792static const char* OHOS_IMAGE_PROPERTY_FLASH_ENERGY = "FlashEnergy" 5793``` 5794 5795**描述** 5796 5797图像捕获时的闪光能量，以BCPS表示。 5798 5799**起始版本：** 12 5800 5801 5802### OHOS_IMAGE_PROPERTY_FLASHPIX_VERSION 5803 5804``` 5805static const char* OHOS_IMAGE_PROPERTY_FLASHPIX_VERSION = "FlashpixVersion" 5806``` 5807 5808**描述** 5809 5810该标签表示FPXR文件支持的Flashpix格式版本，增强了设备兼容性。 5811 5812**起始版本：** 12 5813 5814 5815### OHOS_IMAGE_PROPERTY_FOCAL_PLANE_RESOLUTION_UNIT 5816 5817``` 5818static const char* OHOS_IMAGE_PROPERTY_FOCAL_PLANE_RESOLUTION_UNIT = "FocalPlaneResolutionUnit" 5819``` 5820 5821**描述** 5822 5823测量FocalPlaneXResolution和FocalPlaneYResolution的单位。 5824 5825**起始版本：** 12 5826 5827 5828### OHOS_IMAGE_PROPERTY_FOCAL_PLANE_X_RESOLUTION 5829 5830``` 5831static const char* OHOS_IMAGE_PROPERTY_FOCAL_PLANE_X_RESOLUTION = "FocalPlaneXResolution" 5832``` 5833 5834**描述** 5835 5836图像宽度中每FocalPlaneResolutionUnit的像素。 5837 5838**起始版本：** 12 5839 5840 5841### OHOS_IMAGE_PROPERTY_FOCAL_PLANE_Y_RESOLUTION 5842 5843``` 5844static const char* OHOS_IMAGE_PROPERTY_FOCAL_PLANE_Y_RESOLUTION = "FocalPlaneYResolution" 5845``` 5846 5847**描述** 5848 5849图像高度中每FocalPlaneResolutionUnit的像素。 5850 5851**起始版本：** 12 5852 5853 5854### OHOS_IMAGE_PROPERTY_FRAGMENT_HEIGHT 5855 5856``` 5857static const char *OHOS_IMAGE_PROPERTY_FRAGMENT_HEIGHT = "FragmentImageHeight" 5858``` 5859 5860**描述** 5861 5862水印裁剪图的高。 5863 5864**起始版本：** 13 5865 5866 5867### OHOS_IMAGE_PROPERTY_FRAGMENT_WIDTH 5868 5869``` 5870static const char *OHOS_IMAGE_PROPERTY_FRAGMENT_WIDTH = "FragmentImageWidth" 5871``` 5872 5873**描述** 5874 5875水印裁剪图的宽。 5876 5877**起始版本：** 13 5878 5879 5880### OHOS_IMAGE_PROPERTY_FRONT_CAMERA 5881 5882``` 5883static const char* OHOS_IMAGE_PROPERTY_FRONT_CAMERA = "HwMnoteFrontCamera" 5884``` 5885 5886**描述** 5887 5888是否是前置相机自拍。 5889 5890**起始版本：** 12 5891 5892 5893### OHOS_IMAGE_PROPERTY_GAIN_CONTROL 5894 5895``` 5896static const char* OHOS_IMAGE_PROPERTY_GAIN_CONTROL = "GainControl" 5897``` 5898 5899**描述** 5900 5901整体图像增益调整的程度。 5902 5903**起始版本：** 12 5904 5905 5906### OHOS_IMAGE_PROPERTY_GAMMA 5907 5908``` 5909static const char* OHOS_IMAGE_PROPERTY_GAMMA = "Gamma" 5910``` 5911 5912**描述** 5913 5914表示系数伽马的值。 5915 5916**起始版本：** 12 5917 5918 5919### OHOS_IMAGE_PROPERTY_GIF_LOOP_COUNT 5920 5921``` 5922static const char* OHOS_IMAGE_PROPERTY_GIF_LOOP_COUNT = "GIFLoopCount" 5923``` 5924 5925**描述** 5926 5927GIF图片循环次数。 5928 5929**起始版本：** 12 5930 5931 5932### OHOS_IMAGE_PROPERTY_GPS_ALTITUDE 5933 5934``` 5935static const char* OHOS_IMAGE_PROPERTY_GPS_ALTITUDE = "GPSAltitude" 5936``` 5937 5938**描述** 5939 5940基于GPSAltitudeRef的高度。 5941 5942**起始版本：** 12 5943 5944 5945### OHOS_IMAGE_PROPERTY_GPS_ALTITUDE_REF 5946 5947``` 5948static const char* OHOS_IMAGE_PROPERTY_GPS_ALTITUDE_REF = "GPSAltitudeRef" 5949``` 5950 5951**描述** 5952 5953用于GPS高度的参照高度。 5954 5955**起始版本：** 12 5956 5957 5958### OHOS_IMAGE_PROPERTY_GPS_AREA_INFORMATION 5959 5960``` 5961static const char* OHOS_IMAGE_PROPERTY_GPS_AREA_INFORMATION = "GPSAreaInformation" 5962``` 5963 5964**描述** 5965 5966记录GPS区域名的字符字符串。 5967 5968**起始版本：** 12 5969 5970 5971### OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING 5972 5973``` 5974static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING = "GPSDestBearing" 5975``` 5976 5977**描述** 5978 5979目的地方位。 5980 5981**起始版本：** 12 5982 5983 5984### OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING_REF 5985 5986``` 5987static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING_REF = "GPSDestBearingRef" 5988``` 5989 5990**描述** 5991 5992指向目的地点的方位参照。 5993 5994**起始版本：** 12 5995 5996 5997### OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE 5998 5999``` 6000static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE = "GPSDestDistance" 6001``` 6002 6003**描述** 6004 6005到目的地点的距离。 6006 6007**起始版本：** 12 6008 6009 6010### OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE_REF 6011 6012``` 6013static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE_REF = "GPSDestDistanceRef" 6014``` 6015 6016**描述** 6017 6018目标点距离的测量单位。 6019 6020**起始版本：** 12 6021 6022 6023### OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE 6024 6025``` 6026static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE = "GPSDestLatitude" 6027``` 6028 6029**描述** 6030 6031目的地点的纬度。 6032 6033**起始版本：** 12 6034 6035 6036### OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE_REF 6037 6038``` 6039static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE_REF = "GPSDestLatitudeRef" 6040``` 6041 6042**描述** 6043 6044目的地点的纬度参照。 6045 6046**起始版本：** 12 6047 6048 6049### OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE 6050 6051``` 6052static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE = "GPSDestLongitude" 6053``` 6054 6055**描述** 6056 6057目的地点的经度。 6058 6059**起始版本：** 12 6060 6061 6062### OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE_REF 6063 6064``` 6065static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE_REF = "GPSDestLongitudeRef" 6066``` 6067 6068**描述** 6069 6070目的地点的经度参照。 6071 6072**起始版本：** 12 6073 6074 6075### OHOS_IMAGE_PROPERTY_GPS_DIFFERENTIAL 6076 6077``` 6078static const char* OHOS_IMAGE_PROPERTY_GPS_DIFFERENTIAL = "GPSDifferential" 6079``` 6080 6081**描述** 6082 6083此字段表示GPS数据是否应用了差分校正，对于精确的位置准确性至关重要。 6084 6085**起始版本：** 12 6086 6087 6088### OHOS_IMAGE_PROPERTY_GPS_DOP 6089 6090``` 6091static const char* OHOS_IMAGE_PROPERTY_GPS_DOP = "GPSDOP" 6092``` 6093 6094**描述** 6095 6096GPS DOP（数据精度等级）。 6097 6098**起始版本：** 12 6099 6100 6101### OHOS_IMAGE_PROPERTY_GPS_H_POSITIONING_ERROR 6102 6103``` 6104static const char* OHOS_IMAGE_PROPERTY_GPS_H_POSITIONING_ERROR = "GPSHPositioningError" 6105``` 6106 6107**描述** 6108 6109此标签指示水平定位误差，单位为米。 6110 6111**起始版本：** 12 6112 6113 6114### OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION 6115 6116``` 6117static const char* OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION = "GPSImgDirection" 6118``` 6119 6120**描述** 6121 6122拍摄时图像的方向。 6123 6124**起始版本：** 12 6125 6126 6127### OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION_REF 6128 6129``` 6130static const char* OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION_REF = "GPSImgDirectionRef" 6131``` 6132 6133**描述** 6134 6135图像方向的参照。 6136 6137**起始版本：** 12 6138 6139 6140### OHOS_IMAGE_PROPERTY_GPS_LATITUDE 6141 6142``` 6143static const char* OHOS_IMAGE_PROPERTY_GPS_LATITUDE = "GPSLatitude" 6144``` 6145 6146**描述** 6147 6148图片纬度。 6149 6150**起始版本：** 12 6151 6152 6153### OHOS_IMAGE_PROPERTY_GPS_LATITUDE_REF 6154 6155``` 6156static const char* OHOS_IMAGE_PROPERTY_GPS_LATITUDE_REF = "GPSLatitudeRef" 6157``` 6158 6159**描述** 6160 6161纬度引用，例如N或S。 6162 6163**起始版本：** 12 6164 6165 6166### OHOS_IMAGE_PROPERTY_GPS_LONGITUDE 6167 6168``` 6169static const char* OHOS_IMAGE_PROPERTY_GPS_LONGITUDE = "GPSLongitude" 6170``` 6171 6172**描述** 6173 6174图片经度。 6175 6176**起始版本：** 12 6177 6178 6179### OHOS_IMAGE_PROPERTY_GPS_LONGITUDE_REF 6180 6181``` 6182static const char* OHOS_IMAGE_PROPERTY_GPS_LONGITUDE_REF = "GPSLongitudeRef" 6183``` 6184 6185**描述** 6186 6187经度引用，例如W或E。 6188 6189**起始版本：** 12 6190 6191 6192### OHOS_IMAGE_PROPERTY_GPS_MAP_DATUM 6193 6194``` 6195static const char* OHOS_IMAGE_PROPERTY_GPS_MAP_DATUM = "GPSMapDatum" 6196``` 6197 6198**描述** 6199 6200GPS接收器使用的大地测量数据。 6201 6202**起始版本：** 12 6203 6204 6205### OHOS_IMAGE_PROPERTY_GPS_MEASURE_MODE 6206 6207``` 6208static const char* OHOS_IMAGE_PROPERTY_GPS_MEASURE_MODE = "GPSMeasureMode" 6209``` 6210 6211**描述** 6212 6213GPS测量模式。 6214 6215**起始版本：** 12 6216 6217 6218### OHOS_IMAGE_PROPERTY_GPS_PROCESSING_METHOD 6219 6220``` 6221static const char* OHOS_IMAGE_PROPERTY_GPS_PROCESSING_METHOD = "GPSProcessingMethod" 6222``` 6223 6224**描述** 6225 6226记录定位方法名的字符字符串。 6227 6228**起始版本：** 12 6229 6230 6231### OHOS_IMAGE_PROPERTY_GPS_SATELLITES 6232 6233``` 6234static const char* OHOS_IMAGE_PROPERTY_GPS_SATELLITES = "GPSSatellites" 6235``` 6236 6237**描述** 6238 6239用于测量的GPS卫星。 6240 6241**起始版本：** 12 6242 6243 6244### OHOS_IMAGE_PROPERTY_GPS_SPEED 6245 6246``` 6247static const char* OHOS_IMAGE_PROPERTY_GPS_SPEED = "GPSSpeed" 6248``` 6249 6250**描述** 6251 6252GPS接收器的移动速度。 6253 6254**起始版本：** 12 6255 6256 6257### OHOS_IMAGE_PROPERTY_GPS_SPEED_REF 6258 6259``` 6260static const char* OHOS_IMAGE_PROPERTY_GPS_SPEED_REF = "GPSSpeedRef" 6261``` 6262 6263**描述** 6264 6265用来表示GPS接收器移动速度的单位。 6266 6267**起始版本：** 12 6268 6269 6270### OHOS_IMAGE_PROPERTY_GPS_STATUS 6271 6272``` 6273static const char* OHOS_IMAGE_PROPERTY_GPS_STATUS = "GPSStatus" 6274``` 6275 6276**描述** 6277 6278录制图像时GPS接收器的状态。 6279 6280**起始版本：** 12 6281 6282 6283### OHOS_IMAGE_PROPERTY_GPS_TRACK 6284 6285``` 6286static const char* OHOS_IMAGE_PROPERTY_GPS_TRACK = "GPSTrack" 6287``` 6288 6289**描述** 6290 6291GPS接收机的移动方向。 6292 6293**起始版本：** 12 6294 6295 6296### OHOS_IMAGE_PROPERTY_GPS_TRACK_REF 6297 6298``` 6299static const char* OHOS_IMAGE_PROPERTY_GPS_TRACK_REF = "GPSTrackRef" 6300``` 6301 6302**描述** 6303 6304GPS接收机移动方向的参照。 6305 6306**起始版本：** 12 6307 6308 6309### OHOS_IMAGE_PROPERTY_GPS_VERSION_ID 6310 6311``` 6312static const char* OHOS_IMAGE_PROPERTY_GPS_VERSION_ID = "GPSVersionID" 6313``` 6314 6315**描述** 6316 6317GPSInfoIFD的版本。 6318 6319**起始版本：** 12 6320 6321 6322### OHOS_IMAGE_PROPERTY_IMAGE_LENGTH 6323 6324``` 6325static const char* OHOS_IMAGE_PROPERTY_IMAGE_LENGTH = "ImageLength" 6326``` 6327 6328**描述** 6329 6330图片长度。 6331 6332**起始版本：** 12 6333 6334 6335### OHOS_IMAGE_PROPERTY_IMAGE_UNIQUE_ID 6336 6337``` 6338static const char* OHOS_IMAGE_PROPERTY_IMAGE_UNIQUE_ID = "ImageUniqueID" 6339``` 6340 6341**描述** 6342 6343为每张图片唯一分配的标识符。 6344 6345**起始版本：** 12 6346 6347 6348### OHOS_IMAGE_PROPERTY_IMAGE_WIDTH 6349 6350``` 6351static const char* OHOS_IMAGE_PROPERTY_IMAGE_WIDTH = "ImageWidth" 6352``` 6353 6354**描述** 6355 6356图片宽度。 6357 6358**起始版本：** 12 6359 6360 6361### OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEYYY 6362 6363``` 6364static const char* OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEYYY = "ISOSpeedLatitudeyyy" 6365``` 6366 6367**描述** 6368 6369该标签指示摄像机或输入设备的ISO速度纬度yyy值，该值在ISO 12232中定义。 6370 6371**起始版本：** 12 6372 6373 6374### OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEZZZ 6375 6376``` 6377static const char* OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEZZZ = "ISOSpeedLatitudezzz" 6378``` 6379 6380**描述** 6381 6382该标签指示摄像机或输入设备的ISO速度纬度zzz值，该值在ISO 12232中定义。 6383 6384**起始版本：** 12 6385 6386 6387### OHOS_IMAGE_PROPERTY_ISO_SPEED_RATINGS 6388 6389``` 6390static const char* OHOS_IMAGE_PROPERTY_ISO_SPEED_RATINGS = "ISOSpeedRatings" 6391``` 6392 6393**描述** 6394 6395ISO感光度，例如400。 6396 6397**起始版本：** 12 6398 6399 6400### OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT 6401 6402``` 6403static const char* OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT = "JPEGInterchangeFormat" 6404``` 6405 6406**描述** 6407 6408JPEG压缩缩略图数据开始字节（SOI）的偏移。 6409 6410**起始版本：** 12 6411 6412 6413### OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT_LENGTH 6414 6415``` 6416static const char* OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT_LENGTH = "JPEGInterchangeFormatLength" 6417``` 6418 6419**描述** 6420 6421JPEG压缩缩略图数据的字节数。 6422 6423**起始版本：** 12 6424 6425 6426### OHOS_IMAGE_PROPERTY_LENS_MAKE 6427 6428``` 6429static const char* OHOS_IMAGE_PROPERTY_LENS_MAKE = "LensMake" 6430``` 6431 6432**描述** 6433 6434镜头的制造商。 6435 6436**起始版本：** 12 6437 6438 6439### OHOS_IMAGE_PROPERTY_LENS_MODEL 6440 6441``` 6442static const char* OHOS_IMAGE_PROPERTY_LENS_MODEL = "LensModel" 6443``` 6444 6445**描述** 6446 6447镜头的型号名称。 6448 6449**起始版本：** 12 6450 6451 6452### OHOS_IMAGE_PROPERTY_LENS_SERIAL_NUMBER 6453 6454``` 6455static const char* OHOS_IMAGE_PROPERTY_LENS_SERIAL_NUMBER = "LensSerialNumber" 6456``` 6457 6458**描述** 6459 6460镜头的序列号。 6461 6462**起始版本：** 12 6463 6464 6465### OHOS_IMAGE_PROPERTY_LENS_SPECIFICATION 6466 6467``` 6468static const char* OHOS_IMAGE_PROPERTY_LENS_SPECIFICATION = "LensSpecification" 6469``` 6470 6471**描述** 6472 6473使用的镜头规格。 6474 6475**起始版本：** 12 6476 6477 6478### OHOS_IMAGE_PROPERTY_MAKER_NOTE 6479 6480``` 6481static const char* OHOS_IMAGE_PROPERTY_MAKER_NOTE = "MakerNote" 6482``` 6483 6484**描述** 6485 6486Exif/DCF制造商使用的标签，用于记录任何所需信息。 6487 6488**起始版本：** 12 6489 6490 6491### OHOS_IMAGE_PROPERTY_MAX_APERTURE_VALUE 6492 6493``` 6494static const char* OHOS_IMAGE_PROPERTY_MAX_APERTURE_VALUE = "MaxApertureValue" 6495``` 6496 6497**描述** 6498 6499最小F数镜头。 6500 6501**起始版本：** 12 6502 6503 6504### OHOS_IMAGE_PROPERTY_NEW_SUBFILE_TYPE 6505 6506``` 6507static const char* OHOS_IMAGE_PROPERTY_NEW_SUBFILE_TYPE = "NewSubfileType" 6508``` 6509 6510**描述** 6511 6512在Exif中，"NewSubfileType"字段用于标识子文件的数据类型，如全分辨率图像、缩略图或多帧图像的一部分。其值是位掩码，0代表全分辨率图像，1代表缩略图，2代表多帧图像的一部分。 6513 6514**起始版本：** 12 6515 6516 6517### OHOS_IMAGE_PROPERTY_OECF 6518 6519``` 6520static const char* OHOS_IMAGE_PROPERTY_OECF = "OECF" 6521``` 6522 6523**描述** 6524 6525表示ISO 14524中规定的光电转换函数（OECF）。 6526 6527**起始版本：** 12 6528 6529 6530### OHOS_IMAGE_PROPERTY_OFFSET_TIME 6531 6532``` 6533static const char* OHOS_IMAGE_PROPERTY_OFFSET_TIME = "OffsetTime" 6534``` 6535 6536**描述** 6537 6538在Exif中，OffsetTime字段表示与UTC（协调世界时）的时间偏移，格式为±HH:MM，用于确定照片拍摄的本地时间。 6539 6540**起始版本：** 12 6541 6542 6543### OHOS_IMAGE_PROPERTY_OFFSET_TIME_DIGITIZED 6544 6545``` 6546static const char* OHOS_IMAGE_PROPERTY_OFFSET_TIME_DIGITIZED = "OffsetTimeDigitized" 6547``` 6548 6549**描述** 6550 6551此标签记录图像数字化时的UTC偏移量，有助于准确调整时间戳。 6552 6553**起始版本：** 12 6554 6555 6556### OHOS_IMAGE_PROPERTY_OFFSET_TIME_ORIGINAL 6557 6558``` 6559static const char* OHOS_IMAGE_PROPERTY_OFFSET_TIME_ORIGINAL = "OffsetTimeOriginal" 6560``` 6561 6562**描述** 6563 6564此标签记录原始图像创建时的UTC偏移量，对于时间敏感的应用至关重要。 6565 6566**起始版本：** 12 6567 6568 6569### OHOS_IMAGE_PROPERTY_ORIENTATION 6570 6571``` 6572static const char* OHOS_IMAGE_PROPERTY_ORIENTATION = "Orientation" 6573``` 6574 6575**描述** 6576 6577图片方向。 6578 6579**起始版本：** 12 6580 6581 6582### OHOS_IMAGE_PROPERTY_PHOTOGRAPHIC_SENSITIVITY 6583 6584``` 6585static const char* OHOS_IMAGE_PROPERTY_PHOTOGRAPHIC_SENSITIVITY = "PhotographicSensitivity" 6586``` 6587 6588**描述** 6589 6590此标签指示拍摄图像时相机或输入设备的灵敏度。 6591 6592**起始版本：** 12 6593 6594 6595### OHOS_IMAGE_PROPERTY_PHOTOMETRIC_INTERPRETATION 6596 6597``` 6598static const char* OHOS_IMAGE_PROPERTY_PHOTOMETRIC_INTERPRETATION = "PhotometricInterpretation" 6599``` 6600 6601**描述** 6602 6603像素构成，例如RGB或YCbCr。 6604 6605**起始版本：** 12 6606 6607 6608### OHOS_IMAGE_PROPERTY_PLANAR_CONFIGURATION 6609 6610``` 6611const char* OHOS_IMAGE_PROPERTY_PLANAR_CONFIGURATION = "PlanarConfiguration" 6612``` 6613 6614**描述** 6615 6616表示像素组件的记录格式，chunky格式或是planar格式。 6617 6618**起始版本：** 12 6619 6620 6621### OHOS_IMAGE_PROPERTY_PRIMARY_CHROMATICITIES 6622 6623``` 6624static const char* OHOS_IMAGE_PROPERTY_PRIMARY_CHROMATICITIES = "PrimaryChromaticities" 6625``` 6626 6627**描述** 6628 6629图像的主要颜色的色度。 6630 6631**起始版本：** 12 6632 6633 6634### OHOS_IMAGE_PROPERTY_REFERENCE_BLACK_WHITE 6635 6636``` 6637static const char* OHOS_IMAGE_PROPERTY_REFERENCE_BLACK_WHITE = "ReferenceBlackWhite" 6638``` 6639 6640**描述** 6641 6642参考黑点值和参考白点值。 6643 6644**起始版本：** 12 6645 6646 6647### OHOS_IMAGE_PROPERTY_RELATED_SOUND_FILE 6648 6649``` 6650static const char* OHOS_IMAGE_PROPERTY_RELATED_SOUND_FILE = "RelatedSoundFile" 6651``` 6652 6653**描述** 6654 6655与图像数据相关的音频文件的名称。 6656 6657**起始版本：** 12 6658 6659 6660### OHOS_IMAGE_PROPERTY_RESOLUTION_UNIT 6661 6662``` 6663static const char* OHOS_IMAGE_PROPERTY_RESOLUTION_UNIT = "ResolutionUnit" 6664``` 6665 6666**描述** 6667 6668用于测量XResolution和YResolution的单位。 6669 6670**起始版本：** 12 6671 6672 6673### OHOS_IMAGE_PROPERTY_ROWS_PER_STRIP 6674 6675``` 6676static const char* OHOS_IMAGE_PROPERTY_ROWS_PER_STRIP = "RowsPerStrip" 6677``` 6678 6679**描述** 6680 6681每个strip的图像数据行数。 6682 6683**起始版本：** 12 6684 6685 6686### OHOS_IMAGE_PROPERTY_SAMPLES_PER_PIXEL 6687 6688``` 6689static const char* OHOS_IMAGE_PROPERTY_SAMPLES_PER_PIXEL = "SamplesPerPixel" 6690``` 6691 6692**描述** 6693 6694每个像素的分量数。由于该标准适用于 RGB 和 YCbCr 图像，因此该标签的值设置为 3。在JPEG压缩数据中，使用JPEG标记代替该标签。 6695 6696**起始版本：** 12 6697 6698 6699### OHOS_IMAGE_PROPERTY_SATURATION 6700 6701``` 6702static const char* OHOS_IMAGE_PROPERTY_SATURATION = "Saturation" 6703``` 6704 6705**描述** 6706 6707相机应用的饱和度处理方向。 6708 6709**起始版本：** 12 6710 6711 6712### OHOS_IMAGE_PROPERTY_SCENE_CAPTURE_TYPE 6713 6714``` 6715static const char* OHOS_IMAGE_PROPERTY_SCENE_CAPTURE_TYPE = "SceneCaptureType" 6716``` 6717 6718**描述** 6719 6720捕获的场景类型。 6721 6722**起始版本：** 12 6723 6724 6725### OHOS_IMAGE_PROPERTY_SCENE_POINTER 6726 6727``` 6728static const char* OHOS_IMAGE_PROPERTY_SCENE_POINTER = "HwMnoteScenePointer" 6729``` 6730 6731**描述** 6732 6733场景指针。 6734 6735**起始版本：** 12 6736 6737 6738### OHOS_IMAGE_PROPERTY_SCENE_TYPE 6739 6740``` 6741static const char* OHOS_IMAGE_PROPERTY_SCENE_TYPE = "SceneType" 6742``` 6743 6744**描述** 6745 6746拍摄场景模式，例如人像、风光、运动、夜景等。 6747 6748**起始版本：** 12 6749 6750 6751### OHOS_IMAGE_PROPERTY_SCENE_VERSION 6752 6753``` 6754static const char* OHOS_IMAGE_PROPERTY_SCENE_VERSION = "HwMnoteSceneVersion" 6755``` 6756 6757**描述** 6758 6759场景算法版本信息。 6760 6761**起始版本：** 12 6762 6763 6764### OHOS_IMAGE_PROPERTY_SENSING_METHOD 6765 6766``` 6767static const char* OHOS_IMAGE_PROPERTY_SENSING_METHOD = "SensingMethod" 6768``` 6769 6770**描述** 6771 6772相机上的图像传感器类型。 6773 6774**起始版本：** 12 6775 6776 6777### OHOS_IMAGE_PROPERTY_SHARPNESS 6778 6779``` 6780static const char* OHOS_IMAGE_PROPERTY_SHARPNESS = "Sharpness" 6781``` 6782 6783**描述** 6784 6785相机应用的锐度处理方向。 6786 6787**起始版本：** 12 6788 6789 6790### OHOS_IMAGE_PROPERTY_SHUTTER_SPEED_VALUE 6791 6792``` 6793static const char* OHOS_IMAGE_PROPERTY_SHUTTER_SPEED_VALUE = "ShutterSpeedValue" 6794``` 6795 6796**描述** 6797 6798快门速度，以APEX（摄影曝光的加法系统）值表示。 6799 6800**起始版本：** 12 6801 6802 6803### OHOS_IMAGE_PROPERTY_SOFTWARE 6804 6805``` 6806static const char* OHOS_IMAGE_PROPERTY_SOFTWARE = "Software" 6807``` 6808 6809**描述** 6810 6811用于生成图像的软件的名称和版本。 6812 6813**起始版本：** 12 6814 6815 6816### OHOS_IMAGE_PROPERTY_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE 6817 6818``` 6819static const char* OHOS_IMAGE_PROPERTY_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE = "SourceExposureTimesOfCompositeImage" 6820``` 6821 6822**描述** 6823 6824合成图像的源图像曝光时间。 6825 6826**起始版本：** 12 6827 6828 6829### OHOS_IMAGE_PROPERTY_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE 6830 6831``` 6832static const char* OHOS_IMAGE_PROPERTY_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE = "SourceImageNumberOfCompositeImage" 6833``` 6834 6835**描述** 6836 6837用于合成图像的源图像数量。 6838 6839**起始版本：** 12 6840 6841 6842### OHOS_IMAGE_PROPERTY_SPATIAL_FREQUENCY_RESPONSE 6843 6844``` 6845static const char* OHOS_IMAGE_PROPERTY_SPATIAL_FREQUENCY_RESPONSE = "SpatialFrequencyResponse" 6846``` 6847 6848**描述** 6849 6850相机或输入设备的空间频率表。 6851 6852**起始版本：** 12 6853 6854 6855### OHOS_IMAGE_PROPERTY_SPECTRAL_SENSITIVITY 6856 6857``` 6858static const char* OHOS_IMAGE_PROPERTY_SPECTRAL_SENSITIVITY = "SpectralSensitivity" 6859``` 6860 6861**描述** 6862 6863表示所用相机的每个通道的光谱灵敏度。 6864 6865**起始版本：** 12 6866 6867 6868### OHOS_IMAGE_PROPERTY_STRIP_BYTE_COUNTS 6869 6870``` 6871static const char* OHOS_IMAGE_PROPERTY_STRIP_BYTE_COUNTS = "StripByteCounts" 6872``` 6873 6874**描述** 6875 6876每个图像数据带的总字节数。 6877 6878**起始版本：** 12 6879 6880 6881### OHOS_IMAGE_PROPERTY_STRIP_OFFSETS 6882 6883``` 6884static const char* OHOS_IMAGE_PROPERTY_STRIP_OFFSETS = "StripOffsets" 6885``` 6886 6887**描述** 6888 6889每个strip的字节偏移量。 6890 6891**起始版本：** 12 6892 6893 6894### OHOS_IMAGE_PROPERTY_SUBFILE_TYPE 6895 6896``` 6897static const char* OHOS_IMAGE_PROPERTY_SUBFILE_TYPE = "SubfileType" 6898``` 6899 6900**描述** 6901 6902此标签指示此子文件中的数据类型。标签已弃用，请使用NewSubfileType替代。 6903 6904**起始版本：** 12 6905 6906 6907### OHOS_IMAGE_PROPERTY_SUBJECT_AREA 6908 6909``` 6910static const char* OHOS_IMAGE_PROPERTY_SUBJECT_AREA = "SubjectArea" 6911``` 6912 6913**描述** 6914 6915该标签指示整个场景中主要主体的位置和区域。 6916 6917**起始版本：** 12 6918 6919 6920### OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE 6921 6922``` 6923static const char* OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE = "SubjectDistance" 6924``` 6925 6926**描述** 6927 6928测量单位为米的主体距离。 6929 6930**起始版本：** 12 6931 6932 6933### OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE_RANGE 6934 6935``` 6936static const char* OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE_RANGE = "SubjectDistanceRange" 6937``` 6938 6939**描述** 6940 6941表示主体到相机的距离范围。 6942 6943**起始版本：** 12 6944 6945 6946### OHOS_IMAGE_PROPERTY_SUBJECT_LOCATION 6947 6948``` 6949static const char* OHOS_IMAGE_PROPERTY_SUBJECT_LOCATION = "SubjectLocation" 6950``` 6951 6952**描述** 6953 6954主要对象相对于左边缘的位置。 6955 6956**起始版本：** 12 6957 6958 6959### OHOS_IMAGE_PROPERTY_SUBSEC_TIME 6960 6961``` 6962static const char* OHOS_IMAGE_PROPERTY_SUBSEC_TIME = "SubsecTime" 6963``` 6964 6965**描述** 6966 6967用于为DateTime标签记录秒的分数的标签。 6968 6969**起始版本：** 12 6970 6971 6972### OHOS_IMAGE_PROPERTY_SUBSEC_TIME_DIGITIZED 6973 6974``` 6975static const char* OHOS_IMAGE_PROPERTY_SUBSEC_TIME_DIGITIZED = "SubsecTimeDigitized" 6976``` 6977 6978**描述** 6979 6980用于为DateTimeDigitized标签记录秒的分数的标签。 6981 6982**起始版本：** 12 6983 6984 6985### OHOS_IMAGE_PROPERTY_SUBSEC_TIME_ORIGINAL 6986 6987``` 6988static const char* OHOS_IMAGE_PROPERTY_SUBSEC_TIME_ORIGINAL = "SubsecTimeOriginal" 6989``` 6990 6991**描述** 6992 6993用于为DateTimeOriginal标签记录秒的分数的标签。 6994 6995**起始版本：** 12 6996 6997 6998### OHOS_IMAGE_PROPERTY_TRANSFER_FUNCTION 6999 7000``` 7001static const char* OHOS_IMAGE_PROPERTY_TRANSFER_FUNCTION = "TransferFunction" 7002``` 7003 7004**描述** 7005 7006图像的传递函数，通常用于颜色校正。 7007 7008**起始版本：** 12 7009 7010 7011### OHOS_IMAGE_PROPERTY_WHITE_POINT 7012 7013``` 7014static const char* OHOS_IMAGE_PROPERTY_WHITE_POINT = "WhitePoint" 7015``` 7016 7017**描述** 7018 7019图像的白点色度。 7020 7021**起始版本：** 12 7022 7023 7024### OHOS_IMAGE_PROPERTY_X_IN_ORIGINAL 7025 7026``` 7027static const char *OHOS_IMAGE_PROPERTY_X_IN_ORIGINAL = "XInOriginal" 7028``` 7029 7030**描述** 7031 7032水印裁剪图左上角在原始图中的X坐标。 7033 7034**起始版本：** 13 7035 7036 7037### OHOS_IMAGE_PROPERTY_X_RESOLUTION 7038 7039``` 7040static const char* OHOS_IMAGE_PROPERTY_X_RESOLUTION = "XResolution" 7041``` 7042 7043**描述** 7044 7045图像宽度方向的分辨率。 7046 7047**起始版本：** 12 7048 7049 7050### OHOS_IMAGE_PROPERTY_Y_IN_ORIGINAL 7051 7052``` 7053static const char *OHOS_IMAGE_PROPERTY_Y_IN_ORIGINAL = "YInOriginal" 7054``` 7055 7056**描述** 7057 7058水印裁剪图左上角在原始图中的Y坐标。 7059 7060**起始版本：** 13 7061 7062 7063### OHOS_IMAGE_PROPERTY_Y_RESOLUTION 7064 7065``` 7066static const char* OHOS_IMAGE_PROPERTY_Y_RESOLUTION = "YResolution" 7067``` 7068 7069**描述** 7070 7071图像高度方向的分辨率。 7072 7073**起始版本：** 12 7074 7075 7076### OHOS_IMAGE_PROPERTY_YCBCR_COEFFICIENTS 7077 7078``` 7079static const char* OHOS_IMAGE_PROPERTY_YCBCR_COEFFICIENTS = "YCbCrCoefficients" 7080``` 7081 7082**描述** 7083 7084从RGB到YCbCr图像数据的转换矩阵系数。 7085 7086**起始版本：** 12 7087 7088 7089### OHOS_IMAGE_PROPERTY_YCBCR_POSITIONING 7090 7091``` 7092static const char* OHOS_IMAGE_PROPERTY_YCBCR_POSITIONING = "YCbCrPositioning" 7093``` 7094 7095**描述** 7096 7097色度分量相对于亮度分量的位置。 7098 7099**起始版本：** 12 7100 7101 7102### OHOS_IMAGE_PROPERTY_YCBCR_SUB_SAMPLING 7103 7104``` 7105static const char* OHOS_IMAGE_PROPERTY_YCBCR_SUB_SAMPLING = "YCbCrSubSampling" 7106``` 7107 7108**描述** 7109 7110色度分量与亮度分量的采样比率。 7111 7112**起始版本：** 12 7113 7114 7115