iced_plot 0.5.0

A GPU-accelerated plotting widget for Iced.
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

use std::sync::Arc;

use iced::{Color, Theme, border, widget::container};

/// Produces a [`PlotStyle`] from a given application theme.
pub(crate) type StyleFn = Arc<dyn Fn(&Theme) -> PlotStyle + Send + Sync>;

/// Configures the appearance of a [`PlotWidget`](crate::PlotWidget).
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub struct PlotStyle {
    /// Style for the outer frame surrounding labels, ticks, overlays, and plot area.
    pub frame: container::Style,

    /// Style for the inner plot area behind the GPU-rendered canvas.
    pub plot_area: container::Style,

    /// Style for the legend panel.
    pub legend: container::Style,

    /// Style for the controls/help panel.
    pub controls_panel: container::Style,

    /// Style for the cursor-position overlay bubble.
    pub cursor_overlay: container::Style,

    /// Style for point tooltip bubbles.
    pub tooltip: container::Style,

    /// Style for grid lines rendered inside the plot area.
    pub grid: GridStyle,

    /// Color of tick labels rendered around the plot area.
    pub tick_label_color: Color,

    /// Color of axis labels rendered around the plot area.
    pub axis_label_color: Color,
}

/// Configures the appearance of grid lines inside the plot area.
#[derive(Debug, Clone, Copy, PartialEq, Default)]
pub struct GridStyle {
    /// Color of major grid lines.
    pub major: Color,

    /// Color of minor grid lines.
    pub minor: Color,

    /// Color of sub-minor grid lines.
    pub sub_minor: Color,
}

/// Returns the default plot style derived from the current application theme.
pub fn default_style(theme: &Theme) -> PlotStyle {
    let palette = theme.extended_palette();
    let grid_base = palette.background.base.text;

    PlotStyle {
        frame: container::background(theme.palette().background),
        plot_area: container::background(theme.palette().background),
        legend: container::Style {
            background: Some(palette.background.weakest.color.into()),
            text_color: Some(palette.background.weakest.text),
            border: iced::Border {
                width: 1.0,
                radius: 5.0.into(),
                color: palette.background.weak.color,
            },
            ..container::Style::default()
        },
        controls_panel: container::Style {
            background: Some(palette.background.weak.color.into()),
            text_color: Some(palette.background.weak.text),
            border: border::rounded(2),
            ..container::Style::default()
        },
        cursor_overlay: container::Style {
            background: Some(palette.background.weak.color.into()),
            text_color: Some(palette.background.weak.text),
            border: border::rounded(2),
            ..container::Style::default()
        },
        tooltip: container::Style {
            background: Some(palette.background.weak.color.scale_alpha(0.7).into()),
            text_color: Some(palette.background.weak.text.scale_alpha(0.7)),
            border: border::rounded(2),
            ..container::Style::default()
        },
        grid: GridStyle {
            major: with_alpha(grid_base, 0.45),
            minor: with_alpha(grid_base, 0.28),
            sub_minor: with_alpha(grid_base, 0.10),
        },
        tick_label_color: palette.background.base.text,
        axis_label_color: palette.background.strong.text,
    }
}

fn with_alpha(color: Color, alpha: f32) -> Color {
    Color { a: alpha, ..color }
}