Struct Mouse 

pub struct Mouse { /* private fields */ }

Provides access to mouse input from all mice on the system.

This type coalesces input from all connected mice into a single interface. It provides access to:

• Mouse position within windows
• Button states (left, right, middle, and others)
• Accumulated scroll deltas

Examples

use app_input::mouse::{Mouse, MOUSE_BUTTON_LEFT};

let mouse = Mouse::coalesced();

// Check if left button is pressed
if mouse.button_state(MOUSE_BUTTON_LEFT) {
    println!("Left button is pressed");
}

// Get mouse position
if let Some(pos) = mouse.window_pos() {
    println!("Mouse at ({}, {})", pos.pos_x(), pos.pos_y());
}

Platform-specific behavior

Different platforms require different integration:

• macOS and wasm: Work out of the box
• Windows: You must call window_proc from your window procedure
• Linux: You must call the appropriate wayland event handlers

Implementations

impl Mouse

pub fn coalesced() -> Self

Creates a new Mouse instance that coalesces input from all mice on the system.

This is the primary way to create a Mouse instance. The returned object will aggregate input from all connected mice.

Examples

use app_input::mouse::Mouse;

let mouse = Mouse::coalesced();
// Now you can query mouse state

pub fn window_pos(&self) -> Option<MouseWindowLocation>

Returns the MouseWindowLocation

Platform specifics

• macOS and wasm require no special considerations.
• On windows, you must call [crate::window_proc] from your window.
• • On Linux,you must call from appropriate wayland events:
    • crate::mouse::linux::motion_event,
    • crate::mouse::linux::button_event
    • crate::mouse::linux::xdg_toplevel_configure_event

pub fn button_state(&self, button: u8) -> bool

Determines if the specified mouse button is currently pressed.

Arguments

• button - The button to check. Use constants like MOUSE_BUTTON_LEFT, MOUSE_BUTTON_RIGHT, or MOUSE_BUTTON_MIDDLE. Other button values (e.g., for mice with additional buttons) may be supported on a best-effort basis.

Returns

true if the button is currently pressed, false otherwise.

Examples

use app_input::mouse::{Mouse, MOUSE_BUTTON_LEFT, MOUSE_BUTTON_RIGHT};

let mouse = Mouse::coalesced();

if mouse.button_state(MOUSE_BUTTON_LEFT) {
    println!("Left button is pressed");
}

if mouse.button_state(MOUSE_BUTTON_RIGHT) {
    println!("Right button is pressed");
}

pub fn load_clear_scroll_delta(&mut self) -> (f64, f64)

Returns the accumulated scroll delta and resets it to zero.

This method is useful for implementing scroll handling in your application. The scroll delta accumulates between calls, so you should call this periodically (e.g., once per frame) to process scroll events.

Returns

A tuple (delta_x, delta_y) containing the horizontal and vertical scroll amounts since the last call to this method.

Examples

use app_input::mouse::Mouse;

let mut mouse = Mouse::coalesced();

// In your update loop:
let (scroll_x, scroll_y) = mouse.load_clear_scroll_delta();
if scroll_y != 0.0 {
    println!("Scrolled vertically by {}", scroll_y);
}

Trait Implementations

impl Debug for Mouse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Mouse

fn default() -> Self

Creates a default Mouse instance using Mouse::coalesced().

Examples

use app_input::mouse::Mouse;

let mouse = Mouse::default();
// Equivalent to Mouse::coalesced()

impl Hash for Mouse

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Mouse

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Mouse