Struct OutlineGlyphCollection

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

Collection of scalable glyph outlines.

Implementations

impl<'a> OutlineGlyphCollection<'a>

pub fn new(font: &FontRef<'a>) -> OutlineGlyphCollection<'a>

Creates a new outline collection for the given font.

pub fn with_format( font: &FontRef<'a>, format: OutlineGlyphFormat, ) -> Option<OutlineGlyphCollection<'a>>

Creates a new outline collection for the given font and outline format.

Returns None if the font does not contain outlines in the requested format.

pub fn format(&self) -> Option<OutlineGlyphFormat>

Returns the underlying format of the source outline tables.

pub fn get(&self, glyph_id: GlyphId) -> Option<OutlineGlyph<'a>>

Returns the outline for the given glyph identifier.

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

Returns an iterator over all of the outline glyphs in the collection.

pub fn prefer_interpreter(&self) -> bool

Returns true if the interpreter engine should be used for hinting this set of outlines.

When this returns false, you likely want to use the automatic hinter instead.

This matches the logic used in FreeType when neither of the FT_LOAD_FORCE_AUTOHINT or FT_LOAD_NO_AUTOHINT load flags are specified.

When setting HintingOptions::engine to Engine::AutoFallback, this is used to determine whether to use the interpreter or automatic hinter.

pub fn require_interpreter(&self) -> bool

Returns true when the interpreter engine must be used for hinting this set of outlines to produce correct results.

This corresponds so FreeType’s FT_FACE_FLAG_TRICKY face flag. See the documentation for that flag for more detail.

When this returns true, you should construct a HintingInstance with HintingOptions::engine set to Engine::Interpreter and HintingOptions::target set to Target::Mono.

Performance

This digs through the name table and potentially computes checksums so it may be slow. You should cache the result of this function if possible.

pub fn fractional_size_hinting(&self) -> bool

Returns true when the font supports hinting at fractional sizes.

When this returns false, the requested size will be rounded before computing the scale factor for hinted glyphs.

Trait Implementations

impl<'a> Clone for OutlineGlyphCollection<'a>

fn clone(&self) -> OutlineGlyphCollection<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for OutlineGlyphCollection<'a>

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

Formats the value using the given formatter.