ISurfaceComposer.h revision 134f0422866e8985188ed10dfbdcb8e6c34b87f7
1edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project/* 2edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 3edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 4edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * you may not use this file except in compliance with the License. 6edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * You may obtain a copy of the License at 7edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 8edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 10edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * See the License for the specific language governing permissions and 14edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * limitations under the License. 15edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 16edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 179cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian#ifndef ANDROID_SF_ISURFACE_COMPOSER_H 189cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian#define ANDROID_SF_ISURFACE_COMPOSER_H 19edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 20edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <stdint.h> 21edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <sys/types.h> 22edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 23edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/RefBase.h> 24edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <utils/Errors.h> 259cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian 26c5b2c0bf8007562536b822eb060fc54a01f8e08bMathias Agopian#include <binder/IInterface.h> 27edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 28edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/PixelFormat.h> 29edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 307e27f05739c8a2655cf0f7faea35614ce0a50278Mathias Agopian#include <surfaceflinger/ISurfaceComposerClient.h> 319a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis#include <surfaceflinger/IGraphicBufferAlloc.h> 32edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 339cce325fae8adcf7560a28eef394489f09bad74dMathias Agopiannamespace android { 34edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 35edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 36edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass ISurfaceComposer : public IInterface 37edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 38edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 39edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project DECLARE_META_INTERFACE(SurfaceComposer); 40edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 41edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { // (keep in sync with Surface.java) 42edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eHidden = 0x00000004, 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eDestroyBackbuffer = 0x00000020, 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eSecure = 0x00000080, 45edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eNonPremultiplied = 0x00000100, 463b996c96e4cd1057cb6b9531eaf8c01f934d2b2aRomain Guy eOpaque = 0x00000400, 4716f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten eProtectedByApp = 0x00000800, 4816f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten eProtectedByDRM = 0x00001000, 49edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 50edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceNormal = 0x00000000, 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceBlur = 0x00010000, 52edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceDim = 0x00020000, 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceMask = 0x000F0000, 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 55edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 56edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 57edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project ePositionChanged = 0x00000001, 58edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerChanged = 0x00000002, 59edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eSizeChanged = 0x00000004, 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eAlphaChanged = 0x00000008, 61edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eMatrixChanged = 0x00000010, 62edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eTransparentRegionChanged = 0x00000020, 63edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eVisibilityChanged = 0x00000040, 64edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFreezeTintChanged = 0x00000080, 65edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 66edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 67edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 68edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerHidden = 0x01, 69edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerFrozen = 0x02, 70edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerDither = 0x04, 71edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerFilter = 0x08, 72edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerBlurFreeze = 0x10 73edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 74edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 75edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 76edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientationDefault = 0, 77edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation90 = 1, 78edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation180 = 2, 79edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation270 = 3, 80edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientationSwapMask = 0x01 81edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 82c08731e756868653d09d3e49b723706df3687070Mathias Agopian 83abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian enum { 84abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian eElectronBeamAnimationOn = 0x01, 85abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian eElectronBeamAnimationOff = 0x10 86abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian }; 87abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian 88c08731e756868653d09d3e49b723706df3687070Mathias Agopian // flags for setOrientation 89c08731e756868653d09d3e49b723706df3687070Mathias Agopian enum { 90c08731e756868653d09d3e49b723706df3687070Mathias Agopian eOrientationAnimationDisable = 0x00000001 91c08731e756868653d09d3e49b723706df3687070Mathias Agopian }; 92edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 93edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* create connection with surface flinger, requires 94edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * ACCESS_SURFACE_FLINGER permission 95edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 967e27f05739c8a2655cf0f7faea35614ce0a50278Mathias Agopian virtual sp<ISurfaceComposerClient> createConnection() = 0; 97edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 98b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian /* create a client connection with surface flinger 99b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian */ 100b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian virtual sp<ISurfaceComposerClient> createClientConnection() = 0; 101b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 1029a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis /* create a graphic buffer allocator 1039a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis */ 1049a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis virtual sp<IGraphicBufferAlloc> createGraphicBufferAlloc() = 0; 1059a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis 106edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* retrieve the control block */ 1077303c6bf1a8b00a0e7d8165d774a1f259b4ccda9Mathias Agopian virtual sp<IMemoryHeap> getCblk() const = 0; 108edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1099cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* open/close transactions. requires ACCESS_SURFACE_FLINGER permission */ 110edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void openGlobalTransaction() = 0; 111edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void closeGlobalTransaction() = 0; 112edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1139cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* [un]freeze display. requires ACCESS_SURFACE_FLINGER permission */ 114edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t freezeDisplay(DisplayID dpy, uint32_t flags) = 0; 115edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t unfreezeDisplay(DisplayID dpy, uint32_t flags) = 0; 116edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1179cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* Set display orientation. requires ACCESS_SURFACE_FLINGER permission */ 118c08731e756868653d09d3e49b723706df3687070Mathias Agopian virtual int setOrientation(DisplayID dpy, int orientation, uint32_t flags) = 0; 119edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 120edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* signal that we're done booting. 1219cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian * Requires ACCESS_SURFACE_FLINGER permission 122edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 123edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void bootFinished() = 0; 124edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1251b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian /* Capture the specified screen. requires READ_FRAME_BUFFER permission 1261b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian * This function will fail if there is a secure window on screen. 1271b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian */ 1281b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian virtual status_t captureScreen(DisplayID dpy, 1291b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian sp<IMemoryHeap>* heap, 13074c40c0a273dbfd7d10617c4cc1b0c066bfc812eMathias Agopian uint32_t* width, uint32_t* height, PixelFormat* format, 131bf2c6a6c8f1df40ac94e28b948754bb9739daacaMathias Agopian uint32_t reqWidth, uint32_t reqHeight, 132bf2c6a6c8f1df40ac94e28b948754bb9739daacaMathias Agopian uint32_t minLayerZ, uint32_t maxLayerZ) = 0; 1331b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian 13459119e658a12279e8fff508f8773843de2d90917Mathias Agopian virtual status_t turnElectronBeamOff(int32_t mode) = 0; 1359daa5c9b9dd286cbbf5d43f7e45a5e9e4048e855Mathias Agopian virtual status_t turnElectronBeamOn(int32_t mode) = 0; 13659119e658a12279e8fff508f8773843de2d90917Mathias Agopian 137edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* Signal surfaceflinger that there might be some work to do 138edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * This is an ASYNCHRONOUS call. 139edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 140edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void signal() const = 0; 141134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis 142134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis /* verify that an ISurface was created by SurfaceFlinger. 143134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis */ 144134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis virtual bool authenticateSurface(const sp<ISurface>& surface) const = 0; 145edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 146edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 147edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 148edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 149edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass BnSurfaceComposer : public BnInterface<ISurfaceComposer> 150edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 151edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 152edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 153edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Note: BOOT_FINISHED must remain this value, it is called from 154edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Java by ActivityManagerService. 155edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project BOOT_FINISHED = IBinder::FIRST_CALL_TRANSACTION, 156edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project CREATE_CONNECTION, 157b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian CREATE_CLIENT_CONNECTION, 1589a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis CREATE_GRAPHIC_BUFFER_ALLOC, 159edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project GET_CBLK, 160edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project OPEN_GLOBAL_TRANSACTION, 161edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project CLOSE_GLOBAL_TRANSACTION, 162edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project SET_ORIENTATION, 163edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project FREEZE_DISPLAY, 164edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project UNFREEZE_DISPLAY, 1651b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian SIGNAL, 16659119e658a12279e8fff508f8773843de2d90917Mathias Agopian CAPTURE_SCREEN, 1679daa5c9b9dd286cbbf5d43f7e45a5e9e4048e855Mathias Agopian TURN_ELECTRON_BEAM_OFF, 168134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis TURN_ELECTRON_BEAM_ON, 169134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis AUTHENTICATE_SURFACE, 170edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 171edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 172edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t onTransact( uint32_t code, 173edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const Parcel& data, 174edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Parcel* reply, 175edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t flags = 0); 176edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 177edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 178edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 179edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 180edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 181edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1829cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian#endif // ANDROID_SF_ISURFACE_COMPOSER_H 183