动效概述

笔刷需要与image标签共同使用，当手指滑动屏幕时可以擦除覆盖图片或覆盖颜色所在的图层，显示出背景图片所在图层。若color值不为空，则覆盖图层用颜色来填充，否则用Image图片来填充。注意，用image图片填充时，需要保证背景图片与笔刷覆盖层图片宽高相同（实际图片资源的宽高），以保证笔刷图片完全覆盖背景图。

场景举例

可用于实现游戏中的刮彩票的场景。
可以实现通过擦除图片显示下面的底图。
擦除图片可揭开古风美女面罩。
固定位置刷开后可显示解锁，否则显示谢谢惠顾或再来一次等。
粉刷，更换墙壁颜色。
可用于刮开雾气等场景。
模拟冬天起雾的玻璃，用户用手指写字画画。

XML规范

<!--背景图片-->
<Image x="" y="" w="" h="" src=""/> 
<!--笔刷功能，参数说明主要针对下面Image和Paint标签中的参数进行说明-->
<Image x="" y="" w="" h="" src=""/> 
  <Paint weight="" color="" clear_percent=""/> 
</Image>

参数说明

<Image>

参数	类型	选项	注释
x	数值	选填	笔刷覆盖图层左上角相对于屏幕的x轴坐标，单位为像素，默认为0，支持表达式。
y	数值	选填	笔刷覆盖图层左上角相对于屏幕的y轴坐标，单位为像素，默认为0，支持表达式。
w	数值	选填	笔刷覆盖图层宽度，单位为像素。如果覆盖图层是图片，w无效，实际w为图片的宽度；如果是颜色覆盖则必须填写w，否则默认为0，支持表达式。
h	数值	选填	笔刷覆盖图层高度，单位为像素。如果覆盖图层是图片，h无效，实际h为图片的高度；如果是颜色覆盖则必须填写h，否则默认为0，支持表达式。
src	字符串	选填	笔刷覆盖层图片名称，若覆盖层为颜色填充则该值可不填写。

<Paint>

参数	类型	选项	注释
weight	数值	必填	笔刷的粗细，单位为像素，值越大，笔刷越粗，值越小，笔刷越细，取正实数，默认为0，支持表达式。
color	字符串	选填	如果覆盖图层想用颜色进行覆盖，则填写6或8位16进制颜色，如#afffffff。
clear_percent	数值	选填	当覆盖图层被笔刷刷掉这个比例后，整个覆盖图层自动清除，显示背景图层。取值范围为1-100，默认60，支持表达式。

效果和脚本展示

[h2]笔刷动效示例一

覆盖图层是用颜色进行填充。可以看到笔刷功能中的Image未设置src，但是设置了color。

<!--颜色覆盖-->
<Image w="#screen_width" h="#screen_height" src="bg.jpg"/>
<Image x="0" y="0" w="#screen_width" h="#screen_height">
 <Paint weight="200" color="#ADADAD" clear_percent="60"/>
</Image>

[h2]笔刷动效示例二

覆盖图层用图片进行填充。可以看到笔刷功能中的Image设置了src，但是未设置color。

<!--图片覆盖-->
<Image w="#screen_width" h="#screen_height" src="bg.jpg"/>
<Image x="0" y="0" w="#screen_width" h="#screen_height" src="part.jpg">
 <Paint weight="200" clear_percent="60"/>
</Image>

目录

笔刷<Paint>