1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
/*
* Copyright (C) 2015-2018 Team Kodi
* This file is part of Kodi - https://kodi.tv
*
* SPDX-License-Identifier: GPL-2.0-or-later
* See LICENSES/README.md for more information.
*/
#pragma once
#include "JoystickTypes.h"
namespace KODI
{
namespace JOYSTICK
{
class CDriverPrimitive;
/*!
* \brief Joystick translation utilities
*/
class CJoystickTranslator
{
public:
/*!
* \brief Translate a hat state to a string representation
*
* \param state The hat state
*
* \return A capitalized string representation, or "RELEASED" if the hat is centered.
*/
static const char* HatStateToString(HAT_STATE state);
/*!
* \brief Translate an analog stick direction to a lower-case string
*
* \param dir The analog stick direction
*
* \return A lower-case string representation, or "" if the direction is invalid
*/
static const char* TranslateAnalogStickDirection(ANALOG_STICK_DIRECTION dir);
/*!
* \brief Translate an analog stick direction string to an enum value
*
* \param dir The analog stick direction
*
* \return The translated direction, or ANALOG_STICK_DIRECTION::UNKNOWN if unknown
*/
static ANALOG_STICK_DIRECTION TranslateAnalogStickDirection(const std::string& dir);
/*!
* \brief Translate a wheel direction to a lower-case string
*
* \param dir The wheel direction
*
* \return A lower-case string representation, or "" if the direction is invalid
*/
static const char* TranslateWheelDirection(WHEEL_DIRECTION dir);
/*!
* \brief Translate a wheel direction string to an enum value
*
* \param dir The wheel direction
*
* \return The translated direction, or WHEEL_DIRECTION::UNKNOWN if unknown
*/
static WHEEL_DIRECTION TranslateWheelDirection(const std::string& dir);
/*!
* \brief Translate a throttle direction to a lower-case string
*
* \param dir The analog stick direction
*
* \return A lower-case string representation, or "" if the direction is invalid
*/
static const char* TranslateThrottleDirection(THROTTLE_DIRECTION dir);
/*!
* \brief Translate a throttle direction string to an enum value
*
* \param dir The throttle direction
*
* \return The translated direction, or THROTTLE_DIRECTION::UNKNOWN if unknown
*/
static THROTTLE_DIRECTION TranslateThrottleDirection(const std::string& dir);
/*!
* \brief Get the semi-axis direction containing the specified position
*
* \param position The position of the axis
*
* \return POSITIVE, NEGATIVE, or UNKNOWN if position is 0
*/
static SEMIAXIS_DIRECTION PositionToSemiAxisDirection(float position);
/*!
* \brief Get the wheel direction containing the specified position
*
* \param position The position of the axis
*
* \return LEFT, RIGHT, or UNKNOWN if position is 0
*/
static WHEEL_DIRECTION PositionToWheelDirection(float position);
/*!
* \brief Get the throttle direction containing the specified position
*
* \param position The position of the axis
*
* \return UP, DOWN, or UNKNOWN if position is 0
*/
static THROTTLE_DIRECTION PositionToThrottleDirection(float position);
/*!
* \brief Get the localized name of the primitive
*
* \param primitive The primitive, currently only buttons and axes are supported
*
* \return A title for the primitive, e.g. "Button 0" or "Axis 1"
*/
static std::string GetPrimitiveName(const CDriverPrimitive& primitive);
};
} // namespace JOYSTICK
} // namespace KODI
|
