OpenGL中2D片段着色器读取1D无符号整数缓冲区失败问题

问题背景 #

我用C++写了个OpenGL项目（依赖SDL和GLEW），要把距离信息编码到1D无符号整数缓冲区里。现在已经通过导出文件确认缓冲区写成功了，但在2D片段着色器里死活读不到这个帧缓冲纹理。测试程序的逻辑是先往1D帧缓冲画UV渐变，再从片段着色器读出来渲染到屏幕，核心就是要搞定1D无符号整数缓冲区的读写。

常见踩坑点及修复方法 #

1. 1D纹理参数没设对

无符号整数纹理不能用线性过滤，OpenGL不支持整数纹理的线性插值，必须把过滤模式设成GL_NEAREST。另外，环绕模式最好设成GL_CLAMP_TO_EDGE，避免采样超出纹理范围出问题。

glBindTexture(GL_TEXTURE_1D, distanceTex);
// 过滤模式必须是GL_NEAREST
glTexParameteri(GL_TEXTURE_1D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
glTexParameteri(GL_TEXTURE_1D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
// 环绕模式设为 clamp 防止越界
glTexParameteri(GL_TEXTURE_1D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
// 内部格式要用GL_R32UI这种无符号整数格式，数据格式对应GL_RED_INTEGER和GL_UNSIGNED_INT
glTexImage1D(GL_TEXTURE_1D, 0, GL_R32UI, texWidth, 0, GL_RED_INTEGER, GL_UNSIGNED_INT, nullptr);

2. 帧缓冲附着格式不匹配

创建帧缓冲的时候，要确保附着的纹理格式是整数类型，不然写入和读取的格式对不上。绑定后一定要检查帧缓冲是否完整：

glBindFramebuffer(GL_FRAMEBUFFER, distanceFBO);
glFramebufferTexture1D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_1D, distanceTex, 0);
// 必须检查帧缓冲状态
if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) {
    // 这里打日志或者抛错，排查格式不兼容问题
}

3. 着色器采样器类型错了

普通的sampler1D是用来采样浮点纹理的，读无符号整数纹理必须用usampler1D，不然采样到的整数会被自动转成0.0~1.0的浮点数，自然读不到正确的值。

#version 330 core
out vec4 FragColor;
// 注意这里是usampler1D，不是sampler1D
uniform usampler1D distanceTexture;
in vec2 screenUV;

void main() {
    // 用屏幕UV的x分量当1D采样坐标（假设纹理是水平方向）
    uint distVal = texture(distanceTexture, screenUV.x).r;
    // 把32位整数转成0~1的灰度值用来显示
    float gray = float(distVal) / 4294967295.0;
    FragColor = vec4(gray, gray, gray, 1.0);
}

4. 纹理单元绑定没对齐

渲染到屏幕前，要把1D纹理绑定到指定的纹理单元，然后告诉着色器采样器用这个单元，别搞混了：

// 激活纹理单元0
glActiveTexture(GL_TEXTURE0);
glBindTexture(GL_TEXTURE_1D, distanceTex);
// 告诉着色器，distanceTexture用的是单元0
GLint samplerLoc = glGetUniformLocation(screenShader, "distanceTexture");
glUniform1i(samplerLoc, 0);

5. 采样坐标超出范围

1D纹理的采样坐标是0.0_{1.0的范围，对应纹理的第一个到最后一个像素。如果你的屏幕UV是0}1的范围，直接用x分量就行，别瞎缩放导致坐标越界。

验证方法 #

1. 改完代码重新跑，看屏幕是不是显示出预期的UV渐变灰度图
2. 可以在着色器里把采样到的整数转成颜色输出（比如把低8位当红色，中8位当绿色），对比导出的缓冲区文件
3. 用glGetTexImage读1D纹理的数据，和导出的文件对比，确认纹理数据是对的

内容的提问来源于stack exchange，提问作者addiment