目录

3.11.15.1.3 Mask 组件参考

优质
小牛编辑
127浏览
2023-12-01

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

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

Mask 属性

属性功能说明
Type遮罩类型。包括 RECTELLIPSEGRAPHICS_STENCIL 类型。
Segments椭圆遮罩的曲线细分数,只在遮罩类型设为 ELLIPSE 时生效
Inverted反向遮罩

注意

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

  2. GRAPHICS_STENCIL 类型在这里没有做任何引擎需要的事,只是放开了对 graphics 操控,用户可以使用这个 graphics 来绘制自定义图形,但是节点的点击事件还是根据节点的尺寸来计算。

  3. 在当前版本以及之前版本上,由于底层渲染架构原因,Mask 在编辑器下的所有子节点的渲染内容都看不见,解决方法是,在编辑器下调整 Mask 节点的 layer 为 default 即可,不会影响运行时数据。