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
//! Mouse-driven direct manipulation of the selected facet: the GUI-free math behind the
//! three drag handles and the Slice tool, and all their wording.
//!
//! # The pick frame
//!
//! Everything here works in the **pick frame**: physical pixels of the solid raster
//! (which is also its pick buffer), origin top-left of the letterboxed raster. A caller
//! converts pointer coordinates into it, and back out to draw handles. The projection
//! ([`projection`]) mirrors the rasterizer's own `project` and `Camera::generate_ray`
//! op for op, and takes the camera and frame size the raster used for that frame, so a
//! handle lands exactly where the facet is drawn.
//!
//! # The three handles
//!
//! A selected facet ([`FacetFrame`]) grows three handles from its centroid
//! ([`handle_layout`]), each dragging the WHOLE tier through the normal edit path:
//!
//! - **Angle**: along `d normal / d theta`; tilts the tier (degrees, snapped to 0.1, or
//! 0.01 with Shift).
//! - **Depth**: along the facet normal; moves the tier in or out (its mast, snapped to
//! 0.01 or 0.001), which pins it with a scale reference.
//! - **Index**: along `d normal / d phi`; turns the tier around the index wheel in whole
//! teeth.
//!
//! [`drag_value`] turns pointer travel along a handle into a [`DragValue`];
//! `EditorSession::{set_tier_angle, pin_tier_mast, rotate_tier_indices}` apply it as
//! coalescing edits keyed by [`drag_coalesce_key`], so a whole gesture is one undo step.
//! [`dependents`] names the tiers that follow a drag; [`text`] holds the hint and toast
//! wording; [`slice`] turns a dragged screen line into a snapped cutting plane and the
//! provisional tier it becomes.
//!
//! # What both apps share around them
//!
//! - [`target`]: which facet carries the handles, the alignment checks that hide them
//! rather than land them on the wrong facet, and the hit-test.
//! - [`gesture`]: one drag as pure decisions -- what a press captured, which edit each
//! throttled pointer value asks for, the live feedback and the closing toast.
//! - [`provisional`]: the Slice tool's provisional tier, edited in place until Keep or
//! Discard.
//! - [`diagram2d`]: the same three handles on the 2D Diagram view's orthographic panels
//! -- which panel offers which handle, where the tips go, and the index handle's turn
//! about the panel centre. Its [`PanelHandles`] carries the ordinary [`HandleLayout`], so
//! [`drag_value`], snapping and the edit path are shared unchanged.
//!
//! The pointer <-> pick-frame mapping for a view that letterboxes its raster lives in
//! `indicatrix_solid::preview::view::ContainFit`.
pub use ;
pub use ;
pub use ;
pub use FacetFrame;
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;
pub use ;