Image Kit简介

应用开发中的图片开发是对图片像素数据进行解析、处理、构造的过程，达到目标图片效果，主要涉及图片解码、图片处理、图片编码等。

在学习图片开发前，需要熟悉以下基本概念：

• 图片解码

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

• PixelMap

  指图片解码后无压缩的位图，用于图片显示或图片处理。

• Picture

  多图对象，包含主图与辅助图，用于多图对象的显示或处理。

• 图片处理

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

• 图片编码

  指将PixelMap编码成不同格式的存档图片，用于后续处理，如保存、传输等。

图片开发的主要流程如下图所示。

图1 图片开发流程示意图

1. 获取图片：通过应用沙箱等方式获取原始图片。

2. 创建ImageSource实例：ImageSource是图片解码出来的图片源类，用于获取或修改图片相关信息。

3. 图片解码：通过ImageSource解码生成PixelMap。

4. 图片处理：对PixelMap进行处理，更改图片属性实现图片的旋转、缩放、裁剪等效果。然后通过Image组件显示图片。

5. 图片编码：使用图片打包器类ImagePacker，将PixelMap或ImageSource进行压缩编码，生成一张新的图片。

除上述基本图片开发能力外，OpenHarmony还提供常用图片工具，供开发者选择使用。

亮点/特征

Image Kit编解码支持多种图片格式，并采用了高效的算法和优化策略，提高了图片处理的速度和效率。

约束与限制

• 读写权限限制：

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

• 选择合适的C API接口：

  图片框架当前提供了两套C API接口，分别为依赖于JS对象的C API和不依赖于JS对象的C API。

  • 依赖于JS对象的C接口

    这类接口可以完成图片编解码，图片接收器，处理图像数据等功能，相关示例代码可以参考图片开发指导(依赖JS对象)(C/C++)节点下的内容。开发者可查看Image模块下的C API，确认API范围。这部分API在API 11之前发布，在后续的版本不再增加新功能。

  • 不依赖于JS对象的C接口

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

  注意： 两套C API不建议同时使用，在部分场景下存在不兼容的问题。

与相关Kit的关系

图片框架提供图片编解码能力，为Image组件及图库等应用提供支撑，其解码结果可以传给Image组件显示。

相关实例

针对图片开发，有以下相关实例可供参考：

• 图片显示及处理（ArkTS）（API12）

• 图片显示（ArkTS）（API10）

• 图片裁剪与分割（ArkTS）（API10）