embedded-bitmap-fonts

A comprehensive collection of bitmap fonts for no_std environments, designed for use with the embedded-graphics crate.

Features

• 27 font families with 134 font variants
• Pixel-doubling support - Scale fonts 2x, 3x, or more with zero additional flash cost
• No-std compatible - Works on embedded systems without an allocator
• Feature flags - Include only the fonts you need to minimize binary size

Usage

Add to your Cargo.toml:

[dependencies]
embedded-bitmap-fonts = { version = "0.1", features = ["terminus"] }

Draw text:

use embedded_bitmap_fonts::{TextStyle, terminus::FONT_8x16};
use embedded_graphics::{pixelcolor::BinaryColor, prelude::*, text::Text};

let style = TextStyle::new(&FONT_8x16, BinaryColor::On);
Text::new("Hello!", Point::zero(), style).draw(&mut display)?;

Pixel Doubling

Scale fonts without additional memory cost:

use embedded_bitmap_fonts::terminus::FONT_8x16;

// Original 8x16 font
let small = &FONT_8x16;

// Pixel-doubled 16x32 font (same bitmap data!)
let large = FONT_8x16.pixel_double();

// Triple size 24x48
let huge = FONT_8x16.pixel_triple();

// Custom multiplier
let custom = FONT_8x16.pixel_multiply(4);

Available Fonts

Enable fonts using feature flags:

# Single font
embedded-bitmap-fonts = { version = "0.1", features = ["terminus"] }

# Multiple fonts
embedded-bitmap-fonts = { version = "0.1", features = ["terminus", "tamzen", "cherry"] }

# All fonts (not recommended for embedded - large binary size)
embedded-bitmap-fonts = { version = "0.1", features = ["all-fonts"] }

Total: 134 fonts across 27 families

Contributing

Fonts are generated from BDF (Bitmap Distribution Format) files using a custom codegen tool.

Prerequisites

git clone https://github.com/ecklf/embedded-bitmap-fonts
cd embedded-bitmap-fonts
cargo build --release -p embedded-bitmap-fonts-codegen

Regenerate All Fonts

./generate_all.sh

Generate a Single Font

./target/release/embedded-bitmap-fonts-codegen \
  -i ./fonts/bitmap/terminus \
  -o ./src \
  -f terminus

Codegen Options

-i, --input <PATH>     Input directory containing BDF files
-o, --output <PATH>    Output directory for generated Rust files
-f, --family <NAME>    Font family name (used for module name)
-P, --pattern <PAT>    Include only files matching pattern
-X, --exclude <PAT>    Exclude files matching pattern

Adding New Fonts

1. Add BDF files to fonts/bitmap/<family_name>/
2. Add entry to generate_all.sh
3. Add feature flag to Cargo.toml
4. Add module to src/lib.rs
5. Run ./generate_all.sh

Font Sources

Fonts are sourced from the Tecate/bitmap-fonts collection.

License

This crate is licensed under Apache-2.0. Individual fonts may have their own licenses - check the original font sources for details.