// 快速诊断：强制输出红色
// 片段着色器
void main() {
    FragColor = vec4(1.0, 0.0, 0.0, 1.0);  // 强制红色
}

// 获取详细的编译错误信息
err = clBuildProgram(program, 1, &device, NULL, NULL, NULL);
if (err != CL_SUCCESS) {
    size_t log_size;
    clGetProgramBuildInfo(program, device, CL_PROGRAM_BUILD_LOG, 0, NULL, &log_size);
    char *log = malloc(log_size);
    clGetProgramBuildInfo(program, device, CL_PROGRAM_BUILD_LOG, log_size, log, NULL);
    printf("Build Log:\n%s\n", log);
    free(log);
}

// OpenGL 4.3+ 调试回调
void APIENTRY debugCallback(GLenum source, GLenum type, GLuint id,
                            GLenum severity, GLsizei length,
                            const GLchar* message, const void* userParam) {
    // 过滤通知级别
    if (severity == GL_DEBUG_SEVERITY_NOTIFICATION) return;

    const char* severityStr;
    switch (severity) {
        case GL_DEBUG_SEVERITY_HIGH:         severityStr = "HIGH"; break;
        case GL_DEBUG_SEVERITY_MEDIUM:       severityStr = "MEDIUM"; break;
        case GL_DEBUG_SEVERITY_LOW:          severityStr = "LOW"; break;
        default:                             severityStr = "NOTIFICATION"; break;
    }

    const char* typeStr;
    switch (type) {
        case GL_DEBUG_TYPE_ERROR:               typeStr = "ERROR"; break;
        case GL_DEBUG_TYPE_DEPRECATED_BEHAVIOR: typeStr = "DEPRECATED"; break;
        case GL_DEBUG_TYPE_UNDEFINED_BEHAVIOR:  typeStr = "UNDEFINED"; break;
        case GL_DEBUG_TYPE_PORTABILITY:         typeStr = "PORTABILITY"; break;
        case GL_DEBUG_TYPE_PERFORMANCE:         typeStr = "PERFORMANCE"; break;
        default:                                typeStr = "OTHER"; break;
    }

    fprintf(stderr, "[GL %s/%s] ID:%u: %s\n", severityStr, typeStr, id, message);
}

// 初始化时启用
glEnable(GL_DEBUG_OUTPUT);
glEnable(GL_DEBUG_OUTPUT_SYNCHRONOUS);  // 同步回调（方便调试）
glDebugMessageCallback(debugCallback, nullptr);

# Ubuntu
sudo apt install renderdoc

# 或从官网下载
# https://renderdoc.org/builds

# 安装
sudo apt install apitrace

# 追踪 OpenGL 调用
apitrace trace --api=gl --output=trace.trace ./my_gl_app

# 查看追踪结果
qapitrace trace.trace

# 命令行分析
apitrace dump trace.trace | head -100

# 回放追踪
glretrace trace.trace

# 性能统计
apitrace replay trace.trace --benchmark

# 系统级性能分析
nsys profile --trace=cuda,opengl,vulkan ./my_app

# 生成报告
nsys stats report1.nsys-rep

// 宏：每行 GL 调用后自动检查
#ifdef DEBUG
#define GL_CHECK(call) do { \
    call; \
    GLenum err = glGetError(); \
    if (err != GL_NO_ERROR) { \
        fprintf(stderr, "GL Error 0x%04X at %s:%d (%s)\n", \
                err, __FILE__, __LINE__, #call); \
    } \
} while(0)
#else
#define GL_CHECK(call) call
#endif

// 使用
GL_CHECK(glDrawArrays(GL_TRIANGLES, 0, 36));
GL_CHECK(glBindTexture(GL_TEXTURE_2D, textureId));

GLuint compileShader(GLenum type, const char* source) {
    GLuint shader = glCreateShader(type);
    glShaderSource(shader, 1, &source, NULL);
    glCompileShader(shader);

    GLint success;
    glGetShaderiv(shader, GL_COMPILE_STATUS, &success);
    if (!success) {
        char infoLog[2048];
        glGetShaderInfoLog(shader, sizeof(infoLog), NULL, infoLog);
        fprintf(stderr, "Shader compilation failed:\n%s\n", infoLog);
        fprintf(stderr, "Source:\n%s\n", source);
        glDeleteShader(shader);
        return 0;
    }
    return shader;
}

# 强制使用软件渲染（排除 GPU 驱动问题）
LIBGL_ALWAYS_SOFTWARE=1 ./my_app

# 使用特定的 Mesa 驱动
GALLIUM_DRIVER=llvmpipe ./my_app   # LLVM 软件渲染
GALLIUM_DRIVER=softpipe ./my_app   # 参考软件渲染（最慢但最准确）

# CMake 调试构建
cmake .. -DCMAKE_BUILD_TYPE=Debug -DENABLE_GL_DEBUG=ON

# 启用 Address Sanitizer
cmake .. -DCMAKE_BUILD_TYPE=Debug -DENABLE_ASAN=ON