mesa/src/egl/main
Chad Versace fbb4af96c6 egl: Check config's surface types in eglCreate*Surface()
If the provided EGLConfig does not support the requested surface type,
then emit EGL_BAD_MATCH.

Fixes dEQP-EGL.functional.negative_api.create_pbuffer_surface
on GBM.

Cc: "13.0" <mesa-stable@lists.freedesktop.org>
Reviewed-by: Tapani Pälli <tapani.palli@intel.com>
2016-12-20 11:53:31 -08:00
..
README.txt egl/main: Update README.txt 2015-05-14 21:00:04 +00:00
egl.def
egl.pc.in
eglapi.c egl: Check config's surface types in eglCreate*Surface() 2016-12-20 11:53:31 -08:00
eglapi.h egl: unexport _eglConvertIntsToAttribs 2016-12-09 17:33:43 +00:00
eglarray.c egl: don't allow eglGetConfigs to set num_configs param to a negative value 2015-08-13 17:36:06 +01:00
eglarray.h egl: Add needed extern "C" for C++ access 2015-05-14 14:08:37 -04:00
eglcompiler.h egl: Add needed extern "C" for C++ access 2015-05-14 14:08:37 -04:00
eglconfig.c egl: fix function name in debug string 2016-11-17 09:32:11 +02:00
eglconfig.h egl: Add EGL_RECORDABLE_ANDROID attribute 2016-04-01 13:45:08 +01:00
eglcontext.c egl: Rename MESA_configless_context bit to KHR_no_config_context 2016-09-12 11:29:09 -04:00
eglcontext.h egl: Add needed extern "C" for C++ access 2015-05-14 14:08:37 -04:00
eglcurrent.c egl: Track EGL_KHR_debug state when going through EGL API calls (v3) 2016-10-05 11:40:51 -04:00
eglcurrent.h egl: Track EGL_KHR_debug state when going through EGL API calls (v3) 2016-10-05 11:40:51 -04:00
egldefines.h egl: use util/macros.h 2016-11-04 11:30:47 +01:00
egldisplay.c egl: Implement EGL_MESA_platform_surfaceless 2016-10-14 11:19:40 -07:00
egldisplay.h egl: add and enable EGL_KHR_config_attribs 2016-12-09 17:36:28 +00:00
egldriver.c egl: remove final Windows specific workaround 2015-07-22 16:35:26 +01:00
egldriver.h egl/main: cleanup function prototypes 2015-05-14 21:00:04 +00:00
eglfallbacks.c egl: add EGL_ANDROID_native_fence_sync 2016-12-01 10:57:35 -08:00
eglglobals.c egl: Implement EGL_MESA_platform_surfaceless 2016-10-14 11:19:40 -07:00
eglglobals.h egl: Track EGL_KHR_debug state when going through EGL API calls (v3) 2016-10-05 11:40:51 -04:00
eglimage.c egl: definitions for EXT_image_dma_buf_import 2013-08-02 08:56:03 +03:00
eglimage.h egl: use EGL 1.5 types without suffixes 2015-06-05 19:44:33 +02:00
egllog.c egl: remove custom string functions 2015-07-22 16:35:26 +01:00
egllog.h egl: Add needed extern "C" for C++ access 2015-05-14 14:08:37 -04:00
eglsurface.c egl: add missing error-checking to eglReleaseTexImage() 2016-11-16 08:02:16 +02:00
eglsurface.h egl: implement EGL_KHR_gl_colorspace (v2) 2015-07-22 23:56:00 +02:00
eglsync.c egl: add EGL_ANDROID_native_fence_sync 2016-12-01 10:57:35 -08:00
eglsync.h egl: add EGL_ANDROID_native_fence_sync 2016-12-01 10:57:35 -08:00
egltypedefs.h egl/main: expose only core EGL functions statically 2015-05-14 21:00:05 +00:00

README.txt


Notes about the EGL library:


The EGL code here basically consists of two things:

1. An EGL API dispatcher.  This directly routes all the eglFooBar() API
   calls into driver-specific functions.

2. Fallbacks for EGL API functions.  A driver _could_ implement all the
   EGL API calls from scratch.  But in many cases, the fallbacks provided
   in libEGL (such as eglChooseConfig()) will do the job.



Bootstrapping:

When the apps calls eglInitialize() a device driver is selected and loaded
(look for _eglAddDrivers() and _eglLoadModule() in egldriver.c).

The built-in driver's entry point function is then called.  This driver function
allocates, initializes and returns a new _EGLDriver object (usually a
subclass of that type).

As part of initialization, the dispatch table in _EGLDriver->API must be
populated with all the EGL entrypoints.  Typically, _eglInitDriverFallbacks()
can be used to plug in default/fallback functions.  Some functions like
driver->API.Initialize and driver->API.Terminate _must_ be implemented
with driver-specific code (no default/fallback function is possible).


Shortly after, the driver->API.Initialize() function is executed.  Any additional
driver initialization that wasn't done in the driver entry point should be
done at this point.  Typically, this will involve setting up visual configs, etc.



Special Functions:

Certain EGL functions _must_ be implemented by the driver.  This includes:

eglCreateContext
eglCreateWindowSurface
eglCreatePixmapSurface
eglCreatePBufferSurface
eglMakeCurrent
eglSwapBuffers

Most of the EGLConfig-related functions can be implemented with the
defaults/fallbacks.  Same thing for the eglGet/Query functions.




Teardown:

When eglTerminate() is called, the driver->API.Terminate() function is
called.  The driver should clean up after itself.  eglTerminate() will
then close/unload the driver (shared library).




Subclassing:

The internal libEGL data structures such as _EGLDisplay, _EGLContext,
_EGLSurface, etc should be considered base classes from which drivers
will derive subclasses.