Surface.h revision 076b1cc3a9b90aa5b381a1ed268ca0b548444c9b
1edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project/* 2edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Copyright (C) 2007 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 17edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#ifndef ANDROID_UI_SURFACE_H 18edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#define ANDROID_UI_SURFACE_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/threads.h> 25edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 26edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/ISurface.h> 27edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/PixelFormat.h> 28edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/Region.h> 29edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/ISurfaceFlingerClient.h> 30edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 31076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian#include <EGL/android_natives.h> 32076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 33edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 34edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 35edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 36edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 37edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass Rect; 38edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass SurfaceComposerClient; 39076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianstruct per_client_cblk_t; 40076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianstruct layer_cblk_t; 41076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 42076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian// --------------------------------------------------------------------------- 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 44076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianclass SurfaceBuffer 45076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian : public EGLNativeBase< 46076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian android_native_buffer_t, 47076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian SurfaceBuffer, 48076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian LightRefBase<SurfaceBuffer> > 49edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 50076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianpublic: 51076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian buffer_handle_t getHandle() const { 52076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian return handle; 53076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian } 54076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 55076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianprotected: 56076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian SurfaceBuffer(); 57076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian SurfaceBuffer(const Parcel& reply); 58076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian virtual ~SurfaceBuffer(); 59076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian buffer_handle_t handle; 60076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian bool mOwner; 61076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 62076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianprivate: 63076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian friend class BpSurface; 64076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian friend class BnSurface; 65076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian friend class LightRefBase<SurfaceBuffer>; 66076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 67076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian SurfaceBuffer& operator = (const SurfaceBuffer& rhs); 68076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian const SurfaceBuffer& operator = (const SurfaceBuffer& rhs) const; 69076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 70076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static status_t writeToParcel(Parcel* reply, 71076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian android_native_buffer_t const* buffer); 72076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 73076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static int getHandle(android_native_buffer_t const * base, 74076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian buffer_handle_t* handle); 75076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian}; 76edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 77076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian// --------------------------------------------------------------------------- 78076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 79076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopianclass Surface 80076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian : public EGLNativeBase<android_native_window_t, Surface, RefBase> 81076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian{ 82edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 83edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project struct SurfaceInfo { 84edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t w; 85edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t h; 86076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint32_t s; 87076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian uint32_t usage; 88edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat format; 89edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void* bits; 90edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t reserved[2]; 91edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 92edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 93edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project bool isValid() const { return this && mToken>=0 && mClient!=0; } 94edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project SurfaceID ID() const { return mToken; } 95edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 96edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t lock(SurfaceInfo* info, bool blocking = true); 97edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t lock(SurfaceInfo* info, Region* dirty, bool blocking = true); 98edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t unlockAndPost(); 99076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 100edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t getFlags() const { return mFlags; } 101edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 102edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // setSwapRectangle() is mainly used by EGL 103edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void setSwapRectangle(const Rect& r); 104edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const Rect& swapRectangle() const; 105edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 106edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project sp<Surface> dup() const; 107edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project static sp<Surface> readFromParcel(Parcel* parcel); 108edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project static status_t writeToParcel(const sp<Surface>& surface, Parcel* parcel); 109edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project static bool isSameSurface(const sp<Surface>& lhs, const sp<Surface>& rhs); 110edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 111edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setLayer(int32_t layer); 112edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setPosition(int32_t x, int32_t y); 113edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setSize(uint32_t w, uint32_t h); 114edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t hide(); 115edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t show(int32_t layer = -1); 116edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t freeze(); 117edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t unfreeze(); 118edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setFlags(uint32_t flags, uint32_t mask); 119edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setTransparentRegionHint(const Region& transparent); 120edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setAlpha(float alpha=1.0f); 121edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setMatrix(float dsdx, float dtdx, float dsdy, float dtdy); 122edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project status_t setFreezeTint(uint32_t tint); 123edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 124edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t getIdentity() const { return mIdentity; } 125edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectprivate: 126edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project friend class SurfaceComposerClient; 127edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 128edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // camera and camcorder need access to the ISurface binder interface for preview 129edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project friend class Camera; 130edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project friend class MediaRecorder; 131edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // mediaplayer needs access to ISurface for display 132edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project friend class MediaPlayer; 133edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project friend class Test; 134edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const sp<ISurface>& getISurface() const { return mSurface; } 135edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 136076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian status_t getBufferLocked(int index); 137076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 138edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // can't be copied 139edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Surface& operator = (Surface& rhs); 140edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Surface(const Surface& rhs); 141edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 142edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Surface(const sp<SurfaceComposerClient>& client, 143edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const sp<ISurface>& surface, 144edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const ISurfaceFlingerClient::surface_data_t& data, 145edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t w, uint32_t h, PixelFormat format, uint32_t flags, 146edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project bool owner = true); 147edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 148edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Surface(Surface const* rhs); 149edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 150edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project ~Surface(); 151076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 152edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project Region dirtyRegion() const; 153edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void setDirtyRegion(const Region& region) const; 154edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 155076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 156076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian status_t validate(per_client_cblk_t const* cblk) const; 157076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static void _send_dirty_region(layer_cblk_t* lcblk, const Region& dirty); 158076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 159076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 160076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static void connect(android_native_window_t* window); 161076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static void disconnect(android_native_window_t* window); 162076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static int setSwapInterval(android_native_window_t* window, int interval); 163076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static int setSwapRectangle(android_native_window_t* window, 164076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian int l, int t, int w, int h); 165076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static int dequeueBuffer(android_native_window_t* window, android_native_buffer_t** buffer); 166076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static int lockBuffer(android_native_window_t* window, android_native_buffer_t* buffer); 167076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian static int queueBuffer(android_native_window_t* window, android_native_buffer_t* buffer); 168076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 169076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian int dequeueBuffer(android_native_buffer_t** buffer); 170076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian int lockBuffer(android_native_buffer_t* buffer); 171076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian int queueBuffer(android_native_buffer_t* buffer); 172076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 173076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 174076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian alloc_device_t* mAllocDevice; 175edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project sp<SurfaceComposerClient> mClient; 176edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project sp<ISurface> mSurface; 177076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian sp<SurfaceBuffer> mBuffers[2]; 178076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian android_native_buffer_t* mLockedBuffer; 179edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project SurfaceID mToken; 180edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t mIdentity; 181edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat mFormat; 182edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t mFlags; 183edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const bool mOwner; 184edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable Region mDirtyRegion; 185edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable Rect mSwapRectangle; 186edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable uint8_t mBackbufferIndex; 187edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project mutable Mutex mSurfaceLock; 188edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 189edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 190edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 191edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 192edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#endif // ANDROID_UI_SURFACE_H 193edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 194