InputManager.h

#pragma once
 
#include <Core/Input/InputDevice.h>
#include <Foundation/Communication/Event.h>
#include <Foundation/Containers/DynamicArray.h>
#include <Foundation/Containers/Map.h>
 
struct PL_CORE_DLL plInputActionConfig
{
  enum
  {
    MaxInputSlotAlternatives = 3
  };
 
  plInputActionConfig();
 
  bool m_bApplyTimeScaling;
 
  plString m_sInputSlotTrigger[MaxInputSlotAlternatives];
 
  float m_fInputSlotScale[MaxInputSlotAlternatives];
 
  plString m_sFilterByInputSlotX[MaxInputSlotAlternatives];
 
  plString m_sFilterByInputSlotY[MaxInputSlotAlternatives];
 
  float m_fFilterXMinValue; 
  float m_fFilterXMaxValue; 
  float m_fFilterYMinValue; 
  float m_fFilterYMaxValue; 
 
  float m_fFilteredPriority; 
 
  enum OnLeaveArea
  {
    LoseFocus, 
    KeepFocus, 
  };
 
  enum OnEnterArea
  {
    ActivateImmediately, 
    RequireKeyUp,        
  };
 
  OnLeaveArea m_OnLeaveArea; 
  OnEnterArea m_OnEnterArea; 
};
 
class PL_CORE_DLL plInputManager
{
public:
  static void Update(plTime timeDifference); // [tested]
 
  static void SetInputSlotDisplayName(plStringView sInputSlot, plStringView sDefaultDisplayName); // [tested]
 
  static plStringView GetInputSlotDisplayName(plStringView sInputSlot); // [tested]
 
  static plStringView GetInputSlotDisplayName(plStringView sInputSet, plStringView sAction, plInt32 iTrigger = -1);
 
  static void SetInputSlotDeadZone(plStringView sInputSlot, float fDeadZone); // [tested]
 
  static float GetInputSlotDeadZone(plStringView sInputSlot); // [tested]
 
  static plBitflags<plInputSlotFlags> GetInputSlotFlags(plStringView sInputSlot); // [tested]
 
  static plKeyState::Enum GetInputSlotState(plStringView sInputSlot, float* pValue = nullptr); // [tested]
 
  static void RetrieveAllKnownInputSlots(plDynamicArray<plStringView>& out_inputSlots);
 
  static plUInt32 RetrieveLastCharacter(bool bResetCurrent = true); // [tested]
 
  static void PollHardware();
 
  static void ClearInputMapping(plStringView sInputSet, plStringView sInputSlot); // [tested]
 
  static void SetInputActionConfig(plStringView sInputSet, plStringView sAction, const plInputActionConfig& config, bool bClearPreviousInputMappings); // [tested]
 
  static plInputActionConfig GetInputActionConfig(plStringView sInputSet, plStringView sAction); // [tested]
 
  static void RemoveInputAction(plStringView sInputSet, plStringView sAction); // [tested]
 
  static plKeyState::Enum GetInputActionState(plStringView sInputSet, plStringView sAction, float* pValue = nullptr, plInt8* pTriggeredSlot = nullptr); // [tested]
 
  static void SetActionDisplayName(plStringView sAction, plStringView sDisplayName); // [tested]
 
  static const plString GetActionDisplayName(plStringView sAction); // [tested]
 
  static void GetAllInputSets(plDynamicArray<plString>& out_inputSetNames); // [tested]
 
  static void GetAllInputActions(plStringView sInputSetName, plDynamicArray<plString>& out_inputActions); // [tested]
 
  static void SetExclusiveInputSet(plStringView sExclusiveSet) { s_sExclusiveInputSet = sExclusiveSet; }
 
  static plStringView GetExclusiveInputSet() { return s_sExclusiveInputSet; }
 
  static void InjectInputSlotValue(plStringView sInputSlot, float fValue); // [tested]
 
  static plStringView GetPressedInputSlot(plInputSlotFlags::Enum mustHaveFlags, plInputSlotFlags::Enum mustNotHaveFlags); // [tested]
 
  static plStringView ConvertScanCodeToEngineName(plUInt8 uiScanCode, bool bIsExtendedKey);
 
  static plStringView GetInputSlotTouchPoint(plUInt32 uiIndex);
 
  static plStringView GetInputSlotTouchPointPositionX(plUInt32 uiIndex);
 
  static plStringView GetInputSlotTouchPointPositionY(plUInt32 uiIndex);
 
  struct InputEventData
  {
    enum EventType
    {
      InputSlotChanged,   
      InputActionChanged, 
    };
 
    EventType m_EventType = InputSlotChanged;
    plStringView m_sInputSlot;
    plStringView m_sInputSet;
    plStringView m_sInputAction;
  };
 
  using plEventInput = plEvent<const InputEventData&>;
 
  static plEventSubscriptionID AddEventHandler(plEventInput::Handler handler) { return s_InputEvents.AddEventHandler(handler); }
 
  static void RemoveEventHandler(plEventInput::Handler handler) { s_InputEvents.RemoveEventHandler(handler); }
  static void RemoveEventHandler(plEventSubscriptionID id) { s_InputEvents.RemoveEventHandler(id); }
 
private:
  friend class plInputDevice;
 
  static void RegisterInputSlot(plStringView sName, plStringView sDefaultDisplayName, plBitflags<plInputSlotFlags> SlotFlags);
 
private:
  struct plInputSlot
  {
    plInputSlot();
 
    plString m_sDisplayName;                  
    float m_fValue;                           
    float m_fValueOld = 0.0f;                 
    plKeyState::Enum m_State;                 
    float m_fDeadZone;                        
    plBitflags<plInputSlotFlags> m_SlotFlags; 
  };
 
  struct plActionData
  {
    plActionData();
 
    plInputActionConfig m_Config; 
 
    float m_fValue;           
    plKeyState::Enum m_State; 
 
    plInt8 m_iTriggeredViaAlternative;
  };
 
  using plActionMap = plMap<plString, plActionData>;    
  using plInputSetMap = plMap<plString, plActionMap>;   
  using plInputSlotsMap = plMap<plString, plInputSlot>; 
 
  struct InternalData
  {
    plInputSetMap s_ActionMapping;                  
    plInputSlotsMap s_InputSlots;                   
    plMap<plString, plString> s_ActionDisplayNames; 
    plMap<plString, float> s_InjectedInputSlots;
  };
 
  static plUInt32 s_uiLastCharacter;
 
  static bool s_bInputSlotResetRequired;
 
  static plString s_sExclusiveInputSet;
 
  static void ResetInputSlotValues();
 
  static void GatherDeviceInputSlotValues();
 
  static void UpdateInputSlotStates();
 
  static void UpdateInputActions(plTime tTimeDifference);
 
  static void UpdateInputActions(plStringView sInputSet, plActionMap& Actions, plTime tTimeDifference);
 
  static plActionMap::Iterator GetBestAction(plActionMap& Actions, const plString& sSlot, const plActionMap::Iterator& itFirst);
 
private:
  PL_MAKE_SUBSYSTEM_STARTUP_FRIEND(Core, InputManager);
 
  static void DeallocateInternals();
  static InternalData& GetInternals();
 
  static plEventInput s_InputEvents;
 
  static InternalData* s_pData;
};