egl_display.h revision b29e5e8c2682ae145e8c56d9afb061f8da7f854c
1518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian/* 2518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** Copyright 2007, The Android Open Source Project 3518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** 4518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** Licensed under the Apache License, Version 2.0 (the "License"); 5518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** you may not use this file except in compliance with the License. 6518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** You may obtain a copy of the License at 7518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** 8518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** http://www.apache.org/licenses/LICENSE-2.0 9518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** 10518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** Unless required by applicable law or agreed to in writing, software 11518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** distributed under the License is distributed on an "AS IS" BASIS, 12518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** See the License for the specific language governing permissions and 14518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** limitations under the License. 15518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian */ 16518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 17518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#ifndef ANDROID_EGL_DISPLAY_H 18518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#define ANDROID_EGL_DISPLAY_H 19518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 20518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 21518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <ctype.h> 22518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <stdint.h> 23518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <stdlib.h> 24518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 25518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <EGL/egl.h> 26518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <EGL/eglext.h> 27518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <GLES/gl.h> 28518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <GLES/glext.h> 29518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 30b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall#include <cutils/compiler.h> 31518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <utils/SortedVector.h> 32518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <utils/threads.h> 334b9511c16195a646242eff833b0af212933b6ecaMathias Agopian#include <utils/String8.h> 34518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 351cadb25da1ed875bdd078270e642966724a0c39aMathias Agopian#include "egldefs.h" 36518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include "hooks.h" 37518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 38518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 39518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopiannamespace android { 40518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 41518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 42518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianclass egl_object_t; 43fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopianclass egl_context_t; 44518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianclass egl_connection_t; 45518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 46518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 47518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 4898c6383580f94bb7ff9cc9a7cc24d8b8519e484aJamie Gennisclass EGLAPI egl_display_t { // marked as EGLAPI for testing purposes 49518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian static egl_display_t sDisplay[NUM_DISPLAYS]; 50518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLDisplay getDisplay(EGLNativeDisplayType display); 51a4b2c041828d1074dca3b999407e7dd85568c5aaMathias Agopian void loseCurrentImpl(egl_context_t * cur_c); 52518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 53518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianpublic: 54518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian enum { 55518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian NOT_INITIALIZED = 0, 56518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian INITIALIZED = 1, 57518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian TERMINATED = 2 58518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian }; 59518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 60518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian egl_display_t(); 61518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ~egl_display_t(); 62518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 63518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLBoolean initialize(EGLint *major, EGLint *minor); 64518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLBoolean terminate(); 65518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 66518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian // add object to this display's list 67518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian void addObject(egl_object_t* object); 685b287a6ea8dfac7ab3e03ae1e98f9e2214cbae09Mathias Agopian // remove object from this display's list 695b287a6ea8dfac7ab3e03ae1e98f9e2214cbae09Mathias Agopian void removeObject(egl_object_t* object); 70518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian // add reference to this object. returns true if this is a valid object. 71f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian bool getObject(egl_object_t* object) const; 72518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 73518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian static egl_display_t* get(EGLDisplay dpy); 74518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian static EGLDisplay getFromNativeDisplay(EGLNativeDisplayType disp); 75518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 76fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian EGLBoolean makeCurrent(egl_context_t* c, egl_context_t* cur_c, 77fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian EGLSurface draw, EGLSurface read, EGLContext ctx, 78fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian EGLSurface impl_draw, EGLSurface impl_read, EGLContext impl_ctx); 79fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian static void loseCurrent(egl_context_t * cur_c); 80fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian 81518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian inline bool isReady() const { return (refs > 0); } 82518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian inline bool isValid() const { return magic == '_dpy'; } 83518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian inline bool isAlive() const { return isValid(); } 84518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 854b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getVendorString() const { return mVendorString.string(); } 864b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getVersionString() const { return mVersionString.string(); } 874b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getClientApiString() const { return mClientApiString.string(); } 884b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getExtensionString() const { return mExtensionString.string(); } 894b9511c16195a646242eff833b0af212933b6ecaMathias Agopian 904725e2ca8050250813afcdcac1330244c6e0f5aeRomain Guy inline uint32_t getRefsCount() const { return refs; } 914725e2ca8050250813afcdcac1330244c6e0f5aeRomain Guy 92518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian struct strings_t { 93518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian char const * vendor; 94518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian char const * version; 95518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian char const * clientApi; 96518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian char const * extensions; 97518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian }; 98518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 99518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian struct DisplayImpl { 1007773c435bc5da8217433e1b242d3a6712a17b5f7Mathias Agopian DisplayImpl() : dpy(EGL_NO_DISPLAY), state(NOT_INITIALIZED) { } 101518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLDisplay dpy; 102518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLint state; 103518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian strings_t queryString; 104518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian }; 105518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 106518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianprivate: 107518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian uint32_t magic; 108518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 109518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianpublic: 110ada798b7ca7cabc255aa159964b64975e7fdb2dfMathias Agopian DisplayImpl disp; 11128ef8d7911dbfd1bf8256fb43acba894d87fc07aJamie Gennis bool finishOnSwap; // property: debug.egl.finish 11228ef8d7911dbfd1bf8256fb43acba894d87fc07aJamie Gennis bool traceGpuCompletion; // property: debug.egl.traceGpuCompletion 113518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 114518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianprivate: 115b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall friend class egl_display_ptr; 116b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall bool enter(); 117b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall void leave(); 118b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 119f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian uint32_t refs; 120f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian mutable Mutex lock; 121f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian SortedVector<egl_object_t*> objects; 1224b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mVendorString; 1234b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mVersionString; 1244b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mClientApiString; 1254b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mExtensionString; 126b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall int32_t mWakeCount; 127518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian}; 128518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 129518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 130518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 131b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallclass egl_display_ptr { 132b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallpublic: 133b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall explicit egl_display_ptr(egl_display_t* dpy): mDpy(dpy) { 134b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall if (mDpy) { 135b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall if (CC_UNLIKELY(!mDpy->enter())) { 136b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall mDpy = NULL; 137b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 138b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 139b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 140b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 141b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // We only really need a C++11 move constructor, not a copy constructor. 142b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // A move constructor would save an enter()/leave() pair on every EGL API 143b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // call. But enabling -std=c++0x causes lots of errors elsewhere, so I 144b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // can't use a move constructor yet. 145b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // 146b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // egl_display_ptr(egl_display_ptr&& other) { 147b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // mDpy = other.mDpy; 148b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // other.mDpy = NULL; 149b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // } 150b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_ptr(const egl_display_ptr& other): mDpy(other.mDpy) { 151b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall if (mDpy) { 152b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall mDpy->enter(); 153b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 154b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 155b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 156b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall ~egl_display_ptr() { 157b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall if (mDpy) { 158b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall mDpy->leave(); 159b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 160b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall } 161b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 162b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall const egl_display_t* operator->() const { return mDpy; } 163b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_t* operator->() { return mDpy; } 164b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 165b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall const egl_display_t* get() const { return mDpy; } 166b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_t* get() { return mDpy; } 167b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 168b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall operator bool() const { return mDpy != NULL; } 169b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 170b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallprivate: 171b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_t* mDpy; 172b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 173b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // non-assignable 174b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_ptr& operator=(const egl_display_ptr&); 175b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall}; 176b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 177b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall// ---------------------------------------------------------------------------- 178b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 179b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallinline egl_display_ptr get_display(EGLDisplay dpy) { 180b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall return egl_display_ptr(egl_display_t::get(dpy)); 181b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall} 182b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 183b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall// Does not ensure EGL is unhibernated. Use with caution: calls into the 184b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall// underlying EGL implementation are not safe. 185b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallinline egl_display_t* get_display_nowake(EGLDisplay dpy) { 186518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian return egl_display_t::get(dpy); 187518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian} 188518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 189518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 190518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 191b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallegl_display_ptr validate_display(EGLDisplay dpy); 192b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallegl_display_ptr validate_display_connection(EGLDisplay dpy, 193b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_connection_t*& cnx); 194518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias AgopianEGLBoolean validate_display_context(EGLDisplay dpy, EGLContext ctx); 195518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias AgopianEGLBoolean validate_display_surface(EGLDisplay dpy, EGLSurface surface); 196518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 197518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 198518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian}; // namespace android 199518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 200518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 201518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#endif // ANDROID_EGL_DISPLAY_H 202