Struct GlyphAtlas 

pub struct GlyphAtlas { /* private fields */ }

Requested glyph set for symbol text rendering.

Implementations

impl GlyphAtlas

pub fn new() -> Self

Create an empty glyph atlas request set.

pub fn request_text(&mut self, font_stack: &str, text: &str)

Request all glyphs needed to render a text string.

pub fn requested(&self) -> impl Iterator<Item = &GlyphKey>

Iterate requested glyphs.

pub fn len(&self) -> usize

Number of unique requested glyphs.

pub fn is_empty(&self) -> bool

Whether there are no requested glyphs.

pub fn entries(&self) -> impl Iterator<Item = &GlyphAtlasEntry>

Loaded atlas entries.

pub fn get(&self, font_stack: &str, codepoint: char) -> Option<&GlyphAtlasEntry>

Look up a glyph entry by font stack and codepoint.

pub fn alpha(&self) -> &[u8]

Packed alpha bitmap for the atlas.

pub fn dimensions(&self) -> [u16; 2]

Atlas dimensions in pixels.

pub fn render_em_px(&self) -> f32

Pixel size of 1 em as reported by the provider used for the last load_requested call.

pub fn load_requested(&mut self, provider: &dyn GlyphProvider)

Load all requested glyphs into a packed atlas using a glyph provider.

Each glyph is rasterized by the provider, then converted to a signed distance field (SDF) with [SDF_BUFFER] pixels of padding. The resulting atlas can be used directly with an SDF text shader.

Trait Implementations

impl Clone for GlyphAtlas

fn clone(&self) -> GlyphAtlas

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GlyphAtlas

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GlyphAtlas

fn default() -> Self

Returns the “default value” for a type.