X11重排窗口管理器（Reparenting WM）中的透明度实现问题

嘿，我折腾过X11窗口管理器的透明度逻辑，对你遇到的这个问题感同身受，咱们一步步拆解来看：

一、重排后黑背景的可能原因及解决方向 #

你提到的黑背景大概率和合成器对窗口层级/透明度属性的识别逻辑有关，毕竟重排窗口管理器是把客户端窗口嵌入框架窗口，合成器的处理逻辑会和普通窗口有差异：

• 框架窗口背景未正确透明化：X11窗口默认背景是黑色，哪怕你以为设置了框架背景，合成器可能没正确识别。试试用XSetWindowBackgroundPixmap(dpy, frame_win, None)把框架窗口的背景设为完全透明，或者如果你的X服务器支持ARGB视觉，用XSetWindowBackgroundPixel设置带alpha通道的透明值。
• 透明度属性未同步到框架窗口：很多合成器（比如picom）只会读取顶层窗口（也就是你的框架窗口）的_NET_WM_OPACITY属性，而不会遍历子窗口。所以当客户端窗口设置了透明度时，你需要把这个属性值同步到它的框架窗口上——收到客户端的_NET_WM_OPACITY变更后，调用XChangeProperty把相同的值写到框架窗口的对应属性里。
• 窗口嵌入位置偏移：检查_NET_FRAME_EXTENTS的计算是否准确，确保客户端窗口在框架内的位置是(0,0)，没有偏移导致框架的黑背景从边缘露出来。

二、为什么收不到_NET_WM_OPACITY的PropertyNotify事件？ #

你在根窗口上选了SubstructureRedirect|SubstructureNotify|PropertyChange事件，但这只能捕获根窗口本身的属性变化，以及子结构的创建/销毁通知，客户端窗口的属性变更事件不会自动发送到根窗口。正确的做法是：

• 当你收到MapRequest事件、准备管理这个客户端窗口时，给它单独调用XSelectInput(dpy, client_win, PropertyChangeMask | 你需要的其他掩码)，这样客户端窗口的任何属性变化（包括_NET_WM_OPACITY）都会发送到你的管理器进程。
• AwesomeWM的逻辑也是如此：它会为每个托管的客户端窗口注册属性变更监听，而不是只盯着根窗口。你可以在处理PropertyNotify事件时，判断atom是否为_NET_WM_OPACITY，再执行后续的同步或处理逻辑。

额外排查小技巧 #

如果还是有问题，试试打开合成器的 verbose 模式（比如picom加--verbose参数），查看日志里有没有关于框架窗口/客户端窗口透明度识别的报错或提示，这能帮你快速定位合成器是否正确读取了属性。

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