| /************************************************************************** |
| * |
| * Copyright 2008 VMware, Inc. |
| * Copyright 2009-2010 Chia-I Wu <olvaffe@gmail.com> |
| * Copyright 2010-2011 LunarG, Inc. |
| * All Rights Reserved. |
| * |
| * Permission is hereby granted, free of charge, to any person obtaining a |
| * copy of this software and associated documentation files (the |
| * "Software"), to deal in the Software without restriction, including |
| * without limitation the rights to use, copy, modify, merge, publish, |
| * distribute, sub license, and/or sell copies of the Software, and to |
| * permit persons to whom the Software is furnished to do so, subject to |
| * the following conditions: |
| * |
| * The above copyright notice and this permission notice (including the |
| * next paragraph) shall be included in all copies or substantial portions |
| * of the Software. |
| * |
| * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
| * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
| * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
| * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
| * DEALINGS IN THE SOFTWARE. |
| * |
| **************************************************************************/ |
| |
| |
| /** |
| * Functions related to EGLDisplay. |
| */ |
| |
| #include <assert.h> |
| #include <stdlib.h> |
| #include <string.h> |
| #include "c11/threads.h" |
| #include "util/u_atomic.h" |
| |
| #include "eglcontext.h" |
| #include "eglcurrent.h" |
| #include "eglsurface.h" |
| #include "egldisplay.h" |
| #include "egldriver.h" |
| #include "eglglobals.h" |
| #include "egllog.h" |
| #include "eglimage.h" |
| #include "eglsync.h" |
| |
| /* Includes for _eglNativePlatformDetectNativeDisplay */ |
| #ifdef HAVE_WAYLAND_PLATFORM |
| #include <wayland-client.h> |
| #endif |
| #ifdef HAVE_DRM_PLATFORM |
| #include <gbm.h> |
| #endif |
| |
| |
| /** |
| * Map --with-platforms names to platform types. |
| */ |
| static const struct { |
| _EGLPlatformType platform; |
| const char *name; |
| } egl_platforms[_EGL_NUM_PLATFORMS] = { |
| { _EGL_PLATFORM_X11, "x11" }, |
| { _EGL_PLATFORM_WAYLAND, "wayland" }, |
| { _EGL_PLATFORM_DRM, "drm" }, |
| { _EGL_PLATFORM_ANDROID, "android" }, |
| { _EGL_PLATFORM_HAIKU, "haiku" }, |
| { _EGL_PLATFORM_SURFACELESS, "surfaceless" }, |
| }; |
| |
| |
| /** |
| * Return the native platform by parsing EGL_PLATFORM. |
| */ |
| static _EGLPlatformType |
| _eglGetNativePlatformFromEnv(void) |
| { |
| _EGLPlatformType plat = _EGL_INVALID_PLATFORM; |
| const char *plat_name; |
| EGLint i; |
| |
| plat_name = getenv("EGL_PLATFORM"); |
| /* try deprecated env variable */ |
| if (!plat_name || !plat_name[0]) |
| plat_name = getenv("EGL_DISPLAY"); |
| if (!plat_name || !plat_name[0]) |
| return _EGL_INVALID_PLATFORM; |
| |
| for (i = 0; i < _EGL_NUM_PLATFORMS; i++) { |
| if (strcmp(egl_platforms[i].name, plat_name) == 0) { |
| plat = egl_platforms[i].platform; |
| break; |
| } |
| } |
| |
| return plat; |
| } |
| |
| |
| /** |
| * Try detecting native platform with the help of native display characteristcs. |
| */ |
| static _EGLPlatformType |
| _eglNativePlatformDetectNativeDisplay(void *nativeDisplay) |
| { |
| if (nativeDisplay == EGL_DEFAULT_DISPLAY) |
| return _EGL_INVALID_PLATFORM; |
| |
| if (_eglPointerIsDereferencable(nativeDisplay)) { |
| void *first_pointer = *(void **) nativeDisplay; |
| |
| (void) first_pointer; /* silence unused var warning */ |
| |
| #ifdef HAVE_WAYLAND_PLATFORM |
| /* wl_display is a wl_proxy, which is a wl_object. |
| * wl_object's first element points to the interfacetype. */ |
| if (first_pointer == &wl_display_interface) |
| return _EGL_PLATFORM_WAYLAND; |
| #endif |
| |
| #ifdef HAVE_DRM_PLATFORM |
| /* gbm has a pointer to its constructor as first element. */ |
| if (first_pointer == gbm_create_device) |
| return _EGL_PLATFORM_DRM; |
| #endif |
| |
| #ifdef HAVE_X11_PLATFORM |
| /* If not matched to any other platform, fallback to x11. */ |
| return _EGL_PLATFORM_X11; |
| #endif |
| |
| #ifdef HAVE_HAIKU_PLATFORM |
| return _EGL_PLATFORM_HAIKU; |
| #endif |
| } |
| |
| return _EGL_INVALID_PLATFORM; |
| } |
| |
| |
| /** |
| * Return the native platform. It is the platform of the EGL native types. |
| */ |
| _EGLPlatformType |
| _eglGetNativePlatform(void *nativeDisplay) |
| { |
| static _EGLPlatformType native_platform = _EGL_INVALID_PLATFORM; |
| _EGLPlatformType detected_platform = native_platform; |
| |
| if (detected_platform == _EGL_INVALID_PLATFORM) { |
| const char *detection_method; |
| |
| detected_platform = _eglGetNativePlatformFromEnv(); |
| detection_method = "environment overwrite"; |
| |
| if (detected_platform == _EGL_INVALID_PLATFORM) { |
| detected_platform = _eglNativePlatformDetectNativeDisplay(nativeDisplay); |
| detection_method = "autodetected"; |
| } |
| |
| if (detected_platform == _EGL_INVALID_PLATFORM) { |
| detected_platform = _EGL_NATIVE_PLATFORM; |
| detection_method = "build-time configuration"; |
| } |
| |
| _eglLog(_EGL_DEBUG, "Native platform type: %s (%s)", |
| egl_platforms[detected_platform].name, detection_method); |
| |
| p_atomic_cmpxchg(&native_platform, _EGL_INVALID_PLATFORM, |
| detected_platform); |
| } |
| |
| return native_platform; |
| } |
| |
| |
| /** |
| * Finish display management. |
| */ |
| void |
| _eglFiniDisplay(void) |
| { |
| _EGLDisplay *dpyList, *dpy; |
| |
| /* atexit function is called with global mutex locked */ |
| dpyList = _eglGlobal.DisplayList; |
| while (dpyList) { |
| EGLint i; |
| |
| /* pop list head */ |
| dpy = dpyList; |
| dpyList = dpyList->Next; |
| |
| for (i = 0; i < _EGL_NUM_RESOURCES; i++) { |
| if (dpy->ResourceLists[i]) { |
| _eglLog(_EGL_DEBUG, "Display %p is destroyed with resources", dpy); |
| break; |
| } |
| } |
| |
| free(dpy); |
| } |
| _eglGlobal.DisplayList = NULL; |
| } |
| |
| |
| /** |
| * Find the display corresponding to the specified native display, or create a |
| * new one. |
| */ |
| _EGLDisplay * |
| _eglFindDisplay(_EGLPlatformType plat, void *plat_dpy) |
| { |
| _EGLDisplay *dpy; |
| |
| if (plat == _EGL_INVALID_PLATFORM) |
| return NULL; |
| |
| mtx_lock(_eglGlobal.Mutex); |
| |
| /* search the display list first */ |
| dpy = _eglGlobal.DisplayList; |
| while (dpy) { |
| if (dpy->Platform == plat && dpy->PlatformDisplay == plat_dpy) |
| break; |
| dpy = dpy->Next; |
| } |
| |
| /* create a new display */ |
| if (!dpy) { |
| dpy = calloc(1, sizeof(_EGLDisplay)); |
| if (dpy) { |
| mtx_init(&dpy->Mutex, mtx_plain); |
| dpy->Platform = plat; |
| dpy->PlatformDisplay = plat_dpy; |
| |
| /* add to the display list */ |
| dpy->Next = _eglGlobal.DisplayList; |
| _eglGlobal.DisplayList = dpy; |
| } |
| } |
| |
| mtx_unlock(_eglGlobal.Mutex); |
| |
| return dpy; |
| } |
| |
| |
| /** |
| * Destroy the contexts and surfaces that are linked to the display. |
| */ |
| void |
| _eglReleaseDisplayResources(_EGLDriver *drv, _EGLDisplay *display) |
| { |
| _EGLResource *list; |
| |
| list = display->ResourceLists[_EGL_RESOURCE_CONTEXT]; |
| while (list) { |
| _EGLContext *ctx = (_EGLContext *) list; |
| list = list->Next; |
| |
| _eglUnlinkContext(ctx); |
| drv->API.DestroyContext(drv, display, ctx); |
| } |
| assert(!display->ResourceLists[_EGL_RESOURCE_CONTEXT]); |
| |
| list = display->ResourceLists[_EGL_RESOURCE_SURFACE]; |
| while (list) { |
| _EGLSurface *surf = (_EGLSurface *) list; |
| list = list->Next; |
| |
| _eglUnlinkSurface(surf); |
| drv->API.DestroySurface(drv, display, surf); |
| } |
| assert(!display->ResourceLists[_EGL_RESOURCE_SURFACE]); |
| |
| list = display->ResourceLists[_EGL_RESOURCE_IMAGE]; |
| while (list) { |
| _EGLImage *image = (_EGLImage *) list; |
| list = list->Next; |
| |
| _eglUnlinkImage(image); |
| drv->API.DestroyImageKHR(drv, display, image); |
| } |
| assert(!display->ResourceLists[_EGL_RESOURCE_IMAGE]); |
| |
| list = display->ResourceLists[_EGL_RESOURCE_SYNC]; |
| while (list) { |
| _EGLSync *sync = (_EGLSync *) list; |
| list = list->Next; |
| |
| _eglUnlinkSync(sync); |
| drv->API.DestroySyncKHR(drv, display, sync); |
| } |
| assert(!display->ResourceLists[_EGL_RESOURCE_SYNC]); |
| } |
| |
| |
| /** |
| * Free all the data hanging of an _EGLDisplay object, but not |
| * the object itself. |
| */ |
| void |
| _eglCleanupDisplay(_EGLDisplay *disp) |
| { |
| if (disp->Configs) { |
| _eglDestroyArray(disp->Configs, free); |
| disp->Configs = NULL; |
| } |
| |
| /* XXX incomplete */ |
| } |
| |
| |
| /** |
| * Return EGL_TRUE if the given handle is a valid handle to a display. |
| */ |
| EGLBoolean |
| _eglCheckDisplayHandle(EGLDisplay dpy) |
| { |
| _EGLDisplay *cur; |
| |
| mtx_lock(_eglGlobal.Mutex); |
| cur = _eglGlobal.DisplayList; |
| while (cur) { |
| if (cur == (_EGLDisplay *) dpy) |
| break; |
| cur = cur->Next; |
| } |
| mtx_unlock(_eglGlobal.Mutex); |
| return (cur != NULL); |
| } |
| |
| |
| /** |
| * Return EGL_TRUE if the given resource is valid. That is, the display does |
| * own the resource. |
| */ |
| EGLBoolean |
| _eglCheckResource(void *res, _EGLResourceType type, _EGLDisplay *dpy) |
| { |
| _EGLResource *list = dpy->ResourceLists[type]; |
| |
| if (!res) |
| return EGL_FALSE; |
| |
| while (list) { |
| if (res == (void *) list) { |
| assert(list->Display == dpy); |
| break; |
| } |
| list = list->Next; |
| } |
| |
| return (list != NULL); |
| } |
| |
| |
| /** |
| * Initialize a display resource. The size of the subclass object is |
| * specified. |
| * |
| * This is supposed to be called from the initializers of subclasses, such as |
| * _eglInitContext or _eglInitSurface. |
| */ |
| void |
| _eglInitResource(_EGLResource *res, EGLint size, _EGLDisplay *dpy) |
| { |
| memset(res, 0, size); |
| res->Display = dpy; |
| res->RefCount = 1; |
| } |
| |
| |
| /** |
| * Increment reference count for the resource. |
| */ |
| void |
| _eglGetResource(_EGLResource *res) |
| { |
| assert(res && res->RefCount > 0); |
| /* hopefully a resource is always manipulated with its display locked */ |
| res->RefCount++; |
| } |
| |
| |
| /** |
| * Decrement reference count for the resource. |
| */ |
| EGLBoolean |
| _eglPutResource(_EGLResource *res) |
| { |
| assert(res && res->RefCount > 0); |
| res->RefCount--; |
| return (!res->RefCount); |
| } |
| |
| |
| /** |
| * Link a resource to its display. |
| */ |
| void |
| _eglLinkResource(_EGLResource *res, _EGLResourceType type) |
| { |
| assert(res->Display); |
| |
| res->IsLinked = EGL_TRUE; |
| res->Next = res->Display->ResourceLists[type]; |
| res->Display->ResourceLists[type] = res; |
| _eglGetResource(res); |
| } |
| |
| |
| /** |
| * Unlink a linked resource from its display. |
| */ |
| void |
| _eglUnlinkResource(_EGLResource *res, _EGLResourceType type) |
| { |
| _EGLResource *prev; |
| |
| prev = res->Display->ResourceLists[type]; |
| if (prev != res) { |
| while (prev) { |
| if (prev->Next == res) |
| break; |
| prev = prev->Next; |
| } |
| assert(prev); |
| prev->Next = res->Next; |
| } |
| else { |
| res->Display->ResourceLists[type] = res->Next; |
| } |
| |
| res->Next = NULL; |
| res->IsLinked = EGL_FALSE; |
| _eglPutResource(res); |
| |
| /* We always unlink before destroy. The driver still owns a reference */ |
| assert(res->RefCount); |
| } |
| |
| #ifdef HAVE_X11_PLATFORM |
| static EGLBoolean |
| _eglParseX11DisplayAttribList(_EGLDisplay *display, |
| const EGLAttrib *attrib_list) |
| { |
| int i; |
| |
| if (attrib_list == NULL) { |
| return EGL_TRUE; |
| } |
| |
| for (i = 0; attrib_list[i] != EGL_NONE; i += 2) { |
| EGLAttrib attrib = attrib_list[i]; |
| EGLAttrib value = attrib_list[i + 1]; |
| |
| /* EGL_EXT_platform_x11 recognizes exactly one attribute, |
| * EGL_PLATFORM_X11_SCREEN_EXT, which is optional. |
| */ |
| if (attrib != EGL_PLATFORM_X11_SCREEN_EXT) |
| return _eglError(EGL_BAD_ATTRIBUTE, "eglGetPlatformDisplay"); |
| |
| display->Options.Platform = (void *)(uintptr_t)value; |
| } |
| |
| return EGL_TRUE; |
| } |
| |
| _EGLDisplay* |
| _eglGetX11Display(Display *native_display, |
| const EGLAttrib *attrib_list) |
| { |
| _EGLDisplay *display = _eglFindDisplay(_EGL_PLATFORM_X11, |
| native_display); |
| |
| if (!display) { |
| _eglError(EGL_BAD_ALLOC, "eglGetPlatformDisplay"); |
| return NULL; |
| } |
| |
| if (!_eglParseX11DisplayAttribList(display, attrib_list)) { |
| return NULL; |
| } |
| |
| return display; |
| } |
| #endif /* HAVE_X11_PLATFORM */ |
| |
| #ifdef HAVE_DRM_PLATFORM |
| _EGLDisplay* |
| _eglGetGbmDisplay(struct gbm_device *native_display, |
| const EGLAttrib *attrib_list) |
| { |
| /* EGL_MESA_platform_gbm recognizes no attributes. */ |
| if (attrib_list != NULL && attrib_list[0] != EGL_NONE) { |
| _eglError(EGL_BAD_ATTRIBUTE, "eglGetPlatformDisplay"); |
| return NULL; |
| } |
| |
| return _eglFindDisplay(_EGL_PLATFORM_DRM, native_display); |
| } |
| #endif /* HAVE_DRM_PLATFORM */ |
| |
| #ifdef HAVE_WAYLAND_PLATFORM |
| _EGLDisplay* |
| _eglGetWaylandDisplay(struct wl_display *native_display, |
| const EGLAttrib *attrib_list) |
| { |
| /* EGL_EXT_platform_wayland recognizes no attributes. */ |
| if (attrib_list != NULL && attrib_list[0] != EGL_NONE) { |
| _eglError(EGL_BAD_ATTRIBUTE, "eglGetPlatformDisplay"); |
| return NULL; |
| } |
| |
| return _eglFindDisplay(_EGL_PLATFORM_WAYLAND, native_display); |
| } |
| #endif /* HAVE_WAYLAND_PLATFORM */ |
| |
| #ifdef HAVE_SURFACELESS_PLATFORM |
| _EGLDisplay* |
| _eglGetSurfacelessDisplay(void *native_display, |
| const EGLAttrib *attrib_list) |
| { |
| /* This platform has no native display. */ |
| if (native_display != NULL) { |
| _eglError(EGL_BAD_PARAMETER, "eglGetPlatformDisplay"); |
| return NULL; |
| } |
| |
| /* This platform recognizes no display attributes. */ |
| if (attrib_list != NULL && attrib_list[0] != EGL_NONE) { |
| _eglError(EGL_BAD_ATTRIBUTE, "eglGetPlatformDisplay"); |
| return NULL; |
| } |
| |
| return _eglFindDisplay(_EGL_PLATFORM_SURFACELESS, native_display); |
| } |
| #endif /* HAVE_SURFACELESS_PLATFORM */ |