鸿蒙NEXT开发【图像效果】ArkTS组件通用属性

设置组件的模糊、阴影、球面效果以及设置图片的图像效果。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

blur

blur(value: number, options?: BlurOptions)

为组件添加内容模糊效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number 当前组件添加内容模糊效果,入参为模糊半径,模糊半径越大越模糊,为0时不模糊。
options11+ [BlurOptions] 灰阶梯参数。

shadow

shadow(value: ShadowOptions | ShadowStyle)

为组件添加阴影效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用,ArkTS卡片上不支持参数为 [ShadowStyle]类型。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value [ShadowOptions] [ShadowStyle]10+

grayscale

grayscale(value: number)

为组件添加灰度效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number 为当前组件添加灰度效果。值定义为灰度转换的比例,入参1.0则完全转为灰度图像,入参0.0则图像无变化,入参在0.0和1.0之间时,效果呈线性变化。(百分比)默认值:0.0取值范围:[0.0, 1.0]**说明:**设置小于0.0的值时,按值为0.0处理,设置大于1.0的值时,按值为1.0处理。

brightness

brightness(value: number)

为组件添加高光效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number 为当前组件添加高光效果,入参为高光比例,值为1时没有效果,小于1时亮度变暗,0为全黑,大于1时亮度增加,数值越大亮度越大,亮度为2时会变为全白。默认值:1.0推荐取值范围:[0, 2]**说明:**设置小于0的值时,按值为0处理。卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

saturate

saturate(value: number)

为组件添加饱和度效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number 为当前组件添加饱和度效果,饱和度为颜色中的含色成分和消色成分(灰)的比例,入参为1时,显示原图像,大于1时含色成分越大,饱和度越大,小于1时消色成分越大,饱和度越小。(百分比)默认值:1.0推荐取值范围:[0, 50)**说明:**设置小于0的值时,按值为0处理。

contrast

contrast(value: number)

为组件添加对比度效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number 为当前组件添加对比度效果,入参为对比度的值。值为1时,显示原图,大于1时,值越大对比度越高,图像越清晰醒目,小于1时,值越小对比度越低,当对比度为0时,图像变为全灰。(百分比)默认值:1.0推荐取值范围:[0, 10)**说明:**设置小于0的值时,按值为0处理。

invert

invert(value: number | InvertOptions)

反转输入的图像。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number [InvertOptions]11+

sepia

sepia(value: number)

将图像转换为深褐色。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number 将图像转换为深褐色。入参为图像反转的比例,值为1则完全是深褐色的,值为0图像无变化。 (百分比)

hueRotate

hueRotate(value: number | string)

色相旋转效果。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名 类型 必填 说明
value number string

colorBlend7+

colorBlend(value: Color | string | Resource)

为组件添加颜色叠加效果。

系统能力: SystemCapability.ArkUI.ArkUI.Full

元服务API: 从API version 11开始,该接口支持在元服务中使用。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

参数:

参数名 类型 必填
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值