harmony 鸿蒙@ohos.graphics.uiEffect (效果级联)

  • 2025-06-12
  • 浏览 (4)

@ohos.graphics.uiEffect (效果级联)

本模块提供组件效果的一些基础能力,包括模糊、边缘像素扩展、提亮等。效果被分为Filter和VisualEffect大类,同类效果可以级联在一个效果大类的实例下。在实际开发中,模糊可用于背景虚化,提亮可用于亮屏显示等。

  • Filter:用于添加指定Filter效果到组件上。
  • VisualEffect:用于添加指定VisualEffect效果到组件上。

说明:

本模块首批接口从API version 12开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import { uiEffect } from "@kit.ArkGraphics2D";

uiEffect.createFilter

createFilter(): Filter

创建Filter实例用于给组件添加多种filter效果。

系统能力: SystemCapability.Graphics.Drawing

返回值:

类型 说明
Filter 返回Filter的头节点。

示例:

let filter : uiEffect.Filter = uiEffect.createFilter()

uiEffect.createEffect

createEffect(): VisualEffect

创建VisualEffect实例用于给组件添加多种effect效果。

系统能力: SystemCapability.Graphics.Drawing

返回值:

类型 说明
VisualEffect 返回VisualEffect的头节点。

示例:

let visualEffect : uiEffect.VisualEffect = uiEffect.createEffect()

Filter

Filter效果类,用于将相应的效果添加到指定的组件上。在调用Filter的方法前,需要先通过createFilter创建一个Filter实例。

blur

blur(blurRadius: number): Filter

将模糊效果添加至组件上。

系统能力: SystemCapability.Graphics.Drawing

参数: |参数名 |类型 |必填|说明 | |———–|——-|—-|———| |blurRadius|number|是 |模糊半径。
取值需大于等于0,模糊半径越大,模糊效果越强。
模糊半径为0时无模糊效果。|

返回值:

类型 说明
Filter 返回挂载了模糊效果的Filter。

示例:

filter.blur(20)

VisualEffect

VisualEffect效果类,用于将相应的效果添加到指定的组件上。在调用VisualEffect的方法前,需要先通过createEffect创建一个VisualEffect实例。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 2D(方舟2D图形服务)

harmony 鸿蒙buffer_common.h

harmony 鸿蒙buffer_handle.h

harmony 鸿蒙BufferHandle

harmony 鸿蒙ColorSpacePrimaries

harmony 鸿蒙DisplaySoloist_ExpectedRateRange

harmony 鸿蒙drawing_bitmap.h

harmony 鸿蒙drawing_brush.h

harmony 鸿蒙drawing_canvas.h

harmony 鸿蒙drawing_color_filter.h

0  赞