mesa/src/egl/main
Adrian Negreanu a49ebfab1d android: add libloader to libGLES_mesa and libmesa_egl_dri2
This fixes
  src/egl/drivers/dri2/platform_android.c:664: error: undefined reference to 'loader_set_logger'
  src/egl/drivers/dri2/platform_android.c:678: error: undefined reference to 'loader_get_driver_for_fd'

Cc: "10.1 10.2" <mesa-stable@lists.freedesktop.org>
Signed-off-by: Adrian Negreanu <adrian.m.negreanu@intel.com>
Reviewed-by: Emil Velikov <emil.l.velikov@gmail.com>
Reviewed-by: Juha-Pekka Heikkila <juhapekka.heikkila@gmail.com>
2014-06-09 22:50:53 +01:00
..
Android.mk android: add libloader to libGLES_mesa and libmesa_egl_dri2 2014-06-09 22:50:53 +01:00
egl.def egl: Add egl.def for win32 build. 2010-08-20 19:22:50 +08:00
egl.pc.in egl/main: Convert to automake. 2012-02-29 11:52:40 -08:00
eglapi.c egl: Check for NULL native_window in eglCreateWindowSurface 2014-06-03 17:28:30 -07:00
eglapi.h egl: Add EGL_CHROMIUM_sync_control extension. 2014-05-20 15:19:48 -07:00
eglarray.c egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglarray.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglcompiler.h egl: Don't attempt to redefine stdint.h types with VS 2010. 2014-05-02 22:04:47 +01:00
eglconfig.c s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglconfig.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglcontext.c Add the EGL_MESA_configless_context extension 2014-03-12 14:40:47 -07:00
eglcontext.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglcurrent.c egl: Kill macro _EGL_DECLARE_MUTEX 2013-11-26 12:50:30 -08:00
eglcurrent.h egl/dri2: Add plumbing for EGL_OPENGL_ES3_BIT_KHR 2013-01-15 13:45:54 -08:00
egldefines.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
egldisplay.c egl/main: Enable Linux platform extensions 2014-03-17 15:49:06 -07:00
egldisplay.h egl: Add EGL_CHROMIUM_sync_control extension. 2014-05-20 15:19:48 -07:00
egldriver.c egl/glx: Remove egl_glx driver 2014-02-05 18:19:26 -08:00
egldriver.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglfallbacks.c egl: remove #ifdef's for official extensions 2011-12-20 16:59:09 +08:00
eglglobals.c egl/main: Enable Linux platform extensions 2014-03-17 15:49:06 -07:00
eglglobals.h egl/main: Enable Linux platform extensions 2014-03-17 15:49:06 -07:00
eglimage.c egl: definitions for EXT_image_dma_buf_import 2013-08-02 08:56:03 +03:00
eglimage.h egl: definitions for EXT_image_dma_buf_import 2013-08-02 08:56:03 +03:00
egllog.c s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
egllog.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglmisc.c egl: Add EGL_CHROMIUM_sync_control extension. 2014-05-20 15:19:48 -07:00
eglmisc.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglmode.c s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglmode.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglmutex.h egl: Use C11 thread abstractions. 2014-01-23 12:55:55 +00:00
eglscreen.c s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglscreen.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglstring.c s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglstring.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
eglsurface.c dri_interface: Update __DRItexBufferExtensionRec to version 3 2014-04-28 19:11:27 +01:00
eglsurface.h dri_interface: Update __DRItexBufferExtensionRec to version 3 2014-04-28 19:11:27 +01:00
eglsync.c egl: remove #ifdef's for official extensions 2011-12-20 16:59:09 +08:00
eglsync.h egl: remove #ifdef's for official extensions 2011-12-20 16:59:09 +08:00
egltypedefs.h s/Tungsten Graphics/VMware/ 2014-01-17 20:00:32 +00:00
Makefile.am Fix build for darwin 2014-05-23 15:24:01 +01:00
README.txt egl: some basic docs for libEGL 2008-06-11 19:35:52 -06:00
SConscript scons: Updates for targets/egl-static. 2011-01-12 17:40:01 +08:00


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 eglOpenDisplay() a device driver is selected and loaded
(look for dlsym() or LoadLibrary() in egldriver.c).

The driver's _eglMain() 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).


A bit later, the app will call eglInitialize().  This will get routed
to the driver->API.Initialize() function.  Any additional driver
initialization that wasn't done in _eglMain() 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.