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
|
/*
* Copyright (C) 2013-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 "input/touch/ITouchInputHandling.h"
#include <atomic>
#include <stdint.h>
/*!
* \ingroup touch
* \brief Touch input event
*/
typedef enum
{
TouchInputUnchanged = 0,
TouchInputAbort,
TouchInputDown,
TouchInputUp,
TouchInputMove
} TouchInput;
/*!
* \ingroup touch
* \brief Interface (implements ITouchInputHandling) defining methods to handle
* raw touch input events (down, up, move).
*
* This interface should be implemented on platforms only supporting low level
* (raw) touch input events like touch down/up/move and with no gesture
* recognition logic.
*/
class ITouchInputHandler : public ITouchInputHandling
{
public:
ITouchInputHandler() : m_dpi(160.0f) {}
~ITouchInputHandler() override = default;
/*!
* \brief Handle a touch event
*
* Handles the given touch event at the given location.
* This takes into account all the currently active pointers
* which need to be updated before calling this method to
* actually interpret and handle the changes in touch.
*
* \param event The actual touch event (abort, down, up, move)
* \param x The x coordinate (with sub-pixel) of the touch
* \param y The y coordinate (with sub-pixel) of the touch
* \param time The time (in nanoseconds) when this touch occurred
* \param pointer The number of the touch pointer which caused this event (default 0)
* \param size The size of the touch pointer (with sub-pixel) (default 0.0)
*
* \return True if the event was handled otherwise false.
*
* \sa Update
*/
virtual bool HandleTouchInput(
TouchInput event, float x, float y, int64_t time, int32_t pointer = 0, float size = 0.0f) = 0;
/*!
* \brief Update the coordinates of a pointer
*
* Depending on how a platform handles touch input and provides the necessary events
* this method needs to be called at different times. If there's an event for every
* touch action this method does not need to be called at all. If there's only a
* touch event for the primary pointer (and no special events for any secondary
* pointers in a multi touch gesture) this method should be called for every active
* secondary pointer before calling Handle.
*
* \param pointer The number of the touch pointer which caused this event (default 0)
* \param x The x coordinate (with sub-pixel) of the touch
* \param y The y coordinate (with sub-pixel) of the touch
* \param time The time (in nanoseconds) when this touch occurred
* \param size The size of the touch pointer (with sub-pixel) (default 0.0)
*
* \return True if the pointer was updated otherwise false.
*
* \sa Handle
*/
virtual bool UpdateTouchPointer(
int32_t pointer, float x, float y, int64_t time, float size = 0.0f)
{
return false;
}
void SetScreenDPI(float dpi)
{
if (dpi > 0.0f)
m_dpi = dpi;
}
float GetScreenDPI() { return m_dpi; }
protected:
/*!
* \brief DPI value of the touch screen
*/
std::atomic<float> m_dpi;
};
|
