Expand description

A simple library for querying mouse and keyboard state without requiring an active window. Currently works in Windows, Linux, and macOS.

use device_query::{DeviceQuery, DeviceState, MouseState, Keycode};

let device_state = DeviceState::new();

let mouse: MouseState = device_state.get_mouse();
println!("Current Mouse Coordinates: {:?}", mouse.coords);

let keys: Vec<Keycode> = device_state.get_keys();
println!("Is A pressed? {}", keys.contains(&Keycode::A));

It’s also possible to listen for events.

 use device_query::{DeviceEvents, DeviceState};

 let device_state = DeviceState::new();

 let _guard = device_state.on_mouse_move(|position| {
    println!("Mouse position: {:#?}", position);
 });
 let _guard = device_state.on_mouse_down(|button| {
    println!("Mouse button down: {:#?}", button);
 });
 let _guard = device_state.on_mouse_up(|button| {
    println!("Mouse button up: {:#?}", button);
 });
 let _guard = device_state.on_key_down(|key| {
    println!("Keyboard key down: {:#?}", key);
 });
 let _guard = device_state.on_key_up(|key| {
    println!("Keyboard key up: {:#?}", key);
 });

 loop {}

Re-exports

pub use device_events::*;
pub use device_query::*;
pub use device_state::*;
pub use keymap::*;
pub use mouse_state::*;

Modules

Devices events listeners.

Query functions.

DeviceState implementation.

List of keycodes.

Description of mouse coordinates and state of buttons.