use crate::{Axis, Input}; use bevy_ecs::event::{EventReader, EventWriter}; use bevy_ecs::system::{Res, ResMut}; use bevy_utils::{tracing::info, HashMap, HashSet}; /// A gamepad with an associated `ID`. /// /// ## Usage /// /// The primary way to access the individual connected gamepads is done through the [`Gamepads`] /// `bevy` resource. It is also used inside of [`GamepadEvent`]s and [`GamepadEventRaw`]s to distinguish /// which gamepad an event corresponds to. /// /// ## Note /// /// The `ID` of a gamepad is fixed until the gamepad disconnects or the app is restarted. #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub struct Gamepad { /// The `ID` of the gamepad. pub id: usize, } impl Gamepad { /// Creates a new [`Gamepad`]. pub fn new(id: usize) -> Self { Self { id } } } /// A collection of connected [`Gamepad`]s. /// /// ## Usage /// /// It is stored in a `bevy` resource which tracks all of the currently connected [`Gamepad`]s. /// /// ## Updating /// /// The [`Gamepad`]s are registered and deregistered in the [`gamepad_connection_system`] /// whenever a [`GamepadEventType::Connected`] or [`GamepadEventType::Disconnected`] /// event is received. #[derive(Default, Debug)] pub struct Gamepads { /// The collection of the connected [`Gamepad`]s. gamepads: HashSet, } impl Gamepads { /// Returns `true` if the `gamepad` is connected. pub fn contains(&self, gamepad: &Gamepad) -> bool { self.gamepads.contains(gamepad) } /// An iterator visiting all connected [`Gamepad`]s in arbitrary order. pub fn iter(&self) -> impl Iterator + '_ { self.gamepads.iter() } /// Registers the `gamepad` marking it as connected. fn register(&mut self, gamepad: Gamepad) { self.gamepads.insert(gamepad); } /// Deregisters the `gamepad` marking it as disconnected. fn deregister(&mut self, gamepad: &Gamepad) { self.gamepads.remove(gamepad); } } /// The data contained in a [`GamepadEvent`] or [`GamepadEventRaw`]. #[derive(Debug, Clone, PartialEq)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub enum GamepadEventType { /// A [`Gamepad`] has been connected. Connected, /// A [`Gamepad`] has been disconnected. Disconnected, /// The value of a [`Gamepad`] button has changed. ButtonChanged(GamepadButtonType, f32), /// The value of a [`Gamepad`] axis has changed. AxisChanged(GamepadAxisType, f32), } /// An event of a [`Gamepad`]. /// /// This event is the translated version of the [`GamepadEventRaw`]. It is available to /// the end user and can be used for game logic. /// /// ## Differences /// /// The difference between the [`GamepadEventRaw`] and the [`GamepadEvent`] is that the /// former respects user defined [`GamepadSettings`] for the gamepad inputs when translating it /// to the latter. The former also updates the [`Input`], [`Axis`], /// and [`Axis`] resources accordingly. /// /// ## Gamepad input mocking /// /// When mocking gamepad input, use [`GamepadEventRaw`]s instead of [`GamepadEvent`]s. /// Otherwise [`GamepadSettings`] won't be respected and the [`Input`], /// [`Axis`], and [`Axis`] resources won't be updated correctly. /// /// An example for gamepad input mocking can be seen in the documentation of the [`GamepadEventRaw`]. #[derive(Debug, Clone, PartialEq)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub struct GamepadEvent { /// The gamepad this event corresponds to. pub gamepad: Gamepad, /// The type of the event. pub event_type: GamepadEventType, } impl GamepadEvent { /// Creates a new [`GamepadEvent`]. pub fn new(gamepad: Gamepad, event_type: GamepadEventType) -> Self { Self { gamepad, event_type, } } } /// A raw event of a [`Gamepad`]. /// /// This event is the translated version of the `EventType` from the `GilRs` crate. /// It is available to the end user and can be used for game logic. /// /// ## Differences /// /// The difference between the `EventType` from the `GilRs` crate and the [`GamepadEventRaw`] /// is that the latter has less events, because the button pressing logic is handled through the generic /// [`Input`] instead of through events. /// /// The difference between the [`GamepadEventRaw`] and the [`GamepadEvent`] can be seen in the documentation /// of the [`GamepadEvent`]. /// /// ## Gamepad input mocking /// /// The following example showcases how to mock gamepad input by manually sending [`GamepadEventRaw`]s. /// /// ``` /// # use bevy_input::prelude::*; /// # use bevy_input::InputPlugin; /// # use bevy_input::gamepad::GamepadEventRaw; /// # use bevy_app::prelude::*; /// # use bevy_ecs::prelude::*; /// # /// // This system sets the `bool` resource to `true` if the `South` button /// // of the first gamepad is pressed. /// fn change_resource_on_gamepad_button_press( /// mut my_resource: ResMut, /// gamepads: Res, /// button_inputs: ResMut>, /// ) { /// let gamepad = gamepads.iter().next().unwrap(); /// let gamepad_button= GamepadButton::new(*gamepad, GamepadButtonType::South); /// /// *my_resource = button_inputs.pressed(gamepad_button); /// } /// /// // Create our app. /// let mut app = App::new(); /// /// // Add the input plugin and the system/resource we want to test. /// app.add_plugin(InputPlugin) /// .insert_resource(false) /// .add_system(change_resource_on_gamepad_button_press); /// /// // Define our dummy gamepad input data. /// let gamepad = Gamepad::new(0); /// let button_type = GamepadButtonType::South; /// /// // Send the gamepad connected event to mark our gamepad as connected. /// // This updates the `Gamepads` resource accordingly. /// app.world.send_event(GamepadEventRaw::new(gamepad, GamepadEventType::Connected)); /// /// // Send the gamepad input event to mark the `South` gamepad button as pressed. /// // This updates the `Input` resource accordingly. /// app.world.send_event(GamepadEventRaw::new( /// gamepad, /// GamepadEventType::ButtonChanged(button_type, 1.0) /// )); /// /// // Advance the execution of the schedule by a single cycle. /// app.update(); /// /// // At this point you can check if your game logic corresponded correctly to the gamepad input. /// // In this example we are checking if the `bool` resource was updated from `false` to `true`. /// assert!(app.world.resource::()); /// /// // Send the gamepad input event to mark the `South` gamepad button as released. /// // This updates the `Input` resource accordingly. /// app.world.send_event(GamepadEventRaw::new( /// gamepad, /// GamepadEventType::ButtonChanged(button_type, 0.0) /// )); /// /// // Advance the execution of the schedule by another cycle. /// app.update(); /// /// // Check if the `bool` resource was updated from `true` to `false`. /// assert!(!app.world.resource::()); /// # /// # bevy_ecs::system::assert_is_system(change_resource_on_gamepad_button_press); /// ``` #[derive(Debug, Clone, PartialEq)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub struct GamepadEventRaw { /// The gamepad this event corresponds to. pub gamepad: Gamepad, /// The type of the event. pub event_type: GamepadEventType, } impl GamepadEventRaw { /// Creates a new [`GamepadEventRaw`]. pub fn new(gamepad: Gamepad, event_type: GamepadEventType) -> Self { Self { gamepad, event_type, } } } /// A type of a [`GamepadButton`]. /// /// ## Usage /// /// This is used to determine which button has changed its value when receiving a /// [`GamepadEventType::ButtonChanged`]. It is also used in the [`GamepadButton`] /// which in turn is used to create the [`Input`] or /// [`Axis`] `bevy` resources. #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub enum GamepadButtonType { /// 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, } /// A button of a [`Gamepad`]. /// /// ## Usage /// /// It is used as the generic `T` value of an [`Input`] and [`Axis`] to create `bevy` resources. These /// resources store the data of the buttons and axes of a gamepad and can be accessed inside of a system. /// /// ## Updating /// /// The resources are updated inside of the [`gamepad_event_system`]. #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub struct GamepadButton { /// The gamepad on which the button is located on. pub gamepad: Gamepad, /// The type of the button. pub button_type: GamepadButtonType, } impl GamepadButton { /// Creates a new [`GamepadButton`]. /// /// # Examples /// /// ``` /// # use bevy_input::gamepad::{GamepadButton, GamepadButtonType, Gamepad}; /// # /// let gamepad_button = GamepadButton::new( /// Gamepad::new(1), /// GamepadButtonType::South, /// ); /// ``` pub fn new(gamepad: Gamepad, button_type: GamepadButtonType) -> Self { Self { gamepad, button_type, } } } /// A type of a [`GamepadAxis`]. /// /// ## Usage /// /// This is used to determine which axis has changed its value when receiving a /// [`GamepadEventType::AxisChanged`]. It is also used in the [`GamepadAxis`] /// which in turn is used to create the [`Axis`] `bevy` resource. #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub enum GamepadAxisType { /// 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, } /// An axis of a [`Gamepad`]. /// /// ## Usage /// /// It is used as the generic `T` value of an [`Axis`] to create a `bevy` resource. This resource /// stores the data of the axes of a gamepad and can be accessed inside of a system. /// /// ## Updating /// /// The resource is updated inside of the [`gamepad_event_system`]. #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)] #[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))] pub struct GamepadAxis { /// The gamepad on which the axis is located on. pub gamepad: Gamepad, /// The type of the axis. pub axis_type: GamepadAxisType, } impl GamepadAxis { /// Creates a new [`GamepadAxis`]. /// /// # Examples /// /// ``` /// # use bevy_input::gamepad::{GamepadAxis, GamepadAxisType, Gamepad}; /// # /// let gamepad_axis = GamepadAxis::new( /// Gamepad::new(1), /// GamepadAxisType::LeftStickX, /// ); /// ``` pub fn new(gamepad: Gamepad, axis_type: GamepadAxisType) -> Self { Self { gamepad, axis_type } } } /// Settings for all [`Gamepad`]s. /// /// ## Usage /// /// It is used to create a `bevy` resource that stores the settings of every [`GamepadButton`] and /// [`GamepadAxis`]. 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 inside of the [`gamepad_event_system`], but are never written to /// inside of `bevy`. To modify these settings, mutate the corresponding resource. #[derive(Default, Debug)] 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, /// The user defined axis settings. pub axis_settings: HashMap, /// The user defined button axis settings. pub button_axis_settings: HashMap, } impl GamepadSettings { /// Returns the [`ButtonSettings`] of the `button`. /// /// If no user defined [`ButtonSettings`] are specified the default [`ButtonSettings`] get returned. /// /// # Examples /// /// ``` /// # use bevy_input::gamepad::{GamepadSettings, GamepadButton, Gamepad, GamepadButtonType}; /// # /// # let settings = GamepadSettings::default(); /// let button = GamepadButton::new(Gamepad::new(1), GamepadButtonType::South); /// let button_settings = settings.get_button_settings(button); /// ``` 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 `axis`. /// /// If no user defined [`AxisSettings`] are specified the default [`AxisSettings`] get returned. /// /// # Examples /// /// ``` /// # use bevy_input::gamepad::{GamepadSettings, GamepadAxis, Gamepad, GamepadAxisType}; /// # /// # let settings = GamepadSettings::default(); /// let axis = GamepadAxis::new(Gamepad::new(1), GamepadAxisType::LeftStickX); /// let axis_settings = settings.get_axis_settings(axis); /// ``` 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 `button`. /// /// If no user defined [`ButtonAxisSettings`] are specified the default [`ButtonAxisSettings`] get returned. /// /// # Examples /// /// ``` /// # use bevy_input::gamepad::{GamepadSettings, GamepadButton, Gamepad, GamepadButtonType}; /// # /// # let settings = GamepadSettings::default(); /// let button = GamepadButton::new(Gamepad::new(1), GamepadButtonType::South); /// let button_axis_settings = settings.get_button_axis_settings(button); /// ``` pub fn get_button_axis_settings(&self, button: GamepadButton) -> &ButtonAxisSettings { self.button_axis_settings .get(&button) .unwrap_or(&self.default_button_axis_settings) } } /// Settings for a [`GamepadButton`]. /// /// ## Usage /// /// It is used inside of the [`GamepadSettings`] to define the threshold for a gamepad button /// to be considered pressed or released. A button is considered pressed if the `press` /// value is surpassed and released if the `release` value is undercut. /// /// ## Updating /// /// The current value of a button is received through the [`GamepadEvent`]s or [`GamepadEventRaw`]s. #[derive(Debug, Clone)] pub struct ButtonSettings { /// The threshold for the button to be considered as pressed. pub press: f32, /// The threshold for the button to be considered as released. pub release: f32, } impl Default for ButtonSettings { fn default() -> Self { ButtonSettings { press: 0.75, release: 0.65, } } } impl ButtonSettings { /// 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. fn is_pressed(&self, value: f32) -> bool { value >= self.press } /// 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. fn is_released(&self, value: f32) -> bool { value <= self.release } } /// Settings for a [`GamepadAxis`]. /// /// It is used inside of the [`GamepadSettings`] to define the sensitivity range and /// threshold for an axis. /// /// ## Logic /// /// - Values that are in-between `negative_low` and `positive_low` will be rounded to 0.0. /// - Values that are higher than or equal to `positive_high` will be rounded to 1.0. /// - Values that are lower than or equal to `negative_high` will be rounded to -1.0. /// - Otherwise, values will not be rounded. /// /// The valid range is from -1.0 to 1.0, inclusive. /// /// ## Updating /// /// The current value of an axis is received through the [`GamepadEvent`]s or [`GamepadEventRaw`]s. #[derive(Debug, Clone)] pub struct AxisSettings { /// The positive high value at which to apply rounding. pub positive_high: f32, /// The positive low value at which to apply rounding. pub positive_low: f32, /// The negative high value at which to apply rounding. pub negative_high: f32, /// The negative low value at which to apply rounding. pub negative_low: f32, /// The threshold defining the minimum difference between the old and new values to apply the changes. pub threshold: f32, } impl Default for AxisSettings { fn default() -> Self { AxisSettings { positive_high: 0.95, positive_low: 0.05, negative_high: -0.95, negative_low: -0.05, threshold: 0.01, } } } impl AxisSettings { /// Filters the `new_value` according to the specified settings. /// /// If the `new_value` is: /// - in-between `negative_low` and `positive_low` it will be rounded to 0.0. /// - higher than or equal to `positive_high` it will be rounded to 1.0. /// - lower than or equal to `negative_high` it will be rounded to -1.0. /// - Otherwise it will not be rounded. /// /// If the difference between the calculated value and the `old_value` is lower or /// equal to the `threshold`, [`None`] will be returned. fn filter(&self, new_value: f32, old_value: Option) -> Option { let new_value = if new_value <= self.positive_low && new_value >= self.negative_low { 0.0 } else if new_value >= self.positive_high { 1.0 } else if new_value <= self.negative_high { -1.0 } else { new_value }; if let Some(old_value) = old_value { if (new_value - old_value).abs() <= self.threshold { return None; } } Some(new_value) } } /// Settings for a [`GamepadButton`]. /// /// It is used inside of 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. /// /// ## Updating /// /// The current value of a button is received through the [`GamepadEvent`]s or [`GamepadEventRaw`]s. #[derive(Debug, Clone)] 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 { /// Filters the `new_value` according to the specified settings. /// /// If the `new_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. /// /// If the difference between the calculated value and the `old_value` is lower or /// equal to the `threshold`, [`None`] will be returned. fn filter(&self, new_value: f32, old_value: Option) -> Option { let new_value = if new_value <= self.low { 0.0 } else if new_value >= self.high { 1.0 } else { new_value }; if let Some(old_value) = old_value { if (new_value - old_value).abs() <= self.threshold { return None; } } Some(new_value) } } /// Monitors gamepad connection and disconnection events and updates the [`Gamepads`] resource accordingly. /// /// ## Note /// /// Whenever a [`Gamepad`] connects or disconnects, an information gets printed to the console using the [`info!`] macro. pub fn gamepad_connection_system( mut gamepads: ResMut, mut gamepad_event: EventReader, ) { for event in gamepad_event.iter() { match event.event_type { GamepadEventType::Connected => { gamepads.register(event.gamepad); info!("{:?} Connected", event.gamepad); } GamepadEventType::Disconnected => { gamepads.deregister(&event.gamepad); info!("{:?} Disconnected", event.gamepad); } _ => (), } } } /// Modifies the gamepad resources and sends out gamepad events. /// /// The resources [`Input`], [`Axis`], and [`Axis`] are updated /// and the [`GamepadEvent`]s are sent according to the received [`GamepadEventRaw`]s respecting the [`GamepadSettings`]. /// /// ## Differences /// /// The main difference between the events and the resources is that the latter allows you to check specific /// buttons or axes, rather than reading the events one at a time. This is done through convenient functions /// like [`Input::pressed`], [`Input::just_pressed`], [`Input::just_released`], and [`Axis::get`]. pub fn gamepad_event_system( mut button_input: ResMut>, mut axis: ResMut>, mut button_axis: ResMut>, mut raw_events: EventReader, mut events: EventWriter, settings: Res, ) { button_input.clear(); for event in raw_events.iter() { match event.event_type { GamepadEventType::Connected => { events.send(GamepadEvent::new(event.gamepad, event.event_type.clone())); for button_type in &ALL_BUTTON_TYPES { let gamepad_button = GamepadButton::new(event.gamepad, *button_type); button_input.reset(gamepad_button); button_axis.set(gamepad_button, 0.0); } for axis_type in &ALL_AXIS_TYPES { axis.set(GamepadAxis::new(event.gamepad, *axis_type), 0.0); } } GamepadEventType::Disconnected => { events.send(GamepadEvent::new(event.gamepad, event.event_type.clone())); for button_type in &ALL_BUTTON_TYPES { let gamepad_button = GamepadButton::new(event.gamepad, *button_type); button_input.reset(gamepad_button); button_axis.remove(gamepad_button); } for axis_type in &ALL_AXIS_TYPES { axis.remove(GamepadAxis::new(event.gamepad, *axis_type)); } } GamepadEventType::AxisChanged(axis_type, value) => { let gamepad_axis = GamepadAxis::new(event.gamepad, axis_type); if let Some(filtered_value) = settings .get_axis_settings(gamepad_axis) .filter(value, axis.get(gamepad_axis)) { axis.set(gamepad_axis, filtered_value); events.send(GamepadEvent::new( event.gamepad, GamepadEventType::AxisChanged(axis_type, filtered_value), )); } } GamepadEventType::ButtonChanged(button_type, value) => { let gamepad_button = GamepadButton::new(event.gamepad, button_type); if let Some(filtered_value) = settings .get_button_axis_settings(gamepad_button) .filter(value, button_axis.get(gamepad_button)) { button_axis.set(gamepad_button, filtered_value); events.send(GamepadEvent::new( event.gamepad, GamepadEventType::ButtonChanged(button_type, filtered_value), )); } let button_property = settings.get_button_settings(gamepad_button); if button_input.pressed(gamepad_button) { if button_property.is_released(value) { button_input.release(gamepad_button); } } else if button_property.is_pressed(value) { button_input.press(gamepad_button); } } } } } /// An array of every [`GamepadButtonType`] variant. const ALL_BUTTON_TYPES: [GamepadButtonType; 19] = [ GamepadButtonType::South, GamepadButtonType::East, GamepadButtonType::North, GamepadButtonType::West, GamepadButtonType::C, GamepadButtonType::Z, GamepadButtonType::LeftTrigger, GamepadButtonType::LeftTrigger2, GamepadButtonType::RightTrigger, GamepadButtonType::RightTrigger2, GamepadButtonType::Select, GamepadButtonType::Start, GamepadButtonType::Mode, GamepadButtonType::LeftThumb, GamepadButtonType::RightThumb, GamepadButtonType::DPadUp, GamepadButtonType::DPadDown, GamepadButtonType::DPadLeft, GamepadButtonType::DPadRight, ]; /// An array of every [`GamepadAxisType`] variant. const ALL_AXIS_TYPES: [GamepadAxisType; 6] = [ GamepadAxisType::LeftStickX, GamepadAxisType::LeftStickY, GamepadAxisType::LeftZ, GamepadAxisType::RightStickX, GamepadAxisType::RightStickY, GamepadAxisType::RightZ, ]; #[cfg(test)] mod tests { use super::{AxisSettings, ButtonAxisSettings, ButtonSettings}; fn test_button_axis_settings_filter( settings: ButtonAxisSettings, new_value: f32, old_value: Option, expected: Option, ) { let actual = settings.filter(new_value, old_value); assert_eq!( expected, actual, "Testing filtering for {:?} with new_value = {:?}, old_value = {:?}", settings, new_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, expected: Option, ) { let actual = settings.filter(new_value, old_value); assert_eq!( expected, actual, "Testing filtering for {:?} with new_value = {:?}, old_value = {:?}", settings, new_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::default(); 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::default(); 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 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 is released for value: {}", value); } } }