Struct read_fonts::TableRef

pub struct TableRef<'a, T> { /* private fields */ }

Typed access to raw table data.

Implementations

impl<'a> TableRef<'a, GdefMarker>

pub fn version(&self) -> MajorMinor

The major/minor version of the GDEF table

pub fn glyph_class_def_offset(&self) -> Nullable<Offset16>

Offset to class definition table for glyph type, from beginning of GDEF header (may be NULL)

pub fn glyph_class_def(&self) -> Option<Result<ClassDef<'a>, ReadError>>

Attempt to resolve glyph_class_def_offset.

pub fn attach_list_offset(&self) -> Nullable<Offset16>

Offset to attachment point list table, from beginning of GDEF header (may be NULL)

pub fn attach_list(&self) -> Option<Result<AttachList<'a>, ReadError>>

Attempt to resolve attach_list_offset.

pub fn lig_caret_list_offset(&self) -> Nullable<Offset16>

Offset to ligature caret list table, from beginning of GDEF header (may be NULL)

pub fn lig_caret_list(&self) -> Option<Result<LigCaretList<'a>, ReadError>>

Attempt to resolve lig_caret_list_offset.

pub fn mark_attach_class_def_offset(&self) -> Nullable<Offset16>

Offset to class definition table for mark attachment type, from beginning of GDEF header (may be NULL)

pub fn mark_attach_class_def(&self) -> Option<Result<ClassDef<'a>, ReadError>>

Attempt to resolve mark_attach_class_def_offset.

pub fn mark_glyph_sets_def_offset(&self) -> Option<Nullable<Offset16>>

Offset to the table of mark glyph set definitions, from beginning of GDEF header (may be NULL)

pub fn mark_glyph_sets_def(
    &self
) -> Option<Result<MarkGlyphSets<'a>, ReadError>>

Attempt to resolve mark_glyph_sets_def_offset.

pub fn item_var_store_offset(&self) -> Option<Nullable<Offset32>>

Offset to the Item Variation Store table, from beginning of GDEF header (may be NULL)

pub fn item_var_store(&self) -> Option<Result<ClassDef<'a>, ReadError>>

Attempt to resolve item_var_store_offset.

impl<'a> TableRef<'a, AttachListMarker>

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table - from beginning of AttachList table

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn glyph_count(&self) -> u16

Number of glyphs with attachment points

pub fn attach_point_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to AttachPoint tables-from beginning of AttachList table-in Coverage Index order

pub fn attach_points(
    &self
) -> impl Iterator<Item = Result<AttachPoint<'a>, ReadError>> + 'a

Attempt to resolve attach_point_offsets.

impl<'a> TableRef<'a, AttachPointMarker>

pub fn point_count(&self) -> u16

Number of attachment points on this glyph

pub fn point_indices(&self) -> &'a [BigEndian<u16>]

Array of contour point indices -in increasing numerical order

impl<'a> TableRef<'a, LigCaretListMarker>

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table - from beginning of LigCaretList table

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn lig_glyph_count(&self) -> u16

Number of ligature glyphs

pub fn lig_glyph_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to LigGlyph tables, from beginning of LigCaretList table —in Coverage Index order

pub fn lig_glyphs(
    &self
) -> impl Iterator<Item = Result<LigGlyph<'a>, ReadError>> + 'a

Attempt to resolve lig_glyph_offsets.

impl<'a> TableRef<'a, LigGlyphMarker>

pub fn caret_count(&self) -> u16

Number of CaretValue tables for this ligature (components - 1)

pub fn caret_value_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to CaretValue tables, from beginning of LigGlyph table — in increasing coordinate order

pub fn caret_values(
    &self
) -> impl Iterator<Item = Result<CaretValue<'a>, ReadError>> + 'a

Attempt to resolve caret_value_offsets.

impl<'a> TableRef<'a, CaretValueFormat1Marker>

pub fn caret_value_format(&self) -> u16

Format identifier: format = 1

pub fn coordinate(&self) -> i16

X or Y value, in design units

impl<'a> TableRef<'a, CaretValueFormat2Marker>

pub fn caret_value_format(&self) -> u16

Format identifier: format = 2

pub fn caret_value_point_index(&self) -> u16

Contour point index on glyph

impl<'a> TableRef<'a, CaretValueFormat3Marker>

pub fn caret_value_format(&self) -> u16

Format identifier-format = 3

pub fn coordinate(&self) -> i16

X or Y value, in design units

pub fn device_offset(&self) -> Offset16

Offset to Device table (non-variable font) / Variation Index table (variable font) for X or Y value-from beginning of CaretValue table

pub fn device(&self) -> Result<Device<'a>, ReadError>

Attempt to resolve device_offset.

impl<'a> TableRef<'a, MarkGlyphSetsMarker>

pub fn format(&self) -> u16

Format identifier == 1

pub fn mark_glyph_set_count(&self) -> u16

Number of mark glyph sets defined

pub fn coverage_offsets(&self) -> &'a [BigEndian<Offset32>]

Array of offsets to mark glyph set coverage tables, from the start of the MarkGlyphSets table.

pub fn coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve coverage_offsets.

impl<'a> TableRef<'a, GposMarker>

pub fn version(&self) -> MajorMinor

The major and minor version of the GPOS table, as a tuple (u16, u16)

pub fn script_list_offset(&self) -> Offset16

Offset to ScriptList table, from beginning of GPOS table

pub fn script_list(&self) -> Result<ScriptList<'a>, ReadError>

Attempt to resolve script_list_offset.

pub fn feature_list_offset(&self) -> Offset16

Offset to FeatureList table, from beginning of GPOS table

pub fn feature_list(&self) -> Result<FeatureList<'a>, ReadError>

Attempt to resolve feature_list_offset.

pub fn lookup_list_offset(&self) -> Offset16

Offset to LookupList table, from beginning of GPOS table

pub fn lookup_list(&self) -> Result<PositionLookupList<'a>, ReadError>

Attempt to resolve lookup_list_offset.

pub fn feature_variations_offset(&self) -> Option<Nullable<Offset32>>

pub fn feature_variations(
    &self
) -> Option<Result<FeatureVariations<'a>, ReadError>>

Attempt to resolve feature_variations_offset.

impl<'a> TableRef<'a, AnchorFormat1Marker>

pub fn anchor_format(&self) -> u16

Format identifier, = 1

pub fn x_coordinate(&self) -> i16

Horizontal value, in design units

pub fn y_coordinate(&self) -> i16

Vertical value, in design units

impl<'a> TableRef<'a, AnchorFormat2Marker>

pub fn anchor_format(&self) -> u16

Format identifier, = 2

pub fn x_coordinate(&self) -> i16

Horizontal value, in design units

pub fn y_coordinate(&self) -> i16

Vertical value, in design units

pub fn anchor_point(&self) -> u16

Index to glyph contour point

impl<'a> TableRef<'a, AnchorFormat3Marker>

pub fn anchor_format(&self) -> u16

Format identifier, = 3

pub fn x_coordinate(&self) -> i16

Horizontal value, in design units

pub fn y_coordinate(&self) -> i16

Vertical value, in design units

pub fn x_device_offset(&self) -> Nullable<Offset16>

Offset to Device table (non-variable font) / VariationIndex table (variable font) for X coordinate, from beginning of Anchor table (may be NULL)

pub fn x_device(&self) -> Option<Result<Device<'a>, ReadError>>

Attempt to resolve x_device_offset.

pub fn y_device_offset(&self) -> Nullable<Offset16>

Offset to Device table (non-variable font) / VariationIndex table (variable font) for Y coordinate, from beginning of Anchor table (may be NULL)

pub fn y_device(&self) -> Option<Result<Device<'a>, ReadError>>

Attempt to resolve y_device_offset.

impl<'a> TableRef<'a, MarkArrayMarker>

pub fn mark_count(&self) -> u16

Number of MarkRecords

pub fn mark_records(&self) -> &'a [MarkRecord]

Array of MarkRecords, ordered by corresponding glyphs in the associated mark Coverage table.

impl<'a> TableRef<'a, SinglePosFormat1Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of SinglePos subtable.

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn value_format(&self) -> ValueFormat

Defines the types of data in the ValueRecord.

pub fn value_record(&self) -> ValueRecord

Defines positioning value(s) — applied to all glyphs in the Coverage table.

impl<'a> TableRef<'a, SinglePosFormat2Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 2

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of SinglePos subtable.

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn value_format(&self) -> ValueFormat

Defines the types of data in the ValueRecords.

pub fn value_count(&self) -> u16

Number of ValueRecords — must equal glyphCount in the Coverage table.

pub fn value_records(&self) -> ComputedArray<'a, ValueRecord>

Array of ValueRecords — positioning values applied to glyphs.

impl<'a> TableRef<'a, PairPosFormat1Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of PairPos subtable.

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn value_format1(&self) -> ValueFormat

Defines the types of data in valueRecord1 — for the first glyph in the pair (may be zero).

pub fn value_format2(&self) -> ValueFormat

Defines the types of data in valueRecord2 — for the second glyph in the pair (may be zero).

pub fn pair_set_count(&self) -> u16

Number of PairSet tables

pub fn pair_set_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to PairSet tables. Offsets are from beginning of PairPos subtable, ordered by Coverage Index.

pub fn pair_sets(
    &self
) -> impl Iterator<Item = Result<PairSet<'a>, ReadError>> + 'a

Attempt to resolve pair_set_offsets.

impl<'a> TableRef<'a, PairSetMarker>

pub fn pair_value_count(&self) -> u16

Number of PairValueRecords

pub fn pair_value_records(&self) -> ComputedArray<'a, PairValueRecord>

Array of PairValueRecords, ordered by glyph ID of the second glyph.

impl<'a> TableRef<'a, PairPosFormat2Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 2

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of PairPos subtable.

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn value_format1(&self) -> ValueFormat

ValueRecord definition — for the first glyph of the pair (may be zero).

pub fn value_format2(&self) -> ValueFormat

ValueRecord definition — for the second glyph of the pair (may be zero).

pub fn class_def1_offset(&self) -> Offset16

Offset to ClassDef table, from beginning of PairPos subtable — for the first glyph of the pair.

pub fn class_def1(&self) -> Result<ClassDef<'a>, ReadError>

Attempt to resolve class_def1_offset.

pub fn class_def2_offset(&self) -> Offset16

Offset to ClassDef table, from beginning of PairPos subtable — for the second glyph of the pair.

pub fn class_def2(&self) -> Result<ClassDef<'a>, ReadError>

Attempt to resolve class_def2_offset.

pub fn class1_count(&self) -> u16

Number of classes in classDef1 table — includes Class 0.

pub fn class2_count(&self) -> u16

Number of classes in classDef2 table — includes Class 0.

pub fn class1_records(&self) -> ComputedArray<'a, Class1Record<'a>>

Array of Class1 records, ordered by classes in classDef1.

impl<'a> TableRef<'a, CursivePosFormat1Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of CursivePos subtable.

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn entry_exit_count(&self) -> u16

Number of EntryExit records

pub fn entry_exit_record(&self) -> &'a [EntryExitRecord]

Array of EntryExit records, in Coverage index order.

impl<'a> TableRef<'a, MarkBasePosFormat1Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn mark_coverage_offset(&self) -> Offset16

Offset to markCoverage table, from beginning of MarkBasePos subtable.

pub fn mark_coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve mark_coverage_offset.

pub fn base_coverage_offset(&self) -> Offset16

Offset to baseCoverage table, from beginning of MarkBasePos subtable.

pub fn base_coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve base_coverage_offset.

pub fn mark_class_count(&self) -> u16

Number of classes defined for marks

pub fn mark_array_offset(&self) -> Offset16

Offset to MarkArray table, from beginning of MarkBasePos subtable.

pub fn mark_array(&self) -> Result<MarkArray<'a>, ReadError>

Attempt to resolve mark_array_offset.

pub fn base_array_offset(&self) -> Offset16

Offset to BaseArray table, from beginning of MarkBasePos subtable.

pub fn base_array(&self) -> Result<BaseArray<'a>, ReadError>

Attempt to resolve base_array_offset.

impl<'a> TableRef<'a, BaseArrayMarker>

pub fn base_count(&self) -> u16

Number of BaseRecords

pub fn base_records(&self) -> ComputedArray<'a, BaseRecord<'a>>

Array of BaseRecords, in order of baseCoverage Index.

impl<'a> TableRef<'a, MarkLigPosFormat1Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn mark_coverage_offset(&self) -> Offset16

Offset to markCoverage table, from beginning of MarkLigPos subtable.

pub fn mark_coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve mark_coverage_offset.

pub fn ligature_coverage_offset(&self) -> Offset16

Offset to ligatureCoverage table, from beginning of MarkLigPos subtable.

pub fn ligature_coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve ligature_coverage_offset.

pub fn mark_class_count(&self) -> u16

Number of defined mark classes

pub fn mark_array_offset(&self) -> Offset16

Offset to MarkArray table, from beginning of MarkLigPos subtable.

pub fn mark_array(&self) -> Result<MarkArray<'a>, ReadError>

Attempt to resolve mark_array_offset.

pub fn ligature_array_offset(&self) -> Offset16

Offset to LigatureArray table, from beginning of MarkLigPos subtable.

pub fn ligature_array(&self) -> Result<LigatureArray<'a>, ReadError>

Attempt to resolve ligature_array_offset.

impl<'a> TableRef<'a, LigatureArrayMarker>

pub fn ligature_count(&self) -> u16

Number of LigatureAttach table offsets

pub fn ligature_attach_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to LigatureAttach tables. Offsets are from beginning of LigatureArray table, ordered by ligatureCoverage index.

pub fn ligature_attaches(
    &self
) -> impl Iterator<Item = Result<LigatureAttach<'a>, ReadError>> + 'a

Attempt to resolve ligature_attach_offsets.

impl<'a> TableRef<'a, LigatureAttachMarker>

pub fn component_count(&self) -> u16

Number of ComponentRecords in this ligature

pub fn component_records(&self) -> ComputedArray<'a, ComponentRecord<'a>>

Array of Component records, ordered in writing direction.

impl<'a> TableRef<'a, MarkMarkPosFormat1Marker>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn mark1_coverage_offset(&self) -> Offset16

Offset to Combining Mark Coverage table, from beginning of MarkMarkPos subtable.

pub fn mark1_coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve mark1_coverage_offset.

pub fn mark2_coverage_offset(&self) -> Offset16

Offset to Base Mark Coverage table, from beginning of MarkMarkPos subtable.

pub fn mark2_coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve mark2_coverage_offset.

pub fn mark_class_count(&self) -> u16

Number of Combining Mark classes defined

pub fn mark1_array_offset(&self) -> Offset16

Offset to MarkArray table for mark1, from beginning of MarkMarkPos subtable.

pub fn mark1_array(&self) -> Result<MarkArray<'a>, ReadError>

Attempt to resolve mark1_array_offset.

pub fn mark2_array_offset(&self) -> Offset16

Offset to Mark2Array table for mark2, from beginning of MarkMarkPos subtable.

pub fn mark2_array(&self) -> Result<Mark2Array<'a>, ReadError>

Attempt to resolve mark2_array_offset.

impl<'a> TableRef<'a, Mark2ArrayMarker>

pub fn mark2_count(&self) -> u16

Number of Mark2 records

pub fn mark2_records(&self) -> ComputedArray<'a, Mark2Record<'a>>

Array of Mark2Records, in Coverage order.

impl<'a, T> TableRef<'a, ExtensionPosFormat1Marker<T>>

pub fn pos_format(&self) -> u16

Format identifier: format = 1

pub fn extension_lookup_type(&self) -> u16

Lookup type of subtable referenced by extensionOffset (i.e. the extension subtable).

pub fn extension_offset(&self) -> Offset32

Offset to the extension subtable, of lookup type extensionLookupType, relative to the start of the ExtensionPosFormat1 subtable.

pub fn extension(&self) -> Result<T, ReadError>where
    T: FontRead<'a>,

Attempt to resolve extension_offset.

impl<'a> TableRef<'a, GsubMarker>

pub fn version(&self) -> MajorMinor

The major and minor version of the GSUB table, as a tuple (u16, u16)

pub fn script_list_offset(&self) -> Offset16

Offset to ScriptList table, from beginning of GSUB table

pub fn script_list(&self) -> Result<ScriptList<'a>, ReadError>

Attempt to resolve script_list_offset.

pub fn feature_list_offset(&self) -> Offset16

Offset to FeatureList table, from beginning of GSUB table

pub fn feature_list(&self) -> Result<FeatureList<'a>, ReadError>

Attempt to resolve feature_list_offset.

pub fn lookup_list_offset(&self) -> Offset16

Offset to LookupList table, from beginning of GSUB table

pub fn lookup_list(&self) -> Result<SubstitutionLookupList<'a>, ReadError>

Attempt to resolve lookup_list_offset.

pub fn feature_variations_offset(&self) -> Option<Nullable<Offset32>>

Offset to FeatureVariations table, from beginning of the GSUB table (may be NULL)

pub fn feature_variations(
    &self
) -> Option<Result<FeatureVariations<'a>, ReadError>>

Attempt to resolve feature_variations_offset.

impl<'a> TableRef<'a, SingleSubstFormat1Marker>

pub fn subst_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of substitution subtable

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn delta_glyph_id(&self) -> i16

Add to original glyph ID to get substitute glyph ID

impl<'a> TableRef<'a, SingleSubstFormat2Marker>

pub fn subst_format(&self) -> u16

Format identifier: format = 2

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of substitution subtable

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn glyph_count(&self) -> u16

Number of glyph IDs in the substituteGlyphIDs array

pub fn substitute_glyph_ids(&self) -> &'a [BigEndian<GlyphId>]

Array of substitute glyph IDs — ordered by Coverage index

impl<'a> TableRef<'a, MultipleSubstFormat1Marker>

pub fn subst_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of substitution subtable

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn sequence_count(&self) -> u16

Number of Sequence table offsets in the sequenceOffsets array

pub fn sequence_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to Sequence tables. Offsets are from beginning of substitution subtable, ordered by Coverage index

pub fn sequences(
    &self
) -> impl Iterator<Item = Result<Sequence<'a>, ReadError>> + 'a

Attempt to resolve sequence_offsets.

impl<'a> TableRef<'a, SequenceMarker>

pub fn glyph_count(&self) -> u16

Number of glyph IDs in the substituteGlyphIDs array. This must always be greater than 0.

pub fn substitute_glyph_ids(&self) -> &'a [BigEndian<GlyphId>]

String of glyph IDs to substitute

impl<'a> TableRef<'a, AlternateSubstFormat1Marker>

pub fn subst_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of substitution subtable

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn alternate_set_count(&self) -> u16

Number of AlternateSet tables

pub fn alternate_set_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to AlternateSet tables. Offsets are from beginning of substitution subtable, ordered by Coverage index

pub fn alternate_sets(
    &self
) -> impl Iterator<Item = Result<AlternateSet<'a>, ReadError>> + 'a

Attempt to resolve alternate_set_offsets.

impl<'a> TableRef<'a, AlternateSetMarker>

pub fn glyph_count(&self) -> u16

Number of glyph IDs in the alternateGlyphIDs array

pub fn alternate_glyph_ids(&self) -> &'a [BigEndian<GlyphId>]

Array of alternate glyph IDs, in arbitrary order

impl<'a> TableRef<'a, LigatureSubstFormat1Marker>

pub fn subst_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of substitution subtable

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn ligature_set_count(&self) -> u16

Number of LigatureSet tables

pub fn ligature_set_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to LigatureSet tables. Offsets are from beginning of substitution subtable, ordered by Coverage index

pub fn ligature_sets(
    &self
) -> impl Iterator<Item = Result<LigatureSet<'a>, ReadError>> + 'a

Attempt to resolve ligature_set_offsets.

impl<'a> TableRef<'a, LigatureSetMarker>

pub fn ligature_count(&self) -> u16

Number of Ligature tables

pub fn ligature_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to Ligature tables. Offsets are from beginning of LigatureSet table, ordered by preference.

pub fn ligatures(
    &self
) -> impl Iterator<Item = Result<Ligature<'a>, ReadError>> + 'a

Attempt to resolve ligature_offsets.

impl<'a> TableRef<'a, LigatureMarker>

pub fn ligature_glyph(&self) -> GlyphId

glyph ID of ligature to substitute

pub fn component_count(&self) -> u16

Number of components in the ligature

pub fn component_glyph_ids(&self) -> &'a [BigEndian<GlyphId>]

Array of component glyph IDs — start with the second component, ordered in writing direction

impl<'a, T> TableRef<'a, ExtensionSubstFormat1Marker<T>>

pub fn subst_format(&self) -> u16

Format identifier. Set to 1.

pub fn extension_lookup_type(&self) -> u16

Lookup type of subtable referenced by extensionOffset (that is, the extension subtable).

pub fn extension_offset(&self) -> Offset32

Offset to the extension subtable, of lookup type extensionLookupType, relative to the start of the ExtensionSubstFormat1 subtable.

pub fn extension(&self) -> Result<T, ReadError>where
    T: FontRead<'a>,

Attempt to resolve extension_offset.

impl<'a> TableRef<'a, ReverseChainSingleSubstFormat1Marker>

pub fn subst_format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of substitution subtable.

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn backtrack_glyph_count(&self) -> u16

Number of glyphs in the backtrack sequence.

pub fn backtrack_coverage_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to coverage tables in backtrack sequence, in glyph sequence order.

pub fn backtrack_coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve backtrack_coverage_offsets.

pub fn lookahead_glyph_count(&self) -> u16

Number of glyphs in lookahead sequence.

pub fn lookahead_coverage_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to coverage tables in lookahead sequence, in glyph sequence order.

pub fn lookahead_coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve lookahead_coverage_offsets.

pub fn glyph_count(&self) -> u16

Number of glyph IDs in the substituteGlyphIDs array.

pub fn substitute_glyph_ids(&self) -> &'a [BigEndian<GlyphId>]

Array of substitute glyph IDs — ordered by Coverage index.

impl<'a> TableRef<'a, ScriptListMarker>

pub fn script_count(&self) -> u16

Number of ScriptRecords

pub fn script_records(&self) -> &'a [ScriptRecord]

Array of ScriptRecords, listed alphabetically by script tag

impl<'a> TableRef<'a, ScriptMarker>

pub fn default_lang_sys_offset(&self) -> Nullable<Offset16>

Offset to default LangSys table, from beginning of Script table — may be NULL

pub fn default_lang_sys(&self) -> Option<Result<LangSys<'a>, ReadError>>

Attempt to resolve default_lang_sys_offset.

pub fn lang_sys_count(&self) -> u16

Number of LangSysRecords for this script — excluding the default LangSys

pub fn lang_sys_records(&self) -> &'a [LangSysRecord]

Array of LangSysRecords, listed alphabetically by LangSys tag

impl<'a> TableRef<'a, LangSysMarker>

pub fn required_feature_index(&self) -> u16

Index of a feature required for this language system; if no required features = 0xFFFF

pub fn feature_index_count(&self) -> u16

Number of feature index values for this language system — excludes the required feature

pub fn feature_indices(&self) -> &'a [BigEndian<u16>]

Array of indices into the FeatureList, in arbitrary order

impl<'a> TableRef<'a, FeatureListMarker>

pub fn feature_count(&self) -> u16

Number of FeatureRecords in this table

pub fn feature_records(&self) -> &'a [FeatureRecord]

Array of FeatureRecords — zero-based (first feature has FeatureIndex = 0), listed alphabetically by feature tag

impl<'a> TableRef<'a, FeatureMarker>

pub fn feature_params_offset(&self) -> Nullable<Offset16>

Offset from start of Feature table to FeatureParams table, if defined for the feature and present, else NULL

pub fn feature_params(&self) -> Option<Result<FeatureParams<'a>, ReadError>>

Attempt to resolve feature_params_offset.

pub fn lookup_index_count(&self) -> u16

Number of LookupList indices for this feature

pub fn lookup_list_indices(&self) -> &'a [BigEndian<u16>]

Array of indices into the LookupList — zero-based (first lookup is LookupListIndex = 0)

impl<'a, T> TableRef<'a, LookupListMarker<T>>

pub fn lookup_count(&self) -> u16

Number of lookups in this table

pub fn lookup_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to Lookup tables, from beginning of LookupList — zero based (first lookup is Lookup index = 0)

pub fn lookups(&self) -> impl Iterator<Item = Result<T, ReadError>> + 'awhere
    T: FontRead<'a>,

Attempt to resolve lookup_offsets.

impl<'a, T> TableRef<'a, LookupMarker<T>>

pub fn lookup_type(&self) -> u16

Different enumerations for GSUB and GPOS

pub fn lookup_flag(&self) -> u16

Lookup qualifiers

pub fn sub_table_count(&self) -> u16

Number of subtables for this lookup

pub fn subtable_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to lookup subtables, from beginning of Lookup table

pub fn subtables(&self) -> impl Iterator<Item = Result<T, ReadError>> + 'awhere
    T: FontRead<'a>,

Attempt to resolve subtable_offsets.

pub fn mark_filtering_set(&self) -> u16

Index (base 0) into GDEF mark glyph sets structure. This field is only present if the USE_MARK_FILTERING_SET lookup flag is set.

impl<'a> TableRef<'a, CoverageFormat1Marker>

pub fn coverage_format(&self) -> u16

Format identifier — format = 1

pub fn glyph_count(&self) -> u16

Number of glyphs in the glyph array

pub fn glyph_array(&self) -> &'a [BigEndian<GlyphId>]

Array of glyph IDs — in numerical order

impl<'a> TableRef<'a, CoverageFormat2Marker>

pub fn coverage_format(&self) -> u16

Format identifier — format = 2

pub fn range_count(&self) -> u16

Number of RangeRecords

pub fn range_records(&self) -> &'a [RangeRecord]

Array of glyph ranges — ordered by startGlyphID.

impl<'a> TableRef<'a, ClassDefFormat1Marker>

pub fn class_format(&self) -> u16

Format identifier — format = 1

pub fn start_glyph_id(&self) -> GlyphId

First glyph ID of the classValueArray

pub fn glyph_count(&self) -> u16

Size of the classValueArray

pub fn class_value_array(&self) -> &'a [BigEndian<u16>]

Array of Class Values — one per glyph ID

impl<'a> TableRef<'a, ClassDefFormat2Marker>

pub fn class_format(&self) -> u16

Format identifier — format = 2

pub fn class_range_count(&self) -> u16

Number of ClassRangeRecords

pub fn class_range_records(&self) -> &'a [ClassRangeRecord]

Array of ClassRangeRecords — ordered by startGlyphID

impl<'a> TableRef<'a, SequenceContextFormat1Marker>

pub fn format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of SequenceContextFormat1 table

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn seq_rule_set_count(&self) -> u16

Number of SequenceRuleSet tables

pub fn seq_rule_set_offsets(&self) -> &'a [BigEndian<Nullable<Offset16>>]

Array of offsets to SequenceRuleSet tables, from beginning of SequenceContextFormat1 table (offsets may be NULL)

pub fn seq_rule_sets(
    &self
) -> impl Iterator<Item = Option<Result<SequenceRuleSet<'a>, ReadError>>> + 'a

Attempt to resolve seq_rule_set_offsets.

impl<'a> TableRef<'a, SequenceRuleSetMarker>

pub fn seq_rule_count(&self) -> u16

Number of SequenceRule tables

pub fn seq_rule_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to SequenceRule tables, from beginning of the SequenceRuleSet table

pub fn seq_rules(
    &self
) -> impl Iterator<Item = Result<SequenceRule<'a>, ReadError>> + 'a

Attempt to resolve seq_rule_offsets.

impl<'a> TableRef<'a, SequenceRuleMarker>

pub fn glyph_count(&self) -> u16

Number of glyphs in the input glyph sequence

pub fn seq_lookup_count(&self) -> u16

Number of SequenceLookupRecords

pub fn input_sequence(&self) -> &'a [BigEndian<u16>]

Array of input glyph IDs—starting with the second glyph

pub fn seq_lookup_records(&self) -> &'a [SequenceLookupRecord]

Array of Sequence lookup records

impl<'a> TableRef<'a, SequenceContextFormat2Marker>

pub fn format(&self) -> u16

Format identifier: format = 2

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of SequenceContextFormat2 table

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn class_def_offset(&self) -> Offset16

Offset to ClassDef table, from beginning of SequenceContextFormat2 table

pub fn class_def(&self) -> Result<ClassDef<'a>, ReadError>

Attempt to resolve class_def_offset.

pub fn class_seq_rule_set_count(&self) -> u16

Number of ClassSequenceRuleSet tables

pub fn class_seq_rule_set_offsets(&self) -> &'a [BigEndian<Nullable<Offset16>>]

Array of offsets to ClassSequenceRuleSet tables, from beginning of SequenceContextFormat2 table (may be NULL)

pub fn class_seq_rule_sets(
    &self
) -> impl Iterator<Item = Option<Result<ClassSequenceRuleSet<'a>, ReadError>>> + 'a

Attempt to resolve class_seq_rule_set_offsets.

impl<'a> TableRef<'a, ClassSequenceRuleSetMarker>

pub fn class_seq_rule_count(&self) -> u16

Number of ClassSequenceRule tables

pub fn class_seq_rule_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to ClassSequenceRule tables, from beginning of ClassSequenceRuleSet table

pub fn class_seq_rules(
    &self
) -> impl Iterator<Item = Result<ClassSequenceRule<'a>, ReadError>> + 'a

Attempt to resolve class_seq_rule_offsets.

impl<'a> TableRef<'a, ClassSequenceRuleMarker>

pub fn glyph_count(&self) -> u16

Number of glyphs to be matched

pub fn seq_lookup_count(&self) -> u16

Number of SequenceLookupRecords

pub fn input_sequence(&self) -> &'a [BigEndian<u16>]

Sequence of classes to be matched to the input glyph sequence, beginning with the second glyph position

pub fn seq_lookup_records(&self) -> &'a [SequenceLookupRecord]

Array of SequenceLookupRecords

impl<'a> TableRef<'a, SequenceContextFormat3Marker>

pub fn format(&self) -> u16

Format identifier: format = 3

pub fn glyph_count(&self) -> u16

Number of glyphs in the input sequence

pub fn seq_lookup_count(&self) -> u16

Number of SequenceLookupRecords

pub fn coverage_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to Coverage tables, from beginning of SequenceContextFormat3 subtable

pub fn coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve coverage_offsets.

pub fn seq_lookup_records(&self) -> &'a [SequenceLookupRecord]

Array of SequenceLookupRecords

impl<'a> TableRef<'a, ChainedSequenceContextFormat1Marker>

pub fn format(&self) -> u16

Format identifier: format = 1

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of ChainSequenceContextFormat1 table

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn chained_seq_rule_set_count(&self) -> u16

Number of ChainedSequenceRuleSet tables

pub fn chained_seq_rule_set_offsets(
    &self
) -> &'a [BigEndian<Nullable<Offset16>>]

Array of offsets to ChainedSeqRuleSet tables, from beginning of ChainedSequenceContextFormat1 table (may be NULL)

pub fn chained_seq_rule_sets(
    &self
) -> impl Iterator<Item = Option<Result<ChainedSequenceRuleSet<'a>, ReadError>>> + 'a

Attempt to resolve chained_seq_rule_set_offsets.

impl<'a> TableRef<'a, ChainedSequenceRuleSetMarker>

pub fn chained_seq_rule_count(&self) -> u16

Number of ChainedSequenceRule tables

pub fn chained_seq_rule_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to ChainedSequenceRule tables, from beginning of ChainedSequenceRuleSet table

pub fn chained_seq_rules(
    &self
) -> impl Iterator<Item = Result<ChainedSequenceRule<'a>, ReadError>> + 'a

Attempt to resolve chained_seq_rule_offsets.

impl<'a> TableRef<'a, ChainedSequenceRuleMarker>

pub fn backtrack_glyph_count(&self) -> u16

Number of glyphs in the backtrack sequence

pub fn backtrack_sequence(&self) -> &'a [BigEndian<u16>]

Array of backtrack glyph IDs

pub fn input_glyph_count(&self) -> u16

Number of glyphs in the input sequence

pub fn input_sequence(&self) -> &'a [BigEndian<u16>]

Array of input glyph IDs—start with second glyph

pub fn lookahead_glyph_count(&self) -> u16

Number of glyphs in the lookahead sequence

pub fn lookahead_sequence(&self) -> &'a [BigEndian<u16>]

Array of lookahead glyph IDs

pub fn seq_lookup_count(&self) -> u16

Number of SequenceLookupRecords

pub fn seq_lookup_records(&self) -> &'a [SequenceLookupRecord]

Array of SequenceLookupRecords

impl<'a> TableRef<'a, ChainedSequenceContextFormat2Marker>

pub fn format(&self) -> u16

Format identifier: format = 2

pub fn coverage_offset(&self) -> Offset16

Offset to Coverage table, from beginning of ChainedSequenceContextFormat2 table

pub fn coverage(&self) -> Result<CoverageTable<'a>, ReadError>

Attempt to resolve coverage_offset.

pub fn backtrack_class_def_offset(&self) -> Offset16

Offset to ClassDef table containing backtrack sequence context, from beginning of ChainedSequenceContextFormat2 table

pub fn backtrack_class_def(&self) -> Result<ClassDef<'a>, ReadError>

Attempt to resolve backtrack_class_def_offset.

pub fn input_class_def_offset(&self) -> Offset16

Offset to ClassDef table containing input sequence context, from beginning of ChainedSequenceContextFormat2 table

pub fn input_class_def(&self) -> Result<ClassDef<'a>, ReadError>

Attempt to resolve input_class_def_offset.

pub fn lookahead_class_def_offset(&self) -> Offset16

Offset to ClassDef table containing lookahead sequence context, from beginning of ChainedSequenceContextFormat2 table

pub fn lookahead_class_def(&self) -> Result<ClassDef<'a>, ReadError>

Attempt to resolve lookahead_class_def_offset.

pub fn chained_class_seq_rule_set_count(&self) -> u16

Number of ChainedClassSequenceRuleSet tables

pub fn chained_class_seq_rule_set_offsets(
    &self
) -> &'a [BigEndian<Nullable<Offset16>>]

Array of offsets to ChainedClassSequenceRuleSet tables, from beginning of ChainedSequenceContextFormat2 table (may be NULL)

pub fn chained_class_seq_rule_sets(
    &self
) -> impl Iterator<Item = Option<Result<ChainedClassSequenceRuleSet<'a>, ReadError>>> + 'a

Attempt to resolve chained_class_seq_rule_set_offsets.

impl<'a> TableRef<'a, ChainedClassSequenceRuleSetMarker>

pub fn chained_class_seq_rule_count(&self) -> u16

Number of ChainedClassSequenceRule tables

pub fn chained_class_seq_rule_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to ChainedClassSequenceRule tables, from beginning of ChainedClassSequenceRuleSet

pub fn chained_class_seq_rules(
    &self
) -> impl Iterator<Item = Result<ChainedClassSequenceRule<'a>, ReadError>> + 'a

Attempt to resolve chained_class_seq_rule_offsets.

impl<'a> TableRef<'a, ChainedClassSequenceRuleMarker>

pub fn backtrack_glyph_count(&self) -> u16

Number of glyphs in the backtrack sequence

pub fn backtrack_sequence(&self) -> &'a [BigEndian<u16>]

Array of backtrack-sequence classes

pub fn input_glyph_count(&self) -> u16

Total number of glyphs in the input sequence

pub fn input_sequence(&self) -> &'a [BigEndian<u16>]

Array of input sequence classes, beginning with the second glyph position

pub fn lookahead_glyph_count(&self) -> u16

Number of glyphs in the lookahead sequence

pub fn lookahead_sequence(&self) -> &'a [BigEndian<u16>]

Array of lookahead-sequence classes

pub fn seq_lookup_count(&self) -> u16

Number of SequenceLookupRecords

pub fn seq_lookup_records(&self) -> &'a [SequenceLookupRecord]

Array of SequenceLookupRecords

impl<'a> TableRef<'a, ChainedSequenceContextFormat3Marker>

pub fn format(&self) -> u16

Format identifier: format = 3

pub fn backtrack_glyph_count(&self) -> u16

Number of glyphs in the backtrack sequence

pub fn backtrack_coverage_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to coverage tables for the backtrack sequence

pub fn backtrack_coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve backtrack_coverage_offsets.

pub fn input_glyph_count(&self) -> u16

Number of glyphs in the input sequence

pub fn input_coverage_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to coverage tables for the input sequence

pub fn input_coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve input_coverage_offsets.

pub fn lookahead_glyph_count(&self) -> u16

Number of glyphs in the lookahead sequence

pub fn lookahead_coverage_offsets(&self) -> &'a [BigEndian<Offset16>]

Array of offsets to coverage tables for the lookahead sequence

pub fn lookahead_coverages(
    &self
) -> impl Iterator<Item = Result<CoverageTable<'a>, ReadError>> + 'a

Attempt to resolve lookahead_coverage_offsets.

pub fn seq_lookup_count(&self) -> u16

Number of SequenceLookupRecords

pub fn seq_lookup_records(&self) -> &'a [SequenceLookupRecord]

Array of SequenceLookupRecords

impl<'a> TableRef<'a, DeviceMarker>

pub fn start_size(&self) -> u16

Smallest size to correct, in ppem

pub fn end_size(&self) -> u16

Largest size to correct, in ppem

pub fn delta_format(&self) -> DeltaFormat

Format of deltaValue array data: 0x0001, 0x0002, or 0x0003

pub fn delta_value(&self) -> &'a [BigEndian<u16>]

Array of compressed data

impl<'a> TableRef<'a, VariationIndexMarker>

pub fn delta_set_outer_index(&self) -> u16

A delta-set outer index — used to select an item variation data subtable within the item variation store.

pub fn delta_set_inner_index(&self) -> u16

A delta-set inner index — used to select a delta-set row within an item variation data subtable.

pub fn delta_format(&self) -> u16

Format, = 0x8000

impl<'a> TableRef<'a, FeatureVariationsMarker>

pub fn version(&self) -> MajorMinor

pub fn feature_variation_record_count(&self) -> u32

Number of feature variation records.

pub fn feature_variation_records(&self) -> &'a [FeatureVariationRecord]

Array of feature variation records.

impl<'a> TableRef<'a, ConditionSetMarker>

pub fn condition_count(&self) -> u16

Number of conditions for this condition set.

pub fn condition_offsets(&self) -> &'a [BigEndian<Offset32>]

Array of offsets to condition tables, from beginning of the ConditionSet table.

pub fn conditions(
    &self
) -> impl Iterator<Item = Result<ConditionFormat1<'a>, ReadError>> + 'a

Attempt to resolve condition_offsets.

impl<'a> TableRef<'a, ConditionFormat1Marker>

pub fn format(&self) -> u16

Format, = 1

pub fn axis_index(&self) -> u16

Index (zero-based) for the variation axis within the ‘fvar’ table.

pub fn filter_range_min_value(&self) -> F2Dot14

Minimum value of the font variation instances that satisfy this condition.

pub fn filter_range_max_value(&self) -> F2Dot14

Maximum value of the font variation instances that satisfy this condition.

impl<'a> TableRef<'a, FeatureTableSubstitutionMarker>

pub fn version(&self) -> MajorMinor

Major & minor version of the table: (1, 0)

pub fn substitution_count(&self) -> u16

Number of feature table substitution records.

pub fn substitutions(&self) -> &'a [FeatureTableSubstitutionRecord]

Array of feature table substitution records.

impl<'a> TableRef<'a, SizeParamsMarker>

pub fn design_size(&self) -> u16

The first value represents the design size in 720/inch units (decipoints).

The design size entry must be non-zero. When there is a design size but no recommended size range, the rest of the array will consist of zeros.

pub fn identifier(&self) -> u16

The second value has no independent meaning, but serves as an identifier that associates fonts in a subfamily.

All fonts which share a Typographic or Font Family name and which differ only by size range shall have the same subfamily value, and no fonts which differ in weight or style shall have the same subfamily value. If this value is zero, the remaining fields in the array will be ignored.

pub fn name_entry(&self) -> u16

The third value enables applications to use a single name for the subfamily identified by the second value.

If the preceding value is non-zero, this value must be set in the range 256 – 32767 (inclusive). It records the value of a field in the ‘name’ table, which must contain English-language strings encoded in Windows Unicode and Macintosh Roman, and may contain additional strings localized to other scripts and languages. Each of these strings is the name an application should use, in combination with the family name, to represent the subfamily in a menu. Applications will choose the appropriate version based on their selection criteria.

pub fn range_start(&self) -> u16

The fourth and fifth values represent the small end of the recommended usage range (exclusive) and the large end of the recommended usage range (inclusive), stored in 720/inch units (decipoints).

Ranges must not overlap, and should generally be contiguous.

pub fn range_end(&self) -> u16

impl<'a> TableRef<'a, StylisticSetParamsMarker>

pub fn version(&self) -> u16

pub fn ui_name_id(&self) -> u16

The ‘name’ table name ID that specifies a string (or strings, for multiple languages) for a user-interface label for this feature.

The value of uiLabelNameId is expected to be in the font-specific name ID range (256-32767), though that is not a requirement in this Feature Parameters specification. The user-interface label for the feature can be provided in multiple languages. An English string should be included as a fallback. The string should be kept to a minimal length to fit comfortably with different application interfaces.

impl<'a> TableRef<'a, CharacterVariantParamsMarker>

pub fn format(&self) -> u16

Format number is set to 0.

pub fn feat_ui_label_name_id(&self) -> u16

The ‘name’ table name ID that specifies a string (or strings, for multiple languages) for a user-interface label for this feature. (May be NULL.)

pub fn feat_ui_tooltip_text_name_id(&self) -> u16

The ‘name’ table name ID that specifies a string (or strings, for multiple languages) that an application can use for tooltip text for this feature. (May be NULL.)

pub fn sample_text_name_id(&self) -> u16

The ‘name’ table name ID that specifies sample text that illustrates the effect of this feature. (May be NULL.)

pub fn num_named_parameters(&self) -> u16

Number of named parameters. (May be zero.)

pub fn first_param_ui_label_name_id(&self) -> u16

The first ‘name’ table name ID used to specify strings for user-interface labels for the feature parameters. (Must be zero if numParameters is zero.)

pub fn char_count(&self) -> u16

The count of characters for which this feature provides glyph variants. (May be zero.)

pub fn character(&self) -> &'a [BigEndian<Uint24>]

The Unicode Scalar Value of the characters for which this feature provides glyph variants.

impl<'a, T: FontRead<'a>> TableRef<'a, LookupMarker<T>>

pub fn get_subtable(&self, offset: Offset16) -> Result<T, ReadError>

impl<'a, T> TableRef<'a, T>

pub fn resolve_offset<O: Offset, R: FontRead<'a>>(
    &self,
    offset: O
) -> Result<R, ReadError>

Resolve the provided offset from the start of this table.

pub fn offset_data(&self) -> FontData<'a>

Return a reference to this table’s raw data.

We use this in the compile crate to resolve offsets.

impl<'a> TableRef<'a, CmapMarker>

pub fn version(&self) -> u16

Table version number (0).

pub fn num_tables(&self) -> u16

Number of encoding tables that follow.

pub fn encoding_records(&self) -> &'a [EncodingRecord]

impl<'a> TableRef<'a, Cmap0Marker>

pub fn format(&self) -> u16

Format number is set to 0.

pub fn length(&self) -> u16

This is the length in bytes of the subtable.

pub fn language(&self) -> u16

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn glyph_id_array(&self) -> &'a [BigEndian<u8>]

An array that maps character codes to glyph index values.

impl<'a> TableRef<'a, Cmap2Marker>

pub fn format(&self) -> u16

Format number is set to 2.

pub fn length(&self) -> u16

This is the length in bytes of the subtable.

pub fn language(&self) -> u16

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn sub_header_keys(&self) -> &'a [BigEndian<u16>]

Array that maps high bytes to subHeaders: value is subHeader index × 8.

impl<'a> TableRef<'a, Cmap4Marker>

pub fn format(&self) -> u16

Format number is set to 4.

pub fn length(&self) -> u16

This is the length in bytes of the subtable.

pub fn language(&self) -> u16

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn seg_count_x2(&self) -> u16

2 × segCount.

pub fn search_range(&self) -> u16

Maximum power of 2 less than or equal to segCount, times 2 ((2floor(log2(segCount))) * 2, where “” is an exponentiation operator)

pub fn entry_selector(&self) -> u16

Log2 of the maximum power of 2 less than or equal to numTables (log2(searchRange/2), which is equal to floor(log2(segCount)))

pub fn range_shift(&self) -> u16

segCount times 2, minus searchRange ((segCount * 2) - searchRange)

pub fn end_code(&self) -> &'a [BigEndian<u16>]

End characterCode for each segment, last=0xFFFF.

pub fn start_code(&self) -> &'a [BigEndian<u16>]

Start character code for each segment.

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

Delta for all character codes in segment.

pub fn id_range_offsets(&self) -> &'a [BigEndian<u16>]

Offsets into glyphIdArray or 0

pub fn glyph_id_array(&self) -> &'a [BigEndian<u16>]

Glyph index array (arbitrary length)

impl<'a> TableRef<'a, Cmap6Marker>

pub fn format(&self) -> u16

Format number is set to 6.

pub fn length(&self) -> u16

This is the length in bytes of the subtable.

pub fn language(&self) -> u16

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn first_code(&self) -> u16

First character code of subrange.

pub fn entry_count(&self) -> u16

Number of character codes in subrange.

pub fn glyph_id_array(&self) -> &'a [BigEndian<u16>]

Array of glyph index values for character codes in the range.

impl<'a> TableRef<'a, Cmap8Marker>

pub fn format(&self) -> u16

Subtable format; set to 8.

pub fn length(&self) -> u32

Byte length of this subtable (including the header)

pub fn language(&self) -> u32

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn is32(&self) -> &'a [BigEndian<u8>]

Tightly packed array of bits (8K bytes total) indicating whether the particular 16-bit (index) value is the start of a 32-bit character code

pub fn num_groups(&self) -> u32

Number of groupings which follow

pub fn groups(&self) -> &'a [SequentialMapGroup]

Array of SequentialMapGroup records.

impl<'a> TableRef<'a, Cmap10Marker>

pub fn format(&self) -> u16

Subtable format; set to 10.

pub fn length(&self) -> u32

Byte length of this subtable (including the header)

pub fn language(&self) -> u32

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn start_char_code(&self) -> u32

First character code covered

pub fn num_chars(&self) -> u32

Number of character codes covered

pub fn glyph_id_array(&self) -> &'a [BigEndian<u16>]

Array of glyph indices for the character codes covered

impl<'a> TableRef<'a, Cmap12Marker>

pub fn format(&self) -> u16

Subtable format; set to 12.

pub fn length(&self) -> u32

Byte length of this subtable (including the header)

pub fn language(&self) -> u32

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn num_groups(&self) -> u32

Number of groupings which follow

pub fn groups(&self) -> &'a [SequentialMapGroup]

Array of SequentialMapGroup records.

impl<'a> TableRef<'a, Cmap13Marker>

pub fn format(&self) -> u16

Subtable format; set to 13.

pub fn length(&self) -> u32

Byte length of this subtable (including the header)

pub fn language(&self) -> u32

For requirements on use of the language field, see “Use of the language field in ‘cmap’ subtables” in this document.

pub fn num_groups(&self) -> u32

Number of groupings which follow

pub fn groups(&self) -> &'a [ConstantMapGroup]

Array of ConstantMapGroup records.

impl<'a> TableRef<'a, Cmap14Marker>

pub fn format(&self) -> u16

Subtable format. Set to 14.

pub fn length(&self) -> u32

Byte length of this subtable (including this header)

pub fn num_var_selector_records(&self) -> u32

Number of variation Selector Records

pub fn var_selector(&self) -> &'a [VariationSelector]

Array of VariationSelector records.

impl<'a> TableRef<'a, DefaultUvsMarker>

pub fn num_unicode_value_ranges(&self) -> u32

Number of Unicode character ranges.

pub fn ranges(&self) -> &'a [UnicodeRange]

Array of UnicodeRange records.

impl<'a> TableRef<'a, SimpleGlyphMarker>

pub fn number_of_contours(&self) -> i16

If the number of contours is greater than or equal to zero, this is a simple glyph. If negative, this is a composite glyph — the value -1 should be used for composite glyphs.

pub fn x_min(&self) -> i16

Minimum x for coordinate data.

pub fn y_min(&self) -> i16

Minimum y for coordinate data.

pub fn x_max(&self) -> i16

Maximum x for coordinate data.

pub fn y_max(&self) -> i16

Maximum y for coordinate data.

pub fn end_pts_of_contours(&self) -> &'a [BigEndian<u16>]

Array of point indices for the last point of each contour, in increasing numeric order

pub fn instruction_length(&self) -> u16

Total number of bytes for instructions. If instructionLength is zero, no instructions are present for this glyph, and this field is followed directly by the flags field.

pub fn instructions(&self) -> &'a [BigEndian<u8>]

Array of instruction byte code for the glyph.

pub fn glyph_data(&self) -> &'a [u8]

the raw data for flags & x/y coordinates

impl<'a> TableRef<'a, CompositeGlyphMarker>

pub fn number_of_contours(&self) -> i16

If the number of contours is greater than or equal to zero, this is a simple glyph. If negative, this is a composite glyph — the value -1 should be used for composite glyphs.

pub fn x_min(&self) -> i16

Minimum x for coordinate data.

pub fn y_min(&self) -> i16

Minimum y for coordinate data.

pub fn x_max(&self) -> i16

Maximum x for coordinate data.

pub fn y_max(&self) -> i16

Maximum y for coordinate data.

pub fn component_data(&self) -> &'a [u8]

component flag glyph index of component

impl<'a> TableRef<'a, SimpleGlyphMarker>

pub fn iter_points(&self) -> PointIter<'_>

impl<'a> TableRef<'a, CompositeGlyphMarker>

pub fn iter_components(&self) -> ComponentIter<'a>

impl<'a> TableRef<'a, HeadMarker>

pub fn version(&self) -> MajorMinor

Version number of the font header table, set to (1, 0)

pub fn font_revision(&self) -> Fixed

Set by font manufacturer.

pub fn checksum_adjustment(&self) -> u32

To compute: set it to 0, sum the entire font as uint32, then store 0xB1B0AFBA - sum. If the font is used as a component in a font collection file, the value of this field will be invalidated by changes to the file structure and font table directory, and must be ignored.

pub fn magic_number(&self) -> u32

Set to 0x5F0F3CF5.

pub fn flags(&self) -> u16

See the flags enum

pub fn units_per_em(&self) -> u16

Set to a value from 16 to 16384. Any value in this range is valid. In fonts that have TrueType outlines, a power of 2 is recommended as this allows performance optimizations in some rasterizers.

pub fn created(&self) -> LongDateTime

Number of seconds since 12:00 midnight that started January 1st 1904 in GMT/UTC time zone.

pub fn modified(&self) -> LongDateTime

Number of seconds since 12:00 midnight that started January 1st 1904 in GMT/UTC time zone.

pub fn x_min(&self) -> i16

Minimum x coordinate across all glyph bounding boxes.

pub fn y_min(&self) -> i16

Minimum y coordinate across all glyph bounding boxes.

pub fn x_max(&self) -> i16

Maximum x coordinate across all glyph bounding boxes.

pub fn y_max(&self) -> i16

Maximum y coordinate across all glyph bounding boxes.

pub fn mac_style(&self) -> u16

see somewhere else

pub fn lowest_rec_ppem(&self) -> u16

Smallest readable size in pixels.

pub fn font_direction_hint(&self) -> i16

Deprecated (Set to 2).

pub fn index_to_loc_format(&self) -> i16

0 for short offsets (Offset16), 1 for long (Offset32).

pub fn glyph_data_format(&self) -> i16

0 for current format.

impl<'a> TableRef<'a, HheaMarker>

pub fn version(&self) -> MajorMinor

The major/minor version (1, 0)

pub fn ascender(&self) -> FWord

Typographic ascent—see note below.

pub fn descender(&self) -> FWord

Typographic descent—see note below.

pub fn line_gap(&self) -> FWord

Typographic line gap. Negative LineGap values are treated as zero in some legacy platform implementations.

pub fn advance_width_max(&self) -> UfWord

Maximum advance width value in ‘hmtx’ table.

pub fn min_left_side_bearing(&self) -> FWord

Minimum left sidebearing value in ‘hmtx’ table for glyphs with contours (empty glyphs should be ignored).

pub fn min_right_side_bearing(&self) -> FWord

Minimum right sidebearing value; calculated as min(aw - (lsb + xMax - xMin)) for glyphs with contours (empty glyphs should be ignored).

pub fn x_max_extent(&self) -> FWord

Max(lsb + (xMax - xMin)).

pub fn caret_slope_rise(&self) -> i16

Used to calculate the slope of the cursor (rise/run); 1 for vertical.

pub fn caret_slope_run(&self) -> i16

0 for vertical.

pub fn caret_offset(&self) -> i16

The amount by which a slanted highlight on a glyph needs to be shifted to produce the best appearance. Set to 0 for non-slanted fonts

pub fn metric_data_format(&self) -> i16

0 for current format.

pub fn number_of_h_metrics(&self) -> u16

Number of hMetric entries in ‘hmtx’ table

impl<'a> TableRef<'a, HmtxMarker>

pub fn h_metrics(&self) -> &'a [LongHorMetric]

Paired advance width and left side bearing values for each glyph. Records are indexed by glyph ID.

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

Left side bearings for glyph IDs greater than or equal to numberOfHMetrics.

impl<'a> TableRef<'a, MaxpMarker>

pub fn version(&self) -> Version16Dot16

The version: 0x00005000 for version 0.5, 0x00010000 for version 1.0.

pub fn num_glyphs(&self) -> u16

The number of glyphs in the font.

pub fn max_points(&self) -> Option<u16>

Maximum points in a non-composite glyph.

pub fn max_contours(&self) -> Option<u16>

Maximum contours in a non-composite glyph.

pub fn max_composite_points(&self) -> Option<u16>

Maximum points in a composite glyph.

pub fn max_composite_contours(&self) -> Option<u16>

Maximum contours in a composite glyph.

pub fn max_zones(&self) -> Option<u16>

1 if instructions do not use the twilight zone (Z0), or 2 if instructions do use Z0; should be set to 2 in most cases.

pub fn max_twilight_points(&self) -> Option<u16>

Maximum points used in Z0.

pub fn max_storage(&self) -> Option<u16>

Number of Storage Area locations.

pub fn max_function_defs(&self) -> Option<u16>

Number of FDEFs, equal to the highest function number + 1.

pub fn max_instruction_defs(&self) -> Option<u16>

Number of IDEFs.

pub fn max_stack_elements(&self) -> Option<u16>

Maximum stack depth across Font Program (‘fpgm’ table), CVT Program (‘prep’ table) and all glyph instructions (in the ‘glyf’ table).

pub fn max_size_of_instructions(&self) -> Option<u16>

Maximum byte count for glyph instructions.

pub fn max_component_elements(&self) -> Option<u16>

Maximum number of components referenced at “top level” for any composite glyph.

pub fn max_component_depth(&self) -> Option<u16>

Maximum levels of recursion; 1 for simple components.

impl<'a> TableRef<'a, NameMarker>

pub fn version(&self) -> u16

Table version number (0 or 1)

pub fn count(&self) -> u16

Number of name records.

pub fn storage_offset(&self) -> u16

Offset to start of string storage (from start of table).

pub fn name_record(&self) -> &'a [NameRecord]

The name records where count is the number of records.

pub fn lang_tag_count(&self) -> Option<u16>

Number of language-tag records.

pub fn lang_tag_record(&self) -> Option<&'a [LangTagRecord]>

The language-tag records where langTagCount is the number of records.

impl<'a> TableRef<'a, NameMarker>

pub fn string_data(&self) -> FontData<'a>

The FontData containing the encoded name strings.

impl<'a> TableRef<'a, PostMarker>

pub fn version(&self) -> Version16Dot16

0x00010000 for version 1.0 0x00020000 for version 2.0 0x00025000 for version 2.5 (deprecated) 0x00030000 for version 3.0

pub fn italic_angle(&self) -> Fixed

Italic angle in counter-clockwise degrees from the vertical. Zero for upright text, negative for text that leans to the right (forward).

pub fn underline_position(&self) -> FWord

This is the suggested distance of the top of the underline from the baseline (negative values indicate below baseline). The PostScript definition of this FontInfo dictionary key (the y coordinate of the center of the stroke) is not used for historical reasons. The value of the PostScript key may be calculated by subtracting half the underlineThickness from the value of this field.

pub fn underline_thickness(&self) -> FWord

Suggested values for the underline thickness. In general, the underline thickness should match the thickness of the underscore character (U+005F LOW LINE), and should also match the strikeout thickness, which is specified in the OS/2 table.

pub fn is_fixed_pitch(&self) -> u32

Set to 0 if the font is proportionally spaced, non-zero if the font is not proportionally spaced (i.e. monospaced).

pub fn min_mem_type42(&self) -> u32

Minimum memory usage when an OpenType font is downloaded.

pub fn max_mem_type42(&self) -> u32

Maximum memory usage when an OpenType font is downloaded.

pub fn min_mem_type1(&self) -> u32

Minimum memory usage when an OpenType font is downloaded as a Type 1 font.

pub fn max_mem_type1(&self) -> u32

Maximum memory usage when an OpenType font is downloaded as a Type 1 font.

pub fn num_glyphs(&self) -> Option<u16>

Number of glyphs (this should be the same as numGlyphs in ‘maxp’ table).

pub fn glyph_name_index(&self) -> Option<&'a [BigEndian<u16>]>

Array of indices into the string data. See below for details.

pub fn string_data(&self) -> Option<VarLenArray<'a, PString<'a>>>

Storage for the string data.

impl<'a> TableRef<'a, PostMarker>

pub fn num_names(&self) -> usize

The number of glyph names covered by this table

pub fn glyph_name(&self, glyph_id: GlyphId) -> Option<&str>

impl<'a> TableRef<'a, TableDirectoryMarker>

pub fn sfnt_version(&self) -> u32

0x00010000 or 0x4F54544F

pub fn num_tables(&self) -> u16

Number of tables.

pub fn search_range(&self) -> u16

pub fn entry_selector(&self) -> u16

pub fn range_shift(&self) -> u16

pub fn table_records(&self) -> &'a [TableRecord]

Table records array—one for each top-level table in the font