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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
/*
* Copyright (C) 2022 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 <map>
#include <stdint.h>
#include <string_view>
namespace UTILS
{
namespace MOVING_SPEED
{
struct EventCfg
{
/*!
* \param acceleration Acceleration in pixels per second (px/sec)
* \param maxVelocity Max movement speed, it depends from acceleration value,
* a suitable value could be (acceleration value)*3. Set 0 to disable it
* \param resetTimeout Resets acceleration speed if idle for specified millisecs
*/
EventCfg(float acceleration, float maxVelocity, uint32_t resetTimeout)
: m_acceleration{acceleration}, m_maxVelocity{maxVelocity}, m_resetTimeout{resetTimeout}
{
}
/*!
* \param acceleration Acceleration in pixels per second (px/sec)
* \param maxVelocity Max movement speed, it depends from acceleration value,
* a suitable value could be (acceleration value)*3. Set 0 to disable it
* \param resetTimeout Resets acceleration speed if idle for specified millisecs
* \param delta Specify the minimal increment step, and the result of distance
value will be rounded by delta. Set 0 to disable it
*/
EventCfg(float acceleration, float maxVelocity, uint32_t resetTimeout, float delta)
: m_acceleration{acceleration},
m_maxVelocity{maxVelocity},
m_resetTimeout{resetTimeout},
m_delta{delta}
{
}
float m_acceleration;
float m_maxVelocity;
uint32_t m_resetTimeout;
float m_delta{0};
};
enum class EventType
{
NONE = 0,
UP,
DOWN,
LEFT,
RIGHT
};
typedef std::map<EventType, EventCfg> MapEventConfig;
/*!
* \brief Class to calculate the velocity for a motion effect.
* To ensure it works, the GetUpdatedDistance method must be called at each
* input received (e.g. continuous key press of same key on the keyboard).
* The motion effect will stop at the event ID change (different key pressed).
*/
class CMovingSpeed
{
public:
/*!
* \brief Add the configuration for an event
* \param eventId The id for the event, must be unique
* \param acceleration Acceleration in pixels per second (px/sec)
* \param maxVelocity Max movement speed, it depends from acceleration value,
* a suitable value could be (acceleration value)*3. Set 0 to disable it
* \param resetTimeout Resets acceleration speed if idle for specified millisecs
*/
void AddEventConfig(uint32_t eventId,
float acceleration,
float maxVelocity,
uint32_t resetTimeout);
/*!
* \brief Add the configuration for an event
* \param eventId The id for the event, must be unique
* \param event The event configuration
*/
void AddEventConfig(uint32_t eventId, EventCfg event);
/*!
* \brief Add a map of events configuration
* \param configs The map of events configuration where key value is event id,
*/
void AddEventMapConfig(MapEventConfig& configs);
/*!
* \brief Reset stored velocity to all events
* \param event The event configuration
*/
void Reset();
/*!
* \brief Reset stored velocity for a specific event
* \param event The event ID
*/
void Reset(uint32_t eventId);
/*!
* \brief Get the updated distance based on acceleration speed
* \param eventId The id for the event to handle
* \return The distance
*/
float GetUpdatedDistance(uint32_t eventId);
/*!
* \brief Get the updated distance based on acceleration speed
* \param eventType The event type to handle
* \return The distance
*/
float GetUpdatedDistance(EventType eventType)
{
return GetUpdatedDistance(static_cast<uint32_t>(eventType));
}
private:
struct EventData
{
EventData(EventCfg config) : m_config{config} {}
EventCfg m_config;
float m_currentVelocity{1.0f};
uint32_t m_lastFrameTime{0};
};
uint32_t m_currentEventId{0};
std::map<uint32_t, EventData> m_eventsData;
};
/*!
* \brief Parse a string event type to enum EventType.
* \param eventType The event type as string
* \return The EventType if has success, otherwise EventType::NONE
*/
EventType ParseEventType(std::string_view eventType);
} // namespace MOVING_SPEED
} // namespace UTILS
|
