DisplayDevice.h revision e60b0687c8d49871d0c8786cabe6851f7a7783b5
1/* 2 * Copyright (C) 2007 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17#ifndef ANDROID_DISPLAY_DEVICE_H 18#define ANDROID_DISPLAY_DEVICE_H 19 20#include <stdlib.h> 21 22#include <ui/PixelFormat.h> 23#include <ui/Region.h> 24 25#include <EGL/egl.h> 26#include <EGL/eglext.h> 27 28#include <utils/Mutex.h> 29#include <utils/Timers.h> 30 31#include "Transform.h" 32 33struct ANativeWindow; 34 35namespace android { 36 37class DisplayInfo; 38class FramebufferSurface; 39class LayerBase; 40class SurfaceFlinger; 41 42class DisplayDevice : public LightRefBase<DisplayDevice> 43{ 44public: 45 // region in layer-stack space 46 mutable Region dirtyRegion; 47 // region in screen space 48 mutable Region swapRegion; 49 // region in screen space 50 Region undefinedRegion; 51 52 enum { 53 DISPLAY_ID_MAIN = 0, 54 DISPLAY_ID_HDMI = 1, 55 DISPLAY_ID_COUNT 56 }; 57 58 enum { 59 PARTIAL_UPDATES = 0x00020000, // video driver feature 60 SWAP_RECTANGLE = 0x00080000, 61 }; 62 63 DisplayDevice( 64 const sp<SurfaceFlinger>& flinger, 65 int32_t dpy, int32_t hwcDisplayId, 66 const sp<ANativeWindow>& nativeWindow, 67 const sp<FramebufferSurface>& framebufferSurface, 68 EGLConfig config); 69 70 ~DisplayDevice(); 71 72 // whether this is a valid object. An invalid DisplayDevice is returned 73 // when an non existing id is requested 74 bool isValid() const; 75 76 // Flip the front and back buffers if the back buffer is "dirty". Might 77 // be instantaneous, might involve copying the frame buffer around. 78 void flip(const Region& dirty) const; 79 80 int getWidth() const; 81 int getHeight() const; 82 PixelFormat getFormat() const; 83 uint32_t getFlags() const; 84 85 EGLSurface getEGLSurface() const; 86 87 void setVisibleLayersSortedByZ(const Vector< sp<LayerBase> >& layers); 88 Vector< sp<LayerBase> > getVisibleLayersSortedByZ() const; 89 bool getSecureLayerVisible() const; 90 Region getDirtyRegion(bool repaintEverything) const; 91 92 status_t setOrientation(int orientation); 93 void setLayerStack(uint32_t stack); 94 95 int getOrientation() const { return mOrientation; } 96 const Transform& getTransform() const { return mGlobalTransform; } 97 uint32_t getLayerStack() const { return mLayerStack; } 98 int32_t getDisplayId() const { return mId; } 99 int32_t getHwcDisplayId() const { return mHwcDisplayId; } 100 101 status_t compositionComplete() const; 102 103 Rect getBounds() const { 104 return Rect(mDisplayWidth, mDisplayHeight); 105 } 106 inline Rect bounds() const { return getBounds(); } 107 108 static void makeCurrent(const sp<const DisplayDevice>& hw, EGLContext ctx); 109 110 /* ------------------------------------------------------------------------ 111 * blank / unplank management 112 */ 113 void releaseScreen() const; 114 void acquireScreen() const; 115 bool isScreenAcquired() const; 116 bool canDraw() const; 117 118 /* ------------------------------------------------------------------------ 119 * Debugging 120 */ 121 uint32_t getPageFlipCount() const; 122 void dump(String8& res) const; 123 124 inline bool operator < (const DisplayDevice& rhs) const { 125 return mId < rhs.mId; 126 } 127 128private: 129 void init(EGLConfig config); 130 131 /* 132 * Constants, set during initialization 133 */ 134 sp<SurfaceFlinger> mFlinger; 135 int32_t mId; 136 int32_t mHwcDisplayId; 137 138 // ANativeWindow this display is rendering into 139 sp<ANativeWindow> mNativeWindow; 140 141 // set if mNativeWindow is a FramebufferSurface 142 sp<FramebufferSurface> mFramebufferSurface; 143 144 EGLDisplay mDisplay; 145 EGLSurface mSurface; 146 EGLContext mContext; 147 int mDisplayWidth; 148 int mDisplayHeight; 149 PixelFormat mFormat; 150 uint32_t mFlags; 151 mutable uint32_t mPageFlipCount; 152 153 /* 154 * Can only accessed from the main thread, these members 155 * don't need synchronization. 156 */ 157 158 // list of visible layers on that display 159 Vector< sp<LayerBase> > mVisibleLayersSortedByZ; 160 161 // Whether we have a visible secure layer on this display 162 bool mSecureLayerVisible; 163 164 // Whether the screen is blanked; 165 mutable int mScreenAcquired; 166 167 168 /* 169 * Transaction state 170 */ 171 static status_t orientationToTransfrom(int orientation, int w, int h, 172 Transform* tr); 173 Transform mGlobalTransform; 174 int mOrientation; 175 uint32_t mLayerStack; 176}; 177 178}; // namespace android 179 180#endif // ANDROID_DISPLAY_DEVICE_H 181