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