DisplayDevice.h revision 92a979a92c34b7de609ce2b1662c73bb8a2728b9
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 311b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian#include "Transform.h" 321f7bec634f19c123410a5155c8d282e177c01930Mathias Agopian 33edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 34edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 35c666cae2d5995097ec49a87e375e2afdd92802b7Mathias Agopianclass DisplayInfo; 363e87601170141229d661df93e2f59e1ced73474bMathias Agopianclass FramebufferSurface; 378630320433bd15aca239522e54e711ef6372ab07Mathias Agopianclass LayerBase; 388630320433bd15aca239522e54e711ef6372ab07Mathias Agopianclass SurfaceFlinger; 39a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopianclass SurfaceTextureClient; 40edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 41d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopianclass DisplayDevice 42edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project{ 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectpublic: 4487baae104a3e4c2059990b01c393476065c558b0Mathias Agopian // region in layer-stack space 4587baae104a3e4c2059990b01c393476065c558b0Mathias Agopian mutable Region dirtyRegion; 4687baae104a3e4c2059990b01c393476065c558b0Mathias Agopian // region in screen space 4787baae104a3e4c2059990b01c393476065c558b0Mathias Agopian mutable Region swapRegion; 4887baae104a3e4c2059990b01c393476065c558b0Mathias Agopian // region in screen space 4987baae104a3e4c2059990b01c393476065c558b0Mathias Agopian Region undefinedRegion; 503eb38cb33e41ce40dd1094bdec850f0fca9f8a53Mathias Agopian 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project enum { 5292a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian DISPLAY_ID_MAIN = 0, 5392a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian DISPLAY_ID_HDMI = 1 5492a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian }; 5592a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 5692a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian enum { 5787baae104a3e4c2059990b01c393476065c558b0Mathias Agopian PARTIAL_UPDATES = 0x00020000, // video driver feature 5887baae104a3e4c2059990b01c393476065c558b0Mathias Agopian SWAP_RECTANGLE = 0x00080000, 59edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project }; 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 6192a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian DisplayDevice(); 6292a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 630f2f5ff75b7b48ceb64270655ee6b62d09bf4d00Mathias Agopian DisplayDevice( 64edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project const sp<SurfaceFlinger>& flinger, 65a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian int dpy, 66a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian const sp<SurfaceTextureClient>& surface, 67a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian EGLConfig config); 68edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 69d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian ~DisplayDevice(); 70edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 7192a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian // must be called when this object is no longer needed. this will 7292a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian // render the associated EGLSurface invalid. 7392a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian void terminate(); 7492a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 7592a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian // whether this is a valid object. An invalid DisplayDevice is returned 7692a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian // when an non existing id is requested 7792a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian bool isValid() const; 7892a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian 79edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // Flip the front and back buffers if the back buffer is "dirty". Might 80edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project // be instantaneous, might involve copying the frame buffer around. 81edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project void flip(const Region& dirty) const; 82edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 83edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float getDpiX() const; 84edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float getDpiY() const; 85edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float getRefreshRate() const; 86edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float getDensity() const; 87edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int getWidth() const; 88edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project int getHeight() const; 89edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat getFormat() const; 90edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t getFlags() const; 9182d7ab6c7e0cf971e515134ccf072682dd1a2cdbMathias Agopian nsecs_t getRefreshPeriod() const; 92c666cae2d5995097ec49a87e375e2afdd92802b7Mathias Agopian status_t getInfo(DisplayInfo* info) const; 933eb38cb33e41ce40dd1094bdec850f0fca9f8a53Mathias Agopian 94a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian EGLSurface getEGLSurface() const; 953b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian 963b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian void setVisibleLayersSortedByZ(const Vector< sp<LayerBase> >& layers); 973b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian Vector< sp<LayerBase> > getVisibleLayersSortedByZ() const; 983b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian bool getSecureLayerVisible() const; 993b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian 1001b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian status_t setOrientation(int orientation); 1011b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian int getOrientation() const { return mOrientation; } 1021b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian const Transform& getTransform() const { return mGlobalTransform; } 10387baae104a3e4c2059990b01c393476065c558b0Mathias Agopian uint32_t getLayerStack() const { return mLayerStack; } 10487baae104a3e4c2059990b01c393476065c558b0Mathias Agopian 10574faca212e2675aa55a30235c77cb6403471a4b9Mathias Agopian status_t compositionComplete() const; 10674faca212e2675aa55a30235c77cb6403471a4b9Mathias Agopian 1079c6e297271ec9af9d974242d89cfa08cb6ceaa0aMathias Agopian Rect getBounds() const { 1081b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian return Rect(mDisplayWidth, mDisplayHeight); 109edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project } 1109c6e297271ec9af9d974242d89cfa08cb6ceaa0aMathias Agopian inline Rect bounds() const { return getBounds(); } 111edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 1120f2f5ff75b7b48ceb64270655ee6b62d09bf4d00Mathias Agopian static void makeCurrent(const DisplayDevice& hw, EGLContext ctx); 11352bbb1ae239c8a4d05543a23fa8c08467d09c3b2Mathias Agopian 114d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian /* ------------------------------------------------------------------------ 115d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian * blank / unplank management 116d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian */ 117d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian void releaseScreen() const; 118d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian void acquireScreen() const; 119d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian bool isScreenAcquired() const; 120d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian bool canDraw() const; 121d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 122d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian /* ------------------------------------------------------------------------ 123d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian * Debugging 124d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian */ 125d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian uint32_t getPageFlipCount() const; 126d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian void dump(String8& res) const; 127d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 12892a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian inline bool operator < (const DisplayDevice& rhs) const { 12992a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian return mId < rhs.mId; 13092a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian } 131d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 132edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectprivate: 133a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian void init(EGLConfig config); 134a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian 135a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian /* 136a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian * Constants, set during initialization 137a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian */ 138c7d14e247117392fbd44aa454622778a25c076aeMathias Agopian sp<SurfaceFlinger> mFlinger; 13992a979a92c34b7de609ce2b1662c73bb8a2728b9Mathias Agopian int32_t mId; 140d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 141a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian // ANativeWindow this display is rendering into 142a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian sp<SurfaceTextureClient> mNativeWindow; 143d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 144a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian // set if mNativeWindow is a FramebufferSurface 145a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian sp<FramebufferSurface> mFramebufferSurface; 146a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian 147edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project EGLDisplay mDisplay; 148edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project EGLSurface mSurface; 149edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project EGLContext mContext; 150edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float mDpiX; 151edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float mDpiY; 152edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float mRefreshRate; 153edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project float mDensity; 1541b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian int mDisplayWidth; 1551b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian int mDisplayHeight; 156edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project PixelFormat mFormat; 157edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project uint32_t mFlags; 158076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian mutable uint32_t mPageFlipCount; 159d0566bc26fcf6ca396118701fa11900b627f2c09Mathias Agopian nsecs_t mRefreshPeriod; 16003e407270c7ad76632f982c886d0776bed9e9b4cMathias Agopian 161a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian /* 162a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian * Can only accessed from the main thread, these members 163a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian * don't need synchronization. 164a49126087b4494f4ef50873f3a3f6727265f6621Mathias Agopian */ 165d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 1663b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian // list of visible layers on that display 1673b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian Vector< sp<LayerBase> > mVisibleLayersSortedByZ; 168d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 1693b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian // Whether we have a visible secure layer on this display 1703b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian bool mSecureLayerVisible; 1713b1d2b6b2bbfb5df46b1059ec52360974e6f1428Mathias Agopian 172d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian // Whether the screen is blanked; 173d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian mutable int mScreenAcquired; 174d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian 175a350ff98692b3a50cad5cc93f9f83221242ca86aMathias Agopian 176d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian /* 177d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian * Transaction state 178d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian */ 1791b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian static status_t orientationToTransfrom(int orientation, int w, int h, 1801b03149f3533db04e72e088d3fdd09d0087ca594Mathias Agopian Transform* tr); 18198a121aa916eb7acbf11df0e3e31a6fede6fc9ddMathias Agopian Transform mGlobalTransform; 18298a121aa916eb7acbf11df0e3e31a6fede6fc9ddMathias Agopian int mOrientation; 18387baae104a3e4c2059990b01c393476065c558b0Mathias Agopian uint32_t mLayerStack; 184edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 185edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 186edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 187edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 188d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian#endif // ANDROID_DISPLAY_DEVICE_H 189