The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2006 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 | |
Mathias Agopian | 90ac799 | 2012-02-25 18:48:35 -0800 | [diff] [blame] | 17 | #ifndef ANDROID_GUI_ISURFACE_COMPOSER_H |
| 18 | #define ANDROID_GUI_ISURFACE_COMPOSER_H |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 19 | |
| 20 | #include <stdint.h> |
| 21 | #include <sys/types.h> |
| 22 | |
| 23 | #include <utils/RefBase.h> |
| 24 | #include <utils/Errors.h> |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 25 | #include <utils/Timers.h> |
| 26 | #include <utils/Vector.h> |
Mathias Agopian | 9cce325 | 2010-02-09 17:46:37 -0800 | [diff] [blame] | 27 | |
Mathias Agopian | c5b2c0b | 2009-05-19 19:08:10 -0700 | [diff] [blame] | 28 | #include <binder/IInterface.h> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 29 | |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 30 | #include <ui/FrameStats.h> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 31 | #include <ui/PixelFormat.h> |
Mathias Agopian | 9cce325 | 2010-02-09 17:46:37 -0800 | [diff] [blame] | 32 | |
Mathias Agopian | 90ac799 | 2012-02-25 18:48:35 -0800 | [diff] [blame] | 33 | #include <gui/IGraphicBufferAlloc.h> |
| 34 | #include <gui/ISurfaceComposerClient.h> |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 35 | |
| 36 | namespace android { |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 37 | // ---------------------------------------------------------------------------- |
| 38 | |
Mathias Agopian | 439cf85 | 2011-11-29 13:07:24 -0800 | [diff] [blame] | 39 | class ComposerState; |
Mathias Agopian | 8b33f03 | 2012-07-24 20:43:54 -0700 | [diff] [blame] | 40 | class DisplayState; |
Mathias Agopian | c666cae | 2012-07-25 18:56:13 -0700 | [diff] [blame] | 41 | class DisplayInfo; |
Mathias Agopian | d0566bc | 2011-11-17 17:49:17 -0800 | [diff] [blame] | 42 | class IDisplayEventConnection; |
| 43 | class IMemoryHeap; |
Mathias Agopian | a67932f | 2011-04-20 14:20:59 -0700 | [diff] [blame] | 44 | |
Andy McFadden | 882e3a3 | 2013-01-08 16:06:15 -0800 | [diff] [blame] | 45 | /* |
| 46 | * This class defines the Binder IPC interface for accessing various |
| 47 | * SurfaceFlinger features. |
| 48 | */ |
Mathias Agopian | 3165cc2 | 2012-08-08 19:42:09 -0700 | [diff] [blame] | 49 | class ISurfaceComposer: public IInterface { |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 50 | public: |
| 51 | DECLARE_META_INTERFACE(SurfaceComposer); |
| 52 | |
Mathias Agopian | 3165cc2 | 2012-08-08 19:42:09 -0700 | [diff] [blame] | 53 | // flags for setTransactionState() |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 54 | enum { |
Mathias Agopian | 3165cc2 | 2012-08-08 19:42:09 -0700 | [diff] [blame] | 55 | eSynchronous = 0x01, |
Jamie Gennis | 2d5e230 | 2012-10-15 18:24:43 -0700 | [diff] [blame] | 56 | eAnimation = 0x02, |
Jamie Gennis | 2837839 | 2011-10-12 17:39:00 -0700 | [diff] [blame] | 57 | }; |
| 58 | |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 59 | enum { |
| 60 | eDisplayIdMain = 0, |
| 61 | eDisplayIdHdmi = 1 |
| 62 | }; |
| 63 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 64 | /* create connection with surface flinger, requires |
| 65 | * ACCESS_SURFACE_FLINGER permission |
| 66 | */ |
Mathias Agopian | 7e27f05 | 2010-05-28 14:22:23 -0700 | [diff] [blame] | 67 | virtual sp<ISurfaceComposerClient> createConnection() = 0; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 68 | |
Jamie Gennis | 9a78c90 | 2011-01-12 18:30:40 -0800 | [diff] [blame] | 69 | /* create a graphic buffer allocator |
| 70 | */ |
| 71 | virtual sp<IGraphicBufferAlloc> createGraphicBufferAlloc() = 0; |
| 72 | |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 73 | /* return an IDisplayEventConnection */ |
| 74 | virtual sp<IDisplayEventConnection> createDisplayEventConnection() = 0; |
| 75 | |
Jesse Hall | 6c913be | 2013-08-08 12:15:49 -0700 | [diff] [blame] | 76 | /* create a virtual display |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 77 | * requires ACCESS_SURFACE_FLINGER permission. |
| 78 | */ |
Jamie Gennis | dd3cb84 | 2012-10-19 18:19:11 -0700 | [diff] [blame] | 79 | virtual sp<IBinder> createDisplay(const String8& displayName, |
| 80 | bool secure) = 0; |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 81 | |
Jesse Hall | 6c913be | 2013-08-08 12:15:49 -0700 | [diff] [blame] | 82 | /* destroy a virtual display |
| 83 | * requires ACCESS_SURFACE_FLINGER permission. |
| 84 | */ |
| 85 | virtual void destroyDisplay(const sp<IBinder>& display) = 0; |
| 86 | |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 87 | /* get the token for the existing default displays. possible values |
| 88 | * for id are eDisplayIdMain and eDisplayIdHdmi. |
| 89 | */ |
| 90 | virtual sp<IBinder> getBuiltInDisplay(int32_t id) = 0; |
| 91 | |
Mathias Agopian | 9cce325 | 2010-02-09 17:46:37 -0800 | [diff] [blame] | 92 | /* open/close transactions. requires ACCESS_SURFACE_FLINGER permission */ |
Mathias Agopian | 3165cc2 | 2012-08-08 19:42:09 -0700 | [diff] [blame] | 93 | virtual void setTransactionState(const Vector<ComposerState>& state, |
| 94 | const Vector<DisplayState>& displays, uint32_t flags) = 0; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 95 | |
| 96 | /* signal that we're done booting. |
Mathias Agopian | 9cce325 | 2010-02-09 17:46:37 -0800 | [diff] [blame] | 97 | * Requires ACCESS_SURFACE_FLINGER permission |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 98 | */ |
| 99 | virtual void bootFinished() = 0; |
| 100 | |
Andy McFadden | 2adaf04 | 2012-12-18 09:49:45 -0800 | [diff] [blame] | 101 | /* verify that an IGraphicBufferProducer was created by SurfaceFlinger. |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 102 | */ |
| 103 | virtual bool authenticateSurfaceTexture( |
Andy McFadden | 2adaf04 | 2012-12-18 09:49:45 -0800 | [diff] [blame] | 104 | const sp<IGraphicBufferProducer>& surface) const = 0; |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 105 | |
Mathias Agopian | 041a075 | 2013-03-15 18:31:56 -0700 | [diff] [blame] | 106 | /* triggers screen off and waits for it to complete |
| 107 | * requires ACCESS_SURFACE_FLINGER permission. |
| 108 | */ |
Andy McFadden | c01a79d | 2012-09-27 16:02:06 -0700 | [diff] [blame] | 109 | virtual void blank(const sp<IBinder>& display) = 0; |
Colin Cross | 8e53306 | 2012-06-07 13:17:52 -0700 | [diff] [blame] | 110 | |
Mathias Agopian | 041a075 | 2013-03-15 18:31:56 -0700 | [diff] [blame] | 111 | /* triggers screen on and waits for it to complete |
| 112 | * requires ACCESS_SURFACE_FLINGER permission. |
| 113 | */ |
Andy McFadden | c01a79d | 2012-09-27 16:02:06 -0700 | [diff] [blame] | 114 | virtual void unblank(const sp<IBinder>& display) = 0; |
Mathias Agopian | 3094df3 | 2012-06-18 18:06:45 -0700 | [diff] [blame] | 115 | |
Dan Stoza | 7f7da32 | 2014-05-02 15:26:25 -0700 | [diff] [blame^] | 116 | /* returns information for each configuration of the given display |
Jeff Brown | 9d4e3d2 | 2012-08-24 20:00:51 -0700 | [diff] [blame] | 117 | * intended to be used to get information about built-in displays */ |
Dan Stoza | 7f7da32 | 2014-05-02 15:26:25 -0700 | [diff] [blame^] | 118 | virtual status_t getDisplayConfigs(const sp<IBinder>& display, |
| 119 | Vector<DisplayInfo>* configs) = 0; |
| 120 | |
| 121 | /* indicates which of the configurations returned by getDisplayInfo is |
| 122 | * currently active */ |
| 123 | virtual int getActiveConfig(const sp<IBinder>& display) = 0; |
| 124 | |
| 125 | /* specifies which configuration (of those returned by getDisplayInfo) |
| 126 | * should be used */ |
| 127 | virtual status_t setActiveConfig(const sp<IBinder>& display, int id) = 0; |
Mathias Agopian | 2a9fc49 | 2013-03-01 13:42:57 -0800 | [diff] [blame] | 128 | |
Mathias Agopian | 041a075 | 2013-03-15 18:31:56 -0700 | [diff] [blame] | 129 | /* Capture the specified screen. requires READ_FRAME_BUFFER permission |
| 130 | * This function will fail if there is a secure window on screen. |
| 131 | */ |
Mathias Agopian | 2a9fc49 | 2013-03-01 13:42:57 -0800 | [diff] [blame] | 132 | virtual status_t captureScreen(const sp<IBinder>& display, |
| 133 | const sp<IGraphicBufferProducer>& producer, |
| 134 | uint32_t reqWidth, uint32_t reqHeight, |
Dan Stoza | c701401 | 2014-02-14 15:03:43 -0800 | [diff] [blame] | 135 | uint32_t minLayerZ, uint32_t maxLayerZ, |
| 136 | bool useIdentityTransform) = 0; |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 137 | |
| 138 | |
| 139 | /* Clears the frame statistics for animations. |
| 140 | * |
| 141 | * Requires the ACCESS_SURFACE_FLINGER permission. |
| 142 | */ |
| 143 | virtual status_t clearAnimationFrameStats() = 0; |
| 144 | |
| 145 | /* Gets the frame statistics for animations. |
| 146 | * |
| 147 | * Requires the ACCESS_SURFACE_FLINGER permission. |
| 148 | */ |
| 149 | virtual status_t getAnimationFrameStats(FrameStats* outStats) const = 0; |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 150 | }; |
| 151 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 152 | // ---------------------------------------------------------------------------- |
| 153 | |
Mathias Agopian | 3165cc2 | 2012-08-08 19:42:09 -0700 | [diff] [blame] | 154 | class BnSurfaceComposer: public BnInterface<ISurfaceComposer> { |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 155 | public: |
| 156 | enum { |
| 157 | // Note: BOOT_FINISHED must remain this value, it is called from |
| 158 | // Java by ActivityManagerService. |
| 159 | BOOT_FINISHED = IBinder::FIRST_CALL_TRANSACTION, |
| 160 | CREATE_CONNECTION, |
Jamie Gennis | 9a78c90 | 2011-01-12 18:30:40 -0800 | [diff] [blame] | 161 | CREATE_GRAPHIC_BUFFER_ALLOC, |
Mathias Agopian | d0566bc | 2011-11-17 17:49:17 -0800 | [diff] [blame] | 162 | CREATE_DISPLAY_EVENT_CONNECTION, |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 163 | CREATE_DISPLAY, |
Jesse Hall | 6c913be | 2013-08-08 12:15:49 -0700 | [diff] [blame] | 164 | DESTROY_DISPLAY, |
Mathias Agopian | e57f292 | 2012-08-09 16:29:12 -0700 | [diff] [blame] | 165 | GET_BUILT_IN_DISPLAY, |
| 166 | SET_TRANSACTION_STATE, |
| 167 | AUTHENTICATE_SURFACE, |
Colin Cross | 8e53306 | 2012-06-07 13:17:52 -0700 | [diff] [blame] | 168 | BLANK, |
| 169 | UNBLANK, |
Dan Stoza | 7f7da32 | 2014-05-02 15:26:25 -0700 | [diff] [blame^] | 170 | GET_DISPLAY_CONFIGS, |
| 171 | GET_ACTIVE_CONFIG, |
| 172 | SET_ACTIVE_CONFIG, |
Mathias Agopian | 3094df3 | 2012-06-18 18:06:45 -0700 | [diff] [blame] | 173 | CONNECT_DISPLAY, |
Mathias Agopian | 2a9fc49 | 2013-03-01 13:42:57 -0800 | [diff] [blame] | 174 | CAPTURE_SCREEN, |
Svetoslav | d85084b | 2014-03-20 10:28:31 -0700 | [diff] [blame] | 175 | CLEAR_ANIMATION_FRAME_STATS, |
| 176 | GET_ANIMATION_FRAME_STATS |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 177 | }; |
| 178 | |
Mathias Agopian | 3165cc2 | 2012-08-08 19:42:09 -0700 | [diff] [blame] | 179 | virtual status_t onTransact(uint32_t code, const Parcel& data, |
| 180 | Parcel* reply, uint32_t flags = 0); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 181 | }; |
| 182 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 183 | // ---------------------------------------------------------------------------- |
| 184 | |
| 185 | }; // namespace android |
| 186 | |
Mathias Agopian | 90ac799 | 2012-02-25 18:48:35 -0800 | [diff] [blame] | 187 | #endif // ANDROID_GUI_ISURFACE_COMPOSER_H |