Struct ttf_parser::Font

pub struct Font<'a> { /* fields omitted */ }

A font data handle.

Methods

impl<'a> Font<'a>

pub fn glyph_index(&self, c: char) -> Result<u16, Error>

Resolves Glyph ID for code point.

Returns Error::NoGlyph instead of 0 when glyph is not found.

impl<'a> Font<'a>

pub fn glyph(&self, glyph_id: u16) -> Result<Glyph, Error>

Returns a glyph handle.

impl<'a> Font<'a>

pub fn glyph_hor_metrics(&self, glyph_id: u16) -> Option<HorizontalMetrics>

Returns glyph's horizontal metrics.

Returns None when font doesn't have such glyph_id.

impl<'a> Font<'a>

pub fn underline_metrics(&self) -> LineMetrics

Parses font's underline metrics set in the post table.

impl<'a> Font<'a>

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

Returns font's units per EM set in the head table.

Returns None if value is not in a 16..16384 range.

impl<'a> Font<'a>

pub fn ascender(&self) -> i16

Returns font's ascender set in the hhea table.

pub fn descender(&self) -> i16

Returns font's descender set in the hhea table.

pub fn height(&self) -> i16

Returns font's height.

pub fn line_gap(&self) -> i16

Returns font's line gap set in the hhea table.

impl<'a> Font<'a>

pub fn from_data(data: &'a [u8], index: u32) -> Result<Self, Error>

Creates a Font object from raw data.

You can set index in case of font collections. For simple ttf fonts set index to 0.

This function only parses font tables, so it's relatively light.

Required tables: cmap, glyp, head, hhea, hmtx, loca, post.

Optional tables: GDEF, name, OS/2

pub fn number_of_glyphs(&self) -> u16

Returns a total number of glyphs in the font.

The value was already parsed, so this function doesn't involve any parsing.

pub fn is_valid(&self) -> Result<(), Error>

Checks tables checksum.

Checks only used tables.

pub fn os2_table(&self) -> Option<Table>

Returns a handle to a OS/2 table.

pub fn name_table(&self) -> Option<Table>

Returns a handle to a name table.

pub fn gdef_table(&self) -> Option<Table>

Returns a handle to a GDEF table.

Trait Implementations

impl<'a> Clone for Font<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.