[−][src]Struct font_kit::loaders::freetype::Font

pub struct Font { /* fields omitted */ }

A cross-platform loader that uses the FreeType library to load and rasterize fonts.

On macOS and Windows, the Cargo feature loader-freetype-default can be used to opt into this loader by default.

Methods

`impl Font`[src]

`pub fn from_bytes( font_data: Arc<Vec<u8>>, font_index: u32 ) -> Result<Font, FontLoadingError>`[src]

Loads a font from raw font data (the contents of a .ttf/.otf/etc. file).

If the data represents a collection (.ttc/.otc/etc.), font_index specifies the index of the font to load from it. If the data represents a single font, pass 0 for font_index.

`pub fn from_file( file: &mut File, font_index: u32 ) -> Result<Font, FontLoadingError>`[src]

Loads a font from a .ttf/.otf/etc. file.

If the file is a collection (.ttc/.otc/etc.), font_index specifies the index of the font to load from it. If the file represents a single font, pass 0 for font_index.

`pub fn from_path(path: P, font_index: u32) -> Result<Font, FontLoadingError> where P: AsRef<Path>,` [src]

Loads a font from the path to a .ttf/.otf/etc. file.

If the file is a collection (.ttc/.otc/etc.), font_index specifies the index of the font to load from it. If the file represents a single font, pass 0 for font_index.

`pub unsafe fn from_native_font(freetype_face: NativeFont) -> Font`[src]

Creates a font from a native API handle.

`pub fn from_handle(handle: &Handle) -> Result<Self, FontLoadingError>`[src]

Loads the font pointed to by a handle.

`pub fn analyze_bytes( font_data: Arc<Vec<u8>> ) -> Result<FileType, FontLoadingError>`[src]

Determines whether a blob of raw font data represents a supported font, and, if so, what type of font it is.

`pub fn analyze_file(file: &mut File) -> Result<FileType, FontLoadingError>`[src]

Determines whether a file represents a supported font, and, if so, what type of font it is.

`pub fn analyze_path(path: P) -> Result<FileType, FontLoadingError> where P: AsRef<Path>,` [src]

Determines whether a path points to a supported font, and, if so, what type of font it is.

`pub fn native_font(&self) -> NativeFont`[src]

Returns the wrapped native font handle.

This function increments the reference count of the FreeType face before returning it. Therefore, it is the caller's responsibility to free it with FT_Done_Face.

`pub fn postscript_name(&self) -> Option<String>`[src]

Returns the PostScript name of the font. This should be globally unique.

`pub fn full_name(&self) -> String`[src]

Returns the full name of the font (also known as "display name" on macOS).

`pub fn family_name(&self) -> String`[src]

Returns the name of the font family.

`pub fn is_monospace(&self) -> bool`[src]

Returns true if and only if the font is monospace (fixed-width).

`pub fn properties(&self) -> Properties`[src]

Returns the values of various font properties, corresponding to those defined in CSS.

`pub fn glyph_for_char(&self, character: char) -> Option<u32>`[src]

Returns the usual glyph ID for a Unicode character.

Be careful with this function; typographically correct character-to-glyph mapping must be done using a shaper such as HarfBuzz. This function is only useful for best-effort simple use cases like "what does character X look like on its own".

`pub fn glyph_by_name(&self, name: &str) -> Option<u32>`[src]

Returns the glyph ID for the specified glyph name.

`pub fn glyph_count(&self) -> u32`[src]

Returns the number of glyphs in the font.

Glyph IDs range from 0 inclusive to this value exclusive.

`pub fn outline<S>( &self, glyph_id: u32, hinting: HintingOptions, sink: &mut S ) -> Result<(), GlyphLoadingError> where S: OutlineSink,` [src]

Sends the vector path for a glyph to a path builder.

If hinting_mode is not None, this function performs grid-fitting as requested before sending the hinding outlines to the builder.

TODO(pcwalton): What should we do for bitmap glyphs?

`pub fn typographic_bounds( &self, glyph_id: u32 ) -> Result<RectF, GlyphLoadingError>`[src]

Returns the boundaries of a glyph in font units.

`pub fn advance(&self, glyph_id: u32) -> Result<Vector2F, GlyphLoadingError>`[src]

Returns the distance from the origin of the glyph with the given ID to the next, in font units.

`pub fn origin(&self, _: u32) -> Result<Vector2F, GlyphLoadingError>`[src]

Returns the amount that the given glyph should be displaced from the origin.

FIXME(pcwalton): This always returns zero on FreeType.

`pub fn metrics(&self) -> Metrics`[src]

Retrieves various metrics that apply to the entire font.

`pub fn supports_hinting_options( &self, hinting_options: HintingOptions, for_rasterization: bool ) -> bool`[src]

Returns true if and only if the font loader can perform hinting in the requested way.

Some APIs support only rasterizing glyphs with hinting, not retriving hinted outlines. If for_rasterization is false, this function returns true if and only if the loader supports retrieval of hinted outlines. If for_rasterization is true, this function returns true if and only if the loader supports rasterizing hinted glyphs.

`pub fn raster_bounds( &self, glyph_id: u32, point_size: f32, transform: Transform2F, hinting_options: HintingOptions, rasterization_options: RasterizationOptions ) -> Result<RectI, GlyphLoadingError>`[src]

Returns the pixel boundaries that the glyph will take up when rendered using this loader's rasterizer at the given size and origin.

`pub fn rasterize_glyph( &self, canvas: &mut Canvas, glyph_id: u32, point_size: f32, transform: Transform2F, hinting_options: HintingOptions, rasterization_options: RasterizationOptions ) -> Result<(), GlyphLoadingError>`[src]

Rasterizes a glyph to a canvas with the given size and origin.

Format conversion will be performed if the canvas format does not match the rasterization options. For example, if bilevel (black and white) rendering is requested to an RGBA surface, this function will automatically convert the 1-bit raster image to the 32-bit format of the canvas. Note that this may result in a performance penalty, depending on the loader.

If hinting_options is not None, the requested grid fitting is performed.

`pub fn handle(&self) -> Option<Handle>`[src]

Returns a handle to this font, if possible.

This is useful if you want to open the font with a different loader.

`pub fn copy_font_data(&self) -> Option<Arc<Vec<u8>>>`[src]

Attempts to return the raw font data (contents of the font file).

If this font is a member of a collection, this function returns the data for the entire collection.

`pub fn load_font_table(&self, table_tag: u32) -> Option<Box<[u8]>>`[src]

Returns the raw contents of the OpenType table with the given tag.

Tags are four-character codes. A list of tags can be found in the OpenType specification.

Trait Implementations

`impl Clone for Font`[src]

`fn clone(&self) -> Font`[src]

`fn clone_from(&mut self, source: &Self)`1.0.0[src]

`impl Debug for Font`[src]

`fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>`[src]

`impl Drop for Font`[src]

`fn drop(&mut self)`[src]

`impl Loader for Font`[src]

`type NativeFont = NativeFont`

The handle that the API natively uses to represent a font.

`fn from_bytes( font_data: Arc<Vec<u8>>, font_index: u32 ) -> Result<Self, FontLoadingError>`[src]

`fn from_file(file: &mut File, font_index: u32) -> Result<Font, FontLoadingError>`[src]

`fn analyze_bytes(font_data: Arc<Vec<u8>>) -> Result<FileType, FontLoadingError>`[src]

`fn analyze_file(file: &mut File) -> Result<FileType, FontLoadingError>`[src]

`fn native_font(&self) -> Self::NativeFont`[src]

`unsafe fn from_native_font(native_font: Self::NativeFont) -> Self`[src]

`fn postscript_name(&self) -> Option<String>`[src]

`fn full_name(&self) -> String`[src]

`fn family_name(&self) -> String`[src]

`fn is_monospace(&self) -> bool`[src]

`fn properties(&self) -> Properties`[src]

`fn glyph_for_char(&self, character: char) -> Option<u32>`[src]

`fn glyph_by_name(&self, name: &str) -> Option<u32>`[src]

`fn glyph_count(&self) -> u32`[src]

`fn outline<S>( &self, glyph_id: u32, hinting_mode: HintingOptions, sink: &mut S ) -> Result<(), GlyphLoadingError> where S: OutlineSink,` [src]

`fn typographic_bounds(&self, glyph_id: u32) -> Result<RectF, GlyphLoadingError>`[src]

`fn advance(&self, glyph_id: u32) -> Result<Vector2F, GlyphLoadingError>`[src]

`fn origin(&self, origin: u32) -> Result<Vector2F, GlyphLoadingError>`[src]

`fn metrics(&self) -> Metrics`[src]

`fn copy_font_data(&self) -> Option<Arc<Vec<u8>>>`[src]

`fn supports_hinting_options( &self, hinting_options: HintingOptions, for_rasterization: bool ) -> bool`[src]

`fn rasterize_glyph( &self, canvas: &mut Canvas, glyph_id: u32, point_size: f32, transform: Transform2F, hinting_options: HintingOptions, rasterization_options: RasterizationOptions ) -> Result<(), GlyphLoadingError>`[src]

`fn get_fallbacks(&self, text: &str, locale: &str) -> FallbackResult<Self>`[src]

`fn load_font_table(&self, table_tag: u32) -> Option<Box<[u8]>>`[src]

`fn from_path(path: P, font_index: u32) -> Result<Self, FontLoadingError> where P: AsRef<Path>,` [src]

`fn from_handle(handle: &Handle) -> Result<Self, FontLoadingError>`[src]

`fn analyze_path(path: P) -> Result<FileType, FontLoadingError> where P: AsRef<Path>,` [src]

`fn handle(&self) -> Option<Handle>`[src]

`fn raster_bounds( &self, glyph_id: u32, point_size: f32, transform: Transform2F, _: HintingOptions, _: RasterizationOptions ) -> Result<RectI, GlyphLoadingError>`[src]

Auto Trait Implementations

`impl RefUnwindSafe for Font`

`impl !Send for Font`

`impl !Sync for Font`

`impl Unpin for Font`

`impl UnwindSafe for Font`

Blanket Implementations

`impl<T> Any for T where T: 'static + ?Sized,` [src]

`fn type_id(&self) -> TypeId`[src]

`impl<T> Borrow<T> for T where T: ?Sized,` [src]

`fn borrow(&self) -> &T`[src]

`impl<T> BorrowMut<T> for T where T: ?Sized,` [src]

`fn borrow_mut(&mut self) -> &mut T`[src]

`impl<T> From<T> for T`[src]

`fn from(t: T) -> T`[src]

`impl<T, U> Into for T where U: From<T>,` [src]

`fn into(self) -> U`[src]

`impl<T> ToOwned for T where T: Clone,` [src]

`type Owned = T`

The resulting type after obtaining ownership.

`fn to_owned(&self) -> T`[src]

`fn clone_into(&self, target: &mut T)`[src]

`impl<T, U> TryFrom for T where U: Into<T>,` [src]

`type Error = Infallible`

The type returned in the event of a conversion error.

`fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>`[src]

`impl<T, U> TryInto for T where U: TryFrom<T>,` [src]

`type Error = >::Error`

The type returned in the event of a conversion error.

[−][src]Struct font_kit::loaders::freetype::Font

Methods

impl Font[src]

pub fn from_bytes( font_data: Arc<Vec<u8>>, font_index: u32) -> Result<Font, FontLoadingError>[src]

pub fn from_file( file: &mut File, font_index: u32) -> Result<Font, FontLoadingError>[src]

pub fn from_path<P>(path: P, font_index: u32) -> Result<Font, FontLoadingError> where P: AsRef<Path>, [src]

pub unsafe fn from_native_font(freetype_face: NativeFont) -> Font[src]

pub fn from_handle(handle: &Handle) -> Result<Self, FontLoadingError>[src]

pub fn analyze_bytes( font_data: Arc<Vec<u8>>) -> Result<FileType, FontLoadingError>[src]

pub fn analyze_file(file: &mut File) -> Result<FileType, FontLoadingError>[src]

pub fn analyze_path<P>(path: P) -> Result<FileType, FontLoadingError> where P: AsRef<Path>, [src]

pub fn native_font(&self) -> NativeFont[src]

pub fn postscript_name(&self) -> Option<String>[src]

pub fn full_name(&self) -> String[src]

pub fn family_name(&self) -> String[src]

pub fn is_monospace(&self) -> bool[src]

pub fn properties(&self) -> Properties[src]

pub fn glyph_for_char(&self, character: char) -> Option<u32>[src]

pub fn glyph_by_name(&self, name: &str) -> Option<u32>[src]

pub fn glyph_count(&self) -> u32[src]

pub fn outline<S>( &self, glyph_id: u32, hinting: HintingOptions, sink: &mut S) -> Result<(), GlyphLoadingError> where S: OutlineSink, [src]

pub fn typographic_bounds( &self, glyph_id: u32) -> Result<RectF, GlyphLoadingError>[src]

pub fn advance(&self, glyph_id: u32) -> Result<Vector2F, GlyphLoadingError>[src]

pub fn origin(&self, _: u32) -> Result<Vector2F, GlyphLoadingError>[src]

pub fn metrics(&self) -> Metrics[src]

pub fn supports_hinting_options( &self, hinting_options: HintingOptions, for_rasterization: bool) -> bool[src]

pub fn raster_bounds( &self, glyph_id: u32, point_size: f32, transform: Transform2F, hinting_options: HintingOptions, rasterization_options: RasterizationOptions) -> Result<RectI, GlyphLoadingError>[src]

pub fn rasterize_glyph( &self, canvas: &mut Canvas, glyph_id: u32, point_size: f32, transform: Transform2F, hinting_options: HintingOptions, rasterization_options: RasterizationOptions) -> Result<(), GlyphLoadingError>[src]

pub fn handle(&self) -> Option<Handle>[src]

pub fn copy_font_data(&self) -> Option<Arc<Vec<u8>>>[src]

pub fn load_font_table(&self, table_tag: u32) -> Option<Box<[u8]>>[src]

Trait Implementations

impl Clone for Font[src]

fn clone(&self) -> Font[src]

fn clone_from(&mut self, source: &Self)1.0.0[src]

impl Debug for Font[src]

fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>[src]

impl Drop for Font[src]

fn drop(&mut self)[src]

impl Loader for Font[src]

type NativeFont = NativeFont

fn from_bytes( font_data: Arc<Vec<u8>>, font_index: u32) -> Result<Self, FontLoadingError>[src]

fn from_file(file: &mut File, font_index: u32) -> Result<Font, FontLoadingError>[src]

fn analyze_bytes(font_data: Arc<Vec<u8>>) -> Result<FileType, FontLoadingError>[src]

fn analyze_file(file: &mut File) -> Result<FileType, FontLoadingError>[src]

fn native_font(&self) -> Self::NativeFont[src]

unsafe fn from_native_font(native_font: Self::NativeFont) -> Self[src]

fn postscript_name(&self) -> Option<String>[src]

fn full_name(&self) -> String[src]

fn family_name(&self) -> String[src]

fn is_monospace(&self) -> bool[src]

fn properties(&self) -> Properties[src]

fn glyph_for_char(&self, character: char) -> Option<u32>[src]

fn glyph_by_name(&self, name: &str) -> Option<u32>[src]

fn glyph_count(&self) -> u32[src]

fn outline<S>( &self, glyph_id: u32, hinting_mode: HintingOptions, sink: &mut S) -> Result<(), GlyphLoadingError> where S: OutlineSink, [src]

fn typographic_bounds(&self, glyph_id: u32) -> Result<RectF, GlyphLoadingError>[src]

fn advance(&self, glyph_id: u32) -> Result<Vector2F, GlyphLoadingError>[src]

fn origin(&self, origin: u32) -> Result<Vector2F, GlyphLoadingError>[src]

fn metrics(&self) -> Metrics[src]

fn copy_font_data(&self) -> Option<Arc<Vec<u8>>>[src]

fn supports_hinting_options( &self, hinting_options: HintingOptions, for_rasterization: bool) -> bool[src]

fn rasterize_glyph( &self, canvas: &mut Canvas, glyph_id: u32, point_size: f32, transform: Transform2F, hinting_options: HintingOptions, rasterization_options: RasterizationOptions) -> Result<(), GlyphLoadingError>[src]

fn get_fallbacks(&self, text: &str, locale: &str) -> FallbackResult<Self>[src]

fn load_font_table(&self, table_tag: u32) -> Option<Box<[u8]>>[src]

fn from_path<P>(path: P, font_index: u32) -> Result<Self, FontLoadingError> where P: AsRef<Path>, [src]

fn from_handle(handle: &Handle) -> Result<Self, FontLoadingError>[src]

fn analyze_path<P>(path: P) -> Result<FileType, FontLoadingError> where P: AsRef<Path>, [src]

fn handle(&self) -> Option<Handle>[src]

fn raster_bounds( &self, glyph_id: u32, point_size: f32, transform: Transform2F, _: HintingOptions, _: RasterizationOptions) -> Result<RectI, GlyphLoadingError>[src]