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 Surface.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 
46         eFXSurfaceBufferQueue = 0x00000000,
47         eFXSurfaceColor = 0x00020000,
48         eFXSurfaceBufferState = 0x00040000,
49         eFXSurfaceContainer = 0x00080000,
50         eFXSurfaceMask = 0x000F0000,
51     };
52 
53     /*
54      * Requires ACCESS_SURFACE_FLINGER permission
55      */
56     virtual status_t createSurface(const String8& name, uint32_t w, uint32_t h, PixelFormat format,
57                                    uint32_t flags, const sp<IBinder>& parent,
58                                    LayerMetadata metadata, sp<IBinder>* handle,
59                                    sp<IGraphicBufferProducer>* gbp) = 0;
60 
61     /*
62      * Requires ACCESS_SURFACE_FLINGER permission
63      */
64     virtual status_t createWithSurfaceParent(const String8& name, uint32_t w, uint32_t h,
65                                              PixelFormat format, uint32_t flags,
66                                              const sp<IGraphicBufferProducer>& parent,
67                                              LayerMetadata metadata, sp<IBinder>* handle,
68                                              sp<IGraphicBufferProducer>* gbp) = 0;
69 
70     /*
71      * Requires ACCESS_SURFACE_FLINGER permission
72      */
73     virtual status_t clearLayerFrameStats(const sp<IBinder>& handle) const = 0;
74 
75     /*
76      * Requires ACCESS_SURFACE_FLINGER permission
77      */
78     virtual status_t getLayerFrameStats(const sp<IBinder>& handle, FrameStats* outStats) const = 0;
79 };
80 
81 class BnSurfaceComposerClient : public SafeBnInterface<ISurfaceComposerClient> {
82 public:
BnSurfaceComposerClient()83     BnSurfaceComposerClient()
84           : SafeBnInterface<ISurfaceComposerClient>("BnSurfaceComposerClient") {}
85 
86     status_t onTransact(uint32_t code, const Parcel& data, Parcel* reply, uint32_t flags) override;
87 };
88 
89 } // namespace android
90