linux xrender怎么使用

XRender 是 X Window System 的一个扩展（X Rendering Extension），主要用于抗锯齿、半透明、图像合成、渐变、变形等高质量 2D 渲染。它通常和 Xlib / XCB 一起使用，也被 Cairo、Qt、GTK 等图形库在底层调用。

下面从 概念 → 基本使用流程 → 示例代码 → 常见问题 给你一个实用说明。

一、XRender 是什么（先搞清楚）

XRender 不是“绘图 API 大全”，而是：

在 X Server 端做图像合成
支持 alpha 混合（透明度）
支持 PictFormat（像素格式）
适合做：窗口阴影、半透明、图标合成、特效

⚠️ 注意：

XRender 不负责窗口管理
现代桌面更多用 OpenGL / Vulkan / Wayland
XRender 仍广泛用于传统 X11 环境

二、使用 XRender 的基本流程

1️⃣ 初始化 X11 连接

Display *dpy = XOpenDisplay(NULL);

2️⃣ 检查 XRender 扩展

int event_base, error_base;
if (!XRenderQueryExtension(dpy, &event_base, &error_base)) {
    fprintf(stderr, "XRender not supported\n");
    return -1;
}

3️⃣ 获取 PictFormat（非常重要）

XRender 渲染必须指定 像素格式

XRenderPictFormat *fmt =
    XRenderFindVisualFormat(dpy, DefaultVisual(dpy, 0));

4️⃣ 创建 Picture（渲染对象）

Picture 是 XRender 的核心概念

Picture pic = XRenderCreatePicture(
    dpy,
    window,
    fmt,
    0, NULL
);

5️⃣ 画一个半透明矩形（示例）

XRenderColor color;
color.red   = 0xffff;
color.green = 0x0000;
color.blue  = 0x0000;
color.alpha = 0x8000; // 半透明

XRenderFillRectangle(
    dpy,
    PictOpOver,   // 合成操作（覆盖+alpha）
    pic,
    &color,
    100, 100,     // x, y
    200, 100      // width, height
);

6️⃣ 复合两张图（最常用的功能）

XRenderComposite(
    dpy,
    PictOpOver,
    src_picture,
    None,
    dst_picture,
    0, 0,         // src x/y
    0, 0,         // mask x/y
    x, y,         // dst x/y
    w, h
);

三、完整最小示例（半透明窗口）

#include <X11/Xlib.h>
#include <X11/extensions/Xrender.h>

int main() {
    Display *dpy = XOpenDisplay(NULL);
    Window win = XCreateSimpleWindow(
        dpy, RootWindow(dpy, 0),
        0, 0, 400, 300, 0,
        BlackPixel(dpy, 0),
        WhitePixel(dpy, 0)
    );
    XMapWindow(dpy, win);

    XRenderPictFormat *fmt =
        XRenderFindVisualFormat(dpy, DefaultVisual(dpy, 0));
    Picture pic = XRenderCreatePicture(dpy, win, fmt, 0, NULL);

    XRenderColor c = {0xffff, 0x0000, 0x0000, 0x8000};
    XRenderFillRectangle(dpy, PictOpOver, pic, &c, 50, 50, 200, 100);

    XFlush(dpy);
    sleep(5);
    return 0;
}

编译：

gcc xrender_demo.c -lX11 -lXrender -o xrender_demo

四、XRender 常见操作对照

功能	API
填充	`XRenderFillRectangle`
合成	`XRenderComposite`
梯形	`XRenderFillTrapezoids`
渐变	`XRenderCreateLinearGradient`
变换	`XRenderSetPictureTransform`
裁剪	`XRenderSetPictureClipRectangles`

五、和 Cairo / Qt 的关系

你 不一定直接写 XRender：

Cairo：cairo_xlib_surface_create() → 内部用 XRender
Qt：QPainter → X11 后端用 XRender
GTK：老版本依赖 XRender

如果你只是做应用界面，用 Cairo 更简单。

六、常见坑

❌ 忘了 XRenderFindVisualFormat
❌ alpha 没设对（0x0000 是全透明）
❌ 窗口没有 32位视觉（透明失败）
❌ 在 Wayland 下 XRender 基本不用

七、你接下来想干嘛？

我可以继续帮你：

✅ 写一个 透明窗口 + 阴影
✅ 用 XRender 做 图标合成
✅ 对比 XRender vs OpenGL
✅ 给你 Cairo + XRender 示例

你现在是 学习 X11 底层，还是 做某个具体效果？