mirror of https://gitlab.freedesktop.org/mesa/mesa
18457cb263
EGL contexts and surfaces are resources of displays. They should be managed by displays. This commit adds a bunch of functions to egldisplay.c to help establish the links between contexts/surfaces and displays. How links are established is considered opaque outside display. Functions like _eglGetSurfaceHandle or _eglLookupSurface are therefore moved to egldisplay.c, with some small modifications. The idea is also extended to display. That is, displays need to link to themselves to be looked up. This commit only adds the functions. A commit to use them should follow. Signed-off-by: Chia-I Wu <olvaffe@gmail.com> |
||
---|---|---|
.. | ||
Makefile | ||
README.txt | ||
eglapi.c | ||
eglapi.h | ||
eglcompiler.h | ||
eglconfig.c | ||
eglconfig.h | ||
eglconfigutil.c | ||
eglconfigutil.h | ||
eglcontext.c | ||
eglcontext.h | ||
egldefines.h | ||
egldisplay.c | ||
egldisplay.h | ||
egldriver.c | ||
egldriver.h | ||
eglglobals.c | ||
eglglobals.h | ||
eglhash.c | ||
eglhash.h | ||
egllog.c | ||
egllog.h | ||
eglmisc.c | ||
eglmisc.h | ||
eglmode.c | ||
eglmode.h | ||
eglscreen.c | ||
eglscreen.h | ||
eglstring.c | ||
eglstring.h | ||
eglsurface.c | ||
eglsurface.h | ||
egltypedefs.h | ||
eglx.c | ||
eglx.h |
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 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.