Bitmap font generator (.fnt)
Last updated
Was this helpful?
Last updated
Was this helpful?
Gum renders rasterized fonts using the .fnt and .png files generated by the Bitmap font generator. This tool is used internally by Gum to generate fonts, but custom fonts can also be created by downloading and creating them using the Bitmap font generator tool:
Manually creating .fnt files allows for customization beyond what is provided by the Gum tool.
Each font file is represented by a single .fnt file. When a .fnt is created, it creates one or more accompanying .png files, also known as pages.
To create a font:
Open Bitmap font generator
Select Options -> Font Settings
Change your settings to the desired values - these values will be discussed later in this document. If you would like your exported font sizes to match Gum, be sure to check Match char height
Click OK to apply the changes
Select which characters to include in your font - notice that by default they are unchecked so your font will not include any characters
Select Options->Export Options to
Select a Bit depth of 32
Select the texture width and height. For best performance, select a size which will contain all of the characters you have selected. Also, many game engines prefer textures which are power of two such as 256, 512, 1024, or 2048. Sizes larger than 2048 may not render properly on some hardware.
Change the Textures option to png – Portable Network Graphics
Be sure to keep the Font descriptor as Text.
Press OK to apply the changes
Select Options->Save bitmap font as… to save your .fnt and .png files.
Bitmap font generator automatically produces .fnt files based on the values set in the application. Since .fnt files are text files, they can be modified manually to adjust font behavior. Keep in mind that a modified .fnt file may be overwritten by Bitmap font generator if you export the font again.
The lineHeight value controls the height of each individual line in rendered text. Gum uses this value when determining the size of a font when using Height Units of Relative to Children.
For example, the following Text instance has 3 lines of text and is using a .fnt file with a lineHeight of 18, resulting in a height of 18*3=54.
