zaxis 0.0.4

An event-driven immediate mode GUI for desktop tools
Documentation
//! Bridge from native winit events to logical UI input.

use super::{Context, EventResponse};
use crate::{files::PickedFile, Vec2};
use winit::{
    dpi::PhysicalSize,
    event::{ElementState, MouseButton, MouseScrollDelta, WindowEvent},
    keyboard::{Key, KeyCode, NamedKey, PhysicalKey},
};

/// A wheel notch scrolls three lines of text at a line height of 1.5 font sizes.
const LINE_STEP: f32 = 4.5;

impl Context {
    /// Handle an event immediately against retained hit regions. This preserves
    /// press/release pairs even when several events arrive before the next redraw.
    pub fn on_window_event(&mut self, event: &WindowEvent) -> EventResponse {
        let mut consumed = false;
        if matches!(
            event,
            WindowEvent::HoveredFile(_)
                | WindowEvent::DroppedFile(_)
                | WindowEvent::HoveredFileCancelled
        ) {
            eprintln!("DBG {event:?}");
        }
        let repaint = match event {
            WindowEvent::CursorMoved { position, .. } => {
                let pointer = Vec2::new(position.x as f32, position.y as f32) / self.scale;
                consumed = self.interaction.capture.is_some()
                    || self.scrolling.auto.is_some()
                    || self.hit_test(pointer).is_some();
                let changed = self.input.pointer != Some(pointer);
                self.move_pointer(pointer);
                changed
            }
            WindowEvent::CursorLeft { .. } => {
                self.input.pointer = None;
                self.drag_cursor_left();
                self.stop_auto_scroll();
                true
            }
            WindowEvent::MouseInput { state, button, .. } => {
                if *button == MouseButton::Middle {
                    consumed = self.middle_button(*state);
                } else if *state == ElementState::Pressed && self.stop_auto_scroll() {
                    consumed = true;
                } else if *button == MouseButton::Left {
                    consumed = self.primary_button(*state);
                } else if *button == MouseButton::Right {
                    consumed = self.secondary_button(*state);
                }
                consumed |= self.popups.current.is_some() || self.modal_active();
                true
            }
            WindowEvent::MouseWheel { delta, .. } => {
                self.stop_auto_scroll();
                let delta = match delta {
                    MouseScrollDelta::LineDelta(x, y) => {
                        Vec2::new(*x, *y) * self.style.font_size * LINE_STEP
                    }
                    MouseScrollDelta::PixelDelta(p) => {
                        Vec2::new(p.x as f32, p.y as f32) / self.scale
                    }
                };
                let delta = if self.input.modifiers.shift_key() && delta.x == 0.0 {
                    Vec2::new(delta.y, 0.0)
                } else {
                    delta
                };
                self.input.scroll_delta += delta;
                self.scrolling.wheel = true;
                consumed = self.scroll_wheel(-delta);
                self.scrolling.wheel = false;
                true
            }
            WindowEvent::KeyboardInput { event, .. } => {
                if let Some(code) = navigation_code(event.physical_key, &event.logical_key) {
                    consumed = self.on_key_event(code, event.state, event.repeat).consumed;
                }
                if event.state == ElementState::Pressed {
                    if let Some(text) = &event.text {
                        if !self.text_fields.composing
                            && !self.input.modifiers.control_key()
                            && !self.input.modifiers.super_key()
                        {
                            consumed |= self.on_text_event(text).consumed;
                        }
                    }
                }
                true
            }
            WindowEvent::ModifiersChanged(modifiers) => {
                self.input.modifiers = modifiers.state();
                true
            }
            WindowEvent::Ime(winit::event::Ime::Commit(text)) => {
                self.text_fields.composing = false;
                consumed = self.on_committed_text(text, true).consumed;
                true
            }
            WindowEvent::Ime(winit::event::Ime::Preedit(text, cursor)) => {
                consumed = self.ime_preedit(text, *cursor);
                true
            }
            WindowEvent::Ime(winit::event::Ime::Disabled) => {
                self.ime_disabled();
                true
            }
            WindowEvent::Focused(focused) => {
                self.input.focused = *focused;
                if !focused {
                    self.focus_lost();
                }
                true
            }
            WindowEvent::Resized(size) => {
                self.drag_cancel(crate::components::drag_drop::DragReason::Cancelled);
                self.set_viewport(*size, f64::from(self.scale));
                true
            }
            WindowEvent::ScaleFactorChanged { scale_factor, .. } => {
                self.drag_cancel(crate::components::drag_drop::DragReason::Cancelled);
                let physical = PhysicalSize::new(
                    (self.logical_size.x * self.scale).round() as u32,
                    (self.logical_size.y * self.scale).round() as u32,
                );
                self.set_viewport(physical, *scale_factor);
                true
            }
            WindowEvent::HoveredFile(path) => self.file_hovered(PickedFile::from_path(path)),
            WindowEvent::HoveredFileCancelled => self.file_hover_cancelled(),
            WindowEvent::DroppedFile(path) => self.file_dropped(PickedFile::from_path(path)),
            _ => false,
        };
        if repaint {
            self.request_repaint();
        }
        EventResponse { consumed, repaint }
    }
}

impl Context {
    /// The window lost focus: popups close without restoring focus, drags and gestures
    /// end, buttons and keys count as released, and nothing keeps focus or composition.
    fn focus_lost(&mut self) {
        self.dismiss_popup(false);
        self.drag_cancel(crate::components::drag_drop::DragReason::FocusLost);
        self.input.primary_down = false;
        self.input.middle_down = false;
        self.input.secondary_down = false;
        self.gesture_cancel();
        self.stop_auto_scroll();
        self.input.keys_down.clear();
        self.interaction.capture = None;
        self.text_fields.clicks.reset();
        self.interaction.keyboard_active = None;
        self.set_focus(None);
        self.text_fields.composing = false;
        self.input.pointer = None;
    }
}

// Navigation follows key meaning: NumPad with NumLock off has a numeric physical
// scan code but an arrow/Home/End logical key. Letter shortcuts stay physical.
pub fn navigation_code(physical: PhysicalKey, logical: &Key) -> Option<KeyCode> {
    let code = match logical {
        Key::Named(NamedKey::ArrowUp) => KeyCode::ArrowUp,
        Key::Named(NamedKey::ArrowDown) => KeyCode::ArrowDown,
        Key::Named(NamedKey::ArrowLeft) => KeyCode::ArrowLeft,
        Key::Named(NamedKey::ArrowRight) => KeyCode::ArrowRight,
        Key::Named(NamedKey::Home) => KeyCode::Home,
        Key::Named(NamedKey::End) => KeyCode::End,
        Key::Named(NamedKey::PageUp) => KeyCode::PageUp,
        Key::Named(NamedKey::PageDown) => KeyCode::PageDown,
        _ => {
            return match physical {
                PhysicalKey::Code(code) => Some(code),
                _ => None,
            }
        }
    };
    Some(code)
}