The fonts
The machine's, and yours.
A font comes from two places, and that changes what must be shipped.
The machine's
<fontPath>:/ubuntu_condensed.ttf</fontPath>
The :/ designates EmulationStation's resources. Nothing to copy into your theme: the file is present on every Recalbox.
Yours
<fontPath>${root}/data/fonts/Exo2.otf</fontPath>
The file must be in your theme, and will ship with it. TTF and OTF work.
The size
fontSize changes unit depending on its value: below 1, it is a proportion of the screen height; from 1 up, it is pixels. Everything is explained in Ratio, percentage or pixels. Prefer the ratio: 0.045 gives the same proportion everywhere.
Pixel fonts
f8bitfortressplus is only sharp at sizes that are multiples of 7 in pixels. Between those values, it smears. That is true of every font drawn pixel by pixel: if you add one, check at which sizes it is clean.
fontStyle
normal · bold · italic · bolditalic
⚠️ Only works if the font contains those weights. A font shipped as a single “Regular” file will not become bold: you must provide the “Bold” file and point to it with its own fontPath.
Shipped with Recalbox
Nothing to copy into your theme.
| Font | What to write |
|---|---|
| Ubuntu Condensed | :/ubuntu_condensed.ttf |
| DejaVu Sans Condensed | :/dejavusanscondensed.ttf |
| Ubuntu Mono | :/UbuntuMonoR.ttf |
| 8-bit Fortress Plus — pixel font, crisp at multiples of 7 | :/f8bitfortressplus.ttf |