rust-fontconfig 5.0.0

Pure-Rust alternative to font-loader and fontconfig w. minimal dependencies
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
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Shows how to query by family name, style, generic families, list fonts,
//! and search by name substring.
//!
//! Run with: cargo run --example query

use rust_fontconfig::{FcFontCache, FcPattern, FcWeight, PatternMatch};

fn main() {
    println!("Building font cache...");
    let cache = FcFontCache::build();
    println!("Font cache built with {} fonts\n", cache.list().len());

    // Query by family name
    println!("Query by Family Name");
    let mut trace = Vec::new();
    let pattern = FcPattern {
        family: Some("Arial".to_string()),
        ..Default::default()
    };

    if let Some(result) = cache.query(&pattern, &mut trace) {
        println!("Found Arial:");
        println!("  Font ID: {:?}", result.id);
        if let Some(meta) = cache.get_metadata_by_id(&result.id) {
            println!("  Family: {:?}", meta.family);
            println!("  Weight: {:?}", meta.weight);
            println!("  Italic: {:?}", meta.italic);
        }
        if let Some(source) = cache.get_font_by_id(&result.id) {
            match source {
                rust_fontconfig::OwnedFontSource::Disk(path) => println!("  Path: {}", path.path),
                rust_fontconfig::OwnedFontSource::Memory(font) => {
                    println!("  Memory font: {}", font.id)
                }
            }
        }
    } else {
        println!("Arial not found");
    }

    // Query generic family
    println!("\nQuery Generic 'serif'");
    trace.clear();
    if let Some(result) = cache.query(
        &FcPattern {
            family: Some("serif".to_string()),
            ..Default::default()
        },
        &mut trace,
    ) {
        if let Some(meta) = cache.get_metadata_by_id(&result.id) {
            println!("Found: {:?}", meta.name.as_ref().or(meta.family.as_ref()));
        }
    }

    // Query by style (bold + italic)
    println!("\nQuery Bold Italic");
    trace.clear();
    if let Some(result) = cache.query(
        &FcPattern {
            family: Some("sans-serif".to_string()),
            weight: FcWeight::Bold,
            italic: PatternMatch::True,
            ..Default::default()
        },
        &mut trace,
    ) {
        if let Some(meta) = cache.get_metadata_by_id(&result.id) {
            println!(
                "Found: {:?} weight={:?} italic={:?}",
                meta.name.as_ref().or(meta.family.as_ref()),
                meta.weight,
                meta.italic
            );
        }
    }

    // List bold fonts
    println!("\nFirst 5 Bold Fonts");
    for (meta, id) in cache
        .list()
        .into_iter()
        .filter(|(m, _)| {
            matches!(
                m.weight,
                FcWeight::Bold | FcWeight::ExtraBold | FcWeight::Black
            )
        })
        .take(5)
    {
        println!(
            "  {:?}: {:?}",
            id,
            meta.name.as_ref().or(meta.family.as_ref())
        );
    }

    // Search by name substring
    println!("\nFonts with 'Mono' in name");
    for (meta, _id) in cache
        .list()
        .into_iter()
        .filter(|(m, _)| {
            m.name.as_ref().map(|n| n.contains("Mono")).unwrap_or(false)
                || m.family
                    .as_ref()
                    .map(|f| f.contains("Mono"))
                    .unwrap_or(false)
        })
        .take(10)
    {
        println!("  {:?}", meta.name.as_ref().or(meta.family.as_ref()));
    }
}