Rust基于winit+wgpu创建透明窗口时Alpha混合异常如何解决

问题根因 #

• winit在Windows平台开启with_transparent(true)时，会为窗口添加WS_EX_LAYERED分层样式，但默认未正确配置分层窗口的混合模式，且未匹配DWM（桌面窗口管理器）要求的预乘Alpha输入格式，最终导致Alpha语义不匹配：出现alpha=1的纯黑色完全透明、颜色整体呈现加法混合效果的异常。
• 修复必须调用WinAPI调整窗口属性，同时匹配wgpu渲染侧的配置，二者缺一不可。

修复步骤 #

1. 配置wgpu Surface匹配预乘Alpha格式 #

Windows平台DWM仅支持预乘Alpha的交换链输入，创建Surface配置时必须指定对应参数：

// 获取surface支持的格式，优先选带Alpha通道的SRGB格式
let surface_caps = surface.get_capabilities(&adapter);
let surface_format = surface_caps.formats.iter()
    .find(|f| **f == wgpu::TextureFormat::Bgra8UnormSrgb)
    .copied()
    .unwrap_or(surface_caps.formats[0]);

let surface_config = wgpu::SurfaceConfiguration {
    usage: wgpu::TextureUsages::RENDER_ATTACHMENT,
    format: surface_format,
    width: main_window.inner_size().width,
    height: main_window.inner_size().height,
    present_mode: wgpu::PresentMode::Fifo,
    alpha_mode: wgpu::CompositeAlphaMode::PreMultiplied, // 核心：指定预乘Alpha模式
    view_formats: vec![],
};
surface.configure(&device, &surface_config);

2. 引入WinAPI依赖修正窗口属性 #

首先在Cargo.toml添加所需依赖：

[dependencies]
winit = "0.29"
wgpu = "0.18"
windows = { version = "0.51", features = [
    "Win32_Foundation",
    "Win32_Graphics_Dwm",
    "Win32_UI_WindowsAndMessaging",
] }
raw-window-handle = "0.5"

窗口创建完成后，获取窗口句柄调用Win32接口修正分层窗口配置：

use raw_window_handle::HasRawWindowHandle;
use windows::Win32::Foundation::{HWND, COLORREF};
use windows::Win32::Graphics::Dwm::*;
use windows::Win32::UI::WindowsAndMessaging::*;

// 从winit窗口提取Windows平台HWND句柄
let hwnd = match main_window.raw_window_handle() {
    raw_window_handle::RawWindowHandle::Win32(handle) => HWND(handle.hwnd as _),
    _ => panic!("当前修复方案仅适配Windows平台")
};

unsafe {
    // 禁用色键透明模式（该模式会把指定纯色抠成完全透明，是纯黑全透问题的直接原因）
    // 启用基于Alpha通道的分层混合
    SetLayeredWindowAttributes(
        hwnd,
        COLORREF(0),
        255,
        LWA_ALPHA,
    ).expect("分层窗口属性设置失败");

    // 关闭DWM非客户区渲染，避免系统默认边框混合逻辑干扰
    let render_policy = DWMNCRP_DISABLED;
    DwmSetWindowAttribute(
        hwnd,
        DWMWA_NCRENDERING_POLICY,
        &render_policy as *const _ as *const _,
        std::mem::size_of_val(&render_policy) as u32,
    ).ok();
}

3. 渲染管线匹配预乘Alpha混合规则 #

渲染管线的颜色混合状态必须匹配预乘Alpha逻辑，否则会出现颜色过亮的加法混合效果，管线的target混合配置参考如下：

blend: Some(wgpu::BlendState {
    color: wgpu::BlendComponent {
        src_factor: wgpu::BlendFactor::One, // 预乘Alpha下源颜色因子固定为1
        dst_factor: wgpu::BlendFactor::InverseSrcAlpha,
        operation: wgpu::BlendOperation::Add,
    },
    alpha: wgpu::BlendComponent {
        src_factor: wgpu::BlendFactor::One,
        dst_factor: wgpu::BlendFactor::InverseSrcAlpha,
        operation: wgpu::BlendOperation::Add,
    }
}),

渲染输出颜色时注意：所有半透明颜色的RGB值需要提前乘以Alpha通道值再写入，完全不透明（alpha=1.0）的颜色可直接使用原数值。配置正确后，alpha=1.0的纯色会正常完全不透明，alpha<1.0的颜色会按标准Alpha混合规则和桌面背景合成。

额外适配提示（桌面挂件场景） #

• 无交互需求的挂件可添加WS_EX_TRANSPARENT窗口样式实现点击穿透，需要交互则不要添加该样式
• 要实现类似Rainmeter的桌面固定效果，可通过WinAPI将窗口层级设置在桌面图标窗口之后、壁纸层之上
• 避免使用with_always_on_top，该属性会让窗口盖在所有全屏应用之上，不符合挂件使用预期

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