OpenGL加载16x16 PNG纹理显示随机颜色问题求助

核心问题总结 #

加载16x16 PNG纹理时显示随机颜色，根源在于纹理数据传递错误、顶点属性偏移设置错误、着色器未激活以及错误处理逻辑颠倒，以下是具体问题和修复方案：

一、Texture类代码修复 #

1. 纹理数据指针传递错误 #

原代码中glTexImage2D最后一个参数传递了&data，但data本身就是unsigned char*类型，传递指针的地址会导致OpenGL读取错误内存区域，直接出现随机颜色。

修复代码：
将&data改为data：

// 错误写法
// glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA8, w, h, 0, GL_RGB, GL_UNSIGNED_BYTE, &data);
// 正确写法
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA8, w, h, 0, format, GL_UNSIGNED_BYTE, data);

2. 纹理格式与图像通道数不匹配 #

硬编码使用GL_RGB作为纹理格式，但PNG可能包含RGBA透明通道，需根据stbi返回的通道数bpp动态选择格式。

3. 图像加载失败的错误处理逻辑颠倒 #

原代码先创建OpenGL纹理对象，再判断图像是否加载成功，若加载失败会生成无效纹理，且释放资源时机错误。

完整修复后的TextureClass构造函数：

TextureClass::TextureClass(const std::string& path)
{
    int w, h, bpp;
    stbi_set_flip_vertically_on_load(1);
    unsigned char* data = stbi_load(path.c_str(), &w, &h, &bpp, 0);

    // 先判断图像是否加载成功
    if (!data)
    {
        std::cerr << "加载纹理失败: " << path << std::endl;
        stbi_image_free(data);
        return;
    }

    glGenTextures(1, &ID);
    glBindTexture(GL_TEXTURE_2D, ID);

    // 核心模式下无需调用glEnable(GL_TEXTURE_2D)，绑定纹理对象即可
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);

    // 根据通道数选择纹理格式
    GLenum format = (bpp == 3) ? GL_RGB : GL_RGBA;
    glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA8, w, h, 0, format, GL_UNSIGNED_BYTE, data);
    glGenerateMipmap(GL_TEXTURE_2D);

    glBindTexture(GL_TEXTURE_2D, 0);
    stbi_image_free(data);
}

二、主函数代码修复 #

1. 未激活着色器程序 #

绘制前未启用自定义着色器，OpenGL使用默认着色器无法正确采样纹理，需调用着色器的激活方法（假设Shader类有Use()方法，或直接调用glUseProgram）。

2. Uniform变量设置时机错误 #

glUniform1i必须在着色器激活后调用，否则无法设置目标着色器的uniform变量。

3. 顶点属性偏移设置错误 #

原代码中纹理坐标的偏移量写为(void*)1，这是字节偏移错误，每个顶点前2个是位置数据（占2*sizeof(float)字节），纹理坐标的偏移量应为(void*)(2 * sizeof(float))。

4. VAO/VBO/IBO绑定顺序错误 #

正确顺序应为先绑定VAO，再绑定VBO和IBO，VAO会记录后续VBO/IBO的绑定状态。

5. 主循环内绘制状态缺失 #

循环内需确保着色器、VAO、纹理处于绑定状态，避免状态丢失导致绘制异常。

修复后的主函数关键代码：

int main()
{
    // ... 窗口初始化代码省略 ...

    GLfloat vertices[] =
    {
        -0.5f, -0.5f,   0.0f, 0.0f,//左下
        0.5f, -0.5f,    1.0f, 0.0f,//右下
        0.5f, 0.5f,     1.0f, 1.0f,//右上
        -0.5f, 0.5f,    0.0f, 1.0f,//左上
    };

    unsigned int indices[] =
    {
        0,1,2,
        2,3,0,
    };

    ShaderProgramSource source = ParseShader("Basic.shader");
    const char* vertexShader = source.VertexSource.c_str();
    const char* fragmentShader = source.FragmentSource.c_str();
    Shader ShaderProgramm(vertexShader, fragmentShader);
    TextureClass DirtTexture("Dirt.png");

    // 先激活着色器，再设置uniform
    ShaderProgramm.Use();
    int Loc1 = ShaderProgramm.GetUniformId("tex0");
    glUniform1i(Loc1, 0);

    // 正确的VAO/VBO/IBO绑定顺序
    VAO vao;
    vao.Bind();

    VBO vbo(vertices, sizeof(vertices));
    vbo.Bind();

    IBO ibo(indices, sizeof(indices));
    ibo.Bind();

    // 设置顶点属性，修正纹理坐标偏移量
    vao.LinkAttrib(vbo, 0, 2, GL_FLOAT, 4 * sizeof(float), (void*)0);
    vao.LinkAttrib(vbo, 1, 2, GL_FLOAT, 4 * sizeof(float), (void*)(2 * sizeof(float)));

    //Main Loop
    while (!glfwWindowShouldClose(window))
    {
        glClear(GL_COLOR_BUFFER_BIT);

        // 确保绘制状态正确
        ShaderProgramm.Use();
        vao.Bind();
        DirtTexture.Bind(0);

        glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, nullptr);

        glfwSwapBuffers(window);
        glfwPollEvents();
    }

    // ... 资源释放代码省略 ...
}

三、其他注意事项 #

1. 确保Dirt.png文件路径正确，放在可执行文件同级目录，或使用绝对路径。
2. 检查Shader类的Use()和GetUniformId()方法是否正确实现，确保能正确激活着色器并获取uniform位置。
3. 核心模式下无需调用glEnable(GL_TEXTURE_2D)，绑定纹理对象即可启用纹理功能。

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