InputEngine.h

Go to the documentation of this file.

/*
    This source file is part of Rigs of Rods
    Copyright 2005-2012 Pierre-Michel Ricordel
    Copyright 2007-2012 Thomas Fischer
    Copyright 2013-2023 Petr Ohlidal
 
    For more information, see http://www.rigsofrods.org/
 
    Rigs of Rods is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License version 3, as
    published by the Free Software Foundation.
 
    Rigs of Rods is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with Rigs of Rods. If not, see <http://www.gnu.org/licenses/>.
*/
 
 
#pragma once
 
#include "Application.h"
#include "ForceFeedback.h"
 
#include "OISEvents.h"
#include "OISForceFeedback.h"
#include "OISInputManager.h"
#include "OISJoyStick.h"
#include "OISKeyboard.h"
#include "OISMouse.h"
 
#define MAX_JOYSTICKS 10
#define MAX_JOYSTICK_POVS 4
#define MAX_JOYSTICK_SLIDERS 4
#define MAX_JOYSTICK_AXIS 32
 
namespace RoR {
 
 
enum eventtypes
{
    ET_NONE=0,
    ET_Keyboard,
    ET_MouseButton,
    ET_MouseAxisX,
    ET_MouseAxisY,
    ET_MouseAxisZ,
    ET_JoystickButton,
    ET_JoystickAxisAbs,
    ET_JoystickAxisRel,
    ET_JoystickPov,
    ET_JoystickSliderX,
    ET_JoystickSliderY,
    ET_END
};
 
enum class InputSourceType
{
    IST_ANY,
    IST_DIGITAL,
    IST_ANALOG
};
 
enum events
{
    // has to start at zero, since we iterate over it at times
    EV_AIRPLANE_AIRBRAKES_FULL=0,
    EV_AIRPLANE_AIRBRAKES_LESS,
    EV_AIRPLANE_AIRBRAKES_MORE,
    EV_AIRPLANE_AIRBRAKES_NONE,
    EV_AIRPLANE_BRAKE,           
    EV_AIRPLANE_ELEVATOR_DOWN,   
    EV_AIRPLANE_ELEVATOR_UP,     
    EV_AIRPLANE_FLAPS_FULL,      
    EV_AIRPLANE_FLAPS_LESS,      
    EV_AIRPLANE_FLAPS_MORE,      
    EV_AIRPLANE_FLAPS_NONE,      
    EV_AIRPLANE_PARKING_BRAKE,   
    EV_AIRPLANE_REVERSE,         
    EV_AIRPLANE_RUDDER_LEFT,     
    EV_AIRPLANE_RUDDER_RIGHT,    
    EV_AIRPLANE_STEER_LEFT,      
    EV_AIRPLANE_STEER_RIGHT,     
    EV_AIRPLANE_THROTTLE,        
    EV_AIRPLANE_THROTTLE_AXIS,   
    EV_AIRPLANE_THROTTLE_DOWN,   
    EV_AIRPLANE_THROTTLE_FULL,   
    EV_AIRPLANE_THROTTLE_NO,     
    EV_AIRPLANE_THROTTLE_UP,     
    EV_AIRPLANE_TOGGLE_ENGINES,  
    EV_BOAT_CENTER_RUDDER,       
    EV_BOAT_REVERSE,             
    EV_BOAT_STEER_LEFT,          
    EV_BOAT_STEER_LEFT_AXIS,     
    EV_BOAT_STEER_RIGHT,         
    EV_BOAT_STEER_RIGHT_AXIS,    
    EV_BOAT_THROTTLE_AXIS,       
    EV_BOAT_THROTTLE_DOWN,       
    EV_BOAT_THROTTLE_UP,         
    EV_SKY_DECREASE_TIME,        
    EV_SKY_DECREASE_TIME_FAST,   
    EV_SKY_INCREASE_TIME,        
    EV_SKY_INCREASE_TIME_FAST,   
    EV_CAMERA_CHANGE,            
    EV_CAMERA_DOWN,
    EV_CAMERA_FREE_MODE,
    EV_CAMERA_FREE_MODE_FIX,
    EV_CAMERA_LOOKBACK,          
    EV_CAMERA_RESET,             
    EV_CAMERA_ROTATE_DOWN,       
    EV_CAMERA_ROTATE_LEFT,       
    EV_CAMERA_ROTATE_RIGHT,      
    EV_CAMERA_ROTATE_UP,         
    EV_CAMERA_UP,
    EV_CAMERA_ZOOM_IN,           
    EV_CAMERA_ZOOM_IN_FAST,      
    EV_CAMERA_ZOOM_OUT,          
    EV_CAMERA_ZOOM_OUT_FAST,     
    EV_CHARACTER_BACKWARDS,      
    EV_CHARACTER_FORWARD,        
    EV_CHARACTER_JUMP,           
    EV_CHARACTER_LEFT,           
    EV_CHARACTER_RIGHT,          
    EV_CHARACTER_ROT_DOWN,
    EV_CHARACTER_ROT_UP,
    EV_CHARACTER_RUN,            
    EV_CHARACTER_SIDESTEP_LEFT,  
    EV_CHARACTER_SIDESTEP_RIGHT, 
    EV_COMMANDS_01,              
    EV_COMMANDS_02,              
    EV_COMMANDS_03,              
    EV_COMMANDS_04,              
    EV_COMMANDS_05,              
    EV_COMMANDS_06,              
    EV_COMMANDS_07,              
    EV_COMMANDS_08,              
    EV_COMMANDS_09,              
    EV_COMMANDS_10,              
    EV_COMMANDS_11,              
    EV_COMMANDS_12,              
    EV_COMMANDS_13,              
    EV_COMMANDS_14,              
    EV_COMMANDS_15,              
    EV_COMMANDS_16,              
    EV_COMMANDS_17,              
    EV_COMMANDS_18,              
    EV_COMMANDS_19,              
    EV_COMMANDS_20,              
    EV_COMMANDS_21,              
    EV_COMMANDS_22,              
    EV_COMMANDS_23,              
    EV_COMMANDS_24,              
    EV_COMMANDS_25,              
    EV_COMMANDS_26,              
    EV_COMMANDS_27,              
    EV_COMMANDS_28,              
    EV_COMMANDS_29,              
    EV_COMMANDS_30,              
    EV_COMMANDS_31,              
    EV_COMMANDS_32,              
    EV_COMMANDS_33,              
    EV_COMMANDS_34,              
    EV_COMMANDS_35,              
    EV_COMMANDS_36,              
    EV_COMMANDS_37,              
    EV_COMMANDS_38,              
    EV_COMMANDS_39,              
    EV_COMMANDS_40,              
    EV_COMMANDS_41,              
    EV_COMMANDS_42,              
    EV_COMMANDS_43,              
    EV_COMMANDS_44,              
    EV_COMMANDS_45,              
    EV_COMMANDS_46,              
    EV_COMMANDS_47,              
    EV_COMMANDS_48,              
    EV_COMMANDS_49,              
    EV_COMMANDS_50,              
    EV_COMMANDS_51,              
    EV_COMMANDS_52,              
    EV_COMMANDS_53,              
    EV_COMMANDS_54,              
    EV_COMMANDS_55,              
    EV_COMMANDS_56,              
    EV_COMMANDS_57,              
    EV_COMMANDS_58,              
    EV_COMMANDS_59,              
    EV_COMMANDS_60,              
    EV_COMMANDS_61,              
    EV_COMMANDS_62,              
    EV_COMMANDS_63,              
    EV_COMMANDS_64,              
    EV_COMMANDS_65,              
    EV_COMMANDS_66,              
    EV_COMMANDS_67,              
    EV_COMMANDS_68,              
    EV_COMMANDS_69,              
    EV_COMMANDS_70,              
    EV_COMMANDS_71,              
    EV_COMMANDS_72,              
    EV_COMMANDS_73,              
    EV_COMMANDS_74,              
    EV_COMMANDS_75,              
    EV_COMMANDS_76,              
    EV_COMMANDS_77,              
    EV_COMMANDS_78,              
    EV_COMMANDS_79,              
    EV_COMMANDS_80,              
    EV_COMMANDS_81,              
    EV_COMMANDS_82,              
    EV_COMMANDS_83,              
    EV_COMMANDS_84,              
    EV_COMMON_ACCELERATE_SIMULATION, 
    EV_COMMON_DECELERATE_SIMULATION, 
    EV_COMMON_RESET_SIMULATION_PACE, 
    EV_COMMON_AUTOLOCK,              
    EV_COMMON_CONSOLE_TOGGLE,        
    EV_COMMON_ENTER_CHATMODE,        
    EV_COMMON_ENTER_OR_EXIT_TRUCK,   
    EV_COMMON_ENTER_NEXT_TRUCK,      
    EV_COMMON_ENTER_PREVIOUS_TRUCK,  
    EV_COMMON_REMOVE_CURRENT_TRUCK,  
    EV_COMMON_RESPAWN_LAST_TRUCK,    
    EV_COMMON_FOV_LESS,           
    EV_COMMON_FOV_MORE,           
    EV_COMMON_FOV_RESET,          
    EV_COMMON_FULLSCREEN_TOGGLE,
    EV_COMMON_HIDE_GUI,           
    EV_COMMON_TOGGLE_DASHBOARD,   
    EV_COMMON_LOCK,               
    EV_COMMON_NETCHATDISPLAY,
    EV_COMMON_NETCHATMODE,
    EV_COMMON_OUTPUT_POSITION,    
    EV_COMMON_GET_NEW_VEHICLE,    
    EV_COMMON_PRESSURE_LESS,      
    EV_COMMON_PRESSURE_MORE,      
    EV_COMMON_QUICKLOAD,          
    EV_COMMON_QUICKSAVE,          
    EV_COMMON_QUIT_GAME,          
    EV_COMMON_REPAIR_TRUCK,       
    EV_COMMON_LIVE_REPAIR_MODE,   
    EV_COMMON_REPLAY_BACKWARD,
    EV_COMMON_REPLAY_FAST_BACKWARD,
    EV_COMMON_REPLAY_FAST_FORWARD,
    EV_COMMON_REPLAY_FORWARD,
    EV_COMMON_RESCUE_TRUCK,       
    EV_COMMON_RESET_TRUCK,        
    EV_COMMON_TOGGLE_RESET_MODE,  
    EV_COMMON_ROPELOCK,           
    EV_COMMON_SAVE_TERRAIN,       
    EV_COMMON_SCREENSHOT,         
    EV_COMMON_SCREENSHOT_BIG,     
    EV_COMMON_SECURE_LOAD,        
    EV_COMMON_SEND_CHAT,          
    EV_COMMON_TOGGLE_DEBUG_VIEW,  
    EV_COMMON_CYCLE_DEBUG_VIEWS,  
    EV_COMMON_TOGGLE_TERRAIN_EDITOR,   
    EV_COMMON_TOGGLE_CUSTOM_PARTICLES, 
    EV_COMMON_TOGGLE_MAT_DEBUG,   
    EV_COMMON_TOGGLE_REPLAY_MODE, 
    EV_COMMON_TOGGLE_PHYSICS,     
    EV_COMMON_TOGGLE_STATS,       
    EV_COMMON_TOGGLE_TRUCK_BEACONS,   
    EV_COMMON_CYCLE_TRUCK_LIGHTS,     
    EV_COMMON_TOGGLE_TRUCK_LOW_BEAMS, 
    EV_COMMON_TOGGLE_TRUCK_HIGH_BEAMS,
    EV_COMMON_TOGGLE_TRUCK_FOG_LIGHTS,
    EV_COMMON_TRUCK_INFO,         
    EV_COMMON_TRUCK_DESCRIPTION,  
    EV_COMMON_TRUCK_REMOVE,
    EV_GRASS_LESS,                
    EV_GRASS_MORE,                
    EV_GRASS_MOST,                
    EV_GRASS_NONE,                
    EV_GRASS_SAVE,                
    EV_MENU_DOWN,                 
    EV_MENU_LEFT,                 
    EV_MENU_RIGHT,                
    EV_MENU_SELECT,               
    EV_MENU_UP,                   
    EV_SURVEY_MAP_TOGGLE_ICONS,   
    EV_SURVEY_MAP_CYCLE,          
    EV_SURVEY_MAP_TOGGLE,         
    EV_SURVEY_MAP_ZOOM_IN,        
    EV_SURVEY_MAP_ZOOM_OUT,       
 
    EV_TRUCK_ACCELERATE,             
    EV_TRUCK_ACCELERATE_MODIFIER_25, 
    EV_TRUCK_ACCELERATE_MODIFIER_50, 
    EV_TRUCK_ANTILOCK_BRAKE,      
    EV_TRUCK_AUTOSHIFT_DOWN,      
    EV_TRUCK_AUTOSHIFT_UP,        
    EV_TRUCK_BLINK_LEFT,          
    EV_TRUCK_BLINK_RIGHT,         
    EV_TRUCK_BLINK_WARN,          
    EV_TRUCK_BRAKE,               
    EV_TRUCK_BRAKE_MODIFIER_25,   
    EV_TRUCK_BRAKE_MODIFIER_50,   
    EV_TRUCK_CRUISE_CONTROL,      
    EV_TRUCK_CRUISE_CONTROL_ACCL, 
    EV_TRUCK_CRUISE_CONTROL_DECL, 
    EV_TRUCK_CRUISE_CONTROL_READJUST, 
    EV_TRUCK_HORN,                
    EV_TRUCK_LEFT_MIRROR_LEFT,
    EV_TRUCK_LEFT_MIRROR_RIGHT,
    EV_TRUCK_LIGHTTOGGLE01,       
    EV_TRUCK_LIGHTTOGGLE02,       
    EV_TRUCK_LIGHTTOGGLE03,       
    EV_TRUCK_LIGHTTOGGLE04,       
    EV_TRUCK_LIGHTTOGGLE05,       
    EV_TRUCK_LIGHTTOGGLE06,       
    EV_TRUCK_LIGHTTOGGLE07,       
    EV_TRUCK_LIGHTTOGGLE08,       
    EV_TRUCK_LIGHTTOGGLE09,       
    EV_TRUCK_LIGHTTOGGLE10,       
    EV_TRUCK_MANUAL_CLUTCH,       
    EV_TRUCK_MANUAL_CLUTCH_MODIFIER_25,
    EV_TRUCK_MANUAL_CLUTCH_MODIFIER_50,
    EV_TRUCK_PARKING_BRAKE,       
    EV_TRUCK_TRAILER_PARKING_BRAKE, 
    EV_TRUCK_RIGHT_MIRROR_LEFT,
    EV_TRUCK_RIGHT_MIRROR_RIGHT,
    EV_TRUCK_SHIFT_DOWN,          
    EV_TRUCK_SHIFT_GEAR01,        
    EV_TRUCK_SHIFT_GEAR02,        
    EV_TRUCK_SHIFT_GEAR03,        
    EV_TRUCK_SHIFT_GEAR04,        
    EV_TRUCK_SHIFT_GEAR05,        
    EV_TRUCK_SHIFT_GEAR06,        
    EV_TRUCK_SHIFT_GEAR07,        
    EV_TRUCK_SHIFT_GEAR08,        
    EV_TRUCK_SHIFT_GEAR09,        
    EV_TRUCK_SHIFT_GEAR10,        
    EV_TRUCK_SHIFT_GEAR11,        
    EV_TRUCK_SHIFT_GEAR12,        
    EV_TRUCK_SHIFT_GEAR13,        
    EV_TRUCK_SHIFT_GEAR14,        
    EV_TRUCK_SHIFT_GEAR15,        
    EV_TRUCK_SHIFT_GEAR16,        
    EV_TRUCK_SHIFT_GEAR17,        
    EV_TRUCK_SHIFT_GEAR18,        
    EV_TRUCK_SHIFT_GEAR_REVERSE,  
    EV_TRUCK_SHIFT_HIGHRANGE,     
    EV_TRUCK_SHIFT_LOWRANGE,      
    EV_TRUCK_SHIFT_MIDRANGE,      
    EV_TRUCK_CYCLE_GEAR_RANGES,   
    EV_TRUCK_SHIFT_NEUTRAL,       
    EV_TRUCK_SHIFT_UP,            
    EV_TRUCK_STARTER,             
    EV_TRUCK_STEER_LEFT,          
    EV_TRUCK_STEER_RIGHT,         
    EV_TRUCK_SWITCH_SHIFT_MODES,  
    EV_TRUCK_TOGGLE_CONTACT,      
    EV_TRUCK_TOGGLE_FORWARDCOMMANDS,  
    EV_TRUCK_TOGGLE_IMPORTCOMMANDS,   
    EV_TRUCK_TOGGLE_INTER_AXLE_DIFF,  
    EV_TRUCK_TOGGLE_INTER_WHEEL_DIFF, 
    EV_TRUCK_TOGGLE_PHYSICS,      
    EV_TRUCK_TOGGLE_TCASE_4WD_MODE,   
    EV_TRUCK_TOGGLE_TCASE_GEAR_RATIO, 
    EV_TRUCK_TOGGLE_VIDEOCAMERA,  
    EV_TRUCK_TRACTION_CONTROL,    
 
    // Savegames
    EV_COMMON_QUICKSAVE_01,
    EV_COMMON_QUICKSAVE_02,
    EV_COMMON_QUICKSAVE_03,
    EV_COMMON_QUICKSAVE_04,
    EV_COMMON_QUICKSAVE_05,
    EV_COMMON_QUICKSAVE_06,
    EV_COMMON_QUICKSAVE_07,
    EV_COMMON_QUICKSAVE_08,
    EV_COMMON_QUICKSAVE_09,
    EV_COMMON_QUICKSAVE_10,
 
    EV_COMMON_QUICKLOAD_01,
    EV_COMMON_QUICKLOAD_02,
    EV_COMMON_QUICKLOAD_03,
    EV_COMMON_QUICKLOAD_04,
    EV_COMMON_QUICKLOAD_05,
    EV_COMMON_QUICKLOAD_06,
    EV_COMMON_QUICKLOAD_07,
    EV_COMMON_QUICKLOAD_08,
    EV_COMMON_QUICKLOAD_09,
    EV_COMMON_QUICKLOAD_10,
 
    EV_TRUCKEDIT_RELOAD,
 
    EV_ROAD_EDITOR_POINT_INSERT,
    EV_ROAD_EDITOR_POINT_SET_POS,
    EV_ROAD_EDITOR_POINT_GOTO,
    EV_ROAD_EDITOR_POINT_DELETE,
    EV_ROAD_EDITOR_REBUILD_MESH,
 
    // the end, DO NOT MODIFY
    EV_MODE_BEFORELAST,
    EV_MODE_LAST
};
const events EV_INVALID = (events)-1;
 
struct InputEvent
{
    Ogre::String name;
    int eventID;
    Ogre::String defaultKey;
    std::string description;
};
 
struct event_trigger_t
{
    // general
    enum eventtypes eventtype;
    int configDeviceID;            
    // keyboard
    int keyCode;
    bool explicite;
    bool ctrl;
    bool shift;
    bool alt;
    //mouse
    int mouseButtonNumber;
    //joystick buttons
    int joystickNumber;
    int joystickButtonNumber;
    // joystick axis
    int joystickAxisNumber;
    float joystickAxisDeadzone;
    float joystickAxisLinearity;
    int joystickAxisRegion;
    bool joystickAxisReverse;
    bool joystickAxisHalf;
    bool joystickAxisUseDigital;
 
    // POVs
    int joystickPovNumber;
    int joystickPovDirection;
 
    // Sliders
    int joystickSliderNumber;
    int joystickSliderReverse;
    int joystickSliderRegion;
 
    //others
    char configline[256]; 
    char group[128];
    char tmp_eventname[128];
    char comments[1024];
};
 
class InputEngine
{
public:
    typedef std::vector<event_trigger_t> TriggerVec;
    typedef std::map<int, TriggerVec> EventMap;
 
    static const std::string DEFAULT_MAPFILE; 
    static const int         DEFAULT_MAPFILE_DEVICEID = -1; 
    static const int         BUILTIN_MAPPING_DEVICEID = -2; 
 
    InputEngine();
    ~InputEngine();
 
    void                SetKeyboardListener(OIS::KeyListener* obj);
    OIS::Keyboard*      GetOisKeyboard() { return mKeyboard; }
    void                SetMouseListener(OIS::MouseListener* obj);
    void                SetJoystickListener(OIS::JoyStickListener* obj);
    void                destroy();
 
    void                Capture();
    void                updateKeyBounces(float dt);
    void                processMouseMotionEvent(const OIS::MouseEvent& arg);
    void                processMousePressEvent(const OIS::MouseEvent& arg, OIS::MouseButtonID _id);
    void                processMouseReleaseEvent(const OIS::MouseEvent& arg, OIS::MouseButtonID _id);
    void                ProcessKeyPress(const OIS::KeyEvent& arg);
    void                ProcessKeyRelease(const OIS::KeyEvent& arg);
    void                ProcessJoystickEvent(const OIS::JoyStickEvent& arg);
    void                resetKeysAndMouseButtons();
    void                setEventSimulatedValue(events eventID, float value);
    void                setEventStatusSupressed(events eventID, bool supress);
 
    Ogre::String        getKeyForCommand(int eventID);
    Ogre::String        getModifierKeyName(OIS::KeyCode key);
    Ogre::String        getDeviceName(event_trigger_t const& evt);
    Ogre::String        getEventCommand(int eventID);
    std::string         getEventCommandTrimmed(int eventID);                
    Ogre::String        getTriggerCommand(event_trigger_t const& evt);
    Ogre::String        getEventConfig(int eventID);
    Ogre::String        getEventDefaultConfig(int eventID);
    bool                isEventDefined(int eventID);
    int                 getKeboardKeyForCommand(int eventID);               
    int                 getJoyComponentCount(OIS::ComponentType type, int joystickNumber);
    std::string         getJoyVendor(int joystickNumber);
    int                 getNumJoysticks() { return free_joysticks; }
    EventMap&           getEvents() { return events; };
 
    bool                loadConfigFile(int deviceID = -1);                  
    bool                saveConfigFile(int deviceID = -1);                  
    std::string const&  getLoadedConfigFile(int deviceID = -1);             
    bool                processLine(const char* line, int deviceID = -1);
    bool                updateConfigline(event_trigger_t* t);
 
    void                addEvent(int eventID, event_trigger_t& t);          
    void                addEvent(int eventID);                              
    void                addEventDefault(int eventID, int deviceID = -1);    
    void                updateEvent(int eventID, const event_trigger_t& t);
    void                eraseEvent(int eventID, const event_trigger_t* t);
    void                clearEvents(int eventID);                           
    void                clearEventsByDevice(int deviceID);                  
    void                clearAllEvents();                                   
 
    float               getEventValue(int eventID, bool pure = false, InputSourceType valueSource = InputSourceType::IST_ANY);
    bool                getEventBoolValue(int eventID);
    bool                isEventAnalog(int eventID);
    bool                getEventBoolValueBounce(int eventID, float time = 0.2f);
    float               getEventBounceTime(int eventID);
    bool                isKeyDownEffective(OIS::KeyCode mod);               
    bool                isKeyDownValueBounce(OIS::KeyCode mod, float time = 0.2f);
 
    OIS::JoyStickState* getCurrentJoyState(int joystickNumber);
    OIS::MouseState     getMouseState();
    bool                isKeyDown(OIS::KeyCode mod);                        
    int                 getCurrentKeyCombo(Ogre::String* combo);            
    int                 getCurrentJoyButton(int& joystickNumber, int& button);
    int                 getCurrentPovValue(int& joystickNumber, int& pov, int& povdir);
    Ogre::Vector2       getMouseNormalizedScreenPos();                      
 
    static const char*  getEventTypeName(eventtypes type);                  
    static int          resolveEventName(Ogre::String eventName);
    static Ogre::String eventIDToName(int eventID);
    static Ogre::String eventIDToDescription(int eventID);
    std::string         getKeyNameForKeyCode(OIS::KeyCode keycode);
 
    void windowResized(Ogre::RenderWindow* rw);
    OIS::ForceFeedback* getForceFeedbackDevice() { return mForceFeedback; };
 
protected:
 
    //OIS Input devices
    OIS::InputManager* mInputManager;
    OIS::Mouse* mMouse;
    OIS::Keyboard* mKeyboard;
    OIS::JoyStick* mJoy[MAX_JOYSTICKS];
    int free_joysticks; 
    OIS::ForceFeedback* mForceFeedback;
    int uniqueCounter;
 
    // this stores the key/button/axis values
    std::map<int, bool> keyState;
    OIS::JoyStickState joyState[MAX_JOYSTICKS];
    OIS::MouseState mouseState;
 
    // define event aliases
    std::map<int, std::vector<event_trigger_t>> events;
    std::map<int, float> event_values_simulated;
    std::map<int, float> event_times;
    std::map<int, bool> event_states_supressed;
    std::string m_loaded_configs[MAX_JOYSTICKS];
    bool loadMapping(Ogre::String fileName, int deviceID);
    bool saveMapping(Ogre::String fileName, int deviceID);
    void completeMissingEvents();
 
    void initAllKeys();
    void setup();
    std::map<std::string, OIS::KeyCode> allkeys;
    std::map<std::string, OIS::KeyCode>::iterator allit;
 
    float deadZone(float axis, float dz);
    float axisLinearity(float axisValue, float linearity);
 
    float logval(float val);
    std::string getEventGroup(Ogre::String eventName);
    std::string composeEventConfigString(event_trigger_t const& trig);
    std::string composeEventCommandString(event_trigger_t const& trig);
 
    event_trigger_t newEvent();
 
    // OIS WORKAROUND: After a window focus is restored for the 2nd+ time, OIS delivers a fabricated 'LMB pressed' event,
    //    without ever sending matching 'LMB released', see analysis: https://github.com/RigsOfRods/rigs-of-rods/pull/3184#issuecomment-2380397463
    // This has a very prominent negative effect, see https://github.com/RigsOfRods/rigs-of-rods/issues/2468
    // There's no way to recognize the event as fake, we must track number of frames and LMB presses since last reset.
    size_t m_oisworkaround_frames_since_reset = 0u;
    size_t m_oisworkaround_lmbdowns_since_reset = 0u;
};
 
 
} // namespace RoR