The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2007 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 | |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 17 | #ifndef ANDROID_DISPLAY_DEVICE_H |
| 18 | #define ANDROID_DISPLAY_DEVICE_H |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 19 | |
| 20 | #include <stdlib.h> |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 21 | |
| 22 | #include <memory> |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 23 | #include <optional> |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 24 | #include <string> |
Peiyong Lin | 136fbbc | 2018-04-17 15:09:44 -0700 | [diff] [blame] | 25 | #include <unordered_map> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 26 | |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 27 | #include <binder/IBinder.h> |
Chia-I Wu | f2aa311 | 2018-08-27 14:54:37 -0700 | [diff] [blame] | 28 | #include <gui/LayerState.h> |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 29 | #include <hardware/hwcomposer_defs.h> |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 30 | #include <math/mat4.h> |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 31 | #include <renderengine/RenderEngine.h> |
Alec Mouri | 0587464 | 2018-11-14 22:34:02 +0000 | [diff] [blame^] | 32 | #include <renderengine/Surface.h> |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 33 | #include <ui/GraphicTypes.h> |
Peiyong Lin | fb06930 | 2018-04-25 14:34:31 -0700 | [diff] [blame] | 34 | #include <ui/HdrCapabilities.h> |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 35 | #include <ui/Region.h> |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 36 | #include <ui/Transform.h> |
Mathias Agopian | 8630320 | 2012-07-24 22:46:10 -0700 | [diff] [blame] | 37 | #include <utils/Mutex.h> |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 38 | #include <utils/RefBase.h> |
Mathias Agopian | 4f4f094 | 2013-08-19 17:26:18 -0700 | [diff] [blame] | 39 | #include <utils/String8.h> |
Mathias Agopian | 8630320 | 2012-07-24 22:46:10 -0700 | [diff] [blame] | 40 | #include <utils/Timers.h> |
| 41 | |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 42 | #include "DisplayHardware/DisplayIdentification.h" |
chaviw | a76b271 | 2017-09-20 12:02:26 -0700 | [diff] [blame] | 43 | #include "RenderArea.h" |
Mathias Agopian | f435863 | 2012-08-22 17:16:19 -0700 | [diff] [blame] | 44 | |
Alec Mouri | 0587464 | 2018-11-14 22:34:02 +0000 | [diff] [blame^] | 45 | struct ANativeWindow; |
| 46 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 47 | namespace android { |
| 48 | |
Jesse Hall | 99c7dbb | 2013-03-14 14:29:29 -0700 | [diff] [blame] | 49 | class DisplaySurface; |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 50 | class Fence; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 51 | class HWComposer; |
Jesse Hall | 9e663de | 2013-08-16 14:28:37 -0700 | [diff] [blame] | 52 | class IGraphicBufferProducer; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 53 | class Layer; |
Mathias Agopian | 8630320 | 2012-07-24 22:46:10 -0700 | [diff] [blame] | 54 | class SurfaceFlinger; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 55 | |
David Sodman | fb95bcc | 2017-12-22 15:45:30 -0800 | [diff] [blame] | 56 | struct CompositionInfo; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 57 | struct DisplayDeviceCreationArgs; |
| 58 | struct DisplayInfo; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 59 | |
Mathias Agopian | 028a757 | 2012-08-05 01:23:51 -0700 | [diff] [blame] | 60 | class DisplayDevice : public LightRefBase<DisplayDevice> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 61 | { |
| 62 | public: |
Peiyong Lin | fb06930 | 2018-04-25 14:34:31 -0700 | [diff] [blame] | 63 | constexpr static float sDefaultMinLumiance = 0.0; |
| 64 | constexpr static float sDefaultMaxLumiance = 500.0; |
| 65 | |
Mathias Agopian | 87baae1 | 2012-07-31 12:38:26 -0700 | [diff] [blame] | 66 | // region in layer-stack space |
| 67 | mutable Region dirtyRegion; |
| 68 | // region in screen space |
Mathias Agopian | 87baae1 | 2012-07-31 12:38:26 -0700 | [diff] [blame] | 69 | Region undefinedRegion; |
Jesse Hall | b7a0549 | 2014-08-14 15:45:06 -0700 | [diff] [blame] | 70 | bool lastCompositionHadVisibleLayers; |
Mathias Agopian | 3eb38cb | 2012-04-03 22:09:52 -0700 | [diff] [blame] | 71 | |
Mathias Agopian | 92a979a | 2012-08-02 18:32:23 -0700 | [diff] [blame] | 72 | enum { |
Jesse Hall | 01e2905 | 2013-02-19 16:13:35 -0800 | [diff] [blame] | 73 | NO_LAYER_STACK = 0xFFFFFFFF, |
| 74 | }; |
| 75 | |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 76 | explicit DisplayDevice(DisplayDeviceCreationArgs&& args); |
Mathias Agopian | 028a757 | 2012-08-05 01:23:51 -0700 | [diff] [blame] | 77 | ~DisplayDevice(); |
Mathias Agopian | 92a979a | 2012-08-02 18:32:23 -0700 | [diff] [blame] | 78 | |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 79 | bool isVirtual() const { return mIsVirtual; } |
| 80 | bool isPrimary() const { return mIsPrimary; } |
Mathias Agopian | 92a979a | 2012-08-02 18:32:23 -0700 | [diff] [blame] | 81 | |
Jamie Gennis | dd3cb84 | 2012-10-19 18:19:11 -0700 | [diff] [blame] | 82 | // isSecure indicates whether this display can be trusted to display |
| 83 | // secure surfaces. |
| 84 | bool isSecure() const { return mIsSecure; } |
| 85 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 86 | // Flip the front and back buffers if the back buffer is "dirty". Might |
| 87 | // be instantaneous, might involve copying the frame buffer around. |
Chia-I Wu | b02087d | 2017-11-09 10:19:54 -0800 | [diff] [blame] | 88 | void flip() const; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 89 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 90 | int getWidth() const; |
| 91 | int getHeight() const; |
Chia-I Wu | a02871c | 2018-08-27 14:38:23 -0700 | [diff] [blame] | 92 | int getInstallOrientation() const { return mDisplayInstallOrientation; } |
Mathias Agopian | 3eb38cb | 2012-04-03 22:09:52 -0700 | [diff] [blame] | 93 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 94 | void setVisibleLayersSortedByZ(const Vector< sp<Layer> >& layers); |
| 95 | const Vector< sp<Layer> >& getVisibleLayersSortedByZ() const; |
Chia-I Wu | 8380689 | 2017-11-16 10:50:20 -0800 | [diff] [blame] | 96 | void setLayersNeedingFences(const Vector< sp<Layer> >& layers); |
| 97 | const Vector< sp<Layer> >& getLayersNeedingFences() const; |
Mathias Agopian | cd60f99 | 2012-08-16 16:28:27 -0700 | [diff] [blame] | 98 | Region getDirtyRegion(bool repaintEverything) const; |
Mathias Agopian | 3b1d2b6 | 2012-07-11 13:48:17 -0700 | [diff] [blame] | 99 | |
Mathias Agopian | 28947d7 | 2012-08-08 18:51:15 -0700 | [diff] [blame] | 100 | void setLayerStack(uint32_t stack); |
Michael Lentine | 47e4540 | 2014-07-18 15:34:25 -0700 | [diff] [blame] | 101 | void setDisplaySize(const int newWidth, const int newHeight); |
Mathias Agopian | 00e8c7a | 2012-09-04 19:30:46 -0700 | [diff] [blame] | 102 | void setProjection(int orientation, const Rect& viewport, const Rect& frame); |
Mathias Agopian | 28947d7 | 2012-08-08 18:51:15 -0700 | [diff] [blame] | 103 | |
Mathias Agopian | 1b03149 | 2012-06-20 17:51:20 -0700 | [diff] [blame] | 104 | int getOrientation() const { return mOrientation; } |
Mathias Agopian | c1c05de | 2013-09-17 23:45:22 -0700 | [diff] [blame] | 105 | uint32_t getOrientationTransform() const; |
Pablo Ceballos | 021623b | 2016-04-15 17:31:51 -0700 | [diff] [blame] | 106 | static uint32_t getPrimaryDisplayOrientationTransform(); |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 107 | const ui::Transform& getTransform() const { return mGlobalTransform; } |
Mathias Agopian | f5f714a | 2013-02-26 16:54:05 -0800 | [diff] [blame] | 108 | const Rect getViewport() const { return mViewport; } |
| 109 | const Rect getFrame() const { return mFrame; } |
Mathias Agopian | 766dc49 | 2012-10-30 18:08:06 -0700 | [diff] [blame] | 110 | const Rect& getScissor() const { return mScissor; } |
Mathias Agopian | eba8c68 | 2012-09-19 23:14:45 -0700 | [diff] [blame] | 111 | bool needsFiltering() const { return mNeedsFiltering; } |
Mathias Agopian | da8d0a5 | 2012-09-04 15:05:38 -0700 | [diff] [blame] | 112 | |
Mathias Agopian | 87baae1 | 2012-07-31 12:38:26 -0700 | [diff] [blame] | 113 | uint32_t getLayerStack() const { return mLayerStack; } |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 114 | |
| 115 | const std::optional<DisplayId>& getId() const { return mId; } |
| 116 | const wp<IBinder>& getDisplayToken() const { return mDisplayToken; } |
Mathias Agopian | 87baae1 | 2012-07-31 12:38:26 -0700 | [diff] [blame] | 117 | |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 118 | int32_t getSupportedPerFrameMetadata() const { return mSupportedPerFrameMetadata; } |
| 119 | |
Dan Stoza | 7143316 | 2014-02-04 16:22:36 -0800 | [diff] [blame] | 120 | // We pass in mustRecompose so we can keep VirtualDisplaySurface's state |
| 121 | // machine happy without actually queueing a buffer if nothing has changed |
| 122 | status_t beginFrame(bool mustRecompose) const; |
David Sodman | fb95bcc | 2017-12-22 15:45:30 -0800 | [diff] [blame] | 123 | status_t prepareFrame(HWComposer& hwc, std::vector<CompositionInfo>& compositionInfo); |
Chia-I Wu | be02ec0 | 2018-05-18 10:59:36 -0700 | [diff] [blame] | 124 | |
Peiyong Lin | dd9b2ae | 2018-03-01 16:22:45 -0800 | [diff] [blame] | 125 | bool hasWideColorGamut() const { return mHasWideColorGamut; } |
Peiyong Lin | 136fbbc | 2018-04-17 15:09:44 -0700 | [diff] [blame] | 126 | // Whether h/w composer has native support for specific HDR type. |
Peiyong Lin | 6266589 | 2018-04-16 11:07:44 -0700 | [diff] [blame] | 127 | bool hasHDR10Support() const { return mHasHdr10; } |
| 128 | bool hasHLGSupport() const { return mHasHLG; } |
| 129 | bool hasDolbyVisionSupport() const { return mHasDolbyVision; } |
Chia-I Wu | be02ec0 | 2018-05-18 10:59:36 -0700 | [diff] [blame] | 130 | |
Peiyong Lin | dfde511 | 2018-06-05 10:58:41 -0700 | [diff] [blame] | 131 | // Return true if the HDR dataspace is supported but |
| 132 | // there is no corresponding color mode. |
| 133 | bool hasLegacyHdrSupport(ui::Dataspace dataspace) const; |
Chia-I Wu | be02ec0 | 2018-05-18 10:59:36 -0700 | [diff] [blame] | 134 | |
Peiyong Lin | fb06930 | 2018-04-25 14:34:31 -0700 | [diff] [blame] | 135 | // The returned HdrCapabilities is the combination of HDR capabilities from |
| 136 | // hardware composer and RenderEngine. When the DisplayDevice supports wide |
| 137 | // color gamut, RenderEngine is able to simulate HDR support in Display P3 |
| 138 | // color space for both PQ and HLG HDR contents. The minimum and maximum |
| 139 | // luminance will be set to sDefaultMinLumiance and sDefaultMaxLumiance |
| 140 | // respectively if hardware composer doesn't return meaningful values. |
| 141 | const HdrCapabilities& getHdrCapabilities() const { return mHdrCapabilities; } |
Jesse Hall | 38efe86 | 2013-04-06 23:12:29 -0700 | [diff] [blame] | 142 | |
Chia-I Wu | be02ec0 | 2018-05-18 10:59:36 -0700 | [diff] [blame] | 143 | // Return true if intent is supported by the display. |
| 144 | bool hasRenderIntent(ui::RenderIntent intent) const; |
Peiyong Lin | 136fbbc | 2018-04-17 15:09:44 -0700 | [diff] [blame] | 145 | |
Chia-I Wu | be02ec0 | 2018-05-18 10:59:36 -0700 | [diff] [blame] | 146 | void getBestColorMode(ui::Dataspace dataspace, ui::RenderIntent intent, |
| 147 | ui::Dataspace* outDataspace, ui::ColorMode* outMode, |
| 148 | ui::RenderIntent* outIntent) const; |
Peiyong Lin | 136fbbc | 2018-04-17 15:09:44 -0700 | [diff] [blame] | 149 | |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 150 | // Queues the drawn buffer for consumption by HWC. |
| 151 | void queueBuffer(HWComposer& hwc); |
| 152 | // Allocates a buffer as scratch space for GPU composition |
| 153 | sp<GraphicBuffer> dequeueBuffer(); |
Jesse Hall | 01e2905 | 2013-02-19 16:13:35 -0800 | [diff] [blame] | 154 | |
Mathias Agopian | da27af9 | 2012-09-13 18:17:13 -0700 | [diff] [blame] | 155 | // called after h/w composer has completed its set() call |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 156 | void onPresentDisplayCompleted(); |
Mathias Agopian | da27af9 | 2012-09-13 18:17:13 -0700 | [diff] [blame] | 157 | |
Mathias Agopian | 9c6e297 | 2011-09-20 17:21:56 -0700 | [diff] [blame] | 158 | Rect getBounds() const { |
Mathias Agopian | 1b03149 | 2012-06-20 17:51:20 -0700 | [diff] [blame] | 159 | return Rect(mDisplayWidth, mDisplayHeight); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 160 | } |
Mathias Agopian | 9c6e297 | 2011-09-20 17:21:56 -0700 | [diff] [blame] | 161 | inline Rect bounds() const { return getBounds(); } |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 162 | |
Dominik Laskowski | bf170d9 | 2018-04-19 15:08:05 -0700 | [diff] [blame] | 163 | void setDisplayName(const std::string& displayName); |
| 164 | const std::string& getDisplayName() const { return mDisplayName; } |
Andy McFadden | 8dfa92f | 2012-09-17 18:27:17 -0700 | [diff] [blame] | 165 | |
Alec Mouri | 0587464 | 2018-11-14 22:34:02 +0000 | [diff] [blame^] | 166 | bool makeCurrent() const; |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 167 | // Acquires a new buffer for GPU composition. |
| 168 | void readyNewBuffer(); |
| 169 | // Marks the current buffer has finished, so that it can be presented and |
| 170 | // swapped out. |
| 171 | void finishBuffer(); |
Mathias Agopian | 875d8e1 | 2013-06-07 15:35:48 -0700 | [diff] [blame] | 172 | void setViewportAndProjection() const; |
Mathias Agopian | bae92d0 | 2012-09-28 01:00:47 -0700 | [diff] [blame] | 173 | |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 174 | const sp<Fence>& getClientTargetAcquireFence() const; |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 175 | |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 176 | /* ------------------------------------------------------------------------ |
Prashant Malani | 2c9b11f | 2014-05-25 01:36:31 -0700 | [diff] [blame] | 177 | * Display power mode management. |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 178 | */ |
Prashant Malani | 2c9b11f | 2014-05-25 01:36:31 -0700 | [diff] [blame] | 179 | int getPowerMode() const; |
| 180 | void setPowerMode(int mode); |
Dominik Laskowski | eecd659 | 2018-05-29 10:25:41 -0700 | [diff] [blame] | 181 | bool isPoweredOn() const; |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 182 | |
Peiyong Lin | fd997e0 | 2018-03-28 15:29:00 -0700 | [diff] [blame] | 183 | ui::ColorMode getActiveColorMode() const; |
| 184 | void setActiveColorMode(ui::ColorMode mode); |
Peiyong Lin | dd9b2ae | 2018-03-01 16:22:45 -0800 | [diff] [blame] | 185 | ui::RenderIntent getActiveRenderIntent() const; |
| 186 | void setActiveRenderIntent(ui::RenderIntent renderIntent); |
Yiwei Zhang | 7c64f17 | 2018-03-07 14:52:28 -0800 | [diff] [blame] | 187 | android_color_transform_t getColorTransform() const; |
| 188 | void setColorTransform(const mat4& transform); |
Peiyong Lin | 34beb7a | 2018-03-28 11:57:12 -0700 | [diff] [blame] | 189 | void setCompositionDataSpace(ui::Dataspace dataspace); |
Peiyong Lin | dd9b2ae | 2018-03-01 16:22:45 -0800 | [diff] [blame] | 190 | ui::Dataspace getCompositionDataSpace() const; |
Michael Wright | 28f24d0 | 2016-07-12 13:30:53 -0700 | [diff] [blame] | 191 | |
Michael Lentine | 6c9e34a | 2014-07-14 13:48:55 -0700 | [diff] [blame] | 192 | /* ------------------------------------------------------------------------ |
| 193 | * Display active config management. |
| 194 | */ |
| 195 | int getActiveConfig() const; |
| 196 | void setActiveConfig(int mode); |
| 197 | |
Jesse Hall | 02d8656 | 2013-03-25 14:43:23 -0700 | [diff] [blame] | 198 | // release HWC resources (if any) for removable displays |
| 199 | void disconnect(HWComposer& hwc); |
| 200 | |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 201 | /* ------------------------------------------------------------------------ |
| 202 | * Debugging |
| 203 | */ |
| 204 | uint32_t getPageFlipCount() const; |
Dominik Laskowski | 9b17b2c2 | 2018-11-01 14:49:03 -0700 | [diff] [blame] | 205 | std::string getDebugName() const; |
Mathias Agopian | 74d211a | 2013-04-22 16:55:35 +0200 | [diff] [blame] | 206 | void dump(String8& result) const; |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 207 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 208 | private: |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 209 | const sp<SurfaceFlinger> mFlinger; |
| 210 | const wp<IBinder> mDisplayToken; |
| 211 | |
| 212 | std::optional<DisplayId> mId; |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 213 | |
Mathias Agopian | a491260 | 2012-07-12 14:25:33 -0700 | [diff] [blame] | 214 | // ANativeWindow this display is rendering into |
Mathias Agopian | d8552d7 | 2012-08-04 21:39:11 -0700 | [diff] [blame] | 215 | sp<ANativeWindow> mNativeWindow; |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 216 | // Current buffer that this display can render to. |
| 217 | sp<GraphicBuffer> mGraphicBuffer; |
Jesse Hall | 99c7dbb | 2013-03-14 14:29:29 -0700 | [diff] [blame] | 218 | sp<DisplaySurface> mDisplaySurface; |
Alec Mouri | 8147b0e | 2018-10-09 20:57:19 -0700 | [diff] [blame] | 219 | // File descriptor indicating that mGraphicBuffer is ready for display, i.e. |
| 220 | // that drawing to the buffer is now complete. |
| 221 | base::unique_fd mBufferReady; |
Mathias Agopian | a491260 | 2012-07-12 14:25:33 -0700 | [diff] [blame] | 222 | |
Alec Mouri | 0587464 | 2018-11-14 22:34:02 +0000 | [diff] [blame^] | 223 | std::unique_ptr<renderengine::Surface> mSurface; |
Mathias Agopian | 1b03149 | 2012-06-20 17:51:20 -0700 | [diff] [blame] | 224 | int mDisplayWidth; |
| 225 | int mDisplayHeight; |
Chia-I Wu | a02871c | 2018-08-27 14:38:23 -0700 | [diff] [blame] | 226 | const int mDisplayInstallOrientation; |
Mathias Agopian | 076b1cc | 2009-04-10 14:24:30 -0700 | [diff] [blame] | 227 | mutable uint32_t mPageFlipCount; |
Dominik Laskowski | bf170d9 | 2018-04-19 15:08:05 -0700 | [diff] [blame] | 228 | std::string mDisplayName; |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 229 | |
| 230 | const bool mIsVirtual; |
| 231 | const bool mIsSecure; |
Mathias Agopian | 03e4072 | 2012-04-26 16:11:59 -0700 | [diff] [blame] | 232 | |
Mathias Agopian | a491260 | 2012-07-12 14:25:33 -0700 | [diff] [blame] | 233 | /* |
| 234 | * Can only accessed from the main thread, these members |
| 235 | * don't need synchronization. |
| 236 | */ |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 237 | |
Mathias Agopian | 3b1d2b6 | 2012-07-11 13:48:17 -0700 | [diff] [blame] | 238 | // list of visible layers on that display |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 239 | Vector< sp<Layer> > mVisibleLayersSortedByZ; |
Chia-I Wu | 8380689 | 2017-11-16 10:50:20 -0800 | [diff] [blame] | 240 | // list of layers needing fences |
| 241 | Vector< sp<Layer> > mLayersNeedingFences; |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 242 | |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 243 | /* |
| 244 | * Transaction state |
| 245 | */ |
Mathias Agopian | da8d0a5 | 2012-09-04 15:05:38 -0700 | [diff] [blame] | 246 | static status_t orientationToTransfrom(int orientation, |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 247 | int w, int h, ui::Transform* tr); |
Mathias Agopian | da8d0a5 | 2012-09-04 15:05:38 -0700 | [diff] [blame] | 248 | |
Fabien Sanglard | f0c53d6 | 2017-03-03 18:58:50 -0800 | [diff] [blame] | 249 | // The identifier of the active layer stack for this display. Several displays |
| 250 | // can use the same layer stack: A z-ordered group of layers (sometimes called |
| 251 | // "surfaces"). Any given layer can only be on a single layer stack. |
Mathias Agopian | 87baae1 | 2012-07-31 12:38:26 -0700 | [diff] [blame] | 252 | uint32_t mLayerStack; |
Fabien Sanglard | f0c53d6 | 2017-03-03 18:58:50 -0800 | [diff] [blame] | 253 | |
Mathias Agopian | da8d0a5 | 2012-09-04 15:05:38 -0700 | [diff] [blame] | 254 | int mOrientation; |
Pablo Ceballos | 021623b | 2016-04-15 17:31:51 -0700 | [diff] [blame] | 255 | static uint32_t sPrimaryDisplayOrientation; |
Mathias Agopian | 766dc49 | 2012-10-30 18:08:06 -0700 | [diff] [blame] | 256 | // user-provided visible area of the layer stack |
Mathias Agopian | da8d0a5 | 2012-09-04 15:05:38 -0700 | [diff] [blame] | 257 | Rect mViewport; |
Mathias Agopian | 766dc49 | 2012-10-30 18:08:06 -0700 | [diff] [blame] | 258 | // user-provided rectangle where mViewport gets mapped to |
Mathias Agopian | da8d0a5 | 2012-09-04 15:05:38 -0700 | [diff] [blame] | 259 | Rect mFrame; |
Mathias Agopian | 766dc49 | 2012-10-30 18:08:06 -0700 | [diff] [blame] | 260 | // pre-computed scissor to apply to the display |
| 261 | Rect mScissor; |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 262 | ui::Transform mGlobalTransform; |
Mathias Agopian | eba8c68 | 2012-09-19 23:14:45 -0700 | [diff] [blame] | 263 | bool mNeedsFiltering; |
Prashant Malani | 2c9b11f | 2014-05-25 01:36:31 -0700 | [diff] [blame] | 264 | // Current power mode |
| 265 | int mPowerMode; |
Michael Lentine | 6c9e34a | 2014-07-14 13:48:55 -0700 | [diff] [blame] | 266 | // Current active config |
| 267 | int mActiveConfig; |
Michael Wright | 28f24d0 | 2016-07-12 13:30:53 -0700 | [diff] [blame] | 268 | // current active color mode |
Chia-I Wu | 614e142 | 2018-05-23 02:17:03 -0700 | [diff] [blame] | 269 | ui::ColorMode mActiveColorMode = ui::ColorMode::NATIVE; |
Peiyong Lin | dd9b2ae | 2018-03-01 16:22:45 -0800 | [diff] [blame] | 270 | // Current active render intent. |
Chia-I Wu | 614e142 | 2018-05-23 02:17:03 -0700 | [diff] [blame] | 271 | ui::RenderIntent mActiveRenderIntent = ui::RenderIntent::COLORIMETRIC; |
| 272 | ui::Dataspace mCompositionDataSpace = ui::Dataspace::UNKNOWN; |
Yiwei Zhang | 7c64f17 | 2018-03-07 14:52:28 -0800 | [diff] [blame] | 273 | // Current color transform |
| 274 | android_color_transform_t mColorTransform; |
Courtney Goeltzenleuchter | 5d94389 | 2017-03-22 13:46:46 -0600 | [diff] [blame] | 275 | |
| 276 | // Need to know if display is wide-color capable or not. |
| 277 | // Initialized by SurfaceFlinger when the DisplayDevice is created. |
| 278 | // Fed to RenderEngine during composition. |
Peiyong Lin | dd9b2ae | 2018-03-01 16:22:45 -0800 | [diff] [blame] | 279 | bool mHasWideColorGamut; |
| 280 | bool mHasHdr10; |
Peiyong Lin | 6266589 | 2018-04-16 11:07:44 -0700 | [diff] [blame] | 281 | bool mHasHLG; |
| 282 | bool mHasDolbyVision; |
Peiyong Lin | fb06930 | 2018-04-25 14:34:31 -0700 | [diff] [blame] | 283 | HdrCapabilities mHdrCapabilities; |
Peiyong Lin | 0ac5f4e | 2018-04-19 22:06:34 -0700 | [diff] [blame] | 284 | const int32_t mSupportedPerFrameMetadata; |
Chia-I Wu | be02ec0 | 2018-05-18 10:59:36 -0700 | [diff] [blame] | 285 | |
| 286 | // Mappings from desired Dataspace/RenderIntent to the supported |
| 287 | // Dataspace/ColorMode/RenderIntent. |
| 288 | using ColorModeKey = uint64_t; |
| 289 | struct ColorModeValue { |
| 290 | ui::Dataspace dataspace; |
| 291 | ui::ColorMode colorMode; |
| 292 | ui::RenderIntent renderIntent; |
| 293 | }; |
| 294 | |
| 295 | static ColorModeKey getColorModeKey(ui::Dataspace dataspace, ui::RenderIntent intent) { |
| 296 | return (static_cast<uint64_t>(dataspace) << 32) | static_cast<uint32_t>(intent); |
| 297 | } |
| 298 | void populateColorModes( |
| 299 | const std::unordered_map<ui::ColorMode, std::vector<ui::RenderIntent>>& hwcColorModes); |
| 300 | void addColorMode( |
| 301 | const std::unordered_map<ui::ColorMode, std::vector<ui::RenderIntent>>& hwcColorModes, |
| 302 | const ui::ColorMode mode, const ui::RenderIntent intent); |
| 303 | |
| 304 | std::unordered_map<ColorModeKey, ColorModeValue> mColorModes; |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 305 | |
| 306 | // TODO(b/74619554): Remove special cases for primary display. |
| 307 | const bool mIsPrimary; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 308 | }; |
| 309 | |
Irvel | ffc9efc | 2016-07-27 15:16:37 -0700 | [diff] [blame] | 310 | struct DisplayDeviceState { |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 311 | bool isVirtual() const { return !displayId.has_value(); } |
Irvel | ffc9efc | 2016-07-27 15:16:37 -0700 | [diff] [blame] | 312 | |
Dominik Laskowski | 663bd28 | 2018-04-19 15:26:54 -0700 | [diff] [blame] | 313 | int32_t sequenceId = sNextSequenceId++; |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 314 | std::optional<DisplayId> displayId; |
Irvel | ffc9efc | 2016-07-27 15:16:37 -0700 | [diff] [blame] | 315 | sp<IGraphicBufferProducer> surface; |
| 316 | uint32_t layerStack = DisplayDevice::NO_LAYER_STACK; |
| 317 | Rect viewport; |
| 318 | Rect frame; |
| 319 | uint8_t orientation = 0; |
| 320 | uint32_t width = 0; |
| 321 | uint32_t height = 0; |
Dominik Laskowski | bf170d9 | 2018-04-19 15:08:05 -0700 | [diff] [blame] | 322 | std::string displayName; |
Irvel | ffc9efc | 2016-07-27 15:16:37 -0700 | [diff] [blame] | 323 | bool isSecure = false; |
Dominik Laskowski | 663bd28 | 2018-04-19 15:26:54 -0700 | [diff] [blame] | 324 | |
| 325 | private: |
| 326 | static std::atomic<int32_t> sNextSequenceId; |
Irvel | ffc9efc | 2016-07-27 15:16:37 -0700 | [diff] [blame] | 327 | }; |
| 328 | |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 329 | struct DisplayDeviceCreationArgs { |
| 330 | // We use a constructor to ensure some of the values are set, without |
| 331 | // assuming a default value. |
| 332 | DisplayDeviceCreationArgs(const sp<SurfaceFlinger>& flinger, const wp<IBinder>& displayToken, |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 333 | const std::optional<DisplayId>& displayId); |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 334 | |
| 335 | const sp<SurfaceFlinger> flinger; |
| 336 | const wp<IBinder> displayToken; |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 337 | const std::optional<DisplayId> displayId; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 338 | |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 339 | bool isVirtual{false}; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 340 | bool isSecure{false}; |
| 341 | sp<ANativeWindow> nativeWindow; |
| 342 | sp<DisplaySurface> displaySurface; |
Alec Mouri | 0587464 | 2018-11-14 22:34:02 +0000 | [diff] [blame^] | 343 | std::unique_ptr<renderengine::Surface> renderSurface; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 344 | int displayInstallOrientation{DisplayState::eOrientationDefault}; |
| 345 | bool hasWideColorGamut{false}; |
| 346 | HdrCapabilities hdrCapabilities; |
| 347 | int32_t supportedPerFrameMetadata{0}; |
| 348 | std::unordered_map<ui::ColorMode, std::vector<ui::RenderIntent>> hwcColorModes; |
| 349 | int initialPowerMode{HWC_POWER_MODE_NORMAL}; |
Dominik Laskowski | 075d317 | 2018-05-24 15:50:06 -0700 | [diff] [blame] | 350 | bool isPrimary{false}; |
Lloyd Pique | 2eef1d2 | 2018-09-18 21:30:04 -0700 | [diff] [blame] | 351 | }; |
| 352 | |
chaviw | a76b271 | 2017-09-20 12:02:26 -0700 | [diff] [blame] | 353 | class DisplayRenderArea : public RenderArea { |
| 354 | public: |
| 355 | DisplayRenderArea(const sp<const DisplayDevice> device, |
Chia-I Wu | c80dcbb | 2018-08-24 15:34:02 -0700 | [diff] [blame] | 356 | ui::Transform::orientation_flags rotation = ui::Transform::ROT_0) |
Chia-I Wu | 9d1abea | 2018-08-23 13:44:43 -0700 | [diff] [blame] | 357 | : DisplayRenderArea(device, device->getBounds(), device->getWidth(), device->getHeight(), |
Peiyong Lin | 0e003c9 | 2018-09-17 11:09:51 -0700 | [diff] [blame] | 358 | device->getCompositionDataSpace(), rotation) {} |
Chia-I Wu | 9d1abea | 2018-08-23 13:44:43 -0700 | [diff] [blame] | 359 | DisplayRenderArea(const sp<const DisplayDevice> device, Rect sourceCrop, uint32_t reqWidth, |
Peiyong Lin | 0e003c9 | 2018-09-17 11:09:51 -0700 | [diff] [blame] | 360 | uint32_t reqHeight, ui::Dataspace reqDataSpace, |
| 361 | ui::Transform::orientation_flags rotation) |
| 362 | : RenderArea(reqWidth, reqHeight, CaptureFill::OPAQUE, reqDataSpace, |
Chia-I Wu | f2aa311 | 2018-08-27 14:54:37 -0700 | [diff] [blame] | 363 | getDisplayRotation(rotation, device->getInstallOrientation())), |
| 364 | mDevice(device), |
| 365 | mSourceCrop(sourceCrop) {} |
chaviw | a76b271 | 2017-09-20 12:02:26 -0700 | [diff] [blame] | 366 | |
Peiyong Lin | efefaac | 2018-08-17 12:27:51 -0700 | [diff] [blame] | 367 | const ui::Transform& getTransform() const override { return mDevice->getTransform(); } |
chaviw | a76b271 | 2017-09-20 12:02:26 -0700 | [diff] [blame] | 368 | Rect getBounds() const override { return mDevice->getBounds(); } |
| 369 | int getHeight() const override { return mDevice->getHeight(); } |
| 370 | int getWidth() const override { return mDevice->getWidth(); } |
| 371 | bool isSecure() const override { return mDevice->isSecure(); } |
Chia-I Wu | 5f6664c | 2018-08-28 11:01:44 -0700 | [diff] [blame] | 372 | |
| 373 | bool needsFiltering() const override { |
Chia-I Wu | 8730ba8 | 2018-08-29 09:25:59 -0700 | [diff] [blame] | 374 | // check if the projection from the logical display to the physical |
| 375 | // display needs filtering |
Chia-I Wu | 5f6664c | 2018-08-28 11:01:44 -0700 | [diff] [blame] | 376 | if (mDevice->needsFiltering()) { |
| 377 | return true; |
| 378 | } |
| 379 | |
Chia-I Wu | 8730ba8 | 2018-08-29 09:25:59 -0700 | [diff] [blame] | 380 | // check if the projection from the logical render area (i.e., the |
| 381 | // physical display) to the physical render area requires filtering |
Chia-I Wu | 5f6664c | 2018-08-28 11:01:44 -0700 | [diff] [blame] | 382 | const Rect sourceCrop = getSourceCrop(); |
| 383 | int width = sourceCrop.width(); |
| 384 | int height = sourceCrop.height(); |
| 385 | if (getRotationFlags() & ui::Transform::ROT_90) { |
| 386 | std::swap(width, height); |
| 387 | } |
| 388 | return width != getReqWidth() || height != getReqHeight(); |
| 389 | } |
Chia-I Wu | f2aa311 | 2018-08-27 14:54:37 -0700 | [diff] [blame] | 390 | |
| 391 | Rect getSourceCrop() const override { |
Chia-I Wu | 8730ba8 | 2018-08-29 09:25:59 -0700 | [diff] [blame] | 392 | // use the (projected) logical display viewport by default |
| 393 | if (mSourceCrop.isEmpty()) { |
| 394 | return mDevice->getScissor(); |
| 395 | } |
| 396 | |
Chia-I Wu | f2aa311 | 2018-08-27 14:54:37 -0700 | [diff] [blame] | 397 | const int orientation = mDevice->getInstallOrientation(); |
| 398 | if (orientation == DisplayState::eOrientationDefault) { |
| 399 | return mSourceCrop; |
| 400 | } |
| 401 | |
Chia-I Wu | 8730ba8 | 2018-08-29 09:25:59 -0700 | [diff] [blame] | 402 | // Install orientation is transparent to the callers. Apply it now. |
Chia-I Wu | f2aa311 | 2018-08-27 14:54:37 -0700 | [diff] [blame] | 403 | uint32_t flags = 0x00; |
| 404 | switch (orientation) { |
| 405 | case DisplayState::eOrientation90: |
| 406 | flags = ui::Transform::ROT_90; |
| 407 | break; |
| 408 | case DisplayState::eOrientation180: |
| 409 | flags = ui::Transform::ROT_180; |
| 410 | break; |
| 411 | case DisplayState::eOrientation270: |
| 412 | flags = ui::Transform::ROT_270; |
| 413 | break; |
| 414 | } |
| 415 | ui::Transform tr; |
| 416 | tr.set(flags, getWidth(), getHeight()); |
| 417 | return tr.transform(mSourceCrop); |
| 418 | } |
chaviw | a76b271 | 2017-09-20 12:02:26 -0700 | [diff] [blame] | 419 | |
| 420 | private: |
Chia-I Wu | 8730ba8 | 2018-08-29 09:25:59 -0700 | [diff] [blame] | 421 | // Install orientation is transparent to the callers. We need to cancel |
| 422 | // it out by modifying rotation flags. |
Chia-I Wu | f2aa311 | 2018-08-27 14:54:37 -0700 | [diff] [blame] | 423 | static ui::Transform::orientation_flags getDisplayRotation( |
| 424 | ui::Transform::orientation_flags rotation, int orientation) { |
| 425 | if (orientation == DisplayState::eOrientationDefault) { |
| 426 | return rotation; |
| 427 | } |
| 428 | |
| 429 | // convert hw orientation into flag presentation |
| 430 | // here inverse transform needed |
| 431 | uint8_t hw_rot_90 = 0x00; |
| 432 | uint8_t hw_flip_hv = 0x00; |
| 433 | switch (orientation) { |
| 434 | case DisplayState::eOrientation90: |
| 435 | hw_rot_90 = ui::Transform::ROT_90; |
| 436 | hw_flip_hv = ui::Transform::ROT_180; |
| 437 | break; |
| 438 | case DisplayState::eOrientation180: |
| 439 | hw_flip_hv = ui::Transform::ROT_180; |
| 440 | break; |
| 441 | case DisplayState::eOrientation270: |
| 442 | hw_rot_90 = ui::Transform::ROT_90; |
| 443 | break; |
| 444 | } |
| 445 | |
| 446 | // transform flags operation |
| 447 | // 1) flip H V if both have ROT_90 flag |
| 448 | // 2) XOR these flags |
| 449 | uint8_t rotation_rot_90 = rotation & ui::Transform::ROT_90; |
| 450 | uint8_t rotation_flip_hv = rotation & ui::Transform::ROT_180; |
| 451 | if (rotation_rot_90 & hw_rot_90) { |
| 452 | rotation_flip_hv = (~rotation_flip_hv) & ui::Transform::ROT_180; |
| 453 | } |
| 454 | |
| 455 | return static_cast<ui::Transform::orientation_flags>( |
| 456 | (rotation_rot_90 ^ hw_rot_90) | (rotation_flip_hv ^ hw_flip_hv)); |
| 457 | } |
| 458 | |
chaviw | a76b271 | 2017-09-20 12:02:26 -0700 | [diff] [blame] | 459 | const sp<const DisplayDevice> mDevice; |
| 460 | const Rect mSourceCrop; |
| 461 | }; |
| 462 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 463 | }; // namespace android |
| 464 | |
Mathias Agopian | d3ee231 | 2012-08-02 14:01:42 -0700 | [diff] [blame] | 465 | #endif // ANDROID_DISPLAY_DEVICE_H |