| /* |
| * Copyright (C) 2011 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #ifndef _UI_INPUT_WINDOW_H |
| #define _UI_INPUT_WINDOW_H |
| |
| #include <input/Input.h> |
| #include <input/InputTransport.h> |
| #include <ui/Rect.h> |
| #include <ui/Region.h> |
| #include <utils/RefBase.h> |
| #include <utils/Timers.h> |
| |
| #include "InputApplication.h" |
| |
| namespace android { |
| class Parcel; |
| |
| /* |
| * Describes the properties of a window that can receive input. |
| */ |
| struct InputWindowInfo { |
| InputWindowInfo() = default; |
| InputWindowInfo(const Parcel& from); |
| |
| // Window flags from WindowManager.LayoutParams |
| enum { |
| FLAG_ALLOW_LOCK_WHILE_SCREEN_ON = 0x00000001, |
| FLAG_DIM_BEHIND = 0x00000002, |
| FLAG_BLUR_BEHIND = 0x00000004, |
| FLAG_NOT_FOCUSABLE = 0x00000008, |
| FLAG_NOT_TOUCHABLE = 0x00000010, |
| FLAG_NOT_TOUCH_MODAL = 0x00000020, |
| FLAG_TOUCHABLE_WHEN_WAKING = 0x00000040, |
| FLAG_KEEP_SCREEN_ON = 0x00000080, |
| FLAG_LAYOUT_IN_SCREEN = 0x00000100, |
| FLAG_LAYOUT_NO_LIMITS = 0x00000200, |
| FLAG_FULLSCREEN = 0x00000400, |
| FLAG_FORCE_NOT_FULLSCREEN = 0x00000800, |
| FLAG_DITHER = 0x00001000, |
| FLAG_SECURE = 0x00002000, |
| FLAG_SCALED = 0x00004000, |
| FLAG_IGNORE_CHEEK_PRESSES = 0x00008000, |
| FLAG_LAYOUT_INSET_DECOR = 0x00010000, |
| FLAG_ALT_FOCUSABLE_IM = 0x00020000, |
| FLAG_WATCH_OUTSIDE_TOUCH = 0x00040000, |
| FLAG_SHOW_WHEN_LOCKED = 0x00080000, |
| FLAG_SHOW_WALLPAPER = 0x00100000, |
| FLAG_TURN_SCREEN_ON = 0x00200000, |
| FLAG_DISMISS_KEYGUARD = 0x00400000, |
| FLAG_SPLIT_TOUCH = 0x00800000, |
| FLAG_SLIPPERY = 0x20000000, |
| }; |
| |
| // Window types from WindowManager.LayoutParams |
| enum { |
| FIRST_APPLICATION_WINDOW = 1, |
| TYPE_BASE_APPLICATION = 1, |
| TYPE_APPLICATION = 2, |
| TYPE_APPLICATION_STARTING = 3, |
| LAST_APPLICATION_WINDOW = 99, |
| FIRST_SUB_WINDOW = 1000, |
| TYPE_APPLICATION_PANEL = FIRST_SUB_WINDOW, |
| TYPE_APPLICATION_MEDIA = FIRST_SUB_WINDOW + 1, |
| TYPE_APPLICATION_SUB_PANEL = FIRST_SUB_WINDOW + 2, |
| TYPE_APPLICATION_ATTACHED_DIALOG = FIRST_SUB_WINDOW + 3, |
| TYPE_APPLICATION_MEDIA_OVERLAY = FIRST_SUB_WINDOW + 4, |
| LAST_SUB_WINDOW = 1999, |
| FIRST_SYSTEM_WINDOW = 2000, |
| TYPE_STATUS_BAR = FIRST_SYSTEM_WINDOW, |
| TYPE_SEARCH_BAR = FIRST_SYSTEM_WINDOW + 1, |
| TYPE_PHONE = FIRST_SYSTEM_WINDOW + 2, |
| TYPE_SYSTEM_ALERT = FIRST_SYSTEM_WINDOW + 3, |
| TYPE_KEYGUARD = FIRST_SYSTEM_WINDOW + 4, |
| TYPE_TOAST = FIRST_SYSTEM_WINDOW + 5, |
| TYPE_SYSTEM_OVERLAY = FIRST_SYSTEM_WINDOW + 6, |
| TYPE_PRIORITY_PHONE = FIRST_SYSTEM_WINDOW + 7, |
| TYPE_SYSTEM_DIALOG = FIRST_SYSTEM_WINDOW + 8, |
| TYPE_KEYGUARD_DIALOG = FIRST_SYSTEM_WINDOW + 9, |
| TYPE_SYSTEM_ERROR = FIRST_SYSTEM_WINDOW + 10, |
| TYPE_INPUT_METHOD = FIRST_SYSTEM_WINDOW + 11, |
| TYPE_INPUT_METHOD_DIALOG = FIRST_SYSTEM_WINDOW + 12, |
| TYPE_WALLPAPER = FIRST_SYSTEM_WINDOW + 13, |
| TYPE_STATUS_BAR_PANEL = FIRST_SYSTEM_WINDOW + 14, |
| TYPE_SECURE_SYSTEM_OVERLAY = FIRST_SYSTEM_WINDOW + 15, |
| TYPE_DRAG = FIRST_SYSTEM_WINDOW + 16, |
| TYPE_STATUS_BAR_SUB_PANEL = FIRST_SYSTEM_WINDOW + 17, |
| TYPE_POINTER = FIRST_SYSTEM_WINDOW + 18, |
| TYPE_NAVIGATION_BAR = FIRST_SYSTEM_WINDOW + 19, |
| TYPE_VOLUME_OVERLAY = FIRST_SYSTEM_WINDOW + 20, |
| TYPE_BOOT_PROGRESS = FIRST_SYSTEM_WINDOW + 21, |
| TYPE_INPUT_CONSUMER = FIRST_SYSTEM_WINDOW + 22, |
| TYPE_NAVIGATION_BAR_PANEL = FIRST_SYSTEM_WINDOW + 24, |
| TYPE_MAGNIFICATION_OVERLAY = FIRST_SYSTEM_WINDOW + 27, |
| TYPE_ACCESSIBILITY_OVERLAY = FIRST_SYSTEM_WINDOW + 32, |
| TYPE_DOCK_DIVIDER = FIRST_SYSTEM_WINDOW + 34, |
| TYPE_NOTIFICATION_SHADE = FIRST_SYSTEM_WINDOW + 40, |
| TYPE_TRUSTED_APPLICATION_OVERLAY = FIRST_SYSTEM_WINDOW + 42, |
| LAST_SYSTEM_WINDOW = 2999, |
| }; |
| |
| enum { |
| INPUT_FEATURE_DISABLE_TOUCH_PAD_GESTURES = 0x00000001, |
| INPUT_FEATURE_NO_INPUT_CHANNEL = 0x00000002, |
| INPUT_FEATURE_DISABLE_USER_ACTIVITY = 0x00000004, |
| }; |
| |
| /* These values are filled in by the WM and passed through SurfaceFlinger |
| * unless specified otherwise. |
| */ |
| // This value should NOT be used to uniquely identify the window. There may be different |
| // input windows that have the same token. |
| sp<IBinder> token; |
| // This uniquely identifies the input window. |
| int32_t id = -1; |
| std::string name; |
| int32_t layoutParamsFlags = 0; |
| int32_t layoutParamsType = 0; |
| nsecs_t dispatchingTimeout = -1; |
| |
| /* These values are filled in by SurfaceFlinger. */ |
| int32_t frameLeft = -1; |
| int32_t frameTop = -1; |
| int32_t frameRight = -1; |
| int32_t frameBottom = -1; |
| |
| /* |
| * SurfaceFlinger consumes this value to shrink the computed frame. This is |
| * different from shrinking the touchable region in that it DOES shift the coordinate |
| * space where-as the touchable region does not and is more like "cropping". This |
| * is used for window shadows. |
| */ |
| int32_t surfaceInset = 0; |
| |
| // A global scaling factor for all windows. Unlike windowScaleX/Y this results |
| // in scaling of the TOUCH_MAJOR/TOUCH_MINOR axis. |
| float globalScaleFactor = 1.0f; |
| |
| // Scaling factors applied to individual windows. |
| float windowXScale = 1.0f; |
| float windowYScale = 1.0f; |
| |
| /* |
| * This is filled in by the WM relative to the frame and then translated |
| * to absolute coordinates by SurfaceFlinger once the frame is computed. |
| */ |
| Region touchableRegion; |
| bool visible = false; |
| bool canReceiveKeys = false; |
| bool hasFocus = false; |
| bool hasWallpaper = false; |
| bool paused = false; |
| int32_t ownerPid = -1; |
| int32_t ownerUid = -1; |
| int32_t inputFeatures = 0; |
| int32_t displayId = ADISPLAY_ID_NONE; |
| int32_t portalToDisplayId = ADISPLAY_ID_NONE; |
| InputApplicationInfo applicationInfo; |
| bool replaceTouchableRegionWithCrop = false; |
| wp<IBinder> touchableRegionCropHandle; |
| |
| void addTouchableRegion(const Rect& region); |
| |
| bool touchableRegionContainsPoint(int32_t x, int32_t y) const; |
| bool frameContainsPoint(int32_t x, int32_t y) const; |
| |
| /* Returns true if the window is of a trusted type that is allowed to silently |
| * overlay other windows for the purpose of implementing the secure views feature. |
| * Trusted overlays, such as IME windows, can partly obscure other windows without causing |
| * motion events to be delivered to them with AMOTION_EVENT_FLAG_WINDOW_IS_OBSCURED. |
| */ |
| bool isTrustedOverlay() const; |
| |
| bool supportsSplitTouch() const; |
| |
| bool overlaps(const InputWindowInfo* other) const; |
| |
| status_t write(Parcel& output) const; |
| static InputWindowInfo read(const Parcel& from); |
| }; |
| |
| |
| /* |
| * Handle for a window that can receive input. |
| * |
| * Used by the native input dispatcher to indirectly refer to the window manager objects |
| * that describe a window. |
| */ |
| class InputWindowHandle : public RefBase { |
| public: |
| |
| inline const InputWindowInfo* getInfo() const { |
| return &mInfo; |
| } |
| |
| sp<IBinder> getToken() const; |
| |
| int32_t getId() const { return mInfo.id; } |
| |
| sp<IBinder> getApplicationToken() { |
| return mInfo.applicationInfo.token; |
| } |
| |
| inline std::string getName() const { |
| return !mInfo.name.empty() ? mInfo.name : "<invalid>"; |
| } |
| |
| inline nsecs_t getDispatchingTimeout(nsecs_t defaultValue) const { |
| return mInfo.token ? mInfo.dispatchingTimeout : defaultValue; |
| } |
| |
| inline std::chrono::nanoseconds getDispatchingTimeout( |
| std::chrono::nanoseconds defaultValue) const { |
| return mInfo.token ? std::chrono::nanoseconds(mInfo.dispatchingTimeout) : defaultValue; |
| } |
| |
| /** |
| * Requests that the state of this object be updated to reflect |
| * the most current available information about the application. |
| * |
| * This method should only be called from within the input dispatcher's |
| * critical section. |
| * |
| * Returns true on success, or false if the handle is no longer valid. |
| */ |
| virtual bool updateInfo() = 0; |
| |
| /** |
| * Updates from another input window handle. |
| */ |
| void updateFrom(const sp<InputWindowHandle> handle); |
| |
| /** |
| * Releases the channel used by the associated information when it is |
| * no longer needed. |
| */ |
| void releaseChannel(); |
| |
| protected: |
| explicit InputWindowHandle(); |
| virtual ~InputWindowHandle(); |
| |
| InputWindowInfo mInfo; |
| }; |
| |
| } // namespace android |
| |
| #endif // _UI_INPUT_WINDOW_H |