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