SDL2无法正确渲染天城文（Devanagari）字体问题求助

问题概述 #

使用SDL_ttf渲染天城文时，字符无法正确组合成预期的合体字（实际渲染中零散字符未连写，与连贯的预期文本不符），运行环境为WSL Ubuntu 22.04 + X11 + MobaXterm。

核心原因 #

SDL_ttf基于FreeType，默认仅支持简单文本布局，不处理复杂文本布局（Complex Text Layout, CTL）。天城文属于需要CTL的脚本，涉及字符连写、元音符号附着、字形重组等规则，SDL_ttf原生无法处理这些逻辑，导致渲染结果异常。

解决方案 #

改用支持CTL的文本渲染库，推荐使用SDL_Pango（Pango与SDL的绑定库），Pango专门针对复杂脚本设计，能正确处理天城文的布局规则。

步骤1：安装依赖 #

在Ubuntu终端执行以下命令安装SDL_Pango及相关依赖：

sudo apt update && sudo apt install libpango1.0-dev libsdl2-pango-dev

步骤2：替换渲染代码 #

使用SDL_Pango替换原SDL_ttf的渲染逻辑，完整代码如下：

#include <SDL2/SDL.h>
#include <SDL2/SDL_pango.h>
#include <iostream>

int main() {
    if (SDL_Init(SDL_INIT_VIDEO | SDL_INIT_EVENTS) < 0) {
        std::cout << "SDL初始化错误: " << SDL_GetError();
        return 1;
    }

    if (!SDL_Pango_Init()) {
        std::cout << "SDL_Pango初始化错误";
        return 2;
    }

    SDL_Window *window = NULL;
    SDL_Renderer *renderer = NULL;
    if (SDL_CreateWindowAndRenderer(400, 300, 0, &window, &renderer) != 0) {
        std::cout << "窗口/渲染器创建错误: " << SDL_GetError();
        return 3;
    }

    const std::string text = "यदा यदा हि धर्मस्य ग्लानिर्भवति भारत।\nअभ्युत्थानमधर्मस्य तदात्मानं सृजाम्यहम्।।";
    // 字体描述格式："字体名 字号"，确保系统中已安装Yatra One字体
    const std::string font_desc = "Yatra One 24";

    // SDL_Pango自动处理复杂文本布局，支持换行（指定宽度300）
    SDL_Surface *surface = SDL_Pango_RenderUTF8(text.c_str(), font_desc.c_str(), SDL_Color{255,255,255,255}, 300, -1);
    if (!surface) {
        std::cout << "表面创建错误";
        return 4;
    }

    SDL_Rect rect{50, 50, surface->w, surface->h};
    SDL_Texture *tex = SDL_CreateTextureFromSurface(renderer, surface);
    if (!tex) {
        std::cout << "纹理创建错误";
        return 5;
    }
    SDL_FreeSurface(surface);

    while (true) {
        SDL_Event e;
        if (SDL_WaitEvent(&e)) {
            if (e.type == SDL_QUIT) break;
        }

        SDL_RenderClear(renderer);
        SDL_RenderCopy(renderer, tex, NULL, &rect);
        SDL_RenderPresent(renderer);
    }

    SDL_DestroyTexture(tex);
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    SDL_Pango_Quit();
    SDL_Quit();

    return 0;
}

步骤3：编译运行 #

使用以下命令编译代码（需确保pkg-config能识别SDL2和SDL2_pango）：

g++ devanagari_render.cpp -o devanagari_render `pkg-config --cflags --libs sdl2 SDL2_pango`

运行编译后的程序即可得到符合预期的天城文渲染效果。

备选方案（进阶） #

若坚持使用SDL_ttf，需手动集成HarfBuzz库对文本进行shaping（字形重组），再通过FreeType渲染处理后的字形。此方法需要编写更多代码，负责文本布局、字形定位等逻辑，适合需要高度自定义渲染流程的场景。

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