Struct owned_ttf_parser::PreParsedSubtables

pub struct PreParsedSubtables<'face, F> {
    pub face: F,
    pub(crate) subtables: FaceSubtables<'face>,
}

A Face with cmap & kern subtables parsed once on initialization.

Provides much faster PreParsedSubtables::glyph_index & PreParsedSubtables::glyphs_hor_kerning methods compared to the .as_face_ref() equivalents that must parse their subtables on each call.

Example

use owned_ttf_parser::{AsFaceRef, GlyphId, OwnedFace, PreParsedSubtables};

let owned_face = OwnedFace::from_vec(owned_font_data, 0).unwrap();
let faster_face = PreParsedSubtables::from(owned_face);

// Lookup a GlyphId using the pre-parsed cmap subtables
// this is much faster than doing: .as_face_ref().glyph_index('x')
assert_eq!(faster_face.glyph_index('x'), Some(GlyphId(91)));

// The rest of the methods are still available as normal
assert_eq!(faster_face.as_face_ref().ascender(), 2254);

Fields

face: F

Underlying face.

subtables: FaceSubtables<'face>

Implementations

impl<F> PreParsedSubtables<'_, F>

pub fn glyph_index(&self, c: char) -> Option<GlyphId>

Maps a character to a GlyphId using pre-parsed unicode cmap subtables.

pub fn glyph_variation_index(&self, c: char, v: char) -> Option<GlyphId>

Maps a variation of a character to a GlyphId using pre-parsed unicode cmap subtables.

pub fn glyphs_hor_kerning(&self, first: GlyphId, second: GlyphId) -> Option<i16>

Returns horizontal kerning for a pair of glyphs using pre-parsed kern subtables.

Trait Implementations

impl<F> AsFaceRef for &PreParsedSubtables<'_, F>

where F: AsFaceRef,

fn as_face_ref(&self) -> &Face<'_>

Convert to a Face reference.

impl<F> AsFaceRef for PreParsedSubtables<'_, F>

where F: AsFaceRef,

fn as_face_ref(&self) -> &Face<'_>

Convert to a Face reference.

impl<'face, F: Clone> Clone for PreParsedSubtables<'face, F>

fn clone(&self) -> PreParsedSubtables<'face, F>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F> Debug for PreParsedSubtables<'_, F>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<F> FaceMut for &mut PreParsedSubtables<'_, F>

where F: FaceMut,

fn set_variation(&mut self, axis: Tag, value: f32) -> Option<()>

Sets a variation axis coordinate.

impl<F> FaceMut for PreParsedSubtables<'_, F>

where F: FaceMut,

fn set_variation(&mut self, axis: Tag, value: f32) -> Option<()>

Sets a variation axis coordinate.

impl<'face> From<Face<'face>> for PreParsedSubtables<'face, Face<'face>>

fn from(face: Face<'face>) -> Self

Converts to this type from the input type.

impl From<OwnedFace> for PreParsedSubtables<'static, OwnedFace>

fn from(face: OwnedFace) -> Self

Converts to this type from the input type.