目录

基于colorFilter实现图片滤镜效果

概述

在美颜类应用开发中,图片处理和美化功能已成为提升用户体验的关键要素。通过对原始图像进行不同参数的色彩滤镜调整,开发者可以创造出复杂多样的美图滤镜效果。

ArkUI框架在Image组件中提供了colorFilter属性,该属性是实现图片滤镜效果的核心。此属性允许开发者通过数学矩阵或底层图形对象来操纵像素的颜色通道。

本文将基于原始图像,使用colorFilter属性实现复古、反色、增强饱和度及美白等常见滤镜效果,并详细解析colorFilter的4×5 RGBA转换矩阵和颜色滤波器两种使用方式,同时提供针对性的优化建议与常见问题解答。

实现原理

colorFilter属性本质上是对像素的RGBA通道进行线性变换,该变换通常在渲染管线的片元着色阶段执行,最终影响渲染输出的颜色结果。ArkUI框架提供了4×5颜色矩阵和颜色滤波器两种方式来实现这种变换。

渲染管线的片元着色阶段是计算机图形处理中的关键环节,负责计算屏幕上每个像素点的最终颜色。

[h2]4×5颜色矩阵

颜色矩阵是业界通用的方法,通过colorFilter传入一个4×5的RGBA转换矩阵来实现,该矩阵是实现图片滤镜效果的核心。数学原理上,这是一个4×5的二维矩阵,但在ArkTS的接口实现中,需将其按行优先展开,封装为包含20个数值的一维数组(number[])。数组的前5个元素对应矩阵的第一行(R通道变换),接下来的5个元素对应第二行(G通道变换),依此类推。

颜色矩阵的数学语义

在图形学中,像素由RGBA(红色、绿色、蓝色以及透明度)四个通道组成。颜色转换矩阵的定义公式如下:

其中:

颜色矩阵参数详细解析

为了构造出所需的滤镜效果,需要理解矩阵中每个位置的具体含义:

行 (Row) 决定输出的通道 计算公式
Row 0 红色(Red')
Row 1 绿色(Green')
Row 2 蓝色(Blue')
Row 3 透明度(Alpha')

[h2]颜色滤波器

从API version 12开始,ArkUI开放了@ohos.graphics.drawing模块中的颜色滤波器(DrawingColorFilter接口类型,表示ColorFilter类型的别名)。使用颜色滤波器作为参数的方法提供了更高级、语义化、简便的滤镜创建方式。开发者可根据所需实现的滤镜效果指定ARGB格式(参考如下说明)的颜色值,并选用系统预设的BlendMode混合模式创建颜色滤波器,以实现不同混合算法下的颜色滤镜效果。

在HarmonyOS开发中,ARGB和RGBA是两种不同的颜色通道顺序表示方式。

  • 本质上相同:两者均包含红、绿、蓝、透明度四个通道。
  • 使用场景的差异在于:
    • ARGB多用于十六进制和common2D.Color类型颜色表示(如#FFFF0000和{ alpha: 255, red: 255, green: 0, blue: 0 }均表示不透明的红色),是HarmonyOS开发中颜色资源的常见格式;
    • RGBA多用于CSS样式、SVG解析及API参数(如rgba(r, g, b, a)),ArkUI的Image组件的颜色矩阵计算需依赖RGBA归一化值。

[h2]颜色矩阵和颜色滤波器的区别和使用场景对比

对比维度 颜色矩阵 颜色滤波器(createBlendModeColorFilter混合模式)
核心原理 4×5矩阵线性变换像素RGB/Alpha值 源图与目标图按混合规则融合
使用场景 适合图像编辑中的精细参数控制(亮度、饱和度等)和特殊色彩变换,优点是灵活可控、支持线性变换效果 适合简单的UI染色、叠加、蒙版等场景

滤镜实现

[h2]原图显示,初始化单位矩阵

在滤镜列表中,首个选项通常为“原图”或“无效果”。技术实现上,使用单位矩阵对应此状态。

颜色矩阵定义:

export const ORIGINAL_MATRIX: number[] = [
  1, 0, 0, 0, 0,
  0, 1, 0, 0, 0,
  0, 0, 1, 0, 0,
  0, 0, 0, 1, 0
];

原理解析:

这是一个标准的单位矩阵,根据矩阵乘法原理,它不会改变像素的任何RGBA值,从而起到“保持原图效果”或“重置”的作用。

效果图:

[h2]实现复古灰度滤镜功能

颜色矩阵定义:

const RETRO_COLOR_MATRIX: number[] = [
  0.213, 0.715, 0.072, 0, 0,
  0.213, 0.715, 0.072, 0, 0,
  0.213, 0.715, 0.072, 0, 0,
  0, 0, 0, 1, 0
];

原理解析:

这里以一张纯色图片为例,展示灰度滤镜的实现:

假设纯色原始图片的RGBA颜色值为:rgba(255, 255, 0, 255),即原始的[R, G, B, A]。颜色转换矩阵为上述定义的RETRO_COLOR_MATRIX。

根据颜色转换矩阵的定义公式,可以计算得出:

R' = 0.213 * 255 + 0.715 * 255 + 0.072 * 0 + 0 * 255 + 0 * 255 = 236.64(红),

G' = 0.213 * 255 + 0.715 * 255 + 0.072 * 0 + 0 * 255 + 0 * 255 = 236.64(绿),

B' = 0.213 * 255 + 0.715 * 255 + 0.072 * 0 + 0 * 255 + 0 * 255 = 236.64(蓝),

A' = 0 * 255 + 0 * 255 + 0 * 0 + 1 * 255 + 0 * 255 = 255(透明度)。

转换后的像素颜色分量(取整后)为:rgba(237, 237, 237, 255)

效果图:

[h2]实现反色滤镜功能

颜色矩阵定义:

const REVERSE_COLOR_MATRIX: number[] = [
  -1, 0, 0, 0, 1,
  0, -1, 0, 0, 1,
  0, 0, -1, 0, 1,
  0, 0, 0, 1, 0
];

原理解析:

效果图:

[h2]实现饱和度增强滤镜功能

颜色矩阵定义:

const ENHANCE_COLOR_MATRIX: number[] = [
  1.63, -0.5723, -0.0577, 0, 0,
  -0.17, 1.2277, -0.0577, 0, 0,
  -0.17, -0.5723, 1.7423, 0, 0,
  0, 0, 0, 1, 0
];

原理解析:

对角线魔数值取值说明:

  • 核心算法:基于线性插值原理,在“灰度图像”与“原图”之间进行加权混合。公式为:

    其中,S表示饱和度系数,本例中S ≈ 1.8,即提升饱和度约80%;Gray表示像素的亮度值,基于ITU-R BT.709国际标准(高清视频色彩空间标准)中的亮度计算公式,具体公式见上文实现复古灰度滤镜功能中的原理解析。

  • 系数推导:以红色通道的主对角线元素(1.63)为例:
    • 公式展开:

    • 合并系数:

  • 效果:通过公式计算出的矩阵,既保留了图像的亮度信息,又显著增强了RGB通道的差异,从而实现色彩鲜艳通透的效果。

效果图:

[h2]实现美白滤镜功能

颜色滤波器定义:

const WHITENING_COLOR_CONFIG: common2D.Color = {
  alpha: 30,
  red: 255,
  green: 255,
  blue: 255
};

const WHITENING_COLOR_FILTER =
  drawing.ColorFilter.createBlendModeColorFilter(WHITENING_COLOR_CONFIG, drawing.BlendMode.PLUS);

原理解析:

效果图:

开发步骤

  1. 定义滤镜数据结构

    首先定义图片滤镜选项的接口,便于管理和扩展:

    export interface FilterOption {
      label: string;
      value: string;
      filter: ColorFilter | number[];
    }
  2. 初始化滤镜配置

    在组件中定义各种滤镜矩阵和滤镜选项列表:

    • 滤镜矩阵定义见上文的滤镜实现。

    • 滤镜选项列表定义如下:

      export const FILTER_OPTIONS: FilterOption[] = [
        { label: 'Original', value: 'original', filter: ORIGINAL_MATRIX },
        { label: 'Retro', value: 'retro', filter: RETRO_COLOR_MATRIX },
        { label: 'Invert', value: 'invert', filter: REVERSE_COLOR_MATRIX },
        { label: 'Enhance', value: 'enhance', filter: ENHANCE_COLOR_MATRIX },
        { label: 'Whiten', value: 'whitening', filter: WHITENING_COLOR_FILTER }
      ];
  3. 初始化滤镜状态

    在组件生命周期中初始化每张图片的滤镜状态:

    aboutToAppear(): void {
      this.imageFilterTags = new Array<string>(CAROUSEL_DATA_SOURCE.length).fill('original');
    }
  4. 应用滤镜效果到图片

    在Image组件上使用colorFilter应用滤镜,该步骤是核心实现:

    Image(imgRes)
      .width('100%')
      .height('100%')
      .objectFit(ImageFit.Contain)
      .borderRadius(16)
      .colorFilter(this.getFilterByTag(this.imageFilterTags[index]))

    由于轮播图需切换不同的图片并对每张图片添加滤镜效果,故需根据每张图片记录的滤镜标签获取对应的滤镜对象,关键辅助方法如下:

    private getFilterByTag(tag: string): ColorFilter | number[] {
      const option = FILTER_OPTIONS.find(opt => opt.value === tag);
      return option ? option.filter : ORIGINAL_MATRIX;
    }

常见问题

[h2]SVG图片设置colorFilter未生效

问题现象

PNG、JPG图片应用滤镜正常,但更换为SVG图片后,滤镜不起作用。

可能原因

这与API版本及SVG内部结构有关:

解决方案

若需在低版本中对SVG变色,建议将SVG转换为PNG或PixelMap后再应用colorFilter,或使用fillColor属性(适用于单色图标,图源中需包含fill属性的参数配置,且fill属性不为 'none')。

[h2]设置了colorFilter,但renderMode属性未生效

问题现象

原本设置了renderMode: ImageRenderMode.Template以将图标染成黑色,后来为了添加滤镜使用了colorFilter,导致Template效果消失,颜色显示异常。

可能原因

未遵循系统规格,系统规格指出:设置colorFilter属性时,renderMode属性设置不生效。

解决方案

不要混用colorFilter和renderMode属性。若需染色,直接使用colorFilter模拟Template模式(即忽略原图像素颜色,仅保留Alpha通道,全部染为目标色),例如要染成红色,其对应的单色染色矩阵如下:

[
  0, 0, 0, 0, 1,
  0, 0, 0, 0, 0,
  0, 0, 0, 0, 0,
  0, 0, 0, 1, 0
]

示例代码