图形渲染与 Shader / 系统课时
排查纹理异常
排查纹理异常
纹理全黑、上下翻转、错位、模糊或采样到错误图片,通常分别对应上传、坐标、纹理单元和采样参数的问题。本篇按症状建立定位顺序,并用最小诊断代码确认纹理是否完整、绑定是否正确。
学习目标
- 能根据纹理症状快速锁定上传、坐标或采样阶段
- 能正确建立 sampler、纹理单元与纹理对象之间的绑定关系
- 能处理 Y 轴翻转、像素行对齐、mipmap 与过滤器配置错误
先按症状缩小范围
“全黑”和“采样错图”优先检查纹理对象是否完整、sampler 指向的纹理单元是否正确;“上下翻转”优先检查纹理坐标与图片原点约定;“条纹、斜线或横向错位”常见于像素行对齐;“远处闪烁或过度模糊”则多与 mipmap 和过滤器有关。

先根据症状决定检查点,比逐个修改所有纹理参数更快。尤其要把“图片文件读入失败”和“图片读入成功但 GPU 采样错误”区分开。
验证纹理上传是否完整
上传完成后可以直接查询纹理 0 级的宽高,并同时读取错误状态。下面是片段示例,依赖已经创建的 OpenGL 上下文以及一个完成 glTexImage2D 的二维纹理对象。
#include <cstdio>
#include <glad/glad.h>
void inspectTexture2D(GLuint texture) {
glBindTexture(GL_TEXTURE_2D, texture);
GLint width = 0;
GLint height = 0;
glGetTexLevelParameteriv(GL_TEXTURE_2D, 0, GL_TEXTURE_WIDTH, &width);
glGetTexLevelParameteriv(GL_TEXTURE_2D, 0, GL_TEXTURE_HEIGHT, &height);
GLenum error = glGetError();
std::printf("texture=%u size=%dx%d\\n", texture, width, height);
std::printf("glGetError=0x%04X\\n", error);
}预期输出
texture=<ID> size=<VALUE>x<VALUE>
glGetError=0x0000<ID> 与尺寸会随资源变化。如果宽高为 0,先回到图片加载和 glTexImage2D 参数;如果出现错误码,检查内部格式、输入格式、数据类型和当前绑定目标是否匹配。
对于 RGB 三通道图片,若每行字节数不是 4 的倍数,默认的 GL_UNPACK_ALIGNMENT=4 可能让后续行从错误位置读取,表现为斜纹或错位。上传前可临时改为 1,上传后再恢复默认值。
// 片段示例:适合 3 通道且行字节数不满足 4 字节对齐的图片。
glPixelStorei(GL_UNPACK_ALIGNMENT, 1);
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB8, width, height, 0,
GL_RGB, GL_UNSIGNED_BYTE, pixels);
glPixelStorei(GL_UNPACK_ALIGNMENT, 4);预期结果
纹理行不再出现周期性偏移或斜向错位;实际效果取决于源图片尺寸与通道数。核对纹理坐标和 Y 轴方向
OpenGL 纹理坐标通常把左下角视为 (0, 0),而许多图片解码库返回的数据按左上角开始排列,因此“上下颠倒”往往不是采样器故障,而是两套原点约定不同。
使用 stb_image 时可以在加载前调用 stbi_set_flip_vertically_on_load(true);也可以保持图片数据不变,在模型 UV 或着色器中把 v 改成 1.0 - v。两种方案选一种即可,若同时翻转两次,画面会回到原来的方向。
检查 sampler 与纹理单元
sampler uniform 保存的是纹理单元编号,不是 GL_TEXTURE0 这类枚举值。最常见的错误是把纹理绑定到单元 1,却让 sampler 仍指向默认的单元 0。
// 片段示例:依赖已链接的 program、有效 texture 和 sampler uniform。
glUseProgram(program);
glActiveTexture(GL_TEXTURE1);
glBindTexture(GL_TEXTURE_2D, texture);
GLint location = glGetUniformLocation(program, "uTexture");
glUniform1i(location, 1);预期结果
uTexture 从纹理单元 1 采样,显示该单元当前绑定的二维纹理。若场景中有多张纹理,逐个确认“激活哪个单元、绑定哪个对象、sampler 写入哪个整数”三者一致。还要注意 glUniform1i 必须作用于当前 glUseProgram 选中的程序。
处理模糊、闪烁和全黑采样
纹理过滤器决定放大和缩小时如何取样。像素风素材放大时通常使用 GL_NEAREST;普通照片或材质使用 GL_LINEAR 更自然。缩小时若使用带 mipmap 的 min filter,就必须提供完整 mip 层,最简单的方式是在 0 级上传后调用 glGenerateMipmap(GL_TEXTURE_2D)。
如果设置了 GL_LINEAR_MIPMAP_LINEAR 等 mipmap 过滤器却没有生成 mipmap,纹理会处于不完整状态,采样结果可能表现为全黑或不可用。远处表面闪烁明显时,也应优先确认 mipmap 是否存在,而不是只把过滤器改得更模糊。
最终可以用一条固定顺序排查:先确认图片数据和 0 级纹理尺寸,再检查像素对齐与 UV 方向,然后核对 texture unit 与 sampler,最后检查 mipmap、过滤和 wrap 参数。这样每一种异常都有明确的验证点,而不需要盲目替换纹理文件或重写着色器。