如何通过Xlib仅修改窗口背景透明度而不影响前景？

在 compositor已运行、XServer支持32位深度TrueColor的前提下，你遇到的问题可以通过以下方式解决，先分析你之前的尝试为什么失败：

• _NET_WM_WINDOW_OPACITY属性是 compositor提供的全局窗口透明度控制，作用于整个窗口的所有内容（包括前景和背景），因此无法实现仅背景透明的需求。
• 第二段代码报BadMatch错误，是因为窗口创建时的Visual与你指定的new_colormap使用的Visual不匹配——窗口的Visual是创建时固定的，无法后期修改，因此不能直接更换颜色映射。

解决方案一：创建窗口时使用带Alpha通道的32位Visual #

如果你是自己创建窗口，最直接的方式是在窗口初始化阶段就使用支持Alpha通道的32位TrueColor Visual，并设置带Alpha值的背景像素：

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

int main() {
    Display *display = XOpenDisplay(NULL);
    if (!display) return 1;

    int screen = DefaultScreen(display);
    Visual *visual = DefaultVisual(display, screen);

    // 验证是否为支持Alpha的32位TrueColor Visual
    if (visual->depth != 32 || visual->class != TrueColor) {
        fprintf(stderr, "当前环境不支持32位TrueColor Visual\n");
        XCloseDisplay(display);
        return 1;
    }

    // 定义半透明背景色：0x80为Alpha通道值（0=完全透明，0xFF=完全不透明），后三位为RGB(255,255,255)
    unsigned long bg_color = 0x80FFFFFF;

    XSetWindowAttributes win_attr;
    win_attr.background_pixel = bg_color;
    // 创建与Visual匹配的颜色映射
    win_attr.colormap = XCreateColormap(display, RootWindow(display, screen), visual, AllocNone);

    // 创建窗口
    Window win = XCreateWindow(
        display, RootWindow(display, screen),
        100, 100, 400, 300, 0,
        visual->depth, InputOutput, visual,
        CWBackPixel | CWColormap, &win_attr
    );

    XMapWindow(display, win);

    // 绘制不透明的前景文本，验证前景不受背景透明度影响
    XFontStruct *font = XLoadQueryFont(display, "fixed");
    XSetFont(display, DefaultGC(display, screen), font->fid);
    XDrawString(display, win, DefaultGC(display, screen), 50, 50, "不透明前景文本", 12);

    XFlush(display);

    // 等待窗口关闭事件
    XEvent ev;
    while (XNextEvent(display, &ev)) {
        if (ev.type == DestroyNotify) break;
    }

    // 资源清理
    XFreeFont(display, font);
    XFreeColormap(display, win_attr.colormap);
    XCloseDisplay(display);
    return 0;
}

解决方案二：对已有窗口使用XComposite+XRender扩展 #

如果需要修改已有窗口的背景透明度，可以借助XComposite扩展将窗口重定向到离屏像素图，再通过XRender绘制半透明背景：

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

int main() {
    Display *display = XOpenDisplay(NULL);
    if (!display) return 1;

    int screen = DefaultScreen(display);
    Window target_win = /* 替换为目标窗口的ID */;

    // 检查XComposite扩展是否可用
    int composite_event, composite_error;
    if (!XCompositeQueryExtension(display, &composite_event, &composite_error)) {
        fprintf(stderr, "XComposite扩展未启用\n");
        XCloseDisplay(display);
        return 1;
    }

    // 将目标窗口重定向到离屏像素图
    XCompositeRedirectWindow(display, target_win, CompositeRedirectManual);

    // 获取目标窗口属性
    XWindowAttributes win_attr;
    XGetWindowAttributes(display, target_win, &win_attr);

    // 创建半透明背景的Picture（0x8000为Alpha值，对应0x80的8位值）
    XRenderColor bg_color = {0x8000, 0xffff, 0xffff, 0xffff};
    Picture bg_picture = XRenderCreateSolidFill(display, &bg_color);

    // 创建目标窗口对应的Picture
    XRenderPictFormat *format = XRenderFindVisualFormat(display, win_attr.visual);
    Picture win_picture = XRenderCreatePicture(display, target_win, format, 0, NULL);

    // 将半透明背景合成到窗口
    XRenderComposite(display, PictOpSrc, bg_picture, None, win_picture,
                     0, 0, 0, 0, 0, 0, win_attr.width, win_attr.height);

    // 资源清理
    XRenderFreePicture(display, bg_picture);
    XRenderFreePicture(display, win_picture);

    XFlush(display);
    XCloseDisplay(display);
    return 0;
}

关键注意事项 #

• 窗口的Visual是创建时固定的，若已有窗口使用的是24位深度（无Alpha通道）的Visual，无法直接设置带Alpha的背景像素，必须使用XComposite+XRender方案。
• 确保 compositor支持XComposite扩展，否则无法实现离屏重定向。

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