bevy_input/

gamepad.rs

//! The gamepad input functionality.

use crate::{Axis, ButtonInput, ButtonState};
use bevy_core::Name;
use bevy_ecs::{
    change_detection::DetectChangesMut,
    component::Component,
    entity::Entity,
    event::{Event, EventReader, EventWriter},
    system::{Commands, Query},
};
use bevy_math::Vec2;
#[cfg(feature = "bevy_reflect")]
use bevy_reflect::{std_traits::ReflectDefault, Reflect};
#[cfg(all(feature = "serialize", feature = "bevy_reflect"))]
use bevy_reflect::{ReflectDeserialize, ReflectSerialize};
use bevy_utils::{
    tracing::{info, warn},
    Duration, HashMap,
};
use derive_more::derive::{Display, Error, From};

/// A gamepad event.
///
/// This event type is used over the [`GamepadConnectionEvent`],
/// [`GamepadButtonChangedEvent`] and [`GamepadAxisChangedEvent`] when
/// the in-frame relative ordering of events is important.
///
/// This event is produced by `bevy_input`
#[derive(Event, Debug, Clone, PartialEq, From)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, PartialEq))]
#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(
    all(feature = "serialize", feature = "bevy_reflect"),
    reflect(Serialize, Deserialize)
)]
pub enum GamepadEvent {
    /// A gamepad has been connected or disconnected.
    Connection(GamepadConnectionEvent),
    /// A button of the gamepad has been triggered.
    Button(GamepadButtonChangedEvent),
    /// An axis of the gamepad has been triggered.
    Axis(GamepadAxisChangedEvent),
}

/// A raw gamepad event.
///
/// This event type is used over the [`GamepadConnectionEvent`],
/// [`RawGamepadButtonChangedEvent`] and [`RawGamepadAxisChangedEvent`] when
/// the in-frame relative ordering of events is important.
///
/// This event type is used by `bevy_input` to feed its components.
#[derive(Event, Debug, Clone, PartialEq, Reflect, From)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub enum RawGamepadEvent {
    /// A gamepad has been connected or disconnected.
    Connection(GamepadConnectionEvent),
    /// A button of the gamepad has been triggered.
    Button(RawGamepadButtonChangedEvent),
    /// An axis of the gamepad has been triggered.
    Axis(RawGamepadAxisChangedEvent),
}

/// [`GamepadButton`] changed event unfiltered by [`GamepadSettings`]
#[derive(Event, Debug, Copy, Clone, PartialEq, Reflect)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub struct RawGamepadButtonChangedEvent {
    /// The gamepad on which the button is triggered.
    pub gamepad: Entity,
    /// The type of the triggered button.
    pub button: GamepadButton,
    /// The value of the button.
    pub value: f32,
}

impl RawGamepadButtonChangedEvent {
    /// Creates a [`RawGamepadButtonChangedEvent`].
    pub fn new(gamepad: Entity, button_type: GamepadButton, value: f32) -> Self {
        Self {
            gamepad,
            button: button_type,
            value,
        }
    }
}

/// [`GamepadAxis`] changed event unfiltered by [`GamepadSettings`]
#[derive(Event, Debug, Copy, Clone, PartialEq, Reflect)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub struct RawGamepadAxisChangedEvent {
    /// The gamepad on which the axis is triggered.
    pub gamepad: Entity,
    /// The type of the triggered axis.
    pub axis: GamepadAxis,
    /// The value of the axis.
    pub value: f32,
}

impl RawGamepadAxisChangedEvent {
    /// Creates a [`RawGamepadAxisChangedEvent`].
    pub fn new(gamepad: Entity, axis_type: GamepadAxis, value: f32) -> Self {
        Self {
            gamepad,
            axis: axis_type,
            value,
        }
    }
}

/// A Gamepad connection event. Created when a connection to a gamepad
/// is established and when a gamepad is disconnected.
#[derive(Event, Debug, Clone, PartialEq, Reflect)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub struct GamepadConnectionEvent {
    /// The gamepad whose connection status changed.
    pub gamepad: Entity,
    /// The change in the gamepads connection.
    pub connection: GamepadConnection,
}

impl GamepadConnectionEvent {
    /// Creates a [`GamepadConnectionEvent`].
    pub fn new(gamepad: Entity, connection: GamepadConnection) -> Self {
        Self {
            gamepad,
            connection,
        }
    }

    /// Is the gamepad connected?
    pub fn connected(&self) -> bool {
        matches!(self.connection, GamepadConnection::Connected { .. })
    }

    /// Is the gamepad disconnected?
    pub fn disconnected(&self) -> bool {
        !self.connected()
    }
}

/// [`GamepadButton`] event triggered by a digital state change
#[derive(Event, Debug, Clone, Copy, PartialEq, Eq, Reflect)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub struct GamepadButtonStateChangedEvent {
    /// The entity that represents this gamepad.
    pub entity: Entity,
    /// The gamepad button assigned to the event.
    pub button: GamepadButton,
    /// The pressed state of the button.
    pub state: ButtonState,
}

impl GamepadButtonStateChangedEvent {
    /// Creates a new [`GamepadButtonStateChangedEvent`]
    pub fn new(entity: Entity, button: GamepadButton, state: ButtonState) -> Self {
        Self {
            entity,
            button,
            state,
        }
    }
}

/// [`GamepadButton`] event triggered by an analog state change
#[derive(Event, Debug, Clone, Copy, PartialEq, Reflect)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub struct GamepadButtonChangedEvent {
    /// The entity that represents this gamepad.
    pub entity: Entity,
    /// The gamepad button assigned to the event.
    pub button: GamepadButton,
    /// The pressed state of the button.
    pub state: ButtonState,
    /// The analog value of the button.
    pub value: f32,
}

impl GamepadButtonChangedEvent {
    /// Creates a new [`GamepadButtonChangedEvent`]
    pub fn new(entity: Entity, button: GamepadButton, state: ButtonState, value: f32) -> Self {
        Self {
            entity,
            button,
            state,
            value,
        }
    }
}

/// [`GamepadAxis`] event triggered by an analog state change
#[derive(Event, Debug, Clone, Copy, PartialEq, Reflect)]
#[reflect(Debug, PartialEq)]
#[cfg_attr(
    feature = "serialize",
    derive(serde::Serialize, serde::Deserialize),
    reflect(Serialize, Deserialize)
)]
pub struct GamepadAxisChangedEvent {
    /// The entity that represents this gamepad.
    pub entity: Entity,
    /// The gamepad axis assigned to the event.
    pub axis: GamepadAxis,
    /// The value of this axis.
    pub value: f32,
}

impl GamepadAxisChangedEvent {
    /// Creates a new [`GamepadAxisChangedEvent`]
    pub fn new(entity: Entity, axis: GamepadAxis, value: f32) -> Self {
        Self {
            entity,
            axis,
            value,
        }
    }
}

/// Errors that occur when setting axis settings for gamepad input.
#[derive(Error, Display, Debug, PartialEq)]
pub enum AxisSettingsError {
    /// The given parameter `livezone_lowerbound` was not in range -1.0..=0.0.
    #[display("invalid livezone_lowerbound {_0}, expected value [-1.0..=0.0]")]
    #[error(ignore)]
    LiveZoneLowerBoundOutOfRange(f32),
    /// The given parameter `deadzone_lowerbound` was not in range -1.0..=0.0.
    #[display("invalid deadzone_lowerbound {_0}, expected value [-1.0..=0.0]")]
    #[error(ignore)]
    DeadZoneLowerBoundOutOfRange(f32),
    /// The given parameter `deadzone_lowerbound` was not in range -1.0..=0.0.
    #[display("invalid deadzone_upperbound {_0}, expected value [0.0..=1.0]")]
    #[error(ignore)]
    DeadZoneUpperBoundOutOfRange(f32),
    /// The given parameter `deadzone_lowerbound` was not in range -1.0..=0.0.
    #[display("invalid livezone_upperbound {_0}, expected value [0.0..=1.0]")]
    #[error(ignore)]
    LiveZoneUpperBoundOutOfRange(f32),
    /// Parameter `livezone_lowerbound` was not less than or equal to parameter `deadzone_lowerbound`.
    #[display("invalid parameter values livezone_lowerbound {} deadzone_lowerbound {}, expected livezone_lowerbound <= deadzone_lowerbound", livezone_lowerbound, deadzone_lowerbound)]
    LiveZoneLowerBoundGreaterThanDeadZoneLowerBound {
        /// The value of the `livezone_lowerbound` parameter.
        livezone_lowerbound: f32,
        /// The value of the `deadzone_lowerbound` parameter.
        deadzone_lowerbound: f32,
    },
    ///  Parameter `deadzone_upperbound` was not less than or equal to parameter `livezone_upperbound`.
    #[display("invalid parameter values livezone_upperbound {} deadzone_upperbound {}, expected deadzone_upperbound <= livezone_upperbound", livezone_upperbound, deadzone_upperbound)]
    DeadZoneUpperBoundGreaterThanLiveZoneUpperBound {
        /// The value of the `livezone_upperbound` parameter.
        livezone_upperbound: f32,
        /// The value of the `deadzone_upperbound` parameter.
        deadzone_upperbound: f32,
    },
    /// The given parameter was not in range 0.0..=2.0.
    #[display("invalid threshold {_0}, expected 0.0 <= threshold <= 2.0")]
    #[error(ignore)]
    Threshold(f32),
}

/// Errors that occur when setting button settings for gamepad input.
#[derive(Error, Display, Debug, PartialEq)]
pub enum ButtonSettingsError {
    /// The given parameter was not in range 0.0..=1.0.
    #[display("invalid release_threshold {_0}, expected value [0.0..=1.0]")]
    #[error(ignore)]
    ReleaseThresholdOutOfRange(f32),
    /// The given parameter was not in range 0.0..=1.0.
    #[display("invalid press_threshold {_0}, expected [0.0..=1.0]")]
    #[error(ignore)]
    PressThresholdOutOfRange(f32),
    /// Parameter `release_threshold` was not less than or equal to `press_threshold`.
    #[display("invalid parameter values release_threshold {} press_threshold {}, expected release_threshold <= press_threshold", release_threshold, press_threshold)]
    ReleaseThresholdGreaterThanPressThreshold {
        /// The value of the `press_threshold` parameter.
        press_threshold: f32,
        /// The value of the `release_threshold` parameter.
        release_threshold: f32,
    },
}

/// Stores a connected gamepad's metadata such as the name and its [`GamepadButton`] and [`GamepadAxis`].
///
/// An entity with this component is spawned automatically after [`GamepadConnectionEvent`]
/// and updated by [`gamepad_event_processing_system`].
///
/// See also [`GamepadSettings`] for configuration.
///
/// # Examples
///
/// ```
/// # use bevy_input::gamepad::{Gamepad, GamepadAxis, GamepadButton};
/// # use bevy_ecs::system::Query;
/// # use bevy_core::Name;
/// #
/// fn gamepad_usage_system(gamepads: Query<(&Name, &Gamepad)>) {
///     for (name, gamepad) in &gamepads {
///         println!("{name}");
///
///         if gamepad.just_pressed(GamepadButton::North) {
///             println!("{} just pressed North", name)
///         }
///
///         if let Some(left_stick_x) = gamepad.get(GamepadAxis::LeftStickX)  {
///             println!("left stick X: {}", left_stick_x)
///         }
///     }
/// }
/// ```
#[derive(Component, Debug)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug))]
#[require(GamepadSettings)]
pub struct Gamepad {
    /// The USB vendor ID as assigned by the USB-IF, if available.
    pub(crate) vendor_id: Option<u16>,

    /// The USB product ID as assigned by the [vendor], if available.
    ///
    /// [vendor]: Self::vendor_id
    pub(crate) product_id: Option<u16>,

    /// [`ButtonInput`] of [`GamepadButton`] representing their digital state
    pub(crate) digital: ButtonInput<GamepadButton>,

    /// [`Axis`] of [`GamepadButton`] representing their analog state.
    pub(crate) analog: Axis<GamepadInput>,
}

impl Gamepad {
    /// Returns the USB vendor ID as assigned by the USB-IF, if available.
    pub fn vendor_id(&self) -> Option<u16> {
        self.vendor_id
    }

    /// Returns the USB product ID as assigned by the [vendor], if available.
    ///
    /// [vendor]: Self::vendor_id
    pub fn product_id(&self) -> Option<u16> {
        self.product_id
    }

    /// Returns the analog data of the provided [`GamepadAxis`] or [`GamepadButton`].
    ///
    /// This will be clamped between [[`Axis::MIN`],[`Axis::MAX`]].
    pub fn get(&self, input: impl Into<GamepadInput>) -> Option<f32> {
        self.analog.get(input.into())
    }

    /// Returns the unclamped analog data of the provided [`GamepadAxis`] or [`GamepadButton`].
    ///
    /// This value may be outside the [`Axis::MIN`] and [`Axis::MAX`] range.
    pub fn get_unclamped(&self, input: impl Into<GamepadInput>) -> Option<f32> {
        self.analog.get_unclamped(input.into())
    }

    /// Returns the left stick as a [`Vec2`]
    pub fn left_stick(&self) -> Vec2 {
        Vec2 {
            x: self.get(GamepadAxis::LeftStickX).unwrap_or(0.0),
            y: self.get(GamepadAxis::LeftStickY).unwrap_or(0.0),
        }
    }

    /// Returns the right stick as a [`Vec2`]
    pub fn right_stick(&self) -> Vec2 {
        Vec2 {
            x: self.get(GamepadAxis::RightStickX).unwrap_or(0.0),
            y: self.get(GamepadAxis::RightStickY).unwrap_or(0.0),
        }
    }

    /// Returns the directional pad as a [`Vec2`]
    pub fn dpad(&self) -> Vec2 {
        Vec2 {
            x: self.get(GamepadButton::DPadRight).unwrap_or(0.0)
                - self.get(GamepadButton::DPadLeft).unwrap_or(0.0),
            y: self.get(GamepadButton::DPadUp).unwrap_or(0.0)
                - self.get(GamepadButton::DPadDown).unwrap_or(0.0),
        }
    }

    /// Returns `true` if the [`GamepadButton`] has been pressed.
    pub fn pressed(&self, button_type: GamepadButton) -> bool {
        self.digital.pressed(button_type)
    }

    /// Returns `true` if any item in the [`GamepadButton`] iterator has been pressed.
    pub fn any_pressed(&self, button_inputs: impl IntoIterator<Item = GamepadButton>) -> bool {
        self.digital.any_pressed(button_inputs)
    }

    /// Returns `true` if all items in the [`GamepadButton`] iterator have been pressed.
    pub fn all_pressed(&self, button_inputs: impl IntoIterator<Item = GamepadButton>) -> bool {
        self.digital.all_pressed(button_inputs)
    }

    /// Returns `true` if the [`GamepadButton`] has been pressed during the current frame.
    ///
    /// Note: This function does not imply information regarding the current state of [`ButtonInput::pressed`] or [`ButtonInput::just_released`].
    pub fn just_pressed(&self, button_type: GamepadButton) -> bool {
        self.digital.just_pressed(button_type)
    }

    /// Returns `true` if any item in the [`GamepadButton`] iterator has been pressed during the current frame.
    pub fn any_just_pressed(&self, button_inputs: impl IntoIterator<Item = GamepadButton>) -> bool {
        self.digital.any_just_pressed(button_inputs)
    }

    /// Returns `true` if all items in the [`GamepadButton`] iterator have been just pressed.
    pub fn all_just_pressed(&self, button_inputs: impl IntoIterator<Item = GamepadButton>) -> bool {
        self.digital.all_just_pressed(button_inputs)
    }

    /// Returns `true` if the [`GamepadButton`] has been released during the current frame.
    ///
    /// Note: This function does not imply information regarding the current state of [`ButtonInput::pressed`] or [`ButtonInput::just_pressed`].
    pub fn just_released(&self, button_type: GamepadButton) -> bool {
        self.digital.just_released(button_type)
    }

    /// Returns `true` if any item in the [`GamepadButton`] iterator has just been released.
    pub fn any_just_released(
        &self,
        button_inputs: impl IntoIterator<Item = GamepadButton>,
    ) -> bool {
        self.digital.any_just_released(button_inputs)
    }

    /// Returns `true` if all items in the [`GamepadButton`] iterator have just been released.
    pub fn all_just_released(
        &self,
        button_inputs: impl IntoIterator<Item = GamepadButton>,
    ) -> bool {
        self.digital.all_just_released(button_inputs)
    }

    /// Returns an iterator over all digital [button]s that are pressed.
    ///
    /// [button]: GamepadButton
    pub fn get_pressed(&self) -> impl Iterator<Item = &GamepadButton> {
        self.digital.get_pressed()
    }

    /// Returns an iterator over all digital [button]s that were just pressed.
    ///
    /// [button]: GamepadButton
    pub fn get_just_pressed(&self) -> impl Iterator<Item = &GamepadButton> {
        self.digital.get_just_pressed()
    }

    /// Returns an iterator over all digital [button]s that were just released.
    ///
    /// [button]: GamepadButton
    pub fn get_just_released(&self) -> impl Iterator<Item = &GamepadButton> {
        self.digital.get_just_released()
    }

    /// Returns an iterator over all analog [axes].
    ///
    /// [axes]: GamepadInput
    pub fn get_analog_axes(&self) -> impl Iterator<Item = &GamepadInput> {
        self.analog.all_axes()
    }

    /// [`ButtonInput`] of [`GamepadButton`] representing their digital state
    pub fn digital(&self) -> &ButtonInput<GamepadButton> {
        &self.digital
    }

    /// Mutable [`ButtonInput`] of [`GamepadButton`] representing their digital state. Useful for mocking inputs.
    pub fn digital_mut(&mut self) -> &mut ButtonInput<GamepadButton> {
        &mut self.digital
    }

    /// [`Axis`] of [`GamepadButton`] representing their analog state.
    pub fn analog(&self) -> &Axis<GamepadInput> {
        &self.analog
    }

    /// Mutable [`Axis`] of [`GamepadButton`] representing their analog state. Useful for mocking inputs.
    pub fn analog_mut(&mut self) -> &mut Axis<GamepadInput> {
        &mut self.analog
    }
}

impl Default for Gamepad {
    fn default() -> Self {
        let mut analog = Axis::default();
        for button in GamepadButton::all().iter().copied() {
            analog.set(button, 0.0);
        }
        for axis_type in GamepadAxis::all().iter().copied() {
            analog.set(axis_type, 0.0);
        }

        Self {
            vendor_id: None,
            product_id: None,
            digital: Default::default(),
            analog,
        }
    }
}

/// Represents gamepad input types that are mapped in the range [0.0, 1.0].
///
/// ## Usage
///
/// This is used to determine which button has changed its value when receiving gamepad button events
/// It is also used in the [`Gamepad`] component.
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash, PartialOrd, Ord)]
#[cfg_attr(
    feature = "bevy_reflect",
    derive(Reflect),
    reflect(Debug, Hash, PartialEq)
)]
#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(
    all(feature = "serialize", feature = "bevy_reflect"),
    reflect(Serialize, Deserialize)
)]
pub enum GamepadButton {
    /// The bottom action button of the action pad (i.e. PS: Cross, Xbox: A).
    South,
    /// The right action button of the action pad (i.e. PS: Circle, Xbox: B).
    East,
    /// The upper action button of the action pad (i.e. PS: Triangle, Xbox: Y).
    North,
    /// The left action button of the action pad (i.e. PS: Square, Xbox: X).
    West,

    /// The C button.
    C,
    /// The Z button.
    Z,

    /// The first left trigger.
    LeftTrigger,
    /// The second left trigger.
    LeftTrigger2,
    /// The first right trigger.
    RightTrigger,
    /// The second right trigger.
    RightTrigger2,
    /// The select button.
    Select,
    /// The start button.
    Start,
    /// The mode button.
    Mode,

    /// The left thumb stick button.
    LeftThumb,
    /// The right thumb stick button.
    RightThumb,

    /// The up button of the D-Pad.
    DPadUp,
    /// The down button of the D-Pad.
    DPadDown,
    /// The left button of the D-Pad.
    DPadLeft,
    /// The right button of the D-Pad.
    DPadRight,

    /// Miscellaneous buttons, considered non-standard (i.e. Extra buttons on a flight stick that do not have a gamepad equivalent).
    Other(u8),
}

impl GamepadButton {
    /// Returns an array of all the standard [`GamepadButton`]
    pub const fn all() -> [GamepadButton; 19] {
        [
            GamepadButton::South,
            GamepadButton::East,
            GamepadButton::North,
            GamepadButton::West,
            GamepadButton::C,
            GamepadButton::Z,
            GamepadButton::LeftTrigger,
            GamepadButton::LeftTrigger2,
            GamepadButton::RightTrigger,
            GamepadButton::RightTrigger2,
            GamepadButton::Select,
            GamepadButton::Start,
            GamepadButton::Mode,
            GamepadButton::LeftThumb,
            GamepadButton::RightThumb,
            GamepadButton::DPadUp,
            GamepadButton::DPadDown,
            GamepadButton::DPadLeft,
            GamepadButton::DPadRight,
        ]
    }
}

/// Represents gamepad input types that are mapped in the range [-1.0, 1.0]
///
/// ## Usage
///
/// This is used to determine which axis has changed its value when receiving a
/// gamepad axis event. It is also used in the [`Gamepad`] component.
#[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, PartialEq))]
#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(
    all(feature = "serialize", feature = "bevy_reflect"),
    reflect(Serialize, Deserialize)
)]
pub enum GamepadAxis {
    /// The horizontal value of the left stick.
    LeftStickX,
    /// The vertical value of the left stick.
    LeftStickY,
    /// The value of the left `Z` button.
    LeftZ,

    /// The horizontal value of the right stick.
    RightStickX,
    /// The vertical value of the right stick.
    RightStickY,
    /// The value of the right `Z` button.
    RightZ,

    /// Non-standard support for other axis types (i.e. HOTAS sliders, potentiometers, etc).
    Other(u8),
}

impl GamepadAxis {
    /// Returns an array of all the standard [`GamepadAxis`].
    pub const fn all() -> [GamepadAxis; 6] {
        [
            GamepadAxis::LeftStickX,
            GamepadAxis::LeftStickY,
            GamepadAxis::LeftZ,
            GamepadAxis::RightStickX,
            GamepadAxis::RightStickY,
            GamepadAxis::RightZ,
        ]
    }
}

/// Encapsulation over [`GamepadAxis`] and [`GamepadButton`]
// This is done so Gamepad can share a single Axis<T> and simplifies the API by having only one get/get_unclamped method
#[derive(Debug, Copy, Clone, Eq, Hash, PartialEq, From)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, PartialEq))]
pub enum GamepadInput {
    /// A [`GamepadAxis`]
    Axis(GamepadAxis),
    /// A [`GamepadButton`]
    Button(GamepadButton),
}

/// Gamepad settings component.
///
/// ## Usage
///
/// It is used to create a `bevy` component that stores the settings of [`GamepadButton`] and [`GamepadAxis`] in [`Gamepad`].
/// If no user defined [`ButtonSettings`], [`AxisSettings`], or [`ButtonAxisSettings`]
/// are defined, the default settings of each are used as a fallback accordingly.
///
/// ## Note
///
/// The [`GamepadSettings`] are used to determine when raw gamepad events
/// should register. Events that don't meet the change thresholds defined in [`GamepadSettings`]
/// will not register. To modify these settings, mutate the corresponding component.
#[derive(Component, Clone, Default, Debug)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, Default))]
pub struct GamepadSettings {
    /// The default button settings.
    pub default_button_settings: ButtonSettings,
    /// The default axis settings.
    pub default_axis_settings: AxisSettings,
    /// The default button axis settings.
    pub default_button_axis_settings: ButtonAxisSettings,
    /// The user defined button settings.
    pub button_settings: HashMap<GamepadButton, ButtonSettings>,
    /// The user defined axis settings.
    pub axis_settings: HashMap<GamepadAxis, AxisSettings>,
    /// The user defined button axis settings.
    pub button_axis_settings: HashMap<GamepadButton, ButtonAxisSettings>,
}

impl GamepadSettings {
    /// Returns the [`ButtonSettings`] of the [`GamepadButton`].
    ///
    /// If no user defined [`ButtonSettings`] are specified the default [`ButtonSettings`] get returned.
    ///
    /// # Examples
    ///
    /// ```
    /// # use bevy_input::gamepad::{GamepadSettings, GamepadButton};
    /// #
    /// # let settings = GamepadSettings::default();
    /// let button_settings = settings.get_button_settings(GamepadButton::South);
    /// ```
    pub fn get_button_settings(&self, button: GamepadButton) -> &ButtonSettings {
        self.button_settings
            .get(&button)
            .unwrap_or(&self.default_button_settings)
    }

    /// Returns the [`AxisSettings`] of the [`GamepadAxis`].
    ///
    /// If no user defined [`AxisSettings`] are specified the default [`AxisSettings`] get returned.
    ///
    /// # Examples
    ///
    /// ```
    /// # use bevy_input::gamepad::{GamepadSettings, GamepadAxis};
    /// #
    /// # let settings = GamepadSettings::default();
    /// let axis_settings = settings.get_axis_settings(GamepadAxis::LeftStickX);
    /// ```
    pub fn get_axis_settings(&self, axis: GamepadAxis) -> &AxisSettings {
        self.axis_settings
            .get(&axis)
            .unwrap_or(&self.default_axis_settings)
    }

    /// Returns the [`ButtonAxisSettings`] of the [`GamepadButton`].
    ///
    /// If no user defined [`ButtonAxisSettings`] are specified the default [`ButtonAxisSettings`] get returned.
    ///
    /// # Examples
    ///
    /// ```
    /// # use bevy_input::gamepad::{GamepadSettings, GamepadButton};
    /// #
    /// # let settings = GamepadSettings::default();
    /// let button_axis_settings = settings.get_button_axis_settings(GamepadButton::South);
    /// ```
    pub fn get_button_axis_settings(&self, button: GamepadButton) -> &ButtonAxisSettings {
        self.button_axis_settings
            .get(&button)
            .unwrap_or(&self.default_button_axis_settings)
    }
}

/// Manages settings for gamepad buttons.
///
/// It is used inside [`GamepadSettings`] to define the threshold for a [`GamepadButton`]
/// to be considered pressed or released. A button is considered pressed if the `press_threshold`
/// value is surpassed and released if the `release_threshold` value is undercut.
///
/// Allowed values: `0.0 <= ``release_threshold`` <= ``press_threshold`` <= 1.0`
#[derive(Debug, PartialEq, Clone)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, Default))]
pub struct ButtonSettings {
    press_threshold: f32,
    release_threshold: f32,
}

impl Default for ButtonSettings {
    fn default() -> Self {
        ButtonSettings {
            press_threshold: 0.75,
            release_threshold: 0.65,
        }
    }
}

impl ButtonSettings {
    /// Creates a new [`ButtonSettings`] instance.
    ///
    /// # Parameters
    ///
    /// + `press_threshold` is the button input value above which the button is considered pressed.
    /// + `release_threshold` is the button input value below which the button is considered released.
    ///
    /// Restrictions:
    /// + `0.0 <= ``release_threshold`` <= ``press_threshold`` <= 1.0`
    ///
    /// # Errors
    ///
    /// If the restrictions are not met, returns one of
    /// `GamepadSettingsError::ButtonReleaseThresholdOutOfRange`,
    /// `GamepadSettingsError::ButtonPressThresholdOutOfRange`, or
    /// `GamepadSettingsError::ButtonReleaseThresholdGreaterThanPressThreshold`.
    pub fn new(
        press_threshold: f32,
        release_threshold: f32,
    ) -> Result<ButtonSettings, ButtonSettingsError> {
        if !(0.0..=1.0).contains(&release_threshold) {
            Err(ButtonSettingsError::ReleaseThresholdOutOfRange(
                release_threshold,
            ))
        } else if !(0.0..=1.0).contains(&press_threshold) {
            Err(ButtonSettingsError::PressThresholdOutOfRange(
                press_threshold,
            ))
        } else if release_threshold > press_threshold {
            Err(
                ButtonSettingsError::ReleaseThresholdGreaterThanPressThreshold {
                    press_threshold,
                    release_threshold,
                },
            )
        } else {
            Ok(ButtonSettings {
                press_threshold,
                release_threshold,
            })
        }
    }

    /// Returns `true` if the button is pressed.
    ///
    /// A button is considered pressed if the `value` passed is greater than or equal to the press threshold.
    pub fn is_pressed(&self, value: f32) -> bool {
        value >= self.press_threshold
    }

    /// Returns `true` if the button is released.
    ///
    /// A button is considered released if the `value` passed is lower than or equal to the release threshold.
    pub fn is_released(&self, value: f32) -> bool {
        value <= self.release_threshold
    }

    /// Get the button input threshold above which the button is considered pressed.
    pub fn press_threshold(&self) -> f32 {
        self.press_threshold
    }

    /// Try to set the button input threshold above which the button is considered pressed.
    ///
    /// # Errors
    ///
    /// If the value passed is outside the range [release threshold..=1.0], returns either
    /// `GamepadSettingsError::ButtonPressThresholdOutOfRange` or
    /// `GamepadSettingsError::ButtonReleaseThresholdGreaterThanPressThreshold`.
    pub fn try_set_press_threshold(&mut self, value: f32) -> Result<(), ButtonSettingsError> {
        if (self.release_threshold..=1.0).contains(&value) {
            self.press_threshold = value;
            Ok(())
        } else if !(0.0..1.0).contains(&value) {
            Err(ButtonSettingsError::PressThresholdOutOfRange(value))
        } else {
            Err(
                ButtonSettingsError::ReleaseThresholdGreaterThanPressThreshold {
                    press_threshold: value,
                    release_threshold: self.release_threshold,
                },
            )
        }
    }

    /// Try to set the button input threshold above which the button is considered pressed.
    /// If the value passed is outside the range [release threshold..=1.0], the value will not be changed.
    ///
    /// Returns the new value of the press threshold.
    pub fn set_press_threshold(&mut self, value: f32) -> f32 {
        self.try_set_press_threshold(value).ok();
        self.press_threshold
    }

    /// Get the button input threshold below which the button is considered released.
    pub fn release_threshold(&self) -> f32 {
        self.release_threshold
    }

    /// Try to set the button input threshold below which the button is considered released.
    ///
    /// # Errors
    ///
    /// If the value passed is outside the range [0.0..=press threshold], returns
    /// `ButtonSettingsError::ReleaseThresholdOutOfRange` or
    /// `ButtonSettingsError::ReleaseThresholdGreaterThanPressThreshold`.
    pub fn try_set_release_threshold(&mut self, value: f32) -> Result<(), ButtonSettingsError> {
        if (0.0..=self.press_threshold).contains(&value) {
            self.release_threshold = value;
            Ok(())
        } else if !(0.0..1.0).contains(&value) {
            Err(ButtonSettingsError::ReleaseThresholdOutOfRange(value))
        } else {
            Err(
                ButtonSettingsError::ReleaseThresholdGreaterThanPressThreshold {
                    press_threshold: self.press_threshold,
                    release_threshold: value,
                },
            )
        }
    }

    /// Try to set the button input threshold below which the button is considered released. If the
    /// value passed is outside the range [0.0..=press threshold], the value will not be changed.
    ///
    /// Returns the new value of the release threshold.
    pub fn set_release_threshold(&mut self, value: f32) -> f32 {
        self.try_set_release_threshold(value).ok();
        self.release_threshold
    }
}

/// Settings for a [`GamepadAxis`].
///
/// It is used inside the [`GamepadSettings`] to define the sensitivity range and
/// threshold for an axis.
/// Values that are higher than `livezone_upperbound` will be rounded up to 1.0.
/// Values that are lower than `livezone_lowerbound` will be rounded down to -1.0.
/// Values that are in-between `deadzone_lowerbound` and `deadzone_upperbound` will be rounded
/// to 0.0.
/// Otherwise, values will not be rounded.
///
/// The valid range is `[-1.0, 1.0]`.
#[derive(Debug, Clone, PartialEq)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, Default))]
pub struct AxisSettings {
    /// Values that are higher than `livezone_upperbound` will be rounded up to 1.0.
    livezone_upperbound: f32,
    /// Positive values that are less than `deadzone_upperbound` will be rounded down to 0.0.
    deadzone_upperbound: f32,
    /// Negative values that are greater than `deadzone_lowerbound` will be rounded up to 0.0.
    deadzone_lowerbound: f32,
    /// Values that are lower than `livezone_lowerbound` will be rounded down to -1.0.
    livezone_lowerbound: f32,
    /// `threshold` defines the minimum difference between old and new values to apply the changes.
    threshold: f32,
}

impl Default for AxisSettings {
    fn default() -> Self {
        AxisSettings {
            livezone_upperbound: 1.0,
            deadzone_upperbound: 0.05,
            deadzone_lowerbound: -0.05,
            livezone_lowerbound: -1.0,
            threshold: 0.01,
        }
    }
}

impl AxisSettings {
    /// Creates a new [`AxisSettings`] instance.
    ///
    /// # Arguments
    ///
    /// + `livezone_lowerbound` - the value below which inputs will be rounded down to -1.0.
    /// + `deadzone_lowerbound` - the value above which negative inputs will be rounded up to 0.0.
    /// + `deadzone_upperbound` - the value below which positive inputs will be rounded down to 0.0.
    /// + `livezone_upperbound` - the value above which inputs will be rounded up to 1.0.
    /// + `threshold` - the minimum value by which input must change before the change is registered.
    ///
    /// Restrictions:
    ///
    /// + `-1.0 <= livezone_lowerbound <= deadzone_lowerbound <= 0.0`
    /// + `0.0 <= deadzone_upperbound <= livezone_upperbound <= 1.0`
    /// + `0.0 <= threshold <= 2.0`
    ///
    /// # Errors
    ///
    /// Returns an [`AxisSettingsError`] if any restrictions on the zone values are not met.
    /// If the zone restrictions are met, but the `threshold` value restrictions are not met,
    /// returns [`AxisSettingsError::Threshold`].
    pub fn new(
        livezone_lowerbound: f32,
        deadzone_lowerbound: f32,
        deadzone_upperbound: f32,
        livezone_upperbound: f32,
        threshold: f32,
    ) -> Result<AxisSettings, AxisSettingsError> {
        if !(-1.0..=0.0).contains(&livezone_lowerbound) {
            Err(AxisSettingsError::LiveZoneLowerBoundOutOfRange(
                livezone_lowerbound,
            ))
        } else if !(-1.0..=0.0).contains(&deadzone_lowerbound) {
            Err(AxisSettingsError::DeadZoneLowerBoundOutOfRange(
                deadzone_lowerbound,
            ))
        } else if !(0.0..=1.0).contains(&deadzone_upperbound) {
            Err(AxisSettingsError::DeadZoneUpperBoundOutOfRange(
                deadzone_upperbound,
            ))
        } else if !(0.0..=1.0).contains(&livezone_upperbound) {
            Err(AxisSettingsError::LiveZoneUpperBoundOutOfRange(
                livezone_upperbound,
            ))
        } else if livezone_lowerbound > deadzone_lowerbound {
            Err(
                AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound {
                    livezone_lowerbound,
                    deadzone_lowerbound,
                },
            )
        } else if deadzone_upperbound > livezone_upperbound {
            Err(
                AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound {
                    livezone_upperbound,
                    deadzone_upperbound,
                },
            )
        } else if !(0.0..=2.0).contains(&threshold) {
            Err(AxisSettingsError::Threshold(threshold))
        } else {
            Ok(Self {
                livezone_lowerbound,
                deadzone_lowerbound,
                deadzone_upperbound,
                livezone_upperbound,
                threshold,
            })
        }
    }

    /// Get the value above which inputs will be rounded up to 1.0.
    pub fn livezone_upperbound(&self) -> f32 {
        self.livezone_upperbound
    }

    /// Try to set the value above which inputs will be rounded up to 1.0.
    ///
    /// # Errors
    ///
    /// If the value passed is less than the dead zone upper bound,
    /// returns `AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound`.
    /// If the value passed is not in range [0.0..=1.0], returns `AxisSettingsError::LiveZoneUpperBoundOutOfRange`.
    pub fn try_set_livezone_upperbound(&mut self, value: f32) -> Result<(), AxisSettingsError> {
        if !(0.0..=1.0).contains(&value) {
            Err(AxisSettingsError::LiveZoneUpperBoundOutOfRange(value))
        } else if value < self.deadzone_upperbound {
            Err(
                AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound {
                    livezone_upperbound: value,
                    deadzone_upperbound: self.deadzone_upperbound,
                },
            )
        } else {
            self.livezone_upperbound = value;
            Ok(())
        }
    }

    /// Try to set the value above which inputs will be rounded up to 1.0.
    /// If the value passed is negative or less than `deadzone_upperbound`,
    /// the value will not be changed.
    ///
    /// Returns the new value of `livezone_upperbound`.
    pub fn set_livezone_upperbound(&mut self, value: f32) -> f32 {
        self.try_set_livezone_upperbound(value).ok();
        self.livezone_upperbound
    }

    /// Get the value below which positive inputs will be rounded down to 0.0.
    pub fn deadzone_upperbound(&self) -> f32 {
        self.deadzone_upperbound
    }

    /// Try to set the value below which positive inputs will be rounded down to 0.0.
    ///
    /// # Errors
    ///
    /// If the value passed is greater than the live zone upper bound,
    /// returns `AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound`.
    /// If the value passed is not in range [0.0..=1.0], returns `AxisSettingsError::DeadZoneUpperBoundOutOfRange`.
    pub fn try_set_deadzone_upperbound(&mut self, value: f32) -> Result<(), AxisSettingsError> {
        if !(0.0..=1.0).contains(&value) {
            Err(AxisSettingsError::DeadZoneUpperBoundOutOfRange(value))
        } else if self.livezone_upperbound < value {
            Err(
                AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound {
                    livezone_upperbound: self.livezone_upperbound,
                    deadzone_upperbound: value,
                },
            )
        } else {
            self.deadzone_upperbound = value;
            Ok(())
        }
    }

    /// Try to set the value below which positive inputs will be rounded down to 0.0.
    /// If the value passed is negative or greater than `livezone_upperbound`,
    /// the value will not be changed.
    ///
    /// Returns the new value of `deadzone_upperbound`.
    pub fn set_deadzone_upperbound(&mut self, value: f32) -> f32 {
        self.try_set_deadzone_upperbound(value).ok();
        self.deadzone_upperbound
    }

    /// Get the value below which negative inputs will be rounded down to -1.0.
    pub fn livezone_lowerbound(&self) -> f32 {
        self.livezone_lowerbound
    }

    /// Try to set the value below which negative inputs will be rounded down to -1.0.
    ///
    /// # Errors
    ///
    /// If the value passed is less than the dead zone lower bound,
    /// returns `AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound`.
    /// If the value passed is not in range [-1.0..=0.0], returns `AxisSettingsError::LiveZoneLowerBoundOutOfRange`.
    pub fn try_set_livezone_lowerbound(&mut self, value: f32) -> Result<(), AxisSettingsError> {
        if !(-1.0..=0.0).contains(&value) {
            Err(AxisSettingsError::LiveZoneLowerBoundOutOfRange(value))
        } else if value > self.deadzone_lowerbound {
            Err(
                AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound {
                    livezone_lowerbound: value,
                    deadzone_lowerbound: self.deadzone_lowerbound,
                },
            )
        } else {
            self.livezone_lowerbound = value;
            Ok(())
        }
    }

    /// Try to set the value below which negative inputs will be rounded down to -1.0.
    /// If the value passed is positive or greater than `deadzone_lowerbound`,
    /// the value will not be changed.
    ///
    /// Returns the new value of `livezone_lowerbound`.
    pub fn set_livezone_lowerbound(&mut self, value: f32) -> f32 {
        self.try_set_livezone_lowerbound(value).ok();
        self.livezone_lowerbound
    }

    /// Get the value above which inputs will be rounded up to 0.0.
    pub fn deadzone_lowerbound(&self) -> f32 {
        self.deadzone_lowerbound
    }

    /// Try to set the value above which inputs will be rounded up to 0.0.
    ///
    /// # Errors
    ///
    /// If the value passed is less than the live zone lower bound,
    /// returns `AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound`.
    /// If the value passed is not in range [-1.0..=0.0], returns `AxisSettingsError::DeadZoneLowerBoundOutOfRange`.
    pub fn try_set_deadzone_lowerbound(&mut self, value: f32) -> Result<(), AxisSettingsError> {
        if !(-1.0..=0.0).contains(&value) {
            Err(AxisSettingsError::DeadZoneLowerBoundOutOfRange(value))
        } else if self.livezone_lowerbound > value {
            Err(
                AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound {
                    livezone_lowerbound: self.livezone_lowerbound,
                    deadzone_lowerbound: value,
                },
            )
        } else {
            self.deadzone_lowerbound = value;
            Ok(())
        }
    }

    /// Try to set the value above which inputs will be rounded up to 0.0.
    /// If the value passed is less than -1.0 or less than `livezone_lowerbound`,
    /// the value will not be changed.
    ///
    /// Returns the new value of `deadzone_lowerbound`.
    pub fn set_deadzone_lowerbound(&mut self, value: f32) -> f32 {
        self.try_set_deadzone_lowerbound(value).ok();
        self.deadzone_lowerbound
    }

    /// Get the minimum value by which input must change before the change is registered.
    pub fn threshold(&self) -> f32 {
        self.threshold
    }

    /// Try to set the minimum value by which input must change before the change is registered.
    ///
    /// # Errors
    ///
    /// If the value passed is not within [0.0..=2.0], returns `GamepadSettingsError::AxisThreshold`.
    pub fn try_set_threshold(&mut self, value: f32) -> Result<(), AxisSettingsError> {
        if !(0.0..=2.0).contains(&value) {
            Err(AxisSettingsError::Threshold(value))
        } else {
            self.threshold = value;
            Ok(())
        }
    }

    /// Try to set the minimum value by which input must change before the changes will be applied.
    /// If the value passed is not within [0.0..=2.0], the value will not be changed.
    ///
    /// Returns the new value of threshold.
    pub fn set_threshold(&mut self, value: f32) -> f32 {
        self.try_set_threshold(value).ok();
        self.threshold
    }

    /// Clamps the `raw_value` according to the `AxisSettings`.
    pub fn clamp(&self, new_value: f32) -> f32 {
        if self.deadzone_lowerbound <= new_value && new_value <= self.deadzone_upperbound {
            0.0
        } else if new_value >= self.livezone_upperbound {
            1.0
        } else if new_value <= self.livezone_lowerbound {
            -1.0
        } else {
            new_value
        }
    }

    /// Determines whether the change from `old_value` to `new_value` should
    /// be registered as a change, according to the [`AxisSettings`].
    fn should_register_change(&self, new_value: f32, old_value: Option<f32>) -> bool {
        if old_value.is_none() {
            return true;
        }

        f32::abs(new_value - old_value.unwrap()) > self.threshold
    }

    /// Filters the `new_value` based on the `old_value`, according to the [`AxisSettings`].
    ///
    /// Returns the clamped `new_value` if the change exceeds the settings threshold,
    /// and `None` otherwise.
    pub fn filter(&self, new_value: f32, old_value: Option<f32>) -> Option<f32> {
        let new_value = self.clamp(new_value);

        if self.should_register_change(new_value, old_value) {
            return Some(new_value);
        }
        None
    }
}

/// Settings for a [`GamepadButton`].
///
/// It is used inside the [`GamepadSettings`] to define the sensitivity range and
/// threshold for a button axis.
///
/// ## Logic
///
/// - Values that are higher than or equal to `high` will be rounded to 1.0.
/// - Values that are lower than or equal to `low` will be rounded to 0.0.
/// - Otherwise, values will not be rounded.
///
/// The valid range is from 0.0 to 1.0, inclusive.
#[derive(Debug, Clone)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, Default))]
pub struct ButtonAxisSettings {
    /// The high value at which to apply rounding.
    pub high: f32,
    /// The low value at which to apply rounding.
    pub low: f32,
    /// The threshold to apply rounding.
    pub threshold: f32,
}

impl Default for ButtonAxisSettings {
    fn default() -> Self {
        ButtonAxisSettings {
            high: 0.95,
            low: 0.05,
            threshold: 0.01,
        }
    }
}

impl ButtonAxisSettings {
    /// Clamps the `raw_value` according to the specified settings.
    ///
    /// If the `raw_value` is:
    /// - lower than or equal to `low` it will be rounded to 0.0.
    /// - higher than or equal to `high` it will be rounded to 1.0.
    /// - Otherwise it will not be rounded.
    fn clamp(&self, raw_value: f32) -> f32 {
        if raw_value <= self.low {
            return 0.0;
        }
        if raw_value >= self.high {
            return 1.0;
        }

        raw_value
    }

    /// Determines whether the change from an `old_value` to a `new_value` should
    /// be registered as a change event, according to the specified settings.
    fn should_register_change(&self, new_value: f32, old_value: Option<f32>) -> bool {
        if old_value.is_none() {
            return true;
        }

        f32::abs(new_value - old_value.unwrap()) > self.threshold
    }

    /// Filters the `new_value` based on the `old_value`, according to the [`ButtonAxisSettings`].
    ///
    /// Returns the clamped `new_value`, according to the [`ButtonAxisSettings`], if the change
    /// exceeds the settings threshold, and `None` otherwise.
    pub fn filter(&self, new_value: f32, old_value: Option<f32>) -> Option<f32> {
        let new_value = self.clamp(new_value);

        if self.should_register_change(new_value, old_value) {
            return Some(new_value);
        }
        None
    }
}

/// Handles [`GamepadConnectionEvent`]s events.
///
/// On connection, adds the components representing a [`Gamepad`] to the entity.
/// On disconnection, removes the [`Gamepad`] and other related components.
/// Entities are left alive and might leave components like [`GamepadSettings`] to preserve state in the case of a reconnection
///
/// ## Note
///
/// Whenever a [`Gamepad`] connects or disconnects, an information gets printed to the console using the [`info!`] macro.
pub fn gamepad_connection_system(
    mut commands: Commands,
    mut connection_events: EventReader<GamepadConnectionEvent>,
) {
    for connection_event in connection_events.read() {
        let id = connection_event.gamepad;
        match &connection_event.connection {
            GamepadConnection::Connected {
                name,
                vendor_id,
                product_id,
            } => {
                let Some(mut gamepad) = commands.get_entity(id) else {
                    warn!("Gamepad {:} removed before handling connection event.", id);
                    continue;
                };
                gamepad.insert((
                    Name::new(name.clone()),
                    Gamepad {
                        vendor_id: *vendor_id,
                        product_id: *product_id,
                        ..Default::default()
                    },
                ));
                info!("Gamepad {:?} connected.", id);
            }
            GamepadConnection::Disconnected => {
                let Some(mut gamepad) = commands.get_entity(id) else {
                    warn!("Gamepad {:} removed before handling disconnection event. You can ignore this if you manually removed it.", id);
                    continue;
                };
                // Gamepad entities are left alive to preserve their state (e.g. [`GamepadSettings`]).
                // Instead of despawning, we remove Gamepad components that don't need to preserve state
                // and re-add them if they ever reconnect.
                gamepad.remove::<Gamepad>();
                info!("Gamepad {:} disconnected.", id);
            }
        }
    }
}

// Note that we don't expose `gilrs::Gamepad::uuid` due to
// https://gitlab.com/gilrs-project/gilrs/-/issues/153.
//
/// The connection status of a gamepad.
#[derive(Debug, Clone, PartialEq)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, PartialEq))]
#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(
    all(feature = "serialize", feature = "bevy_reflect"),
    reflect(Serialize, Deserialize)
)]
pub enum GamepadConnection {
    /// The gamepad is connected.
    Connected {
        /// The name of the gamepad.
        ///
        /// This name is generally defined by the OS.
        ///
        /// For example on Windows the name may be "HID-compliant game controller".
        name: String,

        /// The USB vendor ID as assigned by the USB-IF, if available.
        vendor_id: Option<u16>,

        /// The USB product ID as assigned by the vendor, if available.
        product_id: Option<u16>,
    },
    /// The gamepad is disconnected.
    Disconnected,
}

/// Consumes [`RawGamepadEvent`] events, filters them using their [`GamepadSettings`] and if successful,
/// updates the [`Gamepad`] and sends [`GamepadAxisChangedEvent`], [`GamepadButtonStateChangedEvent`], [`GamepadButtonChangedEvent`] events.
pub fn gamepad_event_processing_system(
    mut gamepads: Query<(&mut Gamepad, &GamepadSettings)>,
    mut raw_events: EventReader<RawGamepadEvent>,
    mut processed_events: EventWriter<GamepadEvent>,
    mut processed_axis_events: EventWriter<GamepadAxisChangedEvent>,
    mut processed_digital_events: EventWriter<GamepadButtonStateChangedEvent>,
    mut processed_analog_events: EventWriter<GamepadButtonChangedEvent>,
) {
    // Clear digital buttons state
    for (mut gamepad, _) in gamepads.iter_mut() {
        gamepad.bypass_change_detection().digital.clear();
    }

    for event in raw_events.read() {
        match event {
            // Connections require inserting/removing components so they are done in a separate system
            RawGamepadEvent::Connection(send_event) => {
                processed_events.send(GamepadEvent::from(send_event.clone()));
            }
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent {
                gamepad,
                axis,
                value,
            }) => {
                let (gamepad, axis, value) = (*gamepad, *axis, *value);
                let Ok((mut gamepad_axis, gamepad_settings)) = gamepads.get_mut(gamepad) else {
                    continue;
                };
                let Some(filtered_value) = gamepad_settings
                    .get_axis_settings(axis)
                    .filter(value, gamepad_axis.get(axis))
                else {
                    continue;
                };

                gamepad_axis.analog.set(axis, filtered_value);
                let send_event = GamepadAxisChangedEvent::new(gamepad, axis, filtered_value);
                processed_axis_events.send(send_event);
                processed_events.send(GamepadEvent::from(send_event));
            }
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent {
                gamepad,
                button,
                value,
            }) => {
                let (gamepad, button, value) = (*gamepad, *button, *value);
                let Ok((mut gamepad_buttons, settings)) = gamepads.get_mut(gamepad) else {
                    continue;
                };
                let Some(filtered_value) = settings
                    .get_button_axis_settings(button)
                    .filter(value, gamepad_buttons.get(button))
                else {
                    continue;
                };
                let button_settings = settings.get_button_settings(button);
                gamepad_buttons.analog.set(button, filtered_value);

                if button_settings.is_released(filtered_value) {
                    // Check if button was previously pressed
                    if gamepad_buttons.pressed(button) {
                        processed_digital_events.send(GamepadButtonStateChangedEvent::new(
                            gamepad,
                            button,
                            ButtonState::Released,
                        ));
                    }
                    // We don't have to check if the button was previously pressed here
                    // because that check is performed within Input<T>::release()
                    gamepad_buttons.digital.release(button);
                } else if button_settings.is_pressed(filtered_value) {
                    // Check if button was previously not pressed
                    if !gamepad_buttons.pressed(button) {
                        processed_digital_events.send(GamepadButtonStateChangedEvent::new(
                            gamepad,
                            button,
                            ButtonState::Pressed,
                        ));
                    }
                    gamepad_buttons.digital.press(button);
                };

                let button_state = if gamepad_buttons.digital.pressed(button) {
                    ButtonState::Pressed
                } else {
                    ButtonState::Released
                };
                let send_event =
                    GamepadButtonChangedEvent::new(gamepad, button, button_state, filtered_value);
                processed_analog_events.send(send_event);
                processed_events.send(GamepadEvent::from(send_event));
            }
        }
    }
}

/// The intensity at which a gamepad's force-feedback motors may rumble.
#[derive(Clone, Copy, Debug, PartialEq)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect), reflect(Debug, PartialEq))]
pub struct GamepadRumbleIntensity {
    /// The rumble intensity of the strong gamepad motor.
    ///
    /// Ranges from `0.0` to `1.0`.
    ///
    /// By convention, this is usually a low-frequency motor on the left-hand
    /// side of the gamepad, though it may vary across platforms and hardware.
    pub strong_motor: f32,
    /// The rumble intensity of the weak gamepad motor.
    ///
    /// Ranges from `0.0` to `1.0`.
    ///
    /// By convention, this is usually a high-frequency motor on the right-hand
    /// side of the gamepad, though it may vary across platforms and hardware.
    pub weak_motor: f32,
}

impl GamepadRumbleIntensity {
    /// Rumble both gamepad motors at maximum intensity.
    pub const MAX: Self = GamepadRumbleIntensity {
        strong_motor: 1.0,
        weak_motor: 1.0,
    };

    /// Rumble the weak motor at maximum intensity.
    pub const WEAK_MAX: Self = GamepadRumbleIntensity {
        strong_motor: 0.0,
        weak_motor: 1.0,
    };

    /// Rumble the strong motor at maximum intensity.
    pub const STRONG_MAX: Self = GamepadRumbleIntensity {
        strong_motor: 1.0,
        weak_motor: 0.0,
    };

    /// Creates a new rumble intensity with weak motor intensity set to the given value.
    ///
    /// Clamped within the `0.0` to `1.0` range.
    pub const fn weak_motor(intensity: f32) -> Self {
        Self {
            weak_motor: intensity,
            strong_motor: 0.0,
        }
    }

    /// Creates a new rumble intensity with strong motor intensity set to the given value.
    ///
    /// Clamped within the `0.0` to `1.0` range.
    pub const fn strong_motor(intensity: f32) -> Self {
        Self {
            strong_motor: intensity,
            weak_motor: 0.0,
        }
    }
}

/// An event that controls force-feedback rumbling of a [`Gamepad`] [`entity`](Entity).
///
/// # Notes
///
/// Does nothing if the gamepad or platform does not support rumble.
///
/// # Example
///
/// ```
/// # use bevy_input::gamepad::{Gamepad, GamepadRumbleRequest, GamepadRumbleIntensity};
/// # use bevy_ecs::prelude::{EventWriter, Res, Query, Entity, With};
/// # use bevy_utils::Duration;
/// fn rumble_gamepad_system(
///     mut rumble_requests: EventWriter<GamepadRumbleRequest>,
///     gamepads: Query<Entity, With<Gamepad>>,
/// ) {
///     for entity in gamepads.iter() {
///         rumble_requests.send(GamepadRumbleRequest::Add {
///             gamepad: entity,
///             intensity: GamepadRumbleIntensity::MAX,
///             duration: Duration::from_secs_f32(0.5),
///         });
///     }
/// }
/// ```
#[doc(alias = "haptic feedback")]
#[doc(alias = "force feedback")]
#[doc(alias = "vibration")]
#[doc(alias = "vibrate")]
#[derive(Event, Clone)]
#[cfg_attr(feature = "bevy_reflect", derive(Reflect))]
pub enum GamepadRumbleRequest {
    /// Add a rumble to the given gamepad.
    ///
    /// Simultaneous rumble effects add up to the sum of their strengths.
    ///
    /// Consequently, if two rumbles at half intensity are added at the same
    /// time, their intensities will be added up, and the controller will rumble
    /// at full intensity until one of the rumbles finishes, then the rumble
    /// will continue at the intensity of the remaining event.
    ///
    /// To replace an existing rumble, send a [`GamepadRumbleRequest::Stop`] event first.
    Add {
        /// How long the gamepad should rumble.
        duration: Duration,
        /// How intense the rumble should be.
        intensity: GamepadRumbleIntensity,
        /// The gamepad to rumble.
        gamepad: Entity,
    },
    /// Stop all running rumbles on the given [`Entity`].
    Stop {
        /// The gamepad to stop rumble.
        gamepad: Entity,
    },
}

impl GamepadRumbleRequest {
    /// Get the [`Entity`] associated with this request.
    pub fn gamepad(&self) -> Entity {
        match self {
            Self::Add { gamepad, .. } | Self::Stop { gamepad } => *gamepad,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::{
        gamepad_connection_system, gamepad_event_processing_system, AxisSettings,
        AxisSettingsError, ButtonAxisSettings, ButtonSettings, ButtonSettingsError, Gamepad,
        GamepadAxis, GamepadAxisChangedEvent, GamepadButton, GamepadButtonChangedEvent,
        GamepadButtonStateChangedEvent,
        GamepadConnection::{Connected, Disconnected},
        GamepadConnectionEvent, GamepadEvent, GamepadSettings, RawGamepadAxisChangedEvent,
        RawGamepadButtonChangedEvent, RawGamepadEvent,
    };
    use crate::ButtonState;
    use bevy_app::{App, PreUpdate};
    use bevy_ecs::entity::Entity;
    use bevy_ecs::event::Events;
    use bevy_ecs::schedule::IntoSystemConfigs;

    fn test_button_axis_settings_filter(
        settings: ButtonAxisSettings,
        new_value: f32,
        old_value: Option<f32>,
        expected: Option<f32>,
    ) {
        let actual = settings.filter(new_value, old_value);
        assert_eq!(
            expected, actual,
            "Testing filtering for {settings:?} with new_value = {new_value:?}, old_value = {old_value:?}",
        );
    }

    #[test]
    fn test_button_axis_settings_default_filter() {
        let cases = [
            (1.0, None, Some(1.0)),
            (0.99, None, Some(1.0)),
            (0.96, None, Some(1.0)),
            (0.95, None, Some(1.0)),
            (0.9499, None, Some(0.9499)),
            (0.84, None, Some(0.84)),
            (0.43, None, Some(0.43)),
            (0.05001, None, Some(0.05001)),
            (0.05, None, Some(0.0)),
            (0.04, None, Some(0.0)),
            (0.01, None, Some(0.0)),
            (0.0, None, Some(0.0)),
        ];

        for (new_value, old_value, expected) in cases {
            let settings = ButtonAxisSettings::default();
            test_button_axis_settings_filter(settings, new_value, old_value, expected);
        }
    }

    #[test]
    fn test_button_axis_settings_default_filter_with_old_value() {
        let cases = [
            (0.43, Some(0.44001), Some(0.43)),
            (0.43, Some(0.44), None),
            (0.43, Some(0.43), None),
            (0.43, Some(0.41999), Some(0.43)),
            (0.43, Some(0.17), Some(0.43)),
            (0.43, Some(0.84), Some(0.43)),
            (0.05, Some(0.055), Some(0.0)),
            (0.95, Some(0.945), Some(1.0)),
        ];

        for (new_value, old_value, expected) in cases {
            let settings = ButtonAxisSettings::default();
            test_button_axis_settings_filter(settings, new_value, old_value, expected);
        }
    }

    fn test_axis_settings_filter(
        settings: AxisSettings,
        new_value: f32,
        old_value: Option<f32>,
        expected: Option<f32>,
    ) {
        let actual = settings.filter(new_value, old_value);
        assert_eq!(
            expected, actual,
            "Testing filtering for {settings:?} with new_value = {new_value:?}, old_value = {old_value:?}",
        );
    }

    #[test]
    fn test_axis_settings_default_filter() {
        let cases = [
            (1.0, Some(1.0)),
            (0.99, Some(1.0)),
            (0.96, Some(1.0)),
            (0.95, Some(1.0)),
            (0.9499, Some(0.9499)),
            (0.84, Some(0.84)),
            (0.43, Some(0.43)),
            (0.05001, Some(0.05001)),
            (0.05, Some(0.0)),
            (0.04, Some(0.0)),
            (0.01, Some(0.0)),
            (0.0, Some(0.0)),
            (-1.0, Some(-1.0)),
            (-0.99, Some(-1.0)),
            (-0.96, Some(-1.0)),
            (-0.95, Some(-1.0)),
            (-0.9499, Some(-0.9499)),
            (-0.84, Some(-0.84)),
            (-0.43, Some(-0.43)),
            (-0.05001, Some(-0.05001)),
            (-0.05, Some(0.0)),
            (-0.04, Some(0.0)),
            (-0.01, Some(0.0)),
        ];

        for (new_value, expected) in cases {
            let settings = AxisSettings::new(-0.95, -0.05, 0.05, 0.95, 0.01).unwrap();
            test_axis_settings_filter(settings, new_value, None, expected);
        }
    }

    #[test]
    fn test_axis_settings_default_filter_with_old_values() {
        let cases = [
            (0.43, Some(0.44001), Some(0.43)),
            (0.43, Some(0.44), None),
            (0.43, Some(0.43), None),
            (0.43, Some(0.41999), Some(0.43)),
            (0.43, Some(0.17), Some(0.43)),
            (0.43, Some(0.84), Some(0.43)),
            (0.05, Some(0.055), Some(0.0)),
            (0.95, Some(0.945), Some(1.0)),
            (-0.43, Some(-0.44001), Some(-0.43)),
            (-0.43, Some(-0.44), None),
            (-0.43, Some(-0.43), None),
            (-0.43, Some(-0.41999), Some(-0.43)),
            (-0.43, Some(-0.17), Some(-0.43)),
            (-0.43, Some(-0.84), Some(-0.43)),
            (-0.05, Some(-0.055), Some(0.0)),
            (-0.95, Some(-0.945), Some(-1.0)),
        ];

        for (new_value, old_value, expected) in cases {
            let settings = AxisSettings::new(-0.95, -0.05, 0.05, 0.95, 0.01).unwrap();
            test_axis_settings_filter(settings, new_value, old_value, expected);
        }
    }

    #[test]
    fn test_button_settings_default_is_pressed() {
        let cases = [
            (1.0, true),
            (0.95, true),
            (0.9, true),
            (0.8, true),
            (0.75, true),
            (0.7, false),
            (0.65, false),
            (0.5, false),
            (0.0, false),
        ];

        for (value, expected) in cases {
            let settings = ButtonSettings::default();
            let actual = settings.is_pressed(value);

            assert_eq!(
                expected, actual,
                "testing ButtonSettings::is_pressed() for value: {value}",
            );
        }
    }

    #[test]
    fn test_button_settings_default_is_released() {
        let cases = [
            (1.0, false),
            (0.95, false),
            (0.9, false),
            (0.8, false),
            (0.75, false),
            (0.7, false),
            (0.65, true),
            (0.5, true),
            (0.0, true),
        ];

        for (value, expected) in cases {
            let settings = ButtonSettings::default();
            let actual = settings.is_released(value);

            assert_eq!(
                expected, actual,
                "testing ButtonSettings::is_released() for value: {value}",
            );
        }
    }

    #[test]
    fn test_new_button_settings_given_valid_parameters() {
        let cases = [
            (1.0, 0.0),
            (1.0, 1.0),
            (1.0, 0.9),
            (0.9, 0.9),
            (0.9, 0.0),
            (0.0, 0.0),
        ];

        for (press_threshold, release_threshold) in cases {
            let bs = ButtonSettings::new(press_threshold, release_threshold);
            match bs {
                Ok(button_settings) => {
                    assert_eq!(button_settings.press_threshold, press_threshold);
                    assert_eq!(button_settings.release_threshold, release_threshold);
                }
                Err(_) => {
                    panic!(
                        "ButtonSettings::new({press_threshold}, {release_threshold}) should be valid"
                    );
                }
            }
        }
    }

    #[test]
    fn test_new_button_settings_given_invalid_parameters() {
        let cases = [
            (1.1, 0.0),
            (1.1, 1.0),
            (1.0, 1.1),
            (-1.0, 0.9),
            (-1.0, 0.0),
            (-1.0, -0.4),
            (0.9, 1.0),
            (0.0, 0.1),
        ];

        for (press_threshold, release_threshold) in cases {
            let bs = ButtonSettings::new(press_threshold, release_threshold);
            match bs {
                Ok(_) => {
                    panic!(
                        "ButtonSettings::new({press_threshold}, {release_threshold}) should be invalid"
                    );
                }
                Err(err_code) => match err_code {
                    ButtonSettingsError::PressThresholdOutOfRange(_press_threshold) => {}
                    ButtonSettingsError::ReleaseThresholdGreaterThanPressThreshold {
                        press_threshold: _press_threshold,
                        release_threshold: _release_threshold,
                    } => {}
                    ButtonSettingsError::ReleaseThresholdOutOfRange(_release_threshold) => {}
                },
            }
        }
    }

    #[test]
    fn test_try_out_of_range_axis_settings() {
        let mut axis_settings = AxisSettings::default();
        assert_eq!(
            AxisSettings::new(-0.95, -0.05, 0.05, 0.95, 0.001),
            Ok(AxisSettings {
                livezone_lowerbound: -0.95,
                deadzone_lowerbound: -0.05,
                deadzone_upperbound: 0.05,
                livezone_upperbound: 0.95,
                threshold: 0.001,
            })
        );
        assert_eq!(
            Err(AxisSettingsError::LiveZoneLowerBoundOutOfRange(-2.0)),
            axis_settings.try_set_livezone_lowerbound(-2.0)
        );
        assert_eq!(
            Err(AxisSettingsError::LiveZoneLowerBoundOutOfRange(0.1)),
            axis_settings.try_set_livezone_lowerbound(0.1)
        );
        assert_eq!(
            Err(AxisSettingsError::DeadZoneLowerBoundOutOfRange(-2.0)),
            axis_settings.try_set_deadzone_lowerbound(-2.0)
        );
        assert_eq!(
            Err(AxisSettingsError::DeadZoneLowerBoundOutOfRange(0.1)),
            axis_settings.try_set_deadzone_lowerbound(0.1)
        );

        assert_eq!(
            Err(AxisSettingsError::DeadZoneUpperBoundOutOfRange(-0.1)),
            axis_settings.try_set_deadzone_upperbound(-0.1)
        );
        assert_eq!(
            Err(AxisSettingsError::DeadZoneUpperBoundOutOfRange(1.1)),
            axis_settings.try_set_deadzone_upperbound(1.1)
        );
        assert_eq!(
            Err(AxisSettingsError::LiveZoneUpperBoundOutOfRange(-0.1)),
            axis_settings.try_set_livezone_upperbound(-0.1)
        );
        assert_eq!(
            Err(AxisSettingsError::LiveZoneUpperBoundOutOfRange(1.1)),
            axis_settings.try_set_livezone_upperbound(1.1)
        );

        axis_settings.set_livezone_lowerbound(-0.7);
        axis_settings.set_deadzone_lowerbound(-0.3);
        assert_eq!(
            Err(
                AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound {
                    livezone_lowerbound: -0.1,
                    deadzone_lowerbound: -0.3,
                }
            ),
            axis_settings.try_set_livezone_lowerbound(-0.1)
        );
        assert_eq!(
            Err(
                AxisSettingsError::LiveZoneLowerBoundGreaterThanDeadZoneLowerBound {
                    livezone_lowerbound: -0.7,
                    deadzone_lowerbound: -0.9
                }
            ),
            axis_settings.try_set_deadzone_lowerbound(-0.9)
        );

        axis_settings.set_deadzone_upperbound(0.3);
        axis_settings.set_livezone_upperbound(0.7);
        assert_eq!(
            Err(
                AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound {
                    deadzone_upperbound: 0.8,
                    livezone_upperbound: 0.7
                }
            ),
            axis_settings.try_set_deadzone_upperbound(0.8)
        );
        assert_eq!(
            Err(
                AxisSettingsError::DeadZoneUpperBoundGreaterThanLiveZoneUpperBound {
                    deadzone_upperbound: 0.3,
                    livezone_upperbound: 0.1
                }
            ),
            axis_settings.try_set_livezone_upperbound(0.1)
        );
    }

    struct TestContext {
        pub app: App,
    }

    impl TestContext {
        pub fn new() -> Self {
            let mut app = App::new();
            app.add_systems(
                PreUpdate,
                (
                    gamepad_connection_system,
                    gamepad_event_processing_system.after(gamepad_connection_system),
                ),
            )
            .add_event::<GamepadEvent>()
            .add_event::<GamepadConnectionEvent>()
            .add_event::<RawGamepadButtonChangedEvent>()
            .add_event::<GamepadButtonChangedEvent>()
            .add_event::<GamepadButtonStateChangedEvent>()
            .add_event::<GamepadAxisChangedEvent>()
            .add_event::<RawGamepadAxisChangedEvent>()
            .add_event::<RawGamepadEvent>();
            Self { app }
        }

        pub fn update(&mut self) {
            self.app.update();
        }

        pub fn send_gamepad_connection_event(&mut self, gamepad: Option<Entity>) -> Entity {
            let gamepad = gamepad.unwrap_or_else(|| self.app.world_mut().spawn_empty().id());
            self.app
                .world_mut()
                .resource_mut::<Events<GamepadConnectionEvent>>()
                .send(GamepadConnectionEvent::new(
                    gamepad,
                    Connected {
                        name: "Test gamepad".to_string(),
                        vendor_id: None,
                        product_id: None,
                    },
                ));
            gamepad
        }

        pub fn send_gamepad_disconnection_event(&mut self, gamepad: Entity) {
            self.app
                .world_mut()
                .resource_mut::<Events<GamepadConnectionEvent>>()
                .send(GamepadConnectionEvent::new(gamepad, Disconnected));
        }

        pub fn send_raw_gamepad_event(&mut self, event: RawGamepadEvent) {
            self.app
                .world_mut()
                .resource_mut::<Events<RawGamepadEvent>>()
                .send(event);
        }

        pub fn send_raw_gamepad_event_batch(
            &mut self,
            events: impl IntoIterator<Item = RawGamepadEvent>,
        ) {
            self.app
                .world_mut()
                .resource_mut::<Events<RawGamepadEvent>>()
                .send_batch(events);
        }
    }

    #[test]
    fn connection_event() {
        let mut ctx = TestContext::new();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        ctx.send_gamepad_connection_event(None);
        ctx.update();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<(&Gamepad, &GamepadSettings)>()
                .iter(ctx.app.world())
                .len(),
            1
        );
    }

    #[test]
    fn disconnection_event() {
        let mut ctx = TestContext::new();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        let entity = ctx.send_gamepad_connection_event(None);
        ctx.update();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<(&Gamepad, &GamepadSettings)>()
                .iter(ctx.app.world())
                .len(),
            1
        );
        ctx.send_gamepad_disconnection_event(entity);
        ctx.update();
        // Gamepad component should be removed
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .is_err());
        // Settings should be kept
        assert!(ctx
            .app
            .world_mut()
            .query::<&GamepadSettings>()
            .get(ctx.app.world(), entity)
            .is_ok());

        // Mistakenly sending a second disconnection event shouldn't break anything
        ctx.send_gamepad_disconnection_event(entity);
        ctx.update();
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .is_err());
        assert!(ctx
            .app
            .world_mut()
            .query::<&GamepadSettings>()
            .get(ctx.app.world(), entity)
            .is_ok());
    }

    #[test]
    fn connection_disconnection_frame_event() {
        let mut ctx = TestContext::new();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        let entity = ctx.send_gamepad_connection_event(None);
        ctx.send_gamepad_disconnection_event(entity);
        ctx.update();
        // Gamepad component should be removed
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .is_err());
        // Settings should be kept
        assert!(ctx
            .app
            .world_mut()
            .query::<&GamepadSettings>()
            .get(ctx.app.world(), entity)
            .is_ok());
    }

    #[test]
    fn reconnection_event() {
        let button_settings = ButtonSettings::new(0.7, 0.2).expect("correct parameters");
        let mut ctx = TestContext::new();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        let entity = ctx.send_gamepad_connection_event(None);
        ctx.update();
        let mut settings = ctx
            .app
            .world_mut()
            .query::<&mut GamepadSettings>()
            .get_mut(ctx.app.world_mut(), entity)
            .expect("be alive");
        assert_ne!(settings.default_button_settings, button_settings);
        settings.default_button_settings = button_settings.clone();
        ctx.send_gamepad_disconnection_event(entity);
        ctx.update();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        ctx.send_gamepad_connection_event(Some(entity));
        ctx.update();
        let settings = ctx
            .app
            .world_mut()
            .query::<&GamepadSettings>()
            .get(ctx.app.world(), entity)
            .expect("be alive");
        assert_eq!(settings.default_button_settings, button_settings);
    }

    #[test]
    fn reconnection_same_frame_event() {
        let mut ctx = TestContext::new();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        let entity = ctx.send_gamepad_connection_event(None);
        ctx.send_gamepad_disconnection_event(entity);
        ctx.update();
        assert_eq!(
            ctx.app
                .world_mut()
                .query::<&Gamepad>()
                .iter(ctx.app.world())
                .len(),
            0
        );
        assert!(ctx
            .app
            .world_mut()
            .query::<(Entity, &GamepadSettings)>()
            .get(ctx.app.world(), entity)
            .is_ok());
    }

    #[test]
    fn gamepad_axis_valid() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch([
                RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                    entity,
                    GamepadAxis::LeftStickY,
                    0.5,
                )),
                RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                    entity,
                    GamepadAxis::RightStickX,
                    0.6,
                )),
                RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                    entity,
                    GamepadAxis::RightZ,
                    -0.4,
                )),
                RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                    entity,
                    GamepadAxis::RightStickY,
                    -0.8,
                )),
            ]);
        ctx.update();
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadAxisChangedEvent>>()
                .len(),
            4
        );
    }

    #[test]
    fn gamepad_axis_threshold_filter() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let settings = GamepadSettings::default().default_axis_settings;
        // Set of events to ensure they are being properly filtered
        let base_value = 0.5;
        let events = [
            // Event above threshold
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                base_value,
            )),
            // Event below threshold, should be filtered
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                base_value + settings.threshold - 0.01,
            )),
            // Event above threshold
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                base_value + settings.threshold + 0.01,
            )),
        ];
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch(events);
        ctx.update();
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadAxisChangedEvent>>()
                .len(),
            2
        );
    }

    #[test]
    fn gamepad_axis_deadzone_filter() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let settings = GamepadSettings::default().default_axis_settings;

        // Set of events to ensure they are being properly filtered
        let events = [
            // Event below deadzone upperbound should be filtered
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.deadzone_upperbound - 0.01,
            )),
            // Event above deadzone lowerbound should be filtered
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.deadzone_lowerbound + 0.01,
            )),
        ];
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch(events);
        ctx.update();
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadAxisChangedEvent>>()
                .len(),
            0
        );
    }

    #[test]
    fn gamepad_axis_deadzone_rounded() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let settings = GamepadSettings::default().default_axis_settings;

        // Set of events to ensure they are being properly filtered
        let events = [
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                1.0,
            )),
            // Event below deadzone upperbound should be rounded to 0
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.deadzone_upperbound - 0.01,
            )),
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                1.0,
            )),
            // Event above deadzone lowerbound should be rounded to 0
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.deadzone_lowerbound + 0.01,
            )),
        ];
        let results = [1.0, 0.0, 1.0, 0.0];
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch(events);
        ctx.update();

        let events = ctx
            .app
            .world()
            .resource::<Events<GamepadAxisChangedEvent>>();
        let mut event_reader = events.get_cursor();
        for (event, result) in event_reader.read(events).zip(results) {
            assert_eq!(event.value, result);
        }
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadAxisChangedEvent>>()
                .len(),
            4
        );
    }

    #[test]
    fn gamepad_axis_livezone_filter() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let settings = GamepadSettings::default().default_axis_settings;

        // Set of events to ensure they are being properly filtered
        let events = [
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                1.0,
            )),
            // Event above livezone upperbound should be filtered
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.livezone_upperbound + 0.01,
            )),
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                -1.0,
            )),
            // Event below livezone lowerbound should be filtered
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.livezone_lowerbound - 0.01,
            )),
        ];
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch(events);
        ctx.update();
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadAxisChangedEvent>>()
                .len(),
            2
        );
    }

    #[test]
    fn gamepad_axis_livezone_rounded() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let settings = GamepadSettings::default().default_axis_settings;

        // Set of events to ensure they are being properly filtered
        let events = [
            // Event above livezone upperbound should be rounded to 1
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.livezone_upperbound + 0.01,
            )),
            // Event below livezone lowerbound should be rounded to -1
            RawGamepadEvent::Axis(RawGamepadAxisChangedEvent::new(
                entity,
                GamepadAxis::LeftStickX,
                settings.livezone_lowerbound - 0.01,
            )),
        ];
        let results = [1.0, -1.0];
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch(events);
        ctx.update();

        let events = ctx
            .app
            .world()
            .resource::<Events<GamepadAxisChangedEvent>>();
        let mut event_reader = events.get_cursor();
        for (event, result) in event_reader.read(events).zip(results) {
            assert_eq!(event.value, result);
        }
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadAxisChangedEvent>>()
                .len(),
            2
        );
    }

    #[test]
    fn gamepad_buttons_pressed() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let digital_settings = GamepadSettings::default().default_button_settings;

        let events = [RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
            entity,
            GamepadButton::DPadDown,
            digital_settings.press_threshold,
        ))];
        ctx.app
            .world_mut()
            .resource_mut::<Events<RawGamepadEvent>>()
            .send_batch(events);
        ctx.update();

        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadButtonStateChangedEvent>>()
                .len(),
            1
        );
        let events = ctx
            .app
            .world()
            .resource::<Events<GamepadButtonStateChangedEvent>>();
        let mut event_reader = events.get_cursor();
        for event in event_reader.read(events) {
            assert_eq!(event.button, GamepadButton::DPadDown);
            assert_eq!(event.state, ButtonState::Pressed);
        }
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .pressed(GamepadButton::DPadDown));

        ctx.app
            .world_mut()
            .resource_mut::<Events<GamepadButtonStateChangedEvent>>()
            .clear();
        ctx.update();

        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadButtonStateChangedEvent>>()
                .len(),
            0
        );
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .pressed(GamepadButton::DPadDown));
    }

    #[test]
    fn gamepad_buttons_just_pressed() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let digital_settings = GamepadSettings::default().default_button_settings;

        ctx.send_raw_gamepad_event(RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
            entity,
            GamepadButton::DPadDown,
            digital_settings.press_threshold,
        )));
        ctx.update();

        // Check it is flagged for this frame
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .just_pressed(GamepadButton::DPadDown));
        ctx.update();

        //Check it clears next frame
        assert!(!ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .just_pressed(GamepadButton::DPadDown));
    }
    #[test]
    fn gamepad_buttons_released() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let digital_settings = GamepadSettings::default().default_button_settings;

        ctx.send_raw_gamepad_event(RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
            entity,
            GamepadButton::DPadDown,
            digital_settings.press_threshold,
        )));
        ctx.update();

        ctx.app
            .world_mut()
            .resource_mut::<Events<GamepadButtonStateChangedEvent>>()
            .clear();
        ctx.send_raw_gamepad_event(RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
            entity,
            GamepadButton::DPadDown,
            digital_settings.release_threshold - 0.01,
        )));
        ctx.update();
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadButtonStateChangedEvent>>()
                .len(),
            1
        );
        let events = ctx
            .app
            .world()
            .resource::<Events<GamepadButtonStateChangedEvent>>();
        let mut event_reader = events.get_cursor();
        for event in event_reader.read(events) {
            assert_eq!(event.button, GamepadButton::DPadDown);
            assert_eq!(event.state, ButtonState::Released);
        }
        assert!(!ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .pressed(GamepadButton::DPadDown));
        ctx.app
            .world_mut()
            .resource_mut::<Events<GamepadButtonStateChangedEvent>>()
            .clear();
        ctx.update();

        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadButtonStateChangedEvent>>()
                .len(),
            0
        );
    }

    #[test]
    fn gamepad_buttons_just_released() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let digital_settings = GamepadSettings::default().default_button_settings;

        ctx.send_raw_gamepad_event_batch([
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.press_threshold,
            )),
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.release_threshold - 0.01,
            )),
        ]);
        ctx.update();

        // Check it is flagged for this frame
        assert!(ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .just_released(GamepadButton::DPadDown));
        ctx.update();

        //Check it clears next frame
        assert!(!ctx
            .app
            .world_mut()
            .query::<&Gamepad>()
            .get(ctx.app.world(), entity)
            .unwrap()
            .just_released(GamepadButton::DPadDown));
    }

    #[test]
    fn gamepad_buttons_axis() {
        let mut ctx = TestContext::new();

        // Create test gamepad
        let entity = ctx.send_gamepad_connection_event(None);
        let digital_settings = GamepadSettings::default().default_button_settings;
        let analog_settings = GamepadSettings::default().default_button_axis_settings;

        // Test events
        let events = [
            // Should trigger event
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.press_threshold,
            )),
            // Should trigger event
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.release_threshold,
            )),
            // Shouldn't trigger a state changed event
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.release_threshold - analog_settings.threshold * 1.01,
            )),
            // Shouldn't trigger any event
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.release_threshold - (analog_settings.threshold * 1.5),
            )),
            // Shouldn't trigger a state changed event
            RawGamepadEvent::Button(RawGamepadButtonChangedEvent::new(
                entity,
                GamepadButton::DPadDown,
                digital_settings.release_threshold - (analog_settings.threshold * 2.02),
            )),
        ];
        ctx.send_raw_gamepad_event_batch(events);
        ctx.update();
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadButtonStateChangedEvent>>()
                .len(),
            2
        );
        assert_eq!(
            ctx.app
                .world()
                .resource::<Events<GamepadButtonChangedEvent>>()
                .len(),
            4
        );
    }
}