• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Enums
2<!--Kit: Image Kit-->
3<!--Subsystem: Multimedia-->
4<!--Owner: @aulight02-->
5<!--Designer: @liyang_bryan-->
6<!--Tester: @xchaosioda-->
7<!--Adviser: @zengyawen-->
8
9> **说明:**
10>
11> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
12
13## PixelMapFormat<sup>7+</sup>
14
15枚举,图片像素格式。
16
17**系统能力:** SystemCapability.Multimedia.Image.Core
18
19| 名称                   |   值   | 说明              |
20| ---------------------- | ------ | ----------------- |
21| UNKNOWN                | 0      | 未知格式。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。        |
22| ARGB_8888<sup>18+</sup> | 1 | 颜色信息由透明度(Alpha)与R(Red),G(Green),B(Blue)四部分组成,每个部分占8位,总共占32位。 该格式当前仅支持PixelMap的接口。|
23| RGB_565                | 2      | 颜色信息由R(Red),G(Green),B(Blue)三部分组成,R占5位,G占6位,B占5位,总共占16位。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。     |
24| RGBA_8888              | 3      | 颜色信息由R(Red),G(Green),B(Blue)与透明度(Alpha)四部分组成,每个部分占8位,总共占32位。对应[相机服务CameraFormat中的CAMERA_FORMAT_RGBA_8888](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat)。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。 |
25| BGRA_8888<sup>9+</sup> | 4      | 颜色信息由B(Blue),G(Green),R(Red)与透明度(Alpha)四部分组成,每个部分占8位,总共占32位。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。 |
26| RGB_888<sup>9+</sup>   | 5      | 颜色信息由R(Red),G(Green),B(Blue)三部分组成,每个部分占8位,总共占24位。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。   |
27| ALPHA_8<sup>9+</sup>   | 6      | 颜色信息仅包含透明度(Alpha),每个像素占8位。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。   |
28| RGBA_F16<sup>9+</sup>  | 7      | 颜色信息由R(Red),G(Green),B(Blue)与透明度(Alpha)四部分组成,每个部分占16位,总共占64位。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。  |
29| NV21<sup>9+</sup>      | 8      | YVU像素排列,V分量在U分量之前。颜色信息由亮度分量Y和交错排列的色度分量V和U组成,其中Y分量占8位,UV分量因4:2:0采样平均占4位,总共平均占12位。对应[相机服务CameraFormat中的CAMERA_FORMAT_YUV_420_SP](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat)。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。      |
30| NV12<sup>9+</sup>      | 9      | YUV像素排列,U分量在V分量之前。颜色信息由亮度分量Y和交错排列的色度分量U和V组成,其中Y分量占8位,UV分量因4:2:0采样平均占4位,总共平均占12位。<br>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 <br>**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。      |
31| RGBA_1010102<sup>12+</sup> | 10 | 颜色信息由R(Red),G(Green),B(Blue)与透明度(Alpha)四部分组成,其中R、G、B分别占10位,透明度占2位,总共占32位。 |
32| YCBCR_P010<sup>12+</sup> | 11 | 颜色信息由亮度分量Y和色度分量Cb与Cr组成,每个分量有效10位,实际存储时,Y平面每个像素占16位数据(10位有效),UV平面交错排列,每4个像素占32位数据(每色度分量10位有效),平均有效占15位。对应[相机服务CameraFormat中的CAMERA_FORMAT_YCBCR_P010](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat)。  |
33| YCRCB_P010<sup>12+</sup> | 12 | 颜色信息由亮度分量Y和色度分量Cr与Cb组成,每个分量有效10位,实际存储时,Y平面每个像素占16位数据(10位有效),UV平面交错排列,每4个像素占32位数据(每色度分量10位有效),平均有效占15位。对应[相机服务CameraFormat中的CAMERA_FORMAT_YCRCB_P010](../apis-camera-kit/arkts-apis-camera-e.md#cameraformat)。  |
34| ASTC_4x4<sup>18+</sup> | 102 | 存储格式为ASTC 4x4格式,内存使用量仅为RGBA_8888的1/4。该格式仅用于直接显示场景,不支持像素访问或后期处理编辑,不支持仿射变换级联使用。  |
35
36## AlphaType<sup>9+</sup>
37
38枚举,图像的透明度类型。
39
40**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
41
42**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
43
44**系统能力:** SystemCapability.Multimedia.Image.Core
45
46| 名称     |   值   | 说明                    |
47| -------- | ------ | ----------------------- |
48| UNKNOWN  | 0      | 未知透明度。            |
49| OPAQUE   | 1      | 没有alpha或图片不透明。 |
50| PREMUL   | 2      | RGB预乘alpha。         |
51| UNPREMUL | 3      | RGB非预乘alpha。       |
52
53## AuxiliaryPictureType<sup>13+</sup>
54
55枚举,辅助图的图像类型。
56
57**系统能力:** SystemCapability.Multimedia.Image.Core
58
59| 名称          | 值   | 说明         |
60| ------------- | ---- | ------------ |
61| GAINMAP       | 1    | 增益图,代表了一种增强SDR图像以产生具有可变显示调整能力的HDR图像的机制。它是一组描述如何应用gainmap元数据的组合。     |
62| DEPTH_MAP     | 2    | 深度图,储存图像的深度数据,通过捕捉每个像素与摄像机之间的距离,提供场景的三维结构信息,通常用于3D重建和场景理解。     |
63| UNREFOCUS_MAP | 3    | 人像未对焦的原图,提供了一种在人像拍摄中突出背景模糊效果的方式,能够帮助用户在后期处理中选择焦点区域,增加创作自由度。   |
64| LINEAR_MAP    | 4    | 线性图,用于提供额外的数据视角或补充信息,通常用于视觉效果的增强,它可以包含场景中光照、颜色或其他视觉元素的线性表示。     |
65| FRAGMENT_MAP  | 5    | 水印裁剪图,表示在原图中被水印覆盖的区域,该图像用于修复或移除水印影响,恢复图像的完整性和可视性。 |
66
67## MetadataType<sup>13+</sup>
68
69枚举,图片元数据类型。
70
71**系统能力:** SystemCapability.Multimedia.Image.Core
72
73| 名称              | 值   | 说明               |
74| ----------------- | ---- | ------------------ |
75| EXIF_METADATA     | 1    | exif数据。         |
76| FRAGMENT_METADATA | 2    | 水印裁剪图元数据。 |
77| GIF_METADATA<sup>20+</sup> | 5    | GIF图片元数据。 |
78
79## ScaleMode<sup>9+</sup>
80
81枚举,图像的缩放模式。
82
83**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
84
85**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
86
87**系统能力:** SystemCapability.Multimedia.Image.Core
88
89| 名称            |   值   | 说明                                               |
90| --------------- | ------ | -------------------------------------------------- |
91| CENTER_CROP     | 1      | 缩放图像以填充目标图像区域并居中裁剪区域外的效果。 |
92| FIT_TARGET_SIZE | 0      | 图像适合目标尺寸的效果。                           |
93
94## PropertyKey<sup>7+</sup>
95
96枚举,Exif(Exchangeable image file format)图像信息。
97
98
99
100- 格式示例中的key为:image.PropertyKey.XXX(XXX为枚举的名称,如:image.PropertyKey.NEW_SUBFILE_TYPE) 。
101- 格式示例仅用于说明修改传值和读取结果的格式。具体接口使用方法请参考:[modifyImageProperty](arkts-apis-image-ImageSource.md#modifyimageproperty11)(修改单个Exif字段)、[modifyImageProperties](arkts-apis-image-ImageSource.md#modifyimageproperties12)(修改多个个Exif字段)、[getImageProperty](arkts-apis-image-ImageSource.md#getimageproperty11)(读取单个Exif字段)、[getImageProperties](arkts-apis-image-ImageSource.md#getimageproperties12)(读取多个Exif字段)。
102
103**系统能力:** SystemCapability.Multimedia.Image.Core
104
105| 名称               |   值                    |   说明                    |   格式示例               |
106| ----------------- | ----------------------- | ----------------------- | ----------------------- |
107| NEW_SUBFILE_TYPE<sup>12+</sup>           | "NewSubfileType"            | 在Exif中,"NewSubfileType"字段用于标识子文件的数据类型,如全分辨率图像、缩略图或多帧图像的一部分。其值是位掩码,0代表全分辨率图像,1代表缩略图,2代表多帧图像的一部分。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Primary image');`<br />**读取结果示例:** "0" |
108| SUBFILE_TYPE<sup>12+</sup>               | "SubfileType"               | 此标签指示此子文件中的数据类型。标签已弃用,请使用NewSubfileType替代。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Full-resolution image data');`<br />**读取结果示例:** "1" |
109| IMAGE_WIDTH                               | "ImageWidth"                | 图片宽度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'4096');`<br />**读取结果示例:** "4096" |
110| IMAGE_LENGTH                              | "ImageLength"               | 图片长度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3072');`<br />**读取结果示例:** "3072" |
111| BITS_PER_SAMPLE                           | "BitsPerSample"             | 像素各分量的位数,如RGB,3分量,格式是8,8,8。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 三个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'8 8 8');`<br />或`imageSource.modifyImageProperty(key,'8,8,8');`<br />**读取结果示例:** "8,8,8" |
112| COMPRESSION<sup>12+</sup>                | "Compression"               | 图像压缩方案。<br/> 1:"Uncompressed"。<br/> 2:"CCITT RLE"。<br/> 3:"T4/Group 3 Fax"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br/>**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Uncompressed');`<br />**读取结果示例:** "Uncompressed" |
113| PHOTOMETRIC_INTERPRETATION<sup>12+</sup> | "PhotometricInterpretation" | 像素构成,例如RGB或YCbCr。<br/> 0:"Reversed mono"。<br/> 1:"Normal mono"。<br/> 2:"RGB"。<br/> 3:"Palette"。<br/> 5:"CMYK"。<br/> 6:"YCbCr"。<br/> 8:"CieLAB"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br/>**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Normal mono');`<br />**读取结果示例:** "Normal mono" |
114| IMAGE_DESCRIPTION<sup>10+</sup>           | "ImageDescription"          | 图像信息描述。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Image description info');`<br />**读取结果示例:** "Image description info" |
115| MAKE<sup>10+</sup>                        | "Make"                      | 生产商。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Make');`<br />**读取结果示例:** "Make" |
116| MODEL<sup>10+</sup>                       | "Model"                     | 设备型号。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Model');`<br />**读取结果示例:** "Model" |
117| STRIP_OFFSETS<sup>12+</sup>              | "StripOffsets"              | 每个strip的字节偏移量。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'100');`<br />**读取结果示例:** "100" |
118| ORIENTATION                               | "Orientation"               | 图片方向。<br/> 1:"Top-left",图像未旋转。<br/> 2:"Top-right",镜像水平翻转。<br/> 3:"Bottom-right",图像旋转180°。<br/> 4:"Bottom-left",镜像垂直翻转。<br/> 5:"Left-top",镜像水平翻转再顺时针旋转270°。<br/> 6:"Right-top",顺时针旋转90°。<br/> 7:"Right-bottom",镜像水平翻转再顺时针旋转90°。<br/> 8:"Left-bottom",顺时针旋转270°。<br/> 如果读到未定义值会返回"Unknown Value 0"。获取该属性时会以字符串的形式返回。修改该属性时既可以以数字形式指定,也可以以字符串形式指定。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Top-left');`<br />**读取结果示例:** "Top-left" |
119| SAMPLES_PER_PIXEL<sup>12+</sup>          | "SamplesPerPixel"           | 每个像素的分量数。由于该标准适用于RGB和YCbCr图像,因此该标签的值设置为 3。在JPEG压缩数据中,使用JPEG标记代替该标签。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3');`<br />**读取结果示例:** "3" |
120| ROWS_PER_STRIP<sup>12+</sup>             | "RowsPerStrip"              | 每个strip的图像数据行数。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'10');`<br />**读取结果示例:** "10" |
121| STRIP_BYTE_COUNTS<sup>12+</sup>          | "StripByteCounts"           | 每个图像数据带的总字节数。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1024');`<br />**读取结果示例:** "1024" |
122| X_RESOLUTION<sup>12+</sup>               | "XResolution"               | 图像宽度方向的分辨率。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'72');`<br />**读取结果示例:** "72" |
123| Y_RESOLUTION<sup>12+</sup>               | "YResolution"               | 图像高度方向的分辨率。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'72');`<br />**读取结果示例:** "72" |
124| PLANAR_CONFIGURATION<sup>12+</sup>       | "PlanarConfiguration"       | 表示像素组件的记录格式,chunky格式或是planar格式。<br/>1:"Chunky format",chunky格式。<br/>2:"Planar format",planar格式。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Chunky format');`<br />**读取结果示例:** "Chunky format" |
125| RESOLUTION_UNIT<sup>12+</sup>            | "ResolutionUnit"            | 用于测量XResolution和YResolution的单位,英寸或者厘米。<br/>2:"Inch",英寸。<br/>3:"Centimeter",厘米。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2');`<br />或`imageSource.modifyImageProperty(key,'Inch');`<br />**读取结果示例:** "Inch" |
126| TRANSFER_FUNCTION<sup>12+</sup>          | "TransferFunction"          | 图像的传递函数,通常用于颜色校正。<br/>**读写能力:** 可读写。<br> | 该字段为特有格式,虽然支持读写,但目前版本不做解析。 |
127| SOFTWARE<sup>12+</sup>                   | "Software"                  | 用于生成图像的软件名称和版本。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Software name and version');`<br />**读取结果示例:** "Software name and version" |
128| DATE_TIME<sup>10+</sup>                   | "DateTime"                  | 日期时间。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 有两种格式,YYYY:MM:DD或者YYYY:MM:DD HH:MM:SS<br />**修改示例:**`imageSource.modifyImageProperty(key,'2024:07:07 13:45:59');`<br />或`imageSource.modifyImageProperty(key,'2024:07:07');`<br />**读取结果示例:** "2024:07:07 13:45:59"或"2024:07:07" |
129| ARTIST<sup>12+</sup>                     | "Artist"                    | 创建图像的用户名称。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'User name');`<br />**读取结果示例:** "User name" |
130| WHITE_POINT<sup>12+</sup>                | "WhitePoint"                | 用于指定图像的白点(white point)色度坐标,即图像颜色空间中被认为是“白色”的参考点。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 两个非负有理数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1,2');`<br />或`imageSource.modifyImageProperty(key,'1 2');`<br />**读取结果示例:** "1,2" |
131| PRIMARY_CHROMATICITIES<sup>12+</sup>     | "PrimaryChromaticities"     | 图像的主要颜色的色度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'2/1');`<br />**读取结果示例:** "0.5" |
132| PHOTO_MODE<sup>10+</sup>                  | "PhotoMode"                 | 拍照模式。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** "1" |
133| JPEG_INTERCHANGE_FORMAT<sup>12+</sup>    | "JPEGInterchangeFormat"     | JPEG压缩缩略图数据开始字节(SOI)的偏移。<br />**读写能力:** 只读。<br> | **读取结果示例:** "1024" |
134| JPEG_INTERCHANGE_FORMAT_LENGTH<sup>12+</sup> | "JPEGInterchangeFormatLength" | JPEG压缩缩略图数据的字节数。<br />**读写能力:** 只读。<br> | **读取结果示例:** "1024" |
135| YCBCR_COEFFICIENTS<sup>12+</sup>         | "YCbCrCoefficients"         | 从RGB到YCbCr图像数据的转换矩阵系数,RGB→YCbCr转换时的加权系数。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 三个非负有理数字符串,和为1。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0.299, 0.587, 0.114');`<br />**读取结果示例:** "0.299, 0.587, 0.114" |
136| YCBCR_SUB_SAMPLING<sup>12+</sup>         | "YCbCrSubSampling"          | 色度分量与亮度分量的采样比率。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 两个非负整数字符串,空格或者逗号分隔。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2,2');`<br />或`imageSource.modifyImageProperty(key,'2 2');`<br />**读取结果示例:** "2,2" |
137| YCBCR_POSITIONING<sup>12+</sup>          | "YCbCrPositioning"          | 色度分量相对于亮度分量的位置。<br/>1:"Centered",中心对齐(Centered),Cb/Cr分量的采样点相对于亮度像素点是居中对齐(常见)。<br/>2:"Co-sited",左上对齐(Co-sited)Cb/Cr分量和 Y 分量的采样点对齐在左上角。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。 <br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Centered');`<br />**读取结果示例:** "Centered" |
138| REFERENCE_BLACK_WHITE<sup>12+</sup>      | "ReferenceBlackWhite"       | 参考黑点值和白点值。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** "1,255, 0,255, 0,255" |
139| COPYRIGHT<sup>12+</sup>                  | "Copyright"                 | 图像的版权信息。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'desc');`<br />**读取结果示例:** "desc (Photographer) - [None] (Editor)" |
140| EXPOSURE_TIME<sup>9+</sup>                | "ExposureTime"              | 曝光时间,例如1/33 sec。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'1/2');`<br />**读取结果示例:** "1/33 sec." |
141| F_NUMBER<sup>9+</sup>                     | "FNumber"                   | 光圈值,例如f/1.8。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'1/2');`<br />**读取结果示例:** "f/1.0" |
142| EXPOSURE_PROGRAM<sup>12+</sup>           | "ExposureProgram"           | 拍照时相机用来设置曝光的程序的类别。<br />0:"Not defined"。<br />1:"Manual"。  <br />2:"Normal program"。<br/>3:"Aperture priority"。<br />4:"Shutter priority"。<br />5:"Creative program (biased toward depth of field)"。<br/>6:"Creative program (biased toward fast shutter speed)"。<br/>7:"Portrait mode (for closeup photos with the background out of focus)"。<br/>8:"Landscape mode (for landscape photos with the background in focus)"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Not defined');`<br />**读取结果示例:** "Not defined" |
143| SPECTRAL_SENSITIVITY<sup>12+</sup>       | "SpectralSensitivity"       | 表示所用相机的每个通道的光谱灵敏度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'SpectralSensitivity');`<br />**读取结果示例:** "SpectralSensitivity" |
144| GPS_VERSION_ID<sup>12+</sup>             | "GPSVersionID"              | GPS信息版本号。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 四个以小数点分隔的非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2.3.0.0');`<br />**读取结果示例:** "2.3.0.0" |
145| GPS_LATITUDE_REF                          | "GPSLatitudeRef"            | 用于标识图像拍摄地点的纬度方向(北半球或南半球)。<br/>78:"North"。<br />83:"South"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:**  修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'78');`<br />或`imageSource.modifyImageProperty(key,'North');`<br />**读取结果示例:** "N"或"78" |
146| GPS_LATITUDE                              | "GPSLatitude"               | 图片纬度。修改时应按"度,分,秒"格式传入,如"39,54,7.542"<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 三个非负有理数字符串,逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'39,54,7.542');`<br />**读取结果示例:** "39,54,7.542" |
147| GPS_LONGITUDE_REF                         | "GPSLongitudeRef"           | 经度引用,例如W或E, 用于标识图像拍摄地点的经度方向(东半球或西半球)。<br/>69:"East"。<br />87:"West"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:**  修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'69');`<br />或`imageSource.modifyImageProperty(key,'East');`<br />**读取结果示例:** "69"或"E" |
148| GPS_LONGITUDE                             | "GPSLongitude"              | 图片经度。修改时应按"度,分,秒"格式传入,如"116,19,42.16"<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 三个非负有理数字符串,逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'116,19,42.16');`<br />**读取结果示例:** "116,19,42.16" |
149| GPS_ALTITUDE_REF<sup>12+</sup>           | "GPSAltitudeRef"            | 用于GPS高度的参照高度。<br/>0:"Sea level",海平面以上(Above Sea Level)。<br/>1:"Sea level reference",海平面以下(Below Sea Level)。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:**  修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Sea level');`<br />**读取结果示例:** "Sea level" |
150| GPS_ALTITUDE<sup>12+</sup>               | "GPSAltitude"               | 基于GPSAltitudeRef的高度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'123.45');`<br />**读取结果示例:** "123.45" |
151| GPS_TIME_STAMP<sup>10+</sup>              | "GPSTimeStamp"              | GPS时间戳。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 格式为"HH:mm:ss.ddd"。<br />**修改示例:**`imageSource.modifyImageProperty(key,'12:30:30.123');`<br />**读取结果示例:** "12:30:30.123" |
152| GPS_SATELLITES<sup>12+</sup>             | "GPSSatellites"             | 用于测量的GPS卫星。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'GPS Satellites');`<br />**读取结果示例:** "GPSSatellites" |
153| GPS_STATUS<sup>12+</sup>                 | "GPSStatus"                 | 录制图像时GPS接收器的状态。<br/>  'A':"Measurement in progress",GPS有效,已成功锁定卫星信号,位置数据可信;<br />'V':"Measurement interrupted,GPS无效,当前未能定位,位置数据可能为空或不准。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:**  修改时传入对应的字母或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'A');`<br />或`imageSource.modifyImageProperty(key,'Measurement in progress');`<br />**读取结果示例:** "A" |
154| GPS_MEASURE_MODE<sup>12+</sup>           | "GPSMeasureMode"            | GPS测量模式。用于表示图像拍摄时GPS定位使用的测量模式,即是使用2D(平面)定位还是3D(含高度)定位。<br/>2:"2-dimensional measurement",2D测量(纬度+经度)。<br/>3:"3-dimensional measurement",3D测量(纬度+经度+高度)。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2');`<br />或`imageSource.modifyImageProperty(key,'2-dimensional measurement');`<br />**读取结果示例:** "2" |
155| GPS_DOP<sup>12+</sup>                    | "GPSDOP"                    | GPS DOP(数据精度等级),用于表示拍摄时GPS测量结果的定位精度水平。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1.5');`<br />**读取结果示例:** "1.5" |
156| GPS_SPEED_REF<sup>12+</sup>              | "GPSSpeedRef"               | 用来表示GPS接收器移动速度的单位。<br/>'K':"km/h"。<br />'M':"mph"。<br />'N':"knots"。<br />**读写能力:** 可读写。 | **修改传参格式说明:** 修改时传入对应的字母或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'K');`<br />或`imageSource.modifyImageProperty(key,'km/h');`<br />**读取结果示例:** "K" |
157| GPS_SPEED<sup>12+</sup>                  | "GPSSpeed"                  | GPS接收器的移动速度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串<br />**修改示例:**`imageSource.modifyImageProperty(key,'123');`<br />或`imageSource.modifyImageProperty(key,'123.45');`<br />**读取结果示例:** "123.45" |
158| GPS_TRACK_REF<sup>12+</sup>              | "GPSTrackRef"               | GPS接收机移动方向的参照,用于说明这个角度是以哪个“北”为参考。<br/> 'T':"True direction",真北:地理极点方向,适合地图、导航。<br />'M':"Magnetic direction", 磁北:受地磁影响,磁偏角因地区和时间不同而变化。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入对应的字母或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'T');`<br />或`imageSource.modifyImageProperty(key,'True direction');`<br />**读取结果示例:** "T" |
159| GPS_TRACK<sup>12+</sup>                  | "GPSTrack"                  | GPS接收机的移动方向。用于记录拍摄设备在拍照时的移动方向(行进方向),单位是角度(度)<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'180');`<br />**读取结果示例:** "180" |
160| GPS_IMG_DIRECTION_REF<sup>12+</sup>      | "GPSImgDirectionRef"        | 图像方向的参照。<br/> 'T':"True direction",真北:地理极点方向,适合地图、导航。<br />'M':"Magnetic direction", 磁北:受地磁影响,磁偏角因地区和时间不同而变化。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入对应的字母或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'T');`<br />或`imageSource.modifyImageProperty(key,'True direction');`<br />**读取结果示例:** "T" |
161| GPS_IMG_DIRECTION<sup>12+</sup>          | "GPSImgDirection"           | 拍摄时图像的方向。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'120');`<br />**读取结果示例:** "120" |
162| GPS_MAP_DATUM<sup>12+</sup>              | "GPSMapDatum"               | GPS接收器使用的大地测量数据。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'GPS Map Datum');`<br />**读取结果示例:** "GPS Map Datum" |
163| GPS_DEST_LATITUDE_REF<sup>12+</sup>      | "GPSDestLatitudeRef"        | 目的地点的纬度参照。<br/>78:"North"。<br />83:"South"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'78');`<br />或`imageSource.modifyImageProperty(key,'North');`<br />**读取结果示例:** "78" |
164| GPS_DEST_LATITUDE<sup>12+</sup>          | "GPSDestLatitude"           | 目的地点的纬度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 三个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'39,54,7');`<br />或`imageSource.modifyImageProperty(key,'39 54 7');`<br />**读取结果示例:** "39,54,7" |
165| GPS_DEST_LONGITUDE_REF<sup>12+</sup>     | "GPSDestLongitudeRef"       | 目的地点的经度参照。<br/>69:"East"。<br />87:"West"。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'69');`<br />或`imageSource.modifyImageProperty(key,'East');`<br />**读取结果示例:** "69" |
166| GPS_DEST_LONGITUDE<sup>12+</sup>         | "GPSDestLongitude"          | 目的地点的经度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 三个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'116,19,42');`<br />或`imageSource.modifyImageProperty(key,'116 19 42');`<br />**读取结果示例:** "116,19,42" |
167| GPS_DEST_BEARING_REF<sup>12+</sup>       | "GPSDestBearingRef"         | 指向目的地点的方位参照。<br/> 'T':"True direction",真北:地理极点方向,适合地图、导航。<br />'M':"Magnetic direction",磁北:受地磁影响,磁偏角因地区和时间不同而变化。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入对应的字母或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'T');`<br />或`imageSource.modifyImageProperty(key,'True direction');`<br />**读取结果示例:** "T" |
168| GPS_DEST_BEARING<sup>12+</sup>           | "GPSDestBearing"            | 目的地方位。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'120');`<br />**读取结果示例:** "120" |
169| GPS_DEST_DISTANCE_REF<sup>12+</sup>      | "GPSDestDistanceRef"        | 目标点距离的测量单位。<br/>'K':"km",公里。<br/>'M':"miles",英里。<br/>'N':"nautical miles",海里。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入对应的字母或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'K');`<br />或`imageSource.modifyImageProperty(key,'km');`<br />**读取结果示例:** "K" |
170| GPS_DEST_DISTANCE<sup>12+</sup>          | "GPSDestDistance"           | 到目的地点的距离。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'100');`<br />**读取结果示例:** "100" |
171| GPS_PROCESSING_METHOD<sup>12+</sup>      | "GPSProcessingMethod" |记录定位方法名的字符串。<br/>**读写能力:** 可读写。<br/>|**修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'GPS Processing Method');`<br />**读取结果示例:** "GPS Processing Method"|
172| GPS_AREA_INFORMATION<sup>12+</sup>       | "GPSAreaInformation"   | 记录GPS区域名的字符串。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'GPS Area Information');`<br />**读取结果示例:** "GPS Area Information" |
173| GPS_DATE_STAMP<sup>10+</sup>              | "GPSDateStamp"         | GPS日期戳。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 格式为“YY:MM:DD”。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2020:07:07');`<br />**读取结果示例:** "2020:07:07" |
174| GPS_DIFFERENTIAL<sup>12+</sup>           | "GPSDifferential"      | 此字段表示GPS数据是否应用了差分校正,对于精确的位置准确性至关重要。<br/>  0:"Without correction",没有使用差分校正。<br/> 1:"Correction applied",使用差分校正。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Without correction');`<br />**读取结果示例:** "0" |
175| GPS_H_POSITIONING_ERROR<sup>12+</sup>    | "GPSHPositioningError" | 此标签指示水平定位误差,单位为米。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'100');`<br />**读取结果示例:** "100" |
176| ISO_SPEED_RATINGS<sup>9+</sup>            | "ISOSpeedRatings"           | ISO感光度,例如400。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3200');`<br />**读取结果示例:** "3200" |
177| PHOTOGRAPHIC_SENSITIVITY<sup>12+</sup>   | "PhotographicSensitivity" | 用于表示图像拍摄时所用的感光度值(ISO 值),也叫ISO Speed。该字段是Exif 2.3后的推荐字段,ISOSpeedRatings(Tag 0x8827)是早期使用的字段,类型和含义相同,若两个字段都存在,以`PhotographicSensitivity` 为主。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3200');`<br />**读取结果示例:** "3200" |
178| OECF<sup>12+</sup>                       | "OECF"                      | 表示ISO 14524中规定的光电转换函数(OECF)。<br/>**读写能力:** 可读写。<br> | 该字段为特有格式,虽然支持读写,但目前版本不做解析。 |
179| SENSITIVITY_TYPE<sup>10+</sup>            | "SensitivityType"      | 灵敏度类型。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Standard output sensitivity (SOS)');`<br />**读取结果示例:** "Standard output sensitivity (SOS)" |
180| STANDARD_OUTPUT_SENSITIVITY<sup>10+</sup> | "StandardOutputSensitivity" | 标准输出灵敏度。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'400');`<br />**读取结果示例:** "400" |
181| RECOMMENDED_EXPOSURE_INDEX<sup>10+</sup>  | "RecommendedExposureIndex" | 推荐曝光指数。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3200');`<br />**读取结果示例:** "3200" |
182| ISO_SPEED<sup>10+</sup>                   | "ISOSpeedRatings"           | ISO速度等级。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3200');`<br />**读取结果示例:** "3200" |
183| ISO_SPEED_LATITUDE_YYY<sup>12+</sup>     | "ISOSpeedLatitudeyyy"  | 该标签指示摄像机或输入设备的ISO速度纬度yyy值,该值在ISO 12232中定义。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3200');`<br />**读取结果示例:** "3200" |
184| ISO_SPEED_LATITUDE_ZZZ<sup>12+</sup>     | "ISOSpeedLatitudezzz"  | 该标签指示摄像机或输入设备的ISO速度纬度zzz值,该值在ISO 12232中定义。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3200');`<br />**读取结果示例:** "3200" |
185| EXIF_VERSION<sup>12+</sup>               | "ExifVersion"               | 支持的Exif标准版本。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串,小数点分隔。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2.3');`<br />**读取结果示例:** "Exif Version 2.3" |
186| DATE_TIME_ORIGINAL<sup>9+</sup>           | "DateTimeOriginal"          | 拍摄时间,例如2022:09:06 15:48:00。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 格式为“YY:MM:DD HH:mm:ss”或“YY:MM:DD”。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2024:07:07 13:45:59');`<br />或`imageSource.modifyImageProperty(key,'2024:07:07');`<br />**读取结果示例:** "2024:07:07"或"2024:07:07 13:45:59" |
187| DATE_TIME_DIGITIZED<sup>12+</sup>        | "DateTimeDigitized"         | 图像作为数字数据存储的日期和时间,格式为YYYY:MM:DD HH:mm:ss。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 格式为“YY:MM:DD HH:mm:ss”或“YY:MM:DD”。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2024:07:07 13:45:59');`<br />或`imageSource.modifyImageProperty(key,'2024:07:07');`<br />**读取结果示例:** "2024:07:07"或"2024:07:07 13:45:59" |
188| OFFSET_TIME<sup>12+</sup>                | "OffsetTime"          | 在Exif中,OffsetTime字段表示与UTC(协调世界时)的时间偏移,用于确定照片拍摄的本地时间。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 格式为“YY:MM:DD HH:mm:ss”或“YY:MM:DD”。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2024:07:07 13:45:59');`<br />或`imageSource.modifyImageProperty(key,'2024:07:07');`<br />**读取结果示例:** "2024:07:07"或"2024:07:07 13:45:59" |
189| OFFSET_TIME_ORIGINAL<sup>12+</sup>       | "OffsetTimeOriginal"  | 此标签记录原始图像创建时的UTC偏移量,对于时间敏感的应用至关重要。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Offset Time Original');`<br />**读取结果示例:** "Offset Time Original" |
190| OFFSET_TIME_DIGITIZED<sup>12+</sup>      | "OffsetTimeDigitized" | 此标签记录图像数字化时的UTC偏移量,有助于准确调整时间戳。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Offset Time Digitized');`<br />**读取结果示例:** "Offset Time Digitized" |
191| COMPONENTS_CONFIGURATION<sup>12+</sup>   | "ComponentsConfiguration"   | 压缩数据的特定信息。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** "Y Cb Cr -"。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Y Cb Cr -');`<br />**读取结果示例:** "Y Cb Cr -" |
192| COMPRESSED_BITS_PER_PIXEL<sup>12+</sup>  | "CompressedBitsPerPixel"    | 用于压缩图像的压缩模式,单位为每像素位数。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0.95');`<br />**读取结果示例:** "0.95" |
193| SHUTTER_SPEED<sup>12+</sup>              | "ShutterSpeedValue"         | 快门速度,以APEX(摄影曝光的加法系统)值表示。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** "1.00 EV (1/2 sec.)" |
194| APERTURE_VALUE<sup>10+</sup>              | "ApertureValue"             | 光圈值。格式如4/1。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'5.6');`<br />**读取结果示例:** "5.60 EV (f/7.0)" |
195| BRIGHTNESS_VALUE<sup>12+</sup>           | "BrightnessValue"           | 图像的亮度值,以APEX单位表示。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2');`<br />**读取结果示例:** "2.00 EV (13.71 cd/m^2)" |
196| EXPOSURE_BIAS_VALUE<sup>10+</sup>         | "ExposureBiasValue"         | 曝光偏差值。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** 1.00 EV |
197| MAX_APERTURE_VALUE<sup>12+</sup>         | "MaxApertureValue"          | 最小F数镜头。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** "1.00 EV (f/1.4)" |
198| SUBJECT_DISTANCE<sup>12+</sup>           | "SubjectDistance"           | 测量单位为米的主体距离。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'100');`<br />**读取结果示例:** "100.0 m" |
199| METERING_MODE<sup>10+</sup>               | "MeteringMode"              | 测光模式。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Average');`<br />**读取结果示例:** "Average" |
200| LIGHT_SOURCE<sup>10+</sup>                | "LightSource"               | 光源。例如Fluorescent。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Daylight');`<br />**读取结果示例:** "Daylight" |
201| FLASH<sup>10+</sup>                      | "Flash"                     | 闪光灯,记录闪光灯状态。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0x00');`<br />或`imageSource.modifyImageProperty(key,'Flash did not fire');`<br />**读取结果示例:** "Flash did not fire" |
202| FOCAL_LENGTH<sup>10+</sup>               | "FocalLength"               | 焦距。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'50');`<br />或`imageSource.modifyImageProperty(key,'50/1');`<br />**读取结果示例:** "50.0 mm" |
203| SUBJECT_AREA<sup>12+</sup>               | "SubjectArea"          | 该标签指示整个场景中主要主体的位置和区域。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 两个非负有理数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'50 50');`<br />或`imageSource.modifyImageProperty(key,'50,50');`<br />**读取结果示例:** "(x,y) = (50,50)" |
204| MAKER_NOTE<sup>12+</sup>                 | "MakerNote"                 | Exif/DCF制造商使用的标签,用于记录任何所需信息。<br/>在API 12-19,该字段为只读;从API 20开始,该字段可读写。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Maker Note');`<br />**读取结果示例:** "Maker Note" |
205| USER_COMMENT<sup>10+</sup>               | "UserComment"               | 用户注释。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'User Comment');`<br />**读取结果示例:** "User Comment" |
206| SUBSEC_TIME<sup>12+</sup>                | "SubsecTime"                | 用于为DateTime标签记录秒的分数的标签。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'629000');`<br />**读取结果示例:** "629000" |
207| SUBSEC_TIME_ORIGINAL<sup>12+</sup>       | "SubsecTimeOriginal"        | 用于为DateTimeOriginal标签记录秒的分数的标签。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'629000');`<br />**读取结果示例:** "629000" |
208| SUBSEC_TIME_DIGITIZED<sup>12+</sup>      | "SubsecTimeDigitized"       | 用于为DateTimeDigitized标签记录秒的分数的标签。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'62900');`<br />**读取结果示例:** "62900" |
209| FLASHPIX_VERSION<sup>12+</sup>           | "FlashpixVersion"           | 该标签表示FPXR文件支持的Flashpix格式版本,增强了设备兼容性。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 版本号格式“1.0”。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1.0');`<br />**读取结果示例:** "FlashPix Version 1.0" |
210| COLOR_SPACE<sup>12+</sup>                | "ColorSpace"                | 色彩空间信息标签,通常记录为色彩空间指定符。<br/>1:"sRGB",sRG标准色彩空间(常见默认值)。<br/>2:"Adobe RGB",exif中未定义,但大量相机使用。<br/>0xffff:"Uncalibrated",表示未校准,颜色空间不明确。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'sRGB');`<br />**读取结果示例:** "sRGB" |
211| PIXEL_X_DIMENSION<sup>10+</sup>          | "PixelXDimension"           | 像素X尺寸。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'4096');`<br />**读取结果示例:** "4096" |
212| PIXEL_Y_DIMENSION<sup>10+</sup>           | "PixelYDimension"           | 像素Y尺寸。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'3072');`<br />**读取结果示例:** "3072" |
213| RELATED_SOUND_FILE<sup>12+</sup>         | "RelatedSoundFile"          | 与图像数据相关的音频文件的名称。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Related Sound File');`<br />**读取结果示例:** "Related Sound File" |
214| FLASH_ENERGY<sup>12+</sup>               | "FlashEnergy"               | 图像捕获时的闪光能量,以BCPS表示。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'5.0');`<br />或`imageSource.modifyImageProperty(key,'5/1');`<br />**读取结果示例:** "5" |
215| SPATIAL_FREQUENCY_RESPONSE<sup>12+</sup> | "SpatialFrequencyResponse"  | 相机或输入设备的空间频率表。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Spatial Frequency Response');`<br />**读取结果示例:** "Spatial Frequency Response" |
216| FOCAL_PLANE_X_RESOLUTION<sup>12+</sup>   | "FocalPlaneXResolution"     | 图像宽度中每FocalPlaneResolutionUnit的像素。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'500');`<br />或`imageSource.modifyImageProperty(key,'500.0');`<br />**读取结果示例:** "500" |
217| FOCAL_PLANE_Y_RESOLUTION<sup>12+</sup>   | "FocalPlaneYResolution"     | 图像高度中每FocalPlaneResolutionUnit的像素。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'500');`<br />或`imageSource.modifyImageProperty(key,'500.0');`<br />**读取结果示例:** "500" |
218| FOCAL_PLANE_RESOLUTION_UNIT<sup>12+</sup> | "FocalPlaneResolutionUnit"  | 测量FocalPlaneXResolution和FocalPlaneYResolution的单位。<br/>2:"Inch",英寸。<br/>3:"Centimeter",厘米。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2');`<br />或`imageSource.modifyImageProperty(key,'Inch');`<br />**读取结果示例:** "Inch" |
219| SUBJECT_LOCATION<sup>12+</sup>           | "SubjectLocation"           | 主要对象相对于左边缘的位置。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 两个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'123 456');`<br />或`imageSource.modifyImageProperty(key,'123,456');`<br />**读取结果示例:** "123,456" |
220| EXPOSURE_INDEX<sup>12+</sup>             | "ExposureIndex"             | 捕获时选定的曝光指数。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** "1" |
221| SENSING_METHOD<sup>12+</sup>             | "SensingMethod"             | 相机上的图像传感器类型。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'2');`<br />或`imageSource.modifyImageProperty(key,'One-chip color area sensor');`<br />**读取结果示例:** "One-chip color area sensor" |
222| FILE_SOURCE<sup>12+</sup>                | "FileSource"                | 表明图像来源。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'DSC');`<br />**读取结果示例:** "DSC" |
223| SCENE_TYPE<sup>9+</sup>                   | "SceneType"                 | 拍摄场景模式,例如人像、风光、运动、夜景等。<br/>1:"Directly photographed",图像传感器直接拍摄。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Directly photographed');`<br />**读取结果示例:** "Directly photographed" |
224| CFA_PATTERN<sup>12+</sup>                | "CFAPattern"                | 图像传感器的色彩滤光片(CFA)几何图案。<br/>**读写能力:** 可读写。<br> | 该字段为特有格式,虽然支持读写,但目前版本不做解析。 |
225| CUSTOM_RENDERED<sup>12+</sup>            | "CustomRendered"       | 指示图像数据上的特殊处理。<br/>0:"Normal process",正常处理(未自定义渲染)。<br/>1:"Custom process",自定义处理(如艺术效果、美颜、HDR)。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Custom process');`<br />**读取结果示例:** "Custom process" |
226| EXPOSURE_MODE<sup>12+</sup>              | "ExposureMode"         | 拍摄时设置的曝光模式。<br/>0:"Auto exposure",自动曝光(Auto)。<br/>1:"Manual exposure",手动曝光(Manual)。<br/>2:"Auto bracket",自动曝光优先(Auto bracket)。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Auto exposure');`<br />**读取结果示例:** "Auto exposure" |
227| WHITE_BALANCE<sup>10+</sup>              | "WhiteBalance"         | 白平衡。<br/>0:"Auto white balance",自动白平衡。<br/>1:"Manual white balance",手动白平衡。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Auto white balance');`<br />**读取结果示例:** "Auto white balance" |
228| DIGITAL_ZOOM_RATIO<sup>12+</sup>         | "DigitalZoomRatio"     | 捕获时的数字变焦比率。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1/2');`<br />**读取结果示例:** "0.5" |
229| FOCAL_LENGTH_IN_35_MM_FILM<sup>10+</sup> | "FocalLengthIn35mmFilm" | 焦距35毫米胶片。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负整数字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'50');`<br />**读取结果示例:** "50" |
230| SCENE_CAPTURE_TYPE<sup>12+</sup>         | "SceneCaptureType"     | 捕获的场景类型。<br/>0:"Standard",标准。<br/>1:"Landscape",风景。<br/>2:"Portrait",人像。<br/>3:"Night scene",夜景。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:**  修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Standard');`<br />**读取结果示例:** "Standard" |
231| GAIN_CONTROL<sup>12+</sup>               | "GainControl"          | 整体图像增益调整的程度。<br/>0:"Normal",无增益控制。<br />1:"Low gain up",低增益提升。<br />2:"High gain up",高增益提升。<br/>3:"Low gain down", 低增益降低。<br />4:"High gain down",高增益降低。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:**  修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Normal');`<br />**读取结果示例:** "Normal" |
232| CONTRAST<sup>12+</sup>                   | "Contrast"             | 相机应用的对比度处理方向。<br/>0:"Normal",正常对比度。<br/>1:"Soft",软对比度。<br/>2:"Hard",硬对比度。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Normal');`<br />**读取结果示例:** "Normal" |
233| SATURATION<sup>12+</sup>                 | "Saturation"           | 相机应用的饱和度处理方向。<br/>0:"Normal",正常。<br/>1:"Low saturation",低饱和度。<br/>2:"High saturation",高饱和度。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Normal');`<br />**读取结果示例:** "Normal" |
234| SHARPNESS<sup>12+</sup>                  | "Sharpness"            | 相机应用的锐度处理方向。<br/>0:"Normal",正常(Normal)。<br/>1:"Soft",柔和(Soft)。<br/>2:"Hard",硬(Hard)。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'0');`<br />或`imageSource.modifyImageProperty(key,'Normal');`<br />**读取结果示例:** "Normal" |
235| DEVICE_SETTING_DESCRIPTION<sup>12+</sup> | "DeviceSettingDescription" | 特定相机模型的拍照条件信息。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Device Setting Description');`<br />**读取结果示例:** "Device Setting Description" |
236| SUBJECT_DISTANCE_RANGE<sup>12+</sup>     | "SubjectDistanceRange" | 表示主体到相机的距离范围。<br/>0:"Unknown",未知。<br/>1:"Macro",宏观。<br/>2:"Close view",近景。<br/>3:"Distant view",远景。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 修改时传入相应的数字或者字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'Macro');`<br />**读取结果示例:** "Macro" |
237| IMAGE_UNIQUE_ID<sup>12+</sup>            | "ImageUniqueID"        | 为每张图片唯一分配的标识符。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Image Unique ID');`<br />**读取结果示例:** "Image Unique ID" |
238| CAMERA_OWNER_NAME<sup>12+</sup>          | "CameraOwnerName"      | 相机所有者的姓名。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Camera Owner Name');`<br />**读取结果示例:** "Camera Owner Name" |
239| BODY_SERIAL_NUMBER<sup>12+</sup>         | "BodySerialNumber"     | 相机机身的序列号。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Body Serial Number');`<br />**读取结果示例:** "Body Serial Number" |
240| LENS_SPECIFICATION<sup>12+</sup>         | "LensSpecification"    | 使用的镜头规格。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 四个非负有理数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'12 12 12 12');`或`imageSource.modifyImageProperty(key,'12,12,12,12');`<br />**读取结果示例:** "12,12,12,12" |
241| LENS_MAKE<sup>12+</sup>                  | "LensMake"             | 镜头的制造商。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Lens Make');`<br />**读取结果示例:** "Lens Make" |
242| LENS_MODEL<sup>12+</sup>                 | "LensModel"            | 镜头的型号名称。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Lens Model');`<br />**读取结果示例:** "Lens Model" |
243| LENS_SERIAL_NUMBER<sup>12+</sup>         | "LensSerialNumber"     | 镜头的序列号。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Lens Serial Number');`<br />**读取结果示例:** "Lens Serial Number" |
244| COMPOSITE_IMAGE<sup>12+</sup>            | "CompositeImage"      | 表示图像是否为合成图像。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1');`<br />或`imageSource.modifyImageProperty(key,'NonComposite');`<br />**读取结果示例:** "1" |
245| SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE<sup>12+</sup>   | "SourceImageNumberOfCompositeImage" | 用于合成图像的源图像数量。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 两个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'1 5');`<br />或`imageSource.modifyImageProperty(key,'1,5');`<br />**读取结果示例:** "1,5" |
246| SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE<sup>12+</sup> | "SourceExposureTimesOfCompositeImage" | 合成图像的源图像曝光时间。<br/>**读写能力:** 可读写。<br> | **修改传参格式说明:** 字符串。<br />**修改示例:**`imageSource.modifyImageProperty(key,'Source Exposure Times Of CompositeImage');`<br />**读取结果示例:** "Source Exposure Times Of CompositeImage" |
247| GAMMA<sup>12+</sup>                      | "Gamma"                | 表示系数伽马的值。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 非负有理数字符串。<br />**修改示例:**<br />`imageSource.modifyImageProperty(key,'1');`<br />**读取结果示例:** "1" |
248| DNG_VERSION<sup>12+</sup>                | "DNGVersion"                | DNG版本标签编码了符合DNG规范的四级版本号。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 四个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**<br />`imageSource.modifyImageProperty(key,'1 1 1 1');`<br />或`imageSource.modifyImageProperty(key,'1,1,1,1');`<br />**读取结果示例:** "1,1,1,1" |
249| DEFAULT_CROP_SIZE<sup>12+</sup>          | "DefaultCropSize"           | DefaultCropSize指定了原始坐标中的最终图像大小,考虑了额外的边缘像素。<br />**读写能力:** 可读写。<br> | **修改传参格式说明:** 两个非负整数字符串,空格或者英文逗号隔开。<br />**修改示例:**`imageSource.modifyImageProperty(key,'400 400');`<br />或`imageSource.modifyImageProperty(key,'400,400');`<br />**读取结果示例:** "400,400" |
250| GIF_LOOP_COUNT<sup>12+</sup>             | "GIFLoopCount"              | GIF图片循环次数。0表示无限循环,其他值表示循环次数。<br />**读写能力:** 只读。<br> | _ |
251| IS_XMAGE_SUPPORTED<sup>12+</sup> | "HwMnoteIsXmageSupported" | 是否支持XMAGE。<br />**读写能力:** 可读写。<br> | _ |
252| XMAGE_MODE<sup>12+</sup> | "HwMnoteXmageMode" | XMAGE水印模式。<br />**读写能力:** 可读写。<br> | _ |
253| XMAGE_LEFT<sup>12+</sup> | "HwMnoteXmageLeft" | 水印区域X1坐标。<br />**读写能力:** 可读写。<br> | _ |
254| XMAGE_TOP<sup>12+</sup> | "HwMnoteXmageTop" | 水印区域Y1坐标。<br />**读写能力:** 可读写。<br> | _ |
255| XMAGE_RIGHT<sup>12+</sup> | "HwMnoteXmageRight" | 水印区域X2坐标。<br />**读写能力:** 可读写。<br> | _ |
256| XMAGE_BOTTOM<sup>12+</sup> | "HwMnoteXmageBottom" | 水印区域Y2坐标。<br />**读写能力:** 可读写。<br> | _ |
257| CLOUD_ENHANCEMENT_MODE<sup>12+</sup> | "HwMnoteCloudEnhancementMode" | 云增强模式。<br />**读写能力:** 可读写。<br> | _ |
258| WIND_SNAPSHOT_MODE<sup>12+</sup> | "HwMnoteWindSnapshotMode" | 运动快拍模式。<br />**读写能力:** 只读。<br> | _ |
259| SCENE_POINTER<sup>12+</sup> | "HwMnoteScenePointer" | 场景指针。<br />**读写能力:** 只读。<br> | _ |
260| SCENE_VERSION<sup>12+</sup> | "HwMnoteSceneVersion" | 场景算法版本信息。<br />**读写能力:** 只读。<br> | _ |
261| SCENE_FOOD_CONF<sup>11+</sup> | "HwMnoteSceneFoodConf" | 拍照场景:食物。<br />**读写能力:** 只读。<br> | _ |
262| SCENE_STAGE_CONF<sup>11+</sup> | "HwMnoteSceneStageConf" | 拍照场景:舞台。<br />**读写能力:** 只读。<br> | _ |
263| SCENE_BLUE_SKY_CONF<sup>11+</sup> | "HwMnoteSceneBlueSkyConf" | 拍照场景:蓝天。<br />**读写能力:** 只读。<br> | _ |
264| SCENE_GREEN_PLANT_CONF<sup>11+</sup> | "HwMnoteSceneGreenPlantConf" | 拍照场景:绿植。<br />**读写能力:** 只读。<br> | _ |
265| SCENE_BEACH_CONF<sup>11+</sup> | "HwMnoteSceneBeachConf" | 拍照场景:沙滩。<br />**读写能力:** 只读。<br> | _ |
266| SCENE_SNOW_CONF<sup>11+</sup> | "HwMnoteSceneSnowConf" | 拍照场景:下雪。<br />**读写能力:** 只读。<br> | _ |
267| SCENE_SUNSET_CONF<sup>11+</sup> | "HwMnoteSceneSunsetConf" | 拍照场景:日落。<br />**读写能力:** 只读。<br> | _ |
268| SCENE_FLOWERS_CONF<sup>11+</sup> | "HwMnoteSceneFlowersConf" | 拍照场景:花。<br />**读写能力:** 只读。<br> | _ |
269| SCENE_NIGHT_CONF<sup>11+</sup> | "HwMnoteSceneNightConf" | 拍照场景:夜晚。<br />**读写能力:** 只读。<br> | _ |
270| SCENE_TEXT_CONF<sup>11+</sup> | "HwMnoteSceneTextConf" | 拍照场景:文本。<br />**读写能力:** 只读。<br> | _ |
271| FACE_POINTER<sup>12+</sup> | "HwMnoteFacePointer" | 脸部指针。<br />**读写能力:** 只读。<br> | _ |
272| FACE_VERSION<sup>12+</sup> | "HwMnoteFaceVersion" | 人脸算法版本信息。<br />**读写能力:** 只读。<br> | _ |
273| FACE_COUNT<sup>11+</sup> | "HwMnoteFaceCount" | 人脸数量。<br />**读写能力:** 只读。<br> | _ |
274| FACE_CONF<sup>12+</sup> | "HwMnoteFaceConf" | 人脸置信度。<br />**读写能力:** 只读。<br> | _ |
275| FACE_SMILE_SCORE<sup>12+</sup> | "HwMnoteFaceSmileScore" | FaceCount张人脸的笑脸分数。<br />**读写能力:** 只读。<br> | _ |
276| FACE_RECT<sup>12+</sup> | "HwMnoteFaceRect" | 脸部矩形。<br />**读写能力:** 只读。<br> | _ |
277| FACE_LEYE_CENTER<sup>12+</sup> | "HwMnoteFaceLeyeCenter" | 左眼中心。<br />**读写能力:** 只读。<br> | _ |
278| FACE_REYE_CENTER<sup>12+</sup> | "HwMnoteFaceReyeCenter" | 右眼中心。<br />**读写能力:** 只读。<br> | _ |
279| FACE_MOUTH_CENTER<sup>12+</sup> | "HwMnoteFaceMouthCenter" | 嘴中心。<br />**读写能力:** 只读。<br> | _ |
280| CAPTURE_MODE<sup>10+</sup> | "HwMnoteCaptureMode" | 捕获模式。<br />**读写能力:** 可读写。<br> | _ |
281| BURST_NUMBER<sup>12+</sup> | "HwMnoteBurstNumber" | 连拍次数。<br />**读写能力:** 只读。<br> | _ |
282| FRONT_CAMERA<sup>12+</sup> | "HwMnoteFrontCamera" | 是否是前置相机自拍。<br />**读写能力:** 只读。<br> | _ |
283| ROLL_ANGLE<sup>11+</sup> | "HwMnoteRollAngle" | 滚动角度。<br />**读写能力:** 只读。<br> | _ |
284| PITCH_ANGLE<sup>11+</sup> | "HwMnotePitchAngle" | 俯仰角度。<br />**读写能力:** 只读。<br> | _ |
285| PHYSICAL_APERTURE<sup>10+</sup> | "HwMnotePhysicalAperture" | 物理孔径,光圈大小。<br />**读写能力:** 只读。<br> | _ |
286| FOCUS_MODE<sup>11+</sup> | "HwMnoteFocusMode" | 对焦模式。<br />**读写能力:** 只读。<br> | _ |
287
288## FragmentMapPropertyKey<sup>13+</sup>
289
290枚举,水印裁剪图图片信息。
291
292**系统能力:** SystemCapability.Multimedia.Image.Core
293
294| 名称          | 值                    | 说明                                |
295| ------------- | --------------------- | ----------------------------------- |
296| X_IN_ORIGINAL | "XInOriginal"         | 水印裁剪图左上角在原始图中的X坐标。 |
297| Y_IN_ORIGINAL | "YInOriginal"         | 水印裁剪图左上角在原始图中的Y坐标。 |
298| WIDTH         | "FragmentImageWidth"  | 水印裁剪图的宽。                    |
299| HEIGHT        | "FragmentImageHeight" | 水印裁剪图的高。                    |
300
301## GifPropertyKey<sup>20+</sup>
302
303枚举,GIF图片信息。
304
305**系统能力:** SystemCapability.Multimedia.Image.Core
306
307| 名称              | 值                | 说明                   |
308| ----------------- | ----------------- | --------------------- |
309| GIF_DELAY_TIME    | "GifDelayTime"    | GIF图片的每帧播放时长(单位为毫秒)。 |
310| GIF_DISPOSAL_TYPE | "GifDisposalType" | GIF图片每帧的帧过渡模式。 |
311
312## ImageFormat<sup>9+</sup>
313
314枚举,图片格式。
315
316**系统能力:** SystemCapability.Multimedia.Image.Core
317
318| 名称         |   值   | 说明                 |
319| ------------ | ------ | -------------------- |
320| YCBCR_422_SP | 1000   | YCBCR422半平面格式。 |
321| JPEG         | 2000   | JPEG编码格式。       |
322
323## ComponentType<sup>9+</sup>
324
325枚举,图像的组件类型。
326
327**系统能力:** SystemCapability.Multimedia.Image.ImageReceiver
328
329| 名称  |   值   | 说明        |
330| ----- | ------ | ----------- |
331| YUV_Y | 1      | 亮度信息。  |
332| YUV_U | 2      | 色度信息。  |
333| YUV_V | 3      | 色度信息。  |
334| JPEG  | 4      | JPEG 类型。 |
335
336## DecodingDynamicRange<sup>12+</sup>
337
338描述解码时期望的图像动态范围。
339
340**系统能力:** SystemCapability.Multimedia.Image.Core
341
342| 名称          | 值       | 说明         |
343| ------------- | ----------| ------------ |
344| AUTO          | 0    | 自适应,根据图片信息处理。即如果图片本身为HDR图片,则会按照HDR内容解码;反之按照SDR内容解码。通过[CreateIncrementalSource](arkts-apis-image-f.md#imagecreateincrementalsource9)创建的ImageSource会解码为SDR内容。  |
345| SDR           | 1    | 按照标准动态范围处理图片。   |
346| HDR           | 2    | 按照高动态范围处理图片。通过[CreateIncrementalSource](arkts-apis-image-f.md#imagecreateincrementalsource9)创建的ImageSource会解码为SDR内容。     |
347
348## PackingDynamicRange<sup>12+</sup>
349
350描述编码时期望的图像动态范围。
351
352**系统能力:** SystemCapability.Multimedia.Image.Core
353
354| 名称          | 值       | 说明         |
355| ------------- | ----------| ------------ |
356| AUTO          | 0    | 自适应,根据[pixelmap](arkts-apis-image-PixelMap.md)内容处理。即如果pixelmap本身为HDR,则会按照HDR内容进行编码;反之按照SDR内容编码。  |
357| SDR           | 1    | 按照标准动态范围处理图片。   |
358
359## CropAndScaleStrategy<sup>18+</sup>
360
361枚举,裁剪与缩放的先后策略。
362
363如果在配置解码选项[DecodingOptions](arkts-apis-image-i.md#decodingoptions7)时,未填入参数cropAndScaleStrategy,并且同时设置了参数desiredRegion和desiredSize,由于系统对于不同图片格式采用的解码算法不同,最终解码效果将略有差异。
364
365例如原始图片大小为200x200,传入desiredSize:{width: 150, height: 150},desiredRegion:{x: 0, y: 0, width: 100, height: 100},即预期解码原图左上角1/4区域,最终将pixelMap大小缩放至150x150返回。
366
367对于jpeg、webp图片(部分dng图片解码时会优先解码图片中的jpeg预览图,在此场景下也会被视为jpeg图片格式)会先进行下采样,例如按照7/8下采样,再基于175x175的图片大小进行区域裁剪,因此最终的区域内容稍大于原图的左上角1/4区域。
368
369对于svg图片,由于是矢量图,可以任意缩放不损失清晰度,在解码时会根据desiredSize与原图Size的比例选择缩放比例,在基于缩放后的图片大小进行区域裁剪,因此最终返回的解码区域会有所差异。
370
371针对该场景,建议在解码选项同时设置了desiredRegion与desiredSize时,参数cropAndScaleStrategy应传入CROP_FIRST保证效果一致。
372
373**系统能力:** SystemCapability.Multimedia.Image.Core
374
375| 名称          | 值       | 说明         |
376| ------------- | ----------| ------------ |
377| SCALE_FIRST   | 1    | 解码参数如果同时设置desiredRegion与desiredSize,先根据desiredSize进行缩放,再根据desiredRegion进行区域裁剪。     |
378| CROP_FIRST    | 2    | 解码参数如果同时设置desiredRegion与desiredSize,先根据desiredRegion进行区域裁剪,再根据desiredSize进行缩放。     |
379
380## HdrMetadataKey<sup>12+</sup>
381
382枚举,[pixelmap](arkts-apis-image-PixelMap.md)使用的HDR相关元数据信息的关键字。
383
384**系统能力:** SystemCapability.Multimedia.Image.Core
385
386| 名称          | 值       | 说明         |
387| ------------- | ----------| ------------ |
388| HDR_METADATA_TYPE    | 0    | [pixelmap](arkts-apis-image-PixelMap.md)使用的元数据类型。  |
389| HDR_STATIC_METADATA  | 1    | 静态元数据。   |
390| HDR_DYNAMIC_METADATA | 2    | 动态元数据。   |
391| HDR_GAINMAP_METADATA | 3    | Gainmap使用的元数据。   |
392
393## HdrMetadataType<sup>12+</sup>
394
395枚举,[HdrMetadataKey](#hdrmetadatakey12)中HDR_METADATA_TYPE关键字对应的值。
396
397**系统能力:** SystemCapability.Multimedia.Image.Core
398
399| 名称          | 值       | 说明         |
400| ------------- | ----------| ------------ |
401| NONE     | 0    | 无元数据内容。  |
402| BASE     | 1    | 表示用于基础图的元数据。   |
403| GAINMAP  | 2    | 表示用于Gainmap图的元数据。   |
404| ALTERNATE| 3    | 表示用于合成后HDR图的元数据。   |
405
406## AntiAliasingLevel<sup>12+</sup>
407
408缩放时的缩放算法。
409
410**原子化服务API**:从API version 14 开始,该接口支持在原子化服务中使用。
411
412**系统能力:** SystemCapability.Multimedia.Image.Core
413
414| 名称                   |   值   | 说明              |
415| ---------------------- | ------ | ----------------- |
416| NONE                | 0      | 最近邻插值算法。   |
417| LOW                 | 1      | 双线性插值算法。   |
418| MEDIUM              | 2      | 双线性插值算法,同时开启Mipmap。缩小图片时建议使用。   |
419| HIGH                | 3      | 三次插值算法。   |
420
421## AllocatorType<sup>15+</sup>
422
423枚举,用于图像解码的内存类型。
424
425**系统能力:** SystemCapability.Multimedia.Image.Core
426
427| 名称         | 值   | 说明                               |
428| ------------ | ---- | ---------------------------------- |
429| AUTO         | 0    | 系统决定内存申请方式。     |
430| DMA          | 1    | 使用DMA内存申请方式。            |
431| SHARE_MEMORY | 2    | 使用SHARE_MEMORY的内存申请方式。 |
432