projects / mesa.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
mesa: Add color renderable/texture filterable format info for ES 3.x.
[mesa.git] / src / mesa / main / glformats.c
1 /*
2 * Mesa 3-D graphics library
3 *
4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
5 * Copyright (c) 2008-2009 VMware, Inc.
6 * Copyright (c) 2012 Intel Corporation
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 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
22 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
23 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
24 * OTHER DEALINGS IN THE SOFTWARE.
25 */
26
27
28 #include "context.h"
29 #include "glformats.h"
30 #include "formats.h"
31 #include "texcompress.h"
32 #include "enums.h"
33
34 enum {
35 ZERO = 4,
36 ONE = 5
37 };
38
39 enum {
40 IDX_LUMINANCE = 0,
41 IDX_ALPHA,
42 IDX_INTENSITY,
43 IDX_LUMINANCE_ALPHA,
44 IDX_RGB,
45 IDX_RGBA,
46 IDX_RED,
47 IDX_GREEN,
48 IDX_BLUE,
49 IDX_BGR,
50 IDX_BGRA,
51 IDX_ABGR,
52 IDX_RG,
53 MAX_IDX
54 };
55
56 #define MAP1(x) MAP4(x, ZERO, ZERO, ZERO)
57 #define MAP2(x,y) MAP4(x, y, ZERO, ZERO)
58 #define MAP3(x,y,z) MAP4(x, y, z, ZERO)
59 #define MAP4(x,y,z,w) { x, y, z, w, ZERO, ONE }
60
61 static const struct {
62 GLubyte format_idx;
63 GLubyte to_rgba[6];
64 GLubyte from_rgba[6];
65 } mappings[MAX_IDX] =
66 {
67 {
68 IDX_LUMINANCE,
69 MAP4(0,0,0,ONE),
70 MAP1(0)
71 },
72
73 {
74 IDX_ALPHA,
75 MAP4(ZERO, ZERO, ZERO, 0),
76 MAP1(3)
77 },
78
79 {
80 IDX_INTENSITY,
81 MAP4(0, 0, 0, 0),
82 MAP1(0),
83 },
84
85 {
86 IDX_LUMINANCE_ALPHA,
87 MAP4(0,0,0,1),
88 MAP2(0,3)
89 },
90
91 {
92 IDX_RGB,
93 MAP4(0,1,2,ONE),
94 MAP3(0,1,2)
95 },
96
97 {
98 IDX_RGBA,
99 MAP4(0,1,2,3),
100 MAP4(0,1,2,3),
101 },
102
103 {
104 IDX_RED,
105 MAP4(0, ZERO, ZERO, ONE),
106 MAP1(0),
107 },
108
109 {
110 IDX_GREEN,
111 MAP4(ZERO, 0, ZERO, ONE),
112 MAP1(1),
113 },
114
115 {
116 IDX_BLUE,
117 MAP4(ZERO, ZERO, 0, ONE),
118 MAP1(2),
119 },
120
121 {
122 IDX_BGR,
123 MAP4(2,1,0,ONE),
124 MAP3(2,1,0)
125 },
126
127 {
128 IDX_BGRA,
129 MAP4(2,1,0,3),
130 MAP4(2,1,0,3)
131 },
132
133 {
134 IDX_ABGR,
135 MAP4(3,2,1,0),
136 MAP4(3,2,1,0)
137 },
138
139 {
140 IDX_RG,
141 MAP4(0, 1, ZERO, ONE),
142 MAP2(0, 1)
143 },
144 };
145
146 /**
147 * Convert a GL image format enum to an IDX_* value (see above).
148 */
149 static int
150 get_map_idx(GLenum value)
151 {
152 switch (value) {
153 case GL_LUMINANCE:
154 case GL_LUMINANCE_INTEGER_EXT:
155 return IDX_LUMINANCE;
156 case GL_ALPHA:
157 case GL_ALPHA_INTEGER:
158 return IDX_ALPHA;
159 case GL_INTENSITY:
160 return IDX_INTENSITY;
161 case GL_LUMINANCE_ALPHA:
162 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
163 return IDX_LUMINANCE_ALPHA;
164 case GL_RGB:
165 case GL_RGB_INTEGER:
166 return IDX_RGB;
167 case GL_RGBA:
168 case GL_RGBA_INTEGER:
169 return IDX_RGBA;
170 case GL_RED:
171 case GL_RED_INTEGER:
172 return IDX_RED;
173 case GL_GREEN:
174 return IDX_GREEN;
175 case GL_BLUE:
176 return IDX_BLUE;
177 case GL_BGR:
178 case GL_BGR_INTEGER:
179 return IDX_BGR;
180 case GL_BGRA:
181 case GL_BGRA_INTEGER:
182 return IDX_BGRA;
183 case GL_ABGR_EXT:
184 return IDX_ABGR;
185 case GL_RG:
186 case GL_RG_INTEGER:
187 return IDX_RG;
188 default:
189 _mesa_problem(NULL, "Unexpected inFormat %s",
190 _mesa_enum_to_string(value));
191 return 0;
192 }
193 }
194
195 /**
196 * When promoting texture formats (see below) we need to compute the
197 * mapping of dest components back to source components.
198 * This function does that.
199 * \param inFormat the incoming format of the texture
200 * \param outFormat the final texture format
201 * \return map[6] a full 6-component map
202 */
203 void
204 _mesa_compute_component_mapping(GLenum inFormat, GLenum outFormat, GLubyte *map)
205 {
206 const int inFmt = get_map_idx(inFormat);
207 const int outFmt = get_map_idx(outFormat);
208 const GLubyte *in2rgba = mappings[inFmt].to_rgba;
209 const GLubyte *rgba2out = mappings[outFmt].from_rgba;
210 int i;
211
212 for (i = 0; i < 4; i++)
213 map[i] = in2rgba[rgba2out[i]];
214
215 map[ZERO] = ZERO;
216 map[ONE] = ONE;
217
218 #if 0
219 printf("from %x/%s to %x/%s map %d %d %d %d %d %d\n",
220 inFormat, _mesa_enum_to_string(inFormat),
221 outFormat, _mesa_enum_to_string(outFormat),
222 map[0],
223 map[1],
224 map[2],
225 map[3],
226 map[4],
227 map[5]);
228 #endif
229 }
230
231 /**
232 * \return GL_TRUE if type is packed pixel type, GL_FALSE otherwise.
233 */
234 GLboolean
235 _mesa_type_is_packed(GLenum type)
236 {
237 switch (type) {
238 case GL_UNSIGNED_BYTE_3_3_2:
239 case GL_UNSIGNED_BYTE_2_3_3_REV:
240 case MESA_UNSIGNED_BYTE_4_4:
241 case GL_UNSIGNED_SHORT_5_6_5:
242 case GL_UNSIGNED_SHORT_5_6_5_REV:
243 case GL_UNSIGNED_SHORT_4_4_4_4:
244 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
245 case GL_UNSIGNED_SHORT_5_5_5_1:
246 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
247 case GL_UNSIGNED_INT_8_8_8_8:
248 case GL_UNSIGNED_INT_8_8_8_8_REV:
249 case GL_UNSIGNED_INT_10_10_10_2:
250 case GL_UNSIGNED_INT_2_10_10_10_REV:
251 case GL_UNSIGNED_SHORT_8_8_MESA:
252 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
253 case GL_UNSIGNED_INT_24_8_EXT:
254 case GL_UNSIGNED_INT_5_9_9_9_REV:
255 case GL_UNSIGNED_INT_10F_11F_11F_REV:
256 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
257 return GL_TRUE;
258 }
259
260 return GL_FALSE;
261 }
262
263
264 /**
265 * Get the size of a GL data type.
266 *
267 * \param type GL data type.
268 *
269 * \return the size, in bytes, of the given data type, 0 if a GL_BITMAP, or -1
270 * if an invalid type enum.
271 */
272 GLint
273 _mesa_sizeof_type(GLenum type)
274 {
275 switch (type) {
276 case GL_BITMAP:
277 return 0;
278 case GL_UNSIGNED_BYTE:
279 return sizeof(GLubyte);
280 case GL_BYTE:
281 return sizeof(GLbyte);
282 case GL_UNSIGNED_SHORT:
283 return sizeof(GLushort);
284 case GL_SHORT:
285 return sizeof(GLshort);
286 case GL_UNSIGNED_INT:
287 return sizeof(GLuint);
288 case GL_INT:
289 return sizeof(GLint);
290 case GL_FLOAT:
291 return sizeof(GLfloat);
292 case GL_DOUBLE:
293 return sizeof(GLdouble);
294 case GL_HALF_FLOAT_ARB:
295 case GL_HALF_FLOAT_OES:
296 return sizeof(GLhalfARB);
297 case GL_FIXED:
298 return sizeof(GLfixed);
299 default:
300 return -1;
301 }
302 }
303
304
305 /**
306 * Same as _mesa_sizeof_type() but also accepting the packed pixel
307 * format data types.
308 */
309 GLint
310 _mesa_sizeof_packed_type(GLenum type)
311 {
312 switch (type) {
313 case GL_BITMAP:
314 return 0;
315 case GL_UNSIGNED_BYTE:
316 return sizeof(GLubyte);
317 case GL_BYTE:
318 return sizeof(GLbyte);
319 case GL_UNSIGNED_SHORT:
320 return sizeof(GLushort);
321 case GL_SHORT:
322 return sizeof(GLshort);
323 case GL_UNSIGNED_INT:
324 return sizeof(GLuint);
325 case GL_INT:
326 return sizeof(GLint);
327 case GL_HALF_FLOAT_ARB:
328 case GL_HALF_FLOAT_OES:
329 return sizeof(GLhalfARB);
330 case GL_FLOAT:
331 return sizeof(GLfloat);
332 case GL_UNSIGNED_BYTE_3_3_2:
333 case GL_UNSIGNED_BYTE_2_3_3_REV:
334 case MESA_UNSIGNED_BYTE_4_4:
335 return sizeof(GLubyte);
336 case GL_UNSIGNED_SHORT_5_6_5:
337 case GL_UNSIGNED_SHORT_5_6_5_REV:
338 case GL_UNSIGNED_SHORT_4_4_4_4:
339 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
340 case GL_UNSIGNED_SHORT_5_5_5_1:
341 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
342 case GL_UNSIGNED_SHORT_8_8_MESA:
343 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
344 return sizeof(GLushort);
345 case GL_UNSIGNED_INT_8_8_8_8:
346 case GL_UNSIGNED_INT_8_8_8_8_REV:
347 case GL_UNSIGNED_INT_10_10_10_2:
348 case GL_UNSIGNED_INT_2_10_10_10_REV:
349 case GL_UNSIGNED_INT_24_8_EXT:
350 case GL_UNSIGNED_INT_5_9_9_9_REV:
351 case GL_UNSIGNED_INT_10F_11F_11F_REV:
352 return sizeof(GLuint);
353 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
354 return 8;
355 default:
356 return -1;
357 }
358 }
359
360
361 /**
362 * Get the number of components in a pixel format.
363 *
364 * \param format pixel format.
365 *
366 * \return the number of components in the given format, or -1 if a bad format.
367 */
368 GLint
369 _mesa_components_in_format(GLenum format)
370 {
371 switch (format) {
372 case GL_COLOR_INDEX:
373 case GL_STENCIL_INDEX:
374 case GL_DEPTH_COMPONENT:
375 case GL_RED:
376 case GL_RED_INTEGER_EXT:
377 case GL_GREEN:
378 case GL_GREEN_INTEGER_EXT:
379 case GL_BLUE:
380 case GL_BLUE_INTEGER_EXT:
381 case GL_ALPHA:
382 case GL_ALPHA_INTEGER_EXT:
383 case GL_LUMINANCE:
384 case GL_LUMINANCE_INTEGER_EXT:
385 case GL_INTENSITY:
386 return 1;
387
388 case GL_LUMINANCE_ALPHA:
389 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
390 case GL_RG:
391 case GL_YCBCR_MESA:
392 case GL_DEPTH_STENCIL_EXT:
393 case GL_RG_INTEGER:
394 return 2;
395
396 case GL_RGB:
397 case GL_BGR:
398 case GL_RGB_INTEGER_EXT:
399 case GL_BGR_INTEGER_EXT:
400 return 3;
401
402 case GL_RGBA:
403 case GL_BGRA:
404 case GL_ABGR_EXT:
405 case GL_RGBA_INTEGER_EXT:
406 case GL_BGRA_INTEGER_EXT:
407 return 4;
408
409 default:
410 return -1;
411 }
412 }
413
414
415 /**
416 * Get the bytes per pixel of pixel format type pair.
417 *
418 * \param format pixel format.
419 * \param type pixel type.
420 *
421 * \return bytes per pixel, or -1 if a bad format or type was given.
422 */
423 GLint
424 _mesa_bytes_per_pixel(GLenum format, GLenum type)
425 {
426 GLint comps = _mesa_components_in_format(format);
427 if (comps < 0)
428 return -1;
429
430 switch (type) {
431 case GL_BITMAP:
432 return 0; /* special case */
433 case GL_BYTE:
434 case GL_UNSIGNED_BYTE:
435 return comps * sizeof(GLubyte);
436 case GL_SHORT:
437 case GL_UNSIGNED_SHORT:
438 return comps * sizeof(GLshort);
439 case GL_INT:
440 case GL_UNSIGNED_INT:
441 return comps * sizeof(GLint);
442 case GL_FLOAT:
443 return comps * sizeof(GLfloat);
444 case GL_HALF_FLOAT_ARB:
445 case GL_HALF_FLOAT_OES:
446 return comps * sizeof(GLhalfARB);
447 case GL_UNSIGNED_BYTE_3_3_2:
448 case GL_UNSIGNED_BYTE_2_3_3_REV:
449 if (format == GL_RGB || format == GL_BGR ||
450 format == GL_RGB_INTEGER_EXT || format == GL_BGR_INTEGER_EXT)
451 return sizeof(GLubyte);
452 else
453 return -1; /* error */
454 case GL_UNSIGNED_SHORT_5_6_5:
455 case GL_UNSIGNED_SHORT_5_6_5_REV:
456 if (format == GL_RGB || format == GL_BGR ||
457 format == GL_RGB_INTEGER_EXT || format == GL_BGR_INTEGER_EXT)
458 return sizeof(GLushort);
459 else
460 return -1; /* error */
461 case GL_UNSIGNED_SHORT_4_4_4_4:
462 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
463 if (format == GL_RGBA || format == GL_BGRA || format == GL_ABGR_EXT ||
464 format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT)
465 return sizeof(GLushort);
466 else
467 return -1;
468 case GL_UNSIGNED_SHORT_5_5_5_1:
469 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
470 if (format == GL_RGBA || format == GL_BGRA ||
471 format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT)
472 return sizeof(GLushort);
473 else
474 return -1;
475 case GL_UNSIGNED_INT_8_8_8_8:
476 case GL_UNSIGNED_INT_8_8_8_8_REV:
477 if (format == GL_RGBA || format == GL_BGRA || format == GL_ABGR_EXT ||
478 format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT ||
479 format == GL_RGB)
480 return sizeof(GLuint);
481 else
482 return -1;
483 case GL_UNSIGNED_INT_10_10_10_2:
484 case GL_UNSIGNED_INT_2_10_10_10_REV:
485 if (format == GL_RGBA || format == GL_BGRA ||
486 format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT ||
487 format == GL_RGB)
488 return sizeof(GLuint);
489 else
490 return -1;
491 case GL_UNSIGNED_SHORT_8_8_MESA:
492 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
493 if (format == GL_YCBCR_MESA)
494 return sizeof(GLushort);
495 else
496 return -1;
497 case GL_UNSIGNED_INT_24_8_EXT:
498 if (format == GL_DEPTH_COMPONENT ||
499 format == GL_DEPTH_STENCIL_EXT)
500 return sizeof(GLuint);
501 else
502 return -1;
503 case GL_UNSIGNED_INT_5_9_9_9_REV:
504 if (format == GL_RGB)
505 return sizeof(GLuint);
506 else
507 return -1;
508 case GL_UNSIGNED_INT_10F_11F_11F_REV:
509 if (format == GL_RGB)
510 return sizeof(GLuint);
511 else
512 return -1;
513 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
514 if (format == GL_DEPTH_STENCIL)
515 return 8;
516 else
517 return -1;
518 default:
519 return -1;
520 }
521 }
522
523
524 /**
525 * Get the number of bytes for a vertex attrib with the given number of
526 * components and type.
527 *
528 * \param comps number of components.
529 * \param type data type.
530 *
531 * \return bytes per attribute, or -1 if a bad comps/type combination was given.
532 */
533 GLint
534 _mesa_bytes_per_vertex_attrib(GLint comps, GLenum type)
535 {
536 switch (type) {
537 case GL_BYTE:
538 case GL_UNSIGNED_BYTE:
539 return comps * sizeof(GLubyte);
540 case GL_SHORT:
541 case GL_UNSIGNED_SHORT:
542 return comps * sizeof(GLshort);
543 case GL_INT:
544 case GL_UNSIGNED_INT:
545 return comps * sizeof(GLint);
546 case GL_FLOAT:
547 return comps * sizeof(GLfloat);
548 case GL_HALF_FLOAT_ARB:
549 return comps * sizeof(GLhalfARB);
550 case GL_DOUBLE:
551 return comps * sizeof(GLdouble);
552 case GL_FIXED:
553 return comps * sizeof(GLfixed);
554 case GL_INT_2_10_10_10_REV:
555 case GL_UNSIGNED_INT_2_10_10_10_REV:
556 if (comps == 4)
557 return sizeof(GLuint);
558 else
559 return -1;
560 case GL_UNSIGNED_INT_10F_11F_11F_REV:
561 if (comps == 3)
562 return sizeof(GLuint);
563 else
564 return -1;
565 default:
566 return -1;
567 }
568 }
569
570 /**
571 * Test if the given format is unsized.
572 */
573 GLboolean
574 _mesa_is_enum_format_unsized(GLenum format)
575 {
576 switch (format) {
577 case GL_RGBA:
578 case GL_BGRA:
579 case GL_ABGR_EXT:
580 case GL_RGB:
581 case GL_BGR:
582 case GL_RG:
583 case GL_RED:
584 case GL_GREEN:
585 case GL_BLUE:
586 case GL_ALPHA:
587 case GL_INTENSITY:
588 case GL_LUMINANCE:
589 case GL_LUMINANCE_ALPHA:
590
591 case GL_SRGB:
592 case GL_SRGB_ALPHA:
593 case GL_SLUMINANCE:
594 case GL_SLUMINANCE_ALPHA:
595
596 case GL_RGBA_SNORM:
597 case GL_RGB_SNORM:
598 case GL_RG_SNORM:
599 case GL_RED_SNORM:
600 case GL_ALPHA_SNORM:
601 case GL_INTENSITY_SNORM:
602 case GL_LUMINANCE_SNORM:
603 case GL_LUMINANCE_ALPHA_SNORM:
604
605 case GL_RED_INTEGER:
606 case GL_GREEN_INTEGER:
607 case GL_BLUE_INTEGER:
608 case GL_ALPHA_INTEGER:
609 case GL_RGB_INTEGER:
610 case GL_RGBA_INTEGER:
611 case GL_BGR_INTEGER:
612 case GL_BGRA_INTEGER:
613 case GL_RG_INTEGER:
614 case GL_LUMINANCE_INTEGER_EXT:
615 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
616
617 case GL_DEPTH_COMPONENT:
618 case GL_DEPTH_STENCIL:
619 case GL_STENCIL_INDEX:
620 return GL_TRUE;
621 default:
622 return GL_FALSE;
623 }
624 }
625
626 /**
627 * Test if the given format is a UNORM (unsigned-normalized) format.
628 */
629 GLboolean
630 _mesa_is_enum_format_unorm(GLenum format)
631 {
632 switch(format) {
633 case GL_RED:
634 case GL_GREEN:
635 case GL_BLUE:
636 case GL_ALPHA:
637 case GL_ALPHA4:
638 case GL_ALPHA8:
639 case GL_ALPHA12:
640 case GL_ALPHA16:
641 case 1:
642 case GL_LUMINANCE:
643 case GL_SLUMINANCE:
644 case GL_LUMINANCE4:
645 case GL_LUMINANCE8:
646 case GL_LUMINANCE12:
647 case GL_LUMINANCE16:
648 case 2:
649 case GL_LUMINANCE_ALPHA:
650 case GL_SLUMINANCE_ALPHA:
651 case GL_LUMINANCE4_ALPHA4:
652 case GL_LUMINANCE6_ALPHA2:
653 case GL_LUMINANCE8_ALPHA8:
654 case GL_LUMINANCE12_ALPHA4:
655 case GL_LUMINANCE12_ALPHA12:
656 case GL_LUMINANCE16_ALPHA16:
657 case GL_INTENSITY:
658 case GL_INTENSITY4:
659 case GL_INTENSITY8:
660 case GL_INTENSITY12:
661 case GL_INTENSITY16:
662 case GL_R8:
663 case GL_R16:
664 case GL_RG:
665 case GL_RG8:
666 case GL_RG16:
667 case 3:
668 case GL_RGB:
669 case GL_BGR:
670 case GL_SRGB:
671 case GL_R3_G3_B2:
672 case GL_RGB4:
673 case GL_RGB5:
674 case GL_RGB565:
675 case GL_RGB8:
676 case GL_RGB10:
677 case GL_RGB12:
678 case GL_RGB16:
679 case 4:
680 case GL_ABGR_EXT:
681 case GL_RGBA:
682 case GL_BGRA:
683 case GL_SRGB_ALPHA:
684 case GL_RGBA2:
685 case GL_RGBA4:
686 case GL_RGB5_A1:
687 case GL_RGBA8:
688 case GL_RGB10_A2:
689 case GL_RGBA12:
690 case GL_RGBA16:
691 return GL_TRUE;
692 default:
693 return GL_FALSE;
694 }
695 }
696
697 /**
698 * Test if the given format is a SNORM (signed-normalized) format.
699 */
700 GLboolean
701 _mesa_is_enum_format_snorm(GLenum format)
702 {
703 switch (format) {
704 /* signed, normalized texture formats */
705 case GL_RED_SNORM:
706 case GL_R8_SNORM:
707 case GL_R16_SNORM:
708 case GL_RG_SNORM:
709 case GL_RG8_SNORM:
710 case GL_RG16_SNORM:
711 case GL_RGB_SNORM:
712 case GL_RGB8_SNORM:
713 case GL_RGB16_SNORM:
714 case GL_RGBA_SNORM:
715 case GL_RGBA8_SNORM:
716 case GL_RGBA16_SNORM:
717 case GL_ALPHA_SNORM:
718 case GL_ALPHA8_SNORM:
719 case GL_ALPHA16_SNORM:
720 case GL_LUMINANCE_SNORM:
721 case GL_LUMINANCE8_SNORM:
722 case GL_LUMINANCE16_SNORM:
723 case GL_LUMINANCE_ALPHA_SNORM:
724 case GL_LUMINANCE8_ALPHA8_SNORM:
725 case GL_LUMINANCE16_ALPHA16_SNORM:
726 case GL_INTENSITY_SNORM:
727 case GL_INTENSITY8_SNORM:
728 case GL_INTENSITY16_SNORM:
729 return GL_TRUE;
730 default:
731 return GL_FALSE;
732 }
733 }
734
735 /**
736 * Test if the given format is an integer (non-normalized) format.
737 */
738 GLboolean
739 _mesa_is_enum_format_unsigned_int(GLenum format)
740 {
741 switch (format) {
742 /* specific integer formats */
743 case GL_RGBA32UI_EXT:
744 case GL_RGB32UI_EXT:
745 case GL_RG32UI:
746 case GL_R32UI:
747 case GL_ALPHA32UI_EXT:
748 case GL_INTENSITY32UI_EXT:
749 case GL_LUMINANCE32UI_EXT:
750 case GL_LUMINANCE_ALPHA32UI_EXT:
751 case GL_RGBA16UI_EXT:
752 case GL_RGB16UI_EXT:
753 case GL_RG16UI:
754 case GL_R16UI:
755 case GL_ALPHA16UI_EXT:
756 case GL_INTENSITY16UI_EXT:
757 case GL_LUMINANCE16UI_EXT:
758 case GL_LUMINANCE_ALPHA16UI_EXT:
759 case GL_RGBA8UI_EXT:
760 case GL_RGB8UI_EXT:
761 case GL_RG8UI:
762 case GL_R8UI:
763 case GL_ALPHA8UI_EXT:
764 case GL_INTENSITY8UI_EXT:
765 case GL_LUMINANCE8UI_EXT:
766 case GL_LUMINANCE_ALPHA8UI_EXT:
767 case GL_RGB10_A2UI:
768 return GL_TRUE;
769 default:
770 return GL_FALSE;
771 }
772 }
773
774
775 /**
776 * Test if the given format is an integer (non-normalized) format.
777 */
778 GLboolean
779 _mesa_is_enum_format_signed_int(GLenum format)
780 {
781 switch (format) {
782 /* generic integer formats */
783 case GL_RED_INTEGER_EXT:
784 case GL_GREEN_INTEGER_EXT:
785 case GL_BLUE_INTEGER_EXT:
786 case GL_ALPHA_INTEGER_EXT:
787 case GL_RGB_INTEGER_EXT:
788 case GL_RGBA_INTEGER_EXT:
789 case GL_BGR_INTEGER_EXT:
790 case GL_BGRA_INTEGER_EXT:
791 case GL_LUMINANCE_INTEGER_EXT:
792 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
793 case GL_RG_INTEGER:
794 /* specific integer formats */
795 case GL_RGBA32I_EXT:
796 case GL_RGB32I_EXT:
797 case GL_RG32I:
798 case GL_R32I:
799 case GL_ALPHA32I_EXT:
800 case GL_INTENSITY32I_EXT:
801 case GL_LUMINANCE32I_EXT:
802 case GL_LUMINANCE_ALPHA32I_EXT:
803 case GL_RGBA16I_EXT:
804 case GL_RGB16I_EXT:
805 case GL_RG16I:
806 case GL_R16I:
807 case GL_ALPHA16I_EXT:
808 case GL_INTENSITY16I_EXT:
809 case GL_LUMINANCE16I_EXT:
810 case GL_LUMINANCE_ALPHA16I_EXT:
811 case GL_RGBA8I_EXT:
812 case GL_RGB8I_EXT:
813 case GL_RG8I:
814 case GL_R8I:
815 case GL_ALPHA8I_EXT:
816 case GL_INTENSITY8I_EXT:
817 case GL_LUMINANCE8I_EXT:
818 case GL_LUMINANCE_ALPHA8I_EXT:
819 return GL_TRUE;
820 default:
821 return GL_FALSE;
822 }
823 }
824
825 /**
826 * Test if the given format is an ASTC format.
827 */
828 GLboolean
829 _mesa_is_astc_format(GLenum internalFormat)
830 {
831 switch (internalFormat) {
832 case GL_COMPRESSED_RGBA_ASTC_4x4_KHR:
833 case GL_COMPRESSED_RGBA_ASTC_5x4_KHR:
834 case GL_COMPRESSED_RGBA_ASTC_5x5_KHR:
835 case GL_COMPRESSED_RGBA_ASTC_6x5_KHR:
836 case GL_COMPRESSED_RGBA_ASTC_6x6_KHR:
837 case GL_COMPRESSED_RGBA_ASTC_8x5_KHR:
838 case GL_COMPRESSED_RGBA_ASTC_8x6_KHR:
839 case GL_COMPRESSED_RGBA_ASTC_8x8_KHR:
840 case GL_COMPRESSED_RGBA_ASTC_10x5_KHR:
841 case GL_COMPRESSED_RGBA_ASTC_10x6_KHR:
842 case GL_COMPRESSED_RGBA_ASTC_10x8_KHR:
843 case GL_COMPRESSED_RGBA_ASTC_10x10_KHR:
844 case GL_COMPRESSED_RGBA_ASTC_12x10_KHR:
845 case GL_COMPRESSED_RGBA_ASTC_12x12_KHR:
846 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR:
847 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR:
848 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR:
849 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR:
850 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR:
851 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR:
852 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR:
853 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR:
854 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR:
855 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR:
856 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR:
857 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR:
858 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR:
859 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR:
860 return true;
861 default:
862 return false;
863 }
864 }
865
866
867 /**
868 * Test if the given format is an integer (non-normalized) format.
869 */
870 GLboolean
871 _mesa_is_enum_format_integer(GLenum format)
872 {
873 return _mesa_is_enum_format_unsigned_int(format) ||
874 _mesa_is_enum_format_signed_int(format);
875 }
876
877
878 GLboolean
879 _mesa_is_type_unsigned(GLenum type)
880 {
881 switch (type) {
882 case GL_UNSIGNED_INT:
883 case GL_UNSIGNED_INT_8_8_8_8:
884 case GL_UNSIGNED_INT_8_8_8_8_REV:
885 case GL_UNSIGNED_INT_10_10_10_2:
886 case GL_UNSIGNED_INT_2_10_10_10_REV:
887
888 case GL_UNSIGNED_SHORT:
889 case GL_UNSIGNED_SHORT_4_4_4_4:
890 case GL_UNSIGNED_SHORT_5_5_5_1:
891 case GL_UNSIGNED_SHORT_5_6_5:
892 case GL_UNSIGNED_SHORT_5_6_5_REV:
893 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
894 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
895 case GL_UNSIGNED_SHORT_8_8_MESA:
896 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
897
898 case GL_UNSIGNED_BYTE:
899 case GL_UNSIGNED_BYTE_3_3_2:
900 case GL_UNSIGNED_BYTE_2_3_3_REV:
901 return GL_TRUE;
902
903 default:
904 return GL_FALSE;
905 }
906 }
907
908
909 /**
910 * Test if the given image format is a color/RGBA format (i.e., not color
911 * index, depth, stencil, etc).
912 * \param format the image format value (may by an internal texture format)
913 * \return GL_TRUE if its a color/RGBA format, GL_FALSE otherwise.
914 */
915 GLboolean
916 _mesa_is_color_format(GLenum format)
917 {
918 switch (format) {
919 case GL_RED:
920 case GL_GREEN:
921 case GL_BLUE:
922 case GL_ALPHA:
923 case GL_ALPHA4:
924 case GL_ALPHA8:
925 case GL_ALPHA12:
926 case GL_ALPHA16:
927 case 1:
928 case GL_LUMINANCE:
929 case GL_LUMINANCE4:
930 case GL_LUMINANCE8:
931 case GL_LUMINANCE12:
932 case GL_LUMINANCE16:
933 case 2:
934 case GL_LUMINANCE_ALPHA:
935 case GL_LUMINANCE4_ALPHA4:
936 case GL_LUMINANCE6_ALPHA2:
937 case GL_LUMINANCE8_ALPHA8:
938 case GL_LUMINANCE12_ALPHA4:
939 case GL_LUMINANCE12_ALPHA12:
940 case GL_LUMINANCE16_ALPHA16:
941 case GL_INTENSITY:
942 case GL_INTENSITY4:
943 case GL_INTENSITY8:
944 case GL_INTENSITY12:
945 case GL_INTENSITY16:
946 case GL_R8:
947 case GL_R16:
948 case GL_RG:
949 case GL_RG8:
950 case GL_RG16:
951 case 3:
952 case GL_RGB:
953 case GL_BGR:
954 case GL_R3_G3_B2:
955 case GL_RGB4:
956 case GL_RGB5:
957 case GL_RGB565:
958 case GL_RGB8:
959 case GL_RGB10:
960 case GL_RGB12:
961 case GL_RGB16:
962 case 4:
963 case GL_ABGR_EXT:
964 case GL_RGBA:
965 case GL_BGRA:
966 case GL_RGBA2:
967 case GL_RGBA4:
968 case GL_RGB5_A1:
969 case GL_RGBA8:
970 case GL_RGB10_A2:
971 case GL_RGBA12:
972 case GL_RGBA16:
973 /* float texture formats */
974 case GL_ALPHA16F_ARB:
975 case GL_ALPHA32F_ARB:
976 case GL_LUMINANCE16F_ARB:
977 case GL_LUMINANCE32F_ARB:
978 case GL_LUMINANCE_ALPHA16F_ARB:
979 case GL_LUMINANCE_ALPHA32F_ARB:
980 case GL_INTENSITY16F_ARB:
981 case GL_INTENSITY32F_ARB:
982 case GL_R16F:
983 case GL_R32F:
984 case GL_RG16F:
985 case GL_RG32F:
986 case GL_RGB16F_ARB:
987 case GL_RGB32F_ARB:
988 case GL_RGBA16F_ARB:
989 case GL_RGBA32F_ARB:
990 /* compressed formats */
991 case GL_COMPRESSED_ALPHA:
992 case GL_COMPRESSED_LUMINANCE:
993 case GL_COMPRESSED_LUMINANCE_ALPHA:
994 case GL_COMPRESSED_INTENSITY:
995 case GL_COMPRESSED_RED:
996 case GL_COMPRESSED_RG:
997 case GL_COMPRESSED_RGB:
998 case GL_COMPRESSED_RGBA:
999 case GL_RGB_S3TC:
1000 case GL_RGB4_S3TC:
1001 case GL_RGBA_S3TC:
1002 case GL_RGBA4_S3TC:
1003 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT:
1004 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT:
1005 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT:
1006 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT:
1007 case GL_COMPRESSED_RGB_FXT1_3DFX:
1008 case GL_COMPRESSED_RGBA_FXT1_3DFX:
1009 case GL_SRGB_EXT:
1010 case GL_SRGB8_EXT:
1011 case GL_SRGB_ALPHA_EXT:
1012 case GL_SRGB8_ALPHA8_EXT:
1013 case GL_SLUMINANCE_ALPHA_EXT:
1014 case GL_SLUMINANCE8_ALPHA8_EXT:
1015 case GL_SLUMINANCE_EXT:
1016 case GL_SLUMINANCE8_EXT:
1017 case GL_COMPRESSED_SRGB_EXT:
1018 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT:
1019 case GL_COMPRESSED_SRGB_ALPHA_EXT:
1020 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:
1021 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:
1022 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:
1023 case GL_COMPRESSED_SLUMINANCE_EXT:
1024 case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT:
1025 case GL_COMPRESSED_RED_RGTC1:
1026 case GL_COMPRESSED_SIGNED_RED_RGTC1:
1027 case GL_COMPRESSED_RG_RGTC2:
1028 case GL_COMPRESSED_SIGNED_RG_RGTC2:
1029 case GL_COMPRESSED_LUMINANCE_LATC1_EXT:
1030 case GL_COMPRESSED_SIGNED_LUMINANCE_LATC1_EXT:
1031 case GL_COMPRESSED_LUMINANCE_ALPHA_LATC2_EXT:
1032 case GL_COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2_EXT:
1033 case GL_COMPRESSED_LUMINANCE_ALPHA_3DC_ATI:
1034 case GL_ETC1_RGB8_OES:
1035 case GL_COMPRESSED_RGB8_ETC2:
1036 case GL_COMPRESSED_SRGB8_ETC2:
1037 case GL_COMPRESSED_RGBA8_ETC2_EAC:
1038 case GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC:
1039 case GL_COMPRESSED_R11_EAC:
1040 case GL_COMPRESSED_RG11_EAC:
1041 case GL_COMPRESSED_SIGNED_R11_EAC:
1042 case GL_COMPRESSED_SIGNED_RG11_EAC:
1043 case GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2:
1044 case GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2:
1045 case GL_COMPRESSED_RGBA_BPTC_UNORM:
1046 case GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM:
1047 case GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT:
1048 case GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT:
1049 case GL_COMPRESSED_RGBA_ASTC_4x4_KHR:
1050 case GL_COMPRESSED_RGBA_ASTC_5x4_KHR:
1051 case GL_COMPRESSED_RGBA_ASTC_5x5_KHR:
1052 case GL_COMPRESSED_RGBA_ASTC_6x5_KHR:
1053 case GL_COMPRESSED_RGBA_ASTC_6x6_KHR:
1054 case GL_COMPRESSED_RGBA_ASTC_8x5_KHR:
1055 case GL_COMPRESSED_RGBA_ASTC_8x6_KHR:
1056 case GL_COMPRESSED_RGBA_ASTC_8x8_KHR:
1057 case GL_COMPRESSED_RGBA_ASTC_10x5_KHR:
1058 case GL_COMPRESSED_RGBA_ASTC_10x6_KHR:
1059 case GL_COMPRESSED_RGBA_ASTC_10x8_KHR:
1060 case GL_COMPRESSED_RGBA_ASTC_10x10_KHR:
1061 case GL_COMPRESSED_RGBA_ASTC_12x10_KHR:
1062 case GL_COMPRESSED_RGBA_ASTC_12x12_KHR:
1063 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR:
1064 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR:
1065 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR:
1066 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR:
1067 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR:
1068 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR:
1069 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR:
1070 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR:
1071 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR:
1072 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR:
1073 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR:
1074 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR:
1075 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR:
1076 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR:
1077 /* generic integer formats */
1078 case GL_RED_INTEGER_EXT:
1079 case GL_GREEN_INTEGER_EXT:
1080 case GL_BLUE_INTEGER_EXT:
1081 case GL_ALPHA_INTEGER_EXT:
1082 case GL_RGB_INTEGER_EXT:
1083 case GL_RGBA_INTEGER_EXT:
1084 case GL_BGR_INTEGER_EXT:
1085 case GL_BGRA_INTEGER_EXT:
1086 case GL_RG_INTEGER:
1087 case GL_LUMINANCE_INTEGER_EXT:
1088 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
1089 /* sized integer formats */
1090 case GL_RGBA32UI_EXT:
1091 case GL_RGB32UI_EXT:
1092 case GL_RG32UI:
1093 case GL_R32UI:
1094 case GL_ALPHA32UI_EXT:
1095 case GL_INTENSITY32UI_EXT:
1096 case GL_LUMINANCE32UI_EXT:
1097 case GL_LUMINANCE_ALPHA32UI_EXT:
1098 case GL_RGBA16UI_EXT:
1099 case GL_RGB16UI_EXT:
1100 case GL_RG16UI:
1101 case GL_R16UI:
1102 case GL_ALPHA16UI_EXT:
1103 case GL_INTENSITY16UI_EXT:
1104 case GL_LUMINANCE16UI_EXT:
1105 case GL_LUMINANCE_ALPHA16UI_EXT:
1106 case GL_RGBA8UI_EXT:
1107 case GL_RGB8UI_EXT:
1108 case GL_RG8UI:
1109 case GL_R8UI:
1110 case GL_ALPHA8UI_EXT:
1111 case GL_INTENSITY8UI_EXT:
1112 case GL_LUMINANCE8UI_EXT:
1113 case GL_LUMINANCE_ALPHA8UI_EXT:
1114 case GL_RGBA32I_EXT:
1115 case GL_RGB32I_EXT:
1116 case GL_RG32I:
1117 case GL_R32I:
1118 case GL_ALPHA32I_EXT:
1119 case GL_INTENSITY32I_EXT:
1120 case GL_LUMINANCE32I_EXT:
1121 case GL_LUMINANCE_ALPHA32I_EXT:
1122 case GL_RGBA16I_EXT:
1123 case GL_RGB16I_EXT:
1124 case GL_RG16I:
1125 case GL_R16I:
1126 case GL_ALPHA16I_EXT:
1127 case GL_INTENSITY16I_EXT:
1128 case GL_LUMINANCE16I_EXT:
1129 case GL_LUMINANCE_ALPHA16I_EXT:
1130 case GL_RGBA8I_EXT:
1131 case GL_RGB8I_EXT:
1132 case GL_RG8I:
1133 case GL_R8I:
1134 case GL_ALPHA8I_EXT:
1135 case GL_INTENSITY8I_EXT:
1136 case GL_LUMINANCE8I_EXT:
1137 case GL_LUMINANCE_ALPHA8I_EXT:
1138 /* signed, normalized texture formats */
1139 case GL_RED_SNORM:
1140 case GL_R8_SNORM:
1141 case GL_R16_SNORM:
1142 case GL_RG_SNORM:
1143 case GL_RG8_SNORM:
1144 case GL_RG16_SNORM:
1145 case GL_RGB_SNORM:
1146 case GL_RGB8_SNORM:
1147 case GL_RGB16_SNORM:
1148 case GL_RGBA_SNORM:
1149 case GL_RGBA8_SNORM:
1150 case GL_RGBA16_SNORM:
1151 case GL_ALPHA_SNORM:
1152 case GL_ALPHA8_SNORM:
1153 case GL_ALPHA16_SNORM:
1154 case GL_LUMINANCE_SNORM:
1155 case GL_LUMINANCE8_SNORM:
1156 case GL_LUMINANCE16_SNORM:
1157 case GL_LUMINANCE_ALPHA_SNORM:
1158 case GL_LUMINANCE8_ALPHA8_SNORM:
1159 case GL_LUMINANCE16_ALPHA16_SNORM:
1160 case GL_INTENSITY_SNORM:
1161 case GL_INTENSITY8_SNORM:
1162 case GL_INTENSITY16_SNORM:
1163 case GL_RGB9_E5:
1164 case GL_R11F_G11F_B10F:
1165 case GL_RGB10_A2UI:
1166 return GL_TRUE;
1167 case GL_YCBCR_MESA: /* not considered to be RGB */
1168 /* fall-through */
1169 default:
1170 return GL_FALSE;
1171 }
1172 }
1173
1174
1175 /**
1176 * Test if the given image format is a depth component format.
1177 */
1178 GLboolean
1179 _mesa_is_depth_format(GLenum format)
1180 {
1181 switch (format) {
1182 case GL_DEPTH_COMPONENT:
1183 case GL_DEPTH_COMPONENT16:
1184 case GL_DEPTH_COMPONENT24:
1185 case GL_DEPTH_COMPONENT32:
1186 case GL_DEPTH_COMPONENT32F:
1187 return GL_TRUE;
1188 default:
1189 return GL_FALSE;
1190 }
1191 }
1192
1193
1194 /**
1195 * Test if the given image format is a stencil format.
1196 */
1197 GLboolean
1198 _mesa_is_stencil_format(GLenum format)
1199 {
1200 switch (format) {
1201 case GL_STENCIL_INDEX:
1202 return GL_TRUE;
1203 default:
1204 return GL_FALSE;
1205 }
1206 }
1207
1208
1209 /**
1210 * Test if the given image format is a YCbCr format.
1211 */
1212 GLboolean
1213 _mesa_is_ycbcr_format(GLenum format)
1214 {
1215 switch (format) {
1216 case GL_YCBCR_MESA:
1217 return GL_TRUE;
1218 default:
1219 return GL_FALSE;
1220 }
1221 }
1222
1223
1224 /**
1225 * Test if the given image format is a depth+stencil format.
1226 */
1227 GLboolean
1228 _mesa_is_depthstencil_format(GLenum format)
1229 {
1230 switch (format) {
1231 case GL_DEPTH24_STENCIL8_EXT:
1232 case GL_DEPTH_STENCIL_EXT:
1233 case GL_DEPTH32F_STENCIL8:
1234 return GL_TRUE;
1235 default:
1236 return GL_FALSE;
1237 }
1238 }
1239
1240
1241 /**
1242 * Test if the given image format is a depth or stencil format.
1243 */
1244 GLboolean
1245 _mesa_is_depth_or_stencil_format(GLenum format)
1246 {
1247 switch (format) {
1248 case GL_DEPTH_COMPONENT:
1249 case GL_DEPTH_COMPONENT16:
1250 case GL_DEPTH_COMPONENT24:
1251 case GL_DEPTH_COMPONENT32:
1252 case GL_STENCIL_INDEX:
1253 case GL_STENCIL_INDEX1_EXT:
1254 case GL_STENCIL_INDEX4_EXT:
1255 case GL_STENCIL_INDEX8_EXT:
1256 case GL_STENCIL_INDEX16_EXT:
1257 case GL_DEPTH_STENCIL_EXT:
1258 case GL_DEPTH24_STENCIL8_EXT:
1259 case GL_DEPTH_COMPONENT32F:
1260 case GL_DEPTH32F_STENCIL8:
1261 return GL_TRUE;
1262 default:
1263 return GL_FALSE;
1264 }
1265 }
1266
1267
1268 /**
1269 * Test if an image format is a supported compressed format.
1270 * \param format the internal format token provided by the user.
1271 * \return GL_TRUE if compressed, GL_FALSE if uncompressed
1272 */
1273 GLboolean
1274 _mesa_is_compressed_format(const struct gl_context *ctx, GLenum format)
1275 {
1276 mesa_format m_format = _mesa_glenum_to_compressed_format(format);
1277
1278 /* Some formats in this switch have an equivalent mesa_format_layout
1279 * to the compressed formats in the layout switch below and thus
1280 * must be handled first.
1281 */
1282 switch (format) {
1283 case GL_RGB_S3TC:
1284 case GL_RGB4_S3TC:
1285 case GL_RGBA_S3TC:
1286 case GL_RGBA4_S3TC:
1287 return _mesa_is_desktop_gl(ctx) &&
1288 ctx->Extensions.ANGLE_texture_compression_dxt;
1289 case GL_COMPRESSED_LUMINANCE_ALPHA_3DC_ATI:
1290 return ctx->API == API_OPENGL_COMPAT
1291 && ctx->Extensions.ATI_texture_compression_3dc;
1292 case GL_PALETTE4_RGB8_OES:
1293 case GL_PALETTE4_RGBA8_OES:
1294 case GL_PALETTE4_R5_G6_B5_OES:
1295 case GL_PALETTE4_RGBA4_OES:
1296 case GL_PALETTE4_RGB5_A1_OES:
1297 case GL_PALETTE8_RGB8_OES:
1298 case GL_PALETTE8_RGBA8_OES:
1299 case GL_PALETTE8_R5_G6_B5_OES:
1300 case GL_PALETTE8_RGBA4_OES:
1301 case GL_PALETTE8_RGB5_A1_OES:
1302 return ctx->API == API_OPENGLES;
1303 }
1304
1305 switch (_mesa_get_format_layout(m_format)) {
1306 case MESA_FORMAT_LAYOUT_S3TC:
1307 if (_mesa_get_format_color_encoding(m_format) == GL_LINEAR) {
1308 /* Assume that the ANGLE flag will always be set if the
1309 * EXT flag is set.
1310 */
1311 return ctx->Extensions.ANGLE_texture_compression_dxt;
1312 } else {
1313 return _mesa_is_desktop_gl(ctx)
1314 && ctx->Extensions.EXT_texture_sRGB
1315 && ctx->Extensions.EXT_texture_compression_s3tc;
1316 }
1317 case MESA_FORMAT_LAYOUT_FXT1:
1318 return _mesa_is_desktop_gl(ctx)
1319 && ctx->Extensions.TDFX_texture_compression_FXT1;
1320 case MESA_FORMAT_LAYOUT_RGTC:
1321 return _mesa_is_desktop_gl(ctx)
1322 && ctx->Extensions.ARB_texture_compression_rgtc;
1323 case MESA_FORMAT_LAYOUT_LATC:
1324 return ctx->API == API_OPENGL_COMPAT
1325 && ctx->Extensions.EXT_texture_compression_latc;
1326 case MESA_FORMAT_LAYOUT_ETC1:
1327 return _mesa_is_gles(ctx)
1328 && ctx->Extensions.OES_compressed_ETC1_RGB8_texture;
1329 case MESA_FORMAT_LAYOUT_ETC2:
1330 return _mesa_is_gles3(ctx) || ctx->Extensions.ARB_ES3_compatibility;
1331 case MESA_FORMAT_LAYOUT_BPTC:
1332 return _mesa_is_desktop_gl(ctx) &&
1333 ctx->Extensions.ARB_texture_compression_bptc;
1334 case MESA_FORMAT_LAYOUT_ASTC:
1335 return ctx->Extensions.KHR_texture_compression_astc_ldr;
1336 default:
1337 return GL_FALSE;
1338 }
1339 }
1340
1341 /**
1342 * Test if the given format represents an sRGB format.
1343 * \param format the GL format (can be an internal format)
1344 * \return GL_TRUE if format is sRGB, GL_FALSE otherwise
1345 */
1346 GLboolean
1347 _mesa_is_srgb_format(GLenum format)
1348 {
1349 switch (format) {
1350 case GL_SRGB:
1351 case GL_SRGB8:
1352 case GL_SRGB_ALPHA:
1353 case GL_SRGB8_ALPHA8:
1354 case GL_COMPRESSED_SRGB:
1355 case GL_COMPRESSED_SRGB_ALPHA:
1356 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT:
1357 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:
1358 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:
1359 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:
1360 case GL_COMPRESSED_SRGB8_ETC2:
1361 case GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC:
1362 case GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2:
1363 case GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM:
1364 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_4x4_KHR:
1365 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x4_KHR:
1366 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_5x5_KHR:
1367 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x5_KHR:
1368 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_6x6_KHR:
1369 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x5_KHR:
1370 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x6_KHR:
1371 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_8x8_KHR:
1372 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x5_KHR:
1373 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x6_KHR:
1374 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x8_KHR:
1375 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_10x10_KHR:
1376 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x10_KHR:
1377 case GL_COMPRESSED_SRGB8_ALPHA8_ASTC_12x12_KHR:
1378 return GL_TRUE;
1379 default:
1380 break;
1381 }
1382
1383 return GL_FALSE;
1384 }
1385
1386 /**
1387 * Convert various unpack formats to the corresponding base format.
1388 */
1389 GLenum
1390 _mesa_unpack_format_to_base_format(GLenum format)
1391 {
1392 switch(format) {
1393 case GL_RED_INTEGER:
1394 return GL_RED;
1395 case GL_GREEN_INTEGER:
1396 return GL_GREEN;
1397 case GL_BLUE_INTEGER:
1398 return GL_BLUE;
1399 case GL_ALPHA_INTEGER:
1400 return GL_ALPHA;
1401 case GL_RG_INTEGER:
1402 return GL_RG;
1403 case GL_RGB_INTEGER:
1404 return GL_RGB;
1405 case GL_RGBA_INTEGER:
1406 return GL_RGBA;
1407 case GL_BGR_INTEGER:
1408 return GL_BGR;
1409 case GL_BGRA_INTEGER:
1410 return GL_BGRA;
1411 case GL_LUMINANCE_INTEGER_EXT:
1412 return GL_LUMINANCE;
1413 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
1414 return GL_LUMINANCE_ALPHA;
1415 case GL_RED:
1416 case GL_GREEN:
1417 case GL_BLUE:
1418 case GL_RG:
1419 case GL_RGB:
1420 case GL_RGBA:
1421 case GL_BGR:
1422 case GL_BGRA:
1423 case GL_ALPHA:
1424 case GL_LUMINANCE:
1425 case GL_LUMINANCE_ALPHA:
1426 default:
1427 return format;
1428 }
1429 }
1430
1431 /**
1432 * Convert various base formats to the corresponding integer format.
1433 */
1434 GLenum
1435 _mesa_base_format_to_integer_format(GLenum format)
1436 {
1437 switch(format) {
1438 case GL_RED:
1439 return GL_RED_INTEGER;
1440 case GL_GREEN:
1441 return GL_GREEN_INTEGER;
1442 case GL_BLUE:
1443 return GL_BLUE_INTEGER;
1444 case GL_RG:
1445 return GL_RG_INTEGER;
1446 case GL_RGB:
1447 return GL_RGB_INTEGER;
1448 case GL_RGBA:
1449 return GL_RGBA_INTEGER;
1450 case GL_BGR:
1451 return GL_BGR_INTEGER;
1452 case GL_BGRA:
1453 return GL_BGRA_INTEGER;
1454 case GL_ALPHA:
1455 return GL_ALPHA_INTEGER;
1456 case GL_LUMINANCE:
1457 return GL_LUMINANCE_INTEGER_EXT;
1458 case GL_LUMINANCE_ALPHA:
1459 return GL_LUMINANCE_ALPHA_INTEGER_EXT;
1460 }
1461
1462 return format;
1463 }
1464
1465
1466 /**
1467 * Does the given base texture/renderbuffer format have the channel
1468 * named by 'pname'?
1469 */
1470 GLboolean
1471 _mesa_base_format_has_channel(GLenum base_format, GLenum pname)
1472 {
1473 switch (pname) {
1474 case GL_TEXTURE_RED_SIZE:
1475 case GL_TEXTURE_RED_TYPE:
1476 case GL_RENDERBUFFER_RED_SIZE_EXT:
1477 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
1478 case GL_INTERNALFORMAT_RED_SIZE:
1479 case GL_INTERNALFORMAT_RED_TYPE:
1480 if (base_format == GL_RED ||
1481 base_format == GL_RG ||
1482 base_format == GL_RGB ||
1483 base_format == GL_RGBA) {
1484 return GL_TRUE;
1485 }
1486 return GL_FALSE;
1487 case GL_TEXTURE_GREEN_SIZE:
1488 case GL_TEXTURE_GREEN_TYPE:
1489 case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1490 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
1491 case GL_INTERNALFORMAT_GREEN_SIZE:
1492 case GL_INTERNALFORMAT_GREEN_TYPE:
1493 if (base_format == GL_RG ||
1494 base_format == GL_RGB ||
1495 base_format == GL_RGBA) {
1496 return GL_TRUE;
1497 }
1498 return GL_FALSE;
1499 case GL_TEXTURE_BLUE_SIZE:
1500 case GL_TEXTURE_BLUE_TYPE:
1501 case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1502 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
1503 case GL_INTERNALFORMAT_BLUE_SIZE:
1504 case GL_INTERNALFORMAT_BLUE_TYPE:
1505 if (base_format == GL_RGB ||
1506 base_format == GL_RGBA) {
1507 return GL_TRUE;
1508 }
1509 return GL_FALSE;
1510 case GL_TEXTURE_ALPHA_SIZE:
1511 case GL_TEXTURE_ALPHA_TYPE:
1512 case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1513 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
1514 case GL_INTERNALFORMAT_ALPHA_SIZE:
1515 case GL_INTERNALFORMAT_ALPHA_TYPE:
1516 if (base_format == GL_RGBA ||
1517 base_format == GL_ALPHA ||
1518 base_format == GL_LUMINANCE_ALPHA) {
1519 return GL_TRUE;
1520 }
1521 return GL_FALSE;
1522 case GL_TEXTURE_LUMINANCE_SIZE:
1523 case GL_TEXTURE_LUMINANCE_TYPE:
1524 if (base_format == GL_LUMINANCE ||
1525 base_format == GL_LUMINANCE_ALPHA) {
1526 return GL_TRUE;
1527 }
1528 return GL_FALSE;
1529 case GL_TEXTURE_INTENSITY_SIZE:
1530 case GL_TEXTURE_INTENSITY_TYPE:
1531 if (base_format == GL_INTENSITY) {
1532 return GL_TRUE;
1533 }
1534 return GL_FALSE;
1535 case GL_TEXTURE_DEPTH_SIZE:
1536 case GL_TEXTURE_DEPTH_TYPE:
1537 case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1538 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
1539 case GL_INTERNALFORMAT_DEPTH_SIZE:
1540 case GL_INTERNALFORMAT_DEPTH_TYPE:
1541 if (base_format == GL_DEPTH_STENCIL ||
1542 base_format == GL_DEPTH_COMPONENT) {
1543 return GL_TRUE;
1544 }
1545 return GL_FALSE;
1546 case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1547 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
1548 case GL_INTERNALFORMAT_STENCIL_SIZE:
1549 case GL_INTERNALFORMAT_STENCIL_TYPE:
1550 if (base_format == GL_DEPTH_STENCIL ||
1551 base_format == GL_STENCIL_INDEX) {
1552 return GL_TRUE;
1553 }
1554 return GL_FALSE;
1555 default:
1556 _mesa_warning(NULL, "%s: Unexpected channel token 0x%x\n",
1557 __func__, pname);
1558 return GL_FALSE;
1559 }
1560
1561 return GL_FALSE;
1562 }
1563
1564
1565 /**
1566 * Returns the number of channels/components for a base format.
1567 */
1568 GLint
1569 _mesa_base_format_component_count(GLenum base_format)
1570 {
1571 switch (base_format) {
1572 case GL_RED:
1573 case GL_ALPHA:
1574 case GL_INTENSITY:
1575 case GL_DEPTH_COMPONENT:
1576 return 1;
1577 case GL_RG:
1578 case GL_LUMINANCE_ALPHA:
1579 case GL_DEPTH_STENCIL:
1580 return 2;
1581 case GL_RGB:
1582 return 3;
1583 case GL_RGBA:
1584 return 4;
1585 default:
1586 return -1;
1587 }
1588 }
1589
1590
1591 /**
1592 * If format is a generic compressed format, return the corresponding
1593 * non-compressed format. For other formats, return the format as-is.
1594 */
1595 GLenum
1596 _mesa_generic_compressed_format_to_uncompressed_format(GLenum format)
1597 {
1598 switch (format) {
1599 case GL_COMPRESSED_RED:
1600 return GL_RED;
1601 case GL_COMPRESSED_RG:
1602 return GL_RG;
1603 case GL_COMPRESSED_RGB:
1604 return GL_RGB;
1605 case GL_COMPRESSED_RGBA:
1606 return GL_RGBA;
1607 case GL_COMPRESSED_ALPHA:
1608 return GL_ALPHA;
1609 case GL_COMPRESSED_LUMINANCE:
1610 return GL_LUMINANCE;
1611 case GL_COMPRESSED_LUMINANCE_ALPHA:
1612 return GL_LUMINANCE_ALPHA;
1613 case GL_COMPRESSED_INTENSITY:
1614 return GL_INTENSITY;
1615 /* sRGB formats */
1616 case GL_COMPRESSED_SRGB:
1617 return GL_SRGB;
1618 case GL_COMPRESSED_SRGB_ALPHA:
1619 return GL_SRGB_ALPHA;
1620 case GL_COMPRESSED_SLUMINANCE:
1621 return GL_SLUMINANCE;
1622 case GL_COMPRESSED_SLUMINANCE_ALPHA:
1623 return GL_SLUMINANCE_ALPHA;
1624 default:
1625 return format;
1626 }
1627 }
1628
1629
1630 /**
1631 * Return the equivalent non-generic internal format.
1632 * This is useful for comparing whether two internal formats are equivalent.
1633 */
1634 GLenum
1635 _mesa_get_nongeneric_internalformat(GLenum format)
1636 {
1637 switch (format) {
1638 /* GL 1.1 formats. */
1639 case 4:
1640 case GL_RGBA:
1641 return GL_RGBA8;
1642 case 3:
1643 case GL_RGB:
1644 return GL_RGB8;
1645 case 2:
1646 case GL_LUMINANCE_ALPHA:
1647 return GL_LUMINANCE8_ALPHA8;
1648 case 1:
1649 case GL_LUMINANCE:
1650 return GL_LUMINANCE8;
1651 case GL_ALPHA:
1652 return GL_ALPHA8;
1653 case GL_INTENSITY:
1654 return GL_INTENSITY8;
1655
1656 /* GL_ARB_texture_rg */
1657 case GL_RED:
1658 return GL_R8;
1659 case GL_RG:
1660 return GL_RG8;
1661
1662 /* GL_EXT_texture_sRGB */
1663 case GL_SRGB:
1664 return GL_SRGB8;
1665 case GL_SRGB_ALPHA:
1666 return GL_SRGB8_ALPHA8;
1667 case GL_SLUMINANCE:
1668 return GL_SLUMINANCE8;
1669 case GL_SLUMINANCE_ALPHA:
1670 return GL_SLUMINANCE8_ALPHA8;
1671
1672 /* GL_EXT_texture_snorm */
1673 case GL_RGBA_SNORM:
1674 return GL_RGBA8_SNORM;
1675 case GL_RGB_SNORM:
1676 return GL_RGB8_SNORM;
1677 case GL_RG_SNORM:
1678 return GL_RG8_SNORM;
1679 case GL_RED_SNORM:
1680 return GL_R8_SNORM;
1681 case GL_LUMINANCE_ALPHA_SNORM:
1682 return GL_LUMINANCE8_ALPHA8_SNORM;
1683 case GL_LUMINANCE_SNORM:
1684 return GL_LUMINANCE8_SNORM;
1685 case GL_ALPHA_SNORM:
1686 return GL_ALPHA8_SNORM;
1687 case GL_INTENSITY_SNORM:
1688 return GL_INTENSITY8_SNORM;
1689
1690 default:
1691 return format;
1692 }
1693 }
1694
1695
1696 /**
1697 * Convert an sRGB internal format to linear.
1698 */
1699 GLenum
1700 _mesa_get_linear_internalformat(GLenum format)
1701 {
1702 switch (format) {
1703 case GL_SRGB:
1704 return GL_RGB;
1705 case GL_SRGB_ALPHA:
1706 return GL_RGBA;
1707 case GL_SRGB8:
1708 return GL_RGB8;
1709 case GL_SRGB8_ALPHA8:
1710 return GL_RGBA8;
1711 case GL_SLUMINANCE8:
1712 return GL_LUMINANCE8;
1713 case GL_SLUMINANCE:
1714 return GL_LUMINANCE;
1715 case GL_SLUMINANCE_ALPHA:
1716 return GL_LUMINANCE_ALPHA;
1717 case GL_SLUMINANCE8_ALPHA8:
1718 return GL_LUMINANCE8_ALPHA8;
1719 default:
1720 return format;
1721 }
1722 }
1723
1724
1725 /**
1726 * Do error checking of format/type combinations for glReadPixels,
1727 * glDrawPixels and glTex[Sub]Image. Note that depending on the format
1728 * and type values, we may either generate GL_INVALID_OPERATION or
1729 * GL_INVALID_ENUM.
1730 *
1731 * \param format pixel format.
1732 * \param type pixel type.
1733 *
1734 * \return GL_INVALID_ENUM, GL_INVALID_OPERATION or GL_NO_ERROR
1735 */
1736 GLenum
1737 _mesa_error_check_format_and_type(const struct gl_context *ctx,
1738 GLenum format, GLenum type)
1739 {
1740 /* From OpenGL 3.3 spec, page 220:
1741 * "If the format is DEPTH_STENCIL, then values are taken from
1742 * both the depth buffer and the stencil buffer. If there is no
1743 * depth buffer or if there is no stencil buffer, then the error
1744 * INVALID_OPERATION occurs. If the type parameter is not
1745 * UNSIGNED_INT_24_8 or FLOAT_32_UNSIGNED_INT_24_8_REV, then the
1746 * error INVALID_ENUM occurs."
1747 *
1748 * OpenGL ES still generates GL_INVALID_OPERATION because glReadPixels
1749 * cannot be used to read depth or stencil in that API.
1750 */
1751 if (_mesa_is_desktop_gl(ctx) && format == GL_DEPTH_STENCIL
1752 && type != GL_UNSIGNED_INT_24_8
1753 && type != GL_FLOAT_32_UNSIGNED_INT_24_8_REV)
1754 return GL_INVALID_ENUM;
1755
1756 /* special type-based checks (see glReadPixels, glDrawPixels error lists) */
1757 switch (type) {
1758 case GL_BITMAP:
1759 if (format != GL_COLOR_INDEX && format != GL_STENCIL_INDEX) {
1760 return GL_INVALID_ENUM;
1761 }
1762 break;
1763
1764 case GL_UNSIGNED_BYTE_3_3_2:
1765 case GL_UNSIGNED_BYTE_2_3_3_REV:
1766 case GL_UNSIGNED_SHORT_5_6_5:
1767 case GL_UNSIGNED_SHORT_5_6_5_REV:
1768 if (format == GL_RGB) {
1769 break; /* OK */
1770 }
1771 if (format == GL_RGB_INTEGER_EXT &&
1772 ctx->Extensions.ARB_texture_rgb10_a2ui) {
1773 break; /* OK */
1774 }
1775 return GL_INVALID_OPERATION;
1776
1777 case GL_UNSIGNED_SHORT_4_4_4_4:
1778 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
1779 case GL_UNSIGNED_INT_8_8_8_8:
1780 case GL_UNSIGNED_INT_8_8_8_8_REV:
1781 if (format == GL_RGBA ||
1782 format == GL_BGRA ||
1783 format == GL_ABGR_EXT) {
1784 break; /* OK */
1785 }
1786 if ((format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT) &&
1787 ctx->Extensions.ARB_texture_rgb10_a2ui) {
1788 break; /* OK */
1789 }
1790 return GL_INVALID_OPERATION;
1791
1792 case GL_UNSIGNED_SHORT_5_5_5_1:
1793 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
1794 case GL_UNSIGNED_INT_10_10_10_2:
1795 case GL_UNSIGNED_INT_2_10_10_10_REV:
1796 if (format == GL_RGBA ||
1797 format == GL_BGRA) {
1798 break; /* OK */
1799 }
1800 if ((format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT) &&
1801 ctx->Extensions.ARB_texture_rgb10_a2ui) {
1802 break; /* OK */
1803 }
1804 if (type == GL_UNSIGNED_INT_2_10_10_10_REV && format == GL_RGB &&
1805 ctx->API == API_OPENGLES2) {
1806 break; /* OK by GL_EXT_texture_type_2_10_10_10_REV */
1807 }
1808 return GL_INVALID_OPERATION;
1809
1810 case GL_UNSIGNED_INT_24_8:
1811 /* Depth buffer OK to read in OpenGL ES (NV_read_depth). */
1812 if (ctx->API == API_OPENGLES2 && format == GL_DEPTH_COMPONENT)
1813 return GL_NO_ERROR;
1814
1815 if (format != GL_DEPTH_STENCIL) {
1816 return GL_INVALID_OPERATION;
1817 }
1818 return GL_NO_ERROR;
1819
1820 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
1821 if (!ctx->Extensions.ARB_depth_buffer_float) {
1822 return GL_INVALID_ENUM;
1823 }
1824 if (format != GL_DEPTH_STENCIL) {
1825 return GL_INVALID_OPERATION;
1826 }
1827 return GL_NO_ERROR;
1828
1829 case GL_UNSIGNED_INT_10F_11F_11F_REV:
1830 if (!ctx->Extensions.EXT_packed_float) {
1831 return GL_INVALID_ENUM;
1832 }
1833 if (format != GL_RGB) {
1834 return GL_INVALID_OPERATION;
1835 }
1836 return GL_NO_ERROR;
1837
1838 case GL_HALF_FLOAT_OES:
1839 switch (format) {
1840 case GL_RGBA:
1841 case GL_RGB:
1842 case GL_LUMINANCE_ALPHA:
1843 case GL_LUMINANCE:
1844 case GL_ALPHA:
1845 return GL_NO_ERROR;
1846 case GL_RG:
1847 case GL_RED:
1848 if (_mesa_is_gles3(ctx) || ctx->Extensions.ARB_texture_rg)
1849 return GL_NO_ERROR;
1850 default:
1851 return GL_INVALID_OPERATION;
1852 }
1853
1854 default:
1855 ; /* fall-through */
1856 }
1857
1858 /* now, for each format, check the type for compatibility */
1859 switch (format) {
1860 case GL_COLOR_INDEX:
1861 case GL_STENCIL_INDEX:
1862 switch (type) {
1863 case GL_BITMAP:
1864 case GL_BYTE:
1865 case GL_UNSIGNED_BYTE:
1866 case GL_SHORT:
1867 case GL_UNSIGNED_SHORT:
1868 case GL_INT:
1869 case GL_UNSIGNED_INT:
1870 case GL_FLOAT:
1871 case GL_HALF_FLOAT:
1872 return GL_NO_ERROR;
1873 default:
1874 return GL_INVALID_ENUM;
1875 }
1876
1877 case GL_RED:
1878 case GL_GREEN:
1879 case GL_BLUE:
1880 case GL_ALPHA:
1881 #if 0 /* not legal! see table 3.6 of the 1.5 spec */
1882 case GL_INTENSITY:
1883 #endif
1884 case GL_LUMINANCE:
1885 case GL_LUMINANCE_ALPHA:
1886 case GL_DEPTH_COMPONENT:
1887 switch (type) {
1888 case GL_BYTE:
1889 case GL_UNSIGNED_BYTE:
1890 case GL_SHORT:
1891 case GL_UNSIGNED_SHORT:
1892 case GL_INT:
1893 case GL_UNSIGNED_INT:
1894 case GL_FLOAT:
1895 case GL_HALF_FLOAT:
1896 return GL_NO_ERROR;
1897 default:
1898 return GL_INVALID_ENUM;
1899 }
1900
1901 case GL_RG:
1902 if (!ctx->Extensions.ARB_texture_rg)
1903 return GL_INVALID_ENUM;
1904 switch (type) {
1905 case GL_BYTE:
1906 case GL_UNSIGNED_BYTE:
1907 case GL_SHORT:
1908 case GL_UNSIGNED_SHORT:
1909 case GL_INT:
1910 case GL_UNSIGNED_INT:
1911 case GL_FLOAT:
1912 case GL_HALF_FLOAT:
1913 return GL_NO_ERROR;
1914 default:
1915 return GL_INVALID_ENUM;
1916 }
1917
1918 case GL_RGB:
1919 switch (type) {
1920 case GL_BYTE:
1921 case GL_UNSIGNED_BYTE:
1922 case GL_SHORT:
1923 case GL_UNSIGNED_SHORT:
1924 case GL_INT:
1925 case GL_UNSIGNED_INT:
1926 case GL_FLOAT:
1927 case GL_UNSIGNED_BYTE_3_3_2:
1928 case GL_UNSIGNED_BYTE_2_3_3_REV:
1929 case GL_UNSIGNED_SHORT_5_6_5:
1930 case GL_UNSIGNED_SHORT_5_6_5_REV:
1931 case GL_HALF_FLOAT:
1932 return GL_NO_ERROR;
1933 case GL_UNSIGNED_INT_2_10_10_10_REV:
1934 /* OK by GL_EXT_texture_type_2_10_10_10_REV */
1935 return (ctx->API == API_OPENGLES2)
1936 ? GL_NO_ERROR : GL_INVALID_ENUM;
1937 case GL_UNSIGNED_INT_5_9_9_9_REV:
1938 return ctx->Extensions.EXT_texture_shared_exponent
1939 ? GL_NO_ERROR : GL_INVALID_ENUM;
1940 case GL_UNSIGNED_INT_10F_11F_11F_REV:
1941 return ctx->Extensions.EXT_packed_float
1942 ? GL_NO_ERROR : GL_INVALID_ENUM;
1943 default:
1944 return GL_INVALID_ENUM;
1945 }
1946
1947 case GL_BGR:
1948 switch (type) {
1949 /* NOTE: no packed types are supported with BGR. That's
1950 * intentional, according to the GL spec.
1951 */
1952 case GL_BYTE:
1953 case GL_UNSIGNED_BYTE:
1954 case GL_SHORT:
1955 case GL_UNSIGNED_SHORT:
1956 case GL_INT:
1957 case GL_UNSIGNED_INT:
1958 case GL_FLOAT:
1959 case GL_HALF_FLOAT:
1960 return GL_NO_ERROR;
1961 default:
1962 return GL_INVALID_ENUM;
1963 }
1964
1965 case GL_RGBA:
1966 case GL_BGRA:
1967 switch (type) {
1968 case GL_BYTE:
1969 case GL_UNSIGNED_BYTE:
1970 case GL_SHORT:
1971 case GL_UNSIGNED_SHORT:
1972 case GL_INT:
1973 case GL_UNSIGNED_INT:
1974 case GL_FLOAT:
1975 case GL_UNSIGNED_SHORT_4_4_4_4:
1976 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
1977 case GL_UNSIGNED_SHORT_5_5_5_1:
1978 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
1979 case GL_UNSIGNED_INT_8_8_8_8:
1980 case GL_UNSIGNED_INT_8_8_8_8_REV:
1981 case GL_UNSIGNED_INT_10_10_10_2:
1982 case GL_UNSIGNED_INT_2_10_10_10_REV:
1983 case GL_HALF_FLOAT:
1984 return GL_NO_ERROR;
1985 default:
1986 return GL_INVALID_ENUM;
1987 }
1988
1989 case GL_ABGR_EXT:
1990 switch (type) {
1991 case GL_BYTE:
1992 case GL_UNSIGNED_BYTE:
1993 case GL_SHORT:
1994 case GL_UNSIGNED_SHORT:
1995 case GL_INT:
1996 case GL_UNSIGNED_INT:
1997 case GL_FLOAT:
1998 case GL_UNSIGNED_SHORT_4_4_4_4:
1999 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
2000 case GL_UNSIGNED_INT_8_8_8_8:
2001 case GL_UNSIGNED_INT_8_8_8_8_REV:
2002 case GL_HALF_FLOAT:
2003 return GL_NO_ERROR;
2004 default:
2005 return GL_INVALID_ENUM;
2006 }
2007
2008 case GL_YCBCR_MESA:
2009 if (!ctx->Extensions.MESA_ycbcr_texture)
2010 return GL_INVALID_ENUM;
2011 if (type == GL_UNSIGNED_SHORT_8_8_MESA ||
2012 type == GL_UNSIGNED_SHORT_8_8_REV_MESA)
2013 return GL_NO_ERROR;
2014 else
2015 return GL_INVALID_OPERATION;
2016
2017 case GL_DEPTH_STENCIL:
2018 if (type == GL_UNSIGNED_INT_24_8)
2019 return GL_NO_ERROR;
2020 else if (ctx->Extensions.ARB_depth_buffer_float &&
2021 type == GL_FLOAT_32_UNSIGNED_INT_24_8_REV)
2022 return GL_NO_ERROR;
2023 else
2024 return GL_INVALID_ENUM;
2025
2026 /* integer-valued formats */
2027 case GL_RED_INTEGER_EXT:
2028 case GL_GREEN_INTEGER_EXT:
2029 case GL_BLUE_INTEGER_EXT:
2030 case GL_ALPHA_INTEGER_EXT:
2031 case GL_RG_INTEGER:
2032 switch (type) {
2033 case GL_BYTE:
2034 case GL_UNSIGNED_BYTE:
2035 case GL_SHORT:
2036 case GL_UNSIGNED_SHORT:
2037 case GL_INT:
2038 case GL_UNSIGNED_INT:
2039 return (ctx->Version >= 30 ||
2040 ctx->Extensions.EXT_texture_integer)
2041 ? GL_NO_ERROR : GL_INVALID_ENUM;
2042 default:
2043 return GL_INVALID_ENUM;
2044 }
2045
2046 case GL_RGB_INTEGER_EXT:
2047 switch (type) {
2048 case GL_BYTE:
2049 case GL_UNSIGNED_BYTE:
2050 case GL_SHORT:
2051 case GL_UNSIGNED_SHORT:
2052 case GL_INT:
2053 case GL_UNSIGNED_INT:
2054 return (ctx->Version >= 30 ||
2055 ctx->Extensions.EXT_texture_integer)
2056 ? GL_NO_ERROR : GL_INVALID_ENUM;
2057 case GL_UNSIGNED_BYTE_3_3_2:
2058 case GL_UNSIGNED_BYTE_2_3_3_REV:
2059 case GL_UNSIGNED_SHORT_5_6_5:
2060 case GL_UNSIGNED_SHORT_5_6_5_REV:
2061 return ctx->Extensions.ARB_texture_rgb10_a2ui
2062 ? GL_NO_ERROR : GL_INVALID_ENUM;
2063 default:
2064 return GL_INVALID_ENUM;
2065 }
2066
2067 case GL_BGR_INTEGER_EXT:
2068 switch (type) {
2069 case GL_BYTE:
2070 case GL_UNSIGNED_BYTE:
2071 case GL_SHORT:
2072 case GL_UNSIGNED_SHORT:
2073 case GL_INT:
2074 case GL_UNSIGNED_INT:
2075 /* NOTE: no packed formats w/ BGR format */
2076 return (ctx->Version >= 30 ||
2077 ctx->Extensions.EXT_texture_integer)
2078 ? GL_NO_ERROR : GL_INVALID_ENUM;
2079 default:
2080 return GL_INVALID_ENUM;
2081 }
2082
2083 case GL_RGBA_INTEGER_EXT:
2084 case GL_BGRA_INTEGER_EXT:
2085 switch (type) {
2086 case GL_BYTE:
2087 case GL_UNSIGNED_BYTE:
2088 case GL_SHORT:
2089 case GL_UNSIGNED_SHORT:
2090 case GL_INT:
2091 case GL_UNSIGNED_INT:
2092 return (ctx->Version >= 30 ||
2093 ctx->Extensions.EXT_texture_integer)
2094 ? GL_NO_ERROR : GL_INVALID_ENUM;
2095 case GL_UNSIGNED_SHORT_4_4_4_4:
2096 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
2097 case GL_UNSIGNED_SHORT_5_5_5_1:
2098 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
2099 case GL_UNSIGNED_INT_8_8_8_8:
2100 case GL_UNSIGNED_INT_8_8_8_8_REV:
2101 case GL_UNSIGNED_INT_10_10_10_2:
2102 case GL_UNSIGNED_INT_2_10_10_10_REV:
2103 return ctx->Extensions.ARB_texture_rgb10_a2ui
2104 ? GL_NO_ERROR : GL_INVALID_ENUM;
2105 default:
2106 return GL_INVALID_ENUM;
2107 }
2108
2109 case GL_LUMINANCE_INTEGER_EXT:
2110 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
2111 switch (type) {
2112 case GL_BYTE:
2113 case GL_UNSIGNED_BYTE:
2114 case GL_SHORT:
2115 case GL_UNSIGNED_SHORT:
2116 case GL_INT:
2117 case GL_UNSIGNED_INT:
2118 return ctx->Extensions.EXT_texture_integer
2119 ? GL_NO_ERROR : GL_INVALID_ENUM;
2120 default:
2121 return GL_INVALID_ENUM;
2122 }
2123
2124 default:
2125 return GL_INVALID_ENUM;
2126 }
2127 return GL_NO_ERROR;
2128 }
2129
2130
2131 /**
2132 * Do error checking of format/type combinations for OpenGL ES glReadPixels
2133 * and glTex[Sub]Image.
2134 * \return error code, or GL_NO_ERROR.
2135 */
2136 GLenum
2137 _mesa_es_error_check_format_and_type(const struct gl_context *ctx,
2138 GLenum format, GLenum type,
2139 unsigned dimensions)
2140 {
2141 GLboolean type_valid = GL_TRUE;
2142
2143 switch (format) {
2144 case GL_RED:
2145 case GL_RG:
2146 if (ctx->API == API_OPENGLES || !ctx->Extensions.ARB_texture_rg)
2147 return GL_INVALID_VALUE;
2148 /* fallthrough */
2149 case GL_ALPHA:
2150 case GL_LUMINANCE:
2151 case GL_LUMINANCE_ALPHA:
2152 type_valid = (type == GL_UNSIGNED_BYTE
2153 || type == GL_FLOAT
2154 || type == GL_HALF_FLOAT_OES);
2155 break;
2156
2157 case GL_RGB:
2158 type_valid = (type == GL_UNSIGNED_BYTE
2159 || type == GL_UNSIGNED_SHORT_5_6_5
2160 || type == GL_FLOAT
2161 || type == GL_HALF_FLOAT_OES);
2162 break;
2163
2164 case GL_RGBA:
2165 type_valid = (type == GL_UNSIGNED_BYTE
2166 || type == GL_UNSIGNED_SHORT_4_4_4_4
2167 || type == GL_UNSIGNED_SHORT_5_5_5_1
2168 || type == GL_FLOAT
2169 || type == GL_HALF_FLOAT_OES
2170 || type == GL_UNSIGNED_INT_2_10_10_10_REV);
2171 break;
2172
2173 case GL_DEPTH_COMPONENT:
2174 /* This format is filtered against invalid dimensionalities elsewhere.
2175 */
2176 type_valid = (type == GL_UNSIGNED_SHORT
2177 || type == GL_UNSIGNED_INT);
2178 break;
2179
2180 case GL_DEPTH_STENCIL:
2181 /* This format is filtered against invalid dimensionalities elsewhere.
2182 */
2183 type_valid = (type == GL_UNSIGNED_INT_24_8);
2184 break;
2185
2186 case GL_BGRA_EXT:
2187 type_valid = (type == GL_UNSIGNED_BYTE);
2188
2189 /* This feels like a bug in the EXT_texture_format_BGRA8888 spec, but
2190 * the format does not appear to be allowed for 3D textures in OpenGL
2191 * ES.
2192 */
2193 if (dimensions != 2)
2194 return GL_INVALID_VALUE;
2195
2196 break;
2197
2198 default:
2199 return GL_INVALID_VALUE;
2200 }
2201
2202 return type_valid ? GL_NO_ERROR : GL_INVALID_OPERATION;
2203 }
2204
2205 /**
2206 * Return the simple base format for a given internal texture format.
2207 * For example, given GL_LUMINANCE12_ALPHA4, return GL_LUMINANCE_ALPHA.
2208 *
2209 * \param ctx GL context.
2210 * \param internalFormat the internal texture format token or 1, 2, 3, or 4.
2211 *
2212 * \return the corresponding \u base internal format (GL_ALPHA, GL_LUMINANCE,
2213 * GL_LUMANCE_ALPHA, GL_INTENSITY, GL_RGB, or GL_RGBA), or -1 if invalid enum.
2214 *
2215 * This is the format which is used during texture application (i.e. the
2216 * texture format and env mode determine the arithmetic used.
2217 */
2218 GLint
2219 _mesa_base_tex_format(const struct gl_context *ctx, GLint internalFormat)
2220 {
2221 switch (internalFormat) {
2222 case GL_ALPHA:
2223 case GL_ALPHA4:
2224 case GL_ALPHA8:
2225 case GL_ALPHA12:
2226 case GL_ALPHA16:
2227 return (ctx->API != API_OPENGL_CORE) ? GL_ALPHA : -1;
2228 case 1:
2229 case GL_LUMINANCE:
2230 case GL_LUMINANCE4:
2231 case GL_LUMINANCE8:
2232 case GL_LUMINANCE12:
2233 case GL_LUMINANCE16:
2234 return (ctx->API != API_OPENGL_CORE) ? GL_LUMINANCE : -1;
2235 case 2:
2236 case GL_LUMINANCE_ALPHA:
2237 case GL_LUMINANCE4_ALPHA4:
2238 case GL_LUMINANCE6_ALPHA2:
2239 case GL_LUMINANCE8_ALPHA8:
2240 case GL_LUMINANCE12_ALPHA4:
2241 case GL_LUMINANCE12_ALPHA12:
2242 case GL_LUMINANCE16_ALPHA16:
2243 return (ctx->API != API_OPENGL_CORE) ? GL_LUMINANCE_ALPHA : -1;
2244 case GL_INTENSITY:
2245 case GL_INTENSITY4:
2246 case GL_INTENSITY8:
2247 case GL_INTENSITY12:
2248 case GL_INTENSITY16:
2249 return (ctx->API != API_OPENGL_CORE) ? GL_INTENSITY : -1;
2250 case 3:
2251 return (ctx->API != API_OPENGL_CORE) ? GL_RGB : -1;
2252 case GL_RGB:
2253 case GL_R3_G3_B2:
2254 case GL_RGB4:
2255 case GL_RGB5:
2256 case GL_RGB8:
2257 case GL_RGB10:
2258 case GL_RGB12:
2259 case GL_RGB16:
2260 return GL_RGB;
2261 case 4:
2262 return (ctx->API != API_OPENGL_CORE) ? GL_RGBA : -1;
2263 case GL_RGBA:
2264 case GL_RGBA2:
2265 case GL_RGBA4:
2266 case GL_RGB5_A1:
2267 case GL_RGBA8:
2268 case GL_RGB10_A2:
2269 case GL_RGBA12:
2270 case GL_RGBA16:
2271 return GL_RGBA;
2272 default:
2273 ; /* fallthrough */
2274 }
2275
2276 /* GL_BGRA can be an internal format *only* in OpenGL ES (1.x or 2.0).
2277 */
2278 if (_mesa_is_gles(ctx)) {
2279 switch (internalFormat) {
2280 case GL_BGRA:
2281 return GL_RGBA;
2282 default:
2283 ; /* fallthrough */
2284 }
2285 }
2286
2287 if (ctx->Extensions.ARB_ES2_compatibility) {
2288 switch (internalFormat) {
2289 case GL_RGB565:
2290 return GL_RGB;
2291 default:
2292 ; /* fallthrough */
2293 }
2294 }
2295
2296 if (ctx->Extensions.ARB_depth_texture) {
2297 switch (internalFormat) {
2298 case GL_DEPTH_COMPONENT:
2299 case GL_DEPTH_COMPONENT16:
2300 case GL_DEPTH_COMPONENT24:
2301 case GL_DEPTH_COMPONENT32:
2302 return GL_DEPTH_COMPONENT;
2303 case GL_DEPTH_STENCIL:
2304 case GL_DEPTH24_STENCIL8:
2305 return GL_DEPTH_STENCIL;
2306 default:
2307 ; /* fallthrough */
2308 }
2309 }
2310
2311 if (ctx->Extensions.ARB_texture_stencil8) {
2312 switch (internalFormat) {
2313 case GL_STENCIL_INDEX:
2314 case GL_STENCIL_INDEX1:
2315 case GL_STENCIL_INDEX4:
2316 case GL_STENCIL_INDEX8:
2317 case GL_STENCIL_INDEX16:
2318 return GL_STENCIL_INDEX;
2319 default:
2320 ; /* fallthrough */
2321 }
2322 }
2323
2324 switch (internalFormat) {
2325 case GL_COMPRESSED_ALPHA:
2326 return GL_ALPHA;
2327 case GL_COMPRESSED_LUMINANCE:
2328 return GL_LUMINANCE;
2329 case GL_COMPRESSED_LUMINANCE_ALPHA:
2330 return GL_LUMINANCE_ALPHA;
2331 case GL_COMPRESSED_INTENSITY:
2332 return GL_INTENSITY;
2333 case GL_COMPRESSED_RGB:
2334 return GL_RGB;
2335 case GL_COMPRESSED_RGBA:
2336 return GL_RGBA;
2337 default:
2338 ; /* fallthrough */
2339 }
2340
2341 if (_mesa_is_compressed_format(ctx, internalFormat)) {
2342 GLenum base_compressed =
2343 _mesa_gl_compressed_format_base_format(internalFormat);
2344 if (base_compressed)
2345 return base_compressed;
2346 }
2347
2348 if (ctx->Extensions.KHR_texture_compression_astc_ldr &&
2349 _mesa_is_astc_format(internalFormat))
2350 return GL_RGBA;
2351
2352 if (ctx->Extensions.MESA_ycbcr_texture) {
2353 if (internalFormat == GL_YCBCR_MESA)
2354 return GL_YCBCR_MESA;
2355 }
2356
2357 if (ctx->Extensions.ARB_texture_float) {
2358 switch (internalFormat) {
2359 case GL_ALPHA16F_ARB:
2360 case GL_ALPHA32F_ARB:
2361 return GL_ALPHA;
2362 case GL_RGBA16F_ARB:
2363 case GL_RGBA32F_ARB:
2364 return GL_RGBA;
2365 case GL_RGB16F_ARB:
2366 case GL_RGB32F_ARB:
2367 return GL_RGB;
2368 case GL_INTENSITY16F_ARB:
2369 case GL_INTENSITY32F_ARB:
2370 return GL_INTENSITY;
2371 case GL_LUMINANCE16F_ARB:
2372 case GL_LUMINANCE32F_ARB:
2373 return GL_LUMINANCE;
2374 case GL_LUMINANCE_ALPHA16F_ARB:
2375 case GL_LUMINANCE_ALPHA32F_ARB:
2376 return GL_LUMINANCE_ALPHA;
2377 default:
2378 ; /* fallthrough */
2379 }
2380 }
2381
2382 if (ctx->Extensions.EXT_texture_snorm) {
2383 switch (internalFormat) {
2384 case GL_RED_SNORM:
2385 case GL_R8_SNORM:
2386 case GL_R16_SNORM:
2387 return GL_RED;
2388 case GL_RG_SNORM:
2389 case GL_RG8_SNORM:
2390 case GL_RG16_SNORM:
2391 return GL_RG;
2392 case GL_RGB_SNORM:
2393 case GL_RGB8_SNORM:
2394 case GL_RGB16_SNORM:
2395 return GL_RGB;
2396 case GL_RGBA_SNORM:
2397 case GL_RGBA8_SNORM:
2398 case GL_RGBA16_SNORM:
2399 return GL_RGBA;
2400 case GL_ALPHA_SNORM:
2401 case GL_ALPHA8_SNORM:
2402 case GL_ALPHA16_SNORM:
2403 return GL_ALPHA;
2404 case GL_LUMINANCE_SNORM:
2405 case GL_LUMINANCE8_SNORM:
2406 case GL_LUMINANCE16_SNORM:
2407 return GL_LUMINANCE;
2408 case GL_LUMINANCE_ALPHA_SNORM:
2409 case GL_LUMINANCE8_ALPHA8_SNORM:
2410 case GL_LUMINANCE16_ALPHA16_SNORM:
2411 return GL_LUMINANCE_ALPHA;
2412 case GL_INTENSITY_SNORM:
2413 case GL_INTENSITY8_SNORM:
2414 case GL_INTENSITY16_SNORM:
2415 return GL_INTENSITY;
2416 default:
2417 ; /* fallthrough */
2418 }
2419 }
2420
2421 if (ctx->Extensions.EXT_texture_sRGB) {
2422 switch (internalFormat) {
2423 case GL_SRGB_EXT:
2424 case GL_SRGB8_EXT:
2425 case GL_COMPRESSED_SRGB_EXT:
2426 return GL_RGB;
2427 case GL_SRGB_ALPHA_EXT:
2428 case GL_SRGB8_ALPHA8_EXT:
2429 case GL_COMPRESSED_SRGB_ALPHA_EXT:
2430 return GL_RGBA;
2431 case GL_SLUMINANCE_ALPHA_EXT:
2432 case GL_SLUMINANCE8_ALPHA8_EXT:
2433 case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT:
2434 return GL_LUMINANCE_ALPHA;
2435 case GL_SLUMINANCE_EXT:
2436 case GL_SLUMINANCE8_EXT:
2437 case GL_COMPRESSED_SLUMINANCE_EXT:
2438 return GL_LUMINANCE;
2439 default:
2440 ; /* fallthrough */
2441 }
2442 }
2443
2444 if (ctx->Version >= 30 ||
2445 ctx->Extensions.EXT_texture_integer) {
2446 switch (internalFormat) {
2447 case GL_RGBA8UI_EXT:
2448 case GL_RGBA16UI_EXT:
2449 case GL_RGBA32UI_EXT:
2450 case GL_RGBA8I_EXT:
2451 case GL_RGBA16I_EXT:
2452 case GL_RGBA32I_EXT:
2453 case GL_RGB10_A2UI:
2454 return GL_RGBA;
2455 case GL_RGB8UI_EXT:
2456 case GL_RGB16UI_EXT:
2457 case GL_RGB32UI_EXT:
2458 case GL_RGB8I_EXT:
2459 case GL_RGB16I_EXT:
2460 case GL_RGB32I_EXT:
2461 return GL_RGB;
2462 }
2463 }
2464
2465 if (ctx->Extensions.EXT_texture_integer) {
2466 switch (internalFormat) {
2467 case GL_ALPHA8UI_EXT:
2468 case GL_ALPHA16UI_EXT:
2469 case GL_ALPHA32UI_EXT:
2470 case GL_ALPHA8I_EXT:
2471 case GL_ALPHA16I_EXT:
2472 case GL_ALPHA32I_EXT:
2473 return GL_ALPHA;
2474 case GL_INTENSITY8UI_EXT:
2475 case GL_INTENSITY16UI_EXT:
2476 case GL_INTENSITY32UI_EXT:
2477 case GL_INTENSITY8I_EXT:
2478 case GL_INTENSITY16I_EXT:
2479 case GL_INTENSITY32I_EXT:
2480 return GL_INTENSITY;
2481 case GL_LUMINANCE8UI_EXT:
2482 case GL_LUMINANCE16UI_EXT:
2483 case GL_LUMINANCE32UI_EXT:
2484 case GL_LUMINANCE8I_EXT:
2485 case GL_LUMINANCE16I_EXT:
2486 case GL_LUMINANCE32I_EXT:
2487 return GL_LUMINANCE;
2488 case GL_LUMINANCE_ALPHA8UI_EXT:
2489 case GL_LUMINANCE_ALPHA16UI_EXT:
2490 case GL_LUMINANCE_ALPHA32UI_EXT:
2491 case GL_LUMINANCE_ALPHA8I_EXT:
2492 case GL_LUMINANCE_ALPHA16I_EXT:
2493 case GL_LUMINANCE_ALPHA32I_EXT:
2494 return GL_LUMINANCE_ALPHA;
2495 default:
2496 ; /* fallthrough */
2497 }
2498 }
2499
2500 if (ctx->Extensions.ARB_texture_rg) {
2501 switch (internalFormat) {
2502 case GL_R16F:
2503 case GL_R32F:
2504 if (!ctx->Extensions.ARB_texture_float)
2505 break;
2506 return GL_RED;
2507 case GL_R8I:
2508 case GL_R8UI:
2509 case GL_R16I:
2510 case GL_R16UI:
2511 case GL_R32I:
2512 case GL_R32UI:
2513 if (ctx->Version < 30 && !ctx->Extensions.EXT_texture_integer)
2514 break;
2515 /* FALLTHROUGH */
2516 case GL_R8:
2517 case GL_R16:
2518 case GL_RED:
2519 case GL_COMPRESSED_RED:
2520 return GL_RED;
2521
2522 case GL_RG16F:
2523 case GL_RG32F:
2524 if (!ctx->Extensions.ARB_texture_float)
2525 break;
2526 return GL_RG;
2527 case GL_RG8I:
2528 case GL_RG8UI:
2529 case GL_RG16I:
2530 case GL_RG16UI:
2531 case GL_RG32I:
2532 case GL_RG32UI:
2533 if (ctx->Version < 30 && !ctx->Extensions.EXT_texture_integer)
2534 break;
2535 /* FALLTHROUGH */
2536 case GL_RG:
2537 case GL_RG8:
2538 case GL_RG16:
2539 case GL_COMPRESSED_RG:
2540 return GL_RG;
2541 default:
2542 ; /* fallthrough */
2543 }
2544 }
2545
2546 if (ctx->Extensions.EXT_texture_shared_exponent) {
2547 switch (internalFormat) {
2548 case GL_RGB9_E5_EXT:
2549 return GL_RGB;
2550 default:
2551 ; /* fallthrough */
2552 }
2553 }
2554
2555 if (ctx->Extensions.EXT_packed_float) {
2556 switch (internalFormat) {
2557 case GL_R11F_G11F_B10F_EXT:
2558 return GL_RGB;
2559 default:
2560 ; /* fallthrough */
2561 }
2562 }
2563
2564 if (ctx->Extensions.ARB_depth_buffer_float) {
2565 switch (internalFormat) {
2566 case GL_DEPTH_COMPONENT32F:
2567 return GL_DEPTH_COMPONENT;
2568 case GL_DEPTH32F_STENCIL8:
2569 return GL_DEPTH_STENCIL;
2570 default:
2571 ; /* fallthrough */
2572 }
2573 }
2574
2575 return -1; /* error */
2576 }
2577
2578 /**
2579 * Returns the effective internal format from a texture format and type.
2580 * This is used by texture image operations internally for validation, when
2581 * the specified internal format is a base (unsized) format.
2582 *
2583 * This method will only return a valid effective internal format if the
2584 * combination of format, type and internal format in base form, is acceptable.
2585 *
2586 * If a single sized internal format is defined in the spec (OpenGL-ES 3.0.4) or
2587 * in extensions, to unambiguously correspond to the given base format, then
2588 * that internal format is returned as the effective. Otherwise, if the
2589 * combination is accepted but a single effective format is not defined, the
2590 * passed base format will be returned instead.
2591 *
2592 * \param format the texture format
2593 * \param type the texture type
2594 */
2595 static GLenum
2596 _mesa_es3_effective_internal_format_for_format_and_type(GLenum format,
2597 GLenum type)
2598 {
2599 switch (type) {
2600 case GL_UNSIGNED_BYTE:
2601 switch (format) {
2602 case GL_RGBA:
2603 return GL_RGBA8;
2604 case GL_RGB:
2605 return GL_RGB8;
2606 case GL_RG:
2607 return GL_RG8;
2608 case GL_RED:
2609 return GL_R8;
2610 /* Although LUMINANCE_ALPHA, LUMINANCE and ALPHA appear in table 3.12,
2611 * (section 3.8 Texturing, page 128 of the OpenGL-ES 3.0.4) as effective
2612 * internal formats, they do not correspond to GL constants, so the base
2613 * format is returned instead.
2614 */
2615 case GL_BGRA_EXT:
2616 case GL_LUMINANCE_ALPHA:
2617 case GL_LUMINANCE:
2618 case GL_ALPHA:
2619 return format;
2620 }
2621 break;
2622
2623 case GL_UNSIGNED_SHORT_4_4_4_4:
2624 if (format == GL_RGBA)
2625 return GL_RGBA4;
2626 break;
2627
2628 case GL_UNSIGNED_SHORT_5_5_5_1:
2629 if (format == GL_RGBA)
2630 return GL_RGB5_A1;
2631 break;
2632
2633 case GL_UNSIGNED_SHORT_5_6_5:
2634 if (format == GL_RGB)
2635 return GL_RGB565;
2636 break;
2637
2638 /* OES_packed_depth_stencil */
2639 case GL_UNSIGNED_INT_24_8:
2640 if (format == GL_DEPTH_STENCIL)
2641 return GL_DEPTH24_STENCIL8;
2642 break;
2643
2644 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
2645 if (format == GL_DEPTH_STENCIL)
2646 return GL_DEPTH32F_STENCIL8;
2647 break;
2648
2649 case GL_UNSIGNED_SHORT:
2650 if (format == GL_DEPTH_COMPONENT)
2651 return GL_DEPTH_COMPONENT16;
2652 break;
2653
2654 case GL_UNSIGNED_INT:
2655 /* It can be DEPTH_COMPONENT16 or DEPTH_COMPONENT24, so just return
2656 * the format.
2657 */
2658 if (format == GL_DEPTH_COMPONENT)
2659 return format;
2660 break;
2661
2662 /* OES_texture_float and OES_texture_half_float */
2663 case GL_FLOAT:
2664 if (format == GL_DEPTH_COMPONENT)
2665 return GL_DEPTH_COMPONENT32F;
2666 /* fall through */
2667 case GL_HALF_FLOAT_OES:
2668 switch (format) {
2669 case GL_RGBA:
2670 case GL_RGB:
2671 case GL_LUMINANCE_ALPHA:
2672 case GL_LUMINANCE:
2673 case GL_ALPHA:
2674 case GL_RED:
2675 case GL_RG:
2676 return format;
2677 }
2678 break;
2679 case GL_HALF_FLOAT:
2680 switch (format) {
2681 case GL_RG:
2682 case GL_RED:
2683 return format;
2684 }
2685 break;
2686
2687 /* GL_EXT_texture_type_2_10_10_10_REV */
2688 case GL_UNSIGNED_INT_2_10_10_10_REV:
2689 switch (format) {
2690 case GL_RGBA:
2691 case GL_RGB:
2692 return format;
2693 }
2694 break;
2695
2696 default:
2697 /* fall through and return NONE */
2698 break;
2699 }
2700
2701 return GL_NONE;
2702 }
2703
2704 /**
2705 * Do error checking of format/type combinations for OpenGL ES 3
2706 * glTex[Sub]Image.
2707 * \return error code, or GL_NO_ERROR.
2708 */
2709 GLenum
2710 _mesa_es3_error_check_format_and_type(const struct gl_context *ctx,
2711 GLenum format, GLenum type,
2712 GLenum internalFormat)
2713 {
2714 /* If internalFormat is an unsized format, then the effective internal
2715 * format derived from format and type should be used instead. Page 127,
2716 * section "3.8 Texturing" of the GLES 3.0.4 spec states:
2717 *
2718 * "if internalformat is a base internal format, the effective
2719 * internal format is a sized internal format that is derived
2720 * from the format and type for internal use by the GL.
2721 * Table 3.12 specifies the mapping of format and type to effective
2722 * internal formats. The effective internal format is used by the GL
2723 * for purposes such as texture completeness or type checks for
2724 * CopyTex* commands. In these cases, the GL is required to operate
2725 * as if the effective internal format was used as the internalformat
2726 * when specifying the texture data."
2727 */
2728 if (_mesa_is_enum_format_unsized(internalFormat)) {
2729 GLenum effectiveInternalFormat =
2730 _mesa_es3_effective_internal_format_for_format_and_type(format, type);
2731
2732 if (effectiveInternalFormat == GL_NONE)
2733 return GL_INVALID_OPERATION;
2734
2735 GLenum baseInternalFormat;
2736 if (internalFormat == GL_BGRA_EXT) {
2737 /* Unfortunately, _mesa_base_tex_format returns a base format of
2738 * GL_RGBA for GL_BGRA_EXT. This makes perfect sense if you're
2739 * asking the question, "what channels does this format have?"
2740 * However, if we're trying to determine if two internal formats
2741 * match in the ES3 sense, we actually want GL_BGRA.
2742 */
2743 baseInternalFormat = GL_BGRA_EXT;
2744 } else {
2745 baseInternalFormat =
2746 _mesa_base_tex_format(ctx, effectiveInternalFormat);
2747 }
2748
2749 if (internalFormat != baseInternalFormat)
2750 return GL_INVALID_OPERATION;
2751
2752 internalFormat = effectiveInternalFormat;
2753 }
2754
2755 switch (format) {
2756 case GL_BGRA_EXT:
2757 if (type != GL_UNSIGNED_BYTE || internalFormat != GL_BGRA)
2758 return GL_INVALID_OPERATION;
2759 break;
2760
2761 case GL_RGBA:
2762 switch (type) {
2763 case GL_UNSIGNED_BYTE:
2764 switch (internalFormat) {
2765 case GL_RGBA:
2766 case GL_RGBA8:
2767 case GL_RGB5_A1:
2768 case GL_RGBA4:
2769 case GL_SRGB8_ALPHA8_EXT:
2770 break;
2771 default:
2772 return GL_INVALID_OPERATION;
2773 }
2774 break;
2775
2776 case GL_BYTE:
2777 if (internalFormat != GL_RGBA8_SNORM)
2778 return GL_INVALID_OPERATION;
2779 break;
2780
2781 case GL_UNSIGNED_SHORT_4_4_4_4:
2782 switch (internalFormat) {
2783 case GL_RGBA:
2784 case GL_RGBA4:
2785 break;
2786 default:
2787 return GL_INVALID_OPERATION;
2788 }
2789 break;
2790
2791 case GL_UNSIGNED_SHORT_5_5_5_1:
2792 switch (internalFormat) {
2793 case GL_RGBA:
2794 case GL_RGB5_A1:
2795 break;
2796 default:
2797 return GL_INVALID_OPERATION;
2798 }
2799 break;
2800
2801 case GL_UNSIGNED_INT_2_10_10_10_REV:
2802 switch (internalFormat) {
2803 case GL_RGBA: /* GL_EXT_texture_type_2_10_10_10_REV */
2804 case GL_RGB10_A2:
2805 case GL_RGB5_A1:
2806 break;
2807 default:
2808 return GL_INVALID_OPERATION;
2809 }
2810 break;
2811
2812 case GL_HALF_FLOAT:
2813 if (internalFormat != GL_RGBA16F)
2814 return GL_INVALID_OPERATION;
2815 break;
2816
2817 case GL_FLOAT:
2818 switch (internalFormat) {
2819 case GL_RGBA16F:
2820 case GL_RGBA32F:
2821 break;
2822 case GL_RGBA:
2823 if (ctx->Extensions.OES_texture_float && internalFormat == format)
2824 break;
2825 default:
2826 return GL_INVALID_OPERATION;
2827 }
2828 break;
2829
2830 case GL_HALF_FLOAT_OES:
2831 if (ctx->Extensions.OES_texture_half_float && internalFormat == format)
2832 break;
2833 default:
2834 return GL_INVALID_OPERATION;
2835 }
2836 break;
2837
2838 case GL_RGBA_INTEGER:
2839 switch (type) {
2840 case GL_UNSIGNED_BYTE:
2841 if (internalFormat != GL_RGBA8UI)
2842 return GL_INVALID_OPERATION;
2843 break;
2844
2845 case GL_BYTE:
2846 if (internalFormat != GL_RGBA8I)
2847 return GL_INVALID_OPERATION;
2848 break;
2849
2850 case GL_UNSIGNED_SHORT:
2851 if (internalFormat != GL_RGBA16UI)
2852 return GL_INVALID_OPERATION;
2853 break;
2854
2855 case GL_SHORT:
2856 if (internalFormat != GL_RGBA16I)
2857 return GL_INVALID_OPERATION;
2858 break;
2859
2860 case GL_UNSIGNED_INT:
2861 if (internalFormat != GL_RGBA32UI)
2862 return GL_INVALID_OPERATION;
2863 break;
2864
2865 case GL_INT:
2866 if (internalFormat != GL_RGBA32I)
2867 return GL_INVALID_OPERATION;
2868 break;
2869
2870 case GL_UNSIGNED_INT_2_10_10_10_REV:
2871 if (internalFormat != GL_RGB10_A2UI)
2872 return GL_INVALID_OPERATION;
2873 break;
2874
2875 default:
2876 return GL_INVALID_OPERATION;
2877 }
2878 break;
2879
2880 case GL_RGB:
2881 switch (type) {
2882 case GL_UNSIGNED_BYTE:
2883 switch (internalFormat) {
2884 case GL_RGB:
2885 case GL_RGB8:
2886 case GL_RGB565:
2887 case GL_SRGB8:
2888 break;
2889 default:
2890 return GL_INVALID_OPERATION;
2891 }
2892 break;
2893
2894 case GL_BYTE:
2895 if (internalFormat != GL_RGB8_SNORM)
2896 return GL_INVALID_OPERATION;
2897 break;
2898
2899 case GL_UNSIGNED_SHORT_5_6_5:
2900 switch (internalFormat) {
2901 case GL_RGB:
2902 case GL_RGB565:
2903 break;
2904 default:
2905 return GL_INVALID_OPERATION;
2906 }
2907 break;
2908
2909 case GL_UNSIGNED_INT_10F_11F_11F_REV:
2910 if (internalFormat != GL_R11F_G11F_B10F)
2911 return GL_INVALID_OPERATION;
2912 break;
2913
2914 case GL_UNSIGNED_INT_5_9_9_9_REV:
2915 if (internalFormat != GL_RGB9_E5)
2916 return GL_INVALID_OPERATION;
2917 break;
2918
2919 case GL_HALF_FLOAT:
2920 switch (internalFormat) {
2921 case GL_RGB16F:
2922 case GL_R11F_G11F_B10F:
2923 case GL_RGB9_E5:
2924 break;
2925 default:
2926 return GL_INVALID_OPERATION;
2927 }
2928 break;
2929
2930 case GL_FLOAT:
2931 switch (internalFormat) {
2932 case GL_RGB16F:
2933 case GL_RGB32F:
2934 case GL_R11F_G11F_B10F:
2935 case GL_RGB9_E5:
2936 break;
2937 case GL_RGB:
2938 if (ctx->Extensions.OES_texture_float && internalFormat == format)
2939 break;
2940 default:
2941 return GL_INVALID_OPERATION;
2942 }
2943 break;
2944
2945 case GL_HALF_FLOAT_OES:
2946 if (!ctx->Extensions.OES_texture_half_float || internalFormat != format)
2947 return GL_INVALID_OPERATION;
2948 break;
2949
2950 case GL_UNSIGNED_INT_2_10_10_10_REV:
2951 switch (internalFormat) {
2952 case GL_RGB: /* GL_EXT_texture_type_2_10_10_10_REV */
2953 break;
2954 default:
2955 return GL_INVALID_OPERATION;
2956 }
2957 break;
2958
2959 default:
2960 return GL_INVALID_OPERATION;
2961 }
2962 break;
2963
2964 case GL_RGB_INTEGER:
2965 switch (type) {
2966 case GL_UNSIGNED_BYTE:
2967 if (internalFormat != GL_RGB8UI)
2968 return GL_INVALID_OPERATION;
2969 break;
2970
2971 case GL_BYTE:
2972 if (internalFormat != GL_RGB8I)
2973 return GL_INVALID_OPERATION;
2974 break;
2975
2976 case GL_UNSIGNED_SHORT:
2977 if (internalFormat != GL_RGB16UI)
2978 return GL_INVALID_OPERATION;
2979 break;
2980
2981 case GL_SHORT:
2982 if (internalFormat != GL_RGB16I)
2983 return GL_INVALID_OPERATION;
2984 break;
2985
2986 case GL_UNSIGNED_INT:
2987 if (internalFormat != GL_RGB32UI)
2988 return GL_INVALID_OPERATION;
2989 break;
2990
2991 case GL_INT:
2992 if (internalFormat != GL_RGB32I)
2993 return GL_INVALID_OPERATION;
2994 break;
2995
2996 default:
2997 return GL_INVALID_OPERATION;
2998 }
2999 break;
3000
3001 case GL_RG:
3002 switch (type) {
3003 case GL_UNSIGNED_BYTE:
3004 if (internalFormat != GL_RG8)
3005 return GL_INVALID_OPERATION;
3006 break;
3007
3008 case GL_BYTE:
3009 if (internalFormat != GL_RG8_SNORM)
3010 return GL_INVALID_OPERATION;
3011 break;
3012
3013 case GL_HALF_FLOAT:
3014 case GL_HALF_FLOAT_OES:
3015 switch (internalFormat) {
3016 case GL_RG16F:
3017 break;
3018 case GL_RG:
3019 if (ctx->Extensions.ARB_texture_rg &&
3020 ctx->Extensions.OES_texture_half_float)
3021 break;
3022 /* fallthrough */
3023 default:
3024 return GL_INVALID_OPERATION;
3025 }
3026 break;
3027
3028 case GL_FLOAT:
3029 switch (internalFormat) {
3030 case GL_RG16F:
3031 case GL_RG32F:
3032 break;
3033 case GL_RG:
3034 if (ctx->Extensions.ARB_texture_rg &&
3035 ctx->Extensions.OES_texture_float)
3036 break;
3037 /* fallthrough */
3038 default:
3039 return GL_INVALID_OPERATION;
3040 }
3041 break;
3042
3043 default:
3044 return GL_INVALID_OPERATION;
3045 }
3046 break;
3047
3048 case GL_RG_INTEGER:
3049 switch (type) {
3050 case GL_UNSIGNED_BYTE:
3051 if (internalFormat != GL_RG8UI)
3052 return GL_INVALID_OPERATION;
3053 break;
3054
3055 case GL_BYTE:
3056 if (internalFormat != GL_RG8I)
3057 return GL_INVALID_OPERATION;
3058 break;
3059
3060 case GL_UNSIGNED_SHORT:
3061 if (internalFormat != GL_RG16UI)
3062 return GL_INVALID_OPERATION;
3063 break;
3064
3065 case GL_SHORT:
3066 if (internalFormat != GL_RG16I)
3067 return GL_INVALID_OPERATION;
3068 break;
3069
3070 case GL_UNSIGNED_INT:
3071 if (internalFormat != GL_RG32UI)
3072 return GL_INVALID_OPERATION;
3073 break;
3074
3075 case GL_INT:
3076 if (internalFormat != GL_RG32I)
3077 return GL_INVALID_OPERATION;
3078 break;
3079
3080 default:
3081 return GL_INVALID_OPERATION;
3082 }
3083 break;
3084
3085 case GL_RED:
3086 switch (type) {
3087 case GL_UNSIGNED_BYTE:
3088 if (internalFormat != GL_R8)
3089 return GL_INVALID_OPERATION;
3090 break;
3091
3092 case GL_BYTE:
3093 if (internalFormat != GL_R8_SNORM)
3094 return GL_INVALID_OPERATION;
3095 break;
3096
3097 case GL_HALF_FLOAT:
3098 case GL_HALF_FLOAT_OES:
3099 switch (internalFormat) {
3100 case GL_R16F:
3101 break;
3102 case GL_RG:
3103 case GL_RED:
3104 if (ctx->Extensions.ARB_texture_rg &&
3105 ctx->Extensions.OES_texture_half_float)
3106 break;
3107 /* fallthrough */
3108 default:
3109 return GL_INVALID_OPERATION;
3110 }
3111 break;
3112
3113 case GL_FLOAT:
3114 switch (internalFormat) {
3115 case GL_R16F:
3116 case GL_R32F:
3117 break;
3118 case GL_RED:
3119 if (ctx->Extensions.ARB_texture_rg &&
3120 ctx->Extensions.OES_texture_float)
3121 break;
3122 /* fallthrough */
3123 default:
3124 return GL_INVALID_OPERATION;
3125 }
3126 break;
3127
3128 default:
3129 return GL_INVALID_OPERATION;
3130 }
3131 break;
3132
3133 case GL_RED_INTEGER:
3134 switch (type) {
3135 case GL_UNSIGNED_BYTE:
3136 if (internalFormat != GL_R8UI)
3137 return GL_INVALID_OPERATION;
3138 break;
3139
3140 case GL_BYTE:
3141 if (internalFormat != GL_R8I)
3142 return GL_INVALID_OPERATION;
3143 break;
3144
3145 case GL_UNSIGNED_SHORT:
3146 if (internalFormat != GL_R16UI)
3147 return GL_INVALID_OPERATION;
3148 break;
3149
3150 case GL_SHORT:
3151 if (internalFormat != GL_R16I)
3152 return GL_INVALID_OPERATION;
3153 break;
3154
3155 case GL_UNSIGNED_INT:
3156 if (internalFormat != GL_R32UI)
3157 return GL_INVALID_OPERATION;
3158 break;
3159
3160 case GL_INT:
3161 if (internalFormat != GL_R32I)
3162 return GL_INVALID_OPERATION;
3163 break;
3164
3165 default:
3166 return GL_INVALID_OPERATION;
3167 }
3168 break;
3169
3170 case GL_DEPTH_COMPONENT:
3171 switch (type) {
3172 case GL_UNSIGNED_SHORT:
3173 if (internalFormat != GL_DEPTH_COMPONENT
3174 && internalFormat != GL_DEPTH_COMPONENT16)
3175 return GL_INVALID_OPERATION;
3176 break;
3177
3178 case GL_UNSIGNED_INT:
3179 switch (internalFormat) {
3180 case GL_DEPTH_COMPONENT:
3181 case GL_DEPTH_COMPONENT16:
3182 case GL_DEPTH_COMPONENT24:
3183 break;
3184 default:
3185 return GL_INVALID_OPERATION;
3186 }
3187 break;
3188
3189 case GL_FLOAT:
3190 if (internalFormat != GL_DEPTH_COMPONENT32F)
3191 return GL_INVALID_OPERATION;
3192 break;
3193
3194 default:
3195 return GL_INVALID_OPERATION;
3196 }
3197 break;
3198
3199 case GL_DEPTH_STENCIL:
3200 switch (type) {
3201 case GL_UNSIGNED_INT_24_8:
3202 if (internalFormat != GL_DEPTH_STENCIL
3203 && internalFormat != GL_DEPTH24_STENCIL8)
3204 return GL_INVALID_OPERATION;
3205 break;
3206
3207 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
3208 if (internalFormat != GL_DEPTH32F_STENCIL8)
3209 return GL_INVALID_OPERATION;
3210 break;
3211
3212 default:
3213 return GL_INVALID_OPERATION;
3214 }
3215 break;
3216
3217 case GL_STENCIL_INDEX:
3218 if (!_mesa_has_OES_texture_stencil8(ctx) ||
3219 type != GL_UNSIGNED_BYTE ||
3220 internalFormat != GL_STENCIL_INDEX8) {
3221 return GL_INVALID_OPERATION;
3222 }
3223 break;
3224
3225 case GL_ALPHA:
3226 case GL_LUMINANCE:
3227 case GL_LUMINANCE_ALPHA:
3228 switch (type) {
3229 case GL_FLOAT:
3230 if (ctx->Extensions.OES_texture_float && internalFormat == format)
3231 break;
3232 case GL_HALF_FLOAT_OES:
3233 if (ctx->Extensions.OES_texture_half_float && internalFormat == format)
3234 break;
3235 default:
3236 if (type != GL_UNSIGNED_BYTE || format != internalFormat)
3237 return GL_INVALID_OPERATION;
3238 }
3239 }
3240
3241 return GL_NO_ERROR;
3242 }
3243
3244 static void
3245 set_swizzle(uint8_t *swizzle, int x, int y, int z, int w)
3246 {
3247 swizzle[MESA_FORMAT_SWIZZLE_X] = x;
3248 swizzle[MESA_FORMAT_SWIZZLE_Y] = y;
3249 swizzle[MESA_FORMAT_SWIZZLE_Z] = z;
3250 swizzle[MESA_FORMAT_SWIZZLE_W] = w;
3251 }
3252
3253 static bool
3254 get_swizzle_from_gl_format(GLenum format, uint8_t *swizzle)
3255 {
3256 switch (format) {
3257 case GL_RGBA:
3258 case GL_RGBA_INTEGER_EXT:
3259 set_swizzle(swizzle, 0, 1, 2, 3);
3260 return true;
3261 case GL_BGRA:
3262 case GL_BGRA_INTEGER_EXT:
3263 set_swizzle(swizzle, 2, 1, 0, 3);
3264 return true;
3265 case GL_ABGR_EXT:
3266 set_swizzle(swizzle, 3, 2, 1, 0);
3267 return true;
3268 case GL_RGB:
3269 case GL_RGB_INTEGER_EXT:
3270 set_swizzle(swizzle, 0, 1, 2, 5);
3271 return true;
3272 case GL_BGR:
3273 case GL_BGR_INTEGER_EXT:
3274 set_swizzle(swizzle, 2, 1, 0, 5);
3275 return true;
3276 case GL_LUMINANCE_ALPHA:
3277 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
3278 set_swizzle(swizzle, 0, 0, 0, 1);
3279 return true;
3280 case GL_RG:
3281 case GL_RG_INTEGER:
3282 set_swizzle(swizzle, 0, 1, 4, 5);
3283 return true;
3284 case GL_RED:
3285 case GL_RED_INTEGER_EXT:
3286 set_swizzle(swizzle, 0, 4, 4, 5);
3287 return true;
3288 case GL_GREEN:
3289 case GL_GREEN_INTEGER_EXT:
3290 set_swizzle(swizzle, 4, 0, 4, 5);
3291 return true;
3292 case GL_BLUE:
3293 case GL_BLUE_INTEGER_EXT:
3294 set_swizzle(swizzle, 4, 4, 0, 5);
3295 return true;
3296 case GL_ALPHA:
3297 case GL_ALPHA_INTEGER_EXT:
3298 set_swizzle(swizzle, 4, 4, 4, 0);
3299 return true;
3300 case GL_LUMINANCE:
3301 case GL_LUMINANCE_INTEGER_EXT:
3302 set_swizzle(swizzle, 0, 0, 0, 5);
3303 return true;
3304 case GL_INTENSITY:
3305 set_swizzle(swizzle, 0, 0, 0, 0);
3306 return true;
3307 default:
3308 return false;
3309 }
3310 }
3311
3312 /**
3313 * Take an OpenGL format (GL_RGB, GL_RGBA, etc), OpenGL data type (GL_INT,
3314 * GL_FOAT, etc) and return a matching mesa_array_format or a mesa_format
3315 * otherwise (for non-array formats).
3316 *
3317 * This function will typically be used to compute a mesa format from a GL type
3318 * so we can then call _mesa_format_convert. This function does
3319 * not consider byte swapping, so it returns types assuming that no byte
3320 * swapping is involved. If byte swapping is involved then clients are supposed
3321 * to handle that on their side before calling _mesa_format_convert.
3322 *
3323 * This function returns an uint32_t that can pack a mesa_format or a
3324 * mesa_array_format. Clients must check the mesa array format bit
3325 * (MESA_ARRAY_FORMAT_BIT) on the return value to know if the returned
3326 * format is a mesa_array_format or a mesa_format.
3327 */
3328 uint32_t
3329 _mesa_format_from_format_and_type(GLenum format, GLenum type)
3330 {
3331 bool is_array_format = true;
3332 uint8_t swizzle[4];
3333 bool normalized = false, is_float = false, is_signed = false;
3334 int num_channels = 0, type_size = 0;
3335
3336 /* Extract array format type information from the OpenGL data type */
3337 switch (type) {
3338 case GL_UNSIGNED_BYTE:
3339 type_size = 1;
3340 break;
3341 case GL_BYTE:
3342 type_size = 1;
3343 is_signed = true;
3344 break;
3345 case GL_UNSIGNED_SHORT:
3346 type_size = 2;
3347 break;
3348 case GL_SHORT:
3349 type_size = 2;
3350 is_signed = true;
3351 break;
3352 case GL_UNSIGNED_INT:
3353 type_size = 4;
3354 break;
3355 case GL_INT:
3356 type_size = 4;
3357 is_signed = true;
3358 break;
3359 case GL_HALF_FLOAT:
3360 case GL_HALF_FLOAT_OES:
3361 type_size = 2;
3362 is_signed = true;
3363 is_float = true;
3364 break;
3365 case GL_FLOAT:
3366 type_size = 4;
3367 is_signed = true;
3368 is_float = true;
3369 break;
3370 default:
3371 is_array_format = false;
3372 break;
3373 }
3374
3375 /* Extract array format swizzle information from the OpenGL format */
3376 if (is_array_format)
3377 is_array_format = get_swizzle_from_gl_format(format, swizzle);
3378
3379 /* If this is an array format type after checking data type and format,
3380 * create the array format
3381 */
3382 if (is_array_format) {
3383 normalized = !_mesa_is_enum_format_integer(format);
3384 num_channels = _mesa_components_in_format(format);
3385
3386 return MESA_ARRAY_FORMAT(type_size, is_signed, is_float,
3387 normalized, num_channels,
3388 swizzle[0], swizzle[1], swizzle[2], swizzle[3]);
3389 }
3390
3391 /* Otherwise this is not an array format, so return the mesa_format
3392 * matching the OpenGL format and data type
3393 */
3394 switch (type) {
3395 case GL_UNSIGNED_SHORT_5_6_5:
3396 if (format == GL_RGB)
3397 return MESA_FORMAT_B5G6R5_UNORM;
3398 else if (format == GL_BGR)
3399 return MESA_FORMAT_R5G6B5_UNORM;
3400 else if (format == GL_RGB_INTEGER)
3401 return MESA_FORMAT_B5G6R5_UINT;
3402 break;
3403 case GL_UNSIGNED_SHORT_5_6_5_REV:
3404 if (format == GL_RGB)
3405 return MESA_FORMAT_R5G6B5_UNORM;
3406 else if (format == GL_BGR)
3407 return MESA_FORMAT_B5G6R5_UNORM;
3408 else if (format == GL_RGB_INTEGER)
3409 return MESA_FORMAT_R5G6B5_UINT;
3410 break;
3411 case GL_UNSIGNED_SHORT_4_4_4_4:
3412 if (format == GL_RGBA)
3413 return MESA_FORMAT_A4B4G4R4_UNORM;
3414 else if (format == GL_BGRA)
3415 return MESA_FORMAT_A4R4G4B4_UNORM;
3416 else if (format == GL_ABGR_EXT)
3417 return MESA_FORMAT_R4G4B4A4_UNORM;
3418 else if (format == GL_RGBA_INTEGER)
3419 return MESA_FORMAT_A4B4G4R4_UINT;
3420 else if (format == GL_BGRA_INTEGER)
3421 return MESA_FORMAT_A4R4G4B4_UINT;
3422 break;
3423 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
3424 if (format == GL_RGBA)
3425 return MESA_FORMAT_R4G4B4A4_UNORM;
3426 else if (format == GL_BGRA)
3427 return MESA_FORMAT_B4G4R4A4_UNORM;
3428 else if (format == GL_ABGR_EXT)
3429 return MESA_FORMAT_A4B4G4R4_UNORM;
3430 else if (format == GL_RGBA_INTEGER)
3431 return MESA_FORMAT_R4G4B4A4_UINT;
3432 else if (format == GL_BGRA_INTEGER)
3433 return MESA_FORMAT_B4G4R4A4_UINT;
3434 break;
3435 case GL_UNSIGNED_SHORT_5_5_5_1:
3436 if (format == GL_RGBA)
3437 return MESA_FORMAT_A1B5G5R5_UNORM;
3438 else if (format == GL_BGRA)
3439 return MESA_FORMAT_A1R5G5B5_UNORM;
3440 else if (format == GL_RGBA_INTEGER)
3441 return MESA_FORMAT_A1B5G5R5_UINT;
3442 else if (format == GL_BGRA_INTEGER)
3443 return MESA_FORMAT_A1R5G5B5_UINT;
3444 break;
3445 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
3446 if (format == GL_RGBA)
3447 return MESA_FORMAT_R5G5B5A1_UNORM;
3448 else if (format == GL_BGRA)
3449 return MESA_FORMAT_B5G5R5A1_UNORM;
3450 else if (format == GL_RGBA_INTEGER)
3451 return MESA_FORMAT_R5G5B5A1_UINT;
3452 else if (format == GL_BGRA_INTEGER)
3453 return MESA_FORMAT_B5G5R5A1_UINT;
3454 break;
3455 case GL_UNSIGNED_BYTE_3_3_2:
3456 if (format == GL_RGB)
3457 return MESA_FORMAT_B2G3R3_UNORM;
3458 else if (format == GL_RGB_INTEGER)
3459 return MESA_FORMAT_B2G3R3_UINT;
3460 break;
3461 case GL_UNSIGNED_BYTE_2_3_3_REV:
3462 if (format == GL_RGB)
3463 return MESA_FORMAT_R3G3B2_UNORM;
3464 else if (format == GL_RGB_INTEGER)
3465 return MESA_FORMAT_R3G3B2_UINT;
3466 break;
3467 case GL_UNSIGNED_INT_5_9_9_9_REV:
3468 if (format == GL_RGB)
3469 return MESA_FORMAT_R9G9B9E5_FLOAT;
3470 break;
3471 case GL_UNSIGNED_INT_10_10_10_2:
3472 if (format == GL_RGBA)
3473 return MESA_FORMAT_A2B10G10R10_UNORM;
3474 else if (format == GL_RGBA_INTEGER)
3475 return MESA_FORMAT_A2B10G10R10_UINT;
3476 else if (format == GL_BGRA)
3477 return MESA_FORMAT_A2R10G10B10_UNORM;
3478 else if (format == GL_BGRA_INTEGER)
3479 return MESA_FORMAT_A2R10G10B10_UINT;
3480 break;
3481 case GL_UNSIGNED_INT_2_10_10_10_REV:
3482 if (format == GL_RGB)
3483 return MESA_FORMAT_R10G10B10X2_UNORM;
3484 if (format == GL_RGBA)
3485 return MESA_FORMAT_R10G10B10A2_UNORM;
3486 else if (format == GL_RGBA_INTEGER)
3487 return MESA_FORMAT_R10G10B10A2_UINT;
3488 else if (format == GL_BGRA)
3489 return MESA_FORMAT_B10G10R10A2_UNORM;
3490 else if (format == GL_BGRA_INTEGER)
3491 return MESA_FORMAT_B10G10R10A2_UINT;
3492 break;
3493 case GL_UNSIGNED_INT_8_8_8_8:
3494 if (format == GL_RGBA)
3495 return MESA_FORMAT_A8B8G8R8_UNORM;
3496 else if (format == GL_BGRA)
3497 return MESA_FORMAT_A8R8G8B8_UNORM;
3498 else if (format == GL_ABGR_EXT)
3499 return MESA_FORMAT_R8G8B8A8_UNORM;
3500 else if (format == GL_RGBA_INTEGER)
3501 return MESA_FORMAT_A8B8G8R8_UINT;
3502 else if (format == GL_BGRA_INTEGER)
3503 return MESA_FORMAT_A8R8G8B8_UINT;
3504 break;
3505 case GL_UNSIGNED_INT_8_8_8_8_REV:
3506 if (format == GL_RGBA)
3507 return MESA_FORMAT_R8G8B8A8_UNORM;
3508 else if (format == GL_BGRA)
3509 return MESA_FORMAT_B8G8R8A8_UNORM;
3510 else if (format == GL_ABGR_EXT)
3511 return MESA_FORMAT_A8B8G8R8_UNORM;
3512 else if (format == GL_RGBA_INTEGER)
3513 return MESA_FORMAT_R8G8B8A8_UINT;
3514 else if (format == GL_BGRA_INTEGER)
3515 return MESA_FORMAT_B8G8R8A8_UINT;
3516 break;
3517 case GL_UNSIGNED_SHORT_8_8_MESA:
3518 if (format == GL_YCBCR_MESA)
3519 return MESA_FORMAT_YCBCR;
3520 break;
3521 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
3522 if (format == GL_YCBCR_MESA)
3523 return MESA_FORMAT_YCBCR_REV;
3524 break;
3525 case GL_UNSIGNED_INT_10F_11F_11F_REV:
3526 if (format == GL_RGB)
3527 return MESA_FORMAT_R11G11B10_FLOAT;
3528 break;
3529 case GL_FLOAT:
3530 if (format == GL_DEPTH_COMPONENT)
3531 return MESA_FORMAT_Z_FLOAT32;
3532 break;
3533 case GL_UNSIGNED_INT:
3534 if (format == GL_DEPTH_COMPONENT)
3535 return MESA_FORMAT_Z_UNORM32;
3536 break;
3537 case GL_UNSIGNED_SHORT:
3538 if (format == GL_DEPTH_COMPONENT)
3539 return MESA_FORMAT_Z_UNORM16;
3540 break;
3541 case GL_UNSIGNED_INT_24_8:
3542 if (format == GL_DEPTH_STENCIL)
3543 return MESA_FORMAT_Z24_UNORM_S8_UINT;
3544 break;
3545 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
3546 if (format == GL_DEPTH_STENCIL)
3547 return MESA_FORMAT_Z32_FLOAT_S8X24_UINT;
3548 break;
3549 default:
3550 break;
3551 }
3552
3553 /* If we got here it means that we could not find a Mesa format that
3554 * matches the GL format/type provided. We may need to add a new Mesa
3555 * format in that case.
3556 */
3557 unreachable("Unsupported format");
3558 }
3559
3560 /**
3561 * Returns true if \p internal_format is a sized internal format that
3562 * is marked "Color Renderable" in Table 8.10 of the ES 3.2 specification.
3563 */
3564 bool
3565 _mesa_is_es3_color_renderable(GLenum internal_format)
3566 {
3567 switch (internal_format) {
3568 case GL_R8:
3569 case GL_RG8:
3570 case GL_RGB8:
3571 case GL_RGB565:
3572 case GL_RGBA4:
3573 case GL_RGB5_A1:
3574 case GL_RGBA8:
3575 case GL_RGB10_A2:
3576 case GL_RGB10_A2UI:
3577 case GL_SRGB8_ALPHA8:
3578 case GL_R16F:
3579 case GL_RG16F:
3580 case GL_RGBA16F:
3581 case GL_R32F:
3582 case GL_RG32F:
3583 case GL_RGBA32F:
3584 case GL_R11F_G11F_B10F:
3585 case GL_R8I:
3586 case GL_R8UI:
3587 case GL_R16I:
3588 case GL_R16UI:
3589 case GL_R32I:
3590 case GL_R32UI:
3591 case GL_RG8I:
3592 case GL_RG8UI:
3593 case GL_RG16I:
3594 case GL_RG16UI:
3595 case GL_RG32I:
3596 case GL_RG32UI:
3597 case GL_RGBA8I:
3598 case GL_RGBA8UI:
3599 case GL_RGBA16I:
3600 case GL_RGBA16UI:
3601 case GL_RGBA32I:
3602 case GL_RGBA32UI:
3603 return true;
3604 default:
3605 return false;
3606 }
3607 }
3608
3609 /**
3610 * Returns true if \p internal_format is a sized internal format that
3611 * is marked "Texture Filterable" in Table 8.10 of the ES 3.2 specification.
3612 */
3613 bool
3614 _mesa_is_es3_texture_filterable(GLenum internal_format)
3615 {
3616 switch (internal_format) {
3617 case GL_R8:
3618 case GL_R8_SNORM:
3619 case GL_RG8:
3620 case GL_RG8_SNORM:
3621 case GL_RGB8:
3622 case GL_RGB8_SNORM:
3623 case GL_RGB565:
3624 case GL_RGBA4:
3625 case GL_RGB5_A1:
3626 case GL_RGBA8:
3627 case GL_RGBA8_SNORM:
3628 case GL_RGB10_A2:
3629 case GL_SRGB8:
3630 case GL_SRGB8_ALPHA8:
3631 case GL_R16F:
3632 case GL_RG16F:
3633 case GL_RGB16F:
3634 case GL_RGBA16F:
3635 case GL_R11F_G11F_B10F:
3636 case GL_RGB9_E5:
3637 return true;
3638 default:
3639 return false;
3640 }
3641 }