使用cv2.blur实现Pygame Bloom效果时粒子出现黑边的解决求助

问题根源 #

你遇到的黑色阴影是未对RGBA做预乘处理直接模糊的典型问题：

• 代码中直接将RGBA四个通道一起传入cv2.blur做模糊，画布透明区域的RGB默认值为纯黑(0,0,0)，模糊时透明区域的黑色会和发光区域的颜色混合，alpha通道模糊后产生的半透明区域就会透出混合生成的黑色，因此白色背景下黑边格外明显，灰色背景下视觉上更隐蔽。
• Pygame的SRCALPHA表面默认存储非预乘格式的RGBA值，直接对四个通道做模糊必然会出现颜色混合错误。

修正代码 #

你只需要在模糊前增加预乘alpha的步骤即可解决大部分黑边问题：

def Bloom(canvas: pygame.Surface):
    size = canvas.get_size()
    canvas_color = pygame.surfarray.array2d(canvas)
    # 新增copy操作避免修改原画布数据
    canvas_rgba = canvas_color.view(dtype=np.uint8).reshape((*canvas_color.shape, 4)).copy()

    # 新增预乘alpha处理
    alpha = canvas_rgba[..., 3:4].astype(np.float32) / 255.0
    canvas_rgba[..., :3] = (canvas_rgba[..., :3].astype(np.float32) * alpha).astype(np.uint8)

    newCanvas = pygame.Surface(size, pygame.SRCALPHA)

    cv2.blur(canvas_rgba, ksize=(9, 9), dst=canvas_rgba)

    pygame.surfarray.blit_array(newCanvas, canvas_color)

    return newCanvas

可选优化方案 #

如果修改后仍有轻微残留黑边，可以做以下调整：

• 适当缩小模糊核尺寸，比如改为(7,7)，减少模糊时和透明区域的混合范围
• 模糊后对alpha通道做截断，将值低于10的alpha直接设为0，避免极透明区域的杂色透出
• 拆分模糊逻辑：单独提取画面中发光的部分生成图层做模糊，再和原画布混合，无需对整个画布做透明模糊

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