Struct ActivePad 

pub struct ActivePad { /* private fields */ }

The pad whose sticks drive the game, its filtered sticks, and the let-go rule.

• The first pad to move a stick past the dead zone holds them, or the first to be activated by a button, and keeps them until it disconnects: a second pad cannot take over mid-move.
• Each stick reads through a scaled radial dead zone (crate::radial_deadzone): zero inside it, rescaled from its edge to full throw.
• release_until_neutral — on opening a menu, on losing focus — zeroes the sticks and keeps each stick of each pad at zero until that stick has come back inside the dead zone, so a stick still held as the menu closes does not walk the player off. Every pad first seen after a release is held to the same rule, and so is a pad that disconnected while it held the sticks, when it returns.

Implementations

impl ActivePad

pub fn new(dead_zone: f32) -> Option<Self>

No pad holding the sticks, with dead_zone in 0.0..1.0; None outside it.

pub const fn active(&self) -> Option<GamepadId>

The pad holding the sticks.

pub fn activate(&mut self, id: GamepadId) -> bool

Gives id the sticks, as a button press on it does, unless another pad holds them. Returns whether id holds them now.

pub fn release_until_neutral(&mut self)

Zeroes the sticks and holds every stick of every pad at zero until it has rested.

pub fn submit( &mut self, id: GamepadId, snapshot: &GamepadSnapshot, ) -> StickUpdate

Reads snapshot from pad id: see StickUpdate. A pad that moves while none holds the sticks takes them.

pub fn disconnect(&mut self, id: GamepadId) -> bool

Takes the sticks from id if it holds them, zeroing them; when it returns, its sticks must rest before they drive again. Returns whether it held them.

pub const fn stick(&self, stick: Stick) -> (f32, f32)

A stick as the holding pad last reported it, filtered: (x, y), +Y up, inside the unit disc.

Trait Implementations

impl Clone for ActivePad

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 ActivePad

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

Formats the value using the given formatter.