深入Better Blur DX架构设计:KWin模糊效果6大核心组件全解析
深入Better Blur DX架构设计:KWin模糊效果6大核心组件全解析
Better Blur DX 是一款面向 Plasma 6 的 KWin 模糊效果插件,在官方模糊效果基础上提供强制模糊(Force Blur)、折射(Refraction)、可调节圆角等增强功能。本文将带你快速拆解它的架构设计:从 BlurEffect 渲染管线到 BlurCache 性能缓存,6 大核心组件各司其职,一文全解析。
📁 项目结构总览
先看一眼源码布局,整个效果代码集中在 src/ 目录,职责划分非常清晰:
src/
├── blur.h / blur.cpp # 效果主体:渲染管线(Dual Kawase)
├── window.h / window.cpp # 单窗口状态跟踪
├── window_manager.hpp/.cpp # 窗口管理:白名单/黑名单匹配
├── blur_cache.hpp/.cpp # 模糊缓存:降低 GPU 负载
├── refraction_pass.hpp/.cpp # 折射通道
├── rounded_corners_pass.hpp/.cpp # 圆角通道
├── settings.hpp # BlitMode 等枚举
├── kwin_compat.hpp # KWin 多版本兼容层
├── blur.kcfg # KConfig 配置定义
├── shaders/ # GLSL 着色器(downsample/noise/refraction...)
└── kcm/ # 系统设置配置模块(KCM)
构建入口在 src/CMakeLists.txt,最终产物是一个 KWin 效果插件动态库;插件注册工厂在 src/main.cpp。
组件一:BlurEffect —— 效果主体与 Dual Kawase 渲染管线
BlurEffect 是整个插件的心脏,继承自 KWin::Effect,负责响应 KWin 的绘制回调(prePaintScreen、drawWindow 等)。类定义见 src/blur.h,它声明了 4 组内置着色器通道:
| 通道 | 作用 | 着色器 |
|---|---|---|
m_downsamplePass |
纹理每轮缩小 50%(降采样) | downsample.frag |
m_upsamplePass |
纹理每轮放大 200%(升采样) | upsample.frag |
m_noisePass |
叠加噪声,掩盖平滑渐变中的色带 | noise.frag |
m_onscreenPass |
最终合成到屏幕 | onscreen.frag |
核心的 blur() 函数(约 500 行,见 src/blur.cpp)实现了 Dual Kawase 模糊算法,流程可以概括为一条单向管线:
- 计算有效模糊区域:根据窗口缩放/位移换算出实际的
effectiveShape - 分配离屏 FBO:
m_iterationCount + 1个逐级减半的纹理链 - 降采样:
for i in 1..N,每轮把上一级纹理缩小一半(见 blur.cpp#L1178-L1206) - 升采样:反向遍历,逐级放大回来
- 屏幕合成:应用亮度/对比度/饱和度颜色矩阵
- 可选噪声 & 圆角:最后交给 BlurCache 回写
💡 Dual Kawase 相比高斯模糊的优势:只需 O(log N) 次半分辨率采样就能达到很大模糊半径,GPU 开销极低——这正是它能在 60fps 下平滑运行的原因。
BlurEffect 还通过 provides(Feature::Blur) 向 KWin 声明"我就是模糊效果"(见 blur.h#L260-L266),从而替换 KWin 自带模糊,这也是使用文档中要求先禁用其他模糊效果的原因。
组件二:WindowManager 与 Window —— 窗口跟踪和强制模糊匹配
"强制模糊"是 Better Blur DX 的招牌功能:让不支持模糊的普通窗口也获得毛玻璃背景。这一能力由 WindowManager + Window 两个类承担。
WindowManager(src/window_manager.hpp)是全局的"窗口台账":
- 持有
std::unordered_map<const EffectWindow*, unique_ptr<Window>>,每个 KWin 窗口都有一个 BBDX 侧的影子对象 - 解析用户配置的窗口类列表,支持固定字符串与正则表达式两种匹配(window_manager.hpp#L51-L54)
- 通过
WindowClassMatchMode枚举切换白名单 / 黑名单模式 - 响应窗口增删、最大化状态刷新、缓存失效等信号
Window(src/window.hpp)则是单个窗口的状态机,最有意思的是 BlurOrigin 位掩码(window.hpp#L43-L48):
enum class BlurOrigin : unsigned int {
RequestedContent = 1 << 0, // 窗口自己请求的内容区模糊
RequestedFrame = 1 << 1, // 窗口请求的边框区模糊
ForcedContent = 1 << 2, // 被 BBDX 强制模糊的内容区
ForcedFrame = 1 << 3, // 被 BBDX 强制模糊的边框区
};
4 个来源可以任意叠加,Window::getFinalBlurRegion() 会合并出最终模糊区域。此外 Window 还跟踪最大化状态、是否正在动画变换(TransformState)、透明度历史等,用来解决"动画中模糊闪烁""Wobbly Windows 兼容"等疑难杂症——这些设计决策在 CHANGELOG.md 中有完整记录。
组件三:BlurCache —— 为模糊效果降 GPU 负载的缓存
模糊效果最大的性能问题是:窗口背后哪怕只有一个像素变化,整个模糊区域都要重新计算。BlurCache(src/blur_cache.hpp)就是解决方案。
核心数据结构是 BlurCacheEntry:一个"缓存好的模糊背景"纹理 + 帧缓冲,外加记录哪些区域脏了的 m_accumulatedDirtyRegion(blur_cache.hpp#L74-L94)。
它的工作策略很务实(参考 2.5.0 重构结论):
- 不再做纹理比对——比较本身就要花钱,不如直接限频重算
- 速率限制:由
m_cacheRateLimit(默认 33ms ≈ 30fps)控制,动画期间则持续刷新直到动画结束(m_flushingUntil) - 细粒度失效:
FULL标志整体作废缓存,REGION标志只冲刷脏区域 - 两种 Blit 模式(settings.hpp#L14-L23):
RENDER_TARGET缓存整个屏幕区域,WALLPAPER只缓存壁纸——壁纸模式允许更激进的缓存,因为桌面背景很少变
在渲染管线中,BlurEffect::blur() 会先调用 preparePaintData() 准备缓存;如果当前帧还在限频窗口内(没有脏区域),直接 drawCached() 回画缓存纹理就提前返回(见 blur.cpp#L1171-L1176),完全跳过 Dual Kawase 计算。
组件四:RefractionPass —— 给模糊加折射光效
RefractionPass(src/refraction_pass.hpp)是 Better Blur DX 区别于原生模糊的招牌特性之一:在模糊区域边缘模拟玻璃质感的光线折射,并带 RGB 色散边缘(fringing)。
它把原本负责"对比度调色"的 onscreen 通道替换掉(二选一),可配置参数非常丰富:
RefractionStrength:折射强度RefractionEdgeSize:折射影响边缘宽度(像素)RefractionNormalPow:法线计算指数RefractionRGBFringing:RGB 色散强度RefractionMode/RefractionTextureRepeatMode:折射模式与纹理重复方式
实现基于修改版的玻璃折射着色器,加载逻辑在 src/refraction_pass.cpp,参数默认值定义在 src/blur.kcfg。只有当 RefractionStrength > 0 时该通道才启用,不启用时零开销。
组件五:RoundedCornersPass —— 圆角通道,消灭"korners"泄漏
如果你用过 KWin 模糊,可能见过著名的 "korners" bug:方形模糊区域从圆角窗口的背后"漏"出一截直角。RoundedCornersPass(src/rounded_corners_pass.hpp)就是为此而生的后处理通道。
它的工作方式很巧妙:在整条模糊管线最末尾执行,用 framebuffers[0] 中保存的未模糊原始像素作为遮罩模板,给最终模糊结果"抠"出圆角轮廓。这样矩形噪声纹理就不会泄漏到窗口外面。
半径取值逻辑由 WindowManager::getEffectiveBorderRadius() 统一裁决(window_manager.hpp#L148-L149):窗口自带圆角则尊重窗口值,否则用用户配置的 CornerRadius,全屏/最大化时半径强制归零。相关参数见 docs/configuration.md 中的 "Corner Radius" 一节。
组件六:KCM 配置模块与 KConfig —— 参数从哪来
所有用户可调参数由 KConfig 体系管理:
- 配置定义:src/blur.kcfg 用 XML 声明了约 20 个配置项,分四个区块——General(模糊强度/噪声/亮度/饱和度/对比度/圆角)、Force Blur(窗口类列表/菜单/Dock)、Refraction、Performance(BlitMode/缓存开关/限频)
- 代码生成:
blurconfig.kcfgc声明让 KConfig 工具自动生成BlurConfig骨架类,效果与配置模块共用 - 配置界面:src/kcm/ 下的 KCM(KDE Control Module)提供系统设置里的 "Better Blur DX" 页面。
BlurEffectConfig继承KCModule(src/kcm/blur_config.h),支持滑条与数字框双向同步、折射模式切换等交互逻辑
效果侧在 reconfigure() 钩子中读取配置,并把参数分发给 WindowManager、BlurCache、RefractionPass 等各个子组件——配置变更 → 各组件热更新,无需重启 KWin。
🎁 隐藏主角:kwin_compat 多版本兼容层
Better Blur DX 需要同时兼容 Plasma 6.5 / 6.6 / 6.7(见 README.md "Supported Plasma releases" 一节),但 KWin 每个版本 API 都有变动(Region → RegionF、模糊管理器引入等)。
src/kwin_compat.hpp 是这个项目的"瑞士军刀":它先读入 kwin_version.hpp 判定的编译期版本,再按条件自动包含 kwin_compat_6_5.hpp / kwin_compat_6_6.hpp / kwin_compat_x11.hpp。效果代码里用 #if KWIN_VERSION < KWIN_VERSION_CODE(6, 6, 4) 之类的分支处理差异(blur.h#L101-L113 中 prePaintWindow 的三重签名就是典型例子)。
这一层让"一份源码,三个 Plasma 版本 + X11"的构建目标成为可能,X11 版本通过 -DBBDX_X11=ON 显式开启(见 CMakeLists.txt#L19-L32)。
总结:一张图理解 Better Blur DX 架构
KWin 绘制回调
│
▼
┌─────────────────────────────────────────────┐
│ BlurEffect (效果主体) │
│ ┌──────────────┐ ┌────────────────────┐ │
│ │ WindowManager │ │ BlurCache │ │
│ │ + Window×N │ │ 限频重算/脏区冲刷 │ │
│ │ 模糊来源裁决 │ │ RENDER_TARGET/壁纸 │ │
│ └──────────────┘ └────────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ Dual Kawase 管线: downsample ⇄ upsample │
│ → onscreen / RefractionPass (二选一) │
│ → noise → RoundedCornersPass → 回写缓存 │
└─────────────────────────────────────────────┘
▲ 配置注入
│
blur.kcfg ──> KCM 设置界面 (src/kcm/)
- 渲染归 BlurEffect:算法管线单向清晰,Dual Kawase 保证性能上限
- 决策归 WindowManager:模糊区域"从哪来、该不该强制"与渲染彻底解耦
- 性能归 BlurCache:限频 + 脏区域冲刷,把 GPU 开销压到可接受范围
- 风格归 Refraction / RoundedCorners 两个可选通道:按需启用,互不干扰
- 参数归 KConfig + KCM:声明式定义、代码生成、热更新
如果你想亲手验证这些行为,可以按 docs/debugging.md 的方法开启 kwin_effect_better_blur_dx.*.debug 日志,观察窗口添加、模糊区域变化和缓存失效的完整过程。