Ubuntu下如何获取gnome-terminal文本窗口区域精确左上角绝对坐标

需求背景 #

在Ubuntu系统下用C语言开发ncurses应用，实现鼠标拖拽时让字符'o'尽可能贴近鼠标位置显示，且支持在GNOME Terminal窗口外跟踪鼠标（拖拽出窗口时沿窗口边缘移动字符）。当前通过手动估算文本区域偏移量实现功能，但方案不够稳健，需要精确计算文本区域左上角的绝对坐标。

当前实现的问题 #

• 用XQueryPointer+XTranslateCoordinates获取窗口内鼠标坐标，手动指向窗口左上角像素时转换结果为(20,20)
• XGetWindowAttributes/XGetGeometry仅能获取窗口装饰的左上角坐标(0,0)，手动估算文本区域偏移为x-21、y-69，可靠性差
• 尝试用XQueryTree遍历子窗口，未找到对应文本区域的窗口

系统环境信息 #

lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 20.04.6 LTS
Release:    20.04
Codename:   focal

gnome-terminal --version
# GNOME Terminal 3.36.2 using VTE 0.60.3 +BIDI +GNUTLS +ICU +SYSTEMD

xwininfo输出 #

Absolute upper-left X:  1491
  Absolute upper-left Y:  98
  Relative upper-left X:  1491
  Relative upper-left Y:  98
  Width: 2166
  Height: 1245
  Depth: 32
  Visual: 0x74c
  Visual Class: TrueColor
  Border width: 0
  Class: InputOutput
  Colormap: 0x2400009 (not installed)
  Bit Gravity State: NorthWestGravity
  Window Gravity State: NorthWestGravity
  Backing Store State: NotUseful
  Save Under State: no
  Map State: IsViewable
  Override Redirect State: no
  Corners:  +1491+98  -183+98  -183-817  +1491-817
  -geometry 175x44+1491+98

当前代码片段 #

while (running) {
    Window ncurses_win;
    ncurses_win = XRootWindow(display, screen);
    
    XWindowAttributes attr;
    Status stat = XGetWindowAttributes(display, ncurses_win, &attr);
    fprintf(stderr, "%d %d %d %d\n", attr.x, attr.y, attr.height, attr.width);
    
    // Initialize Xlib variables for window coordinates
    int ncwin_x = 1525, ncwin_y = 127, rat_x, rat_y;
    int ncwin_xx = 3480, ncwin_yy = 1050;
    
    Window root, parent, *children;
    unsigned int nChildren;
    bool found = false;
    if (0 != XQueryTree(display, ncurses_win, &root, &parent, &children, &nChildren)) {
      for (unsigned int i = 0; i < nChildren; i++) {
        // 原代码片段不完整，推测为遍历子窗口查找文本区域
      }
    }

    // 鼠标坐标边界处理
    if (mouse_x > max_x) cursor_x = max_x-1;
    if (cursor_y > max_y) cursor_y = max_y-1;

    if (cursor_x >= 0 && cursor_x < max_x && cursor_y >= 0 && cursor_y < max_y) {
        mvaddch(cursor_y, cursor_x, 'o');
        refresh();
    }
}

解决方案思路与代码实现 #

核心思路 #

GNOME Terminal基于VTE库，文本区域的偏移可通过两种可靠方式计算：

1. 读取GTK窗口标准属性_NET_FRAME_EXTENTS，直接获取窗口装饰的边框和标题栏尺寸
2. 反向推导：将终端内字符坐标(0,0)转换为屏幕绝对坐标，得到文本区域左上角位置

实现代码 #

#include <X11/Xlib.h>
#include <X11/Xutil.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

// 获取GNOME Terminal文本区域的绝对坐标
void get_vte_text_area_absolute_coords(Display *display, Window term_win, int *out_x, int *out_y) {
    // 1. 获取终端窗口的绝对位置
    XWindowAttributes term_attr;
    if (!XGetWindowAttributes(display, term_win, &term_attr)) {
        fprintf(stderr, "Failed to get terminal window attributes\n");
        return;
    }
    int term_abs_x = term_attr.x;
    int term_abs_y = term_attr.y;

    // 2. 读取_NET_FRAME_EXTENTS属性获取窗口装饰尺寸
    Atom net_frame_extents = XInternAtom(display, "_NET_FRAME_EXTENTS", False);
    Atom actual_type;
    int actual_format;
    unsigned long nitems, bytes_after;
    unsigned char *data = NULL;

    if (XGetWindowProperty(display, term_win, net_frame_extents, 0, 4, False, XA_CARDINAL,
                          &actual_type, &actual_format, &nitems, &bytes_after, &data) == Success && data) {
        // 属性值顺序：left, right, top, bottom
        long *extents = (long *)data;
        int border_left = extents[0];
        int border_top = extents[2];

        // 文本区域绝对坐标 = 窗口绝对坐标 + 左边框 + 标题栏高度
        *out_x = term_abs_x + border_left;
        *out_y = term_abs_y + border_top;

        XFree(data);
        return;
    }

    // 3. Fallback：通过字符网格反向计算
    // 从xwininfo获取终端字符网格尺寸（示例为175x44）
    int cols = 175;
    int rows = 44;
    // 计算单个字符的像素尺寸
    int char_width = term_attr.width / cols;
    int char_height = term_attr.height / rows;

    // 将终端内(0,0)字符位置转换为绝对坐标
    int win_x = 0, win_y = 0;
    Window child_return;
    XTranslateCoordinates(display, term_win, term_win, win_x, win_y, out_x, out_y, &child_return);
    *out_x += term_abs_x;
    *out_y += term_abs_y;
}

// 根据WM_CLASS查找GNOME Terminal窗口
Window find_gnome_terminal_window(Display *display) {
    Window root = XDefaultRootWindow(display);
    Window parent, *children;
    unsigned int nchildren;
    if (!XQueryTree(display, root, &root, &parent, &children, &nchildren)) {
        return None;
    }

    Atom wm_class = XInternAtom(display, "WM_CLASS", False);
    char *target_class = "gnome-terminal-server";
    Window result = None;

    for (unsigned int i = 0; i < nchildren; i++) {
        XClassHint ch;
        if (XGetClassHint(display, children[i], &ch)) {
            if (strcmp(ch.res_class, target_class) == 0) {
                result = children[i];
                XFree(ch.res_name);
                XFree(ch.res_class);
                break;
            }
            XFree(ch.res_name);
            XFree(ch.res_class);
        }
    }

    XFree(children);
    return result;
}

int main() {
    Display *display = XOpenDisplay(NULL);
    if (!display) {
        fprintf(stderr, "Cannot open display\n");
        return 1;
    }

    Window term_win = find_gnome_terminal_window(display);
    if (term_win == None) {
        fprintf(stderr, "Could not find GNOME Terminal window\n");
        XCloseDisplay(display);
        return 1;
    }

    int text_area_x, text_area_y;
    get_vte_text_area_absolute_coords(display, term_win, &text_area_x, &text_area_y);
    printf("Text area absolute coordinates: (%d, %d)\n", text_area_x, text_area_y);

    XCloseDisplay(display);
    return 0;
}

代码说明 #

1. _NET_FRAME_EXTENTS属性：GTK窗口标准属性，存储窗口装饰的边框尺寸，直接计算文本区域偏移量
2. 反向推导方案：当无法获取装饰属性时，利用终端字符网格与客户区尺寸的对应关系，反向计算文本区域坐标
3. 窗口查找：通过WM_CLASS属性定位GNOME Terminal的主窗口，确保目标窗口正确

使用注意事项 #

• 编译时需链接Xlib：gcc -o get_term_coords get_term_coords.c -lX11
• 运行时需具备X窗口系统访问权限（默认环境下无需额外配置）
• 多标签页终端下，该方法获取的是整个窗口的文本区域坐标，各标签页坐标一致

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