/usr/include/mirclient/mir_toolkit/events/input/touch_event.h is in libmirclient-dev 0.26.3+16.04.20170605-0ubuntu1.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 153 154 155 156 157 158 159 160 161 162 163 | /*
* Copyright © 2014 Canonical Ltd.
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License version 3,
* as published by the Free Software Foundation.
*
* This program 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Authored by: Robert Carr <robert.carr@canonical.com>
*/
#ifndef MIR_TOOLKIT_TOUCH_EVENT_H_
#define MIR_TOOLKIT_TOUCH_EVENT_H_
#ifdef __cplusplus
/**
* \addtogroup mir_toolkit
* @{
*/
extern "C" {
#endif
/**
* An event type describing a change in touch device state.
*/
typedef struct MirTouchEvent MirTouchEvent;
/**
* An identifier for a touch-point. TouchId's are unique per-gesture.
* That is to say, once a touch has gone down at time T, no other touch will
* use that touch's ID until all touches at time T have come up.
*/
typedef int32_t MirTouchId;
/**
* Possible per touch actions for state changing
*/
typedef enum {
/* This touch point is going up */
mir_touch_action_up = 0,
/* This touch point is going down */
mir_touch_action_down = 1,
/* Axis values have changed on this touch point */
mir_touch_action_change = 2,
mir_touch_actions
} MirTouchAction;
/**
* Identifiers for touch axis
*/
typedef enum {
/* Axis representing the x coordinate for the touch */
mir_touch_axis_x = 0,
/* Axis representing the y coordinate for the touch */
mir_touch_axis_y = 1,
/* Axis representing pressure of the touch */
mir_touch_axis_pressure = 2,
/* Axis representing the length of the major axis of an ellipse
centered at the touch point */
mir_touch_axis_touch_major = 3,
/* Axis representing the length of the minor axis of an ellipse
centered at the touch point */
mir_touch_axis_touch_minor = 4,
/* Axis representing the diameter of a circle centered on the touch
point */
mir_touch_axis_size = 5,
mir_touch_axes
} MirTouchAxis;
/**
* Identifiers for per-touch tool types
*/
typedef enum {
// Tool type could not be determined
mir_touch_tooltype_unknown = 0,
// Touch is made with a finger
mir_touch_tooltype_finger = 1,
// Touch is made with a stylus
mir_touch_tooltype_stylus = 2,
mir_touch_tooltypes
} MirTouchTooltype;
/**
* Retrieve the modifier keys pressed when the touch action occured.
*
* \param [in] event The key event
* \return The modifier mask
*/
MirInputEventModifiers mir_touch_event_modifiers(MirTouchEvent const* event);
/**
* Retrieve the number of touches reported for a given touch event. Each touch
* is said to be index in the event and may be accessed by index 0, 1, ... , (touch_count - 1)
*
* \param [in] event The touch event
* \return The number of touches
*/
unsigned int mir_touch_event_point_count(MirTouchEvent const* event);
/**
* Retrieve the TouchID for a touch at given index.
*
* \param [in] event The touch event
* \param [in] touch_index The touch index. Must be less than (touch_count - 1).
* \return ID of the touch at index
*/
MirTouchId mir_touch_event_id(MirTouchEvent const* event, size_t touch_index);
/**
* Retrieve the action which occured for a touch at given index.
*
* \param [in] event The touch event
* \param [in] touch_index The touch index. Must be less than (touch_count - 1).
* \return Action performed for the touch at index.
*/
MirTouchAction mir_touch_event_action(MirTouchEvent const* event, size_t touch_index);
/**
* Retrieve the tooltype for touch at given index.
*
* \param [in] event The touch event
* \param [in] touch_index The touch index. Must be less than (touch_count - 1).
* \return Tooltype used for the touch at index
*/
MirTouchTooltype mir_touch_event_tooltype(MirTouchEvent const* event,
size_t touch_index);
/**
* Retrieve the axis value for a given axis on an indexed touch.
*
* \param [in] event The touch event
* \param [in] touch_index The touch index. Must be less than (touch_count - 1).
* \param [in] axis The axis to retreive a value from
* \return The value of the given axis
*/
float mir_touch_event_axis_value(MirTouchEvent const* event,
size_t touch_index, MirTouchAxis axis);
/**
* Retrieve the corresponding input event.
*
* \param [in] event The touch event
* \return The input event
*/
MirInputEvent const* mir_touch_event_input_event(MirTouchEvent const* event);
#ifdef __cplusplus
}
/**@}*/
#endif
#endif /* MIR_TOOLKIT_TOUCH_EVENT_H_ */
|