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