2 ** Copyright 2007, The Android Open Source Project
4 ** Licensed under the Apache License, Version 2.0 (the "License");
5 ** you may not use this file except in compliance with the License.
6 ** You may obtain a copy of the License at
8 ** http://www.apache.org/licenses/LICENSE-2.0
10 ** Unless required by applicable law or agreed to in writing, software
11 ** distributed under the License is distributed on an "AS IS" BASIS,
12 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 ** See the License for the specific language governing permissions and
14 ** limitations under the License.
17 #define ATRACE_TAG ATRACE_TAG_GRAPHICS
24 #include <hardware/gralloc.h>
25 #include <system/window.h>
28 #include <EGL/eglext.h>
30 #include <cutils/log.h>
31 #include <cutils/atomic.h>
32 #include <cutils/compiler.h>
33 #include <cutils/properties.h>
34 #include <cutils/memory.h>
36 #include <utils/KeyedVector.h>
37 #include <utils/SortedVector.h>
38 #include <utils/String8.h>
39 #include <utils/Trace.h>
41 #include "../egl_impl.h"
42 #include "../glestrace.h"
45 #include "egl_display.h"
46 #include "egl_object.h"
50 using namespace android;
52 // ----------------------------------------------------------------------------
56 struct extention_map_t {
58 __eglMustCastToProperFunctionPointerType address;
62 * This is the list of EGL extensions exposed to applications.
64 * Some of them (gBuiltinExtensionString) are implemented entirely in this EGL
65 * wrapper and are always available.
67 * The rest (gExtensionString) depend on support in the EGL driver, and are
68 * only available if the driver supports them. However, some of these must be
69 * supported because they are used by the Android system itself; these are
70 * listd as mandatory below and are required by the CDD. The system *assumes*
71 * the mandatory extensions are present and may not function properly if some
74 * NOTE: Both strings MUST have a single space as the last character.
76 extern char const * const gBuiltinExtensionString =
77 "EGL_KHR_get_all_proc_addresses "
78 "EGL_ANDROID_presentation_time "
80 extern char const * const gExtensionString =
81 "EGL_KHR_image " // mandatory
82 "EGL_KHR_image_base " // mandatory
83 "EGL_KHR_image_pixmap "
84 "EGL_KHR_lock_surface "
85 "EGL_KHR_gl_texture_2D_image "
86 "EGL_KHR_gl_texture_cubemap_image "
87 "EGL_KHR_gl_renderbuffer_image "
88 "EGL_KHR_reusable_sync "
90 "EGL_KHR_create_context "
91 "EGL_EXT_create_context_robustness "
93 "EGL_ANDROID_image_native_buffer " // mandatory
94 "EGL_KHR_wait_sync " // strongly recommended
97 // extensions not exposed to applications but used by the ANDROID system
98 // "EGL_ANDROID_blob_cache " // strongly recommended
99 // "EGL_IMG_hibernate_process " // optional
100 // "EGL_ANDROID_native_fence_sync " // strongly recommended
101 // "EGL_ANDROID_framebuffer_target " // mandatory for HWC 1.1
102 // "EGL_ANDROID_recordable " // mandatory
106 * EGL Extensions entry-points exposed to 3rd party applications
107 * (keep in sync with gExtensionString above)
110 static const extention_map_t sExtensionMap[] = {
111 // EGL_KHR_lock_surface
112 { "eglLockSurfaceKHR",
113 (__eglMustCastToProperFunctionPointerType)&eglLockSurfaceKHR },
114 { "eglUnlockSurfaceKHR",
115 (__eglMustCastToProperFunctionPointerType)&eglUnlockSurfaceKHR },
117 // EGL_KHR_image, EGL_KHR_image_base
118 { "eglCreateImageKHR",
119 (__eglMustCastToProperFunctionPointerType)&eglCreateImageKHR },
120 { "eglDestroyImageKHR",
121 (__eglMustCastToProperFunctionPointerType)&eglDestroyImageKHR },
123 // EGL_KHR_reusable_sync, EGL_KHR_fence_sync
124 { "eglCreateSyncKHR",
125 (__eglMustCastToProperFunctionPointerType)&eglCreateSyncKHR },
126 { "eglDestroySyncKHR",
127 (__eglMustCastToProperFunctionPointerType)&eglDestroySyncKHR },
128 { "eglClientWaitSyncKHR",
129 (__eglMustCastToProperFunctionPointerType)&eglClientWaitSyncKHR },
130 { "eglSignalSyncKHR",
131 (__eglMustCastToProperFunctionPointerType)&eglSignalSyncKHR },
132 { "eglGetSyncAttribKHR",
133 (__eglMustCastToProperFunctionPointerType)&eglGetSyncAttribKHR },
135 // EGL_NV_system_time
136 { "eglGetSystemTimeFrequencyNV",
137 (__eglMustCastToProperFunctionPointerType)&eglGetSystemTimeFrequencyNV },
138 { "eglGetSystemTimeNV",
139 (__eglMustCastToProperFunctionPointerType)&eglGetSystemTimeNV },
143 (__eglMustCastToProperFunctionPointerType)&eglWaitSyncKHR },
145 // EGL_ANDROID_presentation_time
146 { "eglPresentationTimeANDROID",
147 (__eglMustCastToProperFunctionPointerType)&eglPresentationTimeANDROID },
151 * These extensions entry-points should not be exposed to applications.
152 * They're used internally by the Android EGL layer.
154 #define FILTER_EXTENSIONS(procname) \
155 (!strcmp((procname), "eglSetBlobCacheFuncsANDROID") || \
156 !strcmp((procname), "eglHibernateProcessIMG") || \
157 !strcmp((procname), "eglAwakenProcessIMG") || \
158 !strcmp((procname), "eglDupNativeFenceFDANDROID"))
162 // accesses protected by sExtensionMapMutex
163 static DefaultKeyedVector<String8, __eglMustCastToProperFunctionPointerType> sGLExtentionMap;
164 static int sGLExtentionSlot = 0;
165 static pthread_mutex_t sExtensionMapMutex = PTHREAD_MUTEX_INITIALIZER;
167 static void(*findProcAddress(const char* name,
168 const extention_map_t* map, size_t n))() {
169 for (uint32_t i=0 ; i<n ; i++) {
170 if (!strcmp(name, map[i].name)) {
171 return map[i].address;
177 // ----------------------------------------------------------------------------
179 extern void setGLHooksThreadSpecific(gl_hooks_t const *value);
180 extern EGLBoolean egl_init_drivers();
181 extern const __eglMustCastToProperFunctionPointerType gExtensionForwarders[MAX_NUMBER_OF_GL_EXTENSIONS];
182 extern int getEGLDebugLevel();
183 extern void setEGLDebugLevel(int level);
184 extern gl_hooks_t gHooksTrace;
186 } // namespace android;
189 // ----------------------------------------------------------------------------
191 static inline void clearError() { egl_tls_t::clearError(); }
192 static inline EGLContext getContext() { return egl_tls_t::getContext(); }
194 // ----------------------------------------------------------------------------
196 EGLDisplay eglGetDisplay(EGLNativeDisplayType display)
200 uint32_t index = uint32_t(display);
201 if (index >= NUM_DISPLAYS) {
202 return setError(EGL_BAD_PARAMETER, EGL_NO_DISPLAY);
205 if (egl_init_drivers() == EGL_FALSE) {
206 return setError(EGL_BAD_PARAMETER, EGL_NO_DISPLAY);
209 EGLDisplay dpy = egl_display_t::getFromNativeDisplay(display);
213 // ----------------------------------------------------------------------------
215 // ----------------------------------------------------------------------------
217 EGLBoolean eglInitialize(EGLDisplay dpy, EGLint *major, EGLint *minor)
221 egl_display_ptr dp = get_display(dpy);
222 if (!dp) return setError(EGL_BAD_DISPLAY, EGL_FALSE);
224 EGLBoolean res = dp->initialize(major, minor);
229 EGLBoolean eglTerminate(EGLDisplay dpy)
231 // NOTE: don't unload the drivers b/c some APIs can be called
232 // after eglTerminate() has been called. eglTerminate() only
233 // terminates an EGLDisplay, not a EGL itself.
237 egl_display_ptr dp = get_display(dpy);
238 if (!dp) return setError(EGL_BAD_DISPLAY, EGL_FALSE);
240 EGLBoolean res = dp->terminate();
245 // ----------------------------------------------------------------------------
247 // ----------------------------------------------------------------------------
249 EGLBoolean eglGetConfigs( EGLDisplay dpy,
251 EGLint config_size, EGLint *num_config)
255 const egl_display_ptr dp = validate_display(dpy);
256 if (!dp) return EGL_FALSE;
259 return setError(EGL_BAD_PARAMETER, EGL_FALSE);
262 EGLBoolean res = EGL_FALSE;
265 egl_connection_t* const cnx = &gEGLImpl;
267 res = cnx->egl.eglGetConfigs(
268 dp->disp.dpy, configs, config_size, num_config);
274 EGLBoolean eglChooseConfig( EGLDisplay dpy, const EGLint *attrib_list,
275 EGLConfig *configs, EGLint config_size,
280 const egl_display_ptr dp = validate_display(dpy);
281 if (!dp) return EGL_FALSE;
284 return setError(EGL_BAD_PARAMETER, EGL_FALSE);
287 EGLBoolean res = EGL_FALSE;
290 egl_connection_t* const cnx = &gEGLImpl;
293 char value[PROPERTY_VALUE_MAX];
294 property_get("debug.egl.force_msaa", value, "false");
296 if (!strcmp(value, "true")) {
297 size_t attribCount = 0;
298 EGLint attrib = attrib_list[0];
300 // Only enable MSAA if the context is OpenGL ES 2.0 and
301 // if no caveat is requested
302 const EGLint *attribRendererable = NULL;
303 const EGLint *attribCaveat = NULL;
305 // Count the number of attributes and look for
306 // EGL_RENDERABLE_TYPE and EGL_CONFIG_CAVEAT
307 while (attrib != EGL_NONE) {
308 attrib = attrib_list[attribCount];
310 case EGL_RENDERABLE_TYPE:
311 attribRendererable = &attrib_list[attribCount];
313 case EGL_CONFIG_CAVEAT:
314 attribCaveat = &attrib_list[attribCount];
320 if (attribRendererable && attribRendererable[1] == EGL_OPENGL_ES2_BIT &&
321 (!attribCaveat || attribCaveat[1] != EGL_NONE)) {
323 // Insert 2 extra attributes to force-enable MSAA 4x
324 EGLint aaAttribs[attribCount + 4];
325 aaAttribs[0] = EGL_SAMPLE_BUFFERS;
327 aaAttribs[2] = EGL_SAMPLES;
330 memcpy(&aaAttribs[4], attrib_list, attribCount * sizeof(EGLint));
333 EGLBoolean resAA = cnx->egl.eglChooseConfig(
334 dp->disp.dpy, aaAttribs, configs, config_size, &numConfigAA);
336 if (resAA == EGL_TRUE && numConfigAA > 0) {
337 ALOGD("Enabling MSAA 4x");
338 *num_config = numConfigAA;
345 res = cnx->egl.eglChooseConfig(
346 dp->disp.dpy, attrib_list, configs, config_size, num_config);
351 EGLBoolean eglGetConfigAttrib(EGLDisplay dpy, EGLConfig config,
352 EGLint attribute, EGLint *value)
356 egl_connection_t* cnx = NULL;
357 const egl_display_ptr dp = validate_display_connection(dpy, cnx);
358 if (!dp) return EGL_FALSE;
360 return cnx->egl.eglGetConfigAttrib(
361 dp->disp.dpy, config, attribute, value);
364 // ----------------------------------------------------------------------------
366 // ----------------------------------------------------------------------------
368 EGLSurface eglCreateWindowSurface( EGLDisplay dpy, EGLConfig config,
369 NativeWindowType window,
370 const EGLint *attrib_list)
374 egl_connection_t* cnx = NULL;
375 egl_display_ptr dp = validate_display_connection(dpy, cnx);
377 EGLDisplay iDpy = dp->disp.dpy;
380 if (native_window_api_connect(window, NATIVE_WINDOW_API_EGL) != OK) {
381 ALOGE("EGLNativeWindowType %p already connected to another API",
383 return setError(EGL_BAD_ALLOC, EGL_NO_SURFACE);
386 // set the native window's buffers format to match this config
387 if (cnx->egl.eglGetConfigAttrib(iDpy,
388 config, EGL_NATIVE_VISUAL_ID, &format)) {
390 int err = native_window_set_buffers_format(window, format);
392 ALOGE("error setting native window pixel format: %s (%d)",
393 strerror(-err), err);
394 native_window_api_disconnect(window, NATIVE_WINDOW_API_EGL);
395 return setError(EGL_BAD_NATIVE_WINDOW, EGL_NO_SURFACE);
400 // the EGL spec requires that a new EGLSurface default to swap interval
401 // 1, so explicitly set that on the window here.
402 ANativeWindow* anw = reinterpret_cast<ANativeWindow*>(window);
403 anw->setSwapInterval(anw, 1);
405 EGLSurface surface = cnx->egl.eglCreateWindowSurface(
406 iDpy, config, window, attrib_list);
407 if (surface != EGL_NO_SURFACE) {
408 egl_surface_t* s = new egl_surface_t(dp.get(), config, window,
413 // EGLSurface creation failed
414 native_window_set_buffers_format(window, 0);
415 native_window_api_disconnect(window, NATIVE_WINDOW_API_EGL);
417 return EGL_NO_SURFACE;
420 EGLSurface eglCreatePixmapSurface( EGLDisplay dpy, EGLConfig config,
421 NativePixmapType pixmap,
422 const EGLint *attrib_list)
426 egl_connection_t* cnx = NULL;
427 egl_display_ptr dp = validate_display_connection(dpy, cnx);
429 EGLSurface surface = cnx->egl.eglCreatePixmapSurface(
430 dp->disp.dpy, config, pixmap, attrib_list);
431 if (surface != EGL_NO_SURFACE) {
432 egl_surface_t* s = new egl_surface_t(dp.get(), config, NULL,
437 return EGL_NO_SURFACE;
440 EGLSurface eglCreatePbufferSurface( EGLDisplay dpy, EGLConfig config,
441 const EGLint *attrib_list)
445 egl_connection_t* cnx = NULL;
446 egl_display_ptr dp = validate_display_connection(dpy, cnx);
448 EGLSurface surface = cnx->egl.eglCreatePbufferSurface(
449 dp->disp.dpy, config, attrib_list);
450 if (surface != EGL_NO_SURFACE) {
451 egl_surface_t* s = new egl_surface_t(dp.get(), config, NULL,
456 return EGL_NO_SURFACE;
459 EGLBoolean eglDestroySurface(EGLDisplay dpy, EGLSurface surface)
463 const egl_display_ptr dp = validate_display(dpy);
464 if (!dp) return EGL_FALSE;
466 SurfaceRef _s(dp.get(), surface);
468 return setError(EGL_BAD_SURFACE, EGL_FALSE);
470 egl_surface_t * const s = get_surface(surface);
471 EGLBoolean result = s->cnx->egl.eglDestroySurface(dp->disp.dpy, s->surface);
472 if (result == EGL_TRUE) {
478 EGLBoolean eglQuerySurface( EGLDisplay dpy, EGLSurface surface,
479 EGLint attribute, EGLint *value)
483 const egl_display_ptr dp = validate_display(dpy);
484 if (!dp) return EGL_FALSE;
486 SurfaceRef _s(dp.get(), surface);
488 return setError(EGL_BAD_SURFACE, EGL_FALSE);
490 egl_surface_t const * const s = get_surface(surface);
491 return s->cnx->egl.eglQuerySurface(
492 dp->disp.dpy, s->surface, attribute, value);
495 void EGLAPI eglBeginFrame(EGLDisplay dpy, EGLSurface surface) {
499 const egl_display_ptr dp = validate_display(dpy);
504 SurfaceRef _s(dp.get(), surface);
506 setError(EGL_BAD_SURFACE, EGL_FALSE);
511 // ----------------------------------------------------------------------------
513 // ----------------------------------------------------------------------------
515 EGLContext eglCreateContext(EGLDisplay dpy, EGLConfig config,
516 EGLContext share_list, const EGLint *attrib_list)
520 egl_connection_t* cnx = NULL;
521 const egl_display_ptr dp = validate_display_connection(dpy, cnx);
523 if (share_list != EGL_NO_CONTEXT) {
524 if (!ContextRef(dp.get(), share_list).get()) {
525 return setError(EGL_BAD_CONTEXT, EGL_NO_CONTEXT);
527 egl_context_t* const c = get_context(share_list);
528 share_list = c->context;
530 EGLContext context = cnx->egl.eglCreateContext(
531 dp->disp.dpy, config, share_list, attrib_list);
532 if (context != EGL_NO_CONTEXT) {
533 // figure out if it's a GLESv1 or GLESv2
536 while (*attrib_list != EGL_NONE) {
537 GLint attr = *attrib_list++;
538 GLint value = *attrib_list++;
539 if (attr == EGL_CONTEXT_CLIENT_VERSION) {
541 version = egl_connection_t::GLESv1_INDEX;
542 } else if (value == 2 || value == 3) {
543 version = egl_connection_t::GLESv2_INDEX;
548 egl_context_t* c = new egl_context_t(dpy, context, config, cnx,
551 if (getEGLDebugLevel() > 0)
552 GLTrace_eglCreateContext(version, c);
557 return EGL_NO_CONTEXT;
560 EGLBoolean eglDestroyContext(EGLDisplay dpy, EGLContext ctx)
564 const egl_display_ptr dp = validate_display(dpy);
568 ContextRef _c(dp.get(), ctx);
570 return setError(EGL_BAD_CONTEXT, EGL_FALSE);
572 egl_context_t * const c = get_context(ctx);
573 EGLBoolean result = c->cnx->egl.eglDestroyContext(dp->disp.dpy, c->context);
574 if (result == EGL_TRUE) {
580 EGLBoolean eglMakeCurrent( EGLDisplay dpy, EGLSurface draw,
581 EGLSurface read, EGLContext ctx)
585 egl_display_ptr dp = validate_display(dpy);
586 if (!dp) return setError(EGL_BAD_DISPLAY, EGL_FALSE);
588 // If ctx is not EGL_NO_CONTEXT, read is not EGL_NO_SURFACE, or draw is not
589 // EGL_NO_SURFACE, then an EGL_NOT_INITIALIZED error is generated if dpy is
590 // a valid but uninitialized display.
591 if ( (ctx != EGL_NO_CONTEXT) || (read != EGL_NO_SURFACE) ||
592 (draw != EGL_NO_SURFACE) ) {
593 if (!dp->isReady()) return setError(EGL_NOT_INITIALIZED, EGL_FALSE);
596 // get a reference to the object passed in
597 ContextRef _c(dp.get(), ctx);
598 SurfaceRef _d(dp.get(), draw);
599 SurfaceRef _r(dp.get(), read);
601 // validate the context (if not EGL_NO_CONTEXT)
602 if ((ctx != EGL_NO_CONTEXT) && !_c.get()) {
603 // EGL_NO_CONTEXT is valid
604 return setError(EGL_BAD_CONTEXT, EGL_FALSE);
607 // these are the underlying implementation's object
608 EGLContext impl_ctx = EGL_NO_CONTEXT;
609 EGLSurface impl_draw = EGL_NO_SURFACE;
610 EGLSurface impl_read = EGL_NO_SURFACE;
612 // these are our objects structs passed in
613 egl_context_t * c = NULL;
614 egl_surface_t const * d = NULL;
615 egl_surface_t const * r = NULL;
617 // these are the current objects structs
618 egl_context_t * cur_c = get_context(getContext());
620 if (ctx != EGL_NO_CONTEXT) {
621 c = get_context(ctx);
622 impl_ctx = c->context;
624 // no context given, use the implementation of the current context
625 if (draw != EGL_NO_SURFACE || read != EGL_NO_SURFACE) {
626 // calling eglMakeCurrent( ..., !=0, !=0, EGL_NO_CONTEXT);
627 return setError(EGL_BAD_MATCH, EGL_FALSE);
630 // no current context
631 // not an error, there is just no current context.
636 // retrieve the underlying implementation's draw EGLSurface
637 if (draw != EGL_NO_SURFACE) {
638 if (!_d.get()) return setError(EGL_BAD_SURFACE, EGL_FALSE);
639 d = get_surface(draw);
640 impl_draw = d->surface;
643 // retrieve the underlying implementation's read EGLSurface
644 if (read != EGL_NO_SURFACE) {
645 if (!_r.get()) return setError(EGL_BAD_SURFACE, EGL_FALSE);
646 r = get_surface(read);
647 impl_read = r->surface;
651 EGLBoolean result = dp->makeCurrent(c, cur_c,
653 impl_draw, impl_read, impl_ctx);
655 if (result == EGL_TRUE) {
657 setGLHooksThreadSpecific(c->cnx->hooks[c->version]);
658 egl_tls_t::setContext(ctx);
660 if (getEGLDebugLevel() > 0)
661 GLTrace_eglMakeCurrent(c->version, c->cnx->hooks[c->version], ctx);
667 setGLHooksThreadSpecific(&gHooksNoContext);
668 egl_tls_t::setContext(EGL_NO_CONTEXT);
671 // this will ALOGE the error
672 result = setError(c->cnx->egl.eglGetError(), EGL_FALSE);
678 EGLBoolean eglQueryContext( EGLDisplay dpy, EGLContext ctx,
679 EGLint attribute, EGLint *value)
683 const egl_display_ptr dp = validate_display(dpy);
684 if (!dp) return EGL_FALSE;
686 ContextRef _c(dp.get(), ctx);
687 if (!_c.get()) return setError(EGL_BAD_CONTEXT, EGL_FALSE);
689 egl_context_t * const c = get_context(ctx);
690 return c->cnx->egl.eglQueryContext(
691 dp->disp.dpy, c->context, attribute, value);
695 EGLContext eglGetCurrentContext(void)
697 // could be called before eglInitialize(), but we wouldn't have a context
698 // then, and this function would correctly return EGL_NO_CONTEXT.
702 EGLContext ctx = getContext();
706 EGLSurface eglGetCurrentSurface(EGLint readdraw)
708 // could be called before eglInitialize(), but we wouldn't have a context
709 // then, and this function would correctly return EGL_NO_SURFACE.
713 EGLContext ctx = getContext();
715 egl_context_t const * const c = get_context(ctx);
716 if (!c) return setError(EGL_BAD_CONTEXT, EGL_NO_SURFACE);
718 case EGL_READ: return c->read;
719 case EGL_DRAW: return c->draw;
720 default: return setError(EGL_BAD_PARAMETER, EGL_NO_SURFACE);
723 return EGL_NO_SURFACE;
726 EGLDisplay eglGetCurrentDisplay(void)
728 // could be called before eglInitialize(), but we wouldn't have a context
729 // then, and this function would correctly return EGL_NO_DISPLAY.
733 EGLContext ctx = getContext();
735 egl_context_t const * const c = get_context(ctx);
736 if (!c) return setError(EGL_BAD_CONTEXT, EGL_NO_SURFACE);
739 return EGL_NO_DISPLAY;
742 EGLBoolean eglWaitGL(void)
746 egl_connection_t* const cnx = &gEGLImpl;
748 return setError(EGL_BAD_CONTEXT, EGL_FALSE);
750 return cnx->egl.eglWaitGL();
753 EGLBoolean eglWaitNative(EGLint engine)
757 egl_connection_t* const cnx = &gEGLImpl;
759 return setError(EGL_BAD_CONTEXT, EGL_FALSE);
761 return cnx->egl.eglWaitNative(engine);
764 EGLint eglGetError(void)
766 EGLint err = EGL_SUCCESS;
767 egl_connection_t* const cnx = &gEGLImpl;
769 err = cnx->egl.eglGetError();
771 if (err == EGL_SUCCESS) {
772 err = egl_tls_t::getError();
777 static __eglMustCastToProperFunctionPointerType findBuiltinGLWrapper(
778 const char* procname) {
779 const egl_connection_t* cnx = &gEGLImpl;
782 proc = dlsym(cnx->libGles2, procname);
783 if (proc) return (__eglMustCastToProperFunctionPointerType)proc;
785 proc = dlsym(cnx->libGles1, procname);
786 if (proc) return (__eglMustCastToProperFunctionPointerType)proc;
791 __eglMustCastToProperFunctionPointerType eglGetProcAddress(const char *procname)
793 // eglGetProcAddress() could be the very first function called
794 // in which case we must make sure we've initialized ourselves, this
795 // happens the first time egl_get_display() is called.
799 if (egl_init_drivers() == EGL_FALSE) {
800 setError(EGL_BAD_PARAMETER, NULL);
804 if (FILTER_EXTENSIONS(procname)) {
808 __eglMustCastToProperFunctionPointerType addr;
809 addr = findProcAddress(procname, sExtensionMap, NELEM(sExtensionMap));
810 if (addr) return addr;
812 addr = findBuiltinGLWrapper(procname);
813 if (addr) return addr;
815 // this protects accesses to sGLExtentionMap and sGLExtentionSlot
816 pthread_mutex_lock(&sExtensionMapMutex);
819 * Since eglGetProcAddress() is not associated to anything, it needs
820 * to return a function pointer that "works" regardless of what
821 * the current context is.
823 * For this reason, we return a "forwarder", a small stub that takes
824 * care of calling the function associated with the context
827 * We first look for extensions we've already resolved, if we're seeing
828 * this extension for the first time, we go through all our
829 * implementations and call eglGetProcAddress() and record the
830 * result in the appropriate implementation hooks and return the
831 * address of the forwarder corresponding to that hook set.
835 const String8 name(procname);
836 addr = sGLExtentionMap.valueFor(name);
837 const int slot = sGLExtentionSlot;
839 ALOGE_IF(slot >= MAX_NUMBER_OF_GL_EXTENSIONS,
840 "no more slots for eglGetProcAddress(\"%s\")",
844 gl_hooks_t *debugHooks = GLTrace_getGLHooks();
847 if (!addr && (slot < MAX_NUMBER_OF_GL_EXTENSIONS)) {
850 egl_connection_t* const cnx = &gEGLImpl;
851 if (cnx->dso && cnx->egl.eglGetProcAddress) {
852 // Extensions are independent of the bound context
854 cnx->hooks[egl_connection_t::GLESv1_INDEX]->ext.extensions[slot] =
855 cnx->hooks[egl_connection_t::GLESv2_INDEX]->ext.extensions[slot] =
857 debugHooks->ext.extensions[slot] =
858 gHooksTrace.ext.extensions[slot] =
860 cnx->egl.eglGetProcAddress(procname);
861 if (addr) found = true;
865 addr = gExtensionForwarders[slot];
866 sGLExtentionMap.add(name, addr);
871 pthread_mutex_unlock(&sExtensionMapMutex);
875 class FrameCompletionThread : public Thread {
878 static void queueSync(EGLSyncKHR sync) {
879 static sp<FrameCompletionThread> thread(new FrameCompletionThread);
880 static bool running = false;
882 thread->run("GPUFrameCompletion");
886 Mutex::Autolock lock(thread->mMutex);
887 ScopedTrace st(ATRACE_TAG, String8::format("kicked off frame %d",
888 thread->mFramesQueued).string());
889 thread->mQueue.push_back(sync);
890 thread->mCondition.signal();
891 thread->mFramesQueued++;
892 ATRACE_INT("GPU Frames Outstanding", thread->mQueue.size());
897 FrameCompletionThread() : mFramesQueued(0), mFramesCompleted(0) {}
899 virtual bool threadLoop() {
903 Mutex::Autolock lock(mMutex);
904 while (mQueue.isEmpty()) {
905 mCondition.wait(mMutex);
908 frameNum = mFramesCompleted;
910 EGLDisplay dpy = eglGetDisplay(EGL_DEFAULT_DISPLAY);
912 ScopedTrace st(ATRACE_TAG, String8::format("waiting for frame %d",
914 EGLint result = eglClientWaitSyncKHR(dpy, sync, 0, EGL_FOREVER_KHR);
915 if (result == EGL_FALSE) {
916 ALOGE("FrameCompletion: error waiting for fence: %#x", eglGetError());
917 } else if (result == EGL_TIMEOUT_EXPIRED_KHR) {
918 ALOGE("FrameCompletion: timeout waiting for fence");
920 eglDestroySyncKHR(dpy, sync);
923 Mutex::Autolock lock(mMutex);
926 ATRACE_INT("GPU Frames Outstanding", mQueue.size());
931 uint32_t mFramesQueued;
932 uint32_t mFramesCompleted;
933 Vector<EGLSyncKHR> mQueue;
934 Condition mCondition;
938 EGLBoolean eglSwapBuffers(EGLDisplay dpy, EGLSurface draw)
943 const egl_display_ptr dp = validate_display(dpy);
944 if (!dp) return EGL_FALSE;
946 SurfaceRef _s(dp.get(), draw);
948 return setError(EGL_BAD_SURFACE, EGL_FALSE);
951 gl_hooks_t const *trace_hooks = getGLTraceThreadSpecific();
952 if (getEGLDebugLevel() > 0) {
953 if (trace_hooks == NULL) {
954 if (GLTrace_start() < 0) {
955 ALOGE("Disabling Tracer for OpenGL ES");
958 // switch over to the trace version of hooks
959 EGLContext ctx = egl_tls_t::getContext();
960 egl_context_t * const c = get_context(ctx);
962 setGLHooksThreadSpecific(c->cnx->hooks[c->version]);
963 GLTrace_eglMakeCurrent(c->version, c->cnx->hooks[c->version], ctx);
968 GLTrace_eglSwapBuffers(dpy, draw);
969 } else if (trace_hooks != NULL) {
970 // tracing is now disabled, so switch back to the non trace version
971 EGLContext ctx = egl_tls_t::getContext();
972 egl_context_t * const c = get_context(ctx);
973 if (c) setGLHooksThreadSpecific(c->cnx->hooks[c->version]);
978 egl_surface_t const * const s = get_surface(draw);
980 if (CC_UNLIKELY(dp->traceGpuCompletion)) {
981 EGLSyncKHR sync = eglCreateSyncKHR(dpy, EGL_SYNC_FENCE_KHR, NULL);
982 if (sync != EGL_NO_SYNC_KHR) {
983 FrameCompletionThread::queueSync(sync);
987 if (CC_UNLIKELY(dp->finishOnSwap)) {
989 egl_context_t * const c = get_context( egl_tls_t::getContext() );
991 // glReadPixels() ensures that the frame is complete
992 s->cnx->hooks[c->version]->gl.glReadPixels(0,0,1,1,
993 GL_RGBA,GL_UNSIGNED_BYTE,&pixel);
997 return s->cnx->egl.eglSwapBuffers(dp->disp.dpy, s->surface);
1000 EGLBoolean eglCopyBuffers( EGLDisplay dpy, EGLSurface surface,
1001 NativePixmapType target)
1005 const egl_display_ptr dp = validate_display(dpy);
1006 if (!dp) return EGL_FALSE;
1008 SurfaceRef _s(dp.get(), surface);
1010 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1012 egl_surface_t const * const s = get_surface(surface);
1013 return s->cnx->egl.eglCopyBuffers(dp->disp.dpy, s->surface, target);
1016 const char* eglQueryString(EGLDisplay dpy, EGLint name)
1020 const egl_display_ptr dp = validate_display(dpy);
1021 if (!dp) return (const char *) NULL;
1025 return dp->getVendorString();
1027 return dp->getVersionString();
1028 case EGL_EXTENSIONS:
1029 return dp->getExtensionString();
1030 case EGL_CLIENT_APIS:
1031 return dp->getClientApiString();
1033 return setError(EGL_BAD_PARAMETER, (const char *)0);
1036 EGLAPI const char* eglQueryStringImplementationANDROID(EGLDisplay dpy, EGLint name)
1040 const egl_display_ptr dp = validate_display(dpy);
1041 if (!dp) return (const char *) NULL;
1045 return dp->disp.queryString.vendor;
1047 return dp->disp.queryString.version;
1048 case EGL_EXTENSIONS:
1049 return dp->disp.queryString.extensions;
1050 case EGL_CLIENT_APIS:
1051 return dp->disp.queryString.clientApi;
1053 return setError(EGL_BAD_PARAMETER, (const char *)0);
1056 // ----------------------------------------------------------------------------
1058 // ----------------------------------------------------------------------------
1060 EGLBoolean eglSurfaceAttrib(
1061 EGLDisplay dpy, EGLSurface surface, EGLint attribute, EGLint value)
1065 const egl_display_ptr dp = validate_display(dpy);
1066 if (!dp) return EGL_FALSE;
1068 SurfaceRef _s(dp.get(), surface);
1070 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1072 egl_surface_t const * const s = get_surface(surface);
1073 if (s->cnx->egl.eglSurfaceAttrib) {
1074 return s->cnx->egl.eglSurfaceAttrib(
1075 dp->disp.dpy, s->surface, attribute, value);
1077 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1080 EGLBoolean eglBindTexImage(
1081 EGLDisplay dpy, EGLSurface surface, EGLint buffer)
1085 const egl_display_ptr dp = validate_display(dpy);
1086 if (!dp) return EGL_FALSE;
1088 SurfaceRef _s(dp.get(), surface);
1090 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1092 egl_surface_t const * const s = get_surface(surface);
1093 if (s->cnx->egl.eglBindTexImage) {
1094 return s->cnx->egl.eglBindTexImage(
1095 dp->disp.dpy, s->surface, buffer);
1097 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1100 EGLBoolean eglReleaseTexImage(
1101 EGLDisplay dpy, EGLSurface surface, EGLint buffer)
1105 const egl_display_ptr dp = validate_display(dpy);
1106 if (!dp) return EGL_FALSE;
1108 SurfaceRef _s(dp.get(), surface);
1110 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1112 egl_surface_t const * const s = get_surface(surface);
1113 if (s->cnx->egl.eglReleaseTexImage) {
1114 return s->cnx->egl.eglReleaseTexImage(
1115 dp->disp.dpy, s->surface, buffer);
1117 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1120 EGLBoolean eglSwapInterval(EGLDisplay dpy, EGLint interval)
1124 const egl_display_ptr dp = validate_display(dpy);
1125 if (!dp) return EGL_FALSE;
1127 EGLBoolean res = EGL_TRUE;
1128 egl_connection_t* const cnx = &gEGLImpl;
1129 if (cnx->dso && cnx->egl.eglSwapInterval) {
1130 res = cnx->egl.eglSwapInterval(dp->disp.dpy, interval);
1137 // ----------------------------------------------------------------------------
1139 // ----------------------------------------------------------------------------
1141 EGLBoolean eglWaitClient(void)
1145 egl_connection_t* const cnx = &gEGLImpl;
1147 return setError(EGL_BAD_CONTEXT, EGL_FALSE);
1150 if (cnx->egl.eglWaitClient) {
1151 res = cnx->egl.eglWaitClient();
1153 res = cnx->egl.eglWaitGL();
1158 EGLBoolean eglBindAPI(EGLenum api)
1162 if (egl_init_drivers() == EGL_FALSE) {
1163 return setError(EGL_BAD_PARAMETER, EGL_FALSE);
1166 // bind this API on all EGLs
1167 EGLBoolean res = EGL_TRUE;
1168 egl_connection_t* const cnx = &gEGLImpl;
1169 if (cnx->dso && cnx->egl.eglBindAPI) {
1170 res = cnx->egl.eglBindAPI(api);
1175 EGLenum eglQueryAPI(void)
1179 if (egl_init_drivers() == EGL_FALSE) {
1180 return setError(EGL_BAD_PARAMETER, EGL_FALSE);
1183 egl_connection_t* const cnx = &gEGLImpl;
1184 if (cnx->dso && cnx->egl.eglQueryAPI) {
1185 return cnx->egl.eglQueryAPI();
1188 // or, it can only be OpenGL ES
1189 return EGL_OPENGL_ES_API;
1192 EGLBoolean eglReleaseThread(void)
1197 if (getEGLDebugLevel() > 0)
1198 GLTrace_eglReleaseThread();
1201 // If there is context bound to the thread, release it
1202 egl_display_t::loseCurrent(get_context(getContext()));
1204 egl_connection_t* const cnx = &gEGLImpl;
1205 if (cnx->dso && cnx->egl.eglReleaseThread) {
1206 cnx->egl.eglReleaseThread();
1208 egl_tls_t::clearTLS();
1212 EGLSurface eglCreatePbufferFromClientBuffer(
1213 EGLDisplay dpy, EGLenum buftype, EGLClientBuffer buffer,
1214 EGLConfig config, const EGLint *attrib_list)
1218 egl_connection_t* cnx = NULL;
1219 const egl_display_ptr dp = validate_display_connection(dpy, cnx);
1220 if (!dp) return EGL_FALSE;
1221 if (cnx->egl.eglCreatePbufferFromClientBuffer) {
1222 return cnx->egl.eglCreatePbufferFromClientBuffer(
1223 dp->disp.dpy, buftype, buffer, config, attrib_list);
1225 return setError(EGL_BAD_CONFIG, EGL_NO_SURFACE);
1228 // ----------------------------------------------------------------------------
1229 // EGL_EGLEXT_VERSION 3
1230 // ----------------------------------------------------------------------------
1232 EGLBoolean eglLockSurfaceKHR(EGLDisplay dpy, EGLSurface surface,
1233 const EGLint *attrib_list)
1237 const egl_display_ptr dp = validate_display(dpy);
1238 if (!dp) return EGL_FALSE;
1240 SurfaceRef _s(dp.get(), surface);
1242 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1244 egl_surface_t const * const s = get_surface(surface);
1245 if (s->cnx->egl.eglLockSurfaceKHR) {
1246 return s->cnx->egl.eglLockSurfaceKHR(
1247 dp->disp.dpy, s->surface, attrib_list);
1249 return setError(EGL_BAD_DISPLAY, EGL_FALSE);
1252 EGLBoolean eglUnlockSurfaceKHR(EGLDisplay dpy, EGLSurface surface)
1256 const egl_display_ptr dp = validate_display(dpy);
1257 if (!dp) return EGL_FALSE;
1259 SurfaceRef _s(dp.get(), surface);
1261 return setError(EGL_BAD_SURFACE, EGL_FALSE);
1263 egl_surface_t const * const s = get_surface(surface);
1264 if (s->cnx->egl.eglUnlockSurfaceKHR) {
1265 return s->cnx->egl.eglUnlockSurfaceKHR(dp->disp.dpy, s->surface);
1267 return setError(EGL_BAD_DISPLAY, EGL_FALSE);
1270 EGLImageKHR eglCreateImageKHR(EGLDisplay dpy, EGLContext ctx, EGLenum target,
1271 EGLClientBuffer buffer, const EGLint *attrib_list)
1275 const egl_display_ptr dp = validate_display(dpy);
1276 if (!dp) return EGL_NO_IMAGE_KHR;
1278 ContextRef _c(dp.get(), ctx);
1279 egl_context_t * const c = _c.get();
1281 EGLImageKHR result = EGL_NO_IMAGE_KHR;
1282 egl_connection_t* const cnx = &gEGLImpl;
1283 if (cnx->dso && cnx->egl.eglCreateImageKHR) {
1284 result = cnx->egl.eglCreateImageKHR(
1286 c ? c->context : EGL_NO_CONTEXT,
1287 target, buffer, attrib_list);
1292 EGLBoolean eglDestroyImageKHR(EGLDisplay dpy, EGLImageKHR img)
1296 const egl_display_ptr dp = validate_display(dpy);
1297 if (!dp) return EGL_FALSE;
1299 EGLBoolean result = EGL_FALSE;
1300 egl_connection_t* const cnx = &gEGLImpl;
1301 if (cnx->dso && cnx->egl.eglDestroyImageKHR) {
1302 result = cnx->egl.eglDestroyImageKHR(dp->disp.dpy, img);
1307 // ----------------------------------------------------------------------------
1308 // EGL_EGLEXT_VERSION 5
1309 // ----------------------------------------------------------------------------
1312 EGLSyncKHR eglCreateSyncKHR(EGLDisplay dpy, EGLenum type, const EGLint *attrib_list)
1316 const egl_display_ptr dp = validate_display(dpy);
1317 if (!dp) return EGL_NO_SYNC_KHR;
1319 EGLSyncKHR result = EGL_NO_SYNC_KHR;
1320 egl_connection_t* const cnx = &gEGLImpl;
1321 if (cnx->dso && cnx->egl.eglCreateSyncKHR) {
1322 result = cnx->egl.eglCreateSyncKHR(dp->disp.dpy, type, attrib_list);
1327 EGLBoolean eglDestroySyncKHR(EGLDisplay dpy, EGLSyncKHR sync)
1331 const egl_display_ptr dp = validate_display(dpy);
1332 if (!dp) return EGL_FALSE;
1334 EGLBoolean result = EGL_FALSE;
1335 egl_connection_t* const cnx = &gEGLImpl;
1336 if (cnx->dso && cnx->egl.eglDestroySyncKHR) {
1337 result = cnx->egl.eglDestroySyncKHR(dp->disp.dpy, sync);
1342 EGLBoolean eglSignalSyncKHR(EGLDisplay dpy, EGLSyncKHR sync, EGLenum mode) {
1345 const egl_display_ptr dp = validate_display(dpy);
1346 if (!dp) return EGL_FALSE;
1348 EGLBoolean result = EGL_FALSE;
1349 egl_connection_t* const cnx = &gEGLImpl;
1350 if (cnx->dso && cnx->egl.eglSignalSyncKHR) {
1351 result = cnx->egl.eglSignalSyncKHR(
1352 dp->disp.dpy, sync, mode);
1357 EGLint eglClientWaitSyncKHR(EGLDisplay dpy, EGLSyncKHR sync,
1358 EGLint flags, EGLTimeKHR timeout)
1362 const egl_display_ptr dp = validate_display(dpy);
1363 if (!dp) return EGL_FALSE;
1365 EGLBoolean result = EGL_FALSE;
1366 egl_connection_t* const cnx = &gEGLImpl;
1367 if (cnx->dso && cnx->egl.eglClientWaitSyncKHR) {
1368 result = cnx->egl.eglClientWaitSyncKHR(
1369 dp->disp.dpy, sync, flags, timeout);
1374 EGLBoolean eglGetSyncAttribKHR(EGLDisplay dpy, EGLSyncKHR sync,
1375 EGLint attribute, EGLint *value)
1379 const egl_display_ptr dp = validate_display(dpy);
1380 if (!dp) return EGL_FALSE;
1382 EGLBoolean result = EGL_FALSE;
1383 egl_connection_t* const cnx = &gEGLImpl;
1384 if (cnx->dso && cnx->egl.eglGetSyncAttribKHR) {
1385 result = cnx->egl.eglGetSyncAttribKHR(
1386 dp->disp.dpy, sync, attribute, value);
1391 // ----------------------------------------------------------------------------
1392 // EGL_EGLEXT_VERSION 15
1393 // ----------------------------------------------------------------------------
1395 EGLint eglWaitSyncKHR(EGLDisplay dpy, EGLSyncKHR sync, EGLint flags) {
1397 const egl_display_ptr dp = validate_display(dpy);
1398 if (!dp) return EGL_FALSE;
1399 EGLint result = EGL_FALSE;
1400 egl_connection_t* const cnx = &gEGLImpl;
1401 if (cnx->dso && cnx->egl.eglWaitSyncKHR) {
1402 result = cnx->egl.eglWaitSyncKHR(dp->disp.dpy, sync, flags);
1407 // ----------------------------------------------------------------------------
1408 // ANDROID extensions
1409 // ----------------------------------------------------------------------------
1411 EGLint eglDupNativeFenceFDANDROID(EGLDisplay dpy, EGLSyncKHR sync)
1415 const egl_display_ptr dp = validate_display(dpy);
1416 if (!dp) return EGL_NO_NATIVE_FENCE_FD_ANDROID;
1418 EGLint result = EGL_NO_NATIVE_FENCE_FD_ANDROID;
1419 egl_connection_t* const cnx = &gEGLImpl;
1420 if (cnx->dso && cnx->egl.eglDupNativeFenceFDANDROID) {
1421 result = cnx->egl.eglDupNativeFenceFDANDROID(dp->disp.dpy, sync);
1426 EGLBoolean eglPresentationTimeANDROID(EGLDisplay dpy, EGLSurface surface,
1427 EGLnsecsANDROID time)
1431 const egl_display_ptr dp = validate_display(dpy);
1436 SurfaceRef _s(dp.get(), surface);
1438 setError(EGL_BAD_SURFACE, EGL_FALSE);
1442 egl_surface_t const * const s = get_surface(surface);
1443 native_window_set_buffers_timestamp(s->win.get(), time);
1448 // ----------------------------------------------------------------------------
1449 // NVIDIA extensions
1450 // ----------------------------------------------------------------------------
1451 EGLuint64NV eglGetSystemTimeFrequencyNV()
1455 if (egl_init_drivers() == EGL_FALSE) {
1456 return setError(EGL_BAD_PARAMETER, EGL_FALSE);
1459 EGLuint64NV ret = 0;
1460 egl_connection_t* const cnx = &gEGLImpl;
1462 if (cnx->dso && cnx->egl.eglGetSystemTimeFrequencyNV) {
1463 return cnx->egl.eglGetSystemTimeFrequencyNV();
1466 return setErrorQuiet(EGL_BAD_DISPLAY, 0);
1469 EGLuint64NV eglGetSystemTimeNV()
1473 if (egl_init_drivers() == EGL_FALSE) {
1474 return setError(EGL_BAD_PARAMETER, EGL_FALSE);
1477 EGLuint64NV ret = 0;
1478 egl_connection_t* const cnx = &gEGLImpl;
1480 if (cnx->dso && cnx->egl.eglGetSystemTimeNV) {
1481 return cnx->egl.eglGetSystemTimeNV();
1484 return setErrorQuiet(EGL_BAD_DISPLAY, 0);