niri 项目中 GTK 层叠窗口输入穿透问题解析

在 niri 窗口管理器的使用过程中，开发者可能会遇到一个与 GTK 层叠窗口（GTK Layer Shell）相关的输入穿透问题。本文将深入分析这一问题的技术背景、解决方案以及相关实现原理。

问题现象

当使用 GTK Layer Shell 创建 OVERLAY 层级的透明窗口时，期望实现鼠标点击穿透效果，即点击透明区域能够聚焦到底层窗口。部分用户报告在某些情况下这一功能失效，而同样的代码在 wlroots 基础的合成器（如 Sway 和 River）中表现正常。

技术背景

GTK Layer Shell 是基于 Wayland 的 wlr-layer-shell 协议的 GTK 封装，允许应用创建不同层级的窗口。OVERLAY 层级的窗口通常用于显示悬浮面板或通知等内容。

要实现点击穿透效果，需要正确设置窗口的输入区域（input region）。Wayland 协议规定，只有当输入区域包含点击坐标时，窗口才会接收输入事件。通过设置空输入区域，可以实现完全的点击穿透。

解决方案

在 GTK3 中，可以通过以下代码实现点击穿透：

# 创建空区域
null_region = cairo.Region(cairo.RectangleInt(0, 0, 0, 0))
# 应用到窗口
win.input_shape_combine_region(null_region)

同时需要正确初始化层叠窗口：

GtkLayerShell.init_for_window(win)
GtkLayerShell.set_layer(win, GtkLayerShell.Layer.OVERLAY)

实现原理

在 niri 的底层实现中，窗口管理逻辑会通过 surface_under 方法检查点击位置下的有效表面。该方法会自动考虑输入区域的设置，确保只有实际可交互的区域才会拦截输入事件。

值得注意的是，输入穿透的实现依赖于合成器的正确处理。niri 在最新版本中已经完善了这一功能，但用户可能需要确保：

1. 使用最新版本的 niri
2. 在更新后完全重启窗口管理器
3. 检查是否有其他应用或设置影响了输入事件的处理

最佳实践

对于开发者而言，在实现透明覆盖层时应注意：

1. 明确设置窗口为可绘制透明背景 (set_app_paintable(True))
2. 正确初始化 GTK Layer Shell 并设置适当的层级
3. 确保输入区域设置正确
4. 在不同合成器上进行兼容性测试

通过遵循这些实践，可以确保透明覆盖层在各种 Wayland 合成器上都能实现预期的点击穿透效果。