鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(图像效果)

鸿蒙Harmony应用开发—ArkTS声明式开发(通用属性:图像效果) ArkTS声明式开发(通用属性:图像效果) 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


图像效果

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

说明

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

blur

blur(value: number, options?: BlurOptions)

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

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

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

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

参数:

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

shadow

shadow(value: ShadowOptions | ShadowStyle)

为组件添加阴影效果。

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

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

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

参数:

参数名类型必填说明
valueShadowOptions | ShadowStyle10+是

为当前组件添加阴影效果。

入参类型为ShadowOptions时,可以指定模糊半径、阴影的颜色、X轴和Y轴的偏移量。

入参类型为ShadowStyle时,可指定不同阴影样式。

grayscale

grayscale(value: number)

为组件添加灰度效果。

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

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

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

参数:

参数名类型必填说明
valuenumber是

为当前组件添加灰度效果。值定义为灰度转换的比例,入参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

参数:

参数名类型必填说明
valuenumber是

为当前组件添加高光效果,入参为高光比例,值为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

参数:

参数名类型必填说明
valuenumber是

为当前组件添加饱和度效果,饱和度为颜色中的含色成分和消色成分(灰)的比例,入参为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

参数:

参数名类型必填说明
valuenumber是

为当前组件添加对比度效果,入参为对比度的值。值为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

参数:

参数名类型必填说明
valuenumber | InvertOptions11+是

反转输入的图像。

入参对象为number时,入参为图像反转的比例,值为1时完全反转,值为0则图像无变化。(百分比)

取值范围:[0, 1]

设置小于0的值时,按值为0处理。

入参对象为 InvertOptions时,对比背景颜色灰度值和阈值区间,背景颜色灰度值小于阈值区间时反色取high值,当背景颜色灰度值大于阈值区间时反色取low值,背景颜色灰度值在阈值区间内取值由high线性渐变到low。

sepia

sepia(value: number)

将图像转换为深褐色。

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

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

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

参数:

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

hueRotate

hueRotate(value: number | string)

色相旋转效果。

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

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

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

参数:

参数名类型必填说明
valuenumber | string是

色相旋转效果,输入参数为旋转角度。

默认值:'0deg'

取值范围:(-∞, +∞)

说明:

色调旋转360度会显示原始颜色。先将色调旋转180 度,然后再旋转-180度会显示原始颜色。数据类型为number时,值为90和'90deg'效果一致。

colorBlend7+

colorBlend(value: Color | string | Resource)

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

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

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

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

参数:

参数名类型必填说明
valueColor | string | Resource是为当前组件添加颜色叠加效果,入参为叠加的颜色。

linearGradientBlur12+

linearGradientBlur(value: number, options: LinearGradientBlurOptions)

为组件添加内容线性渐变模糊效果。

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

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

参数:

参数名类型必填说明
valuenumber是

为模糊半径,模糊半径越大越模糊,为0时不模糊。

取值范围:[0, 1000]

线性梯度模糊包含两个部分fractionStops和direction。

optionsLinearGradientBlurOptions是设置线性渐变模糊效果。

renderGroup10+

renderGroup(value: boolean)

设置当前控件和子控件是否先整体离屏渲染绘制后再与父控件融合绘制。

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

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

参数:

参数名类型必填说明
valueboolean是

设置当前控件和子控件是否先整体离屏渲染绘制后再与父控件融合绘制。当前控件的不透明度不为1时绘制效果可能有差异。

默认值:false

blendMode11+

blendMode(value: BlendMode, type?: BlendApplyType)

将当前控件的内容(包含子节点内容)与下方画布(可能为离屏画布)已有内容进行混合。

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

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

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

参数:

参数名类型必填说明
valueBlendMode是

混合模式。

默认值:BlendMode.NONE

typeBlendApplyType否

blendMode实现方式是否离屏。

默认值:BlendApplyType.FAST

说明:

1. 设置BlendApplyType.FAST时,不离屏。

2. 设置BlendApplyType.OFFSCREEN时,会创建当前组件大小的离屏画布,再将当前组件(含子组件)的内容绘制到离屏画布上,再用指定的混合模式与下方画布已有内容进行混合。

BlendApplyType11+

指示如何将指定的混合模式应用于视图的内容。

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

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

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

名称描述
FAST在目标图像上按顺序混合视图的内容。
OFFSCREEN将此组件和子组件内容绘制到离屏画布上,然后整体进行混合。

useShadowBatching11+

useShadowBatching(value: boolean)

控件内部子节点的阴影进行同层绘制,同层元素阴影重叠。

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

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

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

参数:

参数名类型必填说明
valueboolean是

控件内部子节点的阴影进行同层绘制,同层元素阴影重叠。

默认值:false

说明:

1. 默认不开启,如果子节点的阴影半径较大,节点各自的阴影会互相重叠。 当开启时,元素的阴影将不会重叠。

2. 不推荐useShadowBatching嵌套使用,如果嵌套使用,只会对当前的子节点生效,无法递推。

sphericalEffect12+

sphericalEffect(value: number)

设置组件的图像球面化程度。

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

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

参数:

参数名类型必填说明
valuenumber是

设置组件的图像球面化程度。

取值范围:[0,1]。

说明:

1. 如果value等于0则图像保持原样,如果value等于1则图像为完全球面化效果。在0和1之间,数值越大,则球面化程度越高。

value < 0 或者 value > 1为异常情况,value < 0按0处理,value > 1按1处理。

2. 组件阴影和外描边不支持球面效果。

3. 设置value大于0时,组件冻屏不更新并且把组件内容绘制到透明离屏buffer上,如果要更新组件属性则需要把value设置为0。

lightUpEffect12+

lightUpEffect(value: number)

设置组件图像亮起程度。

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

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

参数:

参数名类型必填说明
valuenumber是

设置组件图像亮起程度。

取值范围:[0,1]。

如果value等于0则图像为全黑,如果value等于1则图像为全亮效果。0到1之间数值越大,表示图像亮度越高。value < 0 或者 value > 1为异常情况,value < 0按0处理,value > 1按1处理。

pixelStretchEffect12+

pixelStretchEffect(options: PixelStretchEffectOptions)

设置组件的图像边缘像素扩展距离。

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

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

参数:

参数名类型必填说明
optionsPixelStretchEffectOptions是

设置组件的图像边缘像素扩展距离。

参数options包括上下左右四个方向的边缘像素扩展距离。

说明:

1. 如果距离为正值,表示向外扩展,放大原来图像大小。上下左右四个方向分别用边缘像素填充,填充的距离即为设置的边缘扩展的距离。

2. 如果距离为负值,表示内缩,但是最终图像大小不变。

内缩方式:

图像根据options的设置缩小,缩小大小为四个方向边缘扩展距离的绝对值。

图像用边缘像素扩展到原来大小。

3. 对options的输入约束:

上下左右四个方向的扩展统一为非正值或者非负值。即四个边同时向外扩或者内缩,方向一致。

所有方向的输入均为百分比或者具体值,不支持百分比和具体值混用。

所有异常情况下,显示为{0,0,0,0}效果,即跟原图保持一致。

PixelStretchEffectOptions10+

像素扩展属性集合,用于描述像素扩展的信息。

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

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

名称类型必填说明
leftLength否组件图像左边沿像素扩展距离。
rightLength否组件图像右边沿像素扩展距离。
topLength否组件图像上边沿像素扩展距离。
bottomLength否组件图像下边沿像素扩展距离。

systemBarEffect12+

systemBarEffect()

根据背景进行智能反色并且带有模糊效果。

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

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

ShadowType10+

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

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

名称描述
COLOR颜色。
BLUR模糊。

ShadowOptions对象说明

阴影属性集合,用于设置阴影的模糊半径、阴影的颜色、X轴和Y轴的偏移量。

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

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

名称类型必填说明
radiusnumber | Resource是

阴影模糊半径。

取值范围:[0, +∞)

单位:px

说明:

设置小于0的值时,按值为0处理。

如需使用vp单位的数值可用vp2px进行转换。

如果radius为Resource类型,则传入的值需为number类型。

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

type10+ShadowType10+否

阴影类型。

默认为COLOR。

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

colorColor | string | Resource| ColoringStrategy10+否

阴影的颜色。

默认为黑色。

说明:

从API version 11开始,该接口支持使用ColoringStrategy实现智能取色,智能取色功能不支持在ArkTS卡片、textShadow中使用。

当前仅支持平均取色和主色取色,智能取色区域为shadow绘制区域。

支持使用'average'字符串触发智能平均取色模式,支持使用'primary'字符串触发智能主色模式。

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

offsetXnumber | Resource否

阴影的X轴偏移量。

默认值:0

单位:px

说明:

如需使用vp单位的数值可用vp2px进行转换。

如果offsetX为Resource类型,则传入的值需为number类型。

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

offsetYnumber | Resource否

阴影的Y轴偏移量。

默认值:0

单位:px

说明:

如需使用vp单位的数值可用vp2px进行转换。

如果offsetY为Resource类型,则传入的值需为number类型。

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

fill11+boolean否

阴影是否内部填充。

默认为false。

说明:

textShadow中该字段不生效。

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

ShadowStyle10+枚举说明

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

名称描述
OUTER_DEFAULT_XS超小阴影。
OUTER_DEFAULT_SM小阴影。
OUTER_DEFAULT_MD中阴影。
OUTER_DEFAULT_LG大阴影。
OUTER_FLOATING_SM浮动小阴影。
OUTER_FLOATING_MD浮动中阴影。

BlendMode11+枚举说明

说明

blendMode枚举中,s表示源像素,d表示目标像素,sa表示原像素透明度,da表示目标像素透明度,r表示混合后像素,ra表示混合后像素透明度。

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

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

名称描述
NONE将上层图像直接覆盖到下层图像上,不进行任何混合操作。
CLEAR将源像素覆盖的目标像素清除为完全透明。
SRCr = s,只显示源像素。
DSTr = d,只显示目标像素。
SRC_OVERr = s + (1 - sa) * d,将源像素按照透明度进行混合,覆盖在目标像素上。
DST_OVERr = d + (1 - da) * s,将目标像素按照透明度进行混合,覆盖在源像素上。
SRC_INr = s * da,只显示源像素中与目标像素重叠的部分。
DST_INr = d * sa,只显示目标像素中与源像素重叠的部分。
SRC_OUTr = s * (1 - da),只显示源像素中与目标像素不重叠的部分。
DST_OUTr = d * (1 - sa),只显示目标像素中与源像素不重叠的部分。
SRC_ATOPr = s * da + d * (1 - sa),在源像素和目标像素重叠的地方绘制源像素,在源像素和目标像素不重叠的地方绘制目标像素。
DST_ATOPr = d * sa + s * (1 - da),在源像素和目标像素重叠的地方绘制目标像素,在源像素和目标像素不重叠的地方绘制源像素。
XORr = s * (1 - da) + d * (1 - sa),只显示源像素与目标像素不重叠的部分。
PLUSr = min(s + d, 1),将源像素值与目标像素值相加,并将结果作为新的像素值。
MODULATEr = s * d,将源像素与目标像素进行乘法运算,并将结果作为新的像素值。
SCREENr = s + d - s * d,将两个图像的像素值相加,然后减去它们的乘积来实现混合。
OVERLAY根据目标像素来决定使用MULTIPLY混合模式还是SCREEN混合模式。
DARKENrc = s + d - max(s * da, d * sa), ra = kSrcOver,当两个颜色重叠时,较暗的颜色会覆盖较亮的颜色。
LIGHTENrc = s + d - min(s * da, d * sa), ra = kSrcOver,将源图像和目标图像中的像素进行比较,选取两者中较亮的像素作为最终的混合结果。
COLOR_DODGE使目标像素变得更亮来反映源像素。
COLOR_BURN使目标像素变得更暗来反映源像素。
HARD_LIGHT根据源像素的值来决定目标像素变得更亮或者更暗。根据源像素来决定使用MULTIPLY混合模式还是SCREEN混合模式。
SOFT_LIGHT根据源像素来决定使用LIGHTEN混合模式还是DARKEN混合模式。
DIFFERENCErc = s + d - 2 * (min(s * da, d * sa)), ra = kSrcOver,对比源像素和目标像素,亮度更高的像素减去亮度更低的像素,产生高对比度的效果。
EXCLUSIONrc = s + d - two(s * d), ra = kSrcOver,对比源像素和目标像素,亮度更高的像素减去亮度更低的像素,产生柔和的效果。
MULTIPLYr = s * (1 - da) + d * (1 - sa) + s * d,将源图像与目标图像进行乘法混合,得到一张新的图像。
HUE保留源图像的亮度和饱和度,但会使用目标图像的色调来替换源图像的色调。
SATURATION保留目标像素的亮度和色调,但会使用源像素的饱和度来替换目标像素的饱和度。
COLOR保留源像素的饱和度和色调,但会使用目标像素的亮度来替换源像素的亮度。
LUMINOSITY保留目标像素的色调和饱和度,但会用源像素的亮度替换目标像素的亮度。

LinearGradientBlurOptions12+对象说明

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

名称类型必填说明
fractionStopsArray<FractionStop>是数组中保存的每一个二元数组(取值0-1,小于0则为0,大于1则为1)表示[模糊程度, 模糊位置];模糊位置需严格递增,开发者传入的数据不符合规范会记录日志,渐变模糊数组中二元数组个数必须大于等于2,否则渐变模糊不生效。
directionGradientDirection是

渐变模糊方向。

默认值:

GradientDirection.Bottom

FractionStop12+

FractionStop = [ number, number ]

定义模糊段。

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

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

取值范围说明
number

分数,值1表示不透明,0表示完全透明。

取值范围:[0,1]

number

停止位置,值1表示区域结束位置,0表示区域开始位置。

取值范围:[0,1]

InvertOptions11+对象说明

前景智能取反色。

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

名称类型必填说明
lownumber是背景颜色灰度值大于阈值区间时的取值。
highnumber是背景颜色灰度值小于阈值区间时的取值。
thresholdnumber是灰度阈值。
thresholdRangenumber是

阈值范围。

说明:

灰度阈值上下偏移thresholdRange构成阈值区间,背景颜色灰度值在区间内取值由high线性渐变到low。

freeze12+

freeze(value: boolean)

设置当前控件和子控件是否整体离屏渲染绘制后重复绘制缓存,不再进行内部属性更新。

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

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

参数:

参数名类型必填说明
valueboolean是

设置当前控件和子控件是否整体离屏渲染绘制后重复绘制缓存,不再进行内部属性更新。当前控件的不透明度不为1时绘制效果可能有差异。

默认值:false

示例

示例1(设置图片不同属性效果)

设置图片的效果,包括阴影,灰度,高光,饱和度,对比度,图像反转,叠色,色相旋转等。

// xxx.ets
@Entry
@Component
struct ImageEffectsExample {
  build() {
    Column({ space: 5 }) {
      // 添加阴影效果,图片效果不变
      Text('shadow').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image'))
        .width('90%')
        .height(30)
        .shadow({ radius: 10, color: Color.Green, offsetX: 20, offsetY: 20 })

      // 添加内部阴影效果
      Text('shadow').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image'))
        .width('90%')
        .height(30)
        .shadow({ radius: 5, color: Color.Green, offsetX: 20, offsetY: 20,fill:true }).opacity(0.5)

      // 灰度效果0~1,越接近1,灰度越明显
      Text('grayscale').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).grayscale(0.3)
      Image($r('app.media.image')).width('90%').height(30).grayscale(0.8)

      // 高光效果,1为正常图片,<1变暗,>1亮度增大
      Text('brightness').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).brightness(1.2)

      // 饱和度,原图为1
      Text('saturate').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).saturate(2.0)
      Image($r('app.media.image')).width('90%').height(30).saturate(0.7)

      // 对比度,1为原图,>1值越大越清晰,<1值越小越模糊
      Text('contrast').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).contrast(2.0)
      Image($r('app.media.image')).width('90%').height(30).contrast(0.8)

      // 图像反转比例
      Text('invert').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).invert(0.2)
      Image($r('app.media.image')).width('90%').height(30).invert(0.8)

      // 叠色添加
      Text('colorBlend').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).colorBlend(Color.Green)
      Image($r('app.media.image')).width('90%').height(30).colorBlend(Color.Blue)

      // 深褐色
      Text('sepia').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).sepia(0.8)

      // 色相旋转
      Text('hueRotate').fontSize(15).fontColor(0xCCCCCC).width('90%')
      Image($r('app.media.image')).width('90%').height(30).hueRotate(90)
    }.width('100%').margin({ top: 5 })
  }
}

示例2(设置组件线性渐变模糊效果)

该示例主要演示通过linearGradientBlur设置组件的内容线性渐变模糊效果。

// xxx.ets
@Entry
@Component
struct ImageExample1 {
  private_resource1:Resource = $r('app.media.testlinearGradientBlurOrigin')
  @State image_src: Resource = this.private_resource1
  build() {
    Column() {
      Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start }) {
        Row({ space: 5 }) {
          Image(this.image_src)
            .linearGradientBlur(60, { fractionStops: [[0,0],[0,0.33],[1,0.66],[1,1]], direction: GradientDirection.Bottom })
        }
      }
    }
  }
}

示例3(设置离屏渲染效果)

该示例主要演示通过renderGroup来设置组件是否先整体离屏渲染绘制后,再与父控件融合绘制。

// xxx.ets
@Component
struct Component1 {
  @Prop renderGroupValue: boolean;
  build() {
    Row() {
      Row() {
        Row()
          .backgroundColor(Color.Black)
          .width(100)
          .height(100)
          .opacity(1)
      }
      .backgroundColor(Color.White)
      .width(150)
      .height(150)
      .justifyContent(FlexAlign.Center)
      .opacity(0.6)
      .renderGroup(this.renderGroupValue)
    }
    .backgroundColor(Color.Black)
    .width(200)
    .height(200)
    .justifyContent(FlexAlign.Center)
    .opacity(1)
  }
}
@Entry
@Component
struct RenderGroupExample {
  build() {
    Column() {
      Component1({renderGroupValue: true})
        .margin(20)
      Component1({renderGroupValue: false})
        .margin(20)
    }
    .width("100%")
    .height("100%")
    .alignItems(HorizontalAlign.Center)
  }
}

示例4(当前组件内容与下方画布内容混合)

该示例主要演示通过blendMode将当前组件内容与下方画布内容混合。

// xxx.ets
@Entry
@Component
struct Index {
  build() {
    Column() {
      Text("blendMode")
        .fontSize(20)
        .fontWeight(FontWeight.Bold)
        .fontColor('#ffff0101')
      Row() {
        Circle()
          .width(200)
          .height(200)
          .fill(Color.Green)
          .position({ x: 50, y: 50 })
        Circle()
          .width(200)
          .height(200)
          .fill(Color.Blue)
          .position({ x: 150, y: 50 })
      }
      .blendMode(BlendMode.OVERLAY,BlendApplyType.OFFSCREEN)
      .alignItems(VerticalAlign.Center)
      .height(300)
      .width('100%')
    }
    .height('100%')
    .width('100%')
    .backgroundImage($r('app.media.image'))
    .backgroundImageSize(ImageSize.Cover)
  }
}

BlendMode.OVERLAY,BlendApplyType.OFFSCREEN

不同的混合模式搭配是否需要离屏从而产生不同的效果。

示例5(前景智能取反色)

该示例主要通过InvertOptions来实现前景智能取反色。

// xxx.ets
 @Entry
 @Component
 struct Index {
   build() {
    Stack() {
      Column()
        Stack(){
          Image($r('app.media.r')).width('100%')
         Column(){
           Column().width("100%").height(30).invert({
             low:0,
             high:1,
             threshold:0.5,
             thresholdRange:0.2
           })
           Column().width("100%").height(30).invert({
             low:0.2,
             high:0.5,
             threshold:0.3,
             thresholdRange:0.2
           })
         }
        }
        .width('100%')
        .height('100%')
    }
  }
 }

示例6(设置同层阴影不重叠效果)

该示例主要通过useShadowBatching搭配shadow实现同层阴影不重叠效果。

// xxx.ets
@Entry
@Component
struct UseShadowBatchingExample {
  build() {
    Column() {
      Column({ space: 10 }) {
        Stack() {

        }.width('90%').height(50).margin({ top: 5 }).backgroundColor(0xFFE4C4)
        .shadow({ radius: 120, color: Color.Green, offsetX: 0, offsetY: 0 })
        .align(Alignment.TopStart).shadow({ radius: 120, color: Color.Green, offsetX: 0, offsetY: 0 })

        Stack() {

        }.width('90%').height(50).margin({ top: 5 }).backgroundColor(0xFFE4C4)
        .align(Alignment.TopStart).shadow({ radius: 120, color: Color.Red, offsetX: 0, offsetY: 0 })
        .width('90%')
        .backgroundColor(Color.White)

        Column() {
          Text()
            .fontWeight(FontWeight.Bold)
            .fontSize(20)
            .fontColor(Color.White)
        }
        .justifyContent(FlexAlign.Center)
        .width(150)
        .height(150)
        .borderRadius(10)
        .backgroundColor(0xf56c6c)
        .shadow({ radius: 300, color: Color.Yellow, offsetX: 0, offsetY: 0 })

        Column() {
          Text()
            .fontWeight(FontWeight.Bold)
            .fontSize(20)
            .fontColor(Color.White)
        }
        .justifyContent(FlexAlign.Center)
        .width(150)
        .height(150)
        .backgroundColor(0x67C23A)
        .borderRadius(10)
        .translate({ y: -50})
        .shadow({ radius: 220, color: Color.Blue, offsetX: 0, offsetY: 0 })
      }
      .useShadowBatching(true)
    }
    .width('100%').margin({ top: 5 })
  }
}

示例7(设置组件图像球面效果)

该示例主要演示通过sphericalEffect设置组件的图像球面效果。

// xxx.ets
@Entry
@Component
struct SphericalEffectExample {
  build() {
    Stack() {
      TextInput({ placeholder: "请输入变化范围百分比([0%,100%])"})
        .width('50%')
        .height(35)
        .type(InputType.Number)
        .enterKeyType(EnterKeyType.Done)
        .caretColor(Color.Red)
        .placeholderColor(Color.Blue)
        .placeholderFont({
          size: 20,
          style: FontStyle.Italic,
          weight: FontWeight.Bold
        })
        .sphericalEffect(0.5)
    }.alignContent(Alignment.Center).width("100%").height("100%")
  }
}

效果图如下:

去掉sphericalEffect的设置,效果如下:

示例8(设置组件图像渐亮效果)

该示例主要演示通过lightUpEffect设置组件的图像渐亮效果。

// xxx.ets
@Entry
@Component
struct LightUpExample {
  build() {
    Stack() {
      Text('This is the text content with letterSpacing 0.')
        .letterSpacing(0)
        .fontSize(12)
        .border({ width: 1 })
        .padding(10)
        .width('50%')
        .lightUpEffect(0.6)
    }.alignContent(Alignment.Center).width("100%").height("100%")
  }
}

效果图如下:

修改lightUpEffect参数值为0.2:

去掉lightUpEffect的设置,效果如下:

示例9(设置组件图像边缘像素扩展效果)

该示例主要演示通过pixelStretchEffect设置组件的图像边缘像素扩展效果。

// xxx.ets
@Entry
@Component
struct PixelStretchExample {
  build() {
    Stack() {
      Text('This is the text content with letterSpacing 0.')
        .letterSpacing(0)
        .fontSize(12)
        .border({ width: 1 })
        .padding(10)
        .clip(false)
        .width('50%')
        .pixelStretchEffect({top:10,left:10,right:10,bottom:10 })
    }.alignContent(Alignment.Center).width("100%").height("100%")
  }
}

效果图如下:

去掉pixelStretchEffect的设置,原图效果如下:

示例10(系统导航条智能反色)

该示例主要演示通过systemBarEffect来实现系统导航条智能反色。

// xxx.ets
@Entry
@Component
struct Index {
  build() {
    Column() {
      Stack(){
        Image($r('app.media.testImage')).width('100%').height('100%')
         Column().width(150).height(10)
          .systemBarEffect()
           .border({radius:5})
           .margin({bottom:80})
      }.alignContent(Alignment.Center)
    }
  }
}

效果图如下:

OpenHarmony实战开发-动画效果、如何实现色彩渐变效果 通过颜色渐变接口,可以设置组件的背景颜色渐变效果,实现在两个或多个指定的颜色之间进行平稳的过渡。 阅读详情

相关推荐

如何使用命令行对RK开发板进行OpenHarmony版本烧录?

开发版烧录

m0_64420071的博客 2317

【HarmonyOS NEXT】ArkTS组件如何设置阴影

图像效果中的shadow接口可以为组件添加阴影效果。图像效果 / 阴影 / shadow。ArkTS组件如何设置阴影?

Mayism123的博客 2541

鸿蒙NEXT开发:ArkUI框架UI界面-@ohos.arkui.componentSnapshot (组件截图)

本模块提供获取组件截图的能力,包括已加载的组件的截图和没有加载的组件的截图。

ZPYQAQ的博客 1017

arkTs边框阴影实现

arkTs边框阴影实现

xiaoxiongxia的博客 1869

鸿蒙5.0版开发:UI框架JS组件-画布组件(OffscreenCanvasRenderingContext2D对象)

使用OffscreenCanvasRenderingContext2D在OffscreenCanvas对象上进行绘制,绘制对象可以是矩形、文本、图片等

m0_69424697的博客 1021

DEM高程数据的获取、合并与坐标转换

DEM高程数据的获取、合并与坐标转换一、DEM数据的获取二、数据合并三、投影转换方法一四、投影转换方法二 今天用DEM数据做了一个坡度分析,数据使用过程中涉及到投影坐标转换,由于不是很熟悉所以费了一番功夫。经过一番折腾总结出两个方法,方法一自认为比较便捷的方法,即通过BIGMAP软件中工具列表中的投影转换功能进行。方法二为传统方法,即在Arcgis中用投影栅格工具进行转换。 一、DEM数据的获取 在地理空间数据云网站下载DEM数据(精度包括30米和90米),数据格式为tif格式或img格式,坐标为WGS_1

weixin_48625651的博客 1万+

【鸿蒙next开发】ArkUI框架:ArkTS组件-图像效果

文章详细解析了多个API接口及其参数,包括图像效果设置、元服务API、系统能力等。

m0_73088370的博客 729

从无人机到机械臂:深入聊聊LQR和LQG在实际项目里的那些‘坑’与最佳实践

本文深入探讨了LQR和LQG在无人机和机械臂等实际项目中的应用挑战与最佳实践。从系统建模的妥协艺术到调参的系统化方法,再到离散化的细节处理,文章分享了工程实践中的宝贵经验。特别强调了如何应对传感器噪声、未建模动态等现实问题,并提供了实用的调试工具和诊断流程,帮助工程师避免常见陷阱,提升控制系统的稳定性和性能。

weixin_28683391的博客 387

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(背景设置)

设置组件的背景样式。

Androidbye的博客 1248

Frida实战:SSL Pinning绕过技术全解析

本文详细解析了如何使用Frida工具绕过SSL Pinning技术,包括环境搭建、四种实战绕过方案及常见问题排查指南。通过具体代码示例和实战经验,帮助安全研究人员快速掌握SSL Pinning绕过技术,适用于金融类App的安全测试场景。

weixin_42530732的博客 188

Spring Boot 实现多图片上传并回显,涨姿势了~

上传 Controller的代码非常简单,由于用了SpringMVC框架,所以直接用MultipartFile来接即可。由于是多图片上传所以用数组来接。此处应该注意参数名应该和<input>中的name值相对应: @RequestMapping("/pic") @ResponseBody publicResponseEntity<String>pic(MultipartFile[]pictures)throwsException{ ResponseEnti...

weixin_54556126的博客 894

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(组件内容模糊)

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

Androidbye的博客 1074

Simplorer-Maxwell联合仿真速度太慢?我用这3个技巧把仿真时间砍半(附SVPWM周期与步长设置避坑)

本文详细介绍了Simplorer-Maxwell联合仿真性能优化的3个关键技巧,包括仿真步长与周期的科学配置、基于任务调度的加速技术以及模型简化与精度平衡。特别针对SVPWM参数设置提供了避坑指南,帮助工程师在不牺牲精度的情况下将仿真时间缩短50%以上,适用于电机驱动系统开发等场景。

weixin_29189381的博客 467

【鸿蒙next开发】ArkUI框架:ArkTS组件-Gauge

本文详细介绍了鸿蒙HarmonyOS 5.0中的Gauge组件使用......

m0_73088370的博客 1050

RK3588开发板量产前必做:24小时DDR压力测试到底在测什么?(附ArmSoM-W3测试脚本解析)

本文深入解析RK3588开发板量产前的24小时DDR压力测试,揭示其核心价值与技术原理。通过memtester、stressapptest和变频测试的组合使用,全面验证DDR内存稳定性。特别介绍ArmSoM-W3测试脚本的创新设计,包括并行测试架构和异常熔断机制,为开发者提供可靠的量产测试方案。

weixin_30325487的博客 455

AI数字人直播带货全攻略:从零搭建到高效运营

本文提供了一份从零开始搭建与运营AI数字人直播间的完整指南。详细解析了AI数字人直播带货的核心价值与适用场景,并分步讲解了硬件准备、软件选择、数字人创建、话术编排、OBS推流设置及开播测试等关键环节。最后,文章还分享了高效运营策略与常见避坑指南,旨在帮助商家利用AI技术实现降本增效,打造24小时不间断的智能带货直播间。

weixin_29269441的博客 2245

鸿蒙5.0版开发:ArkTS组件通用属性(图像效果)

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

m0_73088370的博客 1399

11、硬件工程师笔试面试——IGBT(2025版本)

IGBT的应用展望与创新趋势表明,随着电子技术的不断发展,IGBT在各个领域都有广泛的应用,如高压电力系统、交通工具、电锅炉、太阳能和风能发电系统等。FS型IGBT(场终止型绝缘栅双极晶体管)在电力传输领域的应用中,通过其独特的设计和特性,有助于确保系统的稳定性和安全性。每种器件都有其独特的优势,能够满足电力传输系统中不同的技术要求。FS型IGBT通常具有正温度系数,这意味着随着温度的升高,导通压降的主要影响因素是载流子迁移率的降低以及集电极和发射极的接触电阻的增加,有助于在高温下维持稳定的性能。

XU157303764的博客 2676

【鸿蒙next开发】ArkUI框架:ArkTS组件-背景设置

本文详细介绍了鸿蒙5.0开发中的背景设置功能,涵盖了多种背景样式的配置方法。

m0_73088370的博客 1338

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

老版QQ原生表情gif动态

这是老版的QQ表情,不过全是动态的的,Windows照片查看器是不会动的,可以右击用浏览器打开查看,再说一遍是老版的,只是分享给宁愿用老版也要动态的人。

鸿蒙API14开发【图像效果】ArkUI

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

bbq的博客 1074

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

鸿蒙5.0开发进阶:UI框架-ArkTS组件(XComponent)

提供用于图形绘制和媒体数据写入的Surface...........

Androidbye的博客 1238

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.arkui.componentSnapshot (组件截图)

本模块提供获取组件截图的能力,包括已加载的组件的截图和没有加载的组件的截图。

Androidbye的博客 1004

【鸿蒙next开发】ArkUI框架:ArkTS组件-组件内容模糊

本文详细说明了foregroundBlurStyle方法的参数,包括模糊样式和可选参数,如颜色模式、取色模式和模糊程度等。

m0_73088370的博客 789

鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(自定义绘制设置)

当某些组件本身的绘制内容不满足需求时...........

Androidbye的博客 1058

【鸿蒙next开发】ArkUI框架:ArkTS组件-自定义绘制设置

本文介绍了鸿蒙5.0开发中的自定义组件绘制功能,详细讲解了如何使用DrawModifier接口进行组件的前景、内容和背景的自定义绘制。

m0_73088370的博客 957

鸿蒙API13开发【组件内容模糊】ArkTS组件

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

鸿蒙的技术博客 1099
上一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(图形变换)
下一篇: 鸿蒙5.0开发进阶:API ArkUI框架-ArkTS组件(形状裁剪)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值