renderbuffer.c revision 59a5b5a193d5d9c5776aa586b34657b6e315479d 
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 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 */
24
25
26#include "glheader.h"
27#include "imports.h"
28#include "context.h"
29#include "fbobject.h"
30#include "formats.h"
31#include "mtypes.h"
32#include "renderbuffer.h"
33
34
35/**
36 * Initialize the fields of a gl_renderbuffer to default values.
37 */
38void
39_mesa_init_renderbuffer(struct gl_renderbuffer *rb, GLuint name)
40{
41   _glthread_INIT_MUTEX(rb->Mutex);
42
43   rb->ClassID = 0;
44   rb->Name = name;
45   rb->RefCount = 0;
46   rb->Delete = _mesa_delete_renderbuffer;
47
48   /* The rest of these should be set later by the caller of this function or
49    * the AllocStorage method:
50    */
51   rb->AllocStorage = NULL;
52
53   rb->Width = 0;
54   rb->Height = 0;
55   rb->InternalFormat = GL_RGBA;
56   rb->Format = MESA_FORMAT_NONE;
57}
58
59
60/**
61 * Allocate a new gl_renderbuffer object.  This can be used for user-created
62 * renderbuffers or window-system renderbuffers.
63 */
64struct gl_renderbuffer *
65_mesa_new_renderbuffer(struct gl_context *ctx, GLuint name)
66{
67   struct gl_renderbuffer *rb = CALLOC_STRUCT(gl_renderbuffer);
68   if (rb) {
69      _mesa_init_renderbuffer(rb, name);
70   }
71   return rb;
72}
73
74
75/**
76 * Delete a gl_framebuffer.
77 * This is the default function for renderbuffer->Delete().
78 */
79void
80_mesa_delete_renderbuffer(struct gl_renderbuffer *rb)
81{
82   /* no-op */
83}
84
85
86/**
87 * Attach a renderbuffer to a framebuffer.
88 * \param bufferName  one of the BUFFER_x tokens
89 */
90void
91_mesa_add_renderbuffer(struct gl_framebuffer *fb,
92                       gl_buffer_index bufferName, struct gl_renderbuffer *rb)
93{
94   assert(fb);
95   assert(rb);
96   assert(bufferName < BUFFER_COUNT);
97
98   /* There should be no previous renderbuffer on this attachment point,
99    * with the exception of depth/stencil since the same renderbuffer may
100    * be used for both.
101    */
102   assert(bufferName == BUFFER_DEPTH ||
103          bufferName == BUFFER_STENCIL ||
104          fb->Attachment[bufferName].Renderbuffer == NULL);
105
106   /* winsys vs. user-created buffer cross check */
107   if (_mesa_is_user_fbo(fb)) {
108      assert(rb->Name);
109   }
110   else {
111      assert(!rb->Name);
112   }
113
114   fb->Attachment[bufferName].Type = GL_RENDERBUFFER_EXT;
115   fb->Attachment[bufferName].Complete = GL_TRUE;
116   _mesa_reference_renderbuffer(&fb->Attachment[bufferName].Renderbuffer, rb);
117}
118
119
120/**
121 * Remove the named renderbuffer from the given framebuffer.
122 * \param bufferName  one of the BUFFER_x tokens
123 */
124void
125_mesa_remove_renderbuffer(struct gl_framebuffer *fb,
126                          gl_buffer_index bufferName)
127{
128   assert(bufferName < BUFFER_COUNT);
129   _mesa_reference_renderbuffer(&fb->Attachment[bufferName].Renderbuffer,
130                                NULL);
131}
132
133
134/**
135 * Set *ptr to point to rb.  If *ptr points to another renderbuffer,
136 * dereference that buffer first.  The new renderbuffer's refcount will
137 * be incremented.  The old renderbuffer's refcount will be decremented.
138 * This is normally only called from the _mesa_reference_renderbuffer() macro
139 * when there's a real pointer change.
140 */
141void
142_mesa_reference_renderbuffer_(struct gl_renderbuffer **ptr,
143                              struct gl_renderbuffer *rb)
144{
145   if (*ptr) {
146      /* Unreference the old renderbuffer */
147      GLboolean deleteFlag = GL_FALSE;
148      struct gl_renderbuffer *oldRb = *ptr;
149
150      _glthread_LOCK_MUTEX(oldRb->Mutex);
151      ASSERT(oldRb->RefCount > 0);
152      oldRb->RefCount--;
153      /*printf("RB DECR %p (%d) to %d\n", (void*) oldRb, oldRb->Name, oldRb->RefCount);*/
154      deleteFlag = (oldRb->RefCount == 0);
155      _glthread_UNLOCK_MUTEX(oldRb->Mutex);
156
157      if (deleteFlag) {
158         oldRb->Delete(oldRb);
159      }
160
161      *ptr = NULL;
162   }
163   assert(!*ptr);
164
165   if (rb) {
166      /* reference new renderbuffer */
167      _glthread_LOCK_MUTEX(rb->Mutex);
168      rb->RefCount++;
169      /*printf("RB INCR %p (%d) to %d\n", (void*) rb, rb->Name, rb->RefCount);*/
170      _glthread_UNLOCK_MUTEX(rb->Mutex);
171      *ptr = rb;
172   }
173}
174