API 参考 / 渲染、资源与语言
RenderLayer
用途:引擎内置渲染层枚举,自底向上 7 层,编号越大越靠上。宿主在每层前后各投递一次 RenderEvent.Pre / .Post,7 层全部可插。
完整签名
java
public enum RenderLayer {
BACKGROUND(0),
WORLD(1),
NOTES(2),
JUDGE_FX(3),
HUD(4),
OVERLAY(5),
FULLSCREEN(6);
public int index();
}index()
签名:
java
public int index();行为:返回该层的固定编号 0-6,可用于排序或比较(layer.index() < RenderLayer.HUD.index())。
各层内容
| 层 | 编号 | 默认内容 |
|---|---|---|
BACKGROUND | 0 | 背景:模组背景渲染器(曲绘/纯色等),位于游玩内容之下 |
WORLD | 1 | 轨道容器:模组轨道样式、Z 分层轨道、HOLD 长条装饰 |
NOTES | 2 | 轨道与音符:真实/假轨道与音符、屏障指示 |
JUDGE_FX | 3 | 判定特效:打击特效(含模组 HitEffectStyle) |
HUD | 4 | 原版 HUD:combo、进度条、分数/准度/血条、模组 HUD 覆盖 |
OVERLAY | 5 | 覆盖层:altHud、暂停对话框、renderOverlay、入场黑幕 |
FULLSCREEN | 6 | 全屏后处理:模组滤镜(RenderFilter) |
层内叠放用开放整数层号(见 RenderFilter#zOrder() / BackgroundRenderer#zOrder()):数字越大越靠上,可为负数或大数字,不受 0-6 限制。