feat(input): add deadzone to axis

CHANGELOG.md

@@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Handle body rotation on physics integration (#1242, **&fallenatlas**).
 - Binary Serializer and Deserializer (#1306, **@RiscadoA**).
 - Type Client and Type Server (#1302, **@RiscadoA**).
+- Deadzone for input axis (#844, **@kuukitenshi**)
 
 ### Fixed
 

engine/include/cubos/engine/input/axis.hpp

@@ -35,10 +35,11 @@ namespace cubos::engine
         /// @param negative Negative input combinations.
         /// @param gamepadAxes Gamepad axis bindings.
         InputAxis(std::vector<InputCombination> positive, std::vector<InputCombination> negative,
-                  std::vector<core::io::GamepadAxis> gamepadAxes)
+                  std::vector<core::io::GamepadAxis> gamepadAxes, float deadzone = 0.0F)
             : mPositive(std::move(positive))
             , mNegative(std::move(negative))
             , mGamepadAxes(std::move(gamepadAxes))
+            , mDeadzone(deadzone)
         {
         }
 
@@ -74,11 +75,20 @@ namespace cubos::engine
         /// @param value New value.
         void value(float value);
 
+        /// @brief Gets the deadzone.
+        /// @return Deadzone.
+        float deadzone() const;
+
+        /// @brief Sets the deadzone.
+        /// @param deadzone New deadzone.
+        void deadzone(float deadzone);
+
     private:
         std::vector<InputCombination> mPositive;
         std::vector<InputCombination> mNegative;
         std::vector<core::io::GamepadAxis> mGamepadAxes;
 
         float mValue{0.0F}; ///< Not serialized.
+        float mDeadzone{0.0F};
     };
 } // namespace cubos::engine

engine/src/input/axis.cpp

@@ -1,3 +1,4 @@
+#include <algorithm>
 #include <cmath>
 
 #include <cubos/core/io/keyboard.hpp>
@@ -20,7 +21,8 @@ CUBOS_REFLECT_IMPL(cubos::engine::InputAxis)
         .with(FieldsTrait{}
                   .withField("positive", &InputAxis::mPositive)
                   .withField("negative", &InputAxis::mNegative)
-                  .withField("gamepadAxes", &InputAxis::mGamepadAxes));
+                  .withField("gamepadAxes", &InputAxis::mGamepadAxes)
+                  .withField("deadzone", &InputAxis::mDeadzone));
 }
 
 const std::vector<InputCombination>& InputAxis::positive() const
@@ -60,11 +62,25 @@ float InputAxis::value() const
 
 void InputAxis::value(float value)
 {
-    mValue = value;
+    mValue = std::abs(value) < mDeadzone ? 0.0F : value;
 
     if (std::abs(mValue) > 1.0F)
     {
         CUBOS_WARN("Axis value out of range: {}", mValue);
-        mValue = mValue > 1.0F ? 1.0F : -1.0F;
+        mValue = std::clamp(mValue, -1.0F, 1.0F);
     }
 }
+
+float InputAxis::deadzone() const
+{
+    return mDeadzone;
+}
+
+void InputAxis::deadzone(float deadzone)
+{
+    if (deadzone < 0.0F || deadzone > 1.0F)
+    {
+        CUBOS_WARN("Invalid deadzone value: {}. Value must be between 0.0 and 1.0.", deadzone);
+    }
+    mDeadzone = std::clamp(deadzone, 0.0F, 1.0F);
+}