Struct GamepadManager 

pub struct GamepadManager { /* private fields */ }

Owns the state of every gamepad the page has seen and drives the per-frame poll.

A poll re-reads navigator.get_gamepads() and folds the fresh raw readings into the stored state, computing this frame’s edge sets from the previous frame’s held set. The DOM connect / disconnect events are honoured too: a device announced between two polls is already present as a state when the next poll runs, so polling alone never loses a connect or a disconnect.

Implementations

impl GamepadManager

Implements the manager query surface on GamepadManager.

pub fn state(&self, index: u32) -> Option<&GamepadState>

Looks up the state of one gamepad by index.

Arguments

• u32 - The browser-assigned gamepad index.

Returns

• Option<&GamepadState> - The stored state, or None when this index has never been seen.

pub fn state_mut(&mut self, index: u32) -> Option<&mut GamepadState>

Looks up the state of one gamepad by index, mutably.

Arguments

• u32 - The browser-assigned gamepad index.

Returns

• Option<&mut GamepadState> - The stored state, or None when this index has never been seen.

pub fn is_connected(&self, index: u32) -> bool

Tests whether a gamepad index is currently connected.

Arguments

• u32 - The browser-assigned gamepad index.

Returns

• bool - True if the pad is connected.

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

Reads one analog axis of one gamepad with the deadzone applied.

Arguments

• u32 - The browser-assigned gamepad index.
• u32 - The axis index to read.

Returns

• Option<f64> - The deadzone-corrected reading, or None when the index is unknown.

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

Reads one button’s raw pressure on one gamepad.

Arguments

• u32 - The browser-assigned gamepad index.
• u32 - The button index to read.

Returns

• Option<f64> - The pressure, or None when the index is unknown.

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

Tests whether a button on one gamepad went down on this frame.

Arguments

• u32 - The browser-assigned gamepad index.
• u32 - The button index to check.

Returns

• bool - True if the button was pressed this frame, false when the index is unknown.

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

Tests whether a button on one gamepad is currently held down.

Arguments

• u32 - The browser-assigned gamepad index.
• u32 - The button index to check.

Returns

• bool - True if the button is held, false when the index is unknown.

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

Tests whether a button on one gamepad came up on this frame.

Arguments

• u32 - The browser-assigned gamepad index.
• u32 - The button index to check.

Returns

• bool - True if the button was released this frame, false when the index is unknown.

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

Resolves a button’s current state on one gamepad into enum form.

Arguments

• u32 - The browser-assigned gamepad index.
• u32 - The button index to check.

Returns

• InputAction - The edge state, Idle when the index is unknown.

pub fn connected_count(&self) -> usize

Counts the gamepads that are currently connected.

Returns

• usize - The number of connected gamepads.

pub fn end_frame(&mut self)

Clears every pad’s per-frame data and the manager’s edge sets.

Mirrors InputState::end_frame: pressed and released are per-frame and are dropped, while held sets and the connected flags survive.

impl GamepadManager

Implements the DOM wiring layer on GamepadManager.

The Gamepad API is a polling API: the browser only mutates navigator.get_gamepads() snapshots and never emits per-button events, so button edges must be derived by diffing one frame’s snapshot against the last. The two connect / disconnect events are still bound so a device that appears or vanishes between two polls is reflected in connected / disconnected on the same frame rather than one frame late; a poll alone would also detect both, so the events are a latency optimisation and the poll is the authority.

pub fn poll(&mut self, window: &Window)

Re-reads every gamepad from the DOM and recomputes this frame’s button edges.

A pad that the browser no longer lists is marked disconnected and its edge sets flushed, so a yanked controller cannot keep reporting held buttons forever.

Arguments

• &Window - The global window, used to reach navigator.

pub fn attach( manager_cell: GamepadManagerCell, window: &Window, ) -> GamepadManagerCell

Attaches the gamepad listeners and returns the shared cell.

Arguments

• GamepadManagerCell - The shared manager to mutate.
• &Window - The global window, receiving the connect and disconnect events.

Returns

• GamepadManagerCell - The same cell passed in, for convenient chaining.

pub fn attach_gamepad(manager_cell: &GamepadManagerCell, window: &Window)

Binds the connect / disconnect listeners to window.

Arguments

• &GamepadManagerCell - The shared gamepad manager.
• &Window - The global window.

impl GamepadManager

pub fn get_states(&self) -> &GamepadStateMap

pub fn set_states(&mut self, val: GamepadStateMap) -> &mut Self

pub fn get_connected(&self) -> &GamepadIndexSet

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

pub fn get_disconnected(&self) -> &GamepadIndexSet

pub fn set_disconnected(&mut self, val: GamepadIndexSet) -> &mut Self

Trait Implementations

impl Clone for GamepadManager

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 GamepadManager

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

Formats the value using the given formatter.

impl Default for GamepadManager

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for GamepadManager

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for GamepadManager