GlDebug.java
com.mojang.blaze3d.opengl.GlDebug
信息
- 全限定名：com.mojang.blaze3d.opengl.GlDebug
- 类型：public class
- 包：com.mojang.blaze3d.opengl
- 源码路径：src/main/java/com/mojang/blaze3d/opengl/GlDebug.java
- 起始行号：L24
- 职责：
TODO
字段/常量
-
LOGGER- 类型:
Logger - 修饰符:
private static final - 源码定位:
L25 - 说明:
TODO
- 类型:
-
CIRCULAR_LOG_SIZE- 类型:
int - 修饰符:
private static final - 源码定位:
L26 - 说明:
TODO
- 类型:
-
MESSAGE_BUFFER- 类型:
Queue<GlDebug.LogEntry> - 修饰符:
private final - 源码定位:
L27 - 说明:
TODO
- 类型:
-
lastEntry- 类型:
GlDebug.LogEntry - 修饰符:
private volatile - 源码定位:
L28 - 说明:
TODO
- 类型:
-
DEBUG_LEVELS- 类型:
List<Integer> - 修饰符:
private static final - 源码定位:
L29 - 说明:
TODO
- 类型:
-
DEBUG_LEVELS_ARB- 类型:
List<Integer> - 修饰符:
private static final - 源码定位:
L30 - 说明:
TODO
- 类型:
内部类/嵌套类型
com.mojang.blaze3d.opengl.GlDebug.LogEntry- 类型:
class - 修饰符:
private static - 源码定位:
L161 - 说明:
TODO
- 类型:
构造器
- 无
方法
下面的方法块按源码顺序生成。
private static String printUnknownToken(int token) @ L32
- 方法名：printUnknownToken
- 源码定位：L32
- 返回类型：String
- 修饰符：private static
参数:
- token: int
说明:
TODO
public static String sourceToString(int source) @ L36
- 方法名：sourceToString
- 源码定位：L36
- 返回类型：String
- 修饰符：public static
参数:
- source: int
说明:
TODO
public static String typeToString(int type) @ L55
- 方法名：typeToString
- 源码定位：L55
- 返回类型：String
- 修饰符：public static
参数:
- type: int
说明:
TODO
public static String severityToString(int severity) @ L76
- 方法名：severityToString
- 源码定位：L76
- 返回类型：String
- 修饰符：public static
参数:
- severity: int
说明:
TODO
private void printDebugLog(int source, int type, int id, int severity, int length, long message, long userParam) @ L91
- 方法名：printDebugLog
- 源码定位：L91
- 返回类型：void
- 修饰符：private
参数:
- source: int
- type: int
- id: int
- severity: int
- length: int
- message: long
- userParam: long
说明:
TODO
public List<String> getLastOpenGlDebugMessages() @ L108
- 方法名：getLastOpenGlDebugMessages
- 源码定位：L108
- 返回类型：List
- 修饰符：public
参数:
- 无
说明:
TODO
public static GlDebug enableDebugCallback(int verbosity, boolean debugSynchronousGlLogs, Set<String> enabledExtensions) @ L120
- 方法名：enableDebugCallback
- 源码定位：L120
- 返回类型：GlDebug
- 修饰符：public static
参数:
- verbosity: int
- debugSynchronousGlLogs: boolean
- enabledExtensions: Set
说明:
TODO
代码
@OnlyIn(Dist.CLIENT)
public class GlDebug {
private static final Logger LOGGER = LogUtils.getLogger();
private static final int CIRCULAR_LOG_SIZE = 10;
private final Queue<GlDebug.LogEntry> MESSAGE_BUFFER = EvictingQueue.create(10);
private volatile GlDebug.@Nullable LogEntry lastEntry;
private static final List<Integer> DEBUG_LEVELS = ImmutableList.of(37190, 37191, 37192, 33387);
private static final List<Integer> DEBUG_LEVELS_ARB = ImmutableList.of(37190, 37191, 37192);
private static String printUnknownToken(int token) {
return "Unknown (0x" + HexFormat.of().withUpperCase().toHexDigits(token) + ")";
}
public static String sourceToString(int source) {
switch (source) {
case 33350:
return "API";
case 33351:
return "WINDOW SYSTEM";
case 33352:
return "SHADER COMPILER";
case 33353:
return "THIRD PARTY";
case 33354:
return "APPLICATION";
case 33355:
return "OTHER";
default:
return printUnknownToken(source);
}
}
public static String typeToString(int type) {
switch (type) {
case 33356:
return "ERROR";
case 33357:
return "DEPRECATED BEHAVIOR";
case 33358:
return "UNDEFINED BEHAVIOR";
case 33359:
return "PORTABILITY";
case 33360:
return "PERFORMANCE";
case 33361:
return "OTHER";
case 33384:
return "MARKER";
default:
return printUnknownToken(type);
}
}
public static String severityToString(int severity) {
switch (severity) {
case 33387:
return "NOTIFICATION";
case 37190:
return "HIGH";
case 37191:
return "MEDIUM";
case 37192:
return "LOW";
default:
return printUnknownToken(severity);
}
}
private void printDebugLog(int source, int type, int id, int severity, int length, long message, long userParam) {
String msg = GLDebugMessageCallback.getMessage(length, message);
GlDebug.LogEntry entry;
synchronized (this.MESSAGE_BUFFER) {
entry = this.lastEntry;
if (entry != null && entry.isSame(source, type, id, severity, msg)) {
entry.count++;
} else {
entry = new GlDebug.LogEntry(source, type, id, severity, msg);
this.MESSAGE_BUFFER.add(entry);
this.lastEntry = entry;
}
}
LOGGER.info("OpenGL debug message: {}", entry);
}
public List<String> getLastOpenGlDebugMessages() {
synchronized (this.MESSAGE_BUFFER) {
List<String> result = Lists.newArrayListWithCapacity(this.MESSAGE_BUFFER.size());
for (GlDebug.LogEntry e : this.MESSAGE_BUFFER) {
result.add(e + " x " + e.count);
}
return result;
}
}
public static @Nullable GlDebug enableDebugCallback(int verbosity, boolean debugSynchronousGlLogs, Set<String> enabledExtensions) {
if (verbosity <= 0) {
return null;
} else {
GLCapabilities caps = GL.getCapabilities();
if (caps.GL_KHR_debug && GlDevice.USE_GL_KHR_debug) {
GlDebug debug = new GlDebug();
enabledExtensions.add("GL_KHR_debug");
GL11.glEnable(37600);
if (debugSynchronousGlLogs) {
GL11.glEnable(33346);
}
for (int i = 0; i < DEBUG_LEVELS.size(); i++) {
boolean isEnabled = i < verbosity;
KHRDebug.glDebugMessageControl(4352, 4352, DEBUG_LEVELS.get(i), (int[])null, isEnabled);
}
KHRDebug.glDebugMessageCallback(GLDebugMessageCallback.create(debug::printDebugLog), 0L);
return debug;
} else if (caps.GL_ARB_debug_output && GlDevice.USE_GL_ARB_debug_output) {
GlDebug debug = new GlDebug();
enabledExtensions.add("GL_ARB_debug_output");
if (debugSynchronousGlLogs) {
GL11.glEnable(33346);
}
for (int i = 0; i < DEBUG_LEVELS_ARB.size(); i++) {
boolean isEnabled = i < verbosity;
ARBDebugOutput.glDebugMessageControlARB(4352, 4352, DEBUG_LEVELS_ARB.get(i), (int[])null, isEnabled);
}
ARBDebugOutput.glDebugMessageCallbackARB(GLDebugMessageARBCallback.create(debug::printDebugLog), 0L);
return debug;
} else {
return null;
}
}
}
@OnlyIn(Dist.CLIENT)
private static class LogEntry {
private final int id;
private final int source;
private final int type;
private final int severity;
private final String message;
private int count = 1;
private LogEntry(int source, int type, int id, int severity, String message) {
this.id = id;
this.source = source;
this.type = type;
this.severity = severity;
this.message = message;
}
private boolean isSame(int source, int type, int id, int severity, String message) {
return type == this.type && source == this.source && id == this.id && severity == this.severity && message.equals(this.message);
}
@Override
public String toString() {
return "id="
+ this.id
+ ", source="
+ GlDebug.sourceToString(this.source)
+ ", type="
+ GlDebug.typeToString(this.type)
+ ", severity="
+ GlDebug.severityToString(this.severity)
+ ", message='"
+ this.message
+ "'";
}
}
}引用的其他类
- 无