glapi: define AMD_framebuffer_multisample_advanced and add its functions
[mesa.git] / src / mesa / main / fbobject.c
1 /*
2 * Mesa 3-D graphics library
3 *
4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
5 * Copyright (C) 1999-2009 VMware, Inc. All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
21 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
22 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23 * OTHER DEALINGS IN THE SOFTWARE.
24 */
25
26
27 /*
28 * GL_EXT/ARB_framebuffer_object extensions
29 *
30 * Authors:
31 * Brian Paul
32 */
33
34 #include <stdbool.h>
35
36 #include "buffers.h"
37 #include "context.h"
38 #include "debug_output.h"
39 #include "enums.h"
40 #include "fbobject.h"
41 #include "formats.h"
42 #include "framebuffer.h"
43 #include "glformats.h"
44 #include "hash.h"
45 #include "macros.h"
46 #include "multisample.h"
47 #include "mtypes.h"
48 #include "renderbuffer.h"
49 #include "state.h"
50 #include "teximage.h"
51 #include "texobj.h"
52
53
54 /**
55 * Notes:
56 *
57 * None of the GL_EXT_framebuffer_object functions are compiled into
58 * display lists.
59 */
60
61
62
63 /*
64 * When glGenRender/FramebuffersEXT() is called we insert pointers to
65 * these placeholder objects into the hash table.
66 * Later, when the object ID is first bound, we replace the placeholder
67 * with the real frame/renderbuffer.
68 */
69 static struct gl_framebuffer DummyFramebuffer;
70 static struct gl_renderbuffer DummyRenderbuffer;
71
72 /* We bind this framebuffer when applications pass a NULL
73 * drawable/surface in make current. */
74 static struct gl_framebuffer IncompleteFramebuffer;
75
76
77 static void
78 delete_dummy_renderbuffer(struct gl_context *ctx, struct gl_renderbuffer *rb)
79 {
80 /* no op */
81 }
82
83 static void
84 delete_dummy_framebuffer(struct gl_framebuffer *fb)
85 {
86 /* no op */
87 }
88
89
90 void
91 _mesa_init_fbobjects(struct gl_context *ctx)
92 {
93 simple_mtx_init(&DummyFramebuffer.Mutex, mtx_plain);
94 simple_mtx_init(&DummyRenderbuffer.Mutex, mtx_plain);
95 simple_mtx_init(&IncompleteFramebuffer.Mutex, mtx_plain);
96 DummyFramebuffer.Delete = delete_dummy_framebuffer;
97 DummyRenderbuffer.Delete = delete_dummy_renderbuffer;
98 IncompleteFramebuffer.Delete = delete_dummy_framebuffer;
99 }
100
101 struct gl_framebuffer *
102 _mesa_get_incomplete_framebuffer(void)
103 {
104 return &IncompleteFramebuffer;
105 }
106
107 /**
108 * Helper routine for getting a gl_renderbuffer.
109 */
110 struct gl_renderbuffer *
111 _mesa_lookup_renderbuffer(struct gl_context *ctx, GLuint id)
112 {
113 struct gl_renderbuffer *rb;
114
115 if (id == 0)
116 return NULL;
117
118 rb = (struct gl_renderbuffer *)
119 _mesa_HashLookup(ctx->Shared->RenderBuffers, id);
120 return rb;
121 }
122
123
124 /**
125 * A convenience function for direct state access that throws
126 * GL_INVALID_OPERATION if the renderbuffer doesn't exist.
127 */
128 struct gl_renderbuffer *
129 _mesa_lookup_renderbuffer_err(struct gl_context *ctx, GLuint id,
130 const char *func)
131 {
132 struct gl_renderbuffer *rb;
133
134 rb = _mesa_lookup_renderbuffer(ctx, id);
135 if (!rb || rb == &DummyRenderbuffer) {
136 _mesa_error(ctx, GL_INVALID_OPERATION,
137 "%s(non-existent renderbuffer %u)", func, id);
138 return NULL;
139 }
140
141 return rb;
142 }
143
144
145 /**
146 * Helper routine for getting a gl_framebuffer.
147 */
148 struct gl_framebuffer *
149 _mesa_lookup_framebuffer(struct gl_context *ctx, GLuint id)
150 {
151 struct gl_framebuffer *fb;
152
153 if (id == 0)
154 return NULL;
155
156 fb = (struct gl_framebuffer *)
157 _mesa_HashLookup(ctx->Shared->FrameBuffers, id);
158 return fb;
159 }
160
161
162 /**
163 * A convenience function for direct state access that throws
164 * GL_INVALID_OPERATION if the framebuffer doesn't exist.
165 */
166 struct gl_framebuffer *
167 _mesa_lookup_framebuffer_err(struct gl_context *ctx, GLuint id,
168 const char *func)
169 {
170 struct gl_framebuffer *fb;
171
172 fb = _mesa_lookup_framebuffer(ctx, id);
173 if (!fb || fb == &DummyFramebuffer) {
174 _mesa_error(ctx, GL_INVALID_OPERATION,
175 "%s(non-existent framebuffer %u)", func, id);
176 return NULL;
177 }
178
179 return fb;
180 }
181
182
183 /**
184 * Mark the given framebuffer as invalid. This will force the
185 * test for framebuffer completeness to be done before the framebuffer
186 * is used.
187 */
188 static void
189 invalidate_framebuffer(struct gl_framebuffer *fb)
190 {
191 fb->_Status = 0; /* "indeterminate" */
192 }
193
194
195 /**
196 * Return the gl_framebuffer object which corresponds to the given
197 * framebuffer target, such as GL_DRAW_FRAMEBUFFER.
198 * Check support for GL_EXT_framebuffer_blit to determine if certain
199 * targets are legal.
200 * \return gl_framebuffer pointer or NULL if target is illegal
201 */
202 static struct gl_framebuffer *
203 get_framebuffer_target(struct gl_context *ctx, GLenum target)
204 {
205 bool have_fb_blit = _mesa_is_gles3(ctx) || _mesa_is_desktop_gl(ctx);
206 switch (target) {
207 case GL_DRAW_FRAMEBUFFER:
208 return have_fb_blit ? ctx->DrawBuffer : NULL;
209 case GL_READ_FRAMEBUFFER:
210 return have_fb_blit ? ctx->ReadBuffer : NULL;
211 case GL_FRAMEBUFFER_EXT:
212 return ctx->DrawBuffer;
213 default:
214 return NULL;
215 }
216 }
217
218
219 /**
220 * Given a GL_*_ATTACHMENTn token, return a pointer to the corresponding
221 * gl_renderbuffer_attachment object.
222 * This function is only used for user-created FB objects, not the
223 * default / window-system FB object.
224 * If \p attachment is GL_DEPTH_STENCIL_ATTACHMENT, return a pointer to
225 * the depth buffer attachment point.
226 * Returns if the attachment is a GL_COLOR_ATTACHMENTm_EXT on
227 * is_color_attachment, because several callers would return different errors
228 * if they don't find the attachment.
229 */
230 static struct gl_renderbuffer_attachment *
231 get_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
232 GLenum attachment, bool *is_color_attachment)
233 {
234 GLuint i;
235
236 assert(_mesa_is_user_fbo(fb));
237
238 if (is_color_attachment)
239 *is_color_attachment = false;
240
241 switch (attachment) {
242 case GL_COLOR_ATTACHMENT0_EXT:
243 case GL_COLOR_ATTACHMENT1_EXT:
244 case GL_COLOR_ATTACHMENT2_EXT:
245 case GL_COLOR_ATTACHMENT3_EXT:
246 case GL_COLOR_ATTACHMENT4_EXT:
247 case GL_COLOR_ATTACHMENT5_EXT:
248 case GL_COLOR_ATTACHMENT6_EXT:
249 case GL_COLOR_ATTACHMENT7_EXT:
250 case GL_COLOR_ATTACHMENT8_EXT:
251 case GL_COLOR_ATTACHMENT9_EXT:
252 case GL_COLOR_ATTACHMENT10_EXT:
253 case GL_COLOR_ATTACHMENT11_EXT:
254 case GL_COLOR_ATTACHMENT12_EXT:
255 case GL_COLOR_ATTACHMENT13_EXT:
256 case GL_COLOR_ATTACHMENT14_EXT:
257 case GL_COLOR_ATTACHMENT15_EXT:
258 if (is_color_attachment)
259 *is_color_attachment = true;
260 /* Only OpenGL ES 1.x forbids color attachments other than
261 * GL_COLOR_ATTACHMENT0. For all other APIs the limit set by the
262 * hardware is used.
263 */
264 i = attachment - GL_COLOR_ATTACHMENT0_EXT;
265 if (i >= ctx->Const.MaxColorAttachments
266 || (i > 0 && ctx->API == API_OPENGLES)) {
267 return NULL;
268 }
269 return &fb->Attachment[BUFFER_COLOR0 + i];
270 case GL_DEPTH_STENCIL_ATTACHMENT:
271 if (!_mesa_is_desktop_gl(ctx) && !_mesa_is_gles3(ctx))
272 return NULL;
273 /* fall-through */
274 case GL_DEPTH_ATTACHMENT_EXT:
275 return &fb->Attachment[BUFFER_DEPTH];
276 case GL_STENCIL_ATTACHMENT_EXT:
277 return &fb->Attachment[BUFFER_STENCIL];
278 default:
279 return NULL;
280 }
281 }
282
283
284 /**
285 * As above, but only used for getting attachments of the default /
286 * window-system framebuffer (not user-created framebuffer objects).
287 */
288 static struct gl_renderbuffer_attachment *
289 get_fb0_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
290 GLenum attachment)
291 {
292 assert(_mesa_is_winsys_fbo(fb));
293
294 if (_mesa_is_gles3(ctx)) {
295 assert(attachment == GL_BACK ||
296 attachment == GL_DEPTH ||
297 attachment == GL_STENCIL);
298 switch (attachment) {
299 case GL_BACK:
300 /* Since there is no stereo rendering in ES 3.0, only return the
301 * LEFT bits.
302 */
303 if (ctx->DrawBuffer->Visual.doubleBufferMode)
304 return &fb->Attachment[BUFFER_BACK_LEFT];
305 return &fb->Attachment[BUFFER_FRONT_LEFT];
306 case GL_DEPTH:
307 return &fb->Attachment[BUFFER_DEPTH];
308 case GL_STENCIL:
309 return &fb->Attachment[BUFFER_STENCIL];
310 }
311 }
312
313 switch (attachment) {
314 case GL_FRONT_LEFT:
315 /* Front buffers can be allocated on the first use, but
316 * glGetFramebufferAttachmentParameteriv must work even if that
317 * allocation hasn't happened yet. In such case, use the back buffer,
318 * which should be the same.
319 */
320 if (fb->Attachment[BUFFER_FRONT_LEFT].Type == GL_NONE)
321 return &fb->Attachment[BUFFER_BACK_LEFT];
322 else
323 return &fb->Attachment[BUFFER_FRONT_LEFT];
324 case GL_FRONT_RIGHT:
325 /* Same as above. */
326 if (fb->Attachment[BUFFER_FRONT_RIGHT].Type == GL_NONE)
327 return &fb->Attachment[BUFFER_BACK_RIGHT];
328 else
329 return &fb->Attachment[BUFFER_FRONT_RIGHT];
330 case GL_BACK_LEFT:
331 return &fb->Attachment[BUFFER_BACK_LEFT];
332 case GL_BACK_RIGHT:
333 return &fb->Attachment[BUFFER_BACK_RIGHT];
334 case GL_BACK:
335 /* The ARB_ES3_1_compatibility spec says:
336 *
337 * "Since this command can only query a single framebuffer
338 * attachment, BACK is equivalent to BACK_LEFT."
339 */
340 if (ctx->Extensions.ARB_ES3_1_compatibility)
341 return &fb->Attachment[BUFFER_BACK_LEFT];
342 return NULL;
343 case GL_AUX0:
344 if (fb->Visual.numAuxBuffers == 1) {
345 return &fb->Attachment[BUFFER_AUX0];
346 }
347 return NULL;
348
349 /* Page 336 (page 352 of the PDF) of the OpenGL 3.0 spec says:
350 *
351 * "If the default framebuffer is bound to target, then attachment must
352 * be one of FRONT LEFT, FRONT RIGHT, BACK LEFT, BACK RIGHT, or AUXi,
353 * identifying a color buffer; DEPTH, identifying the depth buffer; or
354 * STENCIL, identifying the stencil buffer."
355 *
356 * Revision #34 of the ARB_framebuffer_object spec has essentially the same
357 * language. However, revision #33 of the ARB_framebuffer_object spec
358 * says:
359 *
360 * "If the default framebuffer is bound to <target>, then <attachment>
361 * must be one of FRONT_LEFT, FRONT_RIGHT, BACK_LEFT, BACK_RIGHT, AUXi,
362 * DEPTH_BUFFER, or STENCIL_BUFFER, identifying a color buffer, the
363 * depth buffer, or the stencil buffer, and <pname> may be
364 * FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE or
365 * FRAMEBUFFER_ATTACHMENT_OBJECT_NAME."
366 *
367 * The enum values for DEPTH_BUFFER and STENCIL_BUFFER have been removed
368 * from glext.h, so shipping apps should not use those values.
369 *
370 * Note that neither EXT_framebuffer_object nor OES_framebuffer_object
371 * support queries of the window system FBO.
372 */
373 case GL_DEPTH:
374 return &fb->Attachment[BUFFER_DEPTH];
375 case GL_STENCIL:
376 return &fb->Attachment[BUFFER_STENCIL];
377 default:
378 return NULL;
379 }
380 }
381
382
383
384 /**
385 * Remove any texture or renderbuffer attached to the given attachment
386 * point. Update reference counts, etc.
387 */
388 static void
389 remove_attachment(struct gl_context *ctx,
390 struct gl_renderbuffer_attachment *att)
391 {
392 struct gl_renderbuffer *rb = att->Renderbuffer;
393
394 /* tell driver that we're done rendering to this texture. */
395 if (rb && rb->NeedsFinishRenderTexture)
396 ctx->Driver.FinishRenderTexture(ctx, rb);
397
398 if (att->Type == GL_TEXTURE) {
399 assert(att->Texture);
400 _mesa_reference_texobj(&att->Texture, NULL); /* unbind */
401 assert(!att->Texture);
402 }
403 if (att->Type == GL_TEXTURE || att->Type == GL_RENDERBUFFER_EXT) {
404 assert(!att->Texture);
405 _mesa_reference_renderbuffer(&att->Renderbuffer, NULL); /* unbind */
406 assert(!att->Renderbuffer);
407 }
408 att->Type = GL_NONE;
409 att->Complete = GL_TRUE;
410 }
411
412 /**
413 * Verify a couple error conditions that will lead to an incomplete FBO and
414 * may cause problems for the driver's RenderTexture path.
415 */
416 static bool
417 driver_RenderTexture_is_safe(const struct gl_renderbuffer_attachment *att)
418 {
419 const struct gl_texture_image *const texImage =
420 att->Texture->Image[att->CubeMapFace][att->TextureLevel];
421
422 if (!texImage ||
423 texImage->Width == 0 || texImage->Height == 0 || texImage->Depth == 0)
424 return false;
425
426 if ((texImage->TexObject->Target == GL_TEXTURE_1D_ARRAY
427 && att->Zoffset >= texImage->Height)
428 || (texImage->TexObject->Target != GL_TEXTURE_1D_ARRAY
429 && att->Zoffset >= texImage->Depth))
430 return false;
431
432 return true;
433 }
434
435 /**
436 * Create a renderbuffer which will be set up by the driver to wrap the
437 * texture image slice.
438 *
439 * By using a gl_renderbuffer (like user-allocated renderbuffers), drivers get
440 * to share most of their framebuffer rendering code between winsys,
441 * renderbuffer, and texture attachments.
442 *
443 * The allocated renderbuffer uses a non-zero Name so that drivers can check
444 * it for determining vertical orientation, but we use ~0 to make it fairly
445 * unambiguous with actual user (non-texture) renderbuffers.
446 */
447 void
448 _mesa_update_texture_renderbuffer(struct gl_context *ctx,
449 struct gl_framebuffer *fb,
450 struct gl_renderbuffer_attachment *att)
451 {
452 struct gl_texture_image *texImage;
453 struct gl_renderbuffer *rb;
454
455 texImage = att->Texture->Image[att->CubeMapFace][att->TextureLevel];
456
457 rb = att->Renderbuffer;
458 if (!rb) {
459 rb = ctx->Driver.NewRenderbuffer(ctx, ~0);
460 if (!rb) {
461 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glFramebufferTexture()");
462 return;
463 }
464 att->Renderbuffer = rb;
465
466 /* This can't get called on a texture renderbuffer, so set it to NULL
467 * for clarity compared to user renderbuffers.
468 */
469 rb->AllocStorage = NULL;
470
471 rb->NeedsFinishRenderTexture = ctx->Driver.FinishRenderTexture != NULL;
472 }
473
474 if (!texImage)
475 return;
476
477 rb->_BaseFormat = texImage->_BaseFormat;
478 rb->Format = texImage->TexFormat;
479 rb->InternalFormat = texImage->InternalFormat;
480 rb->Width = texImage->Width2;
481 rb->Height = texImage->Height2;
482 rb->Depth = texImage->Depth2;
483 rb->NumSamples = texImage->NumSamples;
484 rb->TexImage = texImage;
485
486 if (driver_RenderTexture_is_safe(att))
487 ctx->Driver.RenderTexture(ctx, fb, att);
488 }
489
490 /**
491 * Bind a texture object to an attachment point.
492 * The previous binding, if any, will be removed first.
493 */
494 static void
495 set_texture_attachment(struct gl_context *ctx,
496 struct gl_framebuffer *fb,
497 struct gl_renderbuffer_attachment *att,
498 struct gl_texture_object *texObj,
499 GLenum texTarget, GLuint level, GLuint layer,
500 GLboolean layered)
501 {
502 struct gl_renderbuffer *rb = att->Renderbuffer;
503
504 if (rb && rb->NeedsFinishRenderTexture)
505 ctx->Driver.FinishRenderTexture(ctx, rb);
506
507 if (att->Texture == texObj) {
508 /* re-attaching same texture */
509 assert(att->Type == GL_TEXTURE);
510 }
511 else {
512 /* new attachment */
513 remove_attachment(ctx, att);
514 att->Type = GL_TEXTURE;
515 assert(!att->Texture);
516 _mesa_reference_texobj(&att->Texture, texObj);
517 }
518 invalidate_framebuffer(fb);
519
520 /* always update these fields */
521 att->TextureLevel = level;
522 att->CubeMapFace = _mesa_tex_target_to_face(texTarget);
523 att->Zoffset = layer;
524 att->Layered = layered;
525 att->Complete = GL_FALSE;
526
527 _mesa_update_texture_renderbuffer(ctx, fb, att);
528 }
529
530
531 /**
532 * Bind a renderbuffer to an attachment point.
533 * The previous binding, if any, will be removed first.
534 */
535 static void
536 set_renderbuffer_attachment(struct gl_context *ctx,
537 struct gl_renderbuffer_attachment *att,
538 struct gl_renderbuffer *rb)
539 {
540 /* XXX check if re-doing same attachment, exit early */
541 remove_attachment(ctx, att);
542 att->Type = GL_RENDERBUFFER_EXT;
543 att->Texture = NULL; /* just to be safe */
544 att->Layered = GL_FALSE;
545 att->Complete = GL_FALSE;
546 _mesa_reference_renderbuffer(&att->Renderbuffer, rb);
547 }
548
549
550 /**
551 * Fallback for ctx->Driver.FramebufferRenderbuffer()
552 * Attach a renderbuffer object to a framebuffer object.
553 */
554 void
555 _mesa_FramebufferRenderbuffer_sw(struct gl_context *ctx,
556 struct gl_framebuffer *fb,
557 GLenum attachment,
558 struct gl_renderbuffer *rb)
559 {
560 struct gl_renderbuffer_attachment *att;
561
562 simple_mtx_lock(&fb->Mutex);
563
564 att = get_attachment(ctx, fb, attachment, NULL);
565 assert(att);
566 if (rb) {
567 set_renderbuffer_attachment(ctx, att, rb);
568 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
569 /* do stencil attachment here (depth already done above) */
570 att = get_attachment(ctx, fb, GL_STENCIL_ATTACHMENT_EXT, NULL);
571 assert(att);
572 set_renderbuffer_attachment(ctx, att, rb);
573 }
574 rb->AttachedAnytime = GL_TRUE;
575 }
576 else {
577 remove_attachment(ctx, att);
578 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
579 /* detach stencil (depth was detached above) */
580 att = get_attachment(ctx, fb, GL_STENCIL_ATTACHMENT_EXT, NULL);
581 assert(att);
582 remove_attachment(ctx, att);
583 }
584 }
585
586 invalidate_framebuffer(fb);
587
588 simple_mtx_unlock(&fb->Mutex);
589 }
590
591
592 /**
593 * Fallback for ctx->Driver.ValidateFramebuffer()
594 * Check if the renderbuffer's formats are supported by the software
595 * renderer.
596 * Drivers should probably override this.
597 */
598 void
599 _mesa_validate_framebuffer(struct gl_context *ctx, struct gl_framebuffer *fb)
600 {
601 gl_buffer_index buf;
602 for (buf = 0; buf < BUFFER_COUNT; buf++) {
603 const struct gl_renderbuffer *rb = fb->Attachment[buf].Renderbuffer;
604 if (rb) {
605 switch (rb->_BaseFormat) {
606 case GL_ALPHA:
607 case GL_LUMINANCE_ALPHA:
608 case GL_LUMINANCE:
609 case GL_INTENSITY:
610 case GL_RED:
611 case GL_RG:
612 fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
613 return;
614
615 default:
616 switch (rb->Format) {
617 /* XXX This list is likely incomplete. */
618 case MESA_FORMAT_R9G9B9E5_FLOAT:
619 fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
620 return;
621 default:;
622 /* render buffer format is supported by software rendering */
623 }
624 }
625 }
626 }
627 }
628
629
630 /**
631 * Return true if the framebuffer has a combined depth/stencil
632 * renderbuffer attached.
633 */
634 GLboolean
635 _mesa_has_depthstencil_combined(const struct gl_framebuffer *fb)
636 {
637 const struct gl_renderbuffer_attachment *depth =
638 &fb->Attachment[BUFFER_DEPTH];
639 const struct gl_renderbuffer_attachment *stencil =
640 &fb->Attachment[BUFFER_STENCIL];
641
642 if (depth->Type == stencil->Type) {
643 if (depth->Type == GL_RENDERBUFFER_EXT &&
644 depth->Renderbuffer == stencil->Renderbuffer)
645 return GL_TRUE;
646
647 if (depth->Type == GL_TEXTURE &&
648 depth->Texture == stencil->Texture)
649 return GL_TRUE;
650 }
651
652 return GL_FALSE;
653 }
654
655
656 /**
657 * For debug only.
658 */
659 static void
660 att_incomplete(const char *msg)
661 {
662 if (MESA_DEBUG_FLAGS & DEBUG_INCOMPLETE_FBO) {
663 _mesa_debug(NULL, "attachment incomplete: %s\n", msg);
664 }
665 }
666
667
668 /**
669 * For debug only.
670 */
671 static void
672 fbo_incomplete(struct gl_context *ctx, const char *msg, int index)
673 {
674 static GLuint msg_id;
675
676 _mesa_gl_debug(ctx, &msg_id,
677 MESA_DEBUG_SOURCE_API,
678 MESA_DEBUG_TYPE_OTHER,
679 MESA_DEBUG_SEVERITY_MEDIUM,
680 "FBO incomplete: %s [%d]\n", msg, index);
681
682 if (MESA_DEBUG_FLAGS & DEBUG_INCOMPLETE_FBO) {
683 _mesa_debug(NULL, "FBO Incomplete: %s [%d]\n", msg, index);
684 }
685 }
686
687
688 /**
689 * Is the given base format a legal format for a color renderbuffer?
690 */
691 GLboolean
692 _mesa_is_legal_color_format(const struct gl_context *ctx, GLenum baseFormat)
693 {
694 switch (baseFormat) {
695 case GL_RGB:
696 case GL_RGBA:
697 return GL_TRUE;
698 case GL_LUMINANCE:
699 case GL_LUMINANCE_ALPHA:
700 case GL_INTENSITY:
701 case GL_ALPHA:
702 return ctx->API == API_OPENGL_COMPAT &&
703 ctx->Extensions.ARB_framebuffer_object;
704 case GL_RED:
705 case GL_RG:
706 return ctx->Extensions.ARB_texture_rg;
707 default:
708 return GL_FALSE;
709 }
710 }
711
712
713 /**
714 * Is the given base format a legal format for a color renderbuffer?
715 */
716 static GLboolean
717 is_format_color_renderable(const struct gl_context *ctx, mesa_format format,
718 GLenum internalFormat)
719 {
720 const GLenum baseFormat =
721 _mesa_get_format_base_format(format);
722 GLboolean valid;
723
724 valid = _mesa_is_legal_color_format(ctx, baseFormat);
725 if (!valid || _mesa_is_desktop_gl(ctx)) {
726 return valid;
727 }
728
729 /* Reject additional cases for GLES */
730 switch (internalFormat) {
731 case GL_RGBA8_SNORM:
732 case GL_RGB32F:
733 case GL_RGB32I:
734 case GL_RGB32UI:
735 case GL_RGB16F:
736 case GL_RGB16I:
737 case GL_RGB16UI:
738 case GL_RGB8_SNORM:
739 case GL_RGB8I:
740 case GL_RGB8UI:
741 case GL_SRGB8:
742 case GL_RGB10:
743 case GL_RGB9_E5:
744 case GL_RG8_SNORM:
745 case GL_R8_SNORM:
746 return GL_FALSE;
747 default:
748 break;
749 }
750
751 if (internalFormat != GL_RGB10_A2 &&
752 (format == MESA_FORMAT_B10G10R10A2_UNORM ||
753 format == MESA_FORMAT_B10G10R10X2_UNORM ||
754 format == MESA_FORMAT_R10G10B10A2_UNORM ||
755 format == MESA_FORMAT_R10G10B10X2_UNORM)) {
756 return GL_FALSE;
757 }
758
759 return GL_TRUE;
760 }
761
762
763 /**
764 * Is the given base format a legal format for a depth/stencil renderbuffer?
765 */
766 static GLboolean
767 is_legal_depth_format(const struct gl_context *ctx, GLenum baseFormat)
768 {
769 switch (baseFormat) {
770 case GL_DEPTH_COMPONENT:
771 case GL_DEPTH_STENCIL_EXT:
772 return GL_TRUE;
773 default:
774 return GL_FALSE;
775 }
776 }
777
778
779 /**
780 * Test if an attachment point is complete and update its Complete field.
781 * \param format if GL_COLOR, this is a color attachment point,
782 * if GL_DEPTH, this is a depth component attachment point,
783 * if GL_STENCIL, this is a stencil component attachment point.
784 */
785 static void
786 test_attachment_completeness(const struct gl_context *ctx, GLenum format,
787 struct gl_renderbuffer_attachment *att)
788 {
789 assert(format == GL_COLOR || format == GL_DEPTH || format == GL_STENCIL);
790
791 /* assume complete */
792 att->Complete = GL_TRUE;
793
794 /* Look for reasons why the attachment might be incomplete */
795 if (att->Type == GL_TEXTURE) {
796 const struct gl_texture_object *texObj = att->Texture;
797 const struct gl_texture_image *texImage;
798 GLenum baseFormat;
799
800 if (!texObj) {
801 att_incomplete("no texobj");
802 att->Complete = GL_FALSE;
803 return;
804 }
805
806 texImage = texObj->Image[att->CubeMapFace][att->TextureLevel];
807 if (!texImage) {
808 att_incomplete("no teximage");
809 att->Complete = GL_FALSE;
810 return;
811 }
812 if (texImage->Width < 1 || texImage->Height < 1) {
813 att_incomplete("teximage width/height=0");
814 att->Complete = GL_FALSE;
815 return;
816 }
817
818 switch (texObj->Target) {
819 case GL_TEXTURE_3D:
820 if (att->Zoffset >= texImage->Depth) {
821 att_incomplete("bad z offset");
822 att->Complete = GL_FALSE;
823 return;
824 }
825 break;
826 case GL_TEXTURE_1D_ARRAY:
827 if (att->Zoffset >= texImage->Height) {
828 att_incomplete("bad 1D-array layer");
829 att->Complete = GL_FALSE;
830 return;
831 }
832 break;
833 case GL_TEXTURE_2D_ARRAY:
834 if (att->Zoffset >= texImage->Depth) {
835 att_incomplete("bad 2D-array layer");
836 att->Complete = GL_FALSE;
837 return;
838 }
839 break;
840 case GL_TEXTURE_CUBE_MAP_ARRAY:
841 if (att->Zoffset >= texImage->Depth) {
842 att_incomplete("bad cube-array layer");
843 att->Complete = GL_FALSE;
844 return;
845 }
846 break;
847 }
848
849 baseFormat = texImage->_BaseFormat;
850
851 if (format == GL_COLOR) {
852 if (!_mesa_is_legal_color_format(ctx, baseFormat)) {
853 att_incomplete("bad format");
854 att->Complete = GL_FALSE;
855 return;
856 }
857 if (_mesa_is_format_compressed(texImage->TexFormat)) {
858 att_incomplete("compressed internalformat");
859 att->Complete = GL_FALSE;
860 return;
861 }
862
863 /* OES_texture_float allows creation and use of floating point
864 * textures with GL_FLOAT, GL_HALF_FLOAT but it does not allow
865 * these textures to be used as a render target, this is done via
866 * GL_EXT_color_buffer(_half)_float with set of new sized types.
867 */
868 if (_mesa_is_gles(ctx) && (texObj->_IsFloat || texObj->_IsHalfFloat)) {
869 att_incomplete("bad internal format");
870 att->Complete = GL_FALSE;
871 return;
872 }
873 }
874 else if (format == GL_DEPTH) {
875 if (baseFormat == GL_DEPTH_COMPONENT) {
876 /* OK */
877 }
878 else if (ctx->Extensions.ARB_depth_texture &&
879 baseFormat == GL_DEPTH_STENCIL) {
880 /* OK */
881 }
882 else {
883 att->Complete = GL_FALSE;
884 att_incomplete("bad depth format");
885 return;
886 }
887 }
888 else {
889 assert(format == GL_STENCIL);
890 if (ctx->Extensions.ARB_depth_texture &&
891 baseFormat == GL_DEPTH_STENCIL) {
892 /* OK */
893 } else if (ctx->Extensions.ARB_texture_stencil8 &&
894 baseFormat == GL_STENCIL_INDEX) {
895 /* OK */
896 } else {
897 /* no such thing as stencil-only textures */
898 att_incomplete("illegal stencil texture");
899 att->Complete = GL_FALSE;
900 return;
901 }
902 }
903 }
904 else if (att->Type == GL_RENDERBUFFER_EXT) {
905 const GLenum baseFormat = att->Renderbuffer->_BaseFormat;
906
907 assert(att->Renderbuffer);
908 if (!att->Renderbuffer->InternalFormat ||
909 att->Renderbuffer->Width < 1 ||
910 att->Renderbuffer->Height < 1) {
911 att_incomplete("0x0 renderbuffer");
912 att->Complete = GL_FALSE;
913 return;
914 }
915 if (format == GL_COLOR) {
916 if (!_mesa_is_legal_color_format(ctx, baseFormat)) {
917 att_incomplete("bad renderbuffer color format");
918 att->Complete = GL_FALSE;
919 return;
920 }
921 }
922 else if (format == GL_DEPTH) {
923 if (baseFormat == GL_DEPTH_COMPONENT) {
924 /* OK */
925 }
926 else if (baseFormat == GL_DEPTH_STENCIL) {
927 /* OK */
928 }
929 else {
930 att_incomplete("bad renderbuffer depth format");
931 att->Complete = GL_FALSE;
932 return;
933 }
934 }
935 else {
936 assert(format == GL_STENCIL);
937 if (baseFormat == GL_STENCIL_INDEX ||
938 baseFormat == GL_DEPTH_STENCIL) {
939 /* OK */
940 }
941 else {
942 att->Complete = GL_FALSE;
943 att_incomplete("bad renderbuffer stencil format");
944 return;
945 }
946 }
947 }
948 else {
949 assert(att->Type == GL_NONE);
950 /* complete */
951 return;
952 }
953 }
954
955
956 /**
957 * Test if the given framebuffer object is complete and update its
958 * Status field with the results.
959 * Calls the ctx->Driver.ValidateFramebuffer() function to allow the
960 * driver to make hardware-specific validation/completeness checks.
961 * Also update the framebuffer's Width and Height fields if the
962 * framebuffer is complete.
963 */
964 void
965 _mesa_test_framebuffer_completeness(struct gl_context *ctx,
966 struct gl_framebuffer *fb)
967 {
968 GLuint numImages;
969 GLenum intFormat = GL_NONE; /* color buffers' internal format */
970 GLuint minWidth = ~0, minHeight = ~0, maxWidth = 0, maxHeight = 0;
971 GLint numSamples = -1;
972 GLint fixedSampleLocations = -1;
973 GLint i;
974 GLuint j;
975 /* Covers max_layer_count, is_layered, and layer_tex_target */
976 bool layer_info_valid = false;
977 GLuint max_layer_count = 0, att_layer_count;
978 bool is_layered = false;
979 GLenum layer_tex_target = 0;
980 bool has_depth_attachment = false;
981 bool has_stencil_attachment = false;
982
983 assert(_mesa_is_user_fbo(fb));
984
985 /* we're changing framebuffer fields here */
986 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
987
988 numImages = 0;
989 fb->Width = 0;
990 fb->Height = 0;
991 fb->_AllColorBuffersFixedPoint = GL_TRUE;
992 fb->_HasSNormOrFloatColorBuffer = GL_FALSE;
993 fb->_HasAttachments = true;
994 fb->_IntegerBuffers = 0;
995
996 /* Start at -2 to more easily loop over all attachment points.
997 * -2: depth buffer
998 * -1: stencil buffer
999 * >=0: color buffer
1000 */
1001 for (i = -2; i < (GLint) ctx->Const.MaxColorAttachments; i++) {
1002 struct gl_renderbuffer_attachment *att;
1003 GLenum f;
1004 mesa_format attFormat;
1005 GLenum att_tex_target = GL_NONE;
1006
1007 /*
1008 * XXX for ARB_fbo, only check color buffers that are named by
1009 * GL_READ_BUFFER and GL_DRAW_BUFFERi.
1010 */
1011
1012 /* check for attachment completeness
1013 */
1014 if (i == -2) {
1015 att = &fb->Attachment[BUFFER_DEPTH];
1016 test_attachment_completeness(ctx, GL_DEPTH, att);
1017 if (!att->Complete) {
1018 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
1019 fbo_incomplete(ctx, "depth attachment incomplete", -1);
1020 return;
1021 } else if (att->Type != GL_NONE) {
1022 has_depth_attachment = true;
1023 }
1024 }
1025 else if (i == -1) {
1026 att = &fb->Attachment[BUFFER_STENCIL];
1027 test_attachment_completeness(ctx, GL_STENCIL, att);
1028 if (!att->Complete) {
1029 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
1030 fbo_incomplete(ctx, "stencil attachment incomplete", -1);
1031 return;
1032 } else if (att->Type != GL_NONE) {
1033 has_stencil_attachment = true;
1034 }
1035 }
1036 else {
1037 att = &fb->Attachment[BUFFER_COLOR0 + i];
1038 test_attachment_completeness(ctx, GL_COLOR, att);
1039 if (!att->Complete) {
1040 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
1041 fbo_incomplete(ctx, "color attachment incomplete", i);
1042 return;
1043 }
1044 }
1045
1046 /* get width, height, format of the renderbuffer/texture
1047 */
1048 if (att->Type == GL_TEXTURE) {
1049 const struct gl_texture_image *texImg = att->Renderbuffer->TexImage;
1050 att_tex_target = att->Texture->Target;
1051 minWidth = MIN2(minWidth, texImg->Width);
1052 maxWidth = MAX2(maxWidth, texImg->Width);
1053 minHeight = MIN2(minHeight, texImg->Height);
1054 maxHeight = MAX2(maxHeight, texImg->Height);
1055 f = texImg->_BaseFormat;
1056 attFormat = texImg->TexFormat;
1057 numImages++;
1058
1059 if (!is_format_color_renderable(ctx, attFormat,
1060 texImg->InternalFormat) &&
1061 !is_legal_depth_format(ctx, f) &&
1062 f != GL_STENCIL_INDEX) {
1063 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT;
1064 fbo_incomplete(ctx, "texture attachment incomplete", -1);
1065 return;
1066 }
1067
1068 if (numSamples < 0)
1069 numSamples = texImg->NumSamples;
1070 else if (numSamples != texImg->NumSamples) {
1071 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
1072 fbo_incomplete(ctx, "inconsistent sample count", -1);
1073 return;
1074 }
1075
1076 if (fixedSampleLocations < 0)
1077 fixedSampleLocations = texImg->FixedSampleLocations;
1078 else if (fixedSampleLocations != texImg->FixedSampleLocations) {
1079 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
1080 fbo_incomplete(ctx, "inconsistent fixed sample locations", -1);
1081 return;
1082 }
1083 }
1084 else if (att->Type == GL_RENDERBUFFER_EXT) {
1085 minWidth = MIN2(minWidth, att->Renderbuffer->Width);
1086 maxWidth = MAX2(minWidth, att->Renderbuffer->Width);
1087 minHeight = MIN2(minHeight, att->Renderbuffer->Height);
1088 maxHeight = MAX2(minHeight, att->Renderbuffer->Height);
1089 f = att->Renderbuffer->InternalFormat;
1090 attFormat = att->Renderbuffer->Format;
1091 numImages++;
1092
1093 if (numSamples < 0)
1094 numSamples = att->Renderbuffer->NumSamples;
1095 else if (numSamples != att->Renderbuffer->NumSamples) {
1096 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
1097 fbo_incomplete(ctx, "inconsistent sample count", -1);
1098 return;
1099 }
1100
1101 /* RENDERBUFFER has fixedSampleLocations implicitly true */
1102 if (fixedSampleLocations < 0)
1103 fixedSampleLocations = GL_TRUE;
1104 else if (fixedSampleLocations != GL_TRUE) {
1105 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
1106 fbo_incomplete(ctx, "inconsistent fixed sample locations", -1);
1107 return;
1108 }
1109 }
1110 else {
1111 assert(att->Type == GL_NONE);
1112 continue;
1113 }
1114
1115 /* Update flags describing color buffer datatypes */
1116 if (i >= 0) {
1117 GLenum type = _mesa_get_format_datatype(attFormat);
1118
1119 /* check if integer color */
1120 if (_mesa_is_format_integer_color(attFormat))
1121 fb->_IntegerBuffers |= (1 << i);
1122
1123 fb->_AllColorBuffersFixedPoint =
1124 fb->_AllColorBuffersFixedPoint &&
1125 (type == GL_UNSIGNED_NORMALIZED || type == GL_SIGNED_NORMALIZED);
1126
1127 fb->_HasSNormOrFloatColorBuffer =
1128 fb->_HasSNormOrFloatColorBuffer ||
1129 type == GL_SIGNED_NORMALIZED || type == GL_FLOAT;
1130 }
1131
1132 /* Error-check width, height, format */
1133 if (numImages == 1) {
1134 /* save format */
1135 if (i >= 0) {
1136 intFormat = f;
1137 }
1138 }
1139 else {
1140 if (!ctx->Extensions.ARB_framebuffer_object) {
1141 /* check that width, height, format are same */
1142 if (minWidth != maxWidth || minHeight != maxHeight) {
1143 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT;
1144 fbo_incomplete(ctx, "width or height mismatch", -1);
1145 return;
1146 }
1147 /* check that all color buffers are the same format */
1148 if (intFormat != GL_NONE && f != intFormat) {
1149 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
1150 fbo_incomplete(ctx, "format mismatch", -1);
1151 return;
1152 }
1153 }
1154 }
1155
1156 /* Check that the format is valid. (MESA_FORMAT_NONE means unsupported)
1157 */
1158 if (att->Type == GL_RENDERBUFFER &&
1159 att->Renderbuffer->Format == MESA_FORMAT_NONE) {
1160 fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
1161 fbo_incomplete(ctx, "unsupported renderbuffer format", i);
1162 return;
1163 }
1164
1165 /* Check that layered rendering is consistent. */
1166 if (att->Layered) {
1167 if (att_tex_target == GL_TEXTURE_CUBE_MAP)
1168 att_layer_count = 6;
1169 else if (att_tex_target == GL_TEXTURE_1D_ARRAY)
1170 att_layer_count = att->Renderbuffer->Height;
1171 else
1172 att_layer_count = att->Renderbuffer->Depth;
1173 } else {
1174 att_layer_count = 0;
1175 }
1176 if (!layer_info_valid) {
1177 is_layered = att->Layered;
1178 max_layer_count = att_layer_count;
1179 layer_tex_target = att_tex_target;
1180 layer_info_valid = true;
1181 } else if (max_layer_count > 0 && layer_tex_target != att_tex_target) {
1182 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_LAYER_TARGETS;
1183 fbo_incomplete(ctx, "layered framebuffer has mismatched targets", i);
1184 return;
1185 } else if (is_layered != att->Layered) {
1186 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_LAYER_TARGETS;
1187 fbo_incomplete(ctx,
1188 "framebuffer attachment layer mode is inconsistent",
1189 i);
1190 return;
1191 } else if (att_layer_count > max_layer_count) {
1192 max_layer_count = att_layer_count;
1193 }
1194
1195 /*
1196 * The extension GL_ARB_framebuffer_no_attachments places additional
1197 * requirement on each attachment. Those additional requirements are
1198 * tighter that those of previous versions of GL. In interest of better
1199 * compatibility, we will not enforce these restrictions. For the record
1200 * those additional restrictions are quoted below:
1201 *
1202 * "The width and height of image are greater than zero and less than or
1203 * equal to the values of the implementation-dependent limits
1204 * MAX_FRAMEBUFFER_WIDTH and MAX_FRAMEBUFFER_HEIGHT, respectively."
1205 *
1206 * "If <image> is a three-dimensional texture or a one- or two-dimensional
1207 * array texture and the attachment is layered, the depth or layer count
1208 * of the texture is less than or equal to the implementation-dependent
1209 * limit MAX_FRAMEBUFFER_LAYERS."
1210 *
1211 * "If image has multiple samples, its sample count is less than or equal
1212 * to the value of the implementation-dependent limit
1213 * MAX_FRAMEBUFFER_SAMPLES."
1214 *
1215 * The same requirements are also in place for GL 4.5,
1216 * Section 9.4.1 "Framebuffer Attachment Completeness", pg 310-311
1217 */
1218 }
1219
1220 fb->MaxNumLayers = max_layer_count;
1221
1222 if (numImages == 0) {
1223 fb->_HasAttachments = false;
1224
1225 if (!ctx->Extensions.ARB_framebuffer_no_attachments) {
1226 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT;
1227 fbo_incomplete(ctx, "no attachments", -1);
1228 return;
1229 }
1230
1231 if (fb->DefaultGeometry.Width == 0 || fb->DefaultGeometry.Height == 0) {
1232 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT;
1233 fbo_incomplete(ctx, "no attachments and default width or height is 0", -1);
1234 return;
1235 }
1236 }
1237
1238 if (_mesa_is_desktop_gl(ctx) && !ctx->Extensions.ARB_ES2_compatibility) {
1239 /* Check that all DrawBuffers are present */
1240 for (j = 0; j < ctx->Const.MaxDrawBuffers; j++) {
1241 if (fb->ColorDrawBuffer[j] != GL_NONE) {
1242 const struct gl_renderbuffer_attachment *att
1243 = get_attachment(ctx, fb, fb->ColorDrawBuffer[j], NULL);
1244 assert(att);
1245 if (att->Type == GL_NONE) {
1246 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_EXT;
1247 fbo_incomplete(ctx, "missing drawbuffer", j);
1248 return;
1249 }
1250 }
1251 }
1252
1253 /* Check that the ReadBuffer is present */
1254 if (fb->ColorReadBuffer != GL_NONE) {
1255 const struct gl_renderbuffer_attachment *att
1256 = get_attachment(ctx, fb, fb->ColorReadBuffer, NULL);
1257 assert(att);
1258 if (att->Type == GL_NONE) {
1259 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT;
1260 fbo_incomplete(ctx, "missing readbuffer", -1);
1261 return;
1262 }
1263 }
1264 }
1265
1266 /* The OpenGL ES3 spec, in chapter 9.4. FRAMEBUFFER COMPLETENESS, says:
1267 *
1268 * "Depth and stencil attachments, if present, are the same image."
1269 *
1270 * This restriction is not present in the OpenGL ES2 spec.
1271 */
1272 if (_mesa_is_gles3(ctx) &&
1273 has_stencil_attachment && has_depth_attachment &&
1274 !_mesa_has_depthstencil_combined(fb)) {
1275 fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
1276 fbo_incomplete(ctx, "Depth and stencil attachments must be the same image", -1);
1277 return;
1278 }
1279
1280 /* Provisionally set status = COMPLETE ... */
1281 fb->_Status = GL_FRAMEBUFFER_COMPLETE_EXT;
1282
1283 /* ... but the driver may say the FB is incomplete.
1284 * Drivers will most likely set the status to GL_FRAMEBUFFER_UNSUPPORTED
1285 * if anything.
1286 */
1287 if (ctx->Driver.ValidateFramebuffer) {
1288 ctx->Driver.ValidateFramebuffer(ctx, fb);
1289 if (fb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
1290 fbo_incomplete(ctx, "driver marked FBO as incomplete", -1);
1291 return;
1292 }
1293 }
1294
1295 /*
1296 * Note that if ARB_framebuffer_object is supported and the attached
1297 * renderbuffers/textures are different sizes, the framebuffer
1298 * width/height will be set to the smallest width/height.
1299 */
1300 if (numImages != 0) {
1301 fb->Width = minWidth;
1302 fb->Height = minHeight;
1303 }
1304
1305 /* finally, update the visual info for the framebuffer */
1306 _mesa_update_framebuffer_visual(ctx, fb);
1307 }
1308
1309
1310 GLboolean GLAPIENTRY
1311 _mesa_IsRenderbuffer(GLuint renderbuffer)
1312 {
1313 struct gl_renderbuffer *rb;
1314
1315 GET_CURRENT_CONTEXT(ctx);
1316
1317 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
1318
1319 rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
1320 return rb != NULL && rb != &DummyRenderbuffer;
1321 }
1322
1323
1324 static struct gl_renderbuffer *
1325 allocate_renderbuffer_locked(struct gl_context *ctx, GLuint renderbuffer,
1326 const char *func)
1327 {
1328 struct gl_renderbuffer *newRb;
1329
1330 /* create new renderbuffer object */
1331 newRb = ctx->Driver.NewRenderbuffer(ctx, renderbuffer);
1332 if (!newRb) {
1333 _mesa_error(ctx, GL_OUT_OF_MEMORY, "%s", func);
1334 return NULL;
1335 }
1336 assert(newRb->AllocStorage);
1337 _mesa_HashInsertLocked(ctx->Shared->RenderBuffers, renderbuffer, newRb);
1338
1339 return newRb;
1340 }
1341
1342
1343 static void
1344 bind_renderbuffer(GLenum target, GLuint renderbuffer, bool allow_user_names)
1345 {
1346 struct gl_renderbuffer *newRb;
1347 GET_CURRENT_CONTEXT(ctx);
1348
1349 if (target != GL_RENDERBUFFER_EXT) {
1350 _mesa_error(ctx, GL_INVALID_ENUM, "glBindRenderbufferEXT(target)");
1351 return;
1352 }
1353
1354 /* No need to flush here since the render buffer binding has no
1355 * effect on rendering state.
1356 */
1357
1358 if (renderbuffer) {
1359 newRb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
1360 if (newRb == &DummyRenderbuffer) {
1361 /* ID was reserved, but no real renderbuffer object made yet */
1362 newRb = NULL;
1363 }
1364 else if (!newRb && !allow_user_names) {
1365 /* All RB IDs must be Gen'd */
1366 _mesa_error(ctx, GL_INVALID_OPERATION, "glBindRenderbuffer(buffer)");
1367 return;
1368 }
1369
1370 if (!newRb) {
1371 _mesa_HashLockMutex(ctx->Shared->RenderBuffers);
1372 newRb = allocate_renderbuffer_locked(ctx, renderbuffer,
1373 "glBindRenderbufferEXT");
1374 _mesa_HashUnlockMutex(ctx->Shared->RenderBuffers);
1375 }
1376 }
1377 else {
1378 newRb = NULL;
1379 }
1380
1381 assert(newRb != &DummyRenderbuffer);
1382
1383 _mesa_reference_renderbuffer(&ctx->CurrentRenderbuffer, newRb);
1384 }
1385
1386 void GLAPIENTRY
1387 _mesa_BindRenderbuffer(GLenum target, GLuint renderbuffer)
1388 {
1389 GET_CURRENT_CONTEXT(ctx);
1390
1391 /* OpenGL ES glBindRenderbuffer and glBindRenderbufferOES use this same
1392 * entry point, but they allow the use of user-generated names.
1393 */
1394 bind_renderbuffer(target, renderbuffer, _mesa_is_gles(ctx));
1395 }
1396
1397 void GLAPIENTRY
1398 _mesa_BindRenderbufferEXT(GLenum target, GLuint renderbuffer)
1399 {
1400 /* This function should not be in the dispatch table for core profile /
1401 * OpenGL 3.1, so execution should never get here in those cases -- no
1402 * need for an explicit test.
1403 */
1404 bind_renderbuffer(target, renderbuffer, true);
1405 }
1406
1407 /**
1408 * ARB_framebuffer_no_attachment and ARB_sample_locations - Application passes
1409 * requested param's here. NOTE: NumSamples requested need not be _NumSamples
1410 * which is what the hw supports.
1411 */
1412 static void
1413 framebuffer_parameteri(struct gl_context *ctx, struct gl_framebuffer *fb,
1414 GLenum pname, GLint param, const char *func)
1415 {
1416 bool cannot_be_winsys_fbo = false;
1417
1418 switch (pname) {
1419 case GL_FRAMEBUFFER_DEFAULT_WIDTH:
1420 case GL_FRAMEBUFFER_DEFAULT_HEIGHT:
1421 case GL_FRAMEBUFFER_DEFAULT_LAYERS:
1422 case GL_FRAMEBUFFER_DEFAULT_SAMPLES:
1423 case GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS:
1424 if (!ctx->Extensions.ARB_framebuffer_no_attachments)
1425 goto invalid_pname_enum;
1426 cannot_be_winsys_fbo = true;
1427 break;
1428 case GL_FRAMEBUFFER_PROGRAMMABLE_SAMPLE_LOCATIONS_ARB:
1429 case GL_FRAMEBUFFER_SAMPLE_LOCATION_PIXEL_GRID_ARB:
1430 if (!ctx->Extensions.ARB_sample_locations)
1431 goto invalid_pname_enum;
1432 break;
1433 case GL_FRAMEBUFFER_FLIP_Y_MESA:
1434 if (!ctx->Extensions.MESA_framebuffer_flip_y)
1435 goto invalid_pname_enum;
1436 cannot_be_winsys_fbo = true;
1437 default:
1438 goto invalid_pname_enum;
1439 }
1440
1441 if (cannot_be_winsys_fbo && _mesa_is_winsys_fbo(fb)) {
1442 _mesa_error(ctx, GL_INVALID_OPERATION,
1443 "%s(invalid pname=0x%x for default framebuffer)", func, pname);
1444 return;
1445 }
1446
1447 switch (pname) {
1448 case GL_FRAMEBUFFER_DEFAULT_WIDTH:
1449 if (param < 0 || param > ctx->Const.MaxFramebufferWidth)
1450 _mesa_error(ctx, GL_INVALID_VALUE, "%s", func);
1451 else
1452 fb->DefaultGeometry.Width = param;
1453 break;
1454 case GL_FRAMEBUFFER_DEFAULT_HEIGHT:
1455 if (param < 0 || param > ctx->Const.MaxFramebufferHeight)
1456 _mesa_error(ctx, GL_INVALID_VALUE, "%s", func);
1457 else
1458 fb->DefaultGeometry.Height = param;
1459 break;
1460 case GL_FRAMEBUFFER_DEFAULT_LAYERS:
1461 /*
1462 * According to the OpenGL ES 3.1 specification section 9.2.1, the
1463 * GL_FRAMEBUFFER_DEFAULT_LAYERS parameter name is not supported.
1464 */
1465 if (_mesa_is_gles31(ctx) && !ctx->Extensions.OES_geometry_shader) {
1466 _mesa_error(ctx, GL_INVALID_ENUM, "%s(pname=0x%x)", func, pname);
1467 break;
1468 }
1469 if (param < 0 || param > ctx->Const.MaxFramebufferLayers)
1470 _mesa_error(ctx, GL_INVALID_VALUE, "%s", func);
1471 else
1472 fb->DefaultGeometry.Layers = param;
1473 break;
1474 case GL_FRAMEBUFFER_DEFAULT_SAMPLES:
1475 if (param < 0 || param > ctx->Const.MaxFramebufferSamples)
1476 _mesa_error(ctx, GL_INVALID_VALUE, "%s", func);
1477 else
1478 fb->DefaultGeometry.NumSamples = param;
1479 break;
1480 case GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS:
1481 fb->DefaultGeometry.FixedSampleLocations = param;
1482 break;
1483 case GL_FRAMEBUFFER_PROGRAMMABLE_SAMPLE_LOCATIONS_ARB:
1484 fb->ProgrammableSampleLocations = !!param;
1485 break;
1486 case GL_FRAMEBUFFER_SAMPLE_LOCATION_PIXEL_GRID_ARB:
1487 fb->SampleLocationPixelGrid = !!param;
1488 break;
1489 case GL_FRAMEBUFFER_FLIP_Y_MESA:
1490 fb->FlipY = param;
1491 break;
1492 }
1493
1494 switch (pname) {
1495 case GL_FRAMEBUFFER_PROGRAMMABLE_SAMPLE_LOCATIONS_ARB:
1496 case GL_FRAMEBUFFER_SAMPLE_LOCATION_PIXEL_GRID_ARB:
1497 if (fb == ctx->DrawBuffer)
1498 ctx->NewDriverState |= ctx->DriverFlags.NewSampleLocations;
1499 break;
1500 default:
1501 invalidate_framebuffer(fb);
1502 ctx->NewState |= _NEW_BUFFERS;
1503 break;
1504 }
1505
1506 return;
1507
1508 invalid_pname_enum:
1509 _mesa_error(ctx, GL_INVALID_ENUM, "%s(pname=0x%x)", func, pname);
1510 }
1511
1512 void GLAPIENTRY
1513 _mesa_FramebufferParameteri(GLenum target, GLenum pname, GLint param)
1514 {
1515 GET_CURRENT_CONTEXT(ctx);
1516 struct gl_framebuffer *fb;
1517
1518 if (!ctx->Extensions.ARB_framebuffer_no_attachments &&
1519 !ctx->Extensions.ARB_sample_locations) {
1520 _mesa_error(ctx, GL_INVALID_OPERATION,
1521 "glFramebufferParameteriv not supported "
1522 "(neither ARB_framebuffer_no_attachments nor ARB_sample_locations"
1523 " is available)");
1524 return;
1525 }
1526
1527 fb = get_framebuffer_target(ctx, target);
1528 if (!fb) {
1529 _mesa_error(ctx, GL_INVALID_ENUM,
1530 "glFramebufferParameteri(target=0x%x)", target);
1531 return;
1532 }
1533
1534 framebuffer_parameteri(ctx, fb, pname, param, "glFramebufferParameteri");
1535 }
1536
1537 static bool
1538 validate_get_framebuffer_parameteriv_pname(struct gl_context *ctx,
1539 struct gl_framebuffer *fb,
1540 GLuint pname, const char *func)
1541 {
1542 bool cannot_be_winsys_fbo = true;
1543
1544 switch (pname) {
1545 case GL_FRAMEBUFFER_DEFAULT_LAYERS:
1546 /*
1547 * According to the OpenGL ES 3.1 specification section 9.2.3, the
1548 * GL_FRAMEBUFFER_LAYERS parameter name is not supported.
1549 */
1550 if (_mesa_is_gles31(ctx) && !ctx->Extensions.OES_geometry_shader) {
1551 _mesa_error(ctx, GL_INVALID_ENUM, "%s(pname=0x%x)", func, pname);
1552 return false;
1553 }
1554 break;
1555 case GL_FRAMEBUFFER_DEFAULT_WIDTH:
1556 case GL_FRAMEBUFFER_DEFAULT_HEIGHT:
1557 case GL_FRAMEBUFFER_DEFAULT_SAMPLES:
1558 case GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS:
1559 break;
1560 case GL_DOUBLEBUFFER:
1561 case GL_IMPLEMENTATION_COLOR_READ_FORMAT:
1562 case GL_IMPLEMENTATION_COLOR_READ_TYPE:
1563 case GL_SAMPLES:
1564 case GL_SAMPLE_BUFFERS:
1565 case GL_STEREO:
1566 /* From OpenGL 4.5 spec, section 9.2.3 "Framebuffer Object Queries:
1567 *
1568 * "An INVALID_OPERATION error is generated by GetFramebufferParameteriv
1569 * if the default framebuffer is bound to target and pname is not one
1570 * of the accepted values from table 23.73, other than
1571 * SAMPLE_POSITION."
1572 *
1573 * For OpenGL ES, using default framebuffer raises INVALID_OPERATION
1574 * for any pname.
1575 */
1576 cannot_be_winsys_fbo = !_mesa_is_desktop_gl(ctx);
1577 break;
1578 case GL_FRAMEBUFFER_PROGRAMMABLE_SAMPLE_LOCATIONS_ARB:
1579 case GL_FRAMEBUFFER_SAMPLE_LOCATION_PIXEL_GRID_ARB:
1580 if (!ctx->Extensions.ARB_sample_locations)
1581 goto invalid_pname_enum;
1582 cannot_be_winsys_fbo = false;
1583 break;
1584 case GL_FRAMEBUFFER_FLIP_Y_MESA:
1585 if (!ctx->Extensions.MESA_framebuffer_flip_y) {
1586 _mesa_error(ctx, GL_INVALID_ENUM, "%s(pname=0x%x)", func, pname);
1587 return false;
1588 }
1589 break;
1590 default:
1591 goto invalid_pname_enum;
1592 }
1593
1594 if (cannot_be_winsys_fbo && _mesa_is_winsys_fbo(fb)) {
1595 _mesa_error(ctx, GL_INVALID_OPERATION,
1596 "%s(invalid pname=0x%x for default framebuffer)", func, pname);
1597 return false;
1598 }
1599
1600 return true;
1601
1602 invalid_pname_enum:
1603 _mesa_error(ctx, GL_INVALID_ENUM, "%s(pname=0x%x)", func, pname);
1604 return false;
1605 }
1606
1607 static void
1608 get_framebuffer_parameteriv(struct gl_context *ctx, struct gl_framebuffer *fb,
1609 GLenum pname, GLint *params, const char *func)
1610 {
1611 if (!validate_get_framebuffer_parameteriv_pname(ctx, fb, pname, func))
1612 return;
1613
1614 switch (pname) {
1615 case GL_FRAMEBUFFER_DEFAULT_WIDTH:
1616 *params = fb->DefaultGeometry.Width;
1617 break;
1618 case GL_FRAMEBUFFER_DEFAULT_HEIGHT:
1619 *params = fb->DefaultGeometry.Height;
1620 break;
1621 case GL_FRAMEBUFFER_DEFAULT_LAYERS:
1622 *params = fb->DefaultGeometry.Layers;
1623 break;
1624 case GL_FRAMEBUFFER_DEFAULT_SAMPLES:
1625 *params = fb->DefaultGeometry.NumSamples;
1626 break;
1627 case GL_FRAMEBUFFER_DEFAULT_FIXED_SAMPLE_LOCATIONS:
1628 *params = fb->DefaultGeometry.FixedSampleLocations;
1629 break;
1630 case GL_DOUBLEBUFFER:
1631 *params = fb->Visual.doubleBufferMode;
1632 break;
1633 case GL_IMPLEMENTATION_COLOR_READ_FORMAT:
1634 *params = _mesa_get_color_read_format(ctx, fb, func);
1635 break;
1636 case GL_IMPLEMENTATION_COLOR_READ_TYPE:
1637 *params = _mesa_get_color_read_type(ctx, fb, func);
1638 break;
1639 case GL_SAMPLES:
1640 *params = _mesa_geometric_samples(fb);
1641 break;
1642 case GL_SAMPLE_BUFFERS:
1643 *params = _mesa_geometric_samples(fb) > 0;
1644 break;
1645 case GL_STEREO:
1646 *params = fb->Visual.stereoMode;
1647 break;
1648 case GL_FRAMEBUFFER_PROGRAMMABLE_SAMPLE_LOCATIONS_ARB:
1649 *params = fb->ProgrammableSampleLocations;
1650 break;
1651 case GL_FRAMEBUFFER_SAMPLE_LOCATION_PIXEL_GRID_ARB:
1652 *params = fb->SampleLocationPixelGrid;
1653 break;
1654 case GL_FRAMEBUFFER_FLIP_Y_MESA:
1655 *params = fb->FlipY;
1656 break;
1657 }
1658 }
1659
1660 void GLAPIENTRY
1661 _mesa_GetFramebufferParameteriv(GLenum target, GLenum pname, GLint *params)
1662 {
1663 GET_CURRENT_CONTEXT(ctx);
1664 struct gl_framebuffer *fb;
1665
1666 if (!ctx->Extensions.ARB_framebuffer_no_attachments &&
1667 !ctx->Extensions.ARB_sample_locations) {
1668 _mesa_error(ctx, GL_INVALID_OPERATION,
1669 "glGetFramebufferParameteriv not supported "
1670 "(neither ARB_framebuffer_no_attachments nor ARB_sample_locations"
1671 " is available)");
1672 return;
1673 }
1674
1675 fb = get_framebuffer_target(ctx, target);
1676 if (!fb) {
1677 _mesa_error(ctx, GL_INVALID_ENUM,
1678 "glGetFramebufferParameteriv(target=0x%x)", target);
1679 return;
1680 }
1681
1682 get_framebuffer_parameteriv(ctx, fb, pname, params,
1683 "glGetFramebufferParameteriv");
1684 }
1685
1686
1687 /**
1688 * Remove the specified renderbuffer or texture from any attachment point in
1689 * the framebuffer.
1690 *
1691 * \returns
1692 * \c true if the renderbuffer was detached from an attachment point. \c
1693 * false otherwise.
1694 */
1695 bool
1696 _mesa_detach_renderbuffer(struct gl_context *ctx,
1697 struct gl_framebuffer *fb,
1698 const void *att)
1699 {
1700 unsigned i;
1701 bool progress = false;
1702
1703 for (i = 0; i < BUFFER_COUNT; i++) {
1704 if (fb->Attachment[i].Texture == att
1705 || fb->Attachment[i].Renderbuffer == att) {
1706 remove_attachment(ctx, &fb->Attachment[i]);
1707 progress = true;
1708 }
1709 }
1710
1711 /* Section 4.4.4 (Framebuffer Completeness), subsection "Whole Framebuffer
1712 * Completeness," of the OpenGL 3.1 spec says:
1713 *
1714 * "Performing any of the following actions may change whether the
1715 * framebuffer is considered complete or incomplete:
1716 *
1717 * ...
1718 *
1719 * - Deleting, with DeleteTextures or DeleteRenderbuffers, an object
1720 * containing an image that is attached to a framebuffer object
1721 * that is bound to the framebuffer."
1722 */
1723 if (progress)
1724 invalidate_framebuffer(fb);
1725
1726 return progress;
1727 }
1728
1729
1730 void GLAPIENTRY
1731 _mesa_DeleteRenderbuffers(GLsizei n, const GLuint *renderbuffers)
1732 {
1733 GLint i;
1734 GET_CURRENT_CONTEXT(ctx);
1735
1736 if (n < 0) {
1737 _mesa_error(ctx, GL_INVALID_VALUE, "glDeleteRenderbuffers(n < 0)");
1738 return;
1739 }
1740
1741 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1742
1743 for (i = 0; i < n; i++) {
1744 if (renderbuffers[i] > 0) {
1745 struct gl_renderbuffer *rb;
1746 rb = _mesa_lookup_renderbuffer(ctx, renderbuffers[i]);
1747 if (rb) {
1748 /* check if deleting currently bound renderbuffer object */
1749 if (rb == ctx->CurrentRenderbuffer) {
1750 /* bind default */
1751 assert(rb->RefCount >= 2);
1752 _mesa_BindRenderbuffer(GL_RENDERBUFFER_EXT, 0);
1753 }
1754
1755 /* Section 4.4.2 (Attaching Images to Framebuffer Objects),
1756 * subsection "Attaching Renderbuffer Images to a Framebuffer,"
1757 * of the OpenGL 3.1 spec says:
1758 *
1759 * "If a renderbuffer object is deleted while its image is
1760 * attached to one or more attachment points in the currently
1761 * bound framebuffer, then it is as if FramebufferRenderbuffer
1762 * had been called, with a renderbuffer of 0, for each
1763 * attachment point to which this image was attached in the
1764 * currently bound framebuffer. In other words, this
1765 * renderbuffer image is first detached from all attachment
1766 * points in the currently bound framebuffer. Note that the
1767 * renderbuffer image is specifically not detached from any
1768 * non-bound framebuffers. Detaching the image from any
1769 * non-bound framebuffers is the responsibility of the
1770 * application.
1771 */
1772 if (_mesa_is_user_fbo(ctx->DrawBuffer)) {
1773 _mesa_detach_renderbuffer(ctx, ctx->DrawBuffer, rb);
1774 }
1775 if (_mesa_is_user_fbo(ctx->ReadBuffer)
1776 && ctx->ReadBuffer != ctx->DrawBuffer) {
1777 _mesa_detach_renderbuffer(ctx, ctx->ReadBuffer, rb);
1778 }
1779
1780 /* Remove from hash table immediately, to free the ID.
1781 * But the object will not be freed until it's no longer
1782 * referenced anywhere else.
1783 */
1784 _mesa_HashRemove(ctx->Shared->RenderBuffers, renderbuffers[i]);
1785
1786 if (rb != &DummyRenderbuffer) {
1787 /* no longer referenced by hash table */
1788 _mesa_reference_renderbuffer(&rb, NULL);
1789 }
1790 }
1791 }
1792 }
1793 }
1794
1795 static void
1796 create_render_buffers(struct gl_context *ctx, GLsizei n, GLuint *renderbuffers,
1797 bool dsa)
1798 {
1799 const char *func = dsa ? "glCreateRenderbuffers" : "glGenRenderbuffers";
1800 GLuint first;
1801 GLint i;
1802
1803 if (!renderbuffers)
1804 return;
1805
1806 _mesa_HashLockMutex(ctx->Shared->RenderBuffers);
1807
1808 first = _mesa_HashFindFreeKeyBlock(ctx->Shared->RenderBuffers, n);
1809
1810 for (i = 0; i < n; i++) {
1811 GLuint name = first + i;
1812 renderbuffers[i] = name;
1813
1814 if (dsa) {
1815 allocate_renderbuffer_locked(ctx, name, func);
1816 } else {
1817 /* insert a dummy renderbuffer into the hash table */
1818 _mesa_HashInsertLocked(ctx->Shared->RenderBuffers, name,
1819 &DummyRenderbuffer);
1820 }
1821 }
1822
1823 _mesa_HashUnlockMutex(ctx->Shared->RenderBuffers);
1824 }
1825
1826
1827 static void
1828 create_render_buffers_err(struct gl_context *ctx, GLsizei n,
1829 GLuint *renderbuffers, bool dsa)
1830 {
1831 const char *func = dsa ? "glCreateRenderbuffers" : "glGenRenderbuffers";
1832
1833 if (n < 0) {
1834 _mesa_error(ctx, GL_INVALID_VALUE, "%s(n<0)", func);
1835 return;
1836 }
1837
1838 create_render_buffers(ctx, n, renderbuffers, dsa);
1839 }
1840
1841
1842 void GLAPIENTRY
1843 _mesa_GenRenderbuffers_no_error(GLsizei n, GLuint *renderbuffers)
1844 {
1845 GET_CURRENT_CONTEXT(ctx);
1846 create_render_buffers(ctx, n, renderbuffers, false);
1847 }
1848
1849
1850 void GLAPIENTRY
1851 _mesa_GenRenderbuffers(GLsizei n, GLuint *renderbuffers)
1852 {
1853 GET_CURRENT_CONTEXT(ctx);
1854 create_render_buffers_err(ctx, n, renderbuffers, false);
1855 }
1856
1857
1858 void GLAPIENTRY
1859 _mesa_CreateRenderbuffers_no_error(GLsizei n, GLuint *renderbuffers)
1860 {
1861 GET_CURRENT_CONTEXT(ctx);
1862 create_render_buffers(ctx, n, renderbuffers, true);
1863 }
1864
1865
1866 void GLAPIENTRY
1867 _mesa_CreateRenderbuffers(GLsizei n, GLuint *renderbuffers)
1868 {
1869 GET_CURRENT_CONTEXT(ctx);
1870 create_render_buffers_err(ctx, n, renderbuffers, true);
1871 }
1872
1873
1874 /**
1875 * Given an internal format token for a render buffer, return the
1876 * corresponding base format (one of GL_RGB, GL_RGBA, GL_STENCIL_INDEX,
1877 * GL_DEPTH_COMPONENT, GL_DEPTH_STENCIL_EXT, GL_ALPHA, GL_LUMINANCE,
1878 * GL_LUMINANCE_ALPHA, GL_INTENSITY, etc).
1879 *
1880 * This is similar to _mesa_base_tex_format() but the set of valid
1881 * internal formats is different.
1882 *
1883 * Note that even if a format is determined to be legal here, validation
1884 * of the FBO may fail if the format is not supported by the driver/GPU.
1885 *
1886 * \param internalFormat as passed to glRenderbufferStorage()
1887 * \return the base internal format, or 0 if internalFormat is illegal
1888 */
1889 GLenum
1890 _mesa_base_fbo_format(const struct gl_context *ctx, GLenum internalFormat)
1891 {
1892 /*
1893 * Notes: some formats such as alpha, luminance, etc. were added
1894 * with GL_ARB_framebuffer_object.
1895 */
1896 switch (internalFormat) {
1897 case GL_ALPHA:
1898 case GL_ALPHA4:
1899 case GL_ALPHA8:
1900 case GL_ALPHA12:
1901 case GL_ALPHA16:
1902 return (ctx->API == API_OPENGL_COMPAT &&
1903 ctx->Extensions.ARB_framebuffer_object) ? GL_ALPHA : 0;
1904 case GL_LUMINANCE:
1905 case GL_LUMINANCE4:
1906 case GL_LUMINANCE8:
1907 case GL_LUMINANCE12:
1908 case GL_LUMINANCE16:
1909 return (ctx->API == API_OPENGL_COMPAT &&
1910 ctx->Extensions.ARB_framebuffer_object) ? GL_LUMINANCE : 0;
1911 case GL_LUMINANCE_ALPHA:
1912 case GL_LUMINANCE4_ALPHA4:
1913 case GL_LUMINANCE6_ALPHA2:
1914 case GL_LUMINANCE8_ALPHA8:
1915 case GL_LUMINANCE12_ALPHA4:
1916 case GL_LUMINANCE12_ALPHA12:
1917 case GL_LUMINANCE16_ALPHA16:
1918 return (ctx->API == API_OPENGL_COMPAT &&
1919 ctx->Extensions.ARB_framebuffer_object) ? GL_LUMINANCE_ALPHA : 0;
1920 case GL_INTENSITY:
1921 case GL_INTENSITY4:
1922 case GL_INTENSITY8:
1923 case GL_INTENSITY12:
1924 case GL_INTENSITY16:
1925 return (ctx->API == API_OPENGL_COMPAT &&
1926 ctx->Extensions.ARB_framebuffer_object) ? GL_INTENSITY : 0;
1927 case GL_RGB8:
1928 return GL_RGB;
1929 case GL_RGB:
1930 case GL_R3_G3_B2:
1931 case GL_RGB4:
1932 case GL_RGB5:
1933 case GL_RGB10:
1934 case GL_RGB12:
1935 case GL_RGB16:
1936 return _mesa_is_desktop_gl(ctx) ? GL_RGB : 0;
1937 case GL_SRGB8_EXT:
1938 return _mesa_is_desktop_gl(ctx) ? GL_RGB : 0;
1939 case GL_RGBA4:
1940 case GL_RGB5_A1:
1941 case GL_RGBA8:
1942 return GL_RGBA;
1943 case GL_RGBA:
1944 case GL_RGBA2:
1945 case GL_RGBA12:
1946 return _mesa_is_desktop_gl(ctx) ? GL_RGBA : 0;
1947 case GL_RGBA16:
1948 return _mesa_is_desktop_gl(ctx) || _mesa_has_EXT_texture_norm16(ctx)
1949 ? GL_RGBA : 0;
1950 case GL_RGB10_A2:
1951 case GL_SRGB8_ALPHA8_EXT:
1952 return _mesa_is_desktop_gl(ctx) || _mesa_is_gles3(ctx) ? GL_RGBA : 0;
1953 case GL_STENCIL_INDEX:
1954 case GL_STENCIL_INDEX1_EXT:
1955 case GL_STENCIL_INDEX4_EXT:
1956 case GL_STENCIL_INDEX16_EXT:
1957 /* There are extensions for GL_STENCIL_INDEX1 and GL_STENCIL_INDEX4 in
1958 * OpenGL ES, but Mesa does not currently support them.
1959 */
1960 return _mesa_is_desktop_gl(ctx) ? GL_STENCIL_INDEX : 0;
1961 case GL_STENCIL_INDEX8_EXT:
1962 return GL_STENCIL_INDEX;
1963 case GL_DEPTH_COMPONENT:
1964 case GL_DEPTH_COMPONENT32:
1965 return _mesa_is_desktop_gl(ctx) ? GL_DEPTH_COMPONENT : 0;
1966 case GL_DEPTH_COMPONENT16:
1967 case GL_DEPTH_COMPONENT24:
1968 return GL_DEPTH_COMPONENT;
1969 case GL_DEPTH_STENCIL:
1970 return _mesa_is_desktop_gl(ctx) ? GL_DEPTH_STENCIL : 0;
1971 case GL_DEPTH24_STENCIL8:
1972 return GL_DEPTH_STENCIL;
1973 case GL_DEPTH_COMPONENT32F:
1974 return ctx->Version >= 30
1975 || (ctx->API == API_OPENGL_COMPAT &&
1976 ctx->Extensions.ARB_depth_buffer_float)
1977 ? GL_DEPTH_COMPONENT : 0;
1978 case GL_DEPTH32F_STENCIL8:
1979 return ctx->Version >= 30
1980 || (ctx->API == API_OPENGL_COMPAT &&
1981 ctx->Extensions.ARB_depth_buffer_float)
1982 ? GL_DEPTH_STENCIL : 0;
1983 case GL_RED:
1984 return _mesa_has_ARB_texture_rg(ctx) ? GL_RED : 0;
1985 case GL_R16:
1986 return _mesa_has_ARB_texture_rg(ctx) || _mesa_has_EXT_texture_norm16(ctx)
1987 ? GL_RED : 0;
1988 case GL_R8:
1989 return ctx->API != API_OPENGLES && ctx->Extensions.ARB_texture_rg
1990 ? GL_RED : 0;
1991 case GL_RG:
1992 return _mesa_has_ARB_texture_rg(ctx) ? GL_RG : 0;
1993 case GL_RG16:
1994 return _mesa_has_ARB_texture_rg(ctx) || _mesa_has_EXT_texture_norm16(ctx)
1995 ? GL_RG : 0;
1996 case GL_RG8:
1997 return ctx->API != API_OPENGLES && ctx->Extensions.ARB_texture_rg
1998 ? GL_RG : 0;
1999 /* signed normalized texture formats */
2000 case GL_RED_SNORM:
2001 case GL_R8_SNORM:
2002 case GL_R16_SNORM:
2003 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2004 ? GL_RED : 0;
2005 case GL_RG_SNORM:
2006 case GL_RG8_SNORM:
2007 case GL_RG16_SNORM:
2008 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2009 ? GL_RG : 0;
2010 case GL_RGB_SNORM:
2011 case GL_RGB8_SNORM:
2012 case GL_RGB16_SNORM:
2013 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2014 ? GL_RGB : 0;
2015 case GL_RGBA_SNORM:
2016 case GL_RGBA8_SNORM:
2017 case GL_RGBA16_SNORM:
2018 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2019 ? GL_RGBA : 0;
2020 case GL_ALPHA_SNORM:
2021 case GL_ALPHA8_SNORM:
2022 case GL_ALPHA16_SNORM:
2023 return ctx->API == API_OPENGL_COMPAT &&
2024 ctx->Extensions.EXT_texture_snorm &&
2025 ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
2026 case GL_LUMINANCE_SNORM:
2027 case GL_LUMINANCE8_SNORM:
2028 case GL_LUMINANCE16_SNORM:
2029 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2030 ? GL_LUMINANCE : 0;
2031 case GL_LUMINANCE_ALPHA_SNORM:
2032 case GL_LUMINANCE8_ALPHA8_SNORM:
2033 case GL_LUMINANCE16_ALPHA16_SNORM:
2034 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2035 ? GL_LUMINANCE_ALPHA : 0;
2036 case GL_INTENSITY_SNORM:
2037 case GL_INTENSITY8_SNORM:
2038 case GL_INTENSITY16_SNORM:
2039 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_snorm
2040 ? GL_INTENSITY : 0;
2041
2042 case GL_R16F:
2043 case GL_R32F:
2044 return ((_mesa_is_desktop_gl(ctx) &&
2045 ctx->Extensions.ARB_texture_rg &&
2046 ctx->Extensions.ARB_texture_float) ||
2047 _mesa_is_gles3(ctx) /* EXT_color_buffer_float */ )
2048 ? GL_RED : 0;
2049 case GL_RG16F:
2050 case GL_RG32F:
2051 return ((_mesa_is_desktop_gl(ctx) &&
2052 ctx->Extensions.ARB_texture_rg &&
2053 ctx->Extensions.ARB_texture_float) ||
2054 _mesa_is_gles3(ctx) /* EXT_color_buffer_float */ )
2055 ? GL_RG : 0;
2056 case GL_RGB16F:
2057 case GL_RGB32F:
2058 return (_mesa_is_desktop_gl(ctx) && ctx->Extensions.ARB_texture_float)
2059 ? GL_RGB : 0;
2060 case GL_RGBA16F:
2061 case GL_RGBA32F:
2062 return ((_mesa_is_desktop_gl(ctx) &&
2063 ctx->Extensions.ARB_texture_float) ||
2064 _mesa_is_gles3(ctx) /* EXT_color_buffer_float */ )
2065 ? GL_RGBA : 0;
2066 case GL_RGB9_E5:
2067 return (_mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_shared_exponent)
2068 ? GL_RGB: 0;
2069 case GL_ALPHA16F_ARB:
2070 case GL_ALPHA32F_ARB:
2071 return ctx->API == API_OPENGL_COMPAT &&
2072 ctx->Extensions.ARB_texture_float &&
2073 ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
2074 case GL_LUMINANCE16F_ARB:
2075 case GL_LUMINANCE32F_ARB:
2076 return ctx->API == API_OPENGL_COMPAT &&
2077 ctx->Extensions.ARB_texture_float &&
2078 ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
2079 case GL_LUMINANCE_ALPHA16F_ARB:
2080 case GL_LUMINANCE_ALPHA32F_ARB:
2081 return ctx->API == API_OPENGL_COMPAT &&
2082 ctx->Extensions.ARB_texture_float &&
2083 ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
2084 case GL_INTENSITY16F_ARB:
2085 case GL_INTENSITY32F_ARB:
2086 return ctx->API == API_OPENGL_COMPAT &&
2087 ctx->Extensions.ARB_texture_float &&
2088 ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
2089 case GL_R11F_G11F_B10F:
2090 return ((_mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_packed_float) ||
2091 _mesa_is_gles3(ctx) /* EXT_color_buffer_float */ )
2092 ? GL_RGB : 0;
2093
2094 case GL_RGBA8UI_EXT:
2095 case GL_RGBA16UI_EXT:
2096 case GL_RGBA32UI_EXT:
2097 case GL_RGBA8I_EXT:
2098 case GL_RGBA16I_EXT:
2099 case GL_RGBA32I_EXT:
2100 return ctx->Version >= 30
2101 || (_mesa_is_desktop_gl(ctx) &&
2102 ctx->Extensions.EXT_texture_integer) ? GL_RGBA : 0;
2103
2104 case GL_RGB8UI_EXT:
2105 case GL_RGB16UI_EXT:
2106 case GL_RGB32UI_EXT:
2107 case GL_RGB8I_EXT:
2108 case GL_RGB16I_EXT:
2109 case GL_RGB32I_EXT:
2110 return _mesa_is_desktop_gl(ctx) && ctx->Extensions.EXT_texture_integer
2111 ? GL_RGB : 0;
2112 case GL_R8UI:
2113 case GL_R8I:
2114 case GL_R16UI:
2115 case GL_R16I:
2116 case GL_R32UI:
2117 case GL_R32I:
2118 return ctx->Version >= 30
2119 || (_mesa_is_desktop_gl(ctx) &&
2120 ctx->Extensions.ARB_texture_rg &&
2121 ctx->Extensions.EXT_texture_integer) ? GL_RED : 0;
2122
2123 case GL_RG8UI:
2124 case GL_RG8I:
2125 case GL_RG16UI:
2126 case GL_RG16I:
2127 case GL_RG32UI:
2128 case GL_RG32I:
2129 return ctx->Version >= 30
2130 || (_mesa_is_desktop_gl(ctx) &&
2131 ctx->Extensions.ARB_texture_rg &&
2132 ctx->Extensions.EXT_texture_integer) ? GL_RG : 0;
2133
2134 case GL_INTENSITY8I_EXT:
2135 case GL_INTENSITY8UI_EXT:
2136 case GL_INTENSITY16I_EXT:
2137 case GL_INTENSITY16UI_EXT:
2138 case GL_INTENSITY32I_EXT:
2139 case GL_INTENSITY32UI_EXT:
2140 return ctx->API == API_OPENGL_COMPAT &&
2141 ctx->Extensions.EXT_texture_integer &&
2142 ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
2143
2144 case GL_LUMINANCE8I_EXT:
2145 case GL_LUMINANCE8UI_EXT:
2146 case GL_LUMINANCE16I_EXT:
2147 case GL_LUMINANCE16UI_EXT:
2148 case GL_LUMINANCE32I_EXT:
2149 case GL_LUMINANCE32UI_EXT:
2150 return ctx->API == API_OPENGL_COMPAT &&
2151 ctx->Extensions.EXT_texture_integer &&
2152 ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
2153
2154 case GL_LUMINANCE_ALPHA8I_EXT:
2155 case GL_LUMINANCE_ALPHA8UI_EXT:
2156 case GL_LUMINANCE_ALPHA16I_EXT:
2157 case GL_LUMINANCE_ALPHA16UI_EXT:
2158 case GL_LUMINANCE_ALPHA32I_EXT:
2159 case GL_LUMINANCE_ALPHA32UI_EXT:
2160 return ctx->API == API_OPENGL_COMPAT &&
2161 ctx->Extensions.EXT_texture_integer &&
2162 ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
2163
2164 case GL_ALPHA8I_EXT:
2165 case GL_ALPHA8UI_EXT:
2166 case GL_ALPHA16I_EXT:
2167 case GL_ALPHA16UI_EXT:
2168 case GL_ALPHA32I_EXT:
2169 case GL_ALPHA32UI_EXT:
2170 return ctx->API == API_OPENGL_COMPAT &&
2171 ctx->Extensions.EXT_texture_integer &&
2172 ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
2173
2174 case GL_RGB10_A2UI:
2175 return (_mesa_is_desktop_gl(ctx) &&
2176 ctx->Extensions.ARB_texture_rgb10_a2ui)
2177 || _mesa_is_gles3(ctx) ? GL_RGBA : 0;
2178
2179 case GL_RGB565:
2180 return _mesa_is_gles(ctx) || ctx->Extensions.ARB_ES2_compatibility
2181 ? GL_RGB : 0;
2182 default:
2183 return 0;
2184 }
2185 }
2186
2187
2188 /**
2189 * Invalidate a renderbuffer attachment. Called from _mesa_HashWalk().
2190 */
2191 static void
2192 invalidate_rb(GLuint key, void *data, void *userData)
2193 {
2194 struct gl_framebuffer *fb = (struct gl_framebuffer *) data;
2195 struct gl_renderbuffer *rb = (struct gl_renderbuffer *) userData;
2196
2197 /* If this is a user-created FBO */
2198 if (_mesa_is_user_fbo(fb)) {
2199 GLuint i;
2200 for (i = 0; i < BUFFER_COUNT; i++) {
2201 struct gl_renderbuffer_attachment *att = fb->Attachment + i;
2202 if (att->Type == GL_RENDERBUFFER &&
2203 att->Renderbuffer == rb) {
2204 /* Mark fb status as indeterminate to force re-validation */
2205 fb->_Status = 0;
2206 return;
2207 }
2208 }
2209 }
2210 }
2211
2212
2213 /** sentinal value, see below */
2214 #define NO_SAMPLES 1000
2215
2216 void
2217 _mesa_renderbuffer_storage(struct gl_context *ctx, struct gl_renderbuffer *rb,
2218 GLenum internalFormat, GLsizei width,
2219 GLsizei height, GLsizei samples,
2220 GLsizei storageSamples)
2221 {
2222 const GLenum baseFormat = _mesa_base_fbo_format(ctx, internalFormat);
2223
2224 assert(baseFormat != 0);
2225 assert(width >= 0 && width <= (GLsizei) ctx->Const.MaxRenderbufferSize);
2226 assert(height >= 0 && height <= (GLsizei) ctx->Const.MaxRenderbufferSize);
2227 assert(samples != NO_SAMPLES);
2228 if (samples != 0) {
2229 assert(samples > 0);
2230 assert(_mesa_check_sample_count(ctx, GL_RENDERBUFFER,
2231 internalFormat, samples,
2232 storageSamples) == GL_NO_ERROR);
2233 }
2234
2235 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2236
2237 if (rb->InternalFormat == internalFormat &&
2238 rb->Width == (GLuint) width &&
2239 rb->Height == (GLuint) height &&
2240 rb->NumSamples == samples) {
2241 /* no change in allocation needed */
2242 return;
2243 }
2244
2245 /* These MUST get set by the AllocStorage func */
2246 rb->Format = MESA_FORMAT_NONE;
2247 rb->NumSamples = samples;
2248
2249 /* Now allocate the storage */
2250 assert(rb->AllocStorage);
2251 if (rb->AllocStorage(ctx, rb, internalFormat, width, height)) {
2252 /* No error - check/set fields now */
2253 /* If rb->Format == MESA_FORMAT_NONE, the format is unsupported. */
2254 assert(rb->Width == (GLuint) width);
2255 assert(rb->Height == (GLuint) height);
2256 rb->InternalFormat = internalFormat;
2257 rb->_BaseFormat = baseFormat;
2258 assert(rb->_BaseFormat != 0);
2259 }
2260 else {
2261 /* Probably ran out of memory - clear the fields */
2262 rb->Width = 0;
2263 rb->Height = 0;
2264 rb->Format = MESA_FORMAT_NONE;
2265 rb->InternalFormat = GL_NONE;
2266 rb->_BaseFormat = GL_NONE;
2267 rb->NumSamples = 0;
2268 }
2269
2270 /* Invalidate the framebuffers the renderbuffer is attached in. */
2271 if (rb->AttachedAnytime) {
2272 _mesa_HashWalk(ctx->Shared->FrameBuffers, invalidate_rb, rb);
2273 }
2274 }
2275
2276 /**
2277 * Helper function used by renderbuffer_storage_direct() and
2278 * renderbuffer_storage_target().
2279 * samples will be NO_SAMPLES if called by a non-multisample function.
2280 */
2281 static void
2282 renderbuffer_storage(struct gl_context *ctx, struct gl_renderbuffer *rb,
2283 GLenum internalFormat, GLsizei width,
2284 GLsizei height, GLsizei samples, GLsizei storageSamples,
2285 const char *func)
2286 {
2287 GLenum baseFormat;
2288 GLenum sample_count_error;
2289
2290 baseFormat = _mesa_base_fbo_format(ctx, internalFormat);
2291 if (baseFormat == 0) {
2292 _mesa_error(ctx, GL_INVALID_ENUM, "%s(internalFormat=%s)",
2293 func, _mesa_enum_to_string(internalFormat));
2294 return;
2295 }
2296
2297 if (width < 0 || width > (GLsizei) ctx->Const.MaxRenderbufferSize) {
2298 _mesa_error(ctx, GL_INVALID_VALUE, "%s(invalid width %d)", func,
2299 width);
2300 return;
2301 }
2302
2303 if (height < 0 || height > (GLsizei) ctx->Const.MaxRenderbufferSize) {
2304 _mesa_error(ctx, GL_INVALID_VALUE, "%s(invalid height %d)", func,
2305 height);
2306 return;
2307 }
2308
2309 if (samples == NO_SAMPLES) {
2310 /* NumSamples == 0 indicates non-multisampling */
2311 samples = 0;
2312 storageSamples = 0;
2313 }
2314 else {
2315 /* check the sample count;
2316 * note: driver may choose to use more samples than what's requested
2317 */
2318 sample_count_error = _mesa_check_sample_count(ctx, GL_RENDERBUFFER,
2319 internalFormat, samples, storageSamples);
2320
2321 /* Section 2.5 (GL Errors) of OpenGL 3.0 specification, page 16:
2322 *
2323 * "If a negative number is provided where an argument of type sizei or
2324 * sizeiptr is specified, the error INVALID VALUE is generated."
2325 */
2326 if (samples < 0 || storageSamples < 0) {
2327 sample_count_error = GL_INVALID_VALUE;
2328 }
2329
2330 if (sample_count_error != GL_NO_ERROR) {
2331 _mesa_error(ctx, sample_count_error,
2332 "%s(samples=%d, storageSamples=%d)", func, samples,
2333 storageSamples);
2334 return;
2335 }
2336 }
2337
2338 _mesa_renderbuffer_storage(ctx, rb, internalFormat, width, height, samples,
2339 storageSamples);
2340 }
2341
2342 /**
2343 * Helper function used by _mesa_NamedRenderbufferStorage*().
2344 * samples will be NO_SAMPLES if called by a non-multisample function.
2345 */
2346 static void
2347 renderbuffer_storage_named(GLuint renderbuffer, GLenum internalFormat,
2348 GLsizei width, GLsizei height, GLsizei samples,
2349 GLsizei storageSamples, const char *func)
2350 {
2351 GET_CURRENT_CONTEXT(ctx);
2352
2353 if (MESA_VERBOSE & VERBOSE_API) {
2354 if (samples == NO_SAMPLES)
2355 _mesa_debug(ctx, "%s(%u, %s, %d, %d)\n",
2356 func, renderbuffer,
2357 _mesa_enum_to_string(internalFormat),
2358 width, height);
2359 else
2360 _mesa_debug(ctx, "%s(%u, %s, %d, %d, %d)\n",
2361 func, renderbuffer,
2362 _mesa_enum_to_string(internalFormat),
2363 width, height, samples);
2364 }
2365
2366 struct gl_renderbuffer *rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
2367 if (!rb || rb == &DummyRenderbuffer) {
2368 /* ID was reserved, but no real renderbuffer object made yet */
2369 _mesa_error(ctx, GL_INVALID_OPERATION, "%s(invalid renderbuffer %u)",
2370 func, renderbuffer);
2371 return;
2372 }
2373
2374 renderbuffer_storage(ctx, rb, internalFormat, width, height, samples,
2375 storageSamples, func);
2376 }
2377
2378 /**
2379 * Helper function used by _mesa_RenderbufferStorage() and
2380 * _mesa_RenderbufferStorageMultisample().
2381 * samples will be NO_SAMPLES if called by _mesa_RenderbufferStorage().
2382 */
2383 static void
2384 renderbuffer_storage_target(GLenum target, GLenum internalFormat,
2385 GLsizei width, GLsizei height, GLsizei samples,
2386 GLsizei storageSamples, const char *func)
2387 {
2388 GET_CURRENT_CONTEXT(ctx);
2389
2390 if (MESA_VERBOSE & VERBOSE_API) {
2391 if (samples == NO_SAMPLES)
2392 _mesa_debug(ctx, "%s(%s, %s, %d, %d)\n",
2393 func,
2394 _mesa_enum_to_string(target),
2395 _mesa_enum_to_string(internalFormat),
2396 width, height);
2397 else
2398 _mesa_debug(ctx, "%s(%s, %s, %d, %d, %d)\n",
2399 func,
2400 _mesa_enum_to_string(target),
2401 _mesa_enum_to_string(internalFormat),
2402 width, height, samples);
2403 }
2404
2405 if (target != GL_RENDERBUFFER_EXT) {
2406 _mesa_error(ctx, GL_INVALID_ENUM, "%s(target)", func);
2407 return;
2408 }
2409
2410 if (!ctx->CurrentRenderbuffer) {
2411 _mesa_error(ctx, GL_INVALID_OPERATION, "%s(no renderbuffer bound)",
2412 func);
2413 return;
2414 }
2415
2416 renderbuffer_storage(ctx, ctx->CurrentRenderbuffer, internalFormat, width,
2417 height, samples, storageSamples, func);
2418 }
2419
2420
2421 void GLAPIENTRY
2422 _mesa_EGLImageTargetRenderbufferStorageOES(GLenum target, GLeglImageOES image)
2423 {
2424 struct gl_renderbuffer *rb;
2425 GET_CURRENT_CONTEXT(ctx);
2426
2427 if (!ctx->Extensions.OES_EGL_image) {
2428 _mesa_error(ctx, GL_INVALID_OPERATION,
2429 "glEGLImageTargetRenderbufferStorageOES(unsupported)");
2430 return;
2431 }
2432
2433 if (target != GL_RENDERBUFFER) {
2434 _mesa_error(ctx, GL_INVALID_ENUM,
2435 "EGLImageTargetRenderbufferStorageOES");
2436 return;
2437 }
2438
2439 rb = ctx->CurrentRenderbuffer;
2440 if (!rb) {
2441 _mesa_error(ctx, GL_INVALID_OPERATION,
2442 "EGLImageTargetRenderbufferStorageOES");
2443 return;
2444 }
2445
2446 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2447
2448 ctx->Driver.EGLImageTargetRenderbufferStorage(ctx, rb, image);
2449 }
2450
2451
2452 /**
2453 * Helper function for _mesa_GetRenderbufferParameteriv() and
2454 * _mesa_GetFramebufferAttachmentParameteriv()
2455 * We have to be careful to respect the base format. For example, if a
2456 * renderbuffer/texture was created with internalFormat=GL_RGB but the
2457 * driver actually chose a GL_RGBA format, when the user queries ALPHA_SIZE
2458 * we need to return zero.
2459 */
2460 static GLint
2461 get_component_bits(GLenum pname, GLenum baseFormat, mesa_format format)
2462 {
2463 if (_mesa_base_format_has_channel(baseFormat, pname))
2464 return _mesa_get_format_bits(format, pname);
2465 else
2466 return 0;
2467 }
2468
2469
2470
2471 void GLAPIENTRY
2472 _mesa_RenderbufferStorage(GLenum target, GLenum internalFormat,
2473 GLsizei width, GLsizei height)
2474 {
2475 /* GL_ARB_fbo says calling this function is equivalent to calling
2476 * glRenderbufferStorageMultisample() with samples=0. We pass in
2477 * a token value here just for error reporting purposes.
2478 */
2479 renderbuffer_storage_target(target, internalFormat, width, height,
2480 NO_SAMPLES, 0, "glRenderbufferStorage");
2481 }
2482
2483
2484 void GLAPIENTRY
2485 _mesa_RenderbufferStorageMultisample(GLenum target, GLsizei samples,
2486 GLenum internalFormat,
2487 GLsizei width, GLsizei height)
2488 {
2489 renderbuffer_storage_target(target, internalFormat, width, height,
2490 samples, samples,
2491 "glRenderbufferStorageMultisample");
2492 }
2493
2494
2495 void GLAPIENTRY
2496 _mesa_RenderbufferStorageMultisampleAdvancedAMD(
2497 GLenum target, GLsizei samples, GLsizei storageSamples,
2498 GLenum internalFormat, GLsizei width, GLsizei height)
2499 {
2500 renderbuffer_storage_target(target, internalFormat, width, height,
2501 samples, storageSamples,
2502 "glRenderbufferStorageMultisampleAdvancedAMD");
2503 }
2504
2505
2506 /**
2507 * OpenGL ES version of glRenderBufferStorage.
2508 */
2509 void GLAPIENTRY
2510 _es_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
2511 GLsizei width, GLsizei height)
2512 {
2513 switch (internalFormat) {
2514 case GL_RGB565:
2515 /* XXX this confuses GL_RENDERBUFFER_INTERNAL_FORMAT_OES */
2516 /* choose a closest format */
2517 internalFormat = GL_RGB5;
2518 break;
2519 default:
2520 break;
2521 }
2522
2523 renderbuffer_storage_target(target, internalFormat, width, height, 0, 0,
2524 "glRenderbufferStorageEXT");
2525 }
2526
2527 void GLAPIENTRY
2528 _mesa_NamedRenderbufferStorage(GLuint renderbuffer, GLenum internalformat,
2529 GLsizei width, GLsizei height)
2530 {
2531 /* GL_ARB_fbo says calling this function is equivalent to calling
2532 * glRenderbufferStorageMultisample() with samples=0. We pass in
2533 * a token value here just for error reporting purposes.
2534 */
2535 renderbuffer_storage_named(renderbuffer, internalformat, width, height,
2536 NO_SAMPLES, 0, "glNamedRenderbufferStorage");
2537 }
2538
2539 void GLAPIENTRY
2540 _mesa_NamedRenderbufferStorageMultisample(GLuint renderbuffer, GLsizei samples,
2541 GLenum internalformat,
2542 GLsizei width, GLsizei height)
2543 {
2544 renderbuffer_storage_named(renderbuffer, internalformat, width, height,
2545 samples, samples,
2546 "glNamedRenderbufferStorageMultisample");
2547 }
2548
2549
2550 void GLAPIENTRY
2551 _mesa_NamedRenderbufferStorageMultisampleAdvancedAMD(
2552 GLuint renderbuffer, GLsizei samples, GLsizei storageSamples,
2553 GLenum internalformat, GLsizei width, GLsizei height)
2554 {
2555 renderbuffer_storage_named(renderbuffer, internalformat, width, height,
2556 samples, storageSamples,
2557 "glNamedRenderbufferStorageMultisampleAdvancedAMD");
2558 }
2559
2560
2561 static void
2562 get_render_buffer_parameteriv(struct gl_context *ctx,
2563 struct gl_renderbuffer *rb, GLenum pname,
2564 GLint *params, const char *func)
2565 {
2566 /* No need to flush here since we're just quering state which is
2567 * not effected by rendering.
2568 */
2569
2570 switch (pname) {
2571 case GL_RENDERBUFFER_WIDTH_EXT:
2572 *params = rb->Width;
2573 return;
2574 case GL_RENDERBUFFER_HEIGHT_EXT:
2575 *params = rb->Height;
2576 return;
2577 case GL_RENDERBUFFER_INTERNAL_FORMAT_EXT:
2578 *params = rb->InternalFormat;
2579 return;
2580 case GL_RENDERBUFFER_RED_SIZE_EXT:
2581 case GL_RENDERBUFFER_GREEN_SIZE_EXT:
2582 case GL_RENDERBUFFER_BLUE_SIZE_EXT:
2583 case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
2584 case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
2585 case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
2586 *params = get_component_bits(pname, rb->_BaseFormat, rb->Format);
2587 break;
2588 case GL_RENDERBUFFER_SAMPLES:
2589 if ((_mesa_is_desktop_gl(ctx) && ctx->Extensions.ARB_framebuffer_object)
2590 || _mesa_is_gles3(ctx)) {
2591 *params = rb->NumSamples;
2592 break;
2593 }
2594 /* fallthrough */
2595 default:
2596 _mesa_error(ctx, GL_INVALID_ENUM, "%s(invalid pname=%s)", func,
2597 _mesa_enum_to_string(pname));
2598 return;
2599 }
2600 }
2601
2602
2603 void GLAPIENTRY
2604 _mesa_GetRenderbufferParameteriv(GLenum target, GLenum pname, GLint *params)
2605 {
2606 GET_CURRENT_CONTEXT(ctx);
2607
2608 if (target != GL_RENDERBUFFER_EXT) {
2609 _mesa_error(ctx, GL_INVALID_ENUM,
2610 "glGetRenderbufferParameterivEXT(target)");
2611 return;
2612 }
2613
2614 if (!ctx->CurrentRenderbuffer) {
2615 _mesa_error(ctx, GL_INVALID_OPERATION, "glGetRenderbufferParameterivEXT"
2616 "(no renderbuffer bound)");
2617 return;
2618 }
2619
2620 get_render_buffer_parameteriv(ctx, ctx->CurrentRenderbuffer, pname,
2621 params, "glGetRenderbufferParameteriv");
2622 }
2623
2624
2625 void GLAPIENTRY
2626 _mesa_GetNamedRenderbufferParameteriv(GLuint renderbuffer, GLenum pname,
2627 GLint *params)
2628 {
2629 GET_CURRENT_CONTEXT(ctx);
2630
2631 struct gl_renderbuffer *rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
2632 if (!rb || rb == &DummyRenderbuffer) {
2633 /* ID was reserved, but no real renderbuffer object made yet */
2634 _mesa_error(ctx, GL_INVALID_OPERATION, "glGetNamedRenderbufferParameteriv"
2635 "(invalid renderbuffer %i)", renderbuffer);
2636 return;
2637 }
2638
2639 get_render_buffer_parameteriv(ctx, rb, pname, params,
2640 "glGetNamedRenderbufferParameteriv");
2641 }
2642
2643
2644 GLboolean GLAPIENTRY
2645 _mesa_IsFramebuffer(GLuint framebuffer)
2646 {
2647 GET_CURRENT_CONTEXT(ctx);
2648 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
2649 if (framebuffer) {
2650 struct gl_framebuffer *rb = _mesa_lookup_framebuffer(ctx, framebuffer);
2651 if (rb != NULL && rb != &DummyFramebuffer)
2652 return GL_TRUE;
2653 }
2654 return GL_FALSE;
2655 }
2656
2657
2658 /**
2659 * Check if any of the attachments of the given framebuffer are textures
2660 * (render to texture). Call ctx->Driver.RenderTexture() for such
2661 * attachments.
2662 */
2663 static void
2664 check_begin_texture_render(struct gl_context *ctx, struct gl_framebuffer *fb)
2665 {
2666 GLuint i;
2667 assert(ctx->Driver.RenderTexture);
2668
2669 if (_mesa_is_winsys_fbo(fb))
2670 return; /* can't render to texture with winsys framebuffers */
2671
2672 for (i = 0; i < BUFFER_COUNT; i++) {
2673 struct gl_renderbuffer_attachment *att = fb->Attachment + i;
2674 if (att->Texture && att->Renderbuffer->TexImage
2675 && driver_RenderTexture_is_safe(att)) {
2676 ctx->Driver.RenderTexture(ctx, fb, att);
2677 }
2678 }
2679 }
2680
2681
2682 /**
2683 * Examine all the framebuffer's attachments to see if any are textures.
2684 * If so, call ctx->Driver.FinishRenderTexture() for each texture to
2685 * notify the device driver that the texture image may have changed.
2686 */
2687 static void
2688 check_end_texture_render(struct gl_context *ctx, struct gl_framebuffer *fb)
2689 {
2690 /* Skip if we know NeedsFinishRenderTexture won't be set. */
2691 if (_mesa_is_winsys_fbo(fb) && !ctx->Driver.BindRenderbufferTexImage)
2692 return;
2693
2694 if (ctx->Driver.FinishRenderTexture) {
2695 GLuint i;
2696 for (i = 0; i < BUFFER_COUNT; i++) {
2697 struct gl_renderbuffer_attachment *att = fb->Attachment + i;
2698 struct gl_renderbuffer *rb = att->Renderbuffer;
2699 if (rb && rb->NeedsFinishRenderTexture) {
2700 ctx->Driver.FinishRenderTexture(ctx, rb);
2701 }
2702 }
2703 }
2704 }
2705
2706
2707 static void
2708 bind_framebuffer(GLenum target, GLuint framebuffer, bool allow_user_names)
2709 {
2710 struct gl_framebuffer *newDrawFb, *newReadFb;
2711 GLboolean bindReadBuf, bindDrawBuf;
2712 GET_CURRENT_CONTEXT(ctx);
2713
2714 switch (target) {
2715 case GL_DRAW_FRAMEBUFFER_EXT:
2716 bindDrawBuf = GL_TRUE;
2717 bindReadBuf = GL_FALSE;
2718 break;
2719 case GL_READ_FRAMEBUFFER_EXT:
2720 bindDrawBuf = GL_FALSE;
2721 bindReadBuf = GL_TRUE;
2722 break;
2723 case GL_FRAMEBUFFER_EXT:
2724 bindDrawBuf = GL_TRUE;
2725 bindReadBuf = GL_TRUE;
2726 break;
2727 default:
2728 _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
2729 return;
2730 }
2731
2732 if (framebuffer) {
2733 /* Binding a user-created framebuffer object */
2734 newDrawFb = _mesa_lookup_framebuffer(ctx, framebuffer);
2735 if (newDrawFb == &DummyFramebuffer) {
2736 /* ID was reserved, but no real framebuffer object made yet */
2737 newDrawFb = NULL;
2738 }
2739 else if (!newDrawFb && !allow_user_names) {
2740 /* All FBO IDs must be Gen'd */
2741 _mesa_error(ctx, GL_INVALID_OPERATION, "glBindFramebuffer(buffer)");
2742 return;
2743 }
2744
2745 if (!newDrawFb) {
2746 /* create new framebuffer object */
2747 newDrawFb = ctx->Driver.NewFramebuffer(ctx, framebuffer);
2748 if (!newDrawFb) {
2749 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindFramebufferEXT");
2750 return;
2751 }
2752 _mesa_HashInsert(ctx->Shared->FrameBuffers, framebuffer, newDrawFb);
2753 }
2754 newReadFb = newDrawFb;
2755 }
2756 else {
2757 /* Binding the window system framebuffer (which was originally set
2758 * with MakeCurrent).
2759 */
2760 newDrawFb = ctx->WinSysDrawBuffer;
2761 newReadFb = ctx->WinSysReadBuffer;
2762 }
2763
2764 _mesa_bind_framebuffers(ctx,
2765 bindDrawBuf ? newDrawFb : ctx->DrawBuffer,
2766 bindReadBuf ? newReadFb : ctx->ReadBuffer);
2767 }
2768
2769 void
2770 _mesa_bind_framebuffers(struct gl_context *ctx,
2771 struct gl_framebuffer *newDrawFb,
2772 struct gl_framebuffer *newReadFb)
2773 {
2774 struct gl_framebuffer *const oldDrawFb = ctx->DrawBuffer;
2775 struct gl_framebuffer *const oldReadFb = ctx->ReadBuffer;
2776 const bool bindDrawBuf = oldDrawFb != newDrawFb;
2777 const bool bindReadBuf = oldReadFb != newReadFb;
2778
2779 assert(newDrawFb);
2780 assert(newDrawFb != &DummyFramebuffer);
2781
2782 /*
2783 * OK, now bind the new Draw/Read framebuffers, if they're changing.
2784 *
2785 * We also check if we're beginning and/or ending render-to-texture.
2786 * When a framebuffer with texture attachments is unbound, call
2787 * ctx->Driver.FinishRenderTexture().
2788 * When a framebuffer with texture attachments is bound, call
2789 * ctx->Driver.RenderTexture().
2790 *
2791 * Note that if the ReadBuffer has texture attachments we don't consider
2792 * that a render-to-texture case.
2793 */
2794 if (bindReadBuf) {
2795 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2796
2797 /* check if old readbuffer was render-to-texture */
2798 check_end_texture_render(ctx, oldReadFb);
2799
2800 _mesa_reference_framebuffer(&ctx->ReadBuffer, newReadFb);
2801 }
2802
2803 if (bindDrawBuf) {
2804 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2805 ctx->NewDriverState |= ctx->DriverFlags.NewSampleLocations;
2806
2807 /* check if old framebuffer had any texture attachments */
2808 if (oldDrawFb)
2809 check_end_texture_render(ctx, oldDrawFb);
2810
2811 /* check if newly bound framebuffer has any texture attachments */
2812 check_begin_texture_render(ctx, newDrawFb);
2813
2814 _mesa_reference_framebuffer(&ctx->DrawBuffer, newDrawFb);
2815 }
2816
2817 if ((bindDrawBuf || bindReadBuf) && ctx->Driver.BindFramebuffer) {
2818 /* The few classic drivers that actually hook this function really only
2819 * want to know if the draw framebuffer changed.
2820 */
2821 ctx->Driver.BindFramebuffer(ctx,
2822 bindDrawBuf ? GL_FRAMEBUFFER : GL_READ_FRAMEBUFFER,
2823 newDrawFb, newReadFb);
2824 }
2825 }
2826
2827 void GLAPIENTRY
2828 _mesa_BindFramebuffer(GLenum target, GLuint framebuffer)
2829 {
2830 GET_CURRENT_CONTEXT(ctx);
2831
2832 /* OpenGL ES glBindFramebuffer and glBindFramebufferOES use this same entry
2833 * point, but they allow the use of user-generated names.
2834 */
2835 bind_framebuffer(target, framebuffer, _mesa_is_gles(ctx));
2836 }
2837
2838
2839 void GLAPIENTRY
2840 _mesa_BindFramebufferEXT(GLenum target, GLuint framebuffer)
2841 {
2842 /* This function should not be in the dispatch table for core profile /
2843 * OpenGL 3.1, so execution should never get here in those cases -- no
2844 * need for an explicit test.
2845 */
2846 bind_framebuffer(target, framebuffer, true);
2847 }
2848
2849
2850 void GLAPIENTRY
2851 _mesa_DeleteFramebuffers(GLsizei n, const GLuint *framebuffers)
2852 {
2853 GLint i;
2854 GET_CURRENT_CONTEXT(ctx);
2855
2856 if (n < 0) {
2857 _mesa_error(ctx, GL_INVALID_VALUE, "glDeleteFramebuffers(n < 0)");
2858 return;
2859 }
2860
2861 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2862
2863 for (i = 0; i < n; i++) {
2864 if (framebuffers[i] > 0) {
2865 struct gl_framebuffer *fb;
2866 fb = _mesa_lookup_framebuffer(ctx, framebuffers[i]);
2867 if (fb) {
2868 assert(fb == &DummyFramebuffer || fb->Name == framebuffers[i]);
2869
2870 /* check if deleting currently bound framebuffer object */
2871 if (fb == ctx->DrawBuffer) {
2872 /* bind default */
2873 assert(fb->RefCount >= 2);
2874 _mesa_BindFramebuffer(GL_DRAW_FRAMEBUFFER, 0);
2875 }
2876 if (fb == ctx->ReadBuffer) {
2877 /* bind default */
2878 assert(fb->RefCount >= 2);
2879 _mesa_BindFramebuffer(GL_READ_FRAMEBUFFER, 0);
2880 }
2881
2882 /* remove from hash table immediately, to free the ID */
2883 _mesa_HashRemove(ctx->Shared->FrameBuffers, framebuffers[i]);
2884
2885 if (fb != &DummyFramebuffer) {
2886 /* But the object will not be freed until it's no longer
2887 * bound in any context.
2888 */
2889 _mesa_reference_framebuffer(&fb, NULL);
2890 }
2891 }
2892 }
2893 }
2894 }
2895
2896
2897 /**
2898 * This is the implementation for glGenFramebuffers and glCreateFramebuffers.
2899 * It is not exposed to the rest of Mesa to encourage the use of
2900 * nameless buffers in driver internals.
2901 */
2902 static void
2903 create_framebuffers(GLsizei n, GLuint *framebuffers, bool dsa)
2904 {
2905 GET_CURRENT_CONTEXT(ctx);
2906 GLuint first;
2907 GLint i;
2908 struct gl_framebuffer *fb;
2909
2910 const char *func = dsa ? "glCreateFramebuffers" : "glGenFramebuffers";
2911
2912 if (n < 0) {
2913 _mesa_error(ctx, GL_INVALID_VALUE, "%s(n < 0)", func);
2914 return;
2915 }
2916
2917 if (!framebuffers)
2918 return;
2919
2920 _mesa_HashLockMutex(ctx->Shared->FrameBuffers);
2921
2922 first = _mesa_HashFindFreeKeyBlock(ctx->Shared->FrameBuffers, n);
2923
2924 for (i = 0; i < n; i++) {
2925 GLuint name = first + i;
2926 framebuffers[i] = name;
2927
2928 if (dsa) {
2929 fb = ctx->Driver.NewFramebuffer(ctx, framebuffers[i]);
2930 if (!fb) {
2931 _mesa_HashUnlockMutex(ctx->Shared->FrameBuffers);
2932 _mesa_error(ctx, GL_OUT_OF_MEMORY, "%s", func);
2933 return;
2934 }
2935 }
2936 else
2937 fb = &DummyFramebuffer;
2938
2939 _mesa_HashInsertLocked(ctx->Shared->FrameBuffers, name, fb);
2940 }
2941
2942 _mesa_HashUnlockMutex(ctx->Shared->FrameBuffers);
2943 }
2944
2945
2946 void GLAPIENTRY
2947 _mesa_GenFramebuffers(GLsizei n, GLuint *framebuffers)
2948 {
2949 create_framebuffers(n, framebuffers, false);
2950 }
2951
2952
2953 void GLAPIENTRY
2954 _mesa_CreateFramebuffers(GLsizei n, GLuint *framebuffers)
2955 {
2956 create_framebuffers(n, framebuffers, true);
2957 }
2958
2959
2960 GLenum
2961 _mesa_check_framebuffer_status(struct gl_context *ctx,
2962 struct gl_framebuffer *buffer)
2963 {
2964 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, 0);
2965
2966 if (_mesa_is_winsys_fbo(buffer)) {
2967 /* EGL_KHR_surfaceless_context allows the winsys FBO to be incomplete. */
2968 if (buffer != &IncompleteFramebuffer) {
2969 return GL_FRAMEBUFFER_COMPLETE_EXT;
2970 } else {
2971 return GL_FRAMEBUFFER_UNDEFINED;
2972 }
2973 }
2974
2975 /* No need to flush here */
2976
2977 if (buffer->_Status != GL_FRAMEBUFFER_COMPLETE) {
2978 _mesa_test_framebuffer_completeness(ctx, buffer);
2979 }
2980
2981 return buffer->_Status;
2982 }
2983
2984
2985 GLenum GLAPIENTRY
2986 _mesa_CheckFramebufferStatus_no_error(GLenum target)
2987 {
2988 GET_CURRENT_CONTEXT(ctx);
2989
2990 struct gl_framebuffer *fb = get_framebuffer_target(ctx, target);
2991 return _mesa_check_framebuffer_status(ctx, fb);
2992 }
2993
2994
2995 GLenum GLAPIENTRY
2996 _mesa_CheckFramebufferStatus(GLenum target)
2997 {
2998 struct gl_framebuffer *fb;
2999 GET_CURRENT_CONTEXT(ctx);
3000
3001 if (MESA_VERBOSE & VERBOSE_API)
3002 _mesa_debug(ctx, "glCheckFramebufferStatus(%s)\n",
3003 _mesa_enum_to_string(target));
3004
3005 fb = get_framebuffer_target(ctx, target);
3006 if (!fb) {
3007 _mesa_error(ctx, GL_INVALID_ENUM,
3008 "glCheckFramebufferStatus(invalid target %s)",
3009 _mesa_enum_to_string(target));
3010 return 0;
3011 }
3012
3013 return _mesa_check_framebuffer_status(ctx, fb);
3014 }
3015
3016
3017 GLenum GLAPIENTRY
3018 _mesa_CheckNamedFramebufferStatus(GLuint framebuffer, GLenum target)
3019 {
3020 struct gl_framebuffer *fb;
3021 GET_CURRENT_CONTEXT(ctx);
3022
3023 /* Validate the target (for conformance's sake) and grab a reference to the
3024 * default framebuffer in case framebuffer = 0.
3025 * Section 9.4 Framebuffer Completeness of the OpenGL 4.5 core spec
3026 * (30.10.2014, PDF page 336) says:
3027 * "If framebuffer is zero, then the status of the default read or
3028 * draw framebuffer (as determined by target) is returned."
3029 */
3030 switch (target) {
3031 case GL_DRAW_FRAMEBUFFER:
3032 case GL_FRAMEBUFFER:
3033 fb = ctx->WinSysDrawBuffer;
3034 break;
3035 case GL_READ_FRAMEBUFFER:
3036 fb = ctx->WinSysReadBuffer;
3037 break;
3038 default:
3039 _mesa_error(ctx, GL_INVALID_ENUM,
3040 "glCheckNamedFramebufferStatus(invalid target %s)",
3041 _mesa_enum_to_string(target));
3042 return 0;
3043 }
3044
3045 if (framebuffer) {
3046 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
3047 "glCheckNamedFramebufferStatus");
3048 if (!fb)
3049 return 0;
3050 }
3051
3052 return _mesa_check_framebuffer_status(ctx, fb);
3053 }
3054
3055
3056 /**
3057 * Replicate the src attachment point. Used by framebuffer_texture() when
3058 * the same texture is attached at GL_DEPTH_ATTACHMENT and
3059 * GL_STENCIL_ATTACHMENT.
3060 */
3061 static void
3062 reuse_framebuffer_texture_attachment(struct gl_framebuffer *fb,
3063 gl_buffer_index dst,
3064 gl_buffer_index src)
3065 {
3066 struct gl_renderbuffer_attachment *dst_att = &fb->Attachment[dst];
3067 struct gl_renderbuffer_attachment *src_att = &fb->Attachment[src];
3068
3069 assert(src_att->Texture != NULL);
3070 assert(src_att->Renderbuffer != NULL);
3071
3072 _mesa_reference_texobj(&dst_att->Texture, src_att->Texture);
3073 _mesa_reference_renderbuffer(&dst_att->Renderbuffer, src_att->Renderbuffer);
3074 dst_att->Type = src_att->Type;
3075 dst_att->Complete = src_att->Complete;
3076 dst_att->TextureLevel = src_att->TextureLevel;
3077 dst_att->CubeMapFace = src_att->CubeMapFace;
3078 dst_att->Zoffset = src_att->Zoffset;
3079 dst_att->Layered = src_att->Layered;
3080 }
3081
3082
3083 static struct gl_texture_object *
3084 get_texture_for_framebuffer(struct gl_context *ctx, GLuint texture)
3085 {
3086 if (!texture)
3087 return NULL;
3088
3089 return _mesa_lookup_texture(ctx, texture);
3090 }
3091
3092
3093 /**
3094 * Common code called by gl*FramebufferTexture*() to retrieve the correct
3095 * texture object pointer.
3096 *
3097 * \param texObj where the pointer to the texture object is returned. Note
3098 * that a successful call may return texObj = NULL.
3099 *
3100 * \return true if no errors, false if errors
3101 */
3102 static bool
3103 get_texture_for_framebuffer_err(struct gl_context *ctx, GLuint texture,
3104 bool layered, const char *caller,
3105 struct gl_texture_object **texObj)
3106 {
3107 *texObj = NULL; /* This will get returned if texture = 0. */
3108
3109 if (!texture)
3110 return true;
3111
3112 *texObj = _mesa_lookup_texture(ctx, texture);
3113 if (*texObj == NULL || (*texObj)->Target == 0) {
3114 /* Can't render to a non-existent texture object.
3115 *
3116 * The OpenGL 4.5 core spec (02.02.2015) in Section 9.2 Binding and
3117 * Managing Framebuffer Objects specifies a different error
3118 * depending upon the calling function (PDF pages 325-328).
3119 * *FramebufferTexture (where layered = GL_TRUE) throws invalid
3120 * value, while the other commands throw invalid operation (where
3121 * layered = GL_FALSE).
3122 */
3123 const GLenum error = layered ? GL_INVALID_VALUE :
3124 GL_INVALID_OPERATION;
3125 _mesa_error(ctx, error,
3126 "%s(non-existent texture %u)", caller, texture);
3127 return false;
3128 }
3129
3130 return true;
3131 }
3132
3133
3134 /**
3135 * Common code called by gl*FramebufferTexture() to verify the texture target
3136 * and decide whether or not the attachment should truly be considered
3137 * layered.
3138 *
3139 * \param layered true if attachment should be considered layered, false if
3140 * not
3141 *
3142 * \return true if no errors, false if errors
3143 */
3144 static bool
3145 check_layered_texture_target(struct gl_context *ctx, GLenum target,
3146 const char *caller, GLboolean *layered)
3147 {
3148 *layered = GL_TRUE;
3149
3150 switch (target) {
3151 case GL_TEXTURE_3D:
3152 case GL_TEXTURE_1D_ARRAY_EXT:
3153 case GL_TEXTURE_2D_ARRAY_EXT:
3154 case GL_TEXTURE_CUBE_MAP:
3155 case GL_TEXTURE_CUBE_MAP_ARRAY:
3156 case GL_TEXTURE_2D_MULTISAMPLE_ARRAY:
3157 return true;
3158 case GL_TEXTURE_1D:
3159 case GL_TEXTURE_2D:
3160 case GL_TEXTURE_RECTANGLE:
3161 case GL_TEXTURE_2D_MULTISAMPLE:
3162 /* These texture types are valid to pass to
3163 * glFramebufferTexture(), but since they aren't layered, it
3164 * is equivalent to calling glFramebufferTexture{1D,2D}().
3165 */
3166 *layered = GL_FALSE;
3167 return true;
3168 }
3169
3170 _mesa_error(ctx, GL_INVALID_OPERATION,
3171 "%s(invalid texture target %s)", caller,
3172 _mesa_enum_to_string(target));
3173 return false;
3174 }
3175
3176
3177 /**
3178 * Common code called by gl*FramebufferTextureLayer() to verify the texture
3179 * target.
3180 *
3181 * \return true if no errors, false if errors
3182 */
3183 static bool
3184 check_texture_target(struct gl_context *ctx, GLenum target,
3185 const char *caller)
3186 {
3187 /* We're being called by glFramebufferTextureLayer().
3188 * The only legal texture types for that function are 3D,
3189 * cube-map, and 1D/2D/cube-map array textures.
3190 *
3191 * We don't need to check for GL_ARB_texture_cube_map_array because the
3192 * application wouldn't have been able to create a texture with a
3193 * GL_TEXTURE_CUBE_MAP_ARRAY target if the extension were not enabled.
3194 */
3195 switch (target) {
3196 case GL_TEXTURE_3D:
3197 case GL_TEXTURE_1D_ARRAY:
3198 case GL_TEXTURE_2D_ARRAY:
3199 case GL_TEXTURE_CUBE_MAP_ARRAY:
3200 case GL_TEXTURE_2D_MULTISAMPLE_ARRAY:
3201 return true;
3202 case GL_TEXTURE_CUBE_MAP:
3203 /* We don't need to check the extension (GL_ARB_direct_state_access) or
3204 * GL version (4.5) for GL_TEXTURE_CUBE_MAP because DSA is always
3205 * enabled in core profile. This can be called from
3206 * _mesa_FramebufferTextureLayer in compatibility profile (OpenGL 3.0),
3207 * so we do have to check the profile.
3208 */
3209 return ctx->API == API_OPENGL_CORE;
3210 }
3211
3212 _mesa_error(ctx, GL_INVALID_OPERATION,
3213 "%s(invalid texture target %s)", caller,
3214 _mesa_enum_to_string(target));
3215 return false;
3216 }
3217
3218
3219 /**
3220 * Common code called by glFramebufferTexture*D() to verify the texture
3221 * target.
3222 *
3223 * \return true if no errors, false if errors
3224 */
3225 static bool
3226 check_textarget(struct gl_context *ctx, int dims, GLenum target,
3227 GLenum textarget, const char *caller)
3228 {
3229 bool err = false;
3230
3231 switch (textarget) {
3232 case GL_TEXTURE_1D:
3233 err = dims != 1;
3234 break;
3235 case GL_TEXTURE_1D_ARRAY:
3236 err = dims != 1 || !ctx->Extensions.EXT_texture_array;
3237 break;
3238 case GL_TEXTURE_2D:
3239 err = dims != 2;
3240 break;
3241 case GL_TEXTURE_2D_ARRAY:
3242 err = dims != 2 || !ctx->Extensions.EXT_texture_array ||
3243 (_mesa_is_gles(ctx) && ctx->Version < 30);
3244 break;
3245 case GL_TEXTURE_2D_MULTISAMPLE:
3246 case GL_TEXTURE_2D_MULTISAMPLE_ARRAY:
3247 err = dims != 2 ||
3248 !ctx->Extensions.ARB_texture_multisample ||
3249 (_mesa_is_gles(ctx) && ctx->Version < 31);
3250 break;
3251 case GL_TEXTURE_RECTANGLE:
3252 err = dims != 2 || _mesa_is_gles(ctx) ||
3253 !ctx->Extensions.NV_texture_rectangle;
3254 break;
3255 case GL_TEXTURE_CUBE_MAP:
3256 case GL_TEXTURE_CUBE_MAP_ARRAY:
3257 err = true;
3258 break;
3259 case GL_TEXTURE_CUBE_MAP_POSITIVE_X:
3260 case GL_TEXTURE_CUBE_MAP_NEGATIVE_X:
3261 case GL_TEXTURE_CUBE_MAP_POSITIVE_Y:
3262 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Y:
3263 case GL_TEXTURE_CUBE_MAP_POSITIVE_Z:
3264 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Z:
3265 err = dims != 2 || !ctx->Extensions.ARB_texture_cube_map;
3266 break;
3267 case GL_TEXTURE_3D:
3268 err = dims != 3;
3269 break;
3270 default:
3271 _mesa_error(ctx, GL_INVALID_ENUM,
3272 "%s(unknown textarget 0x%x)", caller, textarget);
3273 return false;
3274 }
3275
3276 if (err) {
3277 _mesa_error(ctx, GL_INVALID_OPERATION,
3278 "%s(invalid textarget %s)",
3279 caller, _mesa_enum_to_string(textarget));
3280 return false;
3281 }
3282
3283 /* Make sure textarget is consistent with the texture's type */
3284 err = (target == GL_TEXTURE_CUBE_MAP) ?
3285 !_mesa_is_cube_face(textarget): (target != textarget);
3286
3287 if (err) {
3288 _mesa_error(ctx, GL_INVALID_OPERATION,
3289 "%s(mismatched texture target)", caller);
3290 return false;
3291 }
3292
3293 return true;
3294 }
3295
3296
3297 /**
3298 * Common code called by gl*FramebufferTextureLayer() and
3299 * glFramebufferTexture3D() to validate the layer.
3300 *
3301 * \return true if no errors, false if errors
3302 */
3303 static bool
3304 check_layer(struct gl_context *ctx, GLenum target, GLint layer,
3305 const char *caller)
3306 {
3307 /* Page 306 (page 328 of the PDF) of the OpenGL 4.5 (Core Profile)
3308 * spec says:
3309 *
3310 * "An INVALID_VALUE error is generated if texture is non-zero
3311 * and layer is negative."
3312 */
3313 if (layer < 0) {
3314 _mesa_error(ctx, GL_INVALID_VALUE, "%s(layer %d < 0)", caller, layer);
3315 return false;
3316 }
3317
3318 if (target == GL_TEXTURE_3D) {
3319 const GLuint maxSize = 1 << (ctx->Const.Max3DTextureLevels - 1);
3320 if (layer >= maxSize) {
3321 _mesa_error(ctx, GL_INVALID_VALUE,
3322 "%s(invalid layer %u)", caller, layer);
3323 return false;
3324 }
3325 }
3326 else if ((target == GL_TEXTURE_1D_ARRAY) ||
3327 (target == GL_TEXTURE_2D_ARRAY) ||
3328 (target == GL_TEXTURE_CUBE_MAP_ARRAY) ||
3329 (target == GL_TEXTURE_2D_MULTISAMPLE_ARRAY)) {
3330 if (layer >= ctx->Const.MaxArrayTextureLayers) {
3331 _mesa_error(ctx, GL_INVALID_VALUE,
3332 "%s(layer %u >= GL_MAX_ARRAY_TEXTURE_LAYERS)",
3333 caller, layer);
3334 return false;
3335 }
3336 }
3337 else if (target == GL_TEXTURE_CUBE_MAP) {
3338 if (layer >= 6) {
3339 _mesa_error(ctx, GL_INVALID_VALUE,
3340 "%s(layer %u >= 6)", caller, layer);
3341 return false;
3342 }
3343 }
3344
3345 return true;
3346 }
3347
3348
3349 /**
3350 * Common code called by all gl*FramebufferTexture*() entry points to verify
3351 * the level.
3352 *
3353 * \return true if no errors, false if errors
3354 */
3355 static bool
3356 check_level(struct gl_context *ctx, struct gl_texture_object *texObj,
3357 GLenum target, GLint level, const char *caller)
3358 {
3359 /* Section 9.2.8 of the OpenGL 4.6 specification says:
3360 *
3361 * "If texture refers to an immutable-format texture, level must be
3362 * greater than or equal to zero and smaller than the value of
3363 * TEXTURE_VIEW_NUM_LEVELS for texture."
3364 */
3365 const int max_levels = texObj->Immutable ? texObj->ImmutableLevels :
3366 _mesa_max_texture_levels(ctx, target);
3367
3368 if (level < 0 || level >= max_levels) {
3369 _mesa_error(ctx, GL_INVALID_VALUE,
3370 "%s(invalid level %d)", caller, level);
3371 return false;
3372 }
3373
3374 return true;
3375 }
3376
3377
3378 struct gl_renderbuffer_attachment *
3379 _mesa_get_and_validate_attachment(struct gl_context *ctx,
3380 struct gl_framebuffer *fb,
3381 GLenum attachment, const char *caller)
3382 {
3383 /* The window-system framebuffer object is immutable */
3384 if (_mesa_is_winsys_fbo(fb)) {
3385 _mesa_error(ctx, GL_INVALID_OPERATION, "%s(window-system framebuffer)",
3386 caller);
3387 return NULL;
3388 }
3389
3390 /* Not a hash lookup, so we can afford to get the attachment here. */
3391 bool is_color_attachment;
3392 struct gl_renderbuffer_attachment *att =
3393 get_attachment(ctx, fb, attachment, &is_color_attachment);
3394 if (att == NULL) {
3395 if (is_color_attachment) {
3396 _mesa_error(ctx, GL_INVALID_OPERATION,
3397 "%s(invalid color attachment %s)", caller,
3398 _mesa_enum_to_string(attachment));
3399 } else {
3400 _mesa_error(ctx, GL_INVALID_ENUM,
3401 "%s(invalid attachment %s)", caller,
3402 _mesa_enum_to_string(attachment));
3403 }
3404 return NULL;
3405 }
3406
3407 return att;
3408 }
3409
3410
3411 void
3412 _mesa_framebuffer_texture(struct gl_context *ctx, struct gl_framebuffer *fb,
3413 GLenum attachment,
3414 struct gl_renderbuffer_attachment *att,
3415 struct gl_texture_object *texObj, GLenum textarget,
3416 GLint level, GLuint layer, GLboolean layered)
3417 {
3418 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
3419
3420 simple_mtx_lock(&fb->Mutex);
3421 if (texObj) {
3422 if (attachment == GL_DEPTH_ATTACHMENT &&
3423 texObj == fb->Attachment[BUFFER_STENCIL].Texture &&
3424 level == fb->Attachment[BUFFER_STENCIL].TextureLevel &&
3425 _mesa_tex_target_to_face(textarget) ==
3426 fb->Attachment[BUFFER_STENCIL].CubeMapFace &&
3427 layer == fb->Attachment[BUFFER_STENCIL].Zoffset) {
3428 /* The texture object is already attached to the stencil attachment
3429 * point. Don't create a new renderbuffer; just reuse the stencil
3430 * attachment's. This is required to prevent a GL error in
3431 * glGetFramebufferAttachmentParameteriv(GL_DEPTH_STENCIL).
3432 */
3433 reuse_framebuffer_texture_attachment(fb, BUFFER_DEPTH,
3434 BUFFER_STENCIL);
3435 } else if (attachment == GL_STENCIL_ATTACHMENT &&
3436 texObj == fb->Attachment[BUFFER_DEPTH].Texture &&
3437 level == fb->Attachment[BUFFER_DEPTH].TextureLevel &&
3438 _mesa_tex_target_to_face(textarget) ==
3439 fb->Attachment[BUFFER_DEPTH].CubeMapFace &&
3440 layer == fb->Attachment[BUFFER_DEPTH].Zoffset) {
3441 /* As above, but with depth and stencil transposed. */
3442 reuse_framebuffer_texture_attachment(fb, BUFFER_STENCIL,
3443 BUFFER_DEPTH);
3444 } else {
3445 set_texture_attachment(ctx, fb, att, texObj, textarget,
3446 level, layer, layered);
3447
3448 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
3449 /* Above we created a new renderbuffer and attached it to the
3450 * depth attachment point. Now attach it to the stencil attachment
3451 * point too.
3452 */
3453 assert(att == &fb->Attachment[BUFFER_DEPTH]);
3454 reuse_framebuffer_texture_attachment(fb,BUFFER_STENCIL,
3455 BUFFER_DEPTH);
3456 }
3457 }
3458
3459 /* Set the render-to-texture flag. We'll check this flag in
3460 * glTexImage() and friends to determine if we need to revalidate
3461 * any FBOs that might be rendering into this texture.
3462 * This flag never gets cleared since it's non-trivial to determine
3463 * when all FBOs might be done rendering to this texture. That's OK
3464 * though since it's uncommon to render to a texture then repeatedly
3465 * call glTexImage() to change images in the texture.
3466 */
3467 texObj->_RenderToTexture = GL_TRUE;
3468 }
3469 else {
3470 remove_attachment(ctx, att);
3471 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
3472 assert(att == &fb->Attachment[BUFFER_DEPTH]);
3473 remove_attachment(ctx, &fb->Attachment[BUFFER_STENCIL]);
3474 }
3475 }
3476
3477 invalidate_framebuffer(fb);
3478
3479 simple_mtx_unlock(&fb->Mutex);
3480 }
3481
3482
3483 static void
3484 framebuffer_texture_with_dims_no_error(GLenum target, GLenum attachment,
3485 GLenum textarget, GLuint texture,
3486 GLint level, GLint layer)
3487 {
3488 GET_CURRENT_CONTEXT(ctx);
3489
3490 /* Get the framebuffer object */
3491 struct gl_framebuffer *fb = get_framebuffer_target(ctx, target);
3492
3493 /* Get the texture object */
3494 struct gl_texture_object *texObj =
3495 get_texture_for_framebuffer(ctx, texture);
3496
3497 struct gl_renderbuffer_attachment *att =
3498 get_attachment(ctx, fb, attachment, NULL);
3499
3500 _mesa_framebuffer_texture(ctx, fb, attachment, att, texObj, textarget,
3501 level, layer, GL_FALSE);
3502 }
3503
3504
3505 static void
3506 framebuffer_texture_with_dims(int dims, GLenum target,
3507 GLenum attachment, GLenum textarget,
3508 GLuint texture, GLint level, GLint layer,
3509 const char *caller)
3510 {
3511 GET_CURRENT_CONTEXT(ctx);
3512 struct gl_framebuffer *fb;
3513 struct gl_texture_object *texObj;
3514
3515 /* Get the framebuffer object */
3516 fb = get_framebuffer_target(ctx, target);
3517 if (!fb) {
3518 _mesa_error(ctx, GL_INVALID_ENUM, "%s(invalid target %s)", caller,
3519 _mesa_enum_to_string(target));
3520 return;
3521 }
3522
3523 /* Get the texture object */
3524 if (!get_texture_for_framebuffer_err(ctx, texture, false, caller, &texObj))
3525 return;
3526
3527 if (texObj) {
3528 if (!check_textarget(ctx, dims, texObj->Target, textarget, caller))
3529 return;
3530
3531 if ((dims == 3) && !check_layer(ctx, texObj->Target, layer, caller))
3532 return;
3533
3534 if (!check_level(ctx, texObj, textarget, level, caller))
3535 return;
3536 }
3537
3538 struct gl_renderbuffer_attachment *att =
3539 _mesa_get_and_validate_attachment(ctx, fb, attachment, caller);
3540 if (!att)
3541 return;
3542
3543 _mesa_framebuffer_texture(ctx, fb, attachment, att, texObj, textarget,
3544 level, layer, GL_FALSE);
3545 }
3546
3547
3548 void GLAPIENTRY
3549 _mesa_FramebufferTexture1D_no_error(GLenum target, GLenum attachment,
3550 GLenum textarget, GLuint texture,
3551 GLint level)
3552 {
3553 framebuffer_texture_with_dims_no_error(target, attachment, textarget,
3554 texture, level, 0);
3555 }
3556
3557
3558 void GLAPIENTRY
3559 _mesa_FramebufferTexture1D(GLenum target, GLenum attachment,
3560 GLenum textarget, GLuint texture, GLint level)
3561 {
3562 framebuffer_texture_with_dims(1, target, attachment, textarget, texture,
3563 level, 0, "glFramebufferTexture1D");
3564 }
3565
3566
3567 void GLAPIENTRY
3568 _mesa_FramebufferTexture2D_no_error(GLenum target, GLenum attachment,
3569 GLenum textarget, GLuint texture,
3570 GLint level)
3571 {
3572 framebuffer_texture_with_dims_no_error(target, attachment, textarget,
3573 texture, level, 0);
3574 }
3575
3576
3577 void GLAPIENTRY
3578 _mesa_FramebufferTexture2D(GLenum target, GLenum attachment,
3579 GLenum textarget, GLuint texture, GLint level)
3580 {
3581 framebuffer_texture_with_dims(2, target, attachment, textarget, texture,
3582 level, 0, "glFramebufferTexture2D");
3583 }
3584
3585
3586 void GLAPIENTRY
3587 _mesa_FramebufferTexture3D_no_error(GLenum target, GLenum attachment,
3588 GLenum textarget, GLuint texture,
3589 GLint level, GLint layer)
3590 {
3591 framebuffer_texture_with_dims_no_error(target, attachment, textarget,
3592 texture, level, layer);
3593 }
3594
3595
3596 void GLAPIENTRY
3597 _mesa_FramebufferTexture3D(GLenum target, GLenum attachment,
3598 GLenum textarget, GLuint texture,
3599 GLint level, GLint layer)
3600 {
3601 framebuffer_texture_with_dims(3, target, attachment, textarget, texture,
3602 level, layer, "glFramebufferTexture3D");
3603 }
3604
3605
3606 static ALWAYS_INLINE void
3607 frame_buffer_texture(GLuint framebuffer, GLenum target,
3608 GLenum attachment, GLuint texture,
3609 GLint level, GLint layer, const char *func,
3610 bool dsa, bool no_error, bool check_layered)
3611 {
3612 GET_CURRENT_CONTEXT(ctx);
3613 GLboolean layered = GL_FALSE;
3614
3615 if (!no_error && check_layered) {
3616 if (!_mesa_has_geometry_shaders(ctx)) {
3617 _mesa_error(ctx, GL_INVALID_OPERATION,
3618 "unsupported function (%s) called", func);
3619 return;
3620 }
3621 }
3622
3623 /* Get the framebuffer object */
3624 struct gl_framebuffer *fb;
3625 if (no_error) {
3626 if (dsa) {
3627 fb = _mesa_lookup_framebuffer(ctx, framebuffer);
3628 } else {
3629 fb = get_framebuffer_target(ctx, target);
3630 }
3631 } else {
3632 if (dsa) {
3633 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer, func);
3634 if (!fb)
3635 return;
3636 } else {
3637 fb = get_framebuffer_target(ctx, target);
3638 if (!fb) {
3639 _mesa_error(ctx, GL_INVALID_ENUM, "%s(invalid target %s)",
3640 func, _mesa_enum_to_string(target));
3641 return;
3642 }
3643 }
3644 }
3645
3646 /* Get the texture object and framebuffer attachment*/
3647 struct gl_renderbuffer_attachment *att;
3648 struct gl_texture_object *texObj;
3649 if (no_error) {
3650 texObj = get_texture_for_framebuffer(ctx, texture);
3651 att = get_attachment(ctx, fb, attachment, NULL);
3652 } else {
3653 if (!get_texture_for_framebuffer_err(ctx, texture, check_layered, func,
3654 &texObj))
3655 return;
3656
3657 att = _mesa_get_and_validate_attachment(ctx, fb, attachment, func);
3658 if (!att)
3659 return;
3660 }
3661
3662 GLenum textarget = 0;
3663 if (texObj) {
3664 if (check_layered) {
3665 /* We do this regardless of no_error because this sets layered */
3666 if (!check_layered_texture_target(ctx, texObj->Target, func,
3667 &layered))
3668 return;
3669 }
3670
3671 if (!no_error) {
3672 if (!check_layered) {
3673 if (!check_texture_target(ctx, texObj->Target, func))
3674 return;
3675
3676 if (!check_layer(ctx, texObj->Target, layer, func))
3677 return;
3678 }
3679
3680 if (!check_level(ctx, texObj, texObj->Target, level, func))
3681 return;
3682 }
3683
3684 if (!check_layered && texObj->Target == GL_TEXTURE_CUBE_MAP) {
3685 assert(layer >= 0 && layer < 6);
3686 textarget = GL_TEXTURE_CUBE_MAP_POSITIVE_X + layer;
3687 layer = 0;
3688 }
3689 }
3690
3691 _mesa_framebuffer_texture(ctx, fb, attachment, att, texObj, textarget,
3692 level, layer, layered);
3693 }
3694
3695 void GLAPIENTRY
3696 _mesa_FramebufferTextureLayer_no_error(GLenum target, GLenum attachment,
3697 GLuint texture, GLint level,
3698 GLint layer)
3699 {
3700 frame_buffer_texture(0, target, attachment, texture, level, layer,
3701 "glFramebufferTextureLayer", false, true, false);
3702 }
3703
3704
3705 void GLAPIENTRY
3706 _mesa_FramebufferTextureLayer(GLenum target, GLenum attachment,
3707 GLuint texture, GLint level, GLint layer)
3708 {
3709 frame_buffer_texture(0, target, attachment, texture, level, layer,
3710 "glFramebufferTextureLayer", false, false, false);
3711 }
3712
3713
3714 void GLAPIENTRY
3715 _mesa_NamedFramebufferTextureLayer_no_error(GLuint framebuffer,
3716 GLenum attachment,
3717 GLuint texture, GLint level,
3718 GLint layer)
3719 {
3720 frame_buffer_texture(framebuffer, 0, attachment, texture, level, layer,
3721 "glNamedFramebufferTextureLayer", true, true, false);
3722 }
3723
3724
3725 void GLAPIENTRY
3726 _mesa_NamedFramebufferTextureLayer(GLuint framebuffer, GLenum attachment,
3727 GLuint texture, GLint level, GLint layer)
3728 {
3729 frame_buffer_texture(framebuffer, 0, attachment, texture, level, layer,
3730 "glNamedFramebufferTextureLayer", true, false, false);
3731 }
3732
3733
3734 void GLAPIENTRY
3735 _mesa_FramebufferTexture_no_error(GLenum target, GLenum attachment,
3736 GLuint texture, GLint level)
3737 {
3738 frame_buffer_texture(0, target, attachment, texture, level, 0,
3739 "glFramebufferTexture", false, true, true);
3740 }
3741
3742
3743 void GLAPIENTRY
3744 _mesa_FramebufferTexture(GLenum target, GLenum attachment,
3745 GLuint texture, GLint level)
3746 {
3747 frame_buffer_texture(0, target, attachment, texture, level, 0,
3748 "glFramebufferTexture", false, false, true);
3749 }
3750
3751 void GLAPIENTRY
3752 _mesa_NamedFramebufferTexture_no_error(GLuint framebuffer, GLenum attachment,
3753 GLuint texture, GLint level)
3754 {
3755 frame_buffer_texture(framebuffer, 0, attachment, texture, level, 0,
3756 "glNamedFramebufferTexture", true, true, true);
3757 }
3758
3759
3760 void GLAPIENTRY
3761 _mesa_NamedFramebufferTexture(GLuint framebuffer, GLenum attachment,
3762 GLuint texture, GLint level)
3763 {
3764 frame_buffer_texture(framebuffer, 0, attachment, texture, level, 0,
3765 "glNamedFramebufferTexture", true, false, true);
3766 }
3767
3768
3769 void
3770 _mesa_framebuffer_renderbuffer(struct gl_context *ctx,
3771 struct gl_framebuffer *fb,
3772 GLenum attachment,
3773 struct gl_renderbuffer *rb)
3774 {
3775 assert(!_mesa_is_winsys_fbo(fb));
3776
3777 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
3778
3779 assert(ctx->Driver.FramebufferRenderbuffer);
3780 ctx->Driver.FramebufferRenderbuffer(ctx, fb, attachment, rb);
3781
3782 /* Some subsequent GL commands may depend on the framebuffer's visual
3783 * after the binding is updated. Update visual info now.
3784 */
3785 _mesa_update_framebuffer_visual(ctx, fb);
3786 }
3787
3788 static ALWAYS_INLINE void
3789 framebuffer_renderbuffer(struct gl_context *ctx, struct gl_framebuffer *fb,
3790 GLenum attachment, GLenum renderbuffertarget,
3791 GLuint renderbuffer, const char *func, bool no_error)
3792 {
3793 struct gl_renderbuffer_attachment *att;
3794 struct gl_renderbuffer *rb;
3795 bool is_color_attachment;
3796
3797 if (!no_error && renderbuffertarget != GL_RENDERBUFFER) {
3798 _mesa_error(ctx, GL_INVALID_ENUM,
3799 "%s(renderbuffertarget is not GL_RENDERBUFFER)", func);
3800 return;
3801 }
3802
3803 if (renderbuffer) {
3804 if (!no_error) {
3805 rb = _mesa_lookup_renderbuffer_err(ctx, renderbuffer, func);
3806 if (!rb)
3807 return;
3808 } else {
3809 rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
3810 }
3811 } else {
3812 /* remove renderbuffer attachment */
3813 rb = NULL;
3814 }
3815
3816 if (!no_error) {
3817 if (_mesa_is_winsys_fbo(fb)) {
3818 /* Can't attach new renderbuffers to a window system framebuffer */
3819 _mesa_error(ctx, GL_INVALID_OPERATION,
3820 "%s(window-system framebuffer)", func);
3821 return;
3822 }
3823
3824 att = get_attachment(ctx, fb, attachment, &is_color_attachment);
3825 if (att == NULL) {
3826 /*
3827 * From OpenGL 4.5 spec, section 9.2.7 "Attaching Renderbuffer Images
3828 * to a Framebuffer":
3829 *
3830 * "An INVALID_OPERATION error is generated if attachment is
3831 * COLOR_- ATTACHMENTm where m is greater than or equal to the
3832 * value of MAX_COLOR_- ATTACHMENTS ."
3833 *
3834 * If we are at this point, is because the attachment is not valid, so
3835 * if is_color_attachment is true, is because of the previous reason.
3836 */
3837 if (is_color_attachment) {
3838 _mesa_error(ctx, GL_INVALID_OPERATION,
3839 "%s(invalid color attachment %s)", func,
3840 _mesa_enum_to_string(attachment));
3841 } else {
3842 _mesa_error(ctx, GL_INVALID_ENUM,
3843 "%s(invalid attachment %s)", func,
3844 _mesa_enum_to_string(attachment));
3845 }
3846
3847 return;
3848 }
3849
3850 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT &&
3851 rb && rb->Format != MESA_FORMAT_NONE) {
3852 /* make sure the renderbuffer is a depth/stencil format */
3853 const GLenum baseFormat = _mesa_get_format_base_format(rb->Format);
3854 if (baseFormat != GL_DEPTH_STENCIL) {
3855 _mesa_error(ctx, GL_INVALID_OPERATION,
3856 "%s(renderbuffer is not DEPTH_STENCIL format)", func);
3857 return;
3858 }
3859 }
3860 }
3861
3862 _mesa_framebuffer_renderbuffer(ctx, fb, attachment, rb);
3863 }
3864
3865 static void
3866 framebuffer_renderbuffer_error(struct gl_context *ctx,
3867 struct gl_framebuffer *fb, GLenum attachment,
3868 GLenum renderbuffertarget,
3869 GLuint renderbuffer, const char *func)
3870 {
3871 framebuffer_renderbuffer(ctx, fb, attachment, renderbuffertarget,
3872 renderbuffer, func, false);
3873 }
3874
3875 static void
3876 framebuffer_renderbuffer_no_error(struct gl_context *ctx,
3877 struct gl_framebuffer *fb, GLenum attachment,
3878 GLenum renderbuffertarget,
3879 GLuint renderbuffer, const char *func)
3880 {
3881 framebuffer_renderbuffer(ctx, fb, attachment, renderbuffertarget,
3882 renderbuffer, func, true);
3883 }
3884
3885 void GLAPIENTRY
3886 _mesa_FramebufferRenderbuffer_no_error(GLenum target, GLenum attachment,
3887 GLenum renderbuffertarget,
3888 GLuint renderbuffer)
3889 {
3890 GET_CURRENT_CONTEXT(ctx);
3891
3892 struct gl_framebuffer *fb = get_framebuffer_target(ctx, target);
3893 framebuffer_renderbuffer_no_error(ctx, fb, attachment, renderbuffertarget,
3894 renderbuffer, "glFramebufferRenderbuffer");
3895 }
3896
3897 void GLAPIENTRY
3898 _mesa_FramebufferRenderbuffer(GLenum target, GLenum attachment,
3899 GLenum renderbuffertarget,
3900 GLuint renderbuffer)
3901 {
3902 struct gl_framebuffer *fb;
3903 GET_CURRENT_CONTEXT(ctx);
3904
3905 fb = get_framebuffer_target(ctx, target);
3906 if (!fb) {
3907 _mesa_error(ctx, GL_INVALID_ENUM,
3908 "glFramebufferRenderbuffer(invalid target %s)",
3909 _mesa_enum_to_string(target));
3910 return;
3911 }
3912
3913 framebuffer_renderbuffer_error(ctx, fb, attachment, renderbuffertarget,
3914 renderbuffer, "glFramebufferRenderbuffer");
3915 }
3916
3917 void GLAPIENTRY
3918 _mesa_NamedFramebufferRenderbuffer_no_error(GLuint framebuffer,
3919 GLenum attachment,
3920 GLenum renderbuffertarget,
3921 GLuint renderbuffer)
3922 {
3923 GET_CURRENT_CONTEXT(ctx);
3924
3925 struct gl_framebuffer *fb = _mesa_lookup_framebuffer(ctx, framebuffer);
3926 framebuffer_renderbuffer_no_error(ctx, fb, attachment, renderbuffertarget,
3927 renderbuffer,
3928 "glNamedFramebufferRenderbuffer");
3929 }
3930
3931 void GLAPIENTRY
3932 _mesa_NamedFramebufferRenderbuffer(GLuint framebuffer, GLenum attachment,
3933 GLenum renderbuffertarget,
3934 GLuint renderbuffer)
3935 {
3936 struct gl_framebuffer *fb;
3937 GET_CURRENT_CONTEXT(ctx);
3938
3939 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
3940 "glNamedFramebufferRenderbuffer");
3941 if (!fb)
3942 return;
3943
3944 framebuffer_renderbuffer_error(ctx, fb, attachment, renderbuffertarget,
3945 renderbuffer,
3946 "glNamedFramebufferRenderbuffer");
3947 }
3948
3949
3950 static void
3951 get_framebuffer_attachment_parameter(struct gl_context *ctx,
3952 struct gl_framebuffer *buffer,
3953 GLenum attachment, GLenum pname,
3954 GLint *params, const char *caller)
3955 {
3956 const struct gl_renderbuffer_attachment *att;
3957 bool is_color_attachment = false;
3958 GLenum err;
3959
3960 /* The error code for an attachment type of GL_NONE differs between APIs.
3961 *
3962 * From the ES 2.0.25 specification, page 127:
3963 * "If the value of FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is NONE, then
3964 * querying any other pname will generate INVALID_ENUM."
3965 *
3966 * From the OpenGL 3.0 specification, page 337, or identically,
3967 * the OpenGL ES 3.0.4 specification, page 240:
3968 *
3969 * "If the value of FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is NONE, no
3970 * framebuffer is bound to target. In this case querying pname
3971 * FRAMEBUFFER_ATTACHMENT_OBJECT_NAME will return zero, and all other
3972 * queries will generate an INVALID_OPERATION error."
3973 */
3974 err = ctx->API == API_OPENGLES2 && ctx->Version < 30 ?
3975 GL_INVALID_ENUM : GL_INVALID_OPERATION;
3976
3977 if (_mesa_is_winsys_fbo(buffer)) {
3978 /* Page 126 (page 136 of the PDF) of the OpenGL ES 2.0.25 spec
3979 * says:
3980 *
3981 * "If the framebuffer currently bound to target is zero, then
3982 * INVALID_OPERATION is generated."
3983 *
3984 * The EXT_framebuffer_object spec has the same wording, and the
3985 * OES_framebuffer_object spec refers to the EXT_framebuffer_object
3986 * spec.
3987 */
3988 if ((!_mesa_is_desktop_gl(ctx) ||
3989 !ctx->Extensions.ARB_framebuffer_object)
3990 && !_mesa_is_gles3(ctx)) {
3991 _mesa_error(ctx, GL_INVALID_OPERATION,
3992 "%s(window-system framebuffer)", caller);
3993 return;
3994 }
3995
3996 if (_mesa_is_gles3(ctx) && attachment != GL_BACK &&
3997 attachment != GL_DEPTH && attachment != GL_STENCIL) {
3998 _mesa_error(ctx, GL_INVALID_ENUM,
3999 "%s(invalid attachment %s)", caller,
4000 _mesa_enum_to_string(attachment));
4001 return;
4002 }
4003
4004 /* The specs are not clear about how to handle
4005 * GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME with the default framebuffer,
4006 * but dEQP-GLES3 expects an INVALID_ENUM error. This has also been
4007 * discussed in:
4008 *
4009 * https://cvs.khronos.org/bugzilla/show_bug.cgi?id=12928#c1
4010 * and https://bugs.freedesktop.org/show_bug.cgi?id=31947
4011 */
4012 if (pname == GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME) {
4013 _mesa_error(ctx, GL_INVALID_ENUM,
4014 "%s(requesting GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME "
4015 "when GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is "
4016 "GL_FRAMEBUFFER_DEFAULT is not allowed)", caller);
4017 return;
4018 }
4019
4020 /* the default / window-system FBO */
4021 att = get_fb0_attachment(ctx, buffer, attachment);
4022 }
4023 else {
4024 /* user-created framebuffer FBO */
4025 att = get_attachment(ctx, buffer, attachment, &is_color_attachment);
4026 }
4027
4028 if (att == NULL) {
4029 /*
4030 * From OpenGL 4.5 spec, section 9.2.3 "Framebuffer Object Queries":
4031 *
4032 * "An INVALID_OPERATION error is generated if a framebuffer object
4033 * is bound to target and attachment is COLOR_ATTACHMENTm where m is
4034 * greater than or equal to the value of MAX_COLOR_ATTACHMENTS."
4035 *
4036 * If we are at this point, is because the attachment is not valid, so
4037 * if is_color_attachment is true, is because of the previous reason.
4038 */
4039 if (is_color_attachment) {
4040 _mesa_error(ctx, GL_INVALID_OPERATION, "%s(invalid color attachment %s)",
4041 caller, _mesa_enum_to_string(attachment));
4042 } else {
4043 _mesa_error(ctx, GL_INVALID_ENUM, "%s(invalid attachment %s)", caller,
4044 _mesa_enum_to_string(attachment));
4045 }
4046 return;
4047 }
4048
4049 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
4050 const struct gl_renderbuffer_attachment *depthAtt, *stencilAtt;
4051 if (pname == GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE) {
4052 /* This behavior is first specified in OpenGL 4.4 specification.
4053 *
4054 * From the OpenGL 4.4 spec page 275:
4055 * "This query cannot be performed for a combined depth+stencil
4056 * attachment, since it does not have a single format."
4057 */
4058 _mesa_error(ctx, GL_INVALID_OPERATION,
4059 "%s(GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE"
4060 " is invalid for depth+stencil attachment)", caller);
4061 return;
4062 }
4063 /* the depth and stencil attachments must point to the same buffer */
4064 depthAtt = get_attachment(ctx, buffer, GL_DEPTH_ATTACHMENT, NULL);
4065 stencilAtt = get_attachment(ctx, buffer, GL_STENCIL_ATTACHMENT, NULL);
4066 if (depthAtt->Renderbuffer != stencilAtt->Renderbuffer) {
4067 _mesa_error(ctx, GL_INVALID_OPERATION,
4068 "%s(DEPTH/STENCIL attachments differ)", caller);
4069 return;
4070 }
4071 }
4072
4073 /* No need to flush here */
4074
4075 switch (pname) {
4076 case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_EXT:
4077 /* From the OpenGL spec, 9.2. Binding and Managing Framebuffer Objects:
4078 *
4079 * "If the value of FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is NONE, then
4080 * either no framebuffer is bound to target; or the default framebuffer
4081 * is bound, attachment is DEPTH or STENCIL, and the number of depth or
4082 * stencil bits, respectively, is zero."
4083 *
4084 * Note that we don't need explicit checks on DEPTH and STENCIL, because
4085 * on the case the spec is pointing, att->Type is already NONE, so we
4086 * just need to check att->Type.
4087 */
4088 *params = (_mesa_is_winsys_fbo(buffer) && att->Type != GL_NONE) ?
4089 GL_FRAMEBUFFER_DEFAULT : att->Type;
4090 return;
4091 case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_EXT:
4092 if (att->Type == GL_RENDERBUFFER_EXT) {
4093 *params = att->Renderbuffer->Name;
4094 }
4095 else if (att->Type == GL_TEXTURE) {
4096 *params = att->Texture->Name;
4097 }
4098 else {
4099 assert(att->Type == GL_NONE);
4100 if (_mesa_is_desktop_gl(ctx) || _mesa_is_gles3(ctx)) {
4101 *params = 0;
4102 } else {
4103 goto invalid_pname_enum;
4104 }
4105 }
4106 return;
4107 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_EXT:
4108 if (att->Type == GL_TEXTURE) {
4109 *params = att->TextureLevel;
4110 }
4111 else if (att->Type == GL_NONE) {
4112 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4113 _mesa_enum_to_string(pname));
4114 }
4115 else {
4116 goto invalid_pname_enum;
4117 }
4118 return;
4119 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_EXT:
4120 if (att->Type == GL_TEXTURE) {
4121 if (att->Texture && att->Texture->Target == GL_TEXTURE_CUBE_MAP) {
4122 *params = GL_TEXTURE_CUBE_MAP_POSITIVE_X + att->CubeMapFace;
4123 }
4124 else {
4125 *params = 0;
4126 }
4127 }
4128 else if (att->Type == GL_NONE) {
4129 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4130 _mesa_enum_to_string(pname));
4131 }
4132 else {
4133 goto invalid_pname_enum;
4134 }
4135 return;
4136 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_3D_ZOFFSET_EXT:
4137 if (ctx->API == API_OPENGLES) {
4138 goto invalid_pname_enum;
4139 } else if (att->Type == GL_NONE) {
4140 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4141 _mesa_enum_to_string(pname));
4142 } else if (att->Type == GL_TEXTURE) {
4143 if (att->Texture && (att->Texture->Target == GL_TEXTURE_3D ||
4144 att->Texture->Target == GL_TEXTURE_2D_ARRAY)) {
4145 *params = att->Zoffset;
4146 }
4147 else {
4148 *params = 0;
4149 }
4150 }
4151 else {
4152 goto invalid_pname_enum;
4153 }
4154 return;
4155 case GL_FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING:
4156 if ((!_mesa_is_desktop_gl(ctx) ||
4157 !ctx->Extensions.ARB_framebuffer_object)
4158 && !_mesa_is_gles3(ctx)) {
4159 goto invalid_pname_enum;
4160 }
4161 else if (att->Type == GL_NONE) {
4162 if (_mesa_is_winsys_fbo(buffer) &&
4163 (attachment == GL_DEPTH || attachment == GL_STENCIL)) {
4164 *params = GL_LINEAR;
4165 } else {
4166 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4167 _mesa_enum_to_string(pname));
4168 }
4169 }
4170 else {
4171 if (ctx->Extensions.EXT_framebuffer_sRGB) {
4172 *params =
4173 _mesa_get_format_color_encoding(att->Renderbuffer->Format);
4174 }
4175 else {
4176 /* According to ARB_framebuffer_sRGB, we should return LINEAR
4177 * if the sRGB conversion is unsupported. */
4178 *params = GL_LINEAR;
4179 }
4180 }
4181 return;
4182 case GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE:
4183 if ((ctx->API != API_OPENGL_COMPAT ||
4184 !ctx->Extensions.ARB_framebuffer_object)
4185 && ctx->API != API_OPENGL_CORE
4186 && !_mesa_is_gles3(ctx)) {
4187 goto invalid_pname_enum;
4188 }
4189 else if (att->Type == GL_NONE) {
4190 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4191 _mesa_enum_to_string(pname));
4192 }
4193 else {
4194 mesa_format format = att->Renderbuffer->Format;
4195
4196 /* Page 235 (page 247 of the PDF) in section 6.1.13 of the OpenGL ES
4197 * 3.0.1 spec says:
4198 *
4199 * "If pname is FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE.... If
4200 * attachment is DEPTH_STENCIL_ATTACHMENT the query will fail and
4201 * generate an INVALID_OPERATION error.
4202 */
4203 if (_mesa_is_gles3(ctx) &&
4204 attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
4205 _mesa_error(ctx, GL_INVALID_OPERATION,
4206 "%s(cannot query "
4207 "GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE of "
4208 "GL_DEPTH_STENCIL_ATTACHMENT)", caller);
4209 return;
4210 }
4211
4212 if (format == MESA_FORMAT_S_UINT8) {
4213 /* special cases */
4214 *params = GL_INDEX;
4215 }
4216 else if (format == MESA_FORMAT_Z32_FLOAT_S8X24_UINT) {
4217 /* depends on the attachment parameter */
4218 if (attachment == GL_STENCIL_ATTACHMENT) {
4219 *params = GL_INDEX;
4220 }
4221 else {
4222 *params = GL_FLOAT;
4223 }
4224 }
4225 else {
4226 *params = _mesa_get_format_datatype(format);
4227 }
4228 }
4229 return;
4230 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
4231 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
4232 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
4233 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
4234 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
4235 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
4236 if ((!_mesa_is_desktop_gl(ctx) ||
4237 !ctx->Extensions.ARB_framebuffer_object)
4238 && !_mesa_is_gles3(ctx)) {
4239 goto invalid_pname_enum;
4240 }
4241 else if (att->Texture) {
4242 const struct gl_texture_image *texImage =
4243 _mesa_select_tex_image(att->Texture, att->Texture->Target,
4244 att->TextureLevel);
4245 if (texImage) {
4246 *params = get_component_bits(pname, texImage->_BaseFormat,
4247 texImage->TexFormat);
4248 }
4249 else {
4250 *params = 0;
4251 }
4252 }
4253 else if (att->Renderbuffer) {
4254 *params = get_component_bits(pname, att->Renderbuffer->_BaseFormat,
4255 att->Renderbuffer->Format);
4256 }
4257 else {
4258 assert(att->Type == GL_NONE);
4259 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4260 _mesa_enum_to_string(pname));
4261 }
4262 return;
4263 case GL_FRAMEBUFFER_ATTACHMENT_LAYERED:
4264 if (!_mesa_has_geometry_shaders(ctx)) {
4265 goto invalid_pname_enum;
4266 } else if (att->Type == GL_TEXTURE) {
4267 *params = att->Layered;
4268 } else if (att->Type == GL_NONE) {
4269 _mesa_error(ctx, err, "%s(invalid pname %s)", caller,
4270 _mesa_enum_to_string(pname));
4271 } else {
4272 goto invalid_pname_enum;
4273 }
4274 return;
4275 default:
4276 goto invalid_pname_enum;
4277 }
4278
4279 return;
4280
4281 invalid_pname_enum:
4282 _mesa_error(ctx, GL_INVALID_ENUM, "%s(invalid pname %s)", caller,
4283 _mesa_enum_to_string(pname));
4284 return;
4285 }
4286
4287
4288 void GLAPIENTRY
4289 _mesa_GetFramebufferAttachmentParameteriv(GLenum target, GLenum attachment,
4290 GLenum pname, GLint *params)
4291 {
4292 GET_CURRENT_CONTEXT(ctx);
4293 struct gl_framebuffer *buffer;
4294
4295 buffer = get_framebuffer_target(ctx, target);
4296 if (!buffer) {
4297 _mesa_error(ctx, GL_INVALID_ENUM,
4298 "glGetFramebufferAttachmentParameteriv(invalid target %s)",
4299 _mesa_enum_to_string(target));
4300 return;
4301 }
4302
4303 get_framebuffer_attachment_parameter(ctx, buffer, attachment, pname,
4304 params,
4305 "glGetFramebufferAttachmentParameteriv");
4306 }
4307
4308
4309 void GLAPIENTRY
4310 _mesa_GetNamedFramebufferAttachmentParameteriv(GLuint framebuffer,
4311 GLenum attachment,
4312 GLenum pname, GLint *params)
4313 {
4314 GET_CURRENT_CONTEXT(ctx);
4315 struct gl_framebuffer *buffer;
4316
4317 if (framebuffer) {
4318 buffer = _mesa_lookup_framebuffer_err(ctx, framebuffer,
4319 "glGetNamedFramebufferAttachmentParameteriv");
4320 if (!buffer)
4321 return;
4322 }
4323 else {
4324 /*
4325 * Section 9.2 Binding and Managing Framebuffer Objects of the OpenGL
4326 * 4.5 core spec (30.10.2014, PDF page 314):
4327 * "If framebuffer is zero, then the default draw framebuffer is
4328 * queried."
4329 */
4330 buffer = ctx->WinSysDrawBuffer;
4331 }
4332
4333 get_framebuffer_attachment_parameter(ctx, buffer, attachment, pname,
4334 params,
4335 "glGetNamedFramebufferAttachmentParameteriv");
4336 }
4337
4338
4339 void GLAPIENTRY
4340 _mesa_NamedFramebufferParameteri(GLuint framebuffer, GLenum pname,
4341 GLint param)
4342 {
4343 GET_CURRENT_CONTEXT(ctx);
4344 struct gl_framebuffer *fb = NULL;
4345
4346 if (!ctx->Extensions.ARB_framebuffer_no_attachments &&
4347 !ctx->Extensions.ARB_sample_locations) {
4348 _mesa_error(ctx, GL_INVALID_OPERATION,
4349 "glNamedFramebufferParameteri("
4350 "neither ARB_framebuffer_no_attachments nor "
4351 "ARB_sample_locations is available)");
4352 return;
4353 }
4354
4355 if (framebuffer) {
4356 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
4357 "glNamedFramebufferParameteri");
4358 } else {
4359 fb = ctx->WinSysDrawBuffer;
4360 }
4361
4362 if (fb) {
4363 framebuffer_parameteri(ctx, fb, pname, param,
4364 "glNamedFramebufferParameteriv");
4365 }
4366 }
4367
4368
4369 void GLAPIENTRY
4370 _mesa_GetNamedFramebufferParameteriv(GLuint framebuffer, GLenum pname,
4371 GLint *param)
4372 {
4373 GET_CURRENT_CONTEXT(ctx);
4374 struct gl_framebuffer *fb;
4375
4376 if (!ctx->Extensions.ARB_framebuffer_no_attachments) {
4377 _mesa_error(ctx, GL_INVALID_OPERATION,
4378 "glNamedFramebufferParameteriv("
4379 "neither ARB_framebuffer_no_attachments nor ARB_sample_locations"
4380 " is available)");
4381 return;
4382 }
4383
4384 if (framebuffer)
4385 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
4386 "glGetNamedFramebufferParameteriv");
4387 else
4388 fb = ctx->WinSysDrawBuffer;
4389
4390 if (fb) {
4391 get_framebuffer_parameteriv(ctx, fb, pname, param,
4392 "glGetNamedFramebufferParameteriv");
4393 }
4394 }
4395
4396
4397 static void
4398 invalidate_framebuffer_storage(struct gl_context *ctx,
4399 struct gl_framebuffer *fb,
4400 GLsizei numAttachments,
4401 const GLenum *attachments, GLint x, GLint y,
4402 GLsizei width, GLsizei height, const char *name)
4403 {
4404 int i;
4405
4406 /* Section 17.4 Whole Framebuffer Operations of the OpenGL 4.5 Core
4407 * Spec (2.2.2015, PDF page 522) says:
4408 * "An INVALID_VALUE error is generated if numAttachments, width, or
4409 * height is negative."
4410 */
4411 if (numAttachments < 0) {
4412 _mesa_error(ctx, GL_INVALID_VALUE,
4413 "%s(numAttachments < 0)", name);
4414 return;
4415 }
4416
4417 if (width < 0) {
4418 _mesa_error(ctx, GL_INVALID_VALUE,
4419 "%s(width < 0)", name);
4420 return;
4421 }
4422
4423 if (height < 0) {
4424 _mesa_error(ctx, GL_INVALID_VALUE,
4425 "%s(height < 0)", name);
4426 return;
4427 }
4428
4429 /* The GL_ARB_invalidate_subdata spec says:
4430 *
4431 * "If an attachment is specified that does not exist in the
4432 * framebuffer bound to <target>, it is ignored."
4433 *
4434 * It also says:
4435 *
4436 * "If <attachments> contains COLOR_ATTACHMENTm and m is greater than
4437 * or equal to the value of MAX_COLOR_ATTACHMENTS, then the error
4438 * INVALID_OPERATION is generated."
4439 *
4440 * No mention is made of GL_AUXi being out of range. Therefore, we allow
4441 * any enum that can be allowed by the API (OpenGL ES 3.0 has a different
4442 * set of retrictions).
4443 */
4444 for (i = 0; i < numAttachments; i++) {
4445 if (_mesa_is_winsys_fbo(fb)) {
4446 switch (attachments[i]) {
4447 case GL_ACCUM:
4448 case GL_AUX0:
4449 case GL_AUX1:
4450 case GL_AUX2:
4451 case GL_AUX3:
4452 /* Accumulation buffers and auxilary buffers were removed in
4453 * OpenGL 3.1, and they never existed in OpenGL ES.
4454 */
4455 if (ctx->API != API_OPENGL_COMPAT)
4456 goto invalid_enum;
4457 break;
4458 case GL_COLOR:
4459 case GL_DEPTH:
4460 case GL_STENCIL:
4461 break;
4462 case GL_BACK_LEFT:
4463 case GL_BACK_RIGHT:
4464 case GL_FRONT_LEFT:
4465 case GL_FRONT_RIGHT:
4466 if (!_mesa_is_desktop_gl(ctx))
4467 goto invalid_enum;
4468 break;
4469 default:
4470 goto invalid_enum;
4471 }
4472 } else {
4473 switch (attachments[i]) {
4474 case GL_DEPTH_ATTACHMENT:
4475 case GL_STENCIL_ATTACHMENT:
4476 break;
4477 case GL_DEPTH_STENCIL_ATTACHMENT:
4478 /* GL_DEPTH_STENCIL_ATTACHMENT is a valid attachment point only
4479 * in desktop and ES 3.0 profiles. Note that OES_packed_depth_stencil
4480 * extension does not make this attachment point valid on ES 2.0.
4481 */
4482 if (_mesa_is_desktop_gl(ctx) || _mesa_is_gles3(ctx))
4483 break;
4484 /* fallthrough */
4485 case GL_COLOR_ATTACHMENT0:
4486 case GL_COLOR_ATTACHMENT1:
4487 case GL_COLOR_ATTACHMENT2:
4488 case GL_COLOR_ATTACHMENT3:
4489 case GL_COLOR_ATTACHMENT4:
4490 case GL_COLOR_ATTACHMENT5:
4491 case GL_COLOR_ATTACHMENT6:
4492 case GL_COLOR_ATTACHMENT7:
4493 case GL_COLOR_ATTACHMENT8:
4494 case GL_COLOR_ATTACHMENT9:
4495 case GL_COLOR_ATTACHMENT10:
4496 case GL_COLOR_ATTACHMENT11:
4497 case GL_COLOR_ATTACHMENT12:
4498 case GL_COLOR_ATTACHMENT13:
4499 case GL_COLOR_ATTACHMENT14:
4500 case GL_COLOR_ATTACHMENT15: {
4501 unsigned k = attachments[i] - GL_COLOR_ATTACHMENT0;
4502 if (k >= ctx->Const.MaxColorAttachments) {
4503 _mesa_error(ctx, GL_INVALID_OPERATION,
4504 "%s(attachment >= max. color attachments)", name);
4505 return;
4506 }
4507 break;
4508 }
4509 default:
4510 goto invalid_enum;
4511 }
4512 }
4513 }
4514
4515 /* We don't actually do anything for this yet. Just return after
4516 * validating the parameters and generating the required errors.
4517 */
4518 return;
4519
4520 invalid_enum:
4521 _mesa_error(ctx, GL_INVALID_ENUM, "%s(invalid attachment %s)", name,
4522 _mesa_enum_to_string(attachments[i]));
4523 return;
4524 }
4525
4526
4527 void GLAPIENTRY
4528 _mesa_InvalidateSubFramebuffer_no_error(GLenum target, GLsizei numAttachments,
4529 const GLenum *attachments, GLint x,
4530 GLint y, GLsizei width, GLsizei height)
4531 {
4532 /* no-op */
4533 }
4534
4535
4536 void GLAPIENTRY
4537 _mesa_InvalidateSubFramebuffer(GLenum target, GLsizei numAttachments,
4538 const GLenum *attachments, GLint x, GLint y,
4539 GLsizei width, GLsizei height)
4540 {
4541 struct gl_framebuffer *fb;
4542 GET_CURRENT_CONTEXT(ctx);
4543
4544 fb = get_framebuffer_target(ctx, target);
4545 if (!fb) {
4546 _mesa_error(ctx, GL_INVALID_ENUM,
4547 "glInvalidateSubFramebuffer(invalid target %s)",
4548 _mesa_enum_to_string(target));
4549 return;
4550 }
4551
4552 invalidate_framebuffer_storage(ctx, fb, numAttachments, attachments,
4553 x, y, width, height,
4554 "glInvalidateSubFramebuffer");
4555 }
4556
4557
4558 void GLAPIENTRY
4559 _mesa_InvalidateNamedFramebufferSubData(GLuint framebuffer,
4560 GLsizei numAttachments,
4561 const GLenum *attachments,
4562 GLint x, GLint y,
4563 GLsizei width, GLsizei height)
4564 {
4565 struct gl_framebuffer *fb;
4566 GET_CURRENT_CONTEXT(ctx);
4567
4568 /* The OpenGL 4.5 core spec (02.02.2015) says (in Section 17.4 Whole
4569 * Framebuffer Operations, PDF page 522): "If framebuffer is zero, the
4570 * default draw framebuffer is affected."
4571 */
4572 if (framebuffer) {
4573 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
4574 "glInvalidateNamedFramebufferSubData");
4575 if (!fb)
4576 return;
4577 }
4578 else
4579 fb = ctx->WinSysDrawBuffer;
4580
4581 invalidate_framebuffer_storage(ctx, fb, numAttachments, attachments,
4582 x, y, width, height,
4583 "glInvalidateNamedFramebufferSubData");
4584 }
4585
4586
4587 void GLAPIENTRY
4588 _mesa_InvalidateFramebuffer_no_error(GLenum target, GLsizei numAttachments,
4589 const GLenum *attachments)
4590 {
4591 /* no-op */
4592 }
4593
4594
4595 void GLAPIENTRY
4596 _mesa_InvalidateFramebuffer(GLenum target, GLsizei numAttachments,
4597 const GLenum *attachments)
4598 {
4599 struct gl_framebuffer *fb;
4600 GET_CURRENT_CONTEXT(ctx);
4601
4602 fb = get_framebuffer_target(ctx, target);
4603 if (!fb) {
4604 _mesa_error(ctx, GL_INVALID_ENUM,
4605 "glInvalidateFramebuffer(invalid target %s)",
4606 _mesa_enum_to_string(target));
4607 return;
4608 }
4609
4610 /* The GL_ARB_invalidate_subdata spec says:
4611 *
4612 * "The command
4613 *
4614 * void InvalidateFramebuffer(enum target,
4615 * sizei numAttachments,
4616 * const enum *attachments);
4617 *
4618 * is equivalent to the command InvalidateSubFramebuffer with <x>, <y>,
4619 * <width>, <height> equal to 0, 0, <MAX_VIEWPORT_DIMS[0]>,
4620 * <MAX_VIEWPORT_DIMS[1]> respectively."
4621 */
4622 invalidate_framebuffer_storage(ctx, fb, numAttachments, attachments,
4623 0, 0,
4624 ctx->Const.MaxViewportWidth,
4625 ctx->Const.MaxViewportHeight,
4626 "glInvalidateFramebuffer");
4627 }
4628
4629
4630 void GLAPIENTRY
4631 _mesa_InvalidateNamedFramebufferData(GLuint framebuffer,
4632 GLsizei numAttachments,
4633 const GLenum *attachments)
4634 {
4635 struct gl_framebuffer *fb;
4636 GET_CURRENT_CONTEXT(ctx);
4637
4638 /* The OpenGL 4.5 core spec (02.02.2015) says (in Section 17.4 Whole
4639 * Framebuffer Operations, PDF page 522): "If framebuffer is zero, the
4640 * default draw framebuffer is affected."
4641 */
4642 if (framebuffer) {
4643 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
4644 "glInvalidateNamedFramebufferData");
4645 if (!fb)
4646 return;
4647 }
4648 else
4649 fb = ctx->WinSysDrawBuffer;
4650
4651 /* The GL_ARB_invalidate_subdata spec says:
4652 *
4653 * "The command
4654 *
4655 * void InvalidateFramebuffer(enum target,
4656 * sizei numAttachments,
4657 * const enum *attachments);
4658 *
4659 * is equivalent to the command InvalidateSubFramebuffer with <x>, <y>,
4660 * <width>, <height> equal to 0, 0, <MAX_VIEWPORT_DIMS[0]>,
4661 * <MAX_VIEWPORT_DIMS[1]> respectively."
4662 */
4663 invalidate_framebuffer_storage(ctx, fb, numAttachments, attachments,
4664 0, 0,
4665 ctx->Const.MaxViewportWidth,
4666 ctx->Const.MaxViewportHeight,
4667 "glInvalidateNamedFramebufferData");
4668 }
4669
4670
4671 void GLAPIENTRY
4672 _mesa_DiscardFramebufferEXT(GLenum target, GLsizei numAttachments,
4673 const GLenum *attachments)
4674 {
4675 struct gl_framebuffer *fb;
4676 GLint i;
4677
4678 GET_CURRENT_CONTEXT(ctx);
4679
4680 fb = get_framebuffer_target(ctx, target);
4681 if (!fb) {
4682 _mesa_error(ctx, GL_INVALID_ENUM,
4683 "glDiscardFramebufferEXT(target %s)",
4684 _mesa_enum_to_string(target));
4685 return;
4686 }
4687
4688 if (numAttachments < 0) {
4689 _mesa_error(ctx, GL_INVALID_VALUE,
4690 "glDiscardFramebufferEXT(numAttachments < 0)");
4691 return;
4692 }
4693
4694 for (i = 0; i < numAttachments; i++) {
4695 switch (attachments[i]) {
4696 case GL_COLOR:
4697 case GL_DEPTH:
4698 case GL_STENCIL:
4699 if (_mesa_is_user_fbo(fb))
4700 goto invalid_enum;
4701 break;
4702 case GL_COLOR_ATTACHMENT0:
4703 case GL_DEPTH_ATTACHMENT:
4704 case GL_STENCIL_ATTACHMENT:
4705 if (_mesa_is_winsys_fbo(fb))
4706 goto invalid_enum;
4707 break;
4708 default:
4709 goto invalid_enum;
4710 }
4711 }
4712
4713 if (ctx->Driver.DiscardFramebuffer)
4714 ctx->Driver.DiscardFramebuffer(ctx, target, numAttachments, attachments);
4715
4716 return;
4717
4718 invalid_enum:
4719 _mesa_error(ctx, GL_INVALID_ENUM,
4720 "glDiscardFramebufferEXT(attachment %s)",
4721 _mesa_enum_to_string(attachments[i]));
4722 }
4723
4724 static void
4725 sample_locations(struct gl_context *ctx, struct gl_framebuffer *fb,
4726 GLuint start, GLsizei count, const GLfloat *v, bool no_error,
4727 const char *name)
4728 {
4729 GLsizei i;
4730
4731 if (!no_error) {
4732 if (!ctx->Extensions.ARB_sample_locations) {
4733 _mesa_error(ctx, GL_INVALID_OPERATION,
4734 "%s not supported "
4735 "(ARB_sample_locations not available)", name);
4736 return;
4737 }
4738
4739 if (start + count > MAX_SAMPLE_LOCATION_TABLE_SIZE) {
4740 _mesa_error(ctx, GL_INVALID_VALUE,
4741 "%s(start+size > sample location table size)", name);
4742 return;
4743 }
4744 }
4745
4746 if (!fb->SampleLocationTable) {
4747 size_t size = MAX_SAMPLE_LOCATION_TABLE_SIZE * 2 * sizeof(GLfloat);
4748 fb->SampleLocationTable = malloc(size);
4749 if (!fb->SampleLocationTable) {
4750 _mesa_error(ctx, GL_OUT_OF_MEMORY,
4751 "Cannot allocate sample location table");
4752 return;
4753 }
4754 for (i = 0; i < MAX_SAMPLE_LOCATION_TABLE_SIZE * 2; i++)
4755 fb->SampleLocationTable[i] = 0.5f;
4756 }
4757
4758 for (i = 0; i < count * 2; i++) {
4759 /* The ARB_sample_locations spec says:
4760 *
4761 * Sample locations outside of [0,1] result in undefined
4762 * behavior.
4763 *
4764 * To simplify driver implementations, we choose to clamp to
4765 * [0,1] and change NaN into 0.5.
4766 */
4767 if (isnan(v[i]) || v[i] < 0.0f || v[i] > 1.0f) {
4768 static GLuint msg_id = 0;
4769 static const char* msg = "Invalid sample location specified";
4770 _mesa_debug_get_id(&msg_id);
4771
4772 _mesa_log_msg(ctx, MESA_DEBUG_SOURCE_API, MESA_DEBUG_TYPE_UNDEFINED,
4773 msg_id, MESA_DEBUG_SEVERITY_HIGH, strlen(msg), msg);
4774 }
4775
4776 if (isnan(v[i]))
4777 fb->SampleLocationTable[start * 2 + i] = 0.5f;
4778 else
4779 fb->SampleLocationTable[start * 2 + i] = CLAMP(v[i], 0.0f, 1.0f);
4780 }
4781
4782 if (fb == ctx->DrawBuffer)
4783 ctx->NewDriverState |= ctx->DriverFlags.NewSampleLocations;
4784 }
4785
4786 void GLAPIENTRY
4787 _mesa_FramebufferSampleLocationsfvARB(GLenum target, GLuint start,
4788 GLsizei count, const GLfloat *v)
4789 {
4790 struct gl_framebuffer *fb;
4791
4792 GET_CURRENT_CONTEXT(ctx);
4793
4794 fb = get_framebuffer_target(ctx, target);
4795 if (!fb) {
4796 _mesa_error(ctx, GL_INVALID_ENUM,
4797 "glFramebufferSampleLocationsfvARB(target %s)",
4798 _mesa_enum_to_string(target));
4799 return;
4800 }
4801
4802 sample_locations(ctx, fb, start, count, v, false,
4803 "glFramebufferSampleLocationsfvARB");
4804 }
4805
4806 void GLAPIENTRY
4807 _mesa_NamedFramebufferSampleLocationsfvARB(GLuint framebuffer, GLuint start,
4808 GLsizei count, const GLfloat *v)
4809 {
4810 struct gl_framebuffer *fb;
4811
4812 GET_CURRENT_CONTEXT(ctx);
4813
4814 if (framebuffer) {
4815 fb = _mesa_lookup_framebuffer_err(ctx, framebuffer,
4816 "glNamedFramebufferSampleLocationsfvARB");
4817 if (!fb)
4818 return;
4819 }
4820 else
4821 fb = ctx->WinSysDrawBuffer;
4822
4823 sample_locations(ctx, fb, start, count, v, false,
4824 "glNamedFramebufferSampleLocationsfvARB");
4825 }
4826
4827 void GLAPIENTRY
4828 _mesa_FramebufferSampleLocationsfvARB_no_error(GLenum target, GLuint start,
4829 GLsizei count, const GLfloat *v)
4830 {
4831 GET_CURRENT_CONTEXT(ctx);
4832 sample_locations(ctx, get_framebuffer_target(ctx, target), start,
4833 count, v, true, "glFramebufferSampleLocationsfvARB");
4834 }
4835
4836 void GLAPIENTRY
4837 _mesa_NamedFramebufferSampleLocationsfvARB_no_error(GLuint framebuffer,
4838 GLuint start, GLsizei count,
4839 const GLfloat *v)
4840 {
4841 GET_CURRENT_CONTEXT(ctx);
4842 sample_locations(ctx, _mesa_lookup_framebuffer(ctx, framebuffer), start,
4843 count, v, true, "glNamedFramebufferSampleLocationsfvARB");
4844 }
4845
4846 void GLAPIENTRY
4847 _mesa_EvaluateDepthValuesARB(void)
4848 {
4849 GET_CURRENT_CONTEXT(ctx);
4850
4851 if (!ctx->Extensions.ARB_sample_locations) {
4852 _mesa_error(ctx, GL_INVALID_OPERATION,
4853 "EvaluateDepthValuesARB not supported (neither "
4854 "ARB_sample_locations nor NV_sample_locations is available)");
4855 return;
4856 }
4857
4858 if (ctx->Driver.EvaluateDepthValues)
4859 ctx->Driver.EvaluateDepthValues(ctx);
4860 }