Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2010 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | #ifndef _UI_INPUT_H |
| 18 | #define _UI_INPUT_H |
| 19 | |
| 20 | /** |
| 21 | * Native input event structures. |
| 22 | */ |
| 23 | |
| 24 | #include <android/input.h> |
| 25 | #include <utils/Vector.h> |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 26 | #include <utils/KeyedVector.h> |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 27 | #include <utils/Timers.h> |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 28 | #include <utils/RefBase.h> |
| 29 | #include <utils/String8.h> |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 30 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 31 | #ifdef HAVE_ANDROID_OS |
| 32 | class SkMatrix; |
| 33 | #endif |
| 34 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 35 | /* |
| 36 | * Additional private constants not defined in ndk/ui/input.h. |
| 37 | */ |
| 38 | enum { |
| 39 | /* |
| 40 | * Private control to determine when an app is tracking a key sequence. |
| 41 | */ |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 42 | AKEY_EVENT_FLAG_START_TRACKING = 0x40000000 |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 43 | }; |
| 44 | |
Jeff Brown | 89de57a | 2011-01-19 18:41:38 -0800 | [diff] [blame] | 45 | enum { |
| 46 | /* |
| 47 | * Indicates that an input device has switches. |
| 48 | * This input source flag is hidden from the API because switches are only used by the system |
| 49 | * and applications have no way to interact with them. |
| 50 | */ |
| 51 | AINPUT_SOURCE_SWITCH = 0x80000000, |
| 52 | }; |
| 53 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 54 | /* |
| 55 | * Maximum number of pointers supported per motion event. |
Jeff Brown | 01ce2e9 | 2010-09-26 22:20:12 -0700 | [diff] [blame] | 56 | * Smallest number of pointers is 1. |
Jeff Brown | 58a2da8 | 2011-01-25 16:02:22 -0800 | [diff] [blame] | 57 | * (We want at least 10 but some touch controllers obstensibly configured for 10 pointers |
| 58 | * will occasionally emit 11. There is not much harm making this constant bigger.) |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 59 | */ |
Jeff Brown | 58a2da8 | 2011-01-25 16:02:22 -0800 | [diff] [blame] | 60 | #define MAX_POINTERS 16 |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 61 | |
Dianne Hackborn | a95e4cb | 2010-06-18 18:09:33 -0700 | [diff] [blame] | 62 | /* |
Jeff Brown | 01ce2e9 | 2010-09-26 22:20:12 -0700 | [diff] [blame] | 63 | * Maximum pointer id value supported in a motion event. |
| 64 | * Smallest pointer id is 0. |
| 65 | * (This is limited by our use of BitSet32 to track pointer assignments.) |
| 66 | */ |
| 67 | #define MAX_POINTER_ID 31 |
| 68 | |
| 69 | /* |
Dianne Hackborn | a95e4cb | 2010-06-18 18:09:33 -0700 | [diff] [blame] | 70 | * Declare a concrete type for the NDK's input event forward declaration. |
| 71 | */ |
Dianne Hackborn | d76b67c | 2010-07-13 17:48:30 -0700 | [diff] [blame] | 72 | struct AInputEvent { |
| 73 | virtual ~AInputEvent() { } |
| 74 | }; |
Dianne Hackborn | a95e4cb | 2010-06-18 18:09:33 -0700 | [diff] [blame] | 75 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 76 | /* |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 77 | * Declare a concrete type for the NDK's input device forward declaration. |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 78 | */ |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 79 | struct AInputDevice { |
| 80 | virtual ~AInputDevice() { } |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 81 | }; |
| 82 | |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 83 | |
| 84 | namespace android { |
| 85 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 86 | #ifdef HAVE_ANDROID_OS |
| 87 | class Parcel; |
| 88 | #endif |
| 89 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 90 | /* |
| 91 | * Flags that flow alongside events in the input dispatch system to help with certain |
| 92 | * policy decisions such as waking from device sleep. |
Jeff Brown | b699726 | 2010-10-08 22:31:17 -0700 | [diff] [blame] | 93 | * |
| 94 | * These flags are also defined in frameworks/base/core/java/android/view/WindowManagerPolicy.java. |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 95 | */ |
| 96 | enum { |
Jeff Brown | 0eaf393 | 2010-10-01 14:55:30 -0700 | [diff] [blame] | 97 | /* These flags originate in RawEvents and are generally set in the key map. |
Jeff Brown | 497a92c | 2010-09-12 17:55:08 -0700 | [diff] [blame] | 98 | * NOTE: If you edit these flags, also edit labels in KeycodeLabels.h. */ |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 99 | |
| 100 | POLICY_FLAG_WAKE = 0x00000001, |
| 101 | POLICY_FLAG_WAKE_DROPPED = 0x00000002, |
| 102 | POLICY_FLAG_SHIFT = 0x00000004, |
| 103 | POLICY_FLAG_CAPS_LOCK = 0x00000008, |
| 104 | POLICY_FLAG_ALT = 0x00000010, |
| 105 | POLICY_FLAG_ALT_GR = 0x00000020, |
| 106 | POLICY_FLAG_MENU = 0x00000040, |
| 107 | POLICY_FLAG_LAUNCHER = 0x00000080, |
Jeff Brown | 0eaf393 | 2010-10-01 14:55:30 -0700 | [diff] [blame] | 108 | POLICY_FLAG_VIRTUAL = 0x00000100, |
Jeff Brown | 497a92c | 2010-09-12 17:55:08 -0700 | [diff] [blame] | 109 | POLICY_FLAG_FUNCTION = 0x00000200, |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 110 | |
Jeff Brown | 7fbdc84 | 2010-06-17 20:52:56 -0700 | [diff] [blame] | 111 | POLICY_FLAG_RAW_MASK = 0x0000ffff, |
| 112 | |
Jeff Brown | 85a3176 | 2010-09-01 17:01:00 -0700 | [diff] [blame] | 113 | /* These flags are set by the input dispatcher. */ |
| 114 | |
| 115 | // Indicates that the input event was injected. |
| 116 | POLICY_FLAG_INJECTED = 0x01000000, |
| 117 | |
Jeff Brown | e20c9e0 | 2010-10-11 14:20:19 -0700 | [diff] [blame] | 118 | // Indicates that the input event is from a trusted source such as a directly attached |
| 119 | // input device or an application with system-wide event injection permission. |
| 120 | POLICY_FLAG_TRUSTED = 0x02000000, |
| 121 | |
Jeff Brown | 9c3cda0 | 2010-06-15 01:31:58 -0700 | [diff] [blame] | 122 | /* These flags are set by the input reader policy as it intercepts each event. */ |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 123 | |
| 124 | // Indicates that the screen was off when the event was received and the event |
| 125 | // should wake the device. |
| 126 | POLICY_FLAG_WOKE_HERE = 0x10000000, |
| 127 | |
| 128 | // Indicates that the screen was dim when the event was received and the event |
| 129 | // should brighten the device. |
| 130 | POLICY_FLAG_BRIGHT_HERE = 0x20000000, |
Jeff Brown | b699726 | 2010-10-08 22:31:17 -0700 | [diff] [blame] | 131 | |
| 132 | // Indicates that the event should be dispatched to applications. |
| 133 | // The input event should still be sent to the InputDispatcher so that it can see all |
| 134 | // input events received include those that it will not deliver. |
| 135 | POLICY_FLAG_PASS_TO_USER = 0x40000000, |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 136 | }; |
| 137 | |
| 138 | /* |
Jeff Brown | 9c3cda0 | 2010-06-15 01:31:58 -0700 | [diff] [blame] | 139 | * Describes the basic configuration of input devices that are present. |
| 140 | */ |
| 141 | struct InputConfiguration { |
| 142 | enum { |
| 143 | TOUCHSCREEN_UNDEFINED = 0, |
| 144 | TOUCHSCREEN_NOTOUCH = 1, |
| 145 | TOUCHSCREEN_STYLUS = 2, |
| 146 | TOUCHSCREEN_FINGER = 3 |
| 147 | }; |
| 148 | |
| 149 | enum { |
| 150 | KEYBOARD_UNDEFINED = 0, |
| 151 | KEYBOARD_NOKEYS = 1, |
| 152 | KEYBOARD_QWERTY = 2, |
| 153 | KEYBOARD_12KEY = 3 |
| 154 | }; |
| 155 | |
| 156 | enum { |
| 157 | NAVIGATION_UNDEFINED = 0, |
| 158 | NAVIGATION_NONAV = 1, |
| 159 | NAVIGATION_DPAD = 2, |
| 160 | NAVIGATION_TRACKBALL = 3, |
| 161 | NAVIGATION_WHEEL = 4 |
| 162 | }; |
| 163 | |
| 164 | int32_t touchScreen; |
| 165 | int32_t keyboard; |
| 166 | int32_t navigation; |
| 167 | }; |
| 168 | |
| 169 | /* |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 170 | * Pointer coordinate data. |
| 171 | */ |
| 172 | struct PointerCoords { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 173 | static const size_t MAX_AXES = 15; // 15 so that sizeof(PointerCoords) == 16 * 4 == 64 |
| 174 | |
| 175 | // Bitfield of axes that are present in this structure. |
| 176 | uint32_t bits; // 32bits are enough for now, can raise to 64bit when needed |
| 177 | |
| 178 | // Values of axes that are stored in this structure packed in order by axis id |
| 179 | // for each axis that is present in the structure according to 'bits'. |
| 180 | float values[MAX_AXES]; |
| 181 | |
| 182 | inline void clear() { |
| 183 | bits = 0; |
| 184 | } |
| 185 | |
| 186 | inline float getAxisValue(int32_t axis) const { |
| 187 | uint32_t axisBit = 1 << axis; |
| 188 | if (!(bits & axisBit)) { |
| 189 | return 0; |
| 190 | } |
| 191 | uint32_t index = __builtin_popcount(bits & (axisBit - 1)); |
| 192 | return values[index]; |
| 193 | } |
| 194 | |
| 195 | inline void setAxisValue(int32_t axis, float value) { |
| 196 | uint32_t axisBit = 1 << axis; |
| 197 | uint32_t index = __builtin_popcount(bits & (axisBit - 1)); |
| 198 | if (!(bits & axisBit)) { |
| 199 | uint32_t count = __builtin_popcount(bits); |
| 200 | if (count >= MAX_AXES) { |
| 201 | tooManyAxes(axis); |
| 202 | return; |
| 203 | } |
| 204 | bits |= axisBit; |
| 205 | for (uint32_t i = count; i > index; i--) { |
| 206 | values[i] = values[i - 1]; |
| 207 | } |
| 208 | } |
| 209 | values[index] = value; |
| 210 | } |
| 211 | |
| 212 | inline float* editAxisValue(int32_t axis) { |
| 213 | uint32_t axisBit = 1 << axis; |
| 214 | if (!(bits & axisBit)) { |
| 215 | return NULL; |
| 216 | } |
| 217 | uint32_t index = __builtin_popcount(bits & (axisBit - 1)); |
| 218 | return &values[index]; |
| 219 | } |
| 220 | |
| 221 | #ifdef HAVE_ANDROID_OS |
| 222 | status_t readFromParcel(Parcel* parcel); |
| 223 | status_t writeToParcel(Parcel* parcel) const; |
| 224 | #endif |
| 225 | |
| 226 | private: |
| 227 | void tooManyAxes(int axis); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 228 | }; |
| 229 | |
| 230 | /* |
| 231 | * Input events. |
| 232 | */ |
Dianne Hackborn | 2e9f93e | 2010-06-28 15:27:30 -0700 | [diff] [blame] | 233 | class InputEvent : public AInputEvent { |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 234 | public: |
| 235 | virtual ~InputEvent() { } |
| 236 | |
| 237 | virtual int32_t getType() const = 0; |
| 238 | |
| 239 | inline int32_t getDeviceId() const { return mDeviceId; } |
| 240 | |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 241 | inline int32_t getSource() const { return mSource; } |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 242 | |
| 243 | inline void setSource(int32_t source) { mSource = source; } |
| 244 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 245 | protected: |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 246 | void initialize(int32_t deviceId, int32_t source); |
Dianne Hackborn | 2c6081c | 2010-07-15 17:44:53 -0700 | [diff] [blame] | 247 | void initialize(const InputEvent& from); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 248 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 249 | int32_t mDeviceId; |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 250 | int32_t mSource; |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 251 | }; |
| 252 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 253 | /* |
| 254 | * Key events. |
| 255 | */ |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 256 | class KeyEvent : public InputEvent { |
| 257 | public: |
| 258 | virtual ~KeyEvent() { } |
| 259 | |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 260 | virtual int32_t getType() const { return AINPUT_EVENT_TYPE_KEY; } |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 261 | |
| 262 | inline int32_t getAction() const { return mAction; } |
| 263 | |
| 264 | inline int32_t getFlags() const { return mFlags; } |
| 265 | |
| 266 | inline int32_t getKeyCode() const { return mKeyCode; } |
| 267 | |
| 268 | inline int32_t getScanCode() const { return mScanCode; } |
| 269 | |
| 270 | inline int32_t getMetaState() const { return mMetaState; } |
| 271 | |
| 272 | inline int32_t getRepeatCount() const { return mRepeatCount; } |
| 273 | |
| 274 | inline nsecs_t getDownTime() const { return mDownTime; } |
| 275 | |
| 276 | inline nsecs_t getEventTime() const { return mEventTime; } |
| 277 | |
Dianne Hackborn | 3c80a4a | 2010-06-29 19:20:40 -0700 | [diff] [blame] | 278 | // Return true if this event may have a default action implementation. |
| 279 | static bool hasDefaultAction(int32_t keyCode); |
| 280 | bool hasDefaultAction() const; |
| 281 | |
| 282 | // Return true if this event represents a system key. |
| 283 | static bool isSystemKey(int32_t keyCode); |
| 284 | bool isSystemKey() const; |
| 285 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 286 | void initialize( |
| 287 | int32_t deviceId, |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 288 | int32_t source, |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 289 | int32_t action, |
| 290 | int32_t flags, |
| 291 | int32_t keyCode, |
| 292 | int32_t scanCode, |
| 293 | int32_t metaState, |
| 294 | int32_t repeatCount, |
| 295 | nsecs_t downTime, |
| 296 | nsecs_t eventTime); |
Dianne Hackborn | 2c6081c | 2010-07-15 17:44:53 -0700 | [diff] [blame] | 297 | void initialize(const KeyEvent& from); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 298 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 299 | protected: |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 300 | int32_t mAction; |
| 301 | int32_t mFlags; |
| 302 | int32_t mKeyCode; |
| 303 | int32_t mScanCode; |
| 304 | int32_t mMetaState; |
| 305 | int32_t mRepeatCount; |
| 306 | nsecs_t mDownTime; |
| 307 | nsecs_t mEventTime; |
| 308 | }; |
| 309 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 310 | /* |
| 311 | * Motion events. |
| 312 | */ |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 313 | class MotionEvent : public InputEvent { |
| 314 | public: |
| 315 | virtual ~MotionEvent() { } |
| 316 | |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 317 | virtual int32_t getType() const { return AINPUT_EVENT_TYPE_MOTION; } |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 318 | |
| 319 | inline int32_t getAction() const { return mAction; } |
| 320 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 321 | inline void setAction(int32_t action) { mAction = action; } |
| 322 | |
Jeff Brown | 85a3176 | 2010-09-01 17:01:00 -0700 | [diff] [blame] | 323 | inline int32_t getFlags() const { return mFlags; } |
| 324 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 325 | inline int32_t getEdgeFlags() const { return mEdgeFlags; } |
| 326 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 327 | inline void setEdgeFlags(int32_t edgeFlags) { mEdgeFlags = edgeFlags; } |
| 328 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 329 | inline int32_t getMetaState() const { return mMetaState; } |
| 330 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 331 | inline void setMetaState(int32_t metaState) { mMetaState = metaState; } |
| 332 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 333 | inline float getXOffset() const { return mXOffset; } |
| 334 | |
| 335 | inline float getYOffset() const { return mYOffset; } |
| 336 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 337 | inline float getXPrecision() const { return mXPrecision; } |
| 338 | |
| 339 | inline float getYPrecision() const { return mYPrecision; } |
| 340 | |
| 341 | inline nsecs_t getDownTime() const { return mDownTime; } |
| 342 | |
| 343 | inline size_t getPointerCount() const { return mPointerIds.size(); } |
| 344 | |
| 345 | inline int32_t getPointerId(size_t pointerIndex) const { return mPointerIds[pointerIndex]; } |
| 346 | |
| 347 | inline nsecs_t getEventTime() const { return mSampleEventTimes[getHistorySize()]; } |
| 348 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 349 | const PointerCoords* getRawPointerCoords(size_t pointerIndex) const; |
| 350 | |
| 351 | float getRawAxisValue(int32_t axis, size_t pointerIndex) const; |
| 352 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 353 | inline float getRawX(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 354 | return getRawAxisValue(AINPUT_MOTION_AXIS_X, pointerIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 355 | } |
| 356 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 357 | inline float getRawY(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 358 | return getRawAxisValue(AINPUT_MOTION_AXIS_Y, pointerIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 359 | } |
| 360 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 361 | float getAxisValue(int32_t axis, size_t pointerIndex) const; |
| 362 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 363 | inline float getX(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 364 | return getAxisValue(AINPUT_MOTION_AXIS_X, pointerIndex); |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 365 | } |
| 366 | |
| 367 | inline float getY(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 368 | return getAxisValue(AINPUT_MOTION_AXIS_Y, pointerIndex); |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 369 | } |
| 370 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 371 | inline float getPressure(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 372 | return getAxisValue(AINPUT_MOTION_AXIS_PRESSURE, pointerIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 373 | } |
| 374 | |
| 375 | inline float getSize(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 376 | return getAxisValue(AINPUT_MOTION_AXIS_SIZE, pointerIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 377 | } |
| 378 | |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 379 | inline float getTouchMajor(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 380 | return getAxisValue(AINPUT_MOTION_AXIS_TOUCH_MAJOR, pointerIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 381 | } |
| 382 | |
| 383 | inline float getTouchMinor(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 384 | return getAxisValue(AINPUT_MOTION_AXIS_TOUCH_MINOR, pointerIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 385 | } |
| 386 | |
| 387 | inline float getToolMajor(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 388 | return getAxisValue(AINPUT_MOTION_AXIS_TOOL_MAJOR, pointerIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 389 | } |
| 390 | |
| 391 | inline float getToolMinor(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 392 | return getAxisValue(AINPUT_MOTION_AXIS_TOOL_MINOR, pointerIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 393 | } |
| 394 | |
| 395 | inline float getOrientation(size_t pointerIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 396 | return getAxisValue(AINPUT_MOTION_AXIS_ORIENTATION, pointerIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 397 | } |
| 398 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 399 | inline size_t getHistorySize() const { return mSampleEventTimes.size() - 1; } |
| 400 | |
| 401 | inline nsecs_t getHistoricalEventTime(size_t historicalIndex) const { |
| 402 | return mSampleEventTimes[historicalIndex]; |
| 403 | } |
| 404 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 405 | const PointerCoords* getHistoricalRawPointerCoords( |
| 406 | size_t pointerIndex, size_t historicalIndex) const; |
| 407 | |
| 408 | float getHistoricalRawAxisValue(int32_t axis, size_t pointerIndex, |
| 409 | size_t historicalIndex) const; |
| 410 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 411 | inline float getHistoricalRawX(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 412 | return getHistoricalRawAxisValue( |
| 413 | AINPUT_MOTION_AXIS_X, pointerIndex, historicalIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 414 | } |
| 415 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 416 | inline float getHistoricalRawY(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 417 | return getHistoricalRawAxisValue( |
| 418 | AINPUT_MOTION_AXIS_Y, pointerIndex, historicalIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 419 | } |
| 420 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 421 | float getHistoricalAxisValue(int32_t axis, size_t pointerIndex, size_t historicalIndex) const; |
| 422 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 423 | inline float getHistoricalX(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 424 | return getHistoricalAxisValue( |
| 425 | AINPUT_MOTION_AXIS_X, pointerIndex, historicalIndex); |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 426 | } |
| 427 | |
| 428 | inline float getHistoricalY(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 429 | return getHistoricalAxisValue( |
| 430 | AINPUT_MOTION_AXIS_Y, pointerIndex, historicalIndex); |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 431 | } |
| 432 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 433 | inline float getHistoricalPressure(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 434 | return getHistoricalAxisValue( |
| 435 | AINPUT_MOTION_AXIS_PRESSURE, pointerIndex, historicalIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 436 | } |
| 437 | |
| 438 | inline float getHistoricalSize(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 439 | return getHistoricalAxisValue( |
| 440 | AINPUT_MOTION_AXIS_SIZE, pointerIndex, historicalIndex); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 441 | } |
| 442 | |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 443 | inline float getHistoricalTouchMajor(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 444 | return getHistoricalAxisValue( |
| 445 | AINPUT_MOTION_AXIS_TOUCH_MAJOR, pointerIndex, historicalIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 446 | } |
| 447 | |
| 448 | inline float getHistoricalTouchMinor(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 449 | return getHistoricalAxisValue( |
| 450 | AINPUT_MOTION_AXIS_TOUCH_MINOR, pointerIndex, historicalIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 451 | } |
| 452 | |
| 453 | inline float getHistoricalToolMajor(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 454 | return getHistoricalAxisValue( |
| 455 | AINPUT_MOTION_AXIS_TOOL_MAJOR, pointerIndex, historicalIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 456 | } |
| 457 | |
| 458 | inline float getHistoricalToolMinor(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 459 | return getHistoricalAxisValue( |
| 460 | AINPUT_MOTION_AXIS_TOOL_MINOR, pointerIndex, historicalIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 461 | } |
| 462 | |
| 463 | inline float getHistoricalOrientation(size_t pointerIndex, size_t historicalIndex) const { |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 464 | return getHistoricalAxisValue( |
| 465 | AINPUT_MOTION_AXIS_ORIENTATION, pointerIndex, historicalIndex); |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 466 | } |
| 467 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 468 | void initialize( |
| 469 | int32_t deviceId, |
Jeff Brown | c5ed591 | 2010-07-14 18:48:53 -0700 | [diff] [blame] | 470 | int32_t source, |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 471 | int32_t action, |
Jeff Brown | 85a3176 | 2010-09-01 17:01:00 -0700 | [diff] [blame] | 472 | int32_t flags, |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 473 | int32_t edgeFlags, |
| 474 | int32_t metaState, |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 475 | float xOffset, |
| 476 | float yOffset, |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 477 | float xPrecision, |
| 478 | float yPrecision, |
| 479 | nsecs_t downTime, |
| 480 | nsecs_t eventTime, |
| 481 | size_t pointerCount, |
| 482 | const int32_t* pointerIds, |
| 483 | const PointerCoords* pointerCoords); |
| 484 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 485 | void copyFrom(const MotionEvent* other, bool keepHistory); |
| 486 | |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 487 | void addSample( |
| 488 | nsecs_t eventTime, |
| 489 | const PointerCoords* pointerCoords); |
| 490 | |
| 491 | void offsetLocation(float xOffset, float yOffset); |
| 492 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 493 | void scale(float scaleFactor); |
| 494 | |
| 495 | #ifdef HAVE_ANDROID_OS |
| 496 | void transform(const SkMatrix* matrix); |
| 497 | |
| 498 | status_t readFromParcel(Parcel* parcel); |
| 499 | status_t writeToParcel(Parcel* parcel) const; |
| 500 | #endif |
| 501 | |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 502 | // Low-level accessors. |
| 503 | inline const int32_t* getPointerIds() const { return mPointerIds.array(); } |
| 504 | inline const nsecs_t* getSampleEventTimes() const { return mSampleEventTimes.array(); } |
| 505 | inline const PointerCoords* getSamplePointerCoords() const { |
| 506 | return mSamplePointerCoords.array(); |
| 507 | } |
| 508 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 509 | protected: |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 510 | int32_t mAction; |
Jeff Brown | 85a3176 | 2010-09-01 17:01:00 -0700 | [diff] [blame] | 511 | int32_t mFlags; |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 512 | int32_t mEdgeFlags; |
| 513 | int32_t mMetaState; |
Jeff Brown | 5c225b1 | 2010-06-16 01:53:36 -0700 | [diff] [blame] | 514 | float mXOffset; |
| 515 | float mYOffset; |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 516 | float mXPrecision; |
| 517 | float mYPrecision; |
| 518 | nsecs_t mDownTime; |
| 519 | Vector<int32_t> mPointerIds; |
| 520 | Vector<nsecs_t> mSampleEventTimes; |
| 521 | Vector<PointerCoords> mSamplePointerCoords; |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 522 | }; |
| 523 | |
| 524 | /* |
| 525 | * Input event factory. |
| 526 | */ |
| 527 | class InputEventFactoryInterface { |
| 528 | protected: |
| 529 | virtual ~InputEventFactoryInterface() { } |
| 530 | |
| 531 | public: |
| 532 | InputEventFactoryInterface() { } |
| 533 | |
| 534 | virtual KeyEvent* createKeyEvent() = 0; |
| 535 | virtual MotionEvent* createMotionEvent() = 0; |
| 536 | }; |
| 537 | |
| 538 | /* |
| 539 | * A simple input event factory implementation that uses a single preallocated instance |
| 540 | * of each type of input event that are reused for each request. |
| 541 | */ |
| 542 | class PreallocatedInputEventFactory : public InputEventFactoryInterface { |
| 543 | public: |
| 544 | PreallocatedInputEventFactory() { } |
| 545 | virtual ~PreallocatedInputEventFactory() { } |
| 546 | |
| 547 | virtual KeyEvent* createKeyEvent() { return & mKeyEvent; } |
| 548 | virtual MotionEvent* createMotionEvent() { return & mMotionEvent; } |
| 549 | |
| 550 | private: |
| 551 | KeyEvent mKeyEvent; |
| 552 | MotionEvent mMotionEvent; |
| 553 | }; |
| 554 | |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 555 | /* |
| 556 | * Describes the characteristics and capabilities of an input device. |
| 557 | */ |
| 558 | class InputDeviceInfo { |
| 559 | public: |
| 560 | InputDeviceInfo(); |
| 561 | InputDeviceInfo(const InputDeviceInfo& other); |
| 562 | ~InputDeviceInfo(); |
| 563 | |
| 564 | struct MotionRange { |
| 565 | float min; |
| 566 | float max; |
| 567 | float flat; |
| 568 | float fuzz; |
| 569 | }; |
| 570 | |
| 571 | void initialize(int32_t id, const String8& name); |
| 572 | |
| 573 | inline int32_t getId() const { return mId; } |
| 574 | inline const String8 getName() const { return mName; } |
| 575 | inline uint32_t getSources() const { return mSources; } |
| 576 | |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 577 | const MotionRange* getMotionRange(int32_t axis) const; |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 578 | |
| 579 | void addSource(uint32_t source); |
Jeff Brown | 91c69ab | 2011-02-14 17:03:18 -0800 | [diff] [blame] | 580 | void addMotionRange(int32_t axis, float min, float max, float flat, float fuzz); |
| 581 | void addMotionRange(int32_t axis, const MotionRange& range); |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 582 | |
| 583 | inline void setKeyboardType(int32_t keyboardType) { mKeyboardType = keyboardType; } |
| 584 | inline int32_t getKeyboardType() const { return mKeyboardType; } |
| 585 | |
Jeff Brown | 8d60866 | 2010-08-30 03:02:23 -0700 | [diff] [blame] | 586 | inline const KeyedVector<int32_t, MotionRange> getMotionRanges() const { |
| 587 | return mMotionRanges; |
| 588 | } |
| 589 | |
Jeff Brown | 6d0fec2 | 2010-07-23 21:28:06 -0700 | [diff] [blame] | 590 | private: |
| 591 | int32_t mId; |
| 592 | String8 mName; |
| 593 | uint32_t mSources; |
| 594 | int32_t mKeyboardType; |
| 595 | |
| 596 | KeyedVector<int32_t, MotionRange> mMotionRanges; |
| 597 | }; |
| 598 | |
Jeff Brown | 9065504 | 2010-12-02 13:50:46 -0800 | [diff] [blame] | 599 | /* |
| 600 | * Identifies a device. |
| 601 | */ |
| 602 | struct InputDeviceIdentifier { |
| 603 | inline InputDeviceIdentifier() : |
| 604 | bus(0), vendor(0), product(0), version(0) { |
| 605 | } |
| 606 | |
| 607 | String8 name; |
| 608 | String8 location; |
| 609 | String8 uniqueId; |
| 610 | uint16_t bus; |
| 611 | uint16_t vendor; |
| 612 | uint16_t product; |
| 613 | uint16_t version; |
| 614 | }; |
| 615 | |
Jeff Brown | 47e6b1b | 2010-11-29 17:37:49 -0800 | [diff] [blame] | 616 | /* Types of input device configuration files. */ |
| 617 | enum InputDeviceConfigurationFileType { |
| 618 | INPUT_DEVICE_CONFIGURATION_FILE_TYPE_CONFIGURATION = 0, /* .idc file */ |
| 619 | INPUT_DEVICE_CONFIGURATION_FILE_TYPE_KEY_LAYOUT = 1, /* .kl file */ |
| 620 | INPUT_DEVICE_CONFIGURATION_FILE_TYPE_KEY_CHARACTER_MAP = 2, /* .kcm file */ |
| 621 | }; |
| 622 | |
| 623 | /* |
Jeff Brown | 9065504 | 2010-12-02 13:50:46 -0800 | [diff] [blame] | 624 | * Gets the path of an input device configuration file, if one is available. |
Jeff Brown | 1f24510 | 2010-11-18 20:53:46 -0800 | [diff] [blame] | 625 | * Considers both system provided and user installed configuration files. |
Jeff Brown | 47e6b1b | 2010-11-29 17:37:49 -0800 | [diff] [blame] | 626 | * |
Jeff Brown | 9065504 | 2010-12-02 13:50:46 -0800 | [diff] [blame] | 627 | * The device identifier is used to construct several default configuration file |
| 628 | * names to try based on the device name, vendor, product, and version. |
| 629 | * |
Jeff Brown | 47e6b1b | 2010-11-29 17:37:49 -0800 | [diff] [blame] | 630 | * Returns an empty string if not found. |
| 631 | */ |
Jeff Brown | 9065504 | 2010-12-02 13:50:46 -0800 | [diff] [blame] | 632 | extern String8 getInputDeviceConfigurationFilePathByDeviceIdentifier( |
| 633 | const InputDeviceIdentifier& deviceIdentifier, |
| 634 | InputDeviceConfigurationFileType type); |
| 635 | |
| 636 | /* |
| 637 | * Gets the path of an input device configuration file, if one is available. |
| 638 | * Considers both system provided and user installed configuration files. |
| 639 | * |
| 640 | * The name is case-sensitive and is used to construct the filename to resolve. |
| 641 | * All characters except 'a'-'z', 'A'-'Z', '0'-'9', '-', and '_' are replaced by underscores. |
| 642 | * |
| 643 | * Returns an empty string if not found. |
| 644 | */ |
| 645 | extern String8 getInputDeviceConfigurationFilePathByName( |
Jeff Brown | 47e6b1b | 2010-11-29 17:37:49 -0800 | [diff] [blame] | 646 | const String8& name, InputDeviceConfigurationFileType type); |
Jeff Brown | 46b9ac0 | 2010-04-22 18:58:52 -0700 | [diff] [blame] | 647 | |
| 648 | } // namespace android |
| 649 | |
| 650 | #endif // _UI_INPUT_H |