• Home
  • History
  • Annotate
  • only in /external/mesa3d/src/egl/main/
NameDateSize

..20-Dec-20164 KiB

.gitignore20-Dec-20169

Android.mk20-Dec-20164 KiB

egl.def20-Dec-2016687

egl.pc.in20-Dec-2016275

eglapi.c20-Dec-201642.8 KiB

eglapi.h20-Dec-201610.3 KiB

eglarray.c20-Dec-20164.7 KiB

eglarray.h20-Dec-20162.3 KiB

eglcompiler.h20-Dec-20163.8 KiB

eglconfig.c20-Dec-201625.3 KiB

eglconfig.h20-Dec-20167.2 KiB

eglcontext.c20-Dec-201617.8 KiB

eglcontext.h20-Dec-20164.1 KiB

eglcurrent.c20-Dec-20168 KiB

eglcurrent.h20-Dec-20162.8 KiB

egldefines.h20-Dec-20161.6 KiB

egldisplay.c20-Dec-201610.6 KiB

egldisplay.h20-Dec-20166 KiB

egldriver.c20-Dec-201615.2 KiB

egldriver.h20-Dec-20163.6 KiB

eglfallbacks.c20-Dec-20164.4 KiB

eglglobals.c20-Dec-20162.5 KiB

eglglobals.h20-Dec-20161.8 KiB

eglimage.c20-Dec-20163.3 KiB

eglimage.h20-Dec-20163.7 KiB

egllog.c20-Dec-20165 KiB

egllog.h20-Dec-20161.9 KiB

eglmisc.c20-Dec-20164.9 KiB

eglmisc.h20-Dec-20161.6 KiB

eglmode.c20-Dec-20169.6 KiB

eglmode.h20-Dec-20162.7 KiB

eglmutex.h20-Dec-20162.3 KiB

eglscreen.c20-Dec-20165.9 KiB

eglscreen.h20-Dec-20163.5 KiB

eglstring.c20-Dec-20161.7 KiB

eglstring.h20-Dec-20161.8 KiB

eglsurface.c20-Dec-201613.8 KiB

eglsurface.h20-Dec-20164.6 KiB

eglsync.c20-Dec-20163.3 KiB

eglsync.h20-Dec-20163.3 KiB

egltypedefs.h20-Dec-20162.2 KiB

Makefile.am20-Dec-20163.7 KiB

README.txt20-Dec-20162 KiB

SConscript20-Dec-20161 KiB

README.txt

1
2
3Notes about the EGL library:
4
5
6The EGL code here basically consists of two things:
7
81. An EGL API dispatcher.  This directly routes all the eglFooBar() API
9   calls into driver-specific functions.
10
112. Fallbacks for EGL API functions.  A driver _could_ implement all the
12   EGL API calls from scratch.  But in many cases, the fallbacks provided
13   in libEGL (such as eglChooseConfig()) will do the job.
14
15
16
17Bootstrapping:
18
19When the apps calls eglOpenDisplay() a device driver is selected and loaded
20(look for dlsym() or LoadLibrary() in egldriver.c).
21
22The driver's _eglMain() function is then called.  This driver function
23allocates, initializes and returns a new _EGLDriver object (usually a
24subclass of that type).
25
26As part of initialization, the dispatch table in _EGLDriver->API must be
27populated with all the EGL entrypoints.  Typically, _eglInitDriverFallbacks()
28can be used to plug in default/fallback functions.  Some functions like
29driver->API.Initialize and driver->API.Terminate _must_ be implemented
30with driver-specific code (no default/fallback function is possible).
31
32
33A bit later, the app will call eglInitialize().  This will get routed
34to the driver->API.Initialize() function.  Any additional driver
35initialization that wasn't done in _eglMain() should be done at this
36point.  Typically, this will involve setting up visual configs, etc.
37
38
39
40Special Functions:
41
42Certain EGL functions _must_ be implemented by the driver.  This includes:
43
44eglCreateContext
45eglCreateWindowSurface
46eglCreatePixmapSurface
47eglCreatePBufferSurface
48eglMakeCurrent
49eglSwapBuffers
50
51Most of the EGLConfig-related functions can be implemented with the
52defaults/fallbacks.  Same thing for the eglGet/Query functions.
53
54
55
56
57Teardown:
58
59When eglTerminate() is called, the driver->API.Terminate() function is
60called.  The driver should clean up after itself.  eglTerminate() will
61then close/unload the driver (shared library).
62
63
64
65
66Subclassing:
67
68The internal libEGL data structures such as _EGLDisplay, _EGLContext,
69_EGLSurface, etc should be considered base classes from which drivers
70will derive subclasses.
71
72