blob: 03f620a8de20b6a250caf2d087832790c32851d3 [file] [log] [blame]
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -08001/*
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
Dominik Laskowski9dab3432019-03-27 13:21:10 -070017#pragma once
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080018
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080019#include <sys/types.h>
20
Mathias Agopian3f844832013-08-07 21:24:32 -070021/*
22 * NOTE: Make sure this file doesn't include anything from <gl/ > or <gl2/ >
23 */
Mathias Agopian921e6ac2012-07-23 23:11:29 -070024
Dominik Laskowski83b88212018-12-11 13:34:06 -080025#include <android-base/thread_annotations.h>
Steven Moreland2716e112018-02-23 14:57:20 -080026#include <cutils/atomic.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080027#include <cutils/compiler.h>
28#include <gui/BufferQueue.h>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080029#include <gui/FrameTimestamps.h>
Mathias Agopian90ac7992012-02-25 18:48:35 -080030#include <gui/ISurfaceComposer.h>
31#include <gui/ISurfaceComposerClient.h>
Robert Carr4cdc58f2017-08-23 14:22:20 -070032#include <gui/LayerState.h>
Dan Stozae77c7662016-05-13 11:37:28 -070033#include <gui/OccupancyTracker.h>
Mathias Agopian86303202012-07-24 22:46:10 -070034#include <hardware/hwcomposer_defs.h>
chaviw291d88a2019-02-14 10:33:58 -080035#include <input/ISetInputWindowsListener.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080036#include <layerproto/LayerProtoHeader.h>
37#include <math/mat4.h>
Vishnu Nair35798872017-10-06 16:00:36 -070038#include <serviceutils/PriorityDumper.h>
Michael Wright28f24d02016-07-12 13:30:53 -070039#include <system/graphics.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080040#include <ui/FenceTime.h>
41#include <ui/PixelFormat.h>
42#include <utils/Errors.h>
43#include <utils/KeyedVector.h>
44#include <utils/RefBase.h>
45#include <utils/SortedVector.h>
46#include <utils/Trace.h>
47#include <utils/threads.h>
Michael Wright28f24d02016-07-12 13:30:53 -070048
Marissa Wall947d34e2019-03-29 14:03:53 -070049#include "ClientCache.h"
Mathias Agopian92a979a2012-08-02 18:32:23 -070050#include "DisplayDevice.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080051#include "DisplayHardware/HWC2.h"
Peiyong Lin74ca2f42019-01-14 19:36:57 -080052#include "DisplayHardware/PowerAdvisor.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080053#include "Effects/Daltonizer.h"
Jamie Gennis4b0eba92013-02-05 13:30:24 -080054#include "FrameTracker.h"
Yiwei Zhang7124ad32018-02-21 13:02:45 -080055#include "LayerStats.h"
Robert Carr2047fae2016-11-28 14:09:09 -080056#include "LayerVector.h"
Dominik Laskowskiccf37d72019-02-01 16:47:58 -080057#include "Scheduler/RefreshRateConfigs.h"
Ana Krulecb43429d2019-01-09 14:28:51 -080058#include "Scheduler/RefreshRateStats.h"
Ana Krulec98b5b242018-08-10 15:03:23 -070059#include "Scheduler/Scheduler.h"
Ana Krulecfefcb582018-08-07 14:22:37 -070060#include "Scheduler/VSyncModulator.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080061#include "SurfaceFlingerFactory.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080062#include "SurfaceTracing.h"
Ady Abraham50204dd2019-07-19 15:47:11 -070063#include "TracedOrdinal.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080064#include "TransactionCompletedThread.h"
Mathias Agopian86303202012-07-24 22:46:10 -070065
Dominik Laskowski83b88212018-12-11 13:34:06 -080066#include <atomic>
67#include <cstdint>
Dominik Laskowskic2867142019-01-21 11:33:38 -080068#include <functional>
Dan Stozae77c7662016-05-13 11:37:28 -070069#include <map>
Dominik Laskowski83b88212018-12-11 13:34:06 -080070#include <memory>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080071#include <mutex>
Dominik Laskowskieddeda12019-07-19 11:54:13 -070072#include <optional>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080073#include <queue>
Dominik Laskowski075d3172018-05-24 15:50:06 -070074#include <set>
Dan Stozae77c7662016-05-13 11:37:28 -070075#include <string>
Steven Thomasb02664d2017-07-26 18:48:28 -070076#include <thread>
Dominik Laskowskic2867142019-01-21 11:33:38 -080077#include <type_traits>
Dominik Laskowski075d3172018-05-24 15:50:06 -070078#include <unordered_map>
Dominik Laskowski22488f62019-03-28 09:53:04 -070079#include <unordered_set>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080080#include <utility>
Dan Stozae77c7662016-05-13 11:37:28 -070081
chaviw1d044282017-09-27 12:19:28 -070082using namespace android::surfaceflinger;
83
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080084namespace android {
85
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080086class Client;
Lloyd Pique144e1162017-12-20 16:44:52 -080087class EventThread;
Dominik Laskowski9dab3432019-03-27 13:21:10 -070088class HWComposer;
Lloyd Pique12eb4232018-01-17 11:54:43 -080089class IGraphicBufferProducer;
Robert Carr720e5062018-07-30 17:45:14 -070090class IInputFlinger;
Sahil Dhanjuc1ba5c42016-06-07 20:09:20 -070091class InjectVSyncSource;
Lloyd Pique144e1162017-12-20 16:44:52 -080092class Layer;
Dominik Laskowski9dab3432019-03-27 13:21:10 -070093class MessageBase;
Ady Abraham03b02dd2019-03-21 15:40:11 -070094class RefreshRateOverlay;
Dominik Laskowski9dab3432019-03-27 13:21:10 -070095class RegionSamplingThread;
Yiwei Zhang7e666a52018-11-15 13:33:42 -080096class TimeStats;
Lloyd Pique144e1162017-12-20 16:44:52 -080097
Lloyd Pique542307f2018-10-19 13:24:08 -070098namespace compositionengine {
99class DisplaySurface;
100} // namespace compositionengine
101
Peiyong Lin833074a2018-08-28 11:53:54 -0700102namespace renderengine {
Lloyd Pique144e1162017-12-20 16:44:52 -0800103class RenderEngine;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700104} // namespace renderengine
chaviwa76b2712017-09-20 12:02:26 -0700105
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800106namespace dvr {
107class VrFlinger;
108} // namespace dvr
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800109
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800110enum {
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700111 eTransactionNeeded = 0x01,
112 eTraversalNeeded = 0x02,
Mathias Agopiane57f2922012-08-09 16:29:12 -0700113 eDisplayTransactionNeeded = 0x04,
Lloyd Piqued432a7c2018-03-23 16:05:31 -0700114 eDisplayLayerStackChanged = 0x08,
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700115 eTransactionFlushNeeded = 0x10,
116 eTransactionMask = 0x1f,
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800117};
118
Peiyong Lindd9b2ae2018-03-01 16:22:45 -0800119enum class DisplayColorSetting : int32_t {
120 MANAGED = 0,
121 UNMANAGED = 1,
122 ENHANCED = 2,
123};
124
David Sodman105b7dc2017-11-04 20:28:14 -0700125class SurfaceFlingerBE
126{
127public:
128 SurfaceFlingerBE();
129
David Sodmanbc815282017-11-05 18:57:52 -0800130 const std::string mHwcServiceName; // "default" for real use, something else for testing.
131
David Sodman73beded2017-11-15 11:56:06 -0800132 FenceTimeline mGlCompositionDoneTimeline;
133 FenceTimeline mDisplayTimeline;
David Sodmanbc815282017-11-05 18:57:52 -0800134
David Sodman99974d22017-11-28 12:04:33 -0800135 // protected by mCompositorTimingLock;
136 mutable std::mutex mCompositorTimingLock;
137 CompositorTiming mCompositorTiming;
Lloyd Piquefcd86612017-12-14 17:15:36 -0800138
David Sodman99974d22017-11-28 12:04:33 -0800139 // Only accessed from the main thread.
140 struct CompositePresentTime {
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700141 nsecs_t composite = -1;
142 std::shared_ptr<FenceTime> display = FenceTime::NO_FENCE;
David Sodman99974d22017-11-28 12:04:33 -0800143 };
144 std::queue<CompositePresentTime> mCompositePresentTimes;
145
David Sodman4a36e932017-11-07 14:29:47 -0800146 static const size_t NUM_BUCKETS = 8; // < 1-7, 7+
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700147 nsecs_t mFrameBuckets[NUM_BUCKETS] = {};
148 nsecs_t mTotalTime = 0;
149 std::atomic<nsecs_t> mLastSwapTime = 0;
David Sodman4a36e932017-11-07 14:29:47 -0800150
David Sodmancbaf0832017-11-07 14:21:36 -0800151 // Double- vs. triple-buffering stats
152 struct BufferingStats {
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700153 size_t numSegments = 0;
154 nsecs_t totalTime = 0;
David Sodmancbaf0832017-11-07 14:21:36 -0800155
156 // "Two buffer" means that a third buffer was never used, whereas
157 // "double-buffered" means that on average the segment only used two
158 // buffers (though it may have used a third for some part of the
159 // segment)
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700160 nsecs_t twoBufferTime = 0;
161 nsecs_t doubleBufferedTime = 0;
162 nsecs_t tripleBufferedTime = 0;
David Sodmancbaf0832017-11-07 14:21:36 -0800163 };
164 mutable Mutex mBufferingStatsMutex;
165 std::unordered_map<std::string, BufferingStats> mBufferingStats;
166
David Sodman105b7dc2017-11-04 20:28:14 -0700167 // The composer sequence id is a monotonically increasing integer that we
168 // use to differentiate callbacks from different hardware composer
169 // instances. Each hardware composer instance gets a different sequence id.
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700170 int32_t mComposerSequenceId = 0;
chaviw291d88a2019-02-14 10:33:58 -0800171};
David Sodman105b7dc2017-11-04 20:28:14 -0700172
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700173class SurfaceFlinger : public BnSurfaceComposer,
Vishnu Nair35798872017-10-06 16:00:36 -0700174 public PriorityDumper,
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700175 private IBinder::DeathRecipient,
Steven Thomasb02664d2017-07-26 18:48:28 -0700176 private HWC2::ComposerCallback
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800177{
178public:
David Sodman105b7dc2017-11-04 20:28:14 -0700179 SurfaceFlingerBE& getBE() { return mBE; }
180 const SurfaceFlingerBE& getBE() const { return mBE; }
Fabien Sanglard0cc19382017-03-06 11:54:40 -0800181
Fabien Sanglard0cc19382017-03-06 11:54:40 -0800182 // This is the phase offset in nanoseconds of the software vsync event
183 // relative to the vsync event reported by HWComposer. The software vsync
184 // event is when SurfaceFlinger and Choreographer-based applications run each
185 // frame.
186 //
187 // This phase offset allows adjustment of the minimum latency from application
188 // wake-up time (by Choreographer) to the time at which the resulting window
189 // image is displayed. This value may be either positive (after the HW vsync)
190 // or negative (before the HW vsync). Setting it to 0 will result in a lower
191 // latency bound of two vsync periods because the app and SurfaceFlinger
192 // will run just after the HW vsync. Setting it to a positive number will
193 // result in the minimum latency being:
194 //
195 // (2 * VSYNC_PERIOD - (vsyncPhaseOffsetNs % VSYNC_PERIOD))
196 //
197 // Note that reducing this latency makes it more likely for the applications
198 // to not have their window content image ready in time. When this happens
199 // the latency will end up being an additional vsync period, and animations
200 // will hiccup. Therefore, this latency should be tuned somewhat
201 // conservatively (or at least with awareness of the trade-off being made).
202 static int64_t vsyncPhaseOffsetNs;
203 static int64_t sfVsyncPhaseOffsetNs;
204
Fabien Sanglardcbf153b2017-03-10 17:57:12 -0800205 // If fences from sync Framework are supported.
206 static bool hasSyncFramework;
207
Fabien Sanglardc45a7d92017-03-14 13:24:22 -0700208 // The offset in nanoseconds to use when DispSync timestamps present fence
209 // signaling time.
210 static int64_t dispSyncPresentTimeOffset;
211
Fabien Sanglarda34ed632017-03-14 11:43:52 -0700212 // Some hardware can do RGB->YUV conversion more efficiently in hardware
213 // controlled by HWC than in hardware controlled by the video encoder.
214 // This instruct VirtualDisplaySurface to use HWC for such conversion on
215 // GL composition.
216 static bool useHwcForRgbToYuv;
217
Fabien Sanglardc8e387e2017-03-10 10:30:28 -0800218 // Maximum dimension supported by HWC for virtual display.
219 // Equal to min(max_height, max_width).
220 static uint64_t maxVirtualDisplaySize;
221
Fabien Sanglard1971b632017-03-10 14:50:03 -0800222 // Controls the number of buffers SurfaceFlinger will allocate for use in
223 // FramebufferSurface
224 static int64_t maxFrameBufferAcquiredBuffers;
225
Peiyong Lin13effd12018-07-24 17:01:47 -0700226 // Indicate if a device has wide color gamut display. This is typically
227 // found on devices with wide color gamut (e.g. Display-P3) display.
Courtney Goeltzenleuchter5d943892017-03-22 13:46:46 -0600228 static bool hasWideColorDisplay;
229
Chia-I Wu304d9cd2018-08-27 14:38:14 -0700230 static int primaryDisplayOrientation;
231
Peiyong Lin13effd12018-07-24 17:01:47 -0700232 // Indicate if device wants color management on its display.
233 static bool useColorManagement;
234
Peiyong Linb3839ad2018-09-05 15:37:19 -0700235 static bool useContextPriority;
236
Peiyong Lin0256f722018-08-31 15:45:10 -0700237 // The data space and pixel format that SurfaceFlinger expects hardware composer
238 // to composite efficiently. Meaning under most scenarios, hardware composer
239 // will accept layers with the data space and pixel format.
Peiyong Linc6780972018-10-28 15:24:08 -0700240 static ui::Dataspace defaultCompositionDataspace;
241 static ui::PixelFormat defaultCompositionPixelFormat;
242
243 // The data space and pixel format that SurfaceFlinger expects hardware composer
244 // to composite efficiently for wide color gamut surfaces. Meaning under most scenarios,
245 // hardware composer will accept layers with the data space and pixel format.
246 static ui::Dataspace wideColorGamutCompositionDataspace;
247 static ui::PixelFormat wideColorGamutCompositionPixelFormat;
Peiyong Lin0256f722018-08-31 15:45:10 -0700248
Mathias Agopianb6df7d02013-05-09 14:53:35 -0700249 static char const* getServiceName() ANDROID_API {
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700250 return "SurfaceFlinger";
251 }
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800252
Lloyd Piqueac648ee2018-01-17 13:42:24 -0800253 struct SkipInitializationTag {};
254 static constexpr SkipInitializationTag SkipInitialization;
Lloyd Pique90c115d2018-09-18 21:39:42 -0700255 SurfaceFlinger(surfaceflinger::Factory&, SkipInitializationTag) ANDROID_API;
256 explicit SurfaceFlinger(surfaceflinger::Factory&) ANDROID_API;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800257
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700258 // must be called before clients can connect
259 void init() ANDROID_API;
260
261 // starts SurfaceFlinger main loop in the current thread
262 void run() ANDROID_API;
263
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700264 // post an asynchronous message to the main thread
Mathias Agopian3f844832013-08-07 21:24:32 -0700265 status_t postMessageAsync(const sp<MessageBase>& msg, nsecs_t reltime = 0, uint32_t flags = 0);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800266
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700267 // post a synchronous message to the main thread
Vishnu Nair8406fd72019-07-30 11:29:31 -0700268 status_t postMessageSync(const sp<MessageBase>& msg, nsecs_t reltime = 0, uint32_t flags = 0)
269 EXCLUDES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800270
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700271 // force full composition on all displays
272 void repaintEverything();
Mathias Agopianbf2c6a62010-12-10 16:22:31 -0800273
Ana Krulec7d1d6832018-12-27 11:10:09 -0800274 // force full composition on all displays without resetting the scheduler idle timer.
275 void repaintEverythingForHWC();
276
Lloyd Pique90c115d2018-09-18 21:39:42 -0700277 surfaceflinger::Factory& getFactory() { return mFactory; }
278
Lloyd Pique70d91362018-10-18 16:02:55 -0700279 // The CompositionEngine encapsulates all composition related interfaces and actions.
280 compositionengine::CompositionEngine& getCompositionEngine() const;
281
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700282 // returns the default Display
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800283 sp<const DisplayDevice> getDefaultDisplayDevice() {
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700284 Mutex::Autolock _l(mStateLock);
285 return getDefaultDisplayDeviceLocked();
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700286 }
Mathias Agopianb60314a2012-04-10 22:09:54 -0700287
Dan Stoza436ccf32018-06-21 12:10:12 -0700288 // Obtains a name from the texture pool, or, if the pool is empty, posts a
289 // synchronous message to the main thread to obtain one on the fly
290 uint32_t getNewTexture();
291
Mathias Agopian86303202012-07-24 22:46:10 -0700292 // utility function to delete a texture on the main thread
Mathias Agopian3f844832013-08-07 21:24:32 -0700293 void deleteTextureAsync(uint32_t texture);
Mathias Agopian86303202012-07-24 22:46:10 -0700294
Mathias Agopian86303202012-07-24 22:46:10 -0700295 // enable/disable h/w composer event
296 // TODO: this should be made accessible only to EventThread
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800297 void setPrimaryVsyncEnabled(bool enabled);
Mathias Agopian86303202012-07-24 22:46:10 -0700298
Ady Abraham9ba25122019-06-03 17:10:55 -0700299 // main thread function to enable/disable h/w composer event
300 void setPrimaryVsyncEnabledInternal(bool enabled);
Dominik Laskowskia8955dd2019-07-10 10:19:09 -0700301 void setVsyncEnabledInHWC(DisplayId displayId, HWC2::Vsync enabled);
Ady Abraham9ba25122019-06-03 17:10:55 -0700302
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700303 // called on the main thread by MessageQueue when an internal message
304 // is received
305 // TODO: this should be made accessible only to MessageQueue
306 void onMessageReceived(int32_t what);
Mathias Agopian3094df32012-06-18 18:06:45 -0700307
Lloyd Piqueb97e04f2018-10-18 17:07:05 -0700308 renderengine::RenderEngine& getRenderEngine() const;
Jesse Hall29c3f352013-05-21 15:36:55 -0700309
Robert Carr0d480722017-01-10 16:42:54 -0800310 bool authenticateSurfaceTextureLocked(
311 const sp<IGraphicBufferProducer>& bufferProducer) const;
312
Robert Carr2e102c92018-10-23 12:11:15 -0700313 inline void onLayerCreated() { mNumLayers++; }
chaviw74d90ad2019-04-26 14:45:26 -0700314 inline void onLayerDestroyed(Layer* layer) {
315 mNumLayers--;
316 mOffscreenLayers.erase(layer);
317 }
Robert Carr2e102c92018-10-23 12:11:15 -0700318
Marissa Walle2ffb422018-10-12 11:33:52 -0700319 TransactionCompletedThread& getTransactionCompletedThread() {
320 return mTransactionCompletedThread;
321 }
322
Robert Carrc0df3122019-04-11 13:18:21 -0700323 sp<Layer> fromHandle(const sp<IBinder>& handle) REQUIRES(mStateLock);
324
Mathias Agopian1f339ff2011-07-01 17:08:43 -0700325private:
David Sodman0c69cad2017-08-21 12:12:51 -0700326 friend class BufferLayer;
Marissa Wallfd668622018-05-10 10:21:13 -0700327 friend class BufferQueueLayer;
Marissa Wall61c58622018-07-18 10:12:20 -0700328 friend class BufferStateLayer;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700329 friend class Client;
330 friend class Layer;
Dan Stozab9b08832014-03-13 11:55:57 -0700331 friend class MonitoredProducer;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700332 friend class RefreshRateOverlay;
Dan Stozaec460082018-12-17 15:35:09 -0800333 friend class RegionSamplingThread;
Nataniel Borges2b796da2019-02-15 13:32:18 -0800334 friend class SurfaceTracing;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800335
Lloyd Piquef58625d2017-12-19 13:22:33 -0800336 // For unit tests
337 friend class TestableSurfaceFlinger;
338
Jamie Gennis6547ff42013-07-16 20:12:42 -0700339 // This value is specified in number of frames. Log frame stats at most
340 // every half hour.
341 enum { LOG_FRAME_STATS_PERIOD = 30*60*60 };
342
Dan Stoza7d89d062015-04-30 13:29:25 -0700343 static const size_t MAX_LAYERS = 4096;
Nataniel Borges2b796da2019-02-15 13:32:18 -0800344 static const int MAX_TRACING_MEMORY = 100 * 1024 * 1024; // 100MB
Dan Stoza7d89d062015-04-30 13:29:25 -0700345
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700346 // We're reference counted, never destroy SurfaceFlinger directly
347 virtual ~SurfaceFlinger();
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800348
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700349 /* ------------------------------------------------------------------------
350 * Internal data structures
351 */
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800352
Robert Carr2047fae2016-11-28 14:09:09 -0800353 class State {
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800354 public:
chaviwfd462612018-05-31 16:11:27 -0700355 explicit State(LayerVector::StateSet set) : stateSet(set), layersSortedByZ(set) {}
Dan Stoza412903f2017-04-27 13:42:17 -0700356 State& operator=(const State& other) {
357 // We explicitly don't copy stateSet so that, e.g., mDrawingState
358 // always uses the Drawing StateSet.
359 layersSortedByZ = other.layersSortedByZ;
360 displays = other.displays;
Chia-I Wu28f320b2018-05-03 11:02:56 -0700361 colorMatrixChanged = other.colorMatrixChanged;
362 if (colorMatrixChanged) {
363 colorMatrix = other.colorMatrix;
364 }
Dan Stoza412903f2017-04-27 13:42:17 -0700365 return *this;
366 }
367
368 const LayerVector::StateSet stateSet = LayerVector::StateSet::Invalid;
Mathias Agopian92a979a2012-08-02 18:32:23 -0700369 LayerVector layersSortedByZ;
Mathias Agopiane57f2922012-08-09 16:29:12 -0700370 DefaultKeyedVector< wp<IBinder>, DisplayDeviceState> displays;
Robert Carr2047fae2016-11-28 14:09:09 -0800371
Chia-I Wu28f320b2018-05-03 11:02:56 -0700372 bool colorMatrixChanged = true;
373 mat4 colorMatrix;
374
Dan Stoza412903f2017-04-27 13:42:17 -0700375 void traverseInZOrder(const LayerVector::Visitor& visitor) const;
376 void traverseInReverseZOrder(const LayerVector::Visitor& visitor) const;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800377 };
378
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700379 /* ------------------------------------------------------------------------
380 * IBinder interface
381 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800382 status_t onTransact(uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) override;
383 status_t dump(int fd, const Vector<String16>& args) override { return priorityDump(fd, args); }
Robert Carr14167e02019-02-13 13:50:55 -0800384 bool callingThreadHasUnscopedSurfaceFlingerAccess() EXCLUDES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800385
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700386 /* ------------------------------------------------------------------------
387 * ISurfaceComposer interface
388 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800389 sp<ISurfaceComposerClient> createConnection() override;
390 sp<IBinder> createDisplay(const String8& displayName, bool secure) override;
391 void destroyDisplay(const sp<IBinder>& displayToken) override;
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800392 std::vector<PhysicalDisplayId> getPhysicalDisplayIds() const override;
393 sp<IBinder> getPhysicalDisplayToken(PhysicalDisplayId displayId) const override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800394 void setTransactionState(const Vector<ComposerState>& state,
395 const Vector<DisplayState>& displays, uint32_t flags,
396 const sp<IBinder>& applyToken,
Marissa Wall17b4e452018-12-26 16:32:34 -0800397 const InputWindowCommands& inputWindowCommands,
Marissa Wall947d34e2019-03-29 14:03:53 -0700398 int64_t desiredPresentTime, const client_cache_t& uncacheBuffer,
Marissa Wall3dad52d2019-03-22 14:03:19 -0700399 const std::vector<ListenerCallbacks>& listenerCallbacks) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800400 void bootFinished() override;
401 bool authenticateSurfaceTexture(
402 const sp<IGraphicBufferProducer>& bufferProducer) const override;
403 status_t getSupportedFrameTimestamps(std::vector<FrameEvent>* outSupported) const override;
404 sp<IDisplayEventConnection> createDisplayEventConnection(
Ady Abraham0f4a1b12019-06-04 16:04:04 -0700405 ISurfaceComposer::VsyncSource vsyncSource = eVsyncSourceApp,
406 ISurfaceComposer::ConfigChanged configChanged =
407 ISurfaceComposer::eConfigChangedSuppress) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800408 status_t captureScreen(const sp<IBinder>& displayToken, sp<GraphicBuffer>* outBuffer,
Robert Carr108b2c72019-04-02 16:32:58 -0700409 bool& outCapturedSecureLayers, const ui::Dataspace reqDataspace,
410 const ui::PixelFormat reqPixelFormat, Rect sourceCrop,
411 uint32_t reqWidth, uint32_t reqHeight,
412 bool useIdentityTransform, ISurfaceComposer::Rotation rotation, bool captureSecureLayers) override;
chaviw93df2ea2019-04-30 16:45:12 -0700413 status_t captureScreen(uint64_t displayOrLayerStack, ui::Dataspace* outDataspace,
414 sp<GraphicBuffer>* outBuffer) override;
Robert Carr866455f2019-04-02 16:28:26 -0700415 status_t captureLayers(
416 const sp<IBinder>& parentHandle, sp<GraphicBuffer>* outBuffer,
417 const ui::Dataspace reqDataspace, const ui::PixelFormat reqPixelFormat,
418 const Rect& sourceCrop,
419 const std::unordered_set<sp<IBinder>, ISurfaceComposer::SpHash<IBinder>>& exclude,
420 float frameScale, bool childrenOnly) override;
Robert Carr108b2c72019-04-02 16:32:58 -0700421
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800422 status_t getDisplayStats(const sp<IBinder>& displayToken, DisplayStatInfo* stats) override;
423 status_t getDisplayConfigs(const sp<IBinder>& displayToken,
Dominik Laskowski22488f62019-03-28 09:53:04 -0700424 Vector<DisplayInfo>* configs) override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800425 int getActiveConfig(const sp<IBinder>& displayToken) override;
426 status_t getDisplayColorModes(const sp<IBinder>& displayToken,
427 Vector<ui::ColorMode>* configs) override;
Daniel Solomon42d04562019-01-20 21:03:19 -0800428 status_t getDisplayNativePrimaries(const sp<IBinder>& displayToken,
429 ui::DisplayPrimaries &primaries);
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800430 ui::ColorMode getActiveColorMode(const sp<IBinder>& displayToken) override;
431 status_t setActiveColorMode(const sp<IBinder>& displayToken, ui::ColorMode colorMode) override;
432 void setPowerMode(const sp<IBinder>& displayToken, int mode) override;
433 status_t setActiveConfig(const sp<IBinder>& displayToken, int id) override;
434 status_t clearAnimationFrameStats() override;
435 status_t getAnimationFrameStats(FrameStats* outStats) const override;
436 status_t getHdrCapabilities(const sp<IBinder>& displayToken,
437 HdrCapabilities* outCapabilities) const override;
438 status_t enableVSyncInjections(bool enable) override;
439 status_t injectVSync(nsecs_t when) override;
440 status_t getLayerDebugInfo(std::vector<LayerDebugInfo>* outLayers) const override;
441 status_t getColorManagement(bool* outGetColorManagement) const override;
Peiyong Linc6780972018-10-28 15:24:08 -0700442 status_t getCompositionPreference(ui::Dataspace* outDataspace, ui::PixelFormat* outPixelFormat,
443 ui::Dataspace* outWideColorGamutDataspace,
444 ui::PixelFormat* outWideColorGamutPixelFormat) const override;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800445 status_t getDisplayedContentSamplingAttributes(const sp<IBinder>& display,
446 ui::PixelFormat* outFormat,
447 ui::Dataspace* outDataspace,
448 uint8_t* outComponentMask) const override;
449 status_t setDisplayContentSamplingEnabled(const sp<IBinder>& display, bool enable,
450 uint8_t componentMask,
451 uint64_t maxFrames) const override;
452 status_t getDisplayedContentSample(const sp<IBinder>& display, uint64_t maxFrames,
453 uint64_t timestamp,
454 DisplayedFrameStats* outStats) const override;
Peiyong Lin3c2791e2019-01-14 17:05:18 -0800455 status_t getProtectedContentSupport(bool* outSupported) const override;
Peiyong Lin4f3fddf2019-01-24 17:21:24 -0800456 status_t isWideColorDisplay(const sp<IBinder>& displayToken,
457 bool* outIsWideColorDisplay) const override;
Dan Stoza84ab9372018-12-17 15:27:57 -0800458 status_t addRegionSamplingListener(const Rect& samplingArea, const sp<IBinder>& stopLayerHandle,
459 const sp<IRegionSamplingListener>& listener) override;
460 status_t removeRegionSamplingListener(const sp<IRegionSamplingListener>& listener) override;
Ady Abraham838de062019-02-04 10:24:03 -0800461 status_t setAllowedDisplayConfigs(const sp<IBinder>& displayToken,
462 const std::vector<int32_t>& allowedConfigs) override;
Ady Abrahamd9b3ea62019-02-26 14:08:03 -0800463 status_t getAllowedDisplayConfigs(const sp<IBinder>& displayToken,
464 std::vector<int32_t>* outAllowedConfigs) override;
Dan Gittik57e63c52019-01-18 16:37:54 +0000465 status_t getDisplayBrightnessSupport(const sp<IBinder>& displayToken,
466 bool* outSupport) const override;
467 status_t setDisplayBrightness(const sp<IBinder>& displayToken, float brightness) const override;
Ady Abraham8532d012019-05-08 14:50:56 -0700468 status_t notifyPowerHint(int32_t hintId) override;
Ady Abraham838de062019-02-04 10:24:03 -0800469
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700470 /* ------------------------------------------------------------------------
471 * DeathRecipient interface
472 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800473 void binderDied(const wp<IBinder>& who) override;
Mathias Agopian99ce5cd2012-01-31 18:24:27 -0800474
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700475 /* ------------------------------------------------------------------------
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700476 * RefBase interface
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700477 */
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800478 void onFirstRef() override;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800479
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700480 /* ------------------------------------------------------------------------
Steven Thomasb02664d2017-07-26 18:48:28 -0700481 * HWC2::ComposerCallback / HWComposer::EventHandler interface
Mathias Agopian86303202012-07-24 22:46:10 -0700482 */
Dominik Laskowskia2edf612018-06-01 13:15:16 -0700483 void onVsyncReceived(int32_t sequenceId, hwc2_display_t hwcDisplayId,
Steven Thomasb02664d2017-07-26 18:48:28 -0700484 int64_t timestamp) override;
Dominik Laskowskia2edf612018-06-01 13:15:16 -0700485 void onHotplugReceived(int32_t sequenceId, hwc2_display_t hwcDisplayId,
Lloyd Pique715a2c12017-12-14 17:18:08 -0800486 HWC2::Connection connection) override;
Dominik Laskowskia2edf612018-06-01 13:15:16 -0700487 void onRefreshReceived(int32_t sequenceId, hwc2_display_t hwcDisplayId) override;
Mathias Agopian86303202012-07-24 22:46:10 -0700488
489 /* ------------------------------------------------------------------------
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700490 * Message handling
491 */
492 void waitForEvent();
Steven Thomas6d8110b2017-08-31 18:24:21 -0700493 // Can only be called from the main thread or with mStateLock held
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700494 void signalTransaction();
Steven Thomas6d8110b2017-08-31 18:24:21 -0700495 // Can only be called from the main thread or with mStateLock held
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700496 void signalLayerUpdate();
497 void signalRefresh();
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800498
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700499 using RefreshRateType = scheduler::RefreshRateConfigs::RefreshRateType;
500
Ady Abraham03b02dd2019-03-21 15:40:11 -0700501 struct ActiveConfigInfo {
502 RefreshRateType type;
503 int configId;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700504 Scheduler::ConfigEvent event;
505
506 bool operator!=(const ActiveConfigInfo& other) const {
Dominik Laskowski22488f62019-03-28 09:53:04 -0700507 return type != other.type || configId != other.configId || event != other.event;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700508 }
509 };
510
Andy McFadden13a082e2012-08-24 10:16:42 -0700511 // called on the main thread in response to initializeDisplays()
Dominik Laskowski83b88212018-12-11 13:34:06 -0800512 void onInitializeDisplays() REQUIRES(mStateLock);
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800513 // Sets the desired active config bit. It obtains the lock, and sets mDesiredActiveConfig.
Ady Abraham03b02dd2019-03-21 15:40:11 -0700514 void setDesiredActiveConfig(const ActiveConfigInfo& info) REQUIRES(mStateLock);
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800515 // Once HWC has returned the present fence, this sets the active config and a new refresh
Ady Abraham53852a52019-05-28 18:07:44 -0700516 // rate in SF.
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800517 void setActiveConfigInternal() REQUIRES(mStateLock);
518 // Active config is updated on INVALIDATE call in a state machine-like manner. When the
Ady Abrahamb838aed2019-02-12 15:30:16 -0800519 // desired config was set, HWC needs to update the panel on the next refresh, and when
Ana Kruleca5bdd9d2019-01-29 19:00:58 -0800520 // we receive the fence back, we know that the process was complete. It returns whether
Ady Abrahamb838aed2019-02-12 15:30:16 -0800521 // we need to wait for the next invalidate
Dominik Laskowski22488f62019-03-28 09:53:04 -0700522 bool performSetActiveConfig() REQUIRES(mStateLock);
Ady Abraham53852a52019-05-28 18:07:44 -0700523 // Called when active config is no longer is progress
524 void desiredActiveConfigChangeDone() REQUIRES(mStateLock);
Prashant Malani2c9b11f2014-05-25 01:36:31 -0700525 // called on the main thread in response to setPowerMode()
Dominik Laskowski83b88212018-12-11 13:34:06 -0800526 void setPowerModeInternal(const sp<DisplayDevice>& display, int mode) REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800527
Ady Abraham838de062019-02-04 10:24:03 -0800528 // called on the main thread in response to setAllowedDisplayConfigs()
Dominik Laskowski22488f62019-03-28 09:53:04 -0700529 void setAllowedDisplayConfigsInternal(const sp<DisplayDevice>& display,
530 const std::vector<int32_t>& allowedConfigs)
531 REQUIRES(mStateLock);
Ady Abraham838de062019-02-04 10:24:03 -0800532
Dan Stoza6b9454d2014-11-07 16:00:59 -0800533 // Returns whether the transaction actually modified any state
534 bool handleMessageTransaction();
535
536 // Returns whether a new buffer has been latched (see handlePageFlip())
537 bool handleMessageInvalidate();
538
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700539 void handleMessageRefresh();
Mathias Agopian4fec8732012-06-29 14:12:52 -0700540
Mathias Agopian87baae12012-07-31 12:38:26 -0700541 void handleTransaction(uint32_t transactionFlags);
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800542 void handleTransactionLocked(uint32_t transactionFlags) REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800543
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800544 void updateInputFlinger();
545 void updateInputWindowInfo();
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800546 void commitInputWindowCommands() REQUIRES(mStateLock);
chaviwfbe5d9c2018-12-26 12:23:37 -0800547 void executeInputWindowCommands();
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700548 void setInputWindowsFinished();
Riley Andrews03414a12014-07-01 14:22:59 -0700549 void updateCursorAsync();
550
Dan Stoza6b9454d2014-11-07 16:00:59 -0800551 /* handlePageFlip - latch a new buffer if available and compute the dirty
552 * region. Returns whether a new buffer has been latched, i.e., whether it
553 * is necessary to perform a refresh during this vsync.
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700554 */
Dan Stoza6b9454d2014-11-07 16:00:59 -0800555 bool handlePageFlip();
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800556
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700557 /* ------------------------------------------------------------------------
558 * Transactions
559 */
Marissa Wall713b63f2018-10-17 15:42:43 -0700560 void applyTransactionState(const Vector<ComposerState>& state,
chaviw273171b2018-12-26 11:46:30 -0800561 const Vector<DisplayState>& displays, uint32_t flags,
Robert Carr14167e02019-02-13 13:50:55 -0800562 const InputWindowCommands& inputWindowCommands,
Marissa Wall78b72202019-03-15 14:58:34 -0700563 const int64_t desiredPresentTime,
Marissa Wall947d34e2019-03-29 14:03:53 -0700564 const client_cache_t& uncacheBuffer,
Marissa Wall3dad52d2019-03-22 14:03:19 -0700565 const std::vector<ListenerCallbacks>& listenerCallbacks,
566 const int64_t postTime, bool privileged, bool isMainThread = false)
567 REQUIRES(mStateLock);
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700568 // Returns true if at least one transaction was flushed
Marissa Wall713b63f2018-10-17 15:42:43 -0700569 bool flushTransactionQueues();
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700570 // Returns true if there is at least one transaction that needs to be flushed
571 bool transactionFlushNeeded();
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700572 uint32_t getTransactionFlags(uint32_t flags);
Fabien Sanglardc8251eb2016-12-07 13:59:48 -0800573 uint32_t peekTransactionFlags();
Steven Thomas6d8110b2017-08-31 18:24:21 -0700574 // Can only be called from the main thread or with mStateLock held
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700575 uint32_t setTransactionFlags(uint32_t flags);
Ana Krulec7ecce8c2018-10-12 13:44:41 -0700576 uint32_t setTransactionFlags(uint32_t flags, Scheduler::TransactionStart transactionStart);
chaviw61626f22018-11-15 16:26:27 -0800577 void latchAndReleaseBuffer(const sp<Layer>& layer);
Nataniel Borges2b796da2019-02-15 13:32:18 -0800578 void commitTransaction() REQUIRES(mStateLock);
chaviw74d90ad2019-04-26 14:45:26 -0700579 void commitOffscreenLayers();
Marissa Wall17b4e452018-12-26 16:32:34 -0800580 bool transactionIsReadyToBeApplied(int64_t desiredPresentTime,
Dominik Laskowskia8955dd2019-07-10 10:19:09 -0700581 bool useCachedExpectedPresentTime,
Marissa Wall17b4e452018-12-26 16:32:34 -0800582 const Vector<ComposerState>& states);
Valerie Haubc6ddb12019-03-08 11:10:15 -0800583 uint32_t setClientStateLocked(const ComposerState& composerState, int64_t desiredPresentTime,
Marissa Wall3dad52d2019-03-22 14:03:19 -0700584 const std::vector<ListenerCallbacks>& listenerCallbacks,
Valerie Haubc6ddb12019-03-08 11:10:15 -0800585 int64_t postTime, bool privileged) REQUIRES(mStateLock);
Vishnu Nairce5d0cc2019-02-28 14:38:41 -0800586 uint32_t setDisplayStateLocked(const DisplayState& s) REQUIRES(mStateLock);
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800587 uint32_t addInputWindowCommands(const InputWindowCommands& inputWindowCommands)
588 REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800589
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700590 /* ------------------------------------------------------------------------
591 * Layer management
592 */
Marissa Wall2d814fb2019-04-09 18:52:57 +0000593 status_t createLayer(const String8& name, const sp<Client>& client, uint32_t w, uint32_t h,
594 PixelFormat format, uint32_t flags, LayerMetadata metadata,
Robert Carrc0df3122019-04-11 13:18:21 -0700595 sp<IBinder>* handle, sp<IGraphicBufferProducer>* gbp,
596 const sp<IBinder>& parentHandle, const sp<Layer>& parentLayer = nullptr);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800597
Marissa Wallfd668622018-05-10 10:21:13 -0700598 status_t createBufferQueueLayer(const sp<Client>& client, const String8& name, uint32_t w,
Evan Roskya1f1e152019-01-24 16:17:46 -0800599 uint32_t h, uint32_t flags, LayerMetadata metadata,
600 PixelFormat& format, sp<IBinder>* outHandle,
601 sp<IGraphicBufferProducer>* outGbp, sp<Layer>* outLayer);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800602
Marissa Wall61c58622018-07-18 10:12:20 -0700603 status_t createBufferStateLayer(const sp<Client>& client, const String8& name, uint32_t w,
Evan Roskya1f1e152019-01-24 16:17:46 -0800604 uint32_t h, uint32_t flags, LayerMetadata metadata,
605 sp<IBinder>* outHandle, sp<Layer>* outLayer);
Marissa Wall61c58622018-07-18 10:12:20 -0700606
Evan Roskya1f1e152019-01-24 16:17:46 -0800607 status_t createColorLayer(const sp<Client>& client, const String8& name, uint32_t w, uint32_t h,
608 uint32_t flags, LayerMetadata metadata, sp<IBinder>* outHandle,
609 sp<Layer>* outLayer);
Mathias Agopian74c40c02010-09-29 13:02:36 -0700610
Evan Roskya1f1e152019-01-24 16:17:46 -0800611 status_t createContainerLayer(const sp<Client>& client, const String8& name, uint32_t w,
612 uint32_t h, uint32_t flags, LayerMetadata metadata,
613 sp<IBinder>* outHandle, sp<Layer>* outLayer);
Robert Carr6b3f6c52018-08-13 13:05:17 -0700614
Cody Northropbc755282017-03-31 12:00:08 -0600615 String8 getUniqueLayerName(const String8& name);
616
Rob Carr4bba3702018-10-08 21:53:30 +0000617 // called when all clients have released all their references to
618 // this layer meaning it is entirely safe to destroy all
619 // resources associated to this layer.
Robert Carr695d5282018-12-18 15:27:58 -0800620 void onHandleDestroyed(sp<Layer>& layer);
Robert Carr6fb1a7e2018-12-11 12:07:25 -0800621 void markLayerPendingRemovalLocked(const sp<Layer>& layer);
Mathias Agopiana4912602012-07-12 14:25:33 -0700622
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700623 // add a layer to SurfaceFlinger
Robert Carrc0df3122019-04-11 13:18:21 -0700624 status_t addClientLayer(const sp<Client>& client, const sp<IBinder>& handle,
625 const sp<IGraphicBufferProducer>& gbc, const sp<Layer>& lbc,
626 const sp<IBinder>& parentHandle, const sp<Layer>& parentLayer,
627 bool addToCurrentState);
Mathias Agopianf1d8e872009-04-20 19:39:12 -0700628
Vishnu Nair4351ad52019-02-11 14:13:02 -0800629 // Traverse through all the layers and compute and cache its bounds.
630 void computeLayerBounds();
631
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700632 /* ------------------------------------------------------------------------
633 * Boot animation, on/off animations and screen capture
634 */
Mathias Agopianbb641242010-05-18 17:06:55 -0700635
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700636 void startBootAnim();
Mathias Agopian96f08192010-06-02 23:28:45 -0700637
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700638 using TraverseLayersFunction = std::function<void(const LayerVector::Visitor&)>;
639
chaviwa76b2712017-09-20 12:02:26 -0700640 void renderScreenImplLocked(const RenderArea& renderArea, TraverseLayersFunction traverseLayers,
Alec Mourie7d1d4a2019-02-05 01:13:46 +0000641 ANativeWindowBuffer* buffer, bool useIdentityTransform,
642 int* outSyncFd);
chaviwa76b2712017-09-20 12:02:26 -0700643 status_t captureScreenCommon(RenderArea& renderArea, TraverseLayersFunction traverseLayers,
Peiyong Lin0e003c92018-09-17 11:09:51 -0700644 sp<GraphicBuffer>* outBuffer, const ui::PixelFormat reqPixelFormat,
Robert Carr108b2c72019-04-02 16:32:58 -0700645 bool useIdentityTransform, bool& outCapturedSecureLayers);
Kevin DuBois7cbcc372019-02-25 14:53:28 -0800646 status_t captureScreenCommon(RenderArea& renderArea, TraverseLayersFunction traverseLayers,
Robert Carr108b2c72019-04-02 16:32:58 -0700647 const sp<GraphicBuffer>& buffer, bool useIdentityTransform,
648 bool& outCapturedSecureLayers);
chaviw93df2ea2019-04-30 16:45:12 -0700649 const sp<DisplayDevice> getDisplayByIdOrLayerStack(uint64_t displayOrLayerStack);
chaviwa76b2712017-09-20 12:02:26 -0700650 status_t captureScreenImplLocked(const RenderArea& renderArea,
651 TraverseLayersFunction traverseLayers,
652 ANativeWindowBuffer* buffer, bool useIdentityTransform,
Robert Carr108b2c72019-04-02 16:32:58 -0700653 bool forSystem, int* outSyncFd, bool& outCapturedSecureLayers);
chaviw0e3479f2018-09-10 16:49:30 -0700654 void traverseLayersInDisplay(const sp<const DisplayDevice>& display,
655 const LayerVector::Visitor& visitor);
Mathias Agopianabe815d2013-03-19 22:22:21 -0700656
Lloyd Pique90c115d2018-09-18 21:39:42 -0700657 sp<StartPropertySetThread> mStartPropertySetThread;
Wei Wangb254fa32017-01-31 17:43:23 -0800658
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700659 /* ------------------------------------------------------------------------
Romain Guy11d63f42017-07-20 12:47:14 -0700660 * Properties
661 */
662 void readPersistentProperties();
663
664 /* ------------------------------------------------------------------------
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700665 * EGL
666 */
Mathias Agopian875d8e12013-06-07 15:35:48 -0700667 size_t getMaxTextureSize() const;
668 size_t getMaxViewportDims() const;
Mathias Agopiana4912602012-07-12 14:25:33 -0700669
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700670 /* ------------------------------------------------------------------------
Mathias Agopian87baae12012-07-31 12:38:26 -0700671 * Display and layer stack management
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700672 */
Andy McFadden13a082e2012-08-24 10:16:42 -0700673 // called when starting, or restarting after system_server death
674 void initializeDisplays();
675
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700676 sp<const DisplayDevice> getDisplayDevice(const wp<IBinder>& displayToken) const {
677 Mutex::Autolock _l(mStateLock);
678 return getDisplayDeviceLocked(displayToken);
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700679 }
680
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700681 sp<DisplayDevice> getDisplayDevice(const wp<IBinder>& displayToken) {
682 Mutex::Autolock _l(mStateLock);
683 return getDisplayDeviceLocked(displayToken);
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700684 }
685
686 // NOTE: can only be called from the main thread or with mStateLock held
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700687 sp<const DisplayDevice> getDisplayDeviceLocked(const wp<IBinder>& displayToken) const {
688 return const_cast<SurfaceFlinger*>(this)->getDisplayDeviceLocked(displayToken);
Mathias Agopian92a979a2012-08-02 18:32:23 -0700689 }
Mathias Agopiandb9b41f2012-10-15 16:51:41 -0700690
691 // NOTE: can only be called from the main thread or with mStateLock held
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700692 sp<DisplayDevice> getDisplayDeviceLocked(const wp<IBinder>& displayToken) {
Dominik Laskowski9fae1022018-05-29 13:17:40 -0700693 const auto it = mDisplays.find(displayToken);
694 return it == mDisplays.end() ? nullptr : it->second;
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700695 }
Mathias Agopian99b49842011-06-27 16:05:52 -0700696
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700697 sp<const DisplayDevice> getDefaultDisplayDeviceLocked() const {
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700698 return const_cast<SurfaceFlinger*>(this)->getDefaultDisplayDeviceLocked();
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700699 }
700
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700701 sp<DisplayDevice> getDefaultDisplayDeviceLocked() {
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800702 if (const auto token = getInternalDisplayTokenLocked()) {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700703 return getDisplayDeviceLocked(token);
704 }
705 return nullptr;
Michael Wright28f24d02016-07-12 13:30:53 -0700706 }
707
Mathias Agopian87baae12012-07-31 12:38:26 -0700708 // mark a region of a layer stack dirty. this updates the dirty
709 // region of all screens presenting this layer stack.
Chia-I Wuab0c3192017-08-01 11:29:00 -0700710 void invalidateLayerStack(const sp<const Layer>& layer, const Region& dirty);
Mathias Agopian87baae12012-07-31 12:38:26 -0700711
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700712 /* ------------------------------------------------------------------------
Mathias Agopian86303202012-07-24 22:46:10 -0700713 * H/W composer
714 */
715
Lloyd Pique441d5042018-10-18 16:49:51 -0700716 // The current hardware composer interface.
717 //
718 // The following thread safety rules apply when accessing mHwc, either
719 // directly or via getHwComposer():
720 //
721 // 1. When recreating mHwc, acquire mStateLock. We currently recreate mHwc
722 // only when switching into and out of vr. Recreating mHwc must only be
723 // done on the main thread.
724 //
725 // 2. When accessing mHwc on the main thread, it's not necessary to acquire
726 // mStateLock.
727 //
728 // 3. When accessing mHwc on a thread other than the main thread, we always
729 // need to acquire mStateLock. This is because the main thread could be
730 // in the process of destroying the current mHwc instance.
731 //
732 // The above thread safety rules only apply to SurfaceFlinger.cpp. In
733 // SurfaceFlinger_hwc1.cpp we create mHwc at surface flinger init and never
734 // destroy it, so it's always safe to access mHwc from any thread without
735 // acquiring mStateLock.
736 HWComposer& getHwComposer() const;
Mathias Agopian86303202012-07-24 22:46:10 -0700737
Mathias Agopian888c8222012-08-04 21:10:38 -0700738 /* ------------------------------------------------------------------------
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700739 * Compositing
740 */
741 void invalidateHwcGeometry();
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700742 void computeVisibleRegions(const sp<const DisplayDevice>& display, Region& dirtyRegion,
743 Region& opaqueRegion);
Mathias Agopiancd60f992012-08-16 16:28:27 -0700744
David Sodman2b406362017-12-15 13:33:47 -0800745 void postComposition();
Dominik Laskowskif654d572018-12-20 11:03:06 -0800746 void getCompositorTiming(CompositorTiming* compositorTiming);
Ana Krulece588e312018-09-18 12:32:24 -0700747 void updateCompositorTiming(const DisplayStatInfo& stats, nsecs_t compositeTime,
748 std::shared_ptr<FenceTime>& presentFenceTime);
749 void setCompositorTimingSnapped(const DisplayStatInfo& stats,
750 nsecs_t compositeToPresentLatency);
Mathias Agopiancd60f992012-08-16 16:28:27 -0700751 void rebuildLayerStacks();
Courtney Goeltzenleuchter5d943892017-03-22 13:46:46 -0600752
Peiyong Lin03912882019-04-16 15:34:46 -0700753 ui::Dataspace getBestDataspace(const sp<DisplayDevice>& display, ui::Dataspace* outHdrDataSpace,
754 bool* outIsHdrClientComposition) const;
Peiyong Lin136fbbc2018-04-17 15:09:44 -0700755
756 // Returns the appropriate ColorMode, Dataspace and RenderIntent for the
757 // DisplayDevice. The function only returns the supported ColorMode,
758 // Dataspace and RenderIntent.
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700759 void pickColorMode(const sp<DisplayDevice>& display, ui::ColorMode* outMode,
760 ui::Dataspace* outDataSpace, ui::RenderIntent* outRenderIntent) const;
Romain Guy0147a172017-06-01 13:53:56 -0700761
David Sodman79bba0e2018-08-05 18:07:49 -0700762 void calculateWorkingSet();
David Sodmanfa9b2af2017-12-24 13:28:59 -0800763 void doComposition(const sp<DisplayDevice>& display, bool repainEverything);
764 void doDebugFlashRegions(const sp<DisplayDevice>& display, bool repaintEverything);
Yiwei Zhang7124ad32018-02-21 13:02:45 -0800765 void logLayerStats();
Alec Mouri0a9c7b82018-11-16 13:05:25 -0800766 void doDisplayComposition(const sp<DisplayDevice>& display, const Region& dirtyRegion);
Michael Lentine3f121fc2014-10-01 11:17:28 -0700767
Alec Mourie7d1d4a2019-02-05 01:13:46 +0000768 // This fails if using GL and the surface has been destroyed. readyFence
769 // will be populated if using GL and native fence sync is supported, to
770 // signal when drawing has completed.
771 bool doComposeSurfaces(const sp<DisplayDevice>& display, const Region& debugRegionm,
772 base::unique_fd* readyFence);
Mathias Agopiancd60f992012-08-16 16:28:27 -0700773
David Sodmanfa9b2af2017-12-24 13:28:59 -0800774 void postFrame();
Mathias Agopian4da75192010-08-10 17:19:56 -0700775
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700776 /* ------------------------------------------------------------------------
Jamie Gennis0bceb842012-08-23 20:19:38 -0700777 * Display management
778 */
Lloyd Pique542307f2018-10-19 13:24:08 -0700779 sp<DisplayDevice> setupNewDisplayDeviceInternal(
780 const wp<IBinder>& displayToken, const std::optional<DisplayId>& displayId,
781 const DisplayDeviceState& state,
782 const sp<compositionengine::DisplaySurface>& dispSurface,
783 const sp<IGraphicBufferProducer>& producer);
Lloyd Pique347200f2017-12-14 17:00:15 -0800784 void processDisplayChangesLocked();
Lloyd Piqueba04e622017-12-14 17:11:26 -0800785 void processDisplayHotplugEventsLocked();
Mathias Agopian3ee454a2012-08-27 16:28:24 -0700786
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800787 void dispatchDisplayHotplugEvent(PhysicalDisplayId displayId, bool connected);
Dominik Laskowski1eba0202019-01-24 09:14:40 -0800788
Jamie Gennisfaf77cc2013-07-30 15:10:32 -0700789 /* ------------------------------------------------------------------------
790 * VSync
791 */
Dominik Laskowski83b88212018-12-11 13:34:06 -0800792 nsecs_t getVsyncPeriod() const REQUIRES(mStateLock);
Robert Carr1f0a16a2016-10-24 16:27:39 -0700793
Dominik Laskowskiccf37d72019-02-01 16:47:58 -0800794 // Sets the refresh rate by switching active configs, if they are available for
Ana Krulec7d1d6832018-12-27 11:10:09 -0800795 // the desired refresh rate.
Ady Abraham03b02dd2019-03-21 15:40:11 -0700796 void setRefreshRateTo(RefreshRateType, Scheduler::ConfigEvent event) REQUIRES(mStateLock);
Jamie Gennis0bceb842012-08-23 20:19:38 -0700797
Ady Abraham261614e2019-07-10 17:53:12 -0700798 bool isDisplayConfigAllowed(int32_t configId) const REQUIRES(mStateLock);
Jamie Gennis0bceb842012-08-23 20:19:38 -0700799
Dominik Laskowskia8955dd2019-07-10 10:19:09 -0700800 bool previousFrameMissed();
801
802 // Populates the expected present time for this frame. For negative offsets, performs a
803 // correction using the predicted vsync for the next frame instead.
804 void populateExpectedPresentTime();
805
Dominik Laskowskic2867142019-01-21 11:33:38 -0800806 /*
807 * Display identification
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700808 */
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800809 sp<IBinder> getPhysicalDisplayTokenLocked(DisplayId displayId) const {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700810 const auto it = mPhysicalDisplayTokens.find(displayId);
811 return it != mPhysicalDisplayTokens.end() ? it->second : nullptr;
812 }
813
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800814 std::optional<DisplayId> getPhysicalDisplayIdLocked(const sp<IBinder>& displayToken) const {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700815 for (const auto& [id, token] : mPhysicalDisplayTokens) {
816 if (token == displayToken) {
817 return id;
818 }
819 }
820 return {};
821 }
822
823 // TODO(b/74619554): Remove special cases for primary display.
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800824 sp<IBinder> getInternalDisplayTokenLocked() const {
825 const auto displayId = getInternalDisplayIdLocked();
826 return displayId ? getPhysicalDisplayTokenLocked(*displayId) : nullptr;
Dominik Laskowski075d3172018-05-24 15:50:06 -0700827 }
828
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800829 std::optional<DisplayId> getInternalDisplayIdLocked() const {
Dominik Laskowski075d3172018-05-24 15:50:06 -0700830 const auto hwcDisplayId = getHwComposer().getInternalHwcDisplayId();
831 return hwcDisplayId ? getHwComposer().toPhysicalDisplayId(*hwcDisplayId) : std::nullopt;
832 }
833
Dominik Laskowskic2867142019-01-21 11:33:38 -0800834 /*
835 * Debugging & dumpsys
836 */
Dominik Laskowskic2867142019-01-21 11:33:38 -0800837 using DumpArgs = Vector<String16>;
838 using Dumper = std::function<void(const DumpArgs&, bool asProto, std::string&)>;
839
840 template <typename F, std::enable_if_t<!std::is_member_function_pointer_v<F>>* = nullptr>
841 static Dumper dumper(F&& dump) {
842 using namespace std::placeholders;
843 return std::bind(std::forward<F>(dump), _3);
844 }
845
846 template <typename F, std::enable_if_t<std::is_member_function_pointer_v<F>>* = nullptr>
847 Dumper dumper(F dump) {
848 using namespace std::placeholders;
849 return std::bind(dump, this, _3);
850 }
851
852 template <typename F>
853 Dumper argsDumper(F dump) {
854 using namespace std::placeholders;
855 return std::bind(dump, this, _1, _3);
856 }
857
858 template <typename F>
859 Dumper protoDumper(F dump) {
860 using namespace std::placeholders;
861 return std::bind(dump, this, _1, _2, _3);
862 }
863
864 void dumpAllLocked(const DumpArgs& args, std::string& result) const REQUIRES(mStateLock);
865
866 void appendSfConfigString(std::string& result) const;
867 void listLayersLocked(std::string& result) const;
868 void dumpStatsLocked(const DumpArgs& args, std::string& result) const REQUIRES(mStateLock);
869 void clearStatsLocked(const DumpArgs& args, std::string& result);
870 void dumpTimeStats(const DumpArgs& args, bool asProto, std::string& result) const;
Jamie Gennis6547ff42013-07-16 20:12:42 -0700871 void logFrameStats();
872
Dominik Laskowskid9e4de62019-01-21 14:23:01 -0800873 void dumpVSync(std::string& result) const REQUIRES(mStateLock);
Yiwei Zhang5434a782018-12-05 18:06:32 -0800874 void dumpStaticScreenStats(std::string& result) const;
Brian Andersond6927fb2016-07-23 23:37:30 -0700875 // Not const because each Layer needs to query Fences and cache timestamps.
Yiwei Zhang5434a782018-12-05 18:06:32 -0800876 void dumpFrameEventsLocked(std::string& result);
Dan Stozab90cf072015-03-05 11:05:59 -0800877
Dan Stozae77c7662016-05-13 11:37:28 -0700878 void recordBufferingStats(const char* layerName,
879 std::vector<OccupancyTracker::Segment>&& history);
Yiwei Zhang5434a782018-12-05 18:06:32 -0800880 void dumpBufferingStats(std::string& result) const;
881 void dumpDisplayIdentificationData(std::string& result) const;
882 void dumpWideColorInfo(std::string& result) const;
Vishnu Nair8406fd72019-07-30 11:29:31 -0700883 LayersProto dumpDrawingStateProto(uint32_t traceFlags = SurfaceTracing::TRACE_ALL) const;
884 LayersProto dumpProtoFromMainThread(uint32_t traceFlags = SurfaceTracing::TRACE_ALL)
885 EXCLUDES(mStateLock);
Nataniel Borges2b796da2019-02-15 13:32:18 -0800886 void withTracingLock(std::function<void()> operation) REQUIRES(mStateLock);
Lloyd Pique37c2c9b2018-12-04 17:25:10 -0800887 LayersProto dumpVisibleLayersProtoInfo(const sp<DisplayDevice>& display) const;
Dan Stozae77c7662016-05-13 11:37:28 -0700888
Fabien Sanglard63a5fcd2016-12-29 15:13:07 -0800889 bool isLayerTripleBufferingDisabled() const {
890 return this->mLayerTripleBufferingDisabled;
891 }
Dominik Laskowskic2867142019-01-21 11:33:38 -0800892
893 status_t doDump(int fd, const DumpArgs& args, bool asProto);
894
Nataniel Borges8e7dc722019-02-28 15:10:28 -0800895 status_t dumpCritical(int fd, const DumpArgs&, bool asProto);
Dominik Laskowskic2867142019-01-21 11:33:38 -0800896
897 status_t dumpAll(int fd, const DumpArgs& args, bool asProto) override {
898 return doDump(fd, args, asProto);
899 }
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800900
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800901 /* ------------------------------------------------------------------------
902 * VrFlinger
903 */
Steven Thomasb02664d2017-07-26 18:48:28 -0700904 void resetDisplayState();
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800905
Steven Thomas050b2c82017-03-06 11:45:16 -0800906 // Check to see if we should handoff to vr flinger.
907 void updateVrFlinger();
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800908
Chia-I Wu28f320b2018-05-03 11:02:56 -0700909 void updateColorMatrixLocked();
910
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700911 /* ------------------------------------------------------------------------
912 * Attributes
913 */
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800914
Lloyd Pique90c115d2018-09-18 21:39:42 -0700915 surfaceflinger::Factory& mFactory;
916
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700917 // access must be protected by mStateLock
918 mutable Mutex mStateLock;
Dan Stoza412903f2017-04-27 13:42:17 -0700919 State mCurrentState{LayerVector::StateSet::Current};
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700920 std::atomic<int32_t> mTransactionFlags = 0;
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700921 Condition mTransactionCV;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700922 bool mTransactionPending = false;
923 bool mAnimTransactionPending = false;
924 SortedVector<sp<Layer>> mLayersPendingRemoval;
925 bool mTraversalNeededMainThread = false;
Dan Stoza101d8dc2018-02-27 15:42:25 -0800926
Nataniel Borges2b796da2019-02-15 13:32:18 -0800927 // guards access to the mDrawing state if tracing is enabled.
928 mutable std::mutex mDrawingStateLock;
929
Chia-I Wu28f320b2018-05-03 11:02:56 -0700930 // global color transform states
931 Daltonizer mDaltonizer;
932 float mGlobalSaturationFactor = 1.0f;
933 mat4 mClientColorMatrix;
934
Dan Stoza101d8dc2018-02-27 15:42:25 -0800935 // Can't be unordered_set because wp<> isn't hashable
936 std::set<wp<IBinder>> mGraphicBufferProducerList;
Dan Stoza0a0158c2018-03-16 13:38:54 -0700937 size_t mMaxGraphicBufferProducerListSize = MAX_LAYERS;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800938
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700939 // protected by mStateLock (but we could use another lock)
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700940 bool mLayersRemoved = false;
941 bool mLayersAdded = false;
Mathias Agopianca4d3602011-05-19 15:38:14 -0700942
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700943 std::atomic<bool> mRepaintEverything = false;
Mathias Agopianca4d3602011-05-19 15:38:14 -0700944
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -0800945 // constant members (no synchronization needed for access)
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700946 const nsecs_t mBootTime = systemTime();
947 bool mGpuToCpuSupported = false;
Lloyd Piquee83f9312018-02-01 12:53:17 -0800948 std::unique_ptr<EventThread> mInjectorEventThread;
Lloyd Piquee83f9312018-02-01 12:53:17 -0800949 std::unique_ptr<InjectVSyncSource> mVSyncInjector;
Mathias Agopian3094df32012-06-18 18:06:45 -0700950
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700951 // Can only accessed from the main thread, these members
952 // don't need synchronization
Dan Stoza412903f2017-04-27 13:42:17 -0700953 State mDrawingState{LayerVector::StateSet::Drawing};
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700954 bool mVisibleRegionsDirty = false;
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800955 // Set during transaction commit stage to track if the input info for a layer has changed.
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700956 bool mInputInfoChanged = false;
957 bool mGeometryInvalid = false;
958 bool mAnimCompositionPending = false;
Dan Stoza9e56aa02015-11-02 13:00:03 -0800959 std::vector<sp<Layer>> mLayersWithQueuedFrames;
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800960 // Tracks layers that need to update a display's dirty region.
961 std::vector<sp<Layer>> mLayersPendingRefresh;
Ady Abrahambe0f9482019-04-24 15:41:53 -0700962 std::array<sp<Fence>, 2> mPreviousPresentFences = {Fence::NO_FENCE, Fence::NO_FENCE};
Alec Mouricc0fc602019-02-26 21:45:19 -0800963 // True if in the previous frame at least one layer was composed via the GPU.
Dan Stoza05dacfb2016-07-01 13:33:38 -0700964 bool mHadClientComposition = false;
Alec Mouricc0fc602019-02-26 21:45:19 -0800965 // True if in the previous frame at least one layer was composed via HW Composer.
966 // Note that it is possible for a frame to be composed via both client and device
967 // composition, for example in the case of overlays.
968 bool mHadDeviceComposition = false;
Mathias Agopiandb9b41f2012-10-15 16:51:41 -0700969
Chia-I Wu14c9c7b2018-06-26 10:18:18 +0800970 enum class BootStage {
971 BOOTLOADER,
972 BOOTANIMATION,
973 FINISHED,
974 };
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700975 BootStage mBootStage = BootStage::BOOTLOADER;
Chia-I Wu14c9c7b2018-06-26 10:18:18 +0800976
Lloyd Piqueba04e622017-12-14 17:11:26 -0800977 struct HotplugEvent {
Dominik Laskowskia2edf612018-06-01 13:15:16 -0700978 hwc2_display_t hwcDisplayId;
Lloyd Piqueba04e622017-12-14 17:11:26 -0800979 HWC2::Connection connection = HWC2::Connection::Invalid;
Lloyd Piqueba04e622017-12-14 17:11:26 -0800980 };
981 // protected by mStateLock
982 std::vector<HotplugEvent> mPendingHotplugEvents;
983
Mathias Agopiandb9b41f2012-10-15 16:51:41 -0700984 // this may only be written from the main thread with mStateLock held
985 // it may be read from other threads with mStateLock held
Dominik Laskowski9fae1022018-05-29 13:17:40 -0700986 std::map<wp<IBinder>, sp<DisplayDevice>> mDisplays;
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800987 std::unordered_map<DisplayId, sp<IBinder>> mPhysicalDisplayTokens;
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700988
Robert Carrc0df3122019-04-11 13:18:21 -0700989 // protected by mStateLock
990 std::unordered_map<BBinder*, wp<Layer>> mLayersByLocalBinderToken;
991
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700992 // don't use a lock for these, we don't care
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700993 int mDebugRegion = 0;
994 bool mDebugDisableHWC = false;
995 bool mDebugDisableTransformHint = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700996 volatile nsecs_t mDebugInTransaction = 0;
997 bool mForceFullDamage = false;
Dan Stozac5da2712016-07-20 15:38:12 -0700998 bool mPropagateBackpressure = true;
Ady Abraham4658e112019-07-22 13:07:26 -0700999 bool mPropagateBackpressureClientComposition = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001000 std::unique_ptr<SurfaceInterceptor> mInterceptor;
1001 SurfaceTracing mTracing{*this};
Nataniel Borges2b796da2019-02-15 13:32:18 -08001002 bool mTracingEnabled = false;
1003 bool mTracingEnabledChanged GUARDED_BY(mStateLock) = false;
Yiwei Zhang7124ad32018-02-21 13:02:45 -08001004 LayerStats mLayerStats;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001005 const std::shared_ptr<TimeStats> mTimeStats;
Fabien Sanglard642b23d2017-02-09 12:29:39 -08001006 bool mUseHwcVirtualDisplays = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001007 std::atomic<uint32_t> mFrameMissedCount = 0;
1008 std::atomic<uint32_t> mHwcFrameMissedCount = 0;
1009 std::atomic<uint32_t> mGpuFrameMissedCount = 0;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001010
Marissa Walle2ffb422018-10-12 11:33:52 -07001011 TransactionCompletedThread mTransactionCompletedThread;
1012
Fabien Sanglard63a5fcd2016-12-29 15:13:07 -08001013 // Restrict layers to use two buffers in their bufferqueues.
1014 bool mLayerTripleBufferingDisabled = false;
1015
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001016 // these are thread safe
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001017 std::unique_ptr<MessageQueue> mEventQueue;
Jamie Gennis4b0eba92013-02-05 13:30:24 -08001018 FrameTracker mAnimFrameTracker;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001019
1020 // protected by mDestroyedLayerLock;
1021 mutable Mutex mDestroyedLayerLock;
Mathias Agopian13127d82013-03-05 17:47:11 -08001022 Vector<Layer const *> mDestroyedLayers;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001023
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001024 nsecs_t mRefreshStartTime = 0;
Jamie Gennisfaf77cc2013-07-30 15:10:32 -07001025
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001026 std::atomic<bool> mRefreshPending = false;
Dan Stoza2b6d38e2017-06-01 16:40:30 -07001027
Dan Stoza436ccf32018-06-21 12:10:12 -07001028 // We maintain a pool of pre-generated texture names to hand out to avoid
1029 // layer creation needing to run on the main thread (which it would
1030 // otherwise need to do to access RenderEngine).
1031 std::mutex mTexturePoolMutex;
1032 uint32_t mTexturePoolSize = 0;
1033 std::vector<uint32_t> mTexturePool;
1034
Marissa Wall713b63f2018-10-17 15:42:43 -07001035 struct IBinderHash {
1036 std::size_t operator()(const sp<IBinder>& strongPointer) const {
1037 return std::hash<IBinder*>{}(strongPointer.get());
1038 }
1039 };
1040 struct TransactionState {
1041 TransactionState(const Vector<ComposerState>& composerStates,
Marissa Wall17b4e452018-12-26 16:32:34 -08001042 const Vector<DisplayState>& displayStates, uint32_t transactionFlags,
Marissa Wall947d34e2019-03-29 14:03:53 -07001043 int64_t desiredPresentTime, const client_cache_t& uncacheBuffer,
Marissa Wall3dad52d2019-03-22 14:03:19 -07001044 const std::vector<ListenerCallbacks>& listenerCallbacks, int64_t postTime,
1045 bool privileged)
Marissa Wall17b4e452018-12-26 16:32:34 -08001046 : states(composerStates),
1047 displays(displayStates),
1048 flags(transactionFlags),
Valerie Haubc6ddb12019-03-08 11:10:15 -08001049 desiredPresentTime(desiredPresentTime),
Marissa Wall78b72202019-03-15 14:58:34 -07001050 buffer(uncacheBuffer),
Marissa Wall3dad52d2019-03-22 14:03:19 -07001051 callback(listenerCallbacks),
Valerie Haubc6ddb12019-03-08 11:10:15 -08001052 postTime(postTime),
Robert Carr14167e02019-02-13 13:50:55 -08001053 privileged(privileged) {}
Marissa Wall713b63f2018-10-17 15:42:43 -07001054
1055 Vector<ComposerState> states;
1056 Vector<DisplayState> displays;
1057 uint32_t flags;
Valerie Haubc6ddb12019-03-08 11:10:15 -08001058 const int64_t desiredPresentTime;
Marissa Wall947d34e2019-03-29 14:03:53 -07001059 client_cache_t buffer;
Marissa Wall3dad52d2019-03-22 14:03:19 -07001060 std::vector<ListenerCallbacks> callback;
Valerie Haubc6ddb12019-03-08 11:10:15 -08001061 const int64_t postTime;
Robert Carr14167e02019-02-13 13:50:55 -08001062 bool privileged;
Marissa Wall713b63f2018-10-17 15:42:43 -07001063 };
1064 std::unordered_map<sp<IBinder>, std::queue<TransactionState>, IBinderHash> mTransactionQueues;
1065
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001066 /* ------------------------------------------------------------------------
1067 * Feature prototyping
1068 */
1069
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001070 bool mInjectVSyncs = false;
Sahil Dhanjuc1ba5c42016-06-07 20:09:20 -07001071
Dan Stozab90cf072015-03-05 11:05:59 -08001072 // Static screen stats
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001073 bool mHasPoweredOff = false;
Dan Stozae77c7662016-05-13 11:37:28 -07001074
chaviweadf0d42019-08-12 13:28:29 -07001075 std::atomic<size_t> mNumLayers = 0;
Robert Carr1f0a16a2016-10-24 16:27:39 -07001076
Fabien Sanglard6e8e98a2016-10-27 20:04:11 -07001077 // Verify that transaction is being called by an approved process:
1078 // either AID_GRAPHICS or AID_SYSTEM.
1079 status_t CheckTransactCodeCredentials(uint32_t code);
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -08001080
Steven Morelanda904bb92019-07-02 17:37:23 -07001081 // to linkToDeath
1082 sp<IBinder> mWindowManager;
1083
Steven Thomasb02664d2017-07-26 18:48:28 -07001084 std::unique_ptr<dvr::VrFlinger> mVrFlinger;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001085 std::atomic<bool> mVrFlingerRequestsDisplay = false;
Steven Thomas050b2c82017-03-06 11:45:16 -08001086 static bool useVrFlinger;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001087 std::thread::id mMainThreadId = std::this_thread::get_id();
Romain Guy0147a172017-06-01 13:53:56 -07001088
Chia-I Wue0ec4312018-07-03 01:17:18 +08001089 DisplayColorSetting mDisplayColorSetting = DisplayColorSetting::ENHANCED;
David Sodman105b7dc2017-11-04 20:28:14 -07001090
Peiyong Lina3ea5592019-02-10 14:45:00 -08001091 // Color mode forced by setting persist.sys.sf.color_mode, it must:
1092 // 1. not be NATIVE color mode, NATIVE color mode means no forced color mode;
1093 // 2. be one of the supported color modes returned by hardware composer, otherwise
1094 // it will not be respected.
1095 // persist.sys.sf.color_mode will only take effect when persist.sys.sf.native_mode
1096 // is not set to 1.
1097 // This property can be used to force SurfaceFlinger to always pick a certain color mode.
1098 ui::ColorMode mForceColorMode = ui::ColorMode::NATIVE;
1099
Peiyong Lin9d846a52018-11-05 13:18:20 -08001100 ui::Dataspace mDefaultCompositionDataspace;
1101 ui::Dataspace mWideColorGamutCompositionDataspace;
Yichi Chenda901bf2019-06-28 14:58:27 +08001102 ui::Dataspace mColorSpaceAgnosticDataspace;
Peiyong Lin9d846a52018-11-05 13:18:20 -08001103
David Sodman105b7dc2017-11-04 20:28:14 -07001104 SurfaceFlingerBE mBE;
Lloyd Pique70d91362018-10-18 16:02:55 -07001105 std::unique_ptr<compositionengine::CompositionEngine> mCompositionEngine;
Ana Krulec98b5b242018-08-10 15:03:23 -07001106
Ana Krulecb43429d2019-01-09 14:28:51 -08001107 /* ------------------------------------------------------------------------
1108 * Scheduler
1109 */
Ana Krulecba13ab32019-02-20 14:14:12 -08001110 bool mUseSmart90ForVideo = false;
Ana Krulec98b5b242018-08-10 15:03:23 -07001111 std::unique_ptr<Scheduler> mScheduler;
1112 sp<Scheduler::ConnectionHandle> mAppConnectionHandle;
1113 sp<Scheduler::ConnectionHandle> mSfConnectionHandle;
Robert Carr720e5062018-07-30 17:45:14 -07001114
Dominik Laskowskieddeda12019-07-19 11:54:13 -07001115 // Stores phase offsets configured per refresh rate.
1116 const std::unique_ptr<scheduler::PhaseOffsets> mPhaseOffsets;
1117
1118 // Optional to defer construction until scheduler connections are created.
1119 std::optional<scheduler::VSyncModulator> mVSyncModulator;
1120
Dominik Laskowski22488f62019-03-28 09:53:04 -07001121 scheduler::RefreshRateConfigs mRefreshRateConfigs;
1122 scheduler::RefreshRateStats mRefreshRateStats{mRefreshRateConfigs, *mTimeStats};
Ady Abraham1902d072019-03-01 17:18:59 -08001123
Dominik Laskowskia8955dd2019-07-10 10:19:09 -07001124 std::atomic<nsecs_t> mExpectedPresentTime = 0;
1125
Dominik Laskowski22488f62019-03-28 09:53:04 -07001126 // All configs are allowed if the set is empty.
Ady Abraham3bb89732019-04-08 11:22:01 -07001127 using DisplayConfigs = std::set<int32_t>;
Dominik Laskowski22488f62019-03-28 09:53:04 -07001128 DisplayConfigs mAllowedDisplayConfigs GUARDED_BY(mStateLock);
Ady Abraham838de062019-02-04 10:24:03 -08001129
Ana Kruleca5bdd9d2019-01-29 19:00:58 -08001130 std::mutex mActiveConfigLock;
1131 // This bit is set once we start setting the config. We read from this bit during the
1132 // process. If at the end, this bit is different than mDesiredActiveConfig, we restart
1133 // the process.
1134 ActiveConfigInfo mUpcomingActiveConfig; // Always read and written on the main thread.
1135 // This bit can be set at any point in time when the system wants the new config.
1136 ActiveConfigInfo mDesiredActiveConfig GUARDED_BY(mActiveConfigLock);
1137
Ady Abrahamb838aed2019-02-12 15:30:16 -08001138 // below flags are set by main thread only
Ady Abraham50204dd2019-07-19 15:47:11 -07001139 TracedOrdinal<bool> mDesiredActiveConfigChanged
1140 GUARDED_BY(mActiveConfigLock) = {"DesiredActiveConfigChanged", false};
Ady Abrahamb838aed2019-02-12 15:30:16 -08001141 bool mCheckPendingFence = false;
1142
Kevin DuBois413287f2019-02-25 08:46:47 -08001143 bool mLumaSampling = true;
1144 sp<RegionSamplingThread> mRegionSamplingThread;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001145 ui::DisplayPrimaries mInternalDisplayPrimaries;
Kevin DuBois413287f2019-02-25 08:46:47 -08001146
Robert Carr720e5062018-07-30 17:45:14 -07001147 sp<IInputFlinger> mInputFlinger;
Vishnu Nairfa5f8df2019-02-13 17:02:51 -08001148 InputWindowCommands mPendingInputWindowCommands GUARDED_BY(mStateLock);
1149 // Should only be accessed by the main thread.
chaviw273171b2018-12-26 11:46:30 -08001150 InputWindowCommands mInputWindowCommands;
chaviw291d88a2019-02-14 10:33:58 -08001151
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001152 struct SetInputWindowsListener : BnSetInputWindowsListener {
1153 explicit SetInputWindowsListener(sp<SurfaceFlinger> flinger)
1154 : mFlinger(std::move(flinger)) {}
1155
1156 void onSetInputWindowsFinished() override;
1157
1158 const sp<SurfaceFlinger> mFlinger;
1159 };
1160
1161 const sp<SetInputWindowsListener> mSetInputWindowsListener = new SetInputWindowsListener(this);
1162
chaviw95ef3c42019-02-14 10:55:09 -08001163 bool mPendingSyncInputWindows GUARDED_BY(mStateLock);
Peiyong Lin74ca2f42019-01-14 19:36:57 -08001164 Hwc2::impl::PowerAdvisor mPowerAdvisor;
Ady Abraham03b02dd2019-03-21 15:40:11 -07001165
1166 std::unique_ptr<RefreshRateOverlay> mRefreshRateOverlay;
Ady Abraham34392f72019-04-10 11:29:27 -07001167
1168 // Flag used to set override allowed display configs from backdoor
1169 bool mDebugDisplayConfigSetByBackdoor = false;
chaviw74d90ad2019-04-26 14:45:26 -07001170
1171 // A set of layers that have no parent so they are not drawn on screen.
1172 // Should only be accessed by the main thread.
1173 // The Layer pointer is removed from the set when the destructor is called so there shouldn't
1174 // be any issues with a raw pointer referencing an invalid object.
1175 std::unordered_set<Layer*> mOffscreenLayers;
Ady Abraham9ba25122019-06-03 17:10:55 -07001176
Ady Abraham27c70212019-06-11 10:52:26 -07001177 // Flags to capture the state of Vsync in HWC
1178 HWC2::Vsync mHWCVsyncState = HWC2::Vsync::Disable;
1179 HWC2::Vsync mHWCVsyncPendingState = HWC2::Vsync::Disable;
Romain Guy0147a172017-06-01 13:53:56 -07001180};
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -08001181
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001182} // namespace android