Struct FontData 

pub struct FontData {
    rt_font: Font<'static>,
    raw_data: RawFontData,
}

The data for a font that is cached by a FontCache.

Fields

rt_font: Font<'static>

raw_data: RawFontData

Implementations

impl FontData

pub fn new( data: Vec<u8>, builtin: Option<BuiltinFont>, ) -> Result<FontData, Error>

Loads a font from the given data.

The provided data must by readable by rusttype. If builtin is set, a built-in PDF font is used instead of embedding the font in the PDF file (see the module documentation for more information). In this case, the given font must be metrically identical to the built-in font.

Example

use genpdfi_extended::fonts::{FontData, FontFamily, FontCache};
let data = include_bytes!(concat!(env!("CARGO_MANIFEST_DIR"), "/fonts/NotoSans-Regular.ttf")).to_vec();
let fd = FontData::new(data, None).expect("font data");
let family = FontFamily { regular: fd.clone(), bold: fd.clone(), italic: fd.clone(), bold_italic: fd.clone() };
let cache = FontCache::new(family);
let _default = cache.default_font_family();

pub fn new_shared( shared_data: Arc<Vec<u8>>, builtin: Option<BuiltinFont>, ) -> Result<FontData, Error>

Creates a new FontData instance that shares the same underlying font data. This method is optimized to avoid duplicating font data when creating multiple FontData instances from the same source. Creates a new FontData instance that shares the same underlying font data. This method is optimized to avoid duplicating font data when creating multiple FontData instances from the same source.

Examples

use std::sync::Arc;
use genpdfi_extended::fonts::FontData;
let data = include_bytes!(concat!(env!("CARGO_MANIFEST_DIR"), "/fonts/NotoSans-Regular.ttf")).to_vec();
let shared = Arc::new(data);
let fd = FontData::new_shared(shared.clone(), None).expect("font data");

pub fn load( path: impl AsRef<Path>, builtin: Option<BuiltinFont>, ) -> Result<FontData, Error>

Loads the font at the given path.

The path must point to a file that can be read by rusttype. If builtin is set, a built-in PDF font is used instead of embedding the font in the PDF file (see the module documentation for more information). In this case, the given font must be metrically identical to the built-in font.

pub fn get_data(&self) -> Result<&[u8], Error>

Gets the raw font data bytes (for embedded fonts only).

Returns

• Ok(&[u8]) - The raw font bytes for embedded fonts
• Err(Error) - If this is a built-in font (which has no raw data to extract)

pub fn has_glyph(&self, c: char) -> bool

Checks if this font has a glyph for the given character.

Arguments

• c - The character to check

Returns

• true if the font contains a glyph for this character
• false if the character is missing (will render as .notdef/missing glyph)

Example

let mut p = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
p.push("fonts/NotoSans-Regular.ttf");
let font_data = FontData::load(&p, None).unwrap();
assert!(font_data.has_glyph('ă'));

pub fn check_coverage(&self, text: &str) -> GlyphCoverage

Analyzes glyph coverage for the given text.

This method checks which characters in the text are supported by this font and returns detailed coverage statistics.

Arguments

• text - The text to analyze

Returns

A GlyphCoverage struct containing coverage statistics and missing characters

Example

let mut p = PathBuf::from(env!("CARGO_MANIFEST_DIR"));
p.push("fonts/NotoSans-Regular.ttf");
let font_data = FontData::load(&p, None).unwrap();
let coverage = font_data.check_coverage("Hello ăâîșț!");
assert!(coverage.coverage_percent() > 0.0);

Trait Implementations

impl Clone for FontData

fn clone(&self) -> FontData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FontData

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

Formats the value using the given formatter.