ISurfaceComposer.h revision a67932fe6864ac346e7f78b86df11cf6c5344137
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 36a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopianclass IMemoryHeap; 37a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian 38edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass ISurfaceComposer : public IInterface 39edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 40edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 41edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project DECLARE_META_INTERFACE(SurfaceComposer); 42edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { // (keep in sync with Surface.java) 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eHidden = 0x00000004, 45edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eDestroyBackbuffer = 0x00000020, 46edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eSecure = 0x00000080, 47edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eNonPremultiplied = 0x00000100, 483b996c96e4cd1057cb6b9531eaf8c01f934d2b2aRomain Guy eOpaque = 0x00000400, 4916f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten eProtectedByApp = 0x00000800, 5016f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten eProtectedByDRM = 0x00001000, 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 52edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceNormal = 0x00000000, 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceBlur = 0x00010000, 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceDim = 0x00020000, 55edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceMask = 0x000F0000, 56edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 57edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 58edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 59edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project ePositionChanged = 0x00000001, 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerChanged = 0x00000002, 61edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eSizeChanged = 0x00000004, 62edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eAlphaChanged = 0x00000008, 63edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eMatrixChanged = 0x00000010, 64edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eTransparentRegionChanged = 0x00000020, 65edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eVisibilityChanged = 0x00000040, 66edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFreezeTintChanged = 0x00000080, 67edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 68edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 69edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 70edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerHidden = 0x01, 71edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerFrozen = 0x02, 72edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerDither = 0x04, 73edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerFilter = 0x08, 74edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerBlurFreeze = 0x10 75edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 76edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 77edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 78edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientationDefault = 0, 79edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation90 = 1, 80edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation180 = 2, 81edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation270 = 3, 82edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientationSwapMask = 0x01 83edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 84c08731e756868653d09d3e49b723706df3687070Mathias Agopian 85abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian enum { 86abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian eElectronBeamAnimationOn = 0x01, 87abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian eElectronBeamAnimationOff = 0x10 88abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian }; 89abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian 90c08731e756868653d09d3e49b723706df3687070Mathias Agopian // flags for setOrientation 91c08731e756868653d09d3e49b723706df3687070Mathias Agopian enum { 92c08731e756868653d09d3e49b723706df3687070Mathias Agopian eOrientationAnimationDisable = 0x00000001 93c08731e756868653d09d3e49b723706df3687070Mathias Agopian }; 94edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 95edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* create connection with surface flinger, requires 96edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * ACCESS_SURFACE_FLINGER permission 97edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 987e27f05739c8a2655cf0f7faea35614ce0a50278Mathias Agopian virtual sp<ISurfaceComposerClient> createConnection() = 0; 99edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1009a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis /* create a graphic buffer allocator 1019a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis */ 1029a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis virtual sp<IGraphicBufferAlloc> createGraphicBufferAlloc() = 0; 1039a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis 104edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* retrieve the control block */ 1057303c6bf1a8b00a0e7d8165d774a1f259b4ccda9Mathias Agopian virtual sp<IMemoryHeap> getCblk() const = 0; 106edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1079cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* open/close transactions. requires ACCESS_SURFACE_FLINGER permission */ 108edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void openGlobalTransaction() = 0; 109edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void closeGlobalTransaction() = 0; 110edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1119cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* [un]freeze display. requires ACCESS_SURFACE_FLINGER permission */ 112edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t freezeDisplay(DisplayID dpy, uint32_t flags) = 0; 113edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t unfreezeDisplay(DisplayID dpy, uint32_t flags) = 0; 114edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1159cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* Set display orientation. requires ACCESS_SURFACE_FLINGER permission */ 116c08731e756868653d09d3e49b723706df3687070Mathias Agopian virtual int setOrientation(DisplayID dpy, int orientation, uint32_t flags) = 0; 117edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 118edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* signal that we're done booting. 1199cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian * Requires ACCESS_SURFACE_FLINGER permission 120edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 121edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void bootFinished() = 0; 122edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1231b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian /* Capture the specified screen. requires READ_FRAME_BUFFER permission 1241b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian * This function will fail if there is a secure window on screen. 1251b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian */ 1261b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian virtual status_t captureScreen(DisplayID dpy, 1271b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian sp<IMemoryHeap>* heap, 12874c40c0a273dbfd7d10617c4cc1b0c066bfc812eMathias Agopian uint32_t* width, uint32_t* height, PixelFormat* format, 129bf2c6a6c8f1df40ac94e28b948754bb9739daacaMathias Agopian uint32_t reqWidth, uint32_t reqHeight, 130bf2c6a6c8f1df40ac94e28b948754bb9739daacaMathias Agopian uint32_t minLayerZ, uint32_t maxLayerZ) = 0; 1311b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian 13259119e658a12279e8fff508f8773843de2d90917Mathias Agopian virtual status_t turnElectronBeamOff(int32_t mode) = 0; 1339daa5c9b9dd286cbbf5d43f7e45a5e9e4048e855Mathias Agopian virtual status_t turnElectronBeamOn(int32_t mode) = 0; 13459119e658a12279e8fff508f8773843de2d90917Mathias Agopian 135134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis /* verify that an ISurface was created by SurfaceFlinger. 136134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis */ 137134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis virtual bool authenticateSurface(const sp<ISurface>& surface) const = 0; 138edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 139edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 140edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 141edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 142edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass BnSurfaceComposer : public BnInterface<ISurfaceComposer> 143edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 144edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 145edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 146edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Note: BOOT_FINISHED must remain this value, it is called from 147edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Java by ActivityManagerService. 148edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project BOOT_FINISHED = IBinder::FIRST_CALL_TRANSACTION, 149edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project CREATE_CONNECTION, 1509a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis CREATE_GRAPHIC_BUFFER_ALLOC, 151edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project GET_CBLK, 152edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project OPEN_GLOBAL_TRANSACTION, 153edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project CLOSE_GLOBAL_TRANSACTION, 154edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project SET_ORIENTATION, 155edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project FREEZE_DISPLAY, 156edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project UNFREEZE_DISPLAY, 15759119e658a12279e8fff508f8773843de2d90917Mathias Agopian CAPTURE_SCREEN, 1589daa5c9b9dd286cbbf5d43f7e45a5e9e4048e855Mathias Agopian TURN_ELECTRON_BEAM_OFF, 159134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis TURN_ELECTRON_BEAM_ON, 160134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis AUTHENTICATE_SURFACE, 161edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 162edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 163edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t onTransact( uint32_t code, 164edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const Parcel& data, 165edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Parcel* reply, 166edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t flags = 0); 167edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 168edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 169edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 170edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 171edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 172edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1739cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian#endif // ANDROID_SF_ISURFACE_COMPOSER_H 174