Importing Fonts

Crown can import fonts from popular font file formats. Importing a font produces a .font resource (a map of glyphs), an accompanying .texture resource (an atlas containing all the glyphs) and a .material resource suitable for drawing text.

../_images/import_font.png

The Import Font dialog.

Dialog overview

On the left, the importer shows a preview of the final texture atlas. On the right you can set various parameters that control which characters are included in the atlas and their size. This size does not have to match the size used when drawing text, but it is good practice to keep them similar to avoid scaling artifacts.

Renaming the font

Font files are often named with variants and other details embedded in the filename. If you prefer a simpler name, you can rename the font before importing by entering it in the Name field.

Atlas generation

The atlas dimensions are shown in Atlas size. They are determined automatically from the font Size and the selected Charset. Enter the desired font size and press Enter; Crown will regenerate the atlas and update the preview. Glyphs are packed as tightly as possible to keep the atlas small and avoid runtime performance issues.

Custom charset

By default Crown provides several common character sets in the Charset dropdown. For a custom range, use Range min and Range max to set the first and last Unicode code point to include in the font.