rust-fontconfig 3.1.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

//! Character resolution example
//!
//! Demonstrates how to resolve individual characters to fonts using font chains.
//! Useful for debugging font coverage issues (e.g. CJK, emoji, symbols).
//!
//! Run with:
//!   cargo run --example character_resolution

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

fn main() {
    let cache = FcFontCache::build();

    // Create a font chain with typical web defaults
    let families = vec!["system-ui".to_string(), "sans-serif".to_string()];

    let chain = cache.resolve_font_chain(
        &families,
        FcWeight::Normal,
        PatternMatch::False,
        PatternMatch::False,
        &mut Vec::new(),
    );

    // Test characters from different Unicode blocks
    let test_chars = [
        ('A', "Latin Capital Letter A"),
        ('a', "Latin Small Letter A"),
        ('0', "Digit Zero"),
        ('€', "Euro Sign"),
        ('→', "Rightwards Arrow"),
        ('中', "CJK Ideograph - China"),
        ('日', "CJK Ideograph - Sun/Day"),
        ('あ', "Hiragana Letter A"),
        ('ア', "Katakana Letter A"),
        ('한', "Hangul Syllable Han"),
        ('א', "Hebrew Letter Alef"),
        ('ا', "Arabic Letter Alef"),
        ('α', "Greek Small Letter Alpha"),
        ('я', "Cyrillic Small Letter Ya"),
        ('🙂', "Slightly Smiling Face"),
        ('♠', "Black Spade Suit"),
        ('∑', "N-ary Summation"),
        ('∞', "Infinity"),
    ];

    println!("Character resolution results:\n");
    println!("{:<6} {:<30} {:<40}", "Char", "Description", "Font");
    println!("{}", "-".repeat(76));

    for (ch, description) in &test_chars {
        let text = ch.to_string();
        let resolved = chain.resolve_text(&cache, &text);

        let font_name = resolved
            .first()
            .and_then(|(_, info)| info.as_ref())
            .and_then(|(id, _)| cache.get_metadata_by_id(id))
            .and_then(|m| m.name.clone().or(m.family.clone()))
            .unwrap_or_else(|| "⚠ NOT FOUND".to_string());

        println!("{:<6} {:<30} {}", ch, description, font_name);
    }

    // Check specific font coverage
    println!("\n\nArial coverage check:");
    let arial_chain = cache.resolve_font_chain(
        &["Arial".to_string()],
        FcWeight::Normal,
        PatternMatch::False,
        PatternMatch::False,
        &mut Vec::new(),
    );

    let arial_result = cache.query(
        &rust_fontconfig::FcPattern {
            family: Some("Arial".to_string()),
            ..Default::default()
        },
        &mut Vec::new(),
    );

    if let Some(arial_match) = arial_result {
        for ch in ['A', '中', '🙂', '→'] {
            let resolved = arial_chain.resolve_text(&cache, &ch.to_string());
            let in_arial = resolved
                .first()
                .and_then(|(_, info)| info.as_ref())
                .map(|(id, _)| id == &arial_match.id)
                .unwrap_or(false);

            println!(
                "  {} '{}' (U+{:04X})",
                if in_arial { "✓" } else { "✗" },
                ch,
                ch as u32
            );
        }
    } else {
        println!("  Arial not found on this system");
    }
}