1# Image Kit简介
2
3应用开发中的图片开发是对图片像素数据进行解析、处理、构造的过程，达到目标图片效果，主要涉及图片解码、图片处理、图片编码等。
4
5在学习图片开发前，需要熟悉以下基本概念：
6
7- 图片解码
8
9  指将所支持格式的存档图片解码成统一的PixelMap，以便在应用或系统中进行图片显示或图片处理。
10
11- PixelMap
12
13  指图片解码后无压缩的位图，用于图片显示或图片处理。
14
15- Picture
16
17  多图对象，包含主图与辅助图，用于多图对象的显示或处理。
18
19- 图片处理
20
21  指对PixelMap进行相关的操作，如旋转、缩放、设置透明度、获取图片信息、读写像素数据等。
22
23- 图片编码
24
25  指将PixelMap编码成不同格式的存档图片，用于后续处理，如保存、传输等。
26
27图片开发的主要流程如下图所示。
28
29**图1** 图片开发流程示意图
30
31![Image development process](figures/image-development-process.png)
32
331. 获取图片：通过应用沙箱等方式获取原始图片。
34
352. 创建ImageSource实例：ImageSource是图片解码出来的图片源类，用于获取或修改图片相关信息。
36
373. [图片解码](image-decoding.md)：通过ImageSource解码生成PixelMap。
38
394. [图片处理](image-transformation.md)：对PixelMap进行处理，更改图片属性实现图片的旋转、缩放、裁剪等效果。然后通过[Image组件](../../ui/arkts-graphics-display.md)显示图片。
40
415. [图片编码](image-encoding.md)：使用图片打包器类ImagePacker，将PixelMap或ImageSource进行压缩编码，生成一张新的图片。
42
43除上述基本图片开发能力外，OpenHarmony还提供常用[图片工具](image-tool.md)，供开发者选择使用。
44
45## 亮点/特征
46
47Image Kit编解码支持多种图片格式，并采用了高效的算法和优化策略，提高了图片处理的速度和效率。
48
49## 约束与限制
50
51- **读写权限限制：**
52
53  在图片处理中，可能需要使用用户图片，应用需要向用户申请对应的读写操作权限才能保证功能的正常运行。
54
55- **选择合适的C API接口：**
56
57  图片框架当前提供了两套C API接口，分别为[依赖于JS对象的C API](../../reference/apis-image-kit/image.md)和[不依赖于JS对象的C API](../../reference/apis-image-kit/_image___native_module.md)。
58  - 依赖于JS对象的C接口
59
60    这类接口可以完成图片编解码，图片接收器，处理图像数据等功能，相关示例代码可以参考[图片开发指导(依赖JS对象)(C/C++)](image-decoding-native.md)节点下的内容。开发者可查看[Image](../../reference/apis-image-kit/image.md)模块下的C API，确认API范围。这部分API在API 11之前发布，在后续的版本不再增加新功能。
61
62  - 不依赖于JS对象的C接口
63
64    这类接口除了提供上述图片框架基础功能，还可以完成多图编解码等新特性，相关开发指导请参考[图片开发指导(C/C++)](image-source-c.md)节点下的内容。开发者可查看[Image_NativeModule](../../reference/apis-image-kit/_image___native_module.md)模块下的C API，确认API范围。这部分API从API 12开始支持，并将持续演进，**推荐开发者使用**。
65
66  > **注意：**
67  > 两套C API不建议同时使用，在部分场景下存在不兼容的问题。
68
69## 与相关Kit的关系
70
71图片框架提供图片编解码能力，为Image组件及图库等应用提供支撑，其解码结果可以传给[Image组件](../../ui/arkts-graphics-display.md)显示。
72
73## 相关实例
74
75针对图片开发，有以下相关实例可供参考：
76
77- [图片显示及处理（ArkTS）（API12）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Image)
78
79- [图片显示（ArkTS）（API10）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/ImageShow)
80
81- [图片裁剪与分割（ArkTS）（API10）](https://gitee.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/GamePuzzle)
82