pub struct FontRef<'a> {
pub(crate) data: FontData<'a>,
pub table_directory: TableDirectory<'a>,
pub(crate) ttc_index: u32,
pub(crate) in_ttc: bool,
pub(crate) table_directory_sorted: bool,
}Expand description
Reference to an in-memory font.
This is a simple implementation of the TableProvider trait backed
by a borrowed slice containing font data.
Fields§
§data: FontData<'a>§table_directory: TableDirectory<'a>§ttc_index: u32The index of this font in a TrueType collection
in_ttc: boolWhether this font is a member of a TrueType collection.
We use a bool rather than an Option to avoid bloating the struct size.
table_directory_sorted: boolImplementations§
Source§impl<'a> FontRef<'a>
impl<'a> FontRef<'a>
Sourcepub fn new(data: &'a [u8]) -> Result<Self, ReadError>
pub fn new(data: &'a [u8]) -> Result<Self, ReadError>
Creates a new reference to an in-memory font backed by the given data.
The data must be a single font (not a font collection) and must begin with a table directory to be considered valid.
To load a font from a font collection, use FontRef::from_index instead.
Sourcepub fn from_index(data: &'a [u8], index: u32) -> Result<Self, ReadError>
pub fn from_index(data: &'a [u8], index: u32) -> Result<Self, ReadError>
Creates a new reference to an in-memory font at the specified index backed by the given data.
The data slice must begin with either a table directory or a ttc header to be considered valid.
In other words, this accepts either font collection (ttc) or single font (ttf/otf) files. If a single font file is provided, the index parameter must be 0.
Sourcepub fn data(&self) -> FontData<'a>
pub fn data(&self) -> FontData<'a>
Returns the underlying font data.
This is the base from which tables are loaded, meaning that for TrueType collection files, this will be the entire font file data.
Sourcepub fn ttc_index(&self) -> Option<u32>
pub fn ttc_index(&self) -> Option<u32>
If the font is in a TrueType collection (ttc) file, returns the index of the font in that collection.
Sourcepub fn table_directory(&self) -> &TableDirectory<'a>
pub fn table_directory(&self) -> &TableDirectory<'a>
Returns the associated table directory.
Sourcepub fn table_data(&self, tag: Tag) -> Option<FontData<'a>>
pub fn table_data(&self, tag: Tag) -> Option<FontData<'a>>
Returns the data for the table with the specified tag, if present.
Sourcepub fn fonts(
data: &'a [u8],
) -> impl Iterator<Item = Result<FontRef<'a>, ReadError>> + 'a + Clone
pub fn fonts( data: &'a [u8], ) -> impl Iterator<Item = Result<FontRef<'a>, ReadError>> + 'a + Clone
Returns an iterator over all of the available fonts in the given font data.
pub(crate) fn with_table_directory( data: FontData<'a>, table_directory: TableDirectory<'a>, ttc_index: Option<u32>, ) -> Result<Self, ReadError>
Trait Implementations§
Source§impl<'a> TableProvider<'a> for FontRef<'a>
impl<'a> TableProvider<'a> for FontRef<'a>
fn data_for_tag(&self, tag: Tag) -> Option<FontData<'a>>
fn expect_data_for_tag(&self, tag: Tag) -> Result<FontData<'a>, ReadError>
fn expect_table<T: TopLevelTable + FontRead<'a, Args = ()>>( &self, ) -> Result<T, ReadError>
fn head(&self) -> Result<Head<'a>, ReadError>
fn name(&self) -> Result<Name<'a>, ReadError>
Source§fn hhea(&self) -> Result<Hhea<'a>, ReadError>
fn hhea(&self) -> Result<Hhea<'a>, ReadError>
hhea table only. A font may carry its metrics header in
HHEA instead; selected_hhea chooses between them.Source§fn vhea(&self) -> Result<Vhea<'a>, ReadError>
fn vhea(&self) -> Result<Vhea<'a>, ReadError>
vhea table only. A font may carry its vertical metrics
header in VHEA instead; selected_vhea chooses
between them.Source§fn hhea_extended(&self) -> Result<HheaExtended<'a>, ReadError>
fn hhea_extended(&self) -> Result<HheaExtended<'a>, ReadError>
Source§fn selected_hhea(&self) -> Result<SelectedHhea<'a>, ReadError>
fn selected_hhea(&self) -> Result<SelectedHhea<'a>, ReadError>
Source§fn vhea_extended(&self) -> Result<VheaExtended<'a>, ReadError>
fn vhea_extended(&self) -> Result<VheaExtended<'a>, ReadError>
Source§fn selected_vhea(&self) -> Result<SelectedVhea<'a>, ReadError>
fn selected_vhea(&self) -> Result<SelectedVhea<'a>, ReadError>
fn hmtx(&self) -> Result<Hmtx<'a>, ReadError>
Source§fn hmtx_extended(&self) -> Result<HmtxExtended<'a>, ReadError>
fn hmtx_extended(&self) -> Result<HmtxExtended<'a>, ReadError>
Source§fn h_glyph_metric_records(&self) -> Result<GlyphMetricRecords<'a>, ReadError>
fn h_glyph_metric_records(&self) -> Result<GlyphMetricRecords<'a>, ReadError>
fn hdmx(&self) -> Result<Hdmx<'a>, ReadError>
fn vmtx(&self) -> Result<Vmtx<'a>, ReadError>
Source§fn vmtx_extended(&self) -> Result<VmtxExtended<'a>, ReadError>
fn vmtx_extended(&self) -> Result<VmtxExtended<'a>, ReadError>
Source§fn v_glyph_metric_records(&self) -> Result<GlyphMetricRecords<'a>, ReadError>
fn v_glyph_metric_records(&self) -> Result<GlyphMetricRecords<'a>, ReadError>
fn vorg(&self) -> Result<Vorg<'a>, ReadError>
fn fvar(&self) -> Result<Fvar<'a>, ReadError>
fn avar(&self) -> Result<Avar<'a>, ReadError>
fn hvar(&self) -> Result<Hvar<'a>, ReadError>
fn vvar(&self) -> Result<Vvar<'a>, ReadError>
fn mvar(&self) -> Result<Mvar<'a>, ReadError>
Source§fn maxp(&self) -> Result<Maxp<'a>, ReadError>
fn maxp(&self) -> Result<Maxp<'a>, ReadError>
maxp table only. A font with more than 65535 glyphs
carries its glyph count in MAXP; selected_maxp
chooses between them.Source§fn maxp_extended(&self) -> Result<MaxpExtended<'a>, ReadError>
fn maxp_extended(&self) -> Result<MaxpExtended<'a>, ReadError>
Source§fn selected_maxp(&self) -> Result<SelectedMaxp<'a>, ReadError>
fn selected_maxp(&self) -> Result<SelectedMaxp<'a>, ReadError>
fn os2(&self) -> Result<Os2<'a>, ReadError>
fn post(&self) -> Result<Post<'a>, ReadError>
fn gasp(&self) -> Result<Gasp<'a>, ReadError>
Source§fn loca(&self, is_long: impl Into<Option<bool>>) -> Result<Loca<'a>, ReadError>
fn loca(&self, is_long: impl Into<Option<bool>>) -> Result<Loca<'a>, ReadError>
Source§fn glyf(&self) -> Result<Glyf<'a>, ReadError>
fn glyf(&self) -> Result<Glyf<'a>, ReadError>
glyf table only. A font may carry its outlines in GLYF and
LOCA instead; selected_glyf_loca chooses
between the pairs.Source§fn glyf_extended(&self) -> Result<Glyf<'a>, ReadError>
fn glyf_extended(&self) -> Result<Glyf<'a>, ReadError>
Source§fn loca_extended(
&self,
is_long: impl Into<Option<bool>>,
) -> Result<Loca<'a>, ReadError>
fn loca_extended( &self, is_long: impl Into<Option<bool>>, ) -> Result<Loca<'a>, ReadError>
Source§fn selected_glyf_loca(
&self,
is_long: impl Into<Option<bool>>,
) -> Result<(Glyf<'a>, Loca<'a>), ReadError>
fn selected_glyf_loca( &self, is_long: impl Into<Option<bool>>, ) -> Result<(Glyf<'a>, Loca<'a>), ReadError>
Source§fn gvar(&self) -> Result<Gvar<'a>, ReadError>
fn gvar(&self) -> Result<Gvar<'a>, ReadError>
gvar table only. A font may carry its glyph variations in
GVAR instead; selected_gvar chooses between
them.Source§fn gvar_extended(&self) -> Result<GvarExtended<'a>, ReadError>
fn gvar_extended(&self) -> Result<GvarExtended<'a>, ReadError>
GVAR table only (ISO/IEC 14496-22:2026).