怎样调试linux xrender

调试 Linux 下的 XRender（X 渲染扩展）通常分为几个层面：确认是否启用、查看错误、使用工具、抓包分析、代码级调试。下面按实用顺序给你一套方法。

一、确认 XRender 是否可用

1. 检查 X 扩展

xdpyinfo | grep -i render

应看到：

XRender

如果没有，说明 X Server 没启用 XRender。

2. 查看扩展版本

xrenderinfo

（部分发行版需要安装 x11-utils 或 xorg-x11-utils）

二、常见调试工具

1. X 客户端错误查看

XRender 错误通常来自 BadPicture / BadPictFormat / BadDrawable。

export LIBXCB_TRACE=1

或

export XLIB_TRACE=1

运行程序，观察 X 请求错误。

2. 使用 xtrace / xscope

抓 X11 协议层：

xtrace your_app

或：

xscope &
your_app --display :1

可以看到：

• RenderCreatePicture
• RenderComposite
• Picture 格式不匹配

3. X 错误处理器

在 Xlib 程序中设置：

XSetErrorHandler(my_error_handler);

XCB 中：

xcb_set_error_handler(conn, err_handler, NULL);

三、XRender 常见问题排查

1. PictFormat 不匹配

最常见错误：

BadPictFormat

检查：

xcb_render_query_pict_formats_reply_t

确认：

• depth
• red/green/blue/alpha mask
• visual 匹配

2. Picture 创建失败

检查：

• Drawable 是否有效
• Visual 是否支持 XRender
• PictFormat 是否来自正确 screen

3. Composite 黑屏 / 不显示

常见原因：

• 没调用 XRenderComposite
• src / mask / dst 顺序错
• alpha = 0
• 没 flush：

XFlush(display);

四、结合 Compositor 调试

如果你在调试 窗口合成器（compositor）：

1. 关闭合成器

killall xcompmgr
# 或
metacity --replace &

2. 使用简单 compositor

xcompmgr -c -f

观察 XRender 行为是否变化。

五、源码级调试（C / XCB）

1. 编译带调试信息

gcc -g -O0 ...

2. GDB

gdb ./your_app
break XRenderComposite

3. 打印 PictFormat

printf("depth=%d alpha=%d\n", fmt->depth, fmt->direct.alpha);

六、典型调试流程（推荐）

1. xdpyinfo | grep Render
2. xrenderinfo
3. 运行程序 + XLIB_TRACE=1
4. xtrace 看 Render 请求
5. 检查 PictFormat
6. GDB 断点 XRenderComposite

如果你能说明：

• 用的是 Xlib 还是 XCB
• 是 应用 / 合成器 / 驱动问题
• 具体错误信息或现象（黑屏 / crash / 不刷新）

我可以给你更针对性的调试方案。