如何在Xlib/LibXFT中使用回退字体绘制含缺失字符的文本？

LibXFT本身没有原生的回退字体机制，需要手动实现字符与字体的匹配逻辑——逐个检查字符是否被主字体支持，不支持则依次尝试回退字体列表，找到可用字体后分段绘制。

实现步骤 #

1. 预加载主字体与回退字体 #

用XftFontOpenName()加载主字体和所有备选回退字体，将它们存入数组便于后续遍历：

Display *dpy = XOpenDisplay(NULL);
// 主字体
XftFont *main_font = XftFontOpenName(dpy, DefaultScreen(dpy), "Noto Sans:size=12");
// 回退字体列表（按需添加，比如CJK、emoji字体）
XftFont *fallback_fonts[] = {
    XftFontOpenName(dpy, DefaultScreen(dpy), "Noto Sans CJK SC:size=12"),
    XftFontOpenName(dpy, DefaultScreen(dpy), "Noto Emoji:size=12")
};
int fallback_count = sizeof(fallback_fonts) / sizeof(fallback_fonts[0]);

2. 检查字符的字体支持性 #

利用XftCharExists()函数判断指定字体能否渲染目标Unicode字符：

Bool is_char_supported(XftFont *font, FcChar32 ucs4) {
    return XftCharExists(font->dpy, font, ucs4);
}

3. 拆分字符串并匹配字体绘制 #

遍历UTF-8字符串的每个Unicode字符，先尝试主字体，不支持则遍历回退字体列表，找到第一个支持的字体后绘制该字符，同时更新绘制坐标：

void draw_string_with_fallback(Display *dpy, Drawable draw, XftDraw *xftdraw, 
                               XftFont *main_font, XftFont **fallbacks, int fallback_cnt,
                               const char *utf8_str, int x, int y, XftColor color) {
    const char *ptr = utf8_str;
    while (*ptr) {
        FcChar32 ucs4;
        // 将UTF-8字符转换为UCS-4编码
        int bytes = XmbTextToUcs4(ptr, strlen(ptr), &ucs4);
        if (bytes <= 0) break;

        // 寻找可渲染当前字符的字体
        XftFont *current_font = main_font;
        if (!XftCharExists(dpy, current_font, ucs4)) {
            for (int i = 0; i < fallback_cnt; i++) {
                if (XftCharExists(dpy, fallbacks[i], ucs4)) {
                    current_font = fallbacks[i];
                    break;
                }
            }
            // 若所有字体都不支持，跳过该字符
            if (!XftCharExists(dpy, current_font, ucs4)) {
                ptr += bytes;
                continue;
            }
        }

        // 将UCS-4转换回UTF-8用于绘制
        char buf[8];
        int len = Xucs4TextToXmb(ucs4, buf, sizeof(buf));
        buf[len] = '\0';

        // 绘制当前字符
        XftDrawStringUtf8(xftdraw, &color, current_font, x, y, (FcChar8*)buf, len);

        // 更新x坐标，移动到下一个字符的起始位置
        x += XftTextExtentsUtf8(dpy, current_font, (FcChar8*)buf, len).xOff;
        ptr += bytes;
    }
}

4. 关键注意事项 #

• 编码转换正确性：必须通过XmbTextToUcs4()和Xucs4TextToXmb()完成UTF-8与UCS-4的转换，避免手动解析编码导致的错误。
• 字体对齐：不同字体的基线、高度可能存在差异，绘制时可统一使用主字体的基线参数，或计算字体间的偏移量来保证文字垂直对齐。
• 资源释放：使用完毕后，调用XftFontClose()释放所有加载的字体，防止内存泄漏：

XftFontClose(dpy, main_font);
for (int i = 0; i < fallback_count; i++) {
    XftFontClose(dpy, fallback_fonts[i]);
}
XCloseDisplay(dpy);

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