Struct App 

pub(crate) struct App {

    pub(crate) window: Option<Arc<Window>>,
    pub(crate) surface: Option<Surface<'static>>,
    pub(crate) surface_config: Option<SurfaceConfiguration>,
    pub(crate) device: Option<Arc<Device>>,
    pub(crate) queue: Option<Arc<Queue>>,
    pub(crate) engine: Option<MilkEngine>,
    pub(crate) audio_input: Option<AudioInput>,
    pub(crate) blit: Option<Blit>,
    pub(crate) preset_manager: PresetManager,
    pub(crate) last_frame: Instant,
    pub(crate) frame_count: u32,
    pub(crate) initial_width: u32,
    pub(crate) initial_height: u32,
    pub(crate) fullscreen: bool,
    pub(crate) no_vsync: bool,
    pub(crate) last_left_click: Option<Instant>,
    pub(crate) fps_window_start: Instant,
    pub(crate) fps_window_frames: u32,
    pub(crate) last_fps: f32,
    pub(crate) last_cursor_move: Instant,
    pub(crate) cursor_visible: bool,
    pub(crate) settings: Settings,
    pub(crate) options_ui: Option<OptionsUi>,
    pub(crate) modifiers: Modifiers,
    pub(crate) keymap: Keymap,
}

Fields

window: Option<Arc<Window>>

surface: Option<Surface<'static>>

surface_config: Option<SurfaceConfiguration>

device: Option<Arc<Device>>

queue: Option<Arc<Queue>>

engine: Option<MilkEngine>

audio_input: Option<AudioInput>

blit: Option<Blit>

preset_manager: PresetManager

last_frame: Instant

frame_count: u32

initial_width: u32

Window-creation preferences read once from CLI args.

initial_height: u32

fullscreen: bool

no_vsync: bool

last_left_click: Option<Instant>

Timestamp of the last left-click; used to detect double-click.

fps_window_start: Instant

Start of the current FPS-measurement window.

fps_window_frames: u32

Frames rendered since fps_window_start.

last_fps: f32

Last computed FPS (refreshed every ~2s alongside the log). Fed into the HUD overlay.

last_cursor_move: Instant

Timestamp of the last cursor movement. Drives the auto-hide behaviour (Settings::window::cursor_auto_hide_secs).

cursor_visible: bool

Current visibility of the cursor — mirrors what we last told winit so we don’t spam set_cursor_visible on every frame.

settings: Settings

Persistent settings loaded at startup; the Options overlay edits this in place and re-saves on every change.

options_ui: Option<OptionsUi>

egui-based Options overlay. None until init_graphics runs.

modifiers: Modifiers

Current modifier state, kept in sync with WindowEvent::ModifiersChanged. The sprite + message keybindings (§5, §6) read Shift (random sprite) and Ctrl (clear all) from here.

keymap: Keymap

Keybind table. Defaults to MD2-style mapping; overrides come from ~/.config/onedrop/settings.toml [keymap.bindings].

Implementations

impl App

pub(crate) fn new(args: &Args, settings: Settings) -> Self

pub(crate) fn toggle_fullscreen(&self)

pub(crate) fn init_graphics(&mut self, window: Arc<Window>) -> Result<()>

pub(crate) fn render(&mut self) -> Result<()>

pub(crate) fn swap_audio_input(&mut self, name: Option<&str>)

Drop the active audio capture stream and rebuild it against a different cpal device. name = None means “the OS default”; a name that doesn’t match any current device falls back to the default with a warning logged by the engine helper.

pub(crate) fn reconfigure_present_mode(&mut self, vsync: bool)

Reconfigure the swapchain for a new VSync preference. Mirrors the boot logic in init_graphics for picking a present mode: Fifo for VSync ON, Immediate (with Mailbox fallback) for OFF. Called by the Options panel.

pub(crate) fn options_open(&self) -> bool

Return true when the Options overlay is currently drawn on screen. Used by handle_keyboard to scope the Esc key to “close overlay” rather than “quit” while the panel is open.

pub(crate) fn handle_keyboard( &mut self, event_loop: &ActiveEventLoop, key_code: KeyCode, )

pub(crate) fn dispatch_action( &mut self, event_loop: &ActiveEventLoop, action: Action, )

Run the side-effects for a resolved Action. Split out from handle_keyboard so the lookup → dispatch step is testable in isolation and so action handlers can be added without touching the winit event-decoding glue.

Trait Implementations

impl ApplicationHandler for App

fn resumed(&mut self, event_loop: &ActiveEventLoop)

Emitted when the application has been resumed.

fn window_event( &mut self, event_loop: &ActiveEventLoop, _window_id: WindowId, event: WindowEvent, )

Emitted when the OS sends an event to a winit window.

fn new_events(&mut self, event_loop: &ActiveEventLoop, cause: StartCause)

Emitted when new events arrive from the OS to be processed.

fn user_event(&mut self, event_loop: &ActiveEventLoop, event: T)

Emitted when an event is sent from EventLoopProxy::send_event.

fn device_event( &mut self, event_loop: &ActiveEventLoop, device_id: DeviceId, event: DeviceEvent, )

Emitted when the OS sends an event to a device.

fn about_to_wait(&mut self, event_loop: &ActiveEventLoop)

Emitted when the event loop is about to block and wait for new events.

fn suspended(&mut self, event_loop: &ActiveEventLoop)

Emitted when the application has been suspended.

fn exiting(&mut self, event_loop: &ActiveEventLoop)

Emitted when the event loop is being shut down.

fn memory_warning(&mut self, event_loop: &ActiveEventLoop)

Emitted when the application has received a memory warning.