egl: drop unused _EGLDriver & _EGLDisplay from WaitNative()
[mesa.git] / src / egl / main / eglapi.c
1 /**************************************************************************
2 *
3 * Copyright 2008 VMware, Inc.
4 * Copyright 2009-2010 Chia-I Wu <olvaffe@gmail.com>
5 * Copyright 2010-2011 LunarG, Inc.
6 * All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the
10 * "Software"), to deal in the Software without restriction, including
11 * without limitation the rights to use, copy, modify, merge, publish,
12 * distribute, sub license, and/or sell copies of the Software, and to
13 * permit persons to whom the Software is furnished to do so, subject to
14 * the following conditions:
15 *
16 * The above copyright notice and this permission notice (including the
17 * next paragraph) shall be included in all copies or substantial portions
18 * of the Software.
19 *
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
25 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
26 * DEALINGS IN THE SOFTWARE.
27 *
28 **************************************************************************/
29
30
31 /**
32 * Public EGL API entrypoints
33 *
34 * Generally, we use the EGLDisplay parameter as a key to lookup the
35 * appropriate device driver handle, then jump though the driver's
36 * dispatch table to handle the function.
37 *
38 * That allows us the option of supporting multiple, simultaneous,
39 * heterogeneous hardware devices in the future.
40 *
41 * The EGLDisplay, EGLConfig, EGLContext and EGLSurface types are
42 * opaque handles. Internal objects are linked to a display to
43 * create the handles.
44 *
45 * For each public API entry point, the opaque handles are looked up
46 * before being dispatched to the drivers. When it fails to look up
47 * a handle, one of
48 *
49 * EGL_BAD_DISPLAY
50 * EGL_BAD_CONFIG
51 * EGL_BAD_CONTEXT
52 * EGL_BAD_SURFACE
53 * EGL_BAD_SCREEN_MESA
54 * EGL_BAD_MODE_MESA
55 *
56 * is generated and the driver function is not called. An
57 * uninitialized EGLDisplay has no driver associated with it. When
58 * such display is detected,
59 *
60 * EGL_NOT_INITIALIZED
61 *
62 * is generated.
63 *
64 * Some of the entry points use current display, context, or surface
65 * implicitly. For such entry points, the implicit objects are also
66 * checked before calling the driver function. Other than the
67 * errors listed above,
68 *
69 * EGL_BAD_CURRENT_SURFACE
70 *
71 * may also be generated.
72 *
73 * Notes on naming conventions:
74 *
75 * eglFooBar - public EGL function
76 * EGL_FOO_BAR - public EGL token
77 * EGLDatatype - public EGL datatype
78 *
79 * _eglFooBar - private EGL function
80 * _EGLDatatype - private EGL datatype, typedef'd struct
81 * _egl_struct - private EGL struct, non-typedef'd
82 *
83 */
84
85
86 #ifdef USE_LIBGLVND
87 #define EGLAPI
88 #undef PUBLIC
89 #define PUBLIC
90 #endif
91
92 #include <stdio.h>
93 #include <stdlib.h>
94 #include <string.h>
95 #include "c99_compat.h"
96 #include "c11/threads.h"
97 #include "util/macros.h"
98
99 #include "egldefines.h"
100 #include "eglglobals.h"
101 #include "eglcontext.h"
102 #include "egldisplay.h"
103 #include "egltypedefs.h"
104 #include "eglcurrent.h"
105 #include "egldevice.h"
106 #include "egldriver.h"
107 #include "eglsurface.h"
108 #include "eglconfig.h"
109 #include "eglimage.h"
110 #include "eglsync.h"
111
112 #include "GL/mesa_glinterop.h"
113
114 /**
115 * Macros to help return an API entrypoint.
116 *
117 * These macros will unlock the display and record the error code.
118 */
119 #define RETURN_EGL_ERROR(disp, err, ret) \
120 do { \
121 if (disp) \
122 _eglUnlockDisplay(disp); \
123 /* EGL error codes are non-zero */ \
124 if (err) \
125 _eglError(err, __func__); \
126 return ret; \
127 } while (0)
128
129 #define RETURN_EGL_SUCCESS(disp, ret) \
130 RETURN_EGL_ERROR(disp, EGL_SUCCESS, ret)
131
132 /* record EGL_SUCCESS only when ret evaluates to true */
133 #define RETURN_EGL_EVAL(disp, ret) \
134 RETURN_EGL_ERROR(disp, (ret) ? EGL_SUCCESS : 0, ret)
135
136
137 /*
138 * A bunch of macros and checks to simplify error checking.
139 */
140
141 #define _EGL_CHECK_DISPLAY(disp, ret, drv) \
142 do { \
143 drv = _eglCheckDisplay(disp, __func__); \
144 if (!drv) \
145 RETURN_EGL_ERROR(disp, 0, ret); \
146 } while (0)
147
148 #define _EGL_CHECK_OBJECT(disp, type, obj, ret, drv) \
149 do { \
150 drv = _eglCheck ## type(disp, obj, __func__); \
151 if (!drv) \
152 RETURN_EGL_ERROR(disp, 0, ret); \
153 } while (0)
154
155 #define _EGL_CHECK_SURFACE(disp, surf, ret, drv) \
156 _EGL_CHECK_OBJECT(disp, Surface, surf, ret, drv)
157
158 #define _EGL_CHECK_CONTEXT(disp, context, ret, drv) \
159 _EGL_CHECK_OBJECT(disp, Context, context, ret, drv)
160
161 #define _EGL_CHECK_CONFIG(disp, conf, ret, drv) \
162 _EGL_CHECK_OBJECT(disp, Config, conf, ret, drv)
163
164 #define _EGL_CHECK_SYNC(disp, s, ret, drv) \
165 _EGL_CHECK_OBJECT(disp, Sync, s, ret, drv)
166
167
168 struct _egl_entrypoint {
169 const char *name;
170 _EGLProc function;
171 };
172
173
174 static inline const _EGLDriver *
175 _eglCheckDisplay(_EGLDisplay *disp, const char *msg)
176 {
177 if (!disp) {
178 _eglError(EGL_BAD_DISPLAY, msg);
179 return NULL;
180 }
181 if (!disp->Initialized) {
182 _eglError(EGL_NOT_INITIALIZED, msg);
183 return NULL;
184 }
185 return disp->Driver;
186 }
187
188
189 static inline const _EGLDriver *
190 _eglCheckSurface(_EGLDisplay *disp, _EGLSurface *surf, const char *msg)
191 {
192 const _EGLDriver *drv = _eglCheckDisplay(disp, msg);
193 if (!drv)
194 return NULL;
195 if (!surf) {
196 _eglError(EGL_BAD_SURFACE, msg);
197 return NULL;
198 }
199 return drv;
200 }
201
202
203 static inline const _EGLDriver *
204 _eglCheckContext(_EGLDisplay *disp, _EGLContext *context, const char *msg)
205 {
206 const _EGLDriver *drv = _eglCheckDisplay(disp, msg);
207 if (!drv)
208 return NULL;
209 if (!context) {
210 _eglError(EGL_BAD_CONTEXT, msg);
211 return NULL;
212 }
213 return drv;
214 }
215
216
217 static inline const _EGLDriver *
218 _eglCheckConfig(_EGLDisplay *disp, _EGLConfig *conf, const char *msg)
219 {
220 const _EGLDriver *drv = _eglCheckDisplay(disp, msg);
221 if (!drv)
222 return NULL;
223 if (!conf) {
224 _eglError(EGL_BAD_CONFIG, msg);
225 return NULL;
226 }
227 return drv;
228 }
229
230
231 static inline const _EGLDriver *
232 _eglCheckSync(_EGLDisplay *disp, _EGLSync *s, const char *msg)
233 {
234 const _EGLDriver *drv = _eglCheckDisplay(disp, msg);
235 if (!drv)
236 return NULL;
237 if (!s) {
238 _eglError(EGL_BAD_PARAMETER, msg);
239 return NULL;
240 }
241 return drv;
242 }
243
244
245 /**
246 * Lookup and lock a display.
247 */
248 static inline _EGLDisplay *
249 _eglLockDisplay(EGLDisplay dpy)
250 {
251 _EGLDisplay *disp = _eglLookupDisplay(dpy);
252 if (disp)
253 mtx_lock(&disp->Mutex);
254 return disp;
255 }
256
257
258 /**
259 * Unlock a display.
260 */
261 static inline void
262 _eglUnlockDisplay(_EGLDisplay *disp)
263 {
264 mtx_unlock(&disp->Mutex);
265 }
266
267 static EGLBoolean
268 _eglSetFuncName(const char *funcName, _EGLDisplay *disp, EGLenum objectType, _EGLResource *object)
269 {
270 _EGLThreadInfo *thr = _eglGetCurrentThread();
271 if (!_eglIsCurrentThreadDummy()) {
272 thr->CurrentFuncName = funcName;
273 thr->CurrentObjectLabel = NULL;
274
275 if (objectType == EGL_OBJECT_THREAD_KHR)
276 thr->CurrentObjectLabel = thr->Label;
277 else if (objectType == EGL_OBJECT_DISPLAY_KHR && disp)
278 thr->CurrentObjectLabel = disp->Label;
279 else if (object)
280 thr->CurrentObjectLabel = object->Label;
281
282 return EGL_TRUE;
283 }
284
285 _eglDebugReport(EGL_BAD_ALLOC, funcName, EGL_DEBUG_MSG_CRITICAL_KHR, NULL);
286 return EGL_FALSE;
287 }
288
289 #define _EGL_FUNC_START(disp, objectType, object, ret) \
290 do { \
291 if (!_eglSetFuncName(__func__, disp, objectType, (_EGLResource *) object)) { \
292 if (disp) \
293 _eglUnlockDisplay(disp); \
294 return ret; \
295 } \
296 } while(0)
297
298 /**
299 * Convert an attribute list from EGLint[] to EGLAttrib[].
300 *
301 * Return an EGL error code. The output parameter out_attrib_list is modified
302 * only on success.
303 */
304 static EGLint
305 _eglConvertIntsToAttribs(const EGLint *int_list, EGLAttrib **out_attrib_list)
306 {
307 size_t len = 0;
308 EGLAttrib *attrib_list;
309
310 if (int_list) {
311 while (int_list[2*len] != EGL_NONE)
312 ++len;
313 }
314
315 if (len == 0) {
316 *out_attrib_list = NULL;
317 return EGL_SUCCESS;
318 }
319
320 if (2*len + 1 > SIZE_MAX / sizeof(EGLAttrib))
321 return EGL_BAD_ALLOC;
322
323 attrib_list = malloc((2*len + 1) * sizeof(EGLAttrib));
324 if (!attrib_list)
325 return EGL_BAD_ALLOC;
326
327 for (size_t i = 0; i < len; ++i) {
328 attrib_list[2*i + 0] = int_list[2*i + 0];
329 attrib_list[2*i + 1] = int_list[2*i + 1];
330 }
331
332 attrib_list[2*len] = EGL_NONE;
333
334 *out_attrib_list = attrib_list;
335 return EGL_SUCCESS;
336 }
337
338
339 static EGLint *
340 _eglConvertAttribsToInt(const EGLAttrib *attr_list)
341 {
342 size_t size = _eglNumAttribs(attr_list);
343 EGLint *int_attribs = NULL;
344
345 /* Convert attributes from EGLAttrib[] to EGLint[] */
346 if (size) {
347 int_attribs = calloc(size, sizeof(int_attribs[0]));
348 if (!int_attribs)
349 return NULL;
350
351 for (size_t i = 0; i < size; i++)
352 int_attribs[i] = attr_list[i];
353 }
354 return int_attribs;
355 }
356
357
358 /**
359 * This is typically the first EGL function that an application calls.
360 * It associates a private _EGLDisplay object to the native display.
361 */
362 EGLDisplay EGLAPIENTRY
363 eglGetDisplay(EGLNativeDisplayType nativeDisplay)
364 {
365 _EGLPlatformType plat;
366 _EGLDisplay *disp;
367 void *native_display_ptr;
368
369 _EGL_FUNC_START(NULL, EGL_OBJECT_THREAD_KHR, NULL, EGL_NO_DISPLAY);
370
371 STATIC_ASSERT(sizeof(void*) == sizeof(nativeDisplay));
372 native_display_ptr = (void*) nativeDisplay;
373
374 plat = _eglGetNativePlatform(native_display_ptr);
375 disp = _eglFindDisplay(plat, native_display_ptr, NULL);
376 return _eglGetDisplayHandle(disp);
377 }
378
379 static EGLDisplay
380 _eglGetPlatformDisplayCommon(EGLenum platform, void *native_display,
381 const EGLAttrib *attrib_list)
382 {
383 _EGLDisplay *disp;
384
385 switch (platform) {
386 #ifdef HAVE_X11_PLATFORM
387 case EGL_PLATFORM_X11_EXT:
388 disp = _eglGetX11Display((Display*) native_display, attrib_list);
389 break;
390 #endif
391 #ifdef HAVE_DRM_PLATFORM
392 case EGL_PLATFORM_GBM_MESA:
393 disp = _eglGetGbmDisplay((struct gbm_device*) native_display,
394 attrib_list);
395 break;
396 #endif
397 #ifdef HAVE_WAYLAND_PLATFORM
398 case EGL_PLATFORM_WAYLAND_EXT:
399 disp = _eglGetWaylandDisplay((struct wl_display*) native_display,
400 attrib_list);
401 break;
402 #endif
403 case EGL_PLATFORM_SURFACELESS_MESA:
404 disp = _eglGetSurfacelessDisplay(native_display, attrib_list);
405 break;
406 #ifdef HAVE_ANDROID_PLATFORM
407 case EGL_PLATFORM_ANDROID_KHR:
408 disp = _eglGetAndroidDisplay(native_display, attrib_list);
409 break;
410 #endif
411 case EGL_PLATFORM_DEVICE_EXT:
412 disp = _eglGetDeviceDisplay(native_display, attrib_list);
413 break;
414 default:
415 RETURN_EGL_ERROR(NULL, EGL_BAD_PARAMETER, NULL);
416 }
417
418 return _eglGetDisplayHandle(disp);
419 }
420
421 static EGLDisplay EGLAPIENTRY
422 eglGetPlatformDisplayEXT(EGLenum platform, void *native_display,
423 const EGLint *int_attribs)
424 {
425 EGLAttrib *attrib_list;
426 EGLDisplay disp;
427
428 _EGL_FUNC_START(NULL, EGL_OBJECT_THREAD_KHR, NULL, EGL_NO_DISPLAY);
429
430 if (_eglConvertIntsToAttribs(int_attribs, &attrib_list) != EGL_SUCCESS)
431 RETURN_EGL_ERROR(NULL, EGL_BAD_ALLOC, NULL);
432
433 disp = _eglGetPlatformDisplayCommon(platform, native_display, attrib_list);
434 free(attrib_list);
435 return disp;
436 }
437
438 EGLDisplay EGLAPIENTRY
439 eglGetPlatformDisplay(EGLenum platform, void *native_display,
440 const EGLAttrib *attrib_list)
441 {
442 _EGL_FUNC_START(NULL, EGL_OBJECT_THREAD_KHR, NULL, EGL_NO_DISPLAY);
443 return _eglGetPlatformDisplayCommon(platform, native_display, attrib_list);
444 }
445
446 /**
447 * Copy the extension into the string and update the string pointer.
448 */
449 static EGLint
450 _eglAppendExtension(char **str, const char *ext)
451 {
452 char *s = *str;
453 size_t len = strlen(ext);
454
455 if (s) {
456 memcpy(s, ext, len);
457 s[len++] = ' ';
458 s[len] = '\0';
459
460 *str += len;
461 }
462 else {
463 len++;
464 }
465
466 return (EGLint) len;
467 }
468
469 /**
470 * Examine the individual extension enable/disable flags and recompute
471 * the driver's Extensions string.
472 */
473 static void
474 _eglCreateExtensionsString(_EGLDisplay *disp)
475 {
476 #define _EGL_CHECK_EXTENSION(ext) \
477 do { \
478 if (disp->Extensions.ext) { \
479 _eglAppendExtension(&exts, "EGL_" #ext); \
480 assert(exts <= disp->ExtensionsString + _EGL_MAX_EXTENSIONS_LEN); \
481 } \
482 } while (0)
483
484 char *exts = disp->ExtensionsString;
485
486 /* Please keep these sorted alphabetically. */
487 _EGL_CHECK_EXTENSION(ANDROID_blob_cache);
488 _EGL_CHECK_EXTENSION(ANDROID_framebuffer_target);
489 _EGL_CHECK_EXTENSION(ANDROID_image_native_buffer);
490 _EGL_CHECK_EXTENSION(ANDROID_native_fence_sync);
491 _EGL_CHECK_EXTENSION(ANDROID_recordable);
492
493 _EGL_CHECK_EXTENSION(CHROMIUM_sync_control);
494
495 _EGL_CHECK_EXTENSION(EXT_buffer_age);
496 _EGL_CHECK_EXTENSION(EXT_create_context_robustness);
497 _EGL_CHECK_EXTENSION(EXT_image_dma_buf_import);
498 _EGL_CHECK_EXTENSION(EXT_image_dma_buf_import_modifiers);
499 _EGL_CHECK_EXTENSION(EXT_surface_CTA861_3_metadata);
500 _EGL_CHECK_EXTENSION(EXT_surface_SMPTE2086_metadata);
501 _EGL_CHECK_EXTENSION(EXT_swap_buffers_with_damage);
502
503 _EGL_CHECK_EXTENSION(IMG_context_priority);
504
505 _EGL_CHECK_EXTENSION(KHR_cl_event2);
506 _EGL_CHECK_EXTENSION(KHR_config_attribs);
507 _EGL_CHECK_EXTENSION(KHR_context_flush_control);
508 _EGL_CHECK_EXTENSION(KHR_create_context);
509 _EGL_CHECK_EXTENSION(KHR_create_context_no_error);
510 _EGL_CHECK_EXTENSION(KHR_fence_sync);
511 _EGL_CHECK_EXTENSION(KHR_get_all_proc_addresses);
512 _EGL_CHECK_EXTENSION(KHR_gl_colorspace);
513 _EGL_CHECK_EXTENSION(KHR_gl_renderbuffer_image);
514 _EGL_CHECK_EXTENSION(KHR_gl_texture_2D_image);
515 _EGL_CHECK_EXTENSION(KHR_gl_texture_3D_image);
516 _EGL_CHECK_EXTENSION(KHR_gl_texture_cubemap_image);
517 if (disp->Extensions.KHR_image_base && disp->Extensions.KHR_image_pixmap)
518 disp->Extensions.KHR_image = EGL_TRUE;
519 _EGL_CHECK_EXTENSION(KHR_image);
520 _EGL_CHECK_EXTENSION(KHR_image_base);
521 _EGL_CHECK_EXTENSION(KHR_image_pixmap);
522 _EGL_CHECK_EXTENSION(KHR_mutable_render_buffer);
523 _EGL_CHECK_EXTENSION(KHR_no_config_context);
524 _EGL_CHECK_EXTENSION(KHR_partial_update);
525 _EGL_CHECK_EXTENSION(KHR_reusable_sync);
526 _EGL_CHECK_EXTENSION(KHR_surfaceless_context);
527 if (disp->Extensions.EXT_swap_buffers_with_damage)
528 _eglAppendExtension(&exts, "EGL_KHR_swap_buffers_with_damage");
529 _EGL_CHECK_EXTENSION(EXT_pixel_format_float);
530 _EGL_CHECK_EXTENSION(KHR_wait_sync);
531
532 if (disp->Extensions.KHR_no_config_context)
533 _eglAppendExtension(&exts, "EGL_MESA_configless_context");
534 _EGL_CHECK_EXTENSION(MESA_drm_image);
535 _EGL_CHECK_EXTENSION(MESA_image_dma_buf_export);
536 _EGL_CHECK_EXTENSION(MESA_query_driver);
537
538 _EGL_CHECK_EXTENSION(NOK_swap_region);
539 _EGL_CHECK_EXTENSION(NOK_texture_from_pixmap);
540
541 _EGL_CHECK_EXTENSION(NV_post_sub_buffer);
542
543 _EGL_CHECK_EXTENSION(WL_bind_wayland_display);
544 _EGL_CHECK_EXTENSION(WL_create_wayland_buffer_from_image);
545
546 #undef _EGL_CHECK_EXTENSION
547 }
548
549 static void
550 _eglCreateAPIsString(_EGLDisplay *disp)
551 {
552 #define addstr(str) \
553 { \
554 const size_t old_len = strlen(disp->ClientAPIsString); \
555 const size_t add_len = sizeof(str); \
556 const size_t max_len = sizeof(disp->ClientAPIsString) - 1; \
557 if (old_len + add_len <= max_len) \
558 strcat(disp->ClientAPIsString, str " "); \
559 else \
560 assert(!"disp->ClientAPIsString is not large enough"); \
561 }
562
563 if (disp->ClientAPIs & EGL_OPENGL_BIT)
564 addstr("OpenGL");
565
566 if (disp->ClientAPIs & EGL_OPENGL_ES_BIT ||
567 disp->ClientAPIs & EGL_OPENGL_ES2_BIT ||
568 disp->ClientAPIs & EGL_OPENGL_ES3_BIT_KHR) {
569 addstr("OpenGL_ES");
570 }
571
572 if (disp->ClientAPIs & EGL_OPENVG_BIT)
573 addstr("OpenVG");
574
575 #undef addstr
576 }
577
578 static void
579 _eglComputeVersion(_EGLDisplay *disp)
580 {
581 disp->Version = 14;
582
583 if (disp->Extensions.KHR_fence_sync &&
584 disp->Extensions.KHR_cl_event2 &&
585 disp->Extensions.KHR_wait_sync &&
586 disp->Extensions.KHR_image_base &&
587 disp->Extensions.KHR_gl_texture_2D_image &&
588 disp->Extensions.KHR_gl_texture_3D_image &&
589 disp->Extensions.KHR_gl_texture_cubemap_image &&
590 disp->Extensions.KHR_gl_renderbuffer_image &&
591 disp->Extensions.KHR_create_context &&
592 disp->Extensions.EXT_create_context_robustness &&
593 disp->Extensions.KHR_get_all_proc_addresses &&
594 disp->Extensions.KHR_gl_colorspace &&
595 disp->Extensions.KHR_surfaceless_context)
596 disp->Version = 15;
597
598 /* For Android P and below limit the EGL version to 1.4 */
599 #if defined(ANDROID) && ANDROID_API_LEVEL <= 28
600 disp->Version = 14;
601 #endif
602 }
603
604 /**
605 * This is typically the second EGL function that an application calls.
606 * Here we load/initialize the actual hardware driver.
607 */
608 EGLBoolean EGLAPIENTRY
609 eglInitialize(EGLDisplay dpy, EGLint *major, EGLint *minor)
610 {
611 _EGLDisplay *disp = _eglLockDisplay(dpy);
612
613 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
614
615 if (!disp)
616 RETURN_EGL_ERROR(NULL, EGL_BAD_DISPLAY, EGL_FALSE);
617
618 if (!disp->Initialized) {
619 if (!_eglInitializeDisplay(disp))
620 RETURN_EGL_ERROR(disp, EGL_NOT_INITIALIZED, EGL_FALSE);
621
622 /* limit to APIs supported by core */
623 disp->ClientAPIs &= _EGL_API_ALL_BITS;
624
625 /* EGL_KHR_get_all_proc_addresses is a corner-case extension. The spec
626 * classifies it as an EGL display extension, though conceptually it's an
627 * EGL client extension.
628 *
629 * From the EGL_KHR_get_all_proc_addresses spec:
630 *
631 * The EGL implementation must expose the name
632 * EGL_KHR_client_get_all_proc_addresses if and only if it exposes
633 * EGL_KHR_get_all_proc_addresses and supports
634 * EGL_EXT_client_extensions.
635 *
636 * Mesa unconditionally exposes both client extensions mentioned above,
637 * so the spec requires that each EGLDisplay unconditionally expose
638 * EGL_KHR_get_all_proc_addresses also.
639 */
640 disp->Extensions.KHR_get_all_proc_addresses = EGL_TRUE;
641
642 /* Extensions is used to provide EGL 1.3 functionality for 1.2 aware
643 * programs. It is driver agnostic and handled in the main EGL code.
644 */
645 disp->Extensions.KHR_config_attribs = EGL_TRUE;
646
647 _eglComputeVersion(disp);
648 _eglCreateExtensionsString(disp);
649 _eglCreateAPIsString(disp);
650 snprintf(disp->VersionString, sizeof(disp->VersionString),
651 "%d.%d", disp->Version / 10, disp->Version % 10);
652 }
653
654 /* Update applications version of major and minor if not NULL */
655 if ((major != NULL) && (minor != NULL)) {
656 *major = disp->Version / 10;
657 *minor = disp->Version % 10;
658 }
659
660 RETURN_EGL_SUCCESS(disp, EGL_TRUE);
661 }
662
663
664 EGLBoolean EGLAPIENTRY
665 eglTerminate(EGLDisplay dpy)
666 {
667 _EGLDisplay *disp = _eglLockDisplay(dpy);
668
669 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
670
671 if (!disp)
672 RETURN_EGL_ERROR(NULL, EGL_BAD_DISPLAY, EGL_FALSE);
673
674 if (disp->Initialized) {
675 disp->Driver->Terminate(disp);
676 /* do not reset disp->Driver */
677 disp->ClientAPIsString[0] = 0;
678 disp->Initialized = EGL_FALSE;
679
680 /* Reset blob cache funcs on terminate. */
681 disp->BlobCacheSet = NULL;
682 disp->BlobCacheGet = NULL;
683 }
684
685 RETURN_EGL_SUCCESS(disp, EGL_TRUE);
686 }
687
688
689 const char * EGLAPIENTRY
690 eglQueryString(EGLDisplay dpy, EGLint name)
691 {
692 _EGLDisplay *disp;
693 const _EGLDriver *drv;
694
695 #if !USE_LIBGLVND
696 if (dpy == EGL_NO_DISPLAY && name == EGL_EXTENSIONS) {
697 RETURN_EGL_SUCCESS(NULL, _eglGlobal.ClientExtensionString);
698 }
699 #endif
700
701 disp = _eglLockDisplay(dpy);
702 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, NULL);
703 _EGL_CHECK_DISPLAY(disp, NULL, drv);
704
705 switch (name) {
706 case EGL_VENDOR:
707 RETURN_EGL_SUCCESS(disp, _EGL_VENDOR_STRING);
708 case EGL_VERSION:
709 RETURN_EGL_SUCCESS(disp, disp->VersionString);
710 case EGL_EXTENSIONS:
711 RETURN_EGL_SUCCESS(disp, disp->ExtensionsString);
712 case EGL_CLIENT_APIS:
713 RETURN_EGL_SUCCESS(disp, disp->ClientAPIsString);
714 default:
715 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, NULL);
716 }
717 }
718
719
720 EGLBoolean EGLAPIENTRY
721 eglGetConfigs(EGLDisplay dpy, EGLConfig *configs,
722 EGLint config_size, EGLint *num_config)
723 {
724 _EGLDisplay *disp = _eglLockDisplay(dpy);
725 const _EGLDriver *drv;
726 EGLBoolean ret;
727
728 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
729
730 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
731
732 if (!num_config)
733 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
734
735 ret = _eglGetConfigs(drv, disp, configs, config_size, num_config);
736
737 RETURN_EGL_EVAL(disp, ret);
738 }
739
740
741 EGLBoolean EGLAPIENTRY
742 eglChooseConfig(EGLDisplay dpy, const EGLint *attrib_list, EGLConfig *configs,
743 EGLint config_size, EGLint *num_config)
744 {
745 _EGLDisplay *disp = _eglLockDisplay(dpy);
746 const _EGLDriver *drv;
747 EGLBoolean ret;
748
749 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
750
751 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
752
753 if (!num_config)
754 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
755
756 ret = _eglChooseConfig(drv, disp, attrib_list, configs,
757 config_size, num_config);
758
759 RETURN_EGL_EVAL(disp, ret);
760 }
761
762
763 EGLBoolean EGLAPIENTRY
764 eglGetConfigAttrib(EGLDisplay dpy, EGLConfig config,
765 EGLint attribute, EGLint *value)
766 {
767 _EGLDisplay *disp = _eglLockDisplay(dpy);
768 _EGLConfig *conf = _eglLookupConfig(config, disp);
769 const _EGLDriver *drv;
770 EGLBoolean ret;
771
772 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
773
774 _EGL_CHECK_CONFIG(disp, conf, EGL_FALSE, drv);
775
776 ret = _eglGetConfigAttrib(drv, disp, conf, attribute, value);
777
778 RETURN_EGL_EVAL(disp, ret);
779 }
780
781
782 EGLContext EGLAPIENTRY
783 eglCreateContext(EGLDisplay dpy, EGLConfig config, EGLContext share_list,
784 const EGLint *attrib_list)
785 {
786 _EGLDisplay *disp = _eglLockDisplay(dpy);
787 _EGLConfig *conf = _eglLookupConfig(config, disp);
788 _EGLContext *share = _eglLookupContext(share_list, disp);
789 const _EGLDriver *drv;
790 _EGLContext *context;
791 EGLContext ret;
792
793 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_CONTEXT);
794
795 _EGL_CHECK_DISPLAY(disp, EGL_NO_CONTEXT, drv);
796
797 if (config != EGL_NO_CONFIG_KHR)
798 _EGL_CHECK_CONFIG(disp, conf, EGL_NO_CONTEXT, drv);
799 else if (!disp->Extensions.KHR_no_config_context)
800 RETURN_EGL_ERROR(disp, EGL_BAD_CONFIG, EGL_NO_CONTEXT);
801
802 if (!share && share_list != EGL_NO_CONTEXT)
803 RETURN_EGL_ERROR(disp, EGL_BAD_CONTEXT, EGL_NO_CONTEXT);
804
805 context = drv->CreateContext(disp, conf, share, attrib_list);
806 ret = (context) ? _eglLinkContext(context) : EGL_NO_CONTEXT;
807
808 RETURN_EGL_EVAL(disp, ret);
809 }
810
811
812 EGLBoolean EGLAPIENTRY
813 eglDestroyContext(EGLDisplay dpy, EGLContext ctx)
814 {
815 _EGLDisplay *disp = _eglLockDisplay(dpy);
816 _EGLContext *context = _eglLookupContext(ctx, disp);
817 const _EGLDriver *drv;
818 EGLBoolean ret;
819
820 _EGL_FUNC_START(disp, EGL_OBJECT_CONTEXT_KHR, context, EGL_FALSE);
821
822 _EGL_CHECK_CONTEXT(disp, context, EGL_FALSE, drv);
823 _eglUnlinkContext(context);
824 ret = drv->DestroyContext(disp, context);
825
826 RETURN_EGL_EVAL(disp, ret);
827 }
828
829
830 EGLBoolean EGLAPIENTRY
831 eglMakeCurrent(EGLDisplay dpy, EGLSurface draw, EGLSurface read,
832 EGLContext ctx)
833 {
834 _EGLDisplay *disp = _eglLockDisplay(dpy);
835 _EGLContext *context = _eglLookupContext(ctx, disp);
836 _EGLSurface *draw_surf = _eglLookupSurface(draw, disp);
837 _EGLSurface *read_surf = _eglLookupSurface(read, disp);
838 const _EGLDriver *drv;
839 EGLBoolean ret;
840
841 _EGL_FUNC_START(disp, EGL_OBJECT_CONTEXT_KHR, context, EGL_FALSE);
842
843 if (!disp)
844 RETURN_EGL_ERROR(disp, EGL_BAD_DISPLAY, EGL_FALSE);
845 drv = disp->Driver;
846
847 /* display is allowed to be uninitialized under certain condition */
848 if (!disp->Initialized) {
849 if (draw != EGL_NO_SURFACE || read != EGL_NO_SURFACE ||
850 ctx != EGL_NO_CONTEXT)
851 RETURN_EGL_ERROR(disp, EGL_BAD_DISPLAY, EGL_FALSE);
852 }
853 if (!drv)
854 RETURN_EGL_SUCCESS(disp, EGL_TRUE);
855
856 if (!context && ctx != EGL_NO_CONTEXT)
857 RETURN_EGL_ERROR(disp, EGL_BAD_CONTEXT, EGL_FALSE);
858 if (!draw_surf || !read_surf) {
859 /* From the EGL 1.4 (20130211) spec:
860 *
861 * To release the current context without assigning a new one, set ctx
862 * to EGL_NO_CONTEXT and set draw and read to EGL_NO_SURFACE.
863 */
864 if (!disp->Extensions.KHR_surfaceless_context && ctx != EGL_NO_CONTEXT)
865 RETURN_EGL_ERROR(disp, EGL_BAD_SURFACE, EGL_FALSE);
866
867 if ((!draw_surf && draw != EGL_NO_SURFACE) ||
868 (!read_surf && read != EGL_NO_SURFACE))
869 RETURN_EGL_ERROR(disp, EGL_BAD_SURFACE, EGL_FALSE);
870 if (draw_surf || read_surf)
871 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_FALSE);
872 }
873
874 /* If a native window underlying either draw or read is no longer valid,
875 * an EGL_BAD_NATIVE_WINDOW error is generated.
876 */
877 if (draw_surf && draw_surf->Lost)
878 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_WINDOW, EGL_FALSE);
879 if (read_surf && read_surf->Lost)
880 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_WINDOW, EGL_FALSE);
881
882 ret = drv->MakeCurrent(disp, draw_surf, read_surf, context);
883
884 RETURN_EGL_EVAL(disp, ret);
885 }
886
887
888 EGLBoolean EGLAPIENTRY
889 eglQueryContext(EGLDisplay dpy, EGLContext ctx,
890 EGLint attribute, EGLint *value)
891 {
892 _EGLDisplay *disp = _eglLockDisplay(dpy);
893 _EGLContext *context = _eglLookupContext(ctx, disp);
894 const _EGLDriver *drv;
895 EGLBoolean ret;
896
897 _EGL_FUNC_START(disp, EGL_OBJECT_CONTEXT_KHR, context, EGL_FALSE);
898
899 _EGL_CHECK_CONTEXT(disp, context, EGL_FALSE, drv);
900
901 ret = _eglQueryContext(drv, disp, context, attribute, value);
902
903 RETURN_EGL_EVAL(disp, ret);
904 }
905
906
907 /* In EGL specs 1.4 and 1.5, at the end of sections 3.5.1 and 3.5.4, it says
908 * that if native_surface was already used to create a window or pixmap, we
909 * can't create a new one. This is what this function checks for.
910 */
911 static bool
912 _eglNativeSurfaceAlreadyUsed(_EGLDisplay *disp, void *native_surface)
913 {
914 _EGLResource *list;
915
916 list = disp->ResourceLists[_EGL_RESOURCE_SURFACE];
917 while (list) {
918 _EGLSurface *surf = (_EGLSurface *) list;
919
920 list = list->Next;
921
922 if (surf->Type == EGL_PBUFFER_BIT)
923 continue;
924
925 if (surf->NativeSurface == native_surface)
926 return true;
927 }
928
929 return false;
930 }
931
932
933 static EGLSurface
934 _eglCreateWindowSurfaceCommon(_EGLDisplay *disp, EGLConfig config,
935 void *native_window, const EGLint *attrib_list)
936 {
937 _EGLConfig *conf = _eglLookupConfig(config, disp);
938 const _EGLDriver *drv;
939 _EGLSurface *surf;
940 EGLSurface ret;
941
942
943 if (native_window == NULL)
944 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_WINDOW, EGL_NO_SURFACE);
945
946 if (disp && (disp->Platform == _EGL_PLATFORM_SURFACELESS ||
947 disp->Platform == _EGL_PLATFORM_DEVICE)) {
948 /* From the EGL_MESA_platform_surfaceless spec (v1):
949 *
950 * eglCreatePlatformWindowSurface fails when called with a <display>
951 * that belongs to the surfaceless platform. It returns
952 * EGL_NO_SURFACE and generates EGL_BAD_NATIVE_WINDOW. The
953 * justification for this unconditional failure is that the
954 * surfaceless platform has no native windows, and therefore the
955 * <native_window> parameter is always invalid.
956 *
957 * This check must occur before checking the EGLConfig, which emits
958 * EGL_BAD_CONFIG.
959 */
960 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_WINDOW, EGL_NO_SURFACE);
961 }
962
963 _EGL_CHECK_CONFIG(disp, conf, EGL_NO_SURFACE, drv);
964
965 if ((conf->SurfaceType & EGL_WINDOW_BIT) == 0)
966 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_NO_SURFACE);
967
968 if (_eglNativeSurfaceAlreadyUsed(disp, native_window))
969 RETURN_EGL_ERROR(disp, EGL_BAD_ALLOC, EGL_NO_SURFACE);
970
971 surf = drv->CreateWindowSurface(disp, conf, native_window, attrib_list);
972 ret = (surf) ? _eglLinkSurface(surf) : EGL_NO_SURFACE;
973
974 RETURN_EGL_EVAL(disp, ret);
975 }
976
977
978 EGLSurface EGLAPIENTRY
979 eglCreateWindowSurface(EGLDisplay dpy, EGLConfig config,
980 EGLNativeWindowType window, const EGLint *attrib_list)
981 {
982 _EGLDisplay *disp = _eglLockDisplay(dpy);
983
984 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
985 STATIC_ASSERT(sizeof(void*) == sizeof(window));
986 return _eglCreateWindowSurfaceCommon(disp, config, (void*) window,
987 attrib_list);
988 }
989
990 static void *
991 _fixupNativeWindow(_EGLDisplay *disp, void *native_window)
992 {
993 #ifdef HAVE_X11_PLATFORM
994 if (disp && disp->Platform == _EGL_PLATFORM_X11 && native_window != NULL) {
995 /* The `native_window` parameter for the X11 platform differs between
996 * eglCreateWindowSurface() and eglCreatePlatformPixmapSurfaceEXT(). In
997 * eglCreateWindowSurface(), the type of `native_window` is an Xlib
998 * `Window`. In eglCreatePlatformWindowSurfaceEXT(), the type is
999 * `Window*`. Convert `Window*` to `Window` because that's what
1000 * dri2_x11_create_window_surface() expects.
1001 */
1002 return (void *)(* (Window*) native_window);
1003 }
1004 #endif
1005 return native_window;
1006 }
1007
1008 static EGLSurface EGLAPIENTRY
1009 eglCreatePlatformWindowSurfaceEXT(EGLDisplay dpy, EGLConfig config,
1010 void *native_window,
1011 const EGLint *attrib_list)
1012 {
1013 _EGLDisplay *disp = _eglLockDisplay(dpy);
1014
1015 native_window = _fixupNativeWindow(disp, native_window);
1016
1017 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1018 return _eglCreateWindowSurfaceCommon(disp, config, native_window,
1019 attrib_list);
1020 }
1021
1022
1023 EGLSurface EGLAPIENTRY
1024 eglCreatePlatformWindowSurface(EGLDisplay dpy, EGLConfig config,
1025 void *native_window,
1026 const EGLAttrib *attrib_list)
1027 {
1028 _EGLDisplay *disp = _eglLockDisplay(dpy);
1029 EGLSurface surface;
1030 EGLint *int_attribs;
1031
1032 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1033
1034 int_attribs = _eglConvertAttribsToInt(attrib_list);
1035 if (attrib_list && !int_attribs)
1036 RETURN_EGL_ERROR(disp, EGL_BAD_ALLOC, EGL_NO_SURFACE);
1037
1038 native_window = _fixupNativeWindow(disp, native_window);
1039 surface = _eglCreateWindowSurfaceCommon(disp, config, native_window,
1040 int_attribs);
1041 free(int_attribs);
1042 return surface;
1043 }
1044
1045 static void *
1046 _fixupNativePixmap(_EGLDisplay *disp, void *native_pixmap)
1047 {
1048 #ifdef HAVE_X11_PLATFORM
1049 /* The `native_pixmap` parameter for the X11 platform differs between
1050 * eglCreatePixmapSurface() and eglCreatePlatformPixmapSurfaceEXT(). In
1051 * eglCreatePixmapSurface(), the type of `native_pixmap` is an Xlib
1052 * `Pixmap`. In eglCreatePlatformPixmapSurfaceEXT(), the type is
1053 * `Pixmap*`. Convert `Pixmap*` to `Pixmap` because that's what
1054 * dri2_x11_create_pixmap_surface() expects.
1055 */
1056 if (disp && disp->Platform == _EGL_PLATFORM_X11 && native_pixmap != NULL)
1057 return (void *)(* (Pixmap*) native_pixmap);
1058 #endif
1059 return native_pixmap;
1060 }
1061
1062 static EGLSurface
1063 _eglCreatePixmapSurfaceCommon(_EGLDisplay *disp, EGLConfig config,
1064 void *native_pixmap, const EGLint *attrib_list)
1065 {
1066 _EGLConfig *conf = _eglLookupConfig(config, disp);
1067 const _EGLDriver *drv;
1068 _EGLSurface *surf;
1069 EGLSurface ret;
1070
1071 if (disp && (disp->Platform == _EGL_PLATFORM_SURFACELESS ||
1072 disp->Platform == _EGL_PLATFORM_DEVICE)) {
1073 /* From the EGL_MESA_platform_surfaceless spec (v1):
1074 *
1075 * [Like eglCreatePlatformWindowSurface,] eglCreatePlatformPixmapSurface
1076 * also fails when called with a <display> that belongs to the
1077 * surfaceless platform. It returns EGL_NO_SURFACE and generates
1078 * EGL_BAD_NATIVE_PIXMAP.
1079 *
1080 * This check must occur before checking the EGLConfig, which emits
1081 * EGL_BAD_CONFIG.
1082 */
1083 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_PIXMAP, EGL_NO_SURFACE);
1084 }
1085
1086 _EGL_CHECK_CONFIG(disp, conf, EGL_NO_SURFACE, drv);
1087
1088 if ((conf->SurfaceType & EGL_PIXMAP_BIT) == 0)
1089 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_NO_SURFACE);
1090
1091 if (native_pixmap == NULL)
1092 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_PIXMAP, EGL_NO_SURFACE);
1093
1094 if (_eglNativeSurfaceAlreadyUsed(disp, native_pixmap))
1095 RETURN_EGL_ERROR(disp, EGL_BAD_ALLOC, EGL_NO_SURFACE);
1096
1097 surf = drv->CreatePixmapSurface(disp, conf, native_pixmap, attrib_list);
1098 ret = (surf) ? _eglLinkSurface(surf) : EGL_NO_SURFACE;
1099
1100 RETURN_EGL_EVAL(disp, ret);
1101 }
1102
1103
1104 EGLSurface EGLAPIENTRY
1105 eglCreatePixmapSurface(EGLDisplay dpy, EGLConfig config,
1106 EGLNativePixmapType pixmap, const EGLint *attrib_list)
1107 {
1108 _EGLDisplay *disp = _eglLockDisplay(dpy);
1109
1110 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1111 STATIC_ASSERT(sizeof(void*) == sizeof(pixmap));
1112 return _eglCreatePixmapSurfaceCommon(disp, config, (void*) pixmap,
1113 attrib_list);
1114 }
1115
1116 static EGLSurface EGLAPIENTRY
1117 eglCreatePlatformPixmapSurfaceEXT(EGLDisplay dpy, EGLConfig config,
1118 void *native_pixmap,
1119 const EGLint *attrib_list)
1120 {
1121 _EGLDisplay *disp = _eglLockDisplay(dpy);
1122
1123 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1124 native_pixmap = _fixupNativePixmap(disp, native_pixmap);
1125 return _eglCreatePixmapSurfaceCommon(disp, config, native_pixmap,
1126 attrib_list);
1127 }
1128
1129
1130 EGLSurface EGLAPIENTRY
1131 eglCreatePlatformPixmapSurface(EGLDisplay dpy, EGLConfig config,
1132 void *native_pixmap,
1133 const EGLAttrib *attrib_list)
1134 {
1135 _EGLDisplay *disp = _eglLockDisplay(dpy);
1136 EGLSurface surface;
1137 EGLint *int_attribs;
1138
1139 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1140
1141 int_attribs = _eglConvertAttribsToInt(attrib_list);
1142 if (attrib_list && !int_attribs)
1143 RETURN_EGL_ERROR(disp, EGL_BAD_ALLOC, EGL_NO_SURFACE);
1144
1145 native_pixmap = _fixupNativePixmap(disp, native_pixmap);
1146 surface = _eglCreatePixmapSurfaceCommon(disp, config, native_pixmap,
1147 int_attribs);
1148 free(int_attribs);
1149 return surface;
1150 }
1151
1152
1153 EGLSurface EGLAPIENTRY
1154 eglCreatePbufferSurface(EGLDisplay dpy, EGLConfig config,
1155 const EGLint *attrib_list)
1156 {
1157 _EGLDisplay *disp = _eglLockDisplay(dpy);
1158 _EGLConfig *conf = _eglLookupConfig(config, disp);
1159 const _EGLDriver *drv;
1160 _EGLSurface *surf;
1161 EGLSurface ret;
1162
1163 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1164 _EGL_CHECK_CONFIG(disp, conf, EGL_NO_SURFACE, drv);
1165
1166 if ((conf->SurfaceType & EGL_PBUFFER_BIT) == 0)
1167 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_NO_SURFACE);
1168
1169 surf = drv->CreatePbufferSurface(disp, conf, attrib_list);
1170 ret = (surf) ? _eglLinkSurface(surf) : EGL_NO_SURFACE;
1171
1172 RETURN_EGL_EVAL(disp, ret);
1173 }
1174
1175
1176 EGLBoolean EGLAPIENTRY
1177 eglDestroySurface(EGLDisplay dpy, EGLSurface surface)
1178 {
1179 _EGLDisplay *disp = _eglLockDisplay(dpy);
1180 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1181 const _EGLDriver *drv;
1182 EGLBoolean ret;
1183
1184 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1185 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1186 _eglUnlinkSurface(surf);
1187 ret = drv->DestroySurface(disp, surf);
1188
1189 RETURN_EGL_EVAL(disp, ret);
1190 }
1191
1192 EGLBoolean EGLAPIENTRY
1193 eglQuerySurface(EGLDisplay dpy, EGLSurface surface,
1194 EGLint attribute, EGLint *value)
1195 {
1196 _EGLDisplay *disp = _eglLockDisplay(dpy);
1197 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1198 const _EGLDriver *drv;
1199 EGLBoolean ret;
1200
1201 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1202 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1203
1204 if (drv->QuerySurface)
1205 ret = drv->QuerySurface(disp, surf, attribute, value);
1206 else
1207 ret = _eglQuerySurface(disp, surf, attribute, value);
1208
1209 RETURN_EGL_EVAL(disp, ret);
1210 }
1211
1212 EGLBoolean EGLAPIENTRY
1213 eglSurfaceAttrib(EGLDisplay dpy, EGLSurface surface,
1214 EGLint attribute, EGLint value)
1215 {
1216 _EGLDisplay *disp = _eglLockDisplay(dpy);
1217 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1218 const _EGLDriver *drv;
1219 EGLBoolean ret;
1220
1221 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1222 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1223
1224 ret = _eglSurfaceAttrib(drv, disp, surf, attribute, value);
1225
1226 RETURN_EGL_EVAL(disp, ret);
1227 }
1228
1229
1230 EGLBoolean EGLAPIENTRY
1231 eglBindTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer)
1232 {
1233 _EGLDisplay *disp = _eglLockDisplay(dpy);
1234 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1235 const _EGLDriver *drv;
1236 EGLBoolean ret;
1237
1238 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1239 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1240 ret = drv->BindTexImage(disp, surf, buffer);
1241
1242 RETURN_EGL_EVAL(disp, ret);
1243 }
1244
1245
1246 EGLBoolean EGLAPIENTRY
1247 eglReleaseTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer)
1248 {
1249 _EGLDisplay *disp = _eglLockDisplay(dpy);
1250 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1251 const _EGLDriver *drv;
1252 EGLBoolean ret;
1253
1254 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1255 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1256 ret = drv->ReleaseTexImage(disp, surf, buffer);
1257
1258 RETURN_EGL_EVAL(disp, ret);
1259 }
1260
1261
1262 EGLBoolean EGLAPIENTRY
1263 eglSwapInterval(EGLDisplay dpy, EGLint interval)
1264 {
1265 _EGLDisplay *disp = _eglLockDisplay(dpy);
1266 _EGLContext *ctx = _eglGetCurrentContext();
1267 _EGLSurface *surf = ctx ? ctx->DrawSurface : NULL;
1268 const _EGLDriver *drv;
1269 EGLBoolean ret;
1270
1271 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1272 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
1273
1274 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
1275 ctx->Resource.Display != disp)
1276 RETURN_EGL_ERROR(disp, EGL_BAD_CONTEXT, EGL_FALSE);
1277
1278 if (_eglGetSurfaceHandle(surf) == EGL_NO_SURFACE)
1279 RETURN_EGL_ERROR(disp, EGL_BAD_SURFACE, EGL_FALSE);
1280
1281 if (surf->Type != EGL_WINDOW_BIT)
1282 RETURN_EGL_EVAL(disp, EGL_TRUE);
1283
1284 interval = CLAMP(interval,
1285 surf->Config->MinSwapInterval,
1286 surf->Config->MaxSwapInterval);
1287
1288 if (surf->SwapInterval != interval) {
1289 if (drv->SwapInterval)
1290 ret = drv->SwapInterval(disp, surf, interval);
1291 else
1292 ret = _eglSwapInterval(disp, surf, interval);
1293 }
1294 else {
1295 ret = EGL_TRUE;
1296 }
1297
1298 if (ret)
1299 surf->SwapInterval = interval;
1300
1301 RETURN_EGL_EVAL(disp, ret);
1302 }
1303
1304
1305 EGLBoolean EGLAPIENTRY
1306 eglSwapBuffers(EGLDisplay dpy, EGLSurface surface)
1307 {
1308 _EGLContext *ctx = _eglGetCurrentContext();
1309 _EGLDisplay *disp = _eglLockDisplay(dpy);
1310 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1311 const _EGLDriver *drv;
1312 EGLBoolean ret;
1313
1314 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1315 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1316
1317 /* surface must be bound to current context in EGL 1.4 */
1318 #ifndef _EGL_BUILT_IN_DRIVER_HAIKU
1319 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
1320 surf != ctx->DrawSurface)
1321 RETURN_EGL_ERROR(disp, EGL_BAD_SURFACE, EGL_FALSE);
1322 #endif
1323
1324 if (surf->Type != EGL_WINDOW_BIT)
1325 RETURN_EGL_EVAL(disp, EGL_TRUE);
1326
1327 /* From the EGL 1.5 spec:
1328 *
1329 * If eglSwapBuffers is called and the native window associated with
1330 * surface is no longer valid, an EGL_BAD_NATIVE_WINDOW error is
1331 * generated.
1332 */
1333 if (surf->Lost)
1334 RETURN_EGL_ERROR(disp, EGL_BAD_NATIVE_WINDOW, EGL_FALSE);
1335
1336 ret = drv->SwapBuffers(disp, surf);
1337
1338 /* EGL_KHR_partial_update
1339 * Frame boundary successfully reached,
1340 * reset damage region and reset BufferAgeRead
1341 */
1342 if (ret) {
1343 surf->SetDamageRegionCalled = EGL_FALSE;
1344 surf->BufferAgeRead = EGL_FALSE;
1345 }
1346
1347 RETURN_EGL_EVAL(disp, ret);
1348 }
1349
1350
1351 static EGLBoolean
1352 _eglSwapBuffersWithDamageCommon(_EGLDisplay *disp, _EGLSurface *surf,
1353 const EGLint *rects, EGLint n_rects)
1354 {
1355 _EGLContext *ctx = _eglGetCurrentContext();
1356 const _EGLDriver *drv;
1357 EGLBoolean ret;
1358
1359 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1360
1361 /* surface must be bound to current context in EGL 1.4 */
1362 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
1363 surf != ctx->DrawSurface)
1364 RETURN_EGL_ERROR(disp, EGL_BAD_SURFACE, EGL_FALSE);
1365
1366 if (surf->Type != EGL_WINDOW_BIT)
1367 RETURN_EGL_EVAL(disp, EGL_TRUE);
1368
1369 if ((n_rects > 0 && rects == NULL) || n_rects < 0)
1370 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
1371
1372 ret = drv->SwapBuffersWithDamageEXT(disp, surf, rects, n_rects);
1373
1374 /* EGL_KHR_partial_update
1375 * Frame boundary successfully reached,
1376 * reset damage region and reset BufferAgeRead
1377 */
1378 if (ret) {
1379 surf->SetDamageRegionCalled = EGL_FALSE;
1380 surf->BufferAgeRead = EGL_FALSE;
1381 }
1382
1383 RETURN_EGL_EVAL(disp, ret);
1384 }
1385
1386 static EGLBoolean EGLAPIENTRY
1387 eglSwapBuffersWithDamageEXT(EGLDisplay dpy, EGLSurface surface,
1388 const EGLint *rects, EGLint n_rects)
1389 {
1390 _EGLDisplay *disp = _eglLockDisplay(dpy);
1391 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1392 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1393 return _eglSwapBuffersWithDamageCommon(disp, surf, rects, n_rects);
1394 }
1395
1396 static EGLBoolean EGLAPIENTRY
1397 eglSwapBuffersWithDamageKHR(EGLDisplay dpy, EGLSurface surface,
1398 const EGLint *rects, EGLint n_rects)
1399 {
1400 _EGLDisplay *disp = _eglLockDisplay(dpy);
1401 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1402 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1403 return _eglSwapBuffersWithDamageCommon(disp, surf, rects, n_rects);
1404 }
1405
1406 /**
1407 * Clamp the rectangles so that they lie within the surface.
1408 */
1409
1410 static void
1411 _eglSetDamageRegionKHRClampRects(_EGLDisplay* disp, _EGLSurface* surf,
1412 EGLint *rects, EGLint n_rects)
1413 {
1414 EGLint i;
1415 EGLint surf_height = surf->Height;
1416 EGLint surf_width = surf->Width;
1417
1418 for (i = 0; i < (4 * n_rects); i += 4) {
1419 EGLint x1, y1, x2, y2;
1420 x1 = rects[i];
1421 y1 = rects[i + 1];
1422 x2 = rects[i + 2] + x1;
1423 y2 = rects[i + 3] + y1;
1424
1425 rects[i] = CLAMP(x1, 0, surf_width);
1426 rects[i + 1] = CLAMP(y1, 0, surf_height);
1427 rects[i + 2] = CLAMP(x2, 0, surf_width) - rects[i];
1428 rects[i + 3] = CLAMP(y2, 0, surf_height) - rects[i + 1];
1429 }
1430 }
1431
1432 static EGLBoolean EGLAPIENTRY
1433 eglSetDamageRegionKHR(EGLDisplay dpy, EGLSurface surface,
1434 EGLint *rects, EGLint n_rects)
1435 {
1436 _EGLDisplay *disp = _eglLockDisplay(dpy);
1437 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1438 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1439 _EGLContext *ctx = _eglGetCurrentContext();
1440 const _EGLDriver *drv;
1441 EGLBoolean ret;
1442 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1443
1444 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
1445 surf->Type != EGL_WINDOW_BIT ||
1446 ctx->DrawSurface != surf ||
1447 surf->SwapBehavior != EGL_BUFFER_DESTROYED)
1448 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_FALSE);
1449
1450 /* If the damage region is already set or
1451 * buffer age is not queried between
1452 * frame boundaries, throw bad access error
1453 */
1454
1455 if (surf->SetDamageRegionCalled || !surf->BufferAgeRead)
1456 RETURN_EGL_ERROR(disp, EGL_BAD_ACCESS, EGL_FALSE);
1457
1458 _eglSetDamageRegionKHRClampRects(disp, surf, rects, n_rects);
1459 ret = drv->SetDamageRegion(disp, surf, rects, n_rects);
1460
1461 if (ret)
1462 surf->SetDamageRegionCalled = EGL_TRUE;
1463
1464 RETURN_EGL_EVAL(disp, ret);
1465 }
1466
1467 EGLBoolean EGLAPIENTRY
1468 eglCopyBuffers(EGLDisplay dpy, EGLSurface surface, EGLNativePixmapType target)
1469 {
1470 _EGLDisplay *disp = _eglLockDisplay(dpy);
1471 _EGLSurface *surf = _eglLookupSurface(surface, disp);
1472 const _EGLDriver *drv;
1473 EGLBoolean ret;
1474 void *native_pixmap_ptr;
1475
1476 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
1477 STATIC_ASSERT(sizeof(void*) == sizeof(target));
1478 native_pixmap_ptr = (void*) target;
1479
1480 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
1481 ret = drv->CopyBuffers(disp, surf, native_pixmap_ptr);
1482
1483 RETURN_EGL_EVAL(disp, ret);
1484 }
1485
1486
1487 static EGLBoolean
1488 _eglWaitClientCommon(void)
1489 {
1490 _EGLContext *ctx = _eglGetCurrentContext();
1491 _EGLDisplay *disp;
1492 EGLBoolean ret;
1493
1494 if (!ctx)
1495 RETURN_EGL_SUCCESS(NULL, EGL_TRUE);
1496
1497 disp = ctx->Resource.Display;
1498 mtx_lock(&disp->Mutex);
1499
1500 /* let bad current context imply bad current surface */
1501 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
1502 _eglGetSurfaceHandle(ctx->DrawSurface) == EGL_NO_SURFACE)
1503 RETURN_EGL_ERROR(disp, EGL_BAD_CURRENT_SURFACE, EGL_FALSE);
1504
1505 /* a valid current context implies an initialized current display */
1506 assert(disp->Initialized);
1507 ret = disp->Driver->WaitClient(disp, ctx);
1508
1509 RETURN_EGL_EVAL(disp, ret);
1510 }
1511
1512 EGLBoolean EGLAPIENTRY
1513 eglWaitClient(void)
1514 {
1515 _EGL_FUNC_START(NULL, EGL_OBJECT_CONTEXT_KHR, _eglGetCurrentContext(), EGL_FALSE);
1516 return _eglWaitClientCommon();
1517 }
1518
1519 EGLBoolean EGLAPIENTRY
1520 eglWaitGL(void)
1521 {
1522 /* Since we only support OpenGL and GLES, eglWaitGL is equivalent to eglWaitClient. */
1523 _EGL_FUNC_START(NULL, EGL_OBJECT_CONTEXT_KHR, _eglGetCurrentContext(), EGL_FALSE);
1524 return _eglWaitClientCommon();
1525 }
1526
1527
1528 EGLBoolean EGLAPIENTRY
1529 eglWaitNative(EGLint engine)
1530 {
1531 _EGLContext *ctx = _eglGetCurrentContext();
1532 _EGLDisplay *disp;
1533 EGLBoolean ret;
1534
1535 if (!ctx)
1536 RETURN_EGL_SUCCESS(NULL, EGL_TRUE);
1537
1538 _EGL_FUNC_START(NULL, EGL_OBJECT_THREAD_KHR, NULL, EGL_FALSE);
1539
1540 disp = ctx->Resource.Display;
1541 mtx_lock(&disp->Mutex);
1542
1543 /* let bad current context imply bad current surface */
1544 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
1545 _eglGetSurfaceHandle(ctx->DrawSurface) == EGL_NO_SURFACE)
1546 RETURN_EGL_ERROR(disp, EGL_BAD_CURRENT_SURFACE, EGL_FALSE);
1547
1548 /* a valid current context implies an initialized current display */
1549 assert(disp->Initialized);
1550 ret = disp->Driver->WaitNative(engine);
1551
1552 RETURN_EGL_EVAL(disp, ret);
1553 }
1554
1555
1556 EGLDisplay EGLAPIENTRY
1557 eglGetCurrentDisplay(void)
1558 {
1559 _EGLContext *ctx = _eglGetCurrentContext();
1560 EGLDisplay ret;
1561
1562 ret = (ctx) ? _eglGetDisplayHandle(ctx->Resource.Display) : EGL_NO_DISPLAY;
1563
1564 RETURN_EGL_SUCCESS(NULL, ret);
1565 }
1566
1567
1568 EGLContext EGLAPIENTRY
1569 eglGetCurrentContext(void)
1570 {
1571 _EGLContext *ctx = _eglGetCurrentContext();
1572 EGLContext ret;
1573
1574 ret = _eglGetContextHandle(ctx);
1575
1576 RETURN_EGL_SUCCESS(NULL, ret);
1577 }
1578
1579
1580 EGLSurface EGLAPIENTRY
1581 eglGetCurrentSurface(EGLint readdraw)
1582 {
1583 _EGLContext *ctx = _eglGetCurrentContext();
1584 EGLint err = EGL_SUCCESS;
1585 _EGLSurface *surf;
1586 EGLSurface ret;
1587
1588 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_NO_SURFACE);
1589
1590 if (!ctx)
1591 RETURN_EGL_SUCCESS(NULL, EGL_NO_SURFACE);
1592
1593 switch (readdraw) {
1594 case EGL_DRAW:
1595 surf = ctx->DrawSurface;
1596 break;
1597 case EGL_READ:
1598 surf = ctx->ReadSurface;
1599 break;
1600 default:
1601 surf = NULL;
1602 err = EGL_BAD_PARAMETER;
1603 break;
1604 }
1605
1606 ret = _eglGetSurfaceHandle(surf);
1607
1608 RETURN_EGL_ERROR(NULL, err, ret);
1609 }
1610
1611
1612 EGLint EGLAPIENTRY
1613 eglGetError(void)
1614 {
1615 _EGLThreadInfo *t = _eglGetCurrentThread();
1616 EGLint e = t->LastError;
1617 if (!_eglIsCurrentThreadDummy())
1618 t->LastError = EGL_SUCCESS;
1619 return e;
1620 }
1621
1622
1623 /**
1624 ** EGL 1.2
1625 **/
1626
1627 /**
1628 * Specify the client API to use for subsequent calls including:
1629 * eglCreateContext()
1630 * eglGetCurrentContext()
1631 * eglGetCurrentDisplay()
1632 * eglGetCurrentSurface()
1633 * eglMakeCurrent(when the ctx parameter is EGL NO CONTEXT)
1634 * eglWaitClient()
1635 * eglWaitNative()
1636 * See section 3.7 "Rendering Context" in the EGL specification for details.
1637 */
1638 EGLBoolean EGLAPIENTRY
1639 eglBindAPI(EGLenum api)
1640 {
1641 _EGLThreadInfo *t;
1642
1643 _EGL_FUNC_START(NULL, EGL_OBJECT_THREAD_KHR, NULL, EGL_FALSE);
1644
1645 t = _eglGetCurrentThread();
1646 if (_eglIsCurrentThreadDummy())
1647 RETURN_EGL_ERROR(NULL, EGL_BAD_ALLOC, EGL_FALSE);
1648
1649 if (!_eglIsApiValid(api))
1650 RETURN_EGL_ERROR(NULL, EGL_BAD_PARAMETER, EGL_FALSE);
1651
1652 t->CurrentAPI = api;
1653
1654 RETURN_EGL_SUCCESS(NULL, EGL_TRUE);
1655 }
1656
1657
1658 /**
1659 * Return the last value set with eglBindAPI().
1660 */
1661 EGLenum EGLAPIENTRY
1662 eglQueryAPI(void)
1663 {
1664 _EGLThreadInfo *t = _eglGetCurrentThread();
1665 EGLenum ret;
1666
1667 /* returns one of EGL_OPENGL_API, EGL_OPENGL_ES_API or EGL_OPENVG_API */
1668 ret = t->CurrentAPI;
1669
1670 RETURN_EGL_SUCCESS(NULL, ret);
1671 }
1672
1673
1674 EGLSurface EGLAPIENTRY
1675 eglCreatePbufferFromClientBuffer(EGLDisplay dpy, EGLenum buftype,
1676 EGLClientBuffer buffer, EGLConfig config,
1677 const EGLint *attrib_list)
1678 {
1679 _EGLDisplay *disp = _eglLockDisplay(dpy);
1680 _EGLConfig *conf = _eglLookupConfig(config, disp);
1681 const _EGLDriver *drv;
1682
1683 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_SURFACE);
1684
1685 _EGL_CHECK_CONFIG(disp, conf, EGL_NO_SURFACE, drv);
1686
1687 /* OpenVG is not supported */
1688 RETURN_EGL_ERROR(disp, EGL_BAD_ALLOC, EGL_NO_SURFACE);
1689 }
1690
1691
1692 EGLBoolean EGLAPIENTRY
1693 eglReleaseThread(void)
1694 {
1695 /* unbind current contexts */
1696 if (!_eglIsCurrentThreadDummy()) {
1697 _EGLThreadInfo *t = _eglGetCurrentThread();
1698 _EGLContext *ctx = t->CurrentContext;
1699
1700 _EGL_FUNC_START(NULL, EGL_OBJECT_THREAD_KHR, NULL, EGL_FALSE);
1701
1702 if (ctx) {
1703 _EGLDisplay *disp = ctx->Resource.Display;
1704
1705 mtx_lock(&disp->Mutex);
1706 (void) disp->Driver->MakeCurrent(disp, NULL, NULL, NULL);
1707 mtx_unlock(&disp->Mutex);
1708 }
1709 }
1710
1711 _eglDestroyCurrentThread();
1712
1713 RETURN_EGL_SUCCESS(NULL, EGL_TRUE);
1714 }
1715
1716
1717 static EGLImage
1718 _eglCreateImageCommon(_EGLDisplay *disp, EGLContext ctx, EGLenum target,
1719 EGLClientBuffer buffer, const EGLint *attr_list)
1720 {
1721 _EGLContext *context = _eglLookupContext(ctx, disp);
1722 const _EGLDriver *drv;
1723 _EGLImage *img;
1724 EGLImage ret;
1725
1726 _EGL_CHECK_DISPLAY(disp, EGL_NO_IMAGE_KHR, drv);
1727 if (!disp->Extensions.KHR_image_base)
1728 RETURN_EGL_EVAL(disp, EGL_NO_IMAGE_KHR);
1729 if (!context && ctx != EGL_NO_CONTEXT)
1730 RETURN_EGL_ERROR(disp, EGL_BAD_CONTEXT, EGL_NO_IMAGE_KHR);
1731 /* "If <target> is EGL_LINUX_DMA_BUF_EXT, <dpy> must be a valid display,
1732 * <ctx> must be EGL_NO_CONTEXT..."
1733 */
1734 if (ctx != EGL_NO_CONTEXT && target == EGL_LINUX_DMA_BUF_EXT)
1735 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_NO_IMAGE_KHR);
1736
1737 img = drv->CreateImageKHR(drv, disp, context, target,
1738 buffer, attr_list);
1739 ret = (img) ? _eglLinkImage(img) : EGL_NO_IMAGE_KHR;
1740
1741 RETURN_EGL_EVAL(disp, ret);
1742 }
1743
1744 static EGLImage EGLAPIENTRY
1745 eglCreateImageKHR(EGLDisplay dpy, EGLContext ctx, EGLenum target,
1746 EGLClientBuffer buffer, const EGLint *attr_list)
1747 {
1748 _EGLDisplay *disp = _eglLockDisplay(dpy);
1749 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_IMAGE_KHR);
1750 return _eglCreateImageCommon(disp, ctx, target, buffer, attr_list);
1751 }
1752
1753
1754 EGLImage EGLAPIENTRY
1755 eglCreateImage(EGLDisplay dpy, EGLContext ctx, EGLenum target,
1756 EGLClientBuffer buffer, const EGLAttrib *attr_list)
1757 {
1758 _EGLDisplay *disp = _eglLockDisplay(dpy);
1759 EGLImage image;
1760 EGLint *int_attribs;
1761
1762 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_NO_IMAGE_KHR);
1763
1764 int_attribs = _eglConvertAttribsToInt(attr_list);
1765 if (attr_list && !int_attribs)
1766 RETURN_EGL_ERROR(disp, EGL_BAD_ALLOC, EGL_NO_IMAGE);
1767
1768 image = _eglCreateImageCommon(disp, ctx, target, buffer, int_attribs);
1769 free(int_attribs);
1770 return image;
1771 }
1772
1773
1774 static EGLBoolean
1775 _eglDestroyImageCommon(_EGLDisplay *disp, _EGLImage *img)
1776 {
1777 const _EGLDriver *drv;
1778 EGLBoolean ret;
1779
1780 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
1781 if (!disp->Extensions.KHR_image_base)
1782 RETURN_EGL_EVAL(disp, EGL_FALSE);
1783 if (!img)
1784 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
1785
1786 _eglUnlinkImage(img);
1787 ret = drv->DestroyImageKHR(drv, disp, img);
1788
1789 RETURN_EGL_EVAL(disp, ret);
1790 }
1791
1792 EGLBoolean EGLAPIENTRY
1793 eglDestroyImage(EGLDisplay dpy, EGLImage image)
1794 {
1795 _EGLDisplay *disp = _eglLockDisplay(dpy);
1796 _EGLImage *img = _eglLookupImage(image, disp);
1797 _EGL_FUNC_START(disp, EGL_OBJECT_IMAGE_KHR, img, EGL_FALSE);
1798 return _eglDestroyImageCommon(disp, img);
1799 }
1800
1801 static EGLBoolean EGLAPIENTRY
1802 eglDestroyImageKHR(EGLDisplay dpy, EGLImage image)
1803 {
1804 _EGLDisplay *disp = _eglLockDisplay(dpy);
1805 _EGLImage *img = _eglLookupImage(image, disp);
1806 _EGL_FUNC_START(disp, EGL_OBJECT_IMAGE_KHR, img, EGL_FALSE);
1807 return _eglDestroyImageCommon(disp, img);
1808 }
1809
1810
1811 static EGLSync
1812 _eglCreateSync(_EGLDisplay *disp, EGLenum type, const EGLAttrib *attrib_list,
1813 EGLBoolean orig_is_EGLAttrib,
1814 EGLenum invalid_type_error)
1815 {
1816 _EGLContext *ctx = _eglGetCurrentContext();
1817 const _EGLDriver *drv;
1818 _EGLSync *sync;
1819 EGLSync ret;
1820
1821 _EGL_CHECK_DISPLAY(disp, EGL_NO_SYNC_KHR, drv);
1822
1823 if (!disp->Extensions.KHR_cl_event2 && orig_is_EGLAttrib) {
1824 /* There exist two EGLAttrib variants of eglCreateSync*:
1825 * eglCreateSync64KHR which requires EGL_KHR_cl_event2, and eglCreateSync
1826 * which requires EGL 1.5. Here we use the presence of EGL_KHR_cl_event2
1827 * support as a proxy for EGL 1.5 support, even though that's not
1828 * entirely correct (though _eglComputeVersion does the same).
1829 *
1830 * The EGL spec provides no guidance on how to handle unsupported
1831 * functions. EGL_BAD_MATCH seems reasonable.
1832 */
1833 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_NO_SYNC_KHR);
1834 }
1835
1836 /* If type is EGL_SYNC_FENCE and no context is current for the bound API
1837 * (i.e., eglGetCurrentContext returns EGL_NO_CONTEXT ), an EGL_BAD_MATCH
1838 * error is generated.
1839 */
1840 if (!ctx &&
1841 (type == EGL_SYNC_FENCE_KHR || type == EGL_SYNC_NATIVE_FENCE_ANDROID))
1842 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_NO_SYNC_KHR);
1843
1844 /* return an error if the client API doesn't support GL_[OES|MESA]_EGL_sync. */
1845 if (ctx && (ctx->Resource.Display != disp ||
1846 (ctx->ClientAPI != EGL_OPENGL_ES_API &&
1847 ctx->ClientAPI != EGL_OPENGL_API)))
1848 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_NO_SYNC_KHR);
1849
1850 switch (type) {
1851 case EGL_SYNC_FENCE_KHR:
1852 if (!disp->Extensions.KHR_fence_sync)
1853 RETURN_EGL_ERROR(disp, invalid_type_error, EGL_NO_SYNC_KHR);
1854 break;
1855 case EGL_SYNC_REUSABLE_KHR:
1856 if (!disp->Extensions.KHR_reusable_sync)
1857 RETURN_EGL_ERROR(disp, invalid_type_error, EGL_NO_SYNC_KHR);
1858 break;
1859 case EGL_SYNC_CL_EVENT_KHR:
1860 if (!disp->Extensions.KHR_cl_event2)
1861 RETURN_EGL_ERROR(disp, invalid_type_error, EGL_NO_SYNC_KHR);
1862 break;
1863 case EGL_SYNC_NATIVE_FENCE_ANDROID:
1864 if (!disp->Extensions.ANDROID_native_fence_sync)
1865 RETURN_EGL_ERROR(disp, invalid_type_error, EGL_NO_SYNC_KHR);
1866 break;
1867 default:
1868 RETURN_EGL_ERROR(disp, invalid_type_error, EGL_NO_SYNC_KHR);
1869 }
1870
1871 sync = drv->CreateSyncKHR(drv, disp, type, attrib_list);
1872 ret = (sync) ? _eglLinkSync(sync) : EGL_NO_SYNC_KHR;
1873
1874 RETURN_EGL_EVAL(disp, ret);
1875 }
1876
1877
1878 static EGLSync EGLAPIENTRY
1879 eglCreateSyncKHR(EGLDisplay dpy, EGLenum type, const EGLint *int_list)
1880 {
1881 _EGLDisplay *disp = _eglLockDisplay(dpy);
1882 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
1883
1884 EGLSync sync;
1885 EGLAttrib *attrib_list;
1886 EGLint err;
1887
1888 if (sizeof(int_list[0]) == sizeof(attrib_list[0])) {
1889 attrib_list = (EGLAttrib *) int_list;
1890 } else {
1891 err = _eglConvertIntsToAttribs(int_list, &attrib_list);
1892 if (err != EGL_SUCCESS)
1893 RETURN_EGL_ERROR(disp, err, EGL_NO_SYNC);
1894 }
1895
1896 sync = _eglCreateSync(disp, type, attrib_list, EGL_FALSE,
1897 EGL_BAD_ATTRIBUTE);
1898
1899 if (sizeof(int_list[0]) != sizeof(attrib_list[0]))
1900 free(attrib_list);
1901
1902 /* Don't double-unlock the display. _eglCreateSync already unlocked it. */
1903 return sync;
1904 }
1905
1906
1907 static EGLSync EGLAPIENTRY
1908 eglCreateSync64KHR(EGLDisplay dpy, EGLenum type, const EGLAttrib *attrib_list)
1909 {
1910 _EGLDisplay *disp = _eglLockDisplay(dpy);
1911 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
1912 return _eglCreateSync(disp, type, attrib_list, EGL_TRUE,
1913 EGL_BAD_ATTRIBUTE);
1914 }
1915
1916
1917 EGLSync EGLAPIENTRY
1918 eglCreateSync(EGLDisplay dpy, EGLenum type, const EGLAttrib *attrib_list)
1919 {
1920 _EGLDisplay *disp = _eglLockDisplay(dpy);
1921 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
1922 return _eglCreateSync(disp, type, attrib_list, EGL_TRUE,
1923 EGL_BAD_PARAMETER);
1924 }
1925
1926
1927 static EGLBoolean
1928 _eglDestroySync(_EGLDisplay *disp, _EGLSync *s)
1929 {
1930 const _EGLDriver *drv;
1931 EGLBoolean ret;
1932
1933 _EGL_CHECK_SYNC(disp, s, EGL_FALSE, drv);
1934 assert(disp->Extensions.KHR_reusable_sync ||
1935 disp->Extensions.KHR_fence_sync ||
1936 disp->Extensions.ANDROID_native_fence_sync);
1937
1938 _eglUnlinkSync(s);
1939 ret = drv->DestroySyncKHR(drv, disp, s);
1940
1941 RETURN_EGL_EVAL(disp, ret);
1942 }
1943
1944 EGLBoolean EGLAPIENTRY
1945 eglDestroySync(EGLDisplay dpy, EGLSync sync)
1946 {
1947 _EGLDisplay *disp = _eglLockDisplay(dpy);
1948 _EGLSync *s = _eglLookupSync(sync, disp);
1949 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
1950 return _eglDestroySync(disp, s);
1951 }
1952
1953 static EGLBoolean EGLAPIENTRY
1954 eglDestroySyncKHR(EGLDisplay dpy, EGLSync sync)
1955 {
1956 _EGLDisplay *disp = _eglLockDisplay(dpy);
1957 _EGLSync *s = _eglLookupSync(sync, disp);
1958 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
1959 return _eglDestroySync(disp, s);
1960 }
1961
1962
1963 static EGLint
1964 _eglClientWaitSyncCommon(_EGLDisplay *disp, EGLDisplay dpy,
1965 _EGLSync *s, EGLint flags, EGLTime timeout)
1966 {
1967 const _EGLDriver *drv;
1968 EGLint ret;
1969
1970 _EGL_CHECK_SYNC(disp, s, EGL_FALSE, drv);
1971 assert(disp->Extensions.KHR_reusable_sync ||
1972 disp->Extensions.KHR_fence_sync ||
1973 disp->Extensions.ANDROID_native_fence_sync);
1974
1975 if (s->SyncStatus == EGL_SIGNALED_KHR)
1976 RETURN_EGL_EVAL(disp, EGL_CONDITION_SATISFIED_KHR);
1977
1978 /* if sync type is EGL_SYNC_REUSABLE_KHR, dpy should be
1979 * unlocked here to allow other threads also to be able to
1980 * go into waiting state.
1981 */
1982
1983 if (s->Type == EGL_SYNC_REUSABLE_KHR)
1984 _eglUnlockDisplay(dpy);
1985
1986 ret = drv->ClientWaitSyncKHR(drv, disp, s, flags, timeout);
1987
1988 /*
1989 * 'disp' is already unlocked for reusable sync type,
1990 * so passing 'NULL' to bypass unlocking display.
1991 */
1992 if (s->Type == EGL_SYNC_REUSABLE_KHR)
1993 RETURN_EGL_EVAL(NULL, ret);
1994 else
1995 RETURN_EGL_EVAL(disp, ret);
1996 }
1997
1998 EGLint EGLAPIENTRY
1999 eglClientWaitSync(EGLDisplay dpy, EGLSync sync,
2000 EGLint flags, EGLTime timeout)
2001 {
2002 _EGLDisplay *disp = _eglLockDisplay(dpy);
2003 _EGLSync *s = _eglLookupSync(sync, disp);
2004 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2005 return _eglClientWaitSyncCommon(disp, dpy, s, flags, timeout);
2006 }
2007
2008 static EGLint EGLAPIENTRY
2009 eglClientWaitSyncKHR(EGLDisplay dpy, EGLSync sync,
2010 EGLint flags, EGLTime timeout)
2011 {
2012 _EGLDisplay *disp = _eglLockDisplay(dpy);
2013 _EGLSync *s = _eglLookupSync(sync, disp);
2014 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2015 return _eglClientWaitSyncCommon(disp, dpy, s, flags, timeout);
2016 }
2017
2018
2019 static EGLint
2020 _eglWaitSyncCommon(_EGLDisplay *disp, _EGLSync *s, EGLint flags)
2021 {
2022 _EGLContext *ctx = _eglGetCurrentContext();
2023 const _EGLDriver *drv;
2024 EGLint ret;
2025
2026 _EGL_CHECK_SYNC(disp, s, EGL_FALSE, drv);
2027 assert(disp->Extensions.KHR_wait_sync);
2028
2029 /* return an error if the client API doesn't support GL_[OES|MESA]_EGL_sync. */
2030 if (ctx == EGL_NO_CONTEXT ||
2031 (ctx->ClientAPI != EGL_OPENGL_ES_API &&
2032 ctx->ClientAPI != EGL_OPENGL_API))
2033 RETURN_EGL_ERROR(disp, EGL_BAD_MATCH, EGL_FALSE);
2034
2035 /* the API doesn't allow any flags yet */
2036 if (flags != 0)
2037 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2038
2039 ret = drv->WaitSyncKHR(drv, disp, s);
2040
2041 RETURN_EGL_EVAL(disp, ret);
2042 }
2043
2044 static EGLint EGLAPIENTRY
2045 eglWaitSyncKHR(EGLDisplay dpy, EGLSync sync, EGLint flags)
2046 {
2047 _EGLDisplay *disp = _eglLockDisplay(dpy);
2048 _EGLSync *s = _eglLookupSync(sync, disp);
2049 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2050 return _eglWaitSyncCommon(disp, s, flags);
2051 }
2052
2053
2054 EGLBoolean EGLAPIENTRY
2055 eglWaitSync(EGLDisplay dpy, EGLSync sync, EGLint flags)
2056 {
2057 /* The KHR version returns EGLint, while the core version returns
2058 * EGLBoolean. In both cases, the return values can only be EGL_FALSE and
2059 * EGL_TRUE.
2060 */
2061 _EGLDisplay *disp = _eglLockDisplay(dpy);
2062 _EGLSync *s = _eglLookupSync(sync, disp);
2063 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2064 return _eglWaitSyncCommon(disp, s, flags);
2065 }
2066
2067
2068 static EGLBoolean EGLAPIENTRY
2069 eglSignalSyncKHR(EGLDisplay dpy, EGLSync sync, EGLenum mode)
2070 {
2071 _EGLDisplay *disp = _eglLockDisplay(dpy);
2072 _EGLSync *s = _eglLookupSync(sync, disp);
2073 const _EGLDriver *drv;
2074 EGLBoolean ret;
2075
2076 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2077
2078 _EGL_CHECK_SYNC(disp, s, EGL_FALSE, drv);
2079 assert(disp->Extensions.KHR_reusable_sync);
2080 ret = drv->SignalSyncKHR(drv, disp, s, mode);
2081
2082 RETURN_EGL_EVAL(disp, ret);
2083 }
2084
2085
2086 static EGLBoolean
2087 _eglGetSyncAttribCommon(_EGLDisplay *disp, _EGLSync *s, EGLint attribute, EGLAttrib *value)
2088 {
2089 const _EGLDriver *drv;
2090 EGLBoolean ret;
2091
2092 _EGL_CHECK_SYNC(disp, s, EGL_FALSE, drv);
2093 assert(disp->Extensions.KHR_reusable_sync ||
2094 disp->Extensions.KHR_fence_sync ||
2095 disp->Extensions.ANDROID_native_fence_sync);
2096
2097 ret = _eglGetSyncAttrib(drv, disp, s, attribute, value);
2098
2099 RETURN_EGL_EVAL(disp, ret);
2100 }
2101
2102 EGLBoolean EGLAPIENTRY
2103 eglGetSyncAttrib(EGLDisplay dpy, EGLSync sync, EGLint attribute, EGLAttrib *value)
2104 {
2105 _EGLDisplay *disp = _eglLockDisplay(dpy);
2106 _EGLSync *s = _eglLookupSync(sync, disp);
2107 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2108
2109 if (!value)
2110 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2111
2112 return _eglGetSyncAttribCommon(disp, s, attribute, value);
2113 }
2114
2115
2116 static EGLBoolean EGLAPIENTRY
2117 eglGetSyncAttribKHR(EGLDisplay dpy, EGLSync sync, EGLint attribute, EGLint *value)
2118 {
2119 _EGLDisplay *disp = _eglLockDisplay(dpy);
2120 _EGLSync *s = _eglLookupSync(sync, disp);
2121 EGLAttrib attrib;
2122 EGLBoolean result;
2123
2124 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2125
2126 if (!value)
2127 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2128
2129 attrib = *value;
2130 result = _eglGetSyncAttribCommon(disp, s, attribute, &attrib);
2131
2132 /* The EGL_KHR_fence_sync spec says this about eglGetSyncAttribKHR:
2133 *
2134 * If any error occurs, <*value> is not modified.
2135 */
2136 if (result == EGL_FALSE)
2137 return result;
2138
2139 *value = attrib;
2140 return result;
2141 }
2142
2143 static EGLint EGLAPIENTRY
2144 eglDupNativeFenceFDANDROID(EGLDisplay dpy, EGLSync sync)
2145 {
2146 _EGLDisplay *disp = _eglLockDisplay(dpy);
2147 _EGLSync *s = _eglLookupSync(sync, disp);
2148 const _EGLDriver *drv;
2149 EGLBoolean ret;
2150
2151 _EGL_FUNC_START(disp, EGL_OBJECT_SYNC_KHR, s, EGL_FALSE);
2152
2153 /* the spec doesn't seem to specify what happens if the fence
2154 * type is not EGL_SYNC_NATIVE_FENCE_ANDROID, but this seems
2155 * sensible:
2156 */
2157 if (!(s && (s->Type == EGL_SYNC_NATIVE_FENCE_ANDROID)))
2158 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_NO_NATIVE_FENCE_FD_ANDROID);
2159
2160 _EGL_CHECK_SYNC(disp, s, EGL_NO_NATIVE_FENCE_FD_ANDROID, drv);
2161 assert(disp->Extensions.ANDROID_native_fence_sync);
2162 ret = drv->DupNativeFenceFDANDROID(drv, disp, s);
2163
2164 RETURN_EGL_EVAL(disp, ret);
2165 }
2166
2167 static EGLBoolean EGLAPIENTRY
2168 eglSwapBuffersRegionNOK(EGLDisplay dpy, EGLSurface surface,
2169 EGLint numRects, const EGLint *rects)
2170 {
2171 _EGLContext *ctx = _eglGetCurrentContext();
2172 _EGLDisplay *disp = _eglLockDisplay(dpy);
2173 _EGLSurface *surf = _eglLookupSurface(surface, disp);
2174 const _EGLDriver *drv;
2175 EGLBoolean ret;
2176
2177 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
2178
2179 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
2180
2181 if (!disp->Extensions.NOK_swap_region)
2182 RETURN_EGL_EVAL(disp, EGL_FALSE);
2183
2184 /* surface must be bound to current context in EGL 1.4 */
2185 if (_eglGetContextHandle(ctx) == EGL_NO_CONTEXT ||
2186 surf != ctx->DrawSurface)
2187 RETURN_EGL_ERROR(disp, EGL_BAD_SURFACE, EGL_FALSE);
2188
2189 ret = drv->SwapBuffersRegionNOK(disp, surf, numRects, rects);
2190
2191 RETURN_EGL_EVAL(disp, ret);
2192 }
2193
2194
2195 static EGLImage EGLAPIENTRY
2196 eglCreateDRMImageMESA(EGLDisplay dpy, const EGLint *attr_list)
2197 {
2198 _EGLDisplay *disp = _eglLockDisplay(dpy);
2199 const _EGLDriver *drv;
2200 _EGLImage *img;
2201 EGLImage ret;
2202
2203 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
2204
2205 _EGL_CHECK_DISPLAY(disp, EGL_NO_IMAGE_KHR, drv);
2206 if (!disp->Extensions.MESA_drm_image)
2207 RETURN_EGL_EVAL(disp, EGL_NO_IMAGE_KHR);
2208
2209 img = drv->CreateDRMImageMESA(drv, disp, attr_list);
2210 ret = (img) ? _eglLinkImage(img) : EGL_NO_IMAGE_KHR;
2211
2212 RETURN_EGL_EVAL(disp, ret);
2213 }
2214
2215 static EGLBoolean EGLAPIENTRY
2216 eglExportDRMImageMESA(EGLDisplay dpy, EGLImage image,
2217 EGLint *name, EGLint *handle, EGLint *stride)
2218 {
2219 _EGLDisplay *disp = _eglLockDisplay(dpy);
2220 _EGLImage *img = _eglLookupImage(image, disp);
2221 const _EGLDriver *drv;
2222 EGLBoolean ret;
2223
2224 _EGL_FUNC_START(disp, EGL_OBJECT_IMAGE_KHR, img, EGL_FALSE);
2225
2226 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2227 assert(disp->Extensions.MESA_drm_image);
2228
2229 if (!img)
2230 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2231
2232 ret = drv->ExportDRMImageMESA(drv, disp, img, name, handle, stride);
2233
2234 RETURN_EGL_EVAL(disp, ret);
2235 }
2236
2237
2238 struct wl_display;
2239
2240 static EGLBoolean EGLAPIENTRY
2241 eglBindWaylandDisplayWL(EGLDisplay dpy, struct wl_display *display)
2242 {
2243 _EGLDisplay *disp = _eglLockDisplay(dpy);
2244 const _EGLDriver *drv;
2245 EGLBoolean ret;
2246
2247 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
2248
2249 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2250 assert(disp->Extensions.WL_bind_wayland_display);
2251
2252 if (!display)
2253 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2254
2255 ret = drv->BindWaylandDisplayWL(drv, disp, display);
2256
2257 RETURN_EGL_EVAL(disp, ret);
2258 }
2259
2260 static EGLBoolean EGLAPIENTRY
2261 eglUnbindWaylandDisplayWL(EGLDisplay dpy, struct wl_display *display)
2262 {
2263 _EGLDisplay *disp = _eglLockDisplay(dpy);
2264 const _EGLDriver *drv;
2265 EGLBoolean ret;
2266
2267 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
2268
2269 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2270 assert(disp->Extensions.WL_bind_wayland_display);
2271
2272 if (!display)
2273 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2274
2275 ret = drv->UnbindWaylandDisplayWL(drv, disp, display);
2276
2277 RETURN_EGL_EVAL(disp, ret);
2278 }
2279
2280 static EGLBoolean EGLAPIENTRY
2281 eglQueryWaylandBufferWL(EGLDisplay dpy, struct wl_resource *buffer,
2282 EGLint attribute, EGLint *value)
2283 {
2284 _EGLDisplay *disp = _eglLockDisplay(dpy);
2285 const _EGLDriver *drv;
2286 EGLBoolean ret;
2287
2288 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
2289
2290 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2291 assert(disp->Extensions.WL_bind_wayland_display);
2292
2293 if (!buffer)
2294 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2295
2296 ret = drv->QueryWaylandBufferWL(drv, disp, buffer, attribute, value);
2297
2298 RETURN_EGL_EVAL(disp, ret);
2299 }
2300
2301
2302 static struct wl_buffer * EGLAPIENTRY
2303 eglCreateWaylandBufferFromImageWL(EGLDisplay dpy, EGLImage image)
2304 {
2305 _EGLDisplay *disp = _eglLockDisplay(dpy);
2306 _EGLImage *img;
2307 const _EGLDriver *drv;
2308 struct wl_buffer *ret;
2309
2310 _EGL_FUNC_START(disp, EGL_OBJECT_DISPLAY_KHR, NULL, EGL_FALSE);
2311
2312 _EGL_CHECK_DISPLAY(disp, NULL, drv);
2313 if (!disp->Extensions.WL_create_wayland_buffer_from_image)
2314 RETURN_EGL_EVAL(disp, NULL);
2315
2316 img = _eglLookupImage(image, disp);
2317
2318 if (!img)
2319 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, NULL);
2320
2321 ret = drv->CreateWaylandBufferFromImageWL(drv, disp, img);
2322
2323 RETURN_EGL_EVAL(disp, ret);
2324 }
2325
2326 static EGLBoolean EGLAPIENTRY
2327 eglPostSubBufferNV(EGLDisplay dpy, EGLSurface surface,
2328 EGLint x, EGLint y, EGLint width, EGLint height)
2329 {
2330 _EGLDisplay *disp = _eglLockDisplay(dpy);
2331 _EGLSurface *surf = _eglLookupSurface(surface, disp);
2332 const _EGLDriver *drv;
2333 EGLBoolean ret;
2334
2335 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
2336
2337 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
2338
2339 if (!disp->Extensions.NV_post_sub_buffer)
2340 RETURN_EGL_EVAL(disp, EGL_FALSE);
2341
2342 ret = drv->PostSubBufferNV(drv, disp, surf, x, y, width, height);
2343
2344 RETURN_EGL_EVAL(disp, ret);
2345 }
2346
2347 static EGLBoolean EGLAPIENTRY
2348 eglGetSyncValuesCHROMIUM(EGLDisplay dpy, EGLSurface surface,
2349 EGLuint64KHR *ust, EGLuint64KHR *msc,
2350 EGLuint64KHR *sbc)
2351 {
2352 _EGLDisplay *disp = _eglLockDisplay(dpy);
2353 _EGLSurface *surf = _eglLookupSurface(surface, disp);
2354 const _EGLDriver *drv;
2355 EGLBoolean ret;
2356
2357 _EGL_FUNC_START(disp, EGL_OBJECT_SURFACE_KHR, surf, EGL_FALSE);
2358
2359 _EGL_CHECK_SURFACE(disp, surf, EGL_FALSE, drv);
2360 if (!disp->Extensions.CHROMIUM_sync_control)
2361 RETURN_EGL_EVAL(disp, EGL_FALSE);
2362
2363 if (!ust || !msc || !sbc)
2364 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2365
2366 ret = drv->GetSyncValuesCHROMIUM(disp, surf, ust, msc, sbc);
2367
2368 RETURN_EGL_EVAL(disp, ret);
2369 }
2370
2371 static EGLBoolean EGLAPIENTRY
2372 eglExportDMABUFImageQueryMESA(EGLDisplay dpy, EGLImage image,
2373 EGLint *fourcc, EGLint *nplanes,
2374 EGLuint64KHR *modifiers)
2375 {
2376 _EGLDisplay *disp = _eglLockDisplay(dpy);
2377 _EGLImage *img = _eglLookupImage(image, disp);
2378 const _EGLDriver *drv;
2379 EGLBoolean ret;
2380
2381 _EGL_FUNC_START(disp, EGL_OBJECT_IMAGE_KHR, img, EGL_FALSE);
2382
2383 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2384 assert(disp->Extensions.MESA_image_dma_buf_export);
2385
2386 if (!img)
2387 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2388
2389 ret = drv->ExportDMABUFImageQueryMESA(drv, disp, img, fourcc, nplanes,
2390 modifiers);
2391
2392 RETURN_EGL_EVAL(disp, ret);
2393 }
2394
2395 static EGLBoolean EGLAPIENTRY
2396 eglExportDMABUFImageMESA(EGLDisplay dpy, EGLImage image,
2397 int *fds, EGLint *strides, EGLint *offsets)
2398 {
2399 _EGLDisplay *disp = _eglLockDisplay(dpy);
2400 _EGLImage *img = _eglLookupImage(image, disp);
2401 const _EGLDriver *drv;
2402 EGLBoolean ret;
2403
2404 _EGL_FUNC_START(disp, EGL_OBJECT_IMAGE_KHR, img, EGL_FALSE);
2405
2406 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2407 assert(disp->Extensions.MESA_image_dma_buf_export);
2408
2409 if (!img)
2410 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_FALSE);
2411
2412 ret = drv->ExportDMABUFImageMESA(drv, disp, img, fds, strides, offsets);
2413
2414 RETURN_EGL_EVAL(disp, ret);
2415 }
2416
2417 static EGLint EGLAPIENTRY
2418 eglLabelObjectKHR(EGLDisplay dpy, EGLenum objectType, EGLObjectKHR object,
2419 EGLLabelKHR label)
2420 {
2421 _EGLDisplay *disp = NULL;
2422 _EGLResourceType type;
2423
2424 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_BAD_ALLOC);
2425
2426 if (objectType == EGL_OBJECT_THREAD_KHR) {
2427 _EGLThreadInfo *t = _eglGetCurrentThread();
2428
2429 if (!_eglIsCurrentThreadDummy()) {
2430 t->Label = label;
2431 return EGL_SUCCESS;
2432 }
2433
2434 RETURN_EGL_ERROR(NULL, EGL_BAD_ALLOC, EGL_BAD_ALLOC);
2435 }
2436
2437 disp = _eglLockDisplay(dpy);
2438 if (disp == NULL)
2439 RETURN_EGL_ERROR(disp, EGL_BAD_DISPLAY, EGL_BAD_DISPLAY);
2440
2441 if (objectType == EGL_OBJECT_DISPLAY_KHR) {
2442 if (dpy != (EGLDisplay) object)
2443 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_BAD_PARAMETER);
2444
2445 disp->Label = label;
2446 RETURN_EGL_EVAL(disp, EGL_SUCCESS);
2447 }
2448
2449 switch (objectType) {
2450 case EGL_OBJECT_CONTEXT_KHR:
2451 type = _EGL_RESOURCE_CONTEXT;
2452 break;
2453 case EGL_OBJECT_SURFACE_KHR:
2454 type = _EGL_RESOURCE_SURFACE;
2455 break;
2456 case EGL_OBJECT_IMAGE_KHR:
2457 type = _EGL_RESOURCE_IMAGE;
2458 break;
2459 case EGL_OBJECT_SYNC_KHR:
2460 type = _EGL_RESOURCE_SYNC;
2461 break;
2462 case EGL_OBJECT_STREAM_KHR:
2463 default:
2464 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_BAD_PARAMETER);
2465 }
2466
2467 if (_eglCheckResource(object, type, disp)) {
2468 _EGLResource *res = (_EGLResource *) object;
2469
2470 res->Label = label;
2471 RETURN_EGL_EVAL(disp, EGL_SUCCESS);
2472 }
2473
2474 RETURN_EGL_ERROR(disp, EGL_BAD_PARAMETER, EGL_BAD_PARAMETER);
2475 }
2476
2477 static EGLint EGLAPIENTRY
2478 eglDebugMessageControlKHR(EGLDEBUGPROCKHR callback,
2479 const EGLAttrib *attrib_list)
2480 {
2481 unsigned int newEnabled;
2482
2483 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_BAD_ALLOC);
2484
2485 mtx_lock(_eglGlobal.Mutex);
2486
2487 newEnabled = _eglGlobal.debugTypesEnabled;
2488 if (attrib_list != NULL) {
2489 int i;
2490
2491 for (i = 0; attrib_list[i] != EGL_NONE; i += 2) {
2492 switch (attrib_list[i]) {
2493 case EGL_DEBUG_MSG_CRITICAL_KHR:
2494 case EGL_DEBUG_MSG_ERROR_KHR:
2495 case EGL_DEBUG_MSG_WARN_KHR:
2496 case EGL_DEBUG_MSG_INFO_KHR:
2497 if (attrib_list[i + 1])
2498 newEnabled |= DebugBitFromType(attrib_list[i]);
2499 else
2500 newEnabled &= ~DebugBitFromType(attrib_list[i]);
2501 break;
2502 default:
2503 // On error, set the last error code, call the current
2504 // debug callback, and return the error code.
2505 mtx_unlock(_eglGlobal.Mutex);
2506 _eglReportError(EGL_BAD_ATTRIBUTE, NULL,
2507 "Invalid attribute 0x%04lx", (unsigned long) attrib_list[i]);
2508 return EGL_BAD_ATTRIBUTE;
2509 }
2510 }
2511 }
2512
2513 if (callback != NULL) {
2514 _eglGlobal.debugCallback = callback;
2515 _eglGlobal.debugTypesEnabled = newEnabled;
2516 } else {
2517 _eglGlobal.debugCallback = NULL;
2518 _eglGlobal.debugTypesEnabled = _EGL_DEBUG_BIT_CRITICAL | _EGL_DEBUG_BIT_ERROR;
2519 }
2520
2521 mtx_unlock(_eglGlobal.Mutex);
2522 return EGL_SUCCESS;
2523 }
2524
2525 static EGLBoolean EGLAPIENTRY
2526 eglQueryDebugKHR(EGLint attribute, EGLAttrib *value)
2527 {
2528 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_BAD_ALLOC);
2529
2530 mtx_lock(_eglGlobal.Mutex);
2531
2532 switch (attribute) {
2533 case EGL_DEBUG_MSG_CRITICAL_KHR:
2534 case EGL_DEBUG_MSG_ERROR_KHR:
2535 case EGL_DEBUG_MSG_WARN_KHR:
2536 case EGL_DEBUG_MSG_INFO_KHR:
2537 if (_eglGlobal.debugTypesEnabled & DebugBitFromType(attribute))
2538 *value = EGL_TRUE;
2539 else
2540 *value = EGL_FALSE;
2541 break;
2542 case EGL_DEBUG_CALLBACK_KHR:
2543 *value = (EGLAttrib) _eglGlobal.debugCallback;
2544 break;
2545 default:
2546 mtx_unlock(_eglGlobal.Mutex);
2547 _eglReportError(EGL_BAD_ATTRIBUTE, NULL,
2548 "Invalid attribute 0x%04lx", (unsigned long) attribute);
2549 return EGL_FALSE;
2550 }
2551
2552 mtx_unlock(_eglGlobal.Mutex);
2553 return EGL_TRUE;
2554 }
2555
2556 static int
2557 _eglFunctionCompare(const void *key, const void *elem)
2558 {
2559 const char *procname = key;
2560 const struct _egl_entrypoint *entrypoint = elem;
2561 return strcmp(procname, entrypoint->name);
2562 }
2563
2564 static EGLBoolean EGLAPIENTRY
2565 eglQueryDmaBufFormatsEXT(EGLDisplay dpy, EGLint max_formats,
2566 EGLint *formats, EGLint *num_formats)
2567 {
2568 _EGLDisplay *disp = _eglLockDisplay(dpy);
2569 const _EGLDriver *drv;
2570 EGLBoolean ret;
2571
2572 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_FALSE);
2573
2574 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2575
2576 ret = drv->QueryDmaBufFormatsEXT(drv, disp, max_formats, formats,
2577 num_formats);
2578
2579 RETURN_EGL_EVAL(disp, ret);
2580 }
2581
2582 static EGLBoolean EGLAPIENTRY
2583 eglQueryDmaBufModifiersEXT(EGLDisplay dpy, EGLint format, EGLint max_modifiers,
2584 EGLuint64KHR *modifiers, EGLBoolean *external_only,
2585 EGLint *num_modifiers)
2586 {
2587 _EGLDisplay *disp = _eglLockDisplay(dpy);
2588 const _EGLDriver *drv;
2589 EGLBoolean ret;
2590
2591 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_FALSE);
2592
2593 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2594
2595 ret = drv->QueryDmaBufModifiersEXT(drv, disp, format, max_modifiers,
2596 modifiers, external_only,
2597 num_modifiers);
2598
2599 RETURN_EGL_EVAL(disp, ret);
2600 }
2601
2602 static void EGLAPIENTRY
2603 eglSetBlobCacheFuncsANDROID(EGLDisplay *dpy, EGLSetBlobFuncANDROID set,
2604 EGLGetBlobFuncANDROID get)
2605 {
2606 /* This function does not return anything so we cannot
2607 * utilize the helper macros _EGL_FUNC_START or _EGL_CHECK_DISPLAY.
2608 */
2609 _EGLDisplay *disp = _eglLockDisplay(dpy);
2610 if (!_eglSetFuncName(__func__, disp, EGL_OBJECT_DISPLAY_KHR, NULL)) {
2611 if (disp)
2612 _eglUnlockDisplay(disp);
2613 return;
2614 }
2615
2616 const _EGLDriver *drv = _eglCheckDisplay(disp, __func__);
2617 if (!drv) {
2618 if (disp)
2619 _eglUnlockDisplay(disp);
2620 return;
2621 }
2622
2623 if (!set || !get) {
2624 _eglError(EGL_BAD_PARAMETER,
2625 "eglSetBlobCacheFuncsANDROID: NULL handler given");
2626 _eglUnlockDisplay(disp);
2627 return;
2628 }
2629
2630 if (disp->BlobCacheSet) {
2631 _eglError(EGL_BAD_PARAMETER,
2632 "eglSetBlobCacheFuncsANDROID: functions already set");
2633 _eglUnlockDisplay(disp);
2634 return;
2635 }
2636
2637 disp->BlobCacheSet = set;
2638 disp->BlobCacheGet = get;
2639
2640 drv->SetBlobCacheFuncsANDROID(drv, disp, set, get);
2641
2642 _eglUnlockDisplay(disp);
2643 }
2644
2645 static EGLBoolean EGLAPIENTRY
2646 eglQueryDeviceAttribEXT(EGLDeviceEXT device,
2647 EGLint attribute,
2648 EGLAttrib *value)
2649 {
2650 _EGLDevice *dev = _eglLookupDevice(device);
2651 EGLBoolean ret;
2652
2653 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_FALSE);
2654 if (!dev)
2655 RETURN_EGL_ERROR(NULL, EGL_BAD_DEVICE_EXT, EGL_FALSE);
2656
2657 ret = _eglQueryDeviceAttribEXT(dev, attribute, value);
2658 RETURN_EGL_EVAL(NULL, ret);
2659 }
2660
2661 static const char * EGLAPIENTRY
2662 eglQueryDeviceStringEXT(EGLDeviceEXT device,
2663 EGLint name)
2664 {
2665 _EGLDevice *dev = _eglLookupDevice(device);
2666
2667 _EGL_FUNC_START(NULL, EGL_NONE, NULL, NULL);
2668 if (!dev)
2669 RETURN_EGL_ERROR(NULL, EGL_BAD_DEVICE_EXT, NULL);
2670
2671 RETURN_EGL_EVAL(NULL, _eglQueryDeviceStringEXT(dev, name));
2672 }
2673
2674 static EGLBoolean EGLAPIENTRY
2675 eglQueryDevicesEXT(EGLint max_devices,
2676 EGLDeviceEXT *devices,
2677 EGLint *num_devices)
2678 {
2679 EGLBoolean ret;
2680
2681 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_FALSE);
2682 ret = _eglQueryDevicesEXT(max_devices, (_EGLDevice **) devices,
2683 num_devices);
2684 RETURN_EGL_EVAL(NULL, ret);
2685 }
2686
2687 static EGLBoolean EGLAPIENTRY
2688 eglQueryDisplayAttribEXT(EGLDisplay dpy,
2689 EGLint attribute,
2690 EGLAttrib *value)
2691 {
2692 _EGLDisplay *disp = _eglLockDisplay(dpy);
2693 const _EGLDriver *drv;
2694
2695 _EGL_FUNC_START(NULL, EGL_NONE, NULL, EGL_FALSE);
2696 _EGL_CHECK_DISPLAY(disp, EGL_FALSE, drv);
2697
2698 switch (attribute) {
2699 case EGL_DEVICE_EXT:
2700 *value = (EGLAttrib) disp->Device;
2701 break;
2702 default:
2703 RETURN_EGL_ERROR(disp, EGL_BAD_ATTRIBUTE, EGL_FALSE);
2704 }
2705 RETURN_EGL_SUCCESS(disp, EGL_TRUE);
2706 }
2707
2708 static char * EGLAPIENTRY
2709 eglGetDisplayDriverConfig(EGLDisplay dpy)
2710 {
2711 _EGLDisplay *disp = _eglLockDisplay(dpy);
2712 const _EGLDriver *drv;
2713 char *ret;
2714
2715 _EGL_FUNC_START(disp, EGL_NONE, NULL, NULL);
2716 _EGL_CHECK_DISPLAY(disp, NULL, drv);
2717
2718 assert(disp->Extensions.MESA_query_driver);
2719
2720 ret = drv->QueryDriverConfig(disp);
2721 RETURN_EGL_EVAL(disp, ret);
2722 }
2723
2724 static const char * EGLAPIENTRY
2725 eglGetDisplayDriverName(EGLDisplay dpy)
2726 {
2727 _EGLDisplay *disp = _eglLockDisplay(dpy);
2728 const _EGLDriver *drv;
2729 const char *ret;
2730
2731 _EGL_FUNC_START(disp, EGL_NONE, NULL, NULL);
2732 _EGL_CHECK_DISPLAY(disp, NULL, drv);
2733
2734 assert(disp->Extensions.MESA_query_driver);
2735
2736 ret = drv->QueryDriverName(disp);
2737 RETURN_EGL_EVAL(disp, ret);
2738 }
2739
2740 __eglMustCastToProperFunctionPointerType EGLAPIENTRY
2741 eglGetProcAddress(const char *procname)
2742 {
2743 static const struct _egl_entrypoint egl_functions[] = {
2744 #define EGL_ENTRYPOINT(f) { .name = #f, .function = (_EGLProc) f },
2745 #include "eglentrypoint.h"
2746 #undef EGL_ENTRYPOINT
2747 };
2748 _EGLProc ret = NULL;
2749
2750 if (!procname)
2751 RETURN_EGL_SUCCESS(NULL, NULL);
2752
2753 _EGL_FUNC_START(NULL, EGL_NONE, NULL, NULL);
2754
2755 if (strncmp(procname, "egl", 3) == 0) {
2756 const struct _egl_entrypoint *entrypoint =
2757 bsearch(procname,
2758 egl_functions, ARRAY_SIZE(egl_functions),
2759 sizeof(egl_functions[0]),
2760 _eglFunctionCompare);
2761 if (entrypoint)
2762 ret = entrypoint->function;
2763 }
2764
2765 if (!ret)
2766 ret = _eglGetDriverProc(procname);
2767
2768 RETURN_EGL_SUCCESS(NULL, ret);
2769 }
2770
2771 static int
2772 _eglLockDisplayInterop(EGLDisplay dpy, EGLContext context,
2773 _EGLDisplay **disp, const _EGLDriver **drv,
2774 _EGLContext **ctx)
2775 {
2776
2777 *disp = _eglLockDisplay(dpy);
2778 if (!*disp || !(*disp)->Initialized || !(*disp)->Driver) {
2779 if (*disp)
2780 _eglUnlockDisplay(*disp);
2781 return MESA_GLINTEROP_INVALID_DISPLAY;
2782 }
2783
2784 *drv = (*disp)->Driver;
2785
2786 *ctx = _eglLookupContext(context, *disp);
2787 if (!*ctx ||
2788 ((*ctx)->ClientAPI != EGL_OPENGL_API &&
2789 (*ctx)->ClientAPI != EGL_OPENGL_ES_API)) {
2790 _eglUnlockDisplay(*disp);
2791 return MESA_GLINTEROP_INVALID_CONTEXT;
2792 }
2793
2794 return MESA_GLINTEROP_SUCCESS;
2795 }
2796
2797 PUBLIC int
2798 MesaGLInteropEGLQueryDeviceInfo(EGLDisplay dpy, EGLContext context,
2799 struct mesa_glinterop_device_info *out)
2800 {
2801 _EGLDisplay *disp;
2802 const _EGLDriver *drv;
2803 _EGLContext *ctx;
2804 int ret;
2805
2806 ret = _eglLockDisplayInterop(dpy, context, &disp, &drv, &ctx);
2807 if (ret != MESA_GLINTEROP_SUCCESS)
2808 return ret;
2809
2810 if (drv->GLInteropQueryDeviceInfo)
2811 ret = drv->GLInteropQueryDeviceInfo(disp, ctx, out);
2812 else
2813 ret = MESA_GLINTEROP_UNSUPPORTED;
2814
2815 _eglUnlockDisplay(disp);
2816 return ret;
2817 }
2818
2819 PUBLIC int
2820 MesaGLInteropEGLExportObject(EGLDisplay dpy, EGLContext context,
2821 struct mesa_glinterop_export_in *in,
2822 struct mesa_glinterop_export_out *out)
2823 {
2824 _EGLDisplay *disp;
2825 const _EGLDriver *drv;
2826 _EGLContext *ctx;
2827 int ret;
2828
2829 ret = _eglLockDisplayInterop(dpy, context, &disp, &drv, &ctx);
2830 if (ret != MESA_GLINTEROP_SUCCESS)
2831 return ret;
2832
2833 if (drv->GLInteropExportObject)
2834 ret = drv->GLInteropExportObject(disp, ctx, in, out);
2835 else
2836 ret = MESA_GLINTEROP_UNSUPPORTED;
2837
2838 _eglUnlockDisplay(disp);
2839 return ret;
2840 }