合作咨询
我们的专家服务团队将竭诚为您提供专业的合作咨询服务
1.Mask标签的x、y属性只与Image标签的x，y属性有关，与其他上级标签x、y属性无关。
2.Mask标签有rotation旋转属性时，pivotX/centerX需要在Mask图片width值的一半基础上加上Image标签的x值、pivotY/centerY属性需要在Mask图片height值的一半基础上加上Image标签的y值。
视图：遮罩<Mask>
功能概述
该功能需要与Image共同使用，对Image标签中的图片（tgt.png）和mask标签中的图片（ori.png）进行混合，支持12种混合模式。例如，通过混合可起到遮罩效果，即按照ori图片对tgt图片进行裁剪，使tgt图片显示与ori图片重叠区域的内容。通过设置align参数，可以达到tgt图片移动但ori图片不移动的效果。
说明
支持范围
起始规范版本：HarmonyOS 5.0
是否平台特性：否
表1 支持根标签
锁屏（Lockscreen） | 桌面（Wallpaper） | 一镜到底（LongTake） | 百变卡片（Widget） | 充电动效（ChargingSkin） | |
|---|---|---|---|---|---|
是否支持 | √ | √ | √ | √ | √ |
表2 支持设备类型
直板机 | 折叠屏 | 平板 | |
|---|---|---|---|
是否支持 | √ | √ | √ |
XML规范
<Image src="">
<Mask src="" align="" hybridMode=""/>
</Image> 参数说明
参数 | 类型 | 选项 | 注释 |
src | 字符串 | 必填 | src为遮罩图片的源地址 |
align | 字符串 | 选填 | 取值为absolute或relative。其中，absolute表示绝对位置，即ori图片不随着tgt图片移动而移动，遮罩(Mask)x,y坐标为相对于屏幕左上角的坐标；如果为相对位置relative，则ori会随着tgt而移动，遮罩(Mask)x,y坐标为相对于图片左上角的坐标。 默认情况下为relative。 |
hybridMode | 字符串 | 选填 | 设置两张图片之间的混合模式，共有12种混合模式供选择：
可以通过输入字符串或者对应的数字编号来选择混合模式，默认为6 |
应用示例
示例一：通过输入字符串来选择混合模式，同时采用绝对位置，当移动源图片时，遮罩图片不移动。
<Image src="tgt.png" x="0" y="#screen_height-92"> <Mask x="0" y="#screen_height-92" src="ori.png" align="absolute" hybridMode="tgtIn" /> </Image>
示例二：通过输入数字编号来选择混合模式，同时采用相对位置，当移动源图片时，遮罩图片跟随移动。
<Image x="0" y="#screen_height-92" src="tgt.png"> <PositionAnimation> <Position x="480" y="0" time="1000"/> <Position x="480" y="0" time="2000"/> </PositionAnimation> <Mask x="0" y="#screen_height-92" src="ori.png" align="relative" hybridMode="6"/> </Image>
搜索
请输入您想要搜索的关键词