图形渲染与 Shader / 系统课时

排查纹理异常

排查纹理异常

纹理全黑、上下翻转、错位、模糊或采样到错误图片,通常分别对应上传、坐标、纹理单元和采样参数的问题。本篇按症状建立定位顺序,并用最小诊断代码确认纹理是否完整、绑定是否正确。

学习目标

  • 能根据纹理症状快速锁定上传、坐标或采样阶段
  • 能正确建立 sampler、纹理单元与纹理对象之间的绑定关系
  • 能处理 Y 轴翻转、像素行对齐、mipmap 与过滤器配置错误

先按症状缩小范围

“全黑”和“采样错图”优先检查纹理对象是否完整、sampler 指向的纹理单元是否正确;“上下翻转”优先检查纹理坐标与图片原点约定;“条纹、斜线或横向错位”常见于像素行对齐;“远处闪烁或过度模糊”则多与 mipmap 和过滤器有关。

OpenGL 纹理异常定位关系

先根据症状决定检查点,比逐个修改所有纹理参数更快。尤其要把“图片文件读入失败”和“图片读入成功但 GPU 采样错误”区分开。

验证纹理上传是否完整

上传完成后可以直接查询纹理 0 级的宽高,并同时读取错误状态。下面是片段示例,依赖已经创建的 OpenGL 上下文以及一个完成 glTexImage2D 的二维纹理对象。

cpp
#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);
}

预期输出

text
texture=<ID> size=<VALUE>x<VALUE>
glGetError=0x0000

<ID> 与尺寸会随资源变化。如果宽高为 0,先回到图片加载和 glTexImage2D 参数;如果出现错误码,检查内部格式、输入格式、数据类型和当前绑定目标是否匹配。

对于 RGB 三通道图片,若每行字节数不是 4 的倍数,默认的 GL_UNPACK_ALIGNMENT=4 可能让后续行从错误位置读取,表现为斜纹或错位。上传前可临时改为 1,上传后再恢复默认值。

cpp
// 片段示例:适合 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);

预期结果

text
纹理行不再出现周期性偏移或斜向错位;实际效果取决于源图片尺寸与通道数。

核对纹理坐标和 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。

cpp
// 片段示例:依赖已链接的 program、有效 texture 和 sampler uniform。
glUseProgram(program);

glActiveTexture(GL_TEXTURE1);
glBindTexture(GL_TEXTURE_2D, texture);

GLint location = glGetUniformLocation(program, "uTexture");
glUniform1i(location, 1);

预期结果

text
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 参数。这样每一种异常都有明确的验证点,而不需要盲目替换纹理文件或重写着色器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查纹理异常

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通