1 /* 2 * Copyright (C) 2014 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 _INPUTFLINGER_POINTER_CONTROLLER_INTERFACE_H 18 #define _INPUTFLINGER_POINTER_CONTROLLER_INTERFACE_H 19 20 #include <input/DisplayViewport.h> 21 #include <input/Input.h> 22 #include <utils/BitSet.h> 23 24 namespace android { 25 26 /** 27 * Interface for tracking a mouse / touch pad pointer and touch pad spots. 28 * 29 * The spots are sprites on screen that visually represent the positions of 30 * fingers 31 * 32 * The pointer controller is responsible for providing synchronization and for tracking 33 * display orientation changes if needed. It works in the display panel's coordinate space, which 34 * is the same coordinate space used by InputReader. 35 */ 36 class PointerControllerInterface { 37 protected: PointerControllerInterface()38 PointerControllerInterface() { } ~PointerControllerInterface()39 virtual ~PointerControllerInterface() { } 40 41 public: 42 /* Gets the bounds of the region that the pointer can traverse. 43 * Returns true if the bounds are available. */ 44 virtual bool getBounds(float* outMinX, float* outMinY, 45 float* outMaxX, float* outMaxY) const = 0; 46 47 /* Move the pointer. */ 48 virtual void move(float deltaX, float deltaY) = 0; 49 50 /* Sets a mask that indicates which buttons are pressed. */ 51 virtual void setButtonState(int32_t buttonState) = 0; 52 53 /* Gets a mask that indicates which buttons are pressed. */ 54 virtual int32_t getButtonState() const = 0; 55 56 /* Sets the absolute location of the pointer. */ 57 virtual void setPosition(float x, float y) = 0; 58 59 /* Gets the absolute location of the pointer. */ 60 virtual void getPosition(float* outX, float* outY) const = 0; 61 62 enum class Transition { 63 // Fade/unfade immediately. 64 IMMEDIATE, 65 // Fade/unfade gradually. 66 GRADUAL, 67 }; 68 69 /* Fades the pointer out now. */ 70 virtual void fade(Transition transition) = 0; 71 72 /* Makes the pointer visible if it has faded out. 73 * The pointer never unfades itself automatically. This method must be called 74 * by the client whenever the pointer is moved or a button is pressed and it 75 * wants to ensure that the pointer becomes visible again. */ 76 virtual void unfade(Transition transition) = 0; 77 78 enum class Presentation { 79 // Show the mouse pointer. 80 POINTER, 81 // Show spots and a spot anchor in place of the mouse pointer. 82 SPOT, 83 }; 84 85 /* Sets the mode of the pointer controller. */ 86 virtual void setPresentation(Presentation presentation) = 0; 87 88 /* Sets the spots for the current gesture. 89 * The spots are not subject to the inactivity timeout like the pointer 90 * itself it since they are expected to remain visible for so long as 91 * the fingers are on the touch pad. 92 * 93 * The values of the AMOTION_EVENT_AXIS_PRESSURE axis is significant. 94 * For spotCoords, pressure != 0 indicates that the spot's location is being 95 * pressed (not hovering). 96 */ 97 virtual void setSpots(const PointerCoords* spotCoords, const uint32_t* spotIdToIndex, 98 BitSet32 spotIdBits, int32_t displayId) = 0; 99 100 /* Removes all spots. */ 101 virtual void clearSpots() = 0; 102 103 /* Gets the id of the display where the pointer should be shown. */ 104 virtual int32_t getDisplayId() const = 0; 105 106 /* Sets the associated display of this pointer. Pointer should show on that display. */ 107 virtual void setDisplayViewport(const DisplayViewport& displayViewport) = 0; 108 }; 109 110 } // namespace android 111 112 #endif // _INPUTFLINGER_POINTER_CONTROLLER_INTERFACE_H 113