You need to enable JavaScript to run this app. Linux下如何用Rust X11库获取鼠标相对终端窗口的坐标
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 08:15:03