Font Families
Font Families¶
Font Families are reusable font definitions that bundle together the four faces a single font can render in — Normal, Bold, Italic, and Bold Italic. A font family is referenced wherever text is rendered in the project, and the engine automatically picks the right face based on how the text is styled.
A font family can also be configured as a pixel font, which switches the renderer to a non-anti-aliased path with adjustable alpha clamping — preserving the crisp, hard-edged look of bitmap-style fonts that softening would otherwise destroy.
Note: Only the Normal face is required. The Bold, Italic, and Bold Italic faces are optional, and any face that is left blank falls back to Normal at runtime. Define the additional faces only when the project actually uses styled text and the chosen font has dedicated artwork for them.
Properties¶
System¶
| Name | Explanation | Type |
|---|---|---|
| Name | The name of the font family. | String |
Fonts¶
| Name | Explanation | Type |
|---|---|---|
| Bold | The bolded face of the font. | String |
| Bold and Italic | The bolded and italicized face of the font. | String |
| Italic | The italicized face of the font. | String |
| Normal | The normal face of the font. | String |
Pixel Font Adjustments¶
| Name | Explanation | Type |
|---|---|---|
| Alpha Clamping | The alpha value to test against when clamping anti-aliasing. | Number |
| Is Pixel Font | Whether the font should be treated as a pixel font. | Toggle |