OpenGL中透明纹理渲染为黑色的问题求助

核心问题 #

纹理加载时glTexImage2D的内部格式参数错误，导致alpha通道被丢弃，无法传递到着色器，最终透明区域显示为黑色。

1. 修复纹理加载代码 #

原代码中glTexImage2D的第三个参数使用数值3（对应GL_RGB），这会让OpenGL仅存储RGB通道、忽略alpha数据。需要将其改为GL_RGBA，确保alpha通道被正确存储：

修改后的关键代码行：

# 替换原来的glTexImage2D调用
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, ix, iy, 0, GL_RGBA, GL_UNSIGNED_BYTE, image)

完整修改后的纹理加载方法：

@classmethod
def load_texture(cls, file_name: str):
    try:
        img = Image.open(f"{sys.path[0]}/res/{file_name}.png").convert('RGBA')
        img = img.transpose(Image.FLIP_TOP_BOTTOM)  # 翻转图片（适配OpenGL坐标系）
    except Exception as e:
        print(e)
        img = Image.open(f"{sys.path[0]}/res/missing_texture.png").convert('RGBA')
        img = img.transpose(Image.FLIP_TOP_BOTTOM)

    ix, iy, image = img.size[0], img.size[1], img.tobytes("raw", "RGBA", 0, -1)

    texture_id = glGenTextures(1)             
    cls.__textures.append(texture_id)
    glBindTexture(GL_TEXTURE_2D, texture_id)  
    # 修复内部格式为GL_RGBA，保留alpha通道
    glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, ix, iy, 0, GL_RGBA, GL_UNSIGNED_BYTE, image)

    glPixelStorei(GL_UNPACK_ALIGNMENT, 1)
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST)
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST)

    return texture_id

2. 优化片段着色器处理 #

原着色器中的texture_color = vec4(vec3(texture_color.a), 1.0)是测试用代码，实际使用时需恢复正确的纹理采样逻辑，并可启用alpha裁剪（直接丢弃透明像素）：

修改后的片段着色器：

#version 400 core

in vec2 pass_texture_coords;
in vec3 surface_normal;
in vec3 to_light_vector;
in vec3 to_camera_vector;

out vec4 out_color;

uniform sampler2D model_texture;
uniform vec3 light_color;
uniform float shine_damper;
uniform float reflectivity;

void main(void){
    vec4 texture_color = texture(model_texture, pass_texture_coords);
    
    // 裁剪半透明/完全透明的像素（可选，根据需求开启）
    if(texture_color.a < 0.5){
        discard;
    }

    vec3 unit_normal = normalize(surface_normal);
    vec3 unit_light_vector = normalize(to_light_vector);

    float n_dot1 = dot(unit_normal, unit_light_vector);
    float brightness = max(n_dot1, 0.1);
    vec3 diffuse = brightness * light_color;

    vec3 unit_vector_to_camera = normalize(to_camera_vector);
    vec3 light_direction = -unit_light_vector;
    vec3 reflected_light_direction = reflect(light_direction, unit_normal);

    float specular_factor = dot(reflected_light_direction, unit_vector_to_camera);
    specular_factor = max(specular_factor, 0.0);
    float damped_factor = pow(specular_factor, shine_damper);
    vec3 final_specular = damped_factor * reflectivity * light_color;

    // 保留纹理的alpha通道，确保透明混合效果正确
    out_color = vec4(diffuse, 1.0) * texture_color + vec4(final_specular, 1.0);
    out_color.a = texture_color.a;
}

3. 调整渲染初始化状态 #

现代OpenGL（4.0+）已弃用GL_ALPHA_TEST，建议移除该启用代码，改用着色器中的discard处理透明像素，避免状态冲突：

修改后的渲染初始化方法：

@staticmethod
def update_display():
    InputController().apply_input()                     # 应用每帧输入

    glEnable(GL_BLEND)
    glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)   # 保持正确的混合模式
    # 移除已弃用的GL_ALPHA_TEST
    # glEnable(GL_ALPHA_TEST)

    glEnable(GL_DEPTH_TEST)
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)  # 清空颜色和深度缓冲
    glClearColor(0, 0.3, 0, 1)                          # 设置背景色
    glLoadIdentity()                                    # 重置模型视图矩阵

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