Struct GlyphMetricRecords 

pub struct GlyphMetricRecords<'a> {
    pub(crate) metrics: &'a [LongMetric],
    pub(crate) bearings: &'a [BigEndian<i16>],
}

Unvaried per-glyph records from HMTX/hmtx or VMTX/vmtx.

Both tables hold the same records, so one type reads either, and which direction it describes is fixed when it is read.

Obtain these through TableProvider::h_glyph_metric_records or TableProvider::v_glyph_metric_records. Uppercase tables are selected independently of the outlines, with the original tables used if they are absent. Nothing here depends on a location, so every location shares one parse.

Fields

metrics: &'a [LongMetric]

bearings: &'a [BigEndian<i16>]

Bare side bearings after the last long metric.

Implementations

impl<'a> GlyphMetricRecords<'a>

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

Returns true if the table states no metrics.

fn run<'o, V: 'o>( &self, num_glyphs: u32, convert: impl Fn(F48Dot16) -> V, glyphs: impl Iterator<Item = (GlyphId, &'o mut V)>, )

Writes the table’s value for each glyph.

A stored advance is a u16, so this needs neither the saturating sum nor the lower bound of run_varied.

fn run_varied<'o, V: 'o>( &self, num_glyphs: u32, delta: impl Fn(GlyphId) -> F48Dot16, convert: impl Fn(F48Dot16) -> V, glyphs: impl Iterator<Item = (GlyphId, &'o mut V)>, )

Writes each glyph’s advance with delta applied.

delta is settled before the run, leaving only the branches that turn on the glyph. The sum saturates rather than wrapping, and is clamped to zero before conversion or scaling.

Glyphs beyond the end of the font measure zero here, as they do unvaried.

pub(crate) fn stated_advance(&self, num_glyphs: u32, glyph: GlyphId) -> F48Dot16

Returns the advance the table states for glyph, before any location.

A glyph past the end of the font advances by nothing. The last record covers every glyph after it, and clamping the index rather than falling back on a failed lookup keeps that bound provable, so a run compiles without a branch per glyph.

self.metrics is never empty here: a caller settles that font before the run starts.

pub(crate) fn stated_side_bearing(&self, glyph: GlyphId) -> Option<F48Dot16>

Returns the side bearing stated for glyph, including the bare bearings following the last long metric.

impl<'a> GlyphMetricRecords<'a>

pub(crate) fn read_horizontal( tables: &(impl TableProvider<'a> + ?Sized), ) -> Result<Self, ReadError>

pub(crate) fn read_vertical( tables: &(impl TableProvider<'a> + ?Sized), ) -> Result<Self, ReadError>

pub fn long_metrics(&self) -> &'a [LongMetric]

Returns the paired advance and side-bearing records.

pub fn side_bearings(&self) -> &'a [BigEndian<i16>]

Returns the side bearings after the last long metric record.

pub fn advance(&self, glyph: GlyphId) -> Option<u16>

Returns the unvaried advance, repeating the last record when needed. This does not check the font’s glyph count.

pub fn side_bearing(&self, glyph: GlyphId) -> Option<i16>

Returns the unvaried leading side bearing for a glyph.

Trait Implementations

impl<'a> Clone for GlyphMetricRecords<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Default for GlyphMetricRecords<'a>

fn default() -> GlyphMetricRecords<'a>

Returns the “default value” for a type.

impl<'a> From<Hmtx<'a>> for GlyphMetricRecords<'a>

fn from(table: Hmtx<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<HmtxExtended<'a>> for GlyphMetricRecords<'a>

fn from(table: HmtxExtended<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Vmtx<'a>> for GlyphMetricRecords<'a>

fn from(table: Vmtx<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<VmtxExtended<'a>> for GlyphMetricRecords<'a>

fn from(table: VmtxExtended<'a>) -> Self

Converts to this type from the input type.