DisplayDevice.h revision f5f714aa188884098aaecbe39d0bc61b40311c0d
1572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams/* 2572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * Copyright (C) 2007 The Android Open Source Project 3572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * 4572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * Licensed under the Apache License, Version 2.0 (the "License"); 5572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * you may not use this file except in compliance with the License. 6572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * You may obtain a copy of the License at 7572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * 8572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * http://www.apache.org/licenses/LICENSE-2.0 9572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * 10572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * Unless required by applicable law or agreed to in writing, software 11572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * distributed under the License is distributed on an "AS IS" BASIS, 12572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * See the License for the specific language governing permissions and 14572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams * limitations under the License. 15572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams */ 16572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 17572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#ifndef ANDROID_DISPLAY_DEVICE_H 18572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#define ANDROID_DISPLAY_DEVICE_H 19572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 20572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <stdlib.h> 21572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 22572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <ui/PixelFormat.h> 23572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <ui/Region.h> 24572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 25572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <EGL/egl.h> 26572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <EGL/eglext.h> 27572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 28572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <utils/Mutex.h> 29572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <utils/Timers.h> 30572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 31572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include <hardware/hwcomposer_defs.h> 32572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 33572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams#include "Transform.h" 34572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 35572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsstruct ANativeWindow; 36572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 37572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsnamespace android { 38572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 39572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsclass DisplayInfo; 40572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsclass FramebufferSurface; 41572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsclass LayerBase; 42572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsclass SurfaceFlinger; 43572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsclass HWComposer; 44572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 45572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samsclass DisplayDevice : public LightRefBase<DisplayDevice> 46572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams{ 47572a5031a5d8602db0bec0b253428a034bd4dd59Jason Samspublic: 48572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams // region in layer-stack space 49572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams mutable Region dirtyRegion; 50572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams // region in screen space 51572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams mutable Region swapRegion; 52572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams // region in screen space 53572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams Region undefinedRegion; 54572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams 55572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams enum DisplayType { 56572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams DISPLAY_ID_INVALID = -1, 57572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams DISPLAY_PRIMARY = HWC_DISPLAY_PRIMARY, 58572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams DISPLAY_EXTERNAL = HWC_DISPLAY_EXTERNAL, 59572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams NUM_DISPLAY_TYPES = HWC_NUM_DISPLAY_TYPES, 60572a5031a5d8602db0bec0b253428a034bd4dd59Jason Sams DISPLAY_VIRTUAL = HWC_NUM_DISPLAY_TYPES 61 }; 62 63 enum { 64 PARTIAL_UPDATES = 0x00020000, // video driver feature 65 SWAP_RECTANGLE = 0x00080000, 66 }; 67 68 DisplayDevice( 69 const sp<SurfaceFlinger>& flinger, 70 DisplayType type, 71 bool isSecure, 72 const wp<IBinder>& displayToken, 73 const sp<ANativeWindow>& nativeWindow, 74 const sp<FramebufferSurface>& framebufferSurface, 75 EGLConfig config); 76 77 ~DisplayDevice(); 78 79 // whether this is a valid object. An invalid DisplayDevice is returned 80 // when an non existing id is requested 81 bool isValid() const; 82 83 // isSecure indicates whether this display can be trusted to display 84 // secure surfaces. 85 bool isSecure() const { return mIsSecure; } 86 87 // Flip the front and back buffers if the back buffer is "dirty". Might 88 // be instantaneous, might involve copying the frame buffer around. 89 void flip(const Region& dirty) const; 90 91 int getWidth() const; 92 int getHeight() const; 93 PixelFormat getFormat() const; 94 uint32_t getFlags() const; 95 96 EGLSurface getEGLSurface() const; 97 98 void setVisibleLayersSortedByZ(const Vector< sp<LayerBase> >& layers); 99 const Vector< sp<LayerBase> >& getVisibleLayersSortedByZ() const; 100 bool getSecureLayerVisible() const; 101 Region getDirtyRegion(bool repaintEverything) const; 102 103 void setLayerStack(uint32_t stack); 104 void setProjection(int orientation, const Rect& viewport, const Rect& frame); 105 106 int getOrientation() const { return mOrientation; } 107 const Transform& getTransform() const { return mGlobalTransform; } 108 const Rect getViewport() const { return mViewport; } 109 const Rect getFrame() const { return mFrame; } 110 const Rect& getScissor() const { return mScissor; } 111 bool needsFiltering() const { return mNeedsFiltering; } 112 113 uint32_t getLayerStack() const { return mLayerStack; } 114 int32_t getDisplayType() const { return mType; } 115 int32_t getHwcDisplayId() const { return mHwcDisplayId; } 116 const wp<IBinder>& getDisplayToken() const { return mDisplayToken; } 117 118 void swapBuffers(HWComposer& hwc) const; 119 status_t compositionComplete() const; 120 121 // called after h/w composer has completed its set() call 122 void onSwapBuffersCompleted(HWComposer& hwc) const; 123 124 Rect getBounds() const { 125 return Rect(mDisplayWidth, mDisplayHeight); 126 } 127 inline Rect bounds() const { return getBounds(); } 128 129 void setDisplayName(const String8& displayName); 130 const String8& getDisplayName() const { return mDisplayName; } 131 132 static EGLBoolean makeCurrent(EGLDisplay dpy, 133 const sp<const DisplayDevice>& hw, EGLContext ctx); 134 135 static void setViewportAndProjection(const sp<const DisplayDevice>& hw); 136 137 /* ------------------------------------------------------------------------ 138 * blank / unblank management 139 */ 140 void releaseScreen() const; 141 void acquireScreen() const; 142 bool isScreenAcquired() const; 143 bool canDraw() const; 144 145 /* ------------------------------------------------------------------------ 146 * Debugging 147 */ 148 uint32_t getPageFlipCount() const; 149 void dump(String8& result, char* buffer, size_t SIZE) const; 150 151private: 152 void init(EGLConfig config); 153 154 /* 155 * Constants, set during initialization 156 */ 157 sp<SurfaceFlinger> mFlinger; 158 DisplayType mType; 159 int32_t mHwcDisplayId; 160 wp<IBinder> mDisplayToken; 161 162 // ANativeWindow this display is rendering into 163 sp<ANativeWindow> mNativeWindow; 164 165 // set if mNativeWindow is a FramebufferSurface 166 sp<FramebufferSurface> mFramebufferSurface; 167 168 EGLDisplay mDisplay; 169 EGLSurface mSurface; 170 EGLContext mContext; 171 int mDisplayWidth; 172 int mDisplayHeight; 173 PixelFormat mFormat; 174 uint32_t mFlags; 175 mutable uint32_t mPageFlipCount; 176 String8 mDisplayName; 177 bool mIsSecure; 178 179 /* 180 * Can only accessed from the main thread, these members 181 * don't need synchronization. 182 */ 183 184 // list of visible layers on that display 185 Vector< sp<LayerBase> > mVisibleLayersSortedByZ; 186 187 // Whether we have a visible secure layer on this display 188 bool mSecureLayerVisible; 189 190 // Whether the screen is blanked; 191 mutable int mScreenAcquired; 192 193 194 /* 195 * Transaction state 196 */ 197 static status_t orientationToTransfrom(int orientation, 198 int w, int h, Transform* tr); 199 200 uint32_t mLayerStack; 201 int mOrientation; 202 // user-provided visible area of the layer stack 203 Rect mViewport; 204 // user-provided rectangle where mViewport gets mapped to 205 Rect mFrame; 206 // pre-computed scissor to apply to the display 207 Rect mScissor; 208 Transform mGlobalTransform; 209 bool mNeedsFiltering; 210}; 211 212}; // namespace android 213 214#endif // ANDROID_DISPLAY_DEVICE_H 215