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
#[derive(Debug, Clone)]
pub(crate) struct Scene {
pub width: u32,
pub height: u32,
pub elements: Vec<Element>,
}
#[derive(Debug, Clone)]
pub(crate) enum Element {
Circle(Circle),
Line(Line),
Polyline(Polyline),
/// The filled outline of a topic map area and the center it was placed around. The SVG
/// carries that center as `data-cx`/`data-cy`, so a host page need not recompute it from the
/// outline.
TopicArea(Polyline, (f64, f64)),
Rect(Rect),
SeriesText(Text, usize),
/// Text the layout decides more about than its class can say: a topic map sizes an area's
/// name by how much room that area has, and ties it to the area it names.
StyledText(Text, TextStyle),
Text(Text),
/// Draws nothing: a `data-*` hook for the optional interactive module, written only with the
/// `hooks` render option.
Hook(Hook),
}
/// The geometry and grouping the interactive module reads from a chart, see [`Element::Hook`].
#[derive(Debug, Clone)]
pub(crate) enum Hook {
/// The plot of one pane: `x` maps the time or category axis as `(value, pixel)` pairs, linear
/// between neighbours; `y` maps the value axis by its two ends, linear or, when `log`, linear
/// in the logarithm of the value.
Plot {
pane: usize,
x: Vec<(f64, f64)>,
y: [(f64, f64); 2],
log: bool,
},
/// Opens a group around what one layer draws, by its index among all layers of all panes.
Layer(usize),
/// Closes the group of the last [`Hook::Layer`].
End,
}
/// What the layout knows about a piece of text beyond its class.
#[derive(Debug, Clone, Copy, Default)]
pub(crate) struct TextStyle {
/// Font size in pixels, when the layout rather than the stylesheet decides it.
pub size: Option<f64>,
/// The area this text belongs to, see [`Polyline::topic`].
pub topic: Option<usize>,
}
#[derive(Debug, Clone)]
pub(crate) struct Circle {
pub cx: f64,
pub cy: f64,
pub radius: f64,
pub class: &'static str,
/// The area this belongs to, see [`Polyline::topic`].
pub topic: Option<usize>,
/// Series index (0-based) for multi-series charts; used for CSS filtering.
pub series_index: Option<usize>,
/// Index into the specification-declared colors, see [`Polyline`].
pub style_index: Option<usize>,
/// Accessible tooltip text displayed on hover via `<title>`.
pub tooltip: Option<String>,
}
#[derive(Debug, Clone)]
pub(crate) struct Line {
pub x1: f64,
pub y1: f64,
pub x2: f64,
pub y2: f64,
pub class: &'static str,
}
#[derive(Debug, Clone)]
pub(crate) struct Rect {
pub x: f64,
pub y: f64,
pub width: f64,
pub height: f64,
pub class: &'static str,
/// Series index (0-based) for multi-series charts; used for CSS filtering.
pub series_index: Option<usize>,
/// Index into the specification-declared colors, see [`Polyline`].
pub style_index: Option<usize>,
/// Accessible tooltip text displayed on hover via `<title>`.
pub tooltip: Option<String>,
}
#[derive(Debug, Clone)]
pub(crate) struct Polyline {
pub points: Vec<(f64, f64)>,
pub class: &'static str,
/// The index of the topic map area this belongs to, written out as a `chartlet-topic-N`
/// class. It is what lets the selection styles address one area without any scripting.
pub topic: Option<usize>,
/// Series index (0-based) for multi-series charts; used for CSS filtering.
pub series_index: Option<usize>,
/// Index into the specification-declared colors: a polyline is painted by
/// `.chartlet-style-N` (stroke), a rect by `.chartlet-style-N-swatch` (fill).
pub style_index: Option<usize>,
/// Accessible tooltip text displayed on hover via `<title>`.
pub tooltip: Option<String>,
}
#[derive(Debug, Clone, Copy)]
pub(crate) enum TextAnchor {
Start,
Middle,
End,
}
#[derive(Debug, Clone)]
pub(crate) struct Text {
pub x: f64,
pub y: f64,
pub class: &'static str,
pub anchor: TextAnchor,
pub content: String,
}