KiThePlot 0.5.0

KiThePlot is a standalone/embeddable plot redactor (plotting library) written in 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
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

//! Core reusable types for plot configuration and styling.
//!
//! These types are intentionally renderer-agnostic and form the stable contract
//! between UI/controller logic and rendering backends.

/// Stable identifier of a plotted series.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
pub struct SeriesId(pub u64);

/// Pair of x/y axis configurations.
#[derive(Clone, Debug)]
pub struct AxesConfig {
    pub x: AxisConfig,
    pub y: AxisConfig,
}

/// Full axis setup edited by axis controls.
#[derive(Clone, Debug)]
pub struct AxisConfig {
    pub label: String,
    pub axis_title_font_size: u32,
    pub label_font_size: u32,
    pub scale: ScaleType,
    pub range: RangePolicy,
    pub ticks: TickConfig,
}

/// Axis transformation mode.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum ScaleType {
    Linear,
    Log10,
    LogE,
}

/// Axis range policy (`Auto` from data or fixed manual bounds).
#[derive(Clone, Debug)]
pub enum RangePolicy {
    Auto,
    Manual { min: f64, max: f64 },
}

/// Tick density controls used by mesh configuration.
#[derive(Clone, Debug)]
pub struct TickConfig {
    pub major_step: Option<f64>,
    pub minor_per_major: u16,
}

/// Chart legend configuration.
#[derive(Clone, Debug)]
pub struct LegendConfig {
    pub visible: bool,
    pub title: Option<String>,
    pub position: LegendPosition,
    pub font_size: u32,
    pub font_color: Color,
}

/// Legend position inside plot area.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum LegendPosition {
    TopLeft,
    TopRight,
    BottomLeft,
    BottomRight,
}

/// Layout-level settings of the plot area and title style.
#[derive(Clone, Debug)]
pub struct LayoutConfig {
    pub title: String,
    pub x_label_area_size: u32,
    pub y_label_area_size: u32,
    pub margin: u32,
    pub title_font_size: u32,
    pub title_font_color: Color,
}

/// RGBA color in 8-bit channels.
#[derive(Clone, Copy, Debug)]
pub struct Color {
    pub r: u8,
    pub g: u8,
    pub b: u8,
    pub a: u8,
}

/// Visual style of one plotted series.
#[derive(Clone, Debug)]
pub struct SeriesStyle {
    pub color: Color,
    pub line_width: f32,
    pub line_style: LineStyle,
    pub marker: Option<MarkerStyle>,
}

/// Line pattern used for a series.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum LineStyle {
    Solid,
    Dashed,
    Dotted,
}

/// Marker configuration for point rendering.
#[derive(Clone, Debug)]
pub struct MarkerStyle {
    pub shape: MarkerShape,
    pub size: f32,
}

/// Marker shape variants.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum MarkerShape {
    Circle,
    Square,
    Triangle,
    Cross,
}

/// Axis selector for generic axis actions.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub enum AxisKind {
    X,
    Y,
}

/// Supported export image formats.
#[derive(Clone, Copy, Debug)]
pub enum ImageFormat {
    Png,
    Svg,
}

/// Export output pixel dimensions.
#[derive(Clone, Copy, Debug)]
pub struct ImageSize {
    pub width: u32,
    pub height: u32,
}