egui-macview 0.5.0

Cross-platform macOS AppKit Layout Engine, Authentic Control Primitive Suite, and CoreAnimation Physics Runtime for egui on Windows 11, macOS, Linux, and Web.
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
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

//! Authentic macOS Floating Overlay Scrollbar Thumb primitives.
//!
//! Handles subpixel-snapped geometric computation, corner clearance isolation,
//! interaction tracking, and dynamic opacity rendering for floating overlay scrollbars.

use crate::layout::subpixel_snap_rect;
use egui::{Color32, CornerRadius, Id, Pos2, Rect, Sense, Stroke, StrokeKind, Ui};

/// Parameters for rendering an authentic floating overlay scrollbar thumb.
#[allow(clippy::too_many_arguments)]
pub fn render_overlay_thumb(
    ui: &mut Ui,
    painter: &egui::Painter,
    id: Id,
    viewport: Rect,
    view_span: f32,
    content_span: f32,
    lead: f32,
    trail: f32,
    inset: f32,
    thickness: f32,
    hover_thickness: f32,
    radius: f32,
    min_len: f32,
    min_visible_len: f32,
    offset: &mut f32,
    max_scroll: f32,
    is_vertical: bool,
    alpha: f32,
    track_bg_color: Color32,
    color_fn: &impl Fn(bool, bool) -> Color32,
    active_id: Id,
    now: f64,
) -> bool {
    let ratio = (view_span / content_span).clamp(0.0, 1.0);
    let avail = (view_span - lead - trail).max(0.0);
    let thumb_len = (avail * ratio).max(min_len.min(avail)).min(avail);
    let travel = (avail - thumb_len).max(0.0);
    let frac = if max_scroll > 0.0 {
        *offset / max_scroll
    } else {
        0.0
    };

    if thumb_len < min_visible_len {
        return false;
    }

    let track_raw = if is_vertical {
        let right = viewport.right() - inset;
        Rect::from_min_max(
            Pos2::new(right - hover_thickness, viewport.top() + lead),
            Pos2::new(right, viewport.top() + lead + avail),
        )
    } else {
        let bottom = viewport.bottom() - inset;
        Rect::from_min_max(
            Pos2::new(viewport.left() + lead, bottom - hover_thickness),
            Pos2::new(viewport.left() + lead + avail, bottom),
        )
    };
    let track_rect = subpixel_snap_rect(track_raw, ui.pixels_per_point());
    let track_resp = ui.interact(track_rect, id.with("track"), Sense::click());
    let track_hovered = track_resp.hovered() || ui.rect_contains_pointer(track_rect);
    let eff_thickness = if track_hovered || ui.ctx().is_being_dragged(id) {
        hover_thickness
    } else {
        thickness
    };

    let raw = if is_vertical {
        let top = viewport.top() + lead + frac * travel;
        let right = viewport.right() - inset;
        Rect::from_min_max(
            Pos2::new(right - eff_thickness, top),
            Pos2::new(right, top + thumb_len),
        )
    } else {
        let left = viewport.left() + lead + frac * travel;
        let bottom = viewport.bottom() - inset;
        Rect::from_min_max(
            Pos2::new(left, bottom - eff_thickness),
            Pos2::new(left + thumb_len, bottom),
        )
    };
    let thumb_rect = subpixel_snap_rect(raw, ui.pixels_per_point());

    let resp = ui.interact(thumb_rect, id, Sense::click_and_drag());
    let mut changed = false;
    if resp.dragged() && travel > 0.0 {
        let dy = if is_vertical {
            resp.drag_delta().y
        } else {
            resp.drag_delta().x
        };
        *offset = (*offset + dy * (max_scroll / travel)).clamp(0.0, max_scroll);
        changed = true;
    } else if track_resp.clicked() && !resp.dragged() {
        if let Some(pos) = track_resp.interact_pointer_pos() {
            if is_vertical {
                if pos.y < thumb_rect.top() {
                    *offset = (*offset - view_span).max(0.0);
                    changed = true;
                } else if pos.y > thumb_rect.bottom() {
                    *offset = (*offset + view_span).min(max_scroll);
                    changed = true;
                }
            } else if pos.x < thumb_rect.left() {
                *offset = (*offset - view_span).max(0.0);
                changed = true;
            } else if pos.x > thumb_rect.right() {
                *offset = (*offset + view_span).min(max_scroll);
                changed = true;
            }
        }
    }

    if track_hovered || resp.hovered() || resp.dragged() || changed {
        ui.data_mut(|d| d.insert_temp(active_id, now));
        ui.ctx().request_repaint();
    }

    if alpha > f32::EPSILON {
        if track_hovered || resp.hovered() || resp.dragged() {
            let tr = radius.min(avail * 0.5).min(eff_thickness * 0.5);
            painter.rect(
                track_rect,
                CornerRadius::same(tr as u8),
                track_bg_color,
                Stroke::NONE,
                StrokeKind::Inside,
            );
        }
        let r = radius.min(thumb_len * 0.5).min(eff_thickness * 0.5);
        painter.rect(
            thumb_rect,
            CornerRadius::same(r as u8),
            color_fn(track_hovered || resp.hovered(), resp.dragged()),
            Stroke::NONE,
            StrokeKind::Inside,
        );
    }

    changed
}