src/mesa/main/renderbuffer.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  6.5
   4  *
   5  * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this software and associated documentation files (the "Software"),
   9  * to deal in the Software without restriction, including without limitation
  10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  11  * and/or sell copies of the Software, and to permit persons to whom the
  12  * Software is furnished to do so, subject to the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be included
  15  * in all copies or substantial portions of the Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  21  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  22  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  23  * OTHER DEALINGS IN THE SOFTWARE.
  24  */
  25
  26
  27 #include "glheader.h"
  28 #include "imports.h"
  29 #include "context.h"
  30 #include "fbobject.h"
  31 #include "formats.h"
  32 #include "mtypes.h"
  33 #include "renderbuffer.h"
  34
  35
  36 /**
  37  * Initialize the fields of a gl_renderbuffer to default values.
  38  */
  39 void
  40 _mesa_init_renderbuffer(struct gl_renderbuffer *rb, GLuint name)
  41 {
  42    _glthread_INIT_MUTEX(rb->Mutex);
  43
  44    rb->ClassID = 0;
  45    rb->Name = name;
  46    rb->RefCount = 0;
  47    rb->Delete = _mesa_delete_renderbuffer;
  48
  49    /* The rest of these should be set later by the caller of this function or
  50     * the AllocStorage method:
  51     */
  52    rb->AllocStorage = NULL;
  53
  54    rb->Width = 0;
  55    rb->Height = 0;
  56    rb->Depth = 0;
  57    rb->InternalFormat = GL_RGBA;
  58    rb->Format = MESA_FORMAT_NONE;
  59 }
  60
  61
  62 /**
  63  * Allocate a new gl_renderbuffer object.  This can be used for user-created
  64  * renderbuffers or window-system renderbuffers.
  65  */
  66 struct gl_renderbuffer *
  67 _mesa_new_renderbuffer(struct gl_context *ctx, GLuint name)
  68 {
  69    struct gl_renderbuffer *rb = CALLOC_STRUCT(gl_renderbuffer);
  70    if (rb) {
  71       _mesa_init_renderbuffer(rb, name);
  72    }
  73    return rb;
  74 }
  75
  76
  77 /**
  78  * Delete a gl_framebuffer.
  79  * This is the default function for renderbuffer->Delete().
  80  * Drivers which subclass gl_renderbuffer should probably implement their
  81  * own delete function.  But the driver might also call this function to
  82  * free the object in the end.
  83  */
  84 void
  85 _mesa_delete_renderbuffer(struct gl_context *ctx, struct gl_renderbuffer *rb)
  86 {
  87    _glthread_DESTROY_MUTEX(rb->Mutex);
  88    free(rb);
  89 }
  90
  91
  92 /**
  93  * Attach a renderbuffer to a framebuffer.
  94  * \param bufferName  one of the BUFFER_x tokens
  95  */
  96 void
  97 _mesa_add_renderbuffer(struct gl_framebuffer *fb,
  98                        gl_buffer_index bufferName, struct gl_renderbuffer *rb)
  99 {
 100    assert(fb);
 101    assert(rb);
 102    assert(bufferName < BUFFER_COUNT);
 103
 104    /* There should be no previous renderbuffer on this attachment point,
 105     * with the exception of depth/stencil since the same renderbuffer may
 106     * be used for both.
 107     */
 108    assert(bufferName == BUFFER_DEPTH ||
 109           bufferName == BUFFER_STENCIL ||
 110           fb->Attachment[bufferName].Renderbuffer == NULL);
 111
 112    /* winsys vs. user-created buffer cross check */
 113    if (_mesa_is_user_fbo(fb)) {
 114       assert(rb->Name);
 115    }
 116    else {
 117       assert(!rb->Name);
 118    }
 119
 120    fb->Attachment[bufferName].Type = GL_RENDERBUFFER_EXT;
 121    fb->Attachment[bufferName].Complete = GL_TRUE;
 122    _mesa_reference_renderbuffer(&fb->Attachment[bufferName].Renderbuffer, rb);
 123 }
 124
 125
 126 /**
 127  * Remove the named renderbuffer from the given framebuffer.
 128  * \param bufferName  one of the BUFFER_x tokens
 129  */
 130 void
 131 _mesa_remove_renderbuffer(struct gl_framebuffer *fb,
 132                           gl_buffer_index bufferName)
 133 {
 134    assert(bufferName < BUFFER_COUNT);
 135    _mesa_reference_renderbuffer(&fb->Attachment[bufferName].Renderbuffer,
 136                                 NULL);
 137 }
 138
 139
 140 /**
 141  * Set *ptr to point to rb.  If *ptr points to another renderbuffer,
 142  * dereference that buffer first.  The new renderbuffer's refcount will
 143  * be incremented.  The old renderbuffer's refcount will be decremented.
 144  * This is normally only called from the _mesa_reference_renderbuffer() macro
 145  * when there's a real pointer change.
 146  */
 147 void
 148 _mesa_reference_renderbuffer_(struct gl_renderbuffer **ptr,
 149                               struct gl_renderbuffer *rb)
 150 {
 151    if (*ptr) {
 152       /* Unreference the old renderbuffer */
 153       GLboolean deleteFlag = GL_FALSE;
 154       struct gl_renderbuffer *oldRb = *ptr;
 155
 156       _glthread_LOCK_MUTEX(oldRb->Mutex);
 157       ASSERT(oldRb->RefCount > 0);
 158       oldRb->RefCount--;
 159       /*printf("RB DECR %p (%d) to %d\n", (void*) oldRb, oldRb->Name, oldRb->RefCount);*/
 160       deleteFlag = (oldRb->RefCount == 0);
 161       _glthread_UNLOCK_MUTEX(oldRb->Mutex);
 162
 163       if (deleteFlag) {
 164          GET_CURRENT_CONTEXT(ctx);
 165          oldRb->Delete(ctx, oldRb);
 166       }
 167
 168       *ptr = NULL;
 169    }
 170    assert(!*ptr);
 171
 172    if (rb) {
 173       /* reference new renderbuffer */
 174       _glthread_LOCK_MUTEX(rb->Mutex);
 175       rb->RefCount++;
 176       /*printf("RB INCR %p (%d) to %d\n", (void*) rb, rb->Name, rb->RefCount);*/
 177       _glthread_UNLOCK_MUTEX(rb->Mutex);
 178       *ptr = rb;
 179    }
 180 }