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