Struct TextAtlasFrame

pub struct TextAtlasFrame<'a> { /* private fields */ }

Scoped atlas access for one frame (pins pages until drop).

Dropping the guard calls finish_frame, unpinning every page. The guard’s mutable borrow prevents other atlas access during the frame.

Examples

use ailloli_ui_render_wgpu::text::TextAtlasFrame;
let _: usize = std::mem::size_of::<TextAtlasFrame<'static>>();

Implementations

impl<'a> TextAtlasFrame<'a>

pub fn get_or_rasterize( &mut self, device: &Device, queue: &Queue, bind_group_layout: &BindGroupLayout, key: GlyphKey, font_data: &[u8], ) -> Option<(u8, Glyph)>

Looks up or rasterizes a glyph and pins its page until this guard drops.

Returns None for invalid font data, a missing glyph image, an oversized allocation, or when all pages are pinned and full.

Examples

use ailloli_ui_render_wgpu::text::{GlyphKey, TextAtlasFrame};
fn lookup(frame: &mut TextAtlasFrame<'_>, device: &wgpu::Device,
    queue: &wgpu::Queue, layout: &wgpu::BindGroupLayout, font: &[u8], key: GlyphKey) {
    let _glyph: Option<(u8, ailloli_ui_render_wgpu::text::Glyph)> =
        frame.get_or_rasterize(device, queue, layout, key, font);
}

pub fn record_missing_face(&mut self)

Records one glyph skipped because its face bytes were unavailable.

Examples

use ailloli_ui_render_wgpu::text::TextAtlasFrame;
fn missing(frame: &mut TextAtlasFrame<'_>) { frame.record_missing_face(); }

pub fn stats(&self) -> TextAtlasStats

Returns current per-frame counters and allocated page count.

Examples

use ailloli_ui_render_wgpu::text::{TextAtlasFrame, TextAtlasStats};
fn stats(frame: &TextAtlasFrame<'_>) -> TextAtlasStats { frame.stats() }

Trait Implementations

impl Drop for TextAtlasFrame<'_>

fn drop(&mut self)

Executes the destructor for this type.