linux xrender为什么黑屏

在 Linux 下使用 XRender 出现“黑屏”通常不是 XRender 本身的问题，而是合成方式、驱动、窗口管理或程序用法的问题。下面按常见原因逐一说明。

一、最常见原因

1. 没有 Composite Manager（合成管理器）

XRender 依赖 Composite Extension 才能正确显示。

• 如果你用的是：
  • 纯 twm / fvwm / openbox（未启用 compositor）
  • 或登录的是 failback / no composite 会话
• 那么使用 XRender 的窗口可能：
  • 完全黑屏
  • 或只显示背景色

✅ 解决：

# 启用合成管理器，例如：
xcompmgr -c &
# 或
picom &

2. 窗口背景未绘制（常见程序错误）

XRender 不会“自动”画背景。

典型错误：

XRenderComposite(..., 0, 0, 0, 0, ...); // 源为空

表现：

• 窗口存在
• 但内容全黑

✅ 正确做法：

• 先填充背景（XFillRectangle / XRenderFillRectangle）
• 或确保 source picture 有内容

3. 用了 ARGB Visual 但没画 alpha

很多 XRender 程序使用：

Visual *visual = get_best_visual(...); // ARGB

问题：

• 窗口是 32-bit ARGB
• 但你没设置 alpha = 255
• 结果：完全透明 → 看起来像黑屏（尤其在无合成时）

✅ 解决：

XRenderFillRectangle(dpy, PictOpSrc, picture,
    &(XRenderColor){0,0,0,0xffff}, 0, 0, w, h);

4. 显卡驱动 / 渲染后端问题

尤其是：

• NVIDIA 闭源驱动 + XRender
• 老旧 Intel / Mesa
• 虚拟机（QEMU / VirtualBox）

表现：

• XRender 黑屏
• GL 正常

✅ 排查：

glxinfo | grep "OpenGL"
xdpyinfo | grep Composite

5. 程序在 XWayland 下运行

在 Wayland 会话中：

• XRender 行为不完整
• 某些合成路径直接黑屏

✅ 解决：

• 在 X11 会话测试
• 或改用 OpenGL / Vulkan

6. 裁剪区域 / 坐标错误

例如：

XRenderComposite(..., x, y, 0,0, w, h);

但 x,y 超出窗口

表现：

• 窗口黑屏
• 实际啥都没画

二、快速自检清单 ✅

# 1. 是否启用 Composite
xdpyinfo | grep Composite

# 2. 是否有 compositor
ps aux | grep -E "picom|xcompmgr|compton"

# 3. 是否 ARGB visual
xdpyinfo | grep -A3 "Visual"

三、一个最小“不黑屏”的 XRender 示例思路

XRenderFillRectangle(dpy, PictOpSrc, win_pic,
    &(XRenderColor){0xffff,0xffff,0xffff,0xffff},
    0, 0, width, height);

四、如果你愿意，我可以更具体地帮你

你可以告诉我：

1. 用的是 X11 还是 Wayland
2. 桌面环境（GNOME / KDE / 无桌面）
3. 是 自己写的 XRender 程序 还是某个软件黑屏
4. 显卡 & 驱动

我可以直接帮你定位是哪一类问题。