bland 0.2.0

Pure-Rust library for paper-ready, monochrome, hatch-patterned technical plots in the visual tradition of 1960s-80s engineering reports.
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

//! Theme presets and defaults.

/// Title case transform applied to figure titles by some themes.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum TitleCase {
    None,
    Upper,
    Lower,
}

/// Tick mark direction relative to the plotting frame.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum TickDirection {
    In,
    Out,
    Both,
}

/// A theme is a bag of typographic, geometric, and stroke defaults.
/// Every figure carries one. Use [`Theme::report_1972`],
/// [`Theme::blueprint`], or [`Theme::gazette`] for the built-in
/// presets, then mutate fields directly to derive variants.
#[derive(Debug, Clone)]
pub struct Theme {
    pub name: &'static str,
    // Typography
    pub font_family: &'static str,
    pub title_font_family: &'static str,
    pub label_font_family: &'static str,
    pub title_font_size: f64,
    pub subtitle_font_size: f64,
    pub axis_label_font_size: f64,
    pub tick_label_font_size: f64,
    pub legend_font_size: f64,
    pub annotation_font_size: f64,
    pub title_letter_spacing: &'static str,
    pub title_case: TitleCase,
    // Colors
    pub foreground: &'static str,
    pub background: &'static str,
    // Strokes
    pub axis_stroke_width: f64,
    pub frame_stroke_width: f64,
    pub grid_stroke_width: f64,
    pub grid_dasharray: &'static str,
    pub series_stroke_width: f64,
    pub tick_length: f64,
    pub tick_minor_length: f64,
    pub tick_direction: TickDirection,
    pub tick_stroke_width: f64,
    // Frame around plotting area
    pub frame: bool,
    // Page border around full canvas
    pub border: bool,
    pub border_stroke_width: f64,
    pub border_inset: f64,
    // Legend
    pub legend_frame: bool,
    pub legend_stroke_width: f64,
    // Marker defaults
    pub marker_size: f64,
    pub marker_stroke_width: f64,
}

impl Theme {
    /// Default: serif body, thin black rules, inward ticks, framed plot.
    pub fn report_1972() -> Self {
        Self {
            name: "report_1972",
            font_family: "Times, 'Liberation Serif', serif",
            title_font_family: "Times, 'Liberation Serif', serif",
            label_font_family: "Times, 'Liberation Serif', serif",
            title_font_size: 14.0,
            subtitle_font_size: 11.0,
            axis_label_font_size: 11.0,
            tick_label_font_size: 9.0,
            legend_font_size: 10.0,
            annotation_font_size: 9.0,
            title_letter_spacing: "0.05em",
            title_case: TitleCase::Upper,
            foreground: "black",
            background: "white",
            axis_stroke_width: 1.0,
            frame_stroke_width: 1.0,
            grid_stroke_width: 0.4,
            grid_dasharray: "2 3",
            series_stroke_width: 1.2,
            tick_length: 4.0,
            tick_minor_length: 2.0,
            tick_direction: TickDirection::In,
            tick_stroke_width: 1.0,
            frame: true,
            border: true,
            border_stroke_width: 0.8,
            border_inset: 12.0,
            legend_frame: true,
            legend_stroke_width: 0.8,
            marker_size: 4.0,
            marker_stroke_width: 1.0,
        }
    }

    /// Courier-style monospace labels, borderless axes, thicker strokes.
    pub fn blueprint() -> Self {
        Self {
            name: "blueprint",
            font_family: "'Courier New', 'Liberation Mono', monospace",
            title_font_family: "'Courier New', 'Liberation Mono', monospace",
            label_font_family: "'Courier New', 'Liberation Mono', monospace",
            title_font_size: 13.0,
            axis_label_font_size: 10.0,
            tick_label_font_size: 9.0,
            axis_stroke_width: 1.4,
            frame_stroke_width: 1.4,
            series_stroke_width: 1.4,
            grid_dasharray: "1 4",
            grid_stroke_width: 0.5,
            frame: false,
            border: true,
            border_inset: 8.0,
            tick_direction: TickDirection::In,
            tick_length: 6.0,
            ..Self::report_1972()
        }
    }

    /// Compact, high-contrast — closer to a newspaper science column.
    pub fn gazette() -> Self {
        Self {
            name: "gazette",
            font_family: "Georgia, 'Liberation Serif', serif",
            title_font_family: "Georgia, 'Liberation Serif', serif",
            title_font_size: 16.0,
            subtitle_font_size: 12.0,
            tick_label_font_size: 10.0,
            axis_label_font_size: 12.0,
            title_letter_spacing: "0.02em",
            title_case: TitleCase::None,
            frame: true,
            border: false,
            grid_dasharray: "1 5",
            series_stroke_width: 1.3,
            tick_length: 4.0,
            tick_direction: TickDirection::Out,
            ..Self::report_1972()
        }
    }

    pub fn transform_title(&self, text: &str) -> String {
        match self.title_case {
            TitleCase::None => text.to_string(),
            TitleCase::Upper => text.to_uppercase(),
            TitleCase::Lower => text.to_lowercase(),
        }
    }
}

impl Default for Theme {
    fn default() -> Self {
        Theme::report_1972()
    }
}