zenthra-text 0.1.1

Typography, font shaping, and text layout for the Zenthra UI framework
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

use cosmic_text::{Attrs, Buffer, Family, Metrics, Shaping, Style, Weight};
use zenthra_core::Color;

/// Input properties for text shaping.
#[derive(Debug, Clone)]
pub struct TextProperties {
    pub text: String,
    pub font_size: f32,
    pub line_height: f32, // multiplier, e.g. 1.2
    pub color: Color,
    pub family: TextFamily,
    pub weight: u16, // 100–900
    pub italic: bool,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum TextFamily {
    SansSerif,
    Serif,
    Monospace,
    Cursive,
    Fantasy,
    Named(String),
}

impl Default for TextProperties {
    fn default() -> Self {
        Self {
            text: String::new(),
            font_size: 16.0,
            line_height: 1.2,
            color: Color::WHITE,
            family: TextFamily::SansSerif,
            weight: 400,
            italic: false,
        }
    }
}

/// Result of shaping a `TextProperties` — owns the cosmic-text Buffer.
pub struct ShapedText {
    pub buffer: Buffer,
}

impl ShapedText {
    pub fn shape(
        font_system: &mut cosmic_text::FontSystem,
        props: &TextProperties,
        max_width: Option<f32>,
    ) -> Self {
        let line_px = props.font_size * props.line_height;
        let metrics = Metrics::new(props.font_size, line_px);
        let mut buf = Buffer::new(font_system, metrics);

        let family = match &props.family {
            TextFamily::SansSerif => Family::SansSerif,
            TextFamily::Serif => Family::Serif,
            TextFamily::Monospace => Family::Monospace,
            TextFamily::Cursive => Family::Cursive,
            TextFamily::Fantasy => Family::Fantasy,
            TextFamily::Named(name) => Family::Name(name.as_str()),
        };

        let color = cosmic_text::Color::rgba(
            (props.color.r * 255.0) as u8,
            (props.color.g * 255.0) as u8,
            (props.color.b * 255.0) as u8,
            (props.color.a * 255.0) as u8,
        );

        let attrs = Attrs::new()
            .family(family)
            .weight(Weight(props.weight))
            .style(if props.italic {
                Style::Italic
            } else {
                Style::Normal
            })
            .color(color);

        buf.set_size(font_system, max_width, None);
        buf.set_text(font_system, &props.text, &attrs, Shaping::Advanced, None);
        buf.shape_until_scroll(font_system, false);

        Self { buffer: buf }
    }
}