Struct DynamicGlyphCache 

pub struct DynamicGlyphCache {
    pub config: GlyphCacheConfig,
    pub atlas_image: Handle<Image>,
    /* private fields */
}

Global dynamic glyph cache resource.

Rasterizes glyphs on demand using fontdue and packs them into a single atlas texture using etagere.

Fields

config: GlyphCacheConfig

atlas_image: Handle<Image>

Implementations

impl DynamicGlyphCache

pub fn new(config: GlyphCacheConfig, images: &mut Assets<Image>) -> Self

pub fn add_font(&mut self, id: FontId, data: &[u8]) -> Result<(), String>

Register a font from raw bytes.

pub fn get_or_insert( &mut self, key: &GlyphKey, images: &mut Assets<Image>, ) -> Option<&GlyphInfo>

Get a cached glyph, or rasterize and cache it on demand. Returns None if the font is not loaded or the atlas is full.

pub fn clear(&mut self, images: &mut Assets<Image>)

Clear the entire cache and reset the allocator. Call this on scene transitions to reclaim atlas space.

pub fn has_font(&self, id: &FontId) -> bool

pub fn glyph_map_get(&self, key: &GlyphKey) -> Option<&GlyphInfo>

Read-only access to glyph cache (for systems that don’t rasterize).

pub fn glyph_metrics( &self, font_id: &FontId, character: char, size_px: u32, ) -> (u32, u32, f32, f32)

Get font metrics (width, height, x_offset, y_offset) for a character. Works without rasterization — just queries fontdue for metrics.

pub fn atlas_size(&self) -> UVec2

pub fn is_dirty(&self) -> bool

Check if atlas was modified since last call to acknowledge_dirty.

pub fn acknowledge_dirty(&mut self)

pub fn horizontal_advance( &self, font_id: &FontId, character: char, size_px: u32, ) -> f32

Get horizontal advance for a character (in pixels at given size).

pub fn line_metrics( &self, font_id: &FontId, size_px: u32, ) -> Option<LineMetrics>

Get line metrics for a font at a given size.

pub fn raster_config( &self, font_id: &FontId, character: char, size_px: f32, ) -> Option<GlyphRasterConfig>

Get raster config for looking up glyphs in fontdue.

Trait Implementations

impl Resource for DynamicGlyphCache

where Self: Send + Sync + 'static,