Skia+GLFW全屏窗口canvas.clear透明时填充黑色问题

开发者阿泽

2026-8-30

问题描述

基于skia-python搭配GLFW开发无装饰、置顶透明悬浮层，用于绘制自定义图形与文本，基础功能在非全屏窗口下运行正常。
核心异常：窗口尺寸小于屏幕原生分辨率1920×1080时，调用canvas.clear(skia.ColorTRANSPARENT)可正常得到透明画布；当窗口尺寸设为1920×1080铺满全屏时，该清空调用会将整个画布填充为纯黑色，但后续文本、图形的交替绘制逻辑仍可正常运行。
测试环境：Windows 10操作系统、Python 3.10，依赖版本为glfw 2.5.3、PyOpenGL 3.1.6、skia-python 87.4。
复现代码如下：

import contextlib, glfw, skia
from OpenGL import GL
import time

WIDTH, HEIGHT = 1920, 1080
#WIDTH, HEIGHT = 1919, 1079

@contextlib.contextmanager
def glfw_window():
    if not glfw.init():
        raise RuntimeError('glfw.init() failed')
    glfw.window_hint(glfw.STENCIL_BITS, 8)
    glfw.window_hint(glfw.SAMPLES, 14)
    glfw.window_hint(glfw.DECORATED, 0)
    glfw.window_hint(glfw.TRANSPARENT_FRAMEBUFFER, 1)
    glfw.window_hint(glfw.FLOATING, 1)

    window = glfw.create_window(WIDTH, HEIGHT, '', None, None)
    glfw.make_context_current(window)
    yield window
    glfw.terminate()

@contextlib.contextmanager
def skia_surface(window):
    context = skia.GrDirectContext.MakeGL()
    (fb_width, fb_height) = glfw.get_framebuffer_size(window)
    backend_render_target = skia.GrBackendRenderTarget(
        fb_width,
        fb_height,
        0,  # sampleCnt
        0,  # stencilBits
        skia.GrGLFramebufferInfo(0, GL.GL_RGBA8))
    surface = skia.Surface.MakeFromBackendRenderTarget(
        context, backend_render_target, skia.kBottomLeft_GrSurfaceOrigin,
        skia.kRGBA_8888_ColorType, skia.ColorSpace.MakeSRGB())
    assert surface is not None
    yield surface
    context.abandonContext()

def drawString(canvas):
    paint = skia.Paint(AntiAlias=True, Color=skia.ColorRED)
    font = skia.Font(skia.Typeface('meiryo'), 36)
    canvas.drawString('あかさたな', 100, 100, font, paint)

def drawCircle(canvas):
    paint = skia.Paint(Color=skia.ColorGREEN)
    canvas.drawCircle(100, 100, 40, paint)

with glfw_window() as window:
    GL.glClear(GL.GL_COLOR_BUFFER_BIT)

    with skia_surface(window) as surface:
        with surface as canvas:
            while (glfw.get_key(window, glfw.KEY_ESCAPE) != glfw.PRESS
                   and not glfw.window_should_close(window)):
                canvas.clear(skia.ColorTRANSPARENT)
                if int(time.time()) % 2 == 0:
                    drawString(canvas)
                else:
                    drawCircle(canvas)
                surface.flushAndSubmit()
                glfw.swap_buffers(window)
                glfw.poll_events()

根本原因

这个异常和skia、GLFW本身的逻辑缺陷无关，完全是Windows桌面窗口管理器（DWM）的默认机制触发的：

Windows 10之后引入了全屏优化（FSO）机制，原本用于提升全屏游戏的渲染性能：当窗口无装饰边框、尺寸完全匹配屏幕分辨率铺满整个屏幕时，系统会自动判定窗口进入全屏优化状态，直接跳过常规的分层窗口alpha合成流程，把帧缓冲内容直接输出到显示设备，帧缓冲携带的alpha透明通道会被直接丢弃。
调用canvas.clear(skia.ColorTRANSPARENT)得到的像素值是RGBA(0,0,0,0)，正常合成模式下alpha=0会和桌面背景混合得到透明效果；但在全屏优化模式下alpha通道被丢弃，直接显示RGB通道的(0,0,0)也就是纯黑色，就出现了黑底现象。
当窗口尺寸哪怕比全屏小1像素（比如1919×1079），DWM就不会触发全屏优化判定，始终走分层合成路径，alpha通道正常生效，透明清空逻辑就完全正常。
另外代码里存在一个潜在隐患：创建GLFW窗口时设置了STENCIL_BITS=8、SAMPLES=14的缓冲区参数，但初始化skia后端渲染目标时硬编码把sampleCnt、stencilBits都写为0，参数不匹配在非全屏模式下会被DWM容错处理，全屏模式下可能加剧帧缓冲显示异常。

可选解决方案

如果业务场景不需要严格的像素级全屏，直接保留1~2像素的屏幕边距即可（比如当前测试可用的1919×1079分辨率），实现成本为0，稳定性最高。
如果必须铺满整个屏幕同时保留透明效果，可以在窗口创建后调用Windows DWM API，显式禁用该窗口的全屏优化权限，强制DWM始终走分层合成路径。
修正skia后端渲染目标的参数传递逻辑，不要硬编码采样数、模板位为0，实际读取GLFW帧缓冲对应的参数传入，避免格式不匹配问题。

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