Struct winit_input_helper::WinitInputHelper

pub struct WinitInputHelper { /* private fields */ }

The main struct of the API. Call update_from_vec or update once per main loop. Then call any of the accessor methods.

Implementations

impl WinitInputHelper

pub fn new() -> WinitInputHelper

pub fn update_from_vec(&mut self, events: Vec<Event>)

Pass every event to this function. WinitInputHelper::Update is easier to use. But this method is useful if you want to inspect the events yourself before giving them to WinitInputHelper. Ensure this method is only called once per application main loop. Ensure every event since the last update_from_vec call is included in the events argument.

pub fn update(&mut self, events_loop: &mut EventsLoop)

Takes every event from the events_loop. If you need to inspect the events yourself use WinitInputHelper::update_from_vec. Ensure this method is only called once per application main loop.

pub fn key_pressed(&self, check_key_code: VirtualKeyCode) -> bool

Returns true when the specified keyboard key goes from “not pressed” to “pressed” Otherwise returns false

pub fn mouse_pressed(&self, check_mouse_button: usize) -> bool

Returns true when the specified mouse button goes from “not pressed” to “pressed” Otherwise returns false

Left => 0 Right => 1 Middle => 2 Other => 3..255

pub fn key_released(&self, check_key_code: VirtualKeyCode) -> bool

Returns true when the specified keyboard key goes from “pressed” to “not pressed” Otherwise returns false

pub fn mouse_released(&self, check_mouse_button: usize) -> bool

Returns true when the specified mouse button goes from “pressed” to “not pressed” Otherwise returns false

Left => 0 Right => 1 Middle => 2 Other => 3..255

pub fn key_held(&self, key_code: VirtualKeyCode) -> bool

Returns true while the specified keyboard key remains “pressed” Otherwise returns false

pub fn mouse_held(&self, mouse_button: usize) -> bool

Returns true while the specified mouse button remains “pressed” Otherwise returns false

Left => 0 Right => 1 Middle => 2 Other => 3..255

pub fn held_shift(&self) -> bool

Returns true while any shift key is held on the keyboard Otherwise returns false

pub fn held_control(&self) -> bool

Returns true while any control key is held on the keyboard Otherwise returns false

pub fn held_alt(&self) -> bool

Returns true while any alt key is held on the keyboard Otherwise returns false

pub fn scroll_diff(&self) -> f32

Returns 0.0 if the mouse is outside of the window. Otherwise returns the amount scrolled by the mouse in between the last two update*() calls

pub fn mouse(&self) -> Option<(f32, f32)>

Returns None when the mouse is outside of the window. Otherwise returns the mouse coordinates in pixels

pub fn game_mouse(&self, camera: Camera) -> Option<(f32, f32)>

Returns None when the mouse is outside of the window. Otherwise returns the mouse coordinates in the game world.

pub fn mouse_diff(&self) -> (f32, f32)

Returns the difference in mouse coordinates between the last two update*() calls Returns (0.0, 0.0) if the mouse is outside of the window.

pub fn game_mouse_diff(&self, camera: Camera) -> (f32, f32)

Returns the difference in mouse coordinates between the last two update*() calls Returns (0.0, 0.0) if the mouse is outside of the window.

pub fn resolution(&self) -> Option<(u32, u32)>

Returns None when the mouse is outside of the window. Otherwise returns the resolution of the window.

pub fn text(&self) -> Vec<TextChar>

Returns the characters pressed since the last update*(). The earlier the character was pressed, the lower the index in the Vec.

pub fn dropped_file(&self) -> Option<PathBuf>

Returns the path to a file that has been drag-and-dropped onto the window.

pub fn window_resized(&self) -> Option<LogicalSize>

Returns the current window size if it was resized between the last two update*() calls. Otherwise returns None

pub fn quit(&self) -> bool

Returns true if the OS has requested the application to quit. Otherwise returns false.