游戏客户端架构 / 系统课时

渲染文本

渲染文本

本课解决“字符串为什么不能直接交给渲染器”的问题。你将完成从字体加载、字形栅格化到纹理绘制的最小链路,并理解缓存、缩放和字符缺失对最终清晰度与性能的影响。

学习目标

  • 说清字符、字形、位图和纹理之间的转换关系
  • 使用字体库生成文本纹理并绘制到窗口
  • 判断何时缓存整段文本,何时缓存单个字形

从字符串到屏幕像素

字符串只保存字符编码,GPU 不能直接理解“字母 A”应长什么样。文本渲染通常先由字体库根据字号找到对应字形,再把字形轮廓栅格化成像素位图,最后上传为纹理并按普通二维图片绘制。

文本渲染处理链路

同一个字符在不同字体、字号和样式下会得到不同字形。渲染器真正绘制的是生成后的像素,而不是原始字符串,因此字体文件路径、字号和颜色都属于纹理生成条件。

使用 SDL_ttf 生成文本纹理

下面的示例加载一个 TrueType 字体,把英文字符串转换为表面和纹理,再绘制到窗口。运行前需安装 SDL2 与 SDL2_ttf,并把字体文件放到 assets/DejaVuSans.ttf;字体路径可替换为本机实际路径。

cpp
#include <SDL2/SDL.h>
#include <SDL2/SDL_ttf.h>
#include <iostream>

int main() {
    if (SDL_Init(SDL_INIT_VIDEO) != 0 || TTF_Init() != 0) {
        std::cerr << "init failed: " << SDL_GetError() << '\n';
        return 1;
    }

    SDL_Window* window = SDL_CreateWindow(
        "Text Demo", SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED,
        800, 240, SDL_WINDOW_SHOWN);
    SDL_Renderer* renderer = SDL_CreateRenderer(
        window, -1, SDL_RENDERER_ACCELERATED | SDL_RENDERER_PRESENTVSYNC);
    TTF_Font* font = TTF_OpenFont("assets/DejaVuSans.ttf", 48);

    if (!window || !renderer || !font) {
        std::cerr << "resource creation failed\n";
        return 1;
    }

    // 字体库先在 CPU 侧把字符串栅格化成带透明通道的位图。
    SDL_Color color{240, 240, 240, 255};
    SDL_Surface* surface = TTF_RenderUTF8_Blended(
        font, "Hello, Anystack!", color);
    SDL_Texture* texture = SDL_CreateTextureFromSurface(renderer, surface);
    SDL_Rect target{80, 80, surface->w, surface->h};
    SDL_FreeSurface(surface);

    bool running = true;
    while (running) {
        SDL_Event event{};
        while (SDL_PollEvent(&event)) {
            if (event.type == SDL_QUIT) {
                running = false;
            }
        }

        SDL_SetRenderDrawColor(renderer, 28, 31, 38, 255);
        SDL_RenderClear(renderer);
        SDL_RenderCopy(renderer, texture, nullptr, &target);
        SDL_RenderPresent(renderer);
    }

    SDL_DestroyTexture(texture);
    TTF_CloseFont(font);
    SDL_DestroyRenderer(renderer);
    SDL_DestroyWindow(window);
    TTF_Quit();
    SDL_Quit();
    return 0;
}

预期结果

text
窗口中央显示浅色文本“Hello, Anystack!”;关闭窗口后程序正常退出。

如果初始化失败,优先检查动态库是否可用;如果字体加载失败,检查文件路径与读取权限。实际窗口位置、字体尺寸和像素宽度可能因系统字体文件与显示缩放不同而变化。

缓存与清晰度边界

静态标题、按钮文字等内容很少变化,可以缓存整段文本纹理,直到文本、字号或颜色改变时再重建。聊天记录、计分板等频繁变化内容若每帧都重新栅格化,会产生明显的 CPU 开销和纹理上传开销。

需要大量动态文本时,更常见的做法是建立字形图集:每个字形只栅格化一次,之后根据排版结果批量绘制多个纹理区域。图集减少纹理切换,但必须处理字距、换行、缺字回退和图集扩容。

文本纹理应按目标像素尺寸生成。把小字号纹理直接放大会变糊,把超大纹理缩小又会浪费显存。高 DPI 环境下应根据实际渲染分辨率选择字号,而不是只使用逻辑窗口尺寸。

本课总结

  • 文本渲染的核心链路是字符编码、字形栅格化、纹理上传和二维绘制
  • 静态文本适合缓存整段纹理,动态文本更适合复用字形图集
  • 字体路径、缺字回退与目标像素尺寸会直接影响可用性和清晰度

下一课预告

下一课将把文字、按钮和面板放入统一的界面布局系统,使用锚点、尺寸与父子关系计算每个元素的最终矩形。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

渲染文本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通