1 /*
2  * Copyright 2023 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #pragma once
18 
19 #include <gui/DisplayInfo.h>
20 
21 #include "FrontEnd/LayerCreationArgs.h"
22 #include "RequestedLayerState.h"
23 #include "TransactionState.h"
24 
25 namespace android {
26 struct LayerCreatedState {
LayerCreatedStateLayerCreatedState27     LayerCreatedState(const wp<Layer>& layer, const wp<Layer>& parent, bool addToRoot)
28           : layer(layer), initialParent(parent), addToRoot(addToRoot) {}
29     wp<Layer> layer;
30     // Indicates the initial parent of the created layer, only used for creating layer in
31     // SurfaceFlinger. If nullptr, it may add the created layer into the current root layers.
32     wp<Layer> initialParent;
33     // Indicates whether the layer getting created should be added at root if there's no parent
34     // and has permission ACCESS_SURFACE_FLINGER. If set to false and no parent, the layer will
35     // be added offscreen.
36     bool addToRoot;
37 };
38 } // namespace android
39 
40 namespace android::surfaceflinger::frontend {
41 
42 // Atomic set of changes affecting layer state. These changes are queued in binder threads and
43 // applied every vsync.
44 struct Update {
45     std::vector<TransactionState> transactions;
46     std::vector<LayerCreatedState> layerCreatedStates;
47     std::vector<std::unique_ptr<frontend::RequestedLayerState>> newLayers;
48     std::vector<LayerCreationArgs> layerCreationArgs;
49     std::vector<std::pair<uint32_t, std::string /* debugName */>> destroyedHandles;
50 };
51 
52 } // namespace android::surfaceflinger::frontend
53