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