1 /*
2  * Copyright (C) 2007 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #pragma once
18 
19 #include <binder/IInterface.h>
20 #include <binder/SafeInterface.h>
21 #include <gui/LayerMetadata.h>
22 #include <ui/PixelFormat.h>
23 
24 #include <unordered_map>
25 
26 namespace android {
27 
28 class FrameStats;
29 class IGraphicBufferProducer;
30 
31 class ISurfaceComposerClient : public IInterface {
32 public:
33     DECLARE_META_INTERFACE(SurfaceComposerClient)
34 
35     // flags for createSurface()
36     enum { // (keep in sync with SurfaceControl.java)
37         eHidden = 0x00000004,
38         eDestroyBackbuffer = 0x00000020,
39         eSecure = 0x00000080,
40         eNonPremultiplied = 0x00000100,
41         eOpaque = 0x00000400,
42         eProtectedByApp = 0x00000800,
43         eProtectedByDRM = 0x00001000,
44         eCursorWindow = 0x00002000,
45         eNoColorFill = 0x00004000,
46 
47         eFXSurfaceBufferQueue = 0x00000000,
48         eFXSurfaceEffect = 0x00020000,
49         eFXSurfaceBufferState = 0x00040000,
50         eFXSurfaceContainer = 0x00080000,
51         eFXSurfaceMask = 0x000F0000,
52     };
53 
54     /*
55      * Requires ACCESS_SURFACE_FLINGER permission
56      */
57     virtual status_t createSurface(const String8& name, uint32_t w, uint32_t h, PixelFormat format,
58                                    uint32_t flags, const sp<IBinder>& parent,
59                                    LayerMetadata metadata, sp<IBinder>* handle,
60                                    sp<IGraphicBufferProducer>* gbp, uint32_t* outTransformHint) = 0;
61 
62     /*
63      * Requires ACCESS_SURFACE_FLINGER permission
64      */
65     virtual status_t createWithSurfaceParent(const String8& name, uint32_t w, uint32_t h,
66                                              PixelFormat format, uint32_t flags,
67                                              const sp<IGraphicBufferProducer>& parent,
68                                              LayerMetadata metadata, sp<IBinder>* handle,
69                                              sp<IGraphicBufferProducer>* gbp,
70                                              uint32_t* outTransformHint) = 0;
71 
72     /*
73      * Requires ACCESS_SURFACE_FLINGER permission
74      */
75     virtual status_t clearLayerFrameStats(const sp<IBinder>& handle) const = 0;
76 
77     /*
78      * Requires ACCESS_SURFACE_FLINGER permission
79      */
80     virtual status_t getLayerFrameStats(const sp<IBinder>& handle, FrameStats* outStats) const = 0;
81 
82     virtual status_t mirrorSurface(const sp<IBinder>& mirrorFromHandle, sp<IBinder>* outHandle) = 0;
83 };
84 
85 class BnSurfaceComposerClient : public SafeBnInterface<ISurfaceComposerClient> {
86 public:
BnSurfaceComposerClient()87     BnSurfaceComposerClient()
88           : SafeBnInterface<ISurfaceComposerClient>("BnSurfaceComposerClient") {}
89 
90     status_t onTransact(uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) override;
91 };
92 
93 } // namespace android
94