GamepadEvent.h

Go to the documentation of this file.

///
/// Copyright (C) 2026 Ultralight, Inc. All rights reserved.
/// A license is required for commercial use. https://ultralig.ht
///
#pragma once
#include <Ultralight/Defines.h>
#include <Ultralight/String.h>
 
namespace ultralight {
 
///
/// Event representing a change in gamepad connection state.
///
/// @see  Renderer::FireGamepadEvent
///
class UExport GamepadEvent {
 public:
  ///
  /// The various GamepadEvent types.
  ///
  enum Type {
    ///
    /// This event type should be fired when a gamepad is connected.
    ///
    /// @note  You will need to previously declare the gamepad, its index, and details about
    ///        its axis and button layout via Renderer::SetGamepadDetails prior to calling
    ///        Renderer::FireGamepadEvent.
    /// 
    kType_GamepadConnected,
    
    ///
    /// This event type should be fired when a gamepad is disconnected.
    ///
    kType_GamepadDisconnected,
  };
 
  ///
  /// The type of this GamepadEvent
  ///
  Type type;
 
  ///
  /// The index of the gamepad, this should match the value previously set in
  /// Renderer::SetGamepadDetails.
  ///
  uint32_t index;
};
 
///
/// Event representing a change in gamepad axis state (eg, pressing a stick in a certain direction).
///
/// @see  Renderer::FireGamepadAxisEvent
///
class UExport GamepadAxisEvent {
 public:
  ///
  /// The index of the gamepad, this should match the value previously set in
  /// Renderer::SetGamepadDetails.
  ///
  uint32_t index;
 
  ///
  /// The index of the axis whose value has changed.
  ///
  /// This value should be in the range previously set in Renderer::SetGamepadDetails.
  ///
  uint32_t axis_index;
 
  ///
  /// The new value of the axis.
  ///
  /// This value should be normalized to the range [-1.0, 1.0].
  ///
  double value;
};
 
///
/// Event representing a change in gamepad button state (eg, pressing a button on a gamepad).
///
/// @see    Renderer::FireGamepadButtonEvent
///
class UExport GamepadButtonEvent {
 public:
  ///
  /// The index of the gamepad, this should match the value previously set in
  /// Renderer::SetGamepadDetails.
  ///
  uint32_t index;
 
  ///
  /// The index of the button whose value has changed.
  ///
  /// This value should be in the range previously set in Renderer::SetGamepadDetails.
  ///
  uint32_t button_index;
 
  ///
  /// The new value of the button.
  ///
  /// This value should be normalized to the range [0.0, 1.0] (0.0 = not pressed,
  /// 1.0 = fully pressed). Any value greater than 0.0 is considered "pressed".
  ///
  double value;
};
 
}  // namespace ultralight