使用Pyglet+GLSL实现战争迷雾时透明度失效问题求助

以下是几种常见的透明度失效原因及排查方案：

1. OpenGL混合模式未启用 #

Pyglet默认不会开启混合，必须手动启用才能让Alpha通道生效：

import pyglet
from pyglet.gl import *

# 在初始化或绘制前添加
glEnable(GL_BLEND)
glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)

如果跳过这一步，Shader输出的Alpha值会被忽略，雾层只会显示完全不透明或完全透明。

2. 片段着色器Alpha通道未正确输出 #

检查你的片段着色器，确保最终输出的vec4包含有效的Alpha值，而不是默认的1.0：

// 错误示例：忽略Alpha，默认输出不透明
out vec4 FragColor;
void main() {
    FragColor = vec4(0.0, 0.0, 0.0); // Alpha默认为1.0，完全不透明
}

// 正确示例：手动设置Alpha控制透明度
out vec4 FragColor;
uniform vec2 player_pos;
in vec2 tex_coord;

void main() {
    float dist = length(tex_coord - player_pos);
    // 用smoothstep生成0-1的Alpha值，控制雾的渐变
    float fog_alpha = smoothstep(0.3, 0.6, dist);
    FragColor = vec4(0.0, 0.0, 0.0, fog_alpha);
}

3. 绘制顺序错误 #

战争迷雾层必须在所有场景元素（地形、单位等）绘制完成后再渲染，否则会被不透明元素覆盖，导致透明度效果无法显现。确保你的绘制逻辑是：

def on_draw():
    glClear(GL_COLOR_BUFFER_BIT)
    # 1. 绘制场景所有元素
    scene_batch.draw()
    # 2. 绘制战争迷雾层
    fog_batch.draw()

4. 窗口未配置Alpha缓冲 #

创建Pyglet窗口时，需要明确指定Alpha通道的大小，否则窗口帧缓冲可能不支持透明度：

config = pyglet.gl.Config(double_buffer=True, alpha_size=8)
window = pyglet.window.Window(width=800, height=600, config=config)

5. 雾状态纹理格式错误 #

如果用纹理存储已探索区域的状态，必须使用带Alpha的纹理格式（如GL_RGBA），而不是GL_RGB：

# 创建带Alpha的雾纹理
fog_texture = pyglet.image.Texture.create(width=map_width, height=map_height, internalformat=GL_RGBA)

快速验证方法 #

先简化Shader逻辑，直接输出固定半透明颜色：

out vec4 FragColor;
void main() {
    FragColor = vec4(0.0, 0.0, 0.0, 0.5); // 50%透明的黑色
}

如果此时仍看不到半透明效果，说明问题出在Pyglet的GL状态或窗口配置上，而非Shader逻辑。

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