字体编辑器

Pyxen 内置了一个字体编辑器，可以在 iPad 和 Mac 上创建位图字体，配合 Text 组件使用。无需任何外部工具，就能为你的游戏设计清晰的像素风文字。

位图字体的工作原理

Pyxen 中的位图字体是一个字体图集——一张包含每个字符的图像，加上一个描述每个字形位置的 JSON 文件。当你的游戏渲染文本时，引擎会在图集中查找每个字符并绘制相应的区域。

创建字体

要创建新字体，请在项目中添加一个 .font.json 资源。选中它时会自动打开字体编辑器。

配置

字体编辑器允许你配置：

• 源字体 — 从系统字体中选择或导入自定义的 .ttf / .otf 文件
• 大小 — 栅格化的像素大小（例如 8px、12px、16px）
• 抗锯齿 — 开启或关闭平滑边缘。关闭它可获得清晰的像素风字体。
• 行高 — 文本行之间的垂直间距
• 基线 — 字符在行上的位置

字符集

选择要包含在字体图集中的字符：

• ASCII — 基本拉丁字母、数字和标点符号（默认）
• 扩展拉丁 — 用于欧洲语言的重音字符
• 自定义 — 定义你自己的字符集

包含更少的字符会生成更小的图集，有助于提升性能和节省内存。只包含你的游戏需要的字符。

图集预览

编辑器底部显示生成的字体图集的实时预览。这就是随你的游戏一起发布的实际图像。你可以准确看到每个字符在配置的大小和设置下的外观。

图集会随着你更改设置而实时更新——调整大小或切换抗锯齿，立即看到结果。

在游戏中使用字体

创建字体后，使用 Text 组件来渲染文本：

label = world.spawn(text=Text("Score: 0", font="myfont"))

font 参数匹配你的 .font.json 资源的名称（不含扩展名）。如果省略，Pyxen 使用内置默认字体。

完整 API 请参见 Text 参考。