如何设置XCB窗口默认背景为透明？跨Linux平台适配问题

#include <unistd.h>      /* pause() */

#include <xcb/xcb.h>

int
main ()
{
    /* Open the connection to the X server */
    xcb_connection_t *connection = xcb_connect (NULL, NULL);


    /* Get the first screen */
    const xcb_setup_t      *setup  = xcb_get_setup (connection);
    xcb_screen_iterator_t   iter   = xcb_setup_roots_iterator (setup);
    xcb_screen_t           *screen = iter.data;


    /* Create the window */
    xcb_window_t window = xcb_generate_id (connection);
    xcb_create_window (connection,                    /* Connection          */
                       XCB_COPY_FROM_PARENT,          /* depth (same as root)*/
                       window,                        /* window Id           */
                       screen->root,                  /* parent window       */
                       0, 0,                          /* x, y                */
                       150, 150,                      /* width, height       */
                       10,                            /* border_width        */
                       XCB_WINDOW_CLASS_INPUT_OUTPUT, /* class               */
                       screen->root_visual,           /* visual              */
                       0, NULL );                     /* masks, not used yet */


    /* Map the window on the screen */
    xcb_map_window (connection, window);


    /* Make sure commands are sent before we pause so that the window gets shown */
    xcb_flush (connection);


    pause ();    /* hold client until Ctrl-C */

    xcb_disconnect (connection);

    return 0;
}

我有一段从网上复制的XCB示例代码，在部分Linux平台上窗口背景为透明，但在其他平台显示为黑色背景。请问如何设置XCB窗口的默认背景为透明？

查阅XCB文档得知，若指定XCB_BACK_PIXMAP_NONE，窗口将无定义背景，服务器可能填充之前的屏幕内容或自行选择内容，但我不清楚如何配置X Server使其填充之前的屏幕内容。

你遇到的差异是因为XCB_BACK_PIXMAP_NONE的行为完全由X服务器和窗口管理器决定——有的环境会保留底层内容（看起来透明），有的则会用黑色填充未定义区域。要实现跨平台一致的透明效果，不能依赖这种未定义行为，需要用更明确的方法：

方法一：使用Composite扩展实现真透明 #

现代Linux桌面几乎都支持Composite扩展，它是实现窗口透明、阴影等效果的基础。要让窗口透明，需要启用窗口重定向，让X服务器将窗口内容合成到根窗口上：

修改步骤： #

• 检查Composite扩展是否可用
• 对目标窗口启用重定向（Redirect）
• 可选：设置窗口的_NET_WM_WINDOW_OPACITY属性让窗口管理器识别为透明窗口

修改后的代码示例： #

#include <unistd.h>
#include <xcb/xcb.h>
#include <xcb/composite.h>
#include <xcb/xcb_atom.h>

int main ()
{
    xcb_connection_t *connection = xcb_connect(NULL, NULL);
    const xcb_setup_t *setup = xcb_get_setup(connection);
    xcb_screen_iterator_t iter = xcb_setup_roots_iterator(setup);
    xcb_screen_t *screen = iter.data;

    // 检查Composite扩展是否存在
    xcb_extension_t *composite_ext = xcb_get_extension_data(connection, &xcb_composite_id);
    if (!composite_ext || !composite_ext->present) {
        // 不支持Composite， fallback到其他方法或退出
        xcb_disconnect(connection);
        return 1;
    }

    // 创建窗口，指定无默认背景
    xcb_window_t window = xcb_generate_id(connection);
    uint32_t create_values[] = {XCB_BACK_PIXMAP_NONE};
    xcb_create_window(
        connection,
        XCB_COPY_FROM_PARENT,
        window,
        screen->root,
        0, 0, 150, 150,
        10,
        XCB_WINDOW_CLASS_INPUT_OUTPUT,
        screen->root_visual,
        XCB_CW_BACK_PIXMAP, // 指定要设置的属性掩码
        create_values
    );

    // 启用Composite重定向，让窗口内容被合成
    xcb_composite_redirect_window(connection, window, XCB_COMPOSITE_REDIRECT_MANUAL);

    // 设置窗口透明度（0是全透，0xffffffff是不透明，这里设为半透明）
    xcb_intern_atom_cookie_t opacity_cookie = xcb_intern_atom(connection, 0, strlen("_NET_WM_WINDOW_OPACITY"), "_NET_WM_WINDOW_OPACITY");
    xcb_intern_atom_reply_t *opacity_atom = xcb_intern_atom_reply(connection, opacity_cookie, NULL);
    if (opacity_atom) {
        uint32_t opacity = 0x80000000;
        xcb_change_property(
            connection,
            XCB_PROP_MODE_REPLACE,
            window,
            opacity_atom->atom,
            XCB_ATOM_CARDINAL,
            32,
            1,
            &opacity
        );
        free(opacity_atom);
    }

    xcb_map_window(connection, window);
    xcb_flush(connection);

    pause();

    xcb_disconnect(connection);
    return 0;
}

方法二：使用ARGB视觉设置透明背景 #

如果你的X服务器支持ARGB视觉格式，可以直接创建带alpha通道的窗口，设置透明背景像素：

修改步骤： #

• 遍历屏幕的视觉列表，找到支持ARGB的视觉
• 创建窗口时使用该视觉，并设置背景像素为0x00000000（全透明，alpha通道为0）

关键代码片段： #

// 查找ARGB视觉
xcb_visualtype_t *argb_visual = NULL;
xcb_depth_iterator_t depth_iter = xcb_screen_allowed_depths_iterator(screen);
for (; depth_iter.rem; xcb_depth_next(&depth_iter)) {
    xcb_visualtype_iterator_t visual_iter = xcb_depth_visuals_iterator(depth_iter.data);
    for (; visual_iter.rem; xcb_visualtype_next(&visual_iter)) {
        xcb_visualtype_t *v = visual_iter.data;
        if (v->class == XCB_VISUAL_CLASS_TRUE_COLOR && v->depth == 32) {
            // 匹配ARGB格式的掩码
            if (v->red_mask == 0x00ff0000 && v->green_mask == 0x0000ff00 && v->blue_mask == 0x000000ff) {
                argb_visual = v;
                break;
            }
        }
    }
    if (argb_visual) break;
}

// 创建带透明背景的ARGB窗口
if (argb_visual) {
    uint32_t create_values[] = {0x00000000}; // 全透明背景
    xcb_create_window(
        connection,
        32, // 使用ARGB的深度
        window,
        screen->root,
        0, 0, 150, 150,
        10,
        XCB_WINDOW_CLASS_INPUT_OUTPUT,
        argb_visual->visual_id,
        XCB_CW_BACK_PIXEL,
        create_values
    );
}

注意事项 #

• 方法一依赖Composite扩展，大多数现代桌面（GNOME、KDE、Xfce）都支持，但一些轻量窗口管理器（如Openbox）需要手动启用Composite
• 方法二需要X服务器提供ARGB视觉，大部分现代系统都支持，但老旧系统可能没有
• 不要依赖XCB_BACK_PIXMAP_NONE的未定义行为，它无法保证跨平台一致性

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