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