Struct FreeTypeFace

pub(crate) struct FreeTypeFace {
    face: NonNull<FT_FaceRec>,
}

A safe wrapper around FT_Face.

Fields

face: NonNull<FT_FaceRec>

Safety Invariant

The pointer must have been returned from FT_New_Face or FT_New_Memory_Face and must not be freed before FreetypeFace::drop is called.

Implementations

impl FreeTypeFace

pub(crate) fn new_from_memory( library: &FreeTypeLibraryHandle, data: &[u8], ) -> Result<Self, &'static str>

pub(crate) fn new_from_file( library: &FreeTypeLibraryHandle, filename: &CStr, index: u32, ) -> Result<Self, &'static str>

pub(crate) fn as_ref(&self) -> &FT_FaceRec

pub(crate) fn as_ptr(&self) -> FT_Face

pub(crate) fn scalable(&self) -> bool

Return true iff the font face flags contain FT_FACE_FLAG_SCALABLE.

pub(crate) fn color(&self) -> bool

Return true iff the font face flags contain FT_FACE_FLAG_COLOR.

pub(crate) fn set_size(&self, requested_size: Au) -> Result<Au, &'static str>

Scale the font to the given size if it is scalable, or select the closest available size if it is not, preferring larger sizes over smaller ones.

Returns the selected size on success and a error message on failure

pub(crate) fn glyph_load_flags(&self) -> FT_Int32

Select a reasonable set of glyph loading flags for the font.

pub(crate) fn set_variations_for_font( &self, variations: &[FontVariation], library: &FreeTypeLibraryHandle, ) -> Result<Vec<FontVariation>, &'static str>

Applies to provided variations to the font face.

Returns the normalized font variations, which are clamped to fit within the range of their respective axis. Variation values for nonexistent axes are not included.

Trait Implementations

impl Debug for FreeTypeFace

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

Formats the value using the given formatter.

impl Drop for FreeTypeFace

fn drop(&mut self)

Executes the destructor for this type.

impl Send for FreeTypeFace

FT_Face can be used in multiple threads, but from only one thread at a time. See https://freetype.org/freetype2/docs/reference/ft2-face_creation.html#ft_face.