Linux下如何用Rust X11库获取鼠标相对终端窗口的坐标
现有代码的问题根源
当前代码获取的全屏幕坐标,本质是查询目标选错了:XQueryPointer返回的相对坐标,永远是相对于传入的查询目标窗口计算的,当传入的目标是整个屏幕的根窗口时,返回的相对坐标和全局坐标完全相等,所以之前的root_x_return和win_x_return数值一致是必然结果,不属于逻辑bug。
具体调整步骤
- 获取当前终端对应的真实X11窗口ID
所有主流终端模拟器都会给运行在内部的子进程注入WINDOWID环境变量,这个值就是终端客户区对应的X窗口编号,不需要手动遍历窗口查找,直接读取即可:// 可在安全上下文读取,不需要放在unsafe块中 let window_id_str = std::env::var("WINDOWID").expect("未在终端环境中运行,无法获取终端窗口ID"); let terminal_window = window_id_str.parse::<xlib::Window>().expect("终端窗口ID格式非法"); - 替换
XQueryPointer的查询目标
把原本传入的根窗口参数,换成上面拿到的终端窗口ID,不再对整个屏幕的根窗口发起查询。 - 校验返回值的有效性
XQueryPointer会返回布尔值,当鼠标不在目标终端窗口范围内时,返回值为False,此时拿到的相对坐标无意义,需要做分支判断。
修正后的完整代码
use std::ptr; use x11::xlib; fn main() { // 提前读取终端窗口标识 let window_id_str = std::env::var("WINDOWID") .expect("请在终端环境中运行程序,当前未获取到终端窗口标识"); let terminal_window: xlib::Window = window_id_str.parse() .expect("终端窗口ID格式非法"); unsafe { let display = xlib::XOpenDisplay(ptr::null()); if display.is_null() { panic!("无法连接X11显示服务"); } let mut root_return = 0; let mut child_return = 0; let mut root_x_return = 0; let mut root_y_return = 0; let mut win_x_return = 0; let mut win_y_return = 0; let mut mask_return = 0; // 将查询目标从根窗口替换为终端窗口 let pointer_in_window = xlib::XQueryPointer( display, terminal_window, &mut root_return, &mut child_return, &mut root_x_return, &mut root_y_return, &mut win_x_return, &mut win_y_return, &mut mask_return, ); if pointer_in_window == xlib::True { // 此时win_x_return、win_y_return就是鼠标相对于终端窗口左上角的坐标 // 坐标原点对应终端第一个字符单元格的起始像素位置,完全匹配需求 dbg!(win_x_return, win_y_return); } else { println!("鼠标当前不在终端窗口范围内"); } xlib::XCloseDisplay(display); } }
注意事项
- 这套方案仅在原生X11会话、XWayland兼容模式下可正常工作;原生Wayland会话下受沙箱安全限制,X11接口无法获取窗口位置和鼠标相对坐标,需要对接Wayland专属协议实现。
- 主流终端模拟器开启客户端装饰(CSD)时,
WINDOWID对应的窗口范围始终是终端字符渲染的客户区,不包含标题栏、外边框的装饰部分,计算出的坐标原点和需求完全一致,不需要额外做偏移修正。
内容的提问来源于stack exchange,提问作者user15415674
相关产品推荐
相关产品推荐

