mesa/src/egl/main
Gaetan Nadon e6fb744141 egl/main: remove undefined X11_LIBS automake variable
The EGL library has some references to x11 but it gets the link flags
from the XCB_DRI2_LIBS if and only if HAVE_EGL_PLATFORM_X11 is true.

The X11_LIBS variable was probably coming from a PKG_CHECK_MODULES (x11)
earlier in history.

If it is possible to have HAVE_EGL_DRIVER_GLX without HAVE_EGL_PLATFORM_X11
then the link flags for libX11 should be passed. However, it won't come
from X11_LIBS which is undefined.

Reported-by: Emil Velikov <emil.l.velikov@gmail.com>
Acked-by: Emil Velikov <emil.l.velikov@gmail.com>
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
2013-10-09 10:36:01 -04:00
..
Android.mk android: libsync is needed on Android 4.2+ for any driver 2013-05-06 07:20:08 -07: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: Update to Wayland 1.2 server API 2013-08-07 10:37:58 -07:00
eglapi.h egl: Update to Wayland 1.2 server API 2013-08-07 10:37:58 -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 mesa,gallium,egl,mapi: One definition of C99 inline/__func__ to rule them all. 2013-03-12 22:06:27 +00:00
eglconfig.c egl/dri2: Add plumbing for EGL_OPENGL_ES3_BIT_KHR 2013-01-15 13:45:54 -08:00
eglconfig.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglcontext.c egl/dri2: Add plumbing for EGL_OPENGL_ES3_BIT_KHR 2013-01-15 13:45:54 -08:00
eglcontext.h egl: Implement front-end support for EGL_KHR_create_context 2012-08-14 15:41:03 -07:00
eglcurrent.c build: Use AX_PTHREAD's HAVE_PTHREAD preprocessor definition 2012-10-01 15:23:04 -07:00
eglcurrent.h egl/dri2: Add plumbing for EGL_OPENGL_ES3_BIT_KHR 2013-01-15 13:45:54 -08:00
egldefines.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
egldisplay.c Don't cast the return value of malloc/realloc 2012-09-05 22:28:50 -07:00
egldisplay.h egl: definitions for EXT_image_dma_buf_import 2013-08-02 08:56:03 +03:00
egldriver.c egl: add copyright notices 2011-07-02 18:21:31 +09:00
egldriver.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglfallbacks.c egl: remove #ifdef's for official extensions 2011-12-20 16:59:09 +08:00
eglglobals.c egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglglobals.h egl: add copyright notices 2011-07-02 18:21:31 +09: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 egl: Don't include strings.h on Windows. 2012-03-01 06:37:30 +00:00
egllog.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglmisc.c egl: definitions for EXT_image_dma_buf_import 2013-08-02 08:56:03 +03:00
eglmisc.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglmode.c Don't cast the return value of malloc/realloc 2012-09-05 22:28:50 -07:00
eglmode.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglmutex.h build: Use AX_PTHREAD's HAVE_PTHREAD preprocessor definition 2012-10-01 15:23:04 -07:00
eglscreen.c Don't cast the return value of malloc/realloc 2012-09-05 22:28:50 -07:00
eglscreen.h egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglstring.c egl: add copyright notices 2011-07-02 18:21:31 +09:00
eglstring.h egl: Don't include strings.h on Windows. 2012-03-01 06:37:30 +00:00
eglsurface.c egl/dri2: Add plumbing for EGL_OPENGL_ES3_BIT_KHR 2013-01-15 13:45:54 -08:00
eglsurface.h egl: add EGL_NV_post_sub_buffer 2011-12-20 17:04:46 +08: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 egl: add copyright notices 2011-07-02 18:21:31 +09:00
Makefile.am egl/main: remove undefined X11_LIBS automake variable 2013-10-09 10:36:01 -04: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.