History

ChestnutYueyue bbefd83664 feat: 添加MSDF字体支持并重构文本渲染系统实现MSDF字体渲染功能，包括： 1. 新增MSDF字体构建工具，支持从TTF生成MSDF图集 2. 重构字体加载器和文本渲染器以支持MSDF 3. 添加MSDF文本渲染示例程序 4. 移除旧的TrueType字体渲染实现 5. 优化VAO顶点属性绑定设置 MSDF字体提供高质量的可缩放文本渲染，同时保持运行时性能。构建工具将TTF转换为带元数据的PNG图集，运行时只需加载预生成的纹理。重构后的文本渲染系统更简洁高效，支持中文等复杂字符集。		2026-02-23 21:30:44 +08:00
..
README.md	feat: 添加MSDF字体支持并重构文本渲染系统	2026-02-23 21:30:44 +08:00
charset_default.txt	feat: 添加MSDF字体支持并重构文本渲染系统	2026-02-23 21:30:44 +08:00
main.cpp	feat: 添加MSDF字体支持并重构文本渲染系统	2026-02-23 21:30:44 +08:00
msdf_font_builder.cpp	feat: 添加MSDF字体支持并重构文本渲染系统	2026-02-23 21:30:44 +08:00
msdf_font_builder.h	feat: 添加MSDF字体支持并重构文本渲染系统	2026-02-23 21:30:44 +08:00

README.md

MSDF Font Builder

将 TTF 字体转换为 MSDF PNG 图集的离线构建工具。

直接集成 msdfgen 库，无需外部依赖。

构建

xmake build msdf_font_builder

使用方法

# 基本用法
msdf_font_builder -i font.ttf -o font.msdf.png

# 指定字符集
msdf_font_builder -i font.ttf -o font.msdf.png -c "ABCabc123"

# 使用字符集文件
msdf_font_builder -i font.ttf -o font.msdf.png -f charset.txt

# 自定义参数
msdf_font_builder -i font.ttf -o font.msdf.png -s 64 -r 6.0 -w 4096 -h 4096

命令行选项

选项	说明	默认值
`-i, --input`	输入 TTF 字体文件	必需
`-o, --output`	输出 PNG 图集路径	必需
`-c, --charset`	字符集字符串	ASCII 可打印字符
`-f, --charset-file`	字符集文件路径	-
`-s, --size`	字体大小（像素）	48
`-r, --range`	像素范围	4.0
`-w, --width`	图集宽度	2048
`-h, --height`	图集高度	2048

输出格式

生成的 PNG 文件包含嵌入的元数据（存储在 tEXt chunk 中）：

{
  "size": 48,
  "pxRange": 4.0,
  "lineHeight": 60,
  "baseline": 12,
  "atlas": { "width": 2048, "height": 2048 },
  "glyphs": [...]
}

在 Extra2D 中使用

#include <extra2d/asset/font_asset.h>
#include <extra2d/render/text_renderer.h>

auto font = assetService->load<FontAsset>("font.msdf.png");

TextRenderer renderer;
renderer.init();
renderer.begin(projection);
renderer.drawText(font.get(), U"Hello, World!", 100, 100, { .fontSize = 32.0f });
renderer.end();

工作流程

构建时: TTF ──► msdfgen 库 ──► MSDF PNG (内嵌 JSON 元数据)
运行时: FontLoader ──► FontAsset ──► TextRenderer