Input.h revision 313eff7bb7e5eedbdbea805343451fd473241266
10b167267bda99b68346045ccab14e810121d5de4Glenn Kasten/* 20b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Copyright (C) 2010 The Android Open Source Project 30b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * 40b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Licensed under the Apache License, Version 2.0 (the "License"); 50b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * you may not use this file except in compliance with the License. 60b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * You may obtain a copy of the License at 70b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * 80b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * http://www.apache.org/licenses/LICENSE-2.0 90b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * 100b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Unless required by applicable law or agreed to in writing, software 110b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * distributed under the License is distributed on an "AS IS" BASIS, 120b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 130b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * See the License for the specific language governing permissions and 140b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * limitations under the License. 150b167267bda99b68346045ccab14e810121d5de4Glenn Kasten */ 160b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 170b167267bda99b68346045ccab14e810121d5de4Glenn Kasten#ifndef _LIBINPUT_INPUT_H 180b167267bda99b68346045ccab14e810121d5de4Glenn Kasten#define _LIBINPUT_INPUT_H 190b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 200b167267bda99b68346045ccab14e810121d5de4Glenn Kasten/** 21ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * Native input event structures. 220b167267bda99b68346045ccab14e810121d5de4Glenn Kasten */ 230b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 240b167267bda99b68346045ccab14e810121d5de4Glenn Kasten#include <android/input.h> 25ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#include <utils/Vector.h> 26ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#include <utils/KeyedVector.h> 27ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#include <utils/Timers.h> 28ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#include <utils/RefBase.h> 29ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#include <utils/String8.h> 30a3080daa505f91df51a808c85ddb37c48745bf7cGlenn Kasten 31a3080daa505f91df51a808c85ddb37c48745bf7cGlenn Kasten/* 32a3080daa505f91df51a808c85ddb37c48745bf7cGlenn Kasten * Additional private constants not defined in ndk/ui/input.h. 33a3080daa505f91df51a808c85ddb37c48745bf7cGlenn Kasten */ 34ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastenenum { 35ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten /* Signifies that the key is being predispatched */ 36ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten AKEY_EVENT_FLAG_PREDISPATCH = 0x20000000, 37ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 380b167267bda99b68346045ccab14e810121d5de4Glenn Kasten /* Private control to determine when an app is tracking a key sequence. */ 390b167267bda99b68346045ccab14e810121d5de4Glenn Kasten AKEY_EVENT_FLAG_START_TRACKING = 0x40000000, 40ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 41a438eb1cf1ae602afab00336528dd230bd929206Glenn Kasten /* Key event is inconsistent with previously sent key events. */ 42a438eb1cf1ae602afab00336528dd230bd929206Glenn Kasten AKEY_EVENT_FLAG_TAINTED = 0x80000000, 430b167267bda99b68346045ccab14e810121d5de4Glenn Kasten}; 44ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 45ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastenenum { 460b167267bda99b68346045ccab14e810121d5de4Glenn Kasten /* Motion event is inconsistent with previously sent motion events. */ 470b167267bda99b68346045ccab14e810121d5de4Glenn Kasten AMOTION_EVENT_FLAG_TAINTED = 0x80000000, 480b167267bda99b68346045ccab14e810121d5de4Glenn Kasten}; 490b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 500b167267bda99b68346045ccab14e810121d5de4Glenn Kastenenum { 51ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten /* Used when a motion event is not associated with any display. 52a3080daa505f91df51a808c85ddb37c48745bf7cGlenn Kasten * Typically used for non-pointer events. */ 53ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten ADISPLAY_ID_NONE = -1, 54ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 55ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten /* The default display id. */ 56a3080daa505f91df51a808c85ddb37c48745bf7cGlenn Kasten ADISPLAY_ID_DEFAULT = 0, 57ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten}; 580b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 590b167267bda99b68346045ccab14e810121d5de4Glenn Kastenenum { 60ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten /* 61ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * Indicates that an input device has switches. 620b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * This input source flag is hidden from the API because switches are only used by the system 63ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * and applications have no way to interact with them. 64ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten */ 650b167267bda99b68346045ccab14e810121d5de4Glenn Kasten AINPUT_SOURCE_SWITCH = 0x80000000, 660b167267bda99b68346045ccab14e810121d5de4Glenn Kasten}; 67ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 680b167267bda99b68346045ccab14e810121d5de4Glenn Kasten/* 690b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * SystemUiVisibility constants from View. 700b167267bda99b68346045ccab14e810121d5de4Glenn Kasten */ 71ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastenenum { 72ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten ASYSTEM_UI_VISIBILITY_STATUS_BAR_VISIBLE = 0, 73ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten ASYSTEM_UI_VISIBILITY_STATUS_BAR_HIDDEN = 0x00000001, 74ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten}; 75ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 76ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten/* 77ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * Maximum number of pointers supported per motion event. 78ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * Smallest number of pointers is 1. 79ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * (We want at least 10 but some touch controllers obstensibly configured for 10 pointers 80ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * will occasionally emit 11. There is not much harm making this constant bigger.) 810b167267bda99b68346045ccab14e810121d5de4Glenn Kasten */ 820b167267bda99b68346045ccab14e810121d5de4Glenn Kasten#define MAX_POINTERS 16 83ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 840b167267bda99b68346045ccab14e810121d5de4Glenn Kasten/* 850b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Maximum pointer id value supported in a motion event. 860b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Smallest pointer id is 0. 87ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * (This is limited by our use of BitSet32 to track pointer assignments.) 88ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten */ 89ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#define MAX_POINTER_ID 31 90ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 91ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten/* 92ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * Declare a concrete type for the NDK's input event forward declaration. 93ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten */ 94ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastenstruct AInputEvent { 95ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten virtual ~AInputEvent() { } 96ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten}; 97ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 98ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten/* 990b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Declare a concrete type for the NDK's input device forward declaration. 1000b167267bda99b68346045ccab14e810121d5de4Glenn Kasten */ 101ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastenstruct AInputDevice { 102b0ab2dee391dd2cb257faeaba252ee6ecccc5f03Glenn Kasten virtual ~AInputDevice() { } 103d2a7f0d6883a6d3835642e7b282f05ed1c54fe63Glenn Kasten}; 1040b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 105ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 106ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastennamespace android { 107bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten 10840d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten#ifdef HAVE_ANDROID_OS 1090b167267bda99b68346045ccab14e810121d5de4Glenn Kastenclass Parcel; 1100b167267bda99b68346045ccab14e810121d5de4Glenn Kasten#endif 111ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 1120b167267bda99b68346045ccab14e810121d5de4Glenn Kasten/* 1130b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Flags that flow alongside events in the input dispatch system to help with certain 114bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten * policy decisions such as waking from device sleep. 115ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * 116ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * These flags are also defined in frameworks/base/core/java/android/view/WindowManagerPolicy.java. 117ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten */ 118ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kastenenum { 119ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten /* These flags originate in RawEvents and are generally set in the key map. 120ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten * NOTE: If you edit these flags, also edit labels in KeycodeLabels.h. */ 121ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 122ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten POLICY_FLAG_WAKE = 0x00000001, 1230b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_WAKE_DROPPED = 0x00000002, 124bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten POLICY_FLAG_SHIFT = 0x00000004, 1250b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_CAPS_LOCK = 0x00000008, 126ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten POLICY_FLAG_ALT = 0x00000010, 1270b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_ALT_GR = 0x00000020, 1280b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_MENU = 0x00000040, 129bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten POLICY_FLAG_LAUNCHER = 0x00000080, 1300b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_VIRTUAL = 0x00000100, 1310b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_FUNCTION = 0x00000200, 1320b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 133ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten POLICY_FLAG_RAW_MASK = 0x0000ffff, 134ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 1350b167267bda99b68346045ccab14e810121d5de4Glenn Kasten /* These flags are set by the input dispatcher. */ 1360b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 1370b167267bda99b68346045ccab14e810121d5de4Glenn Kasten // Indicates that the input event was injected. 1380b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_INJECTED = 0x01000000, 139ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 140ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // Indicates that the input event is from a trusted source such as a directly attached 1410b167267bda99b68346045ccab14e810121d5de4Glenn Kasten // input device or an application with system-wide event injection permission. 1420b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_TRUSTED = 0x02000000, 143ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 144b0ab2dee391dd2cb257faeaba252ee6ecccc5f03Glenn Kasten // Indicates that the input event has passed through an input filter. 145d2a7f0d6883a6d3835642e7b282f05ed1c54fe63Glenn Kasten POLICY_FLAG_FILTERED = 0x04000000, 1460b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 147ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // Disables automatic key repeating behavior. 148ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten POLICY_FLAG_DISABLE_KEY_REPEAT = 0x08000000, 149bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten 15040d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten /* These flags are set by the input reader policy as it intercepts each event. */ 1510b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 1520b167267bda99b68346045ccab14e810121d5de4Glenn Kasten // Indicates that the screen was off when the event was received and the event 153ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // should wake the device. 1540b167267bda99b68346045ccab14e810121d5de4Glenn Kasten POLICY_FLAG_WOKE_HERE = 0x10000000, 1550b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 156bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten // Indicates that the screen was dim when the event was received and the event 157ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // should brighten the device. 158ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten POLICY_FLAG_BRIGHT_HERE = 0x20000000, 159ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 160ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // Indicates that the event should be dispatched to applications. 161ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // The input event should still be sent to the InputDispatcher so that it can see all 162ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // input events received include those that it will not deliver. 163ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten POLICY_FLAG_PASS_TO_USER = 0x40000000, 164ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten}; 1650b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 166bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten/* 1670b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Pointer coordinate data. 168ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten */ 1690b167267bda99b68346045ccab14e810121d5de4Glenn Kastenstruct PointerCoords { 1700b167267bda99b68346045ccab14e810121d5de4Glenn Kasten enum { MAX_AXES = 14 }; // 14 so that sizeof(PointerCoords) == 64 171bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten 1720b167267bda99b68346045ccab14e810121d5de4Glenn Kasten // Bitfield of axes that are present in this structure. 1730b167267bda99b68346045ccab14e810121d5de4Glenn Kasten uint64_t bits; 1740b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 175ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // Values of axes that are stored in this structure packed in order by axis id 176ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten // for each axis that is present in the structure according to 'bits'. 1770b167267bda99b68346045ccab14e810121d5de4Glenn Kasten float values[MAX_AXES]; 1780b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 1790b167267bda99b68346045ccab14e810121d5de4Glenn Kasten inline void clear() { 1800b167267bda99b68346045ccab14e810121d5de4Glenn Kasten bits = 0; 181ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten } 182ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 1830b167267bda99b68346045ccab14e810121d5de4Glenn Kasten float getAxisValue(int32_t axis) const; 1840b167267bda99b68346045ccab14e810121d5de4Glenn Kasten status_t setAxisValue(int32_t axis, float value); 185ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 1860b167267bda99b68346045ccab14e810121d5de4Glenn Kasten void scale(float scale); 1870b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 1880b167267bda99b68346045ccab14e810121d5de4Glenn Kasten inline float getX() const { 189ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten return getAxisValue(AMOTION_EVENT_AXIS_X); 190ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten } 191ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten 192ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten inline float getY() const { 193ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten return getAxisValue(AMOTION_EVENT_AXIS_Y); 194bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten } 195bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten 196ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#ifdef HAVE_ANDROID_OS 197ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten status_t readFromParcel(Parcel* parcel); 198ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten status_t writeToParcel(Parcel* parcel) const; 199ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten#endif 2000b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 2010b167267bda99b68346045ccab14e810121d5de4Glenn Kasten bool operator==(const PointerCoords& other) const; 202ed46c29d6a09112dbbf584c82953f63289596fd6Glenn Kasten inline bool operator!=(const PointerCoords& other) const { 2030b167267bda99b68346045ccab14e810121d5de4Glenn Kasten return !(*this == other); 2040b167267bda99b68346045ccab14e810121d5de4Glenn Kasten } 2050b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 2060b167267bda99b68346045ccab14e810121d5de4Glenn Kasten void copyFrom(const PointerCoords& other); 2070b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 2080b167267bda99b68346045ccab14e810121d5de4Glenn Kastenprivate: 2090b167267bda99b68346045ccab14e810121d5de4Glenn Kasten void tooManyAxes(int axis); 2100b167267bda99b68346045ccab14e810121d5de4Glenn Kasten}; 2110b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 2120b167267bda99b68346045ccab14e810121d5de4Glenn Kasten/* 2130b167267bda99b68346045ccab14e810121d5de4Glenn Kasten * Pointer property data. 2140b167267bda99b68346045ccab14e810121d5de4Glenn Kasten */ 215bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kastenstruct PointerProperties { 216bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten // The id of the pointer. 2170b167267bda99b68346045ccab14e810121d5de4Glenn Kasten int32_t id; 21840d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten 21940d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten // The pointer tool type. 22040d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten int32_t toolType; 221bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten 22240d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten inline void clear() { 22340d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten id = -1; 22440d1c40832a448e23d0bb37512aee53222575c2eGlenn Kasten toolType = 0; 225bcc5c7225e3b7a1dbf2e9e830987f69167acf06fGlenn Kasten } 2260b167267bda99b68346045ccab14e810121d5de4Glenn Kasten 227 bool operator==(const PointerProperties& other) const; 228 inline bool operator!=(const PointerProperties& other) const { 229 return !(*this == other); 230 } 231 232 void copyFrom(const PointerProperties& other); 233}; 234 235/* 236 * Input events. 237 */ 238class InputEvent : public AInputEvent { 239public: 240 virtual ~InputEvent() { } 241 242 virtual int32_t getType() const = 0; 243 244 inline int32_t getDeviceId() const { return mDeviceId; } 245 246 inline int32_t getSource() const { return mSource; } 247 248 inline void setSource(int32_t source) { mSource = source; } 249 250protected: 251 void initialize(int32_t deviceId, int32_t source); 252 void initialize(const InputEvent& from); 253 254 int32_t mDeviceId; 255 int32_t mSource; 256}; 257 258/* 259 * Key events. 260 */ 261class KeyEvent : public InputEvent { 262public: 263 virtual ~KeyEvent() { } 264 265 virtual int32_t getType() const { return AINPUT_EVENT_TYPE_KEY; } 266 267 inline int32_t getAction() const { return mAction; } 268 269 inline int32_t getFlags() const { return mFlags; } 270 271 inline void setFlags(int32_t flags) { mFlags = flags; } 272 273 inline int32_t getKeyCode() const { return mKeyCode; } 274 275 inline int32_t getScanCode() const { return mScanCode; } 276 277 inline int32_t getMetaState() const { return mMetaState; } 278 279 inline int32_t getRepeatCount() const { return mRepeatCount; } 280 281 inline nsecs_t getDownTime() const { return mDownTime; } 282 283 inline nsecs_t getEventTime() const { return mEventTime; } 284 285 // Return true if this event may have a default action implementation. 286 static bool hasDefaultAction(int32_t keyCode); 287 bool hasDefaultAction() const; 288 289 // Return true if this event represents a system key. 290 static bool isSystemKey(int32_t keyCode); 291 bool isSystemKey() const; 292 293 void initialize( 294 int32_t deviceId, 295 int32_t source, 296 int32_t action, 297 int32_t flags, 298 int32_t keyCode, 299 int32_t scanCode, 300 int32_t metaState, 301 int32_t repeatCount, 302 nsecs_t downTime, 303 nsecs_t eventTime); 304 void initialize(const KeyEvent& from); 305 306protected: 307 int32_t mAction; 308 int32_t mFlags; 309 int32_t mKeyCode; 310 int32_t mScanCode; 311 int32_t mMetaState; 312 int32_t mRepeatCount; 313 nsecs_t mDownTime; 314 nsecs_t mEventTime; 315}; 316 317/* 318 * Motion events. 319 */ 320class MotionEvent : public InputEvent { 321public: 322 virtual ~MotionEvent() { } 323 324 virtual int32_t getType() const { return AINPUT_EVENT_TYPE_MOTION; } 325 326 inline int32_t getAction() const { return mAction; } 327 328 inline int32_t getActionMasked() const { return mAction & AMOTION_EVENT_ACTION_MASK; } 329 330 inline int32_t getActionIndex() const { 331 return (mAction & AMOTION_EVENT_ACTION_POINTER_INDEX_MASK) 332 >> AMOTION_EVENT_ACTION_POINTER_INDEX_SHIFT; 333 } 334 335 inline void setAction(int32_t action) { mAction = action; } 336 337 inline int32_t getFlags() const { return mFlags; } 338 339 inline void setFlags(int32_t flags) { mFlags = flags; } 340 341 inline int32_t getEdgeFlags() const { return mEdgeFlags; } 342 343 inline void setEdgeFlags(int32_t edgeFlags) { mEdgeFlags = edgeFlags; } 344 345 inline int32_t getMetaState() const { return mMetaState; } 346 347 inline void setMetaState(int32_t metaState) { mMetaState = metaState; } 348 349 inline int32_t getButtonState() const { return mButtonState; } 350 351 inline float getXOffset() const { return mXOffset; } 352 353 inline float getYOffset() const { return mYOffset; } 354 355 inline float getXPrecision() const { return mXPrecision; } 356 357 inline float getYPrecision() const { return mYPrecision; } 358 359 inline nsecs_t getDownTime() const { return mDownTime; } 360 361 inline void setDownTime(nsecs_t downTime) { mDownTime = downTime; } 362 363 inline size_t getPointerCount() const { return mPointerProperties.size(); } 364 365 inline const PointerProperties* getPointerProperties(size_t pointerIndex) const { 366 return &mPointerProperties[pointerIndex]; 367 } 368 369 inline int32_t getPointerId(size_t pointerIndex) const { 370 return mPointerProperties[pointerIndex].id; 371 } 372 373 inline int32_t getToolType(size_t pointerIndex) const { 374 return mPointerProperties[pointerIndex].toolType; 375 } 376 377 inline nsecs_t getEventTime() const { return mSampleEventTimes[getHistorySize()]; } 378 379 const PointerCoords* getRawPointerCoords(size_t pointerIndex) const; 380 381 float getRawAxisValue(int32_t axis, size_t pointerIndex) const; 382 383 inline float getRawX(size_t pointerIndex) const { 384 return getRawAxisValue(AMOTION_EVENT_AXIS_X, pointerIndex); 385 } 386 387 inline float getRawY(size_t pointerIndex) const { 388 return getRawAxisValue(AMOTION_EVENT_AXIS_Y, pointerIndex); 389 } 390 391 float getAxisValue(int32_t axis, size_t pointerIndex) const; 392 393 inline float getX(size_t pointerIndex) const { 394 return getAxisValue(AMOTION_EVENT_AXIS_X, pointerIndex); 395 } 396 397 inline float getY(size_t pointerIndex) const { 398 return getAxisValue(AMOTION_EVENT_AXIS_Y, pointerIndex); 399 } 400 401 inline float getPressure(size_t pointerIndex) const { 402 return getAxisValue(AMOTION_EVENT_AXIS_PRESSURE, pointerIndex); 403 } 404 405 inline float getSize(size_t pointerIndex) const { 406 return getAxisValue(AMOTION_EVENT_AXIS_SIZE, pointerIndex); 407 } 408 409 inline float getTouchMajor(size_t pointerIndex) const { 410 return getAxisValue(AMOTION_EVENT_AXIS_TOUCH_MAJOR, pointerIndex); 411 } 412 413 inline float getTouchMinor(size_t pointerIndex) const { 414 return getAxisValue(AMOTION_EVENT_AXIS_TOUCH_MINOR, pointerIndex); 415 } 416 417 inline float getToolMajor(size_t pointerIndex) const { 418 return getAxisValue(AMOTION_EVENT_AXIS_TOOL_MAJOR, pointerIndex); 419 } 420 421 inline float getToolMinor(size_t pointerIndex) const { 422 return getAxisValue(AMOTION_EVENT_AXIS_TOOL_MINOR, pointerIndex); 423 } 424 425 inline float getOrientation(size_t pointerIndex) const { 426 return getAxisValue(AMOTION_EVENT_AXIS_ORIENTATION, pointerIndex); 427 } 428 429 inline size_t getHistorySize() const { return mSampleEventTimes.size() - 1; } 430 431 inline nsecs_t getHistoricalEventTime(size_t historicalIndex) const { 432 return mSampleEventTimes[historicalIndex]; 433 } 434 435 const PointerCoords* getHistoricalRawPointerCoords( 436 size_t pointerIndex, size_t historicalIndex) const; 437 438 float getHistoricalRawAxisValue(int32_t axis, size_t pointerIndex, 439 size_t historicalIndex) const; 440 441 inline float getHistoricalRawX(size_t pointerIndex, size_t historicalIndex) const { 442 return getHistoricalRawAxisValue( 443 AMOTION_EVENT_AXIS_X, pointerIndex, historicalIndex); 444 } 445 446 inline float getHistoricalRawY(size_t pointerIndex, size_t historicalIndex) const { 447 return getHistoricalRawAxisValue( 448 AMOTION_EVENT_AXIS_Y, pointerIndex, historicalIndex); 449 } 450 451 float getHistoricalAxisValue(int32_t axis, size_t pointerIndex, size_t historicalIndex) const; 452 453 inline float getHistoricalX(size_t pointerIndex, size_t historicalIndex) const { 454 return getHistoricalAxisValue( 455 AMOTION_EVENT_AXIS_X, pointerIndex, historicalIndex); 456 } 457 458 inline float getHistoricalY(size_t pointerIndex, size_t historicalIndex) const { 459 return getHistoricalAxisValue( 460 AMOTION_EVENT_AXIS_Y, pointerIndex, historicalIndex); 461 } 462 463 inline float getHistoricalPressure(size_t pointerIndex, size_t historicalIndex) const { 464 return getHistoricalAxisValue( 465 AMOTION_EVENT_AXIS_PRESSURE, pointerIndex, historicalIndex); 466 } 467 468 inline float getHistoricalSize(size_t pointerIndex, size_t historicalIndex) const { 469 return getHistoricalAxisValue( 470 AMOTION_EVENT_AXIS_SIZE, pointerIndex, historicalIndex); 471 } 472 473 inline float getHistoricalTouchMajor(size_t pointerIndex, size_t historicalIndex) const { 474 return getHistoricalAxisValue( 475 AMOTION_EVENT_AXIS_TOUCH_MAJOR, pointerIndex, historicalIndex); 476 } 477 478 inline float getHistoricalTouchMinor(size_t pointerIndex, size_t historicalIndex) const { 479 return getHistoricalAxisValue( 480 AMOTION_EVENT_AXIS_TOUCH_MINOR, pointerIndex, historicalIndex); 481 } 482 483 inline float getHistoricalToolMajor(size_t pointerIndex, size_t historicalIndex) const { 484 return getHistoricalAxisValue( 485 AMOTION_EVENT_AXIS_TOOL_MAJOR, pointerIndex, historicalIndex); 486 } 487 488 inline float getHistoricalToolMinor(size_t pointerIndex, size_t historicalIndex) const { 489 return getHistoricalAxisValue( 490 AMOTION_EVENT_AXIS_TOOL_MINOR, pointerIndex, historicalIndex); 491 } 492 493 inline float getHistoricalOrientation(size_t pointerIndex, size_t historicalIndex) const { 494 return getHistoricalAxisValue( 495 AMOTION_EVENT_AXIS_ORIENTATION, pointerIndex, historicalIndex); 496 } 497 498 ssize_t findPointerIndex(int32_t pointerId) const; 499 500 void initialize( 501 int32_t deviceId, 502 int32_t source, 503 int32_t action, 504 int32_t flags, 505 int32_t edgeFlags, 506 int32_t metaState, 507 int32_t buttonState, 508 float xOffset, 509 float yOffset, 510 float xPrecision, 511 float yPrecision, 512 nsecs_t downTime, 513 nsecs_t eventTime, 514 size_t pointerCount, 515 const PointerProperties* pointerProperties, 516 const PointerCoords* pointerCoords); 517 518 void copyFrom(const MotionEvent* other, bool keepHistory); 519 520 void addSample( 521 nsecs_t eventTime, 522 const PointerCoords* pointerCoords); 523 524 void offsetLocation(float xOffset, float yOffset); 525 526 void scale(float scaleFactor); 527 528 // Apply 3x3 perspective matrix transformation. 529 // Matrix is in row-major form and compatible with SkMatrix. 530 void transform(const float matrix[9]); 531 532#ifdef HAVE_ANDROID_OS 533 status_t readFromParcel(Parcel* parcel); 534 status_t writeToParcel(Parcel* parcel) const; 535#endif 536 537 static bool isTouchEvent(int32_t source, int32_t action); 538 inline bool isTouchEvent() const { 539 return isTouchEvent(mSource, mAction); 540 } 541 542 // Low-level accessors. 543 inline const PointerProperties* getPointerProperties() const { 544 return mPointerProperties.array(); 545 } 546 inline const nsecs_t* getSampleEventTimes() const { return mSampleEventTimes.array(); } 547 inline const PointerCoords* getSamplePointerCoords() const { 548 return mSamplePointerCoords.array(); 549 } 550 551protected: 552 int32_t mAction; 553 int32_t mFlags; 554 int32_t mEdgeFlags; 555 int32_t mMetaState; 556 int32_t mButtonState; 557 float mXOffset; 558 float mYOffset; 559 float mXPrecision; 560 float mYPrecision; 561 nsecs_t mDownTime; 562 Vector<PointerProperties> mPointerProperties; 563 Vector<nsecs_t> mSampleEventTimes; 564 Vector<PointerCoords> mSamplePointerCoords; 565}; 566 567/* 568 * Input event factory. 569 */ 570class InputEventFactoryInterface { 571protected: 572 virtual ~InputEventFactoryInterface() { } 573 574public: 575 InputEventFactoryInterface() { } 576 577 virtual KeyEvent* createKeyEvent() = 0; 578 virtual MotionEvent* createMotionEvent() = 0; 579}; 580 581/* 582 * A simple input event factory implementation that uses a single preallocated instance 583 * of each type of input event that are reused for each request. 584 */ 585class PreallocatedInputEventFactory : public InputEventFactoryInterface { 586public: 587 PreallocatedInputEventFactory() { } 588 virtual ~PreallocatedInputEventFactory() { } 589 590 virtual KeyEvent* createKeyEvent() { return & mKeyEvent; } 591 virtual MotionEvent* createMotionEvent() { return & mMotionEvent; } 592 593private: 594 KeyEvent mKeyEvent; 595 MotionEvent mMotionEvent; 596}; 597 598/* 599 * An input event factory implementation that maintains a pool of input events. 600 */ 601class PooledInputEventFactory : public InputEventFactoryInterface { 602public: 603 PooledInputEventFactory(size_t maxPoolSize = 20); 604 virtual ~PooledInputEventFactory(); 605 606 virtual KeyEvent* createKeyEvent(); 607 virtual MotionEvent* createMotionEvent(); 608 609 void recycle(InputEvent* event); 610 611private: 612 const size_t mMaxPoolSize; 613 614 Vector<KeyEvent*> mKeyEventPool; 615 Vector<MotionEvent*> mMotionEventPool; 616}; 617 618} // namespace android 619 620#endif // _LIBINPUT_INPUT_H 621