src/mesa/main/formatquery.c

   1 /*
   2  * Copyright © 2012 Intel Corporation
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8  * and/or sell copies of the Software, and to permit persons to whom the
   9  * Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  21  * DEALINGS IN THE SOFTWARE.
  22  */
  23
  24 #include "mtypes.h"
  25 #include "context.h"
  26 #include "glformats.h"
  27 #include "macros.h"
  28 #include "enums.h"
  29 #include "fbobject.h"
  30 #include "formatquery.h"
  31 #include "teximage.h"
  32
  33 static bool
  34 _is_renderable(struct gl_context *ctx, GLenum internalformat)
  35 {
  36    /*  Section 4.4.4 on page 212 of the  GLES 3.0.4 spec says:
  37     *
  38     *     "An internal format is color-renderable if it is one of the
  39     *     formats from table 3.13 noted as color-renderable or if it
  40     *     is unsized format RGBA or RGB."
  41     *
  42     * Therefore, we must accept GL_RGB and GL_RGBA here.
  43     */
  44    if (internalformat != GL_RGB && internalformat != GL_RGBA &&
  45        _mesa_base_fbo_format(ctx, internalformat) == 0)
  46       return false;
  47
  48    return true;
  49 }
  50
  51 /* Handles the cases where either ARB_internalformat_query or
  52  * ARB_internalformat_query2 have to return an error.
  53  */
  54 static bool
  55 _legal_parameters(struct gl_context *ctx, GLenum target, GLenum internalformat,
  56                   GLenum pname, GLsizei bufSize, GLint *params)
  57
  58 {
  59    bool query2 = _mesa_has_ARB_internalformat_query2(ctx);
  60
  61    /* The ARB_internalformat_query2 spec says:
  62     *
  63     *    "The INVALID_ENUM error is generated if the <target> parameter to
  64     *    GetInternalformati*v is not one of the targets listed in Table 6.xx.
  65     */
  66    switch(target){
  67    case GL_TEXTURE_1D:
  68    case GL_TEXTURE_1D_ARRAY:
  69    case GL_TEXTURE_2D:
  70    case GL_TEXTURE_2D_ARRAY:
  71    case GL_TEXTURE_3D:
  72    case GL_TEXTURE_CUBE_MAP:
  73    case GL_TEXTURE_CUBE_MAP_ARRAY:
  74    case GL_TEXTURE_RECTANGLE:
  75    case GL_TEXTURE_BUFFER:
  76       if (!query2) {
  77          /* The ARB_internalformat_query spec says:
  78           *
  79           *     "If the <target> parameter to GetInternalformativ is not one of
  80           *      TEXTURE_2D_MULTISAMPLE, TEXTURE_2D_MULTISAMPLE_ARRAY
  81           *      or RENDERBUFFER then an INVALID_ENUM error is generated.
  82           */
  83          _mesa_error(ctx, GL_INVALID_ENUM,
  84                      "glGetInternalformativ(target=%s)",
  85                      _mesa_enum_to_string(target));
  86
  87          return false;
  88       }
  89       break;
  90
  91    case GL_RENDERBUFFER:
  92       break;
  93
  94    case GL_TEXTURE_2D_MULTISAMPLE:
  95    case GL_TEXTURE_2D_MULTISAMPLE_ARRAY:
  96       /* The non-existence of ARB_texture_multisample is treated in
  97        * ARB_internalformat_query implementation like an error.
  98        */
  99       if (!query2 &&
 100           !(_mesa_has_ARB_texture_multisample(ctx) || _mesa_is_gles31(ctx))) {
 101          _mesa_error(ctx, GL_INVALID_ENUM,
 102                      "glGetInternalformativ(target=%s)",
 103                      _mesa_enum_to_string(target));
 104
 105          return false;
 106       }
 107       break;
 108
 109    default:
 110       _mesa_error(ctx, GL_INVALID_ENUM,
 111                   "glGetInternalformativ(target=%s)",
 112                   _mesa_enum_to_string(target));
 113       return false;
 114    }
 115
 116
 117    /* The ARB_internalformat_query2 spec says:
 118     *
 119     *     "The INVALID_ENUM error is generated if the <pname> parameter is
 120     *     not one of the listed possibilities.
 121     */
 122    switch(pname){
 123    case GL_SAMPLES:
 124    case GL_NUM_SAMPLE_COUNTS:
 125       break;
 126
 127    case GL_SRGB_DECODE_ARB:
 128       /* The ARB_internalformat_query2 spec says:
 129        *
 130        *     "If ARB_texture_sRGB_decode or EXT_texture_sRGB_decode or
 131        *     equivalent functionality is not supported, queries for the
 132        *     SRGB_DECODE_ARB <pname> set the INVALID_ENUM error.
 133        */
 134       if (!_mesa_has_EXT_texture_sRGB_decode(ctx)) {
 135          _mesa_error(ctx, GL_INVALID_ENUM,
 136                      "glGetInternalformativ(pname=%s)",
 137                      _mesa_enum_to_string(pname));
 138          return false;
 139       }
 140       /* fallthrough */
 141    case GL_INTERNALFORMAT_SUPPORTED:
 142    case GL_INTERNALFORMAT_PREFERRED:
 143    case GL_INTERNALFORMAT_RED_SIZE:
 144    case GL_INTERNALFORMAT_GREEN_SIZE:
 145    case GL_INTERNALFORMAT_BLUE_SIZE:
 146    case GL_INTERNALFORMAT_ALPHA_SIZE:
 147    case GL_INTERNALFORMAT_DEPTH_SIZE:
 148    case GL_INTERNALFORMAT_STENCIL_SIZE:
 149    case GL_INTERNALFORMAT_SHARED_SIZE:
 150    case GL_INTERNALFORMAT_RED_TYPE:
 151    case GL_INTERNALFORMAT_GREEN_TYPE:
 152    case GL_INTERNALFORMAT_BLUE_TYPE:
 153    case GL_INTERNALFORMAT_ALPHA_TYPE:
 154    case GL_INTERNALFORMAT_DEPTH_TYPE:
 155    case GL_INTERNALFORMAT_STENCIL_TYPE:
 156    case GL_MAX_WIDTH:
 157    case GL_MAX_HEIGHT:
 158    case GL_MAX_DEPTH:
 159    case GL_MAX_LAYERS:
 160    case GL_MAX_COMBINED_DIMENSIONS:
 161    case GL_COLOR_COMPONENTS:
 162    case GL_DEPTH_COMPONENTS:
 163    case GL_STENCIL_COMPONENTS:
 164    case GL_COLOR_RENDERABLE:
 165    case GL_DEPTH_RENDERABLE:
 166    case GL_STENCIL_RENDERABLE:
 167    case GL_FRAMEBUFFER_RENDERABLE:
 168    case GL_FRAMEBUFFER_RENDERABLE_LAYERED:
 169    case GL_FRAMEBUFFER_BLEND:
 170    case GL_READ_PIXELS:
 171    case GL_READ_PIXELS_FORMAT:
 172    case GL_READ_PIXELS_TYPE:
 173    case GL_TEXTURE_IMAGE_FORMAT:
 174    case GL_TEXTURE_IMAGE_TYPE:
 175    case GL_GET_TEXTURE_IMAGE_FORMAT:
 176    case GL_GET_TEXTURE_IMAGE_TYPE:
 177    case GL_MIPMAP:
 178    case GL_MANUAL_GENERATE_MIPMAP:
 179    case GL_AUTO_GENERATE_MIPMAP:
 180    case GL_COLOR_ENCODING:
 181    case GL_SRGB_READ:
 182    case GL_SRGB_WRITE:
 183    case GL_FILTER:
 184    case GL_VERTEX_TEXTURE:
 185    case GL_TESS_CONTROL_TEXTURE:
 186    case GL_TESS_EVALUATION_TEXTURE:
 187    case GL_GEOMETRY_TEXTURE:
 188    case GL_FRAGMENT_TEXTURE:
 189    case GL_COMPUTE_TEXTURE:
 190    case GL_TEXTURE_SHADOW:
 191    case GL_TEXTURE_GATHER:
 192    case GL_TEXTURE_GATHER_SHADOW:
 193    case GL_SHADER_IMAGE_LOAD:
 194    case GL_SHADER_IMAGE_STORE:
 195    case GL_SHADER_IMAGE_ATOMIC:
 196    case GL_IMAGE_TEXEL_SIZE:
 197    case GL_IMAGE_COMPATIBILITY_CLASS:
 198    case GL_IMAGE_PIXEL_FORMAT:
 199    case GL_IMAGE_PIXEL_TYPE:
 200    case GL_IMAGE_FORMAT_COMPATIBILITY_TYPE:
 201    case GL_SIMULTANEOUS_TEXTURE_AND_DEPTH_TEST:
 202    case GL_SIMULTANEOUS_TEXTURE_AND_STENCIL_TEST:
 203    case GL_SIMULTANEOUS_TEXTURE_AND_DEPTH_WRITE:
 204    case GL_SIMULTANEOUS_TEXTURE_AND_STENCIL_WRITE:
 205    case GL_TEXTURE_COMPRESSED:
 206    case GL_TEXTURE_COMPRESSED_BLOCK_WIDTH:
 207    case GL_TEXTURE_COMPRESSED_BLOCK_HEIGHT:
 208    case GL_TEXTURE_COMPRESSED_BLOCK_SIZE:
 209    case GL_CLEAR_BUFFER:
 210    case GL_TEXTURE_VIEW:
 211    case GL_VIEW_COMPATIBILITY_CLASS:
 212       /* The ARB_internalformat_query spec says:
 213        *
 214        *     "If the <pname> parameter to GetInternalformativ is not SAMPLES
 215        *     or NUM_SAMPLE_COUNTS, then an INVALID_ENUM error is generated."
 216        */
 217       if (!query2) {
 218          _mesa_error(ctx, GL_INVALID_ENUM,
 219                      "glGetInternalformativ(pname=%s)",
 220                      _mesa_enum_to_string(pname));
 221
 222          return false;
 223       }
 224       break;
 225
 226    default:
 227       _mesa_error(ctx, GL_INVALID_ENUM,
 228                   "glGetInternalformativ(pname=%s)",
 229                   _mesa_enum_to_string(pname));
 230       return false;
 231    }
 232
 233    /* The ARB_internalformat_query spec says:
 234     *
 235     *     "If the <bufSize> parameter to GetInternalformativ is negative, then
 236     *     an INVALID_VALUE error is generated."
 237     *
 238     * Nothing is said in ARB_internalformat_query2 but we assume the same.
 239     */
 240    if (bufSize < 0) {
 241       _mesa_error(ctx, GL_INVALID_VALUE,
 242                   "glGetInternalformativ(target=%s)",
 243                   _mesa_enum_to_string(target));
 244       return false;
 245    }
 246
 247    /* The ARB_internalformat_query spec says:
 248     *
 249     *     "If the <internalformat> parameter to GetInternalformativ is not
 250     *     color-, depth- or stencil-renderable, then an INVALID_ENUM error is
 251     *     generated."
 252     */
 253    if (!query2 && !_is_renderable(ctx, internalformat)) {
 254       _mesa_error(ctx, GL_INVALID_ENUM,
 255                   "glGetInternalformativ(internalformat=%s)",
 256                   _mesa_enum_to_string(internalformat));
 257       return false;
 258    }
 259
 260    return true;
 261 }
 262
 263 /* Sets the appropriate "unsupported" response as defined by the
 264  * ARB_internalformat_query2 spec for each each <pname>.
 265  */
 266 static void
 267 _set_default_response(GLenum pname, GLint buffer[16])
 268 {
 269    /* The ARB_internalformat_query2 defines which is the reponse best
 270     * representing "not supported" or "not applicable" for each <pname>.
 271     *
 272     *     " In general:
 273     *          - size- or count-based queries will return zero,
 274     *          - support-, format- or type-based queries will return NONE,
 275     *          - boolean-based queries will return FALSE, and
 276     *          - list-based queries return no entries."
 277     */
 278    switch(pname) {
 279    case GL_SAMPLES:
 280       break;
 281
 282    case GL_MAX_COMBINED_DIMENSIONS:
 283    case GL_NUM_SAMPLE_COUNTS:
 284    case GL_INTERNALFORMAT_RED_SIZE:
 285    case GL_INTERNALFORMAT_GREEN_SIZE:
 286    case GL_INTERNALFORMAT_BLUE_SIZE:
 287    case GL_INTERNALFORMAT_ALPHA_SIZE:
 288    case GL_INTERNALFORMAT_DEPTH_SIZE:
 289    case GL_INTERNALFORMAT_STENCIL_SIZE:
 290    case GL_INTERNALFORMAT_SHARED_SIZE:
 291    case GL_MAX_WIDTH:
 292    case GL_MAX_HEIGHT:
 293    case GL_MAX_DEPTH:
 294    case GL_MAX_LAYERS:
 295    case GL_IMAGE_TEXEL_SIZE:
 296    case GL_TEXTURE_COMPRESSED_BLOCK_WIDTH:
 297    case GL_TEXTURE_COMPRESSED_BLOCK_HEIGHT:
 298    case GL_TEXTURE_COMPRESSED_BLOCK_SIZE:
 299       buffer[0] = 0;
 300       break;
 301
 302    case GL_INTERNALFORMAT_PREFERRED:
 303    case GL_INTERNALFORMAT_RED_TYPE:
 304    case GL_INTERNALFORMAT_GREEN_TYPE:
 305    case GL_INTERNALFORMAT_BLUE_TYPE:
 306    case GL_INTERNALFORMAT_ALPHA_TYPE:
 307    case GL_INTERNALFORMAT_DEPTH_TYPE:
 308    case GL_INTERNALFORMAT_STENCIL_TYPE:
 309    case GL_FRAMEBUFFER_RENDERABLE:
 310    case GL_FRAMEBUFFER_RENDERABLE_LAYERED:
 311    case GL_FRAMEBUFFER_BLEND:
 312    case GL_READ_PIXELS:
 313    case GL_READ_PIXELS_FORMAT:
 314    case GL_READ_PIXELS_TYPE:
 315    case GL_TEXTURE_IMAGE_FORMAT:
 316    case GL_TEXTURE_IMAGE_TYPE:
 317    case GL_GET_TEXTURE_IMAGE_FORMAT:
 318    case GL_GET_TEXTURE_IMAGE_TYPE:
 319    case GL_MANUAL_GENERATE_MIPMAP:
 320    case GL_AUTO_GENERATE_MIPMAP:
 321    case GL_COLOR_ENCODING:
 322    case GL_SRGB_READ:
 323    case GL_SRGB_WRITE:
 324    case GL_SRGB_DECODE_ARB:
 325    case GL_FILTER:
 326    case GL_VERTEX_TEXTURE:
 327    case GL_TESS_CONTROL_TEXTURE:
 328    case GL_TESS_EVALUATION_TEXTURE:
 329    case GL_GEOMETRY_TEXTURE:
 330    case GL_FRAGMENT_TEXTURE:
 331    case GL_COMPUTE_TEXTURE:
 332    case GL_TEXTURE_SHADOW:
 333    case GL_TEXTURE_GATHER:
 334    case GL_TEXTURE_GATHER_SHADOW:
 335    case GL_SHADER_IMAGE_LOAD:
 336    case GL_SHADER_IMAGE_STORE:
 337    case GL_SHADER_IMAGE_ATOMIC:
 338    case GL_IMAGE_COMPATIBILITY_CLASS:
 339    case GL_IMAGE_PIXEL_FORMAT:
 340    case GL_IMAGE_PIXEL_TYPE:
 341    case GL_IMAGE_FORMAT_COMPATIBILITY_TYPE:
 342    case GL_SIMULTANEOUS_TEXTURE_AND_DEPTH_TEST:
 343    case GL_SIMULTANEOUS_TEXTURE_AND_STENCIL_TEST:
 344    case GL_SIMULTANEOUS_TEXTURE_AND_DEPTH_WRITE:
 345    case GL_SIMULTANEOUS_TEXTURE_AND_STENCIL_WRITE:
 346    case GL_CLEAR_BUFFER:
 347    case GL_TEXTURE_VIEW:
 348    case GL_VIEW_COMPATIBILITY_CLASS:
 349       buffer[0] = GL_NONE;
 350       break;
 351
 352    case GL_INTERNALFORMAT_SUPPORTED:
 353    case GL_COLOR_COMPONENTS:
 354    case GL_DEPTH_COMPONENTS:
 355    case GL_STENCIL_COMPONENTS:
 356    case GL_COLOR_RENDERABLE:
 357    case GL_DEPTH_RENDERABLE:
 358    case GL_STENCIL_RENDERABLE:
 359    case GL_MIPMAP:
 360    case GL_TEXTURE_COMPRESSED:
 361       buffer[0] = GL_FALSE;
 362       break;
 363
 364    default:
 365       unreachable("invalid 'pname'");
 366    }
 367 }
 368
 369 static bool
 370 _is_target_supported(struct gl_context *ctx, GLenum target)
 371 {
 372    /* The ARB_internalformat_query2 spec says:
 373     *
 374     *     "if a particular type of <target> is not supported by the
 375     *     implementation the "unsupported" answer should be given.
 376     *     This is not an error."
 377     */
 378    switch(target){
 379    case GL_TEXTURE_2D:
 380    case GL_TEXTURE_3D:
 381       break;
 382
 383    case GL_TEXTURE_1D:
 384       if (!_mesa_is_desktop_gl(ctx))
 385          return false;
 386       break;
 387
 388    case GL_TEXTURE_1D_ARRAY:
 389       if (!_mesa_has_EXT_texture_array(ctx))
 390          return false;
 391       break;
 392
 393    case GL_TEXTURE_2D_ARRAY:
 394       if (!(_mesa_has_EXT_texture_array(ctx) || _mesa_is_gles3(ctx)))
 395          return false;
 396       break;
 397
 398    case GL_TEXTURE_CUBE_MAP:
 399       if (!_mesa_has_ARB_texture_cube_map(ctx))
 400          return false;
 401       break;
 402
 403    case GL_TEXTURE_CUBE_MAP_ARRAY:
 404       if (!_mesa_has_ARB_texture_cube_map_array(ctx))
 405          return false;
 406       break;
 407
 408    case GL_TEXTURE_RECTANGLE:
 409       if (!_mesa_has_NV_texture_rectangle(ctx))
 410           return false;
 411       break;
 412
 413    case GL_TEXTURE_BUFFER:
 414       if (!_mesa_has_ARB_texture_buffer_object(ctx))
 415          return false;
 416       break;
 417
 418    case GL_RENDERBUFFER:
 419       if (!(_mesa_has_ARB_framebuffer_object(ctx) ||
 420             _mesa_is_gles3(ctx)))
 421          return false;
 422       break;
 423
 424    case GL_TEXTURE_2D_MULTISAMPLE:
 425    case GL_TEXTURE_2D_MULTISAMPLE_ARRAY:
 426       if (!(_mesa_has_ARB_texture_multisample(ctx) ||
 427             _mesa_is_gles31(ctx)))
 428          return false;
 429       break;
 430
 431    default:
 432       unreachable("invalid target");
 433    }
 434
 435    return true;
 436 }
 437
 438 /* default implementation of QueryInternalFormat driverfunc, for
 439  * drivers not implementing ARB_internalformat_query2.
 440  */
 441 void
 442 _mesa_query_internal_format_default(struct gl_context *ctx, GLenum target,
 443                                     GLenum internalFormat, GLenum pname,
 444                                     GLint *params)
 445 {
 446    (void) ctx;
 447    (void) target;
 448    (void) internalFormat;
 449
 450    switch (pname) {
 451    case GL_SAMPLES:
 452    case GL_NUM_SAMPLE_COUNTS:
 453       params[0] = 1;
 454       break;
 455    default:
 456       _set_default_response(pname, params);
 457       break;
 458    }
 459 }
 460
 461 void GLAPIENTRY
 462 _mesa_GetInternalformativ(GLenum target, GLenum internalformat, GLenum pname,
 463                           GLsizei bufSize, GLint *params)
 464 {
 465    GLint buffer[16];
 466    GET_CURRENT_CONTEXT(ctx);
 467
 468    ASSERT_OUTSIDE_BEGIN_END(ctx);
 469
 470    /* ARB_internalformat_query is also mandatory for ARB_internalformat_query2 */
 471    if (!(_mesa_has_ARB_internalformat_query(ctx) ||
 472          _mesa_is_gles3(ctx))) {
 473       _mesa_error(ctx, GL_INVALID_OPERATION, "glGetInternalformativ");
 474       return;
 475    }
 476
 477    assert(ctx->Driver.QueryInternalFormat != NULL);
 478
 479    if (!_legal_parameters(ctx, target, internalformat, pname, bufSize, params))
 480       return;
 481
 482    /* initialize the contents of the temporary buffer */
 483    memcpy(buffer, params, MIN2(bufSize, 16) * sizeof(GLint));
 484
 485    /* Use the 'unsupported' response defined by the spec for every pname
 486     * as the default answer.
 487     */
 488    _set_default_response(pname, buffer);
 489
 490    if (!_is_target_supported(ctx, target))
 491       goto end;
 492
 493    switch (pname) {
 494    case GL_SAMPLES:
 495       /* fall-through */
 496    case GL_NUM_SAMPLE_COUNTS:
 497       /* The ARB_internalformat_query2 sets the response as 'unsupported' for
 498        * SAMPLES and NUM_SAMPLE_COUNTS:
 499        *
 500        *     "If <internalformat> is not color-renderable, depth-renderable, or
 501        *     stencil-renderable (as defined in section 4.4.4), or if <target>
 502        *     does not support multiple samples (ie other than
 503        *     TEXTURE_2D_MULTISAMPLE,  TEXTURE_2D_MULTISAMPLE_ARRAY,
 504        *     or RENDERBUFFER)."
 505        */
 506       if ((target != GL_RENDERBUFFER &&
 507            target != GL_TEXTURE_2D_MULTISAMPLE &&
 508            target != GL_TEXTURE_2D_MULTISAMPLE_ARRAY) ||
 509           !_is_renderable(ctx, internalformat))
 510          goto end;
 511
 512       /* The GL ES 3.0 specification, section 6.1.15 page 236 says:
 513        *
 514        *     "Since multisampling is not supported for signed and unsigned
 515        *     integer internal formats, the value of NUM_SAMPLE_COUNTS will be
 516        *     zero for such formats.
 517        */
 518       if (pname == GL_NUM_SAMPLE_COUNTS && ctx->API == API_OPENGLES2 &&
 519           ctx->Version == 30 && _mesa_is_enum_format_integer(internalformat)) {
 520          goto end;
 521       }
 522
 523       ctx->Driver.QueryInternalFormat(ctx, target, internalformat, pname,
 524                                       buffer);
 525       break;
 526
 527    case GL_INTERNALFORMAT_SUPPORTED:
 528       /* @TODO */
 529       break;
 530
 531    case GL_INTERNALFORMAT_PREFERRED:
 532       /* @TODO */
 533       break;
 534
 535    case GL_INTERNALFORMAT_RED_SIZE:
 536       /* @TODO */
 537       break;
 538
 539    case GL_INTERNALFORMAT_GREEN_SIZE:
 540       /* @TODO */
 541       break;
 542
 543    case GL_INTERNALFORMAT_BLUE_SIZE:
 544       /* @TODO */
 545       break;
 546
 547    case GL_INTERNALFORMAT_ALPHA_SIZE:
 548       /* @TODO */
 549       break;
 550
 551    case GL_INTERNALFORMAT_DEPTH_SIZE:
 552       /* @TODO */
 553       break;
 554
 555    case GL_INTERNALFORMAT_STENCIL_SIZE:
 556       /* @TODO */
 557       break;
 558
 559    case GL_INTERNALFORMAT_SHARED_SIZE:
 560       /* @TODO */
 561       break;
 562
 563    case GL_INTERNALFORMAT_RED_TYPE:
 564       /* @TODO */
 565       break;
 566
 567    case GL_INTERNALFORMAT_GREEN_TYPE:
 568       /* @TODO */
 569       break;
 570
 571    case GL_INTERNALFORMAT_BLUE_TYPE:
 572       /* @TODO */
 573       break;
 574
 575    case GL_INTERNALFORMAT_ALPHA_TYPE:
 576       /* @TODO */
 577       break;
 578
 579    case GL_INTERNALFORMAT_DEPTH_TYPE:
 580       /* @TODO */
 581       break;
 582
 583    case GL_INTERNALFORMAT_STENCIL_TYPE:
 584       /* @TODO */
 585       break;
 586
 587    case GL_MAX_WIDTH:
 588       /* @TODO */
 589       break;
 590
 591    case GL_MAX_HEIGHT:
 592       /* @TODO */
 593       break;
 594
 595    case GL_MAX_DEPTH:
 596       /* @TODO */
 597       break;
 598
 599    case GL_MAX_LAYERS:
 600       /* @TODO */
 601       break;
 602
 603    case GL_MAX_COMBINED_DIMENSIONS:
 604       /* @TODO */
 605       break;
 606
 607    case GL_COLOR_COMPONENTS:
 608       /* @TODO */
 609       break;
 610
 611    case GL_DEPTH_COMPONENTS:
 612       /* @TODO */
 613       break;
 614
 615    case GL_STENCIL_COMPONENTS:
 616       /* @TODO */
 617       break;
 618
 619    case GL_COLOR_RENDERABLE:
 620       /* @TODO */
 621       break;
 622
 623    case GL_DEPTH_RENDERABLE:
 624       /* @TODO */
 625       break;
 626
 627    case GL_STENCIL_RENDERABLE:
 628       /* @TODO */
 629       break;
 630
 631    case GL_FRAMEBUFFER_RENDERABLE:
 632       /* @TODO */
 633       break;
 634
 635    case GL_FRAMEBUFFER_RENDERABLE_LAYERED:
 636       /* @TODO */
 637       break;
 638
 639    case GL_FRAMEBUFFER_BLEND:
 640       /* @TODO */
 641       break;
 642
 643    case GL_READ_PIXELS:
 644       /* @TODO */
 645       break;
 646
 647    case GL_READ_PIXELS_FORMAT:
 648       /* @TODO */
 649       break;
 650
 651    case GL_READ_PIXELS_TYPE:
 652       /* @TODO */
 653       break;
 654
 655    case GL_TEXTURE_IMAGE_FORMAT:
 656       /* @TODO */
 657       break;
 658
 659    case GL_TEXTURE_IMAGE_TYPE:
 660       /* @TODO */
 661       break;
 662
 663    case GL_GET_TEXTURE_IMAGE_FORMAT:
 664       /* @TODO */
 665       break;
 666
 667    case GL_GET_TEXTURE_IMAGE_TYPE:
 668       /* @TODO */
 669       break;
 670
 671    case GL_MIPMAP:
 672       /* @TODO */
 673       break;
 674
 675    case GL_MANUAL_GENERATE_MIPMAP:
 676       /* @TODO */
 677       break;
 678
 679    case GL_AUTO_GENERATE_MIPMAP:
 680       /* @TODO */
 681       break;
 682
 683    case GL_COLOR_ENCODING:
 684       /* @TODO */
 685       break;
 686
 687    case GL_SRGB_READ:
 688       /* @TODO */
 689       break;
 690
 691    case GL_SRGB_WRITE:
 692       /* @TODO */
 693       break;
 694
 695    case GL_SRGB_DECODE_ARB:
 696       /* @TODO */
 697       break;
 698
 699    case GL_FILTER:
 700       /* @TODO */
 701       break;
 702
 703    case GL_VERTEX_TEXTURE:
 704       /* @TODO */
 705       break;
 706
 707    case GL_TESS_CONTROL_TEXTURE:
 708       /* @TODO */
 709       break;
 710
 711    case GL_TESS_EVALUATION_TEXTURE:
 712       /* @TODO */
 713       break;
 714
 715    case GL_GEOMETRY_TEXTURE:
 716       /* @TODO */
 717       break;
 718
 719    case GL_FRAGMENT_TEXTURE:
 720       /* @TODO */
 721       break;
 722
 723    case GL_COMPUTE_TEXTURE:
 724       /* @TODO */
 725       break;
 726
 727    case GL_TEXTURE_SHADOW:
 728       /* @TODO */
 729       break;
 730
 731    case GL_TEXTURE_GATHER:
 732       /* @TODO */
 733       break;
 734
 735    case GL_TEXTURE_GATHER_SHADOW:
 736       /* @TODO */
 737       break;
 738
 739    case GL_SHADER_IMAGE_LOAD:
 740       /* @TODO */
 741       break;
 742
 743    case GL_SHADER_IMAGE_STORE:
 744       /* @TODO */
 745       break;
 746
 747    case GL_SHADER_IMAGE_ATOMIC:
 748       /* @TODO */
 749       break;
 750
 751    case GL_IMAGE_TEXEL_SIZE:
 752       /* @TODO */
 753       break;
 754
 755    case GL_IMAGE_COMPATIBILITY_CLASS:
 756       /* @TODO */
 757       break;
 758
 759    case GL_IMAGE_PIXEL_FORMAT:
 760       /* @TODO */
 761       break;
 762
 763    case GL_IMAGE_PIXEL_TYPE:
 764       /* @TODO */
 765       break;
 766
 767    case GL_IMAGE_FORMAT_COMPATIBILITY_TYPE:
 768       /* @TODO */
 769       break;
 770
 771    case GL_SIMULTANEOUS_TEXTURE_AND_DEPTH_TEST:
 772       /* @TODO */
 773       break;
 774
 775    case GL_SIMULTANEOUS_TEXTURE_AND_STENCIL_TEST:
 776       /* @TODO */
 777       break;
 778
 779    case GL_SIMULTANEOUS_TEXTURE_AND_DEPTH_WRITE:
 780       /* @TODO */
 781       break;
 782
 783    case GL_SIMULTANEOUS_TEXTURE_AND_STENCIL_WRITE:
 784       /* @TODO */
 785       break;
 786
 787    case GL_TEXTURE_COMPRESSED:
 788       /* @TODO */
 789       break;
 790
 791    case GL_TEXTURE_COMPRESSED_BLOCK_WIDTH:
 792       /* @TODO */
 793       break;
 794
 795    case GL_TEXTURE_COMPRESSED_BLOCK_HEIGHT:
 796       /* @TODO */
 797       break;
 798
 799    case GL_TEXTURE_COMPRESSED_BLOCK_SIZE:
 800       /* @TODO */
 801       break;
 802
 803    case GL_CLEAR_BUFFER:
 804       /* @TODO */
 805       break;
 806
 807    case GL_TEXTURE_VIEW:
 808       /* @TODO */
 809       break;
 810
 811    case GL_VIEW_COMPATIBILITY_CLASS:
 812       /* @TODO */
 813       break;
 814
 815    default:
 816       unreachable("bad param");
 817    }
 818
 819  end:
 820    if (bufSize != 0 && params == NULL) {
 821       /* Emit a warning to aid application debugging, but go ahead and do the
 822        * memcpy (and probably crash) anyway.
 823        */
 824       _mesa_warning(ctx,
 825                     "glGetInternalformativ(bufSize = %d, but params = NULL)",
 826                     bufSize);
 827    }
 828
 829    /* Copy the data from the temporary buffer to the buffer supplied by the
 830     * application.  Clamp the size of the copy to the size supplied by the
 831     * application.
 832     */
 833    memcpy(params, buffer, MIN2(bufSize, 16) * sizeof(GLint));
 834
 835    return;
 836 }