viewport_lib/interaction/input/
action_frame.rs

1//! Per-frame resolved action output for the new input pipeline.
2
3use std::collections::HashMap;
4
5use super::action::Action;
6
7/// State of a resolved action for one frame.
8#[derive(Debug, Clone, Copy, PartialEq)]
9pub enum ResolvedActionState {
10    /// The action was triggered this frame (KeyPress).
11    Pressed,
12    /// The action is actively held (KeyHold, Drag in progress).
13    Held,
14    /// The action is producing a two-axis delta (Drag, WheelXY).
15    Delta(glam::Vec2),
16}
17
18/// Resolved navigation actions for one frame.
19///
20/// Produced by [`super::viewport_input::ViewportInput`] after processing all
21/// events for a frame. Non-zero fields indicate active input in that direction.
22#[derive(Debug, Clone, Default)]
23pub struct NavigationActions {
24    /// Orbit delta in radians (x = yaw, y = pitch). Zero if no orbit input.
25    pub orbit: glam::Vec2,
26    /// Pan delta in viewport-local pixels (x = right, y = down). Zero if no pan input.
27    pub pan: glam::Vec2,
28    /// Zoom factor delta. Positive = zoom in. Zero if no zoom input.
29    pub zoom: f32,
30}
31
32/// Per-frame resolved action output.
33///
34/// Returned by [`super::controller::OrbitCameraController::apply_to_camera`] and
35/// available from [`super::viewport_input::ViewportInput`] after a frame.
36#[derive(Debug, Clone, Default)]
37pub struct ActionFrame {
38    /// Resolved camera navigation actions.
39    pub navigation: NavigationActions,
40    /// General action states resolved this frame (key presses, holds, etc.).
41    pub actions: HashMap<Action, ResolvedActionState>,
42}
43
44impl ActionFrame {
45    /// Returns the resolved state for the given action, if active this frame.
46    pub fn action(&self, action: Action) -> Option<&ResolvedActionState> {
47        self.actions.get(&action)
48    }
49
50    /// Returns `true` if the action is active (pressed, held, or producing a delta) this frame.
51    pub fn is_active(&self, action: Action) -> bool {
52        self.actions.contains_key(&action)
53    }
54}
viewport_lib/interaction/input/action_frame.rs

viewport_lib/interaction/input/
action_frame.rs
