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 "renderbuffer.h"
  44 #include "state.h"
  45 #include "teximage.h"
  46 #include "texobj.h"
  47
  48
  49 /** Set this to 1 to help debug FBO incompleteness problems */
  50 #define DEBUG_FBO 0
  51
  52 /** Set this to 1 to debug/log glBlitFramebuffer() calls */
  53 #define DEBUG_BLIT 0
  54
  55
  56 /**
  57  * Notes:
  58  *
  59  * None of the GL_EXT_framebuffer_object functions are compiled into
  60  * display lists.
  61  */
  62
  63
  64
  65 /*
  66  * When glGenRender/FramebuffersEXT() is called we insert pointers to
  67  * these placeholder objects into the hash table.
  68  * Later, when the object ID is first bound, we replace the placeholder
  69  * with the real frame/renderbuffer.
  70  */
  71 static struct gl_framebuffer DummyFramebuffer;
  72 static struct gl_renderbuffer DummyRenderbuffer;
  73
  74
  75 #define IS_CUBE_FACE(TARGET) \
  76    ((TARGET) >= GL_TEXTURE_CUBE_MAP_POSITIVE_X && \
  77     (TARGET) <= GL_TEXTURE_CUBE_MAP_NEGATIVE_Z)
  78
  79
  80 static void
  81 delete_dummy_renderbuffer(struct gl_renderbuffer *rb)
  82 {
  83    /* no op */
  84 }
  85
  86 static void
  87 delete_dummy_framebuffer(struct gl_framebuffer *fb)
  88 {
  89    /* no op */
  90 }
  91
  92
  93 void
  94 _mesa_init_fbobjects(GLcontext *ctx)
  95 {
  96    DummyFramebuffer.Delete = delete_dummy_framebuffer;
  97    DummyRenderbuffer.Delete = delete_dummy_renderbuffer;
  98 }
  99
 100
 101 /**
 102  * Helper routine for getting a gl_renderbuffer.
 103  */
 104 struct gl_renderbuffer *
 105 _mesa_lookup_renderbuffer(GLcontext *ctx, GLuint id)
 106 {
 107    struct gl_renderbuffer *rb;
 108
 109    if (id == 0)
 110       return NULL;
 111
 112    rb = (struct gl_renderbuffer *)
 113       _mesa_HashLookup(ctx->Shared->RenderBuffers, id);
 114    return rb;
 115 }
 116
 117
 118 /**
 119  * Helper routine for getting a gl_framebuffer.
 120  */
 121 struct gl_framebuffer *
 122 _mesa_lookup_framebuffer(GLcontext *ctx, GLuint id)
 123 {
 124    struct gl_framebuffer *fb;
 125
 126    if (id == 0)
 127       return NULL;
 128
 129    fb = (struct gl_framebuffer *)
 130       _mesa_HashLookup(ctx->Shared->FrameBuffers, id);
 131    return fb;
 132 }
 133
 134
 135 /**
 136  * Mark the given framebuffer as invalid.  This will force the
 137  * test for framebuffer completeness to be done before the framebuffer
 138  * is used.
 139  */
 140 static void
 141 invalidate_framebuffer(struct gl_framebuffer *fb)
 142 {
 143    fb->_Status = 0; /* "indeterminate" */
 144 }
 145
 146
 147 /**
 148  * Given a GL_*_ATTACHMENTn token, return a pointer to the corresponding
 149  * gl_renderbuffer_attachment object.
 150  * If \p attachment is GL_DEPTH_STENCIL_ATTACHMENT, return a pointer to
 151  * the depth buffer attachment point.
 152  */
 153 struct gl_renderbuffer_attachment *
 154 _mesa_get_attachment(GLcontext *ctx, struct gl_framebuffer *fb,
 155                      GLenum attachment)
 156 {
 157    GLuint i;
 158
 159    switch (attachment) {
 160    case GL_COLOR_ATTACHMENT0_EXT:
 161    case GL_COLOR_ATTACHMENT1_EXT:
 162    case GL_COLOR_ATTACHMENT2_EXT:
 163    case GL_COLOR_ATTACHMENT3_EXT:
 164    case GL_COLOR_ATTACHMENT4_EXT:
 165    case GL_COLOR_ATTACHMENT5_EXT:
 166    case GL_COLOR_ATTACHMENT6_EXT:
 167    case GL_COLOR_ATTACHMENT7_EXT:
 168    case GL_COLOR_ATTACHMENT8_EXT:
 169    case GL_COLOR_ATTACHMENT9_EXT:
 170    case GL_COLOR_ATTACHMENT10_EXT:
 171    case GL_COLOR_ATTACHMENT11_EXT:
 172    case GL_COLOR_ATTACHMENT12_EXT:
 173    case GL_COLOR_ATTACHMENT13_EXT:
 174    case GL_COLOR_ATTACHMENT14_EXT:
 175    case GL_COLOR_ATTACHMENT15_EXT:
 176       i = attachment - GL_COLOR_ATTACHMENT0_EXT;
 177       if (i >= ctx->Const.MaxColorAttachments) {
 178          return NULL;
 179       }
 180       return &fb->Attachment[BUFFER_COLOR0 + i];
 181    case GL_DEPTH_STENCIL_ATTACHMENT:
 182       /* fall-through */
 183    case GL_DEPTH_ATTACHMENT_EXT:
 184       return &fb->Attachment[BUFFER_DEPTH];
 185    case GL_STENCIL_ATTACHMENT_EXT:
 186       return &fb->Attachment[BUFFER_STENCIL];
 187    default:
 188       return NULL;
 189    }
 190 }
 191
 192
 193 /**
 194  * Remove any texture or renderbuffer attached to the given attachment
 195  * point.  Update reference counts, etc.
 196  */
 197 void
 198 _mesa_remove_attachment(GLcontext *ctx, struct gl_renderbuffer_attachment *att)
 199 {
 200    if (att->Type == GL_TEXTURE) {
 201       ASSERT(att->Texture);
 202       if (ctx->Driver.FinishRenderTexture) {
 203          /* tell driver that we're done rendering to this texture. */
 204          ctx->Driver.FinishRenderTexture(ctx, att);
 205       }
 206       _mesa_reference_texobj(&att->Texture, NULL); /* unbind */
 207       ASSERT(!att->Texture);
 208    }
 209    if (att->Type == GL_TEXTURE || att->Type == GL_RENDERBUFFER_EXT) {
 210       ASSERT(!att->Texture);
 211       _mesa_reference_renderbuffer(&att->Renderbuffer, NULL); /* unbind */
 212       ASSERT(!att->Renderbuffer);
 213    }
 214    att->Type = GL_NONE;
 215    att->Complete = GL_TRUE;
 216 }
 217
 218
 219 /**
 220  * Bind a texture object to an attachment point.
 221  * The previous binding, if any, will be removed first.
 222  */
 223 void
 224 _mesa_set_texture_attachment(GLcontext *ctx,
 225                              struct gl_framebuffer *fb,
 226                              struct gl_renderbuffer_attachment *att,
 227                              struct gl_texture_object *texObj,
 228                              GLenum texTarget, GLuint level, GLuint zoffset)
 229 {
 230    if (att->Texture == texObj) {
 231       /* re-attaching same texture */
 232       ASSERT(att->Type == GL_TEXTURE);
 233       if (ctx->Driver.FinishRenderTexture)
 234          ctx->Driver.FinishRenderTexture(ctx, att);
 235    }
 236    else {
 237       /* new attachment */
 238       if (ctx->Driver.FinishRenderTexture && att->Texture)
 239          ctx->Driver.FinishRenderTexture(ctx, att);
 240       _mesa_remove_attachment(ctx, att);
 241       att->Type = GL_TEXTURE;
 242       assert(!att->Texture);
 243       _mesa_reference_texobj(&att->Texture, texObj);
 244    }
 245
 246    /* always update these fields */
 247    att->TextureLevel = level;
 248    att->CubeMapFace = _mesa_tex_target_to_face(texTarget);
 249    att->Zoffset = zoffset;
 250    att->Complete = GL_FALSE;
 251
 252    if (att->Texture->Image[att->CubeMapFace][att->TextureLevel]) {
 253       ctx->Driver.RenderTexture(ctx, fb, att);
 254    }
 255
 256    invalidate_framebuffer(fb);
 257 }
 258
 259
 260 /**
 261  * Bind a renderbuffer to an attachment point.
 262  * The previous binding, if any, will be removed first.
 263  */
 264 void
 265 _mesa_set_renderbuffer_attachment(GLcontext *ctx,
 266                                   struct gl_renderbuffer_attachment *att,
 267                                   struct gl_renderbuffer *rb)
 268 {
 269    /* XXX check if re-doing same attachment, exit early */
 270    _mesa_remove_attachment(ctx, att);
 271    att->Type = GL_RENDERBUFFER_EXT;
 272    att->Texture = NULL; /* just to be safe */
 273    att->Complete = GL_FALSE;
 274    _mesa_reference_renderbuffer(&att->Renderbuffer, rb);
 275 }
 276
 277
 278 /**
 279  * Fallback for ctx->Driver.FramebufferRenderbuffer()
 280  * Attach a renderbuffer object to a framebuffer object.
 281  */
 282 void
 283 _mesa_framebuffer_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
 284                                GLenum attachment, struct gl_renderbuffer *rb)
 285 {
 286    struct gl_renderbuffer_attachment *att;
 287
 288    _glthread_LOCK_MUTEX(fb->Mutex);
 289
 290    att = _mesa_get_attachment(ctx, fb, attachment);
 291    ASSERT(att);
 292    if (rb) {
 293       _mesa_set_renderbuffer_attachment(ctx, att, rb);
 294       if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
 295          /* do stencil attachment here (depth already done above) */
 296          att = _mesa_get_attachment(ctx, fb, GL_STENCIL_ATTACHMENT_EXT);
 297          assert(att);
 298          _mesa_set_renderbuffer_attachment(ctx, att, rb);
 299       }
 300    }
 301    else {
 302       _mesa_remove_attachment(ctx, att);
 303    }
 304
 305    invalidate_framebuffer(fb);
 306
 307    _glthread_UNLOCK_MUTEX(fb->Mutex);
 308 }
 309
 310
 311 /**
 312  * For debug only.
 313  */
 314 static void
 315 att_incomplete(const char *msg)
 316 {
 317 #if DEBUG_FBO
 318    _mesa_debug(NULL, "attachment incomplete: %s\n", msg);
 319 #else
 320    (void) msg;
 321 #endif
 322 }
 323
 324
 325 /**
 326  * For debug only.
 327  */
 328 static void
 329 fbo_incomplete(const char *msg, int index)
 330 {
 331 #if DEBUG_FBO
 332    _mesa_debug(NULL, "FBO Incomplete: %s [%d]\n", msg, index);
 333 #else
 334    (void) msg;
 335    (void) index;
 336 #endif
 337 }
 338
 339
 340
 341
 342 /**
 343  * Test if an attachment point is complete and update its Complete field.
 344  * \param format if GL_COLOR, this is a color attachment point,
 345  *               if GL_DEPTH, this is a depth component attachment point,
 346  *               if GL_STENCIL, this is a stencil component attachment point.
 347  */
 348 static void
 349 test_attachment_completeness(const GLcontext *ctx, GLenum format,
 350                              struct gl_renderbuffer_attachment *att)
 351 {
 352    assert(format == GL_COLOR || format == GL_DEPTH || format == GL_STENCIL);
 353
 354    /* assume complete */
 355    att->Complete = GL_TRUE;
 356
 357    /* Look for reasons why the attachment might be incomplete */
 358    if (att->Type == GL_TEXTURE) {
 359       const struct gl_texture_object *texObj = att->Texture;
 360       struct gl_texture_image *texImage;
 361       GLenum baseFormat;
 362
 363       if (!texObj) {
 364          att_incomplete("no texobj");
 365          att->Complete = GL_FALSE;
 366          return;
 367       }
 368
 369       texImage = texObj->Image[att->CubeMapFace][att->TextureLevel];
 370       if (!texImage) {
 371          att_incomplete("no teximage");
 372          att->Complete = GL_FALSE;
 373          return;
 374       }
 375       if (texImage->Width < 1 || texImage->Height < 1) {
 376          att_incomplete("teximage width/height=0");
 377          printf("texobj = %u\n", texObj->Name);
 378          printf("level = %d\n", att->TextureLevel);
 379          att->Complete = GL_FALSE;
 380          return;
 381       }
 382       if (texObj->Target == GL_TEXTURE_3D && att->Zoffset >= texImage->Depth) {
 383          att_incomplete("bad z offset");
 384          att->Complete = GL_FALSE;
 385          return;
 386       }
 387
 388       baseFormat = _mesa_get_format_base_format(texImage->TexFormat);
 389
 390       if (format == GL_COLOR) {
 391          if (baseFormat != GL_RGB &&
 392              baseFormat != GL_RGBA) {
 393             att_incomplete("bad format");
 394             att->Complete = GL_FALSE;
 395             return;
 396          }
 397          if (_mesa_is_format_compressed(texImage->TexFormat)) {
 398             att_incomplete("compressed internalformat");
 399             att->Complete = GL_FALSE;
 400             return;
 401          }
 402       }
 403       else if (format == GL_DEPTH) {
 404          if (baseFormat == GL_DEPTH_COMPONENT) {
 405             /* OK */
 406          }
 407          else if (ctx->Extensions.EXT_packed_depth_stencil &&
 408                   ctx->Extensions.ARB_depth_texture &&
 409                   baseFormat == GL_DEPTH_STENCIL_EXT) {
 410             /* OK */
 411          }
 412          else {
 413             att->Complete = GL_FALSE;
 414             att_incomplete("bad depth format");
 415             return;
 416          }
 417       }
 418       else {
 419          ASSERT(format == GL_STENCIL);
 420          if (ctx->Extensions.EXT_packed_depth_stencil &&
 421              ctx->Extensions.ARB_depth_texture &&
 422              baseFormat == GL_DEPTH_STENCIL_EXT) {
 423             /* OK */
 424          }
 425          else {
 426             /* no such thing as stencil-only textures */
 427             att_incomplete("illegal stencil texture");
 428             att->Complete = GL_FALSE;
 429             return;
 430          }
 431       }
 432    }
 433    else if (att->Type == GL_RENDERBUFFER_EXT) {
 434       const GLenum baseFormat =
 435          _mesa_get_format_base_format(att->Renderbuffer->Format);
 436
 437       ASSERT(att->Renderbuffer);
 438       if (!att->Renderbuffer->InternalFormat ||
 439           att->Renderbuffer->Width < 1 ||
 440           att->Renderbuffer->Height < 1) {
 441          att_incomplete("0x0 renderbuffer");
 442          att->Complete = GL_FALSE;
 443          return;
 444       }
 445       if (format == GL_COLOR) {
 446          if (baseFormat != GL_RGB &&
 447              baseFormat != GL_RGBA) {
 448             att_incomplete("bad renderbuffer color format");
 449             att->Complete = GL_FALSE;
 450             return;
 451          }
 452       }
 453       else if (format == GL_DEPTH) {
 454          if (baseFormat == GL_DEPTH_COMPONENT) {
 455             /* OK */
 456          }
 457          else if (ctx->Extensions.EXT_packed_depth_stencil &&
 458                   baseFormat == GL_DEPTH_STENCIL_EXT) {
 459             /* OK */
 460          }
 461          else {
 462             att_incomplete("bad renderbuffer depth format");
 463             att->Complete = GL_FALSE;
 464             return;
 465          }
 466       }
 467       else {
 468          assert(format == GL_STENCIL);
 469          if (baseFormat == GL_STENCIL_INDEX) {
 470             /* OK */
 471          }
 472          else if (ctx->Extensions.EXT_packed_depth_stencil &&
 473                   baseFormat == GL_DEPTH_STENCIL_EXT) {
 474             /* OK */
 475          }
 476          else {
 477             att->Complete = GL_FALSE;
 478             att_incomplete("bad renderbuffer stencil format");
 479             return;
 480          }
 481       }
 482    }
 483    else {
 484       ASSERT(att->Type == GL_NONE);
 485       /* complete */
 486       return;
 487    }
 488 }
 489
 490
 491 /**
 492  * Test if the given framebuffer object is complete and update its
 493  * Status field with the results.
 494  * Calls the ctx->Driver.ValidateFramebuffer() function to allow the
 495  * driver to make hardware-specific validation/completeness checks.
 496  * Also update the framebuffer's Width and Height fields if the
 497  * framebuffer is complete.
 498  */
 499 void
 500 _mesa_test_framebuffer_completeness(GLcontext *ctx, struct gl_framebuffer *fb)
 501 {
 502    GLuint numImages;
 503    GLenum intFormat = GL_NONE; /* color buffers' internal format */
 504    GLuint minWidth = ~0, minHeight = ~0, maxWidth = 0, maxHeight = 0;
 505    GLint numSamples = -1;
 506    GLint i;
 507    GLuint j;
 508
 509    assert(fb->Name != 0);
 510
 511    numImages = 0;
 512    fb->Width = 0;
 513    fb->Height = 0;
 514
 515    /* Start at -2 to more easily loop over all attachment points.
 516     *  -2: depth buffer
 517     *  -1: stencil buffer
 518     * >=0: color buffer
 519     */
 520    for (i = -2; i < (GLint) ctx->Const.MaxColorAttachments; i++) {
 521       struct gl_renderbuffer_attachment *att;
 522       GLenum f;
 523
 524       /*
 525        * XXX for ARB_fbo, only check color buffers that are named by
 526        * GL_READ_BUFFER and GL_DRAW_BUFFERi.
 527        */
 528
 529       /* check for attachment completeness
 530        */
 531       if (i == -2) {
 532          att = &fb->Attachment[BUFFER_DEPTH];
 533          test_attachment_completeness(ctx, GL_DEPTH, att);
 534          if (!att->Complete) {
 535             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
 536             fbo_incomplete("depth attachment incomplete", -1);
 537             return;
 538          }
 539       }
 540       else if (i == -1) {
 541          att = &fb->Attachment[BUFFER_STENCIL];
 542          test_attachment_completeness(ctx, GL_STENCIL, att);
 543          if (!att->Complete) {
 544             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
 545             fbo_incomplete("stencil attachment incomplete", -1);
 546             return;
 547          }
 548       }
 549       else {
 550          att = &fb->Attachment[BUFFER_COLOR0 + i];
 551          test_attachment_completeness(ctx, GL_COLOR, att);
 552          if (!att->Complete) {
 553             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
 554             fbo_incomplete("color attachment incomplete", i);
 555             return;
 556          }
 557       }
 558
 559       /* get width, height, format of the renderbuffer/texture
 560        */
 561       if (att->Type == GL_TEXTURE) {
 562          const struct gl_texture_image *texImg
 563             = att->Texture->Image[att->CubeMapFace][att->TextureLevel];
 564          minWidth = MIN2(minWidth, texImg->Width);
 565          maxWidth = MAX2(maxWidth, texImg->Width);
 566          minHeight = MIN2(minHeight, texImg->Height);
 567          maxHeight = MAX2(maxHeight, texImg->Height);
 568          f = texImg->_BaseFormat;
 569          numImages++;
 570          if (f != GL_RGB && f != GL_RGBA && f != GL_DEPTH_COMPONENT
 571              && f != GL_DEPTH_STENCIL_EXT) {
 572             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
 573             fbo_incomplete("texture attachment incomplete", -1);
 574             return;
 575          }
 576       }
 577       else if (att->Type == GL_RENDERBUFFER_EXT) {
 578          minWidth = MIN2(minWidth, att->Renderbuffer->Width);
 579          maxWidth = MAX2(minWidth, att->Renderbuffer->Width);
 580          minHeight = MIN2(minHeight, att->Renderbuffer->Height);
 581          maxHeight = MAX2(minHeight, att->Renderbuffer->Height);
 582          f = att->Renderbuffer->InternalFormat;
 583          numImages++;
 584       }
 585       else {
 586          assert(att->Type == GL_NONE);
 587          continue;
 588       }
 589
 590       if (numSamples < 0) {
 591          /* first buffer */
 592          numSamples = att->Renderbuffer->NumSamples;
 593       }
 594
 595       /* Error-check width, height, format, samples
 596        */
 597       if (numImages == 1) {
 598          /* save format, num samples */
 599          if (i >= 0) {
 600             intFormat = f;
 601          }
 602       }
 603       else {
 604          if (!ctx->Extensions.ARB_framebuffer_object) {
 605             /* check that width, height, format are same */
 606             if (minWidth != maxWidth || minHeight != maxHeight) {
 607                fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT;
 608                fbo_incomplete("width or height mismatch", -1);
 609                return;
 610             }
 611             /* check that all color buffer have same format */
 612             if (intFormat != GL_NONE && f != intFormat) {
 613                fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
 614                fbo_incomplete("format mismatch", -1);
 615                return;
 616             }
 617          }
 618          if (att->Renderbuffer &&
 619              att->Renderbuffer->NumSamples != numSamples) {
 620             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
 621             fbo_incomplete("inconsistant number of samples", i);
 622             return;
 623          }
 624
 625       }
 626    }
 627
 628 #ifndef FEATURE_OES_framebuffer_object
 629    /* Check that all DrawBuffers are present */
 630    for (j = 0; j < ctx->Const.MaxDrawBuffers; j++) {
 631       if (fb->ColorDrawBuffer[j] != GL_NONE) {
 632          const struct gl_renderbuffer_attachment *att
 633             = _mesa_get_attachment(ctx, fb, fb->ColorDrawBuffer[j]);
 634          assert(att);
 635          if (att->Type == GL_NONE) {
 636             fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_EXT;
 637             fbo_incomplete("missing drawbuffer", j);
 638             return;
 639          }
 640       }
 641    }
 642
 643    /* Check that the ReadBuffer is present */
 644    if (fb->ColorReadBuffer != GL_NONE) {
 645       const struct gl_renderbuffer_attachment *att
 646          = _mesa_get_attachment(ctx, fb, fb->ColorReadBuffer);
 647       assert(att);
 648       if (att->Type == GL_NONE) {
 649          fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT;
 650             fbo_incomplete("missing readbuffer", -1);
 651          return;
 652       }
 653    }
 654 #else
 655    (void) j;
 656 #endif
 657
 658    if (numImages == 0) {
 659       fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT;
 660       fbo_incomplete("no attachments", -1);
 661       return;
 662    }
 663
 664    /* Provisionally set status = COMPLETE ... */
 665    fb->_Status = GL_FRAMEBUFFER_COMPLETE_EXT;
 666
 667    /* ... but the driver may say the FB is incomplete.
 668     * Drivers will most likely set the status to GL_FRAMEBUFFER_UNSUPPORTED
 669     * if anything.
 670     */
 671    if (ctx->Driver.ValidateFramebuffer) {
 672       ctx->Driver.ValidateFramebuffer(ctx, fb);
 673       if (fb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
 674          fbo_incomplete("driver marked FBO as incomplete", -1);
 675       }
 676    }
 677
 678    if (fb->_Status == GL_FRAMEBUFFER_COMPLETE_EXT) {
 679       /*
 680        * Note that if ARB_framebuffer_object is supported and the attached
 681        * renderbuffers/textures are different sizes, the framebuffer
 682        * width/height will be set to the smallest width/height.
 683        */
 684       fb->Width = minWidth;
 685       fb->Height = minHeight;
 686
 687       /* finally, update the visual info for the framebuffer */
 688       _mesa_update_framebuffer_visual(fb);
 689    }
 690 }
 691
 692
 693 GLboolean GLAPIENTRY
 694 _mesa_IsRenderbufferEXT(GLuint renderbuffer)
 695 {
 696    GET_CURRENT_CONTEXT(ctx);
 697    ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
 698    if (renderbuffer) {
 699       struct gl_renderbuffer *rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
 700       if (rb != NULL && rb != &DummyRenderbuffer)
 701          return GL_TRUE;
 702    }
 703    return GL_FALSE;
 704 }
 705
 706
 707 void GLAPIENTRY
 708 _mesa_BindRenderbufferEXT(GLenum target, GLuint renderbuffer)
 709 {
 710    struct gl_renderbuffer *newRb;
 711    GET_CURRENT_CONTEXT(ctx);
 712
 713    ASSERT_OUTSIDE_BEGIN_END(ctx);
 714
 715    if (target != GL_RENDERBUFFER_EXT) {
 716       _mesa_error(ctx, GL_INVALID_ENUM, "glBindRenderbufferEXT(target)");
 717       return;
 718    }
 719
 720    /* No need to flush here since the render buffer binding has no
 721     * effect on rendering state.
 722     */
 723
 724    if (renderbuffer) {
 725       newRb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
 726       if (newRb == &DummyRenderbuffer) {
 727          /* ID was reserved, but no real renderbuffer object made yet */
 728          newRb = NULL;
 729       }
 730       else if (!newRb && ctx->Extensions.ARB_framebuffer_object) {
 731          /* All RB IDs must be Gen'd */
 732          _mesa_error(ctx, GL_INVALID_OPERATION, "glBindRenderbuffer(buffer)");
 733          return;
 734       }
 735
 736       if (!newRb) {
 737          /* create new renderbuffer object */
 738          newRb = ctx->Driver.NewRenderbuffer(ctx, renderbuffer);
 739          if (!newRb) {
 740             _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindRenderbufferEXT");
 741             return;
 742          }
 743          ASSERT(newRb->AllocStorage);
 744          _mesa_HashInsert(ctx->Shared->RenderBuffers, renderbuffer, newRb);
 745          newRb->RefCount = 1; /* referenced by hash table */
 746       }
 747    }
 748    else {
 749       newRb = NULL;
 750    }
 751
 752    ASSERT(newRb != &DummyRenderbuffer);
 753
 754    _mesa_reference_renderbuffer(&ctx->CurrentRenderbuffer, newRb);
 755 }
 756
 757
 758 /**
 759  * If the given renderbuffer is anywhere attached to the framebuffer, detach
 760  * the renderbuffer.
 761  * This is used when a renderbuffer object is deleted.
 762  * The spec calls for unbinding.
 763  */
 764 static void
 765 detach_renderbuffer(GLcontext *ctx,
 766                     struct gl_framebuffer *fb,
 767                     struct gl_renderbuffer *rb)
 768 {
 769    GLuint i;
 770    for (i = 0; i < BUFFER_COUNT; i++) {
 771       if (fb->Attachment[i].Renderbuffer == rb) {
 772          _mesa_remove_attachment(ctx, &fb->Attachment[i]);
 773       }
 774    }
 775    invalidate_framebuffer(fb);
 776 }
 777
 778
 779 void GLAPIENTRY
 780 _mesa_DeleteRenderbuffersEXT(GLsizei n, const GLuint *renderbuffers)
 781 {
 782    GLint i;
 783    GET_CURRENT_CONTEXT(ctx);
 784
 785    ASSERT_OUTSIDE_BEGIN_END(ctx);
 786    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
 787
 788    for (i = 0; i < n; i++) {
 789       if (renderbuffers[i] > 0) {
 790          struct gl_renderbuffer *rb;
 791          rb = _mesa_lookup_renderbuffer(ctx, renderbuffers[i]);
 792          if (rb) {
 793             /* check if deleting currently bound renderbuffer object */
 794             if (rb == ctx->CurrentRenderbuffer) {
 795                /* bind default */
 796                ASSERT(rb->RefCount >= 2);
 797                _mesa_BindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0);
 798             }
 799
 800             if (ctx->DrawBuffer->Name) {
 801                detach_renderbuffer(ctx, ctx->DrawBuffer, rb);
 802             }
 803             if (ctx->ReadBuffer->Name && ctx->ReadBuffer != ctx->DrawBuffer) {
 804                detach_renderbuffer(ctx, ctx->ReadBuffer, rb);
 805             }
 806
 807             /* Remove from hash table immediately, to free the ID.
 808              * But the object will not be freed until it's no longer
 809              * referenced anywhere else.
 810              */
 811             _mesa_HashRemove(ctx->Shared->RenderBuffers, renderbuffers[i]);
 812
 813             if (rb != &DummyRenderbuffer) {
 814                /* no longer referenced by hash table */
 815                _mesa_reference_renderbuffer(&rb, NULL);
 816             }
 817          }
 818       }
 819    }
 820 }
 821
 822
 823 void GLAPIENTRY
 824 _mesa_GenRenderbuffersEXT(GLsizei n, GLuint *renderbuffers)
 825 {
 826    GET_CURRENT_CONTEXT(ctx);
 827    GLuint first;
 828    GLint i;
 829
 830    ASSERT_OUTSIDE_BEGIN_END(ctx);
 831
 832    if (n < 0) {
 833       _mesa_error(ctx, GL_INVALID_VALUE, "glGenRenderbuffersEXT(n)");
 834       return;
 835    }
 836
 837    if (!renderbuffers)
 838       return;
 839
 840    first = _mesa_HashFindFreeKeyBlock(ctx->Shared->RenderBuffers, n);
 841
 842    for (i = 0; i < n; i++) {
 843       GLuint name = first + i;
 844       renderbuffers[i] = name;
 845       /* insert dummy placeholder into hash table */
 846       _glthread_LOCK_MUTEX(ctx->Shared->Mutex);
 847       _mesa_HashInsert(ctx->Shared->RenderBuffers, name, &DummyRenderbuffer);
 848       _glthread_UNLOCK_MUTEX(ctx->Shared->Mutex);
 849    }
 850 }
 851
 852
 853 /**
 854  * Given an internal format token for a render buffer, return the
 855  * corresponding base format.
 856  * This is very similar to _mesa_base_tex_format() but the set of valid
 857  * internal formats is somewhat different.
 858  *
 859  * \return one of GL_RGB, GL_RGBA, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT
 860  *  GL_DEPTH_STENCIL_EXT or zero if error.
 861  *
 862  * XXX in the future when we support red-only and red-green formats
 863  * we'll also return GL_RED and GL_RG.
 864  */
 865 GLenum
 866 _mesa_base_fbo_format(GLcontext *ctx, GLenum internalFormat)
 867 {
 868    switch (internalFormat) {
 869    case GL_RGB:
 870    case GL_R3_G3_B2:
 871    case GL_RGB4:
 872    case GL_RGB5:
 873    case GL_RGB8:
 874    case GL_RGB10:
 875    case GL_RGB12:
 876    case GL_RGB16:
 877       return GL_RGB;
 878    case GL_RGBA:
 879    case GL_RGBA2:
 880    case GL_RGBA4:
 881    case GL_RGB5_A1:
 882    case GL_RGBA8:
 883    case GL_RGB10_A2:
 884    case GL_RGBA12:
 885    case GL_RGBA16:
 886       return GL_RGBA;
 887    case GL_STENCIL_INDEX:
 888    case GL_STENCIL_INDEX1_EXT:
 889    case GL_STENCIL_INDEX4_EXT:
 890    case GL_STENCIL_INDEX8_EXT:
 891    case GL_STENCIL_INDEX16_EXT:
 892       return GL_STENCIL_INDEX;
 893    case GL_DEPTH_COMPONENT:
 894    case GL_DEPTH_COMPONENT16:
 895    case GL_DEPTH_COMPONENT24:
 896    case GL_DEPTH_COMPONENT32:
 897       return GL_DEPTH_COMPONENT;
 898    case GL_DEPTH_STENCIL_EXT:
 899    case GL_DEPTH24_STENCIL8_EXT:
 900       if (ctx->Extensions.EXT_packed_depth_stencil)
 901          return GL_DEPTH_STENCIL_EXT;
 902       else
 903          return 0;
 904    /* XXX add floating point formats eventually */
 905    default:
 906       return 0;
 907    }
 908 }
 909
 910
 911 /** sentinal value, see below */
 912 #define NO_SAMPLES 1000
 913
 914
 915 /**
 916  * Helper function used by _mesa_RenderbufferStorageEXT() and
 917  * _mesa_RenderbufferStorageMultisample().
 918  * samples will be NO_SAMPLES if called by _mesa_RenderbufferStorageEXT().
 919  */
 920 static void
 921 renderbuffer_storage(GLenum target, GLenum internalFormat,
 922                      GLsizei width, GLsizei height, GLsizei samples)
 923 {
 924    const char *func = samples == NO_SAMPLES ?
 925       "glRenderbufferStorage" : "RenderbufferStorageMultisample";
 926    struct gl_renderbuffer *rb;
 927    GLenum baseFormat;
 928    GET_CURRENT_CONTEXT(ctx);
 929
 930    ASSERT_OUTSIDE_BEGIN_END(ctx);
 931
 932    if (target != GL_RENDERBUFFER_EXT) {
 933       _mesa_error(ctx, GL_INVALID_ENUM, "%s(target)", func);
 934       return;
 935    }
 936
 937    baseFormat = _mesa_base_fbo_format(ctx, internalFormat);
 938    if (baseFormat == 0) {
 939       _mesa_error(ctx, GL_INVALID_ENUM, "%s(internalFormat)", func);
 940       return;
 941    }
 942
 943    if (width < 1 || width > (GLsizei) ctx->Const.MaxRenderbufferSize) {
 944       _mesa_error(ctx, GL_INVALID_VALUE, "%s(width)", func);
 945       return;
 946    }
 947
 948    if (height < 1 || height > (GLsizei) ctx->Const.MaxRenderbufferSize) {
 949       _mesa_error(ctx, GL_INVALID_VALUE, "%s(height)", func);
 950       return;
 951    }
 952
 953    if (samples == NO_SAMPLES) {
 954       /* NumSamples == 0 indicates non-multisampling */
 955       samples = 0;
 956    }
 957    else if (samples > (GLsizei) ctx->Const.MaxSamples) {
 958       /* note: driver may choose to use more samples than what's requested */
 959       _mesa_error(ctx, GL_INVALID_VALUE, "%s(samples)", func);
 960       return;
 961    }
 962
 963    rb = ctx->CurrentRenderbuffer;
 964    if (!rb) {
 965       _mesa_error(ctx, GL_INVALID_OPERATION, func);
 966       return;
 967    }
 968
 969    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
 970
 971    if (rb->InternalFormat == internalFormat &&
 972        rb->Width == (GLuint) width &&
 973        rb->Height == (GLuint) height) {
 974       /* no change in allocation needed */
 975       return;
 976    }
 977
 978    /* These MUST get set by the AllocStorage func */
 979    rb->Format = MESA_FORMAT_NONE;
 980    rb->NumSamples = samples;
 981
 982    /* Now allocate the storage */
 983    ASSERT(rb->AllocStorage);
 984    if (rb->AllocStorage(ctx, rb, internalFormat, width, height)) {
 985       /* No error - check/set fields now */
 986       assert(rb->Format != MESA_FORMAT_NONE);
 987       assert(rb->Width == (GLuint) width);
 988       assert(rb->Height == (GLuint) height);
 989       rb->InternalFormat = internalFormat;
 990       rb->_BaseFormat = baseFormat;
 991       assert(rb->_BaseFormat != 0);
 992    }
 993    else {
 994       /* Probably ran out of memory - clear the fields */
 995       rb->Width = 0;
 996       rb->Height = 0;
 997       rb->Format = MESA_FORMAT_NONE;
 998       rb->InternalFormat = GL_NONE;
 999       rb->_BaseFormat = GL_NONE;
1000       rb->NumSamples = 0;
1001    }
1002
1003    /*
1004    test_framebuffer_completeness(ctx, fb);
1005    */
1006    /* XXX if this renderbuffer is attached anywhere, invalidate attachment
1007     * points???
1008     */
1009 }
1010
1011 #if FEATURE_OES_EGL_image
1012 void GLAPIENTRY
1013 _mesa_EGLImageTargetRenderbufferStorageOES (GLenum target, GLeglImageOES image)
1014 {
1015    struct gl_renderbuffer *rb;
1016    GET_CURRENT_CONTEXT(ctx);
1017    ASSERT_OUTSIDE_BEGIN_END(ctx);
1018
1019    if (target != GL_RENDERBUFFER) {
1020       _mesa_error(ctx, GL_INVALID_ENUM, "EGLImageTargetRenderbufferStorageOES");
1021       return;
1022    }
1023
1024    rb = ctx->CurrentRenderbuffer;
1025    if (!rb) {
1026       _mesa_error(ctx, GL_INVALID_OPERATION, "EGLImageTargetRenderbufferStorageOES");
1027       return;
1028    }
1029
1030    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1031
1032    ctx->Driver.EGLImageTargetRenderbufferStorage(ctx, rb, image);
1033 }
1034 #endif
1035
1036 /**
1037  * Helper function for _mesa_GetRenderbufferParameterivEXT() and
1038  * _mesa_GetFramebufferAttachmentParameterivEXT()
1039  * We have to be careful to respect the base format.  For example, if a
1040  * renderbuffer/texture was created with internalFormat=GL_RGB but the
1041  * driver actually chose a GL_RGBA format, when the user queries ALPHA_SIZE
1042  * we need to return zero.
1043  */
1044 static GLint
1045 get_component_bits(GLenum pname, GLenum baseFormat, gl_format format)
1046 {
1047    switch (pname) {
1048    case GL_RENDERBUFFER_RED_SIZE_EXT:
1049    case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
1050    case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1051    case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
1052    case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1053    case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
1054       if (baseFormat == GL_RGB || baseFormat == GL_RGBA)
1055          return _mesa_get_format_bits(format, pname);
1056       else
1057          return 0;
1058    case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1059    case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
1060       if (baseFormat == GL_RGBA || baseFormat == GL_ALPHA)
1061          return _mesa_get_format_bits(format, pname);
1062       else
1063          return 0;
1064    case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1065    case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
1066       if (baseFormat == GL_DEPTH_COMPONENT || baseFormat == GL_DEPTH_STENCIL)
1067          return _mesa_get_format_bits(format, pname);
1068       else
1069          return 0;
1070    case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1071    case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
1072       if (baseFormat == GL_STENCIL_INDEX || baseFormat == GL_DEPTH_STENCIL)
1073          return _mesa_get_format_bits(format, pname);
1074       else
1075          return 0;
1076    default:
1077       return 0;
1078    }
1079 }
1080
1081
1082
1083 void GLAPIENTRY
1084 _mesa_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
1085                              GLsizei width, GLsizei height)
1086 {
1087    /* GL_ARB_fbo says calling this function is equivalent to calling
1088     * glRenderbufferStorageMultisample() with samples=0.  We pass in
1089     * a token value here just for error reporting purposes.
1090     */
1091    renderbuffer_storage(target, internalFormat, width, height, NO_SAMPLES);
1092 }
1093
1094
1095 void GLAPIENTRY
1096 _mesa_RenderbufferStorageMultisample(GLenum target, GLsizei samples,
1097                                      GLenum internalFormat,
1098                                      GLsizei width, GLsizei height)
1099 {
1100    renderbuffer_storage(target, internalFormat, width, height, samples);
1101 }
1102
1103
1104
1105 void GLAPIENTRY
1106 _mesa_GetRenderbufferParameterivEXT(GLenum target, GLenum pname, GLint *params)
1107 {
1108    struct gl_renderbuffer *rb;
1109    GET_CURRENT_CONTEXT(ctx);
1110
1111    ASSERT_OUTSIDE_BEGIN_END(ctx);
1112
1113    if (target != GL_RENDERBUFFER_EXT) {
1114       _mesa_error(ctx, GL_INVALID_ENUM,
1115                   "glGetRenderbufferParameterivEXT(target)");
1116       return;
1117    }
1118
1119    rb = ctx->CurrentRenderbuffer;
1120    if (!rb) {
1121       _mesa_error(ctx, GL_INVALID_OPERATION,
1122                   "glGetRenderbufferParameterivEXT");
1123       return;
1124    }
1125
1126    /* No need to flush here since we're just quering state which is
1127     * not effected by rendering.
1128     */
1129
1130    switch (pname) {
1131    case GL_RENDERBUFFER_WIDTH_EXT:
1132       *params = rb->Width;
1133       return;
1134    case GL_RENDERBUFFER_HEIGHT_EXT:
1135       *params = rb->Height;
1136       return;
1137    case GL_RENDERBUFFER_INTERNAL_FORMAT_EXT:
1138       *params = rb->InternalFormat;
1139       return;
1140    case GL_RENDERBUFFER_RED_SIZE_EXT:
1141    case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1142    case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1143    case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1144    case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1145    case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1146       *params = get_component_bits(pname, rb->_BaseFormat, rb->Format);
1147       break;
1148    case GL_RENDERBUFFER_SAMPLES:
1149       if (ctx->Extensions.ARB_framebuffer_object) {
1150          *params = rb->NumSamples;
1151          break;
1152       }
1153       /* fallthrough */
1154    default:
1155       _mesa_error(ctx, GL_INVALID_ENUM,
1156                   "glGetRenderbufferParameterivEXT(target)");
1157       return;
1158    }
1159 }
1160
1161
1162 GLboolean GLAPIENTRY
1163 _mesa_IsFramebufferEXT(GLuint framebuffer)
1164 {
1165    GET_CURRENT_CONTEXT(ctx);
1166    ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
1167    if (framebuffer) {
1168       struct gl_framebuffer *rb = _mesa_lookup_framebuffer(ctx, framebuffer);
1169       if (rb != NULL && rb != &DummyFramebuffer)
1170          return GL_TRUE;
1171    }
1172    return GL_FALSE;
1173 }
1174
1175
1176 /**
1177  * Check if any of the attachments of the given framebuffer are textures
1178  * (render to texture).  Call ctx->Driver.RenderTexture() for such
1179  * attachments.
1180  */
1181 static void
1182 check_begin_texture_render(GLcontext *ctx, struct gl_framebuffer *fb)
1183 {
1184    GLuint i;
1185    ASSERT(ctx->Driver.RenderTexture);
1186
1187    if (fb->Name == 0)
1188       return; /* can't render to texture with winsys framebuffers */
1189
1190    for (i = 0; i < BUFFER_COUNT; i++) {
1191       struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1192       struct gl_texture_object *texObj = att->Texture;
1193       if (texObj
1194           && texObj->Image[att->CubeMapFace][att->TextureLevel]) {
1195          ctx->Driver.RenderTexture(ctx, fb, att);
1196       }
1197    }
1198 }
1199
1200
1201 /**
1202  * Examine all the framebuffer's attachments to see if any are textures.
1203  * If so, call ctx->Driver.FinishRenderTexture() for each texture to
1204  * notify the device driver that the texture image may have changed.
1205  */
1206 static void
1207 check_end_texture_render(GLcontext *ctx, struct gl_framebuffer *fb)
1208 {
1209    if (fb->Name == 0)
1210       return; /* can't render to texture with winsys framebuffers */
1211
1212    if (ctx->Driver.FinishRenderTexture) {
1213       GLuint i;
1214       for (i = 0; i < BUFFER_COUNT; i++) {
1215          struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1216          if (att->Texture && att->Renderbuffer) {
1217             ctx->Driver.FinishRenderTexture(ctx, att);
1218          }
1219       }
1220    }
1221 }
1222
1223
1224 void GLAPIENTRY
1225 _mesa_BindFramebufferEXT(GLenum target, GLuint framebuffer)
1226 {
1227    struct gl_framebuffer *newDrawFb, *newReadFb;
1228    struct gl_framebuffer *oldDrawFb, *oldReadFb;
1229    GLboolean bindReadBuf, bindDrawBuf;
1230    GET_CURRENT_CONTEXT(ctx);
1231
1232 #ifdef DEBUG
1233    if (ctx->Extensions.ARB_framebuffer_object) {
1234       ASSERT(ctx->Extensions.EXT_framebuffer_object);
1235       ASSERT(ctx->Extensions.EXT_framebuffer_blit);
1236    }
1237 #endif
1238
1239    ASSERT_OUTSIDE_BEGIN_END(ctx);
1240
1241    if (!ctx->Extensions.EXT_framebuffer_object) {
1242       _mesa_error(ctx, GL_INVALID_OPERATION,
1243                   "glBindFramebufferEXT(unsupported)");
1244       return;
1245    }
1246
1247    switch (target) {
1248 #if FEATURE_EXT_framebuffer_blit
1249    case GL_DRAW_FRAMEBUFFER_EXT:
1250       if (!ctx->Extensions.EXT_framebuffer_blit) {
1251          _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1252          return;
1253       }
1254       bindDrawBuf = GL_TRUE;
1255       bindReadBuf = GL_FALSE;
1256       break;
1257    case GL_READ_FRAMEBUFFER_EXT:
1258       if (!ctx->Extensions.EXT_framebuffer_blit) {
1259          _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1260          return;
1261       }
1262       bindDrawBuf = GL_FALSE;
1263       bindReadBuf = GL_TRUE;
1264       break;
1265 #endif
1266    case GL_FRAMEBUFFER_EXT:
1267       bindDrawBuf = GL_TRUE;
1268       bindReadBuf = GL_TRUE;
1269       break;
1270    default:
1271       _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1272       return;
1273    }
1274
1275    if (framebuffer) {
1276       /* Binding a user-created framebuffer object */
1277       newDrawFb = _mesa_lookup_framebuffer(ctx, framebuffer);
1278       if (newDrawFb == &DummyFramebuffer) {
1279          /* ID was reserved, but no real framebuffer object made yet */
1280          newDrawFb = NULL;
1281       }
1282       else if (!newDrawFb && ctx->Extensions.ARB_framebuffer_object) {
1283          /* All FBO IDs must be Gen'd */
1284          _mesa_error(ctx, GL_INVALID_OPERATION, "glBindFramebuffer(buffer)");
1285          return;
1286       }
1287
1288       if (!newDrawFb) {
1289          /* create new framebuffer object */
1290          newDrawFb = ctx->Driver.NewFramebuffer(ctx, framebuffer);
1291          if (!newDrawFb) {
1292             _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindFramebufferEXT");
1293             return;
1294          }
1295          _mesa_HashInsert(ctx->Shared->FrameBuffers, framebuffer, newDrawFb);
1296       }
1297       newReadFb = newDrawFb;
1298    }
1299    else {
1300       /* Binding the window system framebuffer (which was originally set
1301        * with MakeCurrent).
1302        */
1303       newDrawFb = ctx->WinSysDrawBuffer;
1304       newReadFb = ctx->WinSysReadBuffer;
1305    }
1306
1307    ASSERT(newDrawFb);
1308    ASSERT(newDrawFb != &DummyFramebuffer);
1309
1310    /* save pointers to current/old framebuffers */
1311    oldDrawFb = ctx->DrawBuffer;
1312    oldReadFb = ctx->ReadBuffer;
1313
1314    /* check if really changing bindings */
1315    if (oldDrawFb == newDrawFb)
1316       bindDrawBuf = GL_FALSE;
1317    if (oldReadFb == newReadFb)
1318       bindReadBuf = GL_FALSE;
1319
1320    /*
1321     * OK, now bind the new Draw/Read framebuffers, if they're changing.
1322     *
1323     * We also check if we're beginning and/or ending render-to-texture.
1324     * When a framebuffer with texture attachments is unbound, call
1325     * ctx->Driver.FinishRenderTexture().
1326     * When a framebuffer with texture attachments is bound, call
1327     * ctx->Driver.RenderTexture().
1328     *
1329     * Note that if the ReadBuffer has texture attachments we don't consider
1330     * that a render-to-texture case.
1331     */
1332    if (bindReadBuf) {
1333       FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1334
1335       /* check if old readbuffer was render-to-texture */
1336       check_end_texture_render(ctx, oldReadFb);
1337
1338       _mesa_reference_framebuffer(&ctx->ReadBuffer, newReadFb);
1339    }
1340
1341    if (bindDrawBuf) {
1342       FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1343
1344       /* check if old read/draw buffers were render-to-texture */
1345       if (!bindReadBuf)
1346          check_end_texture_render(ctx, oldReadFb);
1347
1348       if (oldDrawFb != oldReadFb)
1349          check_end_texture_render(ctx, oldDrawFb);
1350
1351       /* check if newly bound framebuffer has any texture attachments */
1352       check_begin_texture_render(ctx, newDrawFb);
1353
1354       _mesa_reference_framebuffer(&ctx->DrawBuffer, newDrawFb);
1355    }
1356
1357    if ((bindDrawBuf || bindReadBuf) && ctx->Driver.BindFramebuffer) {
1358       ctx->Driver.BindFramebuffer(ctx, target, newDrawFb, newReadFb);
1359    }
1360 }
1361
1362
1363 void GLAPIENTRY
1364 _mesa_DeleteFramebuffersEXT(GLsizei n, const GLuint *framebuffers)
1365 {
1366    GLint i;
1367    GET_CURRENT_CONTEXT(ctx);
1368
1369    ASSERT_OUTSIDE_BEGIN_END(ctx);
1370    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1371
1372    for (i = 0; i < n; i++) {
1373       if (framebuffers[i] > 0) {
1374          struct gl_framebuffer *fb;
1375          fb = _mesa_lookup_framebuffer(ctx, framebuffers[i]);
1376          if (fb) {
1377             ASSERT(fb == &DummyFramebuffer || fb->Name == framebuffers[i]);
1378
1379             /* check if deleting currently bound framebuffer object */
1380             if (ctx->Extensions.EXT_framebuffer_blit) {
1381                /* separate draw/read binding points */
1382                if (fb == ctx->DrawBuffer) {
1383                   /* bind default */
1384                   ASSERT(fb->RefCount >= 2);
1385                   _mesa_BindFramebufferEXT(GL_DRAW_FRAMEBUFFER_EXT, 0);
1386                }
1387                if (fb == ctx->ReadBuffer) {
1388                   /* bind default */
1389                   ASSERT(fb->RefCount >= 2);
1390                   _mesa_BindFramebufferEXT(GL_READ_FRAMEBUFFER_EXT, 0);
1391                }
1392             }
1393             else {
1394                /* only one binding point for read/draw buffers */
1395                if (fb == ctx->DrawBuffer || fb == ctx->ReadBuffer) {
1396                   /* bind default */
1397                   ASSERT(fb->RefCount >= 2);
1398                   _mesa_BindFramebufferEXT(GL_FRAMEBUFFER_EXT, 0);
1399                }
1400             }
1401
1402             /* remove from hash table immediately, to free the ID */
1403             _mesa_HashRemove(ctx->Shared->FrameBuffers, framebuffers[i]);
1404
1405             if (fb != &DummyFramebuffer) {
1406                /* But the object will not be freed until it's no longer
1407                 * bound in any context.
1408                 */
1409                _mesa_reference_framebuffer(&fb, NULL);
1410             }
1411          }
1412       }
1413    }
1414 }
1415
1416
1417 void GLAPIENTRY
1418 _mesa_GenFramebuffersEXT(GLsizei n, GLuint *framebuffers)
1419 {
1420    GET_CURRENT_CONTEXT(ctx);
1421    GLuint first;
1422    GLint i;
1423
1424    ASSERT_OUTSIDE_BEGIN_END(ctx);
1425
1426    if (n < 0) {
1427       _mesa_error(ctx, GL_INVALID_VALUE, "glGenFramebuffersEXT(n)");
1428       return;
1429    }
1430
1431    if (!framebuffers)
1432       return;
1433
1434    first = _mesa_HashFindFreeKeyBlock(ctx->Shared->FrameBuffers, n);
1435
1436    for (i = 0; i < n; i++) {
1437       GLuint name = first + i;
1438       framebuffers[i] = name;
1439       /* insert dummy placeholder into hash table */
1440       _glthread_LOCK_MUTEX(ctx->Shared->Mutex);
1441       _mesa_HashInsert(ctx->Shared->FrameBuffers, name, &DummyFramebuffer);
1442       _glthread_UNLOCK_MUTEX(ctx->Shared->Mutex);
1443    }
1444 }
1445
1446
1447
1448 GLenum GLAPIENTRY
1449 _mesa_CheckFramebufferStatusEXT(GLenum target)
1450 {
1451    struct gl_framebuffer *buffer;
1452    GET_CURRENT_CONTEXT(ctx);
1453
1454    ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, 0);
1455
1456    switch (target) {
1457 #if FEATURE_EXT_framebuffer_blit
1458    case GL_DRAW_FRAMEBUFFER_EXT:
1459       if (!ctx->Extensions.EXT_framebuffer_blit) {
1460          _mesa_error(ctx, GL_INVALID_ENUM, "glCheckFramebufferStatus(target)");
1461          return 0;
1462       }
1463       buffer = ctx->DrawBuffer;
1464       break;
1465    case GL_READ_FRAMEBUFFER_EXT:
1466       if (!ctx->Extensions.EXT_framebuffer_blit) {
1467          _mesa_error(ctx, GL_INVALID_ENUM, "glCheckFramebufferStatus(target)");
1468          return 0;
1469       }
1470       buffer = ctx->ReadBuffer;
1471       break;
1472 #endif
1473    case GL_FRAMEBUFFER_EXT:
1474       buffer = ctx->DrawBuffer;
1475       break;
1476    default:
1477       _mesa_error(ctx, GL_INVALID_ENUM, "glCheckFramebufferStatus(target)");
1478       return 0; /* formerly GL_FRAMEBUFFER_STATUS_ERROR_EXT */
1479    }
1480
1481    if (buffer->Name == 0) {
1482       /* The window system / default framebuffer is always complete */
1483       return GL_FRAMEBUFFER_COMPLETE_EXT;
1484    }
1485
1486    /* No need to flush here */
1487
1488    if (buffer->_Status != GL_FRAMEBUFFER_COMPLETE) {
1489       _mesa_test_framebuffer_completeness(ctx, buffer);
1490    }
1491
1492    return buffer->_Status;
1493 }
1494
1495
1496
1497 /**
1498  * Common code called by glFramebufferTexture1D/2D/3DEXT().
1499  */
1500 static void
1501 framebuffer_texture(GLcontext *ctx, const char *caller, GLenum target,
1502                     GLenum attachment, GLenum textarget, GLuint texture,
1503                     GLint level, GLint zoffset)
1504 {
1505    struct gl_renderbuffer_attachment *att;
1506    struct gl_texture_object *texObj = NULL;
1507    struct gl_framebuffer *fb;
1508    GLboolean error = GL_FALSE;
1509
1510    ASSERT_OUTSIDE_BEGIN_END(ctx);
1511
1512    switch (target) {
1513    case GL_READ_FRAMEBUFFER_EXT:
1514       error = !ctx->Extensions.EXT_framebuffer_blit;
1515       fb = ctx->ReadBuffer;
1516       break;
1517    case GL_DRAW_FRAMEBUFFER_EXT:
1518       error = !ctx->Extensions.EXT_framebuffer_blit;
1519       /* fall-through */
1520    case GL_FRAMEBUFFER_EXT:
1521       fb = ctx->DrawBuffer;
1522       break;
1523    default:
1524       error = GL_TRUE;
1525    }
1526
1527    if (error) {
1528       _mesa_error(ctx, GL_INVALID_ENUM,
1529                   "glFramebufferTexture%sEXT(target=0x%x)", caller, target);
1530       return;
1531    }
1532
1533    ASSERT(fb);
1534
1535    /* check framebuffer binding */
1536    if (fb->Name == 0) {
1537       _mesa_error(ctx, GL_INVALID_OPERATION,
1538                   "glFramebufferTexture%sEXT", caller);
1539       return;
1540    }
1541
1542
1543    /* The textarget, level, and zoffset parameters are only validated if
1544     * texture is non-zero.
1545     */
1546    if (texture) {
1547       GLboolean err = GL_TRUE;
1548
1549       texObj = _mesa_lookup_texture(ctx, texture);
1550       if (texObj != NULL) {
1551          if (textarget == 0) {
1552             err = (texObj->Target != GL_TEXTURE_3D) &&
1553                 (texObj->Target != GL_TEXTURE_1D_ARRAY_EXT) &&
1554                 (texObj->Target != GL_TEXTURE_2D_ARRAY_EXT);
1555          }
1556          else {
1557             err = (texObj->Target == GL_TEXTURE_CUBE_MAP)
1558                 ? !IS_CUBE_FACE(textarget)
1559                 : (texObj->Target != textarget);
1560          }
1561       }
1562
1563       if (err) {
1564          _mesa_error(ctx, GL_INVALID_OPERATION,
1565                      "glFramebufferTexture%sEXT(texture target mismatch)",
1566                      caller);
1567          return;
1568       }
1569
1570       if (texObj->Target == GL_TEXTURE_3D) {
1571          const GLint maxSize = 1 << (ctx->Const.Max3DTextureLevels - 1);
1572          if (zoffset < 0 || zoffset >= maxSize) {
1573             _mesa_error(ctx, GL_INVALID_VALUE,
1574                         "glFramebufferTexture%sEXT(zoffset)", caller);
1575             return;
1576          }
1577       }
1578       else if ((texObj->Target == GL_TEXTURE_1D_ARRAY_EXT) ||
1579                (texObj->Target == GL_TEXTURE_2D_ARRAY_EXT)) {
1580          if (zoffset < 0 || zoffset >= ctx->Const.MaxArrayTextureLayers) {
1581             _mesa_error(ctx, GL_INVALID_VALUE,
1582                         "glFramebufferTexture%sEXT(layer)", caller);
1583             return;
1584          }
1585       }
1586
1587       if ((level < 0) ||
1588           (level >= _mesa_max_texture_levels(ctx, texObj->Target))) {
1589          _mesa_error(ctx, GL_INVALID_VALUE,
1590                      "glFramebufferTexture%sEXT(level)", caller);
1591          return;
1592       }
1593    }
1594
1595    att = _mesa_get_attachment(ctx, fb, attachment);
1596    if (att == NULL) {
1597       _mesa_error(ctx, GL_INVALID_ENUM,
1598                   "glFramebufferTexture%sEXT(attachment)", caller);
1599       return;
1600    }
1601
1602    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1603
1604    _glthread_LOCK_MUTEX(fb->Mutex);
1605    if (texObj) {
1606       _mesa_set_texture_attachment(ctx, fb, att, texObj, textarget,
1607                                    level, zoffset);
1608       /* Set the render-to-texture flag.  We'll check this flag in
1609        * glTexImage() and friends to determine if we need to revalidate
1610        * any FBOs that might be rendering into this texture.
1611        * This flag never gets cleared since it's non-trivial to determine
1612        * when all FBOs might be done rendering to this texture.  That's OK
1613        * though since it's uncommon to render to a texture then repeatedly
1614        * call glTexImage() to change images in the texture.
1615        */
1616       texObj->_RenderToTexture = GL_TRUE;
1617    }
1618    else {
1619       _mesa_remove_attachment(ctx, att);
1620    }
1621
1622    invalidate_framebuffer(fb);
1623
1624    _glthread_UNLOCK_MUTEX(fb->Mutex);
1625 }
1626
1627
1628
1629 void GLAPIENTRY
1630 _mesa_FramebufferTexture1DEXT(GLenum target, GLenum attachment,
1631                               GLenum textarget, GLuint texture, GLint level)
1632 {
1633    GET_CURRENT_CONTEXT(ctx);
1634
1635    if ((texture != 0) && (textarget != GL_TEXTURE_1D)) {
1636       _mesa_error(ctx, GL_INVALID_ENUM,
1637                   "glFramebufferTexture1DEXT(textarget)");
1638       return;
1639    }
1640
1641    framebuffer_texture(ctx, "1D", target, attachment, textarget, texture,
1642                        level, 0);
1643 }
1644
1645
1646 void GLAPIENTRY
1647 _mesa_FramebufferTexture2DEXT(GLenum target, GLenum attachment,
1648                               GLenum textarget, GLuint texture, GLint level)
1649 {
1650    GET_CURRENT_CONTEXT(ctx);
1651
1652    if ((texture != 0) &&
1653        (textarget != GL_TEXTURE_2D) &&
1654        (textarget != GL_TEXTURE_RECTANGLE_ARB) &&
1655        (!IS_CUBE_FACE(textarget))) {
1656       _mesa_error(ctx, GL_INVALID_OPERATION,
1657                   "glFramebufferTexture2DEXT(textarget=0x%x)", textarget);
1658       return;
1659    }
1660
1661    framebuffer_texture(ctx, "2D", target, attachment, textarget, texture,
1662                        level, 0);
1663 }
1664
1665
1666 void GLAPIENTRY
1667 _mesa_FramebufferTexture3DEXT(GLenum target, GLenum attachment,
1668                               GLenum textarget, GLuint texture,
1669                               GLint level, GLint zoffset)
1670 {
1671    GET_CURRENT_CONTEXT(ctx);
1672
1673    if ((texture != 0) && (textarget != GL_TEXTURE_3D)) {
1674       _mesa_error(ctx, GL_INVALID_ENUM,
1675                   "glFramebufferTexture3DEXT(textarget)");
1676       return;
1677    }
1678
1679    framebuffer_texture(ctx, "3D", target, attachment, textarget, texture,
1680                        level, zoffset);
1681 }
1682
1683
1684 void GLAPIENTRY
1685 _mesa_FramebufferTextureLayerEXT(GLenum target, GLenum attachment,
1686                                  GLuint texture, GLint level, GLint layer)
1687 {
1688    GET_CURRENT_CONTEXT(ctx);
1689
1690    framebuffer_texture(ctx, "Layer", target, attachment, 0, texture,
1691                        level, layer);
1692 }
1693
1694
1695 void GLAPIENTRY
1696 _mesa_FramebufferRenderbufferEXT(GLenum target, GLenum attachment,
1697                                  GLenum renderbufferTarget,
1698                                  GLuint renderbuffer)
1699 {
1700    struct gl_renderbuffer_attachment *att;
1701    struct gl_framebuffer *fb;
1702    struct gl_renderbuffer *rb;
1703    GET_CURRENT_CONTEXT(ctx);
1704
1705    ASSERT_OUTSIDE_BEGIN_END(ctx);
1706
1707    switch (target) {
1708 #if FEATURE_EXT_framebuffer_blit
1709    case GL_DRAW_FRAMEBUFFER_EXT:
1710       if (!ctx->Extensions.EXT_framebuffer_blit) {
1711          _mesa_error(ctx, GL_INVALID_ENUM,
1712                      "glFramebufferRenderbufferEXT(target)");
1713          return;
1714       }
1715       fb = ctx->DrawBuffer;
1716       break;
1717    case GL_READ_FRAMEBUFFER_EXT:
1718       if (!ctx->Extensions.EXT_framebuffer_blit) {
1719          _mesa_error(ctx, GL_INVALID_ENUM,
1720                      "glFramebufferRenderbufferEXT(target)");
1721          return;
1722       }
1723       fb = ctx->ReadBuffer;
1724       break;
1725 #endif
1726    case GL_FRAMEBUFFER_EXT:
1727       fb = ctx->DrawBuffer;
1728       break;
1729    default:
1730       _mesa_error(ctx, GL_INVALID_ENUM,
1731                   "glFramebufferRenderbufferEXT(target)");
1732       return;
1733    }
1734
1735    if (renderbufferTarget != GL_RENDERBUFFER_EXT) {
1736       _mesa_error(ctx, GL_INVALID_ENUM,
1737                   "glFramebufferRenderbufferEXT(renderbufferTarget)");
1738       return;
1739    }
1740
1741    if (fb->Name == 0) {
1742       /* Can't attach new renderbuffers to a window system framebuffer */
1743       _mesa_error(ctx, GL_INVALID_OPERATION, "glFramebufferRenderbufferEXT");
1744       return;
1745    }
1746
1747    att = _mesa_get_attachment(ctx, fb, attachment);
1748    if (att == NULL) {
1749       _mesa_error(ctx, GL_INVALID_ENUM,
1750                   "glFramebufferRenderbufferEXT(invalid attachment %s)",
1751                   _mesa_lookup_enum_by_nr(attachment));
1752       return;
1753    }
1754
1755    if (renderbuffer) {
1756       rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
1757       if (!rb) {
1758          _mesa_error(ctx, GL_INVALID_OPERATION,
1759                      "glFramebufferRenderbufferEXT(non-existant"
1760                      " renderbuffer %u)", renderbuffer);
1761          return;
1762       }
1763    }
1764    else {
1765       /* remove renderbuffer attachment */
1766       rb = NULL;
1767    }
1768
1769    if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
1770       /* make sure the renderbuffer is a depth/stencil format */
1771       const GLenum baseFormat =
1772          _mesa_get_format_base_format(att->Renderbuffer->Format);
1773       if (baseFormat != GL_DEPTH_STENCIL) {
1774          _mesa_error(ctx, GL_INVALID_OPERATION,
1775                      "glFramebufferRenderbufferEXT(renderbuffer"
1776                      " is not DEPTH_STENCIL format)");
1777          return;
1778       }
1779    }
1780
1781
1782    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1783
1784    assert(ctx->Driver.FramebufferRenderbuffer);
1785    ctx->Driver.FramebufferRenderbuffer(ctx, fb, attachment, rb);
1786
1787    /* Some subsequent GL commands may depend on the framebuffer's visual
1788     * after the binding is updated.  Update visual info now.
1789     */
1790    _mesa_update_framebuffer_visual(fb);
1791 }
1792
1793
1794 void GLAPIENTRY
1795 _mesa_GetFramebufferAttachmentParameterivEXT(GLenum target, GLenum attachment,
1796                                              GLenum pname, GLint *params)
1797 {
1798    const struct gl_renderbuffer_attachment *att;
1799    struct gl_framebuffer *buffer;
1800    GET_CURRENT_CONTEXT(ctx);
1801
1802    ASSERT_OUTSIDE_BEGIN_END(ctx);
1803
1804    switch (target) {
1805 #if FEATURE_EXT_framebuffer_blit
1806    case GL_DRAW_FRAMEBUFFER_EXT:
1807       if (!ctx->Extensions.EXT_framebuffer_blit) {
1808          _mesa_error(ctx, GL_INVALID_ENUM,
1809                      "glGetFramebufferAttachmentParameterivEXT(target)");
1810          return;
1811       }
1812       buffer = ctx->DrawBuffer;
1813       break;
1814    case GL_READ_FRAMEBUFFER_EXT:
1815       if (!ctx->Extensions.EXT_framebuffer_blit) {
1816          _mesa_error(ctx, GL_INVALID_ENUM,
1817                      "glGetFramebufferAttachmentParameterivEXT(target)");
1818          return;
1819       }
1820       buffer = ctx->ReadBuffer;
1821       break;
1822 #endif
1823    case GL_FRAMEBUFFER_EXT:
1824       buffer = ctx->DrawBuffer;
1825       break;
1826    default:
1827       _mesa_error(ctx, GL_INVALID_ENUM,
1828                   "glGetFramebufferAttachmentParameterivEXT(target)");
1829       return;
1830    }
1831
1832    if (buffer->Name == 0) {
1833       _mesa_error(ctx, GL_INVALID_OPERATION,
1834                   "glGetFramebufferAttachmentParameterivEXT");
1835       return;
1836    }
1837
1838    att = _mesa_get_attachment(ctx, buffer, attachment);
1839    if (att == NULL) {
1840       _mesa_error(ctx, GL_INVALID_ENUM,
1841                   "glGetFramebufferAttachmentParameterivEXT(attachment)");
1842       return;
1843    }
1844
1845    if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
1846       /* the depth and stencil attachments must point to the same buffer */
1847       const struct gl_renderbuffer_attachment *depthAtt, *stencilAtt;
1848       depthAtt = _mesa_get_attachment(ctx, buffer, GL_DEPTH_ATTACHMENT);
1849       stencilAtt = _mesa_get_attachment(ctx, buffer, GL_STENCIL_ATTACHMENT);
1850       if (depthAtt->Renderbuffer != stencilAtt->Renderbuffer) {
1851          _mesa_error(ctx, GL_INVALID_OPERATION,
1852                      "glGetFramebufferAttachmentParameterivEXT(DEPTH/STENCIL"
1853                      " attachments differ)");
1854          return;
1855       }
1856    }
1857
1858    /* No need to flush here */
1859
1860    switch (pname) {
1861    case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_EXT:
1862       *params = att->Type;
1863       return;
1864    case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_EXT:
1865       if (att->Type == GL_RENDERBUFFER_EXT) {
1866          *params = att->Renderbuffer->Name;
1867       }
1868       else if (att->Type == GL_TEXTURE) {
1869          *params = att->Texture->Name;
1870       }
1871       else {
1872          _mesa_error(ctx, GL_INVALID_ENUM,
1873                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1874       }
1875       return;
1876    case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_EXT:
1877       if (att->Type == GL_TEXTURE) {
1878          *params = att->TextureLevel;
1879       }
1880       else {
1881          _mesa_error(ctx, GL_INVALID_ENUM,
1882                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1883       }
1884       return;
1885    case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_EXT:
1886       if (att->Type == GL_TEXTURE) {
1887          if (att->Texture && att->Texture->Target == GL_TEXTURE_CUBE_MAP) {
1888             *params = GL_TEXTURE_CUBE_MAP_POSITIVE_X + att->CubeMapFace;
1889          }
1890          else {
1891             *params = 0;
1892          }
1893       }
1894       else {
1895          _mesa_error(ctx, GL_INVALID_ENUM,
1896                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1897       }
1898       return;
1899    case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_3D_ZOFFSET_EXT:
1900       if (att->Type == GL_TEXTURE) {
1901          if (att->Texture && att->Texture->Target == GL_TEXTURE_3D) {
1902             *params = att->Zoffset;
1903          }
1904          else {
1905             *params = 0;
1906          }
1907       }
1908       else {
1909          _mesa_error(ctx, GL_INVALID_ENUM,
1910                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1911       }
1912       return;
1913    case GL_FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING:
1914       if (!ctx->Extensions.ARB_framebuffer_object) {
1915          _mesa_error(ctx, GL_INVALID_ENUM,
1916                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1917       }
1918       else {
1919          *params = _mesa_get_format_color_encoding(att->Renderbuffer->Format);
1920       }
1921       return;
1922    case GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE:
1923       if (!ctx->Extensions.ARB_framebuffer_object) {
1924          _mesa_error(ctx, GL_INVALID_ENUM,
1925                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1926          return;
1927       }
1928       else {
1929          gl_format format = att->Renderbuffer->Format;
1930          if (format == MESA_FORMAT_CI8 || format == MESA_FORMAT_S8) {
1931             /* special cases */
1932             *params = GL_INDEX;
1933          }
1934          else {
1935             *params = _mesa_get_format_datatype(format);
1936          }
1937       }
1938       return;
1939    case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
1940    case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
1941    case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
1942    case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
1943    case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
1944    case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
1945       if (!ctx->Extensions.ARB_framebuffer_object) {
1946          _mesa_error(ctx, GL_INVALID_ENUM,
1947                      "glGetFramebufferAttachmentParameterivEXT(pname)");
1948       }
1949       else if (att->Texture) {
1950          const struct gl_texture_image *texImage =
1951             _mesa_select_tex_image(ctx, att->Texture, att->Texture->Target,
1952                                    att->TextureLevel);
1953          if (texImage) {
1954             *params = get_component_bits(pname, texImage->_BaseFormat,
1955                                          texImage->TexFormat);
1956          }
1957          else {
1958             *params = 0;
1959          }
1960       }
1961       else if (att->Renderbuffer) {
1962          *params = get_component_bits(pname, att->Renderbuffer->_BaseFormat,
1963                                       att->Renderbuffer->Format);
1964       }
1965       else {
1966          *params = 0;
1967       }
1968       return;
1969    default:
1970       _mesa_error(ctx, GL_INVALID_ENUM,
1971                   "glGetFramebufferAttachmentParameterivEXT(pname)");
1972       return;
1973    }
1974 }
1975
1976
1977 void GLAPIENTRY
1978 _mesa_GenerateMipmapEXT(GLenum target)
1979 {
1980    struct gl_texture_object *texObj;
1981    GET_CURRENT_CONTEXT(ctx);
1982
1983    ASSERT_OUTSIDE_BEGIN_END(ctx);
1984    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1985
1986    switch (target) {
1987    case GL_TEXTURE_1D:
1988    case GL_TEXTURE_2D:
1989    case GL_TEXTURE_3D:
1990    case GL_TEXTURE_CUBE_MAP:
1991       /* OK, legal value */
1992       break;
1993    default:
1994       _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateMipmapEXT(target)");
1995       return;
1996    }
1997
1998    texObj = _mesa_get_current_tex_object(ctx, target);
1999
2000    if (texObj->BaseLevel >= texObj->MaxLevel) {
2001       /* nothing to do */
2002       return;
2003    }
2004
2005    _mesa_lock_texture(ctx, texObj);
2006    if (target == GL_TEXTURE_CUBE_MAP) {
2007       GLuint face;
2008       for (face = 0; face < 6; face++)
2009          ctx->Driver.GenerateMipmap(ctx,
2010                                     GL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB + face,
2011                                     texObj);
2012    }
2013    else {
2014       ctx->Driver.GenerateMipmap(ctx, target, texObj);
2015    }
2016    _mesa_unlock_texture(ctx, texObj);
2017 }
2018
2019
2020 #if FEATURE_EXT_framebuffer_blit
2021
2022 static const struct gl_renderbuffer_attachment *
2023 find_attachment(const struct gl_framebuffer *fb, const struct gl_renderbuffer *rb)
2024 {
2025    GLuint i;
2026    for (i = 0; i < Elements(fb->Attachment); i++) {
2027       if (fb->Attachment[i].Renderbuffer == rb)
2028          return &fb->Attachment[i];
2029    }
2030    return NULL;
2031 }
2032
2033
2034
2035 /**
2036  * Blit rectangular region, optionally from one framebuffer to another.
2037  *
2038  * Note, if the src buffer is multisampled and the dest is not, this is
2039  * when the samples must be resolved to a single color.
2040  */
2041 void GLAPIENTRY
2042 _mesa_BlitFramebufferEXT(GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
2043                          GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
2044                          GLbitfield mask, GLenum filter)
2045 {
2046    const GLbitfield legalMaskBits = (GL_COLOR_BUFFER_BIT |
2047                                      GL_DEPTH_BUFFER_BIT |
2048                                      GL_STENCIL_BUFFER_BIT);
2049    const struct gl_framebuffer *readFb, *drawFb;
2050    const struct gl_renderbuffer *colorReadRb, *colorDrawRb;
2051    GET_CURRENT_CONTEXT(ctx);
2052
2053    ASSERT_OUTSIDE_BEGIN_END(ctx);
2054    FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2055
2056    if (ctx->NewState) {
2057       _mesa_update_state(ctx);
2058    }
2059
2060    readFb = ctx->ReadBuffer;
2061    drawFb = ctx->DrawBuffer;
2062
2063    if (!readFb || !drawFb) {
2064       /* This will normally never happen but someday we may want to
2065        * support MakeCurrent() with no drawables.
2066        */
2067       return;
2068    }
2069
2070    /* check for complete framebuffers */
2071    if (drawFb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT ||
2072        readFb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
2073       _mesa_error(ctx, GL_INVALID_FRAMEBUFFER_OPERATION_EXT,
2074                   "glBlitFramebufferEXT(incomplete draw/read buffers)");
2075       return;
2076    }
2077
2078    if (filter != GL_NEAREST && filter != GL_LINEAR) {
2079       _mesa_error(ctx, GL_INVALID_ENUM, "glBlitFramebufferEXT(filter)");
2080       return;
2081    }
2082
2083    if (mask & ~legalMaskBits) {
2084       _mesa_error( ctx, GL_INVALID_VALUE, "glBlitFramebufferEXT(mask)");
2085       return;
2086    }
2087
2088    /* depth/stencil must be blitted with nearest filtering */
2089    if ((mask & (GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT))
2090         && filter != GL_NEAREST) {
2091       _mesa_error(ctx, GL_INVALID_OPERATION,
2092              "glBlitFramebufferEXT(depth/stencil requires GL_NEAREST filter");
2093       return;
2094    }
2095
2096    /* get color read/draw renderbuffers */
2097    if (mask & GL_COLOR_BUFFER_BIT) {
2098       colorReadRb = readFb->_ColorReadBuffer;
2099       colorDrawRb = drawFb->_ColorDrawBuffers[0];
2100    }
2101    else {
2102       colorReadRb = colorDrawRb = NULL;
2103    }
2104
2105    if (mask & GL_STENCIL_BUFFER_BIT) {
2106       struct gl_renderbuffer *readRb = readFb->_StencilBuffer;
2107       struct gl_renderbuffer *drawRb = drawFb->_StencilBuffer;
2108       if (!readRb ||
2109           !drawRb ||
2110           _mesa_get_format_bits(readRb->Format, GL_STENCIL_BITS) !=
2111           _mesa_get_format_bits(drawRb->Format, GL_STENCIL_BITS)) {
2112          _mesa_error(ctx, GL_INVALID_OPERATION,
2113                      "glBlitFramebufferEXT(stencil buffer size mismatch");
2114          return;
2115       }
2116    }
2117
2118    if (mask & GL_DEPTH_BUFFER_BIT) {
2119       struct gl_renderbuffer *readRb = readFb->_DepthBuffer;
2120       struct gl_renderbuffer *drawRb = drawFb->_DepthBuffer;
2121       if (!readRb ||
2122           !drawRb ||
2123           _mesa_get_format_bits(readRb->Format, GL_DEPTH_BITS) !=
2124           _mesa_get_format_bits(drawRb->Format, GL_DEPTH_BITS)) {
2125          _mesa_error(ctx, GL_INVALID_OPERATION,
2126                      "glBlitFramebufferEXT(depth buffer size mismatch");
2127          return;
2128       }
2129    }
2130
2131    if (readFb->Visual.samples > 0 &&
2132        drawFb->Visual.samples > 0 &&
2133        readFb->Visual.samples != drawFb->Visual.samples) {
2134       _mesa_error(ctx, GL_INVALID_OPERATION,
2135                   "glBlitFramebufferEXT(mismatched samples");
2136       return;
2137    }
2138
2139    /* extra checks for multisample copies... */
2140    if (readFb->Visual.samples > 0 || drawFb->Visual.samples > 0) {
2141       /* src and dest region sizes must be the same */
2142       if (srcX1 - srcX0 != dstX1 - dstX0 ||
2143           srcY1 - srcY0 != dstY1 - dstY0) {
2144          _mesa_error(ctx, GL_INVALID_OPERATION,
2145                 "glBlitFramebufferEXT(bad src/dst multisample region sizes");
2146          return;
2147       }
2148
2149       /* color formats must match */
2150       if (colorReadRb &&
2151           colorDrawRb &&
2152           colorReadRb->Format != colorDrawRb->Format) {
2153          _mesa_error(ctx, GL_INVALID_OPERATION,
2154                 "glBlitFramebufferEXT(bad src/dst multisample pixel formats");
2155          return;
2156       }
2157    }
2158
2159    if (!ctx->Extensions.EXT_framebuffer_blit) {
2160       _mesa_error(ctx, GL_INVALID_OPERATION, "glBlitFramebufferEXT");
2161       return;
2162    }
2163
2164    /* Debug code */
2165    if (DEBUG_BLIT) {
2166       printf("glBlitFramebuffer(%d, %d, %d, %d,  %d, %d, %d, %d,"
2167              " 0x%x, 0x%x)\n",
2168              srcX0, srcY0, srcX1, srcY1,
2169              dstX0, dstY0, dstX1, dstY1,
2170              mask, filter);
2171       if (colorReadRb) {
2172          const struct gl_renderbuffer_attachment *att;
2173
2174          att = find_attachment(readFb, colorReadRb);
2175          printf("  Src FBO %u  RB %u (%dx%d)  ",
2176                 readFb->Name, colorReadRb->Name,
2177                 colorReadRb->Width, colorReadRb->Height);
2178          if (att && att->Texture) {
2179             printf("Tex %u  tgt 0x%x  level %u  face %u",
2180                    att->Texture->Name,
2181                    att->Texture->Target,
2182                    att->TextureLevel,
2183                    att->CubeMapFace);
2184          }
2185          printf("\n");
2186
2187          att = find_attachment(drawFb, colorDrawRb);
2188          printf("  Dst FBO %u  RB %u (%dx%d)  ",
2189                 drawFb->Name, colorDrawRb->Name,
2190                 colorDrawRb->Width, colorDrawRb->Height);
2191          if (att && att->Texture) {
2192             printf("Tex %u  tgt 0x%x  level %u  face %u",
2193                    att->Texture->Name,
2194                    att->Texture->Target,
2195                    att->TextureLevel,
2196                    att->CubeMapFace);
2197          }
2198          printf("\n");
2199       }
2200    }
2201
2202    ASSERT(ctx->Driver.BlitFramebuffer);
2203    ctx->Driver.BlitFramebuffer(ctx,
2204                                srcX0, srcY0, srcX1, srcY1,
2205                                dstX0, dstY0, dstX1, dstY1,
2206                                mask, filter);
2207 }
2208 #endif /* FEATURE_EXT_framebuffer_blit */