Struct ab_glyph::FontVec

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

Font data handle stored in a Vec<u8> + parsed data. See Font for more methods.

Also see FontRef.

Example

use ab_glyph::{Font, FontVec};

let font = FontVec::try_from_vec_and_index(owned_font_data, 0)?;

assert_eq!(font.glyph_id('s'), ab_glyph::GlyphId(56));

Implementations

impl FontVec

pub fn try_from_vec(data: Vec<u8>) -> Result<Self, InvalidFont>

Creates an FontVec from owned data.

For font collections see FontVec::try_from_vec_and_index.

Example

let font = FontVec::try_from_vec(owned_font_data)?;

pub fn try_from_vec_and_index( data: Vec<u8>, index: u32 ) -> Result<Self, InvalidFont>

Creates an FontVec from owned data.

You can set index for font collections. For simple fonts use 0 or FontVec::try_from_vec.

Example

let font = FontVec::try_from_vec_and_index(owned_font_data, 0)?;

pub fn as_slice(&self) -> &[u8]

Extracts a slice containing the data passed into e.g. FontVec::try_from_vec.

Example

let font_data_clone = owned_font_data.clone();
let font = FontVec::try_from_vec(owned_font_data)?;
assert_eq!(font.as_slice(), font_data_clone);

pub fn into_vec(self) -> Vec<u8>

Unwraps the data passed into e.g. FontVec::try_from_vec.

Example

let font_data_clone = owned_font_data.clone();
let font = FontVec::try_from_vec(owned_font_data)?;
assert_eq!(font.into_vec(), font_data_clone);

Trait Implementations

impl Debug for FontVec

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

Formats the value using the given formatter.

impl Font for FontVec

fn units_per_em(&self) -> Option<f32>

Get the size of the font unit

fn ascent_unscaled(&self) -> f32

Unscaled glyph ascent.

fn descent_unscaled(&self) -> f32

Unscaled glyph descent.

fn line_gap_unscaled(&self) -> f32

Unscaled line gap.

fn glyph_id(&self, c: char) -> GlyphId

Lookup a GlyphId matching a given char.

fn h_advance_unscaled(&self, id: GlyphId) -> f32

Unscaled horizontal advance for a given glyph id.

fn h_side_bearing_unscaled(&self, id: GlyphId) -> f32

Unscaled horizontal side bearing for a given glyph id.

fn v_advance_unscaled(&self, id: GlyphId) -> f32

Unscaled vertical advance for a given glyph id.

fn v_side_bearing_unscaled(&self, id: GlyphId) -> f32

Unscaled vertical side bearing for a given glyph id.

fn kern_unscaled(&self, first: GlyphId, second: GlyphId) -> f32

Returns additional unscaled kerning to apply for a particular pair of glyph ids.

fn outline(&self, id: GlyphId) -> Option<Outline>

Compute unscaled glyph outline curves & bounding box.

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()

fn codepoint_ids(&self) -> CodepointIdIter<'_>

Returns an iterator of all distinct (GlyphId, char) pairs. Not ordered.

fn glyph_raster_image2(&self, id: GlyphId, size: u16) -> Option<GlyphImage<'_>>

Returns a pre-rendered image of the glyph.

fn glyph_svg_image(&self, id: GlyphId) -> Option<GlyphSvg<'_>>

Returns raw SVG data of a range of glyphs which includes this one.

fn font_data(&self) -> &[u8]

Extracts a slice containing the data passed into e.g. [FontArc::try_from_slice].

fn pt_to_px_scale(&self, pt_size: f32) -> Option<PxScale>

Converts pt units into PxScale.

fn height_unscaled(&self) -> f32

Unscaled height ascent - descent.

fn glyph_raster_image( &self, id: GlyphId, pixel_size: u16 ) -> Option<GlyphImage<'_>>

👎Deprecated since 0.2.22: Deprecated in favor of glyph_raster_image2

Returns a pre-rendered image of the glyph.

fn glyph_bounds(&self, glyph: &Glyph) -> Rect

where Self: Sized,

Returns the layout bounds of this glyph. These are different to the outline px_bounds().

fn outline_glyph(&self, glyph: Glyph) -> Option<OutlinedGlyph>

where Self: Sized,

Compute glyph outline ready for drawing.

fn as_scaled<S: Into<PxScale>>(&self, scale: S) -> PxScaleFont<&Self>

where Self: Sized,

Construct a PxScaleFontRef by associating with the given pixel scale.

fn into_scaled<S: Into<PxScale>>(self, scale: S) -> PxScaleFont<Self>

where Self: Sized,

Move into a PxScaleFont associated with the given pixel scale.

impl From<FontVec> for FontArc

fn from(font: FontVec) -> Self

Converts to this type from the input type.

impl VariableFont for FontVec

fn set_variation(&mut self, axis: &[u8; 4], value: f32) -> bool

Sets a variation axis coordinate value by it’s tag.

fn variations(&self) -> Vec<VariationAxis>

Returns variation axes.