蒙层（Stage Mask，也可理解为舞台遮罩）Block 可以在舞台上覆盖一层颜色、渐变或纹理，也可以按指定形状裁剪场景和立绘。它适合制作聚光灯、望远镜视野、局部遮挡、异形画框和氛围滤镜。
与用于整屏开合过渡的幕布不同，蒙层可以自由设置位置、尺寸、形状和层级。
基本用法
插入蒙层 Block
在空白旁白块按 Tab，搜索并选择「蒙层」。
选择模式
选中 Block，在检查器中选择「覆盖蒙层」或「对象裁剪」，再设置显示层级或裁剪目标。
调整形状
在操作盘中拖动位置、尺寸和旋转，选择保留形状内部或外部，并按需设置羽化。
设置入场效果
调整入场时长，然后运行预览检查蒙层与对白、角色和 UI 的叠放关系。
覆盖蒙层与对象裁剪
| 模式 | 效果 | 常见用途 |
|---|
| 覆盖蒙层 | 在指定层级绘制颜色、渐变或纹理，可叠加模糊、暗角、噪点和调色 | 聚光灯、画面染色、暗角氛围、局部遮挡 |
| 对象裁剪 | 按形状保留或隐藏目标的一部分，不额外绘制填充 | 异形立绘、局部场景、画中画边界 |
形状与可见区域
蒙层支持矩形、圆角矩形、椭圆和自定义图片四种形状。位置和尺寸按设计画布的百分比保存，因此更换预览窗口大小时仍会保持相对位置。
「保留内部 / 保留外部」决定原画面哪一侧继续可见：
- 保留内部：形状内部可见，外部被覆盖或裁掉。黑色覆盖蒙层配合椭圆形状即可制作聚光灯。
- 保留外部：形状外部可见，内部被覆盖或裁掉，适合挖洞或隐藏局部。
羽化会软化形状边缘。数值越大，过渡越柔和；需要清晰画框时保持为 0。
自定义图片形状
选择图片形状后，可以使用 PNG 或 WebP 素材，并设置：
- 透明度通道：按图片透明区域生成形状，适合带透明背景的图案。
- 亮度通道：按黑白明暗生成形状，适合灰度遮罩图。
- 拉伸 / 铺满 / 完整：控制图片在蒙层范围中的适配方式。
图片形状决定蒙层边界；覆盖模式中的「纹理填充」决定蒙层覆盖区域实际绘制的图案，两者可以分别选择不同素材。
边缘与外观
覆盖蒙层可以使用三种填充：
| 填充 | 可调内容 |
|---|
| 纯色 | 颜色和强度 |
| 渐变 | 起始色、结束色、方向和强度；0° 为上到下，90° 为左到右 |
| 纹理 | 图片、铺满方式、混合模式、缩放和透明度 |
在剧情中改变蒙层
需要在后续剧情改变蒙层时，再添加一条「蒙层」，保持「显示蒙层」，然后设置新的模式、形状或外观。运行到这里时，当前蒙层会更新为新的效果。
新版可视化检查器会自动管理当前蒙层。
移除蒙层
在需要关闭效果的位置再添加一条「蒙层」，选中后在检查器顶部切换到「移除蒙层」：
切换后只需设置退场时长。
旧工程中可能出现独立的「移除蒙层（旧版）」Block。它仍可正常读取和运行，检查器也会显示「蒙层 ID」：填写 ID 时移除对应蒙层，留空时移除全部蒙层。新剧本请统一使用「蒙层」并切换到「移除蒙层」，不需要填写 ID。
典型用法
- 角色聚光：覆盖蒙层、椭圆、保留内部、黑色高强度填充，再把椭圆移到角色位置并增加羽化。
- 望远镜视野：覆盖蒙层、自定义图片或双圆图案、保留内部，在较高层级显示。
- 异形立绘：对象裁剪、指定角色、自定义图片形状，使用透明度通道控制边界。
- 夜景氛围：覆盖蒙层、整屏矩形、渐变或纹理填充，再小幅调整色相、饱和度和亮度。
复杂蒙层先用较短入场时长调试位置和层级，确认无误后再设置正式时长。效果不符合预期时，先检查模式、显示层级、作用范围和保留区域。
