Struct OutlineTables 

pub struct OutlineTables<'a> {
    pub glyf: Glyf<'a>,
    pub loca: Loca<'a>,
    pub gvar: Option<SelectedGvar<'a>>,
    pub hmtx: Option<GlyphMetricRecords<'a>>,
    pub os2: Option<Os2<'a>>,
    pub hvar: Option<Hvar<'a>>,
    pub units_per_em: u16,
    pub(super) coords: &'a [F2Dot14],
    pub(super) gvar_scalars: &'a [Fixed],
}

An OutlineContext that reads the tables from a font.

new reads at the default instance and at selects a location. Nothing is cached between glyphs; a caller reading many glyphs at one location is better served by a context that caches.

Fields

glyf: Glyf<'a>

Glyph outlines.

loca: Loca<'a>

The index into Self::glyf.

gvar: Option<SelectedGvar<'a>>

Glyph variations, absent if the font does not vary.

hmtx: Option<GlyphMetricRecords<'a>>

Source of the metrics for the first two phantom points.

os2: Option<Os2<'a>>

Supplies the ascender and descender for the last two.

hvar: Option<Hvar<'a>>

Only its presence is read: it changes how deltas apply to phantom points.

units_per_em: u16

Design units per em, from head.

coords: &'a [F2Dot14]

Not public, with gvar_scalars: the two are only correct together, and at is what keeps them so.

gvar_scalars: &'a [Fixed]

Implementations

impl<'a> OutlineTables<'a>

pub fn new(font: &impl TableProvider<'a>) -> Result<Self, ReadError>

Reads the tables from a font.

Fails if glyf, loca or head is missing or malformed. The rest are optional: without gvar the font is treated as non-variable, and without hmtx or OS/2 the corresponding phantom point metrics are zero.

pub fn at(self, coords: &'a [F2Dot14], gvar_scalars: &'a [Fixed]) -> Self

Reads at coords instead of the default instance.

gvar_scalars are the shared tuple scalars for coords, from SelectedGvar::compute_scalars; pass &[] to compute them per glyph instead. They are taken together because scalars for another location produce wrong deltas and nothing can detect it.

Trait Implementations

impl<'a> Clone for OutlineTables<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> OutlineContext<'a> for OutlineTables<'a>

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

Returns the glyph with the given identifier, or None if it is empty.

fn glyph_variation_data(&self, glyph: GlyphId) -> Option<GlyphVariationData<'a>>

Variation data for a glyph, or None if the font does not vary or the glyph has none.

fn has_gvar(&self) -> bool

True if the font has a gvar table, whatever any one glyph has in it.

fn phantom_point_deltas(&self, glyph: GlyphId) -> Option<[Point<Fixed>; 4]>

Variation deltas for a glyph’s four phantom points.

fn coords(&self) -> &[F2Dot14]

Normalized variation coordinates, empty for the default instance.

fn gvar_scalars(&self) -> &[Fixed]

Scalars for gvar’s shared tuples at Self::coords, as SelectedGvar::compute_scalars fills them.

fn units_per_em(&self) -> u16

Design units per em.

fn h_metrics(&self, glyph: GlyphId) -> (i32, i32)

Left side bearing and advance width, in font units.

fn h_line_metrics(&self) -> (i32, i32)

The ascender and descender of the line horizontal text sits on, in font units.

fn has_hvar(&self) -> bool

True if the font has an HVAR table.

fn v_metrics(&self, glyph: GlyphId) -> Option<(i32, i32)>

Top side bearing and vertical advance for a glyph, in font units.