artano 0.3.13

Adds text to pictures.
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

mod annotation;
mod canvas;
mod draw;
mod error;

pub use annotation::*;
pub use canvas::*;
pub use error::Error;
pub use rusttype::Font;

const AA_FACTOR: u32 = 3;
const AA_FACTOR_FLOAT: f32 = 3.0;

pub type Result<T, E = Error> = std::result::Result<T, E>;

/// Load a font face by name.
///
/// This will work only if your system actually has a font of the given name. Unfortunately,
/// licensing restrictions on fonts pretty much require this kind of nonsense.
pub fn load_font<'a>(name: &str) -> Result<Font<'a>> {
    use font_kit::{handle::Handle, source::SystemSource};

    let font = SystemSource::new()
        .select_by_postscript_name(name)
        .map_err(|_| Error::Font(name.into()))?;

    // I have a sneaking suspicion that only one of these paths will ever be exercised, but I have
    // no way of knowing that for sure. Thank God for documentation, right? On Windows, the Path
    // variant is definitely the one exercised.
    let font = match font {
        Handle::Path { path, font_index } => {
            Font::try_from_vec_and_index(std::fs::read(path)?, font_index)
        }
        Handle::Memory { bytes, font_index } => {
            // Sharing font data sucks.
            Font::try_from_vec_and_index(bytes.iter().cloned().collect(), font_index)
        }
    };

    font.ok_or_else(|| Error::Font(name.into()))
}

#[test]
fn test_impact() {
    let _font = load_font("Impact").unwrap();
}