• Mask(遮罩)组件参考
    • Mask 属性
    • 详细说明

    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 影响。