Struct riddle_input::InputSystem

pub struct InputSystem { /* fields omitted */ }

The Riddle input system core state, along with InputMainThreadState.

This stores the thread safe input state which can be queried to inspect the status of input devices. It is updated by InputMainThreadState::process_input.

Implementations

impl InputSystem

pub fn mouse_pos(&self, window: WindowId) -> LogicalPosition

Query the cursor position with respect to a given window.

If no mouse position infomation is available for the given window, the position will be (0,0)

Example

// The initial mouse position is (0,0)
assert_eq!(LogicalPosition{ x: 0, y: 0}, input_system.mouse_pos(window));

// The platform system emits cursor move events
// [..]

// The reported mouse position has changed
assert_ne!(LogicalPosition{ x: 0, y: 0}, input_system.mouse_pos(window));

pub fn is_mouse_button_down(
    &self,
    window: WindowId,
    button: MouseButton
) -> bool

Check if the specified mouse button is down with respect to a given window.

If there is no state recorded for the mouse for the given window the result will be false

Example

// The initial mouse position is (0,0)
assert_eq!(false, input_system.is_mouse_button_down(window, MouseButton::Left));

// The platform system emits cursor move events
// [..]

// The reported mouse position has changed
assert_eq!(true, input_system.is_mouse_button_down(window, MouseButton::Left));

pub fn is_key_down(&self, window: WindowId, scancode: Scancode) -> bool

Query the keyboard scancode state with respect to a given window. See Scancode for details on what a scancode represents.

If no keyboard infomation is available for the given window, the button will be considered to not be down.

Example

// The initial key state is that the button is unpressed
assert_eq!(false, input_system.is_key_down(window, Scancode::Escape));

// The platform system emits key press event
// [..]

// The reported key state has changed
assert_eq!(true, input_system.is_key_down(window, Scancode::Escape));

pub fn is_vkey_down(&self, window: WindowId, vkey: VirtualKey) -> bool

Query the keyboard virtual key state with respect to a given window. See VirtualKey for details on what a virtual key represents.

If no keyboard infomation is available for the given window, the button will be considered to not be down.

Example

// The initial key state is that the button is unpressed
assert_eq!(false, input_system.is_vkey_down(window, VirtualKey::Escape));

// The platform system emits key press event
// [..]

// The reported key state has changed
assert_eq!(true, input_system.is_vkey_down(window, VirtualKey::Escape));

pub fn keyboard_modifiers(&self, window: WindowId) -> KeyboardModifiers

The current state of keyboard modifiers with respect to a given window.

If no state has been set all modifiers are considered unset.

Example

// The initial mouse position is (0,0)
assert_eq!(false, input_system.keyboard_modifiers(window).ctrl);

// The platform system emits key down event for Ctrl key
// [..]

// The reported mouse position has changed
assert_eq!(true, input_system.keyboard_modifiers(window).ctrl);

pub fn last_active_gamepad(&self) -> Option<GamePadId>

Get the GamePadId of the last gamepad which issued any event.

Can be used a very simple way to pick a gamepad to consider the “active” gamepad. Handling InputEvent::GamePadConnected and similar events allows for more fine grained control.

Example

// The initial gamepad is None
assert_eq!(None, input_system.last_active_gamepad());

// Controller button press events are processed
// [..]

// The reported active controller has changed
assert_ne!(None, input_system.last_active_gamepad());

pub fn is_gamepad_button_down(
    &self,
    gamepad: GamePadId,
    button: GamePadButton
) -> bool

Check if a specific button is pressed for a given gamepad.

If no state has been set all buttons are considered not to be down.

// The initial button state is false
assert_eq!(false, input_system.is_gamepad_button_down(gamepad, GamePadButton::North));

// Controller button press events are processed
// [..]

// The reported button state has changed
assert_eq!(true, input_system.is_gamepad_button_down(gamepad, GamePadButton::North));

pub fn gamepad_axis_value(&self, gamepad: GamePadId, axis: GamePadAxis) -> f32

Get the value of a specific axis for a specific gamepad

If no state has been set all axes are considered to have value 0.0.

// The initial button state is false
assert_eq!(0.0, input_system.gamepad_axis_value(gamepad, GamePadAxis::LeftStickX));

// Controller axis events are processed
// [..]

// The reported axis value has changed
assert_ne!(0.0, input_system.gamepad_axis_value(gamepad, GamePadAxis::LeftStickX));

Trait Implementations

impl CloneHandle for InputSystem

type Handle = InputSystemHandle

The type which represents a strong reference, and which may be dereferenced as Self.

type WeakHandle = InputSystemWeak

The type which represents a weak reference.

fn clone_handle(&self) -> InputSystemHandle

Clone a strong handle to the object.

fn clone_weak_handle(&self) -> InputSystemWeak

Clone a weak handle to the object.

impl InputSystemExt for InputSystem

fn new_shared(
    sys_events: &EventPub<PlatformEvent>
) -> Result<(InputSystemHandle, InputMainThreadState), InputError>

Create the input system, initializing any input device libraries needed.

fn take_input_events(&self) -> Vec<InputEvent>

Collect any buffered InputEvents emitted by the input system.