egl_display.h revision 311b479d7f50bc9e487cf9b4859843d0f4778382
14774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall/* 2518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** Copyright 2007, The Android Open Source Project 3518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** 44774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** Licensed under the Apache License, Version 2.0 (the "License"); 54774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** you may not use this file except in compliance with the License. 64774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** You may obtain a copy of the License at 7518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** 84774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** http://www.apache.org/licenses/LICENSE-2.0 9518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ** 104774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** Unless required by applicable law or agreed to in writing, software 114774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** distributed under the License is distributed on an "AS IS" BASIS, 124774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 134774338bd0ad1ebe42c311fd0c72f13786b5c800Jesse Hall ** 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 <stdint.h> 22311b479d7f50bc9e487cf9b4859843d0f4778382Mathias Agopian#include <stddef.h> 23518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 24518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <EGL/egl.h> 25518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <EGL/eglext.h> 26518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 27b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall#include <cutils/compiler.h> 28518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#include <utils/SortedVector.h> 29311b479d7f50bc9e487cf9b4859843d0f4778382Mathias Agopian#include <utils/Condition.h> 30311b479d7f50bc9e487cf9b4859843d0f4778382Mathias Agopian#include <utils/Mutex.h> 314b9511c16195a646242eff833b0af212933b6ecaMathias Agopian#include <utils/String8.h> 32518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 331cadb25da1ed875bdd078270e642966724a0c39aMathias Agopian#include "egldefs.h" 3439c24a20bbc697630d2b92c251b70c04d6f9d00cMathias Agopian#include "../hooks.h" 35518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 36518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 37518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopiannamespace android { 38518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 39518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 40518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianclass egl_object_t; 41fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopianclass egl_context_t; 429f425914db84a3dd9e011ae0b1cb0bd2da6b6720Bernhard Rosenkränzerstruct egl_connection_t; 43518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 44518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 45518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 4698c6383580f94bb7ff9cc9a7cc24d8b8519e484aJamie Gennisclass EGLAPI egl_display_t { // marked as EGLAPI for testing purposes 47518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian static egl_display_t sDisplay[NUM_DISPLAYS]; 48518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLDisplay getDisplay(EGLNativeDisplayType display); 49a4b2c041828d1074dca3b999407e7dd85568c5aaMathias Agopian void loseCurrentImpl(egl_context_t * cur_c); 50518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 51518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopianpublic: 52518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian enum { 53518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian NOT_INITIALIZED = 0, 54518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian INITIALIZED = 1, 55518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian TERMINATED = 2 56518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian }; 57518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 58518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian egl_display_t(); 59518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian ~egl_display_t(); 60518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 61518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLBoolean initialize(EGLint *major, EGLint *minor); 62518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian EGLBoolean terminate(); 63518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 64518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian // add object to this display's list 65518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian void addObject(egl_object_t* object); 665b287a6ea8dfac7ab3e03ae1e98f9e2214cbae09Mathias Agopian // remove object from this display's list 675b287a6ea8dfac7ab3e03ae1e98f9e2214cbae09Mathias Agopian void removeObject(egl_object_t* object); 68518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian // add reference to this object. returns true if this is a valid object. 69f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian bool getObject(egl_object_t* object) const; 70518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 71518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian static egl_display_t* get(EGLDisplay dpy); 72518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian static EGLDisplay getFromNativeDisplay(EGLNativeDisplayType disp); 73518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 74fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian EGLBoolean makeCurrent(egl_context_t* c, egl_context_t* cur_c, 75fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian EGLSurface draw, EGLSurface read, EGLContext ctx, 76fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian EGLSurface impl_draw, EGLSurface impl_read, EGLContext impl_ctx); 77fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian static void loseCurrent(egl_context_t * cur_c); 78fb87e54a9af8bc5063ca4deebe81d90126992480Mathias Agopian 79518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian inline bool isReady() const { return (refs > 0); } 80518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian inline bool isValid() const { return magic == '_dpy'; } 81518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian inline bool isAlive() const { return isValid(); } 82518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 834b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getVendorString() const { return mVendorString.string(); } 844b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getVersionString() const { return mVersionString.string(); } 854b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getClientApiString() const { return mClientApiString.string(); } 864b9511c16195a646242eff833b0af212933b6ecaMathias Agopian char const * getExtensionString() const { return mExtensionString.string(); } 874b9511c16195a646242eff833b0af212933b6ecaMathias Agopian 88c2e41222bf02a6579763974f82d65875cfa43481Jesse Hall bool haveExtension(const char* name, size_t nameLen = 0) const; 89c2e41222bf02a6579763974f82d65875cfa43481Jesse Hall 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 117f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian uint32_t refs; 11854466bc4412acf33a59af59d9eadde54c22b2ebeMichael Lentine bool eglIsInitialized; 11954466bc4412acf33a59af59d9eadde54c22b2ebeMichael Lentine mutable Mutex lock, refLock; 12054466bc4412acf33a59af59d9eadde54c22b2ebeMichael Lentine mutable Condition refCond; 121f0480de37492597a5c5cf1e6f8346f1467e3a552Mathias Agopian SortedVector<egl_object_t*> objects; 1224b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mVendorString; 1234b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mVersionString; 1244b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mClientApiString; 1254b9511c16195a646242eff833b0af212933b6ecaMathias Agopian String8 mExtensionString; 126518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian}; 127518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 128518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 129518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 130258385978c517a47626161b1e644c48bcee28de1Jesse Hall// An egl_display_ptr is a kind of smart pointer for egl_display_t objects. 131258385978c517a47626161b1e644c48bcee28de1Jesse Hall// It doesn't refcount the egl_display_t, but does ensure that the underlying 132258385978c517a47626161b1e644c48bcee28de1Jesse Hall// EGL implementation is "awake" (not hibernating) and ready for use as long 133258385978c517a47626161b1e644c48bcee28de1Jesse Hall// as the egl_display_ptr exists. 134b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallclass egl_display_ptr { 135b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallpublic: 136e9cbb659a7c45481444e3d3cbb171fa3251d0cb8Dan Willemsen explicit egl_display_ptr(egl_display_t* dpy): mDpy(dpy) {} 137b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 138b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // We only really need a C++11 move constructor, not a copy constructor. 139b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // A move constructor would save an enter()/leave() pair on every EGL API 140b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // call. But enabling -std=c++0x causes lots of errors elsewhere, so I 141258385978c517a47626161b1e644c48bcee28de1Jesse Hall // can't use a move constructor until those are cleaned up. 142b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // 143b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // egl_display_ptr(egl_display_ptr&& other) { 144b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // mDpy = other.mDpy; 145b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // other.mDpy = NULL; 146b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // } 147258385978c517a47626161b1e644c48bcee28de1Jesse Hall // 148e9cbb659a7c45481444e3d3cbb171fa3251d0cb8Dan Willemsen egl_display_ptr(const egl_display_ptr& other): mDpy(other.mDpy) {} 149e9cbb659a7c45481444e3d3cbb171fa3251d0cb8Dan Willemsen 150e9cbb659a7c45481444e3d3cbb171fa3251d0cb8Dan Willemsen ~egl_display_ptr() {} 151b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 152b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall const egl_display_t* operator->() const { return mDpy; } 153b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_t* operator->() { return mDpy; } 154b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 155b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall const egl_display_t* get() const { return mDpy; } 156b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_t* get() { return mDpy; } 157b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 158b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall operator bool() const { return mDpy != NULL; } 159b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 160b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallprivate: 161b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_t* mDpy; 162b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 163b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall // non-assignable 164b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_display_ptr& operator=(const egl_display_ptr&); 165b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall}; 166b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 167b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall// ---------------------------------------------------------------------------- 168b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 169b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallinline egl_display_ptr get_display(EGLDisplay dpy) { 170b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall return egl_display_ptr(egl_display_t::get(dpy)); 171b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall} 172b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall 173b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall// Does not ensure EGL is unhibernated. Use with caution: calls into the 174b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall// underlying EGL implementation are not safe. 175b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallinline egl_display_t* get_display_nowake(EGLDisplay dpy) { 176518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian return egl_display_t::get(dpy); 177518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian} 178518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 179518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 180518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 181b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallegl_display_ptr validate_display(EGLDisplay dpy); 182b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hallegl_display_ptr validate_display_connection(EGLDisplay dpy, 183b29e5e8c2682ae145e8c56d9afb061f8da7f854cJesse Hall egl_connection_t*& cnx); 184518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias AgopianEGLBoolean validate_display_context(EGLDisplay dpy, EGLContext ctx); 185518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias AgopianEGLBoolean validate_display_surface(EGLDisplay dpy, EGLSurface surface); 186518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 187518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 188518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian}; // namespace android 189518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian// ---------------------------------------------------------------------------- 190518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian 191518ec112f468eb67bf681b3eec896d7bfb4ff98dMathias Agopian#endif // ANDROID_EGL_DISPLAY_H 192