1# Image_NativeModule 2 3 4## Overview 5 6The Image_NativeModule module provides image processing capabilities, including encoding and decoding an image and obtaining image data from the native layer. 7 8The APIs of this module do not need to be imported through the JS interface. You can directly use the NDK to develop the features. 9 10**Since**: 12 11 12 13## Summary 14 15 16### Files 17 18| Name| Description| 19| -------- | -------- | 20| [image_common.h](image__common_8h.md) | Declares the common enums and structs used by the image interface.| 21| [image_native.h](image__native_8h.md) | Declares the cropping rectangle, size, and component data of an image.| 22| [image_packer_native.h](image__packer__native_8h.md) | Declares the APIs for image encoding.| 23| [image_receiver_native.h](image__receiver__native_8h.md) | Declares the APIs used to obtain image data from the native layer.| 24| [image_source_native.h](image__source__native_8h.md) | Declares the APIs for image decoding.| 25| [pixelmap_native.h](pixelmap__native_8h.md) | Declares the APIs for accessing a pixel map.| 26 27 28### Structs 29 30| Name| Description| 31| -------- | -------- | 32| struct [Image_Size](_image___size.md) | Describes the image size. | 33| struct [Image_Region](_image___region.md) | Describes the region of an image to decode. | 34| struct [Image_String](_image___string.md) | Describes an image string. | 35| struct [OH_Pixelmap_HdrStaticMetadata](_o_h___pixelmap___hdr_static_metadata.md) | Describes the static metadata values available for the key **HDR_STATIC_METADATA**. | 36| struct [OH_Pixelmap_HdrDynamicMetadata](_o_h___pixelmap___hdr_dynamic_metadata.md) | Describes the dynamic metadata values available for the key **DR_DYNAMIC_METADATA**. | 37| struct [OH_Pixelmap_HdrGainmapMetadata](_o_h___pixelmap___hdr_gainmap_metadata.md) | Describes the gain map metadata values available for the key **HDR_GAINMAP_METADATA**. For details, see ISO 21496-1. | 38| struct [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) | Describes the HDR metadata values used by the pixel map and available for the key **OH_Pixelmap_HdrMetadataKey**. | 39 40### Types 41 42| Name| Description| 43| -------- | -------- | 44| typedef struct [Image_Size](_image___size.md) [Image_Size](#image_size) | Defines a struct for the image size. | 45| typedef struct [Image_Region](_image___region.md) [Image_Region](#image_region) | Defines a struct for the region of an image to decode. | 46| typedef struct [Image_String](_image___string.md) [Image_String](#image_string) | Defines a struct for an image string. | 47| typedef struct [Image_String](_image___string.md) [Image_MimeType](#image_mimetype) | Defines a struct for an image format type. | 48| typedef struct [OH_ImageNative](#oh_imagenative) [OH_ImageNative](#oh_imagenative) | Defines the alias for an image object at the native layer. | 49| typedef struct [OH_ImagePackerNative](#oh_imagepackernative) [OH_ImagePackerNative](#oh_imagepackernative) | Defines the **ImagePacker** struct, which is used to perform operations related to an image packer.| 50| typedef struct [OH_PackingOptions](#oh_packingoptions) [OH_PackingOptions](#oh_packingoptions) | Defines a struct for image encoding parameters.| 51| typedef struct [OH_ImageReceiverNative](#oh_imagereceivernative) [OH_ImageReceiverNative](#oh_imagereceivernative) | Defines the data type name of the image receiver at the native layer. | 52| typedef struct [OH_ImageReceiverOptions](#oh_imagereceiveroptions) [OH_ImageReceiverOptions](#oh_imagereceiveroptions) | Defines the data type name of the image receiver options. | 53| typedef void(\* [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback)) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver) | Defines the callbacks for the image receiver at the native layer. | 54| typedef struct [OH_ImageSourceNative](#oh_imagesourcenative) [OH_ImageSourceNative](#oh_imagesourcenative) | Defines the **ImageSource** struct, which is used to perform operations related to an image source.| 55| typedef struct [OH_ImageSource_Info](#oh_imagesource_info) [OH_ImageSource_Info](#oh_imagesource_info) | Defines a struct for the image source information, which is created by calling [OH_ImageSourceInfo_Create](#oh_imagesourceinfo_create).| 56| typedef struct [OH_DecodingOptions](#oh_decodingoptions) [OH_DecodingOptions](#oh_decodingoptions) | Defines a struct for decoding parameters, which are used in [OH_ImageSourceNative_CreatePixelmap](#oh_imagesourcenative_createpixelmap).| 57| typedef struct [OH_PixelmapNative](#oh_pixelmapnative) [OH_PixelmapNative](#oh_pixelmapnative) | Defines the **Pixelmap** struct, which is used to perform operations related to a pixel map.| 58| typedef struct [OH_NativeBuffer](#oh_nativebuffer) [OH_NativeBuffer](#oh_nativebuffer) | Defines the **NativeBuffer** struct, which is used to perform operations related to the native buffer.| 59| typedef struct [OH_Pixelmap_HdrStaticMetadata](_o_h___pixelmap___hdr_static_metadata.md) [OH_Pixelmap_HdrStaticMetadata](#oh_pixelmap_hdrstaticmetadata) | Defines a struct for the static metadata values available for the key **HDR_STATIC_METADATA**. | 60| typedef struct [OH_Pixelmap_HdrDynamicMetadata](_o_h___pixelmap___hdr_dynamic_metadata.md) [OH_Pixelmap_HdrDynamicMetadata](#oh_pixelmap_hdrdynamicmetadata) | Defines a struct for the dynamic metadata values available for the key **DR_DYNAMIC_METADATA**. | 61| typedef struct [OH_Pixelmap_HdrGainmapMetadata](_o_h___pixelmap___hdr_gainmap_metadata.md) [OH_Pixelmap_HdrGainmapMetadata](#oh_pixelmap_hdrgainmapmetadata) | Defines a struct for the gain map metadata values available for the key **HDR_GAINMAP_METADATA**. For details, see ISO 21496-1. | 62| typedef struct [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) [OH_Pixelmap_HdrMetadataValue](#oh_pixelmap_hdrmetadatavalue) | Defines a struct for the HDR metadata values used by the pixel map a the key [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey). It is used in [OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata) and [OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata). | 63| typedef struct [OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) [OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) | Defines a struct for the initialization parameters.| 64| typedef struct [OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) [OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) | Defines a struct for the image information.| 65 66 67### Enums 68 69| Name| Description| 70| -------- | -------- | 71| [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_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>} | Enumerates the error codes. | 72| [IMAGE_PACKER_DYNAMIC_RANGE](#image_packer_dynamic_range) {<br>IMAGE_PACKER_DYNAMIC_RANGE_AUTO = 0,<br>IMAGE_PACKER_DYNAMIC_RANGE_SDR = 1 } | Enumerates the desired dynamic range for encoding.| 73| [IMAGE_DYNAMIC_RANGE](#image_dynamic_range) {<br>IMAGE_DYNAMIC_RANGE_AUTO = 0,<br>IMAGE_DYNAMIC_RANGE_SDR = 1,<br>IMAGE_DYNAMIC_RANGE_HDR = 2 } | Enumerates the desired dynamic range for decoding.| 74| [PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type) {<br>PIXELMAP_ALPHA_TYPE_UNKNOWN = 0,<br>PIXELMAP_ALPHA_TYPE_OPAQUE = 1,<br>PIXELMAP_ALPHA_TYPE_PREMULTIPLIED = 2 } | Enumerates the alpha types of a pixel map.| 75| [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>} | Enumerates the image pixel formats.| 76| [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>} | Enumerates the antialiasing levels used for scaling pixel maps. | 77| [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 } | Enumerates the keys of the HDR related metadata information used by the pixel map. It is used in [OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata) and [OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata). | 78| [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 } | Enumerates the HDR metadata types, which are the values of **HDR_METADATA_TYPE**. | 79 80 81### Functions 82 83| Name| Description| 84| -------- | -------- | 85| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetImageSize](#oh_imagenative_getimagesize) ([OH_ImageNative](#oh_imagenative) \*image, [Image_Size](_image___size.md) \*size) | Obtains the [Image_Size](_image___size.md) information of an [OH_ImageNative](#oh_imagenative) object.| 86| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetComponentTypes](#oh_imagenative_getcomponenttypes) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t \*\*types, size_t \*typeSize) | Obtains the component types of an [OH_ImageNative](#oh_imagenative) object.| 87| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetByteBuffer](#oh_imagenative_getbytebuffer) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, OH_NativeBuffer \*\*nativeBuffer) | Obtains the buffer corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object.| 88| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetBufferSize](#oh_imagenative_getbuffersize) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, size_t \*size) | Obtains the size of the buffer corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object.| 89| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetRowStride](#oh_imagenative_getrowstride) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, int32_t \*rowStride) | Obtains the row stride corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object.| 90| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_GetPixelStride](#oh_imagenative_getpixelstride) ([OH_ImageNative](#oh_imagenative) \*image, uint32_t componentType, int32_t \*pixelStride) | Obtains the pixel stride corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object.| 91| [Image_ErrorCode](#image_errorcode) [OH_ImageNative_Release](#oh_imagenative_release) ([OH_ImageNative](#oh_imagenative) \*image) | Releases an [OH_ImageNative](#oh_imagenative) object.| 92| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_Create](#oh_packingoptions_create) ([OH_PackingOptions](#oh_packingoptions) \*\*options) | Creates the pointer to an **OH_PackingOptions** object.| 93| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_GetMimeType](#oh_packingoptions_getmimetype) ([OH_PackingOptions](#oh_packingoptions) \*options, [Image_MimeType](#image_mimetype) \*format) | Obtains the MIME type.| 94| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_SetMimeType](#oh_packingoptions_setmimetype) ([OH_PackingOptions](#oh_packingoptions) \*options, [Image_MimeType](#image_mimetype) \*format) | Sets the MIME type.| 95| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_GetQuality](#oh_packingoptions_getquality) ([OH_PackingOptions](#oh_packingoptions) \*options, uint32_t \*quality) | Obtains the encoding quality.| 96| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_SetQuality](#oh_packingoptions_setquality) ([OH_PackingOptions](#oh_packingoptions) \*options, uint32_t quality) | Sets the encoding quality.| 97| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_GetDesiredDynamicRange](#oh_packingoptions_getdesireddynamicrange) ([OH_PackingOptions](#oh_packingoptions) \*options, int32_t \*desiredDynamicRange) | Obtains the desired dynamic range during encoding.| 98| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_SetDesiredDynamicRange](#oh_packingoptions_setdesireddynamicrange) ([OH_PackingOptions](#oh_packingoptions) \*options, int32_t desiredDynamicRange) | Sets the desired dynamic range during encoding.| 99| [Image_ErrorCode](#image_errorcode) [OH_PackingOptions_Release](#oh_packingoptions_release) ([OH_PackingOptions](#oh_packingoptions) \*options) | Releases the pointer to an **OH_PackingOptions** object.| 100| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_Create](#oh_imagepackernative_create) ([OH_ImagePackerNative](#oh_imagepackernative) \*\*imagePacker) | Creates the pointer to an **OH_ImagePackerNative** object.| 101| [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) | Encodes an image source into data in a given format.| 102| [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) | Encodes a pixel map into data in a given format.| 103| [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) | Encodes an image source into a file.| 104| [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) | Encodes a pixel map into a file.| 105| [Image_ErrorCode](#image_errorcode) [OH_ImagePackerNative_Release](#oh_imagepackernative_release) ([OH_ImagePackerNative](#oh_imagepackernative) \*imagePacker) | Releases the pointer to an **OH_ImagePackerNative** object.| 106| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_Create](#oh_imagereceiveroptions_create) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*\*options) | Creates an **OH_ImageReceiverOptions** object at the application layer.| 107| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_GetSize](#oh_imagereceiveroptions_getsize) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, [Image_Size](_image___size.md) \*size) | Obtains the [Image_Size](_image___size.md) information of an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object.| 108| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_SetSize](#oh_imagereceiveroptions_setsize) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, [Image_Size](_image___size.md) size) | Sets the [Image_Size](_image___size.md) information for an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object.| 109| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_GetCapacity](#oh_imagereceiveroptions_getcapacity) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, int32_t \*capacity) | Obtains the capacity of an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object.| 110| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_SetCapacity](#oh_imagereceiveroptions_setcapacity) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, int32_t capacity) | Sets the capacity for an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object.| 111| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverOptions_Release](#oh_imagereceiveroptions_release) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options) | Releases an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object.| 112| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_Create](#oh_imagereceivernative_create) ([OH_ImageReceiverOptions](#oh_imagereceiveroptions) \*options, [OH_ImageReceiverNative](#oh_imagereceivernative) \*\*receiver) | Creates an **OH_ImageReceiverNative** object at the application layer.| 113| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_GetReceivingSurfaceId](#oh_imagereceivernative_getreceivingsurfaceid) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, uint64_t \*surfaceId) | Obtains the receiver ID through an [OH_ImageReceiverNative](#oh_imagereceivernative) object.| 114| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_ReadLatestImage](#oh_imagereceivernative_readlatestimage) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [OH_ImageNative](#oh_imagenative) \*\*image) | Obtains the latest image through an [OH_ImageReceiverNative](#oh_imagereceivernative) object.| 115| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_ReadNextImage](#oh_imagereceivernative_readnextimage) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [OH_ImageNative](#oh_imagenative) \*\*image) | Obtains the next image through an [OH_ImageReceiverNative](#oh_imagereceivernative) object.| 116| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_On](#oh_imagereceivernative_on) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) callback) | Registers a callback, which is an [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) object.| 117| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_Off](#oh_imagereceivernative_off) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver) | Unregisters a callback, which is an [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) object.| 118| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_GetSize](#oh_imagereceivernative_getsize) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, [Image_Size](_image___size.md) \*size) | Obtains the size of an image receiver, which is an [OH_ImageReceiverNative](#oh_imagereceivernative) object.| 119| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_GetCapacity](#oh_imagereceivernative_getcapacity) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver, int32_t \*capacity) | Obtains the capacity of an image receiver, which is an [OH_ImageReceiverNative](#oh_imagereceivernative) object.| 120| [Image_ErrorCode](#image_errorcode) [OH_ImageReceiverNative_Release](#oh_imagereceivernative_release) ([OH_ImageReceiverNative](#oh_imagereceivernative) \*receiver) | Releases an [OH_ImageReceiverNative](#oh_imagereceivernative) object.| 121| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_Create](#oh_imagesourceinfo_create) ([OH_ImageSource_Info](#oh_imagesource_info) \*\*info) | Creates the pointer to an **OH_ImageSource_Info** object.| 122| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_GetWidth](#oh_imagesourceinfo_getwidth) ([OH_ImageSource_Info](#oh_imagesource_info) \*info, uint32_t \*width) | Obtains the image width.| 123| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_GetHeight](#oh_imagesourceinfo_getheight) ([OH_ImageSource_Info](#oh_imagesource_info) \*info, uint32_t \*height) | Obtains the image height.| 124| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_GetDynamicRange](#oh_imagesourceinfo_getdynamicrange) ([OH_ImageSource_Info](#oh_imagesource_info) \*info, bool \*isHdr) | Obtains the dynamic range of an image.| 125| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceInfo_Release](#oh_imagesourceinfo_release) ([OH_ImageSource_Info](#oh_imagesource_info) \*info) | Releases the pointer to an **OH_ImageSource_Info** object.| 126| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_Create](#oh_decodingoptions_create) ([OH_DecodingOptions](#oh_decodingoptions) \*\*options) | Creates the pointer to an **OH_DecodingOptions** object.| 127| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetPixelFormat](#oh_decodingoptions_getpixelformat) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t \*pixelFormat) | Obtains the pixel format.| 128| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetPixelFormat](#oh_decodingoptions_setpixelformat) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t pixelFormat) | Sets the pixel format.| 129| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetIndex](#oh_decodingoptions_getindex) ([OH_DecodingOptions](#oh_decodingoptions) \*options, uint32_t \*index) | Obtains the index of an image.| 130| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetIndex](#oh_decodingoptions_setindex) ([OH_DecodingOptions](#oh_decodingoptions) \*options, uint32_t index) | Sets the index for an image.| 131| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetRotate](#oh_decodingoptions_getrotate) ([OH_DecodingOptions](#oh_decodingoptions) \*options, float \*rotate) | Obtains the rotation degree.| 132| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetRotate](#oh_decodingoptions_setrotate) ([OH_DecodingOptions](#oh_decodingoptions) \*options, float rotate) | Sets the rotation angle.| 133| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetDesiredSize](#oh_decodingoptions_getdesiredsize) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Size](_image___size.md) \*desiredSize) | Obtains the desired output size.| 134| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetDesiredSize](#oh_decodingoptions_setdesiredsize) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Size](_image___size.md) \*desiredSize) | Sets the desired output size.| 135| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetDesiredRegion](#oh_decodingoptions_getdesiredregion) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Region](_image___region.md) \*desiredRegion) | Obtains the region to decode.| 136| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetDesiredRegion](#oh_decodingoptions_setdesiredregion) ([OH_DecodingOptions](#oh_decodingoptions) \*options, [Image_Region](_image___region.md) \*desiredRegion) | Sets the region to decode.| 137| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_GetDesiredDynamicRange](#oh_decodingoptions_getdesireddynamicrange) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t \*desiredDynamicRange) | Obtains the desired dynamic range configured during decoding.| 138| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_SetDesiredDynamicRange](#oh_decodingoptions_setdesireddynamicrange) ([OH_DecodingOptions](#oh_decodingoptions) \*options, int32_t desiredDynamicRange) | Sets the desired dynamic range during decoding.| 139| [Image_ErrorCode](#image_errorcode) [OH_DecodingOptions_Release](#oh_decodingoptions_release) ([OH_DecodingOptions](#oh_decodingoptions) \*options) | Releases the pointer to an **OH_DecodingOptions** object.| 140| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromUri](#oh_imagesourcenative_createfromuri) (char \*uri, size_t uriSize, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | Creates the pointer to an **OH_ImageSourceNative** object based on a URI.| 141| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromFd](#oh_imagesourcenative_createfromfd) (int32_t fd, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | Creates the pointer to an **OH_ImageSourceNative** object based on a file descriptor.| 142| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromData](#oh_imagesourcenative_createfromdata) (uint8_t \*data, size_t dataSize, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | Creates the pointer to an **OH_ImageSourceNative** object based on buffer data.| 143| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreateFromRawFile](#oh_imagesourcenative_createfromrawfile) (RawFileDescriptor \*rawFile, [OH_ImageSourceNative](#oh_imagesourcenative) \*\*res) | Creates the pointer to an **OH_ImageSourceNative** object by using the raw file descriptor of an image resource file.| 144| [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) | Creates the pointer to an **OH_PixelmapNative** object based on image decoding parameters.| 145| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_CreatePixelmapList](#oh_imagesourcenative_createpixelmaplist) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, [OH_DecodingOptions](#oh_decodingoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*resVecPixMap[], size_t size) | Creates an array of **OH_PixelmapNative** objects based on image decoding parameters.| 146| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_GetDelayTimeList](#oh_imagesourcenative_getdelaytimelist) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, int32_t \*delayTimeList, size_t size) | Obtains the image delay time list.| 147| [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) | Obtains the information about an image with a given index.| 148| [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) | Obtains the value of an image property.| 149| [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) | Modifies the value of an image property.| 150| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source, uint32_t \*frameCount) | Obtains the number of image frames.| 151| [Image_ErrorCode](#image_errorcode) [OH_ImageSourceNative_Release](#oh_imagesourcenative_release) ([OH_ImageSourceNative](#oh_imagesourcenative) \*source) | Releases the pointer to an **OH_ImageSourceNative** object.| 152| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_Create](#oh_pixelmapinitializationoptions_create) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*\*options) | Creates the pointer to an **OH_Pixelmap_InitializationOptions** object.| 153| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetWidth](#oh_pixelmapinitializationoptions_getwidth) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t \*width) | Obtains the image width.| 154| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetWidth](#oh_pixelmapinitializationoptions_setwidth) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t width) | Sets the image width.| 155| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetHeight](#oh_pixelmapinitializationoptions_getheight) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t \*height) | Obtains the image height.| 156| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetHeight](#oh_pixelmapinitializationoptions_setheight) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, uint32_t height) | Sets the image height.| 157| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetPixelFormat](#oh_pixelmapinitializationoptions_getpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*pixelFormat) | Obtains the pixel format.| 158| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetPixelFormat](#oh_pixelmapinitializationoptions_setpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t pixelFormat) | Sets the pixel format.| 159| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetSrcPixelFormat](#oh_pixelmapinitializationoptions_getsrcpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*srcpixelFormat) | Obtains the source pixel format.| 160| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetSrcPixelFormat](#oh_pixelmapinitializationoptions_setsrcpixelformat) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t srcpixelFormat) | Sets the source pixel format.| 161| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetRowStride](#oh_pixelmapinitializationoptions_getrowstride) (OH_Pixelmap_InitializationOptions \*options, int32_t \*rowStride) | Obtains the row stride. | 162| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetRowStride](#oh_pixelmapinitializationoptions_setrowstride) (OH_Pixelmap_InitializationOptions \*options, int32_t rowStride) | Sets the row stride. | 163| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_GetAlphaType](#oh_pixelmapinitializationoptions_getalphatype) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t \*alphaType) | Obtains the alpha type.| 164| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_SetAlphaType](#oh_pixelmapinitializationoptions_setalphatype) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, int32_t alphaType) | Sets the alpha type.| 165| [Image_ErrorCode](#image_errorcode) [OH_PixelmapInitializationOptions_Release](#oh_pixelmapinitializationoptions_release) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options) | Releases the pointer to an **OH_Pixelmap_InitializationOptions** object.| 166| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_Create](#oh_pixelmapimageinfo_create) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*\*info) | Creates the pointer to an **OH_Pixelmap_ImageInfo** object.| 167| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetWidth](#oh_pixelmapimageinfo_getwidth) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, uint32_t \*width) | Obtains the image width.| 168| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetHeight](#oh_pixelmapimageinfo_getheight) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, uint32_t \*height) | Obtains the image height.| 169| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetRowStride](#oh_pixelmapimageinfo_getrowstride) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, uint32_t \*rowStride) | Obtains the row stride.| 170| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetPixelFormat](#oh_pixelmapimageinfo_getpixelformat) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, int32_t \*pixelFormat) | Obtains the pixel format.| 171| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetAlphaType](#oh_pixelmapimageinfo_getalphatype) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, int32_t \*alphaType) | Obtains the alpha type.| 172| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_GetDynamicRange](#oh_pixelmapimageinfo_getdynamicrange) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info, bool \*isHdr) | Obtains the dynamic range of a pixel map.| 173| [Image_ErrorCode](#image_errorcode) [OH_PixelmapImageInfo_Release](#oh_pixelmapimageinfo_release) ([OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*info) | Releases the pointer to an **OH_Pixelmap_ImageInfo** object.| 174| [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) | Creates a **PixelMap** object based on properties. By default, the BGRA_8888 format is used for data processing.| 175| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ReadPixels](#oh_pixelmapnative_readpixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint8_t \*destination, size_t \*bufferSize) | Reads the image pixel data and writes the data to an ArrayBuffer.| 176| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_WritePixels](#oh_pixelmapnative_writepixels) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, uint8_t \*source, size_t bufferSize) | Reads the image pixel data in the buffer and writes the data to a pixel map.| 177| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ToSdr](#oh_pixelmapnative_tosdr) (OH_PixelmapNative \*pixelmap) | Converts an HDR image into an SDR image. | 178| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetImageInfo](#oh_pixelmapnative_getimageinfo) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_Pixelmap_ImageInfo](#oh_pixelmap_imageinfo) \*imageInfo) | Obtains the image information.| 179| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Opacity](#oh_pixelmapnative_opacity) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float rate) | Sets the opacity rate to enable the pixel map to achieve the corresponding opacity effect.| 180| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Scale](#oh_pixelmapnative_scale) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float scaleX, float scaleY) | Scales an image based on a given width and height.| 181| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ScaleWithAntiAliasing](#oh_pixelmapnative_scalewithantialiasing) (OH_PixelmapNative \*pixelmap, float scaleX, float scaleY, [OH_PixelmapNative_AntiAliasingLevel](#oh_pixelmapnative_antialiasinglevel) level) | Scales an image based on the specified antialiasing level, width, and height. | 182| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Translate](#oh_pixelmapnative_translate) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float x, float y) | Translates an image based on given coordinates.| 183| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Rotate](#oh_pixelmapnative_rotate) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, float angle) | Rotates an image based on a given angle.| 184| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Flip](#oh_pixelmapnative_flip) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, bool shouldFilpHorizontally, bool shouldFilpVertically) | Flips an image based on a given angle.| 185| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Crop](#oh_pixelmapnative_crop) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [Image_Region](_image___region.md) \*region) | Crops an image based on a given size.| 186| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_Release](#oh_pixelmapnative_release) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap) | Releases the pointer to an **OH_PixelmapNative** object.| 187| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_ConvertAlphaFormat](#oh_pixelmapnative_convertalphaformat) ([OH_PixelmapNative](#oh_pixelmapnative) \*pixelmap, [OH_PixelmapNative](#oh_pixelmapnative) \*dstpixelmap, const bool isPremul) | Converts pixel data of a pixel map from premultiplied alpha to non-premultiplied alpha, or vice versa.| 188| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_CreateEmptyPixelmap](#oh_pixelmapnative_createemptypixelmap) ([OH_Pixelmap_InitializationOptions](#oh_pixelmap_initializationoptions) \*options, [OH_PixelmapNative](#oh_pixelmapnative) \*\*pixelmap) | Creates an empty pixel map using **OH_Pixelmap_InitializationOptions**. The memory data is 0.| 189| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetNativeBuffer](#oh_pixelmapnative_getnativebuffer) (OH_PixelmapNative \*pixelmap, OH_NativeBuffer \*\*nativeBuffer) | Obtains the **NativeBuffer** object from a pixel map in the DMA memory. | 190| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata) (OH_PixelmapNative \*pixelmap, [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey) key, [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) \*\*value) | Obtains the metadata. | 191| [Image_ErrorCode](#image_errorcode) [OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata) (OH_PixelmapNative \*pixelmap, [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey) key, [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md) \*value) | Sets the metadata. | 192 193 194### Variables 195 196| Name| Description| 197| -------- | -------- | 198| static const char \*[MIME_TYPE_BMP](#mime_type_bmp) = "image/bmp" | BMP image format.| 199| static const char \*[MIME_TYPE_JPEG](#mime_type_jpeg) = "image/jpeg" | JPEG image format.| 200| static const char \*[MIME_TYPE_HEIC](#mime_type_heic) = "image/heic" | HEIF image format.| 201| static const char \*[MIME_TYPE_PNG](#mime_type_png) = "image/png" | PNG image format.| 202| static const char \*[MIME_TYPE_WEBP](#mime_type_webp) = "image/webp" | WebP image format.| 203| static const char \*[MIME_TYPE_GIF](#mime_type_gif) = "image/gif" | GIF image format.| 204| static const char \*[MIME_TYPE_ICON](#mime_type_icon) = "image/x-icon" | ICO image format.| 205| static const char \*[OHOS_IMAGE_PROPERTY_BITS_PER_SAMPLE](#ohos_image_property_bits_per_sample) = "BitsPerSample" | Number of bits per sample.| 206| static const char \*[OHOS_IMAGE_PROPERTY_ORIENTATION](#ohos_image_property_orientation) = "Orientation" | Image orientation.| 207| static const char \*[OHOS_IMAGE_PROPERTY_IMAGE_LENGTH](#ohos_image_property_image_length) = "ImageLength" | Image length.| 208| static const char \*[OHOS_IMAGE_PROPERTY_IMAGE_WIDTH](#ohos_image_property_image_width) = "ImageWidth" | Image width.| 209| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LATITUDE](#ohos_image_property_gps_latitude) = "GPSLatitude" | Image latitude.| 210| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LONGITUDE](#ohos_image_property_gps_longitude) = "GPSLongitude" | Image longitude.| 211| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LATITUDE_REF](#ohos_image_property_gps_latitude_ref) = "GPSLatitudeRef" | Whether the latitude is north or south latitude.| 212| static const char \*[OHOS_IMAGE_PROPERTY_GPS_LONGITUDE_REF](#ohos_image_property_gps_longitude_ref) = "GPSLongitudeRef" | Whether the longitude is east or west longitude.| 213| static const char \*[OHOS_IMAGE_PROPERTY_DATE_TIME_ORIGINAL](#ohos_image_property_date_time_original) = "DateTimeOriginal" | Shooting time, for example, 2022:09:06 15:48:00.| 214| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_TIME](#ohos_image_property_exposure_time) = "ExposureTime" | Exposure time, for example, 1/33 seconds.| 215| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_TYPE](#ohos_image_property_scene_type) = "SceneType" | Type of the scene, for example, portrait, scenery, motion, and night.| 216| static const char \*[OHOS_IMAGE_PROPERTY_ISO_SPEED_RATINGS](#ohos_image_property_iso_speed_ratings) = "ISOSpeedRatings" | ISO sensitivity or ISO speed, for example, 400.| 217| static const char \*[OHOS_IMAGE_PROPERTY_F_NUMBER](#ohos_image_property_f_number) = "FNumber" | F number, for example, f/1.8.| 218| static const char \*[OHOS_IMAGE_PROPERTY_COMPRESSED_BITS_PER_PIXEL](#ohos_image_property_compressed_bits_per_pixel) = "CompressedBitsPerPixel" | Number of bits per pixel. It is specific to compressed data.| 219| static const char \*[OHOS_IMAGE_PROPERTY_COMPRESSION](#ohos_image_property_compression) = "Compression" | Compression scheme used on the image data.| 220| static const char \*[OHOS_IMAGE_PROPERTY_PHOTOMETRIC_INTERPRETATION](#ohos_image_property_photometric_interpretation) = "PhotometricInterpretation" | Color space of the image data, for example, RGB or YCbCr.| 221| static const char \*[OHOS_IMAGE_PROPERTY_STRIP_OFFSETS](#ohos_image_property_strip_offsets) = "StripOffsets" | Byte offset of each strip.| 222| static const char \*[OHOS_IMAGE_PROPERTY_SAMPLES_PER_PIXEL](#ohos_image_property_samples_per_pixel) = "SamplesPerPixel" | Number of components per pixel. The value is **3** for RGB and YCbCr images. The **JPEG** key is used in JPEG compressed data.| 223| static const char \*[OHOS_IMAGE_PROPERTY_ROWS_PER_STRIP](#ohos_image_property_rows_per_strip) = "RowsPerStrip" | Number of rows per strip.| 224| static const char \*[OHOS_IMAGE_PROPERTY_STRIP_BYTE_COUNTS](#ohos_image_property_strip_byte_counts) = "StripByteCounts" | Number of bytes in each strip after compression.| 225| static const char \*[OHOS_IMAGE_PROPERTY_X_RESOLUTION](#ohos_image_property_x_resolution) = "XResolution" | Number of pixels per ResolutionUnit in the image width (X) direction.| 226| static const char \*[OHOS_IMAGE_PROPERTY_Y_RESOLUTION](#ohos_image_property_y_resolution) = "YResolution" | Number of pixels per ResolutionUnit in the image height (Y) direction.| 227| static const char \*[OHOS_IMAGE_PROPERTY_PLANAR_CONFIGURATION](#ohos_image_property_planar_configuration) = "PlanarConfiguration" | Storage format of components of each pixel, which can be chunky or planar.| 228| static const char \*[OHOS_IMAGE_PROPERTY_RESOLUTION_UNIT](#ohos_image_property_resolution_unit) = "ResolutionUnit" | Unit of measurement for XResolution and YResolution.| 229| static const char \*[OHOS_IMAGE_PROPERTY_TRANSFER_FUNCTION](#ohos_image_property_transfer_function) = "TransferFunction" | Transfer function for the image, which is usually used for color correction.| 230| static const char \*[OHOS_IMAGE_PROPERTY_SOFTWARE](#ohos_image_property_software) = "Software" | Name and version number of the software used to create the image.| 231| static const char \*[OHOS_IMAGE_PROPERTY_ARTIST](#ohos_image_property_artist) = "Artist" | Person who created the image.| 232| static const char \*[OHOS_IMAGE_PROPERTY_WHITE_POINT](#ohos_image_property_white_point) = "WhitePoint" | Chromaticity of the white point of the image.| 233| static const char \*[OHOS_IMAGE_PROPERTY_PRIMARY_CHROMATICITIES](#ohos_image_property_primary_chromaticities) = "PrimaryChromaticities" | Chromaticities of the primaries of the image.| 234| static const char \*[OHOS_IMAGE_PROPERTY_YCBCR_COEFFICIENTS](#ohos_image_property_ycbcr_coefficients) = "YCbCrCoefficients" | Transformation from RGB to YCbCr image data.| 235| static const char \*[OHOS_IMAGE_PROPERTY_YCBCR_SUB_SAMPLING](#ohos_image_property_ycbcr_sub_sampling) = "YCbCrSubSampling" | Subsampling factors used for the chrominance components of a YCbCr image.| 236| static const char \*[OHOS_IMAGE_PROPERTY_YCBCR_POSITIONING](#ohos_image_property_ycbcr_positioning) = "YCbCrPositioning" | Positioning of subsampled chrominance components relative to luminance samples.| 237| static const char \*[OHOS_IMAGE_PROPERTY_REFERENCE_BLACK_WHITE](#ohos_image_property_reference_black_white) = "ReferenceBlackWhite" | A pair of headroom and footroom image data values (codes) for each pixel component.| 238| static const char \*[OHOS_IMAGE_PROPERTY_COPYRIGHT](#ohos_image_property_copyright) = "Copyright" | Copyright notice of the image.| 239| static const char \*[OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT](#ohos_image_property_jpeg_interchange_format) = "JPEGInterchangeFormat" | Offset of the SOI marker of a JPEG interchange format bitstream.| 240| static const char \*[OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT_LENGTH](#ohos_image_property_jpeg_interchange_format_length) = "JPEGInterchangeFormatLength" | Number of bytes of the JPEG stream.| 241| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_PROGRAM](#ohos_image_property_exposure_program) = "ExposureProgram" | Class of the program used by the camera to set exposure when the image was captured.| 242| static const char \*[OHOS_IMAGE_PROPERTY_SPECTRAL_SENSITIVITY](#ohos_image_property_spectral_sensitivity) = "SpectralSensitivity" | Spectral sensitivity of each channel of the camera.| 243| static const char \*[OHOS_IMAGE_PROPERTY_OECF](#ohos_image_property_oecf) = "OECF" | Opto-Electric Conversion Function (OECF) specified in ISO 14524.| 244| static const char \*[OHOS_IMAGE_PROPERTY_EXIF_VERSION](#ohos_image_property_exif_version) = "ExifVersion" | Version of the supported EXIF standard.| 245| static const char \*[OHOS_IMAGE_PROPERTY_DATE_TIME_DIGITIZED](#ohos_image_property_date_time_digitized) = "DateTimeDigitized" | Date and time when the image was stored as digital data, in the format of YYYY:MM:DD HH:MM:SS.| 246| static const char \*[OHOS_IMAGE_PROPERTY_COMPONENTS_CONFIGURATION](#ohos_image_property_components_configuration) = "ComponentsConfiguration" | Specific information about compressed data.| 247| static const char \*[OHOS_IMAGE_PROPERTY_SHUTTER_SPEED_VALUE](#ohos_image_property_shutter_speed_value) = "ShutterSpeedValue" | Shutter speed, expressed in Additive System of Photographic Exposure (APEX) values.| 248| static const char \*[OHOS_IMAGE_PROPERTY_BRIGHTNESS_VALUE](#ohos_image_property_brightness_value) = "BrightnessValue" | Value of brightness, expressed in APEX values.| 249| static const char \*[OHOS_IMAGE_PROPERTY_MAX_APERTURE_VALUE](#ohos_image_property_max_aperture_value) = "MaxApertureValue" | Smallest F number of the lens.| 250| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE](#ohos_image_property_subject_distance) = "SubjectDistance" | Distance to the subject, in meters.| 251| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_AREA](#ohos_image_property_subject_area) = "SubjectArea" | Location and area of the main subject in the entire scene.| 252| static const char \*[OHOS_IMAGE_PROPERTY_MAKER_NOTE](#ohos_image_property_maker_note) = "MakerNote" | Marker used by EXIF/DCF manufacturers to record any required information.| 253| static const char \*[OHOS_IMAGE_PROPERTY_SUBSEC_TIME](#ohos_image_property_subsec_time) = "SubsecTime" | Tag used to record fractions of seconds for the **DateTime** tag.| 254| static const char \*[OHOS_IMAGE_PROPERTY_SUBSEC_TIME_ORIGINAL](#ohos_image_property_subsec_time_original) = "SubsecTimeOriginal" | Tag used to record fractions of seconds for the **DateTimeOriginal** tag.| 255| static const char \*[OHOS_IMAGE_PROPERTY_SUBSEC_TIME_DIGITIZED](#ohos_image_property_subsec_time_digitized) = "SubsecTimeDigitized" | Tag used to record fractions of seconds for the **DateTimeDigitized** tag.| 256| static const char \*[OHOS_IMAGE_PROPERTY_FLASHPIX_VERSION](#ohos_image_property_flashpix_version) = "FlashpixVersion" | FlashPix format version supported by an FPXR file. It is used to enhance device compatibility.| 257| static const char \*[OHOS_IMAGE_PROPERTY_COLOR_SPACE](#ohos_image_property_color_space) = "ColorSpace" | Color space information, which is usually recorded as a color space specifier.| 258| static const char \*[OHOS_IMAGE_PROPERTY_RELATED_SOUND_FILE](#ohos_image_property_related_sound_file) = "RelatedSoundFile" | Name of an audio file related to the image data.| 259| static const char \*[OHOS_IMAGE_PROPERTY_FLASH_ENERGY](#ohos_image_property_flash_energy) = "FlashEnergy" | Strobe energy at the time the image was captured, in Beam Candle Power Seconds (BCPS).| 260| static const char \*[OHOS_IMAGE_PROPERTY_SPATIAL_FREQUENCY_RESPONSE](#ohos_image_property_spatial_frequency_response) = "SpatialFrequencyResponse" | Spatial frequency table of the camera or input device.| 261| static const char \*[OHOS_IMAGE_PROPERTY_FOCAL_PLANE_X_RESOLUTION](#ohos_image_property_focal_plane_x_resolution) = "FocalPlaneXResolution" | Number of pixels in the image width (X) direction per FocalPlaneResolutionUnit.| 262| static const char \*[OHOS_IMAGE_PROPERTY_FOCAL_PLANE_Y_RESOLUTION](#ohos_image_property_focal_plane_y_resolution) = "FocalPlaneYResolution" | Number of pixels in the image height (Y) direction per FocalPlaneResolutionUnit.| 263| static const char \*[OHOS_IMAGE_PROPERTY_FOCAL_PLANE_RESOLUTION_UNIT](#ohos_image_property_focal_plane_resolution_unit) = "FocalPlaneResolutionUnit" | Unit for measuring FocalPlaneXResolution and FocalPlaneYResolution.| 264| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_LOCATION](#ohos_image_property_subject_location) = "SubjectLocation" | Location of the main subject relative to the left edge.| 265| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_INDEX](#ohos_image_property_exposure_index) = "ExposureIndex" | Exposure index selected at the time the image is captured.| 266| static const char \*[OHOS_IMAGE_PROPERTY_SENSING_METHOD](#ohos_image_property_sensing_method) = "SensingMethod" | Type of the image sensor on the camera.| 267| static const char \*[OHOS_IMAGE_PROPERTY_FILE_SOURCE](#ohos_image_property_file_source) = "FileSource" | Image source.| 268| static const char \*[OHOS_IMAGE_PROPERTY_CFA_PATTERN](#ohos_image_property_cfa_pattern) = "CFAPattern" | Color Filter Array (CFA) geometric pattern of the image sensor.| 269| static const char \*[OHOS_IMAGE_PROPERTY_CUSTOM_RENDERED](#ohos_image_property_custom_rendered) = "CustomRendered" | Special processing on image data.| 270| static const char \*[OHOS_IMAGE_PROPERTY_EXPOSURE_MODE](#ohos_image_property_exposure_mode) = "ExposureMode" | Exposure mode set when the image was captured.| 271| static const char \*[OHOS_IMAGE_PROPERTY_DIGITAL_ZOOM_RATIO](#ohos_image_property_digital_zoom_ratio) = "DigitalZoomRatio" | Digital zoom ratio when the image was captured.| 272| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_CAPTURE_TYPE](#ohos_image_property_scene_capture_type) = "SceneCaptureType" | Type of the scene that was captured.| 273| static const char \*[OHOS_IMAGE_PROPERTY_GAIN_CONTROL](#ohos_image_property_gain_control) = "GainControl" | Degree of overall image gain adjustment.| 274| static const char \*[OHOS_IMAGE_PROPERTY_CONTRAST](#ohos_image_property_contrast) = "Contrast" | Direction of contrast processing used by the camera.| 275| static const char \*[OHOS_IMAGE_PROPERTY_SATURATION](#ohos_image_property_saturation) = "Saturation" | Direction of saturation processing used by the camera.| 276| static const char \*[OHOS_IMAGE_PROPERTY_SHARPNESS](#ohos_image_property_sharpness) = "Sharpness" | Direction of sharpness processing used by the camera.| 277| static const char \*[OHOS_IMAGE_PROPERTY_DEVICE_SETTING_DESCRIPTION](#ohos_image_property_device_setting_description) = "DeviceSettingDescription" | Information about the photographing conditions of a specific camera model.| 278| static const char \*[OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE_RANGE](#ohos_image_property_subject_distance_range) = "SubjectDistanceRange" | Distance to the subject.| 279| static const char \*[OHOS_IMAGE_PROPERTY_IMAGE_UNIQUE_ID](#ohos_image_property_image_unique_id) = "ImageUniqueID" | Unique identifier assigned to each image.| 280| static const char \*[OHOS_IMAGE_PROPERTY_GPS_VERSION_ID](#ohos_image_property_gps_version_id) = "GPSVersionID" | Version of GPSInfoIFD.| 281| static const char \*[OHOS_IMAGE_PROPERTY_GPS_ALTITUDE_REF](#ohos_image_property_gps_altitude_ref) = "GPSAltitudeRef" | Whether the latitude is north or south latitude.| 282| static const char \*[OHOS_IMAGE_PROPERTY_GPS_ALTITUDE](#ohos_image_property_gps_altitude) = "GPSAltitude" | Altitude based on the reference in GPSAltitudeRef.| 283| static const char \*[OHOS_IMAGE_PROPERTY_GPS_SATELLITES](#ohos_image_property_gps_satellites) = "GPSSatellites" | GPS satellites used for measurement.| 284| static const char \*[OHOS_IMAGE_PROPERTY_GPS_STATUS](#ohos_image_property_gps_status) = "GPSStatus" | Status of the GPS receiver when the image was recorded.| 285| static const char \*[OHOS_IMAGE_PROPERTY_GPS_MEASURE_MODE](#ohos_image_property_gps_measure_mode) = "GPSMeasureMode" | GPS measurement pmode.| 286| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DOP](#ohos_image_property_gps_dop) = "GPSDOP" | GPS DOP (data degree of precision)| 287| static const char \*[OHOS_IMAGE_PROPERTY_GPS_SPEED_REF](#ohos_image_property_gps_speed_ref) = "GPSSpeedRef" | Unit used to express the movement speed of the GPS receiver.| 288| static const char \*[OHOS_IMAGE_PROPERTY_GPS_SPEED](#ohos_image_property_gps_speed) = "GPSSpeed" | Movement speed of the GPS receiver.| 289| static const char \*[OHOS_IMAGE_PROPERTY_GPS_TRACK_REF](#ohos_image_property_gps_track_ref) = "GPSTrackRef" | Reference of the movement direction of the GPS receiver.| 290| static const char \*[OHOS_IMAGE_PROPERTY_GPS_TRACK](#ohos_image_property_gps_track) = "GPSTrack" | Movement direction of the GPS receiver.| 291| static const char \*[OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION_REF](#ohos_image_property_gps_img_direction_ref) = "GPSImgDirectionRef" | Reference of the direction of the image when it was captured.| 292| static const char \*[OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION](#ohos_image_property_gps_img_direction) = "GPSImgDirection" | Direction of the image when it was captured.| 293| static const char \*[OHOS_IMAGE_PROPERTY_GPS_MAP_DATUM](#ohos_image_property_gps_map_datum) = "GPSMapDatum" | Geodetic survey data used by the GPS receiver.| 294| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE_REF](#ohos_image_property_gps_dest_latitude_ref) = "GPSDestLatitudeRef" | Whether the latitude of the destination point is north or south latitude.| 295| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE](#ohos_image_property_gps_dest_latitude) = "GPSDestLatitude" | Latitude of the destination point.| 296| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE_REF](#ohos_image_property_gps_dest_longitude_ref) = "GPSDestLongitudeRef" | Whether the longitude of the destination point is east or west longitude.| 297| static const char \*[OHOS_IMAGE_PROPERTY_GPS_PROCESSING_METHOD](#ohos_image_property_gps_processing_method) = "GPSProcessingMethod" | String that records the name of the method used for positioning.| 298| static const char \*[OHOS_IMAGE_PROPERTY_GPS_AREA_INFORMATION](#ohos_image_property_gps_area_information) = "GPSAreaInformation" | String that records the name of the GPS area.| 299| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DIFFERENTIAL](#ohos_image_property_gps_differential) = "GPSDifferential" | Whether differential correction is applied to the GPS receiver. It is critical to accurate location accuracy.| 300| static const char \*[OHOS_IMAGE_PROPERTY_BODY_SERIAL_NUMBER](#ohos_image_property_body_serial_number) = "BodySerialNumber" | Serial number of the camera body.| 301| static const char \*[OHOS_IMAGE_PROPERTY_CAMERA_OWNER_NAME](#ohos_image_property_camera_owner_name) = "CameraOwnerName" | Name of the camera owner.| 302| static const char \*[OHOS_IMAGE_PROPERTY_COMPOSITE_IMAGE](#ohos_image_property_composite_image) = "CompositeImage" | Whether the image is a composite image.| 303| static const char \*[OHOS_IMAGE_PROPERTY_DNG_VERSION](#ohos_image_property_dng_version) = "DNGVersion" | DNG version. It encodes the DNG 4-tier version number.| 304| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE](#ohos_image_property_gps_dest_longitude) = "GPSDestLongitude" | Longitude of the destination point.| 305| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING_REF](#ohos_image_property_gps_dest_bearing_ref) = "GPSDestBearingRef" | Reference of the bearing to the destination point.| 306| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING](#ohos_image_property_gps_dest_bearing) = "GPSDestBearing" | Bearing to the destination point.| 307| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE_REF](#ohos_image_property_gps_dest_distance_ref) = "GPSDestDistanceRef" | Unit used to express the distance to the destination point.| 308| static const char \*[OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE](#ohos_image_property_gps_dest_distance) = "GPSDestDistance" | Distance to the destination point.| 309| static const char \*[OHOS_IMAGE_PROPERTY_DEFAULT_CROP_SIZE](#ohos_image_property_default_crop_size) = "DefaultCropSize" | Size of the final image area, in raw image coordinates, taking into account extra pixels around the edges of the final image.| 310| static const char \*[OHOS_IMAGE_PROPERTY_GAMMA](#ohos_image_property_gamma) = "Gamma" | Gamma value.| 311| static const char \*[OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEYYY](#ohos_image_property_iso_speed_latitudeyyy) = "ISOSpeedLatitudeyyy" | ISO speed latitude yyy value of the camera or input device, which is defined in ISO 12232.| 312| static const char \*[OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEZZZ](#ohos_image_property_iso_speed_latitudezzz) = "ISOSpeedLatitudezzz" | ISO speed latitude zzz value of the camera or input device, which is defined in ISO 12232.| 313| static const char \*[OHOS_IMAGE_PROPERTY_LENS_MAKE](#ohos_image_property_lens_make) = "LensMake" | Manufacturer of the lens.| 314| static const char \*[OHOS_IMAGE_PROPERTY_LENS_MODEL](#ohos_image_property_lens_model) = "LensModel" | Model of the lens.| 315| static const char \*[OHOS_IMAGE_PROPERTY_LENS_SERIAL_NUMBER](#ohos_image_property_lens_serial_number) = "LensSerialNumber" | Serial number of the lens.| 316| static const char \*[OHOS_IMAGE_PROPERTY_LENS_SPECIFICATION](#ohos_image_property_lens_specification) = "LensSpecification" | Specifications of the lens.| 317| static const char \*[OHOS_IMAGE_PROPERTY_NEW_SUBFILE_TYPE](#ohos_image_property_new_subfile_type) = "NewSubfileType" | Data type of a subfile, such as a full-resolution image, a thumbnail, or a part of a multi-frame image. The value is a bit mask. The value 0 indicates a full-resolution image, **1** indicates a thumbnail, and **2** indicates a part of a multi-frame image.| 318| static const char \*[OHOS_IMAGE_PROPERTY_OFFSET_TIME](#ohos_image_property_offset_time) = "OffsetTime" | Time with an offset from UTC when the image was captured, in the format of ±HH:MM.| 319| static const char \*[OHOS_IMAGE_PROPERTY_OFFSET_TIME_DIGITIZED](#ohos_image_property_offset_time_digitized) = "OffsetTimeDigitized" | Time with an offset from UTC when the image was digitized. It helps to accurately adjust the timestamp.| 320| static const char \*[OHOS_IMAGE_PROPERTY_OFFSET_TIME_ORIGINAL](#ohos_image_property_offset_time_original) = "OffsetTimeOriginal" | Time with an offset from UTC when the original image was created. It is critical for time-sensitive applications.| 321| static const char \*[OHOS_IMAGE_PROPERTY_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE](#ohos_image_property_source_exposure_times_of_composite_image) = "SourceExposureTimesOfCompositeImage" | Exposure time of source images of the composite image.| 322| static const char \*[OHOS_IMAGE_PROPERTY_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE](#ohos_image_property_source_image_number_of_composite_image) = "SourceImageNumberOfCompositeImage" | Number of source images of the composite image.| 323| static const char \*[OHOS_IMAGE_PROPERTY_SUBFILE_TYPE](#ohos_image_property_subfile_type) = "SubfileType" | Type of data contained in this subfile. This tag has been deprecated. Use **NewSubfileType** instead.| 324| static const char \*[OHOS_IMAGE_PROPERTY_GPS_H_POSITIONING_ERROR](#ohos_image_property_gps_h_positioning_error) = "GPSHPositioningError" | Horizontal positioning error, in meters.| 325| static const char \*[OHOS_IMAGE_PROPERTY_PHOTOGRAPHIC_SENSITIVITY](#ohos_image_property_photographic_sensitivity) = "PhotographicSensitivity" | Sensitivity of the camera or input device when the image was captured.| 326| static const char \*[OHOS_IMAGE_PROPERTY_BURST_NUMBER](#ohos_image_property_burst_number) = "HwMnoteBurstNumber" | Number of burst shooting times.| 327| static const char \*[OHOS_IMAGE_PROPERTY_FACE_CONF](#ohos_image_property_face_conf) = "HwMnoteFaceConf" | Face confidence.| 328| static const char \*[OHOS_IMAGE_PROPERTY_FACE_LEYE_CENTER](#ohos_image_property_face_leye_center) = "HwMnoteFaceLeyeCenter" | Left eye centered. It is used in **OH_ImageSource_GetImageProperty** and **OH_ImageSource_ModifyImageProperty**.| 329| static const char \*[OHOS_IMAGE_PROPERTY_FACE_MOUTH_CENTER](#ohos_image_property_face_mouth_center) = "HwMnoteFaceMouthCenter" | Mouth centered.| 330| static const char \*[OHOS_IMAGE_PROPERTY_FACE_POINTER](#ohos_image_property_face_pointer) = "HwMnoteFacePointer" | Face pointer.| 331| static const char \*[OHOS_IMAGE_PROPERTY_FACE_RECT](#ohos_image_property_face_rect) = "HwMnoteFaceRect" | Face rectangle.| 332| static const char \*[OHOS_IMAGE_PROPERTY_FACE_REYE_CENTER](#ohos_image_property_face_reye_center) = "HwMnoteFaceReyeCenter" | Right eye centered.| 333| static const char \*[OHOS_IMAGE_PROPERTY_FACE_SMILE_SCORE](#ohos_image_property_face_smile_score) = "HwMnoteFaceSmileScore" | Smile score of for faces.| 334| static const char \*[OHOS_IMAGE_PROPERTY_FACE_VERSION](#ohos_image_property_face_version) = "HwMnoteFaceVersion" | Facial recognition algorithm version.| 335| static const char \*[OHOS_IMAGE_PROPERTY_FRONT_CAMERA](#ohos_image_property_front_camera) = "HwMnoteFrontCamera" | Whether the front camera is used to take a selfie.| 336| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_POINTER](#ohos_image_property_scene_pointer) = "HwMnoteScenePointer" | Pointer to the scene.| 337| static const char \*[OHOS_IMAGE_PROPERTY_SCENE_VERSION](#ohos_image_property_scene_version) = "HwMnoteSceneVersion" | Scene algorithm version.| 338| static const char \*[OHOS_IMAGE_PROPERTY_GIF_LOOP_COUNT](#ohos_image_property_gif_loop_count) = "GIFLoopCount" | Number of GIF loops.| 339 340 341## Type Description 342 343 344### Image_MimeType 345 346``` 347typedef struct Image_String Image_MimeType 348``` 349 350**Description** 351 352Defines a struct for an image format type. 353 354**Since**: 12 355 356 357### Image_Region 358 359``` 360typedef struct Image_Region Image_Region 361``` 362 363**Description** 364 365Defines a struct for the region of an image to decode. 366 367**Since**: 12 368 369 370### Image_Size 371 372``` 373typedef struct Image_Size Image_Size 374``` 375 376**Description** 377 378Defines a struct for the image size. 379 380**Since**: 12 381 382 383### Image_String 384 385``` 386typedef struct Image_String Image_String 387``` 388 389**Description** 390 391Defines a struct for an image string. 392 393**Since**: 12 394 395 396### OH_DecodingOptions 397 398``` 399typedef struct OH_DecodingOptions OH_DecodingOptions 400``` 401 402**Description** 403 404Defines a struct for decoding parameters, which are used in [OH_ImageSourceNative_CreatePixelmap](#oh_imagesourcenative_createpixelmap). 405 406The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_DecodingOptions Struct](../../media/image/image-structure-c.md#oh_decodingoptions-struct). 407 408**Since**: 12 409 410 411### OH_ImageNative 412 413``` 414typedef struct OH_ImageNative OH_ImageNative 415``` 416 417**Description** 418 419Defines the alias for an image object at the native layer. 420 421The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_ImageNative Struct](../../media/image/image-structure-c.md#oh_imagenative-struct). 422 423**Since**: 12 424 425 426### OH_ImagePackerNative 427 428``` 429typedef struct OH_ImagePackerNative OH_ImagePackerNative 430``` 431 432**Description** 433 434Defines the **ImagePacker** struct, which is used to perform operations related to an image packer. 435 436The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_ImagePackerNative Struct](../../media/image/image-structure-c.md#oh_imagepackernative-struct). 437 438**Since**: 12 439 440 441### OH_ImageReceiver_OnCallback 442 443``` 444typedef void(*OH_ImageReceiver_OnCallback) (OH_ImageReceiverNative *receiver) 445``` 446 447**Description** 448 449Defines the callbacks for the image receiver at the native layer. 450 451**Since**: 12 452 453 454### OH_ImageReceiverNative 455 456``` 457typedef struct OH_ImageReceiverNative OH_ImageReceiverNative 458``` 459 460**Description** 461 462Defines the data type name of the image receiver at the native layer. 463 464The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_ImageReceiverNative Struct](../../media/image/image-structure-c.md#oh_imagereceivernative-struct). 465 466**Since**: 12 467 468 469### OH_ImageReceiverOptions 470 471``` 472typedef struct OH_ImageReceiverOptionsOH_ImageReceiverOptions 473``` 474 475**Description** 476 477Defines the data type name of the image receiver options. 478 479The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_ImageReceiverOptions Struct](../../media/image/image-structure-c.md#oh_imagereceiveroptions-struct). 480 481**Since**: 12 482 483 484### OH_Pixelmap_HdrDynamicMetadata 485 486``` 487typedef struct OH_Pixelmap_HdrDynamicMetadata OH_Pixelmap_HdrDynamicMetadata 488``` 489 490**Description** 491 492Defines a struct for the dynamic metadata values available for the key **DR_DYNAMIC_METADATA**. 493 494**Since**: 12 495 496 497### OH_Pixelmap_HdrGainmapMetadata 498 499``` 500typedef struct OH_Pixelmap_HdrGainmapMetadata OH_Pixelmap_HdrGainmapMetadata 501``` 502 503**Description** 504 505Defines a struct for the gain map metadata values available for the key **HDR_GAINMAP_METADATA**. For details, see ISO 21496-1. 506 507**Since**: 12 508 509 510### OH_Pixelmap_HdrMetadataValue 511 512``` 513typedef struct OH_Pixelmap_HdrMetadataValue OH_Pixelmap_HdrMetadataValue 514``` 515 516**Description** 517 518Defines a struct for the HDR metadata values used by the pixel map. It corresponds to the key [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey). 519 520It is used in [OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata) and [OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata). 521 522**Since**: 12 523 524 525### OH_Pixelmap_HdrStaticMetadata 526 527``` 528typedef struct OH_Pixelmap_HdrStaticMetadata OH_Pixelmap_HdrStaticMetadata 529``` 530 531**Description** 532 533Defines a struct for the static metadata values available for the key **HDR_STATIC_METADATA**. 534 535**Since**: 12 536 537 538### OH_ImageSource_Info 539 540``` 541typedef struct OH_ImageSource_Info OH_ImageSource_Info 542``` 543 544**Description** 545 546Defines a struct for the image source information, which is created by calling [OH_ImageSourceInfo_Create](#oh_imagesourceinfo_create). 547 548The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_ImageSource_Info Struct](../../media/image/image-structure-c.md#oh_imagesource_info-struct). 549 550**Since**: 12 551 552 553### OH_ImageSourceNative 554 555``` 556typedef struct OH_ImageSourceNative OH_ImageSourceNative 557``` 558 559**Description** 560 561Defines the **ImageSource** struct, which is used to perform operations related to an image source. 562 563The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_ImageSourceNative Struct](../../media/image/image-structure-c.md#oh_imagesourcenative-struct). 564 565**Since**: 12 566 567 568### OH_PackingOptions 569 570``` 571typedef struct OH_PackingOptions OH_PackingOptions 572``` 573 574**Description** 575 576Defines a struct for image encoding parameters. 577 578The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_PackingOptions Struct](../../media/image/image-structure-c.md#oh_packingoptions-struct). 579 580**Since**: 12 581 582 583### OH_Pixelmap_ImageInfo 584 585``` 586typedef struct OH_Pixelmap_ImageInfo OH_Pixelmap_ImageInfo 587``` 588 589**Description** 590 591Defines a struct for the image information. 592 593The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_Pixelmap_ImageInfo Struct](../../media/image/image-structure-c.md#oh_pixelmap_imageinfo-struct). 594 595**Since**: 12 596 597 598### OH_Pixelmap_InitializationOptions 599 600``` 601typedef struct OH_Pixelmap_InitializationOptions OH_Pixelmap_InitializationOptions 602``` 603 604**Description** 605 606Defines a struct for the initialization parameters. 607 608The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_Pixelmap_InitializationOptions Struct](../../media/image/image-structure-c.md#oh_pixelmap_initializationoptions-struct). 609 610**Since**: 12 611 612 613### OH_PixelmapNative 614 615``` 616typedef struct OH_PixelmapNative OH_PixelmapNative 617``` 618 619**Description** 620 621Defines the **Pixelmap** struct, which is used to perform operations related to a pixel map. 622 623The fields in this struct cannot be directly operated. Instead, they must be manipulated via function calls. For details about the struct content and operation mode, see [OH_PixelmapNative Struct](../../media/image/image-structure-c.md#oh_pixelmapnative-struct). 624 625**Since**: 12 626 627 628### OH_NativeBuffer 629 630``` 631typedef struct OH_NativeBuffer OH_NativeBuffer 632``` 633 634**Description** 635 636Defines the **NativeBuffer** struct, which is used to perform operations related to the native buffer. 637 638 639**Since**: 12 640 641 642## Enum Description 643 644 645### IMAGE_DYNAMIC_RANGE 646 647``` 648enum IMAGE_DYNAMIC_RANGE 649``` 650 651**Description** 652 653Enumerates the desired dynamic range for decoding. 654 655**Since**: 12 656 657| Value| Description| 658| -------- | -------- | 659| IMAGE_DYNAMIC_RANGE_AUTO | Adaptive processing.| 660| IMAGE_DYNAMIC_RANGE_SDR | Standard dynamic range (SDR).| 661| IMAGE_DYNAMIC_RANGE_HDR | High dynamic range (HDR).| 662 663 664### Image_ErrorCode 665 666``` 667enum Image_ErrorCode 668``` 669 670**Description** 671 672Enumerates the error codes. 673 674**Since**: 12 675 676| Value| Description| 677| -------- | -------- | 678| IMAGE_SUCCESS | Operation successful.| 679| IMAGE_BAD_PARAMETER | Invalid parameter.| 680| IMAGE_UNSUPPORTED_MIME_TYPE | Unsupported MIME type.| 681| IMAGE_UNKNOWN_MIME_TYPE | Unknown MIME type.| 682| IMAGE_TOO_LARGE | The data or image is too large.| 683| IMAGE_DMA_NOT_EXIST | The memory is not the DMA memory.| 684| IMAGE_DMA_OPERATION_FAILED | The operation on the DMA memory fails.| 685| IMAGE_UNSUPPORTED_OPERATION | Unsupported operation.| 686| IMAGE_UNSUPPORTED_METADATA | Unsupported metadata.| 687| IMAGE_UNSUPPORTED_CONVERSION | Unsupported conversion.| 688| IMAGE_INVALID_REGION | Invalid region.| 689| IMAGE_ALLOC_FAILED | Failed to allocate the memory.| 690| IMAGE_COPY_FAILED | Failed to copy the memory.| 691| IMAGE_UNKNOWN_ERROR | Unknown error.| 692| IMAGE_BAD_SOURCE | Abnormal data source.| 693| IMAGE_DECODE_FAILED | Decoding failed.| 694| IMAGE_ENCODE_FAILED | Encoding failed.| 695 696 697### IMAGE_PACKER_DYNAMIC_RANGE 698 699``` 700enum IMAGE_PACKER_DYNAMIC_RANGE 701``` 702 703**Description** 704 705Enumerates the desired dynamic range for encoding. 706 707**Since**: 12 708 709| Value| Description| 710| -------- | -------- | 711| IMAGE_PACKER_DYNAMIC_RANGE_AUTO | Adaptive processing.| 712| IMAGE_PACKER_DYNAMIC_RANGE_SDR | SDR.| 713 714 715### PIXEL_FORMAT 716 717``` 718enum PIXEL_FORMAT 719``` 720 721**Description** 722 723Enumerates the image pixel formats. 724 725**Since**: 12 726 727| Value| Description| 728| -------- | -------- | 729| PIXEL_FORMAT_UNKNOWN | Unknown format.| 730| PIXEL_FORMAT_RGB_565 | RGB_565 format.| 731| PIXEL_FORMAT_RGBA_8888 | RGBA_8888 format.| 732| PIXEL_FORMAT_BGRA_8888 | BGRA_8888 format.| 733| PIXEL_FORMAT_RGB_888 | RGB_888 format.| 734| PIXEL_FORMAT_ALPHA_8 | ALPHA_8 format.| 735| PIXEL_FORMAT_RGBA_F16 | RGBA_F16 format.| 736| PIXEL_FORMAT_NV21 | NV21 format.| 737| PIXEL_FORMAT_NV12 | NV12 format.| 738 739 740### OH_Pixelmap_HdrMetadataKey 741 742``` 743enum OH_Pixelmap_HdrMetadataKey 744``` 745 746**Description** 747 748Enumerates the keys of the HDR related metadata information used by the pixel map. It is used in [OH_PixelmapNative_SetMetadata](#oh_pixelmapnative_setmetadata) and [OH_PixelmapNative_GetMetadata](#oh_pixelmapnative_getmetadata). 749 750**Since**: 12 751 752| Value| Description| 753| -------- | -------- | 754| HDR_METADATA_TYPE | Metadata type used by the pixel map. | 755| HDR_STATIC_METADATA | Static metadata. | 756| HDR_DYNAMIC_METADATA | Dynamic metadata. | 757| HDR_GAINMAP_METADATA | Metadata used by gain maps. | 758 759 760### OH_Pixelmap_HdrMetadataType 761 762``` 763enum OH_Pixelmap_HdrMetadataType 764``` 765 766**Description** 767 768Enumerates the HDR metadata types, which are the values of **HDR_METADATA_TYPE**. 769 770**Since**: 12 771 772| Value| Description| 773| -------- | -------- | 774| HDR_METADATA_TYPE_NONE | No metadata. | 775| HDR_METADATA_TYPE_BASE | Metadata used for base graphics. | 776| HDR_METADATA_TYPE_GAINMAP | Metadata used for gain maps. | 777| HDR_METADATA_TYPE_ALTERNATE | Metadata used for synthesized HDR graphics. | 778 779 780### OH_PixelmapNative_AntiAliasingLevel 781 782``` 783enum OH_PixelmapNative_AntiAliasingLevel 784``` 785 786**Description** 787 788Enumerates the antialiasing levels used for scaling pixel maps. 789 790**Since**: 12 791 792| Value| Description| 793| -------- | -------- | 794| OH_PixelmapNative_AntiAliasing_NONE | Nearest neighbor. | 795| OH_PixelmapNative_AntiAliasing_LOW | Bilinear interpolation. | 796| OH_PixelmapNative_AntiAliasing_MEDIUM | Bilinear interpolation with mipmap enabled. | 797| OH_PixelmapNative_AntiAliasing_HIGH | Cubic convolution. | 798 799 800### PIXELMAP_ALPHA_TYPE 801 802``` 803enum PIXELMAP_ALPHA_TYPE 804``` 805 806**Description** 807 808Enumerates the alpha types of a pixel map. 809 810**Since**: 12 811 812| Value| Description| 813| -------- | -------- | 814| PIXELMAP_ALPHA_TYPE_UNKNOWN | Unknown format.| 815| PIXELMAP_ALPHA_TYPE_OPAQUE | Opaque format.| 816| PIXELMAP_ALPHA_TYPE_PREMULTIPLIED | Premultiplied format.| 817 818 819## Function Description 820 821 822### OH_DecodingOptions_Create() 823 824``` 825Image_ErrorCode OH_DecodingOptions_Create (OH_DecodingOptions ** options) 826``` 827 828**Description** 829 830Creates the pointer to an **OH_DecodingOptions** object. 831 832**Since**: 12 833 834**Parameters** 835 836| Name| Description| 837| -------- | -------- | 838| options | Double pointer to the **OH_DecodingOptions** object created. | 839 840**Returns** 841 842Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 843 844 845### OH_DecodingOptions_GetDesiredDynamicRange() 846 847``` 848Image_ErrorCode OH_DecodingOptions_GetDesiredDynamicRange (OH_DecodingOptions * options, int32_t * desiredDynamicRange ) 849``` 850 851**Description** 852 853Obtains the desired dynamic range configured during decoding. 854 855**Since**: 12 856 857**Parameters** 858 859| Name| Description| 860| -------- | -------- | 861| options | Pointer to an **OH_DecodingOptions** object. | 862| desiredDynamicRange | Pointer to the desired dynamic range. For details about the available options, see [IMAGE_DYNAMIC_RANGE](#image_dynamic_range). | 863 864**Returns** 865 866Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 867 868 869### OH_DecodingOptions_GetDesiredRegion() 870 871``` 872Image_ErrorCode OH_DecodingOptions_GetDesiredRegion (OH_DecodingOptions * options, Image_Region * desiredRegion ) 873``` 874 875**Description** 876 877Obtains the region to decode. 878 879**Since**: 12 880 881**Parameters** 882 883| Name| Description| 884| -------- | -------- | 885| options | Pointer to an **OH_DecodingOptions** object. | 886| desiredRegion | Pointer to the region to decode. | 887 888**Returns** 889 890Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 891 892 893### OH_DecodingOptions_GetDesiredSize() 894 895``` 896Image_ErrorCode OH_DecodingOptions_GetDesiredSize (OH_DecodingOptions * options, Image_Size * desiredSize ) 897``` 898 899**Description** 900 901Obtains the desired output size. 902 903**Since**: 12 904 905**Parameters** 906 907| Name| Description| 908| -------- | -------- | 909| options | Pointer to an **OH_DecodingOptions** object. | 910| desiredSize | Pointer to the desired output size. | 911 912**Returns** 913 914Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 915 916 917### OH_DecodingOptions_GetIndex() 918 919``` 920Image_ErrorCode OH_DecodingOptions_GetIndex (OH_DecodingOptions * options, uint32_t * index ) 921``` 922 923**Description** 924 925Obtains the index of an image. 926 927**Since**: 12 928 929**Parameters** 930 931| Name| Description| 932| -------- | -------- | 933| options | Pointer to an **OH_DecodingOptions** object. | 934| index | Pointer to the index of the image to decode. | 935 936**Returns** 937 938Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 939 940 941### OH_DecodingOptions_GetPixelFormat() 942 943``` 944Image_ErrorCode OH_DecodingOptions_GetPixelFormat (OH_DecodingOptions * options, int32_t * pixelFormat ) 945``` 946 947**Description** 948 949Obtains the pixel format. 950 951**Since**: 12 952 953**Parameters** 954 955| Name| Description| 956| -------- | -------- | 957| options | Pointer to an **OH_DecodingOptions** object. | 958| pixelFormat | Pointer to the pixel format. For details about the available options, see [PIXEL_FORMAT](#pixel_format).| 959 960**Returns** 961 962Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 963 964 965### OH_DecodingOptions_GetRotate() 966 967``` 968Image_ErrorCode OH_DecodingOptions_GetRotate (OH_DecodingOptions * options, float * rotate ) 969``` 970 971**Description** 972 973Obtains the rotation degree. 974 975**Since**: 12 976 977**Parameters** 978 979| Name| Description| 980| -------- | -------- | 981| options | Pointer to an **OH_DecodingOptions** object. | 982| rotate | Pointer to the angle to rotate, in degrees. | 983 984**Returns** 985 986Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 987 988 989### OH_DecodingOptions_Release() 990 991``` 992Image_ErrorCode OH_DecodingOptions_Release (OH_DecodingOptions * options) 993``` 994 995**Description** 996 997Releases the pointer to an **OH_DecodingOptions** object. 998 999**Since**: 12 1000 1001**Parameters** 1002 1003| Name| Description| 1004| -------- | -------- | 1005| options | Pointer to an **OH_DecodingOptions** object. | 1006 1007**Returns** 1008 1009Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1010 1011 1012 1013### OH_DecodingOptions_SetDesiredDynamicRange() 1014 1015``` 1016Image_ErrorCode OH_DecodingOptions_SetDesiredDynamicRange (OH_DecodingOptions * options, int32_t desiredDynamicRange ) 1017``` 1018 1019**Description** 1020 1021Sets the desired dynamic range during decoding. 1022 1023**Since**: 12 1024 1025**Parameters** 1026 1027| Name| Description| 1028| -------- | -------- | 1029| options | Pointer to an **OH_DecodingOptions** object. | 1030| desiredDynamicRange | Desired dynamic range. For details about the available options, see [IMAGE_DYNAMIC_RANGE](#image_dynamic_range). | 1031 1032**Returns** 1033 1034Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1035 1036 1037 1038 1039### OH_DecodingOptions_SetDesiredRegion() 1040 1041``` 1042Image_ErrorCode OH_DecodingOptions_SetDesiredRegion (OH_DecodingOptions * options, Image_Region * desiredRegion ) 1043``` 1044 1045**Description** 1046 1047Sets the region to decode. 1048 1049**Since**: 12 1050 1051**Parameters** 1052 1053| Name| Description| 1054| -------- | -------- | 1055| options | Pointer to an **OH_DecodingOptions** object. | 1056| desiredRegion | Pointer to the region to decode. | 1057 1058**Returns** 1059 1060Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1061 1062 1063### OH_DecodingOptions_SetDesiredSize() 1064 1065``` 1066Image_ErrorCode OH_DecodingOptions_SetDesiredSize (OH_DecodingOptions * options, Image_Size * desiredSize ) 1067``` 1068 1069**Description** 1070 1071Sets the desired output size. 1072 1073**Since**: 12 1074 1075**Parameters** 1076 1077| Name| Description| 1078| -------- | -------- | 1079| options | Pointer to an **OH_DecodingOptions** object. | 1080| desiredSize | Pointer to the desired output size. | 1081 1082**Returns** 1083 1084Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1085 1086 1087### OH_DecodingOptions_SetIndex() 1088 1089``` 1090Image_ErrorCode OH_DecodingOptions_SetIndex (OH_DecodingOptions * options, uint32_t index ) 1091``` 1092 1093**Description** 1094 1095Sets the index for an image. 1096 1097**Since**: 12 1098 1099**Parameters** 1100 1101| Name| Description| 1102| -------- | -------- | 1103| options | Pointer to an **OH_DecodingOptions** object. | 1104| index | Index of the image to decode. | 1105 1106**Returns** 1107 1108Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1109 1110 1111### OH_DecodingOptions_SetPixelFormat() 1112 1113``` 1114Image_ErrorCode OH_DecodingOptions_SetPixelFormat (OH_DecodingOptions * options, int32_t pixelFormat ) 1115``` 1116 1117**Description** 1118 1119Sets the pixel format. 1120 1121**Since**: 12 1122 1123**Parameters** 1124 1125| Name| Description| 1126| -------- | -------- | 1127| options | Pointer to an **OH_DecodingOptions** object. | 1128| pixelFormat | Pixel format. For details about the available options, see [PIXEL_FORMAT](#pixel_format). | 1129 1130**Returns** 1131 1132Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1133 1134 1135### OH_DecodingOptions_SetRotate() 1136 1137``` 1138Image_ErrorCode OH_DecodingOptions_SetRotate (OH_DecodingOptions * options, float rotate ) 1139``` 1140 1141**Description** 1142 1143Sets the rotation angle. 1144 1145**Since**: 12 1146 1147**Parameters** 1148 1149| Name| Description| 1150| -------- | -------- | 1151| options | Pointer to an **OH_DecodingOptions** object. | 1152| rotate | Angle to rotate, in degrees. | 1153 1154**Returns** 1155 1156Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1157 1158 1159### OH_ImageNative_GetBufferSize() 1160 1161``` 1162Image_ErrorCode OH_ImageNative_GetBufferSize (OH_ImageNative * image, uint32_t componentType, size_t * size ) 1163``` 1164 1165**Description** 1166 1167Obtains the size of the buffer corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object. 1168 1169**Since**: 12 1170 1171**Parameters** 1172 1173| Name| Description| 1174| -------- | -------- | 1175| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1176| componentType | Component type. | 1177| size | Pointer to the size of the buffer. | 1178 1179**Returns** 1180 1181Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1182 1183 1184### OH_ImageNative_GetByteBuffer() 1185 1186``` 1187Image_ErrorCode OH_ImageNative_GetByteBuffer (OH_ImageNative * image, uint32_t componentType, OH_NativeBuffer ** nativeBuffer ) 1188``` 1189 1190**Description** 1191 1192Obtains the buffer corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object. 1193 1194**Since**: 12 1195 1196**Parameters** 1197 1198| Name| Description| 1199| -------- | -------- | 1200| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1201| componentType | Component type. | 1202| nativeBuffer | Double pointer to the buffer, which is an **OH_NativeBuffer** object. | 1203 1204**Returns** 1205 1206Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1207 1208 1209### OH_ImageNative_GetComponentTypes() 1210 1211``` 1212Image_ErrorCode OH_ImageNative_GetComponentTypes (OH_ImageNative * image, uint32_t ** types, size_t * typeSize ) 1213``` 1214 1215**Description** 1216 1217Obtains the component types of an [OH_ImageNative](#oh_imagenative) object. 1218 1219**Since**: 12 1220 1221**Parameters** 1222 1223| Name| Description| 1224| -------- | -------- | 1225| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1226| types | Double pointer to the component types obtained. | 1227| typeSize | Pointer to the number of component types obtained. | 1228 1229**Returns** 1230 1231Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1232 1233 1234### OH_ImageNative_GetImageSize() 1235 1236``` 1237Image_ErrorCode OH_ImageNative_GetImageSize (OH_ImageNative * image, Image_Size * size ) 1238``` 1239 1240**Description** 1241 1242Obtains the [Image_Size](_image___size.md) information of an [OH_ImageNative](#oh_imagenative) object. 1243 1244**Since**: 12 1245 1246**Parameters** 1247 1248| Name| Description| 1249| -------- | -------- | 1250| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1251| size | Pointer to the [Image_Size](_image___size.md) object obtained. | 1252 1253**Returns** 1254 1255Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 1256 1257 1258### OH_ImageNative_GetPixelStride() 1259 1260``` 1261Image_ErrorCode OH_ImageNative_GetPixelStride (OH_ImageNative * image, uint32_t componentType, int32_t * pixelStride ) 1262``` 1263 1264**Description** 1265 1266Obtains the pixel stride corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object. 1267 1268**Since**: 12 1269 1270**Parameters** 1271 1272| Name| Description| 1273| -------- | -------- | 1274| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1275| componentType | Component type. | 1276| pixelStride | Pointer to the pixel stride obtained. | 1277 1278**Returns** 1279 1280Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1281 1282 1283### OH_ImageNative_GetRowStride() 1284 1285``` 1286Image_ErrorCode OH_ImageNative_GetRowStride (OH_ImageNative * image, uint32_t componentType, int32_t * rowStride ) 1287``` 1288 1289**Description** 1290 1291Obtains the row stride corresponding to a component type in an [OH_ImageNative](#oh_imagenative) object. 1292 1293**Since**: 12 1294 1295**Parameters** 1296 1297| Name| Description| 1298| -------- | -------- | 1299| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1300| componentType | Component type. | 1301| rowStride | Pointer to the row stride obtained. | 1302 1303**Returns** 1304 1305Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1306 1307 1308### OH_ImageNative_Release() 1309 1310``` 1311Image_ErrorCode OH_ImageNative_Release (OH_ImageNative * image) 1312``` 1313 1314**Description** 1315 1316Releases an [OH_ImageNative](#oh_imagenative) object. 1317 1318**Since**: 12 1319 1320**Parameters** 1321 1322| Name| Description| 1323| -------- | -------- | 1324| image | Pointer to an [OH_ImageNative](#oh_imagenative) object. | 1325 1326**Returns** 1327 1328Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1329 1330 1331### OH_ImagePackerNative_Create() 1332 1333``` 1334Image_ErrorCode OH_ImagePackerNative_Create (OH_ImagePackerNative ** imagePacker) 1335``` 1336 1337**Description** 1338 1339Creates the pointer to an **OH_ImagePackerNative** object. 1340 1341**Since**: 12 1342 1343**Parameters** 1344 1345| Name| Description| 1346| -------- | -------- | 1347| options | Double pointer to the **OH_ImagePackerNative** object created. | 1348 1349**Returns** 1350 1351Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1352 1353 1354### OH_ImagePackerNative_PackToDataFromImageSource() 1355 1356``` 1357Image_ErrorCode OH_ImagePackerNative_PackToDataFromImageSource (OH_ImagePackerNative * imagePacker, OH_PackingOptions * options, OH_ImageSourceNative * imageSource, uint8_t * outData, size_t * size ) 1358``` 1359 1360**Description** 1361 1362Encodes an image source into data in a given format. 1363 1364**Since**: 12 1365 1366**Parameters** 1367 1368| Name| Description| 1369| -------- | -------- | 1370| imagePacker | Pointer to an **OH_ImagePackerNative** object. | 1371| options | Pointer to an [OH_PackingOptions](#oh_packingoptions) object. | 1372| imageSource | Pointer to the image source to encode. | 1373| outData | Pointer to the buffer used to store the output data. | 1374| size | Pointer to the size of the buffer. | 1375 1376**Returns** 1377 1378Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DECODE_FAILED** if image decoding fails; returns **IMAGE_ALLOC_FAILED** if memory allocation fails; returns **IMAGE_TOO_LARGE** if the data or image is too large; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 1379 1380 1381### OH_ImagePackerNative_PackToDataFromPixelmap() 1382 1383``` 1384Image_ErrorCode OH_ImagePackerNative_PackToDataFromPixelmap (OH_ImagePackerNative * imagePacker, OH_PackingOptions * options, OH_PixelmapNative * pixelmap, uint8_t * outData, size_t * size ) 1385``` 1386 1387**Description** 1388 1389Encodes a pixel map into data in a given format. 1390 1391**Since**: 12 1392 1393**Parameters** 1394 1395| Name| Description| 1396| -------- | -------- | 1397| imagePacker | Pointer to an **OH_ImagePackerNative** object. | 1398| options | Pointer to an [OH_PackingOptions](#oh_packingoptions) object.| 1399| pixelmap | Pointer to the pixel map to encode. | 1400| outData | Pointer to the buffer used to store the output data. | 1401| size | Pointer to the size of the buffer. | 1402 1403**Returns** 1404 1405Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DECODE_FAILED** if image decoding fails; returns **IMAGE_ALLOC_FAILED** if memory allocation fails; returns **IMAGE_TOO_LARGE** if the data or image is too large; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 1406 1407 1408### OH_ImagePackerNative_PackToFileFromImageSource() 1409 1410``` 1411Image_ErrorCode OH_ImagePackerNative_PackToFileFromImageSource (OH_ImagePackerNative * imagePacker, OH_PackingOptions * options, OH_ImageSourceNative * imageSource, int32_t fd ) 1412``` 1413 1414**Description** 1415 1416Encodes an image source into a file. 1417 1418**Since**: 12 1419 1420**Parameters** 1421 1422| Name| Description| 1423| -------- | -------- | 1424| imagePacker | Pointer to an **OH_ImagePackerNative** object. | 1425| options | Pointer to an [OH_PackingOptions](#oh_packingoptions) object.| 1426| imageSource | Pointer to the image source to encode. | 1427| fd | File descriptor, which is writable. | 1428 1429**Returns** 1430 1431Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DECODE_FAILED** if image decoding fails; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 1432 1433 1434### OH_ImagePackerNative_PackToFileFromPixelmap() 1435 1436``` 1437Image_ErrorCode OH_ImagePackerNative_PackToFileFromPixelmap (OH_ImagePackerNative * imagePacker, OH_PackingOptions * options, OH_PixelmapNative * pixelmap, int32_t fd ) 1438``` 1439 1440**Description** 1441 1442Encodes a pixel map into a file. 1443 1444**Since**: 12 1445 1446**Parameters** 1447 1448| Name| Description| 1449| -------- | -------- | 1450| imagePacker | Pointer to an **OH_ImagePackerNative** object. | 1451| options | Pointer to an [OH_PackingOptions](#oh_packingoptions) object.| 1452| pixelmap | Pointer to the pixel map to encode. | 1453| fd | File descriptor, which is writable. | 1454 1455**Returns** 1456 1457Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DECODE_FAILED** if image decoding fails; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 1458 1459 1460### OH_ImagePackerNative_Release() 1461 1462``` 1463Image_ErrorCode OH_ImagePackerNative_Release (OH_ImagePackerNative * imagePacker) 1464``` 1465 1466**Description** 1467 1468Releases the pointer to an **OH_ImagePackerNative** object. 1469 1470**Since**: 12 1471 1472**Parameters** 1473 1474| Name| Description| 1475| -------- | -------- | 1476| imagePacker | Pointer to an **OH_ImagePackerNative** object. | 1477 1478**Returns** 1479 1480Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1481 1482 1483### OH_ImageReceiverNative_Create() 1484 1485``` 1486Image_ErrorCode OH_ImageReceiverNative_Create (OH_ImageReceiverOptions * options, OH_ImageReceiverNative ** receiver ) 1487``` 1488 1489**Description** 1490 1491Creates an **OH_ImageReceiverNative** object at the application layer. 1492 1493**Since**: 12 1494 1495**Parameters** 1496 1497| Name| Description| 1498| -------- | -------- | 1499| options | Pointer to an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. | 1500| receiver | Double pointer to the [OH_ImageReceiverNative](#oh_imagereceivernative) object created. | 1501 1502**Returns** 1503 1504Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_ALLOC_FAILED** if memory allocation fails. For details, see [Image_ErrorCode](#image_errorcode). 1505 1506 1507### OH_ImageReceiverNative_GetCapacity() 1508 1509``` 1510Image_ErrorCode OH_ImageReceiverNative_GetCapacity (OH_ImageReceiverNative * receiver, int32_t * capacity ) 1511``` 1512 1513**Description** 1514 1515Obtains the capacity of an image receiver, which is an [OH_ImageReceiverNative](#oh_imagereceivernative) object. 1516 1517**Since**: 12 1518 1519**Parameters** 1520 1521| Name| Description| 1522| -------- | -------- | 1523| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1524| capacity | Pointer to the capacity obtained. | 1525 1526**Returns** 1527 1528Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1529 1530**See** 1531 1532[OH_ImageReceiverNative](#oh_imagereceivernative) 1533 1534 1535### OH_ImageReceiverNative_GetReceivingSurfaceId() 1536 1537``` 1538Image_ErrorCode OH_ImageReceiverNative_GetReceivingSurfaceId (OH_ImageReceiverNative * receiver, uint64_t * surfaceId ) 1539``` 1540 1541**Description** 1542 1543Obtains the receiver ID through an [OH_ImageReceiverNative](#oh_imagereceivernative) object. 1544 1545**Since**: 12 1546 1547**Parameters** 1548 1549| Name| Description| 1550| -------- | -------- | 1551| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1552| surfaceId | Pointer to the surface ID obtained. | 1553 1554**Returns** 1555 1556Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 1557 1558**See** 1559 1560[OH_ImageReceiverNative](#oh_imagereceivernative) 1561 1562 1563### OH_ImageReceiverNative_GetSize() 1564 1565``` 1566Image_ErrorCode OH_ImageReceiverNative_GetSize (OH_ImageReceiverNative * receiver, Image_Size * size ) 1567``` 1568 1569**Description** 1570 1571Obtains the size of an image receiver, which is an [OH_ImageReceiverNative](#oh_imagereceivernative) object. 1572 1573**Since**: 12 1574 1575**Parameters** 1576 1577| Name| Description| 1578| -------- | -------- | 1579| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1580| size | Pointer to the [Image_Size](_image___size.md) object obtained. | 1581 1582**Returns** 1583 1584Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1585 1586**See** 1587 1588[OH_ImageReceiverNative](#oh_imagereceivernative), [Image_Size](_image___size.md) 1589 1590 1591### OH_ImageReceiverNative_Off() 1592 1593``` 1594Image_ErrorCode OH_ImageReceiverNative_Off (OH_ImageReceiverNative * receiver) 1595``` 1596 1597**Description** 1598 1599Unregisters a callback, which is an [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) object. 1600 1601The callback is registered by calling [OH_ImageReceiverNative_On](#oh_imagereceivernative_on). 1602 1603**Since**: 12 1604 1605**Parameters** 1606 1607| Name| Description| 1608| -------- | -------- | 1609| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1610 1611**Returns** 1612 1613Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1614 1615**See** 1616 1617[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageReceiverNative_On](#oh_imagereceivernative_on) 1618 1619 1620### OH_ImageReceiverNative_On() 1621 1622``` 1623Image_ErrorCode OH_ImageReceiverNative_On (OH_ImageReceiverNative * receiver, OH_ImageReceiver_OnCallback callback ) 1624``` 1625 1626**Description** 1627 1628Registers a callback, which is an [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) object. 1629 1630This callback is triggered whenever a new image is received. 1631 1632**Since**: 12 1633 1634**Parameters** 1635 1636| Name| Description| 1637| -------- | -------- | 1638| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1639| callback | Callback, which is an [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) object. | 1640 1641**Returns** 1642 1643Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1644 1645**See** 1646 1647[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageReceiver_OnCallback](#oh_imagereceiver_oncallback) 1648 1649 1650### OH_ImageReceiverNative_ReadLatestImage() 1651 1652``` 1653Image_ErrorCode OH_ImageReceiverNative_ReadLatestImage (OH_ImageReceiverNative * receiver, OH_ImageNative ** image ) 1654``` 1655 1656**Description** 1657 1658Obtains the latest image through an [OH_ImageReceiverNative](#oh_imagereceivernative) object. 1659 1660**Since**: 12 1661 1662**Parameters** 1663 1664| Name| Description| 1665| -------- | -------- | 1666| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1667| image | Double pointer to the image obtained, which is an **OH_ImageNative** object at the application layer. | 1668 1669**Returns** 1670 1671Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs; returns **IMAGE_ALLOC_FAILED** if memory allocation fails. For details, see [Image_ErrorCode](#image_errorcode). 1672 1673**See** 1674 1675[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageNative](#oh_imagenative) 1676 1677 1678### OH_ImageReceiverNative_ReadNextImage() 1679 1680``` 1681Image_ErrorCode OH_ImageReceiverNative_ReadNextImage (OH_ImageReceiverNative * receiver, OH_ImageNative ** image ) 1682``` 1683 1684**Description** 1685 1686Obtains the next image through an [OH_ImageReceiverNative](#oh_imagereceivernative) object. 1687 1688**Since**: 12 1689 1690**Parameters** 1691 1692| Name| Description| 1693| -------- | -------- | 1694| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1695| image | Double pointer to the image obtained, which is an **OH_ImageNative** object at the application layer. | 1696 1697**Returns** 1698 1699Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs; returns **IMAGE_ALLOC_FAILED** if memory allocation fails. For details, see [Image_ErrorCode](#image_errorcode). 1700 1701**See** 1702 1703[OH_ImageReceiverNative](#oh_imagereceivernative), [OH_ImageNative](#oh_imagenative) 1704 1705 1706### OH_ImageReceiverNative_Release() 1707 1708``` 1709Image_ErrorCode OH_ImageReceiverNative_Release (OH_ImageReceiverNative * receiver) 1710``` 1711 1712**Description** 1713 1714Releases an [OH_ImageReceiverNative](#oh_imagereceivernative) object. 1715 1716**Since**: 12 1717 1718**Parameters** 1719 1720| Name| Description| 1721| -------- | -------- | 1722| receiver | Pointer to an [OH_ImageReceiverNative](#oh_imagereceivernative) object. | 1723 1724**Returns** 1725 1726Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1727 1728**See** 1729 1730[OH_ImageReceiverNative](#oh_imagereceivernative) 1731 1732 1733### OH_ImageReceiverOptions_Create() 1734 1735``` 1736Image_ErrorCode OH_ImageReceiverOptions_Create (OH_ImageReceiverOptions ** options) 1737``` 1738 1739**Description** 1740 1741Creates an **OH_ImageReceiverOptions** object at the application layer. 1742 1743**Since**: 12 1744 1745**Parameters** 1746 1747| Name| Description| 1748| -------- | -------- | 1749| options | Double pointer to the [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object created. | 1750 1751**Returns** 1752 1753Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_ALLOC_FAILED** if memory allocation fails. For details, see [Image_ErrorCode](#image_errorcode). 1754 1755 1756### OH_ImageReceiverOptions_GetCapacity() 1757 1758``` 1759Image_ErrorCode OH_ImageReceiverOptions_GetCapacity (OH_ImageReceiverOptions * options, int32_t * capacity ) 1760``` 1761 1762**Description** 1763 1764Obtains the capacity of an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. 1765 1766**Since**: 12 1767 1768**Parameters** 1769 1770| Name| Description| 1771| -------- | -------- | 1772| options | Pointer to an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. | 1773| capacity | Pointer to the capacity obtained. | 1774 1775**Returns** 1776 1777Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1778 1779 1780### OH_ImageReceiverOptions_GetSize() 1781 1782``` 1783Image_ErrorCode OH_ImageReceiverOptions_GetSize (OH_ImageReceiverOptions * options, Image_Size * size ) 1784``` 1785 1786**Description** 1787 1788Obtains the [Image_Size](_image___size.md) information of an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. 1789 1790**Since**: 12 1791 1792**Parameters** 1793 1794| Name| Description| 1795| -------- | -------- | 1796| options | Pointer to an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. | 1797| size | Pointer to the [Image_Size](_image___size.md) object obtained. | 1798 1799**Returns** 1800 1801Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1802 1803 1804### OH_ImageReceiverOptions_Release() 1805 1806``` 1807Image_ErrorCode OH_ImageReceiverOptions_Release (OH_ImageReceiverOptions * options) 1808``` 1809 1810**Description** 1811 1812Releases an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. 1813 1814**Since**: 12 1815 1816**Parameters** 1817 1818| Name| Description| 1819| -------- | -------- | 1820| options | Pointer to an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. | 1821 1822**Returns** 1823 1824Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1825 1826**See** 1827 1828[OH_ImageReceiverOptions](#oh_imagereceiveroptions) 1829 1830 1831### OH_ImageReceiverOptions_SetCapacity() 1832 1833``` 1834Image_ErrorCode OH_ImageReceiverOptions_SetCapacity (OH_ImageReceiverOptions * options, int32_t capacity ) 1835``` 1836 1837**Description** 1838 1839Sets the capacity for an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. 1840 1841**Since**: 12 1842 1843**Parameters** 1844 1845| Name| Description| 1846| -------- | -------- | 1847| options | Pointer to an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. | 1848| capacity | Capacity to set. | 1849 1850**Returns** 1851 1852Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1853 1854 1855### OH_ImageReceiverOptions_SetSize() 1856 1857``` 1858Image_ErrorCode OH_ImageReceiverOptions_SetSize (OH_ImageReceiverOptions * options, Image_Size size ) 1859``` 1860 1861**Description** 1862 1863Sets the [Image_Size](_image___size.md) information for an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. 1864 1865**Since**: 12 1866 1867**Parameters** 1868 1869| Name| Description| 1870| -------- | -------- | 1871| options | Pointer to an [OH_ImageReceiverOptions](#oh_imagereceiveroptions) object. | 1872| size | [Image_Size](_image___size.md) object. | 1873 1874**Returns** 1875 1876Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1877 1878 1879### OH_ImageSourceInfo_Create() 1880 1881``` 1882Image_ErrorCode OH_ImageSourceInfo_Create (OH_ImageSource_Info ** info) 1883``` 1884 1885**Description** 1886 1887Creates the pointer to an **OH_ImageSource_Info** object. 1888 1889**Since**: 12 1890 1891**Parameters** 1892 1893| Name| Description| 1894| -------- | -------- | 1895| info | Double pointer to the **OH_ImageSource_Info** object created. | 1896 1897**Returns** 1898 1899Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1900 1901 1902### OH_ImageSourceInfo_GetDynamicRange() 1903 1904``` 1905Image_ErrorCode OH_ImageSourceInfo_GetDynamicRange (OH_ImageSource_Info * info, bool * isHdr ) 1906``` 1907 1908**Description** 1909 1910Obtains the dynamic range of an image. 1911 1912**Since**: 12 1913 1914**Parameters** 1915 1916| Name| Description| 1917| -------- | -------- | 1918| info | Pointer to an **OH_ImageSource_Info** object. | 1919| isHdr | Pointer to a Boolean that specifies whether the HDR is used. | 1920 1921**Returns** 1922 1923Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1924 1925 1926### OH_ImageSourceInfo_GetHeight() 1927 1928``` 1929Image_ErrorCode OH_ImageSourceInfo_GetHeight (OH_ImageSource_Info * info, uint32_t * height ) 1930``` 1931 1932**Description** 1933 1934Obtains the image height. 1935 1936**Since**: 12 1937 1938**Parameters** 1939 1940| Name| Description| 1941| -------- | -------- | 1942| info | Pointer to an **OH_ImageSource_Info** object. | 1943| height | Pointer to the image height, in px. | 1944 1945**Returns** 1946 1947Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1948 1949 1950### OH_ImageSourceInfo_GetWidth() 1951 1952``` 1953Image_ErrorCode OH_ImageSourceInfo_GetWidth (OH_ImageSource_Info * info, uint32_t * width ) 1954``` 1955 1956**Description** 1957 1958Obtains the image width. 1959 1960**Since**: 12 1961 1962**Parameters** 1963 1964| Name| Description| 1965| -------- | -------- | 1966| info | Pointer to an **OH_ImageSource_Info** object. | 1967| width | Pointer to the image width, in px. | 1968 1969**Returns** 1970 1971Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1972 1973 1974### OH_ImageSourceInfo_Release() 1975 1976``` 1977Image_ErrorCode OH_ImageSourceInfo_Release (OH_ImageSource_Info * info) 1978``` 1979 1980**Description** 1981 1982Releases the pointer to an **OH_ImageSource_Info** object. 1983 1984**Since**: 12 1985 1986**Parameters** 1987 1988| Name| Description| 1989| -------- | -------- | 1990| info | Pointer to an **OH_ImageSource_Info** object. | 1991 1992**Returns** 1993 1994Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 1995 1996 1997### OH_ImageSourceNative_CreateFromData() 1998 1999``` 2000Image_ErrorCode OH_ImageSourceNative_CreateFromData (uint8_t * data, size_t dataSize, OH_ImageSourceNative ** res ) 2001``` 2002 2003**Description** 2004 2005Creates the pointer to an **OH_ImageSourceNative** object based on buffer data. 2006 2007**Since**: 12 2008 2009**Parameters** 2010 2011| Name| Description| 2012| -------- | -------- | 2013| data | Pointer to the buffer data. | 2014| dataSize | Size of the buffer. | 2015| res | Double pointer to the **OH_ImageSourceNative** object created at the C++ local layer. | 2016 2017**Returns** 2018 2019Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_BAD_SOURCE** if the data source is abnormal. For details, see [Image_ErrorCode](#image_errorcode). 2020 2021 2022### OH_ImageSourceNative_CreateFromFd() 2023 2024``` 2025Image_ErrorCode OH_ImageSourceNative_CreateFromFd (int32_t fd, OH_ImageSourceNative ** res ) 2026``` 2027 2028**Description** 2029 2030Creates the pointer to an **OH_ImageSourceNative** object based on a file descriptor. 2031 2032**Since**: 12 2033 2034**Parameters** 2035 2036| Name| Description| 2037| -------- | -------- | 2038| fd | File descriptor. | 2039| res | Double pointer to the **OH_ImageSourceNative** object created at the C++ local layer. | 2040 2041**Returns** 2042 2043Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2044 2045 2046### OH_ImageSourceNative_CreateFromRawFile() 2047 2048``` 2049Image_ErrorCode OH_ImageSourceNative_CreateFromRawFile (RawFileDescriptor * rawFile, OH_ImageSourceNative ** res ) 2050``` 2051 2052**Description** 2053 2054Creates the pointer to an **OH_ImageSourceNative** object by using the raw file descriptor of an image resource file. 2055 2056**Since**: 12 2057 2058**Parameters** 2059 2060| Name| Description| 2061| -------- | -------- | 2062| rawFile | Pointer to the file descriptor of the raw file. | 2063| res | Double pointer to the **OH_ImageSourceNative** object created at the C++ local layer. | 2064 2065**Returns** 2066 2067Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2068 2069 2070### OH_ImageSourceNative_CreateFromUri() 2071 2072``` 2073Image_ErrorCode OH_ImageSourceNative_CreateFromUri (char * uri, size_t uriSize, OH_ImageSourceNative ** res ) 2074``` 2075 2076**Description** 2077 2078Creates the pointer to an **OH_ImageSourceNative** object based on a URI. 2079 2080**Since**: 12 2081 2082**Parameters** 2083 2084| Name| Description| 2085| -------- | -------- | 2086| uri | Pointer to the URI of the image source. Only file URIs or Base64 URIs are accepted. Currently, only absolute paths are supported. | 2087| uriSize | URI length. | 2088| res | Double pointer to the **OH_ImageSourceNative** object created at the C++ local layer. | 2089 2090**Returns** 2091 2092Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_BAD_SOURCE** if the data source is abnormal. For details, see [Image_ErrorCode](#image_errorcode). 2093 2094 2095### OH_ImageSourceNative_CreatePixelmap() 2096 2097``` 2098Image_ErrorCode OH_ImageSourceNative_CreatePixelmap (OH_ImageSourceNative * source, OH_DecodingOptions * options, OH_PixelmapNative ** pixelmap ) 2099``` 2100 2101**Description** 2102 2103Creates the pointer to an **OH_PixelmapNative** object based on image decoding parameters. 2104 2105**Since**: 12 2106 2107**Parameters** 2108 2109| Name| Description| 2110| -------- | -------- | 2111| source | Pointer to an **OH_ImageSourceNative** object. | 2112| options | Pointer to the image decoding parameters. | 2113| resPixMap | Double pointer to the **OH_PixelmapNative** object created at the C++ local layer. | 2114 2115**Returns** 2116 2117Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2118 2119 2120### OH_ImageSourceNative_CreatePixelmapList() 2121 2122``` 2123Image_ErrorCode OH_ImageSourceNative_CreatePixelmapList (OH_ImageSourceNative * source, OH_DecodingOptions * options, OH_PixelmapNative * resVecPixMap[], size_t size ) 2124``` 2125 2126**Description** 2127 2128Creates an array of **OH_PixelmapNative** objects based on image decoding parameters. 2129 2130**Since**: 12 2131 2132**Parameters** 2133 2134| Name| Description| 2135| -------- | -------- | 2136| source | Pointer to an **OH_ImageSourceNative** object. | 2137| options | Pointer to the image decoding parameters. | 2138| resVecPixMap | Pointer to an array of **OH_PixelmapNative** objects created at the C++ local layer. | 2139| size | Size of the array. You can use [OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount) to obtain the size. | 2140 2141**Returns** 2142 2143Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNSUPPORTED_OPERATION** if the operation is not supported. For details, see [Image_ErrorCode](#image_errorcode). 2144 2145 2146### OH_ImageSourceNative_GetDelayTimeList() 2147 2148``` 2149Image_ErrorCode OH_ImageSourceNative_GetDelayTimeList (OH_ImageSourceNative * source, int32_t * delayTimeList, size_t size ) 2150``` 2151 2152**Description** 2153 2154Obtains the image delay time list. 2155 2156**Since**: 12 2157 2158**Parameters** 2159 2160| Name| Description| 2161| -------- | -------- | 2162| source | Pointer to an **OH_ImageSourceNative** object. | 2163| delayTimeList | Pointer to the delay time list obtained. It cannot be a null pointer. | 2164| size | Size of the delay time list. You can use [OH_ImageSourceNative_GetFrameCount](#oh_imagesourcenative_getframecount) to obtain the size. | 2165 2166**Returns** 2167 2168Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2169 2170 2171### OH_ImageSourceNative_GetFrameCount() 2172 2173``` 2174Image_ErrorCode OH_ImageSourceNative_GetFrameCount (OH_ImageSourceNative * source, uint32_t * frameCount ) 2175``` 2176 2177**Description** 2178 2179Obtains the number of image frames. 2180 2181**Since**: 12 2182 2183**Parameters** 2184 2185| Name| Description| 2186| -------- | -------- | 2187| source | Pointer to an **OH_ImageSourceNative** object. | 2188| frameCount | Pointer to the number of frames obtained. | 2189 2190**Returns** 2191 2192Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2193 2194 2195### OH_ImageSourceNative_GetImageInfo() 2196 2197``` 2198Image_ErrorCode OH_ImageSourceNative_GetImageInfo (OH_ImageSourceNative * source, int32_t index, OH_ImageSource_Info * info ) 2199``` 2200 2201**Description** 2202 2203Obtains the information about an image with a given index. 2204 2205**Since**: 12 2206 2207**Parameters** 2208 2209| Name| Description| 2210| -------- | -------- | 2211| source | Pointer to an **OH_ImageSourceNative** object. | 2212| index | Index of an image. For a GIF image, the value range is [0, N-1], where N indicates the number of GIF frames. For an image with only one frame, you can pass in **0**. | 2213| info | Pointer to the image information obtained, which is an **OH_ImageSource_Info** object. | 2214 2215**Returns** 2216 2217Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2218 2219 2220### OH_ImageSourceNative_GetImageProperty() 2221 2222``` 2223Image_ErrorCode OH_ImageSourceNative_GetImageProperty (OH_ImageSourceNative * source, Image_String * key, Image_String * value ) 2224``` 2225 2226**Description** 2227 2228Obtains the value of an image property. 2229 2230**Since**: 12 2231 2232**Parameters** 2233 2234| Name| Description| 2235| -------- | -------- | 2236| source | Pointer to an **OH_ImageSourceNative** object. | 2237| key | Pointer to the property key. For details, see [Image_String](_image___string.md). For details about the value range of **key**, see the definition of **OHOS_IMAGE_PROPERTY_XXX**. The memory must be released after the image source is used. For details, see [OH_ImageSourceNative_Release](#oh_imagesourcenative_release). | 2238| value | Pointer to the value obtained. You can pass in a null pointer with the size set to zero. In this case, the system will allocate memory, but you must release the memory after use. | 2239 2240**Returns** 2241 2242Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2243 2244 2245### OH_ImageSourceNative_ModifyImageProperty() 2246 2247``` 2248Image_ErrorCode OH_ImageSourceNative_ModifyImageProperty (OH_ImageSourceNative * source, Image_String * key, Image_String * value ) 2249``` 2250 2251**Description** 2252 2253Modifies the value of an image property. 2254 2255**Since**: 12 2256 2257**Parameters** 2258 2259| Name| Description| 2260| -------- | -------- | 2261| source | Pointer to an **OH_ImageSourceNative** object. | 2262| key | Pointer to the property key. For details, see [Image_String](_image___string.md). **key** is an EXIF constant. The memory must be released after the image source is used. For details, see [OH_ImageSourceNative_Release](#oh_imagesourcenative_release). | 2263| value | Pointer to the new value. | 2264 2265**Returns** 2266 2267Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2268 2269 2270### OH_ImageSourceNative_Release() 2271 2272``` 2273Image_ErrorCode OH_ImageSourceNative_Release (OH_ImageSourceNative * source) 2274``` 2275 2276**Description** 2277 2278Releases the pointer to an **OH_ImageSourceNative** object. 2279 2280**Since**: 12 2281 2282**Parameters** 2283 2284| Name| Description| 2285| -------- | -------- | 2286| source | Pointer to an **OH_ImageSourceNative** object. | 2287 2288**Returns** 2289 2290Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2291 2292 2293### OH_PackingOptions_Create() 2294 2295``` 2296Image_ErrorCode OH_PackingOptions_Create (OH_PackingOptions ** options) 2297``` 2298 2299**Description** 2300 2301Creates the pointer to an **OH_PackingOptions** object. 2302 2303**Since**: 12 2304 2305**Parameters** 2306 2307| Name| Description| 2308| -------- | -------- | 2309| options | Double pointer to the **OH_PackingOptions** object created. | 2310 2311**Returns** 2312 2313Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2314 2315 2316### OH_PackingOptions_GetDesiredDynamicRange() 2317 2318``` 2319Image_ErrorCode OH_PackingOptions_GetDesiredDynamicRange (OH_PackingOptions * options, int32_t * desiredDynamicRange ) 2320``` 2321 2322**Description** 2323 2324Obtains the desired dynamic range during encoding. 2325 2326**Since**: 12 2327 2328**Parameters** 2329 2330| Name| Description| 2331| -------- | -------- | 2332| options | Pointer to an **OH_PackingOptions** object. | 2333| desiredDynamicRange | Pointer to the desired dynamic range. For details about the available options, see [IMAGE_PACKER_DYNAMIC_RANGE](#image_packer_dynamic_range). | 2334 2335**Returns** 2336 2337Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2338 2339 2340### OH_PackingOptions_GetMimeType() 2341 2342``` 2343Image_ErrorCode OH_PackingOptions_GetMimeType (OH_PackingOptions * options, Image_MimeType * format ) 2344``` 2345 2346**Description** 2347 2348Obtains the MIME type. 2349 2350**Since**: 12 2351 2352**Parameters** 2353 2354| Name| Description| 2355| -------- | -------- | 2356| options | Pointer to an **OH_PackingOptions** object. | 2357| format | Pointer to the image format. You can pass in a null pointer with the size set to zero. In this case, the system will allocate memory, but you must release the memory after use. | 2358 2359**Returns** 2360 2361Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2362 2363 2364### OH_PackingOptions_GetQuality() 2365 2366``` 2367Image_ErrorCode OH_PackingOptions_GetQuality (OH_PackingOptions * options, uint32_t * quality ) 2368``` 2369 2370**Description** 2371 2372Obtains the encoding quality. 2373 2374**Since**: 12 2375 2376**Parameters** 2377 2378| Name| Description| 2379| -------- | -------- | 2380| options | Pointer to an **OH_PackingOptions** object. | 2381| quality | Pointer to the encoding quality. | 2382 2383**Returns** 2384 2385Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2386 2387 2388### OH_PackingOptions_Release() 2389 2390``` 2391Image_ErrorCode OH_PackingOptions_Release (OH_PackingOptions * options) 2392``` 2393 2394**Description** 2395 2396Releases the pointer to an **OH_PackingOptions** object. 2397 2398**Since**: 12 2399 2400**Parameters** 2401 2402| Name| Description| 2403| -------- | -------- | 2404| options | Pointer to an **OH_PackingOptions** object. | 2405 2406**Returns** 2407 2408Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2409 2410 2411### OH_PackingOptions_SetDesiredDynamicRange() 2412 2413``` 2414Image_ErrorCode OH_PackingOptions_SetDesiredDynamicRange (OH_PackingOptions * options, int32_t desiredDynamicRange ) 2415``` 2416 2417**Description** 2418 2419Sets the desired dynamic range during encoding. 2420 2421**Since**: 12 2422 2423**Parameters** 2424 2425| Name| Description| 2426| -------- | -------- | 2427| options | Pointer to an **OH_PackingOptions** object. | 2428| desiredDynamicRange | Desired dynamic range. For details about the available options, see [IMAGE_PACKER_DYNAMIC_RANGE](#image_packer_dynamic_range). | 2429 2430**Returns** 2431 2432Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2433 2434 2435### OH_PackingOptions_SetMimeType() 2436 2437``` 2438Image_ErrorCode OH_PackingOptions_SetMimeType (OH_PackingOptions * options, Image_MimeType * format ) 2439``` 2440 2441**Description** 2442 2443Sets the MIME type. 2444 2445**Since**: 12 2446 2447**Parameters** 2448 2449| Name| Description| 2450| -------- | -------- | 2451| options | Pointer to an **OH_PackingOptions** object. | 2452| format | Pointer to the image format. | 2453 2454**Returns** 2455 2456Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2457 2458 2459### OH_PackingOptions_SetQuality() 2460 2461``` 2462Image_ErrorCode OH_PackingOptions_SetQuality (OH_PackingOptions * options, uint32_t quality ) 2463``` 2464 2465**Description** 2466 2467Sets the encoding quality. 2468 2469**Since**: 12 2470 2471**Parameters** 2472 2473| Name| Description| 2474| -------- | -------- | 2475| options | Pointer to an **OH_PackingOptions** object. | 2476| quality | Encoding quality. | 2477 2478**Returns** 2479 2480Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2481 2482 2483### OH_PixelmapImageInfo_Create() 2484 2485``` 2486Image_ErrorCode OH_PixelmapImageInfo_Create (OH_Pixelmap_ImageInfo ** info) 2487``` 2488 2489**Description** 2490 2491Creates the pointer to an **OH_Pixelmap_ImageInfo** object. 2492 2493**Since**: 12 2494 2495**Parameters** 2496 2497| Name| Description| 2498| -------- | -------- | 2499| info | Double pointer to the **OH_Pixelmap_ImageInfo** object created. | 2500 2501**Returns** 2502 2503Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2504 2505 2506### OH_PixelmapImageInfo_GetAlphaType() 2507 2508``` 2509Image_ErrorCode OH_PixelmapImageInfo_GetAlphaType (OH_Pixelmap_ImageInfo * info, int32_t * alphaType ) 2510``` 2511 2512**Description** 2513 2514Obtains the alpha type. 2515 2516**Since**: 12 2517 2518**Parameters** 2519 2520| Name| Description| 2521| -------- | -------- | 2522| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2523| alphaType | Pointer to the alpha type. For details about the available options, see [PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type). | 2524 2525**Returns** 2526 2527Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2528 2529 2530### OH_PixelmapImageInfo_GetDynamicRange() 2531 2532``` 2533Image_ErrorCode OH_PixelmapImageInfo_GetDynamicRange (OH_Pixelmap_ImageInfo * info, bool * isHdr ) 2534``` 2535 2536**Description** 2537 2538Obtains the dynamic range of a pixel map. 2539 2540**Since**: 12 2541 2542**Parameters** 2543 2544| Name| Description| 2545| -------- | -------- | 2546| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2547| isHdr | Pointer to a Boolean that specifies whether the HDR is used. | 2548 2549**Returns** 2550 2551Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2552 2553 2554### OH_PixelmapImageInfo_GetHeight() 2555 2556``` 2557Image_ErrorCode OH_PixelmapImageInfo_GetHeight (OH_Pixelmap_ImageInfo * info, uint32_t * height ) 2558``` 2559 2560**Description** 2561 2562Obtains the image height. 2563 2564**Since**: 12 2565 2566**Parameters** 2567 2568| Name| Description| 2569| -------- | -------- | 2570| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2571| height | Pointer to the image height, in px. | 2572 2573**Returns** 2574 2575Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2576 2577 2578### OH_PixelmapImageInfo_GetPixelFormat() 2579 2580``` 2581Image_ErrorCode OH_PixelmapImageInfo_GetPixelFormat (OH_Pixelmap_ImageInfo * info, int32_t * pixelFormat ) 2582``` 2583 2584**Description** 2585 2586Obtains the pixel format. 2587 2588**Since**: 12 2589 2590**Parameters** 2591 2592| Name| Description| 2593| -------- | -------- | 2594| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2595| pixelFormat | Pointer to the pixel format. | 2596 2597**Returns** 2598 2599Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2600 2601 2602### OH_PixelmapImageInfo_GetRowStride() 2603 2604``` 2605Image_ErrorCode OH_PixelmapImageInfo_GetRowStride (OH_Pixelmap_ImageInfo * info, uint32_t * rowStride ) 2606``` 2607 2608**Description** 2609 2610Obtains the row stride. 2611 2612**Since**: 12 2613 2614**Parameters** 2615 2616| Name| Description| 2617| -------- | -------- | 2618| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2619| rowStride | Pointer to the row stride, which is the number of bytes from one row of pixels in memory to the next row of pixels in memory. | 2620 2621**Returns** 2622 2623Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2624 2625 2626### OH_PixelmapImageInfo_GetWidth() 2627 2628``` 2629Image_ErrorCode OH_PixelmapImageInfo_GetWidth (OH_Pixelmap_ImageInfo * info, uint32_t * width ) 2630``` 2631 2632**Description** 2633 2634Obtains the image width. 2635 2636**Since**: 12 2637 2638**Parameters** 2639 2640| Name| Description| 2641| -------- | -------- | 2642| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2643| width | Pointer to the image width, in px. | 2644 2645**Returns** 2646 2647Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2648 2649 2650### OH_PixelmapImageInfo_Release() 2651 2652``` 2653Image_ErrorCode OH_PixelmapImageInfo_Release (OH_Pixelmap_ImageInfo * info) 2654``` 2655 2656**Description** 2657 2658Releases the pointer to an **OH_Pixelmap_ImageInfo** object. 2659 2660**Since**: 12 2661 2662**Parameters** 2663 2664| Name| Description| 2665| -------- | -------- | 2666| info | Pointer to an **OH_Pixelmap_ImageInfo** object. | 2667 2668**Returns** 2669 2670Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2671 2672 2673### OH_PixelmapInitializationOptions_Create() 2674 2675``` 2676Image_ErrorCode OH_PixelmapInitializationOptions_Create (OH_Pixelmap_InitializationOptions ** options) 2677``` 2678 2679**Description** 2680 2681Creates the pointer to an **OH_Pixelmap_InitializationOptions** object. 2682 2683**Since**: 12 2684 2685**Parameters** 2686 2687| Name| Description| 2688| -------- | -------- | 2689| options | Double pointer to the **OH_Pixelmap_InitializationOptions** object created. | 2690 2691**Returns** 2692 2693Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2694 2695 2696### OH_PixelmapInitializationOptions_GetAlphaType() 2697 2698``` 2699Image_ErrorCode OH_PixelmapInitializationOptions_GetAlphaType (OH_Pixelmap_InitializationOptions * options, int32_t * alphaType ) 2700``` 2701 2702**Description** 2703 2704Obtains the alpha type. 2705 2706**Since**: 12 2707 2708**Parameters** 2709 2710| Name| Description| 2711| -------- | -------- | 2712| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2713| alphaType | Pointer to the alpha type. For details about the available options, see [PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type). | 2714 2715**Returns** 2716 2717Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2718 2719 2720### OH_PixelmapInitializationOptions_GetHeight() 2721 2722``` 2723Image_ErrorCode OH_PixelmapInitializationOptions_GetHeight (OH_Pixelmap_InitializationOptions * options, uint32_t * height ) 2724``` 2725 2726**Description** 2727 2728Obtains the image height. 2729 2730**Since**: 12 2731 2732**Parameters** 2733 2734| Name| Description| 2735| -------- | -------- | 2736| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2737| height | Pointer to the image height, in px. | 2738 2739**Returns** 2740 2741Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2742 2743 2744### OH_PixelmapInitializationOptions_GetPixelFormat() 2745 2746``` 2747Image_ErrorCode OH_PixelmapInitializationOptions_GetPixelFormat (OH_Pixelmap_InitializationOptions * options, int32_t * pixelFormat ) 2748``` 2749 2750**Description** 2751 2752Obtains the pixel format. 2753 2754**Since**: 12 2755 2756**Parameters** 2757 2758| Name| Description| 2759| -------- | -------- | 2760| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2761| pixelFormat | Pointer to the pixel format. For details about the available options, see [PIXEL_FORMAT](#pixel_format).| 2762 2763**Returns** 2764 2765Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2766 2767 2768### OH_PixelmapInitializationOptions_GetRowStride() 2769 2770``` 2771Image_ErrorCode OH_PixelmapInitializationOptions_GetRowStride (OH_Pixelmap_InitializationOptions * options, int32_t * rowStride ) 2772``` 2773 2774**Description** 2775 2776Obtains the row stride. 2777 2778The stride is the actual memory size occupied by each row of the image, in bytes. Stride = Width \*Number of bytes per pixel + Padding, where padding refers to the extra space added at the end of each row for memory alignment purposes. 2779 2780**Since**: 12 2781 2782**Parameters** 2783 2784| Name| Description| 2785| -------- | -------- | 2786| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2787| rowStride | Pointer to the stride, in bytes. | 2788 2789**Returns** 2790 2791Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if the object pointed to by **options** is released. For details, see [Image_ErrorCode](#image_errorcode). 2792 2793 2794### OH_PixelmapInitializationOptions_GetSrcPixelFormat() 2795 2796``` 2797Image_ErrorCode OH_PixelmapInitializationOptions_GetSrcPixelFormat(OH_Pixelmap_InitializationOptions *ops, int32_t *srcpixelFormat) 2798``` 2799 2800**Description** 2801 2802Obtains the source pixel format. 2803 2804**Since**: 12 2805 2806**Parameters** 2807 2808| Name| Description| 2809| -------- | -------- | 2810| options | Pointer to an **OH_Pixelmap_InitializationOptions** object.| 2811| srcpixelFormat | Pointer to the source pixel format. For details about the available options, see [PIXEL_FORMAT](#pixel_format).| 2812 2813**Returns** 2814 2815Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2816 2817 2818### OH_PixelmapInitializationOptions_GetWidth() 2819 2820``` 2821Image_ErrorCode OH_PixelmapInitializationOptions_GetWidth (OH_Pixelmap_InitializationOptions * options, uint32_t * width ) 2822``` 2823 2824**Description** 2825 2826Obtains the image width. 2827 2828**Since**: 12 2829 2830**Parameters** 2831 2832| Name| Description| 2833| -------- | -------- | 2834| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2835| width | Pointer to the image width, in px. | 2836 2837**Returns** 2838 2839Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2840 2841 2842### OH_PixelmapInitializationOptions_Release() 2843 2844``` 2845Image_ErrorCode OH_PixelmapInitializationOptions_Release (OH_Pixelmap_InitializationOptions * options) 2846``` 2847 2848**Description** 2849 2850Releases the pointer to an **OH_Pixelmap_InitializationOptions** object. 2851 2852**Since**: 12 2853 2854**Parameters** 2855 2856| Name| Description| 2857| -------- | -------- | 2858| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2859 2860**Returns** 2861 2862Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2863 2864 2865### OH_PixelmapInitializationOptions_SetAlphaType() 2866 2867``` 2868Image_ErrorCode OH_PixelmapInitializationOptions_SetAlphaType (OH_Pixelmap_InitializationOptions * options, int32_t alphaType ) 2869``` 2870 2871**Description** 2872 2873Sets the alpha type. 2874 2875**Since**: 12 2876 2877**Parameters** 2878 2879| Name| Description| 2880| -------- | -------- | 2881| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2882| alphaType | Alpha type. For details about the available options, see [PIXELMAP_ALPHA_TYPE](#pixelmap_alpha_type). | 2883 2884**Returns** 2885 2886Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2887 2888 2889### OH_PixelmapInitializationOptions_SetHeight() 2890 2891``` 2892Image_ErrorCode OH_PixelmapInitializationOptions_SetHeight (OH_Pixelmap_InitializationOptions * options, uint32_t height ) 2893``` 2894 2895**Description** 2896 2897Sets the image height. 2898 2899**Since**: 12 2900 2901**Parameters** 2902 2903| Name| Description| 2904| -------- | -------- | 2905| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2906| height | Image height, in px. | 2907 2908**Returns** 2909 2910Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2911 2912 2913### OH_PixelmapInitializationOptions_SetPixelFormat() 2914 2915``` 2916Image_ErrorCode OH_PixelmapInitializationOptions_SetPixelFormat (OH_Pixelmap_InitializationOptions * options, int32_t pixelFormat ) 2917``` 2918 2919**Description** 2920 2921Sets the pixel format. 2922 2923**Since**: 12 2924 2925**Parameters** 2926 2927| Name| Description| 2928| -------- | -------- | 2929| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2930| pixelFormat | Pixel format. For details about the available options, see [PIXEL_FORMAT](#pixel_format).| 2931 2932**Returns** 2933 2934Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2935 2936 2937### OH_PixelmapInitializationOptions_SetRowStride() 2938 2939``` 2940Image_ErrorCode OH_PixelmapInitializationOptions_SetRowStride (OH_Pixelmap_InitializationOptions * options, int32_t rowStride ) 2941``` 2942 2943**Description** 2944 2945Sets the row stride. 2946 2947The stride is the actual memory size occupied by each row of the image, in bytes. Stride = Width \*Number of bytes per pixel + Padding, where padding refers to the extra space added at the end of each row for memory alignment purposes. 2948 2949**Since**: 12 2950 2951**Parameters** 2952 2953| Name| Description| 2954| -------- | -------- | 2955| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2956| rowStride | Pointer to the stride, in bytes. | 2957 2958**Returns** 2959 2960Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if the object pointed to by **options** is released. For details, see [Image_ErrorCode](#image_errorcode). 2961 2962 2963### OH_PixelmapInitializationOptions_SetSrcPixelFormat() 2964 2965``` 2966Image_ErrorCode OH_PixelmapInitializationOptions_SetSrcPixelFormat (OH_Pixelmap_InitializationOptions * options, int32_t srcpixelFormat ) 2967``` 2968 2969**Description** 2970 2971Sets the source pixel format. 2972 2973**Since**: 12 2974 2975**Parameters** 2976 2977| Name| Description| 2978| -------- | -------- | 2979| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 2980| srcpixelFormat | Source pixel format. For details about the available options, see [PIXEL_FORMAT](#pixel_format). | 2981 2982**Returns** 2983 2984Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 2985 2986 2987### OH_PixelmapInitializationOptions_SetWidth() 2988 2989``` 2990Image_ErrorCode OH_PixelmapInitializationOptions_SetWidth (OH_Pixelmap_InitializationOptions * options, uint32_t width ) 2991``` 2992 2993**Description** 2994 2995Sets the image width. 2996 2997**Since**: 12 2998 2999**Parameters** 3000 3001| Name| Description| 3002| -------- | -------- | 3003| options | Pointer to an **OH_Pixelmap_InitializationOptions** object. | 3004| width | Image width, in px. | 3005 3006**Returns** 3007 3008Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3009 3010 3011### OH_PixelmapNative_ConvertAlphaFormat() 3012 3013``` 3014Image_ErrorCode OH_PixelmapNative_ConvertAlphaFormat (OH_PixelmapNative * srcpixelmap, OH_PixelmapNative * dstpixelmap, const bool isPremul ) 3015``` 3016 3017**Description** 3018 3019Converts pixel data of a pixel map from premultiplied alpha to non-premultiplied alpha, or vice versa. 3020 3021**Since**: 12 3022 3023**Parameters** 3024 3025| Name| Description| 3026| -------- | -------- | 3027| srcpixelmap | Pointer to the source pixel map, which is an **OH_PixelmapNative** object. | 3028| dstpixelmap | Pointer to the destination pixel map, which is an **OH_PixelmapNative** object. This pointer must be different from the pointer to the source pixel map. | 3029| isPremul | Conversion mode. The value **true** means a conversion from premultiplied alpha to non-premultiplied alpha, and **false** means a conversion from non-premultiplied alpha to premultiplied alpha. | 3030 3031**Returns** 3032 3033Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3034 3035 3036### OH_PixelmapNative_CreateEmptyPixelmap() 3037 3038``` 3039Image_ErrorCode OH_PixelmapNative_CreateEmptyPixelmap (OH_Pixelmap_InitializationOptions * options, OH_PixelmapNative ** pixelmap ) 3040``` 3041 3042**Description** 3043 3044Creates an empty pixel map using **OH_Pixelmap_InitializationOptions**. The memory data is 0. 3045 3046**Since**: 12 3047 3048**Parameters** 3049 3050| Name| Description| 3051| -------- | -------- | 3052| options | Pointer to the properties. | 3053| pixelmap | Double pointer to the **OH_PixelmapNative** object created. | 3054 3055**Returns** 3056 3057Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3058 3059 3060### OH_PixelmapNative_CreatePixelmap() 3061 3062``` 3063Image_ErrorCode OH_PixelmapNative_CreatePixelmap (uint8_t * data, size_t dataLength, OH_Pixelmap_InitializationOptions * options, OH_PixelmapNative ** pixelmap ) 3064``` 3065 3066**Description** 3067 3068Creates a **PixelMap** object based on properties. By default, the BGRA_8888 format is used for data processing. 3069 3070**Since**: 12 3071 3072**Parameters** 3073 3074| Name| Description| 3075| -------- | -------- | 3076| data | Pointer to the color array in BGRA_8888 format. | 3077| dataLength | Size of the array. | 3078| options | Pointer to the properties. | 3079| pixelmap | Double pointer to the **OH_PixelmapNative** object created. | 3080 3081**Returns** 3082 3083Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNSUPPORTED_OPERATION** if the operation is not supported. For details, see [Image_ErrorCode](#image_errorcode). 3084 3085 3086### OH_PixelmapNative_Crop() 3087 3088``` 3089Image_ErrorCode OH_PixelmapNative_Crop (OH_PixelmapNative * pixelmap, Image_Region * region ) 3090``` 3091 3092**Description** 3093 3094Crops an image based on a given size. 3095 3096**Since**: 12 3097 3098**Parameters** 3099 3100| Name| Description| 3101| -------- | -------- | 3102| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3103| region | Pointer to the region of the image after cropping. | 3104 3105**Returns** 3106 3107Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3108 3109 3110### OH_PixelmapNative_Flip() 3111 3112``` 3113Image_ErrorCode OH_PixelmapNative_Flip (OH_PixelmapNative * pixelmap, bool shouldFilpHorizontally, bool shouldFilpVertically ) 3114``` 3115 3116**Description** 3117 3118Flips an image based on a given angle. 3119 3120**Since**: 12 3121 3122**Parameters** 3123 3124| Name| Description| 3125| -------- | -------- | 3126| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3127| shouldFilpHorizontally | Whether to flip the image horizontally. | 3128| shouldFilpVertically | Whether to flip the image vertically. | 3129 3130**Returns** 3131 3132Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3133 3134 3135### OH_PixelmapNative_GetImageInfo() 3136 3137``` 3138Image_ErrorCode OH_PixelmapNative_GetImageInfo (OH_PixelmapNative * pixelmap, OH_Pixelmap_ImageInfo * imageInfo ) 3139``` 3140 3141**Description** 3142 3143Obtains the image information. 3144 3145**Since**: 12 3146 3147**Parameters** 3148 3149| Name| Description| 3150| -------- | -------- | 3151| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3152| imageInfo | Pointer to the image information. | 3153 3154**Returns** 3155 3156Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3157 3158 3159### OH_PixelmapNative_GetMetadata() 3160 3161``` 3162Image_ErrorCode OH_PixelmapNative_GetMetadata (OH_PixelmapNative * pixelmap, OH_Pixelmap_HdrMetadataKey key, OH_Pixelmap_HdrMetadataValue ** value ) 3163``` 3164 3165**Description** 3166 3167Obtains the metadata. 3168 3169**Since**: 12 3170 3171**Parameters** 3172 3173| Name| Description| 3174| -------- | -------- | 3175| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3176| key | Metadata key. For details, see [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey). | 3177| value | Double pointer to the value of the metadata key. For details, see [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md). | 3178 3179**Returns** 3180 3181Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DMA_NOT_EXIST** if the DMA memory does not exist; returns **IMAGE_COPY_FAILED** if the memory copy fails. For details, see [Image_ErrorCode](#image_errorcode). 3182 3183 3184### OH_PixelmapNative_GetNativeBuffer() 3185 3186``` 3187Image_ErrorCode OH_PixelmapNative_GetNativeBuffer (OH_PixelmapNative * pixelmap, OH_NativeBuffer ** nativeBuffer ) 3188``` 3189 3190**Description** 3191 3192Obtains the **NativeBuffer** object from a pixel map in the DMA memory. 3193 3194**Since**: 12 3195 3196**Parameters** 3197 3198| Name| Description| 3199| -------- | -------- | 3200| pixelmap | Pointer to the pixel map. | 3201| nativeBuffer | Double pointer to the **NativeBuffer** object obtained. | 3202 3203**Returns** 3204 3205Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DMA_NOT_EXIST** if the memory is not the DMA memory; returns **IMAGE_DMA_OPERATION_FAILED** if the operation on the DMA memory fails. For details, see [Image_ErrorCode](#image_errorcode). 3206 3207 3208### OH_PixelmapNative_Opacity() 3209 3210``` 3211Image_ErrorCode OH_PixelmapNative_Opacity (OH_PixelmapNative * pixelmap, float rate ) 3212``` 3213 3214**Description** 3215 3216Sets the opacity rate to enable the pixel map to achieve the corresponding opacity effect. 3217 3218**Since**: 12 3219 3220**Parameters** 3221 3222| Name| Description| 3223| -------- | -------- | 3224| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3225| rate | Opacity rate to set. | 3226 3227**Returns** 3228 3229Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3230 3231 3232### OH_PixelmapNative_ReadPixels() 3233 3234``` 3235Image_ErrorCode OH_PixelmapNative_ReadPixels (OH_PixelmapNative * pixelmap, uint8_t * destination, size_t * bufferSize ) 3236``` 3237 3238**Description** 3239 3240Reads pixel data of an image and writes the data to the buffer based on the pixel format of the pixel map. 3241 3242**Since**: 12 3243 3244**Parameters** 3245 3246| Name| Description| 3247| -------- | -------- | 3248| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3249| destination | Pointer to the buffer to which the image pixel map data will be written. | 3250| bufferSize | Pointer to the buffer size. | 3251 3252**Returns** 3253 3254Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 3255 3256 3257### OH_PixelmapNative_Release() 3258 3259``` 3260Image_ErrorCode OH_PixelmapNative_Release (OH_PixelmapNative * pixelmap) 3261``` 3262 3263**Description** 3264 3265Releases the pointer to an **OH_PixelmapNative** object. 3266 3267**Since**: 12 3268 3269**Parameters** 3270 3271| Name| Description| 3272| -------- | -------- | 3273| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3274 3275**Returns** 3276 3277Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3278 3279 3280### OH_PixelmapNative_Rotate() 3281 3282``` 3283Image_ErrorCode OH_PixelmapNative_Rotate (OH_PixelmapNative * pixelmap, float angle ) 3284``` 3285 3286**Description** 3287 3288Rotates an image based on a given angle. 3289 3290**Since**: 12 3291 3292**Parameters** 3293 3294| Name| Description| 3295| -------- | -------- | 3296| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3297| angle | Image rotation angle, in degrees. | 3298 3299**Returns** 3300 3301Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3302 3303 3304### OH_PixelmapNative_Scale() 3305 3306``` 3307Image_ErrorCode OH_PixelmapNative_Scale (OH_PixelmapNative * pixelmap, float scaleX, float scaleY ) 3308``` 3309 3310**Description** 3311 3312Scales an image based on a given width and height. 3313 3314**Since**: 12 3315 3316**Parameters** 3317 3318| Name| Description| 3319| -------- | -------- | 3320| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3321| scaleX | Scale ratio of the width. | 3322| scaleY | Scale ratio of the height. | 3323 3324**Returns** 3325 3326Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3327 3328 3329### OH_PixelmapNative_ScaleWithAntiAliasing() 3330 3331``` 3332Image_ErrorCode OH_PixelmapNative_ScaleWithAntiAliasing (OH_PixelmapNative * pixelmap, float scaleX, float scaleY, OH_PixelmapNative_AntiAliasingLevel level ) 3333``` 3334 3335**Description** 3336 3337Scales an image based on the specified antialiasing level, width, and height. 3338 3339**Since**: 12 3340 3341**Parameters** 3342 3343| Name| Description| 3344| -------- | -------- | 3345| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3346| scaleX | Scale ratio of the width. | 3347| scaleY | Scale ratio of the height. | 3348| level | Antialiasing level. | 3349 3350**Returns** 3351 3352Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_TOO_LARGE** if the image is too large; returns **IMAGE_ALLOC_FAILED** if memory allocation fails; returns **IMAGE_UNKNOWN_ERROR** if the object pointed to by **pixelmap** is released. For details, see [Image_ErrorCode](#image_errorcode). 3353 3354 3355### OH_PixelmapNative_SetMetadata() 3356 3357``` 3358Image_ErrorCode OH_PixelmapNative_SetMetadata (OH_PixelmapNative * pixelmap, OH_Pixelmap_HdrMetadataKey key, OH_Pixelmap_HdrMetadataValue * value ) 3359``` 3360 3361**Description** 3362 3363Sets metadata. 3364 3365**Since**: 12 3366 3367**Parameters** 3368 3369| Name| Description| 3370| -------- | -------- | 3371| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3372| key | Pointer to the metadata key. For details, see [OH_Pixelmap_HdrMetadataKey](#oh_pixelmap_hdrmetadatakey). | 3373| value | Pointer to the value of the metadata key. For details, see [OH_Pixelmap_HdrMetadataValue](_o_h___pixelmap___hdr_metadata_value.md). | 3374 3375**Returns** 3376 3377Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_DMA_NOT_EXIST** if the DMA memory does not exist; returns **IMAGE_COPY_FAILED** if the memory copy fails. For details, see [Image_ErrorCode](#image_errorcode). 3378 3379 3380### OH_PixelmapNative_ToSdr() 3381 3382``` 3383Image_ErrorCode OH_PixelmapNative_ToSdr (OH_PixelmapNative * pixelmap) 3384``` 3385 3386**Description** 3387 3388Converts an HDR image into an SDR image. 3389 3390**Since**: 12 3391 3392**Parameters** 3393 3394| Name| Description| 3395| -------- | -------- | 3396| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3397 3398**Returns** 3399 3400Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNSUPPORTED_OPERATION** if the operation is not supported. For details, see [Image_ErrorCode](#image_errorcode). 3401 3402 3403### OH_PixelmapNative_Translate() 3404 3405``` 3406Image_ErrorCode OH_PixelmapNative_Translate (OH_PixelmapNative * pixelmap, float x, float y ) 3407``` 3408 3409**Description** 3410 3411Translates an image based on given coordinates. 3412 3413**Since**: 12 3414 3415**Parameters** 3416 3417| Name| Description| 3418| -------- | -------- | 3419| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3420| x | X coordinate to translate. | 3421| y | Y coordinate to translate. | 3422 3423**Returns** 3424 3425Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect. For details, see [Image_ErrorCode](#image_errorcode). 3426 3427 3428### OH_PixelmapNative_WritePixels() 3429 3430``` 3431Image_ErrorCode OH_PixelmapNative_WritePixels (OH_PixelmapNative * pixelmap, uint8_t * source, size_t bufferSize ) 3432``` 3433 3434**Description** 3435 3436Reads the pixel data in the buffer and writes the result to the pixel map based on the pixel format of the pixel map. 3437 3438**Since**: 12 3439 3440**Parameters** 3441 3442| Name| Description| 3443| -------- | -------- | 3444| pixelmap | Pointer to an **OH_PixelmapNative** object. | 3445| source | Pointer to the buffer from which the image data will be read. | 3446| bufferSize | Buffer size. | 3447 3448**Returns** 3449 3450Returns **IMAGE_SUCCESS** if the operation is successful; returns **IMAGE_BAD_PARAMETER** if a parameter is incorrect; returns **IMAGE_UNSUPPORTED_OPERATION** if the operation is not supported; returns **IMAGE_UNKNOWN_ERROR** if an unknown error occurs. For details, see [Image_ErrorCode](#image_errorcode). 3451 3452 3453## Variable Description 3454 3455 3456### MIME_TYPE_BMP 3457 3458``` 3459static const char* MIME_TYPE_BMP = "image/bmp" 3460``` 3461 3462**Description** 3463 3464BMP image format. 3465 3466**Since**: 12 3467 3468 3469### MIME_TYPE_GIF 3470 3471``` 3472static const char* MIME_TYPE_GIF = "image/gif" 3473``` 3474 3475**Description** 3476 3477GIF image format. 3478 3479**Since**: 12 3480 3481 3482### MIME_TYPE_HEIC 3483 3484``` 3485static const char* MIME_TYPE_HEIC = "image/heic" 3486``` 3487 3488**Description** 3489 3490HEIF image format. 3491 3492**Since**: 12 3493 3494 3495### MIME_TYPE_ICON 3496 3497``` 3498static const char* MIME_TYPE_ICON = "image/x-icon" 3499``` 3500 3501**Description** 3502 3503ICO image format. 3504 3505**Since**: 12 3506 3507 3508### MIME_TYPE_JPEG 3509 3510``` 3511static const char* MIME_TYPE_JPEG = "image/jpeg" 3512``` 3513 3514**Description** 3515 3516JPEG image format. 3517 3518**Since**: 12 3519 3520 3521### MIME_TYPE_PNG 3522 3523``` 3524static const char* MIME_TYPE_PNG = "image/png" 3525``` 3526 3527**Description** 3528 3529PNG image format. 3530 3531**Since**: 12 3532 3533 3534### MIME_TYPE_WEBP 3535 3536``` 3537static const char* MIME_TYPE_WEBP = "image/webp" 3538``` 3539 3540**Description** 3541 3542WebP image format. 3543 3544**Since**: 12 3545 3546 3547### OHOS_IMAGE_PROPERTY_ARTIST 3548 3549``` 3550static const char* OHOS_IMAGE_PROPERTY_ARTIST = "Artist" 3551``` 3552 3553**Description** 3554 3555Person who created the image. 3556 3557**Since**: 12 3558 3559 3560### OHOS_IMAGE_PROPERTY_BITS_PER_SAMPLE 3561 3562``` 3563static const char* OHOS_IMAGE_PROPERTY_BITS_PER_SAMPLE = "BitsPerSample" 3564``` 3565 3566**Description** 3567 3568Number of bits per sample. 3569 3570**Since**: 12 3571 3572 3573### OHOS_IMAGE_PROPERTY_BODY_SERIAL_NUMBER 3574 3575``` 3576static const char* OHOS_IMAGE_PROPERTY_BODY_SERIAL_NUMBER = "BodySerialNumber" 3577``` 3578 3579**Description** 3580 3581Serial number of the camera body. 3582 3583**Since**: 12 3584 3585 3586### OHOS_IMAGE_PROPERTY_BRIGHTNESS_VALUE 3587 3588``` 3589static const char* OHOS_IMAGE_PROPERTY_BRIGHTNESS_VALUE = "BrightnessValue" 3590``` 3591 3592**Description** 3593 3594Value of brightness, expressed in APEX values. 3595 3596**Since**: 12 3597 3598 3599### OHOS_IMAGE_PROPERTY_BURST_NUMBER 3600 3601``` 3602static const char* OHOS_IMAGE_PROPERTY_BURST_NUMBER = "HwMnoteBurstNumber" 3603``` 3604 3605**Description** 3606 3607Number of burst shooting times. 3608 3609**Since**: 12 3610 3611 3612### OHOS_IMAGE_PROPERTY_CAMERA_OWNER_NAME 3613 3614``` 3615static const char* OHOS_IMAGE_PROPERTY_CAMERA_OWNER_NAME = "CameraOwnerName" 3616``` 3617 3618**Description** 3619 3620Name of the camera owner. 3621 3622**Since**: 12 3623 3624 3625### OHOS_IMAGE_PROPERTY_CFA_PATTERN 3626 3627``` 3628static const char* OHOS_IMAGE_PROPERTY_CFA_PATTERN = "CFAPattern" 3629``` 3630 3631**Description** 3632 3633Color Filter Array (CFA) geometric pattern of the image sensor. 3634 3635**Since**: 12 3636 3637 3638### OHOS_IMAGE_PROPERTY_COLOR_SPACE 3639 3640``` 3641static const char* OHOS_IMAGE_PROPERTY_COLOR_SPACE = "ColorSpace" 3642``` 3643 3644**Description** 3645 3646Color space information, which is usually recorded as a color space specifier. 3647 3648**Since**: 12 3649 3650 3651### OHOS_IMAGE_PROPERTY_COMPONENTS_CONFIGURATION 3652 3653``` 3654static const char* OHOS_IMAGE_PROPERTY_COMPONENTS_CONFIGURATION = "ComponentsConfiguration" 3655``` 3656 3657**Description** 3658 3659Specific information about compressed data. 3660 3661**Since**: 12 3662 3663 3664### OHOS_IMAGE_PROPERTY_COMPOSITE_IMAGE 3665 3666``` 3667static const char* OHOS_IMAGE_PROPERTY_COMPOSITE_IMAGE = "CompositeImage" 3668``` 3669 3670**Description** 3671 3672Whether the image is a composite image. 3673 3674**Since**: 12 3675 3676 3677### OHOS_IMAGE_PROPERTY_COMPRESSED_BITS_PER_PIXEL 3678 3679``` 3680static const char* OHOS_IMAGE_PROPERTY_COMPRESSED_BITS_PER_PIXEL = "CompressedBitsPerPixel" 3681``` 3682 3683**Description** 3684 3685Number of bits per pixel. It is specific to compressed data. 3686 3687**Since**: 12 3688 3689 3690### OHOS_IMAGE_PROPERTY_COMPRESSION 3691 3692``` 3693static const char* OHOS_IMAGE_PROPERTY_COMPRESSION = "Compression" 3694``` 3695 3696**Description** 3697 3698Compression scheme used on the image data. 3699 3700**Since**: 12 3701 3702 3703### OHOS_IMAGE_PROPERTY_CONTRAST 3704 3705``` 3706static const char* OHOS_IMAGE_PROPERTY_CONTRAST = "Contrast" 3707``` 3708 3709**Description** 3710 3711Direction of contrast processing used by the camera. 3712 3713**Since**: 12 3714 3715 3716### OHOS_IMAGE_PROPERTY_COPYRIGHT 3717 3718``` 3719static const char* OHOS_IMAGE_PROPERTY_COPYRIGHT = "Copyright" 3720``` 3721 3722**Description** 3723 3724Copyright notice of the image. 3725 3726**Since**: 12 3727 3728 3729### OHOS_IMAGE_PROPERTY_CUSTOM_RENDERED 3730 3731``` 3732static const char* OHOS_IMAGE_PROPERTY_CUSTOM_RENDERED = "CustomRendered" 3733``` 3734 3735**Description** 3736 3737Special processing on image data. 3738 3739**Since**: 12 3740 3741 3742### OHOS_IMAGE_PROPERTY_DATE_TIME_DIGITIZED 3743 3744``` 3745static const char* OHOS_IMAGE_PROPERTY_DATE_TIME_DIGITIZED = "DateTimeDigitized" 3746``` 3747 3748**Description** 3749 3750Date and time when the image was stored as digital data, in the format of YYYY:MM:DD HH:MM:SS. 3751 3752**Since**: 12 3753 3754 3755### OHOS_IMAGE_PROPERTY_DATE_TIME_ORIGINAL 3756 3757``` 3758static const char* OHOS_IMAGE_PROPERTY_DATE_TIME_ORIGINAL = "DateTimeOriginal" 3759``` 3760 3761**Description** 3762 3763Shooting time, for example, 2022:09:06 15:48:00. 3764 3765**Since**: 12 3766 3767 3768### OHOS_IMAGE_PROPERTY_DEFAULT_CROP_SIZE 3769 3770``` 3771static const char* OHOS_IMAGE_PROPERTY_DEFAULT_CROP_SIZE = "DefaultCropSize" 3772``` 3773 3774**Description** 3775 3776Size of the final image area, in raw image coordinates, taking into account extra pixels around the edges of the final image. 3777 3778**Since**: 12 3779 3780 3781### OHOS_IMAGE_PROPERTY_DEVICE_SETTING_DESCRIPTION 3782 3783``` 3784static const char* OHOS_IMAGE_PROPERTY_DEVICE_SETTING_DESCRIPTION = "DeviceSettingDescription" 3785``` 3786 3787**Description** 3788 3789Information about the photographing conditions of a specific camera model. 3790 3791**Since**: 12 3792 3793 3794### OHOS_IMAGE_PROPERTY_DIGITAL_ZOOM_RATIO 3795 3796``` 3797static const char* OHOS_IMAGE_PROPERTY_DIGITAL_ZOOM_RATIO = "DigitalZoomRatio" 3798``` 3799 3800**Description** 3801 3802Digital zoom ratio when the image was captured. 3803 3804**Since**: 12 3805 3806 3807### OHOS_IMAGE_PROPERTY_DNG_VERSION 3808 3809``` 3810static const char* OHOS_IMAGE_PROPERTY_DNG_VERSION = "DNGVersion" 3811``` 3812 3813**Description** 3814 3815DNG version. It encodes the DNG 4-tier version number. 3816 3817**Since**: 12 3818 3819 3820### OHOS_IMAGE_PROPERTY_EXIF_VERSION 3821 3822``` 3823static const char* OHOS_IMAGE_PROPERTY_EXIF_VERSION = "ExifVersion" 3824``` 3825 3826**Description** 3827 3828Version of the supported EXIF standard. 3829 3830**Since**: 12 3831 3832 3833### OHOS_IMAGE_PROPERTY_EXPOSURE_INDEX 3834 3835``` 3836static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_INDEX = "ExposureIndex" 3837``` 3838 3839**Description** 3840 3841Exposure index selected at the time the image is captured. 3842 3843**Since**: 12 3844 3845 3846### OHOS_IMAGE_PROPERTY_EXPOSURE_MODE 3847 3848``` 3849static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_MODE = "ExposureMode" 3850``` 3851 3852**Description** 3853 3854Exposure mode set when the image was captured. 3855 3856**Since**: 12 3857 3858 3859### OHOS_IMAGE_PROPERTY_EXPOSURE_PROGRAM 3860 3861``` 3862static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_PROGRAM = "ExposureProgram" 3863``` 3864 3865**Description** 3866 3867Class of the program used by the camera to set exposure when the image was captured. 3868 3869**Since**: 12 3870 3871 3872### OHOS_IMAGE_PROPERTY_EXPOSURE_TIME 3873 3874``` 3875static const char* OHOS_IMAGE_PROPERTY_EXPOSURE_TIME = "ExposureTime" 3876``` 3877 3878**Description** 3879 3880Exposure time, for example, 1/33 seconds. 3881 3882**Since**: 12 3883 3884 3885### OHOS_IMAGE_PROPERTY_F_NUMBER 3886 3887``` 3888static const char* OHOS_IMAGE_PROPERTY_F_NUMBER = "FNumber" 3889``` 3890 3891**Description** 3892 3893F number, for example, f/1.8. 3894 3895**Since**: 12 3896 3897 3898### OHOS_IMAGE_PROPERTY_FACE_CONF 3899 3900``` 3901static const char* OHOS_IMAGE_PROPERTY_FACE_CONF = "HwMnoteFaceConf" 3902``` 3903 3904**Description** 3905 3906Face confidence. 3907 3908**Since**: 12 3909 3910 3911### OHOS_IMAGE_PROPERTY_FACE_LEYE_CENTER 3912 3913``` 3914static const char* OHOS_IMAGE_PROPERTY_FACE_LEYE_CENTER = "HwMnoteFaceLeyeCenter" 3915``` 3916 3917**Description** 3918 3919Left eye centered. It is used in **OH_ImageSource_GetImageProperty** and **OH_ImageSource_ModifyImageProperty**. 3920 3921**Since**: 12 3922 3923 3924### OHOS_IMAGE_PROPERTY_FACE_MOUTH_CENTER 3925 3926``` 3927static const char* OHOS_IMAGE_PROPERTY_FACE_MOUTH_CENTER = "HwMnoteFaceMouthCenter" 3928``` 3929 3930**Description** 3931 3932Mouth centered. 3933 3934**Since**: 12 3935 3936 3937### OHOS_IMAGE_PROPERTY_FACE_POINTER 3938 3939``` 3940static const char* OHOS_IMAGE_PROPERTY_FACE_POINTER = "HwMnoteFacePointer" 3941``` 3942 3943**Description** 3944 3945Face pointer. 3946 3947**Since**: 12 3948 3949 3950### OHOS_IMAGE_PROPERTY_FACE_RECT 3951 3952``` 3953static const char* OHOS_IMAGE_PROPERTY_FACE_RECT = "HwMnoteFaceRect" 3954``` 3955 3956**Description** 3957 3958Face rectangle. 3959 3960**Since**: 12 3961 3962 3963### OHOS_IMAGE_PROPERTY_FACE_REYE_CENTER 3964 3965``` 3966static const char* OHOS_IMAGE_PROPERTY_FACE_REYE_CENTER = "HwMnoteFaceReyeCenter" 3967``` 3968 3969**Description** 3970 3971Right eye centered. 3972 3973**Since**: 12 3974 3975 3976### OHOS_IMAGE_PROPERTY_FACE_SMILE_SCORE 3977 3978``` 3979static const char* OHOS_IMAGE_PROPERTY_FACE_SMILE_SCORE = "HwMnoteFaceSmileScore" 3980``` 3981 3982**Description** 3983 3984Smile score of for faces. 3985 3986**Since**: 12 3987 3988 3989### OHOS_IMAGE_PROPERTY_FACE_VERSION 3990 3991``` 3992static const char* OHOS_IMAGE_PROPERTY_FACE_VERSION = "HwMnoteFaceVersion" 3993``` 3994 3995**Description** 3996 3997Facial recognition algorithm version. 3998 3999**Since**: 12 4000 4001 4002### OHOS_IMAGE_PROPERTY_FILE_SOURCE 4003 4004``` 4005static const char* OHOS_IMAGE_PROPERTY_FILE_SOURCE = "FileSource" 4006``` 4007 4008**Description** 4009 4010Image source. 4011 4012**Since**: 12 4013 4014 4015### OHOS_IMAGE_PROPERTY_FLASH_ENERGY 4016 4017``` 4018static const char* OHOS_IMAGE_PROPERTY_FLASH_ENERGY = "FlashEnergy" 4019``` 4020 4021**Description** 4022 4023Strobe energy at the time the image was captured, in Beam Candle Power Seconds (BCPS). 4024 4025**Since**: 12 4026 4027 4028### OHOS_IMAGE_PROPERTY_FLASHPIX_VERSION 4029 4030``` 4031static const char* OHOS_IMAGE_PROPERTY_FLASHPIX_VERSION = "FlashpixVersion" 4032``` 4033 4034**Description** 4035 4036FlashPix format version supported by an FPXR file. It is used to enhance device compatibility. 4037 4038**Since**: 12 4039 4040 4041### OHOS_IMAGE_PROPERTY_FOCAL_PLANE_RESOLUTION_UNIT 4042 4043``` 4044static const char* OHOS_IMAGE_PROPERTY_FOCAL_PLANE_RESOLUTION_UNIT = "FocalPlaneResolutionUnit" 4045``` 4046 4047**Description** 4048 4049Unit for measuring FocalPlaneXResolution and FocalPlaneYResolution. 4050 4051**Since**: 12 4052 4053 4054### OHOS_IMAGE_PROPERTY_FOCAL_PLANE_X_RESOLUTION 4055 4056``` 4057static const char* OHOS_IMAGE_PROPERTY_FOCAL_PLANE_X_RESOLUTION = "FocalPlaneXResolution" 4058``` 4059 4060**Description** 4061 4062Number of pixels in the image width (X) direction per FocalPlaneResolutionUnit. 4063 4064**Since**: 12 4065 4066 4067### OHOS_IMAGE_PROPERTY_FOCAL_PLANE_Y_RESOLUTION 4068 4069``` 4070static const char* OHOS_IMAGE_PROPERTY_FOCAL_PLANE_Y_RESOLUTION = "FocalPlaneYResolution" 4071``` 4072 4073**Description** 4074 4075Number of pixels in the image height (Y) direction per FocalPlaneResolutionUnit. 4076 4077**Since**: 12 4078 4079 4080### OHOS_IMAGE_PROPERTY_FRONT_CAMERA 4081 4082``` 4083static const char* OHOS_IMAGE_PROPERTY_FRONT_CAMERA = "HwMnoteFrontCamera" 4084``` 4085 4086**Description** 4087 4088Whether the front camera is used to take a selfie. 4089 4090**Since**: 12 4091 4092 4093### OHOS_IMAGE_PROPERTY_GAIN_CONTROL 4094 4095``` 4096static const char* OHOS_IMAGE_PROPERTY_GAIN_CONTROL = "GainControl" 4097``` 4098 4099**Description** 4100 4101Degree of overall image gain adjustment. 4102 4103**Since**: 12 4104 4105 4106### OHOS_IMAGE_PROPERTY_GAMMA 4107 4108``` 4109static const char* OHOS_IMAGE_PROPERTY_GAMMA = "Gamma" 4110``` 4111 4112**Description** 4113 4114Gamma value. 4115 4116**Since**: 12 4117 4118 4119### OHOS_IMAGE_PROPERTY_GIF_LOOP_COUNT 4120 4121``` 4122static const char* OHOS_IMAGE_PROPERTY_GIF_LOOP_COUNT = "GIFLoopCount" 4123``` 4124 4125**Description** 4126 4127Number of GIF loops. 4128 4129**Since**: 12 4130 4131 4132### OHOS_IMAGE_PROPERTY_GPS_ALTITUDE 4133 4134``` 4135static const char* OHOS_IMAGE_PROPERTY_GPS_ALTITUDE = "GPSAltitude" 4136``` 4137 4138**Description** 4139 4140Altitude based on the reference in GPSAltitudeRef. 4141 4142**Since**: 12 4143 4144 4145### OHOS_IMAGE_PROPERTY_GPS_ALTITUDE_REF 4146 4147``` 4148static const char* OHOS_IMAGE_PROPERTY_GPS_ALTITUDE_REF = "GPSAltitudeRef" 4149``` 4150 4151**Description** 4152 4153Whether the latitude is north or south latitude. 4154 4155**Since**: 12 4156 4157 4158### OHOS_IMAGE_PROPERTY_GPS_AREA_INFORMATION 4159 4160``` 4161static const char* OHOS_IMAGE_PROPERTY_GPS_AREA_INFORMATION = "GPSAreaInformation" 4162``` 4163 4164**Description** 4165 4166String that records the name of the GPS area. 4167 4168**Since**: 12 4169 4170 4171### OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING 4172 4173``` 4174static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING = "GPSDestBearing" 4175``` 4176 4177**Description** 4178 4179Bearing to the destination point. 4180 4181**Since**: 12 4182 4183 4184### OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING_REF 4185 4186``` 4187static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_BEARING_REF = "GPSDestBearingRef" 4188``` 4189 4190**Description** 4191 4192Reference of the bearing to the destination point. 4193 4194**Since**: 12 4195 4196 4197### OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE 4198 4199``` 4200static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE = "GPSDestDistance" 4201``` 4202 4203**Description** 4204 4205Distance to the destination point. 4206 4207**Since**: 12 4208 4209 4210### OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE_REF 4211 4212``` 4213static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_DISTANCE_REF = "GPSDestDistanceRef" 4214``` 4215 4216**Description** 4217 4218Unit used to express the distance to the destination point. 4219 4220**Since**: 12 4221 4222 4223### OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE 4224 4225``` 4226static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE = "GPSDestLatitude" 4227``` 4228 4229**Description** 4230 4231Latitude of the destination point. 4232 4233**Since**: 12 4234 4235 4236### OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE_REF 4237 4238``` 4239static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LATITUDE_REF = "GPSDestLatitudeRef" 4240``` 4241 4242**Description** 4243 4244Whether the latitude of the destination point is north or south latitude. 4245 4246**Since**: 12 4247 4248 4249### OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE 4250 4251``` 4252static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE = "GPSDestLongitude" 4253``` 4254 4255**Description** 4256 4257Longitude of the destination point. 4258 4259**Since**: 12 4260 4261 4262### OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE_REF 4263 4264``` 4265static const char* OHOS_IMAGE_PROPERTY_GPS_DEST_LONGITUDE_REF = "GPSDestLongitudeRef" 4266``` 4267 4268**Description** 4269 4270Whether the longitude of the destination point is east or west longitude. 4271 4272**Since**: 12 4273 4274 4275### OHOS_IMAGE_PROPERTY_GPS_DIFFERENTIAL 4276 4277``` 4278static const char* OHOS_IMAGE_PROPERTY_GPS_DIFFERENTIAL = "GPSDifferential" 4279``` 4280 4281**Description** 4282 4283Whether differential correction is applied to the GPS receiver. It is critical to accurate location accuracy. 4284 4285**Since**: 12 4286 4287 4288### OHOS_IMAGE_PROPERTY_GPS_DOP 4289 4290``` 4291static const char* OHOS_IMAGE_PROPERTY_GPS_DOP = "GPSDOP" 4292``` 4293 4294**Description** 4295 4296GPS DOP (data degree of precision) 4297 4298**Since**: 12 4299 4300 4301### OHOS_IMAGE_PROPERTY_GPS_H_POSITIONING_ERROR 4302 4303``` 4304static const char* OHOS_IMAGE_PROPERTY_GPS_H_POSITIONING_ERROR = "GPSHPositioningError" 4305``` 4306 4307**Description** 4308 4309Horizontal positioning error, in meters. 4310 4311**Since**: 12 4312 4313 4314### OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION 4315 4316``` 4317static const char* OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION = "GPSImgDirection" 4318``` 4319 4320**Description** 4321 4322Direction of the image when it was captured. 4323 4324**Since**: 12 4325 4326 4327### OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION_REF 4328 4329``` 4330static const char* OHOS_IMAGE_PROPERTY_GPS_IMG_DIRECTION_REF = "GPSImgDirectionRef" 4331``` 4332 4333**Description** 4334 4335Reference of the direction of the image when it was captured. 4336 4337**Since**: 12 4338 4339 4340### OHOS_IMAGE_PROPERTY_GPS_LATITUDE 4341 4342``` 4343static const char* OHOS_IMAGE_PROPERTY_GPS_LATITUDE = "GPSLatitude" 4344``` 4345 4346**Description** 4347 4348Image latitude. 4349 4350**Since**: 12 4351 4352 4353### OHOS_IMAGE_PROPERTY_GPS_LATITUDE_REF 4354 4355``` 4356static const char* OHOS_IMAGE_PROPERTY_GPS_LATITUDE_REF = "GPSLatitudeRef" 4357``` 4358 4359**Description** 4360 4361Whether the latitude is north or south latitude. 4362 4363**Since**: 12 4364 4365 4366### OHOS_IMAGE_PROPERTY_GPS_LONGITUDE 4367 4368``` 4369static const char* OHOS_IMAGE_PROPERTY_GPS_LONGITUDE = "GPSLongitude" 4370``` 4371 4372**Description** 4373 4374Image longitude. 4375 4376**Since**: 12 4377 4378 4379### OHOS_IMAGE_PROPERTY_GPS_LONGITUDE_REF 4380 4381``` 4382static const char* OHOS_IMAGE_PROPERTY_GPS_LONGITUDE_REF = "GPSLongitudeRef" 4383``` 4384 4385**Description** 4386 4387Whether the longitude is east or west longitude. 4388 4389**Since**: 12 4390 4391 4392### OHOS_IMAGE_PROPERTY_GPS_MAP_DATUM 4393 4394``` 4395static const char* OHOS_IMAGE_PROPERTY_GPS_MAP_DATUM = "GPSMapDatum" 4396``` 4397 4398**Description** 4399 4400Geodetic survey data used by the GPS receiver. 4401 4402**Since**: 12 4403 4404 4405### OHOS_IMAGE_PROPERTY_GPS_MEASURE_MODE 4406 4407``` 4408static const char* OHOS_IMAGE_PROPERTY_GPS_MEASURE_MODE = "GPSMeasureMode" 4409``` 4410 4411**Description** 4412 4413GPS measurement pmode. 4414 4415**Since**: 12 4416 4417 4418### OHOS_IMAGE_PROPERTY_GPS_PROCESSING_METHOD 4419 4420``` 4421static const char* OHOS_IMAGE_PROPERTY_GPS_PROCESSING_METHOD = "GPSProcessingMethod" 4422``` 4423 4424**Description** 4425 4426String that records the name of the method used for positioning. 4427 4428**Since**: 12 4429 4430 4431### OHOS_IMAGE_PROPERTY_GPS_SATELLITES 4432 4433``` 4434static const char* OHOS_IMAGE_PROPERTY_GPS_SATELLITES = "GPSSatellites" 4435``` 4436 4437**Description** 4438 4439GPS satellites used for measurement. 4440 4441**Since**: 12 4442 4443 4444### OHOS_IMAGE_PROPERTY_GPS_SPEED 4445 4446``` 4447static const char* OHOS_IMAGE_PROPERTY_GPS_SPEED = "GPSSpeed" 4448``` 4449 4450**Description** 4451 4452Movement speed of the GPS receiver. 4453 4454**Since**: 12 4455 4456 4457### OHOS_IMAGE_PROPERTY_GPS_SPEED_REF 4458 4459``` 4460static const char* OHOS_IMAGE_PROPERTY_GPS_SPEED_REF = "GPSSpeedRef" 4461``` 4462 4463**Description** 4464 4465Unit used to express the movement speed of the GPS receiver. 4466 4467**Since**: 12 4468 4469 4470### OHOS_IMAGE_PROPERTY_GPS_STATUS 4471 4472``` 4473static const char* OHOS_IMAGE_PROPERTY_GPS_STATUS = "GPSStatus" 4474``` 4475 4476**Description** 4477 4478Status of the GPS receiver when the image was recorded. 4479 4480**Since**: 12 4481 4482 4483### OHOS_IMAGE_PROPERTY_GPS_TRACK 4484 4485``` 4486static const char* OHOS_IMAGE_PROPERTY_GPS_TRACK = "GPSTrack" 4487``` 4488 4489**Description** 4490 4491Movement direction of the GPS receiver. 4492 4493**Since**: 12 4494 4495 4496### OHOS_IMAGE_PROPERTY_GPS_TRACK_REF 4497 4498``` 4499static const char* OHOS_IMAGE_PROPERTY_GPS_TRACK_REF = "GPSTrackRef" 4500``` 4501 4502**Description** 4503 4504Reference of the movement direction of the GPS receiver. 4505 4506**Since**: 12 4507 4508 4509### OHOS_IMAGE_PROPERTY_GPS_VERSION_ID 4510 4511``` 4512static const char* OHOS_IMAGE_PROPERTY_GPS_VERSION_ID = "GPSVersionID" 4513``` 4514 4515**Description** 4516 4517Version of GPSInfoIFD. 4518 4519**Since**: 12 4520 4521 4522### OHOS_IMAGE_PROPERTY_IMAGE_LENGTH 4523 4524``` 4525static const char* OHOS_IMAGE_PROPERTY_IMAGE_LENGTH = "ImageLength" 4526``` 4527 4528**Description** 4529 4530Image length. 4531 4532**Since**: 12 4533 4534 4535### OHOS_IMAGE_PROPERTY_IMAGE_UNIQUE_ID 4536 4537``` 4538static const char* OHOS_IMAGE_PROPERTY_IMAGE_UNIQUE_ID = "ImageUniqueID" 4539``` 4540 4541**Description** 4542 4543Unique identifier assigned to each image. 4544 4545**Since**: 12 4546 4547 4548### OHOS_IMAGE_PROPERTY_IMAGE_WIDTH 4549 4550``` 4551static const char* OHOS_IMAGE_PROPERTY_IMAGE_WIDTH = "ImageWidth" 4552``` 4553 4554**Description** 4555 4556Image width. 4557 4558**Since**: 12 4559 4560 4561### OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEYYY 4562 4563``` 4564static const char* OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEYYY = "ISOSpeedLatitudeyyy" 4565``` 4566 4567**Description** 4568 4569ISO speed latitude yyy value of the camera or input device, which is defined in ISO 12232. 4570 4571**Since**: 12 4572 4573 4574### OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEZZZ 4575 4576``` 4577static const char* OHOS_IMAGE_PROPERTY_ISO_SPEED_LATITUDEZZZ = "ISOSpeedLatitudezzz" 4578``` 4579 4580**Description** 4581 4582ISO speed latitude zzz value of the camera or input device, which is defined in ISO 12232. 4583 4584**Since**: 12 4585 4586 4587### OHOS_IMAGE_PROPERTY_ISO_SPEED_RATINGS 4588 4589``` 4590static const char* OHOS_IMAGE_PROPERTY_ISO_SPEED_RATINGS = "ISOSpeedRatings" 4591``` 4592 4593**Description** 4594 4595ISO sensitivity or ISO speed, for example, 400. 4596 4597**Since**: 12 4598 4599 4600### OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT 4601 4602``` 4603static const char* OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT = "JPEGInterchangeFormat" 4604``` 4605 4606**Description** 4607 4608Offset of the SOI marker of a JPEG interchange format bitstream. 4609 4610**Since**: 12 4611 4612 4613### OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT_LENGTH 4614 4615``` 4616static const char* OHOS_IMAGE_PROPERTY_JPEG_INTERCHANGE_FORMAT_LENGTH = "JPEGInterchangeFormatLength" 4617``` 4618 4619**Description** 4620 4621Number of bytes of the JPEG stream. 4622 4623**Since**: 12 4624 4625 4626### OHOS_IMAGE_PROPERTY_LENS_MAKE 4627 4628``` 4629static const char* OHOS_IMAGE_PROPERTY_LENS_MAKE = "LensMake" 4630``` 4631 4632**Description** 4633 4634Manufacturer of the lens. 4635 4636**Since**: 12 4637 4638 4639### OHOS_IMAGE_PROPERTY_LENS_MODEL 4640 4641``` 4642static const char* OHOS_IMAGE_PROPERTY_LENS_MODEL = "LensModel" 4643``` 4644 4645**Description** 4646 4647Model of the lens. 4648 4649**Since**: 12 4650 4651 4652### OHOS_IMAGE_PROPERTY_LENS_SERIAL_NUMBER 4653 4654``` 4655static const char* OHOS_IMAGE_PROPERTY_LENS_SERIAL_NUMBER = "LensSerialNumber" 4656``` 4657 4658**Description** 4659 4660Serial number of the lens. 4661 4662**Since**: 12 4663 4664 4665### OHOS_IMAGE_PROPERTY_LENS_SPECIFICATION 4666 4667``` 4668static const char* OHOS_IMAGE_PROPERTY_LENS_SPECIFICATION = "LensSpecification" 4669``` 4670 4671**Description** 4672 4673Specifications of the lens. 4674 4675**Since**: 12 4676 4677 4678### OHOS_IMAGE_PROPERTY_MAKER_NOTE 4679 4680``` 4681static const char* OHOS_IMAGE_PROPERTY_MAKER_NOTE = "MakerNote" 4682``` 4683 4684**Description** 4685 4686Marker used by EXIF/DCF manufacturers to record any required information. 4687 4688**Since**: 12 4689 4690 4691### OHOS_IMAGE_PROPERTY_MAX_APERTURE_VALUE 4692 4693``` 4694static const char* OHOS_IMAGE_PROPERTY_MAX_APERTURE_VALUE = "MaxApertureValue" 4695``` 4696 4697**Description** 4698 4699Smallest F number of the lens. 4700 4701**Since**: 12 4702 4703 4704### OHOS_IMAGE_PROPERTY_NEW_SUBFILE_TYPE 4705 4706``` 4707static const char* OHOS_IMAGE_PROPERTY_NEW_SUBFILE_TYPE = "NewSubfileType" 4708``` 4709 4710**Description** 4711 4712Data type of a subfile, such as a full-resolution image, a thumbnail, or a part of a multi-frame image. The value is a bit mask. The value 0 indicates a full-resolution image, **1** indicates a thumbnail, and **2** indicates a part of a multi-frame image. 4713 4714**Since**: 12 4715 4716 4717### OHOS_IMAGE_PROPERTY_OECF 4718 4719``` 4720static const char* OHOS_IMAGE_PROPERTY_OECF = "OECF" 4721``` 4722 4723**Description** 4724 4725Opto-Electric Conversion Function (OECF) specified in ISO 14524. 4726 4727**Since**: 12 4728 4729 4730### OHOS_IMAGE_PROPERTY_OFFSET_TIME 4731 4732``` 4733static const char* OHOS_IMAGE_PROPERTY_OFFSET_TIME = "OffsetTime" 4734``` 4735 4736**Description** 4737 4738Time with an offset from UTC when the image was captured, in the format of ±HH:MM. 4739 4740**Since**: 12 4741 4742 4743### OHOS_IMAGE_PROPERTY_OFFSET_TIME_DIGITIZED 4744 4745``` 4746static const char* OHOS_IMAGE_PROPERTY_OFFSET_TIME_DIGITIZED = "OffsetTimeDigitized" 4747``` 4748 4749**Description** 4750 4751Time with an offset from UTC when the image was digitized. It helps to accurately adjust the timestamp. 4752 4753**Since**: 12 4754 4755 4756### OHOS_IMAGE_PROPERTY_OFFSET_TIME_ORIGINAL 4757 4758``` 4759static const char* OHOS_IMAGE_PROPERTY_OFFSET_TIME_ORIGINAL = "OffsetTimeOriginal" 4760``` 4761 4762**Description** 4763 4764Time with an offset from UTC when the original image was created. It is critical for time-sensitive applications. 4765 4766**Since**: 12 4767 4768 4769### OHOS_IMAGE_PROPERTY_ORIENTATION 4770 4771``` 4772static const char* OHOS_IMAGE_PROPERTY_ORIENTATION = "Orientation" 4773``` 4774 4775**Description** 4776 4777Image orientation. 4778 4779**Since**: 12 4780 4781 4782### OHOS_IMAGE_PROPERTY_PHOTOGRAPHIC_SENSITIVITY 4783 4784``` 4785static const char* OHOS_IMAGE_PROPERTY_PHOTOGRAPHIC_SENSITIVITY = "PhotographicSensitivity" 4786``` 4787 4788**Description** 4789 4790Sensitivity of the camera or input device when the image was captured. 4791 4792**Since**: 12 4793 4794 4795### OHOS_IMAGE_PROPERTY_PHOTOMETRIC_INTERPRETATION 4796 4797``` 4798static const char* OHOS_IMAGE_PROPERTY_PHOTOMETRIC_INTERPRETATION = "PhotometricInterpretation" 4799``` 4800 4801**Description** 4802 4803Color space of the image data, for example, RGB or YCbCr. 4804 4805**Since**: 12 4806 4807 4808### OHOS_IMAGE_PROPERTY_PLANAR_CONFIGURATION 4809 4810``` 4811const char* OHOS_IMAGE_PROPERTY_PLANAR_CONFIGURATION = "PlanarConfiguration" 4812``` 4813 4814**Description** 4815 4816Storage format of components of each pixel, which can be chunky or planar. 4817 4818**Since**: 12 4819 4820 4821### OHOS_IMAGE_PROPERTY_PRIMARY_CHROMATICITIES 4822 4823``` 4824static const char* OHOS_IMAGE_PROPERTY_PRIMARY_CHROMATICITIES = "PrimaryChromaticities" 4825``` 4826 4827**Description** 4828 4829Chromaticities of the primaries of the image. 4830 4831**Since**: 12 4832 4833 4834### OHOS_IMAGE_PROPERTY_REFERENCE_BLACK_WHITE 4835 4836``` 4837static const char* OHOS_IMAGE_PROPERTY_REFERENCE_BLACK_WHITE = "ReferenceBlackWhite" 4838``` 4839 4840**Description** 4841 4842A pair of headroom and footroom image data values (codes) for each pixel component. 4843 4844**Since**: 12 4845 4846 4847### OHOS_IMAGE_PROPERTY_RELATED_SOUND_FILE 4848 4849``` 4850static const char* OHOS_IMAGE_PROPERTY_RELATED_SOUND_FILE = "RelatedSoundFile" 4851``` 4852 4853**Description** 4854 4855Name of an audio file related to the image data. 4856 4857**Since**: 12 4858 4859 4860### OHOS_IMAGE_PROPERTY_RESOLUTION_UNIT 4861 4862``` 4863static const char* OHOS_IMAGE_PROPERTY_RESOLUTION_UNIT = "ResolutionUnit" 4864``` 4865 4866**Description** 4867 4868Unit of measurement for XResolution and YResolution. 4869 4870**Since**: 12 4871 4872 4873### OHOS_IMAGE_PROPERTY_ROWS_PER_STRIP 4874 4875``` 4876static const char* OHOS_IMAGE_PROPERTY_ROWS_PER_STRIP = "RowsPerStrip" 4877``` 4878 4879**Description** 4880 4881Number of rows per strip. 4882 4883**Since**: 12 4884 4885 4886### OHOS_IMAGE_PROPERTY_SAMPLES_PER_PIXEL 4887 4888``` 4889static const char* OHOS_IMAGE_PROPERTY_SAMPLES_PER_PIXEL = "SamplesPerPixel" 4890``` 4891 4892**Description** 4893 4894Number of components per pixel. The value is **3** for RGB and YCbCr images. The **JPEG** key is used in JPEG compressed data. 4895 4896**Since**: 12 4897 4898 4899### OHOS_IMAGE_PROPERTY_SATURATION 4900 4901``` 4902static const char* OHOS_IMAGE_PROPERTY_SATURATION = "Saturation" 4903``` 4904 4905**Description** 4906 4907Direction of saturation processing used by the camera. 4908 4909**Since**: 12 4910 4911 4912### OHOS_IMAGE_PROPERTY_SCENE_CAPTURE_TYPE 4913 4914``` 4915static const char* OHOS_IMAGE_PROPERTY_SCENE_CAPTURE_TYPE = "SceneCaptureType" 4916``` 4917 4918**Description** 4919 4920Type of the scene that was captured. 4921 4922**Since**: 12 4923 4924 4925### OHOS_IMAGE_PROPERTY_SCENE_POINTER 4926 4927``` 4928static const char* OHOS_IMAGE_PROPERTY_SCENE_POINTER = "HwMnoteScenePointer" 4929``` 4930 4931**Description** 4932 4933Pointer to the scene. 4934 4935**Since**: 12 4936 4937 4938### OHOS_IMAGE_PROPERTY_SCENE_TYPE 4939 4940``` 4941static const char* OHOS_IMAGE_PROPERTY_SCENE_TYPE = "SceneType" 4942``` 4943 4944**Description** 4945 4946Type of the scene, for example, portrait, scenery, motion, and night. 4947 4948**Since**: 12 4949 4950 4951### OHOS_IMAGE_PROPERTY_SCENE_VERSION 4952 4953``` 4954static const char* OHOS_IMAGE_PROPERTY_SCENE_VERSION = "HwMnoteSceneVersion" 4955``` 4956 4957**Description** 4958 4959Scene algorithm version. 4960 4961**Since**: 12 4962 4963 4964### OHOS_IMAGE_PROPERTY_SENSING_METHOD 4965 4966``` 4967static const char* OHOS_IMAGE_PROPERTY_SENSING_METHOD = "SensingMethod" 4968``` 4969 4970**Description** 4971 4972Type of the image sensor on the camera. 4973 4974**Since**: 12 4975 4976 4977### OHOS_IMAGE_PROPERTY_SHARPNESS 4978 4979``` 4980static const char* OHOS_IMAGE_PROPERTY_SHARPNESS = "Sharpness" 4981``` 4982 4983**Description** 4984 4985Direction of sharpness processing used by the camera. 4986 4987**Since**: 12 4988 4989 4990### OHOS_IMAGE_PROPERTY_SHUTTER_SPEED_VALUE 4991 4992``` 4993static const char* OHOS_IMAGE_PROPERTY_SHUTTER_SPEED_VALUE = "ShutterSpeedValue" 4994``` 4995 4996**Description** 4997 4998Shutter speed, expressed in Additive System of Photographic Exposure (APEX) values. 4999 5000**Since**: 12 5001 5002 5003### OHOS_IMAGE_PROPERTY_SOFTWARE 5004 5005``` 5006static const char* OHOS_IMAGE_PROPERTY_SOFTWARE = "Software" 5007``` 5008 5009**Description** 5010 5011Name and version number of the software used to create the image. 5012 5013**Since**: 12 5014 5015 5016### OHOS_IMAGE_PROPERTY_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE 5017 5018``` 5019static const char* OHOS_IMAGE_PROPERTY_SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE = "SourceExposureTimesOfCompositeImage" 5020``` 5021 5022**Description** 5023 5024Exposure time of source images of the composite image. 5025 5026**Since**: 12 5027 5028 5029### OHOS_IMAGE_PROPERTY_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE 5030 5031``` 5032static const char* OHOS_IMAGE_PROPERTY_SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE = "SourceImageNumberOfCompositeImage" 5033``` 5034 5035**Description** 5036 5037Number of source images of the composite image. 5038 5039**Since**: 12 5040 5041 5042### OHOS_IMAGE_PROPERTY_SPATIAL_FREQUENCY_RESPONSE 5043 5044``` 5045static const char* OHOS_IMAGE_PROPERTY_SPATIAL_FREQUENCY_RESPONSE = "SpatialFrequencyResponse" 5046``` 5047 5048**Description** 5049 5050Spatial frequency table of the camera or input device. 5051 5052**Since**: 12 5053 5054 5055### OHOS_IMAGE_PROPERTY_SPECTRAL_SENSITIVITY 5056 5057``` 5058static const char* OHOS_IMAGE_PROPERTY_SPECTRAL_SENSITIVITY = "SpectralSensitivity" 5059``` 5060 5061**Description** 5062 5063Spectral sensitivity of each channel of the camera. 5064 5065**Since**: 12 5066 5067 5068### OHOS_IMAGE_PROPERTY_STRIP_BYTE_COUNTS 5069 5070``` 5071static const char* OHOS_IMAGE_PROPERTY_STRIP_BYTE_COUNTS = "StripByteCounts" 5072``` 5073 5074**Description** 5075 5076Number of bytes in each strip after compression. 5077 5078**Since**: 12 5079 5080 5081### OHOS_IMAGE_PROPERTY_STRIP_OFFSETS 5082 5083``` 5084static const char* OHOS_IMAGE_PROPERTY_STRIP_OFFSETS = "StripOffsets" 5085``` 5086 5087**Description** 5088 5089Byte offset of each strip. 5090 5091**Since**: 12 5092 5093 5094### OHOS_IMAGE_PROPERTY_SUBFILE_TYPE 5095 5096``` 5097static const char* OHOS_IMAGE_PROPERTY_SUBFILE_TYPE = "SubfileType" 5098``` 5099 5100**Description** 5101 5102Type of data contained in this subfile. This tag has been deprecated. Use **NewSubfileType** instead. 5103 5104**Since**: 12 5105 5106 5107### OHOS_IMAGE_PROPERTY_SUBJECT_AREA 5108 5109``` 5110static const char* OHOS_IMAGE_PROPERTY_SUBJECT_AREA = "SubjectArea" 5111``` 5112 5113**Description** 5114 5115Location and area of the main subject in the entire scene. 5116 5117**Since**: 12 5118 5119 5120### OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE 5121 5122``` 5123static const char* OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE = "SubjectDistance" 5124``` 5125 5126**Description** 5127 5128Distance to the subject, in meters. 5129 5130**Since**: 12 5131 5132 5133### OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE_RANGE 5134 5135``` 5136static const char* OHOS_IMAGE_PROPERTY_SUBJECT_DISTANCE_RANGE = "SubjectDistanceRange" 5137``` 5138 5139**Description** 5140 5141Distance to the subject. 5142 5143**Since**: 12 5144 5145 5146### OHOS_IMAGE_PROPERTY_SUBJECT_LOCATION 5147 5148``` 5149static const char* OHOS_IMAGE_PROPERTY_SUBJECT_LOCATION = "SubjectLocation" 5150``` 5151 5152**Description** 5153 5154Location of the main subject relative to the left edge. 5155 5156**Since**: 12 5157 5158 5159### OHOS_IMAGE_PROPERTY_SUBSEC_TIME 5160 5161``` 5162static const char* OHOS_IMAGE_PROPERTY_SUBSEC_TIME = "SubsecTime" 5163``` 5164 5165**Description** 5166 5167Tag used to record fractions of seconds for the **DateTime** tag. 5168 5169**Since**: 12 5170 5171 5172### OHOS_IMAGE_PROPERTY_SUBSEC_TIME_DIGITIZED 5173 5174``` 5175static const char* OHOS_IMAGE_PROPERTY_SUBSEC_TIME_DIGITIZED = "SubsecTimeDigitized" 5176``` 5177 5178**Description** 5179 5180Tag used to record fractions of seconds for the **DateTimeDigitized** tag. 5181 5182**Since**: 12 5183 5184 5185### OHOS_IMAGE_PROPERTY_SUBSEC_TIME_ORIGINAL 5186 5187``` 5188static const char* OHOS_IMAGE_PROPERTY_SUBSEC_TIME_ORIGINAL = "SubsecTimeOriginal" 5189``` 5190 5191**Description** 5192 5193Tag used to record fractions of seconds for the **DateTimeOriginal** tag. 5194 5195**Since**: 12 5196 5197 5198### OHOS_IMAGE_PROPERTY_TRANSFER_FUNCTION 5199 5200``` 5201static const char* OHOS_IMAGE_PROPERTY_TRANSFER_FUNCTION = "TransferFunction" 5202``` 5203 5204**Description** 5205 5206Transfer function for the image, which is usually used for color correction. 5207 5208**Since**: 12 5209 5210 5211### OHOS_IMAGE_PROPERTY_WHITE_POINT 5212 5213``` 5214static const char* OHOS_IMAGE_PROPERTY_WHITE_POINT = "WhitePoint" 5215``` 5216 5217**Description** 5218 5219Chromaticity of the white point of the image. 5220 5221**Since**: 12 5222 5223 5224### OHOS_IMAGE_PROPERTY_X_RESOLUTION 5225 5226``` 5227static const char* OHOS_IMAGE_PROPERTY_X_RESOLUTION = "XResolution" 5228``` 5229 5230**Description** 5231 5232Number of pixels per ResolutionUnit in the image width (X) direction. 5233 5234**Since**: 12 5235 5236 5237### OHOS_IMAGE_PROPERTY_Y_RESOLUTION 5238 5239``` 5240static const char* OHOS_IMAGE_PROPERTY_Y_RESOLUTION = "YResolution" 5241``` 5242 5243**Description** 5244 5245Number of pixels per ResolutionUnit in the image height (Y) direction. 5246 5247**Since**: 12 5248 5249 5250### OHOS_IMAGE_PROPERTY_YCBCR_COEFFICIENTS 5251 5252``` 5253static const char* OHOS_IMAGE_PROPERTY_YCBCR_COEFFICIENTS = "YCbCrCoefficients" 5254``` 5255 5256**Description** 5257 5258Transformation from RGB to YCbCr image data. 5259 5260**Since**: 12 5261 5262 5263### OHOS_IMAGE_PROPERTY_YCBCR_POSITIONING 5264 5265``` 5266static const char* OHOS_IMAGE_PROPERTY_YCBCR_POSITIONING = "YCbCrPositioning" 5267``` 5268 5269**Description** 5270 5271Positioning of subsampled chrominance components relative to luminance samples. 5272 5273**Since**: 12 5274 5275 5276### OHOS_IMAGE_PROPERTY_YCBCR_SUB_SAMPLING 5277 5278``` 5279static const char* OHOS_IMAGE_PROPERTY_YCBCR_SUB_SAMPLING = "YCbCrSubSampling" 5280``` 5281 5282**Description** 5283 5284Subsampling factors used for the chrominance components of a YCbCr image. 5285 5286**Since**: 12 5287