blob: 335fb2993a64dfcb36e34520db145e0b53e49842 [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 *
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080010 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15
Dominik Laskowski9dab3432019-03-27 13:21:10 -070016#pragma once
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080017
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -080018#include <sys/types.h>
19
Mathias Agopian3f844832013-08-07 21:24:32 -070020/*
21 * NOTE: Make sure this file doesn't include anything from <gl/ > or <gl2/ >
22 */
Mathias Agopian921e6ac2012-07-23 23:11:29 -070023
Dominik Laskowski83b88212018-12-11 13:34:06 -080024#include <android-base/thread_annotations.h>
Huihong Luof5029222021-12-16 14:33:46 -080025#include <android/gui/BnSurfaceComposer.h>
Huihong Luoaa7fc2e2022-02-15 10:43:00 -080026#include <android/gui/DisplayStatInfo.h>
27#include <android/gui/DisplayState.h>
Huihong Luod3d8f8e2022-03-08 14:48:46 -080028#include <android/gui/ISurfaceComposerClient.h>
Steven Moreland2716e112018-02-23 14:57:20 -080029#include <cutils/atomic.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080030#include <cutils/compiler.h>
Dominik Laskowskib17c6212022-05-09 09:36:19 -070031#include <ftl/future.h>
Dominik Laskowski530d6bd2022-10-10 16:55:54 -040032#include <ftl/non_null.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080033#include <gui/BufferQueue.h>
Dominik Laskowski5a5e01e2022-07-08 07:52:44 -070034#include <gui/CompositorTiming.h>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080035#include <gui/FrameTimestamps.h>
Mathias Agopian90ac7992012-02-25 18:48:35 -080036#include <gui/ISurfaceComposer.h>
Huihong Luoffee3bc2023-01-17 16:14:35 +000037#include <gui/ITransactionCompletedListener.h>
Huihong Luo05539a12022-02-23 10:29:40 -080038#include <gui/LayerDebugInfo.h>
Robert Carr4cdc58f2017-08-23 14:22:20 -070039#include <gui/LayerState.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080040#include <layerproto/LayerProtoHeader.h>
41#include <math/mat4.h>
Vishnu Nair08f6eae2019-11-26 14:01:39 -080042#include <renderengine/LayerSettings.h>
Vishnu Nair35798872017-10-06 16:00:36 -070043#include <serviceutils/PriorityDumper.h>
Michael Wright28f24d02016-07-12 13:30:53 -070044#include <system/graphics.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080045#include <ui/FenceTime.h>
46#include <ui/PixelFormat.h>
Brian Lindahla13f2d52020-03-05 11:54:17 +010047#include <ui/Size.h>
Peiyong Lin2acb7d42019-01-14 17:22:27 -080048#include <utils/Errors.h>
49#include <utils/KeyedVector.h>
50#include <utils/RefBase.h>
51#include <utils/SortedVector.h>
52#include <utils/Trace.h>
53#include <utils/threads.h>
Michael Wright28f24d02016-07-12 13:30:53 -070054
Dominik Laskowskif6b4ba62021-11-09 12:46:10 -080055#include <compositionengine/OutputColorSetting.h>
56#include <scheduler/Fps.h>
Dominik Laskowski80c77272022-07-08 12:47:29 -070057#include <scheduler/PresentLatencyTracker.h>
Dominik Laskowski8792c112022-07-12 09:03:39 -070058#include <scheduler/Time.h>
Dominik Laskowski1c99a002023-01-20 17:10:36 -050059#include <scheduler/TransactionSchedule.h>
Dominik Laskowski63f12792023-01-21 16:58:22 -050060#include <scheduler/interface/CompositionCoverage.h>
61#include <scheduler/interface/ICompositor.h>
Patrick Williams2e9748f2022-08-09 22:48:18 +000062#include <ui/FenceResult.h>
Dominik Laskowskif6b4ba62021-11-09 12:46:10 -080063
Dominik Laskowskib363c4c2022-08-02 14:03:41 -070064#include "Display/DisplayMap.h"
65#include "Display/PhysicalDisplay.h"
Mathias Agopian92a979a2012-08-02 18:32:23 -070066#include "DisplayDevice.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080067#include "DisplayHardware/HWC2.h"
Peiyong Lin74ca2f42019-01-14 19:36:57 -080068#include "DisplayHardware/PowerAdvisor.h"
Marin Shalamanov0f10d0d2020-08-06 20:04:06 +020069#include "DisplayIdGenerator.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080070#include "Effects/Daltonizer.h"
Robert Carr9b623c32022-03-21 15:55:22 -070071#include "FlagManager.h"
Vishnu Nairaf6d2972022-11-18 06:26:38 +000072#include "FrontEnd/DisplayInfo.h"
Vishnu Naircb8be502022-10-12 19:03:23 +000073#include "FrontEnd/LayerCreationArgs.h"
Vishnu Naird6913222023-02-01 22:56:21 +000074#include "FrontEnd/LayerLifecycleManager.h"
Vishnu Nair7aa0eb72023-01-24 03:59:27 +000075#include "FrontEnd/LayerSnapshot.h"
Vishnu Naird6913222023-02-01 22:56:21 +000076#include "FrontEnd/LayerSnapshotBuilder.h"
Vishnu Naira61e4fb2022-10-18 18:29:37 +000077#include "FrontEnd/TransactionHandler.h"
Robert Carr2047fae2016-11-28 14:09:09 -080078#include "LayerVector.h"
Dominik Laskowskid82e0f02022-10-26 15:23:04 -040079#include "Scheduler/RefreshRateSelector.h"
Ana Krulecb43429d2019-01-09 14:28:51 -080080#include "Scheduler/RefreshRateStats.h"
Ana Krulec98b5b242018-08-10 15:03:23 -070081#include "Scheduler/Scheduler.h"
Peiyong Lin2acb7d42019-01-14 17:22:27 -080082#include "SurfaceFlingerFactory.h"
Dominik Laskowski298b08e2022-02-15 13:45:02 -080083#include "ThreadContext.h"
Vishnu Nair00b90132021-11-05 14:03:40 -070084#include "Tracing/LayerTracing.h"
Vishnu Nair7891e962021-11-11 12:07:21 -080085#include "Tracing/TransactionTracing.h"
Robert Carr9a803c32021-01-14 16:57:58 -080086#include "TransactionCallbackInvoker.h"
Vishnu Nair6b591152021-10-08 11:45:14 -070087#include "TransactionState.h"
Mathias Agopian86303202012-07-24 22:46:10 -070088
Dominik Laskowski83b88212018-12-11 13:34:06 -080089#include <atomic>
90#include <cstdint>
Dominik Laskowskic2867142019-01-21 11:33:38 -080091#include <functional>
Dan Stozae77c7662016-05-13 11:37:28 -070092#include <map>
Dominik Laskowski83b88212018-12-11 13:34:06 -080093#include <memory>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080094#include <mutex>
Dominik Laskowskieddeda12019-07-19 11:54:13 -070095#include <optional>
Brian Anderson0a61b0c2016-12-07 14:55:56 -080096#include <queue>
Dominik Laskowski075d3172018-05-24 15:50:06 -070097#include <set>
Dan Stozae77c7662016-05-13 11:37:28 -070098#include <string>
Steven Thomasb02664d2017-07-26 18:48:28 -070099#include <thread>
Dominik Laskowskic2867142019-01-21 11:33:38 -0800100#include <type_traits>
Dominik Laskowski075d3172018-05-24 15:50:06 -0700101#include <unordered_map>
Dominik Laskowski22488f62019-03-28 09:53:04 -0700102#include <unordered_set>
Brian Anderson0a61b0c2016-12-07 14:55:56 -0800103#include <utility>
Brian Lindahl439afad2022-11-14 11:16:55 -0700104#include <vector>
Dan Stozae77c7662016-05-13 11:37:28 -0700105
Leon Scroggins IIIe7c51c62022-02-01 15:53:54 -0500106#include <aidl/android/hardware/graphics/common/DisplayDecorationSupport.h>
ramindani12bfe6b2023-02-03 13:29:19 -0800107#include <aidl/android/hardware/graphics/composer3/RefreshRateChangedDebugData.h>
Chavi Weingarten7043a7d2022-07-19 23:40:35 +0000108#include "Client.h"
Leon Scroggins IIIe7c51c62022-02-01 15:53:54 -0500109
chaviw1d044282017-09-27 12:19:28 -0700110using namespace android::surfaceflinger;
111
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800112namespace android {
113
Lloyd Pique144e1162017-12-20 16:44:52 -0800114class EventThread;
rnleea2ecd832021-07-29 13:58:30 -0700115class FlagManager;
Alec Mouriadebf5c2021-01-05 12:57:36 -0800116class FpsReporter;
Galia Peycheva8f04b302021-04-27 13:25:38 +0200117class TunnelModeEnabledReporter;
John Reck88270902021-03-18 11:27:35 -0400118class HdrLayerInfoReporter;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700119class HWComposer;
Lloyd Pique12eb4232018-01-17 11:54:43 -0800120class IGraphicBufferProducer;
Lloyd Pique144e1162017-12-20 16:44:52 -0800121class Layer;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700122class MessageBase;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700123class RefreshRateOverlay;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700124class RegionSamplingThread;
Marin Shalamanovf6b5d182020-06-12 02:08:51 +0200125class RenderArea;
Yiwei Zhang7e666a52018-11-15 13:33:42 -0800126class TimeStats;
Mikael Pessa90092f42019-08-26 17:22:04 -0700127class FrameTracer;
Huihong Luof5029222021-12-16 14:33:46 -0800128class ScreenCapturer;
chaviw60c9d3e2021-06-04 12:52:17 -0500129class WindowInfosListenerInvoker;
Lloyd Pique144e1162017-12-20 16:44:52 -0800130
ramindani12bfe6b2023-02-03 13:29:19 -0800131using ::aidl::android::hardware::graphics::composer3::RefreshRateChangedDebugData;
Vishnu Nairaf6d2972022-11-18 06:26:38 +0000132using frontend::TransactionHandler;
Huihong Luof5029222021-12-16 14:33:46 -0800133using gui::CaptureArgs;
134using gui::DisplayCaptureArgs;
Huihong Luoecc1f902021-11-20 11:55:05 -0800135using gui::IRegionSamplingListener;
Huihong Luof5029222021-12-16 14:33:46 -0800136using gui::LayerCaptureArgs;
chaviw0ef7caa2021-01-05 11:04:50 -0800137using gui::ScreenCaptureResults;
138
Adithya Srinivasanf279e042020-08-17 14:56:27 -0700139namespace frametimeline {
140class FrameTimeline;
141}
142
Chris Ye0783e992020-06-02 21:34:49 -0700143namespace os {
144 class IInputFlinger;
145}
146
Lloyd Pique542307f2018-10-19 13:24:08 -0700147namespace compositionengine {
148class DisplaySurface;
Lloyd Pique26d03fd2019-03-07 21:23:23 -0800149class OutputLayer;
Lloyd Pique6a3b4462019-03-07 20:58:12 -0800150
151struct CompositionRefreshArgs;
Lloyd Pique542307f2018-10-19 13:24:08 -0700152} // namespace compositionengine
153
Peiyong Lin833074a2018-08-28 11:53:54 -0700154namespace renderengine {
Lloyd Pique144e1162017-12-20 16:44:52 -0800155class RenderEngine;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700156} // namespace renderengine
chaviwa76b2712017-09-20 12:02:26 -0700157
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800158enum {
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700159 eTransactionNeeded = 0x01,
160 eTraversalNeeded = 0x02,
Mathias Agopiane57f2922012-08-09 16:29:12 -0700161 eDisplayTransactionNeeded = 0x04,
Vishnu Nair6213bd92020-05-08 17:42:25 -0700162 eTransformHintUpdateNeeded = 0x08,
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700163 eTransactionFlushNeeded = 0x10,
164 eTransactionMask = 0x1f,
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800165};
166
Ady Abraham9dada822022-02-03 10:26:59 -0800167// Latch Unsignaled buffer behaviours
168enum class LatchUnsignaledConfig {
169 // All buffers are latched signaled.
170 Disabled,
171
172 // Latch unsignaled is permitted when a single layer is updated in a frame,
173 // and the update includes just a buffer update (i.e. no sync transactions
174 // or geometry changes).
175 AutoSingleLayer,
176
177 // All buffers are latched unsignaled. This behaviour is discouraged as it
178 // can break sync transactions, stall the display and cause undesired side effects.
179 Always,
180};
ramindani4d48f902021-09-20 21:07:45 +0000181
Lloyd Pique6a3b4462019-03-07 20:58:12 -0800182using DisplayColorSetting = compositionengine::OutputColorSetting;
Peiyong Lindd9b2ae2018-03-01 16:22:45 -0800183
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700184class SurfaceFlinger : public BnSurfaceComposer,
Vishnu Nair35798872017-10-06 16:00:36 -0700185 public PriorityDumper,
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700186 private IBinder::DeathRecipient,
Ady Abraham2139f732019-11-13 18:56:40 -0800187 private HWC2::ComposerCallback,
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700188 private ICompositor,
Dominik Laskowski068173d2021-08-11 17:22:59 -0700189 private scheduler::ISchedulerCallback {
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800190public:
Peiyong Linf243e5e2020-08-22 17:40:59 -0700191 struct SkipInitializationTag {};
192
193 SurfaceFlinger(surfaceflinger::Factory&, SkipInitializationTag) ANDROID_API;
194 explicit SurfaceFlinger(surfaceflinger::Factory&) ANDROID_API;
195
196 // set main thread scheduling policy
197 static status_t setSchedFifo(bool enabled) ANDROID_API;
198
Wei Wang23aa5a62021-06-04 15:56:57 -0700199 // set main thread scheduling attributes
200 static status_t setSchedAttr(bool enabled);
201
Peiyong Linf243e5e2020-08-22 17:40:59 -0700202 static char const* getServiceName() ANDROID_API { return "SurfaceFlinger"; }
Fabien Sanglard0cc19382017-03-06 11:54:40 -0800203
Fabien Sanglardcbf153b2017-03-10 17:57:12 -0800204 // If fences from sync Framework are supported.
205 static bool hasSyncFramework;
206
Ady Abraham8cb21882020-08-26 18:22:05 -0700207 // The offset in nanoseconds to use when VsyncController timestamps present fence
Fabien Sanglardc45a7d92017-03-14 13:24:22 -0700208 // signaling time.
209 static int64_t dispSyncPresentTimeOffset;
210
Fabien Sanglarda34ed632017-03-14 11:43:52 -0700211 // Some hardware can do RGB->YUV conversion more efficiently in hardware
212 // controlled by HWC than in hardware controlled by the video encoder.
213 // This instruct VirtualDisplaySurface to use HWC for such conversion on
214 // GL composition.
215 static bool useHwcForRgbToYuv;
216
Fabien Sanglard1971b632017-03-10 14:50:03 -0800217 // Controls the number of buffers SurfaceFlinger will allocate for use in
218 // FramebufferSurface
219 static int64_t maxFrameBufferAcquiredBuffers;
220
Brian Lindahla13f2d52020-03-05 11:54:17 +0100221 // Controls the maximum width and height in pixels that the graphics pipeline can support for
222 // GPU fallback composition. For example, 8k devices with 4k GPUs, or 4k devices with 2k GPUs.
223 static uint32_t maxGraphicsWidth;
224 static uint32_t maxGraphicsHeight;
225
Peiyong Lin13effd12018-07-24 17:01:47 -0700226 // Indicate if device wants color management on its display.
Alec Mouri5f62a602021-09-29 10:52:41 -0700227 static const constexpr bool useColorManagement = true;
Peiyong Lin13effd12018-07-24 17:01:47 -0700228
Peiyong Linb3839ad2018-09-05 15:37:19 -0700229 static bool useContextPriority;
230
Peiyong Lin0256f722018-08-31 15:45:10 -0700231 // The data space and pixel format that SurfaceFlinger expects hardware composer
232 // to composite efficiently. Meaning under most scenarios, hardware composer
233 // will accept layers with the data space and pixel format.
Peiyong Linc6780972018-10-28 15:24:08 -0700234 static ui::Dataspace defaultCompositionDataspace;
235 static ui::PixelFormat defaultCompositionPixelFormat;
236
237 // The data space and pixel format that SurfaceFlinger expects hardware composer
238 // to composite efficiently for wide color gamut surfaces. Meaning under most scenarios,
239 // hardware composer will accept layers with the data space and pixel format.
240 static ui::Dataspace wideColorGamutCompositionDataspace;
241 static ui::PixelFormat wideColorGamutCompositionPixelFormat;
Peiyong Lin0256f722018-08-31 15:45:10 -0700242
Lloyd Piqueac648ee2018-01-17 13:42:24 -0800243 static constexpr SkipInitializationTag SkipInitialization;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800244
ramindani4d48f902021-09-20 21:07:45 +0000245 static LatchUnsignaledConfig enableLatchUnsignaledConfig;
Huihong Luof3441822021-06-16 15:41:07 -0700246
Mathias Agopian4f4f0942013-08-19 17:26:18 -0700247 // must be called before clients can connect
248 void init() ANDROID_API;
249
250 // starts SurfaceFlinger main loop in the current thread
251 void run() ANDROID_API;
252
Dominik Laskowskidd5827a2022-03-17 12:44:23 -0700253 // Indicates frame activity, i.e. whether commit and/or composite is taking place.
254 enum class FrameHint { kNone, kActive };
255
Dominik Laskowski8da6b0e2021-05-12 15:34:13 -0700256 // Schedule commit of transactions on the main thread ahead of the next VSYNC.
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700257 void scheduleCommit(FrameHint);
258 // As above, but also force composite regardless if transactions were committed.
Dominik Laskowskidd5827a2022-03-17 12:44:23 -0700259 void scheduleComposite(FrameHint);
Dominik Laskowski8da6b0e2021-05-12 15:34:13 -0700260 // As above, but also force dirty geometry to repaint.
261 void scheduleRepaint();
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700262 // Schedule sampling independently from commit or composite.
263 void scheduleSample();
Mathias Agopianbf2c6a62010-12-10 16:22:31 -0800264
Lloyd Pique90c115d2018-09-18 21:39:42 -0700265 surfaceflinger::Factory& getFactory() { return mFactory; }
266
Lloyd Pique70d91362018-10-18 16:02:55 -0700267 // The CompositionEngine encapsulates all composition related interfaces and actions.
268 compositionengine::CompositionEngine& getCompositionEngine() const;
269
Dan Stoza436ccf32018-06-21 12:10:12 -0700270 // Obtains a name from the texture pool, or, if the pool is empty, posts a
271 // synchronous message to the main thread to obtain one on the fly
272 uint32_t getNewTexture();
273
Mathias Agopian86303202012-07-24 22:46:10 -0700274 // utility function to delete a texture on the main thread
Mathias Agopian3f844832013-08-07 21:24:32 -0700275 void deleteTextureAsync(uint32_t texture);
Mathias Agopian86303202012-07-24 22:46:10 -0700276
Lloyd Piqueb97e04f2018-10-18 17:07:05 -0700277 renderengine::RenderEngine& getRenderEngine() const;
Jesse Hall29c3f352013-05-21 15:36:55 -0700278
Dominik Laskowski75848362019-11-11 17:57:20 -0800279 void onLayerFirstRef(Layer*);
Dominik Laskowskif7a09ed2019-10-07 13:54:18 -0700280 void onLayerDestroyed(Layer*);
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700281 void onLayerUpdate();
Robert Carr2e102c92018-10-23 12:11:15 -0700282
Robert Carr867be372021-06-29 17:36:02 -0700283 void removeHierarchyFromOffscreenLayers(Layer* layer);
Valerie Hauc5686802019-11-22 14:18:09 -0800284 void removeFromOffscreenLayers(Layer* layer);
285
Vishnu Nair07e2a482022-10-18 19:18:16 +0000286 // Called when all clients have released all their references to
287 // this layer. The layer may still be kept alive by its parents but
288 // the client can no longer modify this layer directly.
289 void onHandleDestroyed(BBinder* handle, sp<Layer>& layer, uint32_t layerId);
290
Robert Carr6a0382d2021-07-01 15:57:17 -0700291 // TODO: Remove atomic if move dtor to main thread CL lands
292 std::atomic<uint32_t> mNumClones;
293
Robert Carr9a803c32021-01-14 16:57:58 -0800294 TransactionCallbackInvoker& getTransactionCallbackInvoker() {
295 return mTransactionCallbackInvoker;
Marissa Walle2ffb422018-10-12 11:33:52 -0700296 }
297
Vishnu Nair9b079a22020-01-21 14:36:08 -0800298 // If set, disables reusing client composition buffers. This can be set by
299 // debug.sf.disable_client_composition_cache
300 bool mDisableClientCompositionCache = false;
301
Alec Mouridea1ac52021-06-23 18:12:18 -0700302 // Disables expensive rendering for all displays
303 // This is scheduled on the main thread
304 void disableExpensiveRendering();
chaviw79468ab2021-10-27 11:11:24 -0500305 FloatRect getMaxDisplayBounds();
Alec Mouridea1ac52021-06-23 18:12:18 -0700306
Vishnu Naira3140382022-02-24 14:07:11 -0800307 // If set, composition engine tries to predict the composition strategy provided by HWC
308 // based on the previous frame. If the strategy can be predicted, gpu composition will
309 // run parallel to the hwc validateDisplay call and re-run if the predition is incorrect.
310 bool mPredictCompositionStrategy = false;
311
Alec Mouridda07d92022-04-25 22:39:25 +0000312 // If true, then any layer with a SMPTE 170M transfer function is decoded using the sRGB
313 // transfer instead. This is mainly to preserve legacy behavior, where implementations treated
314 // SMPTE 170M as sRGB prior to color management being implemented, and now implementations rely
315 // on this behavior to increase contrast for some media sources.
316 bool mTreat170mAsSrgb = false;
317
Neha Jain7b31cca2023-01-09 23:10:42 +0000318 // Allows to ignore physical orientation provided through hwc API in favour of
319 // 'ro.surface_flinger.primary_display_orientation'.
320 // TODO(b/246793311): Clean up a temporary property
321 bool mIgnoreHwcPhysicalDisplayOrientation = false;
322
Chavi Weingarten076acac2023-01-19 17:20:43 +0000323 void forceFutureUpdate(int delayInMs);
324
Peiyong Linf243e5e2020-08-22 17:40:59 -0700325protected:
326 // We're reference counted, never destroy SurfaceFlinger directly
327 virtual ~SurfaceFlinger();
328
Dominik Laskowski263eec42021-07-21 23:13:24 -0700329 virtual void processDisplayAdded(const wp<IBinder>& displayToken, const DisplayDeviceState&)
330 REQUIRES(mStateLock);
331
Vishnu Nairdbbe3852022-01-12 20:22:11 -0800332 virtual std::shared_ptr<renderengine::ExternalTexture> getExternalTextureFromBufferData(
Patrick Williamsf1e5df12022-10-17 21:37:42 +0000333 BufferData& bufferData, const char* layerName, uint64_t transactionId);
Vishnu Nairdbbe3852022-01-12 20:22:11 -0800334
Dominik Laskowski263eec42021-07-21 23:13:24 -0700335 // Returns true if any display matches a `bool(const DisplayDevice&)` predicate.
336 template <typename Predicate>
337 bool hasDisplay(Predicate p) const REQUIRES(mStateLock) {
338 return static_cast<bool>(findDisplay(p));
339 }
340
chaviwba4320c2021-09-15 15:20:53 -0500341 bool exceedsMaxRenderTargetSize(uint32_t width, uint32_t height) const {
342 return width > mMaxRenderTargetSize || height > mMaxRenderTargetSize;
343 }
344
Mathias Agopian1f339ff2011-07-01 17:08:43 -0700345private:
David Sodman0c69cad2017-08-21 12:12:51 -0700346 friend class BufferLayer;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700347 friend class Client;
Alec Mouria9a68a62021-03-04 19:14:50 -0800348 friend class FpsReporter;
Galia Peycheva8f04b302021-04-27 13:25:38 +0200349 friend class TunnelModeEnabledReporter;
Dominik Laskowski9dab3432019-03-27 13:21:10 -0700350 friend class Layer;
Ady Abraham03b02dd2019-03-21 15:40:11 -0700351 friend class RefreshRateOverlay;
Dan Stozaec460082018-12-17 15:35:09 -0800352 friend class RegionSamplingThread;
Robert Carr22ceeaa2022-03-08 13:13:22 -0800353 friend class LayerRenderArea;
Vishnu Nair00b90132021-11-05 14:03:40 -0700354 friend class LayerTracing;
Vishnu Nair59f6d2d2022-10-05 16:59:56 -0700355 friend class SurfaceComposerAIDL;
Vishnu Nair7aa0eb72023-01-24 03:59:27 +0000356 friend class DisplayRenderArea;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800357
Lloyd Piquef58625d2017-12-19 13:22:33 -0800358 // For unit tests
359 friend class TestableSurfaceFlinger;
Valerie Haud251afb2019-03-29 14:19:02 -0700360 friend class TransactionApplicationTest;
Robert Carr3e2a2992021-06-11 13:42:55 -0700361 friend class TunnelModeEnabledReporterTest;
Lloyd Piquef58625d2017-12-19 13:22:33 -0800362
Peiyong Linf243e5e2020-08-22 17:40:59 -0700363 using TransactionSchedule = scheduler::TransactionSchedule;
Vishnu Nair7aa0eb72023-01-24 03:59:27 +0000364 using GetLayerSnapshotsFunction = std::function<std::vector<std::pair<Layer*, sp<LayerFE>>>()>;
Dominik Laskowskib17c6212022-05-09 09:36:19 -0700365 using RenderAreaFuture = ftl::Future<std::unique_ptr<RenderArea>>;
Peiyong Linf243e5e2020-08-22 17:40:59 -0700366 using DumpArgs = Vector<String16>;
367 using Dumper = std::function<void(const DumpArgs&, bool asProto, std::string&)>;
368
Robert Carr2047fae2016-11-28 14:09:09 -0800369 class State {
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800370 public:
chaviwfd462612018-05-31 16:11:27 -0700371 explicit State(LayerVector::StateSet set) : stateSet(set), layersSortedByZ(set) {}
Dan Stoza412903f2017-04-27 13:42:17 -0700372 State& operator=(const State& other) {
373 // We explicitly don't copy stateSet so that, e.g., mDrawingState
374 // always uses the Drawing StateSet.
375 layersSortedByZ = other.layersSortedByZ;
376 displays = other.displays;
Chia-I Wu28f320b2018-05-03 11:02:56 -0700377 colorMatrixChanged = other.colorMatrixChanged;
378 if (colorMatrixChanged) {
379 colorMatrix = other.colorMatrix;
380 }
Vishnu Nair08f6eae2019-11-26 14:01:39 -0800381 globalShadowSettings = other.globalShadowSettings;
382
Dan Stoza412903f2017-04-27 13:42:17 -0700383 return *this;
384 }
385
386 const LayerVector::StateSet stateSet = LayerVector::StateSet::Invalid;
Mathias Agopian92a979a2012-08-02 18:32:23 -0700387 LayerVector layersSortedByZ;
Dominik Laskowski68399272022-09-15 07:54:46 -0700388
389 // TODO(b/241285876): Replace deprecated DefaultKeyedVector with ftl::SmallMap.
390 DefaultKeyedVector<wp<IBinder>, DisplayDeviceState> displays;
391
392 std::optional<size_t> getDisplayIndex(PhysicalDisplayId displayId) const {
393 for (size_t i = 0; i < displays.size(); i++) {
394 const auto& state = displays.valueAt(i);
395 if (state.physical && state.physical->id == displayId) {
396 return i;
397 }
398 }
399
400 return {};
401 }
Robert Carr2047fae2016-11-28 14:09:09 -0800402
Chia-I Wu28f320b2018-05-03 11:02:56 -0700403 bool colorMatrixChanged = true;
404 mat4 colorMatrix;
405
Vishnu Nair08f6eae2019-11-26 14:01:39 -0800406 renderengine::ShadowSettings globalShadowSettings;
407
Edgar Arriaga844fa672020-01-16 14:21:42 -0800408 void traverse(const LayerVector::Visitor& visitor) const;
Dan Stoza412903f2017-04-27 13:42:17 -0700409 void traverseInZOrder(const LayerVector::Visitor& visitor) const;
410 void traverseInReverseZOrder(const LayerVector::Visitor& visitor) const;
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800411 };
412
Vishnu Nair8eda69e2021-02-26 10:42:10 -0800413 // Keeps track of pending buffers per layer handle in the transaction queue or current/drawing
414 // state before the buffers are latched. The layer owns the atomic counters and decrements the
415 // count in the main thread when dropping or latching a buffer.
416 //
417 // The binder threads increment the same counter when a new transaction containing a buffer is
418 // added to the transaction queue. The map is updated with the layer handle lifecycle updates.
419 // This is done to avoid lock contention with the main thread.
420 class BufferCountTracker {
421 public:
422 void increment(BBinder* layerHandle) {
423 std::lock_guard<std::mutex> lock(mLock);
424 auto it = mCounterByLayerHandle.find(layerHandle);
425 if (it != mCounterByLayerHandle.end()) {
426 auto [name, pendingBuffers] = it->second;
427 int32_t count = ++(*pendingBuffers);
428 ATRACE_INT(name.c_str(), count);
429 } else {
430 ALOGW("Handle not found! %p", layerHandle);
431 }
432 }
433
434 void add(BBinder* layerHandle, const std::string& name, std::atomic<int32_t>* counter) {
435 std::lock_guard<std::mutex> lock(mLock);
436 mCounterByLayerHandle[layerHandle] = std::make_pair(name, counter);
437 }
438
439 void remove(BBinder* layerHandle) {
440 std::lock_guard<std::mutex> lock(mLock);
441 mCounterByLayerHandle.erase(layerHandle);
442 }
443
444 private:
445 std::mutex mLock;
446 std::unordered_map<BBinder*, std::pair<std::string, std::atomic<int32_t>*>>
447 mCounterByLayerHandle GUARDED_BY(mLock);
448 };
449
Peiyong Linf243e5e2020-08-22 17:40:59 -0700450 enum class BootStage {
451 BOOTLOADER,
452 BOOTANIMATION,
453 FINISHED,
454 };
455
Vishnu Naird6913222023-02-01 22:56:21 +0000456 struct LayerCreatedState {
457 LayerCreatedState(const wp<Layer>& layer, const wp<Layer>& parent, bool addToRoot)
458 : layer(layer), initialParent(parent), addToRoot(addToRoot) {}
459 wp<Layer> layer;
460 // Indicates the initial parent of the created layer, only used for creating layer in
461 // SurfaceFlinger. If nullptr, it may add the created layer into the current root layers.
462 wp<Layer> initialParent;
463 // Indicates whether the layer getting created should be added at root if there's no parent
464 // and has permission ACCESS_SURFACE_FLINGER. If set to false and no parent, the layer will
465 // be added offscreen.
466 bool addToRoot;
467 };
468
469 struct LifecycleUpdate {
470 std::vector<TransactionState> transactions;
471 std::vector<LayerCreatedState> layerCreatedStates;
472 std::vector<std::unique_ptr<frontend::RequestedLayerState>> newLayers;
473 std::vector<uint32_t> destroyedHandles;
474 };
475
Peiyong Linf243e5e2020-08-22 17:40:59 -0700476 template <typename F, std::enable_if_t<!std::is_member_function_pointer_v<F>>* = nullptr>
477 static Dumper dumper(F&& dump) {
478 using namespace std::placeholders;
479 return std::bind(std::forward<F>(dump), _3);
480 }
481
482 template <typename F, std::enable_if_t<std::is_member_function_pointer_v<F>>* = nullptr>
483 Dumper dumper(F dump) {
484 using namespace std::placeholders;
485 return std::bind(dump, this, _3);
486 }
487
488 template <typename F>
489 Dumper argsDumper(F dump) {
490 using namespace std::placeholders;
491 return std::bind(dump, this, _1, _3);
492 }
493
494 template <typename F>
495 Dumper protoDumper(F dump) {
496 using namespace std::placeholders;
497 return std::bind(dump, this, _1, _2, _3);
498 }
499
Adithya Srinivasan2d736322020-10-01 16:53:48 -0700500 // Maximum allowed number of display frames that can be set through backdoor
501 static const int MAX_ALLOWED_DISPLAY_FRAMES = 2048;
Peiyong Linf243e5e2020-08-22 17:40:59 -0700502
Huihong Luo1b0c49f2022-03-15 19:18:21 -0700503 static const size_t MAX_LAYERS = 4096;
504
Peiyong Linf243e5e2020-08-22 17:40:59 -0700505 // Implements IBinder.
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800506 status_t onTransact(uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) override;
507 status_t dump(int fd, const Vector<String16>& args) override { return priorityDump(fd, args); }
Steven Thomasd4071902020-03-24 16:02:53 -0700508 bool callingThreadHasUnscopedSurfaceFlingerAccess(bool usePermissionCache = true)
509 EXCLUDES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800510
Peiyong Linf243e5e2020-08-22 17:40:59 -0700511 // Implements ISurfaceComposer
Huihong Luo1768cb02022-10-11 11:10:34 -0700512 sp<IBinder> createDisplay(const String8& displayName, bool secure,
513 float requestedRefreshRate = 0);
Huihong Luo07e72362022-02-14 14:26:04 -0800514 void destroyDisplay(const sp<IBinder>& displayToken);
515 std::vector<PhysicalDisplayId> getPhysicalDisplayIds() const EXCLUDES(mStateLock) {
Ady Abrahamed3290f2021-05-17 15:12:14 -0700516 Mutex::Autolock lock(mStateLock);
517 return getPhysicalDisplayIdsLocked();
518 }
Vishnu Nair8c8db542021-09-17 19:51:45 -0700519
Huihong Luo07e72362022-02-14 14:26:04 -0800520 sp<IBinder> getPhysicalDisplayToken(PhysicalDisplayId displayId) const;
Siarhei Vishniakoufc434ac2021-01-13 10:28:00 -1000521 status_t setTransactionState(const FrameTimelineInfo& frameTimelineInfo,
Vishnu Nair40fff5c2022-11-04 02:46:28 +0000522 Vector<ComposerState>& state, const Vector<DisplayState>& displays,
523 uint32_t flags, const sp<IBinder>& applyToken,
chaviw308ddba2020-08-11 16:23:51 -0700524 const InputWindowCommands& inputWindowCommands,
Ady Abrahamf0c56492020-12-17 18:04:15 -0800525 int64_t desiredPresentTime, bool isAutoTimestamp,
Patrick Williams75ce1ea2023-01-19 15:02:30 -0600526 const std::vector<client_cache_t>& uncacheBuffers,
527 bool hasListenerCallbacks,
Pablo Gamito7eb7ee72020-08-05 10:57:05 +0000528 const std::vector<ListenerCallbacks>& listenerCallbacks,
529 uint64_t transactionId) override;
Huihong Luo1b0c49f2022-03-15 19:18:21 -0700530 void bootFinished();
Huihong Luo0a81aa32022-02-22 16:02:36 -0800531 virtual status_t getSupportedFrameTimestamps(std::vector<FrameEvent>* outSupported) const;
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800532 sp<IDisplayEventConnection> createDisplayEventConnection(
Huihong Luo1b0c49f2022-03-15 19:18:21 -0700533 gui::ISurfaceComposer::VsyncSource vsyncSource =
534 gui::ISurfaceComposer::VsyncSource::eVsyncSourceApp,
Rachel Lee2248f522023-01-27 16:45:23 -0800535 EventRegistrationFlags eventRegistration = {},
536 const sp<IBinder>& layerHandle = nullptr);
Dominik Laskowskif1833852021-03-23 15:06:50 -0700537
Huihong Luof5029222021-12-16 14:33:46 -0800538 status_t captureDisplay(const DisplayCaptureArgs&, const sp<IScreenCaptureListener>&);
539 status_t captureDisplay(DisplayId, const sp<IScreenCaptureListener>&);
540 status_t captureLayers(const LayerCaptureArgs&, const sp<IScreenCaptureListener>&);
Robert Carr108b2c72019-04-02 16:32:58 -0700541
Huihong Luoaa7fc2e2022-02-15 10:43:00 -0800542 status_t getDisplayStats(const sp<IBinder>& displayToken, DisplayStatInfo* stats);
Marin Shalamanov228f46b2021-01-28 21:11:45 +0100543 status_t getDisplayState(const sp<IBinder>& displayToken, ui::DisplayState*)
Huihong Luoaa7fc2e2022-02-15 10:43:00 -0800544 EXCLUDES(mStateLock);
Sally Qi6bb12822022-10-05 11:42:30 -0700545 status_t getStaticDisplayInfo(int64_t displayId, ui::StaticDisplayInfo*) EXCLUDES(mStateLock);
546 status_t getDynamicDisplayInfoFromId(int64_t displayId, ui::DynamicDisplayInfo*)
Huihong Luoa79ddf42022-02-17 00:01:38 -0800547 EXCLUDES(mStateLock);
Sally Qi6bb12822022-10-05 11:42:30 -0700548 status_t getDynamicDisplayInfoFromToken(const sp<IBinder>& displayToken,
549 ui::DynamicDisplayInfo*) EXCLUDES(mStateLock);
550 void getDynamicDisplayInfoInternal(ui::DynamicDisplayInfo*&, const sp<DisplayDevice>&,
551 const display::DisplaySnapshot&);
Huihong Luoca3d9a42022-02-22 11:07:34 -0800552 status_t getDisplayNativePrimaries(const sp<IBinder>& displayToken, ui::DisplayPrimaries&);
553 status_t setActiveColorMode(const sp<IBinder>& displayToken, ui::ColorMode colorMode);
Huihong Luo37396db2022-02-15 10:43:00 -0800554 status_t getBootDisplayModeSupport(bool* outSupport) const;
Dominik Laskowskib363c4c2022-08-02 14:03:41 -0700555 status_t setBootDisplayMode(const sp<display::DisplayToken>&, DisplayModeId);
Sally Qi0cbd08b2022-08-17 12:12:28 -0700556 status_t getOverlaySupport(gui::OverlayProperties* outProperties) const;
Huihong Luo37396db2022-02-15 10:43:00 -0800557 status_t clearBootDisplayMode(const sp<IBinder>& displayToken);
Kriti Dang674b9372022-11-18 10:58:44 +0100558 status_t getHdrConversionCapabilities(
559 std::vector<gui::HdrConversionCapability>* hdrConversionCapaabilities) const;
560 status_t setHdrConversionStrategy(const gui::HdrConversionStrategy& hdrConversionStrategy);
561 status_t getHdrOutputConversionSupport(bool* outSupport) const;
Huihong Luo37396db2022-02-15 10:43:00 -0800562 void setAutoLowLatencyMode(const sp<IBinder>& displayToken, bool on);
563 void setGameContentType(const sp<IBinder>& displayToken, bool on);
564 void setPowerMode(const sp<IBinder>& displayToken, int mode);
Kriti Dang49ad4132021-01-08 11:49:56 +0100565 status_t overrideHdrTypes(const sp<IBinder>& displayToken,
Huihong Luo05539a12022-02-23 10:29:40 -0800566 const std::vector<ui::Hdr>& hdrTypes);
Huihong Luo30aa4372022-10-03 14:54:12 -0700567 status_t onPullAtom(const int32_t atomId, std::vector<uint8_t>* pulledData, bool* success);
Huihong Luo05539a12022-02-23 10:29:40 -0800568 status_t getLayerDebugInfo(std::vector<gui::LayerDebugInfo>* outLayers);
569 status_t getColorManagement(bool* outGetColorManagement) const;
Peiyong Linc6780972018-10-28 15:24:08 -0700570 status_t getCompositionPreference(ui::Dataspace* outDataspace, ui::PixelFormat* outPixelFormat,
571 ui::Dataspace* outWideColorGamutDataspace,
Huihong Luo05539a12022-02-23 10:29:40 -0800572 ui::PixelFormat* outWideColorGamutPixelFormat) const;
Dominik Laskowski470df5f2020-04-02 22:27:42 -0700573 status_t getDisplayedContentSamplingAttributes(const sp<IBinder>& displayToken,
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800574 ui::PixelFormat* outFormat,
575 ui::Dataspace* outDataspace,
Huihong Luo05539a12022-02-23 10:29:40 -0800576 uint8_t* outComponentMask) const;
Dominik Laskowski470df5f2020-04-02 22:27:42 -0700577 status_t setDisplayContentSamplingEnabled(const sp<IBinder>& displayToken, bool enable,
Huihong Luo05539a12022-02-23 10:29:40 -0800578 uint8_t componentMask, uint64_t maxFrames);
Dominik Laskowski470df5f2020-04-02 22:27:42 -0700579 status_t getDisplayedContentSample(const sp<IBinder>& displayToken, uint64_t maxFrames,
Huihong Luo05539a12022-02-23 10:29:40 -0800580 uint64_t timestamp, DisplayedFrameStats* outStats) const;
581 status_t getProtectedContentSupport(bool* outSupported) const;
Huihong Luo37396db2022-02-15 10:43:00 -0800582 status_t isWideColorDisplay(const sp<IBinder>& displayToken, bool* outIsWideColorDisplay) const;
Dan Stoza84ab9372018-12-17 15:27:57 -0800583 status_t addRegionSamplingListener(const Rect& samplingArea, const sp<IBinder>& stopLayerHandle,
Huihong Luo02186fb2022-02-23 14:21:54 -0800584 const sp<IRegionSamplingListener>& listener);
585 status_t removeRegionSamplingListener(const sp<IRegionSamplingListener>& listener);
586 status_t addFpsListener(int32_t taskId, const sp<gui::IFpsListener>& listener);
587 status_t removeFpsListener(const sp<gui::IFpsListener>& listener);
588 status_t addTunnelModeEnabledListener(const sp<gui::ITunnelModeEnabledListener>& listener);
589 status_t removeTunnelModeEnabledListener(const sp<gui::ITunnelModeEnabledListener>& listener);
Marin Shalamanov228f46b2021-01-28 21:11:45 +0100590 status_t setDesiredDisplayModeSpecs(const sp<IBinder>& displayToken,
Ady Abraham285f8c12022-10-11 17:12:14 -0700591 const gui::DisplayModeSpecs&);
592 status_t getDesiredDisplayModeSpecs(const sp<IBinder>& displayToken, gui::DisplayModeSpecs*);
Huihong Luo37396db2022-02-15 10:43:00 -0800593 status_t getDisplayBrightnessSupport(const sp<IBinder>& displayToken, bool* outSupport) const;
John Reck22be6962021-03-10 12:59:54 -0500594 status_t setDisplayBrightness(const sp<IBinder>& displayToken,
Huihong Luo37396db2022-02-15 10:43:00 -0800595 const gui::DisplayBrightness& brightness);
John Reck88270902021-03-18 11:27:35 -0400596 status_t addHdrLayerInfoListener(const sp<IBinder>& displayToken,
Huihong Luo37396db2022-02-15 10:43:00 -0800597 const sp<gui::IHdrLayerInfoListener>& listener);
John Reck88270902021-03-18 11:27:35 -0400598 status_t removeHdrLayerInfoListener(const sp<IBinder>& displayToken,
Huihong Luo37396db2022-02-15 10:43:00 -0800599 const sp<gui::IHdrLayerInfoListener>& listener);
600 status_t notifyPowerBoost(int32_t boostId);
Vishnu Nairb13bb952019-11-15 10:24:08 -0800601 status_t setGlobalShadowSettings(const half4& ambientColor, const half4& spotColor,
Huihong Luo3bdef862022-03-03 11:57:19 -0800602 float lightPosY, float lightPosZ, float lightRadius);
Leon Scroggins IIIe7c51c62022-02-01 15:53:54 -0500603 status_t getDisplayDecorationSupport(
604 const sp<IBinder>& displayToken,
605 std::optional<aidl::android::hardware::graphics::common::DisplayDecorationSupport>*
Huihong Luo3bdef862022-03-03 11:57:19 -0800606 outSupport) const;
Steven Thomas62a4cf82020-01-31 12:04:03 -0800607 status_t setFrameRate(const sp<IGraphicBufferProducer>& surface, float frameRate,
Huihong Luo3bdef862022-03-03 11:57:19 -0800608 int8_t compatibility, int8_t changeFrameRateStrategy);
Peiyong Linf243e5e2020-08-22 17:40:59 -0700609
Siarhei Vishniakoufc434ac2021-01-13 10:28:00 -1000610 status_t setFrameTimelineInfo(const sp<IGraphicBufferProducer>& surface,
Huihong Luo3bdef862022-03-03 11:57:19 -0800611 const gui::FrameTimelineInfo& frameTimelineInfo);
Ady Abraham74e17562020-08-24 18:18:19 -0700612
Huihong Luo3bdef862022-03-03 11:57:19 -0800613 status_t setOverrideFrameRate(uid_t uid, float frameRate);
Andy Yu2ae6b6b2021-11-18 14:51:06 -0800614
Huihong Luo02186fb2022-02-23 14:21:54 -0800615 int getGpuContextPriority();
Ana Krulec31f2b3c2020-12-14 14:30:09 -0800616
Huihong Luo02186fb2022-02-23 14:21:54 -0800617 status_t getMaxAcquiredBufferCount(int* buffers) const;
Ady Abraham564f9de2021-02-03 18:34:33 -0800618
Huihong Luo02186fb2022-02-23 14:21:54 -0800619 status_t addWindowInfosListener(const sp<gui::IWindowInfosListener>& windowInfosListener) const;
chaviw60c9d3e2021-06-04 12:52:17 -0500620 status_t removeWindowInfosListener(
Huihong Luo02186fb2022-02-23 14:21:54 -0800621 const sp<gui::IWindowInfosListener>& windowInfosListener) const;
chaviw60c9d3e2021-06-04 12:52:17 -0500622
Peiyong Linf243e5e2020-08-22 17:40:59 -0700623 // Implements IBinder::DeathRecipient.
Peiyong Lin2acb7d42019-01-14 17:22:27 -0800624 void binderDied(const wp<IBinder>& who) override;
Mathias Agopian99ce5cd2012-01-31 18:24:27 -0800625
Dominik Laskowski0deb06e2021-04-16 23:18:31 -0700626 // HWC2::ComposerCallback overrides:
Dominik Laskowskidc2bb802022-09-28 16:02:59 -0400627 void onComposerHalVsync(hal::HWDisplayId, nsecs_t timestamp,
Dominik Laskowski0deb06e2021-04-16 23:18:31 -0700628 std::optional<hal::VsyncPeriodNanos>) override;
629 void onComposerHalHotplug(hal::HWDisplayId, hal::Connection) override;
630 void onComposerHalRefresh(hal::HWDisplayId) override;
631 void onComposerHalVsyncPeriodTimingChanged(hal::HWDisplayId,
632 const hal::VsyncPeriodChangeTimeline&) override;
633 void onComposerHalSeamlessPossible(hal::HWDisplayId) override;
Yichi Chen3401b562022-01-17 15:42:35 +0800634 void onComposerHalVsyncIdle(hal::HWDisplayId) override;
ramindani12bfe6b2023-02-03 13:29:19 -0800635 void onRefreshRateChangedDebug(const RefreshRateChangedDebugData&) override;
Mathias Agopian86303202012-07-24 22:46:10 -0700636
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700637 // ICompositor overrides:
Dominik Laskowskif11728a2022-07-28 13:07:42 -0700638 void configure() override;
Dominik Laskowski08fbd852022-07-14 08:53:42 -0700639 bool commit(TimePoint frameTime, VsyncId, TimePoint expectedVsyncTime) override;
Dominik Laskowski08fbd852022-07-14 08:53:42 -0700640 void composite(TimePoint frameTime, VsyncId) override;
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700641 void sample() override;
642
Dominik Laskowskif11728a2022-07-28 13:07:42 -0700643 // ISchedulerCallback overrides:
Dominik Laskowski8b01cc02020-07-14 19:02:41 -0700644
645 // Toggles hardware VSYNC by calling into HWC.
Dominik Laskowski530d6bd2022-10-10 16:55:54 -0400646 // TODO(b/241286146): Rename for self-explanatory API.
Leon Scroggins IIIdb16a2b2023-02-06 17:50:05 -0500647 void setVsyncEnabled(bool) override;
Dominik Laskowski530d6bd2022-10-10 16:55:54 -0400648 void requestDisplayModes(std::vector<display::DisplayModeRequest>) override;
Ady Abrahama09852a2020-02-20 14:23:42 -0800649 void kernelTimerChanged(bool expired) override;
Ady Abraham62a0be22020-12-08 16:54:10 -0800650 void triggerOnFrameRateOverridesChanged() override;
Dominik Laskowskif11728a2022-07-28 13:07:42 -0700651
Ana Krulecb9afd792020-06-11 13:16:15 -0700652 // Toggles the kernel idle timer on or off depending the policy decisions around refresh rates.
Ady Abraham3efa3942021-06-24 19:01:25 -0700653 void toggleKernelIdleTimer() REQUIRES(mStateLock);
Dominik Laskowski530d6bd2022-10-10 16:55:54 -0400654
Dominik Laskowskid82e0f02022-10-26 15:23:04 -0400655 using KernelIdleTimerController = scheduler::RefreshRateSelector::KernelIdleTimerController;
Dominik Laskowski530d6bd2022-10-10 16:55:54 -0400656
ramindani32cf0602022-03-02 02:30:29 +0000657 // Get the controller and timeout that will help decide how the kernel idle timer will be
658 // configured and what value to use as the timeout.
659 std::pair<std::optional<KernelIdleTimerController>, std::chrono::milliseconds>
660 getKernelIdleTimerProperties(DisplayId) REQUIRES(mStateLock);
661 // Updates the kernel idle timer either through HWC or through sysprop
662 // depending on which controller is provided
663 void updateKernelIdleTimer(std::chrono::milliseconds timeoutMs, KernelIdleTimerController,
664 PhysicalDisplayId) REQUIRES(mStateLock);
Ana Krulecb9afd792020-06-11 13:16:15 -0700665 // Keeps track of whether the kernel idle timer is currently enabled, so we don't have to
666 // make calls to sys prop each time.
667 bool mKernelIdleTimerEnabled = false;
Ady Abraham29d0da32020-07-16 18:39:33 -0700668 // Show spinner with refresh rate overlay
669 bool mRefreshRateOverlaySpinner = false;
Ady Abraham0aa373a2022-11-22 13:56:50 -0800670 // Show render rate with refresh rate overlay
671 bool mRefreshRateOverlayRenderRate = false;
Yifei Zhangcfb7bb32023-01-12 16:17:14 -0800672 // Show render rate overlay offseted to the middle of the screen (e.g. for circular displays)
673 bool mRefreshRateOverlayShowInMiddle = false;
Dominik Laskowski8b01cc02020-07-14 19:02:41 -0700674
Dominik Laskowskifc378b02022-12-02 14:56:05 -0500675 void setDesiredActiveMode(display::DisplayModeRequest&&, bool force = false)
676 REQUIRES(mStateLock);
Dominik Laskowski530d6bd2022-10-10 16:55:54 -0400677
Dominik Laskowskib363c4c2022-08-02 14:03:41 -0700678 status_t setActiveModeFromBackdoor(const sp<display::DisplayToken>&, DisplayModeId);
Marin Shalamanovdd594312021-11-09 16:37:37 +0100679 // Sets the active mode and a new refresh rate in SF.
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700680 void updateInternalStateWithChangedMode() REQUIRES(mStateLock, kMainThreadContext);
Marin Shalamanova7fe3042021-01-29 21:02:08 +0100681 // Calls to setActiveMode on the main thread if there is a pending mode change
Ady Abraham27cbed72020-04-10 12:56:59 -0700682 // that needs to be applied.
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700683 void setActiveModeInHwcIfNeeded() REQUIRES(mStateLock, kMainThreadContext);
Ady Abraham690f4612021-07-01 23:24:03 -0700684 void clearDesiredActiveModeState(const sp<DisplayDevice>&) REQUIRES(mStateLock);
Marin Shalamanova7fe3042021-01-29 21:02:08 +0100685 // Called when active mode is no longer is progress
Ady Abraham690f4612021-07-01 23:24:03 -0700686 void desiredActiveModeChangeDone(const sp<DisplayDevice>&) REQUIRES(mStateLock);
Marin Shalamanov5801c942020-12-17 17:00:13 +0100687 // Called on the main thread in response to setPowerMode()
Peiyong Lin65248e02020-04-18 21:15:07 -0700688 void setPowerModeInternal(const sp<DisplayDevice>& display, hal::PowerMode mode)
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700689 REQUIRES(mStateLock, kMainThreadContext);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800690
Dominik Laskowskif2595442022-08-29 13:51:57 -0700691 // Returns the preferred mode for PhysicalDisplayId if the Scheduler has selected one for that
692 // display. Falls back to the display's defaultModeId otherwise.
Ady Abrahamace3d052022-11-17 16:25:05 -0800693 ftl::Optional<scheduler::FrameRateMode> getPreferredDisplayMode(
Dominik Laskowski530d6bd2022-10-10 16:55:54 -0400694 PhysicalDisplayId, DisplayModeId defaultModeId) const REQUIRES(mStateLock);
Dominik Laskowskif2595442022-08-29 13:51:57 -0700695
Dominik Laskowskid82e0f02022-10-26 15:23:04 -0400696 status_t setDesiredDisplayModeSpecsInternal(
697 const sp<DisplayDevice>&, const scheduler::RefreshRateSelector::PolicyVariant&)
Dominik Laskowski36dced82022-09-02 09:24:00 -0700698 EXCLUDES(mStateLock) REQUIRES(kMainThreadContext);
Ady Abraham838de062019-02-04 10:24:03 -0800699
Dominik Laskowski3f726402022-11-21 17:21:22 -0500700 // TODO(b/241285191): Look up RefreshRateSelector on Scheduler to remove redundant parameter.
701 status_t applyRefreshRateSelectorPolicy(PhysicalDisplayId,
Dominik Laskowskifc378b02022-12-02 14:56:05 -0500702 const scheduler::RefreshRateSelector&,
703 bool force = false)
Dominik Laskowski3f726402022-11-21 17:21:22 -0500704 REQUIRES(mStateLock, kMainThreadContext);
705
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700706 void commitTransactions() EXCLUDES(mStateLock) REQUIRES(kMainThreadContext);
707 void commitTransactionsLocked(uint32_t transactionFlags)
708 REQUIRES(mStateLock, kMainThreadContext);
Dominik Laskowski9e168db2021-05-27 16:05:12 -0700709 void doCommitTransactions() REQUIRES(mStateLock);
Dan Stoza6b9454d2014-11-07 16:00:59 -0800710
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700711 // Returns whether a new buffer has been latched.
712 bool latchBuffers();
Dan Stoza28d46a52020-04-28 09:54:54 -0700713
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -0700714 void updateLayerGeometry();
Vishnu Nair0a4fb002022-08-08 02:40:42 +0000715 void updateLayerMetadataSnapshot();
Vishnu Naird6913222023-02-01 22:56:21 +0000716 std::vector<std::pair<Layer*, LayerFE*>> moveSnapshotsToCompositionArgs(
717 compositionengine::CompositionRefreshArgs& refreshArgs, bool cursorOnly,
718 int64_t vsyncId);
719 void moveSnapshotsFromCompositionArgs(compositionengine::CompositionRefreshArgs& refreshArgs,
720 std::vector<std::pair<Layer*, LayerFE*>>& layers);
721 bool updateLayerSnapshotsLegacy(VsyncId vsyncId, LifecycleUpdate& update,
722 bool transactionsFlushed, bool& out)
723 REQUIRES(kMainThreadContext);
724 bool updateLayerSnapshots(VsyncId vsyncId, LifecycleUpdate& update, bool transactionsFlushed,
725 bool& out) REQUIRES(kMainThreadContext);
726 LifecycleUpdate flushLifecycleUpdates() REQUIRES(kMainThreadContext);
Dan Stoza6b9454d2014-11-07 16:00:59 -0800727
Vishnu Nair6194e2e2019-02-06 12:58:39 -0800728 void updateInputFlinger();
Dominik Laskowski298b08e2022-02-15 13:45:02 -0800729 void persistDisplayBrightness(bool needsComposite) REQUIRES(kMainThreadContext);
Vishnu Nair03ccbd62021-12-01 17:21:16 -0800730 void buildWindowInfos(std::vector<gui::WindowInfo>& outWindowInfos,
731 std::vector<gui::DisplayInfo>& outDisplayInfos);
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800732 void commitInputWindowCommands() REQUIRES(mStateLock);
Riley Andrews03414a12014-07-01 14:22:59 -0700733 void updateCursorAsync();
Dominik Laskowski08d05c22020-07-22 00:05:08 -0700734
Dominik Laskowski59db9562022-10-27 16:18:53 -0400735 void initScheduler(const sp<const DisplayDevice>&) REQUIRES(kMainThreadContext, mStateLock);
Dominik Laskowski1c99a002023-01-20 17:10:36 -0500736 void updatePhaseConfiguration(Fps) REQUIRES(mStateLock);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800737
Peiyong Linf243e5e2020-08-22 17:40:59 -0700738 /*
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700739 * Transactions
740 */
Patrick Williams75ce1ea2023-01-19 15:02:30 -0600741 bool applyTransactionState(
742 const FrameTimelineInfo& info, std::vector<ResolvedComposerState>& state,
743 Vector<DisplayState>& displays, uint32_t flags,
744 const InputWindowCommands& inputWindowCommands, const int64_t desiredPresentTime,
745 bool isAutoTimestamp, const std::vector<uint64_t>& uncacheBufferIds,
746 const int64_t postTime, uint32_t permissions, bool hasListenerCallbacks,
747 const std::vector<ListenerCallbacks>& listenerCallbacks, int originPid, int originUid,
748 uint64_t transactionId) REQUIRES(mStateLock);
Dominik Laskowski08fbd852022-07-14 08:53:42 -0700749 // Flush pending transactions that were presented after desiredPresentTime.
Vishnu Nair42ad3192023-01-24 19:17:59 -0800750 // For test only
Dominik Laskowski08fbd852022-07-14 08:53:42 -0700751 bool flushTransactionQueues(VsyncId) REQUIRES(kMainThreadContext);
Vishnu Nair42ad3192023-01-24 19:17:59 -0800752
753 bool applyTransactions(std::vector<TransactionState>&, VsyncId) REQUIRES(kMainThreadContext);
Vishnu Naird6913222023-02-01 22:56:21 +0000754 bool applyAndCommitDisplayTransactionStates(std::vector<TransactionState>& transactions)
755 REQUIRES(kMainThreadContext);
Vishnu Nair42ad3192023-01-24 19:17:59 -0800756
Marissa Walle6e3c0d2019-03-29 10:28:30 -0700757 // Returns true if there is at least one transaction that needs to be flushed
758 bool transactionFlushNeeded();
Vishnu Nair59f6d2d2022-10-05 16:59:56 -0700759 void addTransactionReadyFilters();
760 TransactionHandler::TransactionReadiness transactionReadyTimelineCheck(
761 const TransactionHandler::TransactionFlushState& flushState)
762 REQUIRES(kMainThreadContext);
763 TransactionHandler::TransactionReadiness transactionReadyBufferCheck(
764 const TransactionHandler::TransactionFlushState& flushState)
765 REQUIRES(kMainThreadContext);
Ady Abrahame1bfaac2022-02-22 21:32:08 -0800766
Vishnu Nair40fff5c2022-11-04 02:46:28 +0000767 uint32_t setClientStateLocked(const FrameTimelineInfo&, ResolvedComposerState&,
Dominik Laskowski48e09ef2021-08-04 14:05:30 -0700768 int64_t desiredPresentTime, bool isAutoTimestamp,
Patrick Williamsf1e5df12022-10-17 21:37:42 +0000769 int64_t postTime, uint32_t permissions, uint64_t transactionId)
770 REQUIRES(mStateLock);
Vishnu Naird6913222023-02-01 22:56:21 +0000771 uint32_t updateLayerCallbacksAndStats(const FrameTimelineInfo&, ResolvedComposerState&,
772 int64_t desiredPresentTime, bool isAutoTimestamp,
773 int64_t postTime, uint32_t permissions,
774 uint64_t transactionId) REQUIRES(mStateLock);
Dominik Laskowski9e168db2021-05-27 16:05:12 -0700775 uint32_t getTransactionFlags() const;
776
Dominik Laskowski94000c42022-03-17 12:55:14 -0700777 // Sets the masked bits, and schedules a commit if needed.
778 void setTransactionFlags(uint32_t mask, TransactionSchedule = TransactionSchedule::Late,
Dominik Laskowski1f6fc702022-03-21 08:34:50 -0700779 const sp<IBinder>& applyToken = nullptr,
780 FrameHint = FrameHint::kActive);
Dominik Laskowski9e168db2021-05-27 16:05:12 -0700781
782 // Clears and returns the masked bits.
783 uint32_t clearTransactionFlags(uint32_t mask);
784
chaviw74d90ad2019-04-26 14:45:26 -0700785 void commitOffscreenLayers();
Dominik Laskowski94000c42022-03-17 12:55:14 -0700786
ramindani4d48f902021-09-20 21:07:45 +0000787 static LatchUnsignaledConfig getLatchUnsignaledConfig();
Ady Abraham2739e832022-02-14 17:42:00 -0800788 bool shouldLatchUnsignaled(const sp<Layer>& layer, const layer_state_t&, size_t numStates,
Vishnu Nair59f6d2d2022-10-05 16:59:56 -0700789 bool firstTransaction) const;
Vishnu Nair42ad3192023-01-24 19:17:59 -0800790 bool applyTransactionsLocked(std::vector<TransactionState>& transactions, VsyncId)
Vishnu Nair7891e962021-11-11 12:07:21 -0800791 REQUIRES(mStateLock);
Vishnu Nairce5d0cc2019-02-28 14:38:41 -0800792 uint32_t setDisplayStateLocked(const DisplayState& s) REQUIRES(mStateLock);
Vishnu Nairfa5f8df2019-02-13 17:02:51 -0800793 uint32_t addInputWindowCommands(const InputWindowCommands& inputWindowCommands)
794 REQUIRES(mStateLock);
Dominik Laskowski08fbd852022-07-14 08:53:42 -0700795 bool frameIsEarly(TimePoint expectedPresentTime, VsyncId) const;
796
Peiyong Linf243e5e2020-08-22 17:40:59 -0700797 /*
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700798 * Layer management
799 */
Vishnu Naircb8be502022-10-12 19:03:23 +0000800 status_t createLayer(LayerCreationArgs& args, gui::CreateSurfaceResult& outResult);
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -0800801
Vishnu Nair7fb9e5a2021-11-08 12:44:05 -0800802 status_t createBufferStateLayer(LayerCreationArgs& args, sp<IBinder>* outHandle,
803 sp<Layer>* outLayer);
Marissa Wall61c58622018-07-18 10:12:20 -0700804
Vishnu Nair84125ac2021-12-02 08:47:48 -0800805 status_t createEffectLayer(const LayerCreationArgs& args, sp<IBinder>* outHandle,
Vishnu Nairfa247b12020-02-11 08:58:26 -0800806 sp<Layer>* outLayer);
Mathias Agopian74c40c02010-09-29 13:02:36 -0700807
Vishnu Nair84125ac2021-12-02 08:47:48 -0800808 status_t mirrorLayer(const LayerCreationArgs& args, const sp<IBinder>& mirrorFromHandle,
Patrick Williamsa361de62022-10-06 20:34:10 +0000809 gui::CreateSurfaceResult& outResult);
chaviwfe94a222019-08-21 13:52:59 -0700810
Chavi Weingarten7043a7d2022-07-19 23:40:35 +0000811 status_t mirrorDisplay(DisplayId displayId, const LayerCreationArgs& args,
Patrick Williamsa361de62022-10-06 20:34:10 +0000812 gui::CreateSurfaceResult& outResult);
Chavi Weingarten7043a7d2022-07-19 23:40:35 +0000813
Robert Carr6fb1a7e2018-12-11 12:07:25 -0800814 void markLayerPendingRemovalLocked(const sp<Layer>& layer);
Mathias Agopiana4912602012-07-12 14:25:33 -0700815
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700816 // add a layer to SurfaceFlinger
Vishnu Naircb8be502022-10-12 19:03:23 +0000817 status_t addClientLayer(const LayerCreationArgs& args, const sp<IBinder>& handle,
818 const sp<Layer>& layer, const wp<Layer>& parentLayer,
Garfield Tandbc93d72021-10-26 18:28:57 -0700819 uint32_t* outTransformHint);
Mathias Agopianf1d8e872009-04-20 19:39:12 -0700820
Vishnu Nair4351ad52019-02-11 14:13:02 -0800821 // Traverse through all the layers and compute and cache its bounds.
822 void computeLayerBounds();
823
Peiyong Linf243e5e2020-08-22 17:40:59 -0700824 // Boot animation, on/off animations and screen capture
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700825 void startBootAnim();
Mathias Agopian96f08192010-06-02 23:28:45 -0700826
Vishnu Nair7aa0eb72023-01-24 03:59:27 +0000827 ftl::SharedFuture<FenceResult> captureScreenCommon(RenderAreaFuture, GetLayerSnapshotsFunction,
Dominik Laskowskib17c6212022-05-09 09:36:19 -0700828 ui::Size bufferSize, ui::PixelFormat,
829 bool allowProtected, bool grayscale,
830 const sp<IScreenCaptureListener>&);
831 ftl::SharedFuture<FenceResult> captureScreenCommon(
Vishnu Nair7aa0eb72023-01-24 03:59:27 +0000832 RenderAreaFuture, GetLayerSnapshotsFunction,
Sally Qi59a9f502021-10-12 18:53:23 +0000833 const std::shared_ptr<renderengine::ExternalTexture>&, bool regionSampling,
834 bool grayscale, const sp<IScreenCaptureListener>&);
Dominik Laskowskib17c6212022-05-09 09:36:19 -0700835 ftl::SharedFuture<FenceResult> renderScreenImpl(
Vishnu Nair7aa0eb72023-01-24 03:59:27 +0000836 std::shared_ptr<const RenderArea>, GetLayerSnapshotsFunction,
Sally Qi59a9f502021-10-12 18:53:23 +0000837 const std::shared_ptr<renderengine::ExternalTexture>&, bool canCaptureBlackoutContent,
Patrick Williams377c0142022-10-13 17:33:38 +0000838 bool regionSampling, bool grayscale, ScreenCaptureResults&) EXCLUDES(mStateLock)
839 REQUIRES(kMainThreadContext);
chaviw03900772020-08-18 12:34:51 -0700840
chaviw4b9d5e12020-08-04 18:30:35 -0700841 // If the uid provided is not UNSET_UID, the traverse will skip any layers that don't have a
842 // matching ownerUid
843 void traverseLayersInLayerStack(ui::LayerStack, const int32_t uid, const LayerVector::Visitor&);
Mathias Agopianabe815d2013-03-19 22:22:21 -0700844
Romain Guy11d63f42017-07-20 12:47:14 -0700845 void readPersistentProperties();
846
rnleeed20fa42021-08-10 18:00:03 -0700847 uint32_t getMaxAcquiredBufferCountForCurrentRefreshRate(uid_t uid) const;
Ady Abraham899dcdb2021-06-15 16:56:21 -0700848
Peiyong Linf243e5e2020-08-22 17:40:59 -0700849 /*
Mathias Agopian87baae12012-07-31 12:38:26 -0700850 * Display and layer stack management
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700851 */
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700852
853 // Called during boot, and restart after system_server death.
Andy McFadden13a082e2012-08-24 10:16:42 -0700854 void initializeDisplays();
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700855 void onInitializeDisplays() REQUIRES(mStateLock, kMainThreadContext);
Andy McFadden13a082e2012-08-24 10:16:42 -0700856
Dominik Laskowski0a1435d2020-04-21 00:27:31 -0700857 sp<const DisplayDevice> getDisplayDeviceLocked(const wp<IBinder>& displayToken) const
858 REQUIRES(mStateLock) {
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700859 return const_cast<SurfaceFlinger*>(this)->getDisplayDeviceLocked(displayToken);
Mathias Agopian92a979a2012-08-02 18:32:23 -0700860 }
Mathias Agopiandb9b41f2012-10-15 16:51:41 -0700861
Dominik Laskowski0a1435d2020-04-21 00:27:31 -0700862 sp<DisplayDevice> getDisplayDeviceLocked(const wp<IBinder>& displayToken) REQUIRES(mStateLock) {
Dominik Laskowskieb627312022-04-07 09:13:16 -0700863 const sp<DisplayDevice> nullDisplay;
864 return mDisplays.get(displayToken).value_or(std::cref(nullDisplay));
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700865 }
Mathias Agopian99b49842011-06-27 16:05:52 -0700866
Ady Abraham690f4612021-07-01 23:24:03 -0700867 sp<const DisplayDevice> getDisplayDeviceLocked(PhysicalDisplayId id) const
868 REQUIRES(mStateLock) {
869 return const_cast<SurfaceFlinger*>(this)->getDisplayDeviceLocked(id);
870 }
871
872 sp<DisplayDevice> getDisplayDeviceLocked(PhysicalDisplayId id) REQUIRES(mStateLock) {
873 if (const auto token = getPhysicalDisplayTokenLocked(id)) {
874 return getDisplayDeviceLocked(token);
875 }
876 return nullptr;
877 }
878
Dominik Laskowski3c363242022-04-07 10:44:12 -0700879 sp<const DisplayDevice> getDisplayDeviceLocked(DisplayId id) const REQUIRES(mStateLock) {
880 // TODO(b/182939859): Replace tokens with IDs for display lookup.
881 return findDisplay([id](const auto& display) { return display.getId() == id; });
882 }
883
884 // Returns the primary display or (for foldables) the active display, assuming that the inner
885 // and outer displays have mutually exclusive power states.
Dominik Laskowski0a1435d2020-04-21 00:27:31 -0700886 sp<const DisplayDevice> getDefaultDisplayDeviceLocked() const REQUIRES(mStateLock) {
Dominik Laskowskieecd6592018-05-29 10:25:41 -0700887 return const_cast<SurfaceFlinger*>(this)->getDefaultDisplayDeviceLocked();
Stephen Kiazyk7d3dcb92017-04-05 16:46:49 -0700888 }
889
Dominik Laskowski0a1435d2020-04-21 00:27:31 -0700890 sp<DisplayDevice> getDefaultDisplayDeviceLocked() REQUIRES(mStateLock) {
Dominik Laskowskie591b552022-09-09 10:44:56 -0700891 if (const auto display = getDisplayDeviceLocked(mActiveDisplayId)) {
Ady Abrahamed3290f2021-05-17 15:12:14 -0700892 return display;
893 }
Dominik Laskowski3c363242022-04-07 10:44:12 -0700894 // The active display is outdated, so fall back to the primary display.
Dominik Laskowskie591b552022-09-09 10:44:56 -0700895 mActiveDisplayId = getPrimaryDisplayIdLocked();
896 return getDisplayDeviceLocked(mActiveDisplayId);
Michael Wright28f24d02016-07-12 13:30:53 -0700897 }
898
Ady Abraham3efa3942021-06-24 19:01:25 -0700899 sp<const DisplayDevice> getDefaultDisplayDevice() const EXCLUDES(mStateLock) {
Dominik Laskowski0a1435d2020-04-21 00:27:31 -0700900 Mutex::Autolock lock(mStateLock);
901 return getDefaultDisplayDeviceLocked();
902 }
Marin Shalamanovf5de90d2019-10-08 10:57:25 +0200903
Dominik Laskowskib363c4c2022-08-02 14:03:41 -0700904 using DisplayDeviceAndSnapshot =
905 std::pair<sp<DisplayDevice>, display::PhysicalDisplay::SnapshotRef>;
906
907 // Combinator for ftl::Optional<PhysicalDisplay>::and_then.
908 auto getDisplayDeviceAndSnapshot() REQUIRES(mStateLock) {
909 return [this](const display::PhysicalDisplay& display) REQUIRES(
910 mStateLock) -> ftl::Optional<DisplayDeviceAndSnapshot> {
911 if (auto device = getDisplayDeviceLocked(display.snapshot().displayId())) {
912 return std::make_pair(std::move(device), display.snapshotRef());
913 }
914
915 return {};
916 };
917 }
918
Dominik Laskowski7b9bf4c2021-03-18 12:21:29 -0700919 // Returns the first display that matches a `bool(const DisplayDevice&)` predicate.
920 template <typename Predicate>
921 sp<DisplayDevice> findDisplay(Predicate p) const REQUIRES(mStateLock) {
922 const auto it = std::find_if(mDisplays.begin(), mDisplays.end(),
923 [&](const auto& pair) { return p(*pair.second); });
924
925 return it == mDisplays.end() ? nullptr : it->second;
926 }
927
Ady Abrahamed3290f2021-05-17 15:12:14 -0700928 std::vector<PhysicalDisplayId> getPhysicalDisplayIdsLocked() const REQUIRES(mStateLock);
929
Mathias Agopian87baae12012-07-31 12:38:26 -0700930 // mark a region of a layer stack dirty. this updates the dirty
931 // region of all screens presenting this layer stack.
Vishnu Naird6913222023-02-01 22:56:21 +0000932 void invalidateLayerStack(const ui::LayerFilter& layerFilter, const Region& dirty);
Mathias Agopian87baae12012-07-31 12:38:26 -0700933
Dominik Laskowskib363c4c2022-08-02 14:03:41 -0700934 ui::LayerFilter makeLayerFilterForDisplay(DisplayId displayId, ui::LayerStack layerStack)
935 REQUIRES(mStateLock) {
936 return {layerStack,
937 PhysicalDisplayId::tryCast(displayId)
938 .and_then(display::getPhysicalDisplay(mPhysicalDisplays))
939 .transform(&display::PhysicalDisplay::isInternal)
940 .value_or(false)};
Ady Abrahamed3290f2021-05-17 15:12:14 -0700941 }
942
Peiyong Linf243e5e2020-08-22 17:40:59 -0700943 /*
Mathias Agopian86303202012-07-24 22:46:10 -0700944 * H/W composer
945 */
Marin Shalamanov6e840172020-12-14 22:13:28 +0100946 // The following thread safety rules apply when accessing HWComposer:
947 // 1. When reading display state from HWComposer on the main thread, it's not necessary to
948 // acquire mStateLock.
949 // 2. When accessing HWComposer on a thread other than the main thread, we always
Lloyd Pique441d5042018-10-18 16:49:51 -0700950 // need to acquire mStateLock. This is because the main thread could be
Marin Shalamanov6e840172020-12-14 22:13:28 +0100951 // in the process of writing display state, e.g. creating or destroying a display.
Lloyd Pique441d5042018-10-18 16:49:51 -0700952 HWComposer& getHwComposer() const;
Mathias Agopian86303202012-07-24 22:46:10 -0700953
Peiyong Linf243e5e2020-08-22 17:40:59 -0700954 /*
Mathias Agopian921e6ac2012-07-23 23:11:29 -0700955 * Compositing
956 */
Chavi Weingarten076acac2023-01-19 17:20:43 +0000957 void postComposition(nsecs_t callTime) REQUIRES(kMainThreadContext);
Mathias Agopian4da75192010-08-10 17:19:56 -0700958
Peiyong Linf243e5e2020-08-22 17:40:59 -0700959 /*
Jamie Gennis0bceb842012-08-23 20:19:38 -0700960 * Display management
961 */
Dominik Laskowskib0054a22022-03-03 09:03:06 -0800962 std::pair<DisplayModes, DisplayModePtr> loadDisplayModes(PhysicalDisplayId) const
963 REQUIRES(mStateLock);
964
Dominik Laskowskif11728a2022-07-28 13:07:42 -0700965 // TODO(b/241285876): Move to DisplayConfigurator.
966 //
967 // Returns whether displays have been added/changed/removed, i.e. whether ICompositor should
968 // commit display transactions.
969 bool configureLocked() REQUIRES(mStateLock) REQUIRES(kMainThreadContext)
970 EXCLUDES(mHotplugMutex);
971
Dominik Laskowskibb66e632022-08-17 08:00:25 -0700972 // Returns a string describing the hotplug, or nullptr if it was rejected.
973 const char* processHotplug(PhysicalDisplayId, hal::HWDisplayId, bool connected,
974 DisplayIdentificationInfo&&) REQUIRES(mStateLock)
975 REQUIRES(kMainThreadContext);
976
Lloyd Pique542307f2018-10-19 13:24:08 -0700977 sp<DisplayDevice> setupNewDisplayDeviceInternal(
Lloyd Pique9370a482019-10-03 17:58:30 -0700978 const wp<IBinder>& displayToken,
979 std::shared_ptr<compositionengine::Display> compositionDisplay,
Lloyd Pique542307f2018-10-19 13:24:08 -0700980 const DisplayDeviceState& state,
Marin Shalamanovae685592020-02-12 17:12:22 +0100981 const sp<compositionengine::DisplaySurface>& displaySurface,
Dominik Laskowski0a1435d2020-04-21 00:27:31 -0700982 const sp<IGraphicBufferProducer>& producer) REQUIRES(mStateLock);
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700983 void processDisplayChangesLocked() REQUIRES(mStateLock, kMainThreadContext);
Dominik Laskowski596a2562022-10-28 11:26:12 -0400984 void processDisplayRemoved(const wp<IBinder>& displayToken)
985 REQUIRES(mStateLock, kMainThreadContext);
Marin Shalamanovae685592020-02-12 17:12:22 +0100986 void processDisplayChanged(const wp<IBinder>& displayToken,
987 const DisplayDeviceState& currentState,
Dominik Laskowskif8734e02022-08-26 09:06:59 -0700988 const DisplayDeviceState& drawingState)
989 REQUIRES(mStateLock, kMainThreadContext);
Mathias Agopian3ee454a2012-08-27 16:28:24 -0700990
Dominik Laskowskidcb38bb2019-01-25 02:35:50 -0800991 void dispatchDisplayHotplugEvent(PhysicalDisplayId displayId, bool connected);
Dominik Laskowski1eba0202019-01-24 09:14:40 -0800992
Peiyong Linf243e5e2020-08-22 17:40:59 -0700993 /*
Dominik Laskowski08d05c22020-07-22 00:05:08 -0700994 * VSYNC
Jamie Gennisfaf77cc2013-07-30 15:10:32 -0700995 */
Ady Abraham2492a022020-07-24 11:09:55 -0700996 nsecs_t getVsyncPeriodFromHWC() const REQUIRES(mStateLock);
Robert Carr1f0a16a2016-10-24 16:27:39 -0700997
Leon Scroggins IIIdb16a2b2023-02-06 17:50:05 -0500998 void setHWCVsyncEnabled(PhysicalDisplayId id, hal::Vsync enabled) {
999 mLastHWCVsyncState = enabled;
1000 getHwComposer().setVsyncEnabled(id, enabled);
Ady Abraham4f960d12021-10-13 16:59:49 -07001001 }
1002
Dominik Laskowski5d164f22022-07-07 07:56:07 -07001003 using FenceTimePtr = std::shared_ptr<FenceTime>;
Ady Abraham6c1b7ac2021-03-31 16:56:03 -07001004
Dominik Laskowski08fbd852022-07-14 08:53:42 -07001005 const FenceTimePtr& getPreviousPresentFence(TimePoint frameTime, Period)
Dominik Laskowski5d164f22022-07-07 07:56:07 -07001006 REQUIRES(kMainThreadContext);
Alec Mouri6d414b52020-03-17 11:18:05 -07001007
Dominik Laskowski5d164f22022-07-07 07:56:07 -07001008 // Blocks the thread waiting for up to graceTimeMs in case the fence is about to signal.
1009 static bool isFencePending(const FenceTimePtr&, int graceTimeMs);
Dominik Laskowskia8955dd2019-07-10 10:19:09 -07001010
Ady Abraham5facfb12020-04-22 15:18:31 -07001011 // Calculates the expected present time for this frame. For negative offsets, performs a
Dominik Laskowskia8955dd2019-07-10 10:19:09 -07001012 // correction using the predicted vsync for the next frame instead.
Dominik Laskowski08fbd852022-07-14 08:53:42 -07001013 TimePoint calculateExpectedPresentTime(TimePoint frameTime) const;
Dominik Laskowskia8955dd2019-07-10 10:19:09 -07001014
Dominik Laskowskic2867142019-01-21 11:33:38 -08001015 /*
1016 * Display identification
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001017 */
Dominik Laskowskib363c4c2022-08-02 14:03:41 -07001018 sp<display::DisplayToken> getPhysicalDisplayTokenLocked(PhysicalDisplayId displayId) const
Marin Shalamanova524a092020-07-27 21:39:55 +02001019 REQUIRES(mStateLock) {
Dominik Laskowskib363c4c2022-08-02 14:03:41 -07001020 const sp<display::DisplayToken> nullToken;
1021 return mPhysicalDisplays.get(displayId)
1022 .transform([](const display::PhysicalDisplay& display) { return display.token(); })
1023 .value_or(std::cref(nullToken));
Dominik Laskowski075d3172018-05-24 15:50:06 -07001024 }
1025
Marin Shalamanov0f10d0d2020-08-06 20:04:06 +02001026 std::optional<PhysicalDisplayId> getPhysicalDisplayIdLocked(
Dominik Laskowskib363c4c2022-08-02 14:03:41 -07001027 const sp<display::DisplayToken>&) const REQUIRES(mStateLock);
Dominik Laskowski075d3172018-05-24 15:50:06 -07001028
Dominik Laskowski3c363242022-04-07 10:44:12 -07001029 // Returns the first display connected at boot.
Dominik Laskowskif8db0f02021-04-19 11:05:25 -07001030 //
Dominik Laskowski3c363242022-04-07 10:44:12 -07001031 // TODO(b/229851933): SF conflates the primary display with the first display connected at boot,
1032 // which typically has DisplayConnectionType::Internal. (Theoretically, it must be an internal
1033 // display because SF does not support disconnecting it, though in practice HWC may circumvent
1034 // this limitation.)
1035 sp<IBinder> getPrimaryDisplayTokenLocked() const REQUIRES(mStateLock) {
1036 return getPhysicalDisplayTokenLocked(getPrimaryDisplayIdLocked());
Dominik Laskowski075d3172018-05-24 15:50:06 -07001037 }
1038
Dominik Laskowski3c363242022-04-07 10:44:12 -07001039 PhysicalDisplayId getPrimaryDisplayIdLocked() const REQUIRES(mStateLock) {
Dominik Laskowskif8db0f02021-04-19 11:05:25 -07001040 return getHwComposer().getPrimaryDisplayId();
Dominik Laskowski075d3172018-05-24 15:50:06 -07001041 }
1042
Dominik Laskowski3dce4f42021-03-08 20:48:28 -08001043 // Toggles use of HAL/GPU virtual displays.
1044 void enableHalVirtualDisplays(bool);
1045
1046 // Virtual display lifecycle for ID generation and HAL allocation.
Dominik Laskowski263eec42021-07-21 23:13:24 -07001047 VirtualDisplayId acquireVirtualDisplay(ui::Size, ui::PixelFormat) REQUIRES(mStateLock);
Dominik Laskowski3dce4f42021-03-08 20:48:28 -08001048 void releaseVirtualDisplay(VirtualDisplayId);
1049
Dominik Laskowskic132a152022-11-30 15:44:52 -05001050 // TODO(b/255635821): Replace pointers with references. `inactiveDisplay` is only ever `nullptr`
1051 // in tests, and `activeDisplay` must not be `nullptr` as a precondition.
1052 void onActiveDisplayChangedLocked(const sp<DisplayDevice>& inactiveDisplay,
1053 const sp<DisplayDevice>& activeDisplay)
Dominik Laskowskif8734e02022-08-26 09:06:59 -07001054 REQUIRES(mStateLock, kMainThreadContext);
Ady Abrahamed3290f2021-05-17 15:12:14 -07001055
Dominik Laskowski68399272022-09-15 07:54:46 -07001056 void onActiveDisplaySizeChanged(const sp<const DisplayDevice>&);
Ady Abrahamed3290f2021-05-17 15:12:14 -07001057
Dominik Laskowskic2867142019-01-21 11:33:38 -08001058 /*
1059 * Debugging & dumpsys
1060 */
Alec Mouri67617332022-09-26 21:37:01 +00001061 void dumpAllLocked(const DumpArgs& args, const std::string& compositionLayers,
1062 std::string& result) const REQUIRES(mStateLock);
Ady Abraham5ad28d62022-08-11 11:26:57 -07001063 void dumpHwcLayersMinidumpLocked(std::string& result) const REQUIRES(mStateLock);
Dominik Laskowskic2867142019-01-21 11:33:38 -08001064
1065 void appendSfConfigString(std::string& result) const;
1066 void listLayersLocked(std::string& result) const;
1067 void dumpStatsLocked(const DumpArgs& args, std::string& result) const REQUIRES(mStateLock);
1068 void clearStatsLocked(const DumpArgs& args, std::string& result);
1069 void dumpTimeStats(const DumpArgs& args, bool asProto, std::string& result) const;
Adithya Srinivasan8fc601d2020-09-25 13:51:09 -07001070 void dumpFrameTimeline(const DumpArgs& args, std::string& result) const;
Dominik Laskowski8792c112022-07-12 09:03:39 -07001071 void logFrameStats(TimePoint now) REQUIRES(kMainThreadContext);
Jamie Gennis6547ff42013-07-16 20:12:42 -07001072
Dominik Laskowski03cfce82022-11-02 12:13:29 -04001073 void dumpScheduler(std::string& result) const REQUIRES(mStateLock);
1074 void dumpEvents(std::string& result) const REQUIRES(mStateLock);
1075 void dumpVsync(std::string& result) const REQUIRES(mStateLock);
Dominik Laskowski0acc3842022-04-07 11:23:42 -07001076
1077 void dumpCompositionDisplays(std::string& result) const REQUIRES(mStateLock);
1078 void dumpDisplays(std::string& result) const REQUIRES(mStateLock);
Dominik Laskowski0a1435d2020-04-21 00:27:31 -07001079 void dumpDisplayIdentificationData(std::string& result) const REQUIRES(mStateLock);
Dominik Laskowskib6e54372019-09-04 14:06:28 -07001080 void dumpRawDisplayIdentificationData(const DumpArgs&, std::string& result) const;
Dominik Laskowski0a1435d2020-04-21 00:27:31 -07001081 void dumpWideColorInfo(std::string& result) const REQUIRES(mStateLock);
Dominik Laskowski0acc3842022-04-07 11:23:42 -07001082
Dominik Laskowski542c9dc2020-04-10 12:42:02 -07001083 LayersProto dumpDrawingStateProto(uint32_t traceFlags) const;
Vishnu Nair0f085c62019-08-30 08:49:12 -07001084 void dumpOffscreenLayersProto(LayersProto& layersProto,
Vishnu Nair00b90132021-11-05 14:03:40 -07001085 uint32_t traceFlags = LayerTracing::TRACE_ALL) const;
chaviw0a398992021-08-13 10:13:01 -05001086 void dumpDisplayProto(LayersTraceProto& layersTraceProto) const;
1087
Alec Mouri6b9e9912020-01-21 10:50:24 -08001088 // Dumps state from HW Composer
1089 void dumpHwc(std::string& result) const;
Vishnu Nair00b90132021-11-05 14:03:40 -07001090 LayersProto dumpProtoFromMainThread(uint32_t traceFlags = LayerTracing::TRACE_ALL)
Vishnu Nair8406fd72019-07-30 11:29:31 -07001091 EXCLUDES(mStateLock);
Vishnu Nair0f085c62019-08-30 08:49:12 -07001092 void dumpOffscreenLayers(std::string& result) EXCLUDES(mStateLock);
Dan Stoza269dc4d2021-01-15 15:07:43 -08001093 void dumpPlannerInfo(const DumpArgs& args, std::string& result) const REQUIRES(mStateLock);
Dan Stozae77c7662016-05-13 11:37:28 -07001094
Dominik Laskowskic2867142019-01-21 11:33:38 -08001095 status_t doDump(int fd, const DumpArgs& args, bool asProto);
1096
Nataniel Borges8e7dc722019-02-28 15:10:28 -08001097 status_t dumpCritical(int fd, const DumpArgs&, bool asProto);
Dominik Laskowskic2867142019-01-21 11:33:38 -08001098
1099 status_t dumpAll(int fd, const DumpArgs& args, bool asProto) override {
1100 return doDump(fd, args, asProto);
1101 }
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -08001102
chaviw17ac24b2021-01-28 18:50:05 -08001103 static mat4 calculateColorMatrix(float saturation);
1104
Chia-I Wu28f320b2018-05-03 11:02:56 -07001105 void updateColorMatrixLocked();
1106
Peiyong Linf243e5e2020-08-22 17:40:59 -07001107 // Verify that transaction is being called by an approved process:
1108 // either AID_GRAPHICS or AID_SYSTEM.
1109 status_t CheckTransactCodeCredentials(uint32_t code);
1110
Ady Abrahame46243a2021-02-23 19:33:49 -08001111 // Add transaction to the Transaction Queue
Ady Abrahame46243a2021-02-23 19:33:49 -08001112
Peiyong Linf243e5e2020-08-22 17:40:59 -07001113 /*
1114 * Generic Layer Metadata
1115 */
1116 const std::unordered_map<std::string, uint32_t>& getGenericLayerMetadataKeyMap() const;
1117
Ady Abraham899dcdb2021-06-15 16:56:21 -07001118 static int calculateMaxAcquiredBufferCount(Fps refreshRate,
1119 std::chrono::nanoseconds presentLatency);
1120 int getMaxAcquiredBufferCountForRefreshRate(Fps refreshRate) const;
Ady Abraham564f9de2021-02-03 18:34:33 -08001121
Ady Abraham3efa3942021-06-24 19:01:25 -07001122 void updateInternalDisplayVsyncLocked(const sp<DisplayDevice>& activeDisplay)
Dominik Laskowskif8734e02022-08-26 09:06:59 -07001123 REQUIRES(mStateLock, kMainThreadContext);
Ady Abrahamed3290f2021-05-17 15:12:14 -07001124
Vishnu Nair7aa0eb72023-01-24 03:59:27 +00001125 bool isHdrLayer(const frontend::LayerSnapshot& snapshot) const;
John Reck49d9ad32022-02-23 19:03:31 -05001126
ramindani06e518e2022-03-14 18:47:53 +00001127 ui::Rotation getPhysicalDisplayOrientation(DisplayId, bool isPrimary) const
1128 REQUIRES(mStateLock);
1129
Peiyong Linf243e5e2020-08-22 17:40:59 -07001130 sp<StartPropertySetThread> mStartPropertySetThread;
Lloyd Pique90c115d2018-09-18 21:39:42 -07001131 surfaceflinger::Factory& mFactory;
Vishnu Nair7891e962021-11-11 12:07:21 -08001132 pid_t mPid;
Ady Abrahamfe2a6db2021-06-09 15:41:37 -07001133 std::future<void> mRenderEnginePrimeCacheFuture;
1134
Leon Scroggins IIIdb16a2b2023-02-06 17:50:05 -05001135 // access must be protected by mStateLock
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001136 mutable Mutex mStateLock;
Dan Stoza412903f2017-04-27 13:42:17 -07001137 State mCurrentState{LayerVector::StateSet::Current};
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001138 std::atomic<int32_t> mTransactionFlags = 0;
Vishnu Nair7891e962021-11-11 12:07:21 -08001139 std::atomic<uint32_t> mUniqueTransactionId = 1;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001140 SortedVector<sp<Layer>> mLayersPendingRemoval;
Dan Stoza101d8dc2018-02-27 15:42:25 -08001141
Brian Lindahl439afad2022-11-14 11:16:55 -07001142 // Buffers that have been discarded by clients and need to be evicted from per-layer caches so
1143 // the graphics memory can be immediately freed.
1144 std::vector<uint64_t> mBufferIdsToUncache;
1145
Chia-I Wu28f320b2018-05-03 11:02:56 -07001146 // global color transform states
1147 Daltonizer mDaltonizer;
1148 float mGlobalSaturationFactor = 1.0f;
1149 mat4 mClientColorMatrix;
1150
Huihong Luo1b0c49f2022-03-15 19:18:21 -07001151 size_t mMaxGraphicBufferProducerListSize = MAX_LAYERS;
Alec Mouri601393f2020-02-21 13:26:52 -08001152 // If there are more GraphicBufferProducers tracked by SurfaceFlinger than
1153 // this threshold, then begin logging.
1154 size_t mGraphicBufferProducerListSizeLogThreshold =
1155 static_cast<size_t>(0.95 * static_cast<double>(MAX_LAYERS));
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -08001156
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001157 // protected by mStateLock (but we could use another lock)
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001158 bool mLayersRemoved = false;
1159 bool mLayersAdded = false;
Mathias Agopianca4d3602011-05-19 15:38:14 -07001160
Dominik Laskowskie0e0cde2021-07-30 10:42:05 -07001161 std::atomic_bool mMustComposite = false;
Dominik Laskowski8da6b0e2021-05-12 15:34:13 -07001162 std::atomic_bool mGeometryDirty = false;
Mathias Agopianca4d3602011-05-19 15:38:14 -07001163
Hendrik Wagenaar87670ff2017-02-01 12:10:46 -08001164 // constant members (no synchronization needed for access)
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001165 const nsecs_t mBootTime = systemTime();
Alec Mouri5f487d42020-02-06 09:26:19 -08001166 bool mIsUserBuild = true;
Mathias Agopian3094df32012-06-18 18:06:45 -07001167
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001168 // Can only accessed from the main thread, these members
1169 // don't need synchronization
Dan Stoza412903f2017-04-27 13:42:17 -07001170 State mDrawingState{LayerVector::StateSet::Drawing};
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001171 bool mVisibleRegionsDirty = false;
Robert Carre450fb52021-06-11 13:21:09 -07001172
John Reck68796592023-01-25 13:47:12 -05001173 bool mHdrLayerInfoChanged = false;
1174
Robert Carr167bdde2021-07-28 11:26:51 -07001175 // Used to ensure we omit a callback when HDR layer info listener is newly added but the
1176 // scene hasn't changed
1177 bool mAddingHDRLayerInfoListener = false;
John Reck49d9ad32022-02-23 19:03:31 -05001178 bool mIgnoreHdrCameraLayers = false;
Robert Carr167bdde2021-07-28 11:26:51 -07001179
Robert Carre450fb52021-06-11 13:21:09 -07001180 // Set during transaction application stage to track if the input info or children
1181 // for a layer has changed.
1182 // TODO: Also move visibleRegions over to a boolean system.
Arthur Hung9ed43392022-05-27 06:31:57 +00001183 bool mUpdateInputInfo = false;
Robert Carre450fb52021-06-11 13:21:09 -07001184 bool mSomeChildrenChanged;
Robert Carrb552ff52021-06-11 13:35:54 -07001185 bool mForceTransactionDisplayChange = false;
Robert Carre450fb52021-06-11 13:21:09 -07001186
Vishnu Nair0a4fb002022-08-08 02:40:42 +00001187 // Set if LayerMetadata has changed since the last LayerMetadata snapshot.
1188 bool mLayerMetadataSnapshotNeeded = false;
1189
Vishnu Naird6913222023-02-01 22:56:21 +00001190 // TODO(b/238781169) validate these on composition
Alec Mouri5c9c9602020-09-01 15:10:40 -07001191 // Tracks layers that have pending frames which are candidates for being
Alec Mouri2f7d9ae2020-11-30 19:32:33 -08001192 // latched.
Huihong Luoa339d0a2022-02-05 09:42:42 -08001193 std::unordered_set<sp<Layer>, SpHash<Layer>> mLayersWithQueuedFrames;
Vishnu Nair6194e2e2019-02-06 12:58:39 -08001194 // Tracks layers that need to update a display's dirty region.
1195 std::vector<sp<Layer>> mLayersPendingRefresh;
Dominik Laskowski5d164f22022-07-07 07:56:07 -07001196
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001197 BootStage mBootStage = BootStage::BOOTLOADER;
Chia-I Wu14c9c7b2018-06-26 10:18:18 +08001198
Dominik Laskowskif11728a2022-07-28 13:07:42 -07001199 struct HotplugEvent {
1200 hal::HWDisplayId hwcDisplayId;
1201 hal::Connection connection = hal::Connection::INVALID;
1202 };
1203
1204 std::mutex mHotplugMutex;
1205 std::vector<HotplugEvent> mPendingHotplugEvents GUARDED_BY(mHotplugMutex);
Lloyd Piqueba04e622017-12-14 17:11:26 -08001206
Dominik Laskowskieb627312022-04-07 09:13:16 -07001207 // Displays are composited in `mDisplays` order. Internal displays are inserted at boot and
1208 // never removed, so take precedence over external and virtual displays.
1209 //
Dominik Laskowskieb627312022-04-07 09:13:16 -07001210 // May be read from any thread, but must only be written from the main thread.
Dominik Laskowskib363c4c2022-08-02 14:03:41 -07001211 display::DisplayMap<wp<IBinder>, const sp<DisplayDevice>> mDisplays GUARDED_BY(mStateLock);
1212
1213 display::PhysicalDisplays mPhysicalDisplays GUARDED_BY(mStateLock);
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001214
Dominik Laskowskie591b552022-09-09 10:44:56 -07001215 // The inner or outer display for foldables, assuming they have mutually exclusive power states.
Dominik Laskowskifc378b02022-12-02 14:56:05 -05001216 // Atomic because writes from onActiveDisplayChangedLocked are not always under mStateLock, but
1217 // reads from ISchedulerCallback::requestDisplayModes may happen concurrently.
1218 std::atomic<PhysicalDisplayId> mActiveDisplayId GUARDED_BY(mStateLock);
Dominik Laskowskie591b552022-09-09 10:44:56 -07001219
Dominik Laskowski3dce4f42021-03-08 20:48:28 -08001220 struct {
1221 DisplayIdGenerator<GpuVirtualDisplayId> gpu;
1222 std::optional<DisplayIdGenerator<HalVirtualDisplayId>> hal;
1223 } mVirtualDisplayIdGenerators;
Marin Shalamanov0f10d0d2020-08-06 20:04:06 +02001224
Dominik Laskowski8da6b0e2021-05-12 15:34:13 -07001225 std::atomic_uint mDebugFlashDelay = 0;
1226 std::atomic_bool mDebugDisableHWC = false;
1227 std::atomic_bool mDebugDisableTransformHint = false;
1228 std::atomic<nsecs_t> mDebugInTransaction = 0;
1229 std::atomic_bool mForceFullDamage = false;
1230
Alec Mouridd8bf2d2021-05-08 16:36:33 -07001231 bool mLayerCachingEnabled = false;
Dominik Laskowski63f12792023-01-21 16:58:22 -05001232 bool mBackpressureGpuComposition = false;
Dominik Laskowski542c9dc2020-04-10 12:42:02 -07001233
Vishnu Nair00b90132021-11-05 14:03:40 -07001234 LayerTracing mLayerTracing{*this};
Vishnu Nair7891e962021-11-11 12:07:21 -08001235 bool mLayerTracingEnabled = false;
1236
Dominik Laskowski46471e62022-01-14 15:34:03 -08001237 std::optional<TransactionTracing> mTransactionTracing;
Dominik Laskowski542c9dc2020-04-10 12:42:02 -07001238 std::atomic<bool> mTracingEnabledChanged = false;
1239
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001240 const std::shared_ptr<TimeStats> mTimeStats;
Mikael Pessa90092f42019-08-26 17:22:04 -07001241 const std::unique_ptr<FrameTracer> mFrameTracer;
Adithya Srinivasan5f683cf2020-09-15 14:21:04 -07001242 const std::unique_ptr<frametimeline::FrameTimeline> mFrameTimeline;
Dominik Laskowski3dce4f42021-03-08 20:48:28 -08001243
Dominik Laskowski08fbd852022-07-14 08:53:42 -07001244 VsyncId mLastCommittedVsyncId;
Pablo Gamito6be82442022-06-13 11:04:34 +00001245
Lucas Dupin00f16422020-03-11 11:33:04 -07001246 // If blurs should be enabled on this device.
1247 bool mSupportsBlur = false;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001248 std::atomic<uint32_t> mFrameMissedCount = 0;
1249 std::atomic<uint32_t> mHwcFrameMissedCount = 0;
1250 std::atomic<uint32_t> mGpuFrameMissedCount = 0;
Mathias Agopian921e6ac2012-07-23 23:11:29 -07001251
Robert Carr9a803c32021-01-14 16:57:58 -08001252 TransactionCallbackInvoker mTransactionCallbackInvoker;
Marissa Walle2ffb422018-10-12 11:33:52 -07001253
Dan Stoza436ccf32018-06-21 12:10:12 -07001254 // We maintain a pool of pre-generated texture names to hand out to avoid
1255 // layer creation needing to run on the main thread (which it would
1256 // otherwise need to do to access RenderEngine).
1257 std::mutex mTexturePoolMutex;
1258 uint32_t mTexturePoolSize = 0;
1259 std::vector<uint32_t> mTexturePool;
1260
chaviweadf0d42019-08-12 13:28:29 -07001261 std::atomic<size_t> mNumLayers = 0;
Robert Carr1f0a16a2016-10-24 16:27:39 -07001262
Steven Morelanda904bb92019-07-02 17:37:23 -07001263 // to linkToDeath
1264 sp<IBinder> mWindowManager;
Rob Carr2aa78cb2020-03-10 14:27:49 -07001265 // We want to avoid multiple calls to BOOT_FINISHED as they come in on
1266 // different threads without a lock and could trigger unsynchronized writes to
1267 // to mWindowManager or mInputFlinger
1268 std::atomic<bool> mBootFinished = false;
Steven Morelanda904bb92019-07-02 17:37:23 -07001269
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001270 std::thread::id mMainThreadId = std::this_thread::get_id();
Romain Guy0147a172017-06-01 13:53:56 -07001271
Lloyd Pique6a3b4462019-03-07 20:58:12 -08001272 DisplayColorSetting mDisplayColorSetting = DisplayColorSetting::kEnhanced;
David Sodman105b7dc2017-11-04 20:28:14 -07001273
Peiyong Lina3ea5592019-02-10 14:45:00 -08001274 // Color mode forced by setting persist.sys.sf.color_mode, it must:
1275 // 1. not be NATIVE color mode, NATIVE color mode means no forced color mode;
1276 // 2. be one of the supported color modes returned by hardware composer, otherwise
1277 // it will not be respected.
1278 // persist.sys.sf.color_mode will only take effect when persist.sys.sf.native_mode
1279 // is not set to 1.
1280 // This property can be used to force SurfaceFlinger to always pick a certain color mode.
1281 ui::ColorMode mForceColorMode = ui::ColorMode::NATIVE;
1282
Dominik Laskowski788945b2022-08-30 12:10:56 -07001283 // Whether to enable wide color gamut (e.g. Display P3) for internal displays that support it.
1284 // If false, wide color modes are filtered out for all internal displays.
1285 bool mSupportsWideColor = false;
1286
Peiyong Lin9d846a52018-11-05 13:18:20 -08001287 ui::Dataspace mDefaultCompositionDataspace;
1288 ui::Dataspace mWideColorGamutCompositionDataspace;
Yichi Chenda901bf2019-06-28 14:58:27 +08001289 ui::Dataspace mColorSpaceAgnosticDataspace;
Alec Mouri6da0e272022-02-07 12:45:57 -08001290 float mDimmingRatio = -1.f;
Peiyong Lin9d846a52018-11-05 13:18:20 -08001291
Patrick Williams0a525a42022-10-26 20:20:50 +00001292 std::unique_ptr<renderengine::RenderEngine> mRenderEngine;
Chavi Weingarten076acac2023-01-19 17:20:43 +00001293 std::atomic<int> mNumTrustedPresentationListeners = 0;
1294
Lloyd Pique70d91362018-10-18 16:02:55 -07001295 std::unique_ptr<compositionengine::CompositionEngine> mCompositionEngine;
Dominik Laskowski63f12792023-01-21 16:58:22 -05001296
1297 CompositionCoverageFlags mCompositionCoverage;
1298
Garfield Tan9c9c1912021-07-19 12:02:16 -07001299 // mMaxRenderTargetSize is only set once in init() so it doesn't need to be protected by
1300 // any mutex.
1301 size_t mMaxRenderTargetSize{1};
Ana Krulec98b5b242018-08-10 15:03:23 -07001302
Dominik Laskowskif06d68e2021-03-24 19:40:03 -07001303 const std::string mHwcServiceName;
1304
Peiyong Linf243e5e2020-08-22 17:40:59 -07001305 /*
Ana Krulecb43429d2019-01-09 14:28:51 -08001306 * Scheduler
1307 */
Dominik Laskowski068173d2021-08-11 17:22:59 -07001308 std::unique_ptr<scheduler::Scheduler> mScheduler;
Dominik Laskowski98041832019-08-01 18:35:59 -07001309 scheduler::ConnectionHandle mAppConnectionHandle;
1310 scheduler::ConnectionHandle mSfConnectionHandle;
Robert Carr720e5062018-07-30 17:45:14 -07001311
Dominik Laskowskieddeda12019-07-19 11:54:13 -07001312 // Stores phase offsets configured per refresh rate.
Ady Abraham8287e852020-08-12 14:44:58 -07001313 std::unique_ptr<scheduler::VsyncConfiguration> mVsyncConfiguration;
Dominik Laskowskieddeda12019-07-19 11:54:13 -07001314
Steven Thomas2bbaabe2019-08-28 16:08:35 -07001315 std::unique_ptr<scheduler::RefreshRateStats> mRefreshRateStats;
Dominik Laskowski80c77272022-07-08 12:47:29 -07001316 scheduler::PresentLatencyTracker mPresentLatencyTracker GUARDED_BY(kMainThreadContext);
Ady Abraham1902d072019-03-01 17:18:59 -08001317
Dominik Laskowski5d164f22022-07-07 07:56:07 -07001318 struct FenceWithFenceTime {
1319 sp<Fence> fence = Fence::NO_FENCE;
1320 FenceTimePtr fenceTime = FenceTime::NO_FENCE;
1321 };
1322 std::array<FenceWithFenceTime, 2> mPreviousPresentFences;
1323
Dominik Laskowski08fbd852022-07-14 08:53:42 -07001324 TimePoint mScheduledPresentTime GUARDED_BY(kMainThreadContext);
1325 TimePoint mExpectedPresentTime GUARDED_BY(kMainThreadContext);
1326
Leon Scroggins IIIdb16a2b2023-02-06 17:50:05 -05001327 hal::Vsync mHWCVsyncPendingState = hal::Vsync::DISABLE;
1328 hal::Vsync mLastHWCVsyncState = hal::Vsync::DISABLE;
1329
Ady Abrahamb838aed2019-02-12 15:30:16 -08001330 // below flags are set by main thread only
Marin Shalamanova7fe3042021-01-29 21:02:08 +01001331 bool mSetActiveModePending = false;
Ady Abrahamb838aed2019-02-12 15:30:16 -08001332
Kevin DuBois413287f2019-02-25 08:46:47 -08001333 bool mLumaSampling = true;
1334 sp<RegionSamplingThread> mRegionSamplingThread;
Alec Mouriadebf5c2021-01-05 12:57:36 -08001335 sp<FpsReporter> mFpsReporter;
Galia Peycheva8f04b302021-04-27 13:25:38 +02001336 sp<TunnelModeEnabledReporter> mTunnelModeEnabledReporter;
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001337 ui::DisplayPrimaries mInternalDisplayPrimaries;
Kevin DuBois413287f2019-02-25 08:46:47 -08001338
Dominik Laskowski3cb3d4e2019-11-21 11:14:45 -08001339 const float mEmulatedDisplayDensity;
Roman Kiryanov3388bf92022-11-11 15:35:16 -08001340 const float mInternalDisplayDensity;
Dominik Laskowski3cb3d4e2019-11-21 11:14:45 -08001341
Vishnu Nairfa5f8df2019-02-13 17:02:51 -08001342 // Should only be accessed by the main thread.
Vishnu Nair03ccbd62021-12-01 17:21:16 -08001343 sp<os::IInputFlinger> mInputFlinger;
chaviw273171b2018-12-26 11:46:30 -08001344 InputWindowCommands mInputWindowCommands;
chaviw291d88a2019-02-14 10:33:58 -08001345
Xiang Wang839fe5b2022-04-04 17:39:38 +00001346 std::unique_ptr<Hwc2::PowerAdvisor> mPowerAdvisor;
Ady Abraham03b02dd2019-03-21 15:40:11 -07001347
Dominik Laskowski02bb2072022-08-26 15:02:52 -07001348 void enableRefreshRateOverlay(bool enable) REQUIRES(mStateLock, kMainThreadContext);
Ady Abraham34392f72019-04-10 11:29:27 -07001349
Marin Shalamanova7fe3042021-01-29 21:02:08 +01001350 // Flag used to set override desired display mode from backdoor
1351 bool mDebugDisplayModeSetByBackdoor = false;
chaviw74d90ad2019-04-26 14:45:26 -07001352
1353 // A set of layers that have no parent so they are not drawn on screen.
1354 // Should only be accessed by the main thread.
1355 // The Layer pointer is removed from the set when the destructor is called so there shouldn't
1356 // be any issues with a raw pointer referencing an invalid object.
1357 std::unordered_set<Layer*> mOffscreenLayers;
Ady Abraham9ba25122019-06-03 17:10:55 -07001358
Vishnu Nair8eda69e2021-02-26 10:42:10 -08001359 BufferCountTracker mBufferCountTracker;
John Reck88270902021-03-18 11:27:35 -04001360
1361 std::unordered_map<DisplayId, sp<HdrLayerInfoReporter>> mHdrLayerInfoListeners
1362 GUARDED_BY(mStateLock);
John Reck68796592023-01-25 13:47:12 -05001363
Vishnu Nair0fc7af52022-01-13 08:11:34 -08001364 mutable std::mutex mCreatedLayersLock;
arthurhungdba591c2021-02-08 17:28:49 +08001365
1366 // A temporay pool that store the created layers and will be added to current state in main
1367 // thread.
Vishnu Nair0fc7af52022-01-13 08:11:34 -08001368 std::vector<LayerCreatedState> mCreatedLayers GUARDED_BY(mCreatedLayersLock);
Vishnu Naird6913222023-02-01 22:56:21 +00001369 bool commitCreatedLayers(VsyncId, std::vector<LayerCreatedState>& createdLayers);
Dominik Laskowski08fbd852022-07-14 08:53:42 -07001370 void handleLayerCreatedLocked(const LayerCreatedState&, VsyncId) REQUIRES(mStateLock);
arthurhungdba591c2021-02-08 17:28:49 +08001371
Chavi Weingarten7043a7d2022-07-19 23:40:35 +00001372 mutable std::mutex mMirrorDisplayLock;
1373 struct MirrorDisplayState {
1374 MirrorDisplayState(ui::LayerStack layerStack, sp<IBinder>& rootHandle,
1375 const sp<Client>& client)
1376 : layerStack(layerStack), rootHandle(rootHandle), client(client) {}
1377
1378 ui::LayerStack layerStack;
1379 sp<IBinder> rootHandle;
1380 const sp<Client> client;
1381 };
1382 std::vector<MirrorDisplayState> mMirrorDisplays GUARDED_BY(mMirrorDisplayLock);
Dominik Laskowski08fbd852022-07-14 08:53:42 -07001383 bool commitMirrorDisplays(VsyncId);
Chavi Weingarten7043a7d2022-07-19 23:40:35 +00001384
Ady Abraham1273ac12021-08-26 17:31:53 -07001385 std::atomic<ui::Transform::RotationFlags> mActiveDisplayTransformHint;
Ady Abraham562c2712021-05-07 15:10:42 -07001386
Ady Abraham1b11bc62021-06-03 19:51:19 -07001387 bool isRefreshRateOverlayEnabled() const REQUIRES(mStateLock) {
Dominik Laskowskieb627312022-04-07 09:13:16 -07001388 return hasDisplay(
1389 [](const auto& display) { return display.isRefreshRateOverlayEnabled(); });
Ady Abraham1b11bc62021-06-03 19:51:19 -07001390 }
Vishnu Naird6913222023-02-01 22:56:21 +00001391 std::function<std::vector<std::pair<Layer*, sp<LayerFE>>>()> getLayerSnapshotsForScreenshots(
1392 std::optional<ui::LayerStack> layerStack, uint32_t uid);
1393 std::function<std::vector<std::pair<Layer*, sp<LayerFE>>>()> getLayerSnapshotsForScreenshots(
1394 uint32_t rootLayerId, uint32_t uid, std::unordered_set<uint32_t> excludeLayerIds,
1395 bool childrenOnly, const FloatRect& parentCrop);
Ady Abraham1b11bc62021-06-03 19:51:19 -07001396
chaviw60c9d3e2021-06-04 12:52:17 -05001397 const sp<WindowInfosListenerInvoker> mWindowInfosListenerInvoker;
rnleea2ecd832021-07-29 13:58:30 -07001398
Robert Carr9b623c32022-03-21 15:55:22 -07001399 FlagManager mFlagManager;
Nathaniel Nifong1303d912021-10-06 09:41:24 -04001400
1401 // returns the framerate of the layer with the given sequence ID
1402 float getLayerFramerate(nsecs_t now, int32_t id) const {
1403 return mScheduler->getLayerFramerate(now, id);
1404 }
Matt Buckleyef51fba2021-10-12 19:30:12 +00001405
Matt Buckley50c44062022-01-17 20:48:10 +00001406 bool mPowerHintSessionEnabled;
1407
Vishnu Naird6913222023-02-01 22:56:21 +00001408 bool mLayerLifecycleManagerEnabled = false;
1409 bool mLegacyFrontEndEnabled = true;
1410
1411 frontend::LayerLifecycleManager mLayerLifecycleManager;
1412 frontend::LayerHierarchyBuilder mLayerHierarchyBuilder{{}};
1413 frontend::LayerSnapshotBuilder mLayerSnapshotBuilder;
1414
1415 std::vector<uint32_t> mDestroyedHandles;
1416 std::vector<std::unique_ptr<frontend::RequestedLayerState>> mNewLayers;
1417 // These classes do not store any client state but help with managing transaction callbacks
1418 // and stats.
1419 std::unordered_map<uint32_t, sp<Layer>> mLegacyLayers;
Matt Buckleyef51fba2021-10-12 19:30:12 +00001420 struct {
Matt Buckley50c44062022-01-17 20:48:10 +00001421 bool late = false;
1422 bool early = false;
1423 } mPowerHintSessionMode;
Ady Abrahame9ebce02022-02-03 12:05:06 -08001424
Vishnu Nair59f6d2d2022-10-05 16:59:56 -07001425 TransactionHandler mTransactionHandler;
Vishnu Nairaf6d2972022-11-18 06:26:38 +00001426 display::DisplayMap<ui::LayerStack, frontend::DisplayInfo> mFrontEndDisplayInfos;
Vishnu Naird6913222023-02-01 22:56:21 +00001427 bool mFrontEndDisplayInfosChanged = false;
Huihong Luof5029222021-12-16 14:33:46 -08001428};
1429
1430class SurfaceComposerAIDL : public gui::BnSurfaceComposer {
1431public:
Greg Kaisera5628662022-02-28 07:18:04 -08001432 SurfaceComposerAIDL(sp<SurfaceFlinger> sf) : mFlinger(std::move(sf)) {}
Huihong Luof5029222021-12-16 14:33:46 -08001433
Huihong Luo1b0c49f2022-03-15 19:18:21 -07001434 binder::Status bootFinished() override;
1435 binder::Status createDisplayEventConnection(
1436 VsyncSource vsyncSource, EventRegistration eventRegistration,
Rachel Lee2248f522023-01-27 16:45:23 -08001437 const sp<IBinder>& layerHandle,
Huihong Luo1b0c49f2022-03-15 19:18:21 -07001438 sp<gui::IDisplayEventConnection>* outConnection) override;
Huihong Luod3d8f8e2022-03-08 14:48:46 -08001439 binder::Status createConnection(sp<gui::ISurfaceComposerClient>* outClient) override;
Huihong Luo07e72362022-02-14 14:26:04 -08001440 binder::Status createDisplay(const std::string& displayName, bool secure,
Huihong Luo1768cb02022-10-11 11:10:34 -07001441 float requestedRefreshRate, sp<IBinder>* outDisplay) override;
Huihong Luo07e72362022-02-14 14:26:04 -08001442 binder::Status destroyDisplay(const sp<IBinder>& display) override;
1443 binder::Status getPhysicalDisplayIds(std::vector<int64_t>* outDisplayIds) override;
Huihong Luo07e72362022-02-14 14:26:04 -08001444 binder::Status getPhysicalDisplayToken(int64_t displayId, sp<IBinder>* outDisplay) override;
Huihong Luo37396db2022-02-15 10:43:00 -08001445 binder::Status setPowerMode(const sp<IBinder>& display, int mode) override;
Huihong Luo0a81aa32022-02-22 16:02:36 -08001446 binder::Status getSupportedFrameTimestamps(std::vector<FrameEvent>* outSupported) override;
Huihong Luoaa7fc2e2022-02-15 10:43:00 -08001447 binder::Status getDisplayStats(const sp<IBinder>& display,
1448 gui::DisplayStatInfo* outStatInfo) override;
1449 binder::Status getDisplayState(const sp<IBinder>& display,
1450 gui::DisplayState* outState) override;
Sally Qi6bb12822022-10-05 11:42:30 -07001451 binder::Status getStaticDisplayInfo(int64_t displayId,
Huihong Luoa79ddf42022-02-17 00:01:38 -08001452 gui::StaticDisplayInfo* outInfo) override;
Sally Qi6bb12822022-10-05 11:42:30 -07001453 binder::Status getDynamicDisplayInfoFromId(int64_t displayId,
1454 gui::DynamicDisplayInfo* outInfo) override;
1455 binder::Status getDynamicDisplayInfoFromToken(const sp<IBinder>& display,
1456 gui::DynamicDisplayInfo* outInfo) override;
Huihong Luoca3d9a42022-02-22 11:07:34 -08001457 binder::Status getDisplayNativePrimaries(const sp<IBinder>& display,
1458 gui::DisplayPrimaries* outPrimaries) override;
1459 binder::Status setActiveColorMode(const sp<IBinder>& display, int colorMode) override;
1460 binder::Status setBootDisplayMode(const sp<IBinder>& display, int displayModeId) override;
Huihong Luo37396db2022-02-15 10:43:00 -08001461 binder::Status clearBootDisplayMode(const sp<IBinder>& display) override;
1462 binder::Status getBootDisplayModeSupport(bool* outMode) override;
Sally Qi0cbd08b2022-08-17 12:12:28 -07001463 binder::Status getOverlaySupport(gui::OverlayProperties* outProperties) override;
Kriti Dang674b9372022-11-18 10:58:44 +01001464 binder::Status getHdrConversionCapabilities(
1465 std::vector<gui::HdrConversionCapability>*) override;
1466 binder::Status setHdrConversionStrategy(
1467 const gui::HdrConversionStrategy& hdrConversionStrategy) override;
1468 binder::Status getHdrOutputConversionSupport(bool* outSupport) override;
Huihong Luo37396db2022-02-15 10:43:00 -08001469 binder::Status setAutoLowLatencyMode(const sp<IBinder>& display, bool on) override;
1470 binder::Status setGameContentType(const sp<IBinder>& display, bool on) override;
Huihong Luof5029222021-12-16 14:33:46 -08001471 binder::Status captureDisplay(const DisplayCaptureArgs&,
1472 const sp<IScreenCaptureListener>&) override;
1473 binder::Status captureDisplayById(int64_t, const sp<IScreenCaptureListener>&) override;
1474 binder::Status captureLayers(const LayerCaptureArgs&,
1475 const sp<IScreenCaptureListener>&) override;
Dominik Laskowski66296b22022-07-12 08:20:36 -07001476
1477 // TODO(b/239076119): Remove deprecated AIDL.
Dominik Laskowskif84183b2022-07-25 14:02:10 -07001478 [[deprecated]] binder::Status clearAnimationFrameStats() override {
1479 return binder::Status::ok();
1480 }
Dominik Laskowski66296b22022-07-12 08:20:36 -07001481 [[deprecated]] binder::Status getAnimationFrameStats(gui::FrameStats*) override {
Dominik Laskowskif84183b2022-07-25 14:02:10 -07001482 return binder::Status::ok();
Dominik Laskowski66296b22022-07-12 08:20:36 -07001483 }
1484
Huihong Luo05539a12022-02-23 10:29:40 -08001485 binder::Status overrideHdrTypes(const sp<IBinder>& display,
1486 const std::vector<int32_t>& hdrTypes) override;
1487 binder::Status onPullAtom(int32_t atomId, gui::PullAtomData* outPullData) override;
Huihong Luo05539a12022-02-23 10:29:40 -08001488 binder::Status getLayerDebugInfo(std::vector<gui::LayerDebugInfo>* outLayers) override;
1489 binder::Status getColorManagement(bool* outGetColorManagement) override;
1490 binder::Status getCompositionPreference(gui::CompositionPreference* outPref) override;
1491 binder::Status getDisplayedContentSamplingAttributes(
1492 const sp<IBinder>& display, gui::ContentSamplingAttributes* outAttrs) override;
1493 binder::Status setDisplayContentSamplingEnabled(const sp<IBinder>& display, bool enable,
1494 int8_t componentMask,
1495 int64_t maxFrames) override;
Huihong Luo3bdef862022-03-03 11:57:19 -08001496 binder::Status getDisplayedContentSample(const sp<IBinder>& display, int64_t maxFrames,
1497 int64_t timestamp,
1498 gui::DisplayedFrameStats* outStats) override;
Huihong Luo05539a12022-02-23 10:29:40 -08001499 binder::Status getProtectedContentSupport(bool* outSupporte) override;
Huihong Luo37396db2022-02-15 10:43:00 -08001500 binder::Status isWideColorDisplay(const sp<IBinder>& token,
1501 bool* outIsWideColorDisplay) override;
Huihong Luo02186fb2022-02-23 14:21:54 -08001502 binder::Status addRegionSamplingListener(
1503 const gui::ARect& samplingArea, const sp<IBinder>& stopLayerHandle,
1504 const sp<gui::IRegionSamplingListener>& listener) override;
1505 binder::Status removeRegionSamplingListener(
1506 const sp<gui::IRegionSamplingListener>& listener) override;
1507 binder::Status addFpsListener(int32_t taskId, const sp<gui::IFpsListener>& listener) override;
1508 binder::Status removeFpsListener(const sp<gui::IFpsListener>& listener) override;
1509 binder::Status addTunnelModeEnabledListener(
1510 const sp<gui::ITunnelModeEnabledListener>& listener) override;
1511 binder::Status removeTunnelModeEnabledListener(
1512 const sp<gui::ITunnelModeEnabledListener>& listener) override;
Ady Abraham285f8c12022-10-11 17:12:14 -07001513 binder::Status setDesiredDisplayModeSpecs(const sp<IBinder>& displayToken,
1514 const gui::DisplayModeSpecs&) override;
Huihong Luo02186fb2022-02-23 14:21:54 -08001515 binder::Status getDesiredDisplayModeSpecs(const sp<IBinder>& displayToken,
1516 gui::DisplayModeSpecs* outSpecs) override;
Huihong Luo37396db2022-02-15 10:43:00 -08001517 binder::Status getDisplayBrightnessSupport(const sp<IBinder>& displayToken,
1518 bool* outSupport) override;
1519 binder::Status setDisplayBrightness(const sp<IBinder>& displayToken,
1520 const gui::DisplayBrightness& brightness) override;
1521 binder::Status addHdrLayerInfoListener(const sp<IBinder>& displayToken,
1522 const sp<gui::IHdrLayerInfoListener>& listener) override;
1523 binder::Status removeHdrLayerInfoListener(
1524 const sp<IBinder>& displayToken,
1525 const sp<gui::IHdrLayerInfoListener>& listener) override;
John Reck68796592023-01-25 13:47:12 -05001526
Huihong Luo37396db2022-02-15 10:43:00 -08001527 binder::Status notifyPowerBoost(int boostId) override;
Huihong Luo3bdef862022-03-03 11:57:19 -08001528 binder::Status setGlobalShadowSettings(const gui::Color& ambientColor,
1529 const gui::Color& spotColor, float lightPosY,
1530 float lightPosZ, float lightRadius) override;
1531 binder::Status getDisplayDecorationSupport(
1532 const sp<IBinder>& displayToken,
1533 std::optional<gui::DisplayDecorationSupport>* outSupport) override;
1534 binder::Status setOverrideFrameRate(int32_t uid, float frameRate) override;
Huihong Luo02186fb2022-02-23 14:21:54 -08001535 binder::Status getGpuContextPriority(int32_t* outPriority) override;
1536 binder::Status getMaxAcquiredBufferCount(int32_t* buffers) override;
1537 binder::Status addWindowInfosListener(
1538 const sp<gui::IWindowInfosListener>& windowInfosListener) override;
1539 binder::Status removeWindowInfosListener(
1540 const sp<gui::IWindowInfosListener>& windowInfosListener) override;
Huihong Luof5029222021-12-16 14:33:46 -08001541
1542private:
Huihong Luo07e72362022-02-14 14:26:04 -08001543 static const constexpr bool kUsePermissionCache = true;
1544 status_t checkAccessPermission(bool usePermissionCache = kUsePermissionCache);
Huihong Luo37396db2022-02-15 10:43:00 -08001545 status_t checkControlDisplayBrightnessPermission();
Huihong Luo02186fb2022-02-23 14:21:54 -08001546 status_t checkReadFrameBufferPermission();
Sally Qi6bb12822022-10-05 11:42:30 -07001547 static void getDynamicDisplayInfoInternal(ui::DynamicDisplayInfo& info,
1548 gui::DynamicDisplayInfo*& outInfo);
Huihong Luo07e72362022-02-14 14:26:04 -08001549
1550private:
Huihong Luof5029222021-12-16 14:33:46 -08001551 sp<SurfaceFlinger> mFlinger;
Romain Guy0147a172017-06-01 13:53:56 -07001552};
The Android Open Source Projectedbf3b62009-03-03 19:31:44 -08001553
Dominik Laskowski9dab3432019-03-27 13:21:10 -07001554} // namespace android