Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2019 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 | |
Prabir Pradhan | 4810866 | 2022-09-09 21:22:04 +0000 | [diff] [blame] | 17 | #pragma once |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 18 | |
Harry Cutts | 3f570c7 | 2024-04-05 16:44:28 +0000 | [diff] [blame] | 19 | #include <array> |
| 20 | #include <climits> |
| 21 | #include <limits> |
| 22 | #include <list> |
| 23 | #include <memory> |
Harry Cutts | f13161a | 2023-03-08 14:15:49 +0000 | [diff] [blame] | 24 | #include <optional> |
| 25 | #include <string> |
Harry Cutts | 3f570c7 | 2024-04-05 16:44:28 +0000 | [diff] [blame] | 26 | #include <utility> |
| 27 | #include <vector> |
Harry Cutts | f13161a | 2023-03-08 14:15:49 +0000 | [diff] [blame] | 28 | |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 29 | #include <stdint.h> |
Harry Cutts | 3f570c7 | 2024-04-05 16:44:28 +0000 | [diff] [blame] | 30 | #include <gui/constants.h> |
| 31 | #include <input/DisplayViewport.h> |
| 32 | #include <input/Input.h> |
| 33 | #include <input/InputDevice.h> |
| 34 | #include <input/VelocityControl.h> |
| 35 | #include <input/VelocityTracker.h> |
| 36 | #include <ui/Rect.h> |
Michael Wright | a9cf419 | 2022-12-01 23:46:39 +0000 | [diff] [blame] | 37 | #include <ui/Rotation.h> |
Harry Cutts | 3f570c7 | 2024-04-05 16:44:28 +0000 | [diff] [blame] | 38 | #include <ui/Size.h> |
| 39 | #include <ui/Transform.h> |
| 40 | #include <utils/BitSet.h> |
| 41 | #include <utils/Timers.h> |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 42 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 43 | #include "CursorButtonAccumulator.h" |
| 44 | #include "CursorScrollAccumulator.h" |
| 45 | #include "EventHub.h" |
| 46 | #include "InputMapper.h" |
| 47 | #include "InputReaderBase.h" |
Harry Cutts | 3f570c7 | 2024-04-05 16:44:28 +0000 | [diff] [blame] | 48 | #include "NotifyArgs.h" |
Harry Cutts | 3f570c7 | 2024-04-05 16:44:28 +0000 | [diff] [blame] | 49 | #include "StylusState.h" |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 50 | #include "TouchButtonAccumulator.h" |
| 51 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 52 | namespace android { |
| 53 | |
Prabir Pradhan | 7d04c4b | 2022-10-28 19:23:26 +0000 | [diff] [blame] | 54 | // Maximum amount of latency to add to touch events while waiting for data from an |
| 55 | // external stylus. |
| 56 | static constexpr nsecs_t EXTERNAL_STYLUS_DATA_TIMEOUT = ms2ns(72); |
| 57 | |
| 58 | // Maximum amount of time to wait on touch data before pushing out new pressure data. |
| 59 | static constexpr nsecs_t TOUCH_DATA_TIMEOUT = ms2ns(20); |
| 60 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 61 | /* Raw axis information from the driver. */ |
| 62 | struct RawPointerAxes { |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 63 | RawAbsoluteAxisInfo x{}; |
| 64 | RawAbsoluteAxisInfo y{}; |
| 65 | RawAbsoluteAxisInfo pressure{}; |
| 66 | RawAbsoluteAxisInfo touchMajor{}; |
| 67 | RawAbsoluteAxisInfo touchMinor{}; |
| 68 | RawAbsoluteAxisInfo toolMajor{}; |
| 69 | RawAbsoluteAxisInfo toolMinor{}; |
| 70 | RawAbsoluteAxisInfo orientation{}; |
| 71 | RawAbsoluteAxisInfo distance{}; |
| 72 | RawAbsoluteAxisInfo tiltX{}; |
| 73 | RawAbsoluteAxisInfo tiltY{}; |
| 74 | RawAbsoluteAxisInfo trackingId{}; |
| 75 | RawAbsoluteAxisInfo slot{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 76 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 77 | inline int32_t getRawWidth() const { return x.maxValue - x.minValue + 1; } |
| 78 | inline int32_t getRawHeight() const { return y.maxValue - y.minValue + 1; } |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 79 | inline void clear() { *this = RawPointerAxes(); } |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 80 | }; |
| 81 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 82 | using PropertiesArray = std::array<PointerProperties, MAX_POINTERS>; |
| 83 | using CoordsArray = std::array<PointerCoords, MAX_POINTERS>; |
| 84 | using IdToIndexArray = std::array<uint32_t, MAX_POINTER_ID + 1>; |
| 85 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 86 | /* Raw data for a collection of pointers including a pointer id mapping table. */ |
| 87 | struct RawPointerData { |
| 88 | struct Pointer { |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 89 | uint32_t id{0xFFFFFFFF}; |
| 90 | int32_t x{}; |
| 91 | int32_t y{}; |
| 92 | int32_t pressure{}; |
| 93 | int32_t touchMajor{}; |
| 94 | int32_t touchMinor{}; |
| 95 | int32_t toolMajor{}; |
| 96 | int32_t toolMinor{}; |
| 97 | int32_t orientation{}; |
| 98 | int32_t distance{}; |
| 99 | int32_t tiltX{}; |
| 100 | int32_t tiltY{}; |
Siarhei Vishniakou | 6d73f83 | 2022-07-21 17:27:03 -0700 | [diff] [blame] | 101 | // A fully decoded ToolType constant. |
| 102 | ToolType toolType{ToolType::UNKNOWN}; |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 103 | bool isHovering{false}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 104 | }; |
| 105 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 106 | uint32_t pointerCount{}; |
| 107 | std::array<Pointer, MAX_POINTERS> pointers{}; |
| 108 | BitSet32 hoveringIdBits{}, touchingIdBits{}, canceledIdBits{}; |
| 109 | IdToIndexArray idToIndex{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 110 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 111 | inline void clear() { *this = RawPointerData(); } |
| 112 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 113 | void getCentroidOfTouchingPointers(float* outX, float* outY) const; |
| 114 | |
| 115 | inline void markIdBit(uint32_t id, bool isHovering) { |
| 116 | if (isHovering) { |
| 117 | hoveringIdBits.markBit(id); |
| 118 | } else { |
| 119 | touchingIdBits.markBit(id); |
| 120 | } |
| 121 | } |
| 122 | |
| 123 | inline void clearIdBits() { |
| 124 | hoveringIdBits.clear(); |
| 125 | touchingIdBits.clear(); |
arthurhung | cc7f980 | 2020-04-30 17:55:40 +0800 | [diff] [blame] | 126 | canceledIdBits.clear(); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 127 | } |
| 128 | |
| 129 | inline const Pointer& pointerForId(uint32_t id) const { return pointers[idToIndex[id]]; } |
| 130 | |
| 131 | inline bool isHovering(uint32_t pointerIndex) { return pointers[pointerIndex].isHovering; } |
| 132 | }; |
| 133 | |
| 134 | /* Cooked data for a collection of pointers including a pointer id mapping table. */ |
| 135 | struct CookedPointerData { |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 136 | uint32_t pointerCount{}; |
| 137 | PropertiesArray pointerProperties{}; |
| 138 | CoordsArray pointerCoords{}; |
| 139 | BitSet32 hoveringIdBits{}, touchingIdBits{}, canceledIdBits{}, validIdBits{}; |
| 140 | IdToIndexArray idToIndex{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 141 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 142 | inline void clear() { *this = CookedPointerData(); } |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 143 | |
| 144 | inline const PointerCoords& pointerCoordsForId(uint32_t id) const { |
| 145 | return pointerCoords[idToIndex[id]]; |
| 146 | } |
| 147 | |
| 148 | inline PointerCoords& editPointerCoordsWithId(uint32_t id) { |
| 149 | return pointerCoords[idToIndex[id]]; |
| 150 | } |
| 151 | |
| 152 | inline PointerProperties& editPointerPropertiesWithId(uint32_t id) { |
| 153 | return pointerProperties[idToIndex[id]]; |
| 154 | } |
| 155 | |
| 156 | inline bool isHovering(uint32_t pointerIndex) const { |
| 157 | return hoveringIdBits.hasBit(pointerProperties[pointerIndex].id); |
| 158 | } |
| 159 | |
| 160 | inline bool isTouching(uint32_t pointerIndex) const { |
| 161 | return touchingIdBits.hasBit(pointerProperties[pointerIndex].id); |
| 162 | } |
Nathaniel R. Lewis | adb58ea | 2019-08-21 04:46:29 +0000 | [diff] [blame] | 163 | |
| 164 | inline bool hasPointerCoordsForId(uint32_t id) const { return validIdBits.hasBit(id); } |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 165 | }; |
| 166 | |
| 167 | class TouchInputMapper : public InputMapper { |
| 168 | public: |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 169 | ~TouchInputMapper() override; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 170 | |
Philip Junker | 4af3b3d | 2021-12-14 10:36:55 +0100 | [diff] [blame] | 171 | uint32_t getSources() const override; |
Harry Cutts | d02ea10 | 2023-03-17 18:21:30 +0000 | [diff] [blame] | 172 | void populateDeviceInfo(InputDeviceInfo& deviceInfo) override; |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 173 | void dump(std::string& dump) override; |
Arpit Singh | 4be4eef | 2023-03-28 14:26:01 +0000 | [diff] [blame] | 174 | [[nodiscard]] std::list<NotifyArgs> reconfigure(nsecs_t when, |
Arpit Singh | ed6c3de | 2023-04-05 19:24:37 +0000 | [diff] [blame] | 175 | const InputReaderConfiguration& config, |
Prabir Pradhan | 4bf6d45 | 2023-04-18 21:26:56 +0000 | [diff] [blame] | 176 | ConfigurationChanges changes) override; |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 177 | [[nodiscard]] std::list<NotifyArgs> reset(nsecs_t when) override; |
| 178 | [[nodiscard]] std::list<NotifyArgs> process(const RawEvent* rawEvent) override; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 179 | |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 180 | int32_t getKeyCodeState(uint32_t sourceMask, int32_t keyCode) override; |
| 181 | int32_t getScanCodeState(uint32_t sourceMask, int32_t scanCode) override; |
Siarhei Vishniakou | 7400794 | 2022-06-13 13:57:47 -0700 | [diff] [blame] | 182 | bool markSupportedKeyCodes(uint32_t sourceMask, const std::vector<int32_t>& keyCodes, |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 183 | uint8_t* outFlags) override; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 184 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 185 | [[nodiscard]] std::list<NotifyArgs> cancelTouch(nsecs_t when, nsecs_t readTime) override; |
| 186 | [[nodiscard]] std::list<NotifyArgs> timeoutExpired(nsecs_t when) override; |
| 187 | [[nodiscard]] std::list<NotifyArgs> updateExternalStylusState( |
| 188 | const StylusState& state) override; |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 189 | std::optional<int32_t> getAssociatedDisplayId() override; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 190 | |
| 191 | protected: |
| 192 | CursorButtonAccumulator mCursorButtonAccumulator; |
| 193 | CursorScrollAccumulator mCursorScrollAccumulator; |
| 194 | TouchButtonAccumulator mTouchButtonAccumulator; |
| 195 | |
| 196 | struct VirtualKey { |
| 197 | int32_t keyCode; |
| 198 | int32_t scanCode; |
| 199 | uint32_t flags; |
| 200 | |
| 201 | // computed hit box, specified in touch screen coords based on known display size |
| 202 | int32_t hitLeft; |
| 203 | int32_t hitTop; |
| 204 | int32_t hitRight; |
| 205 | int32_t hitBottom; |
| 206 | |
| 207 | inline bool isHit(int32_t x, int32_t y) const { |
| 208 | return x >= hitLeft && x <= hitRight && y >= hitTop && y <= hitBottom; |
| 209 | } |
| 210 | }; |
| 211 | |
| 212 | // Input sources and device mode. |
Arpit Singh | 403e53c | 2023-04-18 11:46:56 +0000 | [diff] [blame] | 213 | uint32_t mSource{0}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 214 | |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 215 | enum class DeviceMode { |
| 216 | DISABLED, // input is disabled |
| 217 | DIRECT, // direct mapping (touchscreen) |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 218 | NAVIGATION, // unscaled mapping with assist gesture (touch navigation) |
Harry Cutts | e3aaf39 | 2023-06-19 17:13:43 +0000 | [diff] [blame] | 219 | POINTER, // pointer mapping (e.g. uncaptured touchpad, drawing tablet) |
Dominik Laskowski | 7578845 | 2021-02-09 18:51:25 -0800 | [diff] [blame] | 220 | |
| 221 | ftl_last = POINTER |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 222 | }; |
Arpit Singh | 403e53c | 2023-04-18 11:46:56 +0000 | [diff] [blame] | 223 | DeviceMode mDeviceMode{DeviceMode::DISABLED}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 224 | |
| 225 | // The reader's configuration. |
| 226 | InputReaderConfiguration mConfig; |
| 227 | |
| 228 | // Immutable configuration parameters. |
| 229 | struct Parameters { |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 230 | enum class DeviceType { |
| 231 | TOUCH_SCREEN, |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 232 | TOUCH_NAVIGATION, |
| 233 | POINTER, |
Dominik Laskowski | 7578845 | 2021-02-09 18:51:25 -0800 | [diff] [blame] | 234 | |
| 235 | ftl_last = POINTER |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 236 | }; |
| 237 | |
| 238 | DeviceType deviceType; |
| 239 | bool hasAssociatedDisplay; |
| 240 | bool associatedDisplayIsExternal; |
| 241 | bool orientationAware; |
Prabir Pradhan | ac1c74f | 2021-08-20 16:09:32 -0700 | [diff] [blame] | 242 | |
Michael Wright | a9cf419 | 2022-12-01 23:46:39 +0000 | [diff] [blame] | 243 | ui::Rotation orientation; |
Prabir Pradhan | ac1c74f | 2021-08-20 16:09:32 -0700 | [diff] [blame] | 244 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 245 | bool hasButtonUnderPad; |
| 246 | std::string uniqueDisplayId; |
| 247 | |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 248 | enum class GestureMode { |
| 249 | SINGLE_TOUCH, |
| 250 | MULTI_TOUCH, |
Dominik Laskowski | 7578845 | 2021-02-09 18:51:25 -0800 | [diff] [blame] | 251 | |
| 252 | ftl_last = MULTI_TOUCH |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 253 | }; |
| 254 | GestureMode gestureMode; |
| 255 | |
| 256 | bool wake; |
Prabir Pradhan | 167c270 | 2022-09-14 00:37:24 +0000 | [diff] [blame] | 257 | |
Prabir Pradhan | e04ffaa | 2022-12-13 23:04:04 +0000 | [diff] [blame] | 258 | // The Universal Stylus Initiative (USI) protocol version supported by this device. |
| 259 | std::optional<InputDeviceUsiVersion> usiVersion; |
Yuncheol Heo | 50c19b1 | 2022-11-02 20:33:08 -0700 | [diff] [blame] | 260 | |
| 261 | // Allows touches while the display is off. |
| 262 | bool enableForInactiveViewport; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 263 | } mParameters; |
| 264 | |
| 265 | // Immutable calibration parameters in parsed form. |
| 266 | struct Calibration { |
| 267 | // Size |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 268 | enum class SizeCalibration { |
| 269 | DEFAULT, |
| 270 | NONE, |
| 271 | GEOMETRIC, |
| 272 | DIAMETER, |
| 273 | BOX, |
| 274 | AREA, |
Siarhei Vishniakou | 4e837cc | 2021-12-20 23:24:33 -0800 | [diff] [blame] | 275 | ftl_last = AREA |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 276 | }; |
| 277 | |
| 278 | SizeCalibration sizeCalibration; |
| 279 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 280 | std::optional<float> sizeScale; |
| 281 | std::optional<float> sizeBias; |
| 282 | std::optional<bool> sizeIsSummed; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 283 | |
| 284 | // Pressure |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 285 | enum class PressureCalibration { |
| 286 | DEFAULT, |
| 287 | NONE, |
| 288 | PHYSICAL, |
| 289 | AMPLITUDE, |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 290 | }; |
| 291 | |
| 292 | PressureCalibration pressureCalibration; |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 293 | std::optional<float> pressureScale; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 294 | |
| 295 | // Orientation |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 296 | enum class OrientationCalibration { |
| 297 | DEFAULT, |
| 298 | NONE, |
| 299 | INTERPOLATED, |
| 300 | VECTOR, |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 301 | }; |
| 302 | |
| 303 | OrientationCalibration orientationCalibration; |
| 304 | |
| 305 | // Distance |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 306 | enum class DistanceCalibration { |
| 307 | DEFAULT, |
| 308 | NONE, |
| 309 | SCALED, |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 310 | }; |
| 311 | |
| 312 | DistanceCalibration distanceCalibration; |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 313 | std::optional<float> distanceScale; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 314 | |
Siarhei Vishniakou | 0724734 | 2022-07-15 14:27:37 -0700 | [diff] [blame] | 315 | inline void applySizeScaleAndBias(float& outSize) const { |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 316 | if (sizeScale) { |
Siarhei Vishniakou | 0724734 | 2022-07-15 14:27:37 -0700 | [diff] [blame] | 317 | outSize *= *sizeScale; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 318 | } |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 319 | if (sizeBias) { |
Siarhei Vishniakou | 0724734 | 2022-07-15 14:27:37 -0700 | [diff] [blame] | 320 | outSize += *sizeBias; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 321 | } |
Siarhei Vishniakou | 0724734 | 2022-07-15 14:27:37 -0700 | [diff] [blame] | 322 | if (outSize < 0) { |
| 323 | outSize = 0; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 324 | } |
| 325 | } |
| 326 | } mCalibration; |
| 327 | |
| 328 | // Affine location transformation/calibration |
| 329 | struct TouchAffineTransformation mAffineTransform; |
| 330 | |
| 331 | RawPointerAxes mRawPointerAxes; |
| 332 | |
| 333 | struct RawState { |
Prabir Pradhan | 2f37bcb | 2022-11-08 20:41:28 +0000 | [diff] [blame] | 334 | nsecs_t when{std::numeric_limits<nsecs_t>::min()}; |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 335 | nsecs_t readTime{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 336 | |
| 337 | // Raw pointer sample data. |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 338 | RawPointerData rawPointerData{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 339 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 340 | int32_t buttonState{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 341 | |
| 342 | // Scroll state. |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 343 | int32_t rawVScroll{}; |
| 344 | int32_t rawHScroll{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 345 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 346 | inline void clear() { *this = RawState(); } |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 347 | }; |
| 348 | |
| 349 | struct CookedState { |
| 350 | // Cooked pointer sample data. |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 351 | CookedPointerData cookedPointerData{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 352 | |
| 353 | // Id bits used to differentiate fingers, stylus and mouse tools. |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 354 | BitSet32 fingerIdBits{}; |
| 355 | BitSet32 stylusIdBits{}; |
| 356 | BitSet32 mouseIdBits{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 357 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 358 | int32_t buttonState{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 359 | |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 360 | inline void clear() { *this = CookedState(); } |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 361 | }; |
| 362 | |
| 363 | std::vector<RawState> mRawStatesPending; |
| 364 | RawState mCurrentRawState; |
| 365 | CookedState mCurrentCookedState; |
| 366 | RawState mLastRawState; |
| 367 | CookedState mLastCookedState; |
| 368 | |
| 369 | // State provided by an external stylus |
| 370 | StylusState mExternalStylusState; |
Prabir Pradhan | 8d9ba91 | 2022-11-11 22:26:33 +0000 | [diff] [blame] | 371 | // If an external stylus is capable of reporting pointer-specific data like pressure, we will |
| 372 | // attempt to fuse the pointer data reported by the stylus to the first touch pointer. This is |
| 373 | // the id of the pointer to which the external stylus data is fused. |
| 374 | std::optional<uint32_t> mFusedStylusPointerId; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 375 | nsecs_t mExternalStylusFusionTimeout; |
| 376 | bool mExternalStylusDataPending; |
Prabir Pradhan | 124ea44 | 2022-10-28 20:27:44 +0000 | [diff] [blame] | 377 | // A subset of the buttons in mCurrentRawState that came from an external stylus. |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 378 | int32_t mExternalStylusButtonsApplied{0}; |
Prabir Pradhan | b08a0e8 | 2023-09-14 22:28:32 +0000 | [diff] [blame] | 379 | // True if the current cooked pointer data was modified due to the state of an external stylus. |
| 380 | bool mCurrentStreamModifiedByExternalStylus{false}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 381 | |
| 382 | // True if we sent a HOVER_ENTER event. |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 383 | bool mSentHoverEnter{false}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 384 | |
| 385 | // Have we assigned pointer IDs for this stream |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 386 | bool mHavePointerIds{false}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 387 | |
| 388 | // Is the current stream of direct touch events aborted |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 389 | bool mCurrentMotionAborted{false}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 390 | |
| 391 | // The time the primary pointer last went down. |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 392 | nsecs_t mDownTime{0}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 393 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 394 | std::vector<VirtualKey> mVirtualKeys; |
| 395 | |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 396 | explicit TouchInputMapper(InputDeviceContext& deviceContext, |
| 397 | const InputReaderConfiguration& readerConfig); |
| 398 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 399 | virtual void dumpParameters(std::string& dump); |
| 400 | virtual void configureRawPointerAxes(); |
| 401 | virtual void dumpRawPointerAxes(std::string& dump); |
Prabir Pradhan | 1728b21 | 2021-10-19 16:00:03 -0700 | [diff] [blame] | 402 | virtual void configureInputDevice(nsecs_t when, bool* outResetNeeded); |
| 403 | virtual void dumpDisplay(std::string& dump); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 404 | virtual void configureVirtualKeys(); |
| 405 | virtual void dumpVirtualKeys(std::string& dump); |
| 406 | virtual void parseCalibration(); |
| 407 | virtual void resolveCalibration(); |
| 408 | virtual void dumpCalibration(std::string& dump); |
| 409 | virtual void updateAffineTransformation(); |
| 410 | virtual void dumpAffineTransformation(std::string& dump); |
| 411 | virtual void resolveExternalStylusPresence(); |
| 412 | virtual bool hasStylus() const = 0; |
| 413 | virtual bool hasExternalStylus() const; |
| 414 | |
| 415 | virtual void syncTouch(nsecs_t when, RawState* outState) = 0; |
| 416 | |
| 417 | private: |
| 418 | // The current viewport. |
| 419 | // The components of the viewport are specified in the display's rotated orientation. |
| 420 | DisplayViewport mViewport; |
| 421 | |
Prabir Pradhan | 2d613f4 | 2022-11-10 20:22:06 +0000 | [diff] [blame] | 422 | // We refer to the display as being in the "natural orientation" when there is no rotation |
| 423 | // applied. The display size obtained from the viewport in the natural orientation. |
Prabir Pradhan | 7ddbc95 | 2022-11-09 22:03:40 +0000 | [diff] [blame] | 424 | // Always starts at (0, 0). |
| 425 | ui::Size mDisplayBounds{ui::kInvalidSize}; |
Arthur Hung | 4197f6b | 2020-03-16 15:39:59 +0800 | [diff] [blame] | 426 | |
Prabir Pradhan | 675f25a | 2022-11-10 22:04:07 +0000 | [diff] [blame] | 427 | // The physical frame is the rectangle in the rotated display's coordinate space that maps to |
Prabir Pradhan | 1728b21 | 2021-10-19 16:00:03 -0700 | [diff] [blame] | 428 | // the logical display frame. |
Prabir Pradhan | 675f25a | 2022-11-10 22:04:07 +0000 | [diff] [blame] | 429 | Rect mPhysicalFrameInRotatedDisplay{Rect::INVALID_RECT}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 430 | |
Prabir Pradhan | 1728b21 | 2021-10-19 16:00:03 -0700 | [diff] [blame] | 431 | // The orientation of the input device relative to that of the display panel. It specifies |
| 432 | // the rotation of the input device coordinates required to produce the display panel |
| 433 | // orientation, so it will depend on whether the device is orientation aware. |
Arpit Singh | 403e53c | 2023-04-18 11:46:56 +0000 | [diff] [blame] | 434 | ui::Rotation mInputDeviceOrientation{ui::ROTATION_0}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 435 | |
Prabir Pradhan | ea31d4f | 2022-11-10 20:48:01 +0000 | [diff] [blame] | 436 | // The transform that maps the input device's raw coordinate space to the un-rotated display's |
| 437 | // coordinate space. InputReader generates events in the un-rotated display's coordinate space. |
| 438 | ui::Transform mRawToDisplay; |
| 439 | |
Prabir Pradhan | 675f25a | 2022-11-10 22:04:07 +0000 | [diff] [blame] | 440 | // The transform that maps the input device's raw coordinate space to the rotated display's |
| 441 | // coordinate space. This used to perform hit-testing of raw events with the physical frame in |
| 442 | // the rotated coordinate space. See mPhysicalFrameInRotatedDisplay. |
| 443 | ui::Transform mRawToRotatedDisplay; |
| 444 | |
Prabir Pradhan | e2e10b4 | 2022-11-17 20:59:36 +0000 | [diff] [blame] | 445 | // The transform used for non-planar raw axes, such as orientation and tilt. |
| 446 | ui::Transform mRawRotation; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 447 | |
| 448 | float mGeometricScale; |
| 449 | |
| 450 | float mPressureScale; |
| 451 | |
| 452 | float mSizeScale; |
| 453 | |
| 454 | float mOrientationScale; |
| 455 | |
| 456 | float mDistanceScale; |
| 457 | |
| 458 | bool mHaveTilt; |
| 459 | float mTiltXCenter; |
| 460 | float mTiltXScale; |
| 461 | float mTiltYCenter; |
| 462 | float mTiltYScale; |
| 463 | |
| 464 | bool mExternalStylusConnected; |
| 465 | |
| 466 | // Oriented motion ranges for input device info. |
| 467 | struct OrientedRanges { |
| 468 | InputDeviceInfo::MotionRange x; |
| 469 | InputDeviceInfo::MotionRange y; |
| 470 | InputDeviceInfo::MotionRange pressure; |
| 471 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 472 | std::optional<InputDeviceInfo::MotionRange> size; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 473 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 474 | std::optional<InputDeviceInfo::MotionRange> touchMajor; |
| 475 | std::optional<InputDeviceInfo::MotionRange> touchMinor; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 476 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 477 | std::optional<InputDeviceInfo::MotionRange> toolMajor; |
| 478 | std::optional<InputDeviceInfo::MotionRange> toolMinor; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 479 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 480 | std::optional<InputDeviceInfo::MotionRange> orientation; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 481 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 482 | std::optional<InputDeviceInfo::MotionRange> distance; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 483 | |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 484 | std::optional<InputDeviceInfo::MotionRange> tilt; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 485 | |
| 486 | void clear() { |
Siarhei Vishniakou | 2421088 | 2022-07-15 09:42:04 -0700 | [diff] [blame] | 487 | size = std::nullopt; |
| 488 | touchMajor = std::nullopt; |
| 489 | touchMinor = std::nullopt; |
| 490 | toolMajor = std::nullopt; |
| 491 | toolMinor = std::nullopt; |
| 492 | orientation = std::nullopt; |
| 493 | distance = std::nullopt; |
| 494 | tilt = std::nullopt; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 495 | } |
| 496 | } mOrientedRanges; |
| 497 | |
| 498 | // Oriented dimensions and precision. |
| 499 | float mOrientedXPrecision; |
| 500 | float mOrientedYPrecision; |
| 501 | |
| 502 | struct CurrentVirtualKeyState { |
| 503 | bool down; |
| 504 | bool ignored; |
| 505 | nsecs_t downTime; |
| 506 | int32_t keyCode; |
| 507 | int32_t scanCode; |
| 508 | } mCurrentVirtualKey; |
| 509 | |
| 510 | // Scale factor for gesture or mouse based pointer movements. |
| 511 | float mPointerXMovementScale; |
| 512 | float mPointerYMovementScale; |
| 513 | |
| 514 | // Scale factor for gesture based zooming and other freeform motions. |
| 515 | float mPointerXZoomScale; |
| 516 | float mPointerYZoomScale; |
| 517 | |
HQ Liu | e6983c7 | 2022-04-19 22:14:56 +0000 | [diff] [blame] | 518 | // The maximum swipe width between pointers to detect a swipe gesture |
| 519 | // in the number of pixels.Touches that are wider than this are translated |
| 520 | // into freeform gestures. |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 521 | float mPointerGestureMaxSwipeWidth; |
| 522 | |
| 523 | struct PointerDistanceHeapElement { |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 524 | uint32_t currentPointerIndex : 8 {}; |
| 525 | uint32_t lastPointerIndex : 8 {}; |
| 526 | uint64_t distance : 48 {}; // squared distance |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 527 | }; |
| 528 | |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 529 | enum class PointerUsage { |
| 530 | NONE, |
| 531 | GESTURES, |
| 532 | STYLUS, |
| 533 | MOUSE, |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 534 | }; |
Arpit Singh | a8c236b | 2023-04-25 13:56:05 +0000 | [diff] [blame] | 535 | PointerUsage mPointerUsage{PointerUsage::NONE}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 536 | |
| 537 | struct PointerGesture { |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 538 | enum class Mode { |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 539 | // No fingers, button is not pressed. |
| 540 | // Nothing happening. |
| 541 | NEUTRAL, |
| 542 | |
| 543 | // No fingers, button is not pressed. |
| 544 | // Tap detected. |
| 545 | // Emits DOWN and UP events at the pointer location. |
| 546 | TAP, |
| 547 | |
| 548 | // Exactly one finger dragging following a tap. |
| 549 | // Pointer follows the active finger. |
| 550 | // Emits DOWN, MOVE and UP events at the pointer location. |
| 551 | // |
| 552 | // Detect double-taps when the finger goes up while in TAP_DRAG mode. |
| 553 | TAP_DRAG, |
| 554 | |
| 555 | // Button is pressed. |
| 556 | // Pointer follows the active finger if there is one. Other fingers are ignored. |
| 557 | // Emits DOWN, MOVE and UP events at the pointer location. |
| 558 | BUTTON_CLICK_OR_DRAG, |
| 559 | |
| 560 | // Exactly one finger, button is not pressed. |
| 561 | // Pointer follows the active finger. |
| 562 | // Emits HOVER_MOVE events at the pointer location. |
| 563 | // |
| 564 | // Detect taps when the finger goes up while in HOVER mode. |
| 565 | HOVER, |
| 566 | |
| 567 | // Exactly two fingers but neither have moved enough to clearly indicate |
| 568 | // whether a swipe or freeform gesture was intended. We consider the |
| 569 | // pointer to be pressed so this enables clicking or long-pressing on buttons. |
| 570 | // Pointer does not move. |
| 571 | // Emits DOWN, MOVE and UP events with a single stationary pointer coordinate. |
| 572 | PRESS, |
| 573 | |
| 574 | // Exactly two fingers moving in the same direction, button is not pressed. |
| 575 | // Pointer does not move. |
| 576 | // Emits DOWN, MOVE and UP events with a single pointer coordinate that |
| 577 | // follows the midpoint between both fingers. |
| 578 | SWIPE, |
| 579 | |
| 580 | // Two or more fingers moving in arbitrary directions, button is not pressed. |
| 581 | // Pointer does not move. |
| 582 | // Emits DOWN, POINTER_DOWN, MOVE, POINTER_UP and UP events that follow |
| 583 | // each finger individually relative to the initial centroid of the finger. |
| 584 | FREEFORM, |
| 585 | |
| 586 | // Waiting for quiet time to end before starting the next gesture. |
| 587 | QUIET, |
Harry Cutts | c57cd3c | 2024-04-24 13:52:55 +0000 | [diff] [blame] | 588 | |
| 589 | ftl_last = QUIET, |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 590 | }; |
| 591 | |
Prabir Pradhan | 47cf0a0 | 2021-03-11 20:30:57 -0800 | [diff] [blame] | 592 | // When a gesture is sent to an unfocused window, return true if it can bring that window |
| 593 | // into focus, false otherwise. |
| 594 | static bool canGestureAffectWindowFocus(Mode mode) { |
| 595 | switch (mode) { |
| 596 | case Mode::TAP: |
| 597 | case Mode::TAP_DRAG: |
| 598 | case Mode::BUTTON_CLICK_OR_DRAG: |
| 599 | // Taps can affect window focus. |
| 600 | return true; |
| 601 | case Mode::FREEFORM: |
| 602 | case Mode::HOVER: |
| 603 | case Mode::NEUTRAL: |
| 604 | case Mode::PRESS: |
| 605 | case Mode::QUIET: |
| 606 | case Mode::SWIPE: |
| 607 | // Most gestures can be performed on an unfocused window, so they should not |
| 608 | // not affect window focus. |
| 609 | return false; |
| 610 | } |
| 611 | } |
| 612 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 613 | // Time the first finger went down. |
| 614 | nsecs_t firstTouchTime; |
| 615 | |
| 616 | // The active pointer id from the raw touch data. |
| 617 | int32_t activeTouchId; // -1 if none |
| 618 | |
| 619 | // The active pointer id from the gesture last delivered to the application. |
| 620 | int32_t activeGestureId; // -1 if none |
| 621 | |
| 622 | // Pointer coords and ids for the current and previous pointer gesture. |
| 623 | Mode currentGestureMode; |
| 624 | BitSet32 currentGestureIdBits; |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 625 | IdToIndexArray currentGestureIdToIndex{}; |
| 626 | PropertiesArray currentGestureProperties{}; |
| 627 | CoordsArray currentGestureCoords{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 628 | |
| 629 | Mode lastGestureMode; |
| 630 | BitSet32 lastGestureIdBits; |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 631 | IdToIndexArray lastGestureIdToIndex{}; |
| 632 | PropertiesArray lastGestureProperties{}; |
| 633 | CoordsArray lastGestureCoords{}; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 634 | |
| 635 | // Time the pointer gesture last went down. |
| 636 | nsecs_t downTime; |
| 637 | |
| 638 | // Time when the pointer went down for a TAP. |
| 639 | nsecs_t tapDownTime; |
| 640 | |
| 641 | // Time when the pointer went up for a TAP. |
| 642 | nsecs_t tapUpTime; |
| 643 | |
| 644 | // Location of initial tap. |
| 645 | float tapX, tapY; |
| 646 | |
| 647 | // Time we started waiting for quiescence. |
| 648 | nsecs_t quietTime; |
| 649 | |
| 650 | // Reference points for multitouch gestures. |
| 651 | float referenceTouchX; // reference touch X/Y coordinates in surface units |
| 652 | float referenceTouchY; |
| 653 | float referenceGestureX; // reference gesture X/Y coordinates in pixels |
| 654 | float referenceGestureY; |
| 655 | |
| 656 | // Distance that each pointer has traveled which has not yet been |
| 657 | // subsumed into the reference gesture position. |
| 658 | BitSet32 referenceIdBits; |
| 659 | struct Delta { |
| 660 | float dx, dy; |
| 661 | }; |
| 662 | Delta referenceDeltas[MAX_POINTER_ID + 1]; |
| 663 | |
| 664 | // Describes how touch ids are mapped to gesture ids for freeform gestures. |
| 665 | uint32_t freeformTouchToGestureIdMap[MAX_POINTER_ID + 1]; |
| 666 | |
| 667 | // A velocity tracker for determining whether to switch active pointers during drags. |
| 668 | VelocityTracker velocityTracker; |
| 669 | |
| 670 | void reset() { |
| 671 | firstTouchTime = LLONG_MIN; |
| 672 | activeTouchId = -1; |
| 673 | activeGestureId = -1; |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 674 | currentGestureMode = Mode::NEUTRAL; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 675 | currentGestureIdBits.clear(); |
Michael Wright | 227c554 | 2020-07-02 18:30:52 +0100 | [diff] [blame] | 676 | lastGestureMode = Mode::NEUTRAL; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 677 | lastGestureIdBits.clear(); |
| 678 | downTime = 0; |
| 679 | velocityTracker.clear(); |
| 680 | resetTap(); |
| 681 | resetQuietTime(); |
| 682 | } |
| 683 | |
| 684 | void resetTap() { |
| 685 | tapDownTime = LLONG_MIN; |
| 686 | tapUpTime = LLONG_MIN; |
| 687 | } |
| 688 | |
| 689 | void resetQuietTime() { quietTime = LLONG_MIN; } |
| 690 | } mPointerGesture; |
| 691 | |
| 692 | struct PointerSimple { |
| 693 | PointerCoords currentCoords; |
| 694 | PointerProperties currentProperties; |
| 695 | PointerCoords lastCoords; |
| 696 | PointerProperties lastProperties; |
| 697 | |
| 698 | // True if the pointer is down. |
| 699 | bool down; |
| 700 | |
| 701 | // True if the pointer is hovering. |
| 702 | bool hovering; |
| 703 | |
| 704 | // Time the pointer last went down. |
| 705 | nsecs_t downTime; |
| 706 | |
Prabir Pradhan | b80b6c0 | 2022-11-02 20:05:13 +0000 | [diff] [blame] | 707 | // Values reported for the last pointer event. |
| 708 | uint32_t source; |
| 709 | int32_t displayId; |
| 710 | float lastCursorX; |
| 711 | float lastCursorY; |
| 712 | |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 713 | void reset() { |
| 714 | currentCoords.clear(); |
| 715 | currentProperties.clear(); |
| 716 | lastCoords.clear(); |
| 717 | lastProperties.clear(); |
| 718 | down = false; |
| 719 | hovering = false; |
| 720 | downTime = 0; |
Prabir Pradhan | b80b6c0 | 2022-11-02 20:05:13 +0000 | [diff] [blame] | 721 | source = 0; |
| 722 | displayId = ADISPLAY_ID_NONE; |
| 723 | lastCursorX = 0.f; |
| 724 | lastCursorY = 0.f; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 725 | } |
| 726 | } mPointerSimple; |
| 727 | |
| 728 | // The pointer and scroll velocity controls. |
Harry Cutts | e78184b | 2024-01-08 15:54:58 +0000 | [diff] [blame] | 729 | SimpleVelocityControl mPointerVelocityControl; |
| 730 | SimpleVelocityControl mWheelXVelocityControl; |
| 731 | SimpleVelocityControl mWheelYVelocityControl; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 732 | |
| 733 | std::optional<DisplayViewport> findViewport(); |
| 734 | |
| 735 | void resetExternalStylus(); |
| 736 | void clearStylusDataPendingFlags(); |
| 737 | |
Siarhei Vishniakou | 12c0fcb | 2021-12-17 13:40:44 -0800 | [diff] [blame] | 738 | int32_t clampResolution(const char* axisName, int32_t resolution) const; |
Siarhei Vishniakou | 4e837cc | 2021-12-20 23:24:33 -0800 | [diff] [blame] | 739 | void initializeOrientedRanges(); |
| 740 | void initializeSizeRanges(); |
| 741 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 742 | [[nodiscard]] std::list<NotifyArgs> sync(nsecs_t when, nsecs_t readTime); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 743 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 744 | [[nodiscard]] std::list<NotifyArgs> consumeRawTouches(nsecs_t when, nsecs_t readTime, |
| 745 | uint32_t policyFlags, bool& outConsumed); |
| 746 | [[nodiscard]] std::list<NotifyArgs> processRawTouches(bool timeout); |
| 747 | [[nodiscard]] std::list<NotifyArgs> cookAndDispatch(nsecs_t when, nsecs_t readTime); |
| 748 | [[nodiscard]] NotifyKeyArgs dispatchVirtualKey(nsecs_t when, nsecs_t readTime, |
| 749 | uint32_t policyFlags, int32_t keyEventAction, |
| 750 | int32_t keyEventFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 751 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 752 | [[nodiscard]] std::list<NotifyArgs> dispatchTouches(nsecs_t when, nsecs_t readTime, |
| 753 | uint32_t policyFlags); |
| 754 | [[nodiscard]] std::list<NotifyArgs> dispatchHoverExit(nsecs_t when, nsecs_t readTime, |
| 755 | uint32_t policyFlags); |
| 756 | [[nodiscard]] std::list<NotifyArgs> dispatchHoverEnterAndMove(nsecs_t when, nsecs_t readTime, |
| 757 | uint32_t policyFlags); |
| 758 | [[nodiscard]] std::list<NotifyArgs> dispatchButtonRelease(nsecs_t when, nsecs_t readTime, |
| 759 | uint32_t policyFlags); |
| 760 | [[nodiscard]] std::list<NotifyArgs> dispatchButtonPress(nsecs_t when, nsecs_t readTime, |
| 761 | uint32_t policyFlags); |
LiZhihong | 758eb56 | 2022-11-03 15:28:29 +0800 | [diff] [blame] | 762 | [[nodiscard]] std::list<NotifyArgs> dispatchGestureButtonPress(nsecs_t when, |
| 763 | uint32_t policyFlags, |
| 764 | BitSet32 idBits, |
| 765 | nsecs_t readTime); |
| 766 | [[nodiscard]] std::list<NotifyArgs> dispatchGestureButtonRelease(nsecs_t when, |
| 767 | uint32_t policyFlags, |
| 768 | BitSet32 idBits, |
| 769 | nsecs_t readTime); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 770 | const BitSet32& findActiveIdBits(const CookedPointerData& cookedPointerData); |
| 771 | void cookPointerData(); |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 772 | [[nodiscard]] std::list<NotifyArgs> abortTouches(nsecs_t when, nsecs_t readTime, |
| 773 | uint32_t policyFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 774 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 775 | [[nodiscard]] std::list<NotifyArgs> dispatchPointerUsage(nsecs_t when, nsecs_t readTime, |
| 776 | uint32_t policyFlags, |
| 777 | PointerUsage pointerUsage); |
| 778 | [[nodiscard]] std::list<NotifyArgs> abortPointerUsage(nsecs_t when, nsecs_t readTime, |
| 779 | uint32_t policyFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 780 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 781 | [[nodiscard]] std::list<NotifyArgs> dispatchPointerGestures(nsecs_t when, nsecs_t readTime, |
| 782 | uint32_t policyFlags, |
| 783 | bool isTimeout); |
| 784 | [[nodiscard]] std::list<NotifyArgs> abortPointerGestures(nsecs_t when, nsecs_t readTime, |
| 785 | uint32_t policyFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 786 | bool preparePointerGestures(nsecs_t when, bool* outCancelPreviousGesture, |
| 787 | bool* outFinishPreviousGesture, bool isTimeout); |
| 788 | |
Harry Cutts | bea6ce5 | 2022-10-14 15:17:30 +0000 | [diff] [blame] | 789 | // Returns true if we're in a period of "quiet time" when touchpad gestures should be ignored. |
| 790 | bool checkForTouchpadQuietTime(nsecs_t when); |
| 791 | |
| 792 | std::pair<int32_t, float> getFastestFinger(); |
| 793 | |
| 794 | void prepareMultiFingerPointerGestures(nsecs_t when, bool* outCancelPreviousGesture, |
| 795 | bool* outFinishPreviousGesture); |
| 796 | |
Harry Cutts | 714d1ad | 2022-08-24 16:36:43 +0000 | [diff] [blame] | 797 | // Moves the on-screen mouse pointer based on the movement of the pointer of the given ID |
| 798 | // between the last and current events. Uses a relative motion. |
| 799 | void moveMousePointerFromPointerDelta(nsecs_t when, uint32_t pointerId); |
| 800 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 801 | [[nodiscard]] std::list<NotifyArgs> dispatchPointerStylus(nsecs_t when, nsecs_t readTime, |
| 802 | uint32_t policyFlags); |
| 803 | [[nodiscard]] std::list<NotifyArgs> abortPointerStylus(nsecs_t when, nsecs_t readTime, |
| 804 | uint32_t policyFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 805 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 806 | [[nodiscard]] std::list<NotifyArgs> dispatchPointerMouse(nsecs_t when, nsecs_t readTime, |
| 807 | uint32_t policyFlags); |
| 808 | [[nodiscard]] std::list<NotifyArgs> abortPointerMouse(nsecs_t when, nsecs_t readTime, |
| 809 | uint32_t policyFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 810 | |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 811 | [[nodiscard]] std::list<NotifyArgs> dispatchPointerSimple(nsecs_t when, nsecs_t readTime, |
| 812 | uint32_t policyFlags, bool down, |
Prabir Pradhan | e71e570 | 2023-03-29 14:51:38 +0000 | [diff] [blame] | 813 | bool hovering, int32_t displayId); |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 814 | [[nodiscard]] std::list<NotifyArgs> abortPointerSimple(nsecs_t when, nsecs_t readTime, |
| 815 | uint32_t policyFlags); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 816 | |
Prabir Pradhan | 3f7545f | 2022-10-19 16:56:39 +0000 | [diff] [blame] | 817 | // Attempts to assign a pointer id to the external stylus. Returns true if the state should be |
| 818 | // withheld from further processing while waiting for data from the stylus. |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 819 | bool assignExternalStylusId(const RawState& state, bool timeout); |
| 820 | void applyExternalStylusButtonState(nsecs_t when); |
| 821 | void applyExternalStylusTouchState(nsecs_t when); |
| 822 | |
| 823 | // Dispatches a motion event. |
| 824 | // If the changedId is >= 0 and the action is POINTER_DOWN or POINTER_UP, the |
| 825 | // method will take care of setting the index and transmuting the action to DOWN or UP |
| 826 | // it is the first / last pointer to go down / up. |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 827 | [[nodiscard]] NotifyMotionArgs dispatchMotion( |
| 828 | nsecs_t when, nsecs_t readTime, uint32_t policyFlags, uint32_t source, int32_t action, |
| 829 | int32_t actionButton, int32_t flags, int32_t metaState, int32_t buttonState, |
Prabir Pradhan | d6ccedb | 2022-09-27 21:04:06 +0000 | [diff] [blame] | 830 | int32_t edgeFlags, const PropertiesArray& properties, const CoordsArray& coords, |
| 831 | const IdToIndexArray& idToIndex, BitSet32 idBits, int32_t changedId, float xPrecision, |
Siarhei Vishniakou | 2935db7 | 2022-09-22 13:35:22 -0700 | [diff] [blame] | 832 | float yPrecision, nsecs_t downTime, MotionClassification classification); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 833 | |
Garfield Tan | c734e4f | 2021-01-15 20:01:39 -0800 | [diff] [blame] | 834 | // Returns if this touch device is a touch screen with an associated display. |
| 835 | bool isTouchScreen(); |
Garfield Tan | c734e4f | 2021-01-15 20:01:39 -0800 | [diff] [blame] | 836 | |
Prabir Pradhan | 1728b21 | 2021-10-19 16:00:03 -0700 | [diff] [blame] | 837 | bool isPointInsidePhysicalFrame(int32_t x, int32_t y) const; |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 838 | const VirtualKey* findVirtualKeyHit(int32_t x, int32_t y); |
| 839 | |
Siarhei Vishniakou | 5747998 | 2021-03-03 01:32:21 +0000 | [diff] [blame] | 840 | static void assignPointerIds(const RawState& last, RawState& current); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 841 | |
Prabir Pradhan | 7d9cb5a | 2023-03-14 21:18:07 +0000 | [diff] [blame] | 842 | // Compute input transforms for DIRECT and POINTER modes. |
Prabir Pradhan | 675f25a | 2022-11-10 22:04:07 +0000 | [diff] [blame] | 843 | void computeInputTransforms(); |
Arpit Singh | 403e53c | 2023-04-18 11:46:56 +0000 | [diff] [blame] | 844 | static Parameters::DeviceType computeDeviceType(const InputDeviceContext& deviceContext); |
| 845 | static Parameters computeParameters(const InputDeviceContext& deviceContext); |
Prabir Pradhan | baa5c82 | 2019-08-30 15:27:05 -0700 | [diff] [blame] | 846 | }; |
| 847 | |
| 848 | } // namespace android |