densa-text 0.2.1

Text for densa: font loading, glyph rasterization and a growable, allocation-free glyph atlas cache
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! Real text for densa: fonts, glyph rasterization and a glyph atlas cache.
//!
//! Domain-agnostic: any widget that draws text goes through these three pieces.
//!
//! - [`Font`] wraps an OpenType/TrueType font (skrifa): character mapping, advances, line
//!   metrics. [`Font::bundled_mono`] is JetBrains Mono, shipped under the SIL OFL 1.1.
//! - [`rasterize`] turns a glyph outline into an 8-bit coverage bitmap (zeno), optionally
//!   shifted by a fraction of a pixel.
//! - [`GlyphCache`] packs rasterized glyphs into a paged texture atlas (etagere) that grows a
//!   page at a time and, once at its limit, evicts the least recently used glyphs (never the
//!   current frame's); it queues the [`AtlasUpdate`]s the GPU texture must follow.
//!
//! A warm cache answers lookups without allocating, so per-frame text drawing stays
//! allocation-free; rasterizing a glyph seen for the first time allocates, once.

mod cache;
mod font;
mod glyph_map;
mod raster;
mod run;

pub use cache::{
    quantize_x, AtlasConfig, AtlasLimitError, AtlasUpdate, CacheStats, CachedGlyph, GlyphCache,
    GlyphUnavailable, GlyphUpload, SUBPIXEL_STEPS,
};
pub use font::{Font, FontBytes, FontError, FontId, GlyphId, LineMetrics, BUNDLED_MONO};
pub use glyph_map::{GlyphMap, MappedGlyph, MAX_CACHED_CHARS};
pub use raster::{rasterize, GlyphBitmap};
pub use run::{GlyphRun, PositionedGlyph};