webfont-generator 0.5.0

Generate webfonts (SVG, TTF, EOT, WOFF, WOFF2) from SVG icons
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

use std::collections::{BTreeMap, HashMap};

use usvg::tiny_skia_path::Path as TinyPath;

use crate::types::LoadedSvgFile;

pub(crate) struct SvgOptions<'a> {
    pub ascent: Option<f64>,
    pub center_horizontally: Option<bool>,
    pub center_vertically: Option<bool>,
    pub codepoints: &'a BTreeMap<String, u32>,
    pub descent: Option<f64>,
    pub fixed_width: Option<bool>,
    pub font_height: Option<f64>,
    pub font_id: Option<&'a str>,
    pub font_name: &'a str,
    pub font_style: Option<&'a str>,
    pub font_weight: Option<&'a str>,
    pub ligature: bool,
    pub metadata: Option<&'a str>,
    pub normalize: bool,
    pub optimize_output: Option<bool>,
    pub preserve_aspect_ratio: Option<bool>,
    pub round: Option<f64>,
}

#[derive(Clone)]
pub(crate) struct ParsedGlyph {
    pub codepoint: u32,
    pub height: f64,
    pub index: usize,
    pub name: String,
    pub paths: Vec<TinyPath>,
    pub width: f64,
}

pub(crate) struct GlyphWorkItem<'a> {
    pub codepoint: u32,
    pub index: usize,
    pub name: &'a str,
    pub source_file: &'a LoadedSvgFile,
}

#[derive(Clone)]
pub(crate) struct ProcessedGlyph {
    pub codepoint: u32,
    pub height: f64,
    pub index: usize,
    pub name: String,
    pub path_data: String,
    pub unicode_values: Vec<String>,
    pub width: f64,
}

#[derive(Clone)]
pub(crate) struct CachedProcessedGlyph {
    pub height: f64,
    pub path_data: String,
    pub width: f64,
}

#[derive(Clone)]
pub(crate) struct PreparedSvgFont {
    pub ascent: f64,
    pub descent: f64,
    pub font_height: f64,
    pub font_id: String,
    pub font_width: f64,
    pub metadata: String,
    pub processed_glyphs: Vec<ProcessedGlyph>,
}

/// The content-derived geometry of one parsed glyph (everything in [`ParsedGlyph`] except the
/// assigned `codepoint`/`index`/`name`, which are reassigned on every build). Cached so an
/// incremental rebuild can reuse a glyph whose SVG source didn't change.
#[derive(Clone)]
pub(crate) struct CachedGlyph {
    pub height: f64,
    pub paths: Vec<TinyPath>,
    pub width: f64,
}

/// Per-file parsed-glyph cache keyed by file path, retained on a `GenerateWebfontsResult` when
/// `incremental` is enabled. A present entry is treated as up to date: `regenerate` evicts the
/// paths it was told changed, so the rest can be reused without re-reading or re-hashing them.
#[derive(Clone, Default)]
pub(crate) struct GlyphCache {
    /// Parsed geometry keyed by path for the current/last known file set.
    pub entries: HashMap<String, CachedGlyph>,
    /// Last seen source hash per path, used to ignore no-op watcher events.
    pub content_hashes: HashMap<String, [u8; 16]>,
    /// Parsed geometry keyed by SVG source bytes so added/renamed duplicate icons can reuse it.
    pub by_content_hash: HashMap<[u8; 16], CachedGlyph>,
    /// Processed path data keyed by path for unchanged files while metrics/options stay stable.
    pub processed_entries: HashMap<String, CachedProcessedGlyph>,
    pub processed_signature: Option<[u8; 16]>,
    #[cfg(test)]
    pub parse_count: usize,
    #[cfg(test)]
    pub process_count: usize,
}