# Enums
> **NOTE**
>
> The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
## PixelMapFormat7+
Enumerates the pixel formats of images.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ---------------------- | ------ | ----------------- |
| UNKNOWN | 0 | Unknown format.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| ARGB_888818+ | 1 | The color information consists of four components: alpha, R (Red), G (Green), and B (Blue). Each component occupies 8 bits, and the total length is 32 bits. Currently, this format supports only PixelMap APIs.|
| RGB_565 | 2 | The color information consists of three components: R (Red), G (Green), and B (Blue), which occupies five bits, six bits, and five bits, respectively. The total length is 16 bits.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| RGBA_8888 | 3 | The color information consists of four components: R (Red), G (Green), B (Blue), and alpha. Each component occupies 8 bits, and the total length is 32 bits. It corresponds to [CAMERA_FORMAT_RGBA_8888 in CameraFormat](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat).
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12.|
| BGRA_88889+ | 4 | The color information consists of four components: B (Blue), G (Green), R (Red), and alpha. Each component occupies 8 bits, and the total length is 32 bits.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12.|
| RGB_8889+ | 5 | The color information consists of three components: R (Red), G (Green), and B (Blue). Each component occupies 8 bits, and the total length is 24 bits.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| ALPHA_89+ | 6 | The color information consists of only the alpha component, which occupies eight bits.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| RGBA_F169+ | 7 | The color information consists of four components: R (Red), G (Green), B (Blue), and alpha. Each component occupies 16 bits, and the total length is 64 bits.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| NV219+ | 8 | YVU pixel arrangement, where the V component precedes the U component. The color information consists of the luminance component Y and the interleaved chrominance components V and U. The Y component occupies 8 bits, and the UV components occupy 4 bits on average due to 4:2:0 sampling. The total length is 12 bits on average.
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| NV129+ | 9 | YUV pixel arrangement, where the U component precedes the V component. The color information consists of the luminance component Y and the interleaved chrominance components U and V. The Y component occupies 8 bits, and the UV components occupy 4 bits on average due to 4:2:0 sampling. The total length is 12 bits on average. It corresponds to [CAMERA_FORMAT_YUV_420_SP in CameraFormat](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat).
**Atomic service API**: This API can be used in atomic services since API version 11.
**Widget capability**: This API can be used in ArkTS widgets since API version 12. |
| RGBA_101010212+ | 10 | The color information consists of four components: R (Red), G (Green), B (Blue), and alpha. R, G, and B each occupy 10 bits, and alpha occupies 2 bits. The total length is 32 bits.|
| YCBCR_P01012+ | 11 | The color information consists of the luminance component Y and the chrominance components Cb and Cr. Each component has effective 10 bits. In storage, the Y plane uses 16 bits per pixel (10 of which are effective). The UV plane is interleaved, with every four pixels taking up 32 bits of data (each chrominance component having 10 effective bits), resulting in an average of 15 effective bits overall. It corresponds to [CAMERA_FORMAT_YCBCR_P010 in CameraFormat](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat). |
| YCRCB_P01012+ | 12 | The color information consists of the luminance component Y and the chrominance components Cr and Cb. Each component has effective 10 bits. In storage, the Y plane uses 16 bits per pixel (10 of which are effective). The UV plane is interleaved, with every four pixels taking up 32 bits of data (each chrominance component having 10 effective bits), resulting in an average of 15 effective bits overall. It corresponds to [CAMERA_FORMAT_YCRCB_P010 in CameraFormat](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat). |
| ASTC_4x418+ | 102 | The storage format is ASTC_4x4, and the memory usage is only 1/4 of that of RGBA_8888. This format is intended for direct display scenarios. It does not support pixel access or editing in post-processing, and does not support cascaded affine transformations. |
## AlphaType9+
Enumerates the alpha types of images.
**Widget capability**: This API can be used in ArkTS widgets since API version 12.
**Atomic service API**: This API can be used in atomic services since API version 11.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| -------- | ------ | ----------------------- |
| UNKNOWN | 0 | Unknown alpha type. |
| OPAQUE | 1 | There is no alpha or the image is opaque.|
| PREMUL | 2 | Premultiplied alpha. |
| UNPREMUL | 3 | RGB non-premultiplied alpha. |
## AuxiliaryPictureType13+
Enumerates the auxiliary pictures types.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | ---- | ------------ |
| GAINMAP | 1 | Gain map, a mechanism for transforming an SDR image into an HDR image capable of display adjustment. It is a set of combinations describing how to apply gain map metadata. |
| DEPTH_MAP | 2 | Depth map, which stores the depth data of an image. It captures the distance between each pixel and the camera to provide 3D scene structure. It is usually used for 3D modeling and scene comprehension. |
| UNREFOCUS_MAP | 3 | Defocused portrait original image, which provides a method to emphasize background blur in portrait photographing. It helps users select a focus region in post-processing, allowing for greater creative control. |
| LINEAR_MAP | 4 | Linear map, which is used to provide additional viewpoints or supplementary information. It is usually used to enhance visual effects and can contain linear representations of lighting, colors, or other visual elements in a scene. |
| FRAGMENT_MAP | 5 | Fragment map, which indicates regions obscured by watermarks in the original image. It is used to remove or correct the watermark interference, thereby enhancing the image completeness and visibility.|
## MetadataType13+
Enumerates image metadata types.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ----------------- | ---- | ------------------ |
| EXIF_METADATA | 1 | EXIF data. |
| FRAGMENT_METADATA | 2 | Fragment map metadata.|
| GIF_METADATA20+ | 5 | GIF image metadata.|
## ScaleMode9+
Enumerates the scale modes of images.
**Widget capability**: This API can be used in ArkTS widgets since API version 12.
**Atomic service API**: This API can be used in atomic services since API version 11.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| --------------- | ------ | -------------------------------------------------- |
| CENTER_CROP | 1 | Scales the image so that it fills the requested bounds of the target and crops the extra.|
| FIT_TARGET_SIZE | 0 | Reduces the image size to the dimensions of the target. |
## PropertyKey7+
Describes the exchangeable image file format (EXIF) data of an image.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ----------------- | ----------------------- |---------------------------|
| NEW_SUBFILE_TYPE 12+ | "NewSubfileType" | **Read/Write capability**: readable and writable
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.|
| SUBFILE_TYPE 12+ | "SubfileType" | **Read/Write capability**: readable and writable
Type of data contained in this subfile. This tag has been deprecated. Use **NewSubfileType** instead.|
| IMAGE_WIDTH | "ImageWidth" | **Read/Write capability**: readable and writable
Image width.|
| IMAGE_LENGTH | "ImageLength" | **Read/Write capability**: readable and writable
Image length.|
| BITS_PER_SAMPLE | "BitsPerSample" | **Read/Write capability**: readable and writable
Number of bits per sample. For example, for RGB, which has three components, the format is 8, 8, 8.|
| COMPRESSION 12+ | "Compression" | **Read/Write capability**: readable and writable
Compression scheme used on the image data.|
| PHOTOMETRIC_INTERPRETATION 12+ | "PhotometricInterpretation" | **Read/Write capability**: readable and writable
Color space of the image data, for example, RGB or YCbCr.|
| IMAGE_DESCRIPTION10+ | "ImageDescription" | **Read/Write capability**: readable and writable
Image description.|
| MAKE10+ | "Make" | **Read/Write capability**: readable and writable
Manufacturer.|
| MODEL10+ | "Model" | **Read/Write capability**: readable and writable
Device model.|
| STRIP_OFFSETS 12+ | "StripOffsets" | **Read/Write capability**: readable and writable
Byte offset of each strip.|
| ORIENTATION | "Orientation" | **Read/Write capability**: readable and writable
Image orientation.
1: **Top-left**: The image is not rotated.
2: **Top-right**: The image is flipped horizontally.
3: **Bottom-right**: The image is rotated by 180°.
4: **Bottom-left**: The image is flipped vertically.
5: **Left-top**: The image is flipped horizontally and then rotated clockwise by 270°.
6: **Right-top**: The image is rotated clockwise by 90°.
7: **Right-bottom**: The image is vertically flipped and then rotated clockwise by 90°.
8: **Left-bottom**: The image is rotated clockwise by 270°.
If an undefined value is read, **Unknown Value 0** is returned. The value of the property obtained is returned as a string. When modifying the property, you can specify the property either in the form of a number or a string.|
| SAMPLES_PER_PIXEL 12+ | "SamplesPerPixel" | **Read/Write capability**: readable and writable
Number of components per pixel. The value is 3 for RGB and YCbCr images. The **JPEG** key is used in JPEG compressed data.|
| ROWS_PER_STRIP 12+ | "RowsPerStrip" | **Read/Write capability**: readable and writable
Number of rows per strip.|
| STRIP_BYTE_COUNTS 12+ | "StripByteCounts" | **Read/Write capability**: readable and writable
Number of bytes in each strip after compression.|
| X_RESOLUTION 12+ | "XResolution" | **Read/Write capability**: readable and writable
Number of pixels per ResolutionUnit in the image width (X) direction.|
| Y_RESOLUTION 12+ | "YResolution" | **Read/Write capability**: readable and writable
Number of pixels per ResolutionUnit in the image height (Y) direction.|
| PLANAR_CONFIGURATION 12+ | "PlanarConfiguration" | **Read/Write capability**: readable and writable
Storage format of components of each pixel, which can be chunky or planar.|
| RESOLUTION_UNIT 12+ | "ResolutionUnit" | **Read/Write capability**: readable and writable
Unit of measurement for XResolution and YResolution.|
| TRANSFER_FUNCTION 12+ | "TransferFunction" | **Read/Write capability**: readable and writable
Transfer function for the image, which is usually used for color correction.|
| SOFTWARE 12+ | "Software" | **Read/Write capability**: readable and writable
Name and version number of the software used to create the image.|
| DATE_TIME10+ | "DateTime" | **Read/Write capability**: readable and writable
Date and time of image creation. An example in the correct format is 2024:01:25 05:51:34.|
| ARTIST 12+ | "Artist" | **Read/Write capability**: readable and writable
Person who created the image.|
| WHITE_POINT 12+ | "WhitePoint" | **Read/Write capability**: readable and writable
Chromaticity of the white point of the image.|
| PRIMARY_CHROMATICITIES 12+ | "PrimaryChromaticities" | **Read/Write capability**: readable and writable
Chromaticities of the primaries of the image.|
| PHOTO_MODE10+ | "PhotoMode" | **Read/Write capability**: readable and writable
Photographing mode.|
| JPEG_INTERCHANGE_FORMAT 12+ | "JPEGInterchangeFormat" | **Read/Write capability**: read-only
Offset of the SOI marker of a JPEG interchange format bitstream.|
| JPEG_INTERCHANGE_FORMAT_LENGTH 12+ | "JPEGInterchangeFormatLength" | **Read/Write capability**: read-only
Number of bytes of the JPEG stream.|
| YCBCR_COEFFICIENTS 12+ | "YCbCrCoefficients" | **Read/Write capability**: readable and writable
Transformation from RGB to YCbCr image data.|
| YCBCR_SUB_SAMPLING 12+ | "YCbCrSubSampling" | **Read/Write capability**: readable and writable
Subsampling factors used for the chrominance components of a YCbCr image.|
| YCBCR_POSITIONING 12+ | "YCbCrPositioning" | **Read/Write capability**: readable and writable
Positioning of subsampled chrominance components relative to luminance samples.|
| REFERENCE_BLACK_WHITE 12+ | "ReferenceBlackWhite" | **Read/Write capability**: readable and writable
A pair of headroom and footroom image data values (codes) for each pixel component.|
| COPYRIGHT 12+ | "Copyright" | **Read/Write capability**: readable and writable
Copyright notice of the image.|
| EXPOSURE_TIME9+ | "ExposureTime" | **Read/Write capability**: readable and writable
Exposure time, for example, 1/33 seconds.|
| F_NUMBER9+ | "FNumber" | **Read/Write capability**: readable and writable
F number, for example, f/1.8.|
| EXPOSURE_PROGRAM 12+ | "ExposureProgram" | **Read/Write capability**: readable and writable
Class of the program used by the camera to set exposure when the image was captured.|
| SPECTRAL_SENSITIVITY 12+ | "SpectralSensitivity" | **Read/Write capability**: readable and writable
Spectral sensitivity of each channel of the camera.|
| GPS_VERSION_ID 12+ | "GPSVersionID" | **Read/Write capability**: readable and writable
Version of GPSInfoIFD.|
| GPS_LATITUDE_REF | "GPSLatitudeRef" | **Read/Write capability**: readable and writable
Whether the latitude is north or south latitude.|
| GPS_LATITUDE | "GPSLatitude" | **Read/Write capability**: readable and writable
Image latitude. The value must be in the format of degree,minute,second, for example, 39,54,7.542.|
| GPS_LONGITUDE_REF | "GPSLongitudeRef" | **Read/Write capability**: readable and writable
Whether the longitude is east or west longitude.|
| GPS_LONGITUDE | "GPSLongitude" | **Read/Write capability**: readable and writable
Image longitude. The value must be in the format of degree,minute,second, for example, 116,19,42.16.|
| GPS_ALTITUDE_REF 12+ | "GPSAltitudeRef" | **Read/Write capability**: readable and writable
Whether the latitude is north or south latitude.|
| GPS_ALTITUDE 12+ | "GPSAltitude" | **Read/Write capability**: readable and writable
Altitude based on the reference in GPSAltitudeRef.|
| GPS_TIME_STAMP10+ | "GPSTimeStamp" | **Read/Write capability**: readable and writable
GPS timestamp.|
| GPS_SATELLITES 12+ | "GPSSatellites" | **Read/Write capability**: readable and writable
GPS satellites used for measurement.|
| GPS_STATUS 12+ | "GPSStatus" | **Read/Write capability**: readable and writable
Status of the GPS receiver when the image was recorded.|
| GPS_MEASURE_MODE 12+ | "GPSMeasureMode" | **Read/Write capability**: readable and writable
GPS measurement pmode.|
| GPS_DOP 12+ | "GPSDOP" | **Read/Write capability**: readable and writable
GPS DOP (data degree of precision)|
| GPS_SPEED_REF 12+ | "GPSSpeedRef" | **Read/Write capability**: readable and writable
Unit used to express the movement speed of the GPS receiver.|
| GPS_SPEED 12+ | "GPSSpeed" | **Read/Write capability**: readable and writable
Movement speed of the GPS receiver.|
| GPS_TRACK_REF 12+ | "GPSTrackRef" | **Read/Write capability**: readable and writable
Reference of the movement direction of the GPS receiver.|
| GPS_TRACK 12+ | "GPSTrack" | **Read/Write capability**: readable and writable
Movement direction of the GPS receiver.|
| GPS_IMG_DIRECTION_REF 12+ | "GPSImgDirectionRef" | **Read/Write capability**: readable and writable
Reference of the direction of the image when it was captured.|
| GPS_IMG_DIRECTION 12+ | "GPSImgDirection" | **Read/Write capability**: readable and writable
Direction of the image when it was captured.|
| GPS_MAP_DATUM 12+ | "GPSMapDatum" | **Read/Write capability**: readable and writable
Geodetic survey data used by the GPS receiver.|
| GPS_DEST_LATITUDE_REF 12+ | "GPSDestLatitudeRef" | **Read/Write capability**: readable and writable
Whether the latitude of the destination point is north or south latitude.|
| GPS_DEST_LATITUDE 12+ | "GPSDestLatitude" | **Read/Write capability**: readable and writable
Latitude of the destination point.|
| GPS_DEST_LONGITUDE_REF 12+ | "GPSDestLongitudeRef" | **Read/Write capability**: readable and writable
Whether the longitude of the destination point is east or west longitude.|
| GPS_DEST_LONGITUDE 12+ | "GPSDestLongitude" | **Read/Write capability**: readable and writable
Longitude of the destination point.|
| GPS_DEST_BEARING_REF 12+ | "GPSDestBearingRef" | **Read/Write capability**: readable and writable
Reference of the bearing to the destination point.|
| GPS_DEST_BEARING 12+ | "GPSDestBearing" | **Read/Write capability**: readable and writable
Bearing to the destination point.|
| GPS_DEST_DISTANCE_REF 12+ | "GPSDestDistanceRef" | **Read/Write capability**: readable and writable
Unit used to express the distance to the destination point.|
| GPS_DEST_DISTANCE 12+ | "GPSDestDistance" | **Read/Write capability**: readable and writable
Distance to the destination point.|
| GPS_PROCESSING_METHOD 12+ | "GPSProcessingMethod" | **Read/Write capability**: readable and writable
String that records the name of the method used for positioning.|
| GPS_AREA_INFORMATION 12+ | "GPSAreaInformation" | **Read/Write capability**: readable and writable
String that records the name of the GPS area.|
| GPS_DATE_STAMP10+ | "GPSDateStamp" | **Read/Write capability**: readable and writable
GPS date stamp.|
| GPS_DIFFERENTIAL 12+ | "GPSDifferential" | **Read/Write capability**: readable and writable
Whether differential correction is applied to the GPS receiver. It is critical to accurate location accuracy.|
| GPS_H_POSITIONING_ERROR 12+ | "GPSHPositioningError" | **Read/Write capability**: readable and writable
Horizontal positioning error, in meters.|
| ISO_SPEED_RATINGS9+ | "ISOSpeedRatings" | **Read/Write capability**: readable and writable
ISO sensitivity or ISO speed, for example, 400.|
| PHOTOGRAPHIC_SENSITIVITY 12+ | "PhotographicSensitivity" | **Read/Write capability**: readable and writable
Sensitivity of the camera or input device when the image was captured.|
| OECF 12+ | "OECF" | **Read/Write capability**: readable and writable
Opto-Electric Conversion Function (OECF) specified in ISO 14524.|
| SENSITIVITY_TYPE10+ | "SensitivityType" | **Read/Write capability**: readable and writable
Sensitivity type.|
| STANDARD_OUTPUT_SENSITIVITY10+ | "StandardOutputSensitivity" | **Read/Write capability**: readable and writable
Standard output sensitivity.|
| RECOMMENDED_EXPOSURE_INDEX10+ | "RecommendedExposureIndex" | **Read/Write capability**: readable and writable
Recommended exposure index.|
| ISO_SPEED10+ | "ISOSpeedRatings" | **Read/Write capability**: readable and writable
ISO speed.|
| ISO_SPEED_LATITUDE_YYY 12+ | "ISOSpeedLatitudeyyy" | **Read/Write capability**: readable and writable
ISO speed latitude yyy value of the camera or input device, which is defined in ISO 12232.|
| ISO_SPEED_LATITUDE_ZZZ 12+ | "ISOSpeedLatitudezzz" | **Read/Write capability**: readable and writable
ISO speed latitude zzz value of the camera or input device, which is defined in ISO 12232.|
| EXIF_VERSION 12+ | "ExifVersion" | **Read/Write capability**: readable and writable
Version of the supported EXIF standard.|
| DATE_TIME_ORIGINAL9+ | "DateTimeOriginal" | **Read/Write capability**: readable and writable
Time when the original image data was generated, for example, 2022:09:06 15:48:00.|
| DATE_TIME_DIGITIZED 12+ | "DateTimeDigitized" | **Read/Write capability**: readable and writable
Date and time when the image was stored as digital data, in the format of YYYY:MM:DD HH:MM:SS.|
| OFFSET_TIME 12+ | "OffsetTime" | **Read/Write capability**: readable and writable
Time with an offset from UTC when the image was captured, in the format of ±HH:MM.|
| OFFSET_TIME_ORIGINAL 12+ | "OffsetTimeOriginal" | **Read/Write capability**: readable and writable
Time with an offset from UTC when the original image was created. It is critical for time-sensitive applications.|
| OFFSET_TIME_DIGITIZED 12+ | "OffsetTimeDigitized" | **Read/Write capability**: readable and writable
Time with an offset from UTC when the image was digitized. It helps to accurately adjust the timestamp.|
| COMPONENTS_CONFIGURATION 12+ | "ComponentsConfiguration" | **Read/Write capability**: readable and writable
Specific information about compressed data.|
| COMPRESSED_BITS_PER_PIXEL 12+ | "CompressedBitsPerPixel" | **Read/Write capability**: readable and writable
Number of bits per pixel. It is specific to compressed data.|
| SHUTTER_SPEED 12+ | "ShutterSpeedValue" | **Read/Write capability**: readable and writable
Shutter speed, expressed in Additive System of Photographic Exposure (APEX) values.|
| APERTURE_VALUE10+ | "ApertureValue" | **Read/Write capability**: readable and writable
Lens aperture. An example in the correct format is 4/1.|
| BRIGHTNESS_VALUE 12+ | "BrightnessValue" | **Read/Write capability**: readable and writable
Value of brightness, expressed in APEX values.|
| EXPOSURE_BIAS_VALUE10+ | "ExposureBiasValue" | **Read/Write capability**: readable and writable
Exposure bias.|
| MAX_APERTURE_VALUE 12+ | "MaxApertureValue" | **Read/Write capability**: readable and writable
Smallest F number of the lens.|
| SUBJECT_DISTANCE 12+ | "SubjectDistance" | **Read/Write capability**: readable and writable
Distance to the subject, in meters.|
| METERING_MODE10+ | "MeteringMode" | **Read/Write capability**: readable and writable
Metering mode.|
| LIGHT_SOURCE10+ | "LightSource" | **Read/Write capability**: readable and writable
Light source. An example value is **Fluorescent**.|
| FLASH 10+ | "Flash" | **Read/Write capability**: readable and writable
Flash status.|
| FOCAL_LENGTH 10+ | "FocalLength" | **Read/Write capability**: readable and writable
Focal length of the lens.|
| SUBJECT_AREA 12+ | "SubjectArea" | **Read/Write capability**: readable and writable
Location and area of the main subject in the entire scene.|
| MAKER_NOTE 12+ | "MakerNote" | **Read/Write capability**: readable and writable
Marker used by EXIF/DCF manufacturers to record any required information.
This field is read-only in API versions 12 to 19 and is readable and writable in API version 20 and later.|
| SCENE_POINTER 12+ | "HwMnoteScenePointer" | **Read/Write capability**: read-only
Pointer to the scene.|
| SCENE_VERSION 12+ | "HwMnoteSceneVersion" | **Read/Write capability**: read-only
Scene algorithm version.|
| SCENE_FOOD_CONF11+ | "HwMnoteSceneFoodConf" | **Read/Write capability**: read-only
Photographing scene: food.|
| SCENE_STAGE_CONF11+ | "HwMnoteSceneStageConf" | **Read/Write capability**: read-only
Photographing scene: stage.|
| SCENE_BLUE_SKY_CONF11+ | "HwMnoteSceneBlueSkyConf" | **Read/Write capability**: read-only
Photographing scene: blue sky.|
| SCENE_GREEN_PLANT_CONF11+ | "HwMnoteSceneGreenPlantConf" | **Read/Write capability**: read-only
Photographing scene: green plant.|
| SCENE_BEACH_CONF11+ | "HwMnoteSceneBeachConf" | **Read/Write capability**: read-only
Photographing scene: beach.|
| SCENE_SNOW_CONF11+ | "HwMnoteSceneSnowConf" | **Read/Write capability**: read-only
Photographing scene: snow.|
| SCENE_SUNSET_CONF11+ | "HwMnoteSceneSunsetConf" | **Read/Write capability**: read-only
Photographing scene: sunset.|
| SCENE_FLOWERS_CONF11+ | "HwMnoteSceneFlowersConf" | **Read/Write capability**: read-only
Photographing scene: flowers.|
| SCENE_NIGHT_CONF11+ | "HwMnoteSceneNightConf" | **Read/Write capability**: read-only
Photographing scene: night.|
| SCENE_TEXT_CONF11+ | "HwMnoteSceneTextConf" | **Read/Write capability**: read-only
Photographing scene: text.|
| FACE_POINTER 12+ | "HwMnoteFacePointer" | **Read/Write capability**: read-only
Face pointer.|
| FACE_VERSION 12+ | "HwMnoteFaceVersion" | **Read/Write capability**: read-only
Facial recognition algorithm version.|
| FACE_COUNT11+ | "HwMnoteFaceCount" | **Read/Write capability**: read-only
Number of faces.|
| FACE_CONF 12+ | "HwMnoteFaceConf" | **Read/Write capability**: read-only
Face confidence.|
| FACE_SMILE_SCORE 12+ | "HwMnoteFaceSmileScore" | **Read/Write capability**: read-only
Smile score of for faces.|
| FACE_RECT 12+ | "HwMnoteFaceRect" | **Read/Write capability**: read-only
Face rectangle.|
| FACE_LEYE_CENTER 12+ | "HwMnoteFaceLeyeCenter" | **Read/Write capability**: read-only
Left eye centered.|
| FACE_REYE_CENTER 12+ | "HwMnoteFaceReyeCenter" | **Read/Write capability**: read-only
Right eye centered.|
| FACE_MOUTH_CENTER 12+ | "HwMnoteFaceMouthCenter" | **Read/Write capability**: read-only
Mouth centered.|
| CAPTURE_MODE 10+ | "HwMnoteCaptureMode" | **Read/Write capability**: readable and writable
Capture mode.|
| BURST_NUMBER 12+ | "HwMnoteBurstNumber" | **Read/Write capability**: read-only
Number of burst shooting times.|
| FRONT_CAMERA 12+ | "HwMnoteFrontCamera" | **Read/Write capability**: read-only
Whether the front camera is used to take a selfie.|
| ROLL_ANGLE 11+ | "HwMnoteRollAngle" | **Read/Write capability**: read-only
Roll angle.|
| PITCH_ANGLE11+ | "HwMnotePitchAngle" | **Read/Write capability**: read-only
Pitch angle.|
| PHYSICAL_APERTURE 10+ | "HwMnotePhysicalAperture" | **Read/Write capability**: read-only
Physical aperture.|
| FOCUS_MODE11+ | "HwMnoteFocusMode" | **Read/Write capability**: read-only
Focus mode.|
| USER_COMMENT 10+ | "UserComment" | **Read/Write capability**: readable and writable
User comments.|
| SUBSEC_TIME 12+ | "SubsecTime" | **Read/Write capability**: readable and writable
Tag used to record fractions of seconds for the **DateTime** tag.|
| SUBSEC_TIME_ORIGINAL 12+ | "SubsecTimeOriginal" | **Read/Write capability**: readable and writable
Tag used to record fractions of seconds for the **DateTimeOriginal** tag.|
| SUBSEC_TIME_DIGITIZED 12+ | "SubsecTimeDigitized" | **Read/Write capability**: readable and writable
Tag used to record fractions of seconds for the **DateTimeDigitized** tag.|
| FLASHPIX_VERSION 12+ | "FlashpixVersion" | **Read/Write capability**: readable and writable
FlashPix format version supported by an FPXR file. It is used to enhance device compatibility.|
| COLOR_SPACE 12+ | "ColorSpace" | **Read/Write capability**: readable and writable
Color space information, which is usually recorded as a color space specifier.|
| PIXEL_X_DIMENSION 10+ | "PixelXDimension" | **Read/Write capability**: readable and writable
Pixel X dimension.|
| PIXEL_Y_DIMENSION10+ | "PixelYDimension" | **Read/Write capability**: readable and writable
Pixel Y dimension.|
| RELATED_SOUND_FILE 12+ | "RelatedSoundFile" | **Read/Write capability**: readable and writable
Name of an audio file related to the image data.|
| FLASH_ENERGY 12+ | "FlashEnergy" | **Read/Write capability**: readable and writable
Strobe energy at the time the image was captured, in Beam Candle Power Seconds (BCPS).|
| SPATIAL_FREQUENCY_RESPONSE 12+ | "SpatialFrequencyResponse" | **Read/Write capability**: readable and writable
Spatial frequency table of the camera or input device.|
| FOCAL_PLANE_X_RESOLUTION 12+ | "FocalPlaneXResolution" | **Read/Write capability**: readable and writable
Number of pixels in the image width (X) direction per FocalPlaneResolutionUnit.|
| FOCAL_PLANE_Y_RESOLUTION 12+ | "FocalPlaneYResolution" | **Read/Write capability**: readable and writable
Number of pixels in the image height (Y) direction per FocalPlaneResolutionUnit.|
| FOCAL_PLANE_RESOLUTION_UNIT 12+ | "FocalPlaneResolutionUnit" | **Read/Write capability**: readable and writable
Unit for measuring FocalPlaneXResolution and FocalPlaneYResolution.|
| SUBJECT_LOCATION 12+ | "SubjectLocation" | **Read/Write capability**: readable and writable
Location of the main subject relative to the left edge.|
| EXPOSURE_INDEX 12+ | "ExposureIndex" | **Read/Write capability**: readable and writable
Exposure index selected at the time the image is captured.|
| SENSING_METHOD 12+ | "SensingMethod" | **Read/Write capability**: readable and writable
Type of the image sensor on the camera.|
| FILE_SOURCE 12+ | "FileSource" | **Read/Write capability**: readable and writable
Image source.|
| SCENE_TYPE9+ | "SceneType" | **Read/Write capability**: readable and writable
Type of the scene, for example, portrait, scenery, motion, and night.|
| CFA_PATTERN 12+ | "CFAPattern" | **Read/Write capability**: readable and writable
Color Filter Array (CFA) geometric pattern of the image sensor.|
| CUSTOM_RENDERED 12+ | "CustomRendered" | **Read/Write capability**: readable and writable
Special processing on image data.|
| EXPOSURE_MODE 12+ | "ExposureMode" | **Read/Write capability**: readable and writable
Exposure mode set when the image was captured.|
| WHITE_BALANCE 10+ | "WhiteBalance" | **Read/Write capability**: readable and writable
White balance.|
| DIGITAL_ZOOM_RATIO 12+ | "DigitalZoomRatio" | **Read/Write capability**: readable and writable
Digital zoom ratio when the image was captured.|
| FOCAL_LENGTH_IN_35_MM_FILM 10+ | "FocalLengthIn35mmFilm" | **Read/Write capability**: readable and writable
Focal length in 35mm film.|
| SCENE_CAPTURE_TYPE 12+ | "SceneCaptureType" | **Read/Write capability**: readable and writable
Type of the scene that was captured.|
| GAIN_CONTROL 12+ | "GainControl" | **Read/Write capability**: readable and writable
Degree of overall image gain adjustment.|
| CONTRAST 12+ | "Contrast" | **Read/Write capability**: readable and writable
Direction of contrast processing used by the camera.|
| SATURATION 12+ | "Saturation" | **Read/Write capability**: readable and writable
Direction of saturation processing used by the camera.|
| SHARPNESS 12+ | "Sharpness" | **Read/Write capability**: readable and writable
Direction of sharpness processing used by the camera.|
| DEVICE_SETTING_DESCRIPTION 12+ | "DeviceSettingDescription" | **Read/Write capability**: readable and writable
Information about the photographing conditions of a specific camera model.|
| SUBJECT_DISTANCE_RANGE 12+ | "SubjectDistanceRange" | **Read/Write capability**: readable and writable
Distance to the subject.|
| IMAGE_UNIQUE_ID 12+ | "ImageUniqueID" | **Read/Write capability**: readable and writable
Unique identifier assigned to each image.|
| CAMERA_OWNER_NAME 12+ | "CameraOwnerName" | **Read/Write capability**: readable and writable
Name of the camera owner.|
| BODY_SERIAL_NUMBER 12+ | "BodySerialNumber" | **Read/Write capability**: readable and writable
Serial number of the camera body.|
| LENS_SPECIFICATION 12+ | "LensSpecification" | **Read/Write capability**: readable and writable
Specifications of the lens.|
| LENS_MAKE 12+ | "LensMake" | **Read/Write capability**: readable and writable
Manufacturer of the lens.|
| LENS_MODEL 12+ | "LensModel" | **Read/Write capability**: readable and writable
Model of the lens.|
| LENS_SERIAL_NUMBER 12+ | "LensSerialNumber" | **Read/Write capability**: readable and writable
Serial number of the lens.|
| COMPOSITE_IMAGE 12+ | "CompositeImage" | **Read/Write capability**: readable and writable
Whether the image is a composite image.|
| SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE 12+ | "SourceImageNumberOfCompositeImage" | **Read/Write capability**: readable and writable
Number of source images of the composite image.|
| SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE 12+ | "SourceExposureTimesOfCompositeImage" | **Read/Write capability**: readable and writable
Exposure time of source images of the composite image.|
| GAMMA 12+ | "Gamma" | **Read/Write capability**: readable and writable
Gamma value.|
| DNG_VERSION 12+ | "DNGVersion" | **Read/Write capability**: readable and writable
DNG version. It encodes the DNG 4-tier version number.|
| DEFAULT_CROP_SIZE 12+ | "DefaultCropSize" | **Read/Write capability**: readable and writable
Size of the final image area, in raw image coordinates, taking into account extra pixels around the edges of the final image.|
| GIF_LOOP_COUNT 12+ | "GIFLoopCount" | **Read/Write capability**: read-only
Number of GIF loops. The value **0** means an infinite loop, and other values means the number of loops.|
| IS_XMAGE_SUPPORTED 12+ | "HwMnoteIsXmageSupported" | **Read/Write capability**: readable and writable
Whether XMAGE is supported.|
| XMAGE_MODE 12+ | "HwMnoteXmageMode" | **Read/Write capability**: readable and writable
XMAGE watermark mode.|
| XMAGE_LEFT 12+ | "HwMnoteXmageLeft" | **Read/Write capability**: readable and writable
X1 coordinate of the watermark region.|
| XMAGE_TOP 12+ | "HwMnoteXmageTop" | **Read/Write capability**: readable and writable
Y1 coordinate of the watermark region.|
| XMAGE_RIGHT 12+ | "HwMnoteXmageRight" | **Read/Write capability**: readable and writable
X2 coordinate of the watermark region.|
| XMAGE_BOTTOM 12+ | "HwMnoteXmageBottom" | **Read/Write capability**: readable and writable
Y2 coordinate of the watermark region.|
| CLOUD_ENHANCEMENT_MODE 12+ | "HwMnoteCloudEnhancementMode" | **Read/Write capability**: readable and writable
Cloud enhancement mode.|
| WIND_SNAPSHOT_MODE 12+ | "HwMnoteWindSnapshotMode" | **Read/Write capability**: read-only
Motion snapshot mode.|
## FragmentMapPropertyKey13+
Enumerates the fragment map information.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | --------------------- | ----------------------------------- |
| X_IN_ORIGINAL | "XInOriginal" | X coordinate of the upper left corner of the fragment map in the original image.|
| Y_IN_ORIGINAL | "YInOriginal" | Y coordinate of the upper left corner of the fragment map in the original image.|
| WIDTH | "FragmentImageWidth" | Width of the fragment map. |
| HEIGHT | "FragmentImageHeight" | Height of the fragment map. |
## GifPropertyKey20+
Enumerates the GIF image information.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ----------------- | ----------------- | --------------------- |
| GIF_DELAY_TIME | "GifDelayTime" | Duration for playing each frame of a GIF image, in milliseconds.|
| GIF_DISPOSAL_TYPE | "GifDisposalType" | Disposal type of each frame in a GIF image.|
## ImageFormat9+
Enumerates the image formats.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------ | ------ | -------------------- |
| YCBCR_422_SP | 1000 | YCBCR422 semi-planar format.|
| JPEG | 2000 | JPEG encoding format. |
## ComponentType9+
Enumerates the color component types of images.
**System capability**: SystemCapability.Multimedia.Image.ImageReceiver
| Name | Value | Description |
| ----- | ------ | ----------- |
| YUV_Y | 1 | Luminance component. |
| YUV_U | 2 | Chrominance component. |
| YUV_V | 3 | Chrominance component. |
| JPEG | 4 | JPEG type.|
## DecodingDynamicRange12+
Enumerates the desired dynamic range of an image during decoding.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | ----------| ------------ |
| AUTO | 0 | The image is decoded based on the format. If the image is in HDR format, it is decoded based on the HDR content; otherwise, it is decoded based on the SDR content. The image source created by calling [CreateIncrementalSource](arkts-apis-image-f.md#imagecreateincrementalsource9) is decoded into SDR content. |
| SDR | 1 | The image is decoded according to the standard dynamic range. |
| HDR | 2 | The image is decoded according to the high dynamic range. The image source created by calling [CreateIncrementalSource](arkts-apis-image-f.md#imagecreateincrementalsource9) is decoded into SDR content. |
## PackingDynamicRange12+
Enumerates the desired dynamic range of an image during encoding.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | ----------| ------------ |
| AUTO | 0 | Adaptive. The [pixelmap](arkts-apis-image-PixelMap.md) is encoded based on the format. If the PixelMap is in HDR format, it is encoded based on the HDR content; otherwise, it is encoded based on the SDR content. |
| SDR | 1 | The image is decoded according to the standard dynamic range. |
## CropAndScaleStrategy18+
Enumerates the order of cropping and scaling.
If the **cropAndScaleStrategy** parameter is not specified in [DecodingOptions](arkts-apis-image-i.md#decodingoptions7) and both **desiredRegion** and **desiredSize** are set, the final decoding result may vary slightly due to differences in decoding algorithms used for different image formats.
For example, if the original image size is 200x200, and you specify **desiredSize:{width: 150, height: 150}, desiredRegion:{x: 0, y: 0, width: 100, height: 100}**, the expectation is to decode the top-left 1/4 region of the original image and then scale the pixelMap size to 150x150.
For JPEG and WebP images (as well as some DNG images that decode a JPEG preview within the file and therefore are treated as JPEG format), the system first performs downsampling. For instance, it might downsample by 7/8 and then crop the region based on a 175x175 image size. As a result, the final cropped region will be slightly larger than the top-left 1/4 of the original image.
For SVG images, which are vector-based and can be scaled without losing clarity, the system scales the image based on the ratio of **desiredSize** to the original image size and then crops the region. This results in a decoded region that may differ from the exact 1/4 region of the original image.
To ensure consistent results when both **desiredRegion** and **desiredSize** are set, set the **cropAndScaleStrategy** parameter to **CROP_FIRST**.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | ----------| ------------ |
| SCALE_FIRST | 1 | If both **desiredRegion** and **desiredSize** are specified, the image is first scaled based on **desiredSize** and then cropped based on **desiredRegion**. |
| CROP_FIRST | 2 | If both **desiredRegion** and **desiredSize** are specified, the image is first cropped based on **desiredRegion** and then scaled based on **desiredSize**. |
## HdrMetadataKey12+
Enumerates the keys of HDR metadata used by [pixelmap](arkts-apis-image-PixelMap.md).
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | ----------| ------------ |
| HDR_METADATA_TYPE | 0 | Metadata type used by [pixelmap](arkts-apis-image-PixelMap.md). |
| HDR_STATIC_METADATA | 1 | Static metadata. |
| HDR_DYNAMIC_METADATA | 2 | Dynamic metadata. |
| HDR_GAINMAP_METADATA | 3 | Metadata used by gain maps. |
## HdrMetadataType12+
Enumerates the values available for **HDR_METADATA_TYPE** in [HdrMetadataKey](#hdrmetadatakey12).
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------- | ----------| ------------ |
| NONE | 0 | No metadata. |
| BASE | 1 | Metadata used for base graphics. |
| GAINMAP | 2 | Metadata used for gain maps. |
| ALTERNATE| 3 | Metadata used for synthesized HDR graphics. |
## AntiAliasingLevel12+
Enumerates the anti-aliasing levels.
**Atomic service API**: This API can be used in atomic services since API version 14.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ---------------------- | ------ | ----------------- |
| NONE | 0 | Nearest neighbor interpolation. |
| LOW | 1 | Bilinear interpolation. |
| MEDIUM | 2 | Bilinear interpolation with mipmap enabled. You are advised to use this value when zooming out an image. |
| HIGH | 3 | Cubic interpolation. |
## AllocatorType15+
Enumerates the types of the memory used for image decoding.
**System capability**: SystemCapability.Multimedia.Image.Core
| Name | Value | Description |
| ------------ | ---- | ---------------------------------- |
| AUTO | 0 | The system determines whether DMA memory or shared memory is used. |
| DMA | 1 | DMA memory is used. |
| SHARE_MEMORY | 2 | Shared memory is used.|