Enum Font

pub enum Font<'a> {
    Ref(Arc<Face<'a>>),
    Owned(Arc<OwnedFace>),
}

A single font. This may or may not own the font data.

Lifetime

The lifetime reflects the font data lifetime. Font<'static> covers most cases ie both dynamically loaded owned data and for referenced compile time font data.

Example

let font_data: &[u8] = include_bytes!("../dev/fonts/dejavu/DejaVuSansMono.ttf");
let font: Font<'static> = Font::try_from_bytes(font_data)?;

let owned_font_data: Vec<u8> = font_data.to_vec();
let from_owned_font: Font<'static> = Font::try_from_vec(owned_font_data)?;

Variants

Ref(Arc<Face<'a>>)

Owned(Arc<OwnedFace>)

Implementations

impl Font<'_>

pub fn try_from_bytes(bytes: &[u8]) -> Option<Font<'_>>

Creates a Font from byte-slice data.

Returns None for invalid data.

pub fn try_from_bytes_and_index(bytes: &[u8], index: u32) -> Option<Font<'_>>

Creates a Font from byte-slice data & a font collection index.

Returns None for invalid data.

pub fn try_from_vec(data: Vec<u8>) -> Option<Font<'static>>

Creates a Font from owned font data.

Returns None for invalid data.

pub fn try_from_vec_and_index( data: Vec<u8>, index: u32, ) -> Option<Font<'static>>

Creates a Font from owned font data & a font collection index.

Returns None for invalid data.

impl<'font> Font<'font>

pub fn v_metrics(&self, scale: Scale) -> VMetrics

The “vertical metrics” for this font at a given scale. These metrics are shared by all of the glyphs in the font. See VMetrics for more detail.

pub fn v_metrics_unscaled(&self) -> VMetrics

Get the unscaled VMetrics for this font, shared by all glyphs. See VMetrics for more detail.

pub fn units_per_em(&self) -> u16

Returns the units per EM square of this font

pub fn glyph_count(&self) -> usize

The number of glyphs present in this font. Glyph identifiers for this font will always be in the range 0..self.glyph_count()

pub fn glyph<C: IntoGlyphId>(&self, id: C) -> Glyph<'font>

Returns the corresponding glyph for a Unicode code point or a glyph id for this font.

If id is a GlyphId, it must be valid for this font; otherwise, this function panics. GlyphIds should always be produced by looking up some other sort of designator (like a Unicode code point) in a font, and should only be used to index the font they were produced for.

Note that code points without corresponding glyphs in this font map to the “.notdef” glyph, glyph 0.

pub fn glyphs_for<'a, I: Iterator>(&'a self, itr: I) -> GlyphIter<'a, 'font, I>

where I::Item: IntoGlyphId,

A convenience function.

Returns an iterator that produces the glyphs corresponding to the code points or glyph ids produced by the given iterator itr.

This is equivalent in behaviour to itr.map(|c| font.glyph(c)).

pub fn layout<'a, 's>( &'a self, s: &'s str, scale: Scale, start: Point<f32>, ) -> LayoutIter<'a, 'font, 's>

A convenience function for laying out glyphs for a string horizontally. It does not take control characters like line breaks into account, as treatment of these is likely to depend on the application.

Note that this function does not perform Unicode normalisation. Composite characters (such as ö constructed from two code points, ¨ and o), will not be normalised to single code points. So if a font does not contain a glyph for each separate code point, but does contain one for the normalised single code point (which is common), the desired glyph will not be produced, despite being present in the font. Deal with this by performing Unicode normalisation on the input string before passing it to layout. The crate unicode-normalization is perfect for this purpose.

Calling this function is equivalent to a longer sequence of operations involving glyphs_for, e.g.

font.layout("Hello World!", scale, start)

produces an iterator with behaviour equivalent to the following:

font.glyphs_for("Hello World!".chars())
    .scan((None, 0.0), |(last, x), g| {
        let g = g.scaled(scale);
        if let Some(last) = last {
            *x += font.pair_kerning(scale, *last, g.id());
        }
        let w = g.h_metrics().advance_width;
        let next = g.positioned(start + vector(*x, 0.0));
        *last = Some(next.id());
        *x += w;
        Some(next)
    })

pub fn pair_kerning<A, B>(&self, scale: Scale, first: A, second: B) -> f32

where A: IntoGlyphId, B: IntoGlyphId,

Returns additional kerning to apply as well as that given by HMetrics for a particular pair of glyphs.

pub fn scale_for_pixel_height(&self, height: f32) -> f32

Computes a scale factor to produce a font whose “height” is ‘pixels’ tall. Height is measured as the distance from the highest ascender to the lowest descender; in other words, it’s equivalent to calling GetFontVMetrics and computing: scale = pixels / (ascent - descent) so if you prefer to measure height by the ascent only, use a similar calculation.

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.

impl Debug for Font<'_>

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

Formats the value using the given formatter.