harmony 鸿蒙Enums

2025-06-16
浏览 (2)

Enums

说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

PixelMapFormat⁷⁺

枚举，图片像素格式。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
UNKNOWN	0	未知格式。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
ARGB_8888¹⁸⁺	1	颜色信息由透明度（Alpha）与R（Red），G（Green），B（Blue）四部分组成，每个部分占8位，总共占32位。该格式当前仅支持PixelMap的接口。
RGB_565	2	颜色信息由R（Red），G（Green），B（Blue）三部分组成，R占5位，G占6位，B占5位，总共占16位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
RGBA_8888	3	颜色信息由R（Red），G（Green），B（Blue）与透明度（Alpha）四部分组成，每个部分占8位，总共占32位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
BGRA_8888⁹⁺	4	颜色信息由B（Blue），G（Green），R（Red）与透明度（Alpha）四部分组成，每个部分占8位，总共占32位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
RGB_888⁹⁺	5	颜色信息由R（Red），G（Green），B（Blue）三部分组成，每个部分占8位，总共占24位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
ALPHA_8⁹⁺	6	颜色信息仅包含透明度（Alpha），每个像素占8位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
RGBA_F16⁹⁺	7	颜色信息由R（Red），G（Green），B（Blue）与透明度（Alpha）四部分组成，每个部分占16位，总共占64位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
NV21⁹⁺	8	颜色信息由亮度分量Y和交错排列的色度分量V和U组成，其中Y分量占8位，UV分量因4：2：0采样平均占4位，总共平均占12位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
NV12⁹⁺	9	颜色信息由亮度分量Y和交错排列的色度分量U和V组成，其中Y分量占8位，UV分量因4：2：0采样平均占4位，总共平均占12位。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。卡片能力：从API version 12开始，该接口支持在ArkTS卡片中使用。
RGBA_1010102¹²⁺	10	颜色信息由R（Red），G（Green），B（Blue）与透明度（Alpha）四部分组成，其中R、G、B分别占10位，透明度占2位，总共占32位。
YCBCR_P010¹²⁺	11	颜色信息由亮度分量Y和色度分量Cb与Cr组成，每个分量有效10位，实际存储时，Y平面每个像素占16位数据（10位有效），UV平面交错排列，每4个像素占32位数据（每色度分量10位有效），平均有效占15位。
YCRCB_P010¹²⁺	12	颜色信息由亮度分量Y和色度分量Cr与Cb组成，每个分量有效10位，实际存储时，Y平面每个像素占16位数据（10位有效），UV平面交错排列，每4个像素占32位数据（每色度分量10位有效），平均有效占15位。
ASTC_4x4¹⁸⁺	102	存储格式为 ASTC 4x4 格式，内存使用量仅为 RGBA_8888 的 1/4。该格式仅用于直接显示场景，不支持像素访问或后期处理编辑。

AlphaType⁹⁺

枚举，图像的透明度类型。

卡片能力： 从API version 12开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
UNKNOWN	0	未知透明度。
OPAQUE	1	没有alpha或图片不透明。
PREMUL	2	RGB预乘alpha。
UNPREMUL	3	RGB非预乘alpha。

AuxiliaryPictureType¹³⁺

枚举，辅助图的图像类型。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
GAINMAP	1	增益图，代表了一种增强SDR图像以产生具有可变显示调整能力的HDR图像的机制。它是一组描述如何应用gainmap元数据的组合。
DEPTH_MAP	2	深度图，储存图像的深度数据，通过捕捉每个像素与摄像机之间的距离，提供场景的三维结构信息，通常用于3D重建和场景理解。
UNREFOCUS_MAP	3	人像未对焦的原图，提供了一种在人像拍摄中突出背景模糊效果的方式，能够帮助用户在后期处理中选择焦点区域，增加创作自由度。
LINEAR_MAP	4	线性图，用于提供额外的数据视角或补充信息，通常用于视觉效果的增强，它可以包含场景中光照、颜色或其他视觉元素的线性表示。
FRAGMENT_MAP	5	水印裁剪图，表示在原图中被水印覆盖的区域，该图像用于修复或移除水印影响，恢复图像的完整性和可视性。

MetadataType¹³⁺

枚举，图片元数据类型。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
EXIF_METADATA	1	exif数据。
FRAGMENT_METADATA	2	水印裁剪图元数据。

ScaleMode⁹⁺

枚举，图像的缩放模式。

卡片能力： 从API version 12开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
CENTER_CROP	1	缩放图像以填充目标图像区域并居中裁剪区域外的效果。
FIT_TARGET_SIZE	0	图像适合目标尺寸的效果。

PropertyKey⁷⁺

枚举，Exif（Exchangeable image file format）图片信息。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
NEW_SUBFILE_TYPE ¹²⁺	“NewSubfileType”	读写能力：可读写在Exif中，”NewSubfileType”字段用于标识子文件的数据类型，如全分辨率图像、缩略图或多帧图像的一部分。其值是位掩码，0代表全分辨率图像，1代表缩略图，2代表多帧图像的一部分。
SUBFILE_TYPE ¹²⁺	“SubfileType”	读写能力：可读写此标签指示此子文件中的数据类型。标签已弃用，请使用NewSubfileType替代。
IMAGE_WIDTH	“ImageWidth”	读写能力：可读写图片宽度。
IMAGE_LENGTH	“ImageLength”	读写能力：可读写图片长度。
BITS_PER_SAMPLE	“BitsPerSample”	读写能力：可读写像素各分量的位数，如RGB，3分量，格式是8, 8, 8。
COMPRESSION ¹²⁺	“Compression”	读写能力：可读写图像压缩方案。
PHOTOMETRIC_INTERPRETATION ¹²⁺	“PhotometricInterpretation”	读写能力：可读写像素构成，例如 RGB 或 YCbCr。
IMAGE_DESCRIPTION¹⁰⁺	“ImageDescription”	读写能力：可读写图像信息描述。
MAKE¹⁰⁺	“Make”	读写能力：可读写生产商。
MODEL¹⁰⁺	“Model”	读写能力：可读写设备型号。
STRIP_OFFSETS ¹²⁺	“StripOffsets”	读写能力：可读写每个strip的字节偏移量。
ORIENTATION	“Orientation”	读写能力：可读写图片方向。 1：”Top-left”，图像未旋转。 2：”Top-right”，镜像水平翻转。 3：”Bottom-right”，图像旋转180°。 4：”Bottom-left”，镜像垂直翻转。 5：”Left-top”，镜像水平翻转再顺时针旋转270°。 6：”Right-top”，顺时针旋转90°。 7：”Right-bottom”，镜像水平翻转再顺时针旋转90°。 8：”Left-bottom”，顺时针旋转270°。如果读到未定义值会返回”Unknown Value 0”。获取该属性时会以字符串的形式返回。修改该属性时既可以以数字形式指定，也可以以字符串形式指定。
SAMPLES_PER_PIXEL ¹²⁺	“SamplesPerPixel”	读写能力：可读写每个像素的分量数。由于该标准适用于 RGB 和 YCbCr 图像，因此该标签的值设置为 3。在 JPEG 压缩数据中，使用 JPEG 标记代替该标签。
ROWS_PER_STRIP ¹²⁺	“RowsPerStrip”	读写能力：可读写每个strip的图像数据行数。
STRIP_BYTE_COUNTS ¹²⁺	“StripByteCounts”	读写能力：可读写每个图像数据带的总字节数。
X_RESOLUTION ¹²⁺	“XResolution”	读写能力：可读写图像宽度方向的分辨率。
Y_RESOLUTION ¹²⁺	“YResolution”	读写能力：可读写图像高度方向的分辨率。
PLANAR_CONFIGURATION ¹²⁺	“PlanarConfiguration”	读写能力：可读写表示像素组件的记录格式，chunky格式或是planar格式。
RESOLUTION_UNIT ¹²⁺	“ResolutionUnit”	读写能力：可读写用于测量XResolution和YResolution的单位。
TRANSFER_FUNCTION ¹²⁺	“TransferFunction”	读写能力：可读写图像的传递函数，通常用于颜色校正。
SOFTWARE ¹²⁺	“Software”	读写能力：可读写用于生成图像的软件的名称和版本。
DATE_TIME¹⁰⁺	“DateTime”	读写能力：可读写日期时间。格式如2024:01:25 05:51:34。
ARTIST ¹²⁺	“Artist”	读写能力：可读写创建图像的用户名称。
WHITE_POINT ¹²⁺	“WhitePoint”	读写能力：可读写图像的白点色度。
PRIMARY_CHROMATICITIES ¹²⁺	“PrimaryChromaticities”	读写能力：可读写图像的主要颜色的色度。
PHOTO_MODE¹⁰⁺	“PhotoMode”	读写能力：可读写拍照模式。
JPEG_INTERCHANGE_FORMAT ¹²⁺	“JPEGInterchangeFormat”	读写能力：可读写 JPEG压缩缩略图数据开始字节（SOI）的偏移。
JPEG_INTERCHANGE_FORMAT_LENGTH ¹²⁺	“JPEGInterchangeFormatLength”	读写能力：可读写 JPEG压缩缩略图数据的字节数。
YCBCR_COEFFICIENTS ¹²⁺	“YCbCrCoefficients”	读写能力：可读写从RGB到YCbCr图像数据的转换矩阵系数。
YCBCR_SUB_SAMPLING ¹²⁺	“YCbCrSubSampling”	读写能力：可读写色度分量与亮度分量的采样比率。
YCBCR_POSITIONING ¹²⁺	“YCbCrPositioning”	读写能力：可读写色度分量相对于亮度分量的位置。
REFERENCE_BLACK_WHITE ¹²⁺	“ReferenceBlackWhite”	读写能力：可读写参考黑点值和参考白点值。
COPYRIGHT ¹²⁺	“Copyright”	读写能力：可读写图像的版权信息。
EXPOSURE_TIME⁹⁺	“ExposureTime”	读写能力：可读写曝光时间，例如1/33 sec。
F_NUMBER⁹⁺	“FNumber”	读写能力：可读写光圈值，例如f/1.8。
EXPOSURE_PROGRAM ¹²⁺	“ExposureProgram”	读写能力：可读写拍照时相机用来设置曝光的程序的类别。
SPECTRAL_SENSITIVITY ¹²⁺	“SpectralSensitivity”	读写能力：可读写表示所用相机的每个通道的光谱灵敏度。
GPS_VERSION_ID ¹²⁺	“GPSVersionID”	读写能力：可读写 GPSInfoIFD的版本。
GPS_LATITUDE_REF	“GPSLatitudeRef”	读写能力：可读写纬度引用，例如N或S。
GPS_LATITUDE	“GPSLatitude”	读写能力：可读写图片纬度。修改时应按”度,分,秒”格式传入，如”39,54,7.542”
GPS_LONGITUDE_REF	“GPSLongitudeRef”	读写能力：可读写经度引用，例如W或E。
GPS_LONGITUDE	“GPSLongitude”	读写能力：可读写图片经度。修改时应按”度,分,秒”格式传入，如”116,19,42.16”
GPS_ALTITUDE_REF ¹²⁺	“GPSAltitudeRef”	读写能力：可读写用于GPS高度的参照高度。
GPS_ALTITUDE ¹²⁺	“GPSAltitude”	读写能力：可读写基于GPSAltitudeRef的高度。
GPS_TIME_STAMP¹⁰⁺	“GPSTimeStamp”	读写能力：可读写 GPS时间戳。
GPS_SATELLITES ¹²⁺	“GPSSatellites”	读写能力：可读写用于测量的GPS卫星。
GPS_STATUS ¹²⁺	“GPSStatus”	读写能力：可读写录制图像时GPS接收器的状态。
GPS_MEASURE_MODE ¹²⁺	“GPSMeasureMode”	读写能力：可读写 GPS测量模式。
GPS_DOP ¹²⁺	“GPSDOP”	读写能力：可读写 GPS DOP（数据精度等级）。
GPS_SPEED_REF ¹²⁺	“GPSSpeedRef”	读写能力：可读写用来表示GPS接收器移动速度的单位。
GPS_SPEED ¹²⁺	“GPSSpeed”	读写能力：可读写 GPS接收器的移动速度。
GPS_TRACK_REF ¹²⁺	“GPSTrackRef”	读写能力：可读写 GPS接收机移动方向的参照。
GPS_TRACK ¹²⁺	“GPSTrack”	读写能力：可读写 GPS接收机的移动方向。
GPS_IMG_DIRECTION_REF ¹²⁺	“GPSImgDirectionRef”	读写能力：可读写图像方向的参照。
GPS_IMG_DIRECTION ¹²⁺	“GPSImgDirection”	读写能力：可读写拍摄时图像的方向。
GPS_MAP_DATUM ¹²⁺	“GPSMapDatum”	读写能力：可读写 GPS接收器使用的大地测量数据。
GPS_DEST_LATITUDE_REF ¹²⁺	“GPSDestLatitudeRef”	读写能力：可读写目的地点的纬度参照。
GPS_DEST_LATITUDE ¹²⁺	“GPSDestLatitude”	读写能力：可读写目的地点的纬度。
GPS_DEST_LONGITUDE_REF ¹²⁺	“GPSDestLongitudeRef”	读写能力：可读写目的地点的经度参照。
GPS_DEST_LONGITUDE ¹²⁺	“GPSDestLongitude”	读写能力：可读写目的地点的经度。
GPS_DEST_BEARING_REF ¹²⁺	“GPSDestBearingRef”	读写能力：可读写指向目的地点的方位参照。
GPS_DEST_BEARING ¹²⁺	“GPSDestBearing”	读写能力：可读写目的地方位。
GPS_DEST_DISTANCE_REF ¹²⁺	“GPSDestDistanceRef”	读写能力：可读写目标点距离的测量单位。
GPS_DEST_DISTANCE ¹²⁺	“GPSDestDistance”	读写能力：可读写到目的地点的距离。
GPS_PROCESSING_METHOD ¹²⁺	“GPSProcessingMethod”	读写能力：可读写记录定位方法名的字符字符串。
GPS_AREA_INFORMATION ¹²⁺	“GPSAreaInformation”	读写能力：可读写记录GPS区域名的字符字符串。
GPS_DATE_STAMP¹⁰⁺	“GPSDateStamp”	读写能力：可读写 GPS日期戳。
GPS_DIFFERENTIAL ¹²⁺	“GPSDifferential”	读写能力：可读写此字段表示GPS数据是否应用了差分校正，对于精确的位置准确性至关重要。
GPS_H_POSITIONING_ERROR ¹²⁺	“GPSHPositioningError”	读写能力：可读写此标签指示水平定位误差，单位为米。
ISO_SPEED_RATINGS⁹⁺	“ISOSpeedRatings”	读写能力：可读写 ISO感光度，例如400。
PHOTOGRAPHIC_SENSITIVITY ¹²⁺	“PhotographicSensitivity”	读写能力：可读写此标签指示拍摄图像时相机或输入设备的灵敏度。
OECF ¹²⁺	“OECF”	读写能力：可读写表示ISO 14524中规定的光电转换函数（OECF）。
SENSITIVITY_TYPE¹⁰⁺	“SensitivityType”	读写能力：可读写灵敏度类型。
STANDARD_OUTPUT_SENSITIVITY¹⁰⁺	“StandardOutputSensitivity”	读写能力：可读写标准输出灵敏度。
RECOMMENDED_EXPOSURE_INDEX¹⁰⁺	“RecommendedExposureIndex”	读写能力：可读写推荐曝光指数。
ISO_SPEED¹⁰⁺	“ISOSpeedRatings”	读写能力：可读写 ISO速度等级。
ISO_SPEED_LATITUDE_YYY ¹²⁺	“ISOSpeedLatitudeyyy”	读写能力：可读写该标签指示摄像机或输入设备的ISO速度纬度yyy值，该值在ISO 12232中定义。
ISO_SPEED_LATITUDE_ZZZ ¹²⁺	“ISOSpeedLatitudezzz”	读写能力：可读写该标签指示摄像机或输入设备的ISO速度纬度zzz值，该值在ISO 12232中定义。
EXIF_VERSION ¹²⁺	“ExifVersion”	读写能力：可读写支持的Exif标准版本。
DATE_TIME_ORIGINAL⁹⁺	“DateTimeOriginal”	读写能力：可读写拍摄时间，例如2022:09:06 15:48:00。
DATE_TIME_DIGITIZED ¹²⁺	“DateTimeDigitized”	读写能力：可读写图像作为数字数据存储的日期和时间，格式为YYYY:MM:DD HH:MM:SS
OFFSET_TIME ¹²⁺	“OffsetTime”	读写能力：可读写在Exif中，OffsetTime字段表示与UTC（协调世界时）的时间偏移，格式为±HH:MM，用于确定照片拍摄的本地时间。
OFFSET_TIME_ORIGINAL ¹²⁺	“OffsetTimeOriginal”	读写能力：可读写此标签记录原始图像创建时的UTC偏移量，对于时间敏感的应用至关重要。
OFFSET_TIME_DIGITIZED ¹²⁺	“OffsetTimeDigitized”	读写能力：可读写此标签记录图像数字化时的UTC偏移量，有助于准确调整时间戳。
COMPONENTS_CONFIGURATION ¹²⁺	“ComponentsConfiguration”	读写能力：可读写压缩数据的特定信息。
COMPRESSED_BITS_PER_PIXEL ¹²⁺	“CompressedBitsPerPixel”	读写能力：可读写用于压缩图像的压缩模式，单位为每像素位数。
SHUTTER_SPEED ¹²⁺	“ShutterSpeedValue”	读写能力：可读写快门速度，以APEX（摄影曝光的加法系统）值表示。
APERTURE_VALUE¹⁰⁺	“ApertureValue”	读写能力：可读写光圈值。格式如4/1。
BRIGHTNESS_VALUE ¹²⁺	“BrightnessValue”	读写能力：可读写图像的亮度值，以APEX单位表示。
EXPOSURE_BIAS_VALUE¹⁰⁺	“ExposureBiasValue”	读写能力：可读写曝光偏差值。
MAX_APERTURE_VALUE ¹²⁺	“MaxApertureValue”	读写能力：可读写最小F数镜头。
SUBJECT_DISTANCE ¹²⁺	“SubjectDistance”	读写能力：可读写测量单位为米的主体距离。
METERING_MODE¹⁰⁺	“MeteringMode”	读写能力：可读写测光模式。
LIGHT_SOURCE¹⁰⁺	“LightSource”	读写能力：可读写光源。例如Fluorescent。
FLASH ¹⁰⁺	“Flash”	读写能力：可读写闪光灯,记录闪光灯状态。
FOCAL_LENGTH ¹⁰⁺	“FocalLength”	读写能力：可读写焦距。
SUBJECT_AREA ¹²⁺	“SubjectArea”	读写能力：可读写该标签指示整个场景中主要主体的位置和区域。
MAKER_NOTE ¹²⁺	“MakerNote”	读写能力：可读写 Exif/DCF制造商使用的标签，用于记录任何所需信息。在API 12-19，该字段为只读；从API 20开始，该字段可读写。
SCENE_POINTER ¹²⁺	“HwMnoteScenePointer”	读写能力：只读场景指针。
SCENE_VERSION ¹²⁺	“HwMnoteSceneVersion”	读写能力：只读场景算法版本信息。
SCENE_FOOD_CONF¹¹⁺	“HwMnoteSceneFoodConf”	读写能力：只读拍照场景：食物。
SCENE_STAGE_CONF¹¹⁺	“HwMnoteSceneStageConf”	读写能力：只读拍照场景：舞台。
SCENE_BLUE_SKY_CONF¹¹⁺	“HwMnoteSceneBlueSkyConf”	读写能力：只读拍照场景：蓝天。
SCENE_GREEN_PLANT_CONF¹¹⁺	“HwMnoteSceneGreenPlantConf”	读写能力：只读拍照场景：绿植。
SCENE_BEACH_CONF¹¹⁺	“HwMnoteSceneBeachConf”	读写能力：只读拍照场景：沙滩。
SCENE_SNOW_CONF¹¹⁺	“HwMnoteSceneSnowConf”	读写能力：只读拍照场景：下雪。
SCENE_SUNSET_CONF¹¹⁺	“HwMnoteSceneSunsetConf”	读写能力：只读拍照场景：日落。
SCENE_FLOWERS_CONF¹¹⁺	“HwMnoteSceneFlowersConf”	读写能力：只读拍照场景：花。
SCENE_NIGHT_CONF¹¹⁺	“HwMnoteSceneNightConf”	读写能力：只读拍照场景：夜晚。
SCENE_TEXT_CONF¹¹⁺	“HwMnoteSceneTextConf”	读写能力：只读拍照场景：文本。
FACE_POINTER ¹²⁺	“HwMnoteFacePointer”	读写能力：只读脸部指针。
FACE_VERSION ¹²⁺	“HwMnoteFaceVersion”	读写能力：只读人脸算法版本信息。
FACE_COUNT¹¹⁺	“HwMnoteFaceCount”	读写能力：只读人脸数量。
FACE_CONF ¹²⁺	“HwMnoteFaceConf”	读写能力：只读人脸置信度。
FACE_SMILE_SCORE ¹²⁺	“HwMnoteFaceSmileScore”	读写能力：只读 FaceCount张人脸的笑脸分数。
FACE_RECT ¹²⁺	“HwMnoteFaceRect”	读写能力：只读脸部矩形。
FACE_LEYE_CENTER ¹²⁺	“HwMnoteFaceLeyeCenter”	读写能力：只读左眼中心。
FACE_REYE_CENTER ¹²⁺	“HwMnoteFaceReyeCenter”	读写能力：只读右眼中心。
FACE_MOUTH_CENTER ¹²⁺	“HwMnoteFaceMouthCenter”	读写能力：只读嘴中心。
CAPTURE_MODE ¹⁰⁺	“HwMnoteCaptureMode”	读写能力：可读写捕获模式。
BURST_NUMBER ¹²⁺	“HwMnoteBurstNumber”	读写能力：只读连拍次数。
FRONT_CAMERA ¹²⁺	“HwMnoteFrontCamera”	读写能力：只读是否是前置相机自拍。
ROLL_ANGLE ¹¹⁺	“HwMnoteRollAngle”	读写能力：只读滚动角度。
PITCH_ANGLE¹¹⁺	“HwMnotePitchAngle”	读写能力：只读俯仰角度。
PHYSICAL_APERTURE ¹⁰⁺	“HwMnotePhysicalAperture”	读写能力：只读物理孔径，光圈大小。
FOCUS_MODE¹¹⁺	“HwMnoteFocusMode”	读写能力：只读对焦模式。
USER_COMMENT ¹⁰⁺	“UserComment”	读写能力：可读写用户注释。
SUBSEC_TIME ¹²⁺	“SubsecTime”	读写能力：可读写用于为DateTime标签记录秒的分数的标签。
SUBSEC_TIME_ORIGINAL ¹²⁺	“SubsecTimeOriginal”	读写能力：可读写用于为DateTimeOriginal标签记录秒的分数的标签。
SUBSEC_TIME_DIGITIZED ¹²⁺	“SubsecTimeDigitized”	读写能力：可读写用于为DateTimeDigitized标签记录秒的分数的标签。
FLASHPIX_VERSION ¹²⁺	“FlashpixVersion”	读写能力：可读写该标签表示FPXR文件支持的Flashpix格式版本，增强了设备兼容性。
COLOR_SPACE ¹²⁺	“ColorSpace”	读写能力：可读写色彩空间信息标签，通常记录为色彩空间指定符。
PIXEL_X_DIMENSION ¹⁰⁺	“PixelXDimension”	读写能力：可读写像素X尺寸。
PIXEL_Y_DIMENSION¹⁰⁺	“PixelYDimension”	读写能力：可读写像素Y尺寸。
RELATED_SOUND_FILE ¹²⁺	“RelatedSoundFile”	读写能力：可读写与图像数据相关的音频文件的名称。
FLASH_ENERGY ¹²⁺	“FlashEnergy”	读写能力：可读写图像捕获时的闪光能量，以BCPS表示。
SPATIAL_FREQUENCY_RESPONSE ¹²⁺	“SpatialFrequencyResponse”	读写能力：可读写相机或输入设备的空间频率表。
FOCAL_PLANE_X_RESOLUTION ¹²⁺	“FocalPlaneXResolution”	读写能力：可读写图像宽度中每FocalPlaneResolutionUnit的像素。
FOCAL_PLANE_Y_RESOLUTION ¹²⁺	“FocalPlaneYResolution”	读写能力：可读写图像高度中每FocalPlaneResolutionUnit的像素。
FOCAL_PLANE_RESOLUTION_UNIT ¹²⁺	“FocalPlaneResolutionUnit”	读写能力：可读写测量FocalPlaneXResolution和FocalPlaneYResolution的单位。
SUBJECT_LOCATION ¹²⁺	“SubjectLocation”	读写能力：可读写主要对象相对于左边缘的位置。
EXPOSURE_INDEX ¹²⁺	“ExposureIndex”	读写能力：可读写捕获时选定的曝光指数。
SENSING_METHOD ¹²⁺	“SensingMethod”	读写能力：可读写相机上的图像传感器类型。
FILE_SOURCE ¹²⁺	“FileSource”	读写能力：可读写表明图像来源。
SCENE_TYPE⁹⁺	“SceneType”	读写能力：可读写拍摄场景模式，例如人像、风光、运动、夜景等。
CFA_PATTERN ¹²⁺	“CFAPattern”	读写能力：可读写图像传感器的色彩滤光片（CFA）几何图案。
CUSTOM_RENDERED ¹²⁺	“CustomRendered”	读写能力：可读写指示图像数据上的特殊处理。
EXPOSURE_MODE ¹²⁺	“ExposureMode”	读写能力：可读写拍摄时设置的曝光模式。
WHITE_BALANCE ¹⁰⁺	“WhiteBalance”	读写能力：可读写白平衡。
DIGITAL_ZOOM_RATIO ¹²⁺	“DigitalZoomRatio”	读写能力：可读写捕获时的数字变焦比率。
FOCAL_LENGTH_IN_35_MM_FILM ¹⁰⁺	“FocalLengthIn35mmFilm”	读写能力：可读写焦距35毫米胶片。
SCENE_CAPTURE_TYPE ¹²⁺	“SceneCaptureType”	读写能力：可读写捕获的场景类型。
GAIN_CONTROL ¹²⁺	“GainControl”	读写能力：可读写整体图像增益调整的程度。
CONTRAST ¹²⁺	“Contrast”	读写能力：可读写相机应用的对比度处理方向。
SATURATION ¹²⁺	“Saturation”	读写能力：可读写相机应用的饱和度处理方向。
SHARPNESS ¹²⁺	“Sharpness”	读写能力：可读写相机应用的锐度处理方向。
DEVICE_SETTING_DESCRIPTION ¹²⁺	“DeviceSettingDescription”	读写能力：可读写特定相机模型的拍照条件信息。
SUBJECT_DISTANCE_RANGE ¹²⁺	“SubjectDistanceRange”	读写能力：可读写表示主体到相机的距离范围。
IMAGE_UNIQUE_ID ¹²⁺	“ImageUniqueID”	读写能力：可读写为每张图片唯一分配的标识符。
CAMERA_OWNER_NAME ¹²⁺	“CameraOwnerName”	读写能力：可读写相机所有者的姓名。
BODY_SERIAL_NUMBER ¹²⁺	“BodySerialNumber”	读写能力：可读写相机机身的序列号。
LENS_SPECIFICATION ¹²⁺	“LensSpecification”	读写能力：可读写使用的镜头规格。
LENS_MAKE ¹²⁺	“LensMake”	读写能力：可读写镜头的制造商。
LENS_MODEL ¹²⁺	“LensModel”	读写能力：可读写镜头的型号名称。
LENS_SERIAL_NUMBER ¹²⁺	“LensSerialNumber”	读写能力：可读写镜头的序列号。
COMPOSITE_IMAGE ¹²⁺	“CompositeImage”	读写能力：可读写表示图像是否为合成图像。
SOURCE_IMAGE_NUMBER_OF_COMPOSITE_IMAGE ¹²⁺	“SourceImageNumberOfCompositeImage”	读写能力：可读写用于合成图像的源图像数量。
SOURCE_EXPOSURE_TIMES_OF_COMPOSITE_IMAGE ¹²⁺	“SourceExposureTimesOfCompositeImage”	读写能力：可读写合成图像的源图像曝光时间。
GAMMA ¹²⁺	“Gamma”	读写能力：可读写表示系数伽马的值。
DNG_VERSION ¹²⁺	“DNGVersion”	读写能力：可读写 DNG版本标签编码了符合DNG规范的四级版本号。
DEFAULT_CROP_SIZE ¹²⁺	“DefaultCropSize”	读写能力：可读写 DefaultCropSize指定了原始坐标中的最终图像大小，考虑了额外的边缘像素。
GIF_LOOP_COUNT ¹²⁺	“GIFLoopCount”	读写能力：只读 GIF图片循环次数。0表示无限循环，其他值表示循环次数。
IS_XMAGE_SUPPORTED ¹²⁺	“HwMnoteIsXmageSupported”	读写能力：可读写是否支持XMAGE。
XMAGE_MODE ¹²⁺	“HwMnoteXmageMode”	读写能力：可读写 XMAGE水印模式。
XMAGE_LEFT ¹²⁺	“HwMnoteXmageLeft”	读写能力：可读写水印区域X1坐标。
XMAGE_TOP ¹²⁺	“HwMnoteXmageTop”	读写能力：可读写水印区域Y1坐标。
XMAGE_RIGHT ¹²⁺	“HwMnoteXmageRight”	读写能力：可读写水印区域X2坐标。
XMAGE_BOTTOM ¹²⁺	“HwMnoteXmageBottom”	读写能力：可读写水印区域Y2坐标。
CLOUD_ENHANCEMENT_MODE ¹²⁺	“HwMnoteCloudEnhancementMode”	读写能力：可读写云增强模式。
WIND_SNAPSHOT_MODE ¹²⁺	“HwMnoteWindSnapshotMode”	读写能力：只读运动快拍模式。

FragmentMapPropertyKey¹³⁺

枚举，水印裁剪图图片信息。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
X_IN_ORIGINAL	“XInOriginal”	水印裁剪图左上角在原始图中的X坐标。
Y_IN_ORIGINAL	“YInOriginal”	水印裁剪图左上角在原始图中的Y坐标。
WIDTH	“FragmentImageWidth”	水印裁剪图的宽。
HEIGHT	“FragmentImageHeight”	水印裁剪图的高。

ImageFormat⁹⁺

枚举，图片格式。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
YCBCR_422_SP	1000	YCBCR422半平面格式。
JPEG	2000	JPEG编码格式。

ComponentType⁹⁺

枚举，图像的组件类型。

系统能力： SystemCapability.Multimedia.Image.ImageReceiver

名称	值	说明
YUV_Y	1	亮度信息。
YUV_U	2	色度信息。
YUV_V	3	色度信息。
JPEG	4	JPEG 类型。

DecodingDynamicRange¹²⁺

描述解码时期望的图像动态范围。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
AUTO	0	自适应，根据图片信息处理。即如果图片本身为HDR图片，则会按照HDR内容解码；反之按照SDR内容解码。通过CreateIncrementalSource创建的imagesource会解码为SDR内容。
SDR	1	按照标准动态范围处理图片。
HDR	2	按照高动态范围处理图片。通过CreateIncrementalSource创建的imagesource会解码为SDR内容。

PackingDynamicRange¹²⁺

描述编码时期望的图像动态范围。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
AUTO	0	自适应，根据pixelmap内容处理。即如果pixelmap本身为HDR，则会按照HDR内容进行编码；反之按照SDR内容编码。
SDR	1	按照标准动态范围处理图片。

CropAndScaleStrategy¹⁸⁺

枚举，裁剪与缩放的先后策略。

如果在配置解码选项DecodingOptions时，未填入参数cropAndScaleStrategy，并且同时设置了参数desiredRegion和desiredSize，由于系统对于不同图片格式采用的解码算法不同，最终解码效果将略有差异。

例如原始图片大小为200x200，传入desiredSize:{width: 150, height: 150}，desiredRegion:{x: 0, y: 0, width: 100, height: 100}，即预期解码原图左上角1/4区域，最终将pixelMap大小缩放至150x150返回。

对于jpeg、webp图片（部分dng图片解码时会优先解码图片中的jpeg预览图，在此场景下也会被视为jpeg图片格式）会先进行下采样，例如按照7/8下采样，再基于175x175的图片大小进行区域裁剪，因此最终的区域内容稍大于原图的左上角1/4区域。

对于svg图片，由于是矢量图，可以任意缩放不损失清晰度，在解码时会根据desiredSize与原图Size的比例选择缩放比例，在基于缩放后的图片大小进行区域裁剪，因此最终返回的解码区域会有所差异。

针对该场景，建议在解码选项同时设置了desiredRegion与desiredSize时，参数cropAndScaleStrategy应传入CROP_FIRST保证效果一致。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
SCALE_FIRST	1	解码参数如果同时设置desiredRegion与desiredSize，先根据desiredSize进行缩放，再根据desiredRegion进行区域裁剪。
CROP_FIRST	2	解码参数如果同时设置desiredRegion与desiredSize，先根据desiredRegion进行区域裁剪，再根据desiredSize进行缩放。

HdrMetadataKey¹²⁺

枚举，pixelmap使用的HDR相关元数据信息的关键字。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
HDR_METADATA_TYPE	0	pixelmap使用的元数据类型。
HDR_STATIC_METADATA	1	静态元数据。
HDR_DYNAMIC_METADATA	2	动态元数据。
HDR_GAINMAP_METADATA	3	Gainmap使用的元数据。

HdrMetadataType¹²⁺

枚举，HdrMetadataKey中HDR_METADATA_TYPE关键字对应的值。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
NONE	0	无元数据内容。
BASE	1	表示用于基础图的元数据。
GAINMAP	2	表示用于Gainmap图的元数据。
ALTERNATE	3	表示用于合成后HDR图的元数据。

AntiAliasingLevel¹²⁺

缩放时的缩放算法。

原子化服务API：从API version 14 开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
NONE	0	最近邻插值算法。
LOW	1	双线性插值算法。
MEDIUM	2	双线性插值算法，同时开启Mipmap。缩小图片时建议使用。
HIGH	3	三次插值算法。

AllocatorType¹⁵⁺

枚举，用于图像解码的内存类型。

系统能力： SystemCapability.Multimedia.Image.Core

名称	值	说明
AUTO	0	系统决定内存申请方式。
DMA	1	使用DMA内存申请方式。
SHARE_MEMORY	2	使用SHARE_MEMORY的内存申请方式。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Image Kit（图片处理服务）

harmony 鸿蒙Interface (AuxiliaryPicture)

harmony 鸿蒙Interface (Image)

harmony 鸿蒙Interface (ImageCreator)

harmony 鸿蒙Interface (ImagePacker)

harmony 鸿蒙Interface (ImageReceiver)

harmony 鸿蒙Interface (ImageSource)

harmony 鸿蒙Interface (Metadata)

harmony 鸿蒙Interface (Picture)

harmony 鸿蒙Interface (PixelMap)

0 赞

所属分类： 后端技术
本文标签： 软件鸿蒙
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/0HC47b

harmony 鸿蒙Enums

Enums

PixelMapFormat⁷⁺

AlphaType⁹⁺

AuxiliaryPictureType¹³⁺

MetadataType¹³⁺

ScaleMode⁹⁺

PropertyKey⁷⁺

FragmentMapPropertyKey¹³⁺

ImageFormat⁹⁺

ComponentType⁹⁺

DecodingDynamicRange¹²⁺

PackingDynamicRange¹²⁺

CropAndScaleStrategy¹⁸⁺

HdrMetadataKey¹²⁺

HdrMetadataType¹²⁺

AntiAliasingLevel¹²⁺

AllocatorType¹⁵⁺

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

harmony 鸿蒙Enums

Enums

PixelMapFormat7+

AlphaType9+

AuxiliaryPictureType13+

MetadataType13+

ScaleMode9+

PropertyKey7+

FragmentMapPropertyKey13+

ImageFormat9+

ComponentType9+

DecodingDynamicRange12+

PackingDynamicRange12+

CropAndScaleStrategy18+

HdrMetadataKey12+

HdrMetadataType12+

AntiAliasingLevel12+

AllocatorType15+

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

PixelMapFormat⁷⁺

AlphaType⁹⁺

AuxiliaryPictureType¹³⁺

MetadataType¹³⁺

ScaleMode⁹⁺

PropertyKey⁷⁺

FragmentMapPropertyKey¹³⁺

ImageFormat⁹⁺

ComponentType⁹⁺

DecodingDynamicRange¹²⁺

PackingDynamicRange¹²⁺

CropAndScaleStrategy¹⁸⁺

HdrMetadataKey¹²⁺

HdrMetadataType¹²⁺

AntiAliasingLevel¹²⁺

AllocatorType¹⁵⁺