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
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
//! Turning pointer travel along a handle into a snapped angle, mast or index value, and
//! the coalescing key one drag gesture shares.
use ;
use crateclamp_nudge_to_side;
use tier_is_crown_side;
/// A facet is never steeper than a vertical wall.
const MAX_ANGLE_DEG: f64 = 90.0;
/// Below this many pixels per unit a handle is edge-on to the view: dragging it would
/// divide by (almost) zero, so the value stays where it was.
const MIN_PIXELS_PER_UNIT: f32 = 1e-6;
/// Tags a drag key so it never equals another key family's value in practice.
const DRAG_KEY_TAG: u64 = 0xD4A6_0000_0000_0000;
/// How finely a drag snaps. Shift selects [`Self::Fine`]; the toolbar's Snap pill
/// selects [`Self::Off`]. The index handle rounds to whole teeth in every mode.
/// What a drag gesture captured at pointer-down: the handle, the quantities it started
/// from, where the pointer was, and the handle layout it is measured against.
/// The value a drag currently asks for, by handle kind.
/// `value` rounded to the nearest multiple of `step`, tidied so `413 * 0.1` reads
/// `41.3` rather than `41.300000000000004`. A non-positive or NaN `step` returns
/// `value` unchanged; a negative zero stays negative.
/// Pointer travel from the drag start, projected on the unit screen direction `dir`,
/// expressed in units at `pixels_per_unit`. Zero when the handle is edge-on.
/// The value a drag asks for with the pointer at `pointer`, `snap` applied.
///
/// - **Angle**: `start_angle` plus the pointer travel along `angle_dir` divided by
/// `pixels_per_degree`, snapped, then held to the tier's own side of zero by
/// [`clamp_nudge_to_side`] (so a crown tier stops at `+0.0`, a pavilion tier at
/// `-0.0`) and to at most 90 degrees. The travel counts toward a larger `|angle|`,
/// which is a larger angle on the crown and a MORE negative one on the pavilion --
/// the way the handle's tip points.
/// - **Mast**: keeps `start_mast`'s sign; the magnitude is `|start|` plus the travel
/// along `depth_dir` divided by `pixels_per_mast_unit`, never below 0, then snapped.
/// Dragging along `+depth_dir` (the outward normal) grows the magnitude.
/// - **Index**: the travel along `index_dir` in whole teeth (rounded), whatever `snap`
/// says.
///
/// A handle that is edge-on to the view (pixels-per-unit about 0) keeps its start value.
/// The coalescing key of one drag of `kind` on `tier`.
///
/// Every `EditorSession` coalescing call of one gesture passes the same key, so the
/// gesture is one undo step, and a drag of a different tier or handle never merges
/// into it.
pub const