2011-07-02 09:57:30 +01:00
|
|
|
/**************************************************************************
|
|
|
|
*
|
|
|
|
* Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas.
|
|
|
|
* 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.
|
|
|
|
*
|
|
|
|
**************************************************************************/
|
|
|
|
|
|
|
|
|
2005-11-24 04:02:16 +00:00
|
|
|
#ifndef EGLAPI_INCLUDED
|
|
|
|
#define EGLAPI_INCLUDED
|
|
|
|
|
|
|
|
/**
|
2008-05-30 21:50:33 +01:00
|
|
|
* A generic function ptr type
|
2005-11-24 04:02:16 +00:00
|
|
|
*/
|
2010-01-29 01:00:30 +00:00
|
|
|
typedef void (*_EGLProc)(void);
|
2005-11-24 04:02:16 +00:00
|
|
|
|
|
|
|
|
2008-05-30 21:50:33 +01:00
|
|
|
/**
|
|
|
|
* Typedefs for all EGL API entrypoint functions.
|
|
|
|
*/
|
|
|
|
|
2005-11-24 04:02:16 +00:00
|
|
|
/* driver funcs */
|
2011-01-13 08:53:13 +00:00
|
|
|
typedef EGLBoolean (*Initialize_t)(_EGLDriver *, _EGLDisplay *dpy);
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef EGLBoolean (*Terminate_t)(_EGLDriver *, _EGLDisplay *dpy);
|
2005-11-24 04:02:16 +00:00
|
|
|
|
|
|
|
/* config funcs */
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef EGLBoolean (*GetConfigs_t)(_EGLDriver *drv, _EGLDisplay *dpy, EGLConfig *configs, EGLint config_size, EGLint *num_config);
|
|
|
|
typedef EGLBoolean (*ChooseConfig_t)(_EGLDriver *drv, _EGLDisplay *dpy, const EGLint *attrib_list, EGLConfig *configs, EGLint config_size, EGLint *num_config);
|
|
|
|
typedef EGLBoolean (*GetConfigAttrib_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *config, EGLint attribute, EGLint *value);
|
2005-11-24 04:02:16 +00:00
|
|
|
|
|
|
|
/* context funcs */
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef _EGLContext *(*CreateContext_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *config, _EGLContext *share_list, const EGLint *attrib_list);
|
|
|
|
typedef EGLBoolean (*DestroyContext_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLContext *ctx);
|
2010-01-27 15:51:54 +00:00
|
|
|
/* this is the only function (other than Initialize) that may be called with an uninitialized display */
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef EGLBoolean (*MakeCurrent_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *draw, _EGLSurface *read, _EGLContext *ctx);
|
|
|
|
typedef EGLBoolean (*QueryContext_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLContext *ctx, EGLint attribute, EGLint *value);
|
2005-11-24 04:02:16 +00:00
|
|
|
|
|
|
|
/* surface funcs */
|
2010-01-25 03:55:48 +00:00
|
|
|
typedef _EGLSurface *(*CreateWindowSurface_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *config, EGLNativeWindowType window, const EGLint *attrib_list);
|
|
|
|
typedef _EGLSurface *(*CreatePixmapSurface_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *config, EGLNativePixmapType pixmap, const EGLint *attrib_list);
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef _EGLSurface *(*CreatePbufferSurface_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *config, const EGLint *attrib_list);
|
|
|
|
typedef EGLBoolean (*DestroySurface_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface);
|
|
|
|
typedef EGLBoolean (*QuerySurface_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface, EGLint attribute, EGLint *value);
|
|
|
|
typedef EGLBoolean (*SurfaceAttrib_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface, EGLint attribute, EGLint value);
|
|
|
|
typedef EGLBoolean (*BindTexImage_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface, EGLint buffer);
|
|
|
|
typedef EGLBoolean (*ReleaseTexImage_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface, EGLint buffer);
|
2009-10-15 04:08:48 +01:00
|
|
|
typedef EGLBoolean (*SwapInterval_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surf, EGLint interval);
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef EGLBoolean (*SwapBuffers_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *draw);
|
2010-01-25 03:55:48 +00:00
|
|
|
typedef EGLBoolean (*CopyBuffers_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface, EGLNativePixmapType target);
|
2005-11-24 04:02:16 +00:00
|
|
|
|
|
|
|
/* misc funcs */
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef const char *(*QueryString_t)(_EGLDriver *drv, _EGLDisplay *dpy, EGLint name);
|
2009-09-28 07:12:39 +01:00
|
|
|
typedef EGLBoolean (*WaitClient_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLContext *ctx);
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef EGLBoolean (*WaitNative_t)(_EGLDriver *drv, _EGLDisplay *dpy, EGLint engine);
|
2005-11-24 04:02:16 +00:00
|
|
|
|
2010-02-17 09:30:44 +00:00
|
|
|
/* this function may be called from multiple threads at the same time */
|
2010-01-12 09:44:03 +00:00
|
|
|
typedef _EGLProc (*GetProcAddress_t)(_EGLDriver *drv, const char *procname);
|
2008-05-30 21:50:33 +01:00
|
|
|
|
|
|
|
|
2005-11-24 04:02:16 +00:00
|
|
|
|
2006-01-30 00:10:55 +00:00
|
|
|
#ifdef EGL_MESA_screen_surface
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef EGLBoolean (*ChooseModeMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, const EGLint *attrib_list, EGLModeMESA *modes, EGLint modes_size, EGLint *num_modes);
|
|
|
|
typedef EGLBoolean (*GetModesMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, EGLModeMESA *modes, EGLint mode_size, EGLint *num_mode);
|
|
|
|
typedef EGLBoolean (*GetModeAttribMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLMode *mode, EGLint attribute, EGLint *value);
|
|
|
|
typedef EGLBoolean (*CopyContextMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLContext *source, _EGLContext *dest, EGLint mask);
|
|
|
|
typedef EGLBoolean (*GetScreensMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, EGLScreenMESA *screens, EGLint max_screens, EGLint *num_screens);
|
|
|
|
typedef _EGLSurface *(*CreateScreenSurfaceMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *config, const EGLint *attrib_list);
|
|
|
|
typedef EGLBoolean (*ShowScreenSurfaceMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, _EGLSurface *surface, _EGLMode *mode);
|
|
|
|
typedef EGLBoolean (*ScreenPositionMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, EGLint x, EGLint y);
|
|
|
|
typedef EGLBoolean (*QueryScreenMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, EGLint attribute, EGLint *value);
|
|
|
|
typedef EGLBoolean (*QueryScreenSurfaceMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, _EGLSurface **surface);
|
|
|
|
typedef EGLBoolean (*QueryScreenModeMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLScreen *screen, _EGLMode **mode);
|
|
|
|
typedef const char * (*QueryModeStringMESA_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLMode *mode);
|
2006-01-30 00:10:55 +00:00
|
|
|
#endif /* EGL_MESA_screen_surface */
|
|
|
|
|
|
|
|
|
2009-08-11 10:09:39 +01:00
|
|
|
typedef _EGLSurface *(*CreatePbufferFromClientBuffer_t)(_EGLDriver *drv, _EGLDisplay *dpy, EGLenum buftype, EGLClientBuffer buffer, _EGLConfig *config, const EGLint *attrib_list);
|
2006-01-30 00:10:55 +00:00
|
|
|
|
2005-11-24 04:02:16 +00:00
|
|
|
|
2009-08-15 15:58:13 +01:00
|
|
|
typedef _EGLImage *(*CreateImageKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLContext *ctx, EGLenum target, EGLClientBuffer buffer, const EGLint *attr_list);
|
|
|
|
typedef EGLBoolean (*DestroyImageKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLImage *image);
|
|
|
|
|
2010-08-14 16:09:12 +01:00
|
|
|
|
|
|
|
typedef _EGLSync *(*CreateSyncKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, EGLenum type, const EGLint *attrib_list);
|
|
|
|
typedef EGLBoolean (*DestroySyncKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSync *sync);
|
|
|
|
typedef EGLint (*ClientWaitSyncKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSync *sync, EGLint flags, EGLTimeKHR timeout);
|
|
|
|
typedef EGLBoolean (*SignalSyncKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSync *sync, EGLenum mode);
|
|
|
|
typedef EGLBoolean (*GetSyncAttribKHR_t)(_EGLDriver *drv, _EGLDisplay *dpy, _EGLSync *sync, EGLint attribute, EGLint *value);
|
|
|
|
|
|
|
|
|
2010-05-07 03:01:35 +01:00
|
|
|
#ifdef EGL_NOK_swap_region
|
|
|
|
typedef EGLBoolean (*SwapBuffersRegionNOK_t)(_EGLDriver *drv, _EGLDisplay *disp, _EGLSurface *surf, EGLint numRects, const EGLint *rects);
|
|
|
|
#endif
|
2005-11-24 04:02:16 +00:00
|
|
|
|
2010-06-04 19:28:59 +01:00
|
|
|
#ifdef EGL_MESA_drm_image
|
|
|
|
typedef _EGLImage *(*CreateDRMImageMESA_t)(_EGLDriver *drv, _EGLDisplay *disp, const EGLint *attr_list);
|
|
|
|
typedef EGLBoolean (*ExportDRMImageMESA_t)(_EGLDriver *drv, _EGLDisplay *disp, _EGLImage *img, EGLint *name, EGLint *handle, EGLint *stride);
|
|
|
|
#endif
|
|
|
|
|
2011-02-21 15:22:34 +00:00
|
|
|
#ifdef EGL_WL_bind_wayland_display
|
|
|
|
struct wl_display;
|
|
|
|
typedef EGLBoolean (*BindWaylandDisplayWL_t)(_EGLDriver *drv, _EGLDisplay *disp, struct wl_display *display);
|
|
|
|
typedef EGLBoolean (*UnbindWaylandDisplayWL_t)(_EGLDriver *drv, _EGLDisplay *disp, struct wl_display *display);
|
2012-07-05 21:43:04 +01:00
|
|
|
typedef EGLBoolean (*QueryWaylandBufferWL_t)(_EGLDriver *drv, _EGLDisplay *displ, struct wl_buffer *buffer, EGLint attribute, EGLint *value);
|
2011-02-21 15:22:34 +00:00
|
|
|
#endif
|
|
|
|
|
2011-12-14 20:24:09 +00:00
|
|
|
typedef EGLBoolean (*PostSubBufferNV_t)(_EGLDriver *drv, _EGLDisplay *disp, _EGLSurface *surface, EGLint x, EGLint y, EGLint width, EGLint height);
|
|
|
|
|
2012-12-13 20:59:24 +00:00
|
|
|
typedef EGLint (*QueryBufferAge_t)(_EGLDriver *drv,
|
|
|
|
_EGLDisplay *dpy, _EGLSurface *surface);
|
|
|
|
|
2013-04-25 13:41:42 +01:00
|
|
|
#ifdef EGL_EXT_swap_buffers_with_damage
|
|
|
|
typedef EGLBoolean (*SwapBuffersWithDamageEXT_t) (_EGLDriver *drv, _EGLDisplay *dpy, _EGLSurface *surface, const EGLint *rects, EGLint n_rects);
|
|
|
|
#endif
|
2012-12-13 20:59:24 +00:00
|
|
|
|
2005-11-24 04:02:16 +00:00
|
|
|
/**
|
|
|
|
* The API dispatcher jumps through these functions
|
|
|
|
*/
|
|
|
|
struct _egl_api
|
|
|
|
{
|
|
|
|
Initialize_t Initialize;
|
|
|
|
Terminate_t Terminate;
|
|
|
|
|
|
|
|
GetConfigs_t GetConfigs;
|
|
|
|
ChooseConfig_t ChooseConfig;
|
|
|
|
GetConfigAttrib_t GetConfigAttrib;
|
|
|
|
|
|
|
|
CreateContext_t CreateContext;
|
|
|
|
DestroyContext_t DestroyContext;
|
|
|
|
MakeCurrent_t MakeCurrent;
|
|
|
|
QueryContext_t QueryContext;
|
|
|
|
|
|
|
|
CreateWindowSurface_t CreateWindowSurface;
|
|
|
|
CreatePixmapSurface_t CreatePixmapSurface;
|
|
|
|
CreatePbufferSurface_t CreatePbufferSurface;
|
|
|
|
DestroySurface_t DestroySurface;
|
|
|
|
QuerySurface_t QuerySurface;
|
|
|
|
SurfaceAttrib_t SurfaceAttrib;
|
|
|
|
BindTexImage_t BindTexImage;
|
|
|
|
ReleaseTexImage_t ReleaseTexImage;
|
|
|
|
SwapInterval_t SwapInterval;
|
|
|
|
SwapBuffers_t SwapBuffers;
|
|
|
|
CopyBuffers_t CopyBuffers;
|
|
|
|
|
|
|
|
QueryString_t QueryString;
|
2009-09-28 07:12:39 +01:00
|
|
|
WaitClient_t WaitClient;
|
2005-11-24 04:02:16 +00:00
|
|
|
WaitNative_t WaitNative;
|
2008-05-30 21:50:33 +01:00
|
|
|
GetProcAddress_t GetProcAddress;
|
2005-11-24 04:02:16 +00:00
|
|
|
|
2009-08-15 15:58:13 +01:00
|
|
|
#ifdef EGL_MESA_screen_surface
|
2005-11-24 04:02:16 +00:00
|
|
|
ChooseModeMESA_t ChooseModeMESA;
|
|
|
|
GetModesMESA_t GetModesMESA;
|
|
|
|
GetModeAttribMESA_t GetModeAttribMESA;
|
|
|
|
CopyContextMESA_t CopyContextMESA;
|
|
|
|
GetScreensMESA_t GetScreensMESA;
|
|
|
|
CreateScreenSurfaceMESA_t CreateScreenSurfaceMESA;
|
2005-12-10 17:54:00 +00:00
|
|
|
ShowScreenSurfaceMESA_t ShowScreenSurfaceMESA;
|
2005-11-24 04:02:16 +00:00
|
|
|
ScreenPositionMESA_t ScreenPositionMESA;
|
|
|
|
QueryScreenMESA_t QueryScreenMESA;
|
|
|
|
QueryScreenSurfaceMESA_t QueryScreenSurfaceMESA;
|
|
|
|
QueryScreenModeMESA_t QueryScreenModeMESA;
|
|
|
|
QueryModeStringMESA_t QueryModeStringMESA;
|
2009-08-15 15:58:13 +01:00
|
|
|
#endif /* EGL_MESA_screen_surface */
|
2006-01-30 00:10:55 +00:00
|
|
|
|
|
|
|
CreatePbufferFromClientBuffer_t CreatePbufferFromClientBuffer;
|
2009-08-15 15:58:13 +01:00
|
|
|
|
|
|
|
CreateImageKHR_t CreateImageKHR;
|
|
|
|
DestroyImageKHR_t DestroyImageKHR;
|
2010-05-07 03:01:35 +01:00
|
|
|
|
2010-08-14 16:09:12 +01:00
|
|
|
CreateSyncKHR_t CreateSyncKHR;
|
|
|
|
DestroySyncKHR_t DestroySyncKHR;
|
|
|
|
ClientWaitSyncKHR_t ClientWaitSyncKHR;
|
|
|
|
SignalSyncKHR_t SignalSyncKHR;
|
|
|
|
GetSyncAttribKHR_t GetSyncAttribKHR;
|
|
|
|
|
2010-05-07 03:01:35 +01:00
|
|
|
#ifdef EGL_NOK_swap_region
|
|
|
|
SwapBuffersRegionNOK_t SwapBuffersRegionNOK;
|
|
|
|
#endif
|
2010-06-04 19:28:59 +01:00
|
|
|
|
|
|
|
#ifdef EGL_MESA_drm_image
|
|
|
|
CreateDRMImageMESA_t CreateDRMImageMESA;
|
|
|
|
ExportDRMImageMESA_t ExportDRMImageMESA;
|
|
|
|
#endif
|
2011-02-21 15:22:34 +00:00
|
|
|
|
|
|
|
#ifdef EGL_WL_bind_wayland_display
|
|
|
|
BindWaylandDisplayWL_t BindWaylandDisplayWL;
|
|
|
|
UnbindWaylandDisplayWL_t UnbindWaylandDisplayWL;
|
2012-07-05 21:43:04 +01:00
|
|
|
QueryWaylandBufferWL_t QueryWaylandBufferWL;
|
2011-02-21 15:22:34 +00:00
|
|
|
#endif
|
2011-12-14 20:24:09 +00:00
|
|
|
|
2013-04-25 13:41:42 +01:00
|
|
|
#ifdef EGL_EXT_swap_buffers_with_damage
|
|
|
|
SwapBuffersWithDamageEXT_t SwapBuffersWithDamageEXT;
|
|
|
|
#endif /* EGL_EXT_swap_buffers_with_damage */
|
|
|
|
|
2011-12-14 20:24:09 +00:00
|
|
|
PostSubBufferNV_t PostSubBufferNV;
|
2012-12-13 20:59:24 +00:00
|
|
|
|
|
|
|
QueryBufferAge_t QueryBufferAge;
|
2005-11-24 04:02:16 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif /* EGLAPI_INCLUDED */
|