Mask(遮罩)组件参考

Mask 用于规定子节点可渲染的范围,带有 Mask 的组件的节点会使用该节点的约束框(也就是size规定的范围)创建一个渲染遮罩,该节点的所有子节点都会依据这个遮罩进行裁剪,遮罩范围外的将不会渲染。

add-mask

点击 属性检查器 下面的 添加组件 按钮,然后从 添加渲染组件 中选择 Mask,即可添加 Mask 组件到节点上。注意该组件不能添加到有其他渲染组件的节点上,如 SpriteLabel 等。

遮罩的脚本接口请参考Mask API

mask.png

Mask 属性

属性功能说明
Type遮罩类型 Type API
Inverted布尔值,反向遮罩
AlphaThreshold浮点数,只有当模板的像素的 alpha 大于 alphaThreshold 时,才会绘制内容,该数值 0 ~ 1 之间的浮点数,1 表示因此禁用 alpha 只在遮罩 IMAGE_STENCIL 类型可用
SpriteFrame遮罩所需要的贴图,只在遮罩 IMAGE_STENCIL 类型可用
Segements椭圆遮罩的曲线细分数,只在遮罩 ELLIPSE 类型可用

详细说明

给节点添加 Mask 组件之后,所有在该节点下的子节点在渲染的时候都会受 Mask 影响。