2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 1999-2009 VMware, Inc. All Rights Reserved.
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 * GL_EXT/ARB_framebuffer_object extensions
41 #include "framebuffer.h"
42 #include "glformats.h"
45 #include "mfeatures.h"
47 #include "renderbuffer.h"
53 /** Set this to 1 to debug/log glBlitFramebuffer() calls */
60 * None of the GL_EXT_framebuffer_object functions are compiled into
67 * When glGenRender/FramebuffersEXT() is called we insert pointers to
68 * these placeholder objects into the hash table.
69 * Later, when the object ID is first bound, we replace the placeholder
70 * with the real frame/renderbuffer.
72 static struct gl_framebuffer DummyFramebuffer
;
73 static struct gl_renderbuffer DummyRenderbuffer
;
75 /* We bind this framebuffer when applications pass a NULL
76 * drawable/surface in make current. */
77 static struct gl_framebuffer IncompleteFramebuffer
;
81 delete_dummy_renderbuffer(struct gl_context
*ctx
, struct gl_renderbuffer
*rb
)
87 delete_dummy_framebuffer(struct gl_framebuffer
*fb
)
94 _mesa_init_fbobjects(struct gl_context
*ctx
)
96 _glthread_INIT_MUTEX(DummyFramebuffer
.Mutex
);
97 _glthread_INIT_MUTEX(DummyRenderbuffer
.Mutex
);
98 _glthread_INIT_MUTEX(IncompleteFramebuffer
.Mutex
);
99 DummyFramebuffer
.Delete
= delete_dummy_framebuffer
;
100 DummyRenderbuffer
.Delete
= delete_dummy_renderbuffer
;
101 IncompleteFramebuffer
.Delete
= delete_dummy_framebuffer
;
104 struct gl_framebuffer
*
105 _mesa_get_incomplete_framebuffer(void)
107 return &IncompleteFramebuffer
;
111 * Helper routine for getting a gl_renderbuffer.
113 struct gl_renderbuffer
*
114 _mesa_lookup_renderbuffer(struct gl_context
*ctx
, GLuint id
)
116 struct gl_renderbuffer
*rb
;
121 rb
= (struct gl_renderbuffer
*)
122 _mesa_HashLookup(ctx
->Shared
->RenderBuffers
, id
);
128 * Helper routine for getting a gl_framebuffer.
130 struct gl_framebuffer
*
131 _mesa_lookup_framebuffer(struct gl_context
*ctx
, GLuint id
)
133 struct gl_framebuffer
*fb
;
138 fb
= (struct gl_framebuffer
*)
139 _mesa_HashLookup(ctx
->Shared
->FrameBuffers
, id
);
145 * Mark the given framebuffer as invalid. This will force the
146 * test for framebuffer completeness to be done before the framebuffer
150 invalidate_framebuffer(struct gl_framebuffer
*fb
)
152 fb
->_Status
= 0; /* "indeterminate" */
157 * Return the gl_framebuffer object which corresponds to the given
158 * framebuffer target, such as GL_DRAW_FRAMEBUFFER.
159 * Check support for GL_EXT_framebuffer_blit to determine if certain
161 * \return gl_framebuffer pointer or NULL if target is illegal
163 static struct gl_framebuffer
*
164 get_framebuffer_target(struct gl_context
*ctx
, GLenum target
)
166 bool have_fb_blit
= _mesa_is_gles3(ctx
) ||
167 (ctx
->Extensions
.EXT_framebuffer_blit
&& _mesa_is_desktop_gl(ctx
));
169 case GL_DRAW_FRAMEBUFFER
:
170 return have_fb_blit
? ctx
->DrawBuffer
: NULL
;
171 case GL_READ_FRAMEBUFFER
:
172 return have_fb_blit
? ctx
->ReadBuffer
: NULL
;
173 case GL_FRAMEBUFFER_EXT
:
174 return ctx
->DrawBuffer
;
182 * Given a GL_*_ATTACHMENTn token, return a pointer to the corresponding
183 * gl_renderbuffer_attachment object.
184 * This function is only used for user-created FB objects, not the
185 * default / window-system FB object.
186 * If \p attachment is GL_DEPTH_STENCIL_ATTACHMENT, return a pointer to
187 * the depth buffer attachment point.
189 struct gl_renderbuffer_attachment
*
190 _mesa_get_attachment(struct gl_context
*ctx
, struct gl_framebuffer
*fb
,
195 assert(_mesa_is_user_fbo(fb
));
197 switch (attachment
) {
198 case GL_COLOR_ATTACHMENT0_EXT
:
199 case GL_COLOR_ATTACHMENT1_EXT
:
200 case GL_COLOR_ATTACHMENT2_EXT
:
201 case GL_COLOR_ATTACHMENT3_EXT
:
202 case GL_COLOR_ATTACHMENT4_EXT
:
203 case GL_COLOR_ATTACHMENT5_EXT
:
204 case GL_COLOR_ATTACHMENT6_EXT
:
205 case GL_COLOR_ATTACHMENT7_EXT
:
206 case GL_COLOR_ATTACHMENT8_EXT
:
207 case GL_COLOR_ATTACHMENT9_EXT
:
208 case GL_COLOR_ATTACHMENT10_EXT
:
209 case GL_COLOR_ATTACHMENT11_EXT
:
210 case GL_COLOR_ATTACHMENT12_EXT
:
211 case GL_COLOR_ATTACHMENT13_EXT
:
212 case GL_COLOR_ATTACHMENT14_EXT
:
213 case GL_COLOR_ATTACHMENT15_EXT
:
214 /* Only OpenGL ES 1.x forbids color attachments other than
215 * GL_COLOR_ATTACHMENT0. For all other APIs the limit set by the
218 i
= attachment
- GL_COLOR_ATTACHMENT0_EXT
;
219 if (i
>= ctx
->Const
.MaxColorAttachments
220 || (i
> 0 && ctx
->API
== API_OPENGLES
)) {
223 return &fb
->Attachment
[BUFFER_COLOR0
+ i
];
224 case GL_DEPTH_STENCIL_ATTACHMENT
:
225 if (!_mesa_is_desktop_gl(ctx
) && !_mesa_is_gles3(ctx
))
228 case GL_DEPTH_ATTACHMENT_EXT
:
229 return &fb
->Attachment
[BUFFER_DEPTH
];
230 case GL_STENCIL_ATTACHMENT_EXT
:
231 return &fb
->Attachment
[BUFFER_STENCIL
];
239 * As above, but only used for getting attachments of the default /
240 * window-system framebuffer (not user-created framebuffer objects).
242 static struct gl_renderbuffer_attachment
*
243 _mesa_get_fb0_attachment(struct gl_context
*ctx
, struct gl_framebuffer
*fb
,
246 assert(_mesa_is_winsys_fbo(fb
));
248 switch (attachment
) {
250 return &fb
->Attachment
[BUFFER_FRONT_LEFT
];
252 return &fb
->Attachment
[BUFFER_FRONT_RIGHT
];
254 return &fb
->Attachment
[BUFFER_BACK_LEFT
];
256 return &fb
->Attachment
[BUFFER_BACK_RIGHT
];
258 if (fb
->Visual
.numAuxBuffers
== 1) {
259 return &fb
->Attachment
[BUFFER_AUX0
];
263 /* Page 336 (page 352 of the PDF) of the OpenGL 3.0 spec says:
265 * "If the default framebuffer is bound to target, then attachment must
266 * be one of FRONT LEFT, FRONT RIGHT, BACK LEFT, BACK RIGHT, or AUXi,
267 * identifying a color buffer; DEPTH, identifying the depth buffer; or
268 * STENCIL, identifying the stencil buffer."
270 * Revision #34 of the ARB_framebuffer_object spec has essentially the same
271 * language. However, revision #33 of the ARB_framebuffer_object spec
274 * "If the default framebuffer is bound to <target>, then <attachment>
275 * must be one of FRONT_LEFT, FRONT_RIGHT, BACK_LEFT, BACK_RIGHT, AUXi,
276 * DEPTH_BUFFER, or STENCIL_BUFFER, identifying a color buffer, the
277 * depth buffer, or the stencil buffer, and <pname> may be
278 * FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE or
279 * FRAMEBUFFER_ATTACHMENT_OBJECT_NAME."
281 * The enum values for DEPTH_BUFFER and STENCIL_BUFFER have been removed
282 * from glext.h, so shipping apps should not use those values.
284 * Note that neither EXT_framebuffer_object nor OES_framebuffer_object
285 * support queries of the window system FBO.
288 return &fb
->Attachment
[BUFFER_DEPTH
];
290 return &fb
->Attachment
[BUFFER_STENCIL
];
299 * Remove any texture or renderbuffer attached to the given attachment
300 * point. Update reference counts, etc.
303 _mesa_remove_attachment(struct gl_context
*ctx
,
304 struct gl_renderbuffer_attachment
*att
)
306 if (att
->Type
== GL_TEXTURE
) {
307 ASSERT(att
->Texture
);
308 if (ctx
->Driver
.FinishRenderTexture
) {
309 /* tell driver that we're done rendering to this texture. */
310 ctx
->Driver
.FinishRenderTexture(ctx
, att
);
312 _mesa_reference_texobj(&att
->Texture
, NULL
); /* unbind */
313 ASSERT(!att
->Texture
);
315 if (att
->Type
== GL_TEXTURE
|| att
->Type
== GL_RENDERBUFFER_EXT
) {
316 ASSERT(!att
->Texture
);
317 _mesa_reference_renderbuffer(&att
->Renderbuffer
, NULL
); /* unbind */
318 ASSERT(!att
->Renderbuffer
);
321 att
->Complete
= GL_TRUE
;
326 * Bind a texture object to an attachment point.
327 * The previous binding, if any, will be removed first.
330 _mesa_set_texture_attachment(struct gl_context
*ctx
,
331 struct gl_framebuffer
*fb
,
332 struct gl_renderbuffer_attachment
*att
,
333 struct gl_texture_object
*texObj
,
334 GLenum texTarget
, GLuint level
, GLuint zoffset
)
336 if (att
->Texture
== texObj
) {
337 /* re-attaching same texture */
338 ASSERT(att
->Type
== GL_TEXTURE
);
339 if (ctx
->Driver
.FinishRenderTexture
)
340 ctx
->Driver
.FinishRenderTexture(ctx
, att
);
344 if (ctx
->Driver
.FinishRenderTexture
&& att
->Texture
)
345 ctx
->Driver
.FinishRenderTexture(ctx
, att
);
346 _mesa_remove_attachment(ctx
, att
);
347 att
->Type
= GL_TEXTURE
;
348 assert(!att
->Texture
);
349 _mesa_reference_texobj(&att
->Texture
, texObj
);
352 /* always update these fields */
353 att
->TextureLevel
= level
;
354 att
->CubeMapFace
= _mesa_tex_target_to_face(texTarget
);
355 att
->Zoffset
= zoffset
;
356 att
->Complete
= GL_FALSE
;
358 if (_mesa_get_attachment_teximage(att
)) {
359 ctx
->Driver
.RenderTexture(ctx
, fb
, att
);
362 invalidate_framebuffer(fb
);
367 * Bind a renderbuffer to an attachment point.
368 * The previous binding, if any, will be removed first.
371 _mesa_set_renderbuffer_attachment(struct gl_context
*ctx
,
372 struct gl_renderbuffer_attachment
*att
,
373 struct gl_renderbuffer
*rb
)
375 /* XXX check if re-doing same attachment, exit early */
376 _mesa_remove_attachment(ctx
, att
);
377 att
->Type
= GL_RENDERBUFFER_EXT
;
378 att
->Texture
= NULL
; /* just to be safe */
379 att
->Complete
= GL_FALSE
;
380 _mesa_reference_renderbuffer(&att
->Renderbuffer
, rb
);
385 * Fallback for ctx->Driver.FramebufferRenderbuffer()
386 * Attach a renderbuffer object to a framebuffer object.
389 _mesa_framebuffer_renderbuffer(struct gl_context
*ctx
,
390 struct gl_framebuffer
*fb
,
391 GLenum attachment
, struct gl_renderbuffer
*rb
)
393 struct gl_renderbuffer_attachment
*att
;
395 _glthread_LOCK_MUTEX(fb
->Mutex
);
397 att
= _mesa_get_attachment(ctx
, fb
, attachment
);
400 _mesa_set_renderbuffer_attachment(ctx
, att
, rb
);
401 if (attachment
== GL_DEPTH_STENCIL_ATTACHMENT
) {
402 /* do stencil attachment here (depth already done above) */
403 att
= _mesa_get_attachment(ctx
, fb
, GL_STENCIL_ATTACHMENT_EXT
);
405 _mesa_set_renderbuffer_attachment(ctx
, att
, rb
);
407 rb
->AttachedAnytime
= GL_TRUE
;
410 _mesa_remove_attachment(ctx
, att
);
413 invalidate_framebuffer(fb
);
415 _glthread_UNLOCK_MUTEX(fb
->Mutex
);
420 * Fallback for ctx->Driver.ValidateFramebuffer()
421 * Check if the renderbuffer's formats are supported by the software
423 * Drivers should probably override this.
426 _mesa_validate_framebuffer(struct gl_context
*ctx
, struct gl_framebuffer
*fb
)
429 for (buf
= 0; buf
< BUFFER_COUNT
; buf
++) {
430 const struct gl_renderbuffer
*rb
= fb
->Attachment
[buf
].Renderbuffer
;
432 switch (rb
->_BaseFormat
) {
434 case GL_LUMINANCE_ALPHA
:
439 fb
->_Status
= GL_FRAMEBUFFER_UNSUPPORTED
;
443 switch (rb
->Format
) {
444 /* XXX This list is likely incomplete. */
445 case MESA_FORMAT_RGB9_E5_FLOAT
:
446 fb
->_Status
= GL_FRAMEBUFFER_UNSUPPORTED
;
449 /* render buffer format is supported by software rendering */
461 att_incomplete(const char *msg
)
463 if (MESA_DEBUG_FLAGS
& DEBUG_INCOMPLETE_FBO
) {
464 _mesa_debug(NULL
, "attachment incomplete: %s\n", msg
);
473 fbo_incomplete(const char *msg
, int index
)
475 if (MESA_DEBUG_FLAGS
& DEBUG_INCOMPLETE_FBO
) {
476 _mesa_debug(NULL
, "FBO Incomplete: %s [%d]\n", msg
, index
);
482 * Is the given base format a legal format for a color renderbuffer?
485 _mesa_is_legal_color_format(const struct gl_context
*ctx
, GLenum baseFormat
)
487 switch (baseFormat
) {
492 case GL_LUMINANCE_ALPHA
:
495 return ctx
->Extensions
.ARB_framebuffer_object
;
498 return ctx
->Extensions
.ARB_texture_rg
;
506 * Is the given base format a legal format for a depth/stencil renderbuffer?
509 is_legal_depth_format(const struct gl_context
*ctx
, GLenum baseFormat
)
511 switch (baseFormat
) {
512 case GL_DEPTH_COMPONENT
:
513 case GL_DEPTH_STENCIL_EXT
:
522 * Test if an attachment point is complete and update its Complete field.
523 * \param format if GL_COLOR, this is a color attachment point,
524 * if GL_DEPTH, this is a depth component attachment point,
525 * if GL_STENCIL, this is a stencil component attachment point.
528 test_attachment_completeness(const struct gl_context
*ctx
, GLenum format
,
529 struct gl_renderbuffer_attachment
*att
)
531 assert(format
== GL_COLOR
|| format
== GL_DEPTH
|| format
== GL_STENCIL
);
533 /* assume complete */
534 att
->Complete
= GL_TRUE
;
536 /* Look for reasons why the attachment might be incomplete */
537 if (att
->Type
== GL_TEXTURE
) {
538 const struct gl_texture_object
*texObj
= att
->Texture
;
539 struct gl_texture_image
*texImage
;
543 att_incomplete("no texobj");
544 att
->Complete
= GL_FALSE
;
548 texImage
= texObj
->Image
[att
->CubeMapFace
][att
->TextureLevel
];
550 att_incomplete("no teximage");
551 att
->Complete
= GL_FALSE
;
554 if (texImage
->Width
< 1 || texImage
->Height
< 1) {
555 att_incomplete("teximage width/height=0");
556 printf("texobj = %u\n", texObj
->Name
);
557 printf("level = %d\n", att
->TextureLevel
);
558 att
->Complete
= GL_FALSE
;
561 if (texObj
->Target
== GL_TEXTURE_3D
&& att
->Zoffset
>= texImage
->Depth
) {
562 att_incomplete("bad z offset");
563 att
->Complete
= GL_FALSE
;
567 baseFormat
= _mesa_get_format_base_format(texImage
->TexFormat
);
569 if (format
== GL_COLOR
) {
570 if (!_mesa_is_legal_color_format(ctx
, baseFormat
)) {
571 att_incomplete("bad format");
572 att
->Complete
= GL_FALSE
;
575 if (_mesa_is_format_compressed(texImage
->TexFormat
)) {
576 att_incomplete("compressed internalformat");
577 att
->Complete
= GL_FALSE
;
581 else if (format
== GL_DEPTH
) {
582 if (baseFormat
== GL_DEPTH_COMPONENT
) {
585 else if (ctx
->Extensions
.EXT_packed_depth_stencil
&&
586 ctx
->Extensions
.ARB_depth_texture
&&
587 baseFormat
== GL_DEPTH_STENCIL_EXT
) {
591 att
->Complete
= GL_FALSE
;
592 att_incomplete("bad depth format");
597 ASSERT(format
== GL_STENCIL
);
598 if (ctx
->Extensions
.EXT_packed_depth_stencil
&&
599 ctx
->Extensions
.ARB_depth_texture
&&
600 baseFormat
== GL_DEPTH_STENCIL_EXT
) {
604 /* no such thing as stencil-only textures */
605 att_incomplete("illegal stencil texture");
606 att
->Complete
= GL_FALSE
;
611 else if (att
->Type
== GL_RENDERBUFFER_EXT
) {
612 const GLenum baseFormat
=
613 _mesa_get_format_base_format(att
->Renderbuffer
->Format
);
615 ASSERT(att
->Renderbuffer
);
616 if (!att
->Renderbuffer
->InternalFormat
||
617 att
->Renderbuffer
->Width
< 1 ||
618 att
->Renderbuffer
->Height
< 1) {
619 att_incomplete("0x0 renderbuffer");
620 att
->Complete
= GL_FALSE
;
623 if (format
== GL_COLOR
) {
624 if (!_mesa_is_legal_color_format(ctx
, baseFormat
)) {
625 att_incomplete("bad renderbuffer color format");
626 att
->Complete
= GL_FALSE
;
630 else if (format
== GL_DEPTH
) {
631 if (baseFormat
== GL_DEPTH_COMPONENT
) {
634 else if (ctx
->Extensions
.EXT_packed_depth_stencil
&&
635 baseFormat
== GL_DEPTH_STENCIL_EXT
) {
639 att_incomplete("bad renderbuffer depth format");
640 att
->Complete
= GL_FALSE
;
645 assert(format
== GL_STENCIL
);
646 if (baseFormat
== GL_STENCIL_INDEX
) {
649 else if (ctx
->Extensions
.EXT_packed_depth_stencil
&&
650 baseFormat
== GL_DEPTH_STENCIL_EXT
) {
654 att
->Complete
= GL_FALSE
;
655 att_incomplete("bad renderbuffer stencil format");
661 ASSERT(att
->Type
== GL_NONE
);
669 * Test if the given framebuffer object is complete and update its
670 * Status field with the results.
671 * Calls the ctx->Driver.ValidateFramebuffer() function to allow the
672 * driver to make hardware-specific validation/completeness checks.
673 * Also update the framebuffer's Width and Height fields if the
674 * framebuffer is complete.
677 _mesa_test_framebuffer_completeness(struct gl_context
*ctx
,
678 struct gl_framebuffer
*fb
)
681 GLenum intFormat
= GL_NONE
; /* color buffers' internal format */
682 GLuint minWidth
= ~0, minHeight
= ~0, maxWidth
= 0, maxHeight
= 0;
683 GLint numSamples
= -1;
687 assert(_mesa_is_user_fbo(fb
));
689 /* we're changing framebuffer fields here */
690 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
696 /* Start at -2 to more easily loop over all attachment points.
701 for (i
= -2; i
< (GLint
) ctx
->Const
.MaxColorAttachments
; i
++) {
702 struct gl_renderbuffer_attachment
*att
;
707 * XXX for ARB_fbo, only check color buffers that are named by
708 * GL_READ_BUFFER and GL_DRAW_BUFFERi.
711 /* check for attachment completeness
714 att
= &fb
->Attachment
[BUFFER_DEPTH
];
715 test_attachment_completeness(ctx
, GL_DEPTH
, att
);
716 if (!att
->Complete
) {
717 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT
;
718 fbo_incomplete("depth attachment incomplete", -1);
723 att
= &fb
->Attachment
[BUFFER_STENCIL
];
724 test_attachment_completeness(ctx
, GL_STENCIL
, att
);
725 if (!att
->Complete
) {
726 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT
;
727 fbo_incomplete("stencil attachment incomplete", -1);
732 att
= &fb
->Attachment
[BUFFER_COLOR0
+ i
];
733 test_attachment_completeness(ctx
, GL_COLOR
, att
);
734 if (!att
->Complete
) {
735 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT
;
736 fbo_incomplete("color attachment incomplete", i
);
741 /* get width, height, format of the renderbuffer/texture
743 if (att
->Type
== GL_TEXTURE
) {
744 const struct gl_texture_image
*texImg
=
745 _mesa_get_attachment_teximage(att
);
746 minWidth
= MIN2(minWidth
, texImg
->Width
);
747 maxWidth
= MAX2(maxWidth
, texImg
->Width
);
748 minHeight
= MIN2(minHeight
, texImg
->Height
);
749 maxHeight
= MAX2(maxHeight
, texImg
->Height
);
750 f
= texImg
->_BaseFormat
;
751 attFormat
= texImg
->TexFormat
;
753 if (!_mesa_is_legal_color_format(ctx
, f
) &&
754 !is_legal_depth_format(ctx
, f
)) {
755 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT
;
756 fbo_incomplete("texture attachment incomplete", -1);
760 else if (att
->Type
== GL_RENDERBUFFER_EXT
) {
761 minWidth
= MIN2(minWidth
, att
->Renderbuffer
->Width
);
762 maxWidth
= MAX2(minWidth
, att
->Renderbuffer
->Width
);
763 minHeight
= MIN2(minHeight
, att
->Renderbuffer
->Height
);
764 maxHeight
= MAX2(minHeight
, att
->Renderbuffer
->Height
);
765 f
= att
->Renderbuffer
->InternalFormat
;
766 attFormat
= att
->Renderbuffer
->Format
;
770 assert(att
->Type
== GL_NONE
);
774 if (att
->Renderbuffer
&& numSamples
< 0) {
776 numSamples
= att
->Renderbuffer
->NumSamples
;
779 /* check if integer color */
780 fb
->_IntegerColor
= _mesa_is_format_integer_color(attFormat
);
782 /* Error-check width, height, format, samples
784 if (numImages
== 1) {
785 /* save format, num samples */
791 if (!ctx
->Extensions
.ARB_framebuffer_object
) {
792 /* check that width, height, format are same */
793 if (minWidth
!= maxWidth
|| minHeight
!= maxHeight
) {
794 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT
;
795 fbo_incomplete("width or height mismatch", -1);
798 /* check that all color buffers are the same format */
799 if (intFormat
!= GL_NONE
&& f
!= intFormat
) {
800 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT
;
801 fbo_incomplete("format mismatch", -1);
805 if (att
->Renderbuffer
&&
806 att
->Renderbuffer
->NumSamples
!= numSamples
) {
807 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE
;
808 fbo_incomplete("inconsistant number of samples", i
);
813 /* Check that the format is valid. (MESA_FORMAT_NONE means unsupported)
815 if (att
->Type
== GL_RENDERBUFFER
&&
816 att
->Renderbuffer
->Format
== MESA_FORMAT_NONE
) {
817 fb
->_Status
= GL_FRAMEBUFFER_UNSUPPORTED
;
818 fbo_incomplete("unsupported renderbuffer format", i
);
823 if (_mesa_is_desktop_gl(ctx
) && !ctx
->Extensions
.ARB_ES2_compatibility
) {
824 /* Check that all DrawBuffers are present */
825 for (j
= 0; j
< ctx
->Const
.MaxDrawBuffers
; j
++) {
826 if (fb
->ColorDrawBuffer
[j
] != GL_NONE
) {
827 const struct gl_renderbuffer_attachment
*att
828 = _mesa_get_attachment(ctx
, fb
, fb
->ColorDrawBuffer
[j
]);
830 if (att
->Type
== GL_NONE
) {
831 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_EXT
;
832 fbo_incomplete("missing drawbuffer", j
);
838 /* Check that the ReadBuffer is present */
839 if (fb
->ColorReadBuffer
!= GL_NONE
) {
840 const struct gl_renderbuffer_attachment
*att
841 = _mesa_get_attachment(ctx
, fb
, fb
->ColorReadBuffer
);
843 if (att
->Type
== GL_NONE
) {
844 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT
;
845 fbo_incomplete("missing readbuffer", -1);
851 if (numImages
== 0) {
852 fb
->_Status
= GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT
;
853 fbo_incomplete("no attachments", -1);
857 /* Provisionally set status = COMPLETE ... */
858 fb
->_Status
= GL_FRAMEBUFFER_COMPLETE_EXT
;
860 /* ... but the driver may say the FB is incomplete.
861 * Drivers will most likely set the status to GL_FRAMEBUFFER_UNSUPPORTED
864 if (ctx
->Driver
.ValidateFramebuffer
) {
865 ctx
->Driver
.ValidateFramebuffer(ctx
, fb
);
866 if (fb
->_Status
!= GL_FRAMEBUFFER_COMPLETE_EXT
) {
867 fbo_incomplete("driver marked FBO as incomplete", -1);
871 if (fb
->_Status
== GL_FRAMEBUFFER_COMPLETE_EXT
) {
873 * Note that if ARB_framebuffer_object is supported and the attached
874 * renderbuffers/textures are different sizes, the framebuffer
875 * width/height will be set to the smallest width/height.
877 fb
->Width
= minWidth
;
878 fb
->Height
= minHeight
;
880 /* finally, update the visual info for the framebuffer */
881 _mesa_update_framebuffer_visual(ctx
, fb
);
887 _mesa_IsRenderbuffer(GLuint renderbuffer
)
889 GET_CURRENT_CONTEXT(ctx
);
890 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx
, GL_FALSE
);
892 struct gl_renderbuffer
*rb
= _mesa_lookup_renderbuffer(ctx
, renderbuffer
);
893 if (rb
!= NULL
&& rb
!= &DummyRenderbuffer
)
901 _mesa_BindRenderbuffer(GLenum target
, GLuint renderbuffer
)
903 struct gl_renderbuffer
*newRb
;
904 GET_CURRENT_CONTEXT(ctx
);
906 ASSERT_OUTSIDE_BEGIN_END(ctx
);
908 if (target
!= GL_RENDERBUFFER_EXT
) {
909 _mesa_error(ctx
, GL_INVALID_ENUM
, "glBindRenderbufferEXT(target)");
913 /* No need to flush here since the render buffer binding has no
914 * effect on rendering state.
918 newRb
= _mesa_lookup_renderbuffer(ctx
, renderbuffer
);
919 if (newRb
== &DummyRenderbuffer
) {
920 /* ID was reserved, but no real renderbuffer object made yet */
924 && _mesa_is_desktop_gl(ctx
)
925 && ctx
->Extensions
.ARB_framebuffer_object
) {
926 /* All RB IDs must be Gen'd */
927 _mesa_error(ctx
, GL_INVALID_OPERATION
, "glBindRenderbuffer(buffer)");
932 /* create new renderbuffer object */
933 newRb
= ctx
->Driver
.NewRenderbuffer(ctx
, renderbuffer
);
935 _mesa_error(ctx
, GL_OUT_OF_MEMORY
, "glBindRenderbufferEXT");
938 ASSERT(newRb
->AllocStorage
);
939 _mesa_HashInsert(ctx
->Shared
->RenderBuffers
, renderbuffer
, newRb
);
940 newRb
->RefCount
= 1; /* referenced by hash table */
947 ASSERT(newRb
!= &DummyRenderbuffer
);
949 _mesa_reference_renderbuffer(&ctx
->CurrentRenderbuffer
, newRb
);
954 * If the given renderbuffer is anywhere attached to the framebuffer, detach
956 * This is used when a renderbuffer object is deleted.
957 * The spec calls for unbinding.
960 detach_renderbuffer(struct gl_context
*ctx
,
961 struct gl_framebuffer
*fb
,
962 struct gl_renderbuffer
*rb
)
965 for (i
= 0; i
< BUFFER_COUNT
; i
++) {
966 if (fb
->Attachment
[i
].Renderbuffer
== rb
) {
967 _mesa_remove_attachment(ctx
, &fb
->Attachment
[i
]);
970 invalidate_framebuffer(fb
);
975 _mesa_DeleteRenderbuffers(GLsizei n
, const GLuint
*renderbuffers
)
978 GET_CURRENT_CONTEXT(ctx
);
980 ASSERT_OUTSIDE_BEGIN_END(ctx
);
981 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
983 for (i
= 0; i
< n
; i
++) {
984 if (renderbuffers
[i
] > 0) {
985 struct gl_renderbuffer
*rb
;
986 rb
= _mesa_lookup_renderbuffer(ctx
, renderbuffers
[i
]);
988 /* check if deleting currently bound renderbuffer object */
989 if (rb
== ctx
->CurrentRenderbuffer
) {
991 ASSERT(rb
->RefCount
>= 2);
992 _mesa_BindRenderbuffer(GL_RENDERBUFFER_EXT
, 0);
995 if (_mesa_is_user_fbo(ctx
->DrawBuffer
)) {
996 detach_renderbuffer(ctx
, ctx
->DrawBuffer
, rb
);
998 if (_mesa_is_user_fbo(ctx
->ReadBuffer
)
999 && ctx
->ReadBuffer
!= ctx
->DrawBuffer
) {
1000 detach_renderbuffer(ctx
, ctx
->ReadBuffer
, rb
);
1003 /* Remove from hash table immediately, to free the ID.
1004 * But the object will not be freed until it's no longer
1005 * referenced anywhere else.
1007 _mesa_HashRemove(ctx
->Shared
->RenderBuffers
, renderbuffers
[i
]);
1009 if (rb
!= &DummyRenderbuffer
) {
1010 /* no longer referenced by hash table */
1011 _mesa_reference_renderbuffer(&rb
, NULL
);
1020 _mesa_GenRenderbuffers(GLsizei n
, GLuint
*renderbuffers
)
1022 GET_CURRENT_CONTEXT(ctx
);
1026 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1029 _mesa_error(ctx
, GL_INVALID_VALUE
, "glGenRenderbuffersEXT(n)");
1036 first
= _mesa_HashFindFreeKeyBlock(ctx
->Shared
->RenderBuffers
, n
);
1038 for (i
= 0; i
< n
; i
++) {
1039 GLuint name
= first
+ i
;
1040 renderbuffers
[i
] = name
;
1041 /* insert dummy placeholder into hash table */
1042 _glthread_LOCK_MUTEX(ctx
->Shared
->Mutex
);
1043 _mesa_HashInsert(ctx
->Shared
->RenderBuffers
, name
, &DummyRenderbuffer
);
1044 _glthread_UNLOCK_MUTEX(ctx
->Shared
->Mutex
);
1050 * Given an internal format token for a render buffer, return the
1051 * corresponding base format (one of GL_RGB, GL_RGBA, GL_STENCIL_INDEX,
1052 * GL_DEPTH_COMPONENT, GL_DEPTH_STENCIL_EXT, GL_ALPHA, GL_LUMINANCE,
1053 * GL_LUMINANCE_ALPHA, GL_INTENSITY, etc).
1055 * This is similar to _mesa_base_tex_format() but the set of valid
1056 * internal formats is different.
1058 * Note that even if a format is determined to be legal here, validation
1059 * of the FBO may fail if the format is not supported by the driver/GPU.
1061 * \param internalFormat as passed to glRenderbufferStorage()
1062 * \return the base internal format, or 0 if internalFormat is illegal
1065 _mesa_base_fbo_format(struct gl_context
*ctx
, GLenum internalFormat
)
1068 * Notes: some formats such as alpha, luminance, etc. were added
1069 * with GL_ARB_framebuffer_object.
1071 switch (internalFormat
) {
1077 return ctx
->API
== API_OPENGL_COMPAT
&& ctx
->Extensions
.ARB_framebuffer_object
1082 case GL_LUMINANCE12
:
1083 case GL_LUMINANCE16
:
1084 return ctx
->API
== API_OPENGL_COMPAT
&& ctx
->Extensions
.ARB_framebuffer_object
1086 case GL_LUMINANCE_ALPHA
:
1087 case GL_LUMINANCE4_ALPHA4
:
1088 case GL_LUMINANCE6_ALPHA2
:
1089 case GL_LUMINANCE8_ALPHA8
:
1090 case GL_LUMINANCE12_ALPHA4
:
1091 case GL_LUMINANCE12_ALPHA12
:
1092 case GL_LUMINANCE16_ALPHA16
:
1093 return ctx
->API
== API_OPENGL_COMPAT
&& ctx
->Extensions
.ARB_framebuffer_object
1094 ? GL_LUMINANCE_ALPHA
: 0;
1098 case GL_INTENSITY12
:
1099 case GL_INTENSITY16
:
1100 return ctx
->API
== API_OPENGL_COMPAT
&& ctx
->Extensions
.ARB_framebuffer_object
1111 return _mesa_is_desktop_gl(ctx
) ? GL_RGB
: 0;
1113 return _mesa_is_desktop_gl(ctx
) || _mesa_is_gles3(ctx
) ? GL_RGB
: 0;
1122 return _mesa_is_desktop_gl(ctx
) ? GL_RGBA
: 0;
1124 case GL_SRGB8_ALPHA8_EXT
:
1125 return _mesa_is_desktop_gl(ctx
) || _mesa_is_gles3(ctx
) ? GL_RGBA
: 0;
1126 case GL_STENCIL_INDEX
:
1127 case GL_STENCIL_INDEX1_EXT
:
1128 case GL_STENCIL_INDEX4_EXT
:
1129 case GL_STENCIL_INDEX16_EXT
:
1130 /* There are extensions for GL_STENCIL_INDEX1 and GL_STENCIL_INDEX4 in
1131 * OpenGL ES, but Mesa does not currently support them.
1133 return _mesa_is_desktop_gl(ctx
) ? GL_STENCIL_INDEX
: 0;
1134 case GL_STENCIL_INDEX8_EXT
:
1135 return GL_STENCIL_INDEX
;
1136 case GL_DEPTH_COMPONENT
:
1137 case GL_DEPTH_COMPONENT32
:
1138 return _mesa_is_desktop_gl(ctx
) ? GL_DEPTH_COMPONENT
: 0;
1139 case GL_DEPTH_COMPONENT16
:
1140 case GL_DEPTH_COMPONENT24
:
1141 return GL_DEPTH_COMPONENT
;
1142 case GL_DEPTH_STENCIL_EXT
:
1143 return _mesa_is_desktop_gl(ctx
)
1144 && ctx
->Extensions
.EXT_packed_depth_stencil
1145 ? GL_DEPTH_STENCIL_EXT
: 0;
1146 case GL_DEPTH24_STENCIL8_EXT
:
1147 return ctx
->Extensions
.EXT_packed_depth_stencil
1148 ? GL_DEPTH_STENCIL_EXT
: 0;
1149 case GL_DEPTH_COMPONENT32F
:
1150 return ctx
->Version
>= 30
1151 || (ctx
->API
== API_OPENGL_COMPAT
&& ctx
->Extensions
.ARB_depth_buffer_float
)
1152 ? GL_DEPTH_COMPONENT
: 0;
1153 case GL_DEPTH32F_STENCIL8
:
1154 return ctx
->Version
>= 30
1155 || (ctx
->API
== API_OPENGL_COMPAT
&& ctx
->Extensions
.ARB_depth_buffer_float
)
1156 ? GL_DEPTH_STENCIL
: 0;
1159 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.ARB_texture_rg
1162 return ctx
->API
!= API_OPENGLES
&& ctx
->Extensions
.ARB_texture_rg
1166 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.ARB_texture_rg
1169 return ctx
->API
!= API_OPENGLES
&& ctx
->Extensions
.ARB_texture_rg
1171 /* signed normalized texture formats */
1175 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.EXT_texture_snorm
1180 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.EXT_texture_snorm
1184 case GL_RGB16_SNORM
:
1185 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.EXT_texture_snorm
1188 case GL_RGBA8_SNORM
:
1189 case GL_RGBA16_SNORM
:
1190 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.EXT_texture_snorm
1192 case GL_ALPHA_SNORM
:
1193 case GL_ALPHA8_SNORM
:
1194 case GL_ALPHA16_SNORM
:
1195 return ctx
->API
== API_OPENGL_COMPAT
&&
1196 ctx
->Extensions
.EXT_texture_snorm
&&
1197 ctx
->Extensions
.ARB_framebuffer_object
? GL_ALPHA
: 0;
1200 return ctx
->Version
>= 30
1201 || (ctx
->API
== API_OPENGL_COMPAT
&&
1202 ctx
->Extensions
.ARB_texture_rg
&&
1203 ctx
->Extensions
.ARB_texture_float
) ? GL_RED
: 0;
1206 return ctx
->Version
>= 30
1207 || (ctx
->API
== API_OPENGL_COMPAT
&&
1208 ctx
->Extensions
.ARB_texture_rg
&&
1209 ctx
->Extensions
.ARB_texture_float
) ? GL_RG
: 0;
1212 return (_mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.ARB_texture_float
)
1213 || _mesa_is_gles3(ctx
)
1217 return (_mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.ARB_texture_float
)
1218 || _mesa_is_gles3(ctx
)
1220 case GL_ALPHA16F_ARB
:
1221 case GL_ALPHA32F_ARB
:
1222 return ctx
->API
== API_OPENGL_COMPAT
&&
1223 ctx
->Extensions
.ARB_texture_float
&&
1224 ctx
->Extensions
.ARB_framebuffer_object
? GL_ALPHA
: 0;
1225 case GL_LUMINANCE16F_ARB
:
1226 case GL_LUMINANCE32F_ARB
:
1227 return ctx
->API
== API_OPENGL_COMPAT
&&
1228 ctx
->Extensions
.ARB_texture_float
&&
1229 ctx
->Extensions
.ARB_framebuffer_object
? GL_LUMINANCE
: 0;
1230 case GL_LUMINANCE_ALPHA16F_ARB
:
1231 case GL_LUMINANCE_ALPHA32F_ARB
:
1232 return ctx
->API
== API_OPENGL_COMPAT
&&
1233 ctx
->Extensions
.ARB_texture_float
&&
1234 ctx
->Extensions
.ARB_framebuffer_object
? GL_LUMINANCE_ALPHA
: 0;
1235 case GL_INTENSITY16F_ARB
:
1236 case GL_INTENSITY32F_ARB
:
1237 return ctx
->API
== API_OPENGL_COMPAT
&&
1238 ctx
->Extensions
.ARB_texture_float
&&
1239 ctx
->Extensions
.ARB_framebuffer_object
? GL_INTENSITY
: 0;
1241 return (_mesa_is_desktop_gl(ctx
)
1242 && ctx
->Extensions
.EXT_texture_shared_exponent
)
1243 || _mesa_is_gles3(ctx
) ? GL_RGB
: 0;
1244 case GL_R11F_G11F_B10F
:
1245 return (_mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.EXT_packed_float
)
1246 || _mesa_is_gles3(ctx
) ? GL_RGB
: 0;
1248 case GL_RGBA8UI_EXT
:
1249 case GL_RGBA16UI_EXT
:
1250 case GL_RGBA32UI_EXT
:
1252 case GL_RGBA16I_EXT
:
1253 case GL_RGBA32I_EXT
:
1254 return ctx
->Version
>= 30
1255 || (_mesa_is_desktop_gl(ctx
) &&
1256 ctx
->Extensions
.EXT_texture_integer
) ? GL_RGBA
: 0;
1259 case GL_RGB16UI_EXT
:
1260 case GL_RGB32UI_EXT
:
1264 return _mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.EXT_texture_integer
1272 return ctx
->Version
>= 30
1273 || (_mesa_is_desktop_gl(ctx
) &&
1274 ctx
->Extensions
.ARB_texture_rg
&&
1275 ctx
->Extensions
.EXT_texture_integer
) ? GL_RED
: 0;
1283 return ctx
->Version
>= 30
1284 || (_mesa_is_desktop_gl(ctx
) &&
1285 ctx
->Extensions
.ARB_texture_rg
&&
1286 ctx
->Extensions
.EXT_texture_integer
) ? GL_RG
: 0;
1288 case GL_INTENSITY8I_EXT
:
1289 case GL_INTENSITY8UI_EXT
:
1290 case GL_INTENSITY16I_EXT
:
1291 case GL_INTENSITY16UI_EXT
:
1292 case GL_INTENSITY32I_EXT
:
1293 case GL_INTENSITY32UI_EXT
:
1294 return ctx
->API
== API_OPENGL_COMPAT
&&
1295 ctx
->Extensions
.EXT_texture_integer
&&
1296 ctx
->Extensions
.ARB_framebuffer_object
? GL_INTENSITY
: 0;
1298 case GL_LUMINANCE8I_EXT
:
1299 case GL_LUMINANCE8UI_EXT
:
1300 case GL_LUMINANCE16I_EXT
:
1301 case GL_LUMINANCE16UI_EXT
:
1302 case GL_LUMINANCE32I_EXT
:
1303 case GL_LUMINANCE32UI_EXT
:
1304 return ctx
->API
== API_OPENGL_COMPAT
&&
1305 ctx
->Extensions
.EXT_texture_integer
&&
1306 ctx
->Extensions
.ARB_framebuffer_object
? GL_LUMINANCE
: 0;
1308 case GL_LUMINANCE_ALPHA8I_EXT
:
1309 case GL_LUMINANCE_ALPHA8UI_EXT
:
1310 case GL_LUMINANCE_ALPHA16I_EXT
:
1311 case GL_LUMINANCE_ALPHA16UI_EXT
:
1312 case GL_LUMINANCE_ALPHA32I_EXT
:
1313 case GL_LUMINANCE_ALPHA32UI_EXT
:
1314 return ctx
->API
== API_OPENGL_COMPAT
&&
1315 ctx
->Extensions
.EXT_texture_integer
&&
1316 ctx
->Extensions
.ARB_framebuffer_object
? GL_LUMINANCE_ALPHA
: 0;
1318 case GL_ALPHA8I_EXT
:
1319 case GL_ALPHA8UI_EXT
:
1320 case GL_ALPHA16I_EXT
:
1321 case GL_ALPHA16UI_EXT
:
1322 case GL_ALPHA32I_EXT
:
1323 case GL_ALPHA32UI_EXT
:
1324 return ctx
->API
== API_OPENGL_COMPAT
&&
1325 ctx
->Extensions
.EXT_texture_integer
&&
1326 ctx
->Extensions
.ARB_framebuffer_object
? GL_ALPHA
: 0;
1329 return (_mesa_is_desktop_gl(ctx
) &&
1330 ctx
->Extensions
.ARB_texture_rgb10_a2ui
)
1331 || _mesa_is_gles3(ctx
) ? GL_RGBA
: 0;
1334 return _mesa_is_gles(ctx
) || ctx
->Extensions
.ARB_ES2_compatibility
1343 * Invalidate a renderbuffer attachment. Called from _mesa_HashWalk().
1346 invalidate_rb(GLuint key
, void *data
, void *userData
)
1348 struct gl_framebuffer
*fb
= (struct gl_framebuffer
*) data
;
1349 struct gl_renderbuffer
*rb
= (struct gl_renderbuffer
*) userData
;
1351 /* If this is a user-created FBO */
1352 if (_mesa_is_user_fbo(fb
)) {
1354 for (i
= 0; i
< BUFFER_COUNT
; i
++) {
1355 struct gl_renderbuffer_attachment
*att
= fb
->Attachment
+ i
;
1356 if (att
->Type
== GL_RENDERBUFFER
&&
1357 att
->Renderbuffer
== rb
) {
1358 /* Mark fb status as indeterminate to force re-validation */
1367 /** sentinal value, see below */
1368 #define NO_SAMPLES 1000
1372 * Helper function used by _mesa_RenderbufferStorage() and
1373 * _mesa_RenderbufferStorageMultisample().
1374 * samples will be NO_SAMPLES if called by _mesa_RenderbufferStorage().
1377 renderbuffer_storage(GLenum target
, GLenum internalFormat
,
1378 GLsizei width
, GLsizei height
, GLsizei samples
)
1380 const char *func
= samples
== NO_SAMPLES
?
1381 "glRenderbufferStorage" : "RenderbufferStorageMultisample";
1382 struct gl_renderbuffer
*rb
;
1384 GET_CURRENT_CONTEXT(ctx
);
1386 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1388 if (target
!= GL_RENDERBUFFER_EXT
) {
1389 _mesa_error(ctx
, GL_INVALID_ENUM
, "%s(target)", func
);
1393 baseFormat
= _mesa_base_fbo_format(ctx
, internalFormat
);
1394 if (baseFormat
== 0) {
1395 _mesa_error(ctx
, GL_INVALID_ENUM
, "%s(internalFormat)", func
);
1399 if (width
< 0 || width
> (GLsizei
) ctx
->Const
.MaxRenderbufferSize
) {
1400 _mesa_error(ctx
, GL_INVALID_VALUE
, "%s(width)", func
);
1404 if (height
< 0 || height
> (GLsizei
) ctx
->Const
.MaxRenderbufferSize
) {
1405 _mesa_error(ctx
, GL_INVALID_VALUE
, "%s(height)", func
);
1409 if (samples
== NO_SAMPLES
) {
1410 /* NumSamples == 0 indicates non-multisampling */
1413 else if (samples
> (GLsizei
) ctx
->Const
.MaxSamples
) {
1414 /* note: driver may choose to use more samples than what's requested */
1415 _mesa_error(ctx
, GL_INVALID_VALUE
, "%s(samples)", func
);
1419 rb
= ctx
->CurrentRenderbuffer
;
1421 _mesa_error(ctx
, GL_INVALID_OPERATION
, "%s", func
);
1425 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
1427 if (rb
->InternalFormat
== internalFormat
&&
1428 rb
->Width
== (GLuint
) width
&&
1429 rb
->Height
== (GLuint
) height
&&
1430 rb
->NumSamples
== samples
) {
1431 /* no change in allocation needed */
1435 /* These MUST get set by the AllocStorage func */
1436 rb
->Format
= MESA_FORMAT_NONE
;
1437 rb
->NumSamples
= samples
;
1439 /* Now allocate the storage */
1440 ASSERT(rb
->AllocStorage
);
1441 if (rb
->AllocStorage(ctx
, rb
, internalFormat
, width
, height
)) {
1442 /* No error - check/set fields now */
1443 /* If rb->Format == MESA_FORMAT_NONE, the format is unsupported. */
1444 assert(rb
->Width
== (GLuint
) width
);
1445 assert(rb
->Height
== (GLuint
) height
);
1446 rb
->InternalFormat
= internalFormat
;
1447 rb
->_BaseFormat
= baseFormat
;
1448 assert(rb
->_BaseFormat
!= 0);
1451 /* Probably ran out of memory - clear the fields */
1454 rb
->Format
= MESA_FORMAT_NONE
;
1455 rb
->InternalFormat
= GL_NONE
;
1456 rb
->_BaseFormat
= GL_NONE
;
1460 /* Invalidate the framebuffers the renderbuffer is attached in. */
1461 if (rb
->AttachedAnytime
) {
1462 _mesa_HashWalk(ctx
->Shared
->FrameBuffers
, invalidate_rb
, rb
);
1468 _mesa_EGLImageTargetRenderbufferStorageOES(GLenum target
, GLeglImageOES image
)
1470 struct gl_renderbuffer
*rb
;
1471 GET_CURRENT_CONTEXT(ctx
);
1472 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1474 if (!ctx
->Extensions
.OES_EGL_image
) {
1475 _mesa_error(ctx
, GL_INVALID_OPERATION
,
1476 "glEGLImageTargetRenderbufferStorageOES(unsupported)");
1480 if (target
!= GL_RENDERBUFFER
) {
1481 _mesa_error(ctx
, GL_INVALID_ENUM
,
1482 "EGLImageTargetRenderbufferStorageOES");
1486 rb
= ctx
->CurrentRenderbuffer
;
1488 _mesa_error(ctx
, GL_INVALID_OPERATION
,
1489 "EGLImageTargetRenderbufferStorageOES");
1493 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
1495 ctx
->Driver
.EGLImageTargetRenderbufferStorage(ctx
, rb
, image
);
1500 * Helper function for _mesa_GetRenderbufferParameteriv() and
1501 * _mesa_GetFramebufferAttachmentParameteriv()
1502 * We have to be careful to respect the base format. For example, if a
1503 * renderbuffer/texture was created with internalFormat=GL_RGB but the
1504 * driver actually chose a GL_RGBA format, when the user queries ALPHA_SIZE
1505 * we need to return zero.
1508 get_component_bits(GLenum pname
, GLenum baseFormat
, gl_format format
)
1510 if (_mesa_base_format_has_channel(baseFormat
, pname
))
1511 return _mesa_get_format_bits(format
, pname
);
1519 _mesa_RenderbufferStorage(GLenum target
, GLenum internalFormat
,
1520 GLsizei width
, GLsizei height
)
1522 /* GL_ARB_fbo says calling this function is equivalent to calling
1523 * glRenderbufferStorageMultisample() with samples=0. We pass in
1524 * a token value here just for error reporting purposes.
1526 renderbuffer_storage(target
, internalFormat
, width
, height
, NO_SAMPLES
);
1531 _mesa_RenderbufferStorageMultisample(GLenum target
, GLsizei samples
,
1532 GLenum internalFormat
,
1533 GLsizei width
, GLsizei height
)
1535 renderbuffer_storage(target
, internalFormat
, width
, height
, samples
);
1540 * OpenGL ES version of glRenderBufferStorage.
1543 _es_RenderbufferStorageEXT(GLenum target
, GLenum internalFormat
,
1544 GLsizei width
, GLsizei height
)
1546 switch (internalFormat
) {
1548 /* XXX this confuses GL_RENDERBUFFER_INTERNAL_FORMAT_OES */
1549 /* choose a closest format */
1550 internalFormat
= GL_RGB5
;
1556 renderbuffer_storage(target
, internalFormat
, width
, height
, 0);
1561 _mesa_GetRenderbufferParameteriv(GLenum target
, GLenum pname
, GLint
*params
)
1563 struct gl_renderbuffer
*rb
;
1564 GET_CURRENT_CONTEXT(ctx
);
1566 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1568 if (target
!= GL_RENDERBUFFER_EXT
) {
1569 _mesa_error(ctx
, GL_INVALID_ENUM
,
1570 "glGetRenderbufferParameterivEXT(target)");
1574 rb
= ctx
->CurrentRenderbuffer
;
1576 _mesa_error(ctx
, GL_INVALID_OPERATION
,
1577 "glGetRenderbufferParameterivEXT");
1581 /* No need to flush here since we're just quering state which is
1582 * not effected by rendering.
1586 case GL_RENDERBUFFER_WIDTH_EXT
:
1587 *params
= rb
->Width
;
1589 case GL_RENDERBUFFER_HEIGHT_EXT
:
1590 *params
= rb
->Height
;
1592 case GL_RENDERBUFFER_INTERNAL_FORMAT_EXT
:
1593 *params
= rb
->InternalFormat
;
1595 case GL_RENDERBUFFER_RED_SIZE_EXT
:
1596 case GL_RENDERBUFFER_GREEN_SIZE_EXT
:
1597 case GL_RENDERBUFFER_BLUE_SIZE_EXT
:
1598 case GL_RENDERBUFFER_ALPHA_SIZE_EXT
:
1599 case GL_RENDERBUFFER_DEPTH_SIZE_EXT
:
1600 case GL_RENDERBUFFER_STENCIL_SIZE_EXT
:
1601 *params
= get_component_bits(pname
, rb
->_BaseFormat
, rb
->Format
);
1603 case GL_RENDERBUFFER_SAMPLES
:
1604 if ((_mesa_is_desktop_gl(ctx
) && ctx
->Extensions
.ARB_framebuffer_object
)
1605 || _mesa_is_gles3(ctx
)) {
1606 *params
= rb
->NumSamples
;
1611 _mesa_error(ctx
, GL_INVALID_ENUM
,
1612 "glGetRenderbufferParameterivEXT(target)");
1618 GLboolean GLAPIENTRY
1619 _mesa_IsFramebuffer(GLuint framebuffer
)
1621 GET_CURRENT_CONTEXT(ctx
);
1622 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx
, GL_FALSE
);
1624 struct gl_framebuffer
*rb
= _mesa_lookup_framebuffer(ctx
, framebuffer
);
1625 if (rb
!= NULL
&& rb
!= &DummyFramebuffer
)
1633 * Check if any of the attachments of the given framebuffer are textures
1634 * (render to texture). Call ctx->Driver.RenderTexture() for such
1638 check_begin_texture_render(struct gl_context
*ctx
, struct gl_framebuffer
*fb
)
1641 ASSERT(ctx
->Driver
.RenderTexture
);
1643 if (_mesa_is_winsys_fbo(fb
))
1644 return; /* can't render to texture with winsys framebuffers */
1646 for (i
= 0; i
< BUFFER_COUNT
; i
++) {
1647 struct gl_renderbuffer_attachment
*att
= fb
->Attachment
+ i
;
1648 if (att
->Texture
&& _mesa_get_attachment_teximage(att
)) {
1649 ctx
->Driver
.RenderTexture(ctx
, fb
, att
);
1656 * Examine all the framebuffer's attachments to see if any are textures.
1657 * If so, call ctx->Driver.FinishRenderTexture() for each texture to
1658 * notify the device driver that the texture image may have changed.
1661 check_end_texture_render(struct gl_context
*ctx
, struct gl_framebuffer
*fb
)
1663 if (_mesa_is_winsys_fbo(fb
))
1664 return; /* can't render to texture with winsys framebuffers */
1666 if (ctx
->Driver
.FinishRenderTexture
) {
1668 for (i
= 0; i
< BUFFER_COUNT
; i
++) {
1669 struct gl_renderbuffer_attachment
*att
= fb
->Attachment
+ i
;
1670 if (att
->Texture
&& att
->Renderbuffer
) {
1671 ctx
->Driver
.FinishRenderTexture(ctx
, att
);
1679 _mesa_BindFramebuffer(GLenum target
, GLuint framebuffer
)
1681 struct gl_framebuffer
*newDrawFb
, *newReadFb
;
1682 struct gl_framebuffer
*oldDrawFb
, *oldReadFb
;
1683 GLboolean bindReadBuf
, bindDrawBuf
;
1684 GET_CURRENT_CONTEXT(ctx
);
1687 if (ctx
->Extensions
.ARB_framebuffer_object
) {
1688 ASSERT(ctx
->Extensions
.EXT_framebuffer_object
);
1689 ASSERT(ctx
->Extensions
.EXT_framebuffer_blit
);
1693 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1695 if (!ctx
->Extensions
.EXT_framebuffer_object
) {
1696 _mesa_error(ctx
, GL_INVALID_OPERATION
,
1697 "glBindFramebufferEXT(unsupported)");
1702 case GL_DRAW_FRAMEBUFFER_EXT
:
1703 if (!ctx
->Extensions
.EXT_framebuffer_blit
) {
1704 _mesa_error(ctx
, GL_INVALID_ENUM
, "glBindFramebufferEXT(target)");
1707 bindDrawBuf
= GL_TRUE
;
1708 bindReadBuf
= GL_FALSE
;
1710 case GL_READ_FRAMEBUFFER_EXT
:
1711 if (!ctx
->Extensions
.EXT_framebuffer_blit
) {
1712 _mesa_error(ctx
, GL_INVALID_ENUM
, "glBindFramebufferEXT(target)");
1715 bindDrawBuf
= GL_FALSE
;
1716 bindReadBuf
= GL_TRUE
;
1718 case GL_FRAMEBUFFER_EXT
:
1719 bindDrawBuf
= GL_TRUE
;
1720 bindReadBuf
= GL_TRUE
;
1723 _mesa_error(ctx
, GL_INVALID_ENUM
, "glBindFramebufferEXT(target)");
1728 /* Binding a user-created framebuffer object */
1729 newDrawFb
= _mesa_lookup_framebuffer(ctx
, framebuffer
);
1730 if (newDrawFb
== &DummyFramebuffer
) {
1731 /* ID was reserved, but no real framebuffer object made yet */
1735 && _mesa_is_desktop_gl(ctx
)
1736 && ctx
->Extensions
.ARB_framebuffer_object
) {
1737 /* All FBO IDs must be Gen'd */
1738 _mesa_error(ctx
, GL_INVALID_OPERATION
, "glBindFramebuffer(buffer)");
1743 /* create new framebuffer object */
1744 newDrawFb
= ctx
->Driver
.NewFramebuffer(ctx
, framebuffer
);
1746 _mesa_error(ctx
, GL_OUT_OF_MEMORY
, "glBindFramebufferEXT");
1749 _mesa_HashInsert(ctx
->Shared
->FrameBuffers
, framebuffer
, newDrawFb
);
1751 newReadFb
= newDrawFb
;
1754 /* Binding the window system framebuffer (which was originally set
1755 * with MakeCurrent).
1757 newDrawFb
= ctx
->WinSysDrawBuffer
;
1758 newReadFb
= ctx
->WinSysReadBuffer
;
1762 ASSERT(newDrawFb
!= &DummyFramebuffer
);
1764 /* save pointers to current/old framebuffers */
1765 oldDrawFb
= ctx
->DrawBuffer
;
1766 oldReadFb
= ctx
->ReadBuffer
;
1768 /* check if really changing bindings */
1769 if (oldDrawFb
== newDrawFb
)
1770 bindDrawBuf
= GL_FALSE
;
1771 if (oldReadFb
== newReadFb
)
1772 bindReadBuf
= GL_FALSE
;
1775 * OK, now bind the new Draw/Read framebuffers, if they're changing.
1777 * We also check if we're beginning and/or ending render-to-texture.
1778 * When a framebuffer with texture attachments is unbound, call
1779 * ctx->Driver.FinishRenderTexture().
1780 * When a framebuffer with texture attachments is bound, call
1781 * ctx->Driver.RenderTexture().
1783 * Note that if the ReadBuffer has texture attachments we don't consider
1784 * that a render-to-texture case.
1787 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
1789 /* check if old readbuffer was render-to-texture */
1790 check_end_texture_render(ctx
, oldReadFb
);
1792 _mesa_reference_framebuffer(&ctx
->ReadBuffer
, newReadFb
);
1796 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
1798 /* check if old framebuffer had any texture attachments */
1800 check_end_texture_render(ctx
, oldDrawFb
);
1802 /* check if newly bound framebuffer has any texture attachments */
1803 check_begin_texture_render(ctx
, newDrawFb
);
1805 _mesa_reference_framebuffer(&ctx
->DrawBuffer
, newDrawFb
);
1808 if ((bindDrawBuf
|| bindReadBuf
) && ctx
->Driver
.BindFramebuffer
) {
1809 ctx
->Driver
.BindFramebuffer(ctx
, target
, newDrawFb
, newReadFb
);
1815 _mesa_DeleteFramebuffers(GLsizei n
, const GLuint
*framebuffers
)
1818 GET_CURRENT_CONTEXT(ctx
);
1820 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1821 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
1823 for (i
= 0; i
< n
; i
++) {
1824 if (framebuffers
[i
] > 0) {
1825 struct gl_framebuffer
*fb
;
1826 fb
= _mesa_lookup_framebuffer(ctx
, framebuffers
[i
]);
1828 ASSERT(fb
== &DummyFramebuffer
|| fb
->Name
== framebuffers
[i
]);
1830 /* check if deleting currently bound framebuffer object */
1831 if (ctx
->Extensions
.EXT_framebuffer_blit
) {
1832 /* separate draw/read binding points */
1833 if (fb
== ctx
->DrawBuffer
) {
1835 ASSERT(fb
->RefCount
>= 2);
1836 _mesa_BindFramebuffer(GL_DRAW_FRAMEBUFFER_EXT
, 0);
1838 if (fb
== ctx
->ReadBuffer
) {
1840 ASSERT(fb
->RefCount
>= 2);
1841 _mesa_BindFramebuffer(GL_READ_FRAMEBUFFER_EXT
, 0);
1845 /* only one binding point for read/draw buffers */
1846 if (fb
== ctx
->DrawBuffer
|| fb
== ctx
->ReadBuffer
) {
1848 ASSERT(fb
->RefCount
>= 2);
1849 _mesa_BindFramebuffer(GL_FRAMEBUFFER_EXT
, 0);
1853 /* remove from hash table immediately, to free the ID */
1854 _mesa_HashRemove(ctx
->Shared
->FrameBuffers
, framebuffers
[i
]);
1856 if (fb
!= &DummyFramebuffer
) {
1857 /* But the object will not be freed until it's no longer
1858 * bound in any context.
1860 _mesa_reference_framebuffer(&fb
, NULL
);
1869 _mesa_GenFramebuffers(GLsizei n
, GLuint
*framebuffers
)
1871 GET_CURRENT_CONTEXT(ctx
);
1875 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1878 _mesa_error(ctx
, GL_INVALID_VALUE
, "glGenFramebuffersEXT(n)");
1885 first
= _mesa_HashFindFreeKeyBlock(ctx
->Shared
->FrameBuffers
, n
);
1887 for (i
= 0; i
< n
; i
++) {
1888 GLuint name
= first
+ i
;
1889 framebuffers
[i
] = name
;
1890 /* insert dummy placeholder into hash table */
1891 _glthread_LOCK_MUTEX(ctx
->Shared
->Mutex
);
1892 _mesa_HashInsert(ctx
->Shared
->FrameBuffers
, name
, &DummyFramebuffer
);
1893 _glthread_UNLOCK_MUTEX(ctx
->Shared
->Mutex
);
1900 _mesa_CheckFramebufferStatus(GLenum target
)
1902 struct gl_framebuffer
*buffer
;
1903 GET_CURRENT_CONTEXT(ctx
);
1905 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx
, 0);
1907 if (MESA_VERBOSE
& VERBOSE_API
)
1908 _mesa_debug(ctx
, "glCheckFramebufferStatus(%s)\n",
1909 _mesa_lookup_enum_by_nr(target
));
1911 buffer
= get_framebuffer_target(ctx
, target
);
1913 _mesa_error(ctx
, GL_INVALID_ENUM
, "glCheckFramebufferStatus(target)");
1917 if (_mesa_is_winsys_fbo(buffer
)) {
1918 /* The window system / default framebuffer is always complete */
1919 return GL_FRAMEBUFFER_COMPLETE_EXT
;
1922 /* No need to flush here */
1924 if (buffer
->_Status
!= GL_FRAMEBUFFER_COMPLETE
) {
1925 _mesa_test_framebuffer_completeness(ctx
, buffer
);
1928 return buffer
->_Status
;
1933 * Replicate the src attachment point. Used by framebuffer_texture() when
1934 * the same texture is attached at GL_DEPTH_ATTACHMENT and
1935 * GL_STENCIL_ATTACHMENT.
1938 reuse_framebuffer_texture_attachment(struct gl_framebuffer
*fb
,
1939 gl_buffer_index dst
,
1940 gl_buffer_index src
)
1942 struct gl_renderbuffer_attachment
*dst_att
= &fb
->Attachment
[dst
];
1943 struct gl_renderbuffer_attachment
*src_att
= &fb
->Attachment
[src
];
1945 assert(src_att
->Texture
!= NULL
);
1946 assert(src_att
->Renderbuffer
!= NULL
);
1948 _mesa_reference_texobj(&dst_att
->Texture
, src_att
->Texture
);
1949 _mesa_reference_renderbuffer(&dst_att
->Renderbuffer
, src_att
->Renderbuffer
);
1950 dst_att
->Type
= src_att
->Type
;
1951 dst_att
->Complete
= src_att
->Complete
;
1952 dst_att
->TextureLevel
= src_att
->TextureLevel
;
1953 dst_att
->Zoffset
= src_att
->Zoffset
;
1958 * Common code called by glFramebufferTexture1D/2D/3DEXT() and
1959 * glFramebufferTextureLayerEXT().
1960 * Note: glFramebufferTextureLayerEXT() has no textarget parameter so we'll
1961 * get textarget=0 in that case.
1964 framebuffer_texture(struct gl_context
*ctx
, const char *caller
, GLenum target
,
1965 GLenum attachment
, GLenum textarget
, GLuint texture
,
1966 GLint level
, GLint zoffset
)
1968 struct gl_renderbuffer_attachment
*att
;
1969 struct gl_texture_object
*texObj
= NULL
;
1970 struct gl_framebuffer
*fb
;
1971 GLenum maxLevelsTarget
;
1973 ASSERT_OUTSIDE_BEGIN_END(ctx
);
1975 fb
= get_framebuffer_target(ctx
, target
);
1977 _mesa_error(ctx
, GL_INVALID_ENUM
,
1978 "glFramebufferTexture%sEXT(target=0x%x)", caller
, target
);
1982 /* check framebuffer binding */
1983 if (_mesa_is_winsys_fbo(fb
)) {
1984 _mesa_error(ctx
, GL_INVALID_OPERATION
,
1985 "glFramebufferTexture%sEXT", caller
);
1989 /* The textarget, level, and zoffset parameters are only validated if
1990 * texture is non-zero.
1993 GLboolean err
= GL_TRUE
;
1995 texObj
= _mesa_lookup_texture(ctx
, texture
);
1996 if (texObj
!= NULL
) {
1997 if (textarget
== 0) {
1998 /* If textarget == 0 it means we're being called by
1999 * glFramebufferTextureLayer() and textarget is not used.
2000 * The only legal texture types for that function are 3D and
2001 * 1D/2D arrays textures.
2003 err
= (texObj
->Target
!= GL_TEXTURE_3D
) &&
2004 (texObj
->Target
!= GL_TEXTURE_1D_ARRAY_EXT
) &&
2005 (texObj
->Target
!= GL_TEXTURE_2D_ARRAY_EXT
) &&
2006 (texObj
->Target
!= GL_TEXTURE_CUBE_MAP_ARRAY
);
2009 /* Make sure textarget is consistent with the texture's type */
2010 err
= (texObj
->Target
== GL_TEXTURE_CUBE_MAP
)
2011 ? !_mesa_is_cube_face(textarget
)
2012 : (texObj
->Target
!= textarget
);
2016 /* can't render to a non-existant texture */
2017 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2018 "glFramebufferTexture%sEXT(non existant texture)",
2024 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2025 "glFramebufferTexture%sEXT(texture target mismatch)",
2030 if (texObj
->Target
== GL_TEXTURE_3D
) {
2031 const GLint maxSize
= 1 << (ctx
->Const
.Max3DTextureLevels
- 1);
2032 if (zoffset
< 0 || zoffset
>= maxSize
) {
2033 _mesa_error(ctx
, GL_INVALID_VALUE
,
2034 "glFramebufferTexture%sEXT(zoffset)", caller
);
2038 else if ((texObj
->Target
== GL_TEXTURE_1D_ARRAY_EXT
) ||
2039 (texObj
->Target
== GL_TEXTURE_2D_ARRAY_EXT
) ||
2040 (texObj
->Target
== GL_TEXTURE_CUBE_MAP_ARRAY
)) {
2042 zoffset
>= (GLint
) ctx
->Const
.MaxArrayTextureLayers
) {
2043 _mesa_error(ctx
, GL_INVALID_VALUE
,
2044 "glFramebufferTexture%sEXT(layer)", caller
);
2049 maxLevelsTarget
= textarget
? textarget
: texObj
->Target
;
2051 (level
>= _mesa_max_texture_levels(ctx
, maxLevelsTarget
))) {
2052 _mesa_error(ctx
, GL_INVALID_VALUE
,
2053 "glFramebufferTexture%sEXT(level)", caller
);
2058 att
= _mesa_get_attachment(ctx
, fb
, attachment
);
2060 _mesa_error(ctx
, GL_INVALID_ENUM
,
2061 "glFramebufferTexture%sEXT(attachment)", caller
);
2065 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
2067 _glthread_LOCK_MUTEX(fb
->Mutex
);
2069 if (attachment
== GL_DEPTH_ATTACHMENT
&&
2070 texObj
== fb
->Attachment
[BUFFER_STENCIL
].Texture
&&
2071 level
== fb
->Attachment
[BUFFER_STENCIL
].TextureLevel
&&
2072 _mesa_tex_target_to_face(textarget
) ==
2073 fb
->Attachment
[BUFFER_STENCIL
].CubeMapFace
&&
2074 zoffset
== fb
->Attachment
[BUFFER_STENCIL
].Zoffset
) {
2075 /* The texture object is already attached to the stencil attachment
2076 * point. Don't create a new renderbuffer; just reuse the stencil
2077 * attachment's. This is required to prevent a GL error in
2078 * glGetFramebufferAttachmentParameteriv(GL_DEPTH_STENCIL).
2080 reuse_framebuffer_texture_attachment(fb
, BUFFER_DEPTH
,
2082 } else if (attachment
== GL_STENCIL_ATTACHMENT
&&
2083 texObj
== fb
->Attachment
[BUFFER_DEPTH
].Texture
&&
2084 level
== fb
->Attachment
[BUFFER_DEPTH
].TextureLevel
&&
2085 _mesa_tex_target_to_face(textarget
) ==
2086 fb
->Attachment
[BUFFER_DEPTH
].CubeMapFace
&&
2087 zoffset
== fb
->Attachment
[BUFFER_DEPTH
].Zoffset
) {
2088 /* As above, but with depth and stencil transposed. */
2089 reuse_framebuffer_texture_attachment(fb
, BUFFER_STENCIL
,
2092 _mesa_set_texture_attachment(ctx
, fb
, att
, texObj
, textarget
,
2094 if (attachment
== GL_DEPTH_STENCIL_ATTACHMENT
) {
2095 /* Above we created a new renderbuffer and attached it to the
2096 * depth attachment point. Now attach it to the stencil attachment
2099 assert(att
== &fb
->Attachment
[BUFFER_DEPTH
]);
2100 reuse_framebuffer_texture_attachment(fb
,BUFFER_STENCIL
,
2105 /* Set the render-to-texture flag. We'll check this flag in
2106 * glTexImage() and friends to determine if we need to revalidate
2107 * any FBOs that might be rendering into this texture.
2108 * This flag never gets cleared since it's non-trivial to determine
2109 * when all FBOs might be done rendering to this texture. That's OK
2110 * though since it's uncommon to render to a texture then repeatedly
2111 * call glTexImage() to change images in the texture.
2113 texObj
->_RenderToTexture
= GL_TRUE
;
2116 _mesa_remove_attachment(ctx
, att
);
2117 if (attachment
== GL_DEPTH_STENCIL_ATTACHMENT
) {
2118 assert(att
== &fb
->Attachment
[BUFFER_DEPTH
]);
2119 _mesa_remove_attachment(ctx
, &fb
->Attachment
[BUFFER_STENCIL
]);
2123 invalidate_framebuffer(fb
);
2125 _glthread_UNLOCK_MUTEX(fb
->Mutex
);
2131 _mesa_FramebufferTexture1D(GLenum target
, GLenum attachment
,
2132 GLenum textarget
, GLuint texture
, GLint level
)
2134 GET_CURRENT_CONTEXT(ctx
);
2139 switch (textarget
) {
2143 case GL_TEXTURE_1D_ARRAY
:
2144 error
= !ctx
->Extensions
.EXT_texture_array
;
2151 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2152 "glFramebufferTexture1DEXT(textarget=%s)",
2153 _mesa_lookup_enum_by_nr(textarget
));
2158 framebuffer_texture(ctx
, "1D", target
, attachment
, textarget
, texture
,
2164 _mesa_FramebufferTexture2D(GLenum target
, GLenum attachment
,
2165 GLenum textarget
, GLuint texture
, GLint level
)
2167 GET_CURRENT_CONTEXT(ctx
);
2172 switch (textarget
) {
2176 case GL_TEXTURE_RECTANGLE
:
2177 error
= _mesa_is_gles(ctx
)
2178 || !ctx
->Extensions
.NV_texture_rectangle
;
2180 case GL_TEXTURE_CUBE_MAP_POSITIVE_X
:
2181 case GL_TEXTURE_CUBE_MAP_NEGATIVE_X
:
2182 case GL_TEXTURE_CUBE_MAP_POSITIVE_Y
:
2183 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Y
:
2184 case GL_TEXTURE_CUBE_MAP_POSITIVE_Z
:
2185 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Z
:
2186 error
= !ctx
->Extensions
.ARB_texture_cube_map
;
2188 case GL_TEXTURE_2D_ARRAY
:
2189 error
= (_mesa_is_gles(ctx
) && ctx
->Version
< 30)
2190 || !ctx
->Extensions
.EXT_texture_array
;
2197 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2198 "glFramebufferTexture2DEXT(textarget=%s)",
2199 _mesa_lookup_enum_by_nr(textarget
));
2204 framebuffer_texture(ctx
, "2D", target
, attachment
, textarget
, texture
,
2210 _mesa_FramebufferTexture3D(GLenum target
, GLenum attachment
,
2211 GLenum textarget
, GLuint texture
,
2212 GLint level
, GLint zoffset
)
2214 GET_CURRENT_CONTEXT(ctx
);
2216 if ((texture
!= 0) && (textarget
!= GL_TEXTURE_3D
)) {
2217 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2218 "glFramebufferTexture3DEXT(textarget)");
2222 framebuffer_texture(ctx
, "3D", target
, attachment
, textarget
, texture
,
2228 _mesa_FramebufferTextureLayer(GLenum target
, GLenum attachment
,
2229 GLuint texture
, GLint level
, GLint layer
)
2231 GET_CURRENT_CONTEXT(ctx
);
2233 framebuffer_texture(ctx
, "Layer", target
, attachment
, 0, texture
,
2239 _mesa_FramebufferRenderbuffer(GLenum target
, GLenum attachment
,
2240 GLenum renderbufferTarget
,
2241 GLuint renderbuffer
)
2243 struct gl_renderbuffer_attachment
*att
;
2244 struct gl_framebuffer
*fb
;
2245 struct gl_renderbuffer
*rb
;
2246 GET_CURRENT_CONTEXT(ctx
);
2248 ASSERT_OUTSIDE_BEGIN_END(ctx
);
2250 fb
= get_framebuffer_target(ctx
, target
);
2252 _mesa_error(ctx
, GL_INVALID_ENUM
, "glFramebufferRenderbufferEXT(target)");
2256 if (renderbufferTarget
!= GL_RENDERBUFFER_EXT
) {
2257 _mesa_error(ctx
, GL_INVALID_ENUM
,
2258 "glFramebufferRenderbufferEXT(renderbufferTarget)");
2262 if (_mesa_is_winsys_fbo(fb
)) {
2263 /* Can't attach new renderbuffers to a window system framebuffer */
2264 _mesa_error(ctx
, GL_INVALID_OPERATION
, "glFramebufferRenderbufferEXT");
2268 att
= _mesa_get_attachment(ctx
, fb
, attachment
);
2270 _mesa_error(ctx
, GL_INVALID_ENUM
,
2271 "glFramebufferRenderbufferEXT(invalid attachment %s)",
2272 _mesa_lookup_enum_by_nr(attachment
));
2277 rb
= _mesa_lookup_renderbuffer(ctx
, renderbuffer
);
2279 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2280 "glFramebufferRenderbufferEXT(non-existant"
2281 " renderbuffer %u)", renderbuffer
);
2284 else if (rb
== &DummyRenderbuffer
) {
2285 /* This is what NVIDIA does */
2286 _mesa_error(ctx
, GL_INVALID_VALUE
,
2287 "glFramebufferRenderbufferEXT(renderbuffer %u)",
2293 /* remove renderbuffer attachment */
2297 if (attachment
== GL_DEPTH_STENCIL_ATTACHMENT
&&
2298 rb
&& rb
->Format
!= MESA_FORMAT_NONE
) {
2299 /* make sure the renderbuffer is a depth/stencil format */
2300 const GLenum baseFormat
= _mesa_get_format_base_format(rb
->Format
);
2301 if (baseFormat
!= GL_DEPTH_STENCIL
) {
2302 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2303 "glFramebufferRenderbufferEXT(renderbuffer"
2304 " is not DEPTH_STENCIL format)");
2310 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
2312 assert(ctx
->Driver
.FramebufferRenderbuffer
);
2313 ctx
->Driver
.FramebufferRenderbuffer(ctx
, fb
, attachment
, rb
);
2315 /* Some subsequent GL commands may depend on the framebuffer's visual
2316 * after the binding is updated. Update visual info now.
2318 _mesa_update_framebuffer_visual(ctx
, fb
);
2323 _mesa_GetFramebufferAttachmentParameteriv(GLenum target
, GLenum attachment
,
2324 GLenum pname
, GLint
*params
)
2326 const struct gl_renderbuffer_attachment
*att
;
2327 struct gl_framebuffer
*buffer
;
2329 GET_CURRENT_CONTEXT(ctx
);
2331 ASSERT_OUTSIDE_BEGIN_END(ctx
);
2333 /* The error differs in GL and GLES. */
2334 err
= _mesa_is_desktop_gl(ctx
) ? GL_INVALID_OPERATION
: GL_INVALID_ENUM
;
2336 buffer
= get_framebuffer_target(ctx
, target
);
2338 _mesa_error(ctx
, GL_INVALID_ENUM
,
2339 "glGetFramebufferAttachmentParameterivEXT(target)");
2343 if (_mesa_is_winsys_fbo(buffer
)) {
2344 /* Page 126 (page 136 of the PDF) of the OpenGL ES 2.0.25 spec
2347 * "If the framebuffer currently bound to target is zero, then
2348 * INVALID_OPERATION is generated."
2350 * The EXT_framebuffer_object spec has the same wording, and the
2351 * OES_framebuffer_object spec refers to the EXT_framebuffer_object
2354 if (!_mesa_is_desktop_gl(ctx
) || !ctx
->Extensions
.ARB_framebuffer_object
) {
2355 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2356 "glGetFramebufferAttachmentParameteriv(bound FBO = 0)");
2359 /* the default / window-system FBO */
2360 att
= _mesa_get_fb0_attachment(ctx
, buffer
, attachment
);
2363 /* user-created framebuffer FBO */
2364 att
= _mesa_get_attachment(ctx
, buffer
, attachment
);
2368 _mesa_error(ctx
, GL_INVALID_ENUM
,
2369 "glGetFramebufferAttachmentParameterivEXT(attachment)");
2373 if (attachment
== GL_DEPTH_STENCIL_ATTACHMENT
) {
2374 /* the depth and stencil attachments must point to the same buffer */
2375 const struct gl_renderbuffer_attachment
*depthAtt
, *stencilAtt
;
2376 depthAtt
= _mesa_get_attachment(ctx
, buffer
, GL_DEPTH_ATTACHMENT
);
2377 stencilAtt
= _mesa_get_attachment(ctx
, buffer
, GL_STENCIL_ATTACHMENT
);
2378 if (depthAtt
->Renderbuffer
!= stencilAtt
->Renderbuffer
) {
2379 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2380 "glGetFramebufferAttachmentParameterivEXT(DEPTH/STENCIL"
2381 " attachments differ)");
2386 /* No need to flush here */
2389 case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_EXT
:
2390 *params
= _mesa_is_winsys_fbo(buffer
)
2391 ? GL_FRAMEBUFFER_DEFAULT
: att
->Type
;
2393 case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_EXT
:
2394 if (att
->Type
== GL_RENDERBUFFER_EXT
) {
2395 *params
= att
->Renderbuffer
->Name
;
2397 else if (att
->Type
== GL_TEXTURE
) {
2398 *params
= att
->Texture
->Name
;
2401 assert(att
->Type
== GL_NONE
);
2402 if (_mesa_is_desktop_gl(ctx
) || _mesa_is_gles3(ctx
)) {
2405 goto invalid_pname_enum
;
2409 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_EXT
:
2410 if (att
->Type
== GL_TEXTURE
) {
2411 *params
= att
->TextureLevel
;
2413 else if (att
->Type
== GL_NONE
) {
2414 _mesa_error(ctx
, err
,
2415 "glGetFramebufferAttachmentParameterivEXT(pname)");
2418 goto invalid_pname_enum
;
2421 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_EXT
:
2422 if (att
->Type
== GL_TEXTURE
) {
2423 if (att
->Texture
&& att
->Texture
->Target
== GL_TEXTURE_CUBE_MAP
) {
2424 *params
= GL_TEXTURE_CUBE_MAP_POSITIVE_X
+ att
->CubeMapFace
;
2430 else if (att
->Type
== GL_NONE
) {
2431 _mesa_error(ctx
, err
,
2432 "glGetFramebufferAttachmentParameterivEXT(pname)");
2435 goto invalid_pname_enum
;
2438 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_3D_ZOFFSET_EXT
:
2439 if (ctx
->API
== API_OPENGLES
) {
2440 goto invalid_pname_enum
;
2441 } else if (att
->Type
== GL_NONE
) {
2442 _mesa_error(ctx
, err
,
2443 "glGetFramebufferAttachmentParameterivEXT(pname)");
2444 } else if (att
->Type
== GL_TEXTURE
) {
2445 if (att
->Texture
&& att
->Texture
->Target
== GL_TEXTURE_3D
) {
2446 *params
= att
->Zoffset
;
2453 goto invalid_pname_enum
;
2456 case GL_FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING
:
2457 if ((!_mesa_is_desktop_gl(ctx
) || !ctx
->Extensions
.ARB_framebuffer_object
)
2458 && !_mesa_is_gles3(ctx
)) {
2459 goto invalid_pname_enum
;
2461 else if (att
->Type
== GL_NONE
) {
2462 _mesa_error(ctx
, err
,
2463 "glGetFramebufferAttachmentParameterivEXT(pname)");
2466 if (ctx
->Extensions
.EXT_framebuffer_sRGB
) {
2467 *params
= _mesa_get_format_color_encoding(att
->Renderbuffer
->Format
);
2470 /* According to ARB_framebuffer_sRGB, we should return LINEAR
2471 * if the sRGB conversion is unsupported. */
2472 *params
= GL_LINEAR
;
2476 case GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE
:
2477 if ((ctx
->API
!= API_OPENGL_COMPAT
|| !ctx
->Extensions
.ARB_framebuffer_object
)
2478 && ctx
->API
!= API_OPENGL_CORE
2479 && !_mesa_is_gles3(ctx
)) {
2480 goto invalid_pname_enum
;
2482 else if (att
->Type
== GL_NONE
) {
2483 _mesa_error(ctx
, err
,
2484 "glGetFramebufferAttachmentParameterivEXT(pname)");
2487 gl_format format
= att
->Renderbuffer
->Format
;
2488 if (format
== MESA_FORMAT_S8
) {
2492 else if (format
== MESA_FORMAT_Z32_FLOAT_X24S8
) {
2493 /* depends on the attachment parameter */
2494 if (attachment
== GL_STENCIL_ATTACHMENT
) {
2502 *params
= _mesa_get_format_datatype(format
);
2506 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE
:
2507 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE
:
2508 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE
:
2509 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE
:
2510 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE
:
2511 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE
:
2512 if ((!_mesa_is_desktop_gl(ctx
) || !ctx
->Extensions
.ARB_framebuffer_object
)
2513 && !_mesa_is_gles3(ctx
)) {
2514 goto invalid_pname_enum
;
2516 else if (att
->Type
== GL_NONE
) {
2517 _mesa_error(ctx
, err
,
2518 "glGetFramebufferAttachmentParameterivEXT(pname)");
2520 else if (att
->Texture
) {
2521 const struct gl_texture_image
*texImage
=
2522 _mesa_select_tex_image(ctx
, att
->Texture
, att
->Texture
->Target
,
2525 *params
= get_component_bits(pname
, texImage
->_BaseFormat
,
2526 texImage
->TexFormat
);
2532 else if (att
->Renderbuffer
) {
2533 *params
= get_component_bits(pname
, att
->Renderbuffer
->_BaseFormat
,
2534 att
->Renderbuffer
->Format
);
2537 _mesa_problem(ctx
, "glGetFramebufferAttachmentParameterivEXT:"
2538 " invalid FBO attachment structure");
2542 goto invalid_pname_enum
;
2548 _mesa_error(ctx
, GL_INVALID_ENUM
,
2549 "glGetFramebufferAttachmentParameteriv(pname)");
2555 _mesa_GenerateMipmap(GLenum target
)
2557 struct gl_texture_image
*srcImage
;
2558 struct gl_texture_object
*texObj
;
2561 GET_CURRENT_CONTEXT(ctx
);
2563 ASSERT_OUTSIDE_BEGIN_END(ctx
);
2564 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
2568 error
= _mesa_is_gles(ctx
);
2574 error
= ctx
->API
== API_OPENGLES
;
2576 case GL_TEXTURE_CUBE_MAP
:
2577 error
= !ctx
->Extensions
.ARB_texture_cube_map
;
2579 case GL_TEXTURE_1D_ARRAY
:
2580 error
= _mesa_is_gles(ctx
) || !ctx
->Extensions
.EXT_texture_array
;
2582 case GL_TEXTURE_2D_ARRAY
:
2583 error
= (_mesa_is_gles(ctx
) && ctx
->Version
< 30)
2584 || !ctx
->Extensions
.EXT_texture_array
;
2591 _mesa_error(ctx
, GL_INVALID_ENUM
, "glGenerateMipmapEXT(target=%s)",
2592 _mesa_lookup_enum_by_nr(target
));
2596 texObj
= _mesa_get_current_tex_object(ctx
, target
);
2598 if (texObj
->BaseLevel
>= texObj
->MaxLevel
) {
2603 if (texObj
->Target
== GL_TEXTURE_CUBE_MAP
&&
2604 !_mesa_cube_complete(texObj
)) {
2605 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2606 "glGenerateMipmap(incomplete cube map)");
2610 _mesa_lock_texture(ctx
, texObj
);
2612 srcImage
= _mesa_select_tex_image(ctx
, texObj
, target
, texObj
->BaseLevel
);
2614 _mesa_unlock_texture(ctx
, texObj
);
2615 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2616 "glGenerateMipmap(zero size base image)");
2620 if (_mesa_is_enum_format_integer(srcImage
->InternalFormat
) ||
2621 _mesa_is_depthstencil_format(srcImage
->InternalFormat
) ||
2622 _mesa_is_stencil_format(srcImage
->InternalFormat
)) {
2623 _mesa_unlock_texture(ctx
, texObj
);
2624 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2625 "glGenerateMipmap(invalid internal format)");
2629 if (target
== GL_TEXTURE_CUBE_MAP
) {
2631 for (face
= 0; face
< 6; face
++)
2632 ctx
->Driver
.GenerateMipmap(ctx
,
2633 GL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB
+ face
,
2637 ctx
->Driver
.GenerateMipmap(ctx
, target
, texObj
);
2639 _mesa_unlock_texture(ctx
, texObj
);
2643 static const struct gl_renderbuffer_attachment
*
2644 find_attachment(const struct gl_framebuffer
*fb
,
2645 const struct gl_renderbuffer
*rb
)
2648 for (i
= 0; i
< Elements(fb
->Attachment
); i
++) {
2649 if (fb
->Attachment
[i
].Renderbuffer
== rb
)
2650 return &fb
->Attachment
[i
];
2657 * Helper function for checking if the datatypes of color buffers are
2658 * compatible for glBlitFramebuffer. From the 3.1 spec, page 198:
2660 * "GL_INVALID_OPERATION is generated if mask contains GL_COLOR_BUFFER_BIT
2661 * and any of the following conditions hold:
2662 * - The read buffer contains fixed-point or floating-point values and any
2663 * draw buffer contains neither fixed-point nor floating-point values.
2664 * - The read buffer contains unsigned integer values and any draw buffer
2665 * does not contain unsigned integer values.
2666 * - The read buffer contains signed integer values and any draw buffer
2667 * does not contain signed integer values."
2670 compatible_color_datatypes(gl_format srcFormat
, gl_format dstFormat
)
2672 GLenum srcType
= _mesa_get_format_datatype(srcFormat
);
2673 GLenum dstType
= _mesa_get_format_datatype(dstFormat
);
2675 if (srcType
!= GL_INT
&& srcType
!= GL_UNSIGNED_INT
) {
2676 assert(srcType
== GL_UNSIGNED_NORMALIZED
||
2677 srcType
== GL_SIGNED_NORMALIZED
||
2678 srcType
== GL_FLOAT
);
2679 /* Boil any of those types down to GL_FLOAT */
2683 if (dstType
!= GL_INT
&& dstType
!= GL_UNSIGNED_INT
) {
2684 assert(dstType
== GL_UNSIGNED_NORMALIZED
||
2685 dstType
== GL_SIGNED_NORMALIZED
||
2686 dstType
== GL_FLOAT
);
2687 /* Boil any of those types down to GL_FLOAT */
2691 return srcType
== dstType
;
2696 compatible_resolve_formats(const struct gl_renderbuffer
*readRb
,
2697 const struct gl_renderbuffer
*drawRb
)
2699 GLenum readFormat
, drawFormat
;
2701 /* The simple case where we know the backing Mesa formats are the same.
2703 if (_mesa_get_srgb_format_linear(readRb
->Format
) ==
2704 _mesa_get_srgb_format_linear(drawRb
->Format
)) {
2708 /* The Mesa formats are different, so we must check whether the internal
2709 * formats are compatible.
2711 * Under some circumstances, the user may request e.g. two GL_RGBA8
2712 * textures and get two entirely different Mesa formats like RGBA8888 and
2713 * ARGB8888. Drivers behaving like that should be able to cope with
2714 * non-matching formats by themselves, because it's not the user's fault.
2716 * Blits between linear and sRGB formats are also allowed.
2718 readFormat
= _mesa_get_nongeneric_internalformat(readRb
->InternalFormat
);
2719 drawFormat
= _mesa_get_nongeneric_internalformat(drawRb
->InternalFormat
);
2720 readFormat
= _mesa_get_linear_internalformat(readFormat
);
2721 drawFormat
= _mesa_get_linear_internalformat(drawFormat
);
2723 if (readFormat
== drawFormat
) {
2732 * Blit rectangular region, optionally from one framebuffer to another.
2734 * Note, if the src buffer is multisampled and the dest is not, this is
2735 * when the samples must be resolved to a single color.
2738 _mesa_BlitFramebuffer(GLint srcX0
, GLint srcY0
, GLint srcX1
, GLint srcY1
,
2739 GLint dstX0
, GLint dstY0
, GLint dstX1
, GLint dstY1
,
2740 GLbitfield mask
, GLenum filter
)
2742 const GLbitfield legalMaskBits
= (GL_COLOR_BUFFER_BIT
|
2743 GL_DEPTH_BUFFER_BIT
|
2744 GL_STENCIL_BUFFER_BIT
);
2745 const struct gl_framebuffer
*readFb
, *drawFb
;
2746 const struct gl_renderbuffer
*colorReadRb
, *colorDrawRb
;
2747 GET_CURRENT_CONTEXT(ctx
);
2749 ASSERT_OUTSIDE_BEGIN_END(ctx
);
2750 FLUSH_VERTICES(ctx
, _NEW_BUFFERS
);
2752 if (MESA_VERBOSE
& VERBOSE_API
)
2754 "glBlitFramebuffer(%d, %d, %d, %d, %d, %d, %d, %d, 0x%x, %s)\n",
2755 srcX0
, srcY0
, srcX1
, srcY1
,
2756 dstX0
, dstY0
, dstX1
, dstY1
,
2757 mask
, _mesa_lookup_enum_by_nr(filter
));
2759 if (ctx
->NewState
) {
2760 _mesa_update_state(ctx
);
2763 readFb
= ctx
->ReadBuffer
;
2764 drawFb
= ctx
->DrawBuffer
;
2766 if (!readFb
|| !drawFb
) {
2767 /* This will normally never happen but someday we may want to
2768 * support MakeCurrent() with no drawables.
2773 /* check for complete framebuffers */
2774 if (drawFb
->_Status
!= GL_FRAMEBUFFER_COMPLETE_EXT
||
2775 readFb
->_Status
!= GL_FRAMEBUFFER_COMPLETE_EXT
) {
2776 _mesa_error(ctx
, GL_INVALID_FRAMEBUFFER_OPERATION_EXT
,
2777 "glBlitFramebufferEXT(incomplete draw/read buffers)");
2781 if (filter
!= GL_NEAREST
&& filter
!= GL_LINEAR
) {
2782 _mesa_error(ctx
, GL_INVALID_ENUM
, "glBlitFramebufferEXT(filter)");
2786 if (mask
& ~legalMaskBits
) {
2787 _mesa_error( ctx
, GL_INVALID_VALUE
, "glBlitFramebufferEXT(mask)");
2791 /* depth/stencil must be blitted with nearest filtering */
2792 if ((mask
& (GL_DEPTH_BUFFER_BIT
| GL_STENCIL_BUFFER_BIT
))
2793 && filter
!= GL_NEAREST
) {
2794 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2795 "glBlitFramebufferEXT(depth/stencil requires GL_NEAREST filter)");
2799 /* get color read/draw renderbuffers */
2800 if (mask
& GL_COLOR_BUFFER_BIT
) {
2801 colorReadRb
= readFb
->_ColorReadBuffer
;
2802 colorDrawRb
= drawFb
->_ColorDrawBuffers
[0];
2804 /* From the EXT_framebuffer_object spec:
2806 * "If a buffer is specified in <mask> and does not exist in both
2807 * the read and draw framebuffers, the corresponding bit is silently
2810 if ((colorReadRb
== NULL
) || (colorDrawRb
== NULL
)) {
2811 colorReadRb
= colorDrawRb
= NULL
;
2812 mask
&= ~GL_COLOR_BUFFER_BIT
;
2814 else if (!compatible_color_datatypes(colorReadRb
->Format
,
2815 colorDrawRb
->Format
)) {
2816 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2817 "glBlitFramebufferEXT(color buffer datatypes mismatch)");
2822 colorReadRb
= colorDrawRb
= NULL
;
2825 if (mask
& GL_STENCIL_BUFFER_BIT
) {
2826 struct gl_renderbuffer
*readRb
=
2827 readFb
->Attachment
[BUFFER_STENCIL
].Renderbuffer
;
2828 struct gl_renderbuffer
*drawRb
=
2829 drawFb
->Attachment
[BUFFER_STENCIL
].Renderbuffer
;
2831 /* From the EXT_framebuffer_object spec:
2833 * "If a buffer is specified in <mask> and does not exist in both
2834 * the read and draw framebuffers, the corresponding bit is silently
2837 if ((readRb
== NULL
) || (drawRb
== NULL
)) {
2838 mask
&= ~GL_STENCIL_BUFFER_BIT
;
2840 else if (_mesa_get_format_bits(readRb
->Format
, GL_STENCIL_BITS
) !=
2841 _mesa_get_format_bits(drawRb
->Format
, GL_STENCIL_BITS
)) {
2842 /* There is no need to check the stencil datatype here, because
2843 * there is only one: GL_UNSIGNED_INT.
2845 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2846 "glBlitFramebufferEXT(stencil buffer size mismatch)");
2851 if (mask
& GL_DEPTH_BUFFER_BIT
) {
2852 struct gl_renderbuffer
*readRb
=
2853 readFb
->Attachment
[BUFFER_DEPTH
].Renderbuffer
;
2854 struct gl_renderbuffer
*drawRb
=
2855 drawFb
->Attachment
[BUFFER_DEPTH
].Renderbuffer
;
2857 /* From the EXT_framebuffer_object spec:
2859 * "If a buffer is specified in <mask> and does not exist in both
2860 * the read and draw framebuffers, the corresponding bit is silently
2863 if ((readRb
== NULL
) || (drawRb
== NULL
)) {
2864 mask
&= ~GL_DEPTH_BUFFER_BIT
;
2866 else if ((_mesa_get_format_bits(readRb
->Format
, GL_DEPTH_BITS
) !=
2867 _mesa_get_format_bits(drawRb
->Format
, GL_DEPTH_BITS
)) ||
2868 (_mesa_get_format_datatype(readRb
->Format
) !=
2869 _mesa_get_format_datatype(drawRb
->Format
))) {
2870 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2871 "glBlitFramebufferEXT(depth buffer format mismatch)");
2876 if (readFb
->Visual
.samples
> 0 &&
2877 drawFb
->Visual
.samples
> 0 &&
2878 readFb
->Visual
.samples
!= drawFb
->Visual
.samples
) {
2879 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2880 "glBlitFramebufferEXT(mismatched samples)");
2884 /* extra checks for multisample copies... */
2885 if (readFb
->Visual
.samples
> 0 || drawFb
->Visual
.samples
> 0) {
2886 /* src and dest region sizes must be the same */
2887 if (abs(srcX1
- srcX0
) != abs(dstX1
- dstX0
) ||
2888 abs(srcY1
- srcY0
) != abs(dstY1
- dstY0
)) {
2889 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2890 "glBlitFramebufferEXT(bad src/dst multisample region sizes)");
2894 /* color formats must match */
2897 !compatible_resolve_formats(colorReadRb
, colorDrawRb
)) {
2898 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2899 "glBlitFramebufferEXT(bad src/dst multisample pixel formats)");
2904 if (filter
== GL_LINEAR
&& (mask
& GL_COLOR_BUFFER_BIT
)) {
2905 /* 3.1 spec, page 199:
2906 * "Calling BlitFramebuffer will result in an INVALID_OPERATION error
2907 * if filter is LINEAR and read buffer contains integer data."
2909 GLenum type
= _mesa_get_format_datatype(colorReadRb
->Format
);
2910 if (type
== GL_INT
|| type
== GL_UNSIGNED_INT
) {
2911 _mesa_error(ctx
, GL_INVALID_OPERATION
,
2912 "glBlitFramebufferEXT(integer color type)");
2917 if (!ctx
->Extensions
.EXT_framebuffer_blit
) {
2918 _mesa_error(ctx
, GL_INVALID_OPERATION
, "glBlitFramebufferEXT");
2924 printf("glBlitFramebuffer(%d, %d, %d, %d, %d, %d, %d, %d,"
2926 srcX0
, srcY0
, srcX1
, srcY1
,
2927 dstX0
, dstY0
, dstX1
, dstY1
,
2930 const struct gl_renderbuffer_attachment
*att
;
2932 att
= find_attachment(readFb
, colorReadRb
);
2933 printf(" Src FBO %u RB %u (%dx%d) ",
2934 readFb
->Name
, colorReadRb
->Name
,
2935 colorReadRb
->Width
, colorReadRb
->Height
);
2936 if (att
&& att
->Texture
) {
2937 printf("Tex %u tgt 0x%x level %u face %u",
2939 att
->Texture
->Target
,
2945 att
= find_attachment(drawFb
, colorDrawRb
);
2946 printf(" Dst FBO %u RB %u (%dx%d) ",
2947 drawFb
->Name
, colorDrawRb
->Name
,
2948 colorDrawRb
->Width
, colorDrawRb
->Height
);
2949 if (att
&& att
->Texture
) {
2950 printf("Tex %u tgt 0x%x level %u face %u",
2952 att
->Texture
->Target
,
2964 ASSERT(ctx
->Driver
.BlitFramebuffer
);
2965 ctx
->Driver
.BlitFramebuffer(ctx
,
2966 srcX0
, srcY0
, srcX1
, srcY1
,
2967 dstX0
, dstY0
, dstX1
, dstY1
,
2973 invalidate_framebuffer_storage(GLenum target
, GLsizei numAttachments
,
2974 const GLenum
*attachments
, GLint x
, GLint y
,
2975 GLsizei width
, GLsizei height
, const char *name
)
2978 struct gl_framebuffer
*fb
;
2979 GET_CURRENT_CONTEXT(ctx
);
2981 ASSERT_OUTSIDE_BEGIN_END(ctx
);
2983 fb
= get_framebuffer_target(ctx
, target
);
2985 _mesa_error(ctx
, GL_INVALID_ENUM
, "%s(target)", name
);
2989 if (numAttachments
< 0) {
2990 _mesa_error(ctx
, GL_INVALID_VALUE
,
2991 "%s(numAttachments < 0)", name
);
2995 /* The GL_ARB_invalidate_subdata spec says:
2997 * "If an attachment is specified that does not exist in the
2998 * framebuffer bound to <target>, it is ignored."
3002 * "If <attachments> contains COLOR_ATTACHMENTm and m is greater than
3003 * or equal to the value of MAX_COLOR_ATTACHMENTS, then the error
3004 * INVALID_OPERATION is generated."
3006 * No mention is made of GL_AUXi being out of range. Therefore, we allow
3007 * any enum that can be allowed by the API (OpenGL ES 3.0 has a different
3008 * set of retrictions).
3010 for (i
= 0; i
< numAttachments
; i
++) {
3011 if (_mesa_is_winsys_fbo(fb
)) {
3012 switch (attachments
[i
]) {
3018 /* Accumulation buffers and auxilary buffers were removed in
3019 * OpenGL 3.1, and they never existed in OpenGL ES.
3021 if (ctx
->API
!= API_OPENGL_COMPAT
)
3031 case GL_FRONT_RIGHT
:
3032 if (!_mesa_is_desktop_gl(ctx
))
3039 switch (attachments
[i
]) {
3040 case GL_DEPTH_ATTACHMENT
:
3041 case GL_STENCIL_ATTACHMENT
:
3043 case GL_COLOR_ATTACHMENT0
:
3044 case GL_COLOR_ATTACHMENT1
:
3045 case GL_COLOR_ATTACHMENT2
:
3046 case GL_COLOR_ATTACHMENT3
:
3047 case GL_COLOR_ATTACHMENT4
:
3048 case GL_COLOR_ATTACHMENT5
:
3049 case GL_COLOR_ATTACHMENT6
:
3050 case GL_COLOR_ATTACHMENT7
:
3051 case GL_COLOR_ATTACHMENT8
:
3052 case GL_COLOR_ATTACHMENT9
:
3053 case GL_COLOR_ATTACHMENT10
:
3054 case GL_COLOR_ATTACHMENT11
:
3055 case GL_COLOR_ATTACHMENT12
:
3056 case GL_COLOR_ATTACHMENT13
:
3057 case GL_COLOR_ATTACHMENT14
:
3058 case GL_COLOR_ATTACHMENT15
: {
3059 unsigned k
= attachments
[i
] - GL_COLOR_ATTACHMENT0
;
3060 if (k
>= ctx
->Const
.MaxColorAttachments
) {
3061 _mesa_error(ctx
, GL_INVALID_OPERATION
,
3062 "%s(attachment >= max. color attachments)", name
);
3072 /* We don't actually do anything for this yet. Just return after
3073 * validating the parameters and generating the required errors.
3078 _mesa_error(ctx
, GL_INVALID_ENUM
, "%s(attachment)", name
);
3083 _mesa_InvalidateSubFramebuffer(GLenum target
, GLsizei numAttachments
,
3084 const GLenum
*attachments
, GLint x
, GLint y
,
3085 GLsizei width
, GLsizei height
)
3087 invalidate_framebuffer_storage(target
, numAttachments
, attachments
,
3088 x
, y
, width
, height
,
3089 "glInvalidateSubFramebuffer");
3093 _mesa_InvalidateFramebuffer(GLenum target
, GLsizei numAttachments
,
3094 const GLenum
*attachments
)
3096 /* The GL_ARB_invalidate_subdata spec says:
3100 * void InvalidateFramebuffer(enum target,
3101 * sizei numAttachments,
3102 * const enum *attachments);
3104 * is equivalent to the command InvalidateSubFramebuffer with <x>, <y>,
3105 * <width>, <height> equal to 0, 0, <MAX_VIEWPORT_DIMS[0]>,
3106 * <MAX_VIEWPORT_DIMS[1]> respectively."
3108 invalidate_framebuffer_storage(target
, numAttachments
, attachments
,
3109 0, 0, MAX_VIEWPORT_WIDTH
, MAX_VIEWPORT_HEIGHT
,
3110 "glInvalidateFramebuffer");