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 17 #ifndef ANDROID_GUI_ISURFACE_COMPOSER_H 18 #define ANDROID_GUI_ISURFACE_COMPOSER_H 19 20 #include <stdint.h> 21 #include <sys/types.h> 22 23 #include <utils/RefBase.h> 24 #include <utils/Errors.h> 25 26 #include <binder/IInterface.h> 27 28 #include <ui/PixelFormat.h> 29 30 #include <gui/IGraphicBufferAlloc.h> 31 #include <gui/ISurfaceComposerClient.h> 32 33 namespace android { 34 // ---------------------------------------------------------------------------- 35 36 class ComposerState; 37 class IDisplayEventConnection; 38 class IMemoryHeap; 39 40 class ISurfaceComposer : public IInterface 41 { 42 public: 43 DECLARE_META_INTERFACE(SurfaceComposer); 44 45 enum { // (keep in sync with Surface.java) 46 eHidden = 0x00000004, 47 eDestroyBackbuffer = 0x00000020, 48 eSecure = 0x00000080, 49 eNonPremultiplied = 0x00000100, 50 eOpaque = 0x00000400, 51 eProtectedByApp = 0x00000800, 52 eProtectedByDRM = 0x00001000, 53 54 eFXSurfaceNormal = 0x00000000, 55 eFXSurfaceBlur = 0x00010000, 56 eFXSurfaceDim = 0x00020000, 57 eFXSurfaceScreenshot= 0x00030000, 58 eFXSurfaceMask = 0x000F0000, 59 }; 60 61 enum { 62 ePositionChanged = 0x00000001, 63 eLayerChanged = 0x00000002, 64 eSizeChanged = 0x00000004, 65 eAlphaChanged = 0x00000008, 66 eMatrixChanged = 0x00000010, 67 eTransparentRegionChanged = 0x00000020, 68 eVisibilityChanged = 0x00000040, 69 eFreezeTintChanged = 0x00000080, 70 eCropChanged = 0x00000100, 71 }; 72 73 enum { 74 eLayerHidden = 0x01, 75 eLayerFrozen = 0x02, 76 eLayerDither = 0x04, 77 eLayerFilter = 0x08, 78 eLayerBlurFreeze = 0x10 79 }; 80 81 enum { 82 eOrientationDefault = 0, 83 eOrientation90 = 1, 84 eOrientation180 = 2, 85 eOrientation270 = 3, 86 eOrientationUnchanged = 4, 87 eOrientationSwapMask = 0x01 88 }; 89 90 enum { 91 eSynchronous = 0x01, 92 }; 93 94 enum { 95 eElectronBeamAnimationOn = 0x01, 96 eElectronBeamAnimationOff = 0x10 97 }; 98 99 /* create connection with surface flinger, requires 100 * ACCESS_SURFACE_FLINGER permission 101 */ 102 virtual sp<ISurfaceComposerClient> createConnection() = 0; 103 104 /* create a graphic buffer allocator 105 */ 106 virtual sp<IGraphicBufferAlloc> createGraphicBufferAlloc() = 0; 107 108 /* retrieve the control block */ 109 virtual sp<IMemoryHeap> getCblk() const = 0; 110 111 /* open/close transactions. requires ACCESS_SURFACE_FLINGER permission */ 112 virtual void setTransactionState(const Vector<ComposerState>& state, 113 int orientation, uint32_t flags) = 0; 114 115 /* signal that we're done booting. 116 * Requires ACCESS_SURFACE_FLINGER permission 117 */ 118 virtual void bootFinished() = 0; 119 120 /* Capture the specified screen. requires READ_FRAME_BUFFER permission 121 * This function will fail if there is a secure window on screen. 122 */ 123 virtual status_t captureScreen(DisplayID dpy, 124 sp<IMemoryHeap>* heap, 125 uint32_t* width, uint32_t* height, PixelFormat* format, 126 uint32_t reqWidth, uint32_t reqHeight, 127 uint32_t minLayerZ, uint32_t maxLayerZ) = 0; 128 129 /* triggers screen off animation */ 130 virtual status_t turnElectronBeamOff(int32_t mode) = 0; 131 132 /* triggers screen on animation */ 133 virtual status_t turnElectronBeamOn(int32_t mode) = 0; 134 135 /* verify that an ISurfaceTexture was created by SurfaceFlinger. 136 */ 137 virtual bool authenticateSurfaceTexture( 138 const sp<ISurfaceTexture>& surface) const = 0; 139 140 /* return an IDisplayEventConnection */ 141 virtual sp<IDisplayEventConnection> createDisplayEventConnection() = 0; 142 }; 143 144 // ---------------------------------------------------------------------------- 145 146 class BnSurfaceComposer : public BnInterface<ISurfaceComposer> 147 { 148 public: 149 enum { 150 // Note: BOOT_FINISHED must remain this value, it is called from 151 // Java by ActivityManagerService. 152 BOOT_FINISHED = IBinder::FIRST_CALL_TRANSACTION, 153 CREATE_CONNECTION, 154 CREATE_GRAPHIC_BUFFER_ALLOC, 155 GET_CBLK, 156 SET_TRANSACTION_STATE, 157 SET_ORIENTATION, 158 CAPTURE_SCREEN, 159 TURN_ELECTRON_BEAM_OFF, 160 TURN_ELECTRON_BEAM_ON, 161 AUTHENTICATE_SURFACE, 162 CREATE_DISPLAY_EVENT_CONNECTION, 163 }; 164 165 virtual status_t onTransact( uint32_t code, 166 const Parcel& data, 167 Parcel* reply, 168 uint32_t flags = 0); 169 }; 170 171 // ---------------------------------------------------------------------------- 172 173 }; // namespace android 174 175 #endif // ANDROID_GUI_ISURFACE_COMPOSER_H 176