mesa: Guard against null pointer deref in fbo validation
[mesa.git] / src / mesa / main / fbobject.c
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.1
4 *
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 1999-2009 VMware, Inc. All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 */
25
26
27 /*
28 * GL_EXT/ARB_framebuffer_object extensions
29 *
30 * Authors:
31 * Brian Paul
32 */
33
34
35 #include "buffers.h"
36 #include "context.h"
37 #include "enums.h"
38 #include "fbobject.h"
39 #include "formats.h"
40 #include "framebuffer.h"
41 #include "hash.h"
42 #include "macros.h"
43 #include "mfeatures.h"
44 #include "mtypes.h"
45 #include "renderbuffer.h"
46 #include "state.h"
47 #include "teximage.h"
48 #include "texobj.h"
49
50
51 /** Set this to 1 to help debug FBO incompleteness problems */
52 #define DEBUG_FBO 0
53
54 /** Set this to 1 to debug/log glBlitFramebuffer() calls */
55 #define DEBUG_BLIT 0
56
57
58 /**
59 * Notes:
60 *
61 * None of the GL_EXT_framebuffer_object functions are compiled into
62 * display lists.
63 */
64
65
66
67 /*
68 * When glGenRender/FramebuffersEXT() is called we insert pointers to
69 * these placeholder objects into the hash table.
70 * Later, when the object ID is first bound, we replace the placeholder
71 * with the real frame/renderbuffer.
72 */
73 static struct gl_framebuffer DummyFramebuffer;
74 static struct gl_renderbuffer DummyRenderbuffer;
75
76 /* We bind this framebuffer when applications pass a NULL
77 * drawable/surface in make current. */
78 static struct gl_framebuffer IncompleteFramebuffer;
79
80
81 #define IS_CUBE_FACE(TARGET) \
82 ((TARGET) >= GL_TEXTURE_CUBE_MAP_POSITIVE_X && \
83 (TARGET) <= GL_TEXTURE_CUBE_MAP_NEGATIVE_Z)
84
85
86 static void
87 delete_dummy_renderbuffer(struct gl_renderbuffer *rb)
88 {
89 /* no op */
90 }
91
92 static void
93 delete_dummy_framebuffer(struct gl_framebuffer *fb)
94 {
95 /* no op */
96 }
97
98
99 void
100 _mesa_init_fbobjects(struct gl_context *ctx)
101 {
102 _glthread_INIT_MUTEX(DummyFramebuffer.Mutex);
103 _glthread_INIT_MUTEX(DummyRenderbuffer.Mutex);
104 _glthread_INIT_MUTEX(IncompleteFramebuffer.Mutex);
105 DummyFramebuffer.Delete = delete_dummy_framebuffer;
106 DummyRenderbuffer.Delete = delete_dummy_renderbuffer;
107 IncompleteFramebuffer.Delete = delete_dummy_framebuffer;
108 }
109
110 struct gl_framebuffer *
111 _mesa_get_incomplete_framebuffer(void)
112 {
113 return &IncompleteFramebuffer;
114 }
115
116 /**
117 * Helper routine for getting a gl_renderbuffer.
118 */
119 struct gl_renderbuffer *
120 _mesa_lookup_renderbuffer(struct gl_context *ctx, GLuint id)
121 {
122 struct gl_renderbuffer *rb;
123
124 if (id == 0)
125 return NULL;
126
127 rb = (struct gl_renderbuffer *)
128 _mesa_HashLookup(ctx->Shared->RenderBuffers, id);
129 return rb;
130 }
131
132
133 /**
134 * Helper routine for getting a gl_framebuffer.
135 */
136 struct gl_framebuffer *
137 _mesa_lookup_framebuffer(struct gl_context *ctx, GLuint id)
138 {
139 struct gl_framebuffer *fb;
140
141 if (id == 0)
142 return NULL;
143
144 fb = (struct gl_framebuffer *)
145 _mesa_HashLookup(ctx->Shared->FrameBuffers, id);
146 return fb;
147 }
148
149
150 /**
151 * Mark the given framebuffer as invalid. This will force the
152 * test for framebuffer completeness to be done before the framebuffer
153 * is used.
154 */
155 static void
156 invalidate_framebuffer(struct gl_framebuffer *fb)
157 {
158 fb->_Status = 0; /* "indeterminate" */
159 }
160
161
162 /**
163 * Return the gl_framebuffer object which corresponds to the given
164 * framebuffer target, such as GL_DRAW_FRAMEBUFFER.
165 * Check support for GL_EXT_framebuffer_blit to determine if certain
166 * targets are legal.
167 * \return gl_framebuffer pointer or NULL if target is illegal
168 */
169 static struct gl_framebuffer *
170 get_framebuffer_target(struct gl_context *ctx, GLenum target)
171 {
172 switch (target) {
173 case GL_DRAW_FRAMEBUFFER:
174 return ctx->Extensions.EXT_framebuffer_blit ? ctx->DrawBuffer : NULL;
175 case GL_READ_FRAMEBUFFER:
176 return ctx->Extensions.EXT_framebuffer_blit ? ctx->ReadBuffer : NULL;
177 case GL_FRAMEBUFFER_EXT:
178 return ctx->DrawBuffer;
179 default:
180 return NULL;
181 }
182 }
183
184
185 /**
186 * Given a GL_*_ATTACHMENTn token, return a pointer to the corresponding
187 * gl_renderbuffer_attachment object.
188 * This function is only used for user-created FB objects, not the
189 * default / window-system FB object.
190 * If \p attachment is GL_DEPTH_STENCIL_ATTACHMENT, return a pointer to
191 * the depth buffer attachment point.
192 */
193 struct gl_renderbuffer_attachment *
194 _mesa_get_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
195 GLenum attachment)
196 {
197 GLuint i;
198
199 assert(fb->Name > 0);
200
201 switch (attachment) {
202 case GL_COLOR_ATTACHMENT0_EXT:
203 case GL_COLOR_ATTACHMENT1_EXT:
204 case GL_COLOR_ATTACHMENT2_EXT:
205 case GL_COLOR_ATTACHMENT3_EXT:
206 case GL_COLOR_ATTACHMENT4_EXT:
207 case GL_COLOR_ATTACHMENT5_EXT:
208 case GL_COLOR_ATTACHMENT6_EXT:
209 case GL_COLOR_ATTACHMENT7_EXT:
210 case GL_COLOR_ATTACHMENT8_EXT:
211 case GL_COLOR_ATTACHMENT9_EXT:
212 case GL_COLOR_ATTACHMENT10_EXT:
213 case GL_COLOR_ATTACHMENT11_EXT:
214 case GL_COLOR_ATTACHMENT12_EXT:
215 case GL_COLOR_ATTACHMENT13_EXT:
216 case GL_COLOR_ATTACHMENT14_EXT:
217 case GL_COLOR_ATTACHMENT15_EXT:
218 i = attachment - GL_COLOR_ATTACHMENT0_EXT;
219 if (i >= ctx->Const.MaxColorAttachments) {
220 return NULL;
221 }
222 return &fb->Attachment[BUFFER_COLOR0 + i];
223 case GL_DEPTH_STENCIL_ATTACHMENT:
224 /* fall-through */
225 case GL_DEPTH_BUFFER:
226 /* fall-through / new in GL 3.0 */
227 case GL_DEPTH_ATTACHMENT_EXT:
228 return &fb->Attachment[BUFFER_DEPTH];
229 case GL_STENCIL_BUFFER:
230 /* fall-through / new in GL 3.0 */
231 case GL_STENCIL_ATTACHMENT_EXT:
232 return &fb->Attachment[BUFFER_STENCIL];
233 default:
234 return NULL;
235 }
236 }
237
238
239 /**
240 * As above, but only used for getting attachments of the default /
241 * window-system framebuffer (not user-created framebuffer objects).
242 */
243 static struct gl_renderbuffer_attachment *
244 _mesa_get_fb0_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
245 GLenum attachment)
246 {
247 assert(fb->Name == 0);
248
249 switch (attachment) {
250 case GL_FRONT_LEFT:
251 return &fb->Attachment[BUFFER_FRONT_LEFT];
252 case GL_FRONT_RIGHT:
253 return &fb->Attachment[BUFFER_FRONT_RIGHT];
254 case GL_BACK_LEFT:
255 return &fb->Attachment[BUFFER_BACK_LEFT];
256 case GL_BACK_RIGHT:
257 return &fb->Attachment[BUFFER_BACK_RIGHT];
258 case GL_AUX0:
259 if (fb->Visual.numAuxBuffers == 1) {
260 return &fb->Attachment[BUFFER_AUX0];
261 }
262 return NULL;
263 case GL_DEPTH_BUFFER:
264 /* fall-through / new in GL 3.0 */
265 case GL_DEPTH_ATTACHMENT_EXT:
266 return &fb->Attachment[BUFFER_DEPTH];
267 case GL_STENCIL_BUFFER:
268 /* fall-through / new in GL 3.0 */
269 case GL_STENCIL_ATTACHMENT_EXT:
270 return &fb->Attachment[BUFFER_STENCIL];
271 default:
272 return NULL;
273 }
274 }
275
276
277
278 /**
279 * Remove any texture or renderbuffer attached to the given attachment
280 * point. Update reference counts, etc.
281 */
282 void
283 _mesa_remove_attachment(struct gl_context *ctx,
284 struct gl_renderbuffer_attachment *att)
285 {
286 if (att->Type == GL_TEXTURE) {
287 ASSERT(att->Texture);
288 if (ctx->Driver.FinishRenderTexture) {
289 /* tell driver that we're done rendering to this texture. */
290 ctx->Driver.FinishRenderTexture(ctx, att);
291 }
292 _mesa_reference_texobj(&att->Texture, NULL); /* unbind */
293 ASSERT(!att->Texture);
294 }
295 if (att->Type == GL_TEXTURE || att->Type == GL_RENDERBUFFER_EXT) {
296 ASSERT(!att->Texture);
297 _mesa_reference_renderbuffer(&att->Renderbuffer, NULL); /* unbind */
298 ASSERT(!att->Renderbuffer);
299 }
300 att->Type = GL_NONE;
301 att->Complete = GL_TRUE;
302 }
303
304
305 /**
306 * Bind a texture object to an attachment point.
307 * The previous binding, if any, will be removed first.
308 */
309 void
310 _mesa_set_texture_attachment(struct gl_context *ctx,
311 struct gl_framebuffer *fb,
312 struct gl_renderbuffer_attachment *att,
313 struct gl_texture_object *texObj,
314 GLenum texTarget, GLuint level, GLuint zoffset)
315 {
316 if (att->Texture == texObj) {
317 /* re-attaching same texture */
318 ASSERT(att->Type == GL_TEXTURE);
319 if (ctx->Driver.FinishRenderTexture)
320 ctx->Driver.FinishRenderTexture(ctx, att);
321 }
322 else {
323 /* new attachment */
324 if (ctx->Driver.FinishRenderTexture && att->Texture)
325 ctx->Driver.FinishRenderTexture(ctx, att);
326 _mesa_remove_attachment(ctx, att);
327 att->Type = GL_TEXTURE;
328 assert(!att->Texture);
329 _mesa_reference_texobj(&att->Texture, texObj);
330 }
331
332 /* always update these fields */
333 att->TextureLevel = level;
334 att->CubeMapFace = _mesa_tex_target_to_face(texTarget);
335 att->Zoffset = zoffset;
336 att->Complete = GL_FALSE;
337
338 if (_mesa_get_attachment_teximage(att)) {
339 ctx->Driver.RenderTexture(ctx, fb, att);
340 }
341
342 invalidate_framebuffer(fb);
343 }
344
345
346 /**
347 * Bind a renderbuffer to an attachment point.
348 * The previous binding, if any, will be removed first.
349 */
350 void
351 _mesa_set_renderbuffer_attachment(struct gl_context *ctx,
352 struct gl_renderbuffer_attachment *att,
353 struct gl_renderbuffer *rb)
354 {
355 /* XXX check if re-doing same attachment, exit early */
356 _mesa_remove_attachment(ctx, att);
357 att->Type = GL_RENDERBUFFER_EXT;
358 att->Texture = NULL; /* just to be safe */
359 att->Complete = GL_FALSE;
360 _mesa_reference_renderbuffer(&att->Renderbuffer, rb);
361 }
362
363
364 /**
365 * Fallback for ctx->Driver.FramebufferRenderbuffer()
366 * Attach a renderbuffer object to a framebuffer object.
367 */
368 void
369 _mesa_framebuffer_renderbuffer(struct gl_context *ctx,
370 struct gl_framebuffer *fb,
371 GLenum attachment, struct gl_renderbuffer *rb)
372 {
373 struct gl_renderbuffer_attachment *att;
374
375 _glthread_LOCK_MUTEX(fb->Mutex);
376
377 att = _mesa_get_attachment(ctx, fb, attachment);
378 ASSERT(att);
379 if (rb) {
380 _mesa_set_renderbuffer_attachment(ctx, att, rb);
381 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
382 /* do stencil attachment here (depth already done above) */
383 att = _mesa_get_attachment(ctx, fb, GL_STENCIL_ATTACHMENT_EXT);
384 assert(att);
385 _mesa_set_renderbuffer_attachment(ctx, att, rb);
386 }
387 rb->AttachedAnytime = GL_TRUE;
388 }
389 else {
390 _mesa_remove_attachment(ctx, att);
391 }
392
393 invalidate_framebuffer(fb);
394
395 _glthread_UNLOCK_MUTEX(fb->Mutex);
396 }
397
398
399 /**
400 * Fallback for ctx->Driver.ValidateFramebuffer()
401 * Check if the renderbuffer's formats are supported by the software
402 * renderer.
403 * Drivers should probably override this.
404 */
405 void
406 _mesa_validate_framebuffer(struct gl_context *ctx, struct gl_framebuffer *fb)
407 {
408 gl_buffer_index buf;
409 for (buf = 0; buf < BUFFER_COUNT; buf++) {
410 const struct gl_renderbuffer *rb = fb->Attachment[buf].Renderbuffer;
411 if (rb) {
412 switch (rb->_BaseFormat) {
413 case GL_ALPHA:
414 case GL_LUMINANCE_ALPHA:
415 case GL_LUMINANCE:
416 case GL_INTENSITY:
417 case GL_RED:
418 case GL_RG:
419 fb->_Status = GL_FRAMEBUFFER_UNSUPPORTED;
420 return;
421 default:
422 /* render buffer format is supported by software rendering */
423 ;
424 }
425 }
426 }
427 }
428
429
430 /**
431 * For debug only.
432 */
433 static void
434 att_incomplete(const char *msg)
435 {
436 #if DEBUG_FBO
437 _mesa_debug(NULL, "attachment incomplete: %s\n", msg);
438 #else
439 (void) msg;
440 #endif
441 }
442
443
444 /**
445 * For debug only.
446 */
447 static void
448 fbo_incomplete(const char *msg, int index)
449 {
450 #if DEBUG_FBO
451 _mesa_debug(NULL, "FBO Incomplete: %s [%d]\n", msg, index);
452 #else
453 (void) msg;
454 (void) index;
455 #endif
456 }
457
458
459 /**
460 * Is the given base format a legal format for a color renderbuffer?
461 */
462 GLboolean
463 _mesa_is_legal_color_format(const struct gl_context *ctx, GLenum baseFormat)
464 {
465 switch (baseFormat) {
466 case GL_RGB:
467 case GL_RGBA:
468 return GL_TRUE;
469 case GL_LUMINANCE:
470 case GL_LUMINANCE_ALPHA:
471 case GL_INTENSITY:
472 case GL_ALPHA:
473 return ctx->Extensions.ARB_framebuffer_object;
474 case GL_RED:
475 case GL_RG:
476 return ctx->Extensions.ARB_texture_rg;
477 default:
478 return GL_FALSE;
479 }
480 }
481
482
483 /**
484 * Is the given base format a legal format for a depth/stencil renderbuffer?
485 */
486 static GLboolean
487 is_legal_depth_format(const struct gl_context *ctx, GLenum baseFormat)
488 {
489 switch (baseFormat) {
490 case GL_DEPTH_COMPONENT:
491 case GL_DEPTH_STENCIL_EXT:
492 return GL_TRUE;
493 default:
494 return GL_FALSE;
495 }
496 }
497
498
499 /**
500 * Test if an attachment point is complete and update its Complete field.
501 * \param format if GL_COLOR, this is a color attachment point,
502 * if GL_DEPTH, this is a depth component attachment point,
503 * if GL_STENCIL, this is a stencil component attachment point.
504 */
505 static void
506 test_attachment_completeness(const struct gl_context *ctx, GLenum format,
507 struct gl_renderbuffer_attachment *att)
508 {
509 assert(format == GL_COLOR || format == GL_DEPTH || format == GL_STENCIL);
510
511 /* assume complete */
512 att->Complete = GL_TRUE;
513
514 /* Look for reasons why the attachment might be incomplete */
515 if (att->Type == GL_TEXTURE) {
516 const struct gl_texture_object *texObj = att->Texture;
517 struct gl_texture_image *texImage;
518 GLenum baseFormat;
519
520 if (!texObj) {
521 att_incomplete("no texobj");
522 att->Complete = GL_FALSE;
523 return;
524 }
525
526 texImage = texObj->Image[att->CubeMapFace][att->TextureLevel];
527 if (!texImage) {
528 att_incomplete("no teximage");
529 att->Complete = GL_FALSE;
530 return;
531 }
532 if (texImage->Width < 1 || texImage->Height < 1) {
533 att_incomplete("teximage width/height=0");
534 printf("texobj = %u\n", texObj->Name);
535 printf("level = %d\n", att->TextureLevel);
536 att->Complete = GL_FALSE;
537 return;
538 }
539 if (texObj->Target == GL_TEXTURE_3D && att->Zoffset >= texImage->Depth) {
540 att_incomplete("bad z offset");
541 att->Complete = GL_FALSE;
542 return;
543 }
544
545 baseFormat = _mesa_get_format_base_format(texImage->TexFormat);
546
547 if (format == GL_COLOR) {
548 if (!_mesa_is_legal_color_format(ctx, baseFormat)) {
549 att_incomplete("bad format");
550 att->Complete = GL_FALSE;
551 return;
552 }
553 if (_mesa_is_format_compressed(texImage->TexFormat)) {
554 att_incomplete("compressed internalformat");
555 att->Complete = GL_FALSE;
556 return;
557 }
558 }
559 else if (format == GL_DEPTH) {
560 if (baseFormat == GL_DEPTH_COMPONENT) {
561 /* OK */
562 }
563 else if (ctx->Extensions.EXT_packed_depth_stencil &&
564 ctx->Extensions.ARB_depth_texture &&
565 baseFormat == GL_DEPTH_STENCIL_EXT) {
566 /* OK */
567 }
568 else {
569 att->Complete = GL_FALSE;
570 att_incomplete("bad depth format");
571 return;
572 }
573 }
574 else {
575 ASSERT(format == GL_STENCIL);
576 if (ctx->Extensions.EXT_packed_depth_stencil &&
577 ctx->Extensions.ARB_depth_texture &&
578 baseFormat == GL_DEPTH_STENCIL_EXT) {
579 /* OK */
580 }
581 else {
582 /* no such thing as stencil-only textures */
583 att_incomplete("illegal stencil texture");
584 att->Complete = GL_FALSE;
585 return;
586 }
587 }
588 }
589 else if (att->Type == GL_RENDERBUFFER_EXT) {
590 const GLenum baseFormat =
591 _mesa_get_format_base_format(att->Renderbuffer->Format);
592
593 ASSERT(att->Renderbuffer);
594 if (!att->Renderbuffer->InternalFormat ||
595 att->Renderbuffer->Width < 1 ||
596 att->Renderbuffer->Height < 1) {
597 att_incomplete("0x0 renderbuffer");
598 att->Complete = GL_FALSE;
599 return;
600 }
601 if (format == GL_COLOR) {
602 if (!_mesa_is_legal_color_format(ctx, baseFormat)) {
603 att_incomplete("bad renderbuffer color format");
604 att->Complete = GL_FALSE;
605 return;
606 }
607 }
608 else if (format == GL_DEPTH) {
609 if (baseFormat == GL_DEPTH_COMPONENT) {
610 /* OK */
611 }
612 else if (ctx->Extensions.EXT_packed_depth_stencil &&
613 baseFormat == GL_DEPTH_STENCIL_EXT) {
614 /* OK */
615 }
616 else {
617 att_incomplete("bad renderbuffer depth format");
618 att->Complete = GL_FALSE;
619 return;
620 }
621 }
622 else {
623 assert(format == GL_STENCIL);
624 if (baseFormat == GL_STENCIL_INDEX) {
625 /* OK */
626 }
627 else if (ctx->Extensions.EXT_packed_depth_stencil &&
628 baseFormat == GL_DEPTH_STENCIL_EXT) {
629 /* OK */
630 }
631 else {
632 att->Complete = GL_FALSE;
633 att_incomplete("bad renderbuffer stencil format");
634 return;
635 }
636 }
637 }
638 else {
639 ASSERT(att->Type == GL_NONE);
640 /* complete */
641 return;
642 }
643 }
644
645
646 /**
647 * Test if the given framebuffer object is complete and update its
648 * Status field with the results.
649 * Calls the ctx->Driver.ValidateFramebuffer() function to allow the
650 * driver to make hardware-specific validation/completeness checks.
651 * Also update the framebuffer's Width and Height fields if the
652 * framebuffer is complete.
653 */
654 void
655 _mesa_test_framebuffer_completeness(struct gl_context *ctx,
656 struct gl_framebuffer *fb)
657 {
658 GLuint numImages;
659 GLenum intFormat = GL_NONE; /* color buffers' internal format */
660 GLuint minWidth = ~0, minHeight = ~0, maxWidth = 0, maxHeight = 0;
661 GLint numSamples = -1;
662 GLint i;
663 GLuint j;
664
665 assert(fb->Name != 0);
666
667 numImages = 0;
668 fb->Width = 0;
669 fb->Height = 0;
670
671 /* Start at -2 to more easily loop over all attachment points.
672 * -2: depth buffer
673 * -1: stencil buffer
674 * >=0: color buffer
675 */
676 for (i = -2; i < (GLint) ctx->Const.MaxColorAttachments; i++) {
677 struct gl_renderbuffer_attachment *att;
678 GLenum f;
679 gl_format attFormat;
680
681 /*
682 * XXX for ARB_fbo, only check color buffers that are named by
683 * GL_READ_BUFFER and GL_DRAW_BUFFERi.
684 */
685
686 /* check for attachment completeness
687 */
688 if (i == -2) {
689 att = &fb->Attachment[BUFFER_DEPTH];
690 test_attachment_completeness(ctx, GL_DEPTH, att);
691 if (!att->Complete) {
692 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
693 fbo_incomplete("depth attachment incomplete", -1);
694 return;
695 }
696 }
697 else if (i == -1) {
698 att = &fb->Attachment[BUFFER_STENCIL];
699 test_attachment_completeness(ctx, GL_STENCIL, att);
700 if (!att->Complete) {
701 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
702 fbo_incomplete("stencil attachment incomplete", -1);
703 return;
704 }
705 }
706 else {
707 att = &fb->Attachment[BUFFER_COLOR0 + i];
708 test_attachment_completeness(ctx, GL_COLOR, att);
709 if (!att->Complete) {
710 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_EXT;
711 fbo_incomplete("color attachment incomplete", i);
712 return;
713 }
714 }
715
716 /* get width, height, format of the renderbuffer/texture
717 */
718 if (att->Type == GL_TEXTURE) {
719 const struct gl_texture_image *texImg =
720 _mesa_get_attachment_teximage(att);
721 minWidth = MIN2(minWidth, texImg->Width);
722 maxWidth = MAX2(maxWidth, texImg->Width);
723 minHeight = MIN2(minHeight, texImg->Height);
724 maxHeight = MAX2(maxHeight, texImg->Height);
725 f = texImg->_BaseFormat;
726 attFormat = texImg->TexFormat;
727 numImages++;
728 if (!_mesa_is_legal_color_format(ctx, f) &&
729 !is_legal_depth_format(ctx, f)) {
730 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
731 fbo_incomplete("texture attachment incomplete", -1);
732 return;
733 }
734 }
735 else if (att->Type == GL_RENDERBUFFER_EXT) {
736 minWidth = MIN2(minWidth, att->Renderbuffer->Width);
737 maxWidth = MAX2(minWidth, att->Renderbuffer->Width);
738 minHeight = MIN2(minHeight, att->Renderbuffer->Height);
739 maxHeight = MAX2(minHeight, att->Renderbuffer->Height);
740 f = att->Renderbuffer->InternalFormat;
741 attFormat = att->Renderbuffer->Format;
742 numImages++;
743 }
744 else {
745 assert(att->Type == GL_NONE);
746 continue;
747 }
748
749 if (att->Renderbuffer && numSamples < 0) {
750 /* first buffer */
751 numSamples = att->Renderbuffer->NumSamples;
752 }
753
754 /* check if integer color */
755 fb->_IntegerColor = _mesa_is_format_integer_color(attFormat);
756
757 /* Error-check width, height, format, samples
758 */
759 if (numImages == 1) {
760 /* save format, num samples */
761 if (i >= 0) {
762 intFormat = f;
763 }
764 }
765 else {
766 if (!ctx->Extensions.ARB_framebuffer_object) {
767 /* check that width, height, format are same */
768 if (minWidth != maxWidth || minHeight != maxHeight) {
769 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_EXT;
770 fbo_incomplete("width or height mismatch", -1);
771 return;
772 }
773 /* check that all color buffer have same format */
774 if (intFormat != GL_NONE && f != intFormat) {
775 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_FORMATS_EXT;
776 fbo_incomplete("format mismatch", -1);
777 return;
778 }
779 }
780 if (att->Renderbuffer &&
781 att->Renderbuffer->NumSamples != numSamples) {
782 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE;
783 fbo_incomplete("inconsistant number of samples", i);
784 return;
785 }
786
787 }
788 }
789
790 #if FEATURE_GL
791 if (ctx->API == API_OPENGL) {
792 /* Check that all DrawBuffers are present */
793 for (j = 0; j < ctx->Const.MaxDrawBuffers; j++) {
794 if (fb->ColorDrawBuffer[j] != GL_NONE) {
795 const struct gl_renderbuffer_attachment *att
796 = _mesa_get_attachment(ctx, fb, fb->ColorDrawBuffer[j]);
797 assert(att);
798 if (att->Type == GL_NONE) {
799 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_EXT;
800 fbo_incomplete("missing drawbuffer", j);
801 return;
802 }
803 }
804 }
805
806 /* Check that the ReadBuffer is present */
807 if (fb->ColorReadBuffer != GL_NONE) {
808 const struct gl_renderbuffer_attachment *att
809 = _mesa_get_attachment(ctx, fb, fb->ColorReadBuffer);
810 assert(att);
811 if (att->Type == GL_NONE) {
812 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_EXT;
813 fbo_incomplete("missing readbuffer", -1);
814 return;
815 }
816 }
817 }
818 #else
819 (void) j;
820 #endif
821
822 if (numImages == 0) {
823 fb->_Status = GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_EXT;
824 fbo_incomplete("no attachments", -1);
825 return;
826 }
827
828 /* Provisionally set status = COMPLETE ... */
829 fb->_Status = GL_FRAMEBUFFER_COMPLETE_EXT;
830
831 /* ... but the driver may say the FB is incomplete.
832 * Drivers will most likely set the status to GL_FRAMEBUFFER_UNSUPPORTED
833 * if anything.
834 */
835 if (ctx->Driver.ValidateFramebuffer) {
836 ctx->Driver.ValidateFramebuffer(ctx, fb);
837 if (fb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
838 fbo_incomplete("driver marked FBO as incomplete", -1);
839 }
840 }
841
842 if (fb->_Status == GL_FRAMEBUFFER_COMPLETE_EXT) {
843 /*
844 * Note that if ARB_framebuffer_object is supported and the attached
845 * renderbuffers/textures are different sizes, the framebuffer
846 * width/height will be set to the smallest width/height.
847 */
848 fb->Width = minWidth;
849 fb->Height = minHeight;
850
851 /* finally, update the visual info for the framebuffer */
852 _mesa_update_framebuffer_visual(ctx, fb);
853 }
854 }
855
856
857 GLboolean GLAPIENTRY
858 _mesa_IsRenderbufferEXT(GLuint renderbuffer)
859 {
860 GET_CURRENT_CONTEXT(ctx);
861 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
862 if (renderbuffer) {
863 struct gl_renderbuffer *rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
864 if (rb != NULL && rb != &DummyRenderbuffer)
865 return GL_TRUE;
866 }
867 return GL_FALSE;
868 }
869
870
871 void GLAPIENTRY
872 _mesa_BindRenderbufferEXT(GLenum target, GLuint renderbuffer)
873 {
874 struct gl_renderbuffer *newRb;
875 GET_CURRENT_CONTEXT(ctx);
876
877 ASSERT_OUTSIDE_BEGIN_END(ctx);
878
879 if (target != GL_RENDERBUFFER_EXT) {
880 _mesa_error(ctx, GL_INVALID_ENUM, "glBindRenderbufferEXT(target)");
881 return;
882 }
883
884 /* No need to flush here since the render buffer binding has no
885 * effect on rendering state.
886 */
887
888 if (renderbuffer) {
889 newRb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
890 if (newRb == &DummyRenderbuffer) {
891 /* ID was reserved, but no real renderbuffer object made yet */
892 newRb = NULL;
893 }
894 else if (!newRb && ctx->Extensions.ARB_framebuffer_object) {
895 /* All RB IDs must be Gen'd */
896 _mesa_error(ctx, GL_INVALID_OPERATION, "glBindRenderbuffer(buffer)");
897 return;
898 }
899
900 if (!newRb) {
901 /* create new renderbuffer object */
902 newRb = ctx->Driver.NewRenderbuffer(ctx, renderbuffer);
903 if (!newRb) {
904 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindRenderbufferEXT");
905 return;
906 }
907 ASSERT(newRb->AllocStorage);
908 _mesa_HashInsert(ctx->Shared->RenderBuffers, renderbuffer, newRb);
909 newRb->RefCount = 1; /* referenced by hash table */
910 }
911 }
912 else {
913 newRb = NULL;
914 }
915
916 ASSERT(newRb != &DummyRenderbuffer);
917
918 _mesa_reference_renderbuffer(&ctx->CurrentRenderbuffer, newRb);
919 }
920
921
922 /**
923 * If the given renderbuffer is anywhere attached to the framebuffer, detach
924 * the renderbuffer.
925 * This is used when a renderbuffer object is deleted.
926 * The spec calls for unbinding.
927 */
928 static void
929 detach_renderbuffer(struct gl_context *ctx,
930 struct gl_framebuffer *fb,
931 struct gl_renderbuffer *rb)
932 {
933 GLuint i;
934 for (i = 0; i < BUFFER_COUNT; i++) {
935 if (fb->Attachment[i].Renderbuffer == rb) {
936 _mesa_remove_attachment(ctx, &fb->Attachment[i]);
937 }
938 }
939 invalidate_framebuffer(fb);
940 }
941
942
943 void GLAPIENTRY
944 _mesa_DeleteRenderbuffersEXT(GLsizei n, const GLuint *renderbuffers)
945 {
946 GLint i;
947 GET_CURRENT_CONTEXT(ctx);
948
949 ASSERT_OUTSIDE_BEGIN_END(ctx);
950 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
951
952 for (i = 0; i < n; i++) {
953 if (renderbuffers[i] > 0) {
954 struct gl_renderbuffer *rb;
955 rb = _mesa_lookup_renderbuffer(ctx, renderbuffers[i]);
956 if (rb) {
957 /* check if deleting currently bound renderbuffer object */
958 if (rb == ctx->CurrentRenderbuffer) {
959 /* bind default */
960 ASSERT(rb->RefCount >= 2);
961 _mesa_BindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0);
962 }
963
964 if (ctx->DrawBuffer->Name) {
965 detach_renderbuffer(ctx, ctx->DrawBuffer, rb);
966 }
967 if (ctx->ReadBuffer->Name && ctx->ReadBuffer != ctx->DrawBuffer) {
968 detach_renderbuffer(ctx, ctx->ReadBuffer, rb);
969 }
970
971 /* Remove from hash table immediately, to free the ID.
972 * But the object will not be freed until it's no longer
973 * referenced anywhere else.
974 */
975 _mesa_HashRemove(ctx->Shared->RenderBuffers, renderbuffers[i]);
976
977 if (rb != &DummyRenderbuffer) {
978 /* no longer referenced by hash table */
979 _mesa_reference_renderbuffer(&rb, NULL);
980 }
981 }
982 }
983 }
984 }
985
986
987 void GLAPIENTRY
988 _mesa_GenRenderbuffersEXT(GLsizei n, GLuint *renderbuffers)
989 {
990 GET_CURRENT_CONTEXT(ctx);
991 GLuint first;
992 GLint i;
993
994 ASSERT_OUTSIDE_BEGIN_END(ctx);
995
996 if (n < 0) {
997 _mesa_error(ctx, GL_INVALID_VALUE, "glGenRenderbuffersEXT(n)");
998 return;
999 }
1000
1001 if (!renderbuffers)
1002 return;
1003
1004 first = _mesa_HashFindFreeKeyBlock(ctx->Shared->RenderBuffers, n);
1005
1006 for (i = 0; i < n; i++) {
1007 GLuint name = first + i;
1008 renderbuffers[i] = name;
1009 /* insert dummy placeholder into hash table */
1010 _glthread_LOCK_MUTEX(ctx->Shared->Mutex);
1011 _mesa_HashInsert(ctx->Shared->RenderBuffers, name, &DummyRenderbuffer);
1012 _glthread_UNLOCK_MUTEX(ctx->Shared->Mutex);
1013 }
1014 }
1015
1016
1017 /**
1018 * Given an internal format token for a render buffer, return the
1019 * corresponding base format (one of GL_RGB, GL_RGBA, GL_STENCIL_INDEX,
1020 * GL_DEPTH_COMPONENT, GL_DEPTH_STENCIL_EXT, GL_ALPHA, GL_LUMINANCE,
1021 * GL_LUMINANCE_ALPHA, GL_INTENSITY, etc).
1022 *
1023 * This is similar to _mesa_base_tex_format() but the set of valid
1024 * internal formats is different.
1025 *
1026 * Note that even if a format is determined to be legal here, validation
1027 * of the FBO may fail if the format is not supported by the driver/GPU.
1028 *
1029 * \param internalFormat as passed to glRenderbufferStorage()
1030 * \return the base internal format, or 0 if internalFormat is illegal
1031 */
1032 GLenum
1033 _mesa_base_fbo_format(struct gl_context *ctx, GLenum internalFormat)
1034 {
1035 /*
1036 * Notes: some formats such as alpha, luminance, etc. were added
1037 * with GL_ARB_framebuffer_object.
1038 */
1039 switch (internalFormat) {
1040 case GL_ALPHA:
1041 case GL_ALPHA4:
1042 case GL_ALPHA8:
1043 case GL_ALPHA12:
1044 case GL_ALPHA16:
1045 return ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
1046 case GL_LUMINANCE:
1047 case GL_LUMINANCE4:
1048 case GL_LUMINANCE8:
1049 case GL_LUMINANCE12:
1050 case GL_LUMINANCE16:
1051 return ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
1052 case GL_LUMINANCE_ALPHA:
1053 case GL_LUMINANCE4_ALPHA4:
1054 case GL_LUMINANCE6_ALPHA2:
1055 case GL_LUMINANCE8_ALPHA8:
1056 case GL_LUMINANCE12_ALPHA4:
1057 case GL_LUMINANCE12_ALPHA12:
1058 case GL_LUMINANCE16_ALPHA16:
1059 return ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
1060 case GL_INTENSITY:
1061 case GL_INTENSITY4:
1062 case GL_INTENSITY8:
1063 case GL_INTENSITY12:
1064 case GL_INTENSITY16:
1065 return ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
1066 case GL_RGB:
1067 case GL_R3_G3_B2:
1068 case GL_RGB4:
1069 case GL_RGB5:
1070 case GL_RGB8:
1071 case GL_RGB10:
1072 case GL_RGB12:
1073 case GL_RGB16:
1074 case GL_SRGB8_EXT:
1075 return GL_RGB;
1076 case GL_RGBA:
1077 case GL_RGBA2:
1078 case GL_RGBA4:
1079 case GL_RGB5_A1:
1080 case GL_RGBA8:
1081 case GL_RGB10_A2:
1082 case GL_RGBA12:
1083 case GL_RGBA16:
1084 case GL_SRGB8_ALPHA8_EXT:
1085 return GL_RGBA;
1086 case GL_STENCIL_INDEX:
1087 case GL_STENCIL_INDEX1_EXT:
1088 case GL_STENCIL_INDEX4_EXT:
1089 case GL_STENCIL_INDEX8_EXT:
1090 case GL_STENCIL_INDEX16_EXT:
1091 return GL_STENCIL_INDEX;
1092 case GL_DEPTH_COMPONENT:
1093 case GL_DEPTH_COMPONENT16:
1094 case GL_DEPTH_COMPONENT24:
1095 case GL_DEPTH_COMPONENT32:
1096 return GL_DEPTH_COMPONENT;
1097 case GL_DEPTH_STENCIL_EXT:
1098 case GL_DEPTH24_STENCIL8_EXT:
1099 if (ctx->Extensions.EXT_packed_depth_stencil)
1100 return GL_DEPTH_STENCIL_EXT;
1101 else
1102 return 0;
1103 case GL_RED:
1104 case GL_R8:
1105 case GL_R16:
1106 return ctx->Extensions.ARB_texture_rg ? GL_RED : 0;
1107 case GL_RG:
1108 case GL_RG8:
1109 case GL_RG16:
1110 return ctx->Extensions.ARB_texture_rg ? GL_RG : 0;
1111 /* signed normalized texture formats */
1112 case GL_RED_SNORM:
1113 case GL_R8_SNORM:
1114 case GL_R16_SNORM:
1115 return ctx->Extensions.EXT_texture_snorm ? GL_RED : 0;
1116 case GL_RG_SNORM:
1117 case GL_RG8_SNORM:
1118 case GL_RG16_SNORM:
1119 return ctx->Extensions.EXT_texture_snorm ? GL_RG : 0;
1120 case GL_RGB_SNORM:
1121 case GL_RGB8_SNORM:
1122 case GL_RGB16_SNORM:
1123 return ctx->Extensions.EXT_texture_snorm ? GL_RGB : 0;
1124 case GL_RGBA_SNORM:
1125 case GL_RGBA8_SNORM:
1126 case GL_RGBA16_SNORM:
1127 return ctx->Extensions.EXT_texture_snorm ? GL_RGBA : 0;
1128 case GL_ALPHA_SNORM:
1129 case GL_ALPHA8_SNORM:
1130 case GL_ALPHA16_SNORM:
1131 return ctx->Extensions.EXT_texture_snorm &&
1132 ctx->Extensions.ARB_framebuffer_object ? GL_ALPHA : 0;
1133 case GL_LUMINANCE_SNORM:
1134 case GL_LUMINANCE8_SNORM:
1135 case GL_LUMINANCE16_SNORM:
1136 return ctx->Extensions.EXT_texture_snorm &&
1137 ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE : 0;
1138 case GL_LUMINANCE_ALPHA_SNORM:
1139 case GL_LUMINANCE8_ALPHA8_SNORM:
1140 case GL_LUMINANCE16_ALPHA16_SNORM:
1141 return ctx->Extensions.EXT_texture_snorm &&
1142 ctx->Extensions.ARB_framebuffer_object ? GL_LUMINANCE_ALPHA : 0;
1143 case GL_INTENSITY_SNORM:
1144 case GL_INTENSITY8_SNORM:
1145 case GL_INTENSITY16_SNORM:
1146 return ctx->Extensions.EXT_texture_snorm &&
1147 ctx->Extensions.ARB_framebuffer_object ? GL_INTENSITY : 0;
1148 /* XXX add floating point and integer formats eventually */
1149 default:
1150 return 0;
1151 }
1152 }
1153
1154
1155 /**
1156 * Invalidate a renderbuffer attachment. Called from _mesa_HashWalk().
1157 */
1158 static void
1159 invalidate_rb(GLuint key, void *data, void *userData)
1160 {
1161 struct gl_framebuffer *fb = (struct gl_framebuffer *) data;
1162 struct gl_renderbuffer *rb = (struct gl_renderbuffer *) userData;
1163
1164 /* If this is a user-created FBO */
1165 if (fb->Name) {
1166 GLuint i;
1167 for (i = 0; i < BUFFER_COUNT; i++) {
1168 struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1169 if (att->Type == GL_RENDERBUFFER &&
1170 att->Renderbuffer == rb) {
1171 /* Mark fb status as indeterminate to force re-validation */
1172 fb->_Status = 0;
1173 return;
1174 }
1175 }
1176 }
1177 }
1178
1179
1180 /** sentinal value, see below */
1181 #define NO_SAMPLES 1000
1182
1183
1184 /**
1185 * Helper function used by _mesa_RenderbufferStorageEXT() and
1186 * _mesa_RenderbufferStorageMultisample().
1187 * samples will be NO_SAMPLES if called by _mesa_RenderbufferStorageEXT().
1188 */
1189 static void
1190 renderbuffer_storage(GLenum target, GLenum internalFormat,
1191 GLsizei width, GLsizei height, GLsizei samples)
1192 {
1193 const char *func = samples == NO_SAMPLES ?
1194 "glRenderbufferStorage" : "RenderbufferStorageMultisample";
1195 struct gl_renderbuffer *rb;
1196 GLenum baseFormat;
1197 GET_CURRENT_CONTEXT(ctx);
1198
1199 ASSERT_OUTSIDE_BEGIN_END(ctx);
1200
1201 if (target != GL_RENDERBUFFER_EXT) {
1202 _mesa_error(ctx, GL_INVALID_ENUM, "%s(target)", func);
1203 return;
1204 }
1205
1206 baseFormat = _mesa_base_fbo_format(ctx, internalFormat);
1207 if (baseFormat == 0) {
1208 _mesa_error(ctx, GL_INVALID_ENUM, "%s(internalFormat)", func);
1209 return;
1210 }
1211
1212 if (width < 1 || width > (GLsizei) ctx->Const.MaxRenderbufferSize) {
1213 _mesa_error(ctx, GL_INVALID_VALUE, "%s(width)", func);
1214 return;
1215 }
1216
1217 if (height < 1 || height > (GLsizei) ctx->Const.MaxRenderbufferSize) {
1218 _mesa_error(ctx, GL_INVALID_VALUE, "%s(height)", func);
1219 return;
1220 }
1221
1222 if (samples == NO_SAMPLES) {
1223 /* NumSamples == 0 indicates non-multisampling */
1224 samples = 0;
1225 }
1226 else if (samples > (GLsizei) ctx->Const.MaxSamples) {
1227 /* note: driver may choose to use more samples than what's requested */
1228 _mesa_error(ctx, GL_INVALID_VALUE, "%s(samples)", func);
1229 return;
1230 }
1231
1232 rb = ctx->CurrentRenderbuffer;
1233 if (!rb) {
1234 _mesa_error(ctx, GL_INVALID_OPERATION, "%s", func);
1235 return;
1236 }
1237
1238 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1239
1240 if (rb->InternalFormat == internalFormat &&
1241 rb->Width == (GLuint) width &&
1242 rb->Height == (GLuint) height) {
1243 /* no change in allocation needed */
1244 return;
1245 }
1246
1247 /* These MUST get set by the AllocStorage func */
1248 rb->Format = MESA_FORMAT_NONE;
1249 rb->NumSamples = samples;
1250
1251 /* Now allocate the storage */
1252 ASSERT(rb->AllocStorage);
1253 if (rb->AllocStorage(ctx, rb, internalFormat, width, height)) {
1254 /* No error - check/set fields now */
1255 assert(rb->Format != MESA_FORMAT_NONE);
1256 assert(rb->Width == (GLuint) width);
1257 assert(rb->Height == (GLuint) height);
1258 rb->InternalFormat = internalFormat;
1259 rb->_BaseFormat = baseFormat;
1260 assert(rb->_BaseFormat != 0);
1261 }
1262 else {
1263 /* Probably ran out of memory - clear the fields */
1264 rb->Width = 0;
1265 rb->Height = 0;
1266 rb->Format = MESA_FORMAT_NONE;
1267 rb->InternalFormat = GL_NONE;
1268 rb->_BaseFormat = GL_NONE;
1269 rb->NumSamples = 0;
1270 }
1271
1272 /* Invalidate the framebuffers the renderbuffer is attached in. */
1273 if (rb->AttachedAnytime) {
1274 _mesa_HashWalk(ctx->Shared->FrameBuffers, invalidate_rb, rb);
1275 }
1276 }
1277
1278
1279 #if FEATURE_OES_EGL_image
1280 void GLAPIENTRY
1281 _mesa_EGLImageTargetRenderbufferStorageOES(GLenum target, GLeglImageOES image)
1282 {
1283 struct gl_renderbuffer *rb;
1284 GET_CURRENT_CONTEXT(ctx);
1285 ASSERT_OUTSIDE_BEGIN_END(ctx);
1286
1287 if (!ctx->Extensions.OES_EGL_image) {
1288 _mesa_error(ctx, GL_INVALID_OPERATION,
1289 "glEGLImageTargetRenderbufferStorageOES(unsupported)");
1290 return;
1291 }
1292
1293 if (target != GL_RENDERBUFFER) {
1294 _mesa_error(ctx, GL_INVALID_ENUM,
1295 "EGLImageTargetRenderbufferStorageOES");
1296 return;
1297 }
1298
1299 rb = ctx->CurrentRenderbuffer;
1300 if (!rb) {
1301 _mesa_error(ctx, GL_INVALID_OPERATION,
1302 "EGLImageTargetRenderbufferStorageOES");
1303 return;
1304 }
1305
1306 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1307
1308 ctx->Driver.EGLImageTargetRenderbufferStorage(ctx, rb, image);
1309 }
1310 #endif
1311
1312
1313 /**
1314 * Helper function for _mesa_GetRenderbufferParameterivEXT() and
1315 * _mesa_GetFramebufferAttachmentParameterivEXT()
1316 * We have to be careful to respect the base format. For example, if a
1317 * renderbuffer/texture was created with internalFormat=GL_RGB but the
1318 * driver actually chose a GL_RGBA format, when the user queries ALPHA_SIZE
1319 * we need to return zero.
1320 */
1321 static GLint
1322 get_component_bits(GLenum pname, GLenum baseFormat, gl_format format)
1323 {
1324 switch (pname) {
1325 case GL_RENDERBUFFER_RED_SIZE_EXT:
1326 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
1327 if (baseFormat == GL_RGB || baseFormat == GL_RGBA ||
1328 baseFormat == GL_RG || baseFormat == GL_RED)
1329 return _mesa_get_format_bits(format, pname);
1330 else
1331 return 0;
1332 case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1333 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
1334 if (baseFormat == GL_RGB || baseFormat == GL_RGBA || baseFormat == GL_RG)
1335 return _mesa_get_format_bits(format, pname);
1336 else
1337 return 0;
1338 case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1339 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
1340 if (baseFormat == GL_RGB || baseFormat == GL_RGBA)
1341 return _mesa_get_format_bits(format, pname);
1342 else
1343 return 0;
1344 case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1345 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
1346 if (baseFormat == GL_RGBA || baseFormat == GL_ALPHA ||
1347 baseFormat == GL_LUMINANCE_ALPHA)
1348 return _mesa_get_format_bits(format, pname);
1349 else
1350 return 0;
1351 case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1352 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
1353 if (baseFormat == GL_DEPTH_COMPONENT || baseFormat == GL_DEPTH_STENCIL)
1354 return _mesa_get_format_bits(format, pname);
1355 else
1356 return 0;
1357 case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1358 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
1359 if (baseFormat == GL_STENCIL_INDEX || baseFormat == GL_DEPTH_STENCIL)
1360 return _mesa_get_format_bits(format, pname);
1361 else
1362 return 0;
1363 default:
1364 return 0;
1365 }
1366 }
1367
1368
1369
1370 void GLAPIENTRY
1371 _mesa_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
1372 GLsizei width, GLsizei height)
1373 {
1374 /* GL_ARB_fbo says calling this function is equivalent to calling
1375 * glRenderbufferStorageMultisample() with samples=0. We pass in
1376 * a token value here just for error reporting purposes.
1377 */
1378 renderbuffer_storage(target, internalFormat, width, height, NO_SAMPLES);
1379 }
1380
1381
1382 void GLAPIENTRY
1383 _mesa_RenderbufferStorageMultisample(GLenum target, GLsizei samples,
1384 GLenum internalFormat,
1385 GLsizei width, GLsizei height)
1386 {
1387 renderbuffer_storage(target, internalFormat, width, height, samples);
1388 }
1389
1390
1391 /**
1392 * OpenGL ES version of glRenderBufferStorage.
1393 */
1394 void GLAPIENTRY
1395 _es_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
1396 GLsizei width, GLsizei height)
1397 {
1398 switch (internalFormat) {
1399 case GL_RGB565:
1400 /* XXX this confuses GL_RENDERBUFFER_INTERNAL_FORMAT_OES */
1401 /* choose a closest format */
1402 internalFormat = GL_RGB5;
1403 break;
1404 default:
1405 break;
1406 }
1407
1408 renderbuffer_storage(target, internalFormat, width, height, 0);
1409 }
1410
1411
1412 void GLAPIENTRY
1413 _mesa_GetRenderbufferParameterivEXT(GLenum target, GLenum pname, GLint *params)
1414 {
1415 struct gl_renderbuffer *rb;
1416 GET_CURRENT_CONTEXT(ctx);
1417
1418 ASSERT_OUTSIDE_BEGIN_END(ctx);
1419
1420 if (target != GL_RENDERBUFFER_EXT) {
1421 _mesa_error(ctx, GL_INVALID_ENUM,
1422 "glGetRenderbufferParameterivEXT(target)");
1423 return;
1424 }
1425
1426 rb = ctx->CurrentRenderbuffer;
1427 if (!rb) {
1428 _mesa_error(ctx, GL_INVALID_OPERATION,
1429 "glGetRenderbufferParameterivEXT");
1430 return;
1431 }
1432
1433 /* No need to flush here since we're just quering state which is
1434 * not effected by rendering.
1435 */
1436
1437 switch (pname) {
1438 case GL_RENDERBUFFER_WIDTH_EXT:
1439 *params = rb->Width;
1440 return;
1441 case GL_RENDERBUFFER_HEIGHT_EXT:
1442 *params = rb->Height;
1443 return;
1444 case GL_RENDERBUFFER_INTERNAL_FORMAT_EXT:
1445 *params = rb->InternalFormat;
1446 return;
1447 case GL_RENDERBUFFER_RED_SIZE_EXT:
1448 case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1449 case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1450 case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1451 case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1452 case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1453 *params = get_component_bits(pname, rb->_BaseFormat, rb->Format);
1454 break;
1455 case GL_RENDERBUFFER_SAMPLES:
1456 if (ctx->Extensions.ARB_framebuffer_object) {
1457 *params = rb->NumSamples;
1458 break;
1459 }
1460 /* fallthrough */
1461 default:
1462 _mesa_error(ctx, GL_INVALID_ENUM,
1463 "glGetRenderbufferParameterivEXT(target)");
1464 return;
1465 }
1466 }
1467
1468
1469 GLboolean GLAPIENTRY
1470 _mesa_IsFramebufferEXT(GLuint framebuffer)
1471 {
1472 GET_CURRENT_CONTEXT(ctx);
1473 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, GL_FALSE);
1474 if (framebuffer) {
1475 struct gl_framebuffer *rb = _mesa_lookup_framebuffer(ctx, framebuffer);
1476 if (rb != NULL && rb != &DummyFramebuffer)
1477 return GL_TRUE;
1478 }
1479 return GL_FALSE;
1480 }
1481
1482
1483 /**
1484 * Check if any of the attachments of the given framebuffer are textures
1485 * (render to texture). Call ctx->Driver.RenderTexture() for such
1486 * attachments.
1487 */
1488 static void
1489 check_begin_texture_render(struct gl_context *ctx, struct gl_framebuffer *fb)
1490 {
1491 GLuint i;
1492 ASSERT(ctx->Driver.RenderTexture);
1493
1494 if (fb->Name == 0)
1495 return; /* can't render to texture with winsys framebuffers */
1496
1497 for (i = 0; i < BUFFER_COUNT; i++) {
1498 struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1499 if (att->Texture && _mesa_get_attachment_teximage(att)) {
1500 ctx->Driver.RenderTexture(ctx, fb, att);
1501 }
1502 }
1503 }
1504
1505
1506 /**
1507 * Examine all the framebuffer's attachments to see if any are textures.
1508 * If so, call ctx->Driver.FinishRenderTexture() for each texture to
1509 * notify the device driver that the texture image may have changed.
1510 */
1511 static void
1512 check_end_texture_render(struct gl_context *ctx, struct gl_framebuffer *fb)
1513 {
1514 if (fb->Name == 0)
1515 return; /* can't render to texture with winsys framebuffers */
1516
1517 if (ctx->Driver.FinishRenderTexture) {
1518 GLuint i;
1519 for (i = 0; i < BUFFER_COUNT; i++) {
1520 struct gl_renderbuffer_attachment *att = fb->Attachment + i;
1521 if (att->Texture && att->Renderbuffer) {
1522 ctx->Driver.FinishRenderTexture(ctx, att);
1523 }
1524 }
1525 }
1526 }
1527
1528
1529 void GLAPIENTRY
1530 _mesa_BindFramebufferEXT(GLenum target, GLuint framebuffer)
1531 {
1532 struct gl_framebuffer *newDrawFb, *newReadFb;
1533 struct gl_framebuffer *oldDrawFb, *oldReadFb;
1534 GLboolean bindReadBuf, bindDrawBuf;
1535 GET_CURRENT_CONTEXT(ctx);
1536
1537 #ifdef DEBUG
1538 if (ctx->Extensions.ARB_framebuffer_object) {
1539 ASSERT(ctx->Extensions.EXT_framebuffer_object);
1540 ASSERT(ctx->Extensions.EXT_framebuffer_blit);
1541 }
1542 #endif
1543
1544 ASSERT_OUTSIDE_BEGIN_END(ctx);
1545
1546 if (!ctx->Extensions.EXT_framebuffer_object) {
1547 _mesa_error(ctx, GL_INVALID_OPERATION,
1548 "glBindFramebufferEXT(unsupported)");
1549 return;
1550 }
1551
1552 switch (target) {
1553 #if FEATURE_EXT_framebuffer_blit
1554 case GL_DRAW_FRAMEBUFFER_EXT:
1555 if (!ctx->Extensions.EXT_framebuffer_blit) {
1556 _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1557 return;
1558 }
1559 bindDrawBuf = GL_TRUE;
1560 bindReadBuf = GL_FALSE;
1561 break;
1562 case GL_READ_FRAMEBUFFER_EXT:
1563 if (!ctx->Extensions.EXT_framebuffer_blit) {
1564 _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1565 return;
1566 }
1567 bindDrawBuf = GL_FALSE;
1568 bindReadBuf = GL_TRUE;
1569 break;
1570 #endif
1571 case GL_FRAMEBUFFER_EXT:
1572 bindDrawBuf = GL_TRUE;
1573 bindReadBuf = GL_TRUE;
1574 break;
1575 default:
1576 _mesa_error(ctx, GL_INVALID_ENUM, "glBindFramebufferEXT(target)");
1577 return;
1578 }
1579
1580 if (framebuffer) {
1581 /* Binding a user-created framebuffer object */
1582 newDrawFb = _mesa_lookup_framebuffer(ctx, framebuffer);
1583 if (newDrawFb == &DummyFramebuffer) {
1584 /* ID was reserved, but no real framebuffer object made yet */
1585 newDrawFb = NULL;
1586 }
1587 else if (!newDrawFb && ctx->Extensions.ARB_framebuffer_object) {
1588 /* All FBO IDs must be Gen'd */
1589 _mesa_error(ctx, GL_INVALID_OPERATION, "glBindFramebuffer(buffer)");
1590 return;
1591 }
1592
1593 if (!newDrawFb) {
1594 /* create new framebuffer object */
1595 newDrawFb = ctx->Driver.NewFramebuffer(ctx, framebuffer);
1596 if (!newDrawFb) {
1597 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glBindFramebufferEXT");
1598 return;
1599 }
1600 _mesa_HashInsert(ctx->Shared->FrameBuffers, framebuffer, newDrawFb);
1601 }
1602 newReadFb = newDrawFb;
1603 }
1604 else {
1605 /* Binding the window system framebuffer (which was originally set
1606 * with MakeCurrent).
1607 */
1608 newDrawFb = ctx->WinSysDrawBuffer;
1609 newReadFb = ctx->WinSysReadBuffer;
1610 }
1611
1612 ASSERT(newDrawFb);
1613 ASSERT(newDrawFb != &DummyFramebuffer);
1614
1615 /* save pointers to current/old framebuffers */
1616 oldDrawFb = ctx->DrawBuffer;
1617 oldReadFb = ctx->ReadBuffer;
1618
1619 /* check if really changing bindings */
1620 if (oldDrawFb == newDrawFb)
1621 bindDrawBuf = GL_FALSE;
1622 if (oldReadFb == newReadFb)
1623 bindReadBuf = GL_FALSE;
1624
1625 /*
1626 * OK, now bind the new Draw/Read framebuffers, if they're changing.
1627 *
1628 * We also check if we're beginning and/or ending render-to-texture.
1629 * When a framebuffer with texture attachments is unbound, call
1630 * ctx->Driver.FinishRenderTexture().
1631 * When a framebuffer with texture attachments is bound, call
1632 * ctx->Driver.RenderTexture().
1633 *
1634 * Note that if the ReadBuffer has texture attachments we don't consider
1635 * that a render-to-texture case.
1636 */
1637 if (bindReadBuf) {
1638 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1639
1640 /* check if old readbuffer was render-to-texture */
1641 check_end_texture_render(ctx, oldReadFb);
1642
1643 _mesa_reference_framebuffer(&ctx->ReadBuffer, newReadFb);
1644 }
1645
1646 if (bindDrawBuf) {
1647 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1648
1649 /* check if old read/draw buffers were render-to-texture */
1650 if (!bindReadBuf)
1651 check_end_texture_render(ctx, oldReadFb);
1652
1653 if (oldDrawFb != oldReadFb)
1654 check_end_texture_render(ctx, oldDrawFb);
1655
1656 /* check if newly bound framebuffer has any texture attachments */
1657 check_begin_texture_render(ctx, newDrawFb);
1658
1659 _mesa_reference_framebuffer(&ctx->DrawBuffer, newDrawFb);
1660 }
1661
1662 if ((bindDrawBuf || bindReadBuf) && ctx->Driver.BindFramebuffer) {
1663 ctx->Driver.BindFramebuffer(ctx, target, newDrawFb, newReadFb);
1664 }
1665 }
1666
1667
1668 void GLAPIENTRY
1669 _mesa_DeleteFramebuffersEXT(GLsizei n, const GLuint *framebuffers)
1670 {
1671 GLint i;
1672 GET_CURRENT_CONTEXT(ctx);
1673
1674 ASSERT_OUTSIDE_BEGIN_END(ctx);
1675 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1676
1677 for (i = 0; i < n; i++) {
1678 if (framebuffers[i] > 0) {
1679 struct gl_framebuffer *fb;
1680 fb = _mesa_lookup_framebuffer(ctx, framebuffers[i]);
1681 if (fb) {
1682 ASSERT(fb == &DummyFramebuffer || fb->Name == framebuffers[i]);
1683
1684 /* check if deleting currently bound framebuffer object */
1685 if (ctx->Extensions.EXT_framebuffer_blit) {
1686 /* separate draw/read binding points */
1687 if (fb == ctx->DrawBuffer) {
1688 /* bind default */
1689 ASSERT(fb->RefCount >= 2);
1690 _mesa_BindFramebufferEXT(GL_DRAW_FRAMEBUFFER_EXT, 0);
1691 }
1692 if (fb == ctx->ReadBuffer) {
1693 /* bind default */
1694 ASSERT(fb->RefCount >= 2);
1695 _mesa_BindFramebufferEXT(GL_READ_FRAMEBUFFER_EXT, 0);
1696 }
1697 }
1698 else {
1699 /* only one binding point for read/draw buffers */
1700 if (fb == ctx->DrawBuffer || fb == ctx->ReadBuffer) {
1701 /* bind default */
1702 ASSERT(fb->RefCount >= 2);
1703 _mesa_BindFramebufferEXT(GL_FRAMEBUFFER_EXT, 0);
1704 }
1705 }
1706
1707 /* remove from hash table immediately, to free the ID */
1708 _mesa_HashRemove(ctx->Shared->FrameBuffers, framebuffers[i]);
1709
1710 if (fb != &DummyFramebuffer) {
1711 /* But the object will not be freed until it's no longer
1712 * bound in any context.
1713 */
1714 _mesa_reference_framebuffer(&fb, NULL);
1715 }
1716 }
1717 }
1718 }
1719 }
1720
1721
1722 void GLAPIENTRY
1723 _mesa_GenFramebuffersEXT(GLsizei n, GLuint *framebuffers)
1724 {
1725 GET_CURRENT_CONTEXT(ctx);
1726 GLuint first;
1727 GLint i;
1728
1729 ASSERT_OUTSIDE_BEGIN_END(ctx);
1730
1731 if (n < 0) {
1732 _mesa_error(ctx, GL_INVALID_VALUE, "glGenFramebuffersEXT(n)");
1733 return;
1734 }
1735
1736 if (!framebuffers)
1737 return;
1738
1739 first = _mesa_HashFindFreeKeyBlock(ctx->Shared->FrameBuffers, n);
1740
1741 for (i = 0; i < n; i++) {
1742 GLuint name = first + i;
1743 framebuffers[i] = name;
1744 /* insert dummy placeholder into hash table */
1745 _glthread_LOCK_MUTEX(ctx->Shared->Mutex);
1746 _mesa_HashInsert(ctx->Shared->FrameBuffers, name, &DummyFramebuffer);
1747 _glthread_UNLOCK_MUTEX(ctx->Shared->Mutex);
1748 }
1749 }
1750
1751
1752
1753 GLenum GLAPIENTRY
1754 _mesa_CheckFramebufferStatusEXT(GLenum target)
1755 {
1756 struct gl_framebuffer *buffer;
1757 GET_CURRENT_CONTEXT(ctx);
1758
1759 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx, 0);
1760
1761 buffer = get_framebuffer_target(ctx, target);
1762 if (!buffer) {
1763 _mesa_error(ctx, GL_INVALID_ENUM, "glCheckFramebufferStatus(target)");
1764 return 0;
1765 }
1766
1767 if (buffer->Name == 0) {
1768 /* The window system / default framebuffer is always complete */
1769 return GL_FRAMEBUFFER_COMPLETE_EXT;
1770 }
1771
1772 /* No need to flush here */
1773
1774 if (buffer->_Status != GL_FRAMEBUFFER_COMPLETE) {
1775 _mesa_test_framebuffer_completeness(ctx, buffer);
1776 }
1777
1778 return buffer->_Status;
1779 }
1780
1781
1782
1783 /**
1784 * Common code called by glFramebufferTexture1D/2D/3DEXT().
1785 */
1786 static void
1787 framebuffer_texture(struct gl_context *ctx, const char *caller, GLenum target,
1788 GLenum attachment, GLenum textarget, GLuint texture,
1789 GLint level, GLint zoffset)
1790 {
1791 struct gl_renderbuffer_attachment *att;
1792 struct gl_texture_object *texObj = NULL;
1793 struct gl_framebuffer *fb;
1794
1795 ASSERT_OUTSIDE_BEGIN_END(ctx);
1796
1797 fb = get_framebuffer_target(ctx, target);
1798 if (!fb) {
1799 _mesa_error(ctx, GL_INVALID_ENUM,
1800 "glFramebufferTexture%sEXT(target=0x%x)", caller, target);
1801 return;
1802 }
1803
1804 /* check framebuffer binding */
1805 if (fb->Name == 0) {
1806 _mesa_error(ctx, GL_INVALID_OPERATION,
1807 "glFramebufferTexture%sEXT", caller);
1808 return;
1809 }
1810
1811
1812 /* The textarget, level, and zoffset parameters are only validated if
1813 * texture is non-zero.
1814 */
1815 if (texture) {
1816 GLboolean err = GL_TRUE;
1817
1818 texObj = _mesa_lookup_texture(ctx, texture);
1819 if (texObj != NULL) {
1820 if (textarget == 0) {
1821 /* XXX what's the purpose of this? */
1822 err = (texObj->Target != GL_TEXTURE_3D) &&
1823 (texObj->Target != GL_TEXTURE_1D_ARRAY_EXT) &&
1824 (texObj->Target != GL_TEXTURE_2D_ARRAY_EXT);
1825 }
1826 else {
1827 err = (texObj->Target == GL_TEXTURE_CUBE_MAP)
1828 ? !IS_CUBE_FACE(textarget)
1829 : (texObj->Target != textarget);
1830 }
1831 }
1832 else {
1833 /* can't render to a non-existant texture */
1834 _mesa_error(ctx, GL_INVALID_OPERATION,
1835 "glFramebufferTexture%sEXT(non existant texture)",
1836 caller);
1837 return;
1838 }
1839
1840 if (err) {
1841 _mesa_error(ctx, GL_INVALID_OPERATION,
1842 "glFramebufferTexture%sEXT(texture target mismatch)",
1843 caller);
1844 return;
1845 }
1846
1847 if (texObj->Target == GL_TEXTURE_3D) {
1848 const GLint maxSize = 1 << (ctx->Const.Max3DTextureLevels - 1);
1849 if (zoffset < 0 || zoffset >= maxSize) {
1850 _mesa_error(ctx, GL_INVALID_VALUE,
1851 "glFramebufferTexture%sEXT(zoffset)", caller);
1852 return;
1853 }
1854 }
1855 else if ((texObj->Target == GL_TEXTURE_1D_ARRAY_EXT) ||
1856 (texObj->Target == GL_TEXTURE_2D_ARRAY_EXT)) {
1857 if (zoffset < 0 || zoffset >= ctx->Const.MaxArrayTextureLayers) {
1858 _mesa_error(ctx, GL_INVALID_VALUE,
1859 "glFramebufferTexture%sEXT(layer)", caller);
1860 return;
1861 }
1862 }
1863
1864 if ((level < 0) ||
1865 (level >= _mesa_max_texture_levels(ctx, texObj->Target))) {
1866 _mesa_error(ctx, GL_INVALID_VALUE,
1867 "glFramebufferTexture%sEXT(level)", caller);
1868 return;
1869 }
1870 }
1871
1872 att = _mesa_get_attachment(ctx, fb, attachment);
1873 if (att == NULL) {
1874 _mesa_error(ctx, GL_INVALID_ENUM,
1875 "glFramebufferTexture%sEXT(attachment)", caller);
1876 return;
1877 }
1878
1879 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
1880
1881 _glthread_LOCK_MUTEX(fb->Mutex);
1882 if (texObj) {
1883 _mesa_set_texture_attachment(ctx, fb, att, texObj, textarget,
1884 level, zoffset);
1885 /* Set the render-to-texture flag. We'll check this flag in
1886 * glTexImage() and friends to determine if we need to revalidate
1887 * any FBOs that might be rendering into this texture.
1888 * This flag never gets cleared since it's non-trivial to determine
1889 * when all FBOs might be done rendering to this texture. That's OK
1890 * though since it's uncommon to render to a texture then repeatedly
1891 * call glTexImage() to change images in the texture.
1892 */
1893 texObj->_RenderToTexture = GL_TRUE;
1894 }
1895 else {
1896 _mesa_remove_attachment(ctx, att);
1897 }
1898
1899 invalidate_framebuffer(fb);
1900
1901 _glthread_UNLOCK_MUTEX(fb->Mutex);
1902 }
1903
1904
1905
1906 void GLAPIENTRY
1907 _mesa_FramebufferTexture1DEXT(GLenum target, GLenum attachment,
1908 GLenum textarget, GLuint texture, GLint level)
1909 {
1910 GET_CURRENT_CONTEXT(ctx);
1911
1912 if ((texture != 0) && (textarget != GL_TEXTURE_1D)) {
1913 _mesa_error(ctx, GL_INVALID_ENUM,
1914 "glFramebufferTexture1DEXT(textarget)");
1915 return;
1916 }
1917
1918 framebuffer_texture(ctx, "1D", target, attachment, textarget, texture,
1919 level, 0);
1920 }
1921
1922
1923 void GLAPIENTRY
1924 _mesa_FramebufferTexture2DEXT(GLenum target, GLenum attachment,
1925 GLenum textarget, GLuint texture, GLint level)
1926 {
1927 GET_CURRENT_CONTEXT(ctx);
1928
1929 if ((texture != 0) &&
1930 (textarget != GL_TEXTURE_2D) &&
1931 (textarget != GL_TEXTURE_RECTANGLE_ARB) &&
1932 (!IS_CUBE_FACE(textarget))) {
1933 _mesa_error(ctx, GL_INVALID_OPERATION,
1934 "glFramebufferTexture2DEXT(textarget=0x%x)", textarget);
1935 return;
1936 }
1937
1938 framebuffer_texture(ctx, "2D", target, attachment, textarget, texture,
1939 level, 0);
1940 }
1941
1942
1943 void GLAPIENTRY
1944 _mesa_FramebufferTexture3DEXT(GLenum target, GLenum attachment,
1945 GLenum textarget, GLuint texture,
1946 GLint level, GLint zoffset)
1947 {
1948 GET_CURRENT_CONTEXT(ctx);
1949
1950 if ((texture != 0) && (textarget != GL_TEXTURE_3D)) {
1951 _mesa_error(ctx, GL_INVALID_ENUM,
1952 "glFramebufferTexture3DEXT(textarget)");
1953 return;
1954 }
1955
1956 framebuffer_texture(ctx, "3D", target, attachment, textarget, texture,
1957 level, zoffset);
1958 }
1959
1960
1961 void GLAPIENTRY
1962 _mesa_FramebufferTextureLayerEXT(GLenum target, GLenum attachment,
1963 GLuint texture, GLint level, GLint layer)
1964 {
1965 GET_CURRENT_CONTEXT(ctx);
1966
1967 framebuffer_texture(ctx, "Layer", target, attachment, 0, texture,
1968 level, layer);
1969 }
1970
1971
1972 void GLAPIENTRY
1973 _mesa_FramebufferRenderbufferEXT(GLenum target, GLenum attachment,
1974 GLenum renderbufferTarget,
1975 GLuint renderbuffer)
1976 {
1977 struct gl_renderbuffer_attachment *att;
1978 struct gl_framebuffer *fb;
1979 struct gl_renderbuffer *rb;
1980 GET_CURRENT_CONTEXT(ctx);
1981
1982 ASSERT_OUTSIDE_BEGIN_END(ctx);
1983
1984 fb = get_framebuffer_target(ctx, target);
1985 if (!fb) {
1986 _mesa_error(ctx, GL_INVALID_ENUM, "glFramebufferRenderbufferEXT(target)");
1987 return;
1988 }
1989
1990 if (renderbufferTarget != GL_RENDERBUFFER_EXT) {
1991 _mesa_error(ctx, GL_INVALID_ENUM,
1992 "glFramebufferRenderbufferEXT(renderbufferTarget)");
1993 return;
1994 }
1995
1996 if (fb->Name == 0) {
1997 /* Can't attach new renderbuffers to a window system framebuffer */
1998 _mesa_error(ctx, GL_INVALID_OPERATION, "glFramebufferRenderbufferEXT");
1999 return;
2000 }
2001
2002 att = _mesa_get_attachment(ctx, fb, attachment);
2003 if (att == NULL) {
2004 _mesa_error(ctx, GL_INVALID_ENUM,
2005 "glFramebufferRenderbufferEXT(invalid attachment %s)",
2006 _mesa_lookup_enum_by_nr(attachment));
2007 return;
2008 }
2009
2010 if (renderbuffer) {
2011 rb = _mesa_lookup_renderbuffer(ctx, renderbuffer);
2012 if (!rb) {
2013 _mesa_error(ctx, GL_INVALID_OPERATION,
2014 "glFramebufferRenderbufferEXT(non-existant"
2015 " renderbuffer %u)", renderbuffer);
2016 return;
2017 }
2018 else if (rb == &DummyRenderbuffer) {
2019 /* This is what NVIDIA does */
2020 _mesa_error(ctx, GL_INVALID_VALUE,
2021 "glFramebufferRenderbufferEXT(renderbuffer %u)",
2022 renderbuffer);
2023 return;
2024 }
2025 }
2026 else {
2027 /* remove renderbuffer attachment */
2028 rb = NULL;
2029 }
2030
2031 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT &&
2032 rb && rb->Format != MESA_FORMAT_NONE) {
2033 /* make sure the renderbuffer is a depth/stencil format */
2034 const GLenum baseFormat = _mesa_get_format_base_format(rb->Format);
2035 if (baseFormat != GL_DEPTH_STENCIL) {
2036 _mesa_error(ctx, GL_INVALID_OPERATION,
2037 "glFramebufferRenderbufferEXT(renderbuffer"
2038 " is not DEPTH_STENCIL format)");
2039 return;
2040 }
2041 }
2042
2043
2044 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2045
2046 assert(ctx->Driver.FramebufferRenderbuffer);
2047 ctx->Driver.FramebufferRenderbuffer(ctx, fb, attachment, rb);
2048
2049 /* Some subsequent GL commands may depend on the framebuffer's visual
2050 * after the binding is updated. Update visual info now.
2051 */
2052 _mesa_update_framebuffer_visual(ctx, fb);
2053 }
2054
2055
2056 void GLAPIENTRY
2057 _mesa_GetFramebufferAttachmentParameterivEXT(GLenum target, GLenum attachment,
2058 GLenum pname, GLint *params)
2059 {
2060 const struct gl_renderbuffer_attachment *att;
2061 struct gl_framebuffer *buffer;
2062 GET_CURRENT_CONTEXT(ctx);
2063
2064 ASSERT_OUTSIDE_BEGIN_END(ctx);
2065
2066 buffer = get_framebuffer_target(ctx, target);
2067 if (!buffer) {
2068 _mesa_error(ctx, GL_INVALID_ENUM,
2069 "glGetFramebufferAttachmentParameterivEXT(target)");
2070 return;
2071 }
2072
2073 if (buffer->Name == 0) {
2074 /* the default / window-system FBO */
2075 att = _mesa_get_fb0_attachment(ctx, buffer, attachment);
2076 }
2077 else {
2078 /* user-created framebuffer FBO */
2079 att = _mesa_get_attachment(ctx, buffer, attachment);
2080 }
2081
2082 if (att == NULL) {
2083 _mesa_error(ctx, GL_INVALID_ENUM,
2084 "glGetFramebufferAttachmentParameterivEXT(attachment)");
2085 return;
2086 }
2087
2088 if (attachment == GL_DEPTH_STENCIL_ATTACHMENT) {
2089 /* the depth and stencil attachments must point to the same buffer */
2090 const struct gl_renderbuffer_attachment *depthAtt, *stencilAtt;
2091 depthAtt = _mesa_get_attachment(ctx, buffer, GL_DEPTH_ATTACHMENT);
2092 stencilAtt = _mesa_get_attachment(ctx, buffer, GL_STENCIL_ATTACHMENT);
2093 if (depthAtt->Renderbuffer != stencilAtt->Renderbuffer) {
2094 _mesa_error(ctx, GL_INVALID_OPERATION,
2095 "glGetFramebufferAttachmentParameterivEXT(DEPTH/STENCIL"
2096 " attachments differ)");
2097 return;
2098 }
2099 }
2100
2101 /* No need to flush here */
2102
2103 switch (pname) {
2104 case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_EXT:
2105 *params = buffer->Name == 0 ? GL_FRAMEBUFFER_DEFAULT : att->Type;
2106 return;
2107 case GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_EXT:
2108 if (att->Type == GL_RENDERBUFFER_EXT) {
2109 *params = att->Renderbuffer->Name;
2110 }
2111 else if (att->Type == GL_TEXTURE) {
2112 *params = att->Texture->Name;
2113 }
2114 else {
2115 assert(att->Type == GL_NONE);
2116 *params = 0;
2117 }
2118 return;
2119 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_EXT:
2120 if (att->Type == GL_TEXTURE) {
2121 *params = att->TextureLevel;
2122 }
2123 else {
2124 _mesa_error(ctx, GL_INVALID_ENUM,
2125 "glGetFramebufferAttachmentParameterivEXT(pname)");
2126 }
2127 return;
2128 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_EXT:
2129 if (att->Type == GL_TEXTURE) {
2130 if (att->Texture && att->Texture->Target == GL_TEXTURE_CUBE_MAP) {
2131 *params = GL_TEXTURE_CUBE_MAP_POSITIVE_X + att->CubeMapFace;
2132 }
2133 else {
2134 *params = 0;
2135 }
2136 }
2137 else {
2138 _mesa_error(ctx, GL_INVALID_ENUM,
2139 "glGetFramebufferAttachmentParameterivEXT(pname)");
2140 }
2141 return;
2142 case GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_3D_ZOFFSET_EXT:
2143 if (att->Type == GL_TEXTURE) {
2144 if (att->Texture && att->Texture->Target == GL_TEXTURE_3D) {
2145 *params = att->Zoffset;
2146 }
2147 else {
2148 *params = 0;
2149 }
2150 }
2151 else {
2152 _mesa_error(ctx, GL_INVALID_ENUM,
2153 "glGetFramebufferAttachmentParameterivEXT(pname)");
2154 }
2155 return;
2156 case GL_FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING:
2157 if (!ctx->Extensions.ARB_framebuffer_object) {
2158 _mesa_error(ctx, GL_INVALID_ENUM,
2159 "glGetFramebufferAttachmentParameterivEXT(pname)");
2160 }
2161 else {
2162 if (ctx->Extensions.EXT_framebuffer_sRGB && ctx->Const.sRGBCapable) {
2163 *params = _mesa_get_format_color_encoding(att->Renderbuffer->Format);
2164 }
2165 else {
2166 /* According to ARB_framebuffer_sRGB, we should return LINEAR
2167 * if the sRGB conversion is unsupported. */
2168 *params = GL_LINEAR;
2169 }
2170 }
2171 return;
2172 case GL_FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE:
2173 if (!ctx->Extensions.ARB_framebuffer_object) {
2174 _mesa_error(ctx, GL_INVALID_ENUM,
2175 "glGetFramebufferAttachmentParameterivEXT(pname)");
2176 return;
2177 }
2178 else {
2179 gl_format format = att->Renderbuffer->Format;
2180 if (format == MESA_FORMAT_CI8 || format == MESA_FORMAT_S8) {
2181 /* special cases */
2182 *params = GL_INDEX;
2183 }
2184 else {
2185 *params = _mesa_get_format_datatype(format);
2186 }
2187 }
2188 return;
2189 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
2190 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
2191 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
2192 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
2193 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
2194 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
2195 if (!ctx->Extensions.ARB_framebuffer_object) {
2196 _mesa_error(ctx, GL_INVALID_ENUM,
2197 "glGetFramebufferAttachmentParameterivEXT(pname)");
2198 }
2199 else if (att->Texture) {
2200 const struct gl_texture_image *texImage =
2201 _mesa_select_tex_image(ctx, att->Texture, att->Texture->Target,
2202 att->TextureLevel);
2203 if (texImage) {
2204 *params = get_component_bits(pname, texImage->_BaseFormat,
2205 texImage->TexFormat);
2206 }
2207 else {
2208 *params = 0;
2209 }
2210 }
2211 else if (att->Renderbuffer) {
2212 *params = get_component_bits(pname, att->Renderbuffer->_BaseFormat,
2213 att->Renderbuffer->Format);
2214 }
2215 else {
2216 *params = 0;
2217 }
2218 return;
2219 default:
2220 _mesa_error(ctx, GL_INVALID_ENUM,
2221 "glGetFramebufferAttachmentParameterivEXT(pname)");
2222 return;
2223 }
2224 }
2225
2226
2227 void GLAPIENTRY
2228 _mesa_GenerateMipmapEXT(GLenum target)
2229 {
2230 struct gl_texture_object *texObj;
2231 GET_CURRENT_CONTEXT(ctx);
2232
2233 ASSERT_OUTSIDE_BEGIN_END(ctx);
2234 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2235
2236 switch (target) {
2237 case GL_TEXTURE_1D:
2238 case GL_TEXTURE_2D:
2239 case GL_TEXTURE_3D:
2240 case GL_TEXTURE_CUBE_MAP:
2241 /* OK, legal value */
2242 break;
2243 default:
2244 /* XXX need to implement GL_TEXTURE_1D_ARRAY and GL_TEXTURE_2D_ARRAY */
2245 _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateMipmapEXT(target)");
2246 return;
2247 }
2248
2249 texObj = _mesa_get_current_tex_object(ctx, target);
2250
2251 if (texObj->BaseLevel >= texObj->MaxLevel) {
2252 /* nothing to do */
2253 return;
2254 }
2255
2256 if (texObj->Target == GL_TEXTURE_CUBE_MAP &&
2257 !_mesa_cube_complete(texObj)) {
2258 _mesa_error(ctx, GL_INVALID_OPERATION,
2259 "glGenerateMipmap(incomplete cube map)");
2260 return;
2261 }
2262
2263 _mesa_lock_texture(ctx, texObj);
2264 if (target == GL_TEXTURE_CUBE_MAP) {
2265 GLuint face;
2266 for (face = 0; face < 6; face++)
2267 ctx->Driver.GenerateMipmap(ctx,
2268 GL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB + face,
2269 texObj);
2270 }
2271 else {
2272 ctx->Driver.GenerateMipmap(ctx, target, texObj);
2273 }
2274 _mesa_unlock_texture(ctx, texObj);
2275 }
2276
2277
2278 #if FEATURE_EXT_framebuffer_blit
2279
2280 static const struct gl_renderbuffer_attachment *
2281 find_attachment(const struct gl_framebuffer *fb,
2282 const struct gl_renderbuffer *rb)
2283 {
2284 GLuint i;
2285 for (i = 0; i < Elements(fb->Attachment); i++) {
2286 if (fb->Attachment[i].Renderbuffer == rb)
2287 return &fb->Attachment[i];
2288 }
2289 return NULL;
2290 }
2291
2292
2293
2294 /**
2295 * Blit rectangular region, optionally from one framebuffer to another.
2296 *
2297 * Note, if the src buffer is multisampled and the dest is not, this is
2298 * when the samples must be resolved to a single color.
2299 */
2300 void GLAPIENTRY
2301 _mesa_BlitFramebufferEXT(GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
2302 GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
2303 GLbitfield mask, GLenum filter)
2304 {
2305 const GLbitfield legalMaskBits = (GL_COLOR_BUFFER_BIT |
2306 GL_DEPTH_BUFFER_BIT |
2307 GL_STENCIL_BUFFER_BIT);
2308 const struct gl_framebuffer *readFb, *drawFb;
2309 const struct gl_renderbuffer *colorReadRb, *colorDrawRb;
2310 GET_CURRENT_CONTEXT(ctx);
2311
2312 ASSERT_OUTSIDE_BEGIN_END(ctx);
2313 FLUSH_VERTICES(ctx, _NEW_BUFFERS);
2314
2315 if (MESA_VERBOSE & VERBOSE_API)
2316 _mesa_debug(ctx,
2317 "glBlitFramebuffer(%d, %d, %d, %d, %d, %d, %d, %d, 0x%x, %s)\n",
2318 srcX0, srcY0, srcX1, srcY1,
2319 dstX0, dstY0, dstX1, dstY1,
2320 mask, _mesa_lookup_enum_by_nr(filter));
2321
2322 if (ctx->NewState) {
2323 _mesa_update_state(ctx);
2324 }
2325
2326 readFb = ctx->ReadBuffer;
2327 drawFb = ctx->DrawBuffer;
2328
2329 if (!readFb || !drawFb) {
2330 /* This will normally never happen but someday we may want to
2331 * support MakeCurrent() with no drawables.
2332 */
2333 return;
2334 }
2335
2336 /* check for complete framebuffers */
2337 if (drawFb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT ||
2338 readFb->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
2339 _mesa_error(ctx, GL_INVALID_FRAMEBUFFER_OPERATION_EXT,
2340 "glBlitFramebufferEXT(incomplete draw/read buffers)");
2341 return;
2342 }
2343
2344 if (filter != GL_NEAREST && filter != GL_LINEAR) {
2345 _mesa_error(ctx, GL_INVALID_ENUM, "glBlitFramebufferEXT(filter)");
2346 return;
2347 }
2348
2349 if (mask & ~legalMaskBits) {
2350 _mesa_error( ctx, GL_INVALID_VALUE, "glBlitFramebufferEXT(mask)");
2351 return;
2352 }
2353
2354 /* depth/stencil must be blitted with nearest filtering */
2355 if ((mask & (GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT))
2356 && filter != GL_NEAREST) {
2357 _mesa_error(ctx, GL_INVALID_OPERATION,
2358 "glBlitFramebufferEXT(depth/stencil requires GL_NEAREST filter)");
2359 return;
2360 }
2361
2362 /* get color read/draw renderbuffers */
2363 if (mask & GL_COLOR_BUFFER_BIT) {
2364 colorReadRb = readFb->_ColorReadBuffer;
2365 colorDrawRb = drawFb->_ColorDrawBuffers[0];
2366 }
2367 else {
2368 colorReadRb = colorDrawRb = NULL;
2369 }
2370
2371 if (mask & GL_STENCIL_BUFFER_BIT) {
2372 struct gl_renderbuffer *readRb = readFb->_StencilBuffer;
2373 struct gl_renderbuffer *drawRb = drawFb->_StencilBuffer;
2374 if (!readRb ||
2375 !drawRb ||
2376 _mesa_get_format_bits(readRb->Format, GL_STENCIL_BITS) !=
2377 _mesa_get_format_bits(drawRb->Format, GL_STENCIL_BITS)) {
2378 _mesa_error(ctx, GL_INVALID_OPERATION,
2379 "glBlitFramebufferEXT(stencil buffer size mismatch)");
2380 return;
2381 }
2382 }
2383
2384 if (mask & GL_DEPTH_BUFFER_BIT) {
2385 struct gl_renderbuffer *readRb = readFb->_DepthBuffer;
2386 struct gl_renderbuffer *drawRb = drawFb->_DepthBuffer;
2387 if (!readRb ||
2388 !drawRb ||
2389 _mesa_get_format_bits(readRb->Format, GL_DEPTH_BITS) !=
2390 _mesa_get_format_bits(drawRb->Format, GL_DEPTH_BITS)) {
2391 _mesa_error(ctx, GL_INVALID_OPERATION,
2392 "glBlitFramebufferEXT(depth buffer size mismatch)");
2393 return;
2394 }
2395 }
2396
2397 if (readFb->Visual.samples > 0 &&
2398 drawFb->Visual.samples > 0 &&
2399 readFb->Visual.samples != drawFb->Visual.samples) {
2400 _mesa_error(ctx, GL_INVALID_OPERATION,
2401 "glBlitFramebufferEXT(mismatched samples");
2402 return;
2403 }
2404
2405 /* extra checks for multisample copies... */
2406 if (readFb->Visual.samples > 0 || drawFb->Visual.samples > 0) {
2407 /* src and dest region sizes must be the same */
2408 if (srcX1 - srcX0 != dstX1 - dstX0 ||
2409 srcY1 - srcY0 != dstY1 - dstY0) {
2410 _mesa_error(ctx, GL_INVALID_OPERATION,
2411 "glBlitFramebufferEXT(bad src/dst multisample region sizes)");
2412 return;
2413 }
2414
2415 /* color formats must match */
2416 if (colorReadRb &&
2417 colorDrawRb &&
2418 colorReadRb->Format != colorDrawRb->Format) {
2419 _mesa_error(ctx, GL_INVALID_OPERATION,
2420 "glBlitFramebufferEXT(bad src/dst multisample pixel formats)");
2421 return;
2422 }
2423 }
2424
2425 if (!ctx->Extensions.EXT_framebuffer_blit) {
2426 _mesa_error(ctx, GL_INVALID_OPERATION, "glBlitFramebufferEXT");
2427 return;
2428 }
2429
2430 /* Debug code */
2431 if (DEBUG_BLIT) {
2432 printf("glBlitFramebuffer(%d, %d, %d, %d, %d, %d, %d, %d,"
2433 " 0x%x, 0x%x)\n",
2434 srcX0, srcY0, srcX1, srcY1,
2435 dstX0, dstY0, dstX1, dstY1,
2436 mask, filter);
2437 if (colorReadRb) {
2438 const struct gl_renderbuffer_attachment *att;
2439
2440 att = find_attachment(readFb, colorReadRb);
2441 printf(" Src FBO %u RB %u (%dx%d) ",
2442 readFb->Name, colorReadRb->Name,
2443 colorReadRb->Width, colorReadRb->Height);
2444 if (att && att->Texture) {
2445 printf("Tex %u tgt 0x%x level %u face %u",
2446 att->Texture->Name,
2447 att->Texture->Target,
2448 att->TextureLevel,
2449 att->CubeMapFace);
2450 }
2451 printf("\n");
2452
2453 att = find_attachment(drawFb, colorDrawRb);
2454 printf(" Dst FBO %u RB %u (%dx%d) ",
2455 drawFb->Name, colorDrawRb->Name,
2456 colorDrawRb->Width, colorDrawRb->Height);
2457 if (att && att->Texture) {
2458 printf("Tex %u tgt 0x%x level %u face %u",
2459 att->Texture->Name,
2460 att->Texture->Target,
2461 att->TextureLevel,
2462 att->CubeMapFace);
2463 }
2464 printf("\n");
2465 }
2466 }
2467
2468 ASSERT(ctx->Driver.BlitFramebuffer);
2469 ctx->Driver.BlitFramebuffer(ctx,
2470 srcX0, srcY0, srcX1, srcY1,
2471 dstX0, dstY0, dstX1, dstY1,
2472 mask, filter);
2473 }
2474 #endif /* FEATURE_EXT_framebuffer_blit */
2475
2476 #if FEATURE_ARB_geometry_shader4
2477 void GLAPIENTRY
2478 _mesa_FramebufferTextureARB(GLenum target, GLenum attachment,
2479 GLuint texture, GLint level)
2480 {
2481 GET_CURRENT_CONTEXT(ctx);
2482 _mesa_error(ctx, GL_INVALID_OPERATION,
2483 "glFramebufferTextureARB "
2484 "not implemented!");
2485 }
2486
2487 void GLAPIENTRY
2488 _mesa_FramebufferTextureFaceARB(GLenum target, GLenum attachment,
2489 GLuint texture, GLint level, GLenum face)
2490 {
2491 GET_CURRENT_CONTEXT(ctx);
2492 _mesa_error(ctx, GL_INVALID_OPERATION,
2493 "glFramebufferTextureFaceARB "
2494 "not implemented!");
2495 }
2496 #endif /* FEATURE_ARB_geometry_shader4 */