How xarblu/kwin-effects-better-blur-dx works
Better Blur DX is a KWin/Plasma 6 compositor effect that applies configurable blur behind windows, with force-blur rules, rounded corners, and optional refraction. The main runtime flow is KWin loading the effect, which manages window state and renders blur using cached background data and shader passes; users configure it through the KDE settings module. Edges are limited to relationships shown in excerpts, the source index, or README. Some rendering details and documented bug fixes are not represented as separate stages because their implementations were not sampled.
Main entry points: blur.cpp Blur Effect · window_manager.cpp Window Manager · blur_cache.cpp Blur Cache · rounded_corners_pass.cpp Rounded Corners Pass
Components 15
KWin Integration
- KWin Compositor
- Effect Entry
src/main.cpp - Blur Effect
src/blur.cpp
Configuration
- Settings Module
src/kcm/blur_config.cpp - Blur Settings
src/settings.hpp
Window Policy
- Window Manager
src/window_manager.cpp - Window State
src/window.cpp
Blur Rendering
- Blur Cache
src/blur_cache.cpp - Cache Entry
src/blur_cache.cpp - Refraction Pass
src/refraction_pass.cpp - Rounded Corners Pass
src/rounded_corners_pass.cpp - Shader Assets
src/shaders - Render Utilities
src/utils.cpp
Compatibility
- KWin Compatibility
src/kwin_compat.hpp
Other components
- Desktop User
Connections 24
- Desktop User → Settings Module: configures
README.md - Settings Module → Blur Settings: sets options
src/kcm/blur_config.cpp - KWin Compositor → Effect Entry: loads effect
src/main.cpp - Effect Entry → Blur Effect: creates
src/main.cpp - KWin Compositor → Blur Effect: renders windows
README.md - Blur Effect → Window Manager: manages windows
- Window Manager → Window State: tracks windows
src/window_manager.cpp - Window Manager → Blur Settings: reads options
src/window_manager.cpp - Blur Effect → Blur Settings: configures passes
README.md - Blur Effect → Blur Cache: prepares cache
src/blur.cpp - Blur Effect → Window Manager: queries policy
src/blur.cpp - Blur Effect → Refraction Pass: applies refraction
src/blur.cpp - Blur Effect → Rounded Corners Pass: draws corners
src/blur.cpp - Blur Effect → Render Utilities: uses helpers
src/blur.cpp - Blur Cache → Cache Entry: creates and updates
src/blur_cache.cpp - Blur Cache → Rounded Corners Pass: delegates drawing
src/blur_cache.cpp - Blur Cache → Window Manager: flushes caches
src/blur_cache.cpp - Refraction Pass → Render Utilities: uses helpers
src/refraction_pass.cpp - Rounded Corners Pass → Render Utilities: uses helpers
src/rounded_corners_pass.cpp - Blur Effect → Shader Assets: loads shaders
- Refraction Pass → Shader Assets: uses shader assets
- Rounded Corners Pass → Shader Assets: uses shader assets
- Blur Effect → KWin Compatibility: uses compatibility layer
src/blur.cpp - Window State → KWin Compatibility: uses compatibility layer
src/window.cpp