2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
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:
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
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.
32 #include "renderbuffer.h"
33 #include "util/u_memory.h"
37 * Initialize the fields of a gl_renderbuffer to default values.
40 _mesa_init_renderbuffer(struct gl_renderbuffer
*rb
, GLuint name
)
42 GET_CURRENT_CONTEXT(ctx
);
44 simple_mtx_init(&rb
->Mutex
, mtx_plain
);
49 rb
->Delete
= _mesa_delete_renderbuffer
;
51 /* The rest of these should be set later by the caller of this function or
52 * the AllocStorage method:
54 rb
->AllocStorage
= NULL
;
60 /* In GL 3, the initial format is GL_RGBA according to Table 6.26
61 * on page 302 of the GL 3.3 spec.
63 * In GLES 3, the initial format is GL_RGBA4 according to Table 6.15
64 * on page 258 of the GLES 3.0.4 spec.
66 * If the context is current, set the initial format based on the
67 * specs. If the context is not current, we cannot determine the
68 * API, so default to GL_RGBA.
70 if (ctx
&& _mesa_is_gles(ctx
)) {
71 rb
->InternalFormat
= GL_RGBA4
;
73 rb
->InternalFormat
= GL_RGBA
;
76 rb
->Format
= MESA_FORMAT_NONE
;
81 * Allocate a new gl_renderbuffer object. This can be used for user-created
82 * renderbuffers or window-system renderbuffers.
84 struct gl_renderbuffer
*
85 _mesa_new_renderbuffer(struct gl_context
*ctx
, GLuint name
)
87 struct gl_renderbuffer
*rb
= CALLOC_STRUCT(gl_renderbuffer
);
89 _mesa_init_renderbuffer(rb
, name
);
96 * Delete a gl_framebuffer.
97 * This is the default function for renderbuffer->Delete().
98 * Drivers which subclass gl_renderbuffer should probably implement their
99 * own delete function. But the driver might also call this function to
100 * free the object in the end.
103 _mesa_delete_renderbuffer(struct gl_context
*ctx
, struct gl_renderbuffer
*rb
)
105 simple_mtx_destroy(&rb
->Mutex
);
111 validate_and_init_renderbuffer_attachment(struct gl_framebuffer
*fb
,
112 gl_buffer_index bufferName
,
113 struct gl_renderbuffer
*rb
)
117 assert(bufferName
< BUFFER_COUNT
);
119 /* There should be no previous renderbuffer on this attachment point,
120 * with the exception of depth/stencil since the same renderbuffer may
123 assert(bufferName
== BUFFER_DEPTH
||
124 bufferName
== BUFFER_STENCIL
||
125 fb
->Attachment
[bufferName
].Renderbuffer
== NULL
);
127 /* winsys vs. user-created buffer cross check */
128 if (_mesa_is_user_fbo(fb
)) {
135 fb
->Attachment
[bufferName
].Type
= GL_RENDERBUFFER_EXT
;
136 fb
->Attachment
[bufferName
].Complete
= GL_TRUE
;
141 * Attach a renderbuffer to a framebuffer.
142 * \param bufferName one of the BUFFER_x tokens
144 * This function avoids adding a reference and is therefore intended to be
145 * used with a freshly created renderbuffer.
148 _mesa_attach_and_own_rb(struct gl_framebuffer
*fb
,
149 gl_buffer_index bufferName
,
150 struct gl_renderbuffer
*rb
)
152 assert(rb
->RefCount
== 1);
154 validate_and_init_renderbuffer_attachment(fb
, bufferName
, rb
);
156 _mesa_reference_renderbuffer(&fb
->Attachment
[bufferName
].Renderbuffer
,
158 fb
->Attachment
[bufferName
].Renderbuffer
= rb
;
162 * Attach a renderbuffer to a framebuffer.
163 * \param bufferName one of the BUFFER_x tokens
166 _mesa_attach_and_reference_rb(struct gl_framebuffer
*fb
,
167 gl_buffer_index bufferName
,
168 struct gl_renderbuffer
*rb
)
170 validate_and_init_renderbuffer_attachment(fb
, bufferName
, rb
);
171 _mesa_reference_renderbuffer(&fb
->Attachment
[bufferName
].Renderbuffer
, rb
);
176 * Remove the named renderbuffer from the given framebuffer.
177 * \param bufferName one of the BUFFER_x tokens
180 _mesa_remove_renderbuffer(struct gl_framebuffer
*fb
,
181 gl_buffer_index bufferName
)
183 assert(bufferName
< BUFFER_COUNT
);
184 _mesa_reference_renderbuffer(&fb
->Attachment
[bufferName
].Renderbuffer
,
190 * Set *ptr to point to rb. If *ptr points to another renderbuffer,
191 * dereference that buffer first. The new renderbuffer's refcount will
192 * be incremented. The old renderbuffer's refcount will be decremented.
193 * This is normally only called from the _mesa_reference_renderbuffer() macro
194 * when there's a real pointer change.
197 _mesa_reference_renderbuffer_(struct gl_renderbuffer
**ptr
,
198 struct gl_renderbuffer
*rb
)
201 /* Unreference the old renderbuffer */
202 GLboolean deleteFlag
= GL_FALSE
;
203 struct gl_renderbuffer
*oldRb
= *ptr
;
205 simple_mtx_lock(&oldRb
->Mutex
);
206 assert(oldRb
->RefCount
> 0);
208 deleteFlag
= (oldRb
->RefCount
== 0);
209 simple_mtx_unlock(&oldRb
->Mutex
);
212 GET_CURRENT_CONTEXT(ctx
);
213 oldRb
->Delete(ctx
, oldRb
);
221 /* reference new renderbuffer */
222 simple_mtx_lock(&rb
->Mutex
);
224 simple_mtx_unlock(&rb
->Mutex
);