src/mesa/main/fbobject.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  7.1
   4  *
   5  * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
   6  * Copyright (C) 1999-2009  VMware, Inc.  All Rights Reserved.
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a
   9  * copy of this software and associated documentation files (the "Software"),
  10  * to deal in the Software without restriction, including without limitation
  11  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  12  * and/or sell copies of the Software, and to permit persons to whom the
  13  * Software is furnished to do so, subject to the following conditions:
  14  *
  15  * The above copyright notice and this permission notice shall be included
  16  * in all copies or substantial portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  21  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  22  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  23  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  24  */
  25
  26
  27 /*
  28  * GL_EXT/ARB_framebuffer_object extensions
  29  *
  30  * Authors:
  31  *   Brian Paul
  32  */
  33
  34
  35 #include "buffers.h"
  36 #include "context.h"
  37 #include "enums.h"
  38 #include "fbobject.h"
  39 #include "formats.h"
  40 #include "framebuffer.h"
  41 #include "hash.h"
  42 #include "macros.h"
  43 #include "mfeatures.h"
  44 #include "mtypes.h"
  45 #include "renderbuffer.h"
  46 #include "state.h"
  47 #include "teximage.h"
  48 #include "texobj.h"
  49 #include "texparam.h"
  50
  51
  52 /** Set this to 1 to help debug FBO incompleteness problems */
  53 #define DEBUG_FBO 0
  54
  55 /** Set this to 1 to debug/log glBlitFramebuffer() calls */
  56 #define DEBUG_BLIT 0
  57
  58
  59 /**
  60  * Notes:
  61  *
  62  * None of the GL_EXT_framebuffer_object functions are compiled into
  63  * display lists.
  64  */
  65
  66
  67
  68 /*
  69  * When glGenRender/FramebuffersEXT() is called we insert pointers to
  70  * these placeholder objects into the hash table.
  71  * Later, when the object ID is first bound, we replace the placeholder
  72  * with the real frame/renderbuffer.
  73  */
  74 static struct gl_framebuffer DummyFramebuffer;
  75 static struct gl_renderbuffer DummyRenderbuffer;
  76
  77 /* We bind this framebuffer when applications pass a NULL
  78  * drawable/surface in make current. */
  79 static struct gl_framebuffer IncompleteFramebuffer;
  80
  81
  82 /**
  83  * Is the given FBO a user-created FBO?
  84  */
  85 static inline GLboolean
  86 is_user_fbo(const struct gl_framebuffer *fb)
  87 {
  88    return fb->Name != 0;
  89 }
  90
  91
  92 /**
  93  * Is the given FBO a window system FBO (like an X window)?
  94  */
  95 static inline GLboolean
  96 is_winsys_fbo(const struct gl_framebuffer *fb)
  97 {
  98    return fb->Name == 0;
  99 }
 100
 101
 102 static void
 103 delete_dummy_renderbuffer(struct gl_renderbuffer *rb)
 104 {
 105    /* no op */
 106 }
 107
 108 static void
 109 delete_dummy_framebuffer(struct gl_framebuffer *fb)
 110 {
 111    /* no op */
 112 }
 113
 114
 115 void
 116 _mesa_init_fbobjects(struct gl_context *ctx)
 117 {
 118    _glthread_INIT_MUTEX(DummyFramebuffer.Mutex);
 119    _glthread_INIT_MUTEX(DummyRenderbuffer.Mutex);
 120    _glthread_INIT_MUTEX(IncompleteFramebuffer.Mutex);
 121    DummyFramebuffer.Delete = delete_dummy_framebuffer;
 122    DummyRenderbuffer.Delete = delete_dummy_renderbuffer;
 123    IncompleteFramebuffer.Delete = delete_dummy_framebuffer;
 124 }
 125
 126 struct gl_framebuffer *
 127 _mesa_get_incomplete_framebuffer(void)
 128 {
 129    return &IncompleteFramebuffer;
 130 }
 131
 132 /**
 133  * Helper routine for getting a gl_renderbuffer.
 134  */
 135 struct gl_renderbuffer *
 136 _mesa_lookup_renderbuffer(struct gl_context *ctx, GLuint id)
 137 {
 138    struct gl_renderbuffer *rb;
 139
 140    if (id == 0)
 141       return NULL;
 142
 143    rb = (struct gl_renderbuffer *)
 144       _mesa_HashLookup(ctx->Shared->RenderBuffers, id);
 145    return rb;
 146 }
 147
 148
 149 /**
 150  * Helper routine for getting a gl_framebuffer.
 151  */
 152 struct gl_framebuffer *
 153 _mesa_lookup_framebuffer(struct gl_context *ctx, GLuint id)
 154 {
 155    struct gl_framebuffer *fb;
 156
 157    if (id == 0)
 158       return NULL;
 159
 160    fb = (struct gl_framebuffer *)
 161       _mesa_HashLookup(ctx->Shared->FrameBuffers, id);
 162    return fb;
 163 }
 164
 165
 166 /**
 167  * Mark the given framebuffer as invalid.  This will force the
 168  * test for framebuffer completeness to be done before the framebuffer
 169  * is used.
 170  */
 171 static void
 172 invalidate_framebuffer(struct gl_framebuffer *fb)
 173 {
 174    fb->_Status = 0; /* "indeterminate" */
 175 }
 176
 177
 178 /**
 179  * Return the gl_framebuffer object which corresponds to the given
 180  * framebuffer target, such as GL_DRAW_FRAMEBUFFER.
 181  * Check support for GL_EXT_framebuffer_blit to determine if certain
 182  * targets are legal.
 183  * \return gl_framebuffer pointer or NULL if target is illegal
 184  */
 185 static struct gl_framebuffer *
 186 get_framebuffer_target(struct gl_context *ctx, GLenum target)
 187 {
 188    switch (target) {
 189    case GL_DRAW_FRAMEBUFFER:
 190       return ctx->Extensions.EXT_framebuffer_blit && ctx->API == API_OPENGL
 191          ? ctx->DrawBuffer : NULL;
 192    case GL_READ_FRAMEBUFFER:
 193       return ctx->Extensions.EXT_framebuffer_blit && ctx->API == API_OPENGL
 194          ? ctx->ReadBuffer : NULL;
 195    case GL_FRAMEBUFFER_EXT:
 196       return ctx->DrawBuffer;
 197    default:
 198       return NULL;
 199    }
 200 }
 201
 202
 203 /**
 204  * Given a GL_*_ATTACHMENTn token, return a pointer to the corresponding
 205  * gl_renderbuffer_attachment object.
 206  * This function is only used for user-created FB objects, not the
 207  * default / window-system FB object.
 208  * If \p attachment is GL_DEPTH_STENCIL_ATTACHMENT, return a pointer to
 209  * the depth buffer attachment point.
 210  */
 211 struct gl_renderbuffer_attachment *
 212 _mesa_get_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
 213                      GLenum attachment)
 214 {
 215    GLuint i;
 216
 217    assert(is_user_fbo(fb));
 218
 219    switch (attachment) {
 220    case GL_COLOR_ATTACHMENT0_EXT:
 221    case GL_COLOR_ATTACHMENT1_EXT:
 222    case GL_COLOR_ATTACHMENT2_EXT:
 223    case GL_COLOR_ATTACHMENT3_EXT:
 224    case GL_COLOR_ATTACHMENT4_EXT:
 225    case GL_COLOR_ATTACHMENT5_EXT:
 226    case GL_COLOR_ATTACHMENT6_EXT:
 227    case GL_COLOR_ATTACHMENT7_EXT:
 228    case GL_COLOR_ATTACHMENT8_EXT:
 229    case GL_COLOR_ATTACHMENT9_EXT:
 230    case GL_COLOR_ATTACHMENT10_EXT:
 231    case GL_COLOR_ATTACHMENT11_EXT:
 232    case GL_COLOR_ATTACHMENT12_EXT:
 233    case GL_COLOR_ATTACHMENT13_EXT:
 234    case GL_COLOR_ATTACHMENT14_EXT:
 235    case GL_COLOR_ATTACHMENT15_EXT:
 236       /* Only OpenGL ES 1.x forbids color attachments other than
 237        * GL_COLOR_ATTACHMENT0.  For all other APIs the limit set by the
 238        * hardware is used.
 239        */
 240       i = attachment - GL_COLOR_ATTACHMENT0_EXT;
 241       if (i >= ctx->Const.MaxColorAttachments
 242           || (i > 0 && ctx->API == API_OPENGLES)) {
 243          return NULL;
 244       }
 245       return &fb->Attachment[BUFFER_COLOR0 + i];
 246    case GL_DEPTH_STENCIL_ATTACHMENT:
 247       if (ctx->API != API_OPENGL)
 248          return NULL;
 249       /* fall-through */
 250    case GL_DEPTH_ATTACHMENT_EXT:
 251       return &fb->Attachment[BUFFER_DEPTH];
 252    case GL_STENCIL_ATTACHMENT_EXT:
 253       return &fb->Attachment[BUFFER_STENCIL];
 254    default:
 255       return NULL;
 256    }
 257 }
 258
 259
 260 /**
 261  * As above, but only used for getting attachments of the default /
 262  * window-system framebuffer (not user-created framebuffer objects).
 263  */
 264 static struct gl_renderbuffer_attachment *
 265 _mesa_get_fb0_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
 266                          GLenum attachment)
 267 {
 268    assert(is_winsys_fbo(fb));
 269
 270    switch (attachment) {
 271    case GL_FRONT_LEFT:
 272       return &fb->Attachment[BUFFER_FRONT_LEFT];
 273    case GL_FRONT_RIGHT:
 274       return &fb->Attachment[BUFFER_FRONT_RIGHT];
 275    case GL_BACK_LEFT:
 276       return &fb->Attachment[BUFFER_BACK_LEFT];
 277    case GL_BACK_RIGHT:
 278       return &fb->Attachment[BUFFER_BACK_RIGHT];
 279    case GL_AUX0:
 280       if (fb->Visual.numAuxBuffers == 1) {
 281          return &fb->Attachment[BUFFER_AUX0];
 282       }
 283       return NULL;
 284
 285    /* Page 336 (page 352 of the PDF) of the OpenGL 3.0 spec says:
 286     *
 287     *     "If the default framebuffer is bound to target, then attachment must
 288     *     be one of FRONT LEFT, FRONT RIGHT, BACK LEFT, BACK RIGHT, or AUXi,
 289     *     identifying a color buffer; DEPTH, identifying the depth buffer; or
 290     *     STENCIL, identifying the stencil buffer."
 291     *
 292     * Revision #34 of the ARB_framebuffer_object spec has essentially the same
 293     * language.  However, revision #33 of the ARB_framebuffer_object spec
 294     * says:
 295     *
 296     *     "If the default framebuffer is bound to <target>, then <attachment>
 297     *     must be one of FRONT_LEFT, FRONT_RIGHT, BACK_LEFT, BACK_RIGHT, AUXi,
 298     *     DEPTH_BUFFER, or STENCIL_BUFFER, identifying a color buffer, the
 299     *     depth buffer, or the stencil buffer, and <pname> may be
 300     *     FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE or
 301     *     FRAMEBUFFER_ATTACHMENT_OBJECT_NAME."
 302     *
 303     * The enum values for DEPTH_BUFFER and STENCIL_BUFFER have been removed
 304     * from glext.h, so shipping apps should not use those values.
 305     *
 306     * Note that neither EXT_framebuffer_object nor OES_framebuffer_object
 307     * support queries of the window system FBO.
 308     */
 309    case GL_DEPTH:
 310       return &fb->Attachment[BUFFER_DEPTH];
 311    case GL_STENCIL:
 312       return &fb->Attachment[BUFFER_STENCIL];
 313    default:
 314       return NULL;
 315    }
 316 }
 317
 318
 319
 320 /**
 321  * Remove any texture or renderbuffer attached to the given attachment
 322  * point.  Update reference counts, etc.
 323  */
 324 void
 325 _mesa_remove_attachment(struct gl_context *ctx,
 326                         struct gl_renderbuffer_attachment *att)
 327 {
 328    if (att->Type == GL_TEXTURE) {
 329       ASSERT(att->Texture);
 330       if (ctx->Driver.FinishRenderTexture) {
 331          /* tell driver that we're done rendering to this texture. */
 332          ctx->Driver.FinishRenderTexture(ctx, att);
 333       }
 334       _mesa_reference_texobj(&att->Texture, NULL); /* unbind */
 335       ASSERT(!att->Texture);
 336    }
 337    if (att->Type == GL_TEXTURE || att->Type == GL_RENDERBUFFER_EXT) {
 338       ASSERT(!att->Texture);
 339       _mesa_reference_renderbuffer(&att->Renderbuffer, NULL); /* unbind */
 340       ASSERT(!att->Renderbuffer);
 341    }
 342    att->Type = GL_NONE;
 343    att->Complete = GL_TRUE;
 344 }
 345
 346
 347 /**
 348  * Bind a texture object to an attachment point.
 349  * The previous binding, if any, will be removed first.
 350  */
 351 void
 352 _mesa_set_texture_attachment(struct gl_context *ctx,
 353                              struct gl_framebuffer *fb,
 354                              struct gl_renderbuffer_attachment *att,
 355                              struct gl_texture_object *texObj,
 356                              GLenum texTarget, GLuint level, GLuint zoffset)
 357 {
 358    if (att->Texture == texObj) {
 359       /* re-attaching same texture */
 360       ASSERT(att->Type == GL_TEXTURE);
 361       if (ctx->Driver.FinishRenderTexture)
 362          ctx->Driver.FinishRenderTexture(ctx, att);
 363    }
 364    else {
 365       /* new attachment */
 366       if (ctx->Driver.FinishRenderTexture && att->Texture)
 367          ctx->Driver.FinishRenderTexture(ctx, att);
 368       _mesa_remove_attachment(ctx, att);
 369       att->Type = GL_TEXTURE;
 370       assert(!att->Texture);
 371       _mesa_reference_texobj(&att->Texture, texObj);
 372    }
 373
 374    /* always update these fields */
 375    att->TextureLevel = level;
 376    att->CubeMapFace = _mesa_tex_target_to_face(texTarget);
 377    att->Zoffset = zoffset;
 378    att->Complete = GL_FALSE;
 379
 380    if (_mesa_get_attachment_teximage(att)) {
 381       ctx->Driver.RenderTexture(ctx, fb, att);
 382    }
 383
 384    invalidate_framebuffer(fb);
 385 }
 386
 387
 388 /**
 389  * Bind a renderbuffer to an attachment point.
 390  * The previous binding, if any, will be removed first.
 391  */
 392 void
 393 _mesa_set_renderbuffer_attachment(struct gl_context *ctx,
 394                                   struct gl_renderbuffer_attachment *att,
 395                                   struct gl_renderbuffer *rb)
 396 {
 397    /* XXX check if re-doing same attachment, exit early */
 398    _mesa_remove_attachment(ctx, att);
 399    att->Type = GL_RENDERBUFFER_EXT;
 400    att->Texture = NULL; /* just to be safe */
 401    att->Complete = GL_FALSE;
 402    _mesa_reference_renderbuffer(&att->Renderbuffer, rb);
 403 }
 404
 405
 406 /**
 407  * Fallback for ctx->Driver.FramebufferRenderbuffer()
 408  * Attach a renderbuffer object to a framebuffer object.
 409  */
 410 void
 411 _mesa_framebuffer_renderbuffer(struct gl_context *ctx,
 412                                struct gl_framebuffer *fb,
 413                                GLenum attachment, struct gl_renderbuffer *rb)
 414 {
 415    struct gl_renderbuffer_attachment *att;
 416
 417    _glthread_LOCK_MUTEX(fb->Mutex);
 418
 419    att = _mesa_get_attachment(ctx, fb, attachment);
 420    ASSERT(att);
 421    if (rb) {
 422       _mesa_set_renderbuffer_attachment(ctx, att, rb);
 423       if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
 424          /* do stencil attachment here (depth already done above) */
 425          att = _mesa_get_attachment(ctx, fb, GL_STENCIL_ATTACHMENT_EXT);
 426          assert(att);
 427          _mesa_set_renderbuffer_attachment(ctx, att, rb);
 428       }
 429       rb->AttachedAnytime = GL_TRUE;
 430    }
 431    else {
 432       _mesa_remove_attachment(ctx, att);
 433    }
 434
 435    invalidate_framebuffer(fb);
 436
 437    _glthread_UNLOCK_MUTEX(fb->Mutex);
 438 }
 439
 440
 441 /**
 442  * Fallback for ctx->Driver.ValidateFramebuffer()
 443  * Check if the renderbuffer's formats are supported by the software
 444  * renderer.
 445  * Drivers should probably override this.
 446  */
 447 void
 448 _mesa_validate_framebuffer(struct gl_context *ctx, struct gl_framebuffer *fb)
 449 {
 450    gl_buffer_index buf;
 451    for (buf = 0; buf < BUFFER_COUNT; buf++) {
 452       const struct gl_renderbuffer *rb = fb->Attachment[buf].Renderbuffer;
 453       if (rb) {
 454          switch (rb->_BaseFormat) {
 455          case GL_ALPHA:
 456          case GL_LUMINANCE_ALPHA:
 457          case GL_LUMINANCE:
 458          case GL_INTENSITY:
 459          case GL_RED:
 460          case GL_RG:
 461             fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
 462             return;
 463
 464          default:
 465             switch (rb->Format) {
 466             /* XXX This list is likely incomplete. */
 467             case MESA_FORMAT_RGB9_E5_FLOAT:
 468                fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
 469                return;
 470             default:;
 471                /* render buffer format is supported by software rendering */
 472             }
 473          }
 474       }
 475    }
 476 }
 477
 478
 479 /**
 480  * For debug only.
 481  */
 482 static void
 483 att_incomplete(const char *msg)
 484 {
 485 #if DEBUG_FBO
 486    _mesa_debug(NULL, "attachment incomplete: %s\n", msg);
 487 #else
 488    (void) msg;
 489 #endif
 490 }
 491
 492
 493 /**
 494  * For debug only.
 495  */
 496 static void
 497 fbo_incomplete(const char *msg, int index)
 498 {
 499 #if DEBUG_FBO
 500    _mesa_debug(NULL, "FBO Incomplete: %s [%d]\n", msg, index);
 501 #else
 502    (void) msg;
 503    (void) index;
 504 #endif
 505 }
 506
 507
 508 /**
 509  * Is the given base format a legal format for a color renderbuffer?
 510  */
 511 GLboolean
 512 _mesa_is_legal_color_format(const struct gl_context *ctx, GLenum baseFormat)
 513 {
 514    switch (baseFormat) {
 515    case GL_RGB:
 516    case GL_RGBA:
 517       return GL_TRUE;
 518    case GL_LUMINANCE:
 519    case GL_LUMINANCE_ALPHA:
 520    case GL_INTENSITY:
 521    case GL_ALPHA:
 522       return ctx->Extensions.ARB_framebuffer_object;
 523    case GL_RED:
 524    case GL_RG:
 525       return ctx->Extensions.ARB_texture_rg;
 526    default:
 527       return GL_FALSE;
 528    }
 529 }
 530
 531
 532 /**
 533  * Is the given base format a legal format for a depth/stencil renderbuffer?
 534  */
 535 static GLboolean
 536 is_legal_depth_format(const struct gl_context *ctx, GLenum baseFormat)
 537 {
 538    switch (baseFormat) {
 539    case GL_DEPTH_COMPONENT:
 540    case GL_DEPTH_STENCIL_EXT:
 541       return GL_TRUE;
 542    default:
 543       return GL_FALSE;
 544    }
 545 }
 546
 547
 548 /**
 549  * Test if an attachment point is complete and update its Complete field.
 550  * \param format if GL_COLOR, this is a color attachment point,
 551  *               if GL_DEPTH, this is a depth component attachment point,
 552  *               if GL_STENCIL, this is a stencil component attachment point.
 553  */
 554 static void
 555 test_attachment_completeness(const struct gl_context *ctx, GLenum format,
 556                              struct gl_renderbuffer_attachment *att)
 557 {
 558    assert(format == GL_COLOR || format == GL_DEPTH || format == GL_STENCIL);
 559
 560    /* assume complete */
 561    att->Complete = GL_TRUE;
 562
 563    /* Look for reasons why the attachment might be incomplete */
 564    if (att->Type == GL_TEXTURE) {
 565       const struct gl_texture_object *texObj = att->Texture;
 566       struct gl_texture_image *texImage;
 567       GLenum baseFormat;
 568
 569       if (!texObj) {
 570          att_incomplete("no texobj");
 571          att->Complete = GL_FALSE;
 572          return;
 573       }
 574
 575       texImage = texObj->Image[att->CubeMapFace][att->TextureLevel];
 576       if (!texImage) {
 577          att_incomplete("no teximage");
 578          att->Complete = GL_FALSE;
 579          return;
 580       }
 581       if (texImage->Width < 1 || texImage->Height < 1) {
 582          att_incomplete("teximage width/height=0");
 583          printf("texobj = %u\n", texObj->Name);
 584          printf("level = %d\n", att->TextureLevel);
 585          att->Complete = GL_FALSE;
 586          return;
 587       }
 588       if (texObj->Target == GL_TEXTURE_3D && att->Zoffset >= texImage->Depth) {
 589          att_incomplete("bad z offset");
 590          att->Complete = GL_FALSE;
 591          return;
 592       }
 593
 594       baseFormat = _mesa_get_format_base_format(texImage->TexFormat);
 595
 596       if (format == GL_COLOR) {
 597          if (!_mesa_is_legal_color_format(ctx, baseFormat)) {
 598             att_incomplete("bad format");
 599             att->Complete = GL_FALSE;
 600             return;
 601          }
 602          if (_mesa_is_format_compressed(texImage->TexFormat)) {
 603             att_incomplete("compressed internalformat");
 604             att->Complete = GL_FALSE;
 605             return;
 606          }
 607       }
 608       else if (format == GL_DEPTH) {
 609          if (baseFormat == GL_DEPTH_COMPONENT) {
 610             /* OK */
 611          }
 612          else if (ctx->Extensions.EXT_packed_depth_stencil &&
 613                   ctx->Extensions.ARB_depth_texture &&
 614                   baseFormat == GL_DEPTH_STENCIL_EXT) {
 615             /* OK */
 616          }
 617          else {
 618             att->Complete = GL_FALSE;
 619             att_incomplete("bad depth format");
 620             return;
 621          }
 622       }
 623       else {
 624          ASSERT(format == GL_STENCIL);
 625          if (ctx->Extensions.EXT_packed_depth_stencil &&
 626              ctx->Extensions.ARB_depth_texture &&
 627              baseFormat == GL_DEPTH_STENCIL_EXT) {
 628             /* OK */
 629          }
 630          else {
 631             /* no such thing as stencil-only textures */
 632             att_incomplete("illegal stencil texture");
 633             att->Complete = GL_FALSE;
 634             return;
 635          }
 636       }
 637    }
 638    else if (att->Type == GL_RENDERBUFFER_EXT) {
 639       const GLenum baseFormat =
 640          _mesa_get_format_base_format(att->Renderbuffer->Format);
 641
 642       ASSERT(att->Renderbuffer);
 643       if (!att->Renderbuffer->InternalFormat ||
 644           att->Renderbuffer->Width < 1 ||
 645           att->Renderbuffer->Height < 1) {
 646          att_incomplete("0x0 renderbuffer");
 647          att->Complete = GL_FALSE;
 648          return;
 649       }
 650       if (format == GL_COLOR) {
 651          if (!_mesa_is_legal_color_format(ctx, baseFormat)) {
 652             att_incomplete("bad renderbuffer color format");
 653             att->Complete = GL_FALSE;
 654             return;
 655          }
 656       }
 657       else if (format == GL_DEPTH) {
 658          if (baseFormat == GL_DEPTH_COMPONENT) {
 659             /* OK */
 660          }
 661          else if (ctx->Extensions.EXT_packed_depth_stencil &&
 662                   baseFormat == GL_DEPTH_STENCIL_EXT) {
 663             /* OK */
 664          }
 665          else {
 666             att_incomplete("bad renderbuffer depth format");
 667             att->Complete = GL_FALSE;
 668             return;
 669          }
 670       }
 671       else {
 672          assert(format == GL_STENCIL);
 673          if (baseFormat == GL_STENCIL_INDEX) {
 674             /* OK */
 675          }
 676          else if (ctx->Extensions.EXT_packed_depth_stencil &&
 677                   baseFormat == GL_DEPTH_STENCIL_EXT) {
 678             /* OK */
 679          }
 680          else {
 681             att->Complete = GL_FALSE;
 682             att_incomplete("bad renderbuffer stencil format");
 683             return;
 684          }
 685       }
 686    }
 687    else {
 688       ASSERT(att->Type == GL_NONE);
 689       /* complete */
 690       return;
 691    }
 692 }
 693
 694
 695 /**
 696  * Test if the given framebuffer object is complete and update its
 697  * Status field with the results.
 698  * Calls the ctx->Driver.ValidateFramebuffer() function to allow the
 699  * driver to make hardware-specific validation/completeness checks.
 700  * Also update the framebuffer's Width and Height fields if the
 701  * framebuffer is complete.
 702  */
 703 void
 704 _mesa_test_framebuffer_completeness(struct gl_context *ctx,
 705                                     struct gl_framebuffer *fb)
 706 {
 707    GLuint numImages;
 708    GLenum intFormat = GL_NONE; /* color buffers' internal format */
 709    GLuint minWidth = ~0, minHeight = ~0, maxWidth = 0, maxHeight = 0;
 710    GLint numSamples = -1;
 711    GLint i;
 712    GLuint j;
 713
 714    assert(is_user_fbo(fb));
 715
 716    numImages = 0;
 717    fb->Width = 0;
 718    fb->Height = 0;
 719
 720    /* Start at -2 to more easily loop over all attachment points.
 721     *  -2: depth buffer
 722     *  -1: stencil buffer
 723     * >=0: color buffer
 724     */
 725    for (i = -2; i < (GLint) ctx->Const.MaxColorAttachments; i++) {
 726       struct gl_renderbuffer_attachment *att;
 727       GLenum f;
 728       gl_format attFormat;
 729
 730       /*
 731        * XXX for ARB_fbo, only check color buffers that are named by
 732        * GL_READ_BUFFER and GL_DRAW_BUFFERi.
 733        */
 734
 735       /* check for attachment completeness
 736        */
 737       if (i == -2) {
 738          att = &fb->Attachment[BUFFER_DEPTH];
 739          test_attachment_completeness(ctx, GL_DEPTH, att);
 740          if (!att->Complete) {
 741             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
 742             fbo_incomplete("depth attachment incomplete", -1);
 743             return;
 744          }
 745       }
 746       else if (i == -1) {
 747          att = &fb->Attachment[BUFFER_STENCIL];
 748          test_attachment_completeness(ctx, GL_STENCIL, att);
 749          if (!att->Complete) {
 750             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
 751             fbo_incomplete("stencil attachment incomplete", -1);
 752             return;
 753          }
 754       }
 755       else {
 756          att = &fb->Attachment[BUFFER_COLOR0 + i];
 757          test_attachment_completeness(ctx, GL_COLOR, att);
 758          if (!att->Complete) {
 759             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
 760             fbo_incomplete("color attachment incomplete", i);
 761             return;
 762          }
 763       }
 764
 765       /* get width, height, format of the renderbuffer/texture
 766        */
 767       if (att->Type == GL_TEXTURE) {
 768          const struct gl_texture_image *texImg =
 769             _mesa_get_attachment_teximage(att);
 770          minWidth = MIN2(minWidth, texImg->Width);
 771          maxWidth = MAX2(maxWidth, texImg->Width);
 772          minHeight = MIN2(minHeight, texImg->Height);
 773          maxHeight = MAX2(maxHeight, texImg->Height);
 774          f = texImg->_BaseFormat;
 775          attFormat = texImg->TexFormat;
 776          numImages++;
 777          if (!_mesa_is_legal_color_format(ctx, f) &&
 778              !is_legal_depth_format(ctx, f)) {
 779             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
 780             fbo_incomplete("texture attachment incomplete", -1);
 781             return;
 782          }
 783       }
 784       else if (att->Type == GL_RENDERBUFFER_EXT) {
 785          minWidth = MIN2(minWidth, att->Renderbuffer->Width);
 786          maxWidth = MAX2(minWidth, att->Renderbuffer->Width);
 787          minHeight = MIN2(minHeight, att->Renderbuffer->Height);
 788          maxHeight = MAX2(minHeight, att->Renderbuffer->Height);
 789          f = att->Renderbuffer->InternalFormat;
 790          attFormat = att->Renderbuffer->Format;
 791          numImages++;
 792       }
 793       else {
 794          assert(att->Type == GL_NONE);
 795          continue;
 796       }
 797
 798       if (att->Renderbuffer && numSamples < 0) {
 799          /* first buffer */
 800          numSamples = att->Renderbuffer->NumSamples;
 801       }
 802
 803       /* check if integer color */
 804       fb->_IntegerColor = _mesa_is_format_integer_color(attFormat);
 805
 806       /* Error-check width, height, format, samples
 807        */
 808       if (numImages == 1) {
 809          /* save format, num samples */
 810          if (i >= 0) {
 811             intFormat = f;
 812          }
 813       }
 814       else {
 815          if (!ctx->Extensions.ARB_framebuffer_object) {
 816             /* check that width, height, format are same */
 817             if (minWidth != maxWidth || minHeight != maxHeight) {
 818                fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT;
 819                fbo_incomplete("width or height mismatch", -1);
 820                return;
 821             }
 822             /* check that all color buffer have same format */
 823             if (intFormat != GL_NONE && f != intFormat) {
 824                fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
 825                fbo_incomplete("format mismatch", -1);
 826                return;
 827             }
 828          }
 829          if (att->Renderbuffer &&
 830              att->Renderbuffer->NumSamples != numSamples) {
 831             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
 832             fbo_incomplete("inconsistant number of samples", i);
 833             return;
 834          }
 835
 836       }
 837    }
 838
 839 #if FEATURE_GL
 840    if (ctx->API == API_OPENGL && !ctx->Extensions.ARB_ES2_compatibility) {
 841       /* Check that all DrawBuffers are present */
 842       for (j = 0; j < ctx->Const.MaxDrawBuffers; j++) {
 843          if (fb->ColorDrawBuffer[j] != GL_NONE) {
 844             const struct gl_renderbuffer_attachment *att
 845                = _mesa_get_attachment(ctx, fb, fb->ColorDrawBuffer[j]);
 846             assert(att);
 847             if (att->Type == GL_NONE) {
 848                fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_EXT;
 849                fbo_incomplete("missing drawbuffer", j);
 850                return;
 851             }
 852          }
 853       }
 854
 855       /* Check that the ReadBuffer is present */
 856       if (fb->ColorReadBuffer != GL_NONE) {
 857          const struct gl_renderbuffer_attachment *att
 858             = _mesa_get_attachment(ctx, fb, fb->ColorReadBuffer);
 859          assert(att);
 860          if (att->Type == GL_NONE) {
 861             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT;
 862             fbo_incomplete("missing readbuffer", -1);
 863             return;
 864          }
 865       }
 866    }
 867 #else
 868    (void) j;
 869 #endif
 870
 871    if (numImages == 0) {
 872       fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT;
 873       fbo_incomplete("no attachments", -1);
 874       return;
 875    }
 876
 877    /* Provisionally set status = COMPLETE ... */
 878    fb->_Status = GL_FRAMEBUFFER_COMPLETE_EXT;
 879
 880    /* ... but the driver may say the FB is incomplete.
 881     * Drivers will most likely set the status to GL_FRAMEBUFFER_UNSUPPORTED
 882     * if anything.
 883     */
 884    if (ctx->Driver.ValidateFramebuffer) {
 885       ctx->Driver.ValidateFramebuffer(ctx, fb);
 886       if (fb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
 887          fbo_incomplete("driver marked FBO as incomplete", -1);
 888       }
 889    }
 890
 891    if (fb->_Status == GL_FRAMEBUFFER_COMPLETE_EXT) {
 892       /*
 893        * Note that if ARB_framebuffer_object is supported and the attached
 894        * renderbuffers/textures are different sizes, the framebuffer
 895        * width/height will be set to the smallest width/height.
 896        */
 897       fb->Width = minWidth;
 898       fb->Height = minHeight;
 899
 900       /* finally, update the visual info for the framebuffer */
 901       _mesa_update_framebuffer_visual(ctx, fb);
 902    }
 903 }
 904
 905
 906 GLboolean GLAPIENTRY
 907 _mesa_IsRenderbufferEXT(GLuint renderbuffer)
 908 {
 909    GET_CURRENT_CONTEXT(ctx);
 910    ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
 911    if (renderbuffer) {
 912       struct gl_renderbuffer *rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
 913       if (rb != NULL && rb != &DummyRenderbuffer)
 914          return GL_TRUE;
 915    }
 916    return GL_FALSE;
 917 }
 918
 919
 920 void GLAPIENTRY
 921 _mesa_BindRenderbufferEXT(GLenum target, GLuint renderbuffer)
 922 {
 923    struct gl_renderbuffer *newRb;
 924    GET_CURRENT_CONTEXT(ctx);
 925
 926    ASSERT_OUTSIDE_BEGIN_END(ctx);
 927
 928    if (target != GL_RENDERBUFFER_EXT) {
 929       _mesa_error(ctx, GL_INVALID_ENUM, "glBindRenderbufferEXT(target)");
 930       return;
 931    }
 932
 933    /* No need to flush here since the render buffer binding has no
 934     * effect on rendering state.
 935     */
 936
 937    if (renderbuffer) {
 938       newRb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
 939       if (newRb == &DummyRenderbuffer) {
 940          /* ID was reserved, but no real renderbuffer object made yet */
 941          newRb = NULL;
 942       }
 943       else if (!newRb && ctx->Extensions.ARB_framebuffer_object) {
 944          /* All RB IDs must be Gen'd */
 945          _mesa_error(ctx, GL_INVALID_OPERATION, "glBindRenderbuffer(buffer)");
 946          return;
 947       }
 948
 949       if (!newRb) {
 950          /* create new renderbuffer object */
 951          newRb = ctx->Driver.NewRenderbuffer(ctx, renderbuffer);
 952          if (!newRb) {
 953             _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindRenderbufferEXT");
 954             return;
 955          }
 956          ASSERT(newRb->AllocStorage);
 957          _mesa_HashInsert(ctx->Shared->RenderBuffers, renderbuffer, newRb);
 958          newRb->RefCount = 1; /* referenced by hash table */
 959       }
 960    }
 961    else {
 962       newRb = NULL;
 963    }
 964
 965    ASSERT(newRb != &DummyRenderbuffer);
 966
 967    _mesa_reference_renderbuffer(&ctx->CurrentRenderbuffer, newRb);
 968 }
 969
 970
 971 /**
 972  * If the given renderbuffer is anywhere attached to the framebuffer, detach
 973  * the renderbuffer.
 974  * This is used when a renderbuffer object is deleted.
 975  * The spec calls for unbinding.
 976  */
 977 static void
 978 detach_renderbuffer(struct gl_context *ctx,
 979                     struct gl_framebuffer *fb,
 980                     struct gl_renderbuffer *rb)
 981 {
 982    GLuint i;
 983    for (i = 0; i < BUFFER_COUNT; i++) {
 984       if (fb->Attachment[i].Renderbuffer == rb) {
 985          _mesa_remove_attachment(ctx, &fb->Attachment[i]);
 986       }
 987    }
 988    invalidate_framebuffer(fb);
 989 }
 990
 991
 992 void GLAPIENTRY
 993 _mesa_DeleteRenderbuffersEXT(GLsizei n, const GLuint *renderbuffers)
 994 {
 995    GLint i;
 996    GET_CURRENT_CONTEXT(ctx);
 997
 998    ASSERT_OUTSIDE_BEGIN_END(ctx);
 999    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1000
1001    for (i = 0; i < n; i++) {
1002       if (renderbuffers[i] > 0) {
1003          struct gl_renderbuffer *rb;
1004          rb = _mesa_lookup_renderbuffer(ctx, renderbuffers[i]);
1005          if (rb) {
1006             /* check if deleting currently bound renderbuffer object */
1007             if (rb == ctx->CurrentRenderbuffer) {
1008                /* bind default */
1009                ASSERT(rb->RefCount >= 2);
1010                _mesa_BindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0);
1011             }
1012
1013             if (is_user_fbo(ctx->DrawBuffer)) {
1014                detach_renderbuffer(ctx, ctx->DrawBuffer, rb);
1015             }
1016             if (is_user_fbo(ctx->ReadBuffer)
1017                 && ctx->ReadBuffer != ctx->DrawBuffer) {
1018                detach_renderbuffer(ctx, ctx->ReadBuffer, rb);
1019             }
1020
1021             /* Remove from hash table immediately, to free the ID.
1022              * But the object will not be freed until it's no longer
1023              * referenced anywhere else.
1024              */
1025             _mesa_HashRemove(ctx->Shared->RenderBuffers, renderbuffers[i]);
1026
1027             if (rb != &DummyRenderbuffer) {
1028                /* no longer referenced by hash table */
1029                _mesa_reference_renderbuffer(&rb, NULL);
1030             }
1031          }
1032       }
1033    }
1034 }
1035
1036
1037 void GLAPIENTRY
1038 _mesa_GenRenderbuffersEXT(GLsizei n, GLuint *renderbuffers)
1039 {
1040    GET_CURRENT_CONTEXT(ctx);
1041    GLuint first;
1042    GLint i;
1043
1044    ASSERT_OUTSIDE_BEGIN_END(ctx);
1045
1046    if (n < 0) {
1047       _mesa_error(ctx, GL_INVALID_VALUE, "glGenRenderbuffersEXT(n)");
1048       return;
1049    }
1050
1051    if (!renderbuffers)
1052       return;
1053
1054    first = _mesa_HashFindFreeKeyBlock(ctx->Shared->RenderBuffers, n);
1055
1056    for (i = 0; i < n; i++) {
1057       GLuint name = first + i;
1058       renderbuffers[i] = name;
1059       /* insert dummy placeholder into hash table */
1060       _glthread_LOCK_MUTEX(ctx->Shared->Mutex);
1061       _mesa_HashInsert(ctx->Shared->RenderBuffers, name, &DummyRenderbuffer);
1062       _glthread_UNLOCK_MUTEX(ctx->Shared->Mutex);
1063    }
1064 }
1065
1066
1067 /**
1068  * Given an internal format token for a render buffer, return the
1069  * corresponding base format (one of GL_RGB, GL_RGBA, GL_STENCIL_INDEX,
1070  * GL_DEPTH_COMPONENT, GL_DEPTH_STENCIL_EXT, GL_ALPHA, GL_LUMINANCE,
1071  * GL_LUMINANCE_ALPHA, GL_INTENSITY, etc).
1072  *
1073  * This is similar to _mesa_base_tex_format() but the set of valid
1074  * internal formats is different.
1075  *
1076  * Note that even if a format is determined to be legal here, validation
1077  * of the FBO may fail if the format is not supported by the driver/GPU.
1078  *
1079  * \param internalFormat  as passed to glRenderbufferStorage()
1080  * \return the base internal format, or 0 if internalFormat is illegal
1081  */
1082 GLenum
1083 _mesa_base_fbo_format(struct gl_context *ctx, GLenum internalFormat)
1084 {
1085    /*
1086     * Notes: some formats such as alpha, luminance, etc. were added
1087     * with GL_ARB_framebuffer_object.
1088     */
1089    switch (internalFormat) {
1090    case GL_ALPHA:
1091    case GL_ALPHA4:
1092    case GL_ALPHA8:
1093    case GL_ALPHA12:
1094    case GL_ALPHA16:
1095       return ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
1096    case GL_LUMINANCE:
1097    case GL_LUMINANCE4:
1098    case GL_LUMINANCE8:
1099    case GL_LUMINANCE12:
1100    case GL_LUMINANCE16:
1101       return ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
1102    case GL_LUMINANCE_ALPHA:
1103    case GL_LUMINANCE4_ALPHA4:
1104    case GL_LUMINANCE6_ALPHA2:
1105    case GL_LUMINANCE8_ALPHA8:
1106    case GL_LUMINANCE12_ALPHA4:
1107    case GL_LUMINANCE12_ALPHA12:
1108    case GL_LUMINANCE16_ALPHA16:
1109       return ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
1110    case GL_INTENSITY:
1111    case GL_INTENSITY4:
1112    case GL_INTENSITY8:
1113    case GL_INTENSITY12:
1114    case GL_INTENSITY16:
1115       return ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
1116    case GL_RGB:
1117    case GL_R3_G3_B2:
1118    case GL_RGB4:
1119    case GL_RGB5:
1120    case GL_RGB8:
1121    case GL_RGB10:
1122    case GL_RGB12:
1123    case GL_RGB16:
1124    case GL_SRGB8_EXT:
1125       return GL_RGB;
1126    case GL_RGBA:
1127    case GL_RGBA2:
1128    case GL_RGBA4:
1129    case GL_RGB5_A1:
1130    case GL_RGBA8:
1131    case GL_RGB10_A2:
1132    case GL_RGBA12:
1133    case GL_RGBA16:
1134    case GL_SRGB8_ALPHA8_EXT:
1135       return GL_RGBA;
1136    case GL_STENCIL_INDEX:
1137    case GL_STENCIL_INDEX1_EXT:
1138    case GL_STENCIL_INDEX4_EXT:
1139    case GL_STENCIL_INDEX8_EXT:
1140    case GL_STENCIL_INDEX16_EXT:
1141       return GL_STENCIL_INDEX;
1142    case GL_DEPTH_COMPONENT:
1143    case GL_DEPTH_COMPONENT16:
1144    case GL_DEPTH_COMPONENT24:
1145    case GL_DEPTH_COMPONENT32:
1146       return GL_DEPTH_COMPONENT;
1147    case GL_DEPTH_STENCIL_EXT:
1148    case GL_DEPTH24_STENCIL8_EXT:
1149       if (ctx->Extensions.EXT_packed_depth_stencil)
1150          return GL_DEPTH_STENCIL_EXT;
1151       else
1152          return 0;
1153    case GL_DEPTH_COMPONENT32F:
1154       if (ctx->Extensions.ARB_depth_buffer_float)
1155          return GL_DEPTH_COMPONENT;
1156       else
1157          return 0;
1158    case GL_DEPTH32F_STENCIL8:
1159       if (ctx->Extensions.ARB_depth_buffer_float)
1160          return GL_DEPTH_STENCIL;
1161       else
1162          return 0;
1163    case GL_RED:
1164    case GL_R8:
1165    case GL_R16:
1166       return ctx->Extensions.ARB_texture_rg ? GL_RED : 0;
1167    case GL_RG:
1168    case GL_RG8:
1169    case GL_RG16:
1170       return ctx->Extensions.ARB_texture_rg ? GL_RG : 0;
1171    /* signed normalized texture formats */
1172    case GL_RED_SNORM:
1173    case GL_R8_SNORM:
1174    case GL_R16_SNORM:
1175       return ctx->Extensions.EXT_texture_snorm ? GL_RED : 0;
1176    case GL_RG_SNORM:
1177    case GL_RG8_SNORM:
1178    case GL_RG16_SNORM:
1179       return ctx->Extensions.EXT_texture_snorm ? GL_RG : 0;
1180    case GL_RGB_SNORM:
1181    case GL_RGB8_SNORM:
1182    case GL_RGB16_SNORM:
1183       return ctx->Extensions.EXT_texture_snorm ? GL_RGB : 0;
1184    case GL_RGBA_SNORM:
1185    case GL_RGBA8_SNORM:
1186    case GL_RGBA16_SNORM:
1187       return ctx->Extensions.EXT_texture_snorm ? GL_RGBA : 0;
1188    case GL_ALPHA_SNORM:
1189    case GL_ALPHA8_SNORM:
1190    case GL_ALPHA16_SNORM:
1191       return ctx->Extensions.EXT_texture_snorm &&
1192              ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
1193    case GL_LUMINANCE_SNORM:
1194    case GL_LUMINANCE8_SNORM:
1195    case GL_LUMINANCE16_SNORM:
1196       return ctx->Extensions.EXT_texture_snorm &&
1197              ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
1198    case GL_LUMINANCE_ALPHA_SNORM:
1199    case GL_LUMINANCE8_ALPHA8_SNORM:
1200    case GL_LUMINANCE16_ALPHA16_SNORM:
1201       return ctx->Extensions.EXT_texture_snorm &&
1202              ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
1203    case GL_INTENSITY_SNORM:
1204    case GL_INTENSITY8_SNORM:
1205    case GL_INTENSITY16_SNORM:
1206       return ctx->Extensions.EXT_texture_snorm &&
1207              ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
1208    case GL_R16F:
1209    case GL_R32F:
1210       return ctx->Extensions.ARB_texture_rg &&
1211              ctx->Extensions.ARB_texture_float ? GL_RED : 0;
1212    case GL_RG16F:
1213    case GL_RG32F:
1214       return ctx->Extensions.ARB_texture_rg &&
1215              ctx->Extensions.ARB_texture_float ? GL_RG : 0;
1216    case GL_RGB16F:
1217    case GL_RGB32F:
1218       return ctx->Extensions.ARB_texture_float ? GL_RGB : 0;
1219    case GL_RGBA16F:
1220    case GL_RGBA32F:
1221       return ctx->Extensions.ARB_texture_float ? GL_RGBA : 0;
1222    case GL_ALPHA16F_ARB:
1223    case GL_ALPHA32F_ARB:
1224       return ctx->Extensions.ARB_texture_float &&
1225              ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
1226    case GL_LUMINANCE16F_ARB:
1227    case GL_LUMINANCE32F_ARB:
1228       return ctx->Extensions.ARB_texture_float &&
1229              ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
1230    case GL_LUMINANCE_ALPHA16F_ARB:
1231    case GL_LUMINANCE_ALPHA32F_ARB:
1232       return ctx->Extensions.ARB_texture_float &&
1233              ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
1234    case GL_INTENSITY16F_ARB:
1235    case GL_INTENSITY32F_ARB:
1236       return ctx->Extensions.ARB_texture_float &&
1237              ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
1238    case GL_RGB9_E5:
1239       return ctx->Extensions.EXT_texture_shared_exponent ? GL_RGB : 0;
1240    case GL_R11F_G11F_B10F:
1241       return ctx->Extensions.EXT_packed_float ? GL_RGB : 0;
1242
1243    case GL_RGBA8UI_EXT:
1244    case GL_RGBA16UI_EXT:
1245    case GL_RGBA32UI_EXT:
1246    case GL_RGBA8I_EXT:
1247    case GL_RGBA16I_EXT:
1248    case GL_RGBA32I_EXT:
1249       return ctx->Extensions.EXT_texture_integer ? GL_RGBA : 0;
1250
1251    case GL_RGB8UI_EXT:
1252    case GL_RGB16UI_EXT:
1253    case GL_RGB32UI_EXT:
1254    case GL_RGB8I_EXT:
1255    case GL_RGB16I_EXT:
1256    case GL_RGB32I_EXT:
1257       return ctx->Extensions.EXT_texture_integer ? GL_RGB : 0;
1258
1259    case GL_R8UI:
1260    case GL_R8I:
1261    case GL_R16UI:
1262    case GL_R16I:
1263    case GL_R32UI:
1264    case GL_R32I:
1265       return ctx->Extensions.ARB_texture_rg &&
1266              ctx->Extensions.EXT_texture_integer ? GL_RED : 0;
1267
1268    case GL_RG8UI:
1269    case GL_RG8I:
1270    case GL_RG16UI:
1271    case GL_RG16I:
1272    case GL_RG32UI:
1273    case GL_RG32I:
1274       return ctx->Extensions.ARB_texture_rg &&
1275              ctx->Extensions.EXT_texture_integer ? GL_RG : 0;
1276
1277    case GL_INTENSITY8I_EXT:
1278    case GL_INTENSITY8UI_EXT:
1279    case GL_INTENSITY16I_EXT:
1280    case GL_INTENSITY16UI_EXT:
1281    case GL_INTENSITY32I_EXT:
1282    case GL_INTENSITY32UI_EXT:
1283       return ctx->Extensions.EXT_texture_integer &&
1284              ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
1285
1286    case GL_LUMINANCE8I_EXT:
1287    case GL_LUMINANCE8UI_EXT:
1288    case GL_LUMINANCE16I_EXT:
1289    case GL_LUMINANCE16UI_EXT:
1290    case GL_LUMINANCE32I_EXT:
1291    case GL_LUMINANCE32UI_EXT:
1292       return ctx->Extensions.EXT_texture_integer &&
1293              ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
1294
1295    case GL_LUMINANCE_ALPHA8I_EXT:
1296    case GL_LUMINANCE_ALPHA8UI_EXT:
1297    case GL_LUMINANCE_ALPHA16I_EXT:
1298    case GL_LUMINANCE_ALPHA16UI_EXT:
1299    case GL_LUMINANCE_ALPHA32I_EXT:
1300    case GL_LUMINANCE_ALPHA32UI_EXT:
1301       return ctx->Extensions.EXT_texture_integer &&
1302              ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
1303
1304    case GL_RGB10_A2UI:
1305       return ctx->Extensions.ARB_texture_rgb10_a2ui ? GL_RGBA : 0;
1306    default:
1307       return 0;
1308    }
1309 }
1310
1311
1312 /**
1313  * Invalidate a renderbuffer attachment.  Called from _mesa_HashWalk().
1314  */
1315 static void
1316 invalidate_rb(GLuint key, void *data, void *userData)
1317 {
1318    struct gl_framebuffer *fb = (struct gl_framebuffer *) data;
1319    struct gl_renderbuffer *rb = (struct gl_renderbuffer *) userData;
1320
1321    /* If this is a user-created FBO */
1322    if (is_user_fbo(fb)) {
1323       GLuint i;
1324       for (i = 0; i < BUFFER_COUNT; i++) {
1325          struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1326          if (att->Type == GL_RENDERBUFFER &&
1327              att->Renderbuffer == rb) {
1328             /* Mark fb status as indeterminate to force re-validation */
1329             fb->_Status = 0;
1330             return;
1331          }
1332       }
1333    }
1334 }
1335
1336
1337 /** sentinal value, see below */
1338 #define NO_SAMPLES 1000
1339
1340
1341 /**
1342  * Helper function used by _mesa_RenderbufferStorageEXT() and
1343  * _mesa_RenderbufferStorageMultisample().
1344  * samples will be NO_SAMPLES if called by _mesa_RenderbufferStorageEXT().
1345  */
1346 static void
1347 renderbuffer_storage(GLenum target, GLenum internalFormat,
1348                      GLsizei width, GLsizei height, GLsizei samples)
1349 {
1350    const char *func = samples == NO_SAMPLES ?
1351       "glRenderbufferStorage" : "RenderbufferStorageMultisample";
1352    struct gl_renderbuffer *rb;
1353    GLenum baseFormat;
1354    GET_CURRENT_CONTEXT(ctx);
1355
1356    ASSERT_OUTSIDE_BEGIN_END(ctx);
1357
1358    if (target != GL_RENDERBUFFER_EXT) {
1359       _mesa_error(ctx, GL_INVALID_ENUM, "%s(target)", func);
1360       return;
1361    }
1362
1363    baseFormat = _mesa_base_fbo_format(ctx, internalFormat);
1364    if (baseFormat == 0) {
1365       _mesa_error(ctx, GL_INVALID_ENUM, "%s(internalFormat)", func);
1366       return;
1367    }
1368
1369    if (width < 0 || width > (GLsizei) ctx->Const.MaxRenderbufferSize) {
1370       _mesa_error(ctx, GL_INVALID_VALUE, "%s(width)", func);
1371       return;
1372    }
1373
1374    if (height < 0 || height > (GLsizei) ctx->Const.MaxRenderbufferSize) {
1375       _mesa_error(ctx, GL_INVALID_VALUE, "%s(height)", func);
1376       return;
1377    }
1378
1379    if (samples == NO_SAMPLES) {
1380       /* NumSamples == 0 indicates non-multisampling */
1381       samples = 0;
1382    }
1383    else if (samples > (GLsizei) ctx->Const.MaxSamples) {
1384       /* note: driver may choose to use more samples than what's requested */
1385       _mesa_error(ctx, GL_INVALID_VALUE, "%s(samples)", func);
1386       return;
1387    }
1388
1389    rb = ctx->CurrentRenderbuffer;
1390    if (!rb) {
1391       _mesa_error(ctx, GL_INVALID_OPERATION, "%s", func);
1392       return;
1393    }
1394
1395    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1396
1397    if (rb->InternalFormat == internalFormat &&
1398        rb->Width == (GLuint) width &&
1399        rb->Height == (GLuint) height) {
1400       /* no change in allocation needed */
1401       return;
1402    }
1403
1404    /* These MUST get set by the AllocStorage func */
1405    rb->Format = MESA_FORMAT_NONE;
1406    rb->NumSamples = samples;
1407
1408    /* Now allocate the storage */
1409    ASSERT(rb->AllocStorage);
1410    if (rb->AllocStorage(ctx, rb, internalFormat, width, height)) {
1411       /* No error - check/set fields now */
1412       assert(rb->Format != MESA_FORMAT_NONE);
1413       assert(rb->Width == (GLuint) width);
1414       assert(rb->Height == (GLuint) height);
1415       rb->InternalFormat = internalFormat;
1416       rb->_BaseFormat = baseFormat;
1417       assert(rb->_BaseFormat != 0);
1418    }
1419    else {
1420       /* Probably ran out of memory - clear the fields */
1421       rb->Width = 0;
1422       rb->Height = 0;
1423       rb->Format = MESA_FORMAT_NONE;
1424       rb->InternalFormat = GL_NONE;
1425       rb->_BaseFormat = GL_NONE;
1426       rb->NumSamples = 0;
1427    }
1428
1429    /* Invalidate the framebuffers the renderbuffer is attached in. */
1430    if (rb->AttachedAnytime) {
1431       _mesa_HashWalk(ctx->Shared->FrameBuffers, invalidate_rb, rb);
1432    }
1433 }
1434
1435
1436 #if FEATURE_OES_EGL_image
1437 void GLAPIENTRY
1438 _mesa_EGLImageTargetRenderbufferStorageOES(GLenum target, GLeglImageOES image)
1439 {
1440    struct gl_renderbuffer *rb;
1441    GET_CURRENT_CONTEXT(ctx);
1442    ASSERT_OUTSIDE_BEGIN_END(ctx);
1443
1444    if (!ctx->Extensions.OES_EGL_image) {
1445       _mesa_error(ctx, GL_INVALID_OPERATION,
1446                   "glEGLImageTargetRenderbufferStorageOES(unsupported)");
1447       return;
1448    }
1449
1450    if (target != GL_RENDERBUFFER) {
1451       _mesa_error(ctx, GL_INVALID_ENUM,
1452                   "EGLImageTargetRenderbufferStorageOES");
1453       return;
1454    }
1455
1456    rb = ctx->CurrentRenderbuffer;
1457    if (!rb) {
1458       _mesa_error(ctx, GL_INVALID_OPERATION,
1459                   "EGLImageTargetRenderbufferStorageOES");
1460       return;
1461    }
1462
1463    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1464
1465    ctx->Driver.EGLImageTargetRenderbufferStorage(ctx, rb, image);
1466 }
1467 #endif
1468
1469
1470 /**
1471  * Helper function for _mesa_GetRenderbufferParameterivEXT() and
1472  * _mesa_GetFramebufferAttachmentParameterivEXT()
1473  * We have to be careful to respect the base format.  For example, if a
1474  * renderbuffer/texture was created with internalFormat=GL_RGB but the
1475  * driver actually chose a GL_RGBA format, when the user queries ALPHA_SIZE
1476  * we need to return zero.
1477  */
1478 static GLint
1479 get_component_bits(GLenum pname, GLenum baseFormat, gl_format format)
1480 {
1481    if (_mesa_base_format_has_channel(baseFormat, pname))
1482       return _mesa_get_format_bits(format, pname);
1483    else
1484       return 0;
1485 }
1486
1487
1488
1489 void GLAPIENTRY
1490 _mesa_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
1491                              GLsizei width, GLsizei height)
1492 {
1493    /* GL_ARB_fbo says calling this function is equivalent to calling
1494     * glRenderbufferStorageMultisample() with samples=0.  We pass in
1495     * a token value here just for error reporting purposes.
1496     */
1497    renderbuffer_storage(target, internalFormat, width, height, NO_SAMPLES);
1498 }
1499
1500
1501 void GLAPIENTRY
1502 _mesa_RenderbufferStorageMultisample(GLenum target, GLsizei samples,
1503                                      GLenum internalFormat,
1504                                      GLsizei width, GLsizei height)
1505 {
1506    renderbuffer_storage(target, internalFormat, width, height, samples);
1507 }
1508
1509
1510 /**
1511  * OpenGL ES version of glRenderBufferStorage.
1512  */
1513 void GLAPIENTRY
1514 _es_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
1515                            GLsizei width, GLsizei height)
1516 {
1517    switch (internalFormat) {
1518    case GL_RGB565:
1519       /* XXX this confuses GL_RENDERBUFFER_INTERNAL_FORMAT_OES */
1520       /* choose a closest format */
1521       internalFormat = GL_RGB5;
1522       break;
1523    default:
1524       break;
1525    }
1526
1527    renderbuffer_storage(target, internalFormat, width, height, 0);
1528 }
1529
1530
1531 void GLAPIENTRY
1532 _mesa_GetRenderbufferParameterivEXT(GLenum target, GLenum pname, GLint *params)
1533 {
1534    struct gl_renderbuffer *rb;
1535    GET_CURRENT_CONTEXT(ctx);
1536
1537    ASSERT_OUTSIDE_BEGIN_END(ctx);
1538
1539    if (target != GL_RENDERBUFFER_EXT) {
1540       _mesa_error(ctx, GL_INVALID_ENUM,
1541                   "glGetRenderbufferParameterivEXT(target)");
1542       return;
1543    }
1544
1545    rb = ctx->CurrentRenderbuffer;
1546    if (!rb) {
1547       _mesa_error(ctx, GL_INVALID_OPERATION,
1548                   "glGetRenderbufferParameterivEXT");
1549       return;
1550    }
1551
1552    /* No need to flush here since we're just quering state which is
1553     * not effected by rendering.
1554     */
1555
1556    switch (pname) {
1557    case GL_RENDERBUFFER_WIDTH_EXT:
1558       *params = rb->Width;
1559       return;
1560    case GL_RENDERBUFFER_HEIGHT_EXT:
1561       *params = rb->Height;
1562       return;
1563    case GL_RENDERBUFFER_INTERNAL_FORMAT_EXT:
1564       *params = rb->InternalFormat;
1565       return;
1566    case GL_RENDERBUFFER_RED_SIZE_EXT:
1567    case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1568    case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1569    case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1570    case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1571    case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1572       *params = get_component_bits(pname, rb->_BaseFormat, rb->Format);
1573       break;
1574    case GL_RENDERBUFFER_SAMPLES:
1575       if (ctx->Extensions.ARB_framebuffer_object) {
1576          *params = rb->NumSamples;
1577          break;
1578       }
1579       /* fallthrough */
1580    default:
1581       _mesa_error(ctx, GL_INVALID_ENUM,
1582                   "glGetRenderbufferParameterivEXT(target)");
1583       return;
1584    }
1585 }
1586
1587
1588 GLboolean GLAPIENTRY
1589 _mesa_IsFramebufferEXT(GLuint framebuffer)
1590 {
1591    GET_CURRENT_CONTEXT(ctx);
1592    ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
1593    if (framebuffer) {
1594       struct gl_framebuffer *rb = _mesa_lookup_framebuffer(ctx, framebuffer);
1595       if (rb != NULL && rb != &DummyFramebuffer)
1596          return GL_TRUE;
1597    }
1598    return GL_FALSE;
1599 }
1600
1601
1602 /**
1603  * Check if any of the attachments of the given framebuffer are textures
1604  * (render to texture).  Call ctx->Driver.RenderTexture() for such
1605  * attachments.
1606  */
1607 static void
1608 check_begin_texture_render(struct gl_context *ctx, struct gl_framebuffer *fb)
1609 {
1610    GLuint i;
1611    ASSERT(ctx->Driver.RenderTexture);
1612
1613    if (is_winsys_fbo(fb))
1614       return; /* can't render to texture with winsys framebuffers */
1615
1616    for (i = 0; i < BUFFER_COUNT; i++) {
1617       struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1618       if (att->Texture && _mesa_get_attachment_teximage(att)) {
1619          ctx->Driver.RenderTexture(ctx, fb, att);
1620       }
1621    }
1622 }
1623
1624
1625 /**
1626  * Examine all the framebuffer's attachments to see if any are textures.
1627  * If so, call ctx->Driver.FinishRenderTexture() for each texture to
1628  * notify the device driver that the texture image may have changed.
1629  */
1630 static void
1631 check_end_texture_render(struct gl_context *ctx, struct gl_framebuffer *fb)
1632 {
1633    if (is_winsys_fbo(fb))
1634       return; /* can't render to texture with winsys framebuffers */
1635
1636    if (ctx->Driver.FinishRenderTexture) {
1637       GLuint i;
1638       for (i = 0; i < BUFFER_COUNT; i++) {
1639          struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1640          if (att->Texture && att->Renderbuffer) {
1641             ctx->Driver.FinishRenderTexture(ctx, att);
1642          }
1643       }
1644    }
1645 }
1646
1647
1648 void GLAPIENTRY
1649 _mesa_BindFramebufferEXT(GLenum target, GLuint framebuffer)
1650 {
1651    struct gl_framebuffer *newDrawFb, *newReadFb;
1652    struct gl_framebuffer *oldDrawFb, *oldReadFb;
1653    GLboolean bindReadBuf, bindDrawBuf;
1654    GET_CURRENT_CONTEXT(ctx);
1655
1656 #ifdef DEBUG
1657    if (ctx->Extensions.ARB_framebuffer_object) {
1658       ASSERT(ctx->Extensions.EXT_framebuffer_object);
1659       ASSERT(ctx->Extensions.EXT_framebuffer_blit);
1660    }
1661 #endif
1662
1663    ASSERT_OUTSIDE_BEGIN_END(ctx);
1664
1665    if (!ctx->Extensions.EXT_framebuffer_object) {
1666       _mesa_error(ctx, GL_INVALID_OPERATION,
1667                   "glBindFramebufferEXT(unsupported)");
1668       return;
1669    }
1670
1671    switch (target) {
1672 #if FEATURE_EXT_framebuffer_blit
1673    case GL_DRAW_FRAMEBUFFER_EXT:
1674       if (!ctx->Extensions.EXT_framebuffer_blit) {
1675          _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1676          return;
1677       }
1678       bindDrawBuf = GL_TRUE;
1679       bindReadBuf = GL_FALSE;
1680       break;
1681    case GL_READ_FRAMEBUFFER_EXT:
1682       if (!ctx->Extensions.EXT_framebuffer_blit) {
1683          _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1684          return;
1685       }
1686       bindDrawBuf = GL_FALSE;
1687       bindReadBuf = GL_TRUE;
1688       break;
1689 #endif
1690    case GL_FRAMEBUFFER_EXT:
1691       bindDrawBuf = GL_TRUE;
1692       bindReadBuf = GL_TRUE;
1693       break;
1694    default:
1695       _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1696       return;
1697    }
1698
1699    if (framebuffer) {
1700       /* Binding a user-created framebuffer object */
1701       newDrawFb = _mesa_lookup_framebuffer(ctx, framebuffer);
1702       if (newDrawFb == &DummyFramebuffer) {
1703          /* ID was reserved, but no real framebuffer object made yet */
1704          newDrawFb = NULL;
1705       }
1706       else if (!newDrawFb && ctx->Extensions.ARB_framebuffer_object) {
1707          /* All FBO IDs must be Gen'd */
1708          _mesa_error(ctx, GL_INVALID_OPERATION, "glBindFramebuffer(buffer)");
1709          return;
1710       }
1711
1712       if (!newDrawFb) {
1713          /* create new framebuffer object */
1714          newDrawFb = ctx->Driver.NewFramebuffer(ctx, framebuffer);
1715          if (!newDrawFb) {
1716             _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindFramebufferEXT");
1717             return;
1718          }
1719          _mesa_HashInsert(ctx->Shared->FrameBuffers, framebuffer, newDrawFb);
1720       }
1721       newReadFb = newDrawFb;
1722    }
1723    else {
1724       /* Binding the window system framebuffer (which was originally set
1725        * with MakeCurrent).
1726        */
1727       newDrawFb = ctx->WinSysDrawBuffer;
1728       newReadFb = ctx->WinSysReadBuffer;
1729    }
1730
1731    ASSERT(newDrawFb);
1732    ASSERT(newDrawFb != &DummyFramebuffer);
1733
1734    /* save pointers to current/old framebuffers */
1735    oldDrawFb = ctx->DrawBuffer;
1736    oldReadFb = ctx->ReadBuffer;
1737
1738    /* check if really changing bindings */
1739    if (oldDrawFb == newDrawFb)
1740       bindDrawBuf = GL_FALSE;
1741    if (oldReadFb == newReadFb)
1742       bindReadBuf = GL_FALSE;
1743
1744    /*
1745     * OK, now bind the new Draw/Read framebuffers, if they're changing.
1746     *
1747     * We also check if we're beginning and/or ending render-to-texture.
1748     * When a framebuffer with texture attachments is unbound, call
1749     * ctx->Driver.FinishRenderTexture().
1750     * When a framebuffer with texture attachments is bound, call
1751     * ctx->Driver.RenderTexture().
1752     *
1753     * Note that if the ReadBuffer has texture attachments we don't consider
1754     * that a render-to-texture case.
1755     */
1756    if (bindReadBuf) {
1757       FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1758
1759       /* check if old readbuffer was render-to-texture */
1760       check_end_texture_render(ctx, oldReadFb);
1761
1762       _mesa_reference_framebuffer(&ctx->ReadBuffer, newReadFb);
1763    }
1764
1765    if (bindDrawBuf) {
1766       FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1767
1768       /* check if old read/draw buffers were render-to-texture */
1769       if (!bindReadBuf)
1770          check_end_texture_render(ctx, oldReadFb);
1771
1772       if (oldDrawFb != oldReadFb)
1773          check_end_texture_render(ctx, oldDrawFb);
1774
1775       /* check if newly bound framebuffer has any texture attachments */
1776       check_begin_texture_render(ctx, newDrawFb);
1777
1778       _mesa_reference_framebuffer(&ctx->DrawBuffer, newDrawFb);
1779    }
1780
1781    if ((bindDrawBuf || bindReadBuf) && ctx->Driver.BindFramebuffer) {
1782       ctx->Driver.BindFramebuffer(ctx, target, newDrawFb, newReadFb);
1783    }
1784 }
1785
1786
1787 void GLAPIENTRY
1788 _mesa_DeleteFramebuffersEXT(GLsizei n, const GLuint *framebuffers)
1789 {
1790    GLint i;
1791    GET_CURRENT_CONTEXT(ctx);
1792
1793    ASSERT_OUTSIDE_BEGIN_END(ctx);
1794    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1795
1796    for (i = 0; i < n; i++) {
1797       if (framebuffers[i] > 0) {
1798          struct gl_framebuffer *fb;
1799          fb = _mesa_lookup_framebuffer(ctx, framebuffers[i]);
1800          if (fb) {
1801             ASSERT(fb == &DummyFramebuffer || fb->Name == framebuffers[i]);
1802
1803             /* check if deleting currently bound framebuffer object */
1804             if (ctx->Extensions.EXT_framebuffer_blit) {
1805                /* separate draw/read binding points */
1806                if (fb == ctx->DrawBuffer) {
1807                   /* bind default */
1808                   ASSERT(fb->RefCount >= 2);
1809                   _mesa_BindFramebufferEXT(GL_DRAW_FRAMEBUFFER_EXT, 0);
1810                }
1811                if (fb == ctx->ReadBuffer) {
1812                   /* bind default */
1813                   ASSERT(fb->RefCount >= 2);
1814                   _mesa_BindFramebufferEXT(GL_READ_FRAMEBUFFER_EXT, 0);
1815                }
1816             }
1817             else {
1818                /* only one binding point for read/draw buffers */
1819                if (fb == ctx->DrawBuffer || fb == ctx->ReadBuffer) {
1820                   /* bind default */
1821                   ASSERT(fb->RefCount >= 2);
1822                   _mesa_BindFramebufferEXT(GL_FRAMEBUFFER_EXT, 0);
1823                }
1824             }
1825
1826             /* remove from hash table immediately, to free the ID */
1827             _mesa_HashRemove(ctx->Shared->FrameBuffers, framebuffers[i]);
1828
1829             if (fb != &DummyFramebuffer) {
1830                /* But the object will not be freed until it's no longer
1831                 * bound in any context.
1832                 */
1833                _mesa_reference_framebuffer(&fb, NULL);
1834             }
1835          }
1836       }
1837    }
1838 }
1839
1840
1841 void GLAPIENTRY
1842 _mesa_GenFramebuffersEXT(GLsizei n, GLuint *framebuffers)
1843 {
1844    GET_CURRENT_CONTEXT(ctx);
1845    GLuint first;
1846    GLint i;
1847
1848    ASSERT_OUTSIDE_BEGIN_END(ctx);
1849
1850    if (n < 0) {
1851       _mesa_error(ctx, GL_INVALID_VALUE, "glGenFramebuffersEXT(n)");
1852       return;
1853    }
1854
1855    if (!framebuffers)
1856       return;
1857
1858    first = _mesa_HashFindFreeKeyBlock(ctx->Shared->FrameBuffers, n);
1859
1860    for (i = 0; i < n; i++) {
1861       GLuint name = first + i;
1862       framebuffers[i] = name;
1863       /* insert dummy placeholder into hash table */
1864       _glthread_LOCK_MUTEX(ctx->Shared->Mutex);
1865       _mesa_HashInsert(ctx->Shared->FrameBuffers, name, &DummyFramebuffer);
1866       _glthread_UNLOCK_MUTEX(ctx->Shared->Mutex);
1867    }
1868 }
1869
1870
1871
1872 GLenum GLAPIENTRY
1873 _mesa_CheckFramebufferStatusEXT(GLenum target)
1874 {
1875    struct gl_framebuffer *buffer;
1876    GET_CURRENT_CONTEXT(ctx);
1877
1878    ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, 0);
1879
1880    buffer = get_framebuffer_target(ctx, target);
1881    if (!buffer) {
1882       _mesa_error(ctx, GL_INVALID_ENUM, "glCheckFramebufferStatus(target)");
1883       return 0;
1884    }
1885
1886    if (is_winsys_fbo(buffer)) {
1887       /* The window system / default framebuffer is always complete */
1888       return GL_FRAMEBUFFER_COMPLETE_EXT;
1889    }
1890
1891    /* No need to flush here */
1892
1893    if (buffer->_Status != GL_FRAMEBUFFER_COMPLETE) {
1894       _mesa_test_framebuffer_completeness(ctx, buffer);
1895    }
1896
1897    return buffer->_Status;
1898 }
1899
1900 /**
1901  * Replicate the src attachment point. Used by framebuffer_texture() when
1902  * the same texture is attached at GL_DEPTH_ATTACHMENT and
1903  * GL_STENCIL_ATTACHMENT.
1904  */
1905 static void
1906 reuse_framebuffer_texture_attachment(struct gl_framebuffer *fb,
1907                                      gl_buffer_index dst,
1908                                      gl_buffer_index src)
1909 {
1910    struct gl_renderbuffer_attachment *dst_att = &fb->Attachment[dst];
1911    struct gl_renderbuffer_attachment *src_att = &fb->Attachment[src];
1912
1913    assert(src_att->Texture != NULL);
1914    assert (src_att->Renderbuffer != NULL);
1915
1916    _mesa_reference_texobj(&dst_att->Texture, src_att->Texture);
1917    _mesa_reference_renderbuffer(&dst_att->Renderbuffer, src_att->Renderbuffer);
1918    dst_att->Type = src_att->Type;
1919    dst_att->Complete = src_att->Complete;
1920    dst_att->TextureLevel = src_att->TextureLevel;
1921    dst_att->Zoffset = src_att->Zoffset;
1922 }
1923
1924 /**
1925  * Common code called by glFramebufferTexture1D/2D/3DEXT().
1926  */
1927 static void
1928 framebuffer_texture(struct gl_context *ctx, const char *caller, GLenum target,
1929                     GLenum attachment, GLenum textarget, GLuint texture,
1930                     GLint level, GLint zoffset)
1931 {
1932    struct gl_renderbuffer_attachment *att;
1933    struct gl_texture_object *texObj = NULL;
1934    struct gl_framebuffer *fb;
1935
1936    ASSERT_OUTSIDE_BEGIN_END(ctx);
1937
1938    fb = get_framebuffer_target(ctx, target);
1939    if (!fb) {
1940       _mesa_error(ctx, GL_INVALID_ENUM,
1941                   "glFramebufferTexture%sEXT(target=0x%x)", caller, target);
1942       return;
1943    }
1944
1945    /* check framebuffer binding */
1946    if (is_winsys_fbo(fb)) {
1947       _mesa_error(ctx, GL_INVALID_OPERATION,
1948                   "glFramebufferTexture%sEXT", caller);
1949       return;
1950    }
1951
1952
1953    /* The textarget, level, and zoffset parameters are only validated if
1954     * texture is non-zero.
1955     */
1956    if (texture) {
1957       GLboolean err = GL_TRUE;
1958
1959       texObj = _mesa_lookup_texture(ctx, texture);
1960       if (texObj != NULL) {
1961          if (textarget == 0) {
1962             /* XXX what's the purpose of this? */
1963             err = (texObj->Target != GL_TEXTURE_3D) &&
1964                 (texObj->Target != GL_TEXTURE_1D_ARRAY_EXT) &&
1965                 (texObj->Target != GL_TEXTURE_2D_ARRAY_EXT);
1966          }
1967          else {
1968             err = (texObj->Target == GL_TEXTURE_CUBE_MAP)
1969                 ? !_mesa_is_cube_face(textarget)
1970                 : (texObj->Target != textarget);
1971          }
1972       }
1973       else {
1974          /* can't render to a non-existant texture */
1975          _mesa_error(ctx, GL_INVALID_OPERATION,
1976                      "glFramebufferTexture%sEXT(non existant texture)",
1977                      caller);
1978          return;
1979       }
1980
1981       if (err) {
1982          _mesa_error(ctx, GL_INVALID_OPERATION,
1983                      "glFramebufferTexture%sEXT(texture target mismatch)",
1984                      caller);
1985          return;
1986       }
1987
1988       if (texObj->Target == GL_TEXTURE_3D) {
1989          const GLint maxSize = 1 << (ctx->Const.Max3DTextureLevels - 1);
1990          if (zoffset < 0 || zoffset >= maxSize) {
1991             _mesa_error(ctx, GL_INVALID_VALUE,
1992                         "glFramebufferTexture%sEXT(zoffset)", caller);
1993             return;
1994          }
1995       }
1996       else if ((texObj->Target == GL_TEXTURE_1D_ARRAY_EXT) ||
1997                (texObj->Target == GL_TEXTURE_2D_ARRAY_EXT)) {
1998          if (zoffset < 0 || zoffset >= ctx->Const.MaxArrayTextureLayers) {
1999             _mesa_error(ctx, GL_INVALID_VALUE,
2000                         "glFramebufferTexture%sEXT(layer)", caller);
2001             return;
2002          }
2003       }
2004
2005       if ((level < 0) ||
2006           (level >= _mesa_max_texture_levels(ctx, texObj->Target))) {
2007          _mesa_error(ctx, GL_INVALID_VALUE,
2008                      "glFramebufferTexture%sEXT(level)", caller);
2009          return;
2010       }
2011    }
2012
2013    att = _mesa_get_attachment(ctx, fb, attachment);
2014    if (att == NULL) {
2015       _mesa_error(ctx, GL_INVALID_ENUM,
2016                   "glFramebufferTexture%sEXT(attachment)", caller);
2017       return;
2018    }
2019
2020    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2021
2022    _glthread_LOCK_MUTEX(fb->Mutex);
2023    if (texObj) {
2024       if (attachment == GL_DEPTH_ATTACHMENT &&
2025            texObj == fb->Attachment[BUFFER_STENCIL].Texture) {
2026          /* The texture object is already attached to the stencil attachment
2027           * point. Don't create a new renderbuffer; just reuse the stencil
2028           * attachment's. This is required to prevent a GL error in
2029           * glGetFramebufferAttachmentParameteriv(GL_DEPTH_STENCIL).
2030           */
2031          reuse_framebuffer_texture_attachment(fb, BUFFER_DEPTH,
2032                                               BUFFER_STENCIL);
2033       } else if (attachment == GL_STENCIL_ATTACHMENT &&
2034                  texObj== fb->Attachment[BUFFER_DEPTH].Texture) {
2035          /* As above, but with depth and stencil juxtasposed. */
2036          reuse_framebuffer_texture_attachment(fb, BUFFER_STENCIL,
2037                                               BUFFER_DEPTH);
2038       } else {
2039          _mesa_set_texture_attachment(ctx, fb, att, texObj, textarget,
2040                                       level, zoffset);
2041          if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
2042             /* Above we created a new renderbuffer and attached it to the
2043              * depth attachment point. Now attach it to the stencil attachment
2044              * point too.
2045              */
2046             assert(att == &fb->Attachment[BUFFER_DEPTH]);
2047             reuse_framebuffer_texture_attachment(fb,BUFFER_STENCIL,
2048                                                  BUFFER_DEPTH);
2049          }
2050       }
2051
2052       /* Set the render-to-texture flag.  We'll check this flag in
2053        * glTexImage() and friends to determine if we need to revalidate
2054        * any FBOs that might be rendering into this texture.
2055        * This flag never gets cleared since it's non-trivial to determine
2056        * when all FBOs might be done rendering to this texture.  That's OK
2057        * though since it's uncommon to render to a texture then repeatedly
2058        * call glTexImage() to change images in the texture.
2059        */
2060       texObj->_RenderToTexture = GL_TRUE;
2061    }
2062    else {
2063       _mesa_remove_attachment(ctx, att);
2064       if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
2065          assert(att == &fb->Attachment[BUFFER_DEPTH]);
2066          _mesa_remove_attachment(ctx, &fb->Attachment[BUFFER_STENCIL]);
2067       }
2068    }
2069
2070    invalidate_framebuffer(fb);
2071
2072    _glthread_UNLOCK_MUTEX(fb->Mutex);
2073 }
2074
2075
2076
2077 void GLAPIENTRY
2078 _mesa_FramebufferTexture1DEXT(GLenum target, GLenum attachment,
2079                               GLenum textarget, GLuint texture, GLint level)
2080 {
2081    GET_CURRENT_CONTEXT(ctx);
2082
2083    if (texture != 0) {
2084       GLboolean error;
2085
2086       switch (textarget) {
2087       case GL_TEXTURE_1D:
2088          error = GL_FALSE;
2089          break;
2090       case GL_TEXTURE_1D_ARRAY:
2091          error = !ctx->Extensions.EXT_texture_array;
2092          break;
2093       default:
2094          error = GL_TRUE;
2095       }
2096
2097       if (error) {
2098          _mesa_error(ctx, GL_INVALID_OPERATION,
2099                      "glFramebufferTexture1DEXT(textarget=%s)",
2100                      _mesa_lookup_enum_by_nr(textarget));
2101          return;
2102       }
2103    }
2104
2105    framebuffer_texture(ctx, "1D", target, attachment, textarget, texture,
2106                        level, 0);
2107 }
2108
2109
2110 void GLAPIENTRY
2111 _mesa_FramebufferTexture2DEXT(GLenum target, GLenum attachment,
2112                               GLenum textarget, GLuint texture, GLint level)
2113 {
2114    GET_CURRENT_CONTEXT(ctx);
2115
2116    if (texture != 0) {
2117       GLboolean error;
2118
2119       switch (textarget) {
2120       case GL_TEXTURE_2D:
2121          error = GL_FALSE;
2122          break;
2123       case GL_TEXTURE_RECTANGLE:
2124          error = !ctx->Extensions.NV_texture_rectangle;
2125          break;
2126       case GL_TEXTURE_CUBE_MAP_POSITIVE_X:
2127       case GL_TEXTURE_CUBE_MAP_NEGATIVE_X:
2128       case GL_TEXTURE_CUBE_MAP_POSITIVE_Y:
2129       case GL_TEXTURE_CUBE_MAP_NEGATIVE_Y:
2130       case GL_TEXTURE_CUBE_MAP_POSITIVE_Z:
2131       case GL_TEXTURE_CUBE_MAP_NEGATIVE_Z:
2132          error = !ctx->Extensions.ARB_texture_cube_map;
2133          break;
2134       case GL_TEXTURE_2D_ARRAY:
2135          error = !ctx->Extensions.EXT_texture_array;
2136          break;
2137       default:
2138          error = GL_TRUE;
2139       }
2140
2141       if (error) {
2142          _mesa_error(ctx, GL_INVALID_OPERATION,
2143                      "glFramebufferTexture2DEXT(textarget=%s)",
2144                      _mesa_lookup_enum_by_nr(textarget));
2145          return;
2146       }
2147    }
2148
2149    framebuffer_texture(ctx, "2D", target, attachment, textarget, texture,
2150                        level, 0);
2151 }
2152
2153
2154 void GLAPIENTRY
2155 _mesa_FramebufferTexture3DEXT(GLenum target, GLenum attachment,
2156                               GLenum textarget, GLuint texture,
2157                               GLint level, GLint zoffset)
2158 {
2159    GET_CURRENT_CONTEXT(ctx);
2160
2161    if ((texture != 0) && (textarget != GL_TEXTURE_3D)) {
2162       _mesa_error(ctx, GL_INVALID_OPERATION,
2163                   "glFramebufferTexture3DEXT(textarget)");
2164       return;
2165    }
2166
2167    framebuffer_texture(ctx, "3D", target, attachment, textarget, texture,
2168                        level, zoffset);
2169 }
2170
2171
2172 void GLAPIENTRY
2173 _mesa_FramebufferTextureLayerEXT(GLenum target, GLenum attachment,
2174                                  GLuint texture, GLint level, GLint layer)
2175 {
2176    GET_CURRENT_CONTEXT(ctx);
2177
2178    framebuffer_texture(ctx, "Layer", target, attachment, 0, texture,
2179                        level, layer);
2180 }
2181
2182
2183 void GLAPIENTRY
2184 _mesa_FramebufferRenderbufferEXT(GLenum target, GLenum attachment,
2185                                  GLenum renderbufferTarget,
2186                                  GLuint renderbuffer)
2187 {
2188    struct gl_renderbuffer_attachment *att;
2189    struct gl_framebuffer *fb;
2190    struct gl_renderbuffer *rb;
2191    GET_CURRENT_CONTEXT(ctx);
2192
2193    ASSERT_OUTSIDE_BEGIN_END(ctx);
2194
2195    fb = get_framebuffer_target(ctx, target);
2196    if (!fb) {
2197       _mesa_error(ctx, GL_INVALID_ENUM, "glFramebufferRenderbufferEXT(target)");
2198       return;
2199    }
2200
2201    if (renderbufferTarget != GL_RENDERBUFFER_EXT) {
2202       _mesa_error(ctx, GL_INVALID_ENUM,
2203                   "glFramebufferRenderbufferEXT(renderbufferTarget)");
2204       return;
2205    }
2206
2207    if (is_winsys_fbo(fb)) {
2208       /* Can't attach new renderbuffers to a window system framebuffer */
2209       _mesa_error(ctx, GL_INVALID_OPERATION, "glFramebufferRenderbufferEXT");
2210       return;
2211    }
2212
2213    att = _mesa_get_attachment(ctx, fb, attachment);
2214    if (att == NULL) {
2215       _mesa_error(ctx, GL_INVALID_ENUM,
2216                   "glFramebufferRenderbufferEXT(invalid attachment %s)",
2217                   _mesa_lookup_enum_by_nr(attachment));
2218       return;
2219    }
2220
2221    if (renderbuffer) {
2222       rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
2223       if (!rb) {
2224          _mesa_error(ctx, GL_INVALID_OPERATION,
2225                      "glFramebufferRenderbufferEXT(non-existant"
2226                      " renderbuffer %u)", renderbuffer);
2227          return;
2228       }
2229       else if (rb == &DummyRenderbuffer) {
2230          /* This is what NVIDIA does */
2231          _mesa_error(ctx, GL_INVALID_VALUE,
2232                      "glFramebufferRenderbufferEXT(renderbuffer %u)",
2233                      renderbuffer);
2234          return;
2235       }
2236    }
2237    else {
2238       /* remove renderbuffer attachment */
2239       rb = NULL;
2240    }
2241
2242    if (attachment == GL_DEPTH_STENCIL_ATTACHMENT &&
2243        rb && rb->Format != MESA_FORMAT_NONE) {
2244       /* make sure the renderbuffer is a depth/stencil format */
2245       const GLenum baseFormat = _mesa_get_format_base_format(rb->Format);
2246       if (baseFormat != GL_DEPTH_STENCIL) {
2247          _mesa_error(ctx, GL_INVALID_OPERATION,
2248                      "glFramebufferRenderbufferEXT(renderbuffer"
2249                      " is not DEPTH_STENCIL format)");
2250          return;
2251       }
2252    }
2253
2254
2255    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2256
2257    assert(ctx->Driver.FramebufferRenderbuffer);
2258    ctx->Driver.FramebufferRenderbuffer(ctx, fb, attachment, rb);
2259
2260    /* Some subsequent GL commands may depend on the framebuffer's visual
2261     * after the binding is updated.  Update visual info now.
2262     */
2263    _mesa_update_framebuffer_visual(ctx, fb);
2264 }
2265
2266
2267 void GLAPIENTRY
2268 _mesa_GetFramebufferAttachmentParameterivEXT(GLenum target, GLenum attachment,
2269                                              GLenum pname, GLint *params)
2270 {
2271    const struct gl_renderbuffer_attachment *att;
2272    struct gl_framebuffer *buffer;
2273    GLenum err;
2274    GET_CURRENT_CONTEXT(ctx);
2275
2276    ASSERT_OUTSIDE_BEGIN_END(ctx);
2277
2278    /* The error differs in GL andd GLES. */
2279    err = ctx->API == API_OPENGL ? GL_INVALID_OPERATION : GL_INVALID_ENUM;
2280
2281    buffer = get_framebuffer_target(ctx, target);
2282    if (!buffer) {
2283       _mesa_error(ctx, GL_INVALID_ENUM,
2284                   "glGetFramebufferAttachmentParameterivEXT(target)");
2285       return;
2286    }
2287
2288    if (is_winsys_fbo(buffer)) {
2289       /* Page 126 (page 136 of the PDF) of the OpenGL ES 2.0.25 spec
2290        * says:
2291        *
2292        *     "If the framebuffer currently bound to target is zero, then
2293        *     INVALID_OPERATION is generated."
2294        *
2295        * The EXT_framebuffer_object spec has the same wording, and the
2296        * OES_framebuffer_object spec refers to the EXT_framebuffer_object
2297        * spec.
2298        */
2299       if (ctx->API != API_OPENGL || !ctx->Extensions.ARB_framebuffer_object) {
2300          _mesa_error(ctx, GL_INVALID_OPERATION,
2301                      "glGetFramebufferAttachmentParameteriv(bound FBO = 0)");
2302          return;
2303       }
2304       /* the default / window-system FBO */
2305       att = _mesa_get_fb0_attachment(ctx, buffer, attachment);
2306    }
2307    else {
2308       /* user-created framebuffer FBO */
2309       att = _mesa_get_attachment(ctx, buffer, attachment);
2310    }
2311
2312    if (att == NULL) {
2313       _mesa_error(ctx, GL_INVALID_ENUM,
2314                   "glGetFramebufferAttachmentParameterivEXT(attachment)");
2315       return;
2316    }
2317
2318    if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
2319       /* the depth and stencil attachments must point to the same buffer */
2320       const struct gl_renderbuffer_attachment *depthAtt, *stencilAtt;
2321       depthAtt = _mesa_get_attachment(ctx, buffer, GL_DEPTH_ATTACHMENT);
2322       stencilAtt = _mesa_get_attachment(ctx, buffer, GL_STENCIL_ATTACHMENT);
2323       if (depthAtt->Renderbuffer != stencilAtt->Renderbuffer) {
2324          _mesa_error(ctx, GL_INVALID_OPERATION,
2325                      "glGetFramebufferAttachmentParameterivEXT(DEPTH/STENCIL"
2326                      " attachments differ)");
2327          return;
2328       }
2329    }
2330
2331    /* No need to flush here */
2332
2333    switch (pname) {
2334    case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_EXT:
2335       *params = is_winsys_fbo(buffer) ? GL_FRAMEBUFFER_DEFAULT : att->Type;
2336       return;
2337    case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_EXT:
2338       if (att->Type == GL_RENDERBUFFER_EXT) {
2339          *params = att->Renderbuffer->Name;
2340       }
2341       else if (att->Type == GL_TEXTURE) {
2342          *params = att->Texture->Name;
2343       }
2344       else {
2345          assert(att->Type == GL_NONE);
2346          if (ctx->API == API_OPENGL) {
2347             *params = 0;
2348          } else {
2349             _mesa_error(ctx, GL_INVALID_ENUM,
2350                         "glGetFramebufferAttachmentParameterivEXT(pname)");
2351          }
2352       }
2353       return;
2354    case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_EXT:
2355       if (att->Type == GL_TEXTURE) {
2356          *params = att->TextureLevel;
2357       }
2358       else if (att->Type == GL_NONE) {
2359          _mesa_error(ctx, err,
2360                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2361       }
2362       else {
2363          _mesa_error(ctx, GL_INVALID_ENUM,
2364                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2365       }
2366       return;
2367    case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_EXT:
2368       if (att->Type == GL_TEXTURE) {
2369          if (att->Texture && att->Texture->Target == GL_TEXTURE_CUBE_MAP) {
2370             *params = GL_TEXTURE_CUBE_MAP_POSITIVE_X + att->CubeMapFace;
2371          }
2372          else {
2373             *params = 0;
2374          }
2375       }
2376       else if (att->Type == GL_NONE) {
2377          _mesa_error(ctx, err,
2378                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2379       }
2380       else {
2381          _mesa_error(ctx, GL_INVALID_ENUM,
2382                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2383       }
2384       return;
2385    case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_3D_ZOFFSET_EXT:
2386       if (att->Type == GL_TEXTURE) {
2387          if (att->Texture && att->Texture->Target == GL_TEXTURE_3D) {
2388             *params = att->Zoffset;
2389          }
2390          else {
2391             *params = 0;
2392          }
2393       }
2394       else if (att->Type == GL_NONE) {
2395          _mesa_error(ctx, err,
2396                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2397       }
2398       else {
2399          _mesa_error(ctx, GL_INVALID_ENUM,
2400                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2401       }
2402       return;
2403    case GL_FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING:
2404       if (!ctx->Extensions.ARB_framebuffer_object) {
2405          _mesa_error(ctx, GL_INVALID_ENUM,
2406                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2407       }
2408       else if (att->Type == GL_NONE) {
2409          _mesa_error(ctx, err,
2410                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2411       }
2412       else {
2413          if (ctx->Extensions.EXT_framebuffer_sRGB && ctx->Const.sRGBCapable) {
2414             *params = _mesa_get_format_color_encoding(att->Renderbuffer->Format);
2415          }
2416          else {
2417             /* According to ARB_framebuffer_sRGB, we should return LINEAR
2418              * if the sRGB conversion is unsupported. */
2419             *params = GL_LINEAR;
2420          }
2421       }
2422       return;
2423    case GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE:
2424       if (!ctx->Extensions.ARB_framebuffer_object) {
2425          _mesa_error(ctx, GL_INVALID_ENUM,
2426                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2427          return;
2428       }
2429       else if (att->Type == GL_NONE) {
2430          _mesa_error(ctx, err,
2431                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2432       }
2433       else {
2434          gl_format format = att->Renderbuffer->Format;
2435          if (format == MESA_FORMAT_S8) {
2436             /* special cases */
2437             *params = GL_INDEX;
2438          }
2439          else if (format == MESA_FORMAT_Z32_FLOAT_X24S8) {
2440             /* depends on the attachment parameter */
2441             if (attachment == GL_STENCIL_ATTACHMENT) {
2442                *params = GL_INDEX;
2443             }
2444             else {
2445                *params = GL_FLOAT;
2446             }
2447          }
2448          else {
2449             *params = _mesa_get_format_datatype(format);
2450          }
2451       }
2452       return;
2453    case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
2454    case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
2455    case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
2456    case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
2457    case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
2458    case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
2459       if (!ctx->Extensions.ARB_framebuffer_object) {
2460          _mesa_error(ctx, GL_INVALID_ENUM,
2461                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2462       }
2463       else if (att->Type == GL_NONE) {
2464          _mesa_error(ctx, err,
2465                      "glGetFramebufferAttachmentParameterivEXT(pname)");
2466       }
2467       else if (att->Texture) {
2468          const struct gl_texture_image *texImage =
2469             _mesa_select_tex_image(ctx, att->Texture, att->Texture->Target,
2470                                    att->TextureLevel);
2471          if (texImage) {
2472             *params = get_component_bits(pname, texImage->_BaseFormat,
2473                                          texImage->TexFormat);
2474          }
2475          else {
2476             *params = 0;
2477          }
2478       }
2479       else if (att->Renderbuffer) {
2480          *params = get_component_bits(pname, att->Renderbuffer->_BaseFormat,
2481                                       att->Renderbuffer->Format);
2482       }
2483       else {
2484          _mesa_problem(ctx, "glGetFramebufferAttachmentParameterivEXT:"
2485                        " invalid FBO attachment structure");
2486       }
2487       return;
2488    default:
2489       _mesa_error(ctx, GL_INVALID_ENUM,
2490                   "glGetFramebufferAttachmentParameterivEXT(pname)");
2491       return;
2492    }
2493 }
2494
2495
2496 void GLAPIENTRY
2497 _mesa_GenerateMipmapEXT(GLenum target)
2498 {
2499    struct gl_texture_image *srcImage;
2500    struct gl_texture_object *texObj;
2501    GLboolean error;
2502
2503    GET_CURRENT_CONTEXT(ctx);
2504
2505    ASSERT_OUTSIDE_BEGIN_END(ctx);
2506    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2507
2508    switch (target) {
2509    case GL_TEXTURE_1D:
2510    case GL_TEXTURE_2D:
2511    case GL_TEXTURE_3D:
2512       error = GL_FALSE;
2513       break;
2514    case GL_TEXTURE_CUBE_MAP:
2515       error = !ctx->Extensions.ARB_texture_cube_map;
2516       break;
2517    case GL_TEXTURE_1D_ARRAY:
2518    case GL_TEXTURE_2D_ARRAY:
2519       error = !ctx->Extensions.EXT_texture_array;
2520       break;
2521    default:
2522       error = GL_TRUE;
2523    }
2524
2525    if (error) {
2526       _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateMipmapEXT(target=%s)",
2527                   _mesa_lookup_enum_by_nr(target));
2528       return;
2529    }
2530
2531    texObj = _mesa_get_current_tex_object(ctx, target);
2532
2533    if (texObj->BaseLevel >= texObj->MaxLevel) {
2534       /* nothing to do */
2535       return;
2536    }
2537
2538    if (texObj->Target == GL_TEXTURE_CUBE_MAP &&
2539        !_mesa_cube_complete(texObj)) {
2540       _mesa_error(ctx, GL_INVALID_OPERATION,
2541                   "glGenerateMipmap(incomplete cube map)");
2542       return;
2543    }
2544
2545    _mesa_lock_texture(ctx, texObj);
2546
2547    srcImage = _mesa_select_tex_image(ctx, texObj, target, texObj->BaseLevel);
2548    if (!srcImage) {
2549       _mesa_unlock_texture(ctx, texObj);
2550       return;
2551    }
2552
2553    if (target == GL_TEXTURE_CUBE_MAP) {
2554       GLuint face;
2555       for (face = 0; face < 6; face++)
2556          ctx->Driver.GenerateMipmap(ctx,
2557                                     GL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB + face,
2558                                     texObj);
2559    }
2560    else {
2561       ctx->Driver.GenerateMipmap(ctx, target, texObj);
2562    }
2563    _mesa_unlock_texture(ctx, texObj);
2564 }
2565
2566
2567 #if FEATURE_EXT_framebuffer_blit
2568
2569 static const struct gl_renderbuffer_attachment *
2570 find_attachment(const struct gl_framebuffer *fb,
2571                 const struct gl_renderbuffer *rb)
2572 {
2573    GLuint i;
2574    for (i = 0; i < Elements(fb->Attachment); i++) {
2575       if (fb->Attachment[i].Renderbuffer == rb)
2576          return &fb->Attachment[i];
2577    }
2578    return NULL;
2579 }
2580
2581
2582
2583 /**
2584  * Blit rectangular region, optionally from one framebuffer to another.
2585  *
2586  * Note, if the src buffer is multisampled and the dest is not, this is
2587  * when the samples must be resolved to a single color.
2588  */
2589 void GLAPIENTRY
2590 _mesa_BlitFramebufferEXT(GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
2591                          GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
2592                          GLbitfield mask, GLenum filter)
2593 {
2594    const GLbitfield legalMaskBits = (GL_COLOR_BUFFER_BIT |
2595                                      GL_DEPTH_BUFFER_BIT |
2596                                      GL_STENCIL_BUFFER_BIT);
2597    const struct gl_framebuffer *readFb, *drawFb;
2598    const struct gl_renderbuffer *colorReadRb, *colorDrawRb;
2599    GET_CURRENT_CONTEXT(ctx);
2600
2601    ASSERT_OUTSIDE_BEGIN_END(ctx);
2602    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2603
2604    if (MESA_VERBOSE & VERBOSE_API)
2605       _mesa_debug(ctx,
2606                   "glBlitFramebuffer(%d, %d, %d, %d,  %d, %d, %d, %d, 0x%x, %s)\n",
2607                   srcX0, srcY0, srcX1, srcY1,
2608                   dstX0, dstY0, dstX1, dstY1,
2609                   mask, _mesa_lookup_enum_by_nr(filter));
2610
2611    if (ctx->NewState) {
2612       _mesa_update_state(ctx);
2613    }
2614
2615    readFb = ctx->ReadBuffer;
2616    drawFb = ctx->DrawBuffer;
2617
2618    if (!readFb || !drawFb) {
2619       /* This will normally never happen but someday we may want to
2620        * support MakeCurrent() with no drawables.
2621        */
2622       return;
2623    }
2624
2625    /* check for complete framebuffers */
2626    if (drawFb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT ||
2627        readFb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
2628       _mesa_error(ctx, GL_INVALID_FRAMEBUFFER_OPERATION_EXT,
2629                   "glBlitFramebufferEXT(incomplete draw/read buffers)");
2630       return;
2631    }
2632
2633    if (filter != GL_NEAREST && filter != GL_LINEAR) {
2634       _mesa_error(ctx, GL_INVALID_ENUM, "glBlitFramebufferEXT(filter)");
2635       return;
2636    }
2637
2638    if (mask & ~legalMaskBits) {
2639       _mesa_error( ctx, GL_INVALID_VALUE, "glBlitFramebufferEXT(mask)");
2640       return;
2641    }
2642
2643    /* depth/stencil must be blitted with nearest filtering */
2644    if ((mask & (GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT))
2645         && filter != GL_NEAREST) {
2646       _mesa_error(ctx, GL_INVALID_OPERATION,
2647              "glBlitFramebufferEXT(depth/stencil requires GL_NEAREST filter)");
2648       return;
2649    }
2650
2651    /* get color read/draw renderbuffers */
2652    if (mask & GL_COLOR_BUFFER_BIT) {
2653       colorReadRb = readFb->_ColorReadBuffer;
2654       colorDrawRb = drawFb->_ColorDrawBuffers[0];
2655
2656       /* From the EXT_framebuffer_object spec:
2657        *
2658        *     "If a buffer is specified in <mask> and does not exist in both
2659        *     the read and draw framebuffers, the corresponding bit is silently
2660        *     ignored."
2661        */
2662       if ((colorReadRb == NULL) || (colorDrawRb == NULL)) {
2663          colorReadRb = colorDrawRb = NULL;
2664          mask &= ~GL_COLOR_BUFFER_BIT;
2665       }
2666    }
2667    else {
2668       colorReadRb = colorDrawRb = NULL;
2669    }
2670
2671    if (mask & GL_STENCIL_BUFFER_BIT) {
2672       struct gl_renderbuffer *readRb = readFb->_StencilBuffer;
2673       struct gl_renderbuffer *drawRb = drawFb->_StencilBuffer;
2674
2675       /* From the EXT_framebuffer_object spec:
2676        *
2677        *     "If a buffer is specified in <mask> and does not exist in both
2678        *     the read and draw framebuffers, the corresponding bit is silently
2679        *     ignored."
2680        */
2681       if ((readRb == NULL) || (drawRb == NULL)) {
2682          readRb = drawRb = NULL;
2683          mask &= ~GL_STENCIL_BUFFER_BIT;
2684       }
2685       else if (_mesa_get_format_bits(readRb->Format, GL_STENCIL_BITS) !=
2686                _mesa_get_format_bits(drawRb->Format, GL_STENCIL_BITS)) {
2687          _mesa_error(ctx, GL_INVALID_OPERATION,
2688                      "glBlitFramebufferEXT(stencil buffer size mismatch)");
2689          return;
2690       }
2691    }
2692
2693    if (mask & GL_DEPTH_BUFFER_BIT) {
2694       struct gl_renderbuffer *readRb = readFb->_DepthBuffer;
2695       struct gl_renderbuffer *drawRb = drawFb->_DepthBuffer;
2696
2697       /* From the EXT_framebuffer_object spec:
2698        *
2699        *     "If a buffer is specified in <mask> and does not exist in both
2700        *     the read and draw framebuffers, the corresponding bit is silently
2701        *     ignored."
2702        */
2703       if ((readRb == NULL) || (drawRb == NULL)) {
2704          readRb = drawRb = NULL;
2705          mask &= ~GL_DEPTH_BUFFER_BIT;
2706       }
2707       else if (_mesa_get_format_bits(readRb->Format, GL_DEPTH_BITS) !=
2708                _mesa_get_format_bits(drawRb->Format, GL_DEPTH_BITS)) {
2709          _mesa_error(ctx, GL_INVALID_OPERATION,
2710                      "glBlitFramebufferEXT(depth buffer size mismatch)");
2711          return;
2712       }
2713    }
2714
2715    if (readFb->Visual.samples > 0 &&
2716        drawFb->Visual.samples > 0 &&
2717        readFb->Visual.samples != drawFb->Visual.samples) {
2718       _mesa_error(ctx, GL_INVALID_OPERATION,
2719                   "glBlitFramebufferEXT(mismatched samples");
2720       return;
2721    }
2722
2723    /* extra checks for multisample copies... */
2724    if (readFb->Visual.samples > 0 || drawFb->Visual.samples > 0) {
2725       /* src and dest region sizes must be the same */
2726       if (srcX1 - srcX0 != dstX1 - dstX0 ||
2727           srcY1 - srcY0 != dstY1 - dstY0) {
2728          _mesa_error(ctx, GL_INVALID_OPERATION,
2729                 "glBlitFramebufferEXT(bad src/dst multisample region sizes)");
2730          return;
2731       }
2732
2733       /* color formats must match */
2734       if (colorReadRb &&
2735           colorDrawRb &&
2736           colorReadRb->Format != colorDrawRb->Format) {
2737          _mesa_error(ctx, GL_INVALID_OPERATION,
2738                 "glBlitFramebufferEXT(bad src/dst multisample pixel formats)");
2739          return;
2740       }
2741    }
2742
2743    if (!ctx->Extensions.EXT_framebuffer_blit) {
2744       _mesa_error(ctx, GL_INVALID_OPERATION, "glBlitFramebufferEXT");
2745       return;
2746    }
2747
2748    /* Debug code */
2749    if (DEBUG_BLIT) {
2750       printf("glBlitFramebuffer(%d, %d, %d, %d,  %d, %d, %d, %d,"
2751              " 0x%x, 0x%x)\n",
2752              srcX0, srcY0, srcX1, srcY1,
2753              dstX0, dstY0, dstX1, dstY1,
2754              mask, filter);
2755       if (colorReadRb) {
2756          const struct gl_renderbuffer_attachment *att;
2757
2758          att = find_attachment(readFb, colorReadRb);
2759          printf("  Src FBO %u  RB %u (%dx%d)  ",
2760                 readFb->Name, colorReadRb->Name,
2761                 colorReadRb->Width, colorReadRb->Height);
2762          if (att && att->Texture) {
2763             printf("Tex %u  tgt 0x%x  level %u  face %u",
2764                    att->Texture->Name,
2765                    att->Texture->Target,
2766                    att->TextureLevel,
2767                    att->CubeMapFace);
2768          }
2769          printf("\n");
2770
2771          att = find_attachment(drawFb, colorDrawRb);
2772          printf("  Dst FBO %u  RB %u (%dx%d)  ",
2773                 drawFb->Name, colorDrawRb->Name,
2774                 colorDrawRb->Width, colorDrawRb->Height);
2775          if (att && att->Texture) {
2776             printf("Tex %u  tgt 0x%x  level %u  face %u",
2777                    att->Texture->Name,
2778                    att->Texture->Target,
2779                    att->TextureLevel,
2780                    att->CubeMapFace);
2781          }
2782          printf("\n");
2783       }
2784    }
2785
2786    if (!mask) {
2787       return;
2788    }
2789
2790    ASSERT(ctx->Driver.BlitFramebuffer);
2791    ctx->Driver.BlitFramebuffer(ctx,
2792                                srcX0, srcY0, srcX1, srcY1,
2793                                dstX0, dstY0, dstX1, dstY1,
2794                                mask, filter);
2795 }
2796 #endif /* FEATURE_EXT_framebuffer_blit */
2797
2798 #if FEATURE_ARB_geometry_shader4
2799 void GLAPIENTRY
2800 _mesa_FramebufferTextureARB(GLenum target, GLenum attachment,
2801                             GLuint texture, GLint level)
2802 {
2803    GET_CURRENT_CONTEXT(ctx);
2804    _mesa_error(ctx, GL_INVALID_OPERATION,
2805                "glFramebufferTextureARB "
2806                "not implemented!");
2807 }
2808
2809 void GLAPIENTRY
2810 _mesa_FramebufferTextureFaceARB(GLenum target, GLenum attachment,
2811                                 GLuint texture, GLint level, GLenum face)
2812 {
2813    GET_CURRENT_CONTEXT(ctx);
2814    _mesa_error(ctx, GL_INVALID_OPERATION,
2815                "glFramebufferTextureFaceARB "
2816                "not implemented!");
2817 }
2818 #endif /* FEATURE_ARB_geometry_shader4 */