ISurfaceComposer.h revision d0566bc26fcf6ca396118701fa11900b627f2c09
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 36439cf8576d3b846c0aa0944d84372259bf075d51Mathias Agopianclass ComposerState; 37d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopianclass IDisplayEventConnection; 38d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopianclass IMemoryHeap; 39a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian 40edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass ISurfaceComposer : public IInterface 41edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 42edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project DECLARE_META_INTERFACE(SurfaceComposer); 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 45edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { // (keep in sync with Surface.java) 46edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eHidden = 0x00000004, 47edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eDestroyBackbuffer = 0x00000020, 48edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eSecure = 0x00000080, 49edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eNonPremultiplied = 0x00000100, 503b996c96e4cd1057cb6b9531eaf8c01f934d2b2aRomain Guy eOpaque = 0x00000400, 5116f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten eProtectedByApp = 0x00000800, 5216f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten eProtectedByDRM = 0x00001000, 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceNormal = 0x00000000, 55edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceBlur = 0x00010000, 56edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceDim = 0x00020000, 57118d0245ee0a3b107055782aa8b555404b6f0280Mathias Agopian eFXSurfaceScreenshot= 0x00030000, 58edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFXSurfaceMask = 0x000F0000, 59edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 61edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 62edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project ePositionChanged = 0x00000001, 63edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerChanged = 0x00000002, 64edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eSizeChanged = 0x00000004, 65edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eAlphaChanged = 0x00000008, 66edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eMatrixChanged = 0x00000010, 67edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eTransparentRegionChanged = 0x00000020, 68edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eVisibilityChanged = 0x00000040, 69edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eFreezeTintChanged = 0x00000080, 70edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 71edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 72edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 73edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerHidden = 0x01, 74edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerFrozen = 0x02, 75edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerDither = 0x04, 76edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerFilter = 0x08, 77edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eLayerBlurFreeze = 0x10 78edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 79edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 80edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 81edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientationDefault = 0, 82edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation90 = 1, 83edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation180 = 2, 84edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientation270 = 3, 85b8d69a55f1c187a35ac41e69de63251f5501b6f4Jamie Gennis eOrientationUnchanged = 4, 86edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project eOrientationSwapMask = 0x01 87edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 8828378392fd5aa3e0a392c9eb64634055678c3987Jamie Gennis 8928378392fd5aa3e0a392c9eb64634055678c3987Jamie Gennis enum { 9028378392fd5aa3e0a392c9eb64634055678c3987Jamie Gennis eSynchronous = 0x01, 9128378392fd5aa3e0a392c9eb64634055678c3987Jamie Gennis }; 9228378392fd5aa3e0a392c9eb64634055678c3987Jamie Gennis 93abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian enum { 94abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian eElectronBeamAnimationOn = 0x01, 95abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian eElectronBeamAnimationOff = 0x10 96abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian }; 97abd671a08a41519a7ab3d438a500efe0ef0bfc1dMathias Agopian 98edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* create connection with surface flinger, requires 99edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * ACCESS_SURFACE_FLINGER permission 100edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 1017e27f05739c8a2655cf0f7faea35614ce0a50278Mathias Agopian virtual sp<ISurfaceComposerClient> createConnection() = 0; 102edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1039a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis /* create a graphic buffer allocator 1049a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis */ 1059a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis virtual sp<IGraphicBufferAlloc> createGraphicBufferAlloc() = 0; 1069a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis 107edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* retrieve the control block */ 1087303c6bf1a8b00a0e7d8165d774a1f259b4ccda9Mathias Agopian virtual sp<IMemoryHeap> getCblk() const = 0; 109edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1109cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian /* open/close transactions. requires ACCESS_SURFACE_FLINGER permission */ 111b8d69a55f1c187a35ac41e69de63251f5501b6f4Jamie Gennis virtual void setTransactionState(const Vector<ComposerState>& state, 11228378392fd5aa3e0a392c9eb64634055678c3987Jamie Gennis int orientation, uint32_t flags) = 0; 113edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 114edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project /* signal that we're done booting. 1159cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian * Requires ACCESS_SURFACE_FLINGER permission 116edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 117edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual void bootFinished() = 0; 118edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1191b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian /* Capture the specified screen. requires READ_FRAME_BUFFER permission 1201b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian * This function will fail if there is a secure window on screen. 1211b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian */ 1221b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian virtual status_t captureScreen(DisplayID dpy, 1231b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian sp<IMemoryHeap>* heap, 12474c40c0a273dbfd7d10617c4cc1b0c066bfc812eMathias Agopian uint32_t* width, uint32_t* height, PixelFormat* format, 125bf2c6a6c8f1df40ac94e28b948754bb9739daacaMathias Agopian uint32_t reqWidth, uint32_t reqHeight, 126bf2c6a6c8f1df40ac94e28b948754bb9739daacaMathias Agopian uint32_t minLayerZ, uint32_t maxLayerZ) = 0; 1271b0b30d04304392748a8a4ab5a69e52a19f51b3aMathias Agopian 128d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian /* triggers screen off animation */ 12959119e658a12279e8fff508f8773843de2d90917Mathias Agopian virtual status_t turnElectronBeamOff(int32_t mode) = 0; 130d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian 131d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian /* triggers screen on animation */ 1329daa5c9b9dd286cbbf5d43f7e45a5e9e4048e855Mathias Agopian virtual status_t turnElectronBeamOn(int32_t mode) = 0; 13359119e658a12279e8fff508f8773843de2d90917Mathias Agopian 134582270d69db94286a248bd829f1ae6f910d45124Jamie Gennis /* verify that an ISurfaceTexture was created by SurfaceFlinger. 135134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis */ 136582270d69db94286a248bd829f1ae6f910d45124Jamie Gennis virtual bool authenticateSurfaceTexture( 137582270d69db94286a248bd829f1ae6f910d45124Jamie Gennis const sp<ISurfaceTexture>& surface) const = 0; 138d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian 139d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian /* return an IDisplayEventConnection */ 140d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian virtual sp<IDisplayEventConnection> createDisplayEventConnection() = 0; 141edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 142edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 143edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 144edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 145edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass BnSurfaceComposer : public BnInterface<ISurfaceComposer> 146edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 147edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 148edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 149edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Note: BOOT_FINISHED must remain this value, it is called from 150edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Java by ActivityManagerService. 151edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project BOOT_FINISHED = IBinder::FIRST_CALL_TRANSACTION, 152edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project CREATE_CONNECTION, 1539a78c90cd46b2a3bd637b056873149d3b94384b4Jamie Gennis CREATE_GRAPHIC_BUFFER_ALLOC, 154edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project GET_CBLK, 155698c0873cf2e07bdc7fd1e72169aee2a19fa40d7Mathias Agopian SET_TRANSACTION_STATE, 156edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project SET_ORIENTATION, 15759119e658a12279e8fff508f8773843de2d90917Mathias Agopian CAPTURE_SCREEN, 1589daa5c9b9dd286cbbf5d43f7e45a5e9e4048e855Mathias Agopian TURN_ELECTRON_BEAM_OFF, 159134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis TURN_ELECTRON_BEAM_ON, 160134f0422866e8985188ed10dfbdcb8e6c34b87f7Jamie Gennis AUTHENTICATE_SURFACE, 161d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian CREATE_DISPLAY_EVENT_CONNECTION, 162edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 163edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 164edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project virtual status_t onTransact( uint32_t code, 165edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const Parcel& data, 166edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Parcel* reply, 167edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t flags = 0); 168edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 169edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 170edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// ---------------------------------------------------------------------------- 171edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 172edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 173edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1749cce325fae8adcf7560a28eef394489f09bad74dMathias Agopian#endif // ANDROID_SF_ISURFACE_COMPOSER_H 175