Mir
touch_event.h
Go to the documentation of this file.
1 /*
2  * Copyright © 2014 Canonical Ltd.
3  *
4  * This program is free software: you can redistribute it and/or modify it
5  * under the terms of the GNU Lesser General Public License version 3,
6  * as published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  *
16  * Authored by: Robert Carr <robert.carr@canonical.com>
17  */
18 
19 #ifndef MIR_TOOLKIT_TOUCH_EVENT_H_
20 #define MIR_TOOLKIT_TOUCH_EVENT_H_
21 
22 #ifdef __cplusplus
23 
27 extern "C" {
28 #endif
29 
34 
40 typedef int32_t MirTouchId;
41 
45 typedef enum {
46  /* This touch point is going up */
48  /* This touch point is going down */
50  /* Axis values have changed on this touch point */
53 
57 typedef enum {
58 /* Axis representing the x coordinate for the touch */
60 /* Axis representing the y coordinate for the touch */
62 /* Axis representing pressure of the touch */
64 /* Axis representing the length of the major axis of an ellipse
65  centered at the touch point */
67 /* Axis representing the length of the minor axis of an ellipse
68  centered at the touch point */
70 /* Axis representing the diameter of a circle centered on the touch
71  point */
73 } MirTouchAxis;
74 
78 typedef enum {
79 // Tool type could not be determined
81 // Touch is made with a finger
83 // Touch is made with a stylus
86 
94 
102 unsigned int mir_touch_event_point_count(MirTouchEvent const* event);
103 
111 MirTouchId mir_touch_event_id(MirTouchEvent const* event, size_t touch_index);
112 
120 MirTouchAction mir_touch_event_action(MirTouchEvent const* event, size_t touch_index);
121 
130  size_t touch_index);
131 
132 
141 float mir_touch_event_axis_value(MirTouchEvent const* event,
142  size_t touch_index, MirTouchAxis axis);
143 
151 
152 #ifdef __cplusplus
153 }
155 #endif
156 
157 #endif /* MIR_TOOLKIT_TOUCH_EVENT_H_ */
Definition: touch_event.h:69
Definition: touch_event.h:49
float mir_touch_event_axis_value(MirTouchEvent const *event, size_t touch_index, MirTouchAxis axis)
Retrieve the axis value for a given axis on an indexed touch.
Definition: input_event.cpp:299
Definition: touch_event.h:66
unsigned int mir_touch_event_point_count(MirTouchEvent const *event)
Retrieve the number of touches reported for a given touch event.
Definition: input_event.cpp:253
Definition: touch_event.h:72
int32_t MirTouchId
An identifier for a touch-point.
Definition: touch_event.h:40
Definition: touch_event.h:59
MirTouchAxis
Identifiers for touch axis.
Definition: touch_event.h:57
MirInputEvent const * mir_touch_event_input_event(MirTouchEvent const *event)
Retrieve the corresponding input event.
Definition: input_event.cpp:195
Definition: touch_event.h:84
unsigned int MirInputEventModifiers
Definition: input_event.h:66
Definition: touch_event.h:47
struct MirTouchEvent MirTouchEvent
An event type describing a change in touch device state.
Definition: touch_event.h:33
Definition: touch_event.h:61
MirTouchTooltype mir_touch_event_tooltype(MirTouchEvent const *event, size_t touch_index)
Retrieve the tooltype for touch at given index.
Definition: input_event.cpp:285
MirTouchTooltype
Identifiers for per-touch tool types.
Definition: touch_event.h:78
Definition: touch_event.h:51
Definition: touch_event.h:63
struct MirInputEvent MirInputEvent
Definition: event.h:56
MirInputEventModifiers mir_touch_event_modifiers(MirTouchEvent const *event)
Retrieve the modifier keys pressed when the touch action occured.
Definition: input_event.cpp:235
MirTouchAction
Possible per touch actions for state changing.
Definition: touch_event.h:45
MirTouchId mir_touch_event_id(MirTouchEvent const *event, size_t touch_index)
Retrieve the TouchID for a touch at given index.
Definition: input_event.cpp:259
Definition: touch_event.h:80
MirTouchAction mir_touch_event_action(MirTouchEvent const *event, size_t touch_index)
Retrieve the action which occured for a touch at given index.
Definition: input_event.cpp:272
Definition: touch_event.h:82

Copyright © 2012-2015 Canonical Ltd.
Generated on Wed Mar 30 00:29:56 UTC 2016