OpenGL片段着色器mix函数失效及采样器重命名纹理异常问题

采样器重命名后纹理失效的原因及解决 #

采样器重命名后无法正常工作，大概率是uniform位置获取失败或纹理绑定流程出错，按以下步骤排查：

• 先打印glGetUniformLocation的返回值，如果是-1，说明着色器中找不到对应变量：
  • 核对代码中传入的变量名和着色器里的拼写、大小写完全一致（GLSL是大小写敏感的，比如OurTexture和ourTexture是两个不同变量）
  • 确认着色器中的采样器变量是全局作用域，没被定义在函数内部
  • 强制打印着色器编译日志，检查是否有语法错误（很多时候编译失败程序不会崩溃，但uniform会失效）
• 确保glGetUniformLocation是在glLinkProgram成功之后调用的，链接前着色器程序未完成合并，无法正确获取uniform位置
• 检查纹理绑定的单元是否对应：给每个纹理分配独立的纹理单元，比如把重命名后的采样器对应到GL_TEXTURE0，笑脸采样器对应GL_TEXTURE1，代码示例：

// 绑定第一个纹理
glActiveTexture(GL_TEXTURE0);
glBindTexture(GL_TEXTURE_2D, ourTextureID);
int texture1Loc = glGetUniformLocation(shaderProgram, "texture1"); // 重命名后的变量名
glUniform1i(texture1Loc, 0);

// 绑定第二个纹理
glActiveTexture(GL_TEXTURE1);
glBindTexture(GL_TEXTURE_2D, smileyTextureID);
int texture2Loc = glGetUniformLocation(shaderProgram, "smileyTexture");
glUniform1i(texture2Loc, 1);

调用mix()后黑屏的问题排查 #

黑屏通常是因为其中一个或两个纹理采样返回了全黑（vec4(0,0,0,0)），解决采样器问题后再按以下步骤验证：

• 先单独测试每个纹理的采样：把片段着色器的输出改成FragColor = texture(texture1, TexCoords);和FragColor = texture(texture2, TexCoords);，确认两张图都能正常显示
• 如果用了texture(smileyTexture, texCoords).a作为混合因子，检查笑脸纹理的格式：
  • 如果纹理加载时用的是GL_RGB格式，那么alpha通道会被默认设为0，混合因子变成0，此时mix结果等于第一个纹理；如果第一个纹理也没正确采样，就会黑屏
  • 改成加载GL_RGBA格式，或者直接用固定值（比如0.2）测试混合效果
• 简化mix表达式，比如先写FragColor = mix(baseColor, vec4(1.0,0.0,0.0,1.0), 0.2);，看是否能显示红色混合效果，排除纹理采样的问题

正确的片段着色器示例 #

#version 330 core
out vec4 FragColor;

in vec2 TexCoords;

uniform sampler2D texture1; // 重命名后的采样器
uniform sampler2D smileyTexture;

void main()
{
    vec4 baseColor = texture(texture1, TexCoords);
    vec4 overlayColor = texture(smileyTexture, TexCoords);
    FragColor = mix(baseColor, overlayColor, 0.2);
}

内容的提问来源于stack exchange，提问作者Dr-Galunga