Struct FontFace

pub struct FontFace(/* private fields */);

A font face selected from a font family.

Usually this is part of a FontList that can be requested from the FONTS service.

This type is a shared reference to the font data, cloning it is cheap.

Implementations

impl FontFace

pub fn empty() -> Self

New empty font face.

pub fn is_empty(&self) -> bool

Is empty font face.

pub fn harfbuzz(&self) -> Option<Face<'_>>

Loads the harfbuzz face.

Loads from in memory bytes.

Returns None if is_empty.

pub fn ttf(&self) -> Option<Face<'_>>

Loads the full TTF face.

Loads from in memory bytes.

Returns None if is_empty.

pub fn bytes(&self) -> &FontDataRef

Reference the font file bytes.

pub fn index(&self) -> u32

Index of the font face in the font file.

pub fn display_name(&self) -> &FontName

Font full name.

pub fn family_name(&self) -> &FontName

Font family name.

pub fn postscript_name(&self) -> Option<&str>

Font globally unique name.

pub fn style(&self) -> FontStyle

Font style.

pub fn weight(&self) -> FontWeight

Font weight.

pub fn stretch(&self) -> FontStretch

Font stretch.

pub fn is_monospace(&self) -> bool

Font is monospace (fixed-width).

pub fn metrics(&self) -> &FontFaceMetrics

Font metrics in font units.

pub fn sized(&self, font_size: Px, variations: RFontVariations) -> Font

Gets a cached sized Font.

The font_size is the size of 1 font EM in pixels.

The variations are custom font variations that will be used during shaping and rendering.

pub fn synthesis_for( &self, style: FontStyle, weight: FontWeight, ) -> FontSynthesis

Gets what font synthesis to use to better render this font face given the style and weight.

pub fn is_cached(&self) -> bool

If this font face is cached. All font faces are cached by default, a font face can be detached from cache when a FONT_CHANGED_EVENT event happens, in this case the font can still be used normally, but a request for the same font name will return a different reference.

pub fn color_palettes(&self) -> &ColorPalettes

CPAL table.

Is empty if not provided by the font.

pub fn color_glyphs(&self) -> &ColorGlyphs

COLR table.

Is empty if not provided by the font.

pub fn has_ligatures(&self) -> bool

If the font provides glyph substitutions.

pub fn has_ligature_caret_offsets(&self) -> bool

If this font provides custom positioned carets for some or all ligature glyphs.

If true the Font::ligature_caret_offsets method can be used to get the caret offsets, otherwise it always returns empty.

pub fn has_raster_images(&self) -> bool

If this font has bitmap images associated with some glyphs.

pub fn has_svg_images(&self) -> bool

If this font has SVG images associated with some glyphs.

Trait Implementations

impl Clone for FontFace

fn clone(&self) -> FontFace

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FontFace

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

Formats the value using the given formatter.

impl PartialEq for FontFace

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FontFace