esoc-chart 0.1.0

High-level charting API built on esoc-gfx — matplotlib-equivalent for Rust
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

// SPDX-License-Identifier: MIT OR Apache-2.0
//! Chart themes controlling colors, fonts, and visual style.

use esoc_gfx::color::Color;
use esoc_gfx::palette::Palette;

/// A theme controlling the visual appearance of charts.
#[derive(Clone, Debug)]
pub struct Theme {
    /// Background color.
    pub background: Color,
    /// Foreground color (text, axes, ticks).
    pub foreground: Color,
    /// Color palette for data series.
    pub palette: Palette,
    /// Grid line color.
    pub grid_color: Color,
    /// Grid line width.
    pub grid_width: f64,
    /// Whether to show grid lines.
    pub show_grid: bool,
    /// Title font size.
    pub title_font_size: f64,
    /// Axis label font size.
    pub label_font_size: f64,
    /// Tick label font size.
    pub tick_font_size: f64,
    /// Legend font size.
    pub legend_font_size: f64,
    /// Font family.
    pub font_family: String,
    /// Axis line width.
    pub axis_width: f64,
    /// Default data line width.
    pub line_width: f64,
    /// Default scatter point radius.
    pub point_radius: f64,
}

impl Theme {
    /// Default light theme.
    pub fn light() -> Self {
        Self {
            background: Color::WHITE,
            foreground: Color::BLACK,
            palette: Palette::tab10(),
            grid_color: Color::new(0.9, 0.9, 0.9, 1.0),
            grid_width: 0.5,
            show_grid: true,
            title_font_size: 16.0,
            label_font_size: 13.0,
            tick_font_size: 11.0,
            legend_font_size: 11.0,
            font_family: "sans-serif".to_string(),
            axis_width: 1.0,
            line_width: 2.0,
            point_radius: 4.0,
        }
    }

    /// Dark theme.
    pub fn dark() -> Self {
        Self {
            background: Color::from_rgb8(0x1e, 0x1e, 0x2e),
            foreground: Color::from_rgb8(0xcd, 0xd6, 0xf4),
            palette: Palette::tab10(),
            grid_color: Color::new(0.3, 0.3, 0.35, 1.0),
            grid_width: 0.5,
            show_grid: true,
            title_font_size: 16.0,
            label_font_size: 13.0,
            tick_font_size: 11.0,
            legend_font_size: 11.0,
            font_family: "sans-serif".to_string(),
            axis_width: 1.0,
            line_width: 2.0,
            point_radius: 4.0,
        }
    }

    /// Minimal theme — no grid, thin axes.
    pub fn minimal() -> Self {
        Self {
            background: Color::WHITE,
            foreground: Color::from_rgb8(0x33, 0x33, 0x33),
            palette: Palette::tab10(),
            grid_color: Color::TRANSPARENT,
            grid_width: 0.0,
            show_grid: false,
            title_font_size: 14.0,
            label_font_size: 12.0,
            tick_font_size: 10.0,
            legend_font_size: 10.0,
            font_family: "sans-serif".to_string(),
            axis_width: 0.5,
            line_width: 1.5,
            point_radius: 3.0,
        }
    }
}

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