Struct UnicodeCharmap 

pub struct UnicodeCharmap {
    mapping: Vec<(u32, GlyphId)>,
}

A Unicode charmap built from glyph names.

Building one depends on the agl feature.

Fields

mapping: Vec<(u32, GlyphId)>

Implementations

impl UnicodeCharmap

pub fn map(&self, ch: impl Into<u32>) -> Option<GlyphId>

Returns the glyph id for the given character.

A base glyph is preferred, and a variant is used where the font has no base glyph for the character.

pub(crate) fn next_char(&self, ch: u32) -> Option<(u32, GlyphId)>

Returns the first character above ch that has a glyph, and the glyph.

https://gitlab.freedesktop.org/freetype/freetype/-/blob/80a507a6b8e3d2906ad2c8ba69329bd2fb2a85ef/src/psnames/psmodule.c#L456

fn search(&self, ch: u32, wrapping_index: bool) -> (Option<GlyphId>, usize)

Searches for ch as FreeType does, returning the glyph found and the index of the first entry at or above ch.

The search keeps a variant until it finds the base glyph, and after each step predicts the next entry as in a run of consecutive characters. Where several glyphs share a character, the predictions decide which is found. A step below the current entry is a large unsigned step forwards. char_next keeps a 32 bit index, so the step wraps around to the entry below. char_index keeps a pointer, which wraps the same way on 32 bit targets and lands past the end on 64 bit ones, so its results depend on the target.

pub fn iter(&self) -> impl Iterator<Item = (u32, GlyphId)> + Clone + '_

Returns each character and its glyph, in character order.

A variant glyph, such as A.alt, has the high bit set on its character, and follows any base glyph for the character.

Trait Implementations

impl Clone for UnicodeCharmap

fn clone(&self) -> UnicodeCharmap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnicodeCharmap

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

Formats the value using the given formatter.

impl Default for UnicodeCharmap

fn default() -> UnicodeCharmap

Returns the “default value” for a type.