Skip to main content

Font reference

Tetra bundles 115 bitmap font faces sized for a 64 × 32 display: 10 original faces and 105 PixelFonts variants. Choose a face based on how much text must fit, whether fixed-width glyphs matter, and which characters the app needs. render.Text uses tb-8 by default; set its font parameter to select another face.

Choose a font​

This complete app accepts font and sample configuration values, which makes it useful for checking text before committing to a layout:

app.star
load("render.star", "render")

def main(config):
font = config.str("font", "tb-8")
sample = config.str("sample", "Aa09 ÑÖ")

return render.Root(
child = render.Box(
width = 64,
height = 32,
child = render.Column(
expanded = True,
main_align = "center",
cross_align = "center",
children = [
render.Text(
sample,
font = font,
color = "#ffffff",
),
],
),
),
)
Text rendered with Tetra's default tb-8 font

Use the smallest face that remains legible for the content:

  • PixelFonts spans 5- to 21-pixel capital heights, with multiple widths, weights, 3D styles, and extended Latin variants.
  • CG-pixel-3x5-mono and CG-pixel-4x5-mono maximize density.
  • tom-thumb, tb-8, and 5x8 work well for compact labels and values.
  • Dina_r400-6, 6x10, 6x10-rounded, and 6x13 improve readability when more vertical space is available.
  • 10x20 is best for a short value or focal number.

Typography metrics​

Bitmap fonts align glyphs around a common baseline. These measurements explain how much space each face needs and where its glyphs sit inside that space.

Typography diagram showing baseline, ascent, cap height, x-height, descent, and advance
Baseline
The line on which most letters sit.
Ascent
The distance from the baseline to the font's highest point.
Cap height
The distance from the baseline to the top of a capital letter.
X-height
The height of a lowercase letter without an ascender.
Descent
The distance below the baseline reserved for descending glyphs.
Advance
The horizontal distance from one glyph's origin to the next.

render.Text positions a font on its baseline, offset upward by its descent. A cap height of 6 pixels with a 1-pixel descent is generally enough for readable upper- and lowercase Latin text. Accented Latin-1 characters such as Ñ, Ä, and Ö need additional ascent.

Available fonts​

Every preview below was rendered by Tetra from the same sample app.

Original fonts​

PreviewFontAdvanceHeightCap heightAscentDescentNotes
tb-8 font sampletb-82–68671Default, variable-width face derived from 5x8. Digits use a fixed 5-pixel advance.
Dina r400 6 font sampleDina_r400-6610682Jørgen Ibsen. Monospace Basic Latin and Latin-1.
5x8 font sample5x858671Markus Kuhn. Monospace with broad Latin coverage.
6x13 font sample6x136139112Markus Kuhn. Taller monospace face with broad Unicode coverage.
6x10 font sample6x10610782Olikraus. Medium monospace face for fixed-width layouts.
6x10 rounded font sample6x10-rounded610782Rounded 6x10 variant by Olikraus, modified by SynthSolar.
10x20 font sample10x20102013164Markus Kuhn. Large monospace face with broad Unicode coverage.
tom-thumb font sampletom-thumb46451Robey Pointer. Tiny 4x6 monospace face with 3x5 usable glyph pixels.
CG pixel 3x5 mono font sampleCG-pixel-3x5-mono45450Ilmari Karonen. True 3x5 glyphs for the narrowest layouts.
CG pixel 4x5 mono font sampleCG-pixel-4x5-mono55450Ilmari Karonen. True 4x5 glyphs when one more pixel of width is available.

PixelFonts family​

PixelFonts by mcer12 is a family of narrow bitmap fonts for low-resolution displays, distributed under the MIT License. Tetra includes all 105 variants.

The names follow this pattern:

pixelfont[_3d|_3d_condensed][_extended_latin]_<height>x<width>_<weight>

The dimensions are capital height × width, so 13x7 means a capital height of 13 pixels and a width of 7 pixels. The weights are thin (1-pixel strokes), semibold (2-pixel strokes), and bold (3-pixel strokes).

StyleASCII prefixExtended Latin prefixSpacing
Flatpixelfont_pixelfont_extended_latin_Standard
3Dpixelfont_3d_pixelfont_3d_extended_latin_1-pixel character and line gap
3D condensedpixelfont_3d_condensed_pixelfont_3d_condensed_extended_latin_No character or line gap

Append a base design such as 13x7_semibold to one of these prefixes:

app.star
load("render.star", "render")

label = render.Text(
"Hello!",
font = render.fonts["pixelfont_13x7_semibold"],
)

Base designs​

Each preview uses the flat ASCII variant. The same base designs are available in 3D and condensed 3D, with extended Latin versions for every design except 5x5_thin.

Style comparison​

The 3D styles add an outline and shadow, making the design 3 pixels taller. The condensed form removes the extra spacing between characters and lines.

Extended Latin​

Extended Latin variants add supported lowercase accented characters and punctuation. Accented capital letters are not included, so preview localized content before choosing a face.

Compact numbers with tb-8​

All tb-8 digits are 5 × 6 pixels and share the same advance. Set height = 6 and offset = -1 when a numeric row must fit tightly without cropping. The common +, -, /, *, =, %, and . symbols also fit; a comma extends into the 1-pixel descent and needs the full height.

app.star
load("render.star", "render")

def main(config):
return render.Root(
child = render.Box(
width = 64,
height = 32,
child = render.Padding(
pad = (4, 5, 4, 5),
child = render.Column(
children = [
render.Text(
"COMPACT",
font = "CG-pixel-3x5-mono",
color = "#94a3b8",
),
render.Box(width = 1, height = 4),
render.Text(
"123.45%",
font = "tb-8",
height = 6,
offset = -1,
color = "#22d3ee",
),
],
),
),
),
)
Compact numeric text rendered with tb-8 at a height of six pixels

Character coverage​

Basic Latin covers ASCII letters, digits, punctuation, and common symbols. Latin-1 Supplement adds characters used by many Western European languages. Use a face with known Latin-1 support for names and locations, and preview the actual text when an app may receive characters beyond those ranges. Unsupported glyphs cannot be recovered by changing height or offset; select a font with the required coverage instead.