linux xrender如何调试

在 Linux 下调试 X Render（X11 Render Extension，Xrender），通常目标是：

• 确认 Xrender 是否启用
• 跟踪 Xrender 请求/错误
• 分析渲染结果是否正确
• 定位性能或显示异常问题

下面按常用调试手段和典型场景来说明。

一、确认 Xrender 是否可用

1. 检查 X11 扩展是否启用

xdpyinfo | grep RENDER

输出类似：

RENDER

说明 Xrender 扩展已加载。

2. 查看 Xserver 是否支持

X -version

或

grep -i render /var/log/Xorg.0.log

二、使用 X11 调试工具

1. xtrace（强烈推荐）

用于跟踪 X11 协议请求，包括 Xrender。

sudo apt install xtrace
xtrace your_x11_app

可以看到类似：

RenderComposite src=0x4a00001 ...

✅ 适合调试：

• Render 请求是否发出
• 参数是否正确
• 是否缺少 PictFormat / Picture

2. xscope

比 xtrace 更底层，适合协议级调试。

sudo apt install xscope
xscope -v

然后让程序连接 DISPLAY=:1 等。

三、X Render 常见调试点

1. Picture / PictFormat 是否正确

Xrender 的核心是 Picture。

常见错误：

• 使用了不存在的 PictFormat
• Picture 未创建就 Composite
• Drawable 与 Picture 不匹配

调试方法：

• 打印 XRenderFindVisualFormat 返回值
• 检查 XRenderCreatePicture 是否成功

示例：

XRenderPictFormat *fmt = XRenderFindVisualFormat(dpy, vis);
if (!fmt) {
    fprintf(stderr, "No pict format\n");
}

2. 检查 Composite 参数

XRenderComposite(
    dpy,
    PictOpOver,
    src,
    mask,
    dst,
    src_x, src_y,
    mask_x, mask_y,
    dst_x, dst_y,
    width, height
);

常见错误：

• mask = None 但用了 PictOpSrc
• src / dst Picture 不匹配
• 坐标越界

✅ 调试建议：

• 先画纯色矩形
• 再逐步加 mask / transform

四、使用环境变量调试

1. LIBGL / X11 调试

export LIBGL_DEBUG=verbose
export MESA_DEBUG=1

（对 Xrender 本身帮助有限，但可排除 GL 干扰）

2. Xlib 同步调试

XSynchronize(dpy, True);

✅ 好处：

• 错误立即返回
• 容易定位是哪一行代码出错

五、错误定位技巧

1. 捕获 X11 错误

int xerror_handler(Display *dpy, XErrorEvent *err) {
    char msg[256];
    XGetErrorText(dpy, err->error_code, msg, sizeof(msg));
    fprintf(stderr, "X Error: %s\n", msg);
    return 0;
}

XSetErrorHandler(xerror_handler);

Xrender 常见错误：

• BadPicture
• BadMatch
• BadDrawable

六、图形结果不对？这样排查

1. 先画纯色

XRenderFillRectangle(dpy, PictOpSrc, picture, &color, 0, 0, w, h);

2. 再测试 Composite

• 不用 mask
• 不用 transform
• 不用 repeat

七、性能调试（进阶）

1. 是否走软件渲染

export XRENDER_SYNC=1

2. 检查是否使用 Composite 扩展

xdpyinfo | grep Composite

八、推荐调试组合（实战）

✅ 最常用组合

xtrace your_app
XSynchronize(dpy, True)
XSetErrorHandler

✅ 图形异常

• 打印 Picture / PictFormat
• 缩小到最小可复现用例

九、如果你愿意，我可以进一步帮你

你可以告诉我：

1. 用的是 Xlib / XCB / GTK / Qt / 自己写的 Xrender 程序
2. 具体现象（黑屏 / 花屏 / 不显示 / 性能差）
3. 是否使用 mask / transform / gradients

我可以直接帮你 定位代码级问题。