charton 0.5.0

A high-performance, layered charting system for Rust, featuring a flexible data core and multi-backend rendering.
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

/// Represents different geometric shapes for data points.
/// Supports conversion from strings for a fluent API and provides
/// integer IDs for GPU-accelerated rendering.
#[derive(Clone, Copy, Debug, PartialEq, Eq)] // Added Copy/Eq for easier usage
#[derive(Default)]
pub enum PointShape {
    #[default]
    Circle = 0,
    Square = 1,
    Triangle = 2,
    Star = 3,
    Diamond = 4,
    Pentagon = 5,
    Hexagon = 6,
    Octagon = 7,
}

impl PointShape {
    /// Returns a unique integer ID for the shape.
    /// This is crucial for passing shape data to GPU shaders (wgpu).
    pub fn gpu_id(&self) -> u32 {
        *self as u32
    }

    /// Shapes used for default mapping in legends.
    pub(crate) const LEGEND_SHAPES: &'static [PointShape] = &[
        PointShape::Circle,
        PointShape::Square,
        PointShape::Triangle,
        PointShape::Star,
        PointShape::Diamond,
        PointShape::Pentagon,
        PointShape::Hexagon,
        PointShape::Octagon,
    ];
}

// --- Fluent API Support: From string literals ---

impl From<&str> for PointShape {
    /// Converts a string like "circle" or "square" into a PointShape.
    /// Defaults to Circle if the string is unrecognized.
    fn from(s: &str) -> Self {
        match s.to_lowercase().as_str() {
            "circle" => PointShape::Circle,
            "square" => PointShape::Square,
            "triangle" => PointShape::Triangle,
            "star" => PointShape::Star,
            "diamond" => PointShape::Diamond,
            "pentagon" => PointShape::Pentagon,
            "hexagon" => PointShape::Hexagon,
            "octagon" => PointShape::Octagon,
            _ => PointShape::Circle, // Robust fallback
        }
    }
}

impl From<String> for PointShape {
    fn from(s: String) -> Self {
        PointShape::from(s.as_str())
    }
}