重父化窗口管理器下32位深窗口帧合成器不绘制阴影问题

问题成因 #

这个是X11生态下合成器的通用默认逻辑导致的，核心原因有3个：

• 32位深窗口默认携带ARGB alpha通道，绝大多数合成器（picom、Mutter、KWin等）的默认规则都会跳过为ARGB32窗口自动绘制阴影。这类窗口通常是带自定义透明效果、圆角的应用，合成器默认认为应用自身会处理边缘视觉效果，自动加阴影反而会导致透明区域透出阴影、显示异常。而24位深窗口没有alpha通道，不会触发这个排除规则，因此可以正常显示阴影。
• 你的代码中创建32位帧窗口时，传入的background_pixel大概率只携带了24位RGB分量，没有将最高8位的alpha值设为0xFF（完全不透明）。合成器检测到窗口背景alpha通道值不为不透明时，会判定窗口为半透明/全透明窗口，进一步触发跳过阴影绘制的逻辑。
• 你当前没有给创建的帧窗口设置标准的WM hint标记合成器绘制阴影：多数合成器支持_NET_WM_WINDOW_TYPE_NORMAL窗口类型标记，或者_KDE_NET_WM_SHADOW、_COMPIZ_SHADOW_MODE这类扩展属性，显式告诉合成器需要为当前窗口绘制阴影，缺失这些标记时32位窗口会默认走无阴影逻辑。

快速验证方案 #

你可以临时修改合成器配置关闭ARGB窗口阴影排除规则，比如picom的配置中删除shadow-exclude规则里匹配argb的条目，重启合成器后如果32位帧窗口出现阴影，就可以确认是上述规则导致的。

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