Home | History | Annotate | Download | only in main 
      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  */
     38 void
     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  */
     83 struct 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  */
    101 void
    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  */
    114 void
    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  */
    148 void
    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  */
    165 void
    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