src/egl/main/eglapi.c

   1 /**
   2  * Public EGL API entrypoints
   3  *
   4  * Generally, we use the EGLDisplay parameter as a key to lookup the
   5  * appropriate device driver handle, then jump though the driver's
   6  * dispatch table to handle the function.
   7  *
   8  * That allows us the option of supporting multiple, simultaneous,
   9  * heterogeneous hardware devices in the future.
  10  *
  11  * The EGLDisplay, EGLConfig, EGLContext and EGLSurface types are
  12  * opaque handles. Internal objects are linked to a display to
  13  * create the handles.
  14  *
  15  * For each public API entry point, the opaque handles are looked up
  16  * before being dispatched to the drivers.  When it fails to look up
  17  * a handle, one of
  18  *
  19  * EGL_BAD_DISPLAY
  20  * EGL_BAD_CONFIG
  21  * EGL_BAD_CONTEXT
  22  * EGL_BAD_SURFACE
  23  * EGL_BAD_SCREEN_MESA
  24  * EGL_BAD_MODE_MESA
  25  *
  26  * is generated and the driver function is not called. An
  27  * uninitialized EGLDisplay has no driver associated with it. When
  28  * such display is detected,
  29  *
  30  * EGL_NOT_INITIALIZED
  31  *
  32  * is generated.
  33  *
  34  * Some of the entry points use current display, context, or surface
  35  * implicitly.  For such entry points, the implicit objects are also
  36  * checked before calling the driver function.  Other than the
  37  * errors listed above,
  38  *
  39  * EGL_BAD_CURRENT_SURFACE
  40  *
  41  * may also be generated.
  42  *
  43  * Notes on naming conventions:
  44  *
  45  * eglFooBar    - public EGL function
  46  * EGL_FOO_BAR  - public EGL token
  47  * EGLDatatype  - public EGL datatype
  48  *
  49  * _eglFooBar   - private EGL function
  50  * _EGLDatatype - private EGL datatype, typedef'd struct
  51  * _egl_struct  - private EGL struct, non-typedef'd
  52  *
  53  */
  54
  55
  56 #include <stdio.h>
  57 #include <stdlib.h>
  58 #include <string.h>
  59 #include "eglcontext.h"
  60 #include "egldisplay.h"
  61 #include "egltypedefs.h"
  62 #include "eglglobals.h"
  63 #include "egldriver.h"
  64 #include "eglsurface.h"
  65 #include "eglconfig.h"
  66 #include "eglscreen.h"
  67 #include "eglmode.h"
  68
  69
  70 /**
  71  * This is typically the first EGL function that an application calls.
  72  * We initialize our global vars and create a private _EGLDisplay object.
  73  */
  74 EGLDisplay EGLAPIENTRY
  75 eglGetDisplay(NativeDisplayType nativeDisplay)
  76 {
  77    _EGLDisplay *dpy;
  78    dpy = _eglFindDisplay(nativeDisplay);
  79    if (!dpy) {
  80       dpy = _eglNewDisplay(nativeDisplay);
  81       if (dpy)
  82          _eglLinkDisplay(dpy);
  83    }
  84    return _eglGetDisplayHandle(dpy);
  85 }
  86
  87
  88 /**
  89  * This is typically the second EGL function that an application calls.
  90  * Here we load/initialize the actual hardware driver.
  91  */
  92 EGLBoolean EGLAPIENTRY
  93 eglInitialize(EGLDisplay dpy, EGLint *major, EGLint *minor)
  94 {
  95    _EGLDisplay *disp = _eglLookupDisplay(dpy);
  96    _EGLDriver *drv;
  97    EGLint major_int, minor_int;
  98
  99    if (!disp)
 100       return _eglError(EGL_BAD_DISPLAY, __FUNCTION__);
 101
 102    drv = disp->Driver;
 103    if (!drv) {
 104       drv = _eglOpenDriver(disp);
 105       if (!drv)
 106          return _eglError(EGL_NOT_INITIALIZED, __FUNCTION__);
 107
 108       /* Initialize the particular display now */
 109       if (!drv->API.Initialize(drv, disp, &major_int, &minor_int)) {
 110          _eglCloseDriver(drv, disp);
 111          return _eglError(EGL_NOT_INITIALIZED, __FUNCTION__);
 112       }
 113
 114       disp->APImajor = major_int;
 115       disp->APIminor = minor_int;
 116       snprintf(disp->Version, sizeof(disp->Version),
 117                "%d.%d (%s)", major_int, minor_int, drv->Name);
 118
 119       /* limit to APIs supported by core */
 120       disp->ClientAPIsMask &= _EGL_API_ALL_BITS;
 121
 122       disp->Driver = drv;
 123    } else {
 124       major_int = disp->APImajor;
 125       minor_int = disp->APIminor;
 126    }
 127
 128    /* Update applications version of major and minor if not NULL */
 129    if ((major != NULL) && (minor != NULL)) {
 130       *major = major_int;
 131       *minor = minor_int;
 132    }
 133
 134    return EGL_TRUE;
 135 }
 136
 137
 138 EGLBoolean EGLAPIENTRY
 139 eglTerminate(EGLDisplay dpy)
 140 {
 141    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 142    _EGLDriver *drv;
 143
 144    if (!disp)
 145       return _eglError(EGL_BAD_DISPLAY, __FUNCTION__);
 146
 147    drv = disp->Driver;
 148    if (drv) {
 149       drv->API.Terminate(drv, disp);
 150       _eglCloseDriver(drv, disp);
 151       disp->Driver = NULL;
 152    }
 153
 154    return EGL_TRUE;
 155 }
 156
 157
 158 /**
 159  * A bunch of check functions and declare macros to simply error checking.
 160  */
 161 static INLINE _EGLDriver *
 162 _eglCheckDisplay(_EGLDisplay *disp, const char *msg)
 163 {
 164    if (!disp) {
 165       _eglError(EGL_BAD_DISPLAY, msg);
 166       return NULL;
 167    }
 168    if (!disp->Driver) {
 169       _eglError(EGL_NOT_INITIALIZED, msg);
 170       return NULL;
 171    }
 172    return disp->Driver;
 173 }
 174
 175
 176 static INLINE _EGLDriver *
 177 _eglCheckSurface(_EGLDisplay *disp, _EGLSurface *surf, const char *msg)
 178 {
 179    _EGLDriver *drv = _eglCheckDisplay(disp, msg);
 180    if (!drv)
 181       return NULL;
 182    if (!surf) {
 183       _eglError(EGL_BAD_SURFACE, msg);
 184       return NULL;
 185    }
 186    return drv;
 187 }
 188
 189
 190 static INLINE _EGLDriver *
 191 _eglCheckContext(_EGLDisplay *disp, _EGLContext *context, const char *msg)
 192 {
 193    _EGLDriver *drv = _eglCheckDisplay(disp, msg);
 194    if (!drv)
 195       return NULL;
 196    if (!context) {
 197       _eglError(EGL_BAD_CONTEXT, msg);
 198       return NULL;
 199    }
 200    return drv;
 201 }
 202
 203
 204 static INLINE _EGLDriver *
 205 _eglCheckConfig(_EGLDisplay *disp, _EGLConfig *conf, const char *msg)
 206 {
 207    _EGLDriver *drv = _eglCheckDisplay(disp, msg);
 208    if (!drv)
 209       return NULL;
 210    if (!conf) {
 211       _eglError(EGL_BAD_CONFIG, msg);
 212       return NULL;
 213    }
 214    return drv;
 215 }
 216
 217
 218 #define _EGL_DECLARE_DD(dpy)                                   \
 219    _EGLDisplay *disp = _eglLookupDisplay(dpy);                 \
 220    _EGLDriver *drv;                                            \
 221    do {                                                        \
 222       drv = _eglCheckDisplay(disp, __FUNCTION__);              \
 223       if (!drv)                                                \
 224          return EGL_FALSE;                                     \
 225    } while (0)
 226
 227
 228 #define _EGL_DECLARE_DD_AND_SURFACE(dpy, surface)              \
 229    _EGLDisplay *disp = _eglLookupDisplay(dpy);                 \
 230    _EGLSurface *surf = _eglLookupSurface((surface), disp);     \
 231    _EGLDriver *drv;                                            \
 232    do {                                                        \
 233       drv = _eglCheckSurface(disp, surf, __FUNCTION__);        \
 234       if (!drv)                                                \
 235          return EGL_FALSE;                                     \
 236    } while (0)
 237
 238
 239 #define _EGL_DECLARE_DD_AND_CONTEXT(dpy, ctx)                  \
 240    _EGLDisplay *disp = _eglLookupDisplay(dpy);                 \
 241    _EGLContext *context = _eglLookupContext((ctx), disp);      \
 242    _EGLDriver *drv;                                            \
 243    do {                                                        \
 244       drv = _eglCheckContext(disp, context, __FUNCTION__);     \
 245       if (!drv)                                                \
 246          return EGL_FALSE;                                     \
 247    } while (0)
 248
 249
 250 #ifdef EGL_MESA_screen_surface
 251
 252
 253 static INLINE _EGLDriver *
 254 _eglCheckScreen(_EGLDisplay *disp, _EGLScreen *scrn, const char *msg)
 255 {
 256    _EGLDriver *drv = _eglCheckDisplay(disp, msg);
 257    if (!drv)
 258       return NULL;
 259    if (!scrn) {
 260       _eglError(EGL_BAD_SCREEN_MESA, msg);
 261       return NULL;
 262    }
 263    return drv;
 264 }
 265
 266
 267 static INLINE _EGLDriver *
 268 _eglCheckMode(_EGLDisplay *disp, _EGLMode *m, const char *msg)
 269 {
 270    _EGLDriver *drv = _eglCheckDisplay(disp, msg);
 271    if (!drv)
 272       return NULL;
 273    if (!m) {
 274       _eglError(EGL_BAD_MODE_MESA, msg);
 275       return NULL;
 276    }
 277    return drv;
 278 }
 279
 280
 281 #define _EGL_DECLARE_DD_AND_SCREEN(dpy, screen)                \
 282    _EGLDisplay *disp = _eglLookupDisplay(dpy);                 \
 283    _EGLScreen *scrn = _eglLookupScreen((screen), disp);        \
 284    _EGLDriver *drv;                                            \
 285    do {                                                        \
 286       drv = _eglCheckScreen(disp, scrn, __FUNCTION__);         \
 287       if (!drv)                                                \
 288          return EGL_FALSE;                                     \
 289    } while (0)
 290
 291
 292 #define _EGL_DECLARE_DD_AND_MODE(dpy, mode)                    \
 293    _EGLDisplay *disp = _eglLookupDisplay(dpy);                 \
 294    _EGLMode *m = _eglLookupMode((mode), disp);                 \
 295    _EGLDriver *drv;                                            \
 296    do {                                                        \
 297       drv = _eglCheckMode(disp, m, __FUNCTION__);              \
 298       if (!drv)                                                \
 299          return EGL_FALSE;                                     \
 300    } while (0)
 301
 302
 303 #endif /* EGL_MESA_screen_surface */
 304
 305
 306 const char * EGLAPIENTRY
 307 eglQueryString(EGLDisplay dpy, EGLint name)
 308 {
 309    _EGL_DECLARE_DD(dpy);
 310    return drv->API.QueryString(drv, disp, name);
 311 }
 312
 313
 314 EGLBoolean EGLAPIENTRY
 315 eglGetConfigs(EGLDisplay dpy, EGLConfig *configs,
 316               EGLint config_size, EGLint *num_config)
 317 {
 318    _EGL_DECLARE_DD(dpy);
 319    return drv->API.GetConfigs(drv, disp, configs, config_size, num_config);
 320 }
 321
 322
 323 EGLBoolean EGLAPIENTRY
 324 eglChooseConfig(EGLDisplay dpy, const EGLint *attrib_list, EGLConfig *configs,
 325                 EGLint config_size, EGLint *num_config)
 326 {
 327    _EGL_DECLARE_DD(dpy);
 328    return drv->API.ChooseConfig(drv, disp, attrib_list, configs,
 329                                 config_size, num_config);
 330 }
 331
 332
 333 EGLBoolean EGLAPIENTRY
 334 eglGetConfigAttrib(EGLDisplay dpy, EGLConfig config,
 335                    EGLint attribute, EGLint *value)
 336 {
 337    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 338    _EGLConfig *conf = _eglLookupConfig(config, disp);
 339    _EGLDriver *drv;
 340
 341    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 342    if (!drv)
 343       return EGL_FALSE;
 344
 345    return drv->API.GetConfigAttrib(drv, disp, conf, attribute, value);
 346 }
 347
 348
 349 EGLContext EGLAPIENTRY
 350 eglCreateContext(EGLDisplay dpy, EGLConfig config, EGLContext share_list,
 351                  const EGLint *attrib_list)
 352 {
 353    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 354    _EGLConfig *conf = _eglLookupConfig(config, disp);
 355    _EGLContext *share = _eglLookupContext(share_list, disp);
 356    _EGLDriver *drv;
 357    _EGLContext *context;
 358
 359    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 360    if (!drv)
 361       return EGL_NO_CONTEXT;
 362    if (!share && share_list != EGL_NO_CONTEXT) {
 363       _eglError(EGL_BAD_CONTEXT, __FUNCTION__);
 364       return EGL_NO_CONTEXT;
 365    }
 366
 367    context = drv->API.CreateContext(drv, disp, conf, share, attrib_list);
 368    if (context)
 369       return _eglLinkContext(context, disp);
 370    else
 371       return EGL_NO_CONTEXT;
 372 }
 373
 374
 375 EGLBoolean EGLAPIENTRY
 376 eglDestroyContext(EGLDisplay dpy, EGLContext ctx)
 377 {
 378    _EGL_DECLARE_DD_AND_CONTEXT(dpy, ctx);
 379    _eglUnlinkContext(context);
 380    return drv->API.DestroyContext(drv, disp, context);
 381 }
 382
 383
 384 EGLBoolean EGLAPIENTRY
 385 eglMakeCurrent(EGLDisplay dpy, EGLSurface draw, EGLSurface read,
 386                EGLContext ctx)
 387 {
 388    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 389    _EGLContext *context = _eglLookupContext(ctx, disp);
 390    _EGLSurface *draw_surf = _eglLookupSurface(draw, disp);
 391    _EGLSurface *read_surf = _eglLookupSurface(read, disp);
 392    _EGLDriver *drv;
 393
 394    drv = _eglCheckDisplay(disp, __FUNCTION__);
 395    if (!drv)
 396       return EGL_FALSE;
 397    if (!context && ctx != EGL_NO_CONTEXT)
 398       return _eglError(EGL_BAD_CONTEXT, __FUNCTION__);
 399    if ((!draw_surf && draw != EGL_NO_SURFACE) ||
 400        (!read_surf && read != EGL_NO_SURFACE))
 401       return _eglError(EGL_BAD_SURFACE, __FUNCTION__);
 402
 403    return drv->API.MakeCurrent(drv, disp, draw_surf, read_surf, context);
 404 }
 405
 406
 407 EGLBoolean EGLAPIENTRY
 408 eglQueryContext(EGLDisplay dpy, EGLContext ctx,
 409                 EGLint attribute, EGLint *value)
 410 {
 411    _EGL_DECLARE_DD_AND_CONTEXT(dpy, ctx);
 412    return drv->API.QueryContext(drv, disp, context, attribute, value);
 413 }
 414
 415
 416 EGLSurface EGLAPIENTRY
 417 eglCreateWindowSurface(EGLDisplay dpy, EGLConfig config,
 418                        NativeWindowType window, const EGLint *attrib_list)
 419 {
 420    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 421    _EGLConfig *conf = _eglLookupConfig(config, disp);
 422    _EGLDriver *drv;
 423    _EGLSurface *surf;
 424
 425    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 426    if (!drv)
 427       return EGL_NO_SURFACE;
 428
 429    surf = drv->API.CreateWindowSurface(drv, disp, conf, window, attrib_list);
 430    if (surf)
 431       return _eglLinkSurface(surf, disp);
 432    else
 433       return EGL_NO_SURFACE;
 434 }
 435
 436
 437 EGLSurface EGLAPIENTRY
 438 eglCreatePixmapSurface(EGLDisplay dpy, EGLConfig config,
 439                        NativePixmapType pixmap, const EGLint *attrib_list)
 440 {
 441    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 442    _EGLConfig *conf = _eglLookupConfig(config, disp);
 443    _EGLDriver *drv;
 444    _EGLSurface *surf;
 445
 446    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 447    if (!drv)
 448       return EGL_NO_SURFACE;
 449
 450    surf = drv->API.CreatePixmapSurface(drv, disp, conf, pixmap, attrib_list);
 451    if (surf)
 452       return _eglLinkSurface(surf, disp);
 453    else
 454       return EGL_NO_SURFACE;
 455 }
 456
 457
 458 EGLSurface EGLAPIENTRY
 459 eglCreatePbufferSurface(EGLDisplay dpy, EGLConfig config,
 460                         const EGLint *attrib_list)
 461 {
 462    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 463    _EGLConfig *conf = _eglLookupConfig(config, disp);
 464    _EGLDriver *drv;
 465    _EGLSurface *surf;
 466
 467    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 468    if (!drv)
 469       return EGL_NO_SURFACE;
 470
 471    surf = drv->API.CreatePbufferSurface(drv, disp, conf, attrib_list);
 472    if (surf)
 473       return _eglLinkSurface(surf, disp);
 474    else
 475       return EGL_NO_SURFACE;
 476 }
 477
 478
 479 EGLBoolean EGLAPIENTRY
 480 eglDestroySurface(EGLDisplay dpy, EGLSurface surface)
 481 {
 482    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 483    _eglUnlinkSurface(surf);
 484    return drv->API.DestroySurface(drv, disp, surf);
 485 }
 486
 487 EGLBoolean EGLAPIENTRY
 488 eglQuerySurface(EGLDisplay dpy, EGLSurface surface,
 489                 EGLint attribute, EGLint *value)
 490 {
 491    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 492    return drv->API.QuerySurface(drv, disp, surf, attribute, value);
 493 }
 494
 495 EGLBoolean EGLAPIENTRY
 496 eglSurfaceAttrib(EGLDisplay dpy, EGLSurface surface,
 497                  EGLint attribute, EGLint value)
 498 {
 499    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 500    return drv->API.SurfaceAttrib(drv, disp, surf, attribute, value);
 501 }
 502
 503
 504 EGLBoolean EGLAPIENTRY
 505 eglBindTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer)
 506 {
 507    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 508    return drv->API.BindTexImage(drv, disp, surf, buffer);
 509 }
 510
 511
 512 EGLBoolean EGLAPIENTRY
 513 eglReleaseTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer)
 514 {
 515    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 516    return drv->API.ReleaseTexImage(drv, disp, surf, buffer);
 517 }
 518
 519
 520 EGLBoolean EGLAPIENTRY
 521 eglSwapInterval(EGLDisplay dpy, EGLint interval)
 522 {
 523    _EGL_DECLARE_DD(dpy);
 524    return drv->API.SwapInterval(drv, disp, interval);
 525 }
 526
 527
 528 EGLBoolean EGLAPIENTRY
 529 eglSwapBuffers(EGLDisplay dpy, EGLSurface surface)
 530 {
 531    _EGLContext *ctx = _eglGetCurrentContext();
 532    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 533
 534    /* surface must be bound to current context in EGL 1.4 */
 535    if (!ctx || !_eglIsContextLinked(ctx) || surf != ctx->DrawSurface)
 536       return _eglError(EGL_BAD_SURFACE, __FUNCTION__);
 537
 538    return drv->API.SwapBuffers(drv, disp, surf);
 539 }
 540
 541
 542 EGLBoolean EGLAPIENTRY
 543 eglCopyBuffers(EGLDisplay dpy, EGLSurface surface, NativePixmapType target)
 544 {
 545    _EGL_DECLARE_DD_AND_SURFACE(dpy, surface);
 546    return drv->API.CopyBuffers(drv, disp, surf, target);
 547 }
 548
 549
 550 EGLBoolean EGLAPIENTRY
 551 eglWaitGL(void)
 552 {
 553    _EGLDisplay *disp = _eglGetCurrentDisplay();
 554    _EGLDriver *drv;
 555
 556    if (!disp)
 557       return EGL_TRUE;
 558
 559    /* a current display is always initialized */
 560    drv = disp->Driver;
 561
 562    return drv->API.WaitGL(drv, disp);
 563 }
 564
 565
 566 EGLBoolean EGLAPIENTRY
 567 eglWaitNative(EGLint engine)
 568 {
 569    _EGLDisplay *disp = _eglGetCurrentDisplay();
 570    _EGLDriver *drv;
 571
 572    if (!disp)
 573       return EGL_TRUE;
 574
 575    /* a current display is always initialized */
 576    drv = disp->Driver;
 577
 578    return drv->API.WaitNative(drv, disp, engine);
 579 }
 580
 581
 582 EGLDisplay EGLAPIENTRY
 583 eglGetCurrentDisplay(void)
 584 {
 585    _EGLDisplay *dpy = _eglGetCurrentDisplay();
 586    return _eglGetDisplayHandle(dpy);
 587 }
 588
 589
 590 EGLContext EGLAPIENTRY
 591 eglGetCurrentContext(void)
 592 {
 593    _EGLContext *ctx = _eglGetCurrentContext();
 594    return _eglGetContextHandle(ctx);
 595 }
 596
 597
 598 EGLSurface EGLAPIENTRY
 599 eglGetCurrentSurface(EGLint readdraw)
 600 {
 601    _EGLContext *ctx = _eglGetCurrentContext();
 602    _EGLSurface *surf;
 603
 604    if (!ctx)
 605       return EGL_NO_SURFACE;
 606
 607    switch (readdraw) {
 608    case EGL_DRAW:
 609       surf = ctx->DrawSurface;
 610       break;
 611    case EGL_READ:
 612       surf = ctx->ReadSurface;
 613       break;
 614    default:
 615       _eglError(EGL_BAD_PARAMETER, __FUNCTION__);
 616       surf = NULL;
 617       break;
 618    }
 619
 620    return _eglGetSurfaceHandle(surf);
 621 }
 622
 623
 624 EGLint EGLAPIENTRY
 625 eglGetError(void)
 626 {
 627    _EGLThreadInfo *t = _eglGetCurrentThread();
 628    EGLint e = t->LastError;
 629    if (!_eglIsCurrentThreadDummy())
 630       t->LastError = EGL_SUCCESS;
 631    return e;
 632 }
 633
 634
 635 void (* EGLAPIENTRY eglGetProcAddress(const char *procname))()
 636 {
 637    static const struct {
 638       const char *name;
 639       _EGLProc function;
 640    } egl_functions[] = {
 641       /* extensions only */
 642 #ifdef EGL_MESA_screen_surface
 643       { "eglChooseModeMESA", (_EGLProc) eglChooseModeMESA },
 644       { "eglGetModesMESA", (_EGLProc) eglGetModesMESA },
 645       { "eglGetModeAttribMESA", (_EGLProc) eglGetModeAttribMESA },
 646       { "eglCopyContextMESA", (_EGLProc) eglCopyContextMESA },
 647       { "eglGetScreensMESA", (_EGLProc) eglGetScreensMESA },
 648       { "eglCreateScreenSurfaceMESA", (_EGLProc) eglCreateScreenSurfaceMESA },
 649       { "eglShowScreenSurfaceMESA", (_EGLProc) eglShowScreenSurfaceMESA },
 650       { "eglScreenPositionMESA", (_EGLProc) eglScreenPositionMESA },
 651       { "eglQueryScreenMESA", (_EGLProc) eglQueryScreenMESA },
 652       { "eglQueryScreenSurfaceMESA", (_EGLProc) eglQueryScreenSurfaceMESA },
 653       { "eglQueryScreenModeMESA", (_EGLProc) eglQueryScreenModeMESA },
 654       { "eglQueryModeStringMESA", (_EGLProc) eglQueryModeStringMESA },
 655 #endif /* EGL_MESA_screen_surface */
 656       { NULL, NULL }
 657    };
 658    EGLint i;
 659
 660    if (!procname)
 661       return NULL;
 662    if (strncmp(procname, "egl", 3) == 0) {
 663       for (i = 0; egl_functions[i].name; i++) {
 664          if (strcmp(egl_functions[i].name, procname) == 0)
 665             return egl_functions[i].function;
 666       }
 667    }
 668
 669    /* preload a driver if there isn't one */
 670    if (!_eglGlobal.NumDrivers)
 671       _eglPreloadDriver(NULL);
 672
 673    /* now loop over drivers to query their procs */
 674    for (i = 0; i < _eglGlobal.NumDrivers; i++) {
 675       _EGLProc p = _eglGlobal.Drivers[i]->API.GetProcAddress(procname);
 676       if (p)
 677          return p;
 678    }
 679
 680    return NULL;
 681 }
 682
 683
 684 #ifdef EGL_MESA_screen_surface
 685
 686
 687 /*
 688  * EGL_MESA_screen extension
 689  */
 690
 691 EGLBoolean EGLAPIENTRY
 692 eglChooseModeMESA(EGLDisplay dpy, EGLScreenMESA screen,
 693                   const EGLint *attrib_list, EGLModeMESA *modes,
 694                   EGLint modes_size, EGLint *num_modes)
 695 {
 696    _EGL_DECLARE_DD_AND_SCREEN(dpy, screen);
 697    return drv->API.ChooseModeMESA(drv, disp, scrn, attrib_list,
 698                                   modes, modes_size, num_modes);
 699 }
 700
 701
 702 EGLBoolean EGLAPIENTRY
 703 eglGetModesMESA(EGLDisplay dpy, EGLScreenMESA screen, EGLModeMESA *modes,
 704                 EGLint mode_size, EGLint *num_mode)
 705 {
 706    _EGL_DECLARE_DD_AND_SCREEN(dpy, screen);
 707    return drv->API.GetModesMESA(drv, disp, scrn, modes, mode_size, num_mode);
 708 }
 709
 710
 711 EGLBoolean EGLAPIENTRY
 712 eglGetModeAttribMESA(EGLDisplay dpy, EGLModeMESA mode,
 713                      EGLint attribute, EGLint *value)
 714 {
 715    _EGL_DECLARE_DD_AND_MODE(dpy, mode);
 716    return drv->API.GetModeAttribMESA(drv, disp, m, attribute, value);
 717 }
 718
 719
 720 EGLBoolean EGLAPIENTRY
 721 eglCopyContextMESA(EGLDisplay dpy, EGLContext source, EGLContext dest,
 722                    EGLint mask)
 723 {
 724    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 725    _EGLContext *source_context = _eglLookupContext(source, disp);
 726    _EGLContext *dest_context = _eglLookupContext(dest, disp);
 727    _EGLDriver *drv;
 728
 729    drv = _eglCheckContext(disp, source_context, __FUNCTION__);
 730    if (!drv || !dest_context) {
 731       if (drv)
 732          _eglError(EGL_BAD_CONTEXT, __FUNCTION__);
 733       return EGL_FALSE;
 734    }
 735
 736    return drv->API.CopyContextMESA(drv, disp, source_context, dest_context,
 737                                    mask);
 738 }
 739
 740
 741 EGLBoolean
 742 eglGetScreensMESA(EGLDisplay dpy, EGLScreenMESA *screens,
 743                   EGLint max_screens, EGLint *num_screens)
 744 {
 745    _EGL_DECLARE_DD(dpy);
 746    return drv->API.GetScreensMESA(drv, disp, screens,
 747                                   max_screens, num_screens);
 748 }
 749
 750
 751 EGLSurface
 752 eglCreateScreenSurfaceMESA(EGLDisplay dpy, EGLConfig config,
 753                            const EGLint *attrib_list)
 754 {
 755    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 756    _EGLConfig *conf = _eglLookupConfig(config, disp);
 757    _EGLDriver *drv;
 758    _EGLSurface *surf;
 759
 760    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 761    if (!drv)
 762       return EGL_NO_SURFACE;
 763
 764    surf = drv->API.CreateScreenSurfaceMESA(drv, disp, conf, attrib_list);
 765    if (surf)
 766       return _eglLinkSurface(surf, disp);
 767    else
 768       return EGL_NO_SURFACE;
 769 }
 770
 771
 772 EGLBoolean
 773 eglShowScreenSurfaceMESA(EGLDisplay dpy, EGLint screen,
 774                          EGLSurface surface, EGLModeMESA mode)
 775 {
 776    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 777    _EGLScreen *scrn = _eglLookupScreen((EGLScreenMESA) screen, disp);
 778    _EGLSurface *surf = _eglLookupSurface(surface, disp);
 779    _EGLMode *m = _eglLookupMode(mode, disp);
 780    _EGLDriver *drv;
 781
 782    drv = _eglCheckScreen(disp, scrn, __FUNCTION__);
 783    if (!drv)
 784       return EGL_FALSE;
 785    if (!surf && surface != EGL_NO_SURFACE)
 786       return _eglError(EGL_BAD_SURFACE, __FUNCTION__);
 787    if (!m && mode != EGL_NO_MODE_MESA)
 788       return _eglError(EGL_BAD_MODE_MESA, __FUNCTION__);
 789
 790    return drv->API.ShowScreenSurfaceMESA(drv, disp, scrn, surf, m);
 791 }
 792
 793
 794 EGLBoolean
 795 eglScreenPositionMESA(EGLDisplay dpy, EGLScreenMESA screen, EGLint x, EGLint y)
 796 {
 797    _EGL_DECLARE_DD_AND_SCREEN(dpy, screen);
 798    return drv->API.ScreenPositionMESA(drv, disp, scrn, x, y);
 799 }
 800
 801
 802 EGLBoolean
 803 eglQueryScreenMESA(EGLDisplay dpy, EGLScreenMESA screen,
 804                    EGLint attribute, EGLint *value)
 805 {
 806    _EGL_DECLARE_DD_AND_SCREEN(dpy, screen);
 807    return drv->API.QueryScreenMESA(drv, disp, scrn, attribute, value);
 808 }
 809
 810
 811 EGLBoolean
 812 eglQueryScreenSurfaceMESA(EGLDisplay dpy, EGLScreenMESA screen,
 813                           EGLSurface *surface)
 814 {
 815    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 816    _EGLScreen *scrn = _eglLookupScreen((EGLScreenMESA) screen, disp);
 817    _EGLDriver *drv;
 818    _EGLSurface *surf;
 819
 820    drv = _eglCheckScreen(disp, scrn, __FUNCTION__);
 821    if (!drv)
 822       return EGL_FALSE;
 823
 824    if (drv->API.QueryScreenSurfaceMESA(drv, disp, scrn, &surf) != EGL_TRUE)
 825       surf = NULL;
 826    if (surface)
 827       *surface = _eglGetSurfaceHandle(surf);
 828    return (surf != NULL);
 829 }
 830
 831
 832 EGLBoolean
 833 eglQueryScreenModeMESA(EGLDisplay dpy, EGLScreenMESA screen, EGLModeMESA *mode)
 834 {
 835    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 836    _EGLScreen *scrn = _eglLookupScreen((EGLScreenMESA) screen, disp);
 837    _EGLDriver *drv;
 838    _EGLMode *m;
 839
 840    drv = _eglCheckScreen(disp, scrn, __FUNCTION__);
 841    if (!drv)
 842       return EGL_FALSE;
 843
 844    if (drv->API.QueryScreenModeMESA(drv, disp, scrn, &m) != EGL_TRUE)
 845       m = NULL;
 846    if (mode)
 847       *mode = m->Handle;
 848
 849    return (m != NULL);
 850 }
 851
 852
 853 const char *
 854 eglQueryModeStringMESA(EGLDisplay dpy, EGLModeMESA mode)
 855 {
 856    _EGL_DECLARE_DD_AND_MODE(dpy, mode);
 857    return drv->API.QueryModeStringMESA(drv, disp, m);
 858 }
 859
 860
 861 #endif /* EGL_MESA_screen_surface */
 862
 863
 864 /**
 865  ** EGL 1.2
 866  **/
 867
 868 #ifdef EGL_VERSION_1_2
 869
 870
 871 /**
 872  * Specify the client API to use for subsequent calls including:
 873  *  eglCreateContext()
 874  *  eglGetCurrentContext()
 875  *  eglGetCurrentDisplay()
 876  *  eglGetCurrentSurface()
 877  *  eglMakeCurrent(when the ctx parameter is EGL NO CONTEXT)
 878  *  eglWaitClient()
 879  *  eglWaitNative()
 880  * See section 3.7 "Rendering Context" in the EGL specification for details.
 881  */
 882 EGLBoolean
 883 eglBindAPI(EGLenum api)
 884 {
 885    _EGLThreadInfo *t = _eglGetCurrentThread();
 886
 887    if (_eglIsCurrentThreadDummy())
 888       return _eglError(EGL_BAD_ALLOC, "eglBindAPI");
 889
 890    if (!_eglIsApiValid(api))
 891       return _eglError(EGL_BAD_PARAMETER, "eglBindAPI");
 892
 893    t->CurrentAPIIndex = _eglConvertApiToIndex(api);
 894    return EGL_TRUE;
 895 }
 896
 897
 898 /**
 899  * Return the last value set with eglBindAPI().
 900  */
 901 EGLenum
 902 eglQueryAPI(void)
 903 {
 904    /* returns one of EGL_OPENGL_API, EGL_OPENGL_ES_API or EGL_OPENVG_API */
 905    _EGLThreadInfo *t = _eglGetCurrentThread();
 906    return _eglConvertApiFromIndex(t->CurrentAPIIndex);
 907 }
 908
 909
 910 EGLSurface
 911 eglCreatePbufferFromClientBuffer(EGLDisplay dpy, EGLenum buftype,
 912                                  EGLClientBuffer buffer, EGLConfig config,
 913                                  const EGLint *attrib_list)
 914 {
 915    _EGLDisplay *disp = _eglLookupDisplay(dpy);
 916    _EGLConfig *conf = _eglLookupConfig(config, disp);
 917    _EGLDriver *drv;
 918    _EGLSurface *surf;
 919
 920    drv = _eglCheckConfig(disp, conf, __FUNCTION__);
 921    if (!drv)
 922       return EGL_NO_SURFACE;
 923
 924    surf = drv->API.CreatePbufferFromClientBuffer(drv, disp, buftype, buffer,
 925                                                  conf, attrib_list);
 926    if (surf)
 927       return _eglLinkSurface(surf, disp);
 928    else
 929       return EGL_NO_SURFACE;
 930 }
 931
 932
 933 EGLBoolean
 934 eglReleaseThread(void)
 935 {
 936    /* unbind current context */
 937    if (!_eglIsCurrentThreadDummy()) {
 938       _EGLDisplay *disp = _eglGetCurrentDisplay();
 939       _EGLDriver *drv;
 940       if (disp) {
 941          drv = disp->Driver;
 942          (void) drv->API.MakeCurrent(drv, disp, NULL, NULL, NULL);
 943       }
 944    }
 945
 946    _eglDestroyCurrentThread();
 947    return EGL_TRUE;
 948 }
 949
 950
 951 EGLBoolean
 952 eglWaitClient(void)
 953 {
 954    _EGLDisplay *disp = _eglGetCurrentDisplay();
 955    _EGLDriver *drv;
 956
 957    if (!disp)
 958       return EGL_TRUE;
 959
 960    /* a current display is always initialized */
 961    drv = disp->Driver;
 962
 963    return drv->API.WaitClient(drv, disp);
 964 }
 965
 966
 967 #endif /* EGL_VERSION_1_2 */