Struct FontCache 

pub struct FontCache {
    fonts: Vec<FontData>,
    pdf_fonts: Vec<IndirectFontRef>,
    default_font_family: Option<FontFamily<Font>>,
    embedded_font_cache: HashMap<*const Vec<u8>, IndirectFontRef>,
}

Stores font data that can be referenced by a Font or FontFamily.

If you use the high-level interface provided by Document, you don’t have to access this type. See the module documentation for details on the internals.

Fields

fonts: Vec<FontData>

pdf_fonts: Vec<IndirectFontRef>

default_font_family: Option<FontFamily<Font>>

embedded_font_cache: HashMap<*const Vec<u8>, IndirectFontRef>

Implementations

impl FontCache

pub fn new(default_font_family: FontFamily<FontData>) -> FontCache

Creates a new font cache with the given default font family. Creates a new font cache with the given default font family.

Examples

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.clone(), 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 add_font(&mut self, font_data: FontData) -> Font

Adds the given font to the cache and returns a reference to it. Adds the given font to the cache and returns a reference to it.

Examples

use genpdfi_extended::fonts::FontData;
use genpdfi_extended::fonts::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 mut cache = FontCache::new(genpdfi_extended::fonts::FontFamily { regular: fd.clone(), bold: fd.clone(), italic: fd.clone(), bold_italic: fd.clone() });
let f = cache.add_font(fd.clone());
let _rt = cache.get_rt_font(f);

pub fn add_font_family( &mut self, family: FontFamily<FontData>, ) -> FontFamily<Font>

Adds the given font family to the cache and returns a reference to it.

pub fn load_pdf_fonts(&mut self, renderer: &mut Renderer) -> Result<(), Error>

Embeds all loaded fonts into the document generated by the given renderer and caches a reference to them. Embeds all loaded fonts into the document generated by the given renderer and caches a reference to them.

Examples

use genpdfi_extended::fonts::{FontData, FontFamily, FontCache};
use genpdfi_extended::render::Renderer;
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 mut cache = FontCache::new(family);
let mut r = Renderer::new(genpdfi_extended::Size::new(210.0, 297.0), "ex").expect("renderer");
cache.load_pdf_fonts(&mut r).expect("load fonts");

pub fn default_font_family(&self) -> FontFamily<Font>

Returns the default font family for this font cache.

pub fn get_pdf_font(&self, font: Font) -> Option<&IndirectFontRef>

Returns a reference to the emebdded PDF font for the given font, if available.

This method may only be called with Font instances that have been created by this font cache. PDF fonts are only avaiable if load_pdf_fonts has been called.

pub fn get_rt_font(&self, font: Font) -> &Font<'static>

Returns a reference to the Rusttype font for the given font, if available.

This method may only be called with Font instances that have been created by this font cache.

Trait Implementations

impl Debug for FontCache

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

Formats the value using the given formatter.