euv-chart 0.32.9

A high-performance charting library for the euv framework, providing an ECharts-compatible option model with WebGPU, WebGL2, and Canvas2D backends behind one API.
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 super::*;

/// A point on the globe.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct GeoPoint {
    /// The longitude, in degrees.
    pub lng: f64,
    /// The latitude, in degrees.
    pub lat: f64,
}

/// The box a map covers.
#[derive(Clone, Copy, Debug, lombok_macros::Data, PartialEq)]
pub struct GeoBounds {
    /// The westernmost longitude.
    #[get(type(copy))]
    pub min_lng: f64,
    /// The southernmost latitude.
    #[get(type(copy))]
    pub min_lat: f64,
    /// The easternmost longitude.
    #[get(type(copy))]
    pub max_lng: f64,
    /// The northernmost latitude.
    #[get(type(copy))]
    pub max_lat: f64,
}

/// One outline of a region: an outer ring, and the holes in it.
///
/// A region is made of one or more outlines: a country with an
/// enclave, or an archipelago, has more than one.
#[derive(Clone, Debug, Default, PartialEq)]
pub struct RegionPolygon {
    /// The outer ring of the outline.
    pub outer: Vec<GeoPoint>,
    /// The holes of the outline — the lakes and the enclaves that are
    /// not part of the region.
    pub holes: Vec<Vec<GeoPoint>>,
}

/// One region of a map.
///
/// The name of the region is what the series' data is matched
/// against: a data item whose name is the name of a region gives that
/// region its value.
#[derive(Clone, Debug, Default, lombok_macros::Data, PartialEq)]
pub struct MapRegion {
    /// The name of the region.
    pub name: String,
    /// The outlines of the region.
    pub polygons: Vec<RegionPolygon>,
}

/// One map: the regions it is made of, and the box they cover.
#[derive(Clone, Debug, Default, lombok_macros::Data, PartialEq)]
pub struct MapData {
    /// The name the map is registered under.
    pub name: String,
    /// The regions of the map.
    pub regions: Vec<MapRegion>,
    /// The box the regions cover.
    pub bounds: GeoBounds,
}

/// The maps a chart can draw.
///
/// The registry is what turns a map series into a picture: the series
/// names the map it wants, and the registry holds the geometry. The
/// geometry is kept out of the option on purpose — a map of a country
/// is megabytes of coordinates, and it is the same for every chart
/// that draws it.
#[derive(Clone, Debug, Default, lombok_macros::Data, PartialEq)]
pub struct MapRegistry {
    /// The maps of the registry, by name.
    pub maps: BTreeMap<String, MapData>,
}

/// One region of a map, in pixel space.
#[derive(Clone, Debug, lombok_macros::Data, PartialEq)]
pub struct GeoRegionLayout {
    /// The name of the region.
    pub name: String,
    /// The outline of the region, projected into the chart.
    pub path: Path,
    /// The middle of the region, where its label goes.
    pub center: Point,
}

/// A map, in pixel space.
#[derive(Clone, Debug, lombok_macros::Data, PartialEq)]
pub struct GeoLayout {
    /// The name of the map.
    pub name: String,
    /// The regions of the map, projected into the chart.
    pub regions: Vec<GeoRegionLayout>,
    /// The transform that takes a longitude and a latitude to a point of
    /// the chart.
    pub transform: Transform2D,
}