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 | |
| 17 | #ifndef ANDROID_LAYER_H |
| 18 | #define ANDROID_LAYER_H |
| 19 | |
| 20 | #include <stdint.h> |
| 21 | #include <sys/types.h> |
| 22 | |
Mathias Agopian | 076b1cc | 2009-04-10 14:24:30 -0700 | [diff] [blame] | 23 | #include <EGL/egl.h> |
| 24 | #include <EGL/eglext.h> |
Mathias Agopian | 076b1cc | 2009-04-10 14:24:30 -0700 | [diff] [blame] | 25 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 26 | #include <utils/RefBase.h> |
| 27 | #include <utils/String8.h> |
| 28 | #include <utils/Timers.h> |
| 29 | |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 30 | #include <ui/FrameStats.h> |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 31 | #include <ui/GraphicBuffer.h> |
| 32 | #include <ui/PixelFormat.h> |
| 33 | #include <ui/Region.h> |
| 34 | |
| 35 | #include <gui/ISurfaceComposerClient.h> |
| 36 | |
| 37 | #include <private/gui/LayerState.h> |
| 38 | |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 39 | #include <list> |
| 40 | |
Jamie Gennis | 82dbc74 | 2012-11-08 19:23:28 -0800 | [diff] [blame] | 41 | #include "FrameTracker.h" |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 42 | #include "Client.h" |
Dan Stoza | b9b0883 | 2014-03-13 11:55:57 -0700 | [diff] [blame] | 43 | #include "MonitoredProducer.h" |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 44 | #include "SurfaceFlinger.h" |
| 45 | #include "SurfaceFlingerConsumer.h" |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 46 | #include "Transform.h" |
| 47 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 48 | #include "DisplayHardware/HWComposer.h" |
Mathias Agopian | 6b44267 | 2013-07-09 21:24:52 -0700 | [diff] [blame] | 49 | #include "DisplayHardware/FloatRect.h" |
Mathias Agopian | 3f84483 | 2013-08-07 21:24:32 -0700 | [diff] [blame] | 50 | #include "RenderEngine/Mesh.h" |
Mathias Agopian | 49457ac | 2013-08-14 18:20:17 -0700 | [diff] [blame] | 51 | #include "RenderEngine/Texture.h" |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 52 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 53 | namespace android { |
| 54 | |
| 55 | // --------------------------------------------------------------------------- |
| 56 | |
Mathias Agopian | 1f7bec6 | 2010-06-25 18:02:21 -0700 | [diff] [blame] | 57 | class Client; |
Mathias Agopian | 3e25fd8 | 2013-04-22 17:52:16 +0200 | [diff] [blame] | 58 | class Colorizer; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 59 | class DisplayDevice; |
| 60 | class GraphicBuffer; |
| 61 | class SurfaceFlinger; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 62 | |
| 63 | // --------------------------------------------------------------------------- |
| 64 | |
Andy McFadden | 882e3a3 | 2013-01-08 16:06:15 -0800 | [diff] [blame] | 65 | /* |
Andy McFadden | 882e3a3 | 2013-01-08 16:06:15 -0800 | [diff] [blame] | 66 | * A new BufferQueue and a new SurfaceFlingerConsumer are created when the |
| 67 | * Layer is first referenced. |
| 68 | * |
| 69 | * This also implements onFrameAvailable(), which notifies SurfaceFlinger |
| 70 | * that new data has arrived. |
| 71 | */ |
Jesse Hall | 399184a | 2014-03-03 15:42:54 -0800 | [diff] [blame] | 72 | class Layer : public SurfaceFlingerConsumer::ContentsChangedListener { |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 73 | static int32_t sSequence; |
| 74 | |
Mathias Agopian | d606de6 | 2010-05-10 20:06:11 -0700 | [diff] [blame] | 75 | public: |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 76 | mutable bool contentDirty; |
| 77 | // regions below are in window-manager space |
| 78 | Region visibleRegion; |
| 79 | Region coveredRegion; |
| 80 | Region visibleNonTransparentRegion; |
Dan Stoza | ee44edd | 2015-03-23 15:50:23 -0700 | [diff] [blame] | 81 | Region surfaceDamageRegion; |
Andy McFadden | 4df87bd | 2014-04-21 18:08:54 -0700 | [diff] [blame] | 82 | |
| 83 | // Layer serial number. This gives layers an explicit ordering, so we |
| 84 | // have a stable sort order when their layer stack and Z-order are |
| 85 | // the same. |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 86 | int32_t sequence; |
| 87 | |
| 88 | enum { // flags for doTransaction() |
| 89 | eDontUpdateGeometryState = 0x00000001, |
| 90 | eVisibleRegion = 0x00000002, |
| 91 | }; |
| 92 | |
| 93 | struct Geometry { |
| 94 | uint32_t w; |
| 95 | uint32_t h; |
Robert Carr | 3dcabfa | 2016-03-01 18:36:58 -0800 | [diff] [blame] | 96 | Transform transform; |
| 97 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 98 | inline bool operator ==(const Geometry& rhs) const { |
Robert Carr | b5d3d26 | 2016-03-25 15:08:13 -0700 | [diff] [blame] | 99 | return (w == rhs.w && h == rhs.h); |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 100 | } |
| 101 | inline bool operator !=(const Geometry& rhs) const { |
| 102 | return !operator ==(rhs); |
| 103 | } |
| 104 | }; |
| 105 | |
| 106 | struct State { |
| 107 | Geometry active; |
| 108 | Geometry requested; |
| 109 | uint32_t z; |
| 110 | uint32_t layerStack; |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 111 | #ifdef USE_HWC2 |
| 112 | float alpha; |
| 113 | #else |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 114 | uint8_t alpha; |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 115 | #endif |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 116 | uint8_t flags; |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 117 | uint8_t mask; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 118 | uint8_t reserved[2]; |
| 119 | int32_t sequence; // changes when visible regions can change |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 120 | bool modified; |
| 121 | |
Robert Carr | b5d3d26 | 2016-03-25 15:08:13 -0700 | [diff] [blame] | 122 | Rect crop; |
| 123 | Rect finalCrop; |
| 124 | |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 125 | // If set, defers this state update until the Layer identified by handle |
| 126 | // receives a frame with the given frameNumber |
| 127 | sp<IBinder> handle; |
| 128 | uint64_t frameNumber; |
| 129 | |
Mathias Agopian | 2ca7939 | 2013-04-02 18:30:32 -0700 | [diff] [blame] | 130 | // the transparentRegion hint is a bit special, it's latched only |
| 131 | // when we receive a buffer -- this is because it's "content" |
| 132 | // dependent. |
| 133 | Region activeTransparentRegion; |
| 134 | Region requestedTransparentRegion; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 135 | }; |
| 136 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 137 | // ----------------------------------------------------------------------- |
| 138 | |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 139 | Layer(SurfaceFlinger* flinger, const sp<Client>& client, |
| 140 | const String8& name, uint32_t w, uint32_t h, uint32_t flags); |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 141 | |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 142 | virtual ~Layer(); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 143 | |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 144 | // the this layer's size and format |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 145 | status_t setBuffers(uint32_t w, uint32_t h, PixelFormat format, uint32_t flags); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 146 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 147 | // modify current state |
| 148 | bool setPosition(float x, float y); |
| 149 | bool setLayer(uint32_t z); |
| 150 | bool setSize(uint32_t w, uint32_t h); |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 151 | #ifdef USE_HWC2 |
| 152 | bool setAlpha(float alpha); |
| 153 | #else |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 154 | bool setAlpha(uint8_t alpha); |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 155 | #endif |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 156 | bool setMatrix(const layer_state_t::matrix22_t& matrix); |
| 157 | bool setTransparentRegionHint(const Region& transparent); |
| 158 | bool setFlags(uint8_t flags, uint8_t mask); |
| 159 | bool setCrop(const Rect& crop); |
Pablo Ceballos | acbe678 | 2016-03-04 17:54:21 +0000 | [diff] [blame] | 160 | bool setFinalCrop(const Rect& crop); |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 161 | bool setLayerStack(uint32_t layerStack); |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 162 | void deferTransactionUntil(const sp<IBinder>& handle, uint64_t frameNumber); |
Robert Carr | c3574f7 | 2016-03-24 12:19:32 -0700 | [diff] [blame] | 163 | bool setOverrideScalingMode(int32_t overrideScalingMode); |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 164 | |
Dan Stoza | ee44edd | 2015-03-23 15:50:23 -0700 | [diff] [blame] | 165 | // If we have received a new buffer this frame, we will pass its surface |
| 166 | // damage down to hardware composer. Otherwise, we must send a region with |
| 167 | // one empty rect. |
| 168 | void useSurfaceDamage(); |
| 169 | void useEmptyDamage(); |
| 170 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 171 | uint32_t getTransactionFlags(uint32_t flags); |
| 172 | uint32_t setTransactionFlags(uint32_t flags); |
| 173 | |
Dan Stoza | c701401 | 2014-02-14 15:03:43 -0800 | [diff] [blame] | 174 | void computeGeometry(const sp<const DisplayDevice>& hw, Mesh& mesh, |
| 175 | bool useIdentityTransform) const; |
Michael Lentine | 6c925ed | 2014-09-26 17:55:01 -0700 | [diff] [blame] | 176 | Rect computeBounds(const Region& activeTransparentRegion) const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 177 | Rect computeBounds() const; |
| 178 | |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 179 | class Handle; |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 180 | sp<IBinder> getHandle(); |
Dan Stoza | b9b0883 | 2014-03-13 11:55:57 -0700 | [diff] [blame] | 181 | sp<IGraphicBufferProducer> getProducer() const; |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 182 | const String8& getName() const; |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 183 | |
Pablo Ceballos | 40845df | 2016-01-25 17:41:15 -0800 | [diff] [blame] | 184 | int32_t getSequence() const { return sequence; } |
| 185 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 186 | // ----------------------------------------------------------------------- |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 187 | // Virtuals |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 188 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 189 | virtual const char* getTypeId() const { return "Layer"; } |
| 190 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 191 | /* |
| 192 | * isOpaque - true if this surface is opaque |
Andy McFadden | 4125a4f | 2014-01-29 17:17:11 -0800 | [diff] [blame] | 193 | * |
| 194 | * This takes into account the buffer format (i.e. whether or not the |
| 195 | * pixel format includes an alpha channel) and the "opaque" flag set |
| 196 | * on the layer. It does not examine the current plane alpha value. |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 197 | */ |
Andy McFadden | 4125a4f | 2014-01-29 17:17:11 -0800 | [diff] [blame] | 198 | virtual bool isOpaque(const Layer::State& s) const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 199 | |
| 200 | /* |
| 201 | * isSecure - true if this surface is secure, that is if it prevents |
| 202 | * screenshots or VNC servers. |
| 203 | */ |
Dan Stoza | 2311608 | 2015-06-18 14:58:39 -0700 | [diff] [blame] | 204 | virtual bool isSecure() const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 205 | |
| 206 | /* |
| 207 | * isProtected - true if the layer may contain protected content in the |
| 208 | * GRALLOC_USAGE_PROTECTED sense. |
| 209 | */ |
Jamie Gennis | 7a4d0df | 2011-03-09 17:05:02 -0800 | [diff] [blame] | 210 | virtual bool isProtected() const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 211 | |
| 212 | /* |
| 213 | * isVisible - true if this layer is visible, false otherwise |
| 214 | */ |
Mathias Agopian | da27af9 | 2012-09-13 18:17:13 -0700 | [diff] [blame] | 215 | virtual bool isVisible() const; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 216 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 217 | /* |
| 218 | * isFixedSize - true if content has a fixed size |
| 219 | */ |
| 220 | virtual bool isFixedSize() const; |
Jamie Gennis | 582270d | 2011-08-17 18:19:00 -0700 | [diff] [blame] | 221 | |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 222 | protected: |
| 223 | /* |
| 224 | * onDraw - draws the surface. |
| 225 | */ |
Dan Stoza | c701401 | 2014-02-14 15:03:43 -0800 | [diff] [blame] | 226 | virtual void onDraw(const sp<const DisplayDevice>& hw, const Region& clip, |
| 227 | bool useIdentityTransform) const; |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 228 | |
| 229 | public: |
| 230 | // ----------------------------------------------------------------------- |
| 231 | |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 232 | #ifdef USE_HWC2 |
| 233 | void setGeometry(const sp<const DisplayDevice>& displayDevice); |
| 234 | void forceClientComposition(int32_t hwcId); |
| 235 | void setPerFrameData(const sp<const DisplayDevice>& displayDevice); |
| 236 | |
| 237 | // callIntoHwc exists so we can update our local state and call |
| 238 | // acceptDisplayChanges without unnecessarily updating the device's state |
| 239 | void setCompositionType(int32_t hwcId, HWC2::Composition type, |
| 240 | bool callIntoHwc = true); |
| 241 | HWC2::Composition getCompositionType(int32_t hwcId) const; |
| 242 | |
| 243 | void setClearClientTarget(int32_t hwcId, bool clear); |
| 244 | bool getClearClientTarget(int32_t hwcId) const; |
| 245 | |
| 246 | void updateCursorPosition(const sp<const DisplayDevice>& hw); |
| 247 | #else |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 248 | void setGeometry(const sp<const DisplayDevice>& hw, |
| 249 | HWComposer::HWCLayerInterface& layer); |
| 250 | void setPerFrameData(const sp<const DisplayDevice>& hw, |
| 251 | HWComposer::HWCLayerInterface& layer); |
| 252 | void setAcquireFence(const sp<const DisplayDevice>& hw, |
| 253 | HWComposer::HWCLayerInterface& layer); |
| 254 | |
Riley Andrews | 03414a1 | 2014-07-01 14:22:59 -0700 | [diff] [blame] | 255 | Rect getPosition(const sp<const DisplayDevice>& hw); |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 256 | #endif |
Riley Andrews | 03414a1 | 2014-07-01 14:22:59 -0700 | [diff] [blame] | 257 | |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 258 | /* |
| 259 | * called after page-flip |
| 260 | */ |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 261 | #ifdef USE_HWC2 |
| 262 | void onLayerDisplayed(const sp<Fence>& releaseFence); |
| 263 | #else |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 264 | void onLayerDisplayed(const sp<const DisplayDevice>& hw, |
| 265 | HWComposer::HWCLayerInterface* layer); |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 266 | #endif |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 267 | |
Dan Stoza | 6b9454d | 2014-11-07 16:00:59 -0800 | [diff] [blame] | 268 | bool shouldPresentNow(const DispSync& dispSync) const; |
| 269 | |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 270 | /* |
| 271 | * called before composition. |
| 272 | * returns true if the layer has pending updates. |
| 273 | */ |
| 274 | bool onPreComposition(); |
| 275 | |
| 276 | /* |
Dan Stoza | e77c766 | 2016-05-13 11:37:28 -0700 | [diff] [blame] | 277 | * called after composition. |
| 278 | * returns true if the layer latched a new buffer this frame. |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 279 | */ |
Dan Stoza | e77c766 | 2016-05-13 11:37:28 -0700 | [diff] [blame] | 280 | bool onPostComposition(); |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 281 | |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 282 | #ifdef USE_HWC2 |
| 283 | // If a buffer was replaced this frame, release the former buffer |
| 284 | void releasePendingBuffer(); |
| 285 | #endif |
| 286 | |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 287 | /* |
| 288 | * draw - performs some global clipping optimizations |
| 289 | * and calls onDraw(). |
| 290 | */ |
| 291 | void draw(const sp<const DisplayDevice>& hw, const Region& clip) const; |
Dan Stoza | c701401 | 2014-02-14 15:03:43 -0800 | [diff] [blame] | 292 | void draw(const sp<const DisplayDevice>& hw, bool useIdentityTransform) const; |
| 293 | void draw(const sp<const DisplayDevice>& hw) const; |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 294 | |
| 295 | /* |
| 296 | * doTransaction - process the transaction. This is a good place to figure |
| 297 | * out which attributes of the surface have changed. |
| 298 | */ |
| 299 | uint32_t doTransaction(uint32_t transactionFlags); |
| 300 | |
| 301 | /* |
| 302 | * setVisibleRegion - called to set the new visible region. This gives |
| 303 | * a chance to update the new visible region or record the fact it changed. |
| 304 | */ |
| 305 | void setVisibleRegion(const Region& visibleRegion); |
| 306 | |
| 307 | /* |
| 308 | * setCoveredRegion - called when the covered region changes. The covered |
| 309 | * region corresponds to any area of the surface that is covered |
| 310 | * (transparently or not) by another surface. |
| 311 | */ |
| 312 | void setCoveredRegion(const Region& coveredRegion); |
| 313 | |
| 314 | /* |
| 315 | * setVisibleNonTransparentRegion - called when the visible and |
| 316 | * non-transparent region changes. |
| 317 | */ |
| 318 | void setVisibleNonTransparentRegion(const Region& |
| 319 | visibleNonTransparentRegion); |
| 320 | |
| 321 | /* |
| 322 | * latchBuffer - called each time the screen is redrawn and returns whether |
| 323 | * the visible regions need to be recomputed (this is a fairly heavy |
| 324 | * operation, so this should be set only if needed). Typically this is used |
| 325 | * to figure out if the content or size of a surface has changed. |
| 326 | */ |
| 327 | Region latchBuffer(bool& recomputeVisibleRegions); |
| 328 | |
Riley Andrews | 03414a1 | 2014-07-01 14:22:59 -0700 | [diff] [blame] | 329 | bool isPotentialCursor() const { return mPotentialCursor;} |
| 330 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 331 | /* |
| 332 | * called with the state lock when the surface is removed from the |
| 333 | * current list |
| 334 | */ |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 335 | void onRemoved(); |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 336 | |
| 337 | |
Andy McFadden | bf974ab | 2012-12-04 16:51:15 -0800 | [diff] [blame] | 338 | // Updates the transform hint in our SurfaceFlingerConsumer to match |
Mathias Agopian | 8430095 | 2012-11-21 16:02:13 -0800 | [diff] [blame] | 339 | // the current orientation of the display device. |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 340 | void updateTransformHint(const sp<const DisplayDevice>& hw) const; |
Andy McFadden | 6905205 | 2012-09-14 16:10:11 -0700 | [diff] [blame] | 341 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 342 | /* |
| 343 | * returns the rectangle that crops the content of the layer and scales it |
| 344 | * to the layer's size. |
| 345 | */ |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 346 | Rect getContentCrop() const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 347 | |
Eric Penner | 51c59cd | 2014-07-28 19:51:58 -0700 | [diff] [blame] | 348 | /* |
| 349 | * Returns if a frame is queued. |
| 350 | */ |
Pablo Ceballos | 0631218 | 2015-10-07 16:32:12 -0700 | [diff] [blame] | 351 | bool hasQueuedFrame() const { return mQueuedFrames > 0 || |
Pablo Ceballos | ff95aab | 2016-01-13 17:09:58 -0800 | [diff] [blame] | 352 | mSidebandStreamChanged || mAutoRefresh; } |
Eric Penner | 51c59cd | 2014-07-28 19:51:58 -0700 | [diff] [blame] | 353 | |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 354 | #ifdef USE_HWC2 |
| 355 | // ----------------------------------------------------------------------- |
| 356 | |
| 357 | bool hasHwcLayer(int32_t hwcId) { |
| 358 | if (mHwcLayers.count(hwcId) == 0) { |
| 359 | return false; |
| 360 | } |
| 361 | if (mHwcLayers[hwcId].layer->isAbandoned()) { |
| 362 | ALOGI("Erasing abandoned layer %s on %d", mName.string(), hwcId); |
| 363 | mHwcLayers.erase(hwcId); |
| 364 | return false; |
| 365 | } |
| 366 | return true; |
| 367 | } |
| 368 | |
| 369 | std::shared_ptr<HWC2::Layer> getHwcLayer(int32_t hwcId) { |
| 370 | if (mHwcLayers.count(hwcId) == 0) { |
| 371 | return nullptr; |
| 372 | } |
| 373 | return mHwcLayers[hwcId].layer; |
| 374 | } |
| 375 | |
| 376 | void setHwcLayer(int32_t hwcId, std::shared_ptr<HWC2::Layer>&& layer) { |
| 377 | if (layer) { |
| 378 | mHwcLayers[hwcId].layer = layer; |
| 379 | } else { |
| 380 | mHwcLayers.erase(hwcId); |
| 381 | } |
| 382 | } |
| 383 | |
| 384 | #endif |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 385 | // ----------------------------------------------------------------------- |
| 386 | |
| 387 | void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip) const; |
| 388 | void setFiltering(bool filtering); |
| 389 | bool getFiltering() const; |
| 390 | |
| 391 | // only for debugging |
| 392 | inline const sp<GraphicBuffer>& getActiveBuffer() const { return mActiveBuffer; } |
| 393 | |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 394 | inline const State& getDrawingState() const { return mDrawingState; } |
| 395 | inline const State& getCurrentState() const { return mCurrentState; } |
| 396 | inline State& getCurrentState() { return mCurrentState; } |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 397 | |
| 398 | |
| 399 | /* always call base class first */ |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 400 | void dump(String8& result, Colorizer& colorizer) const; |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 401 | void dumpFrameStats(String8& result) const; |
| 402 | void clearFrameStats(); |
Jamie Gennis | 6547ff4 | 2013-07-16 20:12:42 -0700 | [diff] [blame] | 403 | void logFrameStats(); |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 404 | void getFrameStats(FrameStats* outStats) const; |
Mathias Agopian | 1b5e102 | 2010-04-20 17:55:49 -0700 | [diff] [blame] | 405 | |
Pablo Ceballos | 40845df | 2016-01-25 17:41:15 -0800 | [diff] [blame] | 406 | void getFenceData(String8* outName, uint64_t* outFrameNumber, |
| 407 | bool* outIsGlesComposition, nsecs_t* outPostedTime, |
| 408 | sp<Fence>* outAcquireFence, sp<Fence>* outPrevReleaseFence) const; |
| 409 | |
Dan Stoza | e77c766 | 2016-05-13 11:37:28 -0700 | [diff] [blame] | 410 | std::vector<OccupancyTracker::Segment> getOccupancyHistory(bool forceFlush); |
| 411 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 412 | protected: |
| 413 | // constant |
| 414 | sp<SurfaceFlinger> mFlinger; |
| 415 | |
| 416 | virtual void onFirstRef(); |
| 417 | |
| 418 | /* |
| 419 | * Trivial class, used to ensure that mFlinger->onLayerDestroyed(mLayer) |
| 420 | * is called. |
| 421 | */ |
| 422 | class LayerCleaner { |
| 423 | sp<SurfaceFlinger> mFlinger; |
| 424 | wp<Layer> mLayer; |
| 425 | protected: |
| 426 | ~LayerCleaner(); |
| 427 | public: |
| 428 | LayerCleaner(const sp<SurfaceFlinger>& flinger, const sp<Layer>& layer); |
| 429 | }; |
| 430 | |
Mathias Agopian | 2a9fc49 | 2013-03-01 13:42:57 -0800 | [diff] [blame] | 431 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 432 | private: |
Jesse Hall | 399184a | 2014-03-03 15:42:54 -0800 | [diff] [blame] | 433 | // Interface implementation for SurfaceFlingerConsumer::ContentsChangedListener |
Dan Stoza | dc13c5b | 2015-05-11 15:33:01 -0700 | [diff] [blame] | 434 | virtual void onFrameAvailable(const BufferItem& item) override; |
| 435 | virtual void onFrameReplaced(const BufferItem& item) override; |
| 436 | virtual void onSidebandStreamChanged() override; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 437 | |
Pablo Ceballos | 05289c2 | 2016-04-14 15:49:55 -0700 | [diff] [blame] | 438 | void commitTransaction(const State& stateToCommit); |
Mathias Agopian | 1eae0ee | 2013-06-05 16:59:15 -0700 | [diff] [blame] | 439 | |
| 440 | // needsLinearFiltering - true if this surface's state requires filtering |
| 441 | bool needsFiltering(const sp<const DisplayDevice>& hw) const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 442 | |
Mathias Agopian | 3330b20 | 2009-10-05 17:07:12 -0700 | [diff] [blame] | 443 | uint32_t getEffectiveUsage(uint32_t usage) const; |
Mathias Agopian | 6b44267 | 2013-07-09 21:24:52 -0700 | [diff] [blame] | 444 | FloatRect computeCrop(const sp<const DisplayDevice>& hw) const; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 445 | bool isCropped() const; |
| 446 | static bool getOpacityForFormat(uint32_t format); |
Mathias Agopian | 0aa758d | 2009-04-22 15:23:34 -0700 | [diff] [blame] | 447 | |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 448 | // drawing |
| 449 | void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip, |
Mathias Agopian | 3f84483 | 2013-08-07 21:24:32 -0700 | [diff] [blame] | 450 | float r, float g, float b, float alpha) const; |
Dan Stoza | c701401 | 2014-02-14 15:03:43 -0800 | [diff] [blame] | 451 | void drawWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip, |
| 452 | bool useIdentityTransform) const; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 453 | |
Ruben Brunk | 1681d95 | 2014-06-27 15:51:55 -0700 | [diff] [blame] | 454 | // Temporary - Used only for LEGACY camera mode. |
| 455 | uint32_t getProducerStickyTransform() const; |
| 456 | |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 457 | // ----------------------------------------------------------------------- |
| 458 | |
| 459 | class SyncPoint |
| 460 | { |
| 461 | public: |
| 462 | SyncPoint(uint64_t frameNumber) : mFrameNumber(frameNumber), |
| 463 | mFrameIsAvailable(false), mTransactionIsApplied(false) {} |
| 464 | |
| 465 | uint64_t getFrameNumber() const { |
| 466 | return mFrameNumber; |
| 467 | } |
| 468 | |
| 469 | bool frameIsAvailable() const { |
| 470 | return mFrameIsAvailable; |
| 471 | } |
| 472 | |
| 473 | void setFrameAvailable() { |
| 474 | mFrameIsAvailable = true; |
| 475 | } |
| 476 | |
| 477 | bool transactionIsApplied() const { |
| 478 | return mTransactionIsApplied; |
| 479 | } |
| 480 | |
| 481 | void setTransactionApplied() { |
| 482 | mTransactionIsApplied = true; |
| 483 | } |
| 484 | |
| 485 | private: |
| 486 | const uint64_t mFrameNumber; |
| 487 | std::atomic<bool> mFrameIsAvailable; |
| 488 | std::atomic<bool> mTransactionIsApplied; |
| 489 | }; |
| 490 | |
Dan Stoza | cac3538 | 2016-01-27 12:21:06 -0800 | [diff] [blame] | 491 | // SyncPoints which will be signaled when the correct frame is at the head |
| 492 | // of the queue and dropped after the frame has been latched. Protected by |
| 493 | // mLocalSyncPointMutex. |
| 494 | Mutex mLocalSyncPointMutex; |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 495 | std::list<std::shared_ptr<SyncPoint>> mLocalSyncPoints; |
| 496 | |
Dan Stoza | cac3538 | 2016-01-27 12:21:06 -0800 | [diff] [blame] | 497 | // SyncPoints which will be signaled and then dropped when the transaction |
| 498 | // is applied |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 499 | std::list<std::shared_ptr<SyncPoint>> mRemoteSyncPoints; |
| 500 | |
Dan Stoza | cac3538 | 2016-01-27 12:21:06 -0800 | [diff] [blame] | 501 | uint64_t getHeadFrameNumber() const; |
| 502 | |
| 503 | // Returns false if the relevant frame has already been latched |
| 504 | bool addSyncPoint(const std::shared_ptr<SyncPoint>& point); |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 505 | |
| 506 | void pushPendingState(); |
Pablo Ceballos | 05289c2 | 2016-04-14 15:49:55 -0700 | [diff] [blame] | 507 | void popPendingState(State* stateToCommit); |
| 508 | bool applyPendingStates(State* stateToCommit); |
Robert Carr | c3574f7 | 2016-03-24 12:19:32 -0700 | [diff] [blame] | 509 | |
| 510 | // Returns mCurrentScaling mode (originating from the |
| 511 | // Client) or mOverrideScalingMode mode (originating from |
| 512 | // the Surface Controller) if set. |
| 513 | uint32_t getEffectiveScalingMode() const; |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 514 | public: |
| 515 | void notifyAvailableFrames(); |
| 516 | private: |
Igor Murashkin | a4a3149 | 2012-10-29 13:36:11 -0700 | [diff] [blame] | 517 | |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 518 | // ----------------------------------------------------------------------- |
| 519 | |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 520 | // constants |
Andy McFadden | bf974ab | 2012-12-04 16:51:15 -0800 | [diff] [blame] | 521 | sp<SurfaceFlingerConsumer> mSurfaceFlingerConsumer; |
Dan Stoza | b9b0883 | 2014-03-13 11:55:57 -0700 | [diff] [blame] | 522 | sp<IGraphicBufferProducer> mProducer; |
Andy McFadden | 4df87bd | 2014-04-21 18:08:54 -0700 | [diff] [blame] | 523 | uint32_t mTextureName; // from GLES |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 524 | bool mPremultipliedAlpha; |
| 525 | String8 mName; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 526 | PixelFormat mFormat; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 527 | |
| 528 | // these are protected by an external lock |
| 529 | State mCurrentState; |
| 530 | State mDrawingState; |
| 531 | volatile int32_t mTransactionFlags; |
Mathias Agopian | d606de6 | 2010-05-10 20:06:11 -0700 | [diff] [blame] | 532 | |
Dan Stoza | 7dde599 | 2015-05-22 09:51:44 -0700 | [diff] [blame] | 533 | // Accessed from main thread and binder threads |
| 534 | Mutex mPendingStateMutex; |
| 535 | Vector<State> mPendingStates; |
| 536 | |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 537 | // thread-safe |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 538 | volatile int32_t mQueuedFrames; |
Jesse Hall | 399184a | 2014-03-03 15:42:54 -0800 | [diff] [blame] | 539 | volatile int32_t mSidebandStreamChanged; // used like an atomic boolean |
Jamie Gennis | 4b0eba9 | 2013-02-05 13:30:24 -0800 | [diff] [blame] | 540 | FrameTracker mFrameTracker; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 541 | |
| 542 | // main thread |
| 543 | sp<GraphicBuffer> mActiveBuffer; |
Jesse Hall | 399184a | 2014-03-03 15:42:54 -0800 | [diff] [blame] | 544 | sp<NativeHandle> mSidebandStream; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 545 | Rect mCurrentCrop; |
| 546 | uint32_t mCurrentTransform; |
Mathias Agopian | 933389f | 2011-07-18 16:15:08 -0700 | [diff] [blame] | 547 | uint32_t mCurrentScalingMode; |
Robert Carr | c3574f7 | 2016-03-24 12:19:32 -0700 | [diff] [blame] | 548 | // We encode unset as -1. |
| 549 | int32_t mOverrideScalingMode; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 550 | bool mCurrentOpacity; |
Dan Stoza | cac3538 | 2016-01-27 12:21:06 -0800 | [diff] [blame] | 551 | std::atomic<uint64_t> mCurrentFrameNumber; |
Mathias Agopian | 4d143ee | 2012-02-23 20:05:39 -0800 | [diff] [blame] | 552 | bool mRefreshPending; |
Jamie Gennis | e8696a4 | 2012-01-15 18:54:57 -0800 | [diff] [blame] | 553 | bool mFrameLatencyNeeded; |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 554 | // Whether filtering is forced on or not |
| 555 | bool mFiltering; |
| 556 | // Whether filtering is needed b/c of the drawingstate |
| 557 | bool mNeedsFiltering; |
Mathias Agopian | 5cdc899 | 2013-08-13 20:51:23 -0700 | [diff] [blame] | 558 | // The mesh used to draw the layer in GLES composition mode |
| 559 | mutable Mesh mMesh; |
Andy McFadden | 4df87bd | 2014-04-21 18:08:54 -0700 | [diff] [blame] | 560 | // The texture used to draw the layer in GLES composition mode |
Mathias Agopian | 49457ac | 2013-08-14 18:20:17 -0700 | [diff] [blame] | 561 | mutable Texture mTexture; |
Mathias Agopian | d606de6 | 2010-05-10 20:06:11 -0700 | [diff] [blame] | 562 | |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 563 | #ifdef USE_HWC2 |
| 564 | // HWC items, accessed from the main thread |
| 565 | struct HWCInfo { |
| 566 | HWCInfo() |
| 567 | : layer(), |
| 568 | forceClientComposition(false), |
| 569 | compositionType(HWC2::Composition::Invalid), |
| 570 | clearClientTarget(false) {} |
| 571 | |
| 572 | std::shared_ptr<HWC2::Layer> layer; |
| 573 | bool forceClientComposition; |
| 574 | HWC2::Composition compositionType; |
| 575 | bool clearClientTarget; |
| 576 | }; |
| 577 | std::unordered_map<int32_t, HWCInfo> mHwcLayers; |
Pablo Ceballos | 40845df | 2016-01-25 17:41:15 -0800 | [diff] [blame] | 578 | #else |
| 579 | bool mIsGlesComposition; |
Dan Stoza | 9e56aa0 | 2015-11-02 13:00:03 -0800 | [diff] [blame] | 580 | #endif |
| 581 | |
Mathias Agopian | b7e930d | 2010-06-01 15:12:58 -0700 | [diff] [blame] | 582 | // page-flip thread (currently main thread) |
Glenn Kasten | 16f0453 | 2011-01-19 15:27:27 -0800 | [diff] [blame] | 583 | bool mProtectedByApp; // application requires protected path to external sink |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 584 | |
| 585 | // protected by mLock |
| 586 | mutable Mutex mLock; |
Mathias Agopian | 4d9b822 | 2013-03-12 17:11:48 -0700 | [diff] [blame] | 587 | // Set to true once we've returned this surface's handle |
Mathias Agopian | 13127d8 | 2013-03-05 17:47:11 -0800 | [diff] [blame] | 588 | mutable bool mHasSurface; |
| 589 | const wp<Client> mClientRef; |
Riley Andrews | 03414a1 | 2014-07-01 14:22:59 -0700 | [diff] [blame] | 590 | |
| 591 | // This layer can be a cursor on some displays. |
| 592 | bool mPotentialCursor; |
Dan Stoza | 6b9454d | 2014-11-07 16:00:59 -0800 | [diff] [blame] | 593 | |
| 594 | // Local copy of the queued contents of the incoming BufferQueue |
| 595 | mutable Mutex mQueueItemLock; |
Dan Stoza | a4650a5 | 2015-05-12 12:56:16 -0700 | [diff] [blame] | 596 | Condition mQueueItemCondition; |
Dan Stoza | 6b9454d | 2014-11-07 16:00:59 -0800 | [diff] [blame] | 597 | Vector<BufferItem> mQueueItems; |
Dan Stoza | cac3538 | 2016-01-27 12:21:06 -0800 | [diff] [blame] | 598 | std::atomic<uint64_t> mLastFrameNumberReceived; |
Dan Stoza | 65476f3 | 2015-05-14 09:27:25 -0700 | [diff] [blame] | 599 | bool mUpdateTexImageFailed; // This is only modified from the main thread |
Pablo Ceballos | 0631218 | 2015-10-07 16:32:12 -0700 | [diff] [blame] | 600 | |
Pablo Ceballos | ff95aab | 2016-01-13 17:09:58 -0800 | [diff] [blame] | 601 | bool mAutoRefresh; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 602 | }; |
| 603 | |
| 604 | // --------------------------------------------------------------------------- |
| 605 | |
| 606 | }; // namespace android |
| 607 | |
| 608 | #endif // ANDROID_LAYER_H |