DisplayDevice.h revision eba8c688f633f3f3f1b75c2bc64faf799dd2b5f2
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 17d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian#ifndef ANDROID_DISPLAY_DEVICE_H 18d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian#define ANDROID_DISPLAY_DEVICE_H 19edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 20edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <stdlib.h> 21edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 22edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/PixelFormat.h> 23edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/Region.h> 24edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 25edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <EGL/egl.h> 26076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian#include <EGL/eglext.h> 27076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 288630320433bd15aca239522e54e711ef6372ab07Mathias Agopian#include <utils/Mutex.h> 298630320433bd15aca239522e54e711ef6372ab07Mathias Agopian#include <utils/Timers.h> 308630320433bd15aca239522e54e711ef6372ab07Mathias Agopian 31f435863467ab407f2a482604beed5fa6f0144c62Mathias Agopian#include <hardware/hwcomposer_defs.h> 32f435863467ab407f2a482604beed5fa6f0144c62Mathias Agopian 331b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian#include "Transform.h" 341f7bec634f19c123410a5155c8d282e177c01930Mathias Agopian 35d8552d796cbcb9a89711fc8f97b34838da5cbdb7Mathias Agopianstruct ANativeWindow; 36d8552d796cbcb9a89711fc8f97b34838da5cbdb7Mathias Agopian 37edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 38edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 39c666cae2d5995097ec49a87e375e2afdd92802b7Mathias Agopianclass DisplayInfo; 403e87601170141229d661df93e2f59e1ced73474bMathias Agopianclass FramebufferSurface; 418630320433bd15aca239522e54e711ef6372ab07Mathias Agopianclass LayerBase; 428630320433bd15aca239522e54e711ef6372ab07Mathias Agopianclass SurfaceFlinger; 43da27af9832a0170f1fc40ef3f21371c4d30d21b3Mathias Agopianclass HWComposer; 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 45028a7572c81f91e4039b694cde1f55fdb3e483c7Mathias Agopianclass DisplayDevice : public LightRefBase<DisplayDevice> 46edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 47edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 4887baae104a3e4c2059990b01c393476065c558b0Mathias Agopian // region in layer-stack space 4987baae104a3e4c2059990b01c393476065c558b0Mathias Agopian mutable Region dirtyRegion; 5087baae104a3e4c2059990b01c393476065c558b0Mathias Agopian // region in screen space 5187baae104a3e4c2059990b01c393476065c558b0Mathias Agopian mutable Region swapRegion; 5287baae104a3e4c2059990b01c393476065c558b0Mathias Agopian // region in screen space 5387baae104a3e4c2059990b01c393476065c558b0Mathias Agopian Region undefinedRegion; 543eb38cb33e41ce40dd1094bdec850f0fca9f8a53Mathias Agopian 553ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian enum DisplayType { 563ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian DISPLAY_ID_INVALID = -1, 573ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian DISPLAY_PRIMARY = HWC_DISPLAY_PRIMARY, 583ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian DISPLAY_EXTERNAL = HWC_DISPLAY_EXTERNAL, 593ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian NUM_DISPLAY_TYPES = HWC_NUM_DISPLAY_TYPES, 603ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian DISPLAY_VIRTUAL = HWC_NUM_DISPLAY_TYPES 6192a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian }; 6292a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 6392a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian enum { 6487baae104a3e4c2059990b01c393476065c558b0Mathias Agopian PARTIAL_UPDATES = 0x00020000, // video driver feature 6587baae104a3e4c2059990b01c393476065c558b0Mathias Agopian SWAP_RECTANGLE = 0x00080000, 66edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 67edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 680f2f5ff75b7b48ceb64270655ee6b62d09bf4d00Mathias Agopian DisplayDevice( 69edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const sp<SurfaceFlinger>& flinger, 703ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian DisplayType type, const wp<IBinder>& displayToken, 711a4d883dcc1725892bfb5c28dec255a233186524Jamie Gennis const sp<ANativeWindow>& nativeWindow, 721a4d883dcc1725892bfb5c28dec255a233186524Jamie Gennis const sp<FramebufferSurface>& framebufferSurface, 73a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian EGLConfig config); 74edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 75028a7572c81f91e4039b694cde1f55fdb3e483c7Mathias Agopian ~DisplayDevice(); 7692a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 7792a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian // whether this is a valid object. An invalid DisplayDevice is returned 7892a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian // when an non existing id is requested 7992a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian bool isValid() const; 8092a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 81edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Flip the front and back buffers if the back buffer is "dirty". Might 82edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // be instantaneous, might involve copying the frame buffer around. 83edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void flip(const Region& dirty) const; 84edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 85edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int getWidth() const; 86edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int getHeight() const; 87edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat getFormat() const; 88edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t getFlags() const; 893eb38cb33e41ce40dd1094bdec850f0fca9f8a53Mathias Agopian 90a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian EGLSurface getEGLSurface() const; 913b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian 923b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian void setVisibleLayersSortedByZ(const Vector< sp<LayerBase> >& layers); 933ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian const Vector< sp<LayerBase> >& getVisibleLayersSortedByZ() const; 943b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian bool getSecureLayerVisible() const; 95cd60f99aba9e750700a967db30b74a29145739cfMathias Agopian Region getDirtyRegion(bool repaintEverything) const; 963b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian 9728947d7fbf9f486539322e8e12dd057568e180c2Mathias Agopian void setLayerStack(uint32_t stack); 9800e8c7a88a5b9c4104a71013a713acd3e4d3b77bMathias Agopian void setProjection(int orientation, const Rect& viewport, const Rect& frame); 9928947d7fbf9f486539322e8e12dd057568e180c2Mathias Agopian 1001b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian int getOrientation() const { return mOrientation; } 1011b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian const Transform& getTransform() const { return mGlobalTransform; } 102da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian const Rect& getViewport() const { return mViewport; } 103da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian const Rect& getFrame() const { return mFrame; } 104eba8c688f633f3f3f1b75c2bc64faf799dd2b5f2Mathias Agopian bool needsFiltering() const { return mNeedsFiltering; } 105da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian 10687baae104a3e4c2059990b01c393476065c558b0Mathias Agopian uint32_t getLayerStack() const { return mLayerStack; } 1073ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian int32_t getDisplayType() const { return mType; } 108e60b0687c8d49871d0c8786cabe6851f7a7783b5Mathias Agopian int32_t getHwcDisplayId() const { return mHwcDisplayId; } 1093ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian const wp<IBinder>& getDisplayToken() const { return mDisplayToken; } 11087baae104a3e4c2059990b01c393476065c558b0Mathias Agopian 111da27af9832a0170f1fc40ef3f21371c4d30d21b3Mathias Agopian void swapBuffers(HWComposer& hwc) const; 11274faca212e2675aa55a30235c77cb6403471a4b9Mathias Agopian status_t compositionComplete() const; 11374faca212e2675aa55a30235c77cb6403471a4b9Mathias Agopian 114da27af9832a0170f1fc40ef3f21371c4d30d21b3Mathias Agopian // called after h/w composer has completed its set() call 115da27af9832a0170f1fc40ef3f21371c4d30d21b3Mathias Agopian void onSwapBuffersCompleted(HWComposer& hwc) const; 116da27af9832a0170f1fc40ef3f21371c4d30d21b3Mathias Agopian 1179c6e297271ec9af9d974242d89cfa08cb6ceaa0aMathias Agopian Rect getBounds() const { 1181b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian return Rect(mDisplayWidth, mDisplayHeight); 119edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project } 1209c6e297271ec9af9d974242d89cfa08cb6ceaa0aMathias Agopian inline Rect bounds() const { return getBounds(); } 121edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1228dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden void setDisplayName(const String8& displayName) { 1238dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden mDisplayName = displayName; 1248dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden } 1258dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden const String8& getDisplayName() const { return mDisplayName; } 1268dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden 127da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian static EGLBoolean makeCurrent(EGLDisplay dpy, 128da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian const sp<const DisplayDevice>& hw, EGLContext ctx); 12952bbb1ae239c8a4d05543a23fa8c08467d09c3b2Mathias Agopian 130d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian /* ------------------------------------------------------------------------ 1318dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden * blank / unblank management 132d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian */ 133d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian void releaseScreen() const; 134d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian void acquireScreen() const; 135d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian bool isScreenAcquired() const; 136d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian bool canDraw() const; 137d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 138d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian /* ------------------------------------------------------------------------ 139d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian * Debugging 140d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian */ 141d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian uint32_t getPageFlipCount() const; 1421d12d8a8e61163b35cf42c51c558a67138014e82Mathias Agopian void dump(String8& result, char* buffer, size_t SIZE) const; 143d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 144edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectprivate: 145a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian void init(EGLConfig config); 146a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian 147a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian /* 148a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian * Constants, set during initialization 149a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian */ 150c7d14e247117392fbd44aa454622778a25c076aeMathias Agopian sp<SurfaceFlinger> mFlinger; 1513ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian DisplayType mType; 152e60b0687c8d49871d0c8786cabe6851f7a7783b5Mathias Agopian int32_t mHwcDisplayId; 1533ee454a7bef8bd3d1c9cdd9d17108eb80ebadf2aMathias Agopian wp<IBinder> mDisplayToken; 154d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 155a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian // ANativeWindow this display is rendering into 156d8552d796cbcb9a89711fc8f97b34838da5cbdb7Mathias Agopian sp<ANativeWindow> mNativeWindow; 157d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 158a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian // set if mNativeWindow is a FramebufferSurface 159a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian sp<FramebufferSurface> mFramebufferSurface; 160a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian 161edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project EGLDisplay mDisplay; 162edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project EGLSurface mSurface; 163edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project EGLContext mContext; 1641b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian int mDisplayWidth; 1651b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian int mDisplayHeight; 166edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat mFormat; 167edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t mFlags; 168076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian mutable uint32_t mPageFlipCount; 1698dfa92fef9759a881e96ee58d59875d35023aab9Andy McFadden String8 mDisplayName; 17003e407270c7ad76632f982c886d0776bed9e9b4cMathias Agopian 171a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian /* 172a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian * Can only accessed from the main thread, these members 173a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian * don't need synchronization. 174a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian */ 175d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 1763b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian // list of visible layers on that display 1773b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian Vector< sp<LayerBase> > mVisibleLayersSortedByZ; 178d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 1793b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian // Whether we have a visible secure layer on this display 1803b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian bool mSecureLayerVisible; 1813b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian 182d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian // Whether the screen is blanked; 183d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian mutable int mScreenAcquired; 184d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 185a350ff98692b3a50cad5cc93f9f83221242ca86aMathias Agopian 186d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian /* 187d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian * Transaction state 188d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian */ 189da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian static status_t orientationToTransfrom(int orientation, 190da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian int w, int h, Transform* tr); 191da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian 192da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian void updateGeometryTransform(); 193da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian 19487baae104a3e4c2059990b01c393476065c558b0Mathias Agopian uint32_t mLayerStack; 195da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian int mOrientation; 196da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian Rect mViewport; 197da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian Rect mFrame; 198da8d0a5c0cf9d41915d3b106cad4aaec3e767c11Mathias Agopian Transform mGlobalTransform; 199eba8c688f633f3f3f1b75c2bc64faf799dd2b5f2Mathias Agopian bool mNeedsFiltering; 200edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 201edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 202edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 203edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 204d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian#endif // ANDROID_DISPLAY_DEVICE_H 205