Struct GamepadState 

pub struct GamepadState { /* private fields */ }

Per-frame and steady-state data for a single gamepad index.

The edge sets follow the same contract as InputState: buttons_pressed records a button that went down on the frame it went down and is cleared by GamepadState::end_frame, buttons_held records every button currently down and survives end_frame, and buttons_released records a button that was held and came up on this frame.

Implementations

impl GamepadState

Implements the per-pad query surface on GamepadState.

pub fn axis(&self, axis: u32) -> f64

Reads one analog axis with the deadzone applied.

Arguments

• u32 - The axis index to read.

Returns

• f64 - The deadzone-corrected reading, or 0.0 when the pad has no such axis.

pub fn button_value(&self, button: u32) -> f64

Reads one button’s raw pressure without any deadzone.

Arguments

• u32 - The button index to read.

Returns

• f64 - The pressure in [0.0, 1.0], or 0.0 when the pad has no such button.

pub fn is_button_pressed(&self, button: u32) -> bool

Tests whether a button went down on this frame.

Arguments

• u32 - The button index to check.

Returns

• bool - True if the button was pressed this frame.

pub fn is_button_held(&self, button: u32) -> bool

Tests whether a button is currently held down.

Arguments

• u32 - The button index to check.

Returns

• bool - True if the button is held.

pub fn is_button_released(&self, button: u32) -> bool

Tests whether a button came up on this frame.

Arguments

• u32 - The button index to check.

Returns

• bool - True if the button was released this frame.

pub fn button_action(&self, button: u32) -> InputAction

Resolves a button’s current state into the enum form.

Arguments

• u32 - The button index to check.

Returns

• InputAction - The edge state of the button, Pressed taking precedence over Released when a connect and a release land on the same frame.

pub fn axis_pressed(&self, axis: u32, threshold: f64) -> bool

Tests whether a direction pair reads as a positive deflection.

Arguments

• u32 - The index of the axis to read.
• f64 - The deflection that counts as a press.

Returns

• bool - True if the corrected axis reading reaches threshold.

pub fn end_frame(&mut self)

Clears this frame’s per-frame data, keeping the held set.

Mirrors InputState::end_frame: the pressed and released sets are per-frame and are dropped, while the held set survives so a button that is still down stays held on the next frame.

impl GamepadState

pub fn get_id(&self) -> String

pub fn get_mut_id(&mut self) -> &mut String

pub fn set_id(&mut self, val: String) -> &mut Self

pub fn get_axes(&self) -> &Vec<f64>

pub fn set_axes(&mut self, val: Vec<f64>) -> &mut Self

pub fn get_button_values(&self) -> &Vec<f64>

pub fn set_button_values(&mut self, val: Vec<f64>) -> &mut Self

pub fn get_connected(&self) -> bool

pub fn get_mut_connected(&mut self) -> &mut bool

pub fn set_connected(&mut self, val: bool) -> &mut Self

pub fn get_buttons_pressed(&self) -> &GamepadButtonSet

pub fn set_buttons_pressed(&mut self, val: GamepadButtonSet) -> &mut Self

pub fn get_buttons_held(&self) -> &GamepadButtonSet

pub fn set_buttons_held(&mut self, val: GamepadButtonSet) -> &mut Self

pub fn get_buttons_released(&self) -> &GamepadButtonSet

pub fn set_buttons_released(&mut self, val: GamepadButtonSet) -> &mut Self

Trait Implementations

impl Clone for GamepadState

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GamepadState

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

Formats the value using the given formatter.

impl Default for GamepadState

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for GamepadState

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for GamepadState