src/mesa/drivers/dri/common/dri_util.c

   1 /*
   2  * (C) Copyright IBM Corporation 2002, 2004
   3  * All Rights Reserved.
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * on the rights to use, copy, modify, merge, publish, distribute, sub
   9  * license, and/or sell copies of the Software, and to permit persons to whom
  10  * the Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice (including the next
  13  * paragraph) shall be included in all copies or substantial portions of the
  14  * Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
  20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  22  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25 /**
  26  * \file dri_util.c
  27  * DRI utility functions.
  28  *
  29  * This module acts as glue between GLX and the actual hardware driver.  A DRI
  30  * driver doesn't really \e have to use any of this - it's optional.  But, some
  31  * useful stuff is done here that otherwise would have to be duplicated in most
  32  * drivers.
  33  *
  34  * Basically, these utility functions take care of some of the dirty details of
  35  * screen initialization, context creation, context binding, DRM setup, etc.
  36  *
  37  * These functions are compiled into each DRI driver so libGL.so knows nothing
  38  * about them.
  39  */
  40
  41
  42 #include <stdbool.h>
  43 #ifndef __NOT_HAVE_DRM_H
  44 #include <xf86drm.h>
  45 #endif
  46 #include "dri_util.h"
  47 #include "utils.h"
  48 #include "xmlpool.h"
  49 #include "../glsl/glsl_parser_extras.h"
  50 #include "main/mtypes.h"
  51 #include "main/version.h"
  52 #include "main/errors.h"
  53 #include "main/macros.h"
  54
  55 PUBLIC const char __dri2ConfigOptions[] =
  56    DRI_CONF_BEGIN
  57       DRI_CONF_SECTION_PERFORMANCE
  58          DRI_CONF_VBLANK_MODE(DRI_CONF_VBLANK_DEF_INTERVAL_1)
  59       DRI_CONF_SECTION_END
  60    DRI_CONF_END;
  61
  62 /*****************************************************************/
  63 /** \name Screen handling functions                              */
  64 /*****************************************************************/
  65 /*@{*/
  66
  67 static void
  68 setupLoaderExtensions(__DRIscreen *psp,
  69                       const __DRIextension **extensions)
  70 {
  71     int i;
  72
  73     for (i = 0; extensions[i]; i++) {
  74         if (strcmp(extensions[i]->name, __DRI_DRI2_LOADER) == 0)
  75             psp->dri2.loader = (__DRIdri2LoaderExtension *) extensions[i];
  76         if (strcmp(extensions[i]->name, __DRI_IMAGE_LOOKUP) == 0)
  77             psp->dri2.image = (__DRIimageLookupExtension *) extensions[i];
  78         if (strcmp(extensions[i]->name, __DRI_USE_INVALIDATE) == 0)
  79             psp->dri2.useInvalidate = (__DRIuseInvalidateExtension *) extensions[i];
  80         if (strcmp(extensions[i]->name, __DRI_SWRAST_LOADER) == 0)
  81             psp->swrast_loader = (__DRIswrastLoaderExtension *) extensions[i];
  82         if (strcmp(extensions[i]->name, __DRI_IMAGE_LOADER) == 0)
  83            psp->image.loader = (__DRIimageLoaderExtension *) extensions[i];
  84     }
  85 }
  86
  87 /**
  88  * This pointer determines which driver API we'll use in the case of the
  89  * loader not passing us an explicit driver extensions list (that would,
  90  * itself, contain a pointer to a driver API.)
  91  *
  92  * A driver's driDriverGetExtensions_drivername() can update this pointer to
  93  * what it's returning, and a loader that is ignorant of createNewScreen2()
  94  * will get the correct driver screen created, as long as no other
  95  * driDriverGetExtensions() happened in between the first one and the
  96  * createNewScreen().
  97  *
  98  * This allows the X Server to not require the significant dri_interface.h
  99  * updates for doing createNewScreen2(), which would discourage backporting of
 100  * the X Server patches to support the new loader interface.
 101  */
 102 const struct __DriverAPIRec *globalDriverAPI = &driDriverAPI;
 103
 104 /**
 105  * This is the first entrypoint in the driver called by the DRI driver loader
 106  * after dlopen()ing it.
 107  *
 108  * It's used to create global state for the driver across contexts on the same
 109  * Display.
 110  */
 111 static __DRIscreen *
 112 driCreateNewScreen2(int scrn, int fd,
 113                     const __DRIextension **extensions,
 114                     const __DRIextension **driver_extensions,
 115                     const __DRIconfig ***driver_configs, void *data)
 116 {
 117     static const __DRIextension *emptyExtensionList[] = { NULL };
 118     __DRIscreen *psp;
 119
 120     psp = calloc(1, sizeof(*psp));
 121     if (!psp)
 122         return NULL;
 123
 124     /* By default, use the global driDriverAPI symbol (non-megadrivers). */
 125     psp->driver = globalDriverAPI;
 126
 127     /* If the driver exposes its vtable through its extensions list
 128      * (megadrivers), use that instead.
 129      */
 130     if (driver_extensions) {
 131        for (int i = 0; driver_extensions[i]; i++) {
 132           if (strcmp(driver_extensions[i]->name, __DRI_DRIVER_VTABLE) == 0) {
 133              psp->driver =
 134                 ((__DRIDriverVtableExtension *)driver_extensions[i])->vtable;
 135           }
 136        }
 137     }
 138
 139     setupLoaderExtensions(psp, extensions);
 140
 141 #ifndef __NOT_HAVE_DRM_H
 142     if (fd != -1) {
 143        drmVersionPtr version = drmGetVersion(fd);
 144        if (version) {
 145           psp->drm_version.major = version->version_major;
 146           psp->drm_version.minor = version->version_minor;
 147           psp->drm_version.patch = version->version_patchlevel;
 148           drmFreeVersion(version);
 149        }
 150     }
 151 #endif
 152
 153     psp->loaderPrivate = data;
 154
 155     psp->extensions = emptyExtensionList;
 156     psp->fd = fd;
 157     psp->myNum = scrn;
 158
 159     *driver_configs = psp->driver->InitScreen(psp);
 160     if (*driver_configs == NULL) {
 161         free(psp);
 162         return NULL;
 163     }
 164
 165     int gl_version_override = _mesa_get_gl_version_override();
 166     if (gl_version_override >= 31) {
 167        psp->max_gl_core_version = MAX2(psp->max_gl_core_version,
 168                                        gl_version_override);
 169     } else {
 170        psp->max_gl_compat_version = MAX2(psp->max_gl_compat_version,
 171                                          gl_version_override);
 172     }
 173
 174     psp->api_mask = (1 << __DRI_API_OPENGL);
 175     if (psp->max_gl_core_version > 0)
 176        psp->api_mask |= (1 << __DRI_API_OPENGL_CORE);
 177     if (psp->max_gl_es1_version > 0)
 178        psp->api_mask |= (1 << __DRI_API_GLES);
 179     if (psp->max_gl_es2_version > 0)
 180        psp->api_mask |= (1 << __DRI_API_GLES2);
 181     if (psp->max_gl_es2_version >= 30)
 182        psp->api_mask |= (1 << __DRI_API_GLES3);
 183
 184     driParseOptionInfo(&psp->optionInfo, __dri2ConfigOptions);
 185     driParseConfigFiles(&psp->optionCache, &psp->optionInfo, psp->myNum, "dri2");
 186
 187
 188     return psp;
 189 }
 190
 191 static __DRIscreen *
 192 dri2CreateNewScreen(int scrn, int fd,
 193                     const __DRIextension **extensions,
 194                     const __DRIconfig ***driver_configs, void *data)
 195 {
 196    return driCreateNewScreen2(scrn, fd, extensions, NULL,
 197                                driver_configs, data);
 198 }
 199
 200 /** swrast driver createNewScreen entrypoint. */
 201 static __DRIscreen *
 202 driSWRastCreateNewScreen(int scrn, const __DRIextension **extensions,
 203                          const __DRIconfig ***driver_configs, void *data)
 204 {
 205    return driCreateNewScreen2(scrn, -1, extensions, NULL,
 206                                driver_configs, data);
 207 }
 208
 209 static __DRIscreen *
 210 driSWRastCreateNewScreen2(int scrn, const __DRIextension **extensions,
 211                           const __DRIextension **driver_extensions,
 212                           const __DRIconfig ***driver_configs, void *data)
 213 {
 214    return driCreateNewScreen2(scrn, -1, extensions, driver_extensions,
 215                                driver_configs, data);
 216 }
 217
 218 /**
 219  * Destroy the per-screen private information.
 220  *
 221  * \internal
 222  * This function calls __DriverAPIRec::DestroyScreen on \p screenPrivate, calls
 223  * drmClose(), and finally frees \p screenPrivate.
 224  */
 225 static void driDestroyScreen(__DRIscreen *psp)
 226 {
 227     if (psp) {
 228         /* No interaction with the X-server is possible at this point.  This
 229          * routine is called after XCloseDisplay, so there is no protocol
 230          * stream open to the X-server anymore.
 231          */
 232
 233        _mesa_destroy_shader_compiler();
 234
 235         psp->driver->DestroyScreen(psp);
 236
 237         driDestroyOptionCache(&psp->optionCache);
 238         driDestroyOptionInfo(&psp->optionInfo);
 239
 240         free(psp);
 241     }
 242 }
 243
 244 static const __DRIextension **driGetExtensions(__DRIscreen *psp)
 245 {
 246     return psp->extensions;
 247 }
 248
 249 /*@}*/
 250
 251
 252 static bool
 253 validate_context_version(__DRIscreen *screen,
 254                          int mesa_api,
 255                          unsigned major_version,
 256                          unsigned minor_version,
 257                          unsigned *dri_ctx_error)
 258 {
 259    unsigned req_version = 10 * major_version + minor_version;
 260    unsigned max_version = 0;
 261
 262    switch (mesa_api) {
 263    case API_OPENGL_COMPAT:
 264       max_version = screen->max_gl_compat_version;
 265       break;
 266    case API_OPENGL_CORE:
 267       max_version = screen->max_gl_core_version;
 268       break;
 269    case API_OPENGLES:
 270       max_version = screen->max_gl_es1_version;
 271       break;
 272    case API_OPENGLES2:
 273       max_version = screen->max_gl_es2_version;
 274       break;
 275    default:
 276       max_version = 0;
 277       break;
 278    }
 279
 280    if (max_version == 0) {
 281       *dri_ctx_error = __DRI_CTX_ERROR_BAD_API;
 282       return false;
 283    } else if (req_version > max_version) {
 284       *dri_ctx_error = __DRI_CTX_ERROR_BAD_VERSION;
 285       return false;
 286    }
 287
 288    return true;
 289 }
 290
 291 /*****************************************************************/
 292 /** \name Context handling functions                             */
 293 /*****************************************************************/
 294 /*@{*/
 295
 296 static __DRIcontext *
 297 driCreateContextAttribs(__DRIscreen *screen, int api,
 298                         const __DRIconfig *config,
 299                         __DRIcontext *shared,
 300                         unsigned num_attribs,
 301                         const uint32_t *attribs,
 302                         unsigned *error,
 303                         void *data)
 304 {
 305     __DRIcontext *context;
 306     const struct gl_config *modes = (config != NULL) ? &config->modes : NULL;
 307     void *shareCtx = (shared != NULL) ? shared->driverPrivate : NULL;
 308     gl_api mesa_api;
 309     unsigned major_version = 1;
 310     unsigned minor_version = 0;
 311     uint32_t flags = 0;
 312     bool notify_reset = false;
 313
 314     assert((num_attribs == 0) || (attribs != NULL));
 315
 316     if (!(screen->api_mask & (1 << api))) {
 317         *error = __DRI_CTX_ERROR_BAD_API;
 318         return NULL;
 319     }
 320
 321     switch (api) {
 322     case __DRI_API_OPENGL:
 323         mesa_api = API_OPENGL_COMPAT;
 324         break;
 325     case __DRI_API_GLES:
 326         mesa_api = API_OPENGLES;
 327         break;
 328     case __DRI_API_GLES2:
 329     case __DRI_API_GLES3:
 330         mesa_api = API_OPENGLES2;
 331         break;
 332     case __DRI_API_OPENGL_CORE:
 333         mesa_api = API_OPENGL_CORE;
 334         break;
 335     default:
 336         *error = __DRI_CTX_ERROR_BAD_API;
 337         return NULL;
 338     }
 339
 340     for (unsigned i = 0; i < num_attribs; i++) {
 341         switch (attribs[i * 2]) {
 342         case __DRI_CTX_ATTRIB_MAJOR_VERSION:
 343             major_version = attribs[i * 2 + 1];
 344             break;
 345         case __DRI_CTX_ATTRIB_MINOR_VERSION:
 346             minor_version = attribs[i * 2 + 1];
 347             break;
 348         case __DRI_CTX_ATTRIB_FLAGS:
 349             flags = attribs[i * 2 + 1];
 350             break;
 351         case __DRI_CTX_ATTRIB_RESET_STRATEGY:
 352             notify_reset = (attribs[i * 2 + 1]
 353                             != __DRI_CTX_RESET_NO_NOTIFICATION);
 354             break;
 355         default:
 356             /* We can't create a context that satisfies the requirements of an
 357              * attribute that we don't understand.  Return failure.
 358              */
 359             assert(!"Should not get here.");
 360             *error = __DRI_CTX_ERROR_UNKNOWN_ATTRIBUTE;
 361             return NULL;
 362         }
 363     }
 364
 365     /* Mesa does not support the GL_ARB_compatibilty extension or the
 366      * compatibility profile.  This means that we treat a API_OPENGL_COMPAT 3.1 as
 367      * API_OPENGL_CORE and reject API_OPENGL_COMPAT 3.2+.
 368      */
 369     if (mesa_api == API_OPENGL_COMPAT && major_version == 3 && minor_version == 1)
 370        mesa_api = API_OPENGL_CORE;
 371
 372     if (mesa_api == API_OPENGL_COMPAT
 373         && ((major_version > 3)
 374             || (major_version == 3 && minor_version >= 2))) {
 375        *error = __DRI_CTX_ERROR_BAD_API;
 376        return NULL;
 377     }
 378
 379     /* The EGL_KHR_create_context spec says:
 380      *
 381      *     "Flags are only defined for OpenGL context creation, and specifying
 382      *     a flags value other than zero for other types of contexts,
 383      *     including OpenGL ES contexts, will generate an error."
 384      *
 385      * The GLX_EXT_create_context_es2_profile specification doesn't say
 386      * anything specific about this case.  However, none of the known flags
 387      * have any meaning in an ES context, so this seems safe.
 388      */
 389     if (mesa_api != API_OPENGL_COMPAT
 390         && mesa_api != API_OPENGL_CORE
 391         && flags != 0) {
 392         *error = __DRI_CTX_ERROR_BAD_FLAG;
 393         return NULL;
 394     }
 395
 396     /* There are no forward-compatible contexts before OpenGL 3.0.  The
 397      * GLX_ARB_create_context spec says:
 398      *
 399      *     "Forward-compatible contexts are defined only for OpenGL versions
 400      *     3.0 and later."
 401      *
 402      * Forward-looking contexts are supported by silently converting the
 403      * requested API to API_OPENGL_CORE.
 404      *
 405      * In Mesa, a debug context is the same as a regular context.
 406      */
 407     if ((flags & __DRI_CTX_FLAG_FORWARD_COMPATIBLE) != 0) {
 408        mesa_api = API_OPENGL_CORE;
 409     }
 410
 411     const uint32_t allowed_flags = (__DRI_CTX_FLAG_DEBUG
 412                                     | __DRI_CTX_FLAG_FORWARD_COMPATIBLE
 413                                     | __DRI_CTX_FLAG_ROBUST_BUFFER_ACCESS);
 414     if (flags & ~allowed_flags) {
 415         *error = __DRI_CTX_ERROR_UNKNOWN_FLAG;
 416         return NULL;
 417     }
 418
 419     if (!validate_context_version(screen, mesa_api,
 420                                   major_version, minor_version, error))
 421        return NULL;
 422
 423     context = calloc(1, sizeof *context);
 424     if (!context) {
 425         *error = __DRI_CTX_ERROR_NO_MEMORY;
 426         return NULL;
 427     }
 428
 429     context->loaderPrivate = data;
 430
 431     context->driScreenPriv = screen;
 432     context->driDrawablePriv = NULL;
 433     context->driReadablePriv = NULL;
 434
 435     if (!screen->driver->CreateContext(mesa_api, modes, context,
 436                                        major_version, minor_version,
 437                                        flags, notify_reset, error, shareCtx)) {
 438         free(context);
 439         return NULL;
 440     }
 441
 442     *error = __DRI_CTX_ERROR_SUCCESS;
 443     return context;
 444 }
 445
 446 void
 447 driContextSetFlags(struct gl_context *ctx, uint32_t flags)
 448 {
 449     if ((flags & __DRI_CTX_FLAG_FORWARD_COMPATIBLE) != 0)
 450         ctx->Const.ContextFlags |= GL_CONTEXT_FLAG_FORWARD_COMPATIBLE_BIT;
 451     if ((flags & __DRI_CTX_FLAG_DEBUG) != 0) {
 452         struct gl_debug_state *debug = _mesa_get_debug_state(ctx);
 453         if (debug) {
 454             debug->DebugOutput = GL_TRUE;
 455         }
 456         ctx->Const.ContextFlags |= GL_CONTEXT_FLAG_DEBUG_BIT;
 457     }
 458 }
 459
 460 static __DRIcontext *
 461 driCreateNewContextForAPI(__DRIscreen *screen, int api,
 462                           const __DRIconfig *config,
 463                           __DRIcontext *shared, void *data)
 464 {
 465     unsigned error;
 466
 467     return driCreateContextAttribs(screen, api, config, shared, 0, NULL,
 468                                    &error, data);
 469 }
 470
 471 static __DRIcontext *
 472 driCreateNewContext(__DRIscreen *screen, const __DRIconfig *config,
 473                     __DRIcontext *shared, void *data)
 474 {
 475     return driCreateNewContextForAPI(screen, __DRI_API_OPENGL,
 476                                      config, shared, data);
 477 }
 478
 479 /**
 480  * Destroy the per-context private information.
 481  *
 482  * \internal
 483  * This function calls __DriverAPIRec::DestroyContext on \p contextPrivate, calls
 484  * drmDestroyContext(), and finally frees \p contextPrivate.
 485  */
 486 static void
 487 driDestroyContext(__DRIcontext *pcp)
 488 {
 489     if (pcp) {
 490         pcp->driScreenPriv->driver->DestroyContext(pcp);
 491         free(pcp);
 492     }
 493 }
 494
 495 static int
 496 driCopyContext(__DRIcontext *dest, __DRIcontext *src, unsigned long mask)
 497 {
 498     (void) dest;
 499     (void) src;
 500     (void) mask;
 501     return GL_FALSE;
 502 }
 503
 504 /*@}*/
 505
 506
 507 /*****************************************************************/
 508 /** \name Context (un)binding functions                          */
 509 /*****************************************************************/
 510 /*@{*/
 511
 512 static void dri_get_drawable(__DRIdrawable *pdp);
 513 static void dri_put_drawable(__DRIdrawable *pdp);
 514
 515 /**
 516  * This function takes both a read buffer and a draw buffer.  This is needed
 517  * for \c glXMakeCurrentReadSGI or GLX 1.3's \c glXMakeContextCurrent
 518  * function.
 519  */
 520 static int driBindContext(__DRIcontext *pcp,
 521                           __DRIdrawable *pdp,
 522                           __DRIdrawable *prp)
 523 {
 524     /*
 525     ** Assume error checking is done properly in glXMakeCurrent before
 526     ** calling driUnbindContext.
 527     */
 528
 529     if (!pcp)
 530         return GL_FALSE;
 531
 532     /* Bind the drawable to the context */
 533     pcp->driDrawablePriv = pdp;
 534     pcp->driReadablePriv = prp;
 535     if (pdp) {
 536         pdp->driContextPriv = pcp;
 537         dri_get_drawable(pdp);
 538     }
 539     if (prp && pdp != prp) {
 540         dri_get_drawable(prp);
 541     }
 542
 543     return pcp->driScreenPriv->driver->MakeCurrent(pcp, pdp, prp);
 544 }
 545
 546 /**
 547  * Unbind context.
 548  *
 549  * \param scrn the screen.
 550  * \param gc context.
 551  *
 552  * \return \c GL_TRUE on success, or \c GL_FALSE on failure.
 553  *
 554  * \internal
 555  * This function calls __DriverAPIRec::UnbindContext, and then decrements
 556  * __DRIdrawableRec::refcount which must be non-zero for a successful
 557  * return.
 558  *
 559  * While casting the opaque private pointers associated with the parameters
 560  * into their respective real types it also assures they are not \c NULL.
 561  */
 562 static int driUnbindContext(__DRIcontext *pcp)
 563 {
 564     __DRIdrawable *pdp;
 565     __DRIdrawable *prp;
 566
 567     /*
 568     ** Assume error checking is done properly in glXMakeCurrent before
 569     ** calling driUnbindContext.
 570     */
 571
 572     if (pcp == NULL)
 573         return GL_FALSE;
 574
 575     pdp = pcp->driDrawablePriv;
 576     prp = pcp->driReadablePriv;
 577
 578     /* already unbound */
 579     if (!pdp && !prp)
 580         return GL_TRUE;
 581
 582     pcp->driScreenPriv->driver->UnbindContext(pcp);
 583
 584     assert(pdp);
 585     if (pdp->refcount == 0) {
 586         /* ERROR!!! */
 587         return GL_FALSE;
 588     }
 589
 590     dri_put_drawable(pdp);
 591
 592     if (prp != pdp) {
 593         if (prp->refcount == 0) {
 594             /* ERROR!!! */
 595             return GL_FALSE;
 596         }
 597
 598         dri_put_drawable(prp);
 599     }
 600
 601     pcp->driDrawablePriv = NULL;
 602     pcp->driReadablePriv = NULL;
 603
 604     return GL_TRUE;
 605 }
 606
 607 /*@}*/
 608
 609
 610 static void dri_get_drawable(__DRIdrawable *pdp)
 611 {
 612     pdp->refcount++;
 613 }
 614
 615 static void dri_put_drawable(__DRIdrawable *pdp)
 616 {
 617     if (pdp) {
 618         pdp->refcount--;
 619         if (pdp->refcount)
 620             return;
 621
 622         pdp->driScreenPriv->driver->DestroyBuffer(pdp);
 623         free(pdp);
 624     }
 625 }
 626
 627 static __DRIdrawable *
 628 driCreateNewDrawable(__DRIscreen *screen,
 629                      const __DRIconfig *config,
 630                      void *data)
 631 {
 632     __DRIdrawable *pdraw;
 633
 634     pdraw = malloc(sizeof *pdraw);
 635     if (!pdraw)
 636         return NULL;
 637
 638     pdraw->loaderPrivate = data;
 639
 640     pdraw->driScreenPriv = screen;
 641     pdraw->driContextPriv = NULL;
 642     pdraw->refcount = 0;
 643     pdraw->lastStamp = 0;
 644     pdraw->w = 0;
 645     pdraw->h = 0;
 646
 647     dri_get_drawable(pdraw);
 648
 649     if (!screen->driver->CreateBuffer(screen, pdraw, &config->modes,
 650                                       GL_FALSE)) {
 651        free(pdraw);
 652        return NULL;
 653     }
 654
 655     pdraw->dri2.stamp = pdraw->lastStamp + 1;
 656
 657     return pdraw;
 658 }
 659
 660 static void
 661 driDestroyDrawable(__DRIdrawable *pdp)
 662 {
 663     dri_put_drawable(pdp);
 664 }
 665
 666 static __DRIbuffer *
 667 dri2AllocateBuffer(__DRIscreen *screen,
 668                    unsigned int attachment, unsigned int format,
 669                    int width, int height)
 670 {
 671     return screen->driver->AllocateBuffer(screen, attachment, format,
 672                                           width, height);
 673 }
 674
 675 static void
 676 dri2ReleaseBuffer(__DRIscreen *screen, __DRIbuffer *buffer)
 677 {
 678     screen->driver->ReleaseBuffer(screen, buffer);
 679 }
 680
 681
 682 static int
 683 dri2ConfigQueryb(__DRIscreen *screen, const char *var, GLboolean *val)
 684 {
 685    if (!driCheckOption(&screen->optionCache, var, DRI_BOOL))
 686       return -1;
 687
 688    *val = driQueryOptionb(&screen->optionCache, var);
 689
 690    return 0;
 691 }
 692
 693 static int
 694 dri2ConfigQueryi(__DRIscreen *screen, const char *var, GLint *val)
 695 {
 696    if (!driCheckOption(&screen->optionCache, var, DRI_INT) &&
 697        !driCheckOption(&screen->optionCache, var, DRI_ENUM))
 698       return -1;
 699
 700     *val = driQueryOptioni(&screen->optionCache, var);
 701
 702     return 0;
 703 }
 704
 705 static int
 706 dri2ConfigQueryf(__DRIscreen *screen, const char *var, GLfloat *val)
 707 {
 708    if (!driCheckOption(&screen->optionCache, var, DRI_FLOAT))
 709       return -1;
 710
 711     *val = driQueryOptionf(&screen->optionCache, var);
 712
 713     return 0;
 714 }
 715
 716 static unsigned int
 717 driGetAPIMask(__DRIscreen *screen)
 718 {
 719     return screen->api_mask;
 720 }
 721
 722 /**
 723  * swrast swapbuffers entrypoint.
 724  *
 725  * DRI2 implements this inside the loader with only flushes handled by the
 726  * driver.
 727  */
 728 static void
 729 driSwapBuffers(__DRIdrawable *pdp)
 730 {
 731     assert(pdp->driScreenPriv->swrast_loader);
 732
 733     pdp->driScreenPriv->driver->SwapBuffers(pdp);
 734 }
 735
 736 /** Core interface */
 737 const __DRIcoreExtension driCoreExtension = {
 738     .base = { __DRI_CORE, __DRI_CORE_VERSION },
 739
 740     .createNewScreen            = NULL,
 741     .destroyScreen              = driDestroyScreen,
 742     .getExtensions              = driGetExtensions,
 743     .getConfigAttrib            = driGetConfigAttrib,
 744     .indexConfigAttrib          = driIndexConfigAttrib,
 745     .createNewDrawable          = NULL,
 746     .destroyDrawable            = driDestroyDrawable,
 747     .swapBuffers                = driSwapBuffers, /* swrast */
 748     .createNewContext           = driCreateNewContext, /* swrast */
 749     .copyContext                = driCopyContext,
 750     .destroyContext             = driDestroyContext,
 751     .bindContext                = driBindContext,
 752     .unbindContext              = driUnbindContext
 753 };
 754
 755 /** DRI2 interface */
 756 const __DRIdri2Extension driDRI2Extension = {
 757     .base = { __DRI_DRI2, 4 },
 758
 759     .createNewScreen            = dri2CreateNewScreen,
 760     .createNewDrawable          = driCreateNewDrawable,
 761     .createNewContext           = driCreateNewContext,
 762     .getAPIMask                 = driGetAPIMask,
 763     .createNewContextForAPI     = driCreateNewContextForAPI,
 764     .allocateBuffer             = dri2AllocateBuffer,
 765     .releaseBuffer              = dri2ReleaseBuffer,
 766     .createContextAttribs       = driCreateContextAttribs,
 767     .createNewScreen2           = driCreateNewScreen2,
 768 };
 769
 770 const __DRIswrastExtension driSWRastExtension = {
 771     .base = { __DRI_SWRAST, 4 },
 772
 773     .createNewScreen            = driSWRastCreateNewScreen,
 774     .createNewDrawable          = driCreateNewDrawable,
 775     .createNewContextForAPI     = driCreateNewContextForAPI,
 776     .createContextAttribs       = driCreateContextAttribs,
 777     .createNewScreen2           = driSWRastCreateNewScreen2,
 778 };
 779
 780 const __DRI2configQueryExtension dri2ConfigQueryExtension = {
 781    .base = { __DRI2_CONFIG_QUERY, __DRI2_CONFIG_QUERY_VERSION },
 782
 783    .configQueryb        = dri2ConfigQueryb,
 784    .configQueryi        = dri2ConfigQueryi,
 785    .configQueryf        = dri2ConfigQueryf,
 786 };
 787
 788 void
 789 dri2InvalidateDrawable(__DRIdrawable *drawable)
 790 {
 791     drawable->dri2.stamp++;
 792 }
 793
 794 /**
 795  * Check that the gl_framebuffer associated with dPriv is the right size.
 796  * Resize the gl_framebuffer if needed.
 797  * It's expected that the dPriv->driverPrivate member points to a
 798  * gl_framebuffer object.
 799  */
 800 void
 801 driUpdateFramebufferSize(struct gl_context *ctx, const __DRIdrawable *dPriv)
 802 {
 803    struct gl_framebuffer *fb = (struct gl_framebuffer *) dPriv->driverPrivate;
 804    if (fb && (dPriv->w != fb->Width || dPriv->h != fb->Height)) {
 805       ctx->Driver.ResizeBuffers(ctx, fb, dPriv->w, dPriv->h);
 806       /* if the driver needs the hw lock for ResizeBuffers, the drawable
 807          might have changed again by now */
 808       assert(fb->Width == dPriv->w);
 809       assert(fb->Height == dPriv->h);
 810    }
 811 }
 812
 813 uint32_t
 814 driGLFormatToImageFormat(mesa_format format)
 815 {
 816    switch (format) {
 817    case MESA_FORMAT_B5G6R5_UNORM:
 818       return __DRI_IMAGE_FORMAT_RGB565;
 819    case MESA_FORMAT_B8G8R8X8_UNORM:
 820       return __DRI_IMAGE_FORMAT_XRGB8888;
 821    case MESA_FORMAT_B10G10R10A2_UNORM:
 822       return __DRI_IMAGE_FORMAT_ARGB2101010;
 823    case MESA_FORMAT_B10G10R10X2_UNORM:
 824       return __DRI_IMAGE_FORMAT_XRGB2101010;
 825    case MESA_FORMAT_B8G8R8A8_UNORM:
 826       return __DRI_IMAGE_FORMAT_ARGB8888;
 827    case MESA_FORMAT_R8G8B8A8_UNORM:
 828       return __DRI_IMAGE_FORMAT_ABGR8888;
 829    case MESA_FORMAT_R8G8B8X8_UNORM:
 830       return __DRI_IMAGE_FORMAT_XBGR8888;
 831    case MESA_FORMAT_R_UNORM8:
 832       return __DRI_IMAGE_FORMAT_R8;
 833    case MESA_FORMAT_R8G8_UNORM:
 834       return __DRI_IMAGE_FORMAT_GR88;
 835    case MESA_FORMAT_NONE:
 836       return __DRI_IMAGE_FORMAT_NONE;
 837    case MESA_FORMAT_B8G8R8A8_SRGB:
 838       return __DRI_IMAGE_FORMAT_SARGB8;
 839    default:
 840       return 0;
 841    }
 842 }
 843
 844 mesa_format
 845 driImageFormatToGLFormat(uint32_t image_format)
 846 {
 847    switch (image_format) {
 848    case __DRI_IMAGE_FORMAT_RGB565:
 849       return MESA_FORMAT_B5G6R5_UNORM;
 850    case __DRI_IMAGE_FORMAT_XRGB8888:
 851       return MESA_FORMAT_B8G8R8X8_UNORM;
 852    case __DRI_IMAGE_FORMAT_ARGB2101010:
 853       return MESA_FORMAT_B10G10R10A2_UNORM;
 854    case __DRI_IMAGE_FORMAT_XRGB2101010:
 855       return MESA_FORMAT_B10G10R10X2_UNORM;
 856    case __DRI_IMAGE_FORMAT_ARGB8888:
 857       return MESA_FORMAT_B8G8R8A8_UNORM;
 858    case __DRI_IMAGE_FORMAT_ABGR8888:
 859       return MESA_FORMAT_R8G8B8A8_UNORM;
 860    case __DRI_IMAGE_FORMAT_XBGR8888:
 861       return MESA_FORMAT_R8G8B8X8_UNORM;
 862    case __DRI_IMAGE_FORMAT_R8:
 863       return MESA_FORMAT_R_UNORM8;
 864    case __DRI_IMAGE_FORMAT_GR88:
 865       return MESA_FORMAT_R8G8_UNORM;
 866    case __DRI_IMAGE_FORMAT_SARGB8:
 867       return MESA_FORMAT_B8G8R8A8_SRGB;
 868    case __DRI_IMAGE_FORMAT_NONE:
 869       return MESA_FORMAT_NONE;
 870    default:
 871       return MESA_FORMAT_NONE;
 872    }
 873 }
 874
 875 /** Image driver interface */
 876 const __DRIimageDriverExtension driImageDriverExtension = {
 877     .base = { __DRI_IMAGE_DRIVER, 1 },
 878
 879     .createNewScreen2           = driCreateNewScreen2,
 880     .createNewDrawable          = driCreateNewDrawable,
 881     .getAPIMask                 = driGetAPIMask,
 882     .createContextAttribs       = driCreateContextAttribs,
 883 };
 884
 885 /* swrast copy sub buffer entrypoint. */
 886 static void driCopySubBuffer(__DRIdrawable *pdp, int x, int y,
 887                              int w, int h)
 888 {
 889     assert(pdp->driScreenPriv->swrast_loader);
 890
 891     pdp->driScreenPriv->driver->CopySubBuffer(pdp, x, y, w, h);
 892 }
 893
 894 /* for swrast only */
 895 const __DRIcopySubBufferExtension driCopySubBufferExtension = {
 896    .base = { __DRI_COPY_SUB_BUFFER, 1 },
 897
 898    .copySubBuffer               = driCopySubBuffer,
 899 };