include/rive/input/standard_gamepad.hpp

#ifndef _RIVE_STANDARD_GAMEPAD_HPP_
#define _RIVE_STANDARD_GAMEPAD_HPP_

#include <cstddef>
#include <cstdint>
#include <vector>

namespace rive
{

/// Logical face / control positions for the W3C Standard Gamepad layout.
/// Indices match https://w3c.github.io/gamepad/#remapping button indices.
enum class StandardGamepadButton : uint8_t
{
  south = 0x00,
  east = 0x01,
  west = 0x02,
  north = 0x03,
  leftShoulder = 0x04,
  rightShoulder = 0x05,
  leftTrigger = 0x06,
  rightTrigger = 0x07,
  back = 0x08,
  forward = 0x09,
  leftStick = 0x0a,
  rightStick = 0x0b,
  dpadUp = 0x0c,
  dpadDown = 0x0d,
  dpadLeft = 0x0e,
  dpadRight = 0x0f,
  start = 0x10,
};

/// Standard axis slots for the W3C layout (indices into `GamepadSnapshot::axes`
/// when that vector is standard-mapped; missing indices read as 0). Analog
/// button pressure uses `GamepadSnapshot::buttonValues` at the same indices as
/// `StandardGamepadButton`.
enum class StandardGamepadAxis : uint8_t
{
  leftX = 0,
  leftY = 1,
  rightX = 2,
  rightY = 3,
  leftTrigger = 4,
  rightTrigger = 5,
};

inline float standardGamepadAxisValue(
    const std::vector<float>& axes,
    StandardGamepadAxis axis)
{
  const size_t i = static_cast<size_t>(axis);
  return i < axes.size() ? axes[i] : 0.f;
}

inline size_t standardGamepadButtonIndex(StandardGamepadButton b)
{
  return static_cast<size_t>(b);
}

inline bool standardGamepadButtonPressed(
    uint64_t buttonMask,
    StandardGamepadButton button)
{
  const uint64_t bit = uint64_t(1) << standardGamepadButtonIndex(button);
  return (buttonMask & bit) != 0;
}

} // namespace rive

#endif