harmony 鸿蒙Image Kit简介

2025-06-12
浏览 (7)

Image Kit简介

开发者通过调用Image Kit（图片处理服务）提供的接口，可以实现图片的解码、编码、编辑、元数据处理和图片接收等功能。

亮点/特征

编解码支持HEIF、JPEG、PNG、WebP等主流图片格式。
支持HDR图片编解码，给用户带来更高质量的色彩体验，还可以使用AI能力将SDR图片转换成HDR图片。
提供丰富的图片编辑和处理的能力，包括：图像变换、位图操作、滤镜效果等。
采用了高效的算法和优化策略，提高了图片处理的速度和效率。

基础概念

在开发前，需要了解以下基础概念：

PixelMap

位图对象。可用于读取或写入像素数据，可以进行裁剪、缩放、平移、旋转、镜像等操作，并可直接传给Image组件用于显示。还提供了获取图片信息、获取和设置图片色域、HDR元数据的方法。

Picture

多图对象。包含主图、辅助图和元数据。其中，主图包含了主要图像信息；辅助图用于存储与主图相关的附加信息；元数据用于存储与图片相关的其他信息。Picture提供获取主图、合成HDR图、获取辅助图、设置辅助图、获取元数据、设置元数据等方法。

图片解码

将所支持格式的图片文件解码成PixelMap或Picture，以便在应用或系统中进行图片显示或图片处理。

图片编辑和处理

对PixelMap进行相关的操作，如旋转、缩放、设置透明度、获取图片信息、读写像素数据等，操作时坐标系原点为左上角。

图片编码

将PixelMap（或Picture）编码成不同格式的图片文件，用于后续处理，如保存、传输等。

使用方式

Image Kit提供了丰富的图片处理能力，开发者可按需灵活使用。既可以完整调用图片解码、编辑处理、编码的全流程；也可以图片解码后不做处理，直接将解码得到的PixelMap传给Image组件显示。解码、编码过程中均提供了丰富的选项参数，可以满足各种实际开发场景的需求。

Image Kit支持对解码得到的PixelMap进行位图操作，对目标图片中的部分区域进行处理；实现图像变换，可以对图片做裁剪、缩放、偏移、旋转、翻转、设置透明度等变换。

还可以通过ImageEffect为图片添加滤镜效果；使用ImageProcessing进行图片细节增强，色彩空间转换以及HDR图片处理。

Image Kit还提供了读取和编辑图片EXIF信息的能力，可以获取和配置图片文件中的附加属性，如：宽、高、旋转方向等图片基本信息，光圈、焦距等图片拍照参数，经度、纬度等图片GPS信息等。

图片解码和图片编码的流程如图1和图2所示。图片解码得到的PixelMap可以直接用于图片显示、图片编辑和处理。

图1 图片解码流程示意图

Image development process

图2 图片编码流程示意图

Image development process

约束与限制

读写权限限制：

在图片处理中，可能需要使用用户图片，应用需要向用户申请对应的读写操作权限才能保证功能的正常运行，申请方式请参考向用户申请授权。

选择合适的C API接口：

Image Kit当前提供了两套C API接口，分别为依赖于JS对象的C API和不依赖于JS对象的C API。 - 依赖于JS对象的C接口

这类接口可以完成图片编解码，图片接收器，处理图像数据等功能，相关示例代码可以参考[图片开发指导(依赖JS对象)(C/C++)](image-decoding-native.md)节点下的内容。开发者可查看[Image](https://www.seaxiang.com/blog/7oGplW)模块下的C API，确认API范围。这部分API在API 11之前发布，在后续的版本不再增加新功能，**不再推荐使用**。

不依赖于JS对象的C接口

这类接口除了提供上述图片框架基础功能，还可以完成多图编解码等新特性，相关开发指导请参考图片开发指导(C/C++)节点下的内容。开发者可查看Image_NativeModule模块下的C API，确认API范围。这部分API从API 12开始支持，并将持续演进，推荐开发者使用。