Struct OutlineGlyphs 

pub struct OutlineGlyphs<'a> {
    font: &'a Font,
    base: Base<'a>,
    varc: Option<&'a Outlines<'a>>,
}

Provides access to the glyph outlines in a font.

The sources used for drawing are selected when this is created. It is cheap to create and copy because it only borrows tables that the font has already parsed.

Fields

font: &'a Font

base: Base<'a>

varc: Option<&'a Outlines<'a>>

Implementations

impl<'a> OutlineGlyphs<'a>

pub(crate) fn new(font: &'a Font, order: GlyphSourceOrder) -> Self

pub fn font(&self) -> &'a Font

Returns the font that contains these outlines.

pub fn source(&self) -> Option<OutlineSource>

Returns the table that provides the outlines.

This is OutlineSource::Varc if VARC composites are drawn. The composites cover only some glyphs, and the rest come from the underlying_source. Returns None if the font has no outlines from the requested sources.

pub fn underlying_source(&self) -> Option<OutlineSource>

Returns the table that draws the glyphs VARC does not cover and the components of those it does.

This is the same as source unless VARC composites are drawn, and is never OutlineSource::Varc. Returns None if the font has no outlines from the requested sources.

pub(crate) fn has_varc(&self) -> bool

Returns true if VARC composites are drawn.

pub(crate) fn varc_covers(&self, glyph: GlyphId) -> bool

Returns true if glyph is drawn as a VARC composite.

pub fn is_empty(&self) -> bool

Returns true if the font has no outlines from the requested sources.

pub fn len(&self) -> u32

Returns the number of glyphs in the font.

Returns zero if the font has no outlines from the requested sources.

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

Returns the outline for glyph, or None if it has no outline or its data in the base source cannot be read.

If VARC is enabled and the table covers the glyph, this returns a VARC composite. Otherwise, the outline comes from the base source. A composite that is malformed or nests past the recursion or edge limits returns an error when it is drawn.

fn get_base(&self, glyph: GlyphId) -> Option<OutlineGlyph<'a>>

Returns the outline for glyph from the base source only.

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

Returns an iterator over every glyph that has an outline, in glyph identifier order.

pub(super) fn draw_base( &self, glyph: GlyphId, coords: &[F2Dot14], options: &DrawOptions, precision: Precision, buf: &mut [u8], sink: &mut dyn PathSink, ) -> Result<(), Error>

Draws glyph from the base source at coords.

This is used for the components of a composite. The coords may differ from the font’s location.

pub(super) fn base_buffer_size(&self, glyph: GlyphId) -> usize

Returns the size in bytes of the working memory needed to draw glyph from the base source.

Trait Implementations

impl<'a> Clone for OutlineGlyphs<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for OutlineGlyphs<'a>

impl<'yoke> Yokeable<'yoke> for OutlineGlyphs<'static>

type Output = OutlineGlyphs<'yoke>

This type MUST be Self with the 'static replaced with 'a, i.e. Self<'a>

fn transform(&'yoke self) -> &'yoke Self::Output

This method must cast self between &'a Self<'static> and &'a Self<'a>.

fn transform_owned(self) -> Self::Output

This method must cast self between Self<'static> and Self<'a>.

unsafe fn make(from: Self::Output) -> Self

This method can be used to cast away Self<'a>’s lifetime.

fn transform_mut<F>(&'yoke mut self, f: F)

where F: 'static + for<'_yoke> FnOnce(&'_yoke mut Self::Output),

This method must cast self between &'a mut Self<'static> and &'a mut Self<'a>, and pass it to f.