glyphore

MapLibre glyph PBF generation for Rust, with a native command-line interface.

CLI

cargo install glyphore
glyphore build ./fonts -o ./public/glyphs
glyphore info ./fonts/NotoSans-Regular.ttf

The complete commands are:

glyphore build <fonts-dir> -o <out-dir> [--skip-invalid]
glyphore info <font-file> [--json]

build writes each font's covered 256-codepoint ranges below a directory named with its internal fontstack name. --skip-invalid reports and excludes fonts that cannot be parsed. info --json prints the extracted font metadata as JSON. Only ranges containing mapped glyphs are written.

Use each generated directory with a single-entry text-font array. MapLibre joins multiple text-font entries with commas when expanding {fontstack}; glyphore does not generate those combined directories.

Rust API

The library target re-exports the glyph API from glyphore-core. To use the API without compiling the CLI dependency, disable default features:

cargo add glyphore --no-default-features

use glyphore::{FontFace, generate_range};

fn main() -> Result<(), Box<dyn std::error::Error>> {
	let bytes = std::fs::read("NotoSans-Regular.ttf")?;
	let face = FontFace::parse(&bytes)?;
	let pbf = generate_range(&face, 0)?;
	std::fs::write("0-255.pbf", pbf)?;
	Ok(())
}

See the API documentation for the re-exported Rust types and functions.

Features

• cli (default): builds the glyphore executable and enables argument parsing with clap.
• With default features disabled, only the Rust library API and glyphore-core dependency remain.

Generated PBF files contain data derived from the source font. Check the font's license before redistributing them.

License

Licensed under either Apache-2.0 or MIT, at your option.