1# Image Kit简介 2<!--Kit: Image Kit--> 3<!--Subsystem: Multimedia--> 4<!--Owner: @aulight02--> 5<!--Designer: @liyang_bryan--> 6<!--Tester: @xchaosioda--> 7<!--Adviser: @zengyawen--> 8 9开发者通过调用Image Kit（图片处理服务）提供的接口，可以实现图片的解码、编码、编辑、元数据处理和图片接收等功能。 10 11## 亮点/特征 12 13- 编解码支持HEIF、JPEG、PNG、WebP等主流图片格式。 14- 支持HDR图片编解码，给用户带来更高质量的色彩体验，还可以使用AI能力将SDR图片转换成HDR图片。 15- 提供丰富的图片编辑和处理的能力，包括：图像变换、位图操作、滤镜效果等。 16- 采用了高效的算法和优化策略，提高了图片处理的速度和效率。 17 18## 基础概念 19在开发前，需要了解以下基础概念： 20 21- PixelMap 22 23 位图对象。可用于读取或写入像素数据，可以进行裁剪、缩放、平移、旋转、镜像等操作，并可直接传给[Image组件](../../ui/arkts-graphics-display.md)用于显示。还提供了获取图片信息、获取和设置图片色域、HDR元数据的方法。 24 25- Picture 26 27 多图对象。包含主图、辅助图和元数据。其中，主图包含了主要图像信息；辅助图用于存储与主图相关的附加信息；元数据用于存储与图片相关的其他信息。Picture提供获取主图、合成HDR图、获取辅助图、设置辅助图、获取元数据、设置元数据等方法。 28 29- 图片解码 30 31 将所支持格式的图片文件解码成PixelMap或Picture，以便在应用或系统中进行图片显示或图片处理。 32 33- 图片编辑和处理 34 35 对PixelMap进行相关的操作，如旋转、缩放、设置透明度、获取图片信息、读写像素数据等，操作时坐标系原点为左上角。 36 37- 图片编码 38 39 将PixelMap（或Picture）编码成不同格式的图片文件，用于后续处理，如保存、传输等。 40 41## 使用方式 42 43Image Kit提供了丰富的图片处理能力，开发者可按需灵活使用。既可以完整调用图片解码、编辑处理、编码的全流程；也可以图片解码后不做处理，直接将解码得到的PixelMap传给[Image组件](../../ui/arkts-graphics-display.md)显示。解码、编码过程中均提供了丰富的选项参数，可以满足各种实际开发场景的需求。 44 45Image Kit支持对解码得到的PixelMap进行[位图操作](../image/image-pixelmap-operation.md)，对目标图片中的部分区域进行处理；实现[图像变换](../image/image-transformation.md)，可以对图片做裁剪、缩放、偏移、旋转、翻转、设置透明度等变换。 46 47还可以通过[ImageEffect](../image/image-effect-guidelines.md)为图片添加滤镜效果；使用ImageProcessing进行图片细节增强，色彩空间转换以及HDR图片处理。 48 49Image Kit还提供了读取和编辑图片EXIF信息的能力，可以获取和配置图片文件中的附加属性，如：宽、高、旋转方向等图片基本信息，光圈、焦距等图片拍照参数，经度、纬度等图片GPS信息等。 50 51图片解码和图片编码的流程如图1和图2所示。图片解码得到的PixelMap可以直接用于图片显示、图片编辑和处理。 52 53**图1** 图片解码流程示意图 54 55 56 57**图2** 图片编码流程示意图 58 59 60 61 62## 约束与限制 63 64- **读写权限限制：** 65 66 在图片处理中，可能需要使用用户图片，应用需要向用户申请对应的读写操作权限才能保证功能的正常运行，申请方式请参考[向用户申请授权](../../security/AccessToken/request-user-authorization.md)。 67 68- **选择合适的C API接口：** 69 70 Image Kit当前提供了两套C API接口，分别为[依赖于JS对象的C API](../../reference/apis-image-kit/capi-image.md)和[不依赖于JS对象的C API](../../reference/apis-image-kit/capi-image-nativemodule.md)。 71 - 依赖于JS对象的C接口 72 73 这类接口可以完成图片编解码，图片接收器，处理图像数据等功能，相关示例代码可以参考[图片开发指导(依赖JS对象)(C/C++)](image-decoding-native.md)节点下的内容。开发者可查看[Image](../../reference/apis-image-kit/capi-image.md)模块下的C API，确认API范围。这部分API在API 11之前发布，在后续的版本不再增加新功能，**不再推荐使用**。 74 75 - 不依赖于JS对象的C接口 76 77 这类接口除了提供上述图片框架基础功能，还可以完成多图编解码等新特性，相关开发指导请参考[图片开发指导(C/C++)](image-source-c.md)节点下的内容。开发者可查看[Image_NativeModule](../../reference/apis-image-kit/capi-image-nativemodule.md)模块下的C API，确认API范围。这部分API从API 12开始支持，并将持续演进，**推荐开发者使用**。 78 79 > **注意：** 80 > 两套C API不建议同时使用，在部分场景下存在不兼容的问题。 81 82## 与相关Kit的关系 83 84Image Kit提供图片编解码、图片接收、图片编辑和处理等能力，为Image组件、图库以及其他有图片相关需求的应用提供支撑。图片解码得到的PixelMap可以传给[Image组件](../../ui/arkts-graphics-display.md)显示。通过ImageReceiver（图片接收）可以实现[相机预览流二次处理](../camera/native-camera-preview-imageReceiver.md)。 85 86## 相关实例 87 88针对图片开发，有以下相关实例可供参考： 89 90- [图片显示及处理（ArkTS）（API12）](https://gitcode.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/Image) 91 92- [图片显示（ArkTS）（API10）](https://gitcode.com/openharmony/applications_app_samples/tree/master/code/BasicFeature/Media/ImageShow) 93 94- [图片裁剪与分割（ArkTS）（API10）](https://gitcode.com/openharmony/applications_app_samples/tree/master/code/SystemFeature/Media/GamePuzzle) 95
