1
2
3# ImageEffect框架
4
5- [简介](#简介)
6  - [基本概念](#基本概念)
7- [目录](#目录)
8- [编译](#编译)
9- [使用说明](#使用说明)
10  - [滤镜链处理](#滤镜链处理)
11  - [单个滤镜处理](#单个滤镜处理)
12  - [自定义滤镜处理](#自定义滤镜处理)
13
14## 简介
15
16图像效果引擎框架提供支持图片编辑业务的开发，开发者可以通过已开放的接口实现图片编辑相关功能的开发。框架提供了单个滤镜处理能力、滤镜链处理能力以及开发者自定义滤镜的处理能力，支持pixelmap、uri、surface等多种输入输出图片数据场景。
17
18**图** 1 图片编辑组件架构图
19
20![](figures/imageeffect-architecture_zh.jpg)
21
22## 功能介绍
23-   滤镜
24    开发者可以通过滤镜的接口快速实现基本的效果处理，也可以将滤镜添加到效果器中，组合成滤镜链串联执行。系统提供了如”亮度“、”裁剪“等基本的效果处理滤镜。
25
26-   效果器
27    效果器提供了滤镜的添加、删除、查询等功能。开发者可以通过效果器提供的接口将多个滤镜组合串联，从而实现较为复杂的效果调节功能。同时，效果器支持多种输入类型，如pixelmap、uri、surface。不同的输入类型在效果器内部都会转换为内存对象，通过滤镜的效果处理，获得处理结果。
28
29-   自定义效果
30    开发者可以使用自定义滤镜实现定制化的滤镜效果，可以将自定义滤镜通过效果器接口添加到效果器中，与其他滤镜组合成滤镜链，也可以只单独使用自定义滤镜处理图片，获得处理效果。
31
32## 目录
33
34仓目录结构如下：
35
36```
37/foundation/multimedia/image_effect      # 图片编辑框架业务代码
38├── frameworks                           # 框架代码
39│   ├── native                           # 内部接口实现
40│   │   └── capi                         # 接口实现
41│   │   ├── effect                       # 效果类
42│   │   └── efilter                      # 效果器实现
43│   │   └── utils                        # 工具类
44├── interfaces                           # 接口代码
45│   ├── inner_api                        # 内部接口
46│   └── kits                             # 外部接口
47├── test                                 # 测试代码
48│   └── unittest                         # 单元测试
49├── BUILD.gn                             # 构建配置
50├── bundle.json                          # 部件配置
51├── config.gni                           # 构建参数配置
52└── LICENSE                              # 证书文件
53```
54
55## 编译
56
57```
58./build.sh --product-name {product-name} --build-target foundation/multimedia/image_effect:image_effect
59```
60
61 {product-name}为当前支持的平台，比如rk3568.
62
63## 使用说明
64
65详细的开发指导请参考[ImageEffect开发指导 (C/C++)](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/media/image/image-effect-guidelines.md)。
66