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 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        _mesa_set_debug_state_int(ctx, GL_DEBUG_OUTPUT, GL_TRUE);
 453         ctx->Const.ContextFlags |= GL_CONTEXT_FLAG_DEBUG_BIT;
 454     }
 455 }
 456
 457 static __DRIcontext *
 458 driCreateNewContextForAPI(__DRIscreen *screen, int api,
 459                           const __DRIconfig *config,
 460                           __DRIcontext *shared, void *data)
 461 {
 462     unsigned error;
 463
 464     return driCreateContextAttribs(screen, api, config, shared, 0, NULL,
 465                                    &error, data);
 466 }
 467
 468 static __DRIcontext *
 469 driCreateNewContext(__DRIscreen *screen, const __DRIconfig *config,
 470                     __DRIcontext *shared, void *data)
 471 {
 472     return driCreateNewContextForAPI(screen, __DRI_API_OPENGL,
 473                                      config, shared, data);
 474 }
 475
 476 /**
 477  * Destroy the per-context private information.
 478  *
 479  * \internal
 480  * This function calls __DriverAPIRec::DestroyContext on \p contextPrivate, calls
 481  * drmDestroyContext(), and finally frees \p contextPrivate.
 482  */
 483 static void
 484 driDestroyContext(__DRIcontext *pcp)
 485 {
 486     if (pcp) {
 487         pcp->driScreenPriv->driver->DestroyContext(pcp);
 488         free(pcp);
 489     }
 490 }
 491
 492 static int
 493 driCopyContext(__DRIcontext *dest, __DRIcontext *src, unsigned long mask)
 494 {
 495     (void) dest;
 496     (void) src;
 497     (void) mask;
 498     return GL_FALSE;
 499 }
 500
 501 /*@}*/
 502
 503
 504 /*****************************************************************/
 505 /** \name Context (un)binding functions                          */
 506 /*****************************************************************/
 507 /*@{*/
 508
 509 static void dri_get_drawable(__DRIdrawable *pdp);
 510 static void dri_put_drawable(__DRIdrawable *pdp);
 511
 512 /**
 513  * This function takes both a read buffer and a draw buffer.  This is needed
 514  * for \c glXMakeCurrentReadSGI or GLX 1.3's \c glXMakeContextCurrent
 515  * function.
 516  */
 517 static int driBindContext(__DRIcontext *pcp,
 518                           __DRIdrawable *pdp,
 519                           __DRIdrawable *prp)
 520 {
 521     /*
 522     ** Assume error checking is done properly in glXMakeCurrent before
 523     ** calling driUnbindContext.
 524     */
 525
 526     if (!pcp)
 527         return GL_FALSE;
 528
 529     /* Bind the drawable to the context */
 530     pcp->driDrawablePriv = pdp;
 531     pcp->driReadablePriv = prp;
 532     if (pdp) {
 533         pdp->driContextPriv = pcp;
 534         dri_get_drawable(pdp);
 535     }
 536     if (prp && pdp != prp) {
 537         dri_get_drawable(prp);
 538     }
 539
 540     return pcp->driScreenPriv->driver->MakeCurrent(pcp, pdp, prp);
 541 }
 542
 543 /**
 544  * Unbind context.
 545  *
 546  * \param scrn the screen.
 547  * \param gc context.
 548  *
 549  * \return \c GL_TRUE on success, or \c GL_FALSE on failure.
 550  *
 551  * \internal
 552  * This function calls __DriverAPIRec::UnbindContext, and then decrements
 553  * __DRIdrawableRec::refcount which must be non-zero for a successful
 554  * return.
 555  *
 556  * While casting the opaque private pointers associated with the parameters
 557  * into their respective real types it also assures they are not \c NULL.
 558  */
 559 static int driUnbindContext(__DRIcontext *pcp)
 560 {
 561     __DRIdrawable *pdp;
 562     __DRIdrawable *prp;
 563
 564     /*
 565     ** Assume error checking is done properly in glXMakeCurrent before
 566     ** calling driUnbindContext.
 567     */
 568
 569     if (pcp == NULL)
 570         return GL_FALSE;
 571
 572     pdp = pcp->driDrawablePriv;
 573     prp = pcp->driReadablePriv;
 574
 575     /* already unbound */
 576     if (!pdp && !prp)
 577         return GL_TRUE;
 578
 579     pcp->driScreenPriv->driver->UnbindContext(pcp);
 580
 581     assert(pdp);
 582     if (pdp->refcount == 0) {
 583         /* ERROR!!! */
 584         return GL_FALSE;
 585     }
 586
 587     dri_put_drawable(pdp);
 588
 589     if (prp != pdp) {
 590         if (prp->refcount == 0) {
 591             /* ERROR!!! */
 592             return GL_FALSE;
 593         }
 594
 595         dri_put_drawable(prp);
 596     }
 597
 598     pcp->driDrawablePriv = NULL;
 599     pcp->driReadablePriv = NULL;
 600
 601     return GL_TRUE;
 602 }
 603
 604 /*@}*/
 605
 606
 607 static void dri_get_drawable(__DRIdrawable *pdp)
 608 {
 609     pdp->refcount++;
 610 }
 611
 612 static void dri_put_drawable(__DRIdrawable *pdp)
 613 {
 614     if (pdp) {
 615         pdp->refcount--;
 616         if (pdp->refcount)
 617             return;
 618
 619         pdp->driScreenPriv->driver->DestroyBuffer(pdp);
 620         free(pdp);
 621     }
 622 }
 623
 624 static __DRIdrawable *
 625 driCreateNewDrawable(__DRIscreen *screen,
 626                      const __DRIconfig *config,
 627                      void *data)
 628 {
 629     __DRIdrawable *pdraw;
 630
 631     pdraw = malloc(sizeof *pdraw);
 632     if (!pdraw)
 633         return NULL;
 634
 635     pdraw->loaderPrivate = data;
 636
 637     pdraw->driScreenPriv = screen;
 638     pdraw->driContextPriv = NULL;
 639     pdraw->refcount = 0;
 640     pdraw->lastStamp = 0;
 641     pdraw->w = 0;
 642     pdraw->h = 0;
 643
 644     dri_get_drawable(pdraw);
 645
 646     if (!screen->driver->CreateBuffer(screen, pdraw, &config->modes,
 647                                       GL_FALSE)) {
 648        free(pdraw);
 649        return NULL;
 650     }
 651
 652     pdraw->dri2.stamp = pdraw->lastStamp + 1;
 653
 654     return pdraw;
 655 }
 656
 657 static void
 658 driDestroyDrawable(__DRIdrawable *pdp)
 659 {
 660     dri_put_drawable(pdp);
 661 }
 662
 663 static __DRIbuffer *
 664 dri2AllocateBuffer(__DRIscreen *screen,
 665                    unsigned int attachment, unsigned int format,
 666                    int width, int height)
 667 {
 668     return screen->driver->AllocateBuffer(screen, attachment, format,
 669                                           width, height);
 670 }
 671
 672 static void
 673 dri2ReleaseBuffer(__DRIscreen *screen, __DRIbuffer *buffer)
 674 {
 675     screen->driver->ReleaseBuffer(screen, buffer);
 676 }
 677
 678
 679 static int
 680 dri2ConfigQueryb(__DRIscreen *screen, const char *var, bool *val)
 681 {
 682    if (!driCheckOption(&screen->optionCache, var, DRI_BOOL))
 683       return -1;
 684
 685    *val = driQueryOptionb(&screen->optionCache, var);
 686
 687    return 0;
 688 }
 689
 690 static int
 691 dri2ConfigQueryi(__DRIscreen *screen, const char *var, int *val)
 692 {
 693    if (!driCheckOption(&screen->optionCache, var, DRI_INT) &&
 694        !driCheckOption(&screen->optionCache, var, DRI_ENUM))
 695       return -1;
 696
 697     *val = driQueryOptioni(&screen->optionCache, var);
 698
 699     return 0;
 700 }
 701
 702 static int
 703 dri2ConfigQueryf(__DRIscreen *screen, const char *var, float *val)
 704 {
 705    if (!driCheckOption(&screen->optionCache, var, DRI_FLOAT))
 706       return -1;
 707
 708     *val = driQueryOptionf(&screen->optionCache, var);
 709
 710     return 0;
 711 }
 712
 713 static unsigned int
 714 driGetAPIMask(__DRIscreen *screen)
 715 {
 716     return screen->api_mask;
 717 }
 718
 719 /**
 720  * swrast swapbuffers entrypoint.
 721  *
 722  * DRI2 implements this inside the loader with only flushes handled by the
 723  * driver.
 724  */
 725 static void
 726 driSwapBuffers(__DRIdrawable *pdp)
 727 {
 728     assert(pdp->driScreenPriv->swrast_loader);
 729
 730     pdp->driScreenPriv->driver->SwapBuffers(pdp);
 731 }
 732
 733 /** Core interface */
 734 const __DRIcoreExtension driCoreExtension = {
 735     .base = { __DRI_CORE, 1 },
 736
 737     .createNewScreen            = NULL,
 738     .destroyScreen              = driDestroyScreen,
 739     .getExtensions              = driGetExtensions,
 740     .getConfigAttrib            = driGetConfigAttrib,
 741     .indexConfigAttrib          = driIndexConfigAttrib,
 742     .createNewDrawable          = NULL,
 743     .destroyDrawable            = driDestroyDrawable,
 744     .swapBuffers                = driSwapBuffers, /* swrast */
 745     .createNewContext           = driCreateNewContext, /* swrast */
 746     .copyContext                = driCopyContext,
 747     .destroyContext             = driDestroyContext,
 748     .bindContext                = driBindContext,
 749     .unbindContext              = driUnbindContext
 750 };
 751
 752 /** DRI2 interface */
 753 const __DRIdri2Extension driDRI2Extension = {
 754     .base = { __DRI_DRI2, 4 },
 755
 756     .createNewScreen            = dri2CreateNewScreen,
 757     .createNewDrawable          = driCreateNewDrawable,
 758     .createNewContext           = driCreateNewContext,
 759     .getAPIMask                 = driGetAPIMask,
 760     .createNewContextForAPI     = driCreateNewContextForAPI,
 761     .allocateBuffer             = dri2AllocateBuffer,
 762     .releaseBuffer              = dri2ReleaseBuffer,
 763     .createContextAttribs       = driCreateContextAttribs,
 764     .createNewScreen2           = driCreateNewScreen2,
 765 };
 766
 767 const __DRIswrastExtension driSWRastExtension = {
 768     .base = { __DRI_SWRAST, 4 },
 769
 770     .createNewScreen            = driSWRastCreateNewScreen,
 771     .createNewDrawable          = driCreateNewDrawable,
 772     .createNewContextForAPI     = driCreateNewContextForAPI,
 773     .createContextAttribs       = driCreateContextAttribs,
 774     .createNewScreen2           = driSWRastCreateNewScreen2,
 775 };
 776
 777 const __DRI2configQueryExtension dri2ConfigQueryExtension = {
 778    .base = { __DRI2_CONFIG_QUERY, 1 },
 779
 780    .configQueryb        = dri2ConfigQueryb,
 781    .configQueryi        = dri2ConfigQueryi,
 782    .configQueryf        = dri2ConfigQueryf,
 783 };
 784
 785 void
 786 dri2InvalidateDrawable(__DRIdrawable *drawable)
 787 {
 788     drawable->dri2.stamp++;
 789 }
 790
 791 /**
 792  * Check that the gl_framebuffer associated with dPriv is the right size.
 793  * Resize the gl_framebuffer if needed.
 794  * It's expected that the dPriv->driverPrivate member points to a
 795  * gl_framebuffer object.
 796  */
 797 void
 798 driUpdateFramebufferSize(struct gl_context *ctx, const __DRIdrawable *dPriv)
 799 {
 800    struct gl_framebuffer *fb = (struct gl_framebuffer *) dPriv->driverPrivate;
 801    if (fb && (dPriv->w != fb->Width || dPriv->h != fb->Height)) {
 802       ctx->Driver.ResizeBuffers(ctx, fb, dPriv->w, dPriv->h);
 803       /* if the driver needs the hw lock for ResizeBuffers, the drawable
 804          might have changed again by now */
 805       assert(fb->Width == dPriv->w);
 806       assert(fb->Height == dPriv->h);
 807    }
 808 }
 809
 810 uint32_t
 811 driGLFormatToImageFormat(mesa_format format)
 812 {
 813    switch (format) {
 814    case MESA_FORMAT_B5G6R5_UNORM:
 815       return __DRI_IMAGE_FORMAT_RGB565;
 816    case MESA_FORMAT_B8G8R8X8_UNORM:
 817       return __DRI_IMAGE_FORMAT_XRGB8888;
 818    case MESA_FORMAT_B10G10R10A2_UNORM:
 819       return __DRI_IMAGE_FORMAT_ARGB2101010;
 820    case MESA_FORMAT_B10G10R10X2_UNORM:
 821       return __DRI_IMAGE_FORMAT_XRGB2101010;
 822    case MESA_FORMAT_B8G8R8A8_UNORM:
 823       return __DRI_IMAGE_FORMAT_ARGB8888;
 824    case MESA_FORMAT_R8G8B8A8_UNORM:
 825       return __DRI_IMAGE_FORMAT_ABGR8888;
 826    case MESA_FORMAT_R8G8B8X8_UNORM:
 827       return __DRI_IMAGE_FORMAT_XBGR8888;
 828    case MESA_FORMAT_R_UNORM8:
 829       return __DRI_IMAGE_FORMAT_R8;
 830    case MESA_FORMAT_R8G8_UNORM:
 831       return __DRI_IMAGE_FORMAT_GR88;
 832    case MESA_FORMAT_NONE:
 833       return __DRI_IMAGE_FORMAT_NONE;
 834    case MESA_FORMAT_B8G8R8A8_SRGB:
 835       return __DRI_IMAGE_FORMAT_SARGB8;
 836    default:
 837       return 0;
 838    }
 839 }
 840
 841 mesa_format
 842 driImageFormatToGLFormat(uint32_t image_format)
 843 {
 844    switch (image_format) {
 845    case __DRI_IMAGE_FORMAT_RGB565:
 846       return MESA_FORMAT_B5G6R5_UNORM;
 847    case __DRI_IMAGE_FORMAT_XRGB8888:
 848       return MESA_FORMAT_B8G8R8X8_UNORM;
 849    case __DRI_IMAGE_FORMAT_ARGB2101010:
 850       return MESA_FORMAT_B10G10R10A2_UNORM;
 851    case __DRI_IMAGE_FORMAT_XRGB2101010:
 852       return MESA_FORMAT_B10G10R10X2_UNORM;
 853    case __DRI_IMAGE_FORMAT_ARGB8888:
 854       return MESA_FORMAT_B8G8R8A8_UNORM;
 855    case __DRI_IMAGE_FORMAT_ABGR8888:
 856       return MESA_FORMAT_R8G8B8A8_UNORM;
 857    case __DRI_IMAGE_FORMAT_XBGR8888:
 858       return MESA_FORMAT_R8G8B8X8_UNORM;
 859    case __DRI_IMAGE_FORMAT_R8:
 860       return MESA_FORMAT_R_UNORM8;
 861    case __DRI_IMAGE_FORMAT_GR88:
 862       return MESA_FORMAT_R8G8_UNORM;
 863    case __DRI_IMAGE_FORMAT_SARGB8:
 864       return MESA_FORMAT_B8G8R8A8_SRGB;
 865    case __DRI_IMAGE_FORMAT_NONE:
 866       return MESA_FORMAT_NONE;
 867    default:
 868       return MESA_FORMAT_NONE;
 869    }
 870 }
 871
 872 /** Image driver interface */
 873 const __DRIimageDriverExtension driImageDriverExtension = {
 874     .base = { __DRI_IMAGE_DRIVER, 1 },
 875
 876     .createNewScreen2           = driCreateNewScreen2,
 877     .createNewDrawable          = driCreateNewDrawable,
 878     .getAPIMask                 = driGetAPIMask,
 879     .createContextAttribs       = driCreateContextAttribs,
 880 };
 881
 882 /* swrast copy sub buffer entrypoint. */
 883 static void driCopySubBuffer(__DRIdrawable *pdp, int x, int y,
 884                              int w, int h)
 885 {
 886     assert(pdp->driScreenPriv->swrast_loader);
 887
 888     pdp->driScreenPriv->driver->CopySubBuffer(pdp, x, y, w, h);
 889 }
 890
 891 /* for swrast only */
 892 const __DRIcopySubBufferExtension driCopySubBufferExtension = {
 893    .base = { __DRI_COPY_SUB_BUFFER, 1 },
 894
 895    .copySubBuffer               = driCopySubBuffer,
 896 };