可可图片编辑 HarmonyOS（5）滤镜效果

前言

可可图片编辑也实现了滤镜效果，主要是利用 Image组件的 colorFilter 属性实现。

colorFilter 的主要作用是给图像设置颜色滤镜效果。

其核心原理是使用一个 4x5 的颜色矩阵 对图片的每个像素颜色（RGBA）进行数学变换，从而得到一个新的颜色值。

参数类型：

它接受两种类型的参数：

ColorFilter: ArkUI 自带的颜色滤镜对象，主要通过传递一个 4x5 的矩阵数组来使用。
DrawingColorFilter: 来自 @kit.ArkGraphics2D

绘图模块的、功能更丰富的颜色滤镜对象，提供了多种静态创建方法（如混合模式、矩阵、光照等）。

这是最基础和最灵活的方式。你需要构造一个包含 20 个数字的数组来表示一个 4x5 的矩阵。

矩阵结构如下，它会对每个像素的原始颜色 [R, G, B, A] 进行运算：

输出颜色 [R', G', B', A'] 的计算公式为：

重要提示：计算时，原始颜色值（R,G,B,A）需要先归一化（Normalize）到 $0.0, 1.0$ 的浮点数范围（1.0 对应 255）。

示例代码：

后续的效果都可以在当前示例代码上进行修改

a) 原图效果（单位矩阵） 保持图片原有色彩，不对其做任何改变。

b) 灰度效果 将图片转换为黑白灰度图。常见的权重公式是 0.299*R + 0.587*G + 0.114*B。

c) 颜色反转（负片效果） 将每个颜色通道取反。

d) 纯色着色（文档中的核心方案） 忽略原图颜色 ，将其渲染为指定的目标颜色（例如 #4f0f48db）。

假设目标色为 #4f0f48db，其归一化后的值为：

对应的矩阵为：

e) 棕褐色怀旧效果 (Sepia) ,这是一种经典的老照片效果，为图像添加温暖的棕褐色调。

f) 亮度调节,整体提升或降低图像的亮度。

g) 冷色调/暖色调通过微调不同颜色通道的增益，营造冷暖感觉.

通过 '@kit.ArkGraphics2D' 模块提供的多种静态方法创建滤镜，这种方式通常更简洁易懂。

a) 创建混合模式滤镜 (createBlendModeColorFilter)

使用指定的颜色和混合模式（如 BlendMode.SRC_IN）进行混合，非常适合着色。

b) 直接通过矩阵创建 (createMatrixColorFilter)

与原生 ColorFilter 类似，但使用 drawing 模块的接口。

性能：颜色滤镜的运算发生在渲染时，对于大图或频繁操作，可能会有性能开销。建议对处理后的结果进行缓存。

Alpha 通道：在处理透明度时务必小心，错误的矩阵设置可能导致图片完全透明或出现非预期的半透明效果。

对于简单的颜色覆盖/着色，优先推荐使用 drawing.ColorFilter.createBlendModeColorFilter，它的代码更简洁，意图更

清晰。对于复杂的颜色变换（如复古、色调分离等），再考虑使用自定义矩阵。