mesa: #define fprintf to be __mingw_fprintf() on Mingw32
[mesa.git] / src / mesa / main / image.c
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.5
4 *
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 2009 VMware, Inc. All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 */
25
26
27 /**
28 * \file image.c
29 * Image handling.
30 */
31
32
33 #include "glheader.h"
34 #include "colormac.h"
35 #include "image.h"
36 #include "imports.h"
37 #include "macros.h"
38 #include "mfeatures.h"
39 #include "mtypes.h"
40
41
42
43 /**
44 * \return GL_TRUE if type is packed pixel type, GL_FALSE otherwise.
45 */
46 GLboolean
47 _mesa_type_is_packed(GLenum type)
48 {
49 switch (type) {
50 case GL_UNSIGNED_BYTE_3_3_2:
51 case GL_UNSIGNED_BYTE_2_3_3_REV:
52 case MESA_UNSIGNED_BYTE_4_4:
53 case GL_UNSIGNED_SHORT_5_6_5:
54 case GL_UNSIGNED_SHORT_5_6_5_REV:
55 case GL_UNSIGNED_SHORT_4_4_4_4:
56 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
57 case GL_UNSIGNED_SHORT_5_5_5_1:
58 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
59 case GL_UNSIGNED_INT_8_8_8_8:
60 case GL_UNSIGNED_INT_8_8_8_8_REV:
61 case GL_UNSIGNED_INT_10_10_10_2:
62 case GL_UNSIGNED_INT_2_10_10_10_REV:
63 case GL_UNSIGNED_SHORT_8_8_MESA:
64 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
65 case GL_UNSIGNED_INT_24_8_EXT:
66 case GL_UNSIGNED_INT_5_9_9_9_REV:
67 case GL_UNSIGNED_INT_10F_11F_11F_REV:
68 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
69 return GL_TRUE;
70 }
71
72 return GL_FALSE;
73 }
74
75
76
77 /**
78 * Flip the order of the 2 bytes in each word in the given array.
79 *
80 * \param p array.
81 * \param n number of words.
82 */
83 void
84 _mesa_swap2( GLushort *p, GLuint n )
85 {
86 GLuint i;
87 for (i = 0; i < n; i++) {
88 p[i] = (p[i] >> 8) | ((p[i] << 8) & 0xff00);
89 }
90 }
91
92
93
94 /*
95 * Flip the order of the 4 bytes in each word in the given array.
96 */
97 void
98 _mesa_swap4( GLuint *p, GLuint n )
99 {
100 GLuint i, a, b;
101 for (i = 0; i < n; i++) {
102 b = p[i];
103 a = (b >> 24)
104 | ((b >> 8) & 0xff00)
105 | ((b << 8) & 0xff0000)
106 | ((b << 24) & 0xff000000);
107 p[i] = a;
108 }
109 }
110
111
112 /**
113 * Get the size of a GL data type.
114 *
115 * \param type GL data type.
116 *
117 * \return the size, in bytes, of the given data type, 0 if a GL_BITMAP, or -1
118 * if an invalid type enum.
119 */
120 GLint
121 _mesa_sizeof_type( GLenum type )
122 {
123 switch (type) {
124 case GL_BITMAP:
125 return 0;
126 case GL_UNSIGNED_BYTE:
127 return sizeof(GLubyte);
128 case GL_BYTE:
129 return sizeof(GLbyte);
130 case GL_UNSIGNED_SHORT:
131 return sizeof(GLushort);
132 case GL_SHORT:
133 return sizeof(GLshort);
134 case GL_UNSIGNED_INT:
135 return sizeof(GLuint);
136 case GL_INT:
137 return sizeof(GLint);
138 case GL_FLOAT:
139 return sizeof(GLfloat);
140 case GL_DOUBLE:
141 return sizeof(GLdouble);
142 case GL_HALF_FLOAT_ARB:
143 return sizeof(GLhalfARB);
144 case GL_FIXED:
145 return sizeof(GLfixed);
146 default:
147 return -1;
148 }
149 }
150
151
152 /**
153 * Same as _mesa_sizeof_type() but also accepting the packed pixel
154 * format data types.
155 */
156 GLint
157 _mesa_sizeof_packed_type( GLenum type )
158 {
159 switch (type) {
160 case GL_BITMAP:
161 return 0;
162 case GL_UNSIGNED_BYTE:
163 return sizeof(GLubyte);
164 case GL_BYTE:
165 return sizeof(GLbyte);
166 case GL_UNSIGNED_SHORT:
167 return sizeof(GLushort);
168 case GL_SHORT:
169 return sizeof(GLshort);
170 case GL_UNSIGNED_INT:
171 return sizeof(GLuint);
172 case GL_INT:
173 return sizeof(GLint);
174 case GL_HALF_FLOAT_ARB:
175 return sizeof(GLhalfARB);
176 case GL_FLOAT:
177 return sizeof(GLfloat);
178 case GL_UNSIGNED_BYTE_3_3_2:
179 case GL_UNSIGNED_BYTE_2_3_3_REV:
180 case MESA_UNSIGNED_BYTE_4_4:
181 return sizeof(GLubyte);
182 case GL_UNSIGNED_SHORT_5_6_5:
183 case GL_UNSIGNED_SHORT_5_6_5_REV:
184 case GL_UNSIGNED_SHORT_4_4_4_4:
185 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
186 case GL_UNSIGNED_SHORT_5_5_5_1:
187 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
188 case GL_UNSIGNED_SHORT_8_8_MESA:
189 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
190 return sizeof(GLushort);
191 case GL_UNSIGNED_INT_8_8_8_8:
192 case GL_UNSIGNED_INT_8_8_8_8_REV:
193 case GL_UNSIGNED_INT_10_10_10_2:
194 case GL_UNSIGNED_INT_2_10_10_10_REV:
195 case GL_UNSIGNED_INT_24_8_EXT:
196 case GL_UNSIGNED_INT_5_9_9_9_REV:
197 case GL_UNSIGNED_INT_10F_11F_11F_REV:
198 return sizeof(GLuint);
199 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
200 return 8;
201 default:
202 return -1;
203 }
204 }
205
206
207 /**
208 * Get the number of components in a pixel format.
209 *
210 * \param format pixel format.
211 *
212 * \return the number of components in the given format, or -1 if a bad format.
213 */
214 GLint
215 _mesa_components_in_format( GLenum format )
216 {
217 switch (format) {
218 case GL_COLOR_INDEX:
219 case GL_STENCIL_INDEX:
220 case GL_DEPTH_COMPONENT:
221 case GL_RED:
222 case GL_RED_INTEGER_EXT:
223 case GL_GREEN:
224 case GL_GREEN_INTEGER_EXT:
225 case GL_BLUE:
226 case GL_BLUE_INTEGER_EXT:
227 case GL_ALPHA:
228 case GL_ALPHA_INTEGER_EXT:
229 case GL_LUMINANCE:
230 case GL_LUMINANCE_INTEGER_EXT:
231 case GL_INTENSITY:
232 return 1;
233
234 case GL_LUMINANCE_ALPHA:
235 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
236 case GL_RG:
237 case GL_YCBCR_MESA:
238 case GL_DEPTH_STENCIL_EXT:
239 case GL_DUDV_ATI:
240 case GL_DU8DV8_ATI:
241 case GL_RG_INTEGER:
242 return 2;
243
244 case GL_RGB:
245 case GL_BGR:
246 case GL_RGB_INTEGER_EXT:
247 case GL_BGR_INTEGER_EXT:
248 return 3;
249
250 case GL_RGBA:
251 case GL_BGRA:
252 case GL_ABGR_EXT:
253 case GL_RGBA_INTEGER_EXT:
254 case GL_BGRA_INTEGER_EXT:
255 return 4;
256
257 default:
258 return -1;
259 }
260 }
261
262
263 /**
264 * Get the bytes per pixel of pixel format type pair.
265 *
266 * \param format pixel format.
267 * \param type pixel type.
268 *
269 * \return bytes per pixel, or -1 if a bad format or type was given.
270 */
271 GLint
272 _mesa_bytes_per_pixel( GLenum format, GLenum type )
273 {
274 GLint comps = _mesa_components_in_format( format );
275 if (comps < 0)
276 return -1;
277
278 switch (type) {
279 case GL_BITMAP:
280 return 0; /* special case */
281 case GL_BYTE:
282 case GL_UNSIGNED_BYTE:
283 return comps * sizeof(GLubyte);
284 case GL_SHORT:
285 case GL_UNSIGNED_SHORT:
286 return comps * sizeof(GLshort);
287 case GL_INT:
288 case GL_UNSIGNED_INT:
289 return comps * sizeof(GLint);
290 case GL_FLOAT:
291 return comps * sizeof(GLfloat);
292 case GL_HALF_FLOAT_ARB:
293 return comps * sizeof(GLhalfARB);
294 case GL_UNSIGNED_BYTE_3_3_2:
295 case GL_UNSIGNED_BYTE_2_3_3_REV:
296 if (format == GL_RGB || format == GL_BGR ||
297 format == GL_RGB_INTEGER_EXT || format == GL_BGR_INTEGER_EXT)
298 return sizeof(GLubyte);
299 else
300 return -1; /* error */
301 case GL_UNSIGNED_SHORT_5_6_5:
302 case GL_UNSIGNED_SHORT_5_6_5_REV:
303 if (format == GL_RGB || format == GL_BGR ||
304 format == GL_RGB_INTEGER_EXT || format == GL_BGR_INTEGER_EXT)
305 return sizeof(GLushort);
306 else
307 return -1; /* error */
308 case GL_UNSIGNED_SHORT_4_4_4_4:
309 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
310 case GL_UNSIGNED_SHORT_5_5_5_1:
311 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
312 if (format == GL_RGBA || format == GL_BGRA || format == GL_ABGR_EXT ||
313 format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT)
314 return sizeof(GLushort);
315 else
316 return -1;
317 case GL_UNSIGNED_INT_8_8_8_8:
318 case GL_UNSIGNED_INT_8_8_8_8_REV:
319 case GL_UNSIGNED_INT_10_10_10_2:
320 case GL_UNSIGNED_INT_2_10_10_10_REV:
321 if (format == GL_RGBA || format == GL_BGRA || format == GL_ABGR_EXT ||
322 format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT)
323 return sizeof(GLuint);
324 else
325 return -1;
326 case GL_UNSIGNED_SHORT_8_8_MESA:
327 case GL_UNSIGNED_SHORT_8_8_REV_MESA:
328 if (format == GL_YCBCR_MESA)
329 return sizeof(GLushort);
330 else
331 return -1;
332 case GL_UNSIGNED_INT_24_8_EXT:
333 if (format == GL_DEPTH_STENCIL_EXT)
334 return sizeof(GLuint);
335 else
336 return -1;
337 case GL_UNSIGNED_INT_5_9_9_9_REV:
338 if (format == GL_RGB)
339 return sizeof(GLuint);
340 else
341 return -1;
342 case GL_UNSIGNED_INT_10F_11F_11F_REV:
343 if (format == GL_RGB)
344 return sizeof(GLuint);
345 else
346 return -1;
347 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
348 if (format == GL_DEPTH_STENCIL)
349 return 8;
350 else
351 return -1;
352 default:
353 return -1;
354 }
355 }
356
357
358 /**
359 * Do error checking of format/type combinations for glReadPixels,
360 * glDrawPixels and glTex[Sub]Image. Note that depending on the format
361 * and type values, we may either generate GL_INVALID_OPERATION or
362 * GL_INVALID_ENUM.
363 *
364 * \param format pixel format.
365 * \param type pixel type.
366 *
367 * \return GL_INVALID_ENUM, GL_INVALID_OPERATION or GL_NO_ERROR
368 */
369 GLenum
370 _mesa_error_check_format_and_type(const struct gl_context *ctx,
371 GLenum format, GLenum type)
372 {
373 /* special type-based checks (see glReadPixels, glDrawPixels error lists) */
374 switch (type) {
375 case GL_BITMAP:
376 if (format != GL_COLOR_INDEX && format != GL_STENCIL_INDEX) {
377 return GL_INVALID_ENUM;
378 }
379 break;
380
381 case GL_UNSIGNED_BYTE_3_3_2:
382 case GL_UNSIGNED_BYTE_2_3_3_REV:
383 case GL_UNSIGNED_SHORT_5_6_5:
384 case GL_UNSIGNED_SHORT_5_6_5_REV:
385 if (format == GL_RGB) {
386 break; /* OK */
387 }
388 if (format == GL_RGB_INTEGER_EXT &&
389 ctx->Extensions.ARB_texture_rgb10_a2ui) {
390 break; /* OK */
391 }
392 return GL_INVALID_OPERATION;
393
394 case GL_UNSIGNED_SHORT_4_4_4_4:
395 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
396 case GL_UNSIGNED_SHORT_5_5_5_1:
397 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
398 case GL_UNSIGNED_INT_8_8_8_8:
399 case GL_UNSIGNED_INT_8_8_8_8_REV:
400 case GL_UNSIGNED_INT_10_10_10_2:
401 case GL_UNSIGNED_INT_2_10_10_10_REV:
402 if (format == GL_RGBA ||
403 format == GL_BGRA ||
404 format == GL_ABGR_EXT) {
405 break; /* OK */
406 }
407 if ((format == GL_RGBA_INTEGER_EXT || format == GL_BGRA_INTEGER_EXT) &&
408 ctx->Extensions.ARB_texture_rgb10_a2ui) {
409 break; /* OK */
410 }
411 return GL_INVALID_OPERATION;
412
413 case GL_UNSIGNED_INT_24_8:
414 if (!ctx->Extensions.EXT_packed_depth_stencil) {
415 return GL_INVALID_ENUM;
416 }
417 if (format != GL_DEPTH_STENCIL) {
418 return GL_INVALID_OPERATION;
419 }
420 return GL_NO_ERROR;
421
422 case GL_FLOAT_32_UNSIGNED_INT_24_8_REV:
423 if (!ctx->Extensions.ARB_depth_buffer_float) {
424 return GL_INVALID_ENUM;
425 }
426 if (format != GL_DEPTH_STENCIL) {
427 return GL_INVALID_OPERATION;
428 }
429 return GL_NO_ERROR;
430
431 case GL_UNSIGNED_INT_10F_11F_11F_REV:
432 if (!ctx->Extensions.EXT_packed_float) {
433 return GL_INVALID_ENUM;
434 }
435 if (format != GL_RGB) {
436 return GL_INVALID_OPERATION;
437 }
438 return GL_NO_ERROR;
439
440 default:
441 ; /* fall-through */
442 }
443
444 /* now, for each format, check the type for compatibility */
445 switch (format) {
446 case GL_COLOR_INDEX:
447 case GL_STENCIL_INDEX:
448 switch (type) {
449 case GL_BITMAP:
450 case GL_BYTE:
451 case GL_UNSIGNED_BYTE:
452 case GL_SHORT:
453 case GL_UNSIGNED_SHORT:
454 case GL_INT:
455 case GL_UNSIGNED_INT:
456 case GL_FLOAT:
457 return GL_NO_ERROR;
458 case GL_HALF_FLOAT:
459 return ctx->Extensions.ARB_half_float_pixel
460 ? GL_NO_ERROR : GL_INVALID_ENUM;
461 default:
462 return GL_INVALID_ENUM;
463 }
464
465 case GL_RED:
466 case GL_GREEN:
467 case GL_BLUE:
468 case GL_ALPHA:
469 #if 0 /* not legal! see table 3.6 of the 1.5 spec */
470 case GL_INTENSITY:
471 #endif
472 case GL_LUMINANCE:
473 case GL_LUMINANCE_ALPHA:
474 case GL_DEPTH_COMPONENT:
475 switch (type) {
476 case GL_BYTE:
477 case GL_UNSIGNED_BYTE:
478 case GL_SHORT:
479 case GL_UNSIGNED_SHORT:
480 case GL_INT:
481 case GL_UNSIGNED_INT:
482 case GL_FLOAT:
483 return GL_NO_ERROR;
484 case GL_HALF_FLOAT:
485 return ctx->Extensions.ARB_half_float_pixel
486 ? GL_NO_ERROR : GL_INVALID_ENUM;
487 default:
488 return GL_INVALID_ENUM;
489 }
490
491 case GL_RG:
492 if (!ctx->Extensions.ARB_texture_rg)
493 return GL_INVALID_ENUM;
494 switch (type) {
495 case GL_BYTE:
496 case GL_UNSIGNED_BYTE:
497 case GL_SHORT:
498 case GL_UNSIGNED_SHORT:
499 case GL_INT:
500 case GL_UNSIGNED_INT:
501 case GL_FLOAT:
502 return GL_NO_ERROR;
503 case GL_HALF_FLOAT:
504 return ctx->Extensions.ARB_half_float_pixel
505 ? GL_NO_ERROR : GL_INVALID_ENUM;
506 default:
507 return GL_INVALID_ENUM;
508 }
509
510 case GL_RGB:
511 switch (type) {
512 case GL_BYTE:
513 case GL_UNSIGNED_BYTE:
514 case GL_SHORT:
515 case GL_UNSIGNED_SHORT:
516 case GL_INT:
517 case GL_UNSIGNED_INT:
518 case GL_FLOAT:
519 case GL_UNSIGNED_BYTE_3_3_2:
520 case GL_UNSIGNED_BYTE_2_3_3_REV:
521 case GL_UNSIGNED_SHORT_5_6_5:
522 case GL_UNSIGNED_SHORT_5_6_5_REV:
523 return GL_NO_ERROR;
524 case GL_HALF_FLOAT:
525 return ctx->Extensions.ARB_half_float_pixel
526 ? GL_NO_ERROR : GL_INVALID_ENUM;
527 case GL_UNSIGNED_INT_5_9_9_9_REV:
528 return ctx->Extensions.EXT_texture_shared_exponent
529 ? GL_NO_ERROR : GL_INVALID_ENUM;
530 case GL_UNSIGNED_INT_10F_11F_11F_REV:
531 return ctx->Extensions.EXT_packed_float
532 ? GL_NO_ERROR : GL_INVALID_ENUM;
533 default:
534 return GL_INVALID_ENUM;
535 }
536
537 case GL_BGR:
538 switch (type) {
539 /* NOTE: no packed types are supported with BGR. That's
540 * intentional, according to the GL spec.
541 */
542 case GL_BYTE:
543 case GL_UNSIGNED_BYTE:
544 case GL_SHORT:
545 case GL_UNSIGNED_SHORT:
546 case GL_INT:
547 case GL_UNSIGNED_INT:
548 case GL_FLOAT:
549 return GL_NO_ERROR;
550 case GL_HALF_FLOAT:
551 return ctx->Extensions.ARB_half_float_pixel
552 ? GL_NO_ERROR : GL_INVALID_ENUM;
553 default:
554 return GL_INVALID_ENUM;
555 }
556
557 case GL_RGBA:
558 case GL_BGRA:
559 case GL_ABGR_EXT:
560 switch (type) {
561 case GL_BYTE:
562 case GL_UNSIGNED_BYTE:
563 case GL_SHORT:
564 case GL_UNSIGNED_SHORT:
565 case GL_INT:
566 case GL_UNSIGNED_INT:
567 case GL_FLOAT:
568 case GL_UNSIGNED_SHORT_4_4_4_4:
569 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
570 case GL_UNSIGNED_SHORT_5_5_5_1:
571 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
572 case GL_UNSIGNED_INT_8_8_8_8:
573 case GL_UNSIGNED_INT_8_8_8_8_REV:
574 case GL_UNSIGNED_INT_10_10_10_2:
575 case GL_UNSIGNED_INT_2_10_10_10_REV:
576 return GL_NO_ERROR;
577 case GL_HALF_FLOAT:
578 return ctx->Extensions.ARB_half_float_pixel
579 ? GL_NO_ERROR : GL_INVALID_ENUM;
580 default:
581 return GL_INVALID_ENUM;
582 }
583
584 case GL_YCBCR_MESA:
585 if (!ctx->Extensions.MESA_ycbcr_texture)
586 return GL_INVALID_ENUM;
587 if (type == GL_UNSIGNED_SHORT_8_8_MESA ||
588 type == GL_UNSIGNED_SHORT_8_8_REV_MESA)
589 return GL_NO_ERROR;
590 else
591 return GL_INVALID_OPERATION;
592
593 case GL_DEPTH_STENCIL_EXT:
594 if (ctx->Extensions.EXT_packed_depth_stencil &&
595 type == GL_UNSIGNED_INT_24_8)
596 return GL_NO_ERROR;
597 else if (ctx->Extensions.ARB_depth_buffer_float &&
598 type == GL_FLOAT_32_UNSIGNED_INT_24_8_REV)
599 return GL_NO_ERROR;
600 else
601 return GL_INVALID_ENUM;
602
603 case GL_DUDV_ATI:
604 case GL_DU8DV8_ATI:
605 if (!ctx->Extensions.ATI_envmap_bumpmap)
606 return GL_INVALID_ENUM;
607 switch (type) {
608 case GL_BYTE:
609 case GL_UNSIGNED_BYTE:
610 case GL_SHORT:
611 case GL_UNSIGNED_SHORT:
612 case GL_INT:
613 case GL_UNSIGNED_INT:
614 case GL_FLOAT:
615 return GL_NO_ERROR;
616 default:
617 return GL_INVALID_ENUM;
618 }
619
620 /* integer-valued formats */
621 case GL_RED_INTEGER_EXT:
622 case GL_GREEN_INTEGER_EXT:
623 case GL_BLUE_INTEGER_EXT:
624 case GL_ALPHA_INTEGER_EXT:
625 case GL_RG_INTEGER:
626 switch (type) {
627 case GL_BYTE:
628 case GL_UNSIGNED_BYTE:
629 case GL_SHORT:
630 case GL_UNSIGNED_SHORT:
631 case GL_INT:
632 case GL_UNSIGNED_INT:
633 return (ctx->VersionMajor >= 3 ||
634 ctx->Extensions.EXT_texture_integer)
635 ? GL_NO_ERROR : GL_INVALID_ENUM;
636 default:
637 return GL_INVALID_ENUM;
638 }
639
640 case GL_RGB_INTEGER_EXT:
641 switch (type) {
642 case GL_BYTE:
643 case GL_UNSIGNED_BYTE:
644 case GL_SHORT:
645 case GL_UNSIGNED_SHORT:
646 case GL_INT:
647 case GL_UNSIGNED_INT:
648 return (ctx->VersionMajor >= 3 ||
649 ctx->Extensions.EXT_texture_integer)
650 ? GL_NO_ERROR : GL_INVALID_ENUM;
651 case GL_UNSIGNED_BYTE_3_3_2:
652 case GL_UNSIGNED_BYTE_2_3_3_REV:
653 case GL_UNSIGNED_SHORT_5_6_5:
654 case GL_UNSIGNED_SHORT_5_6_5_REV:
655 return ctx->Extensions.ARB_texture_rgb10_a2ui
656 ? GL_NO_ERROR : GL_INVALID_ENUM;
657 default:
658 return GL_INVALID_ENUM;
659 }
660
661 case GL_BGR_INTEGER_EXT:
662 switch (type) {
663 case GL_BYTE:
664 case GL_UNSIGNED_BYTE:
665 case GL_SHORT:
666 case GL_UNSIGNED_SHORT:
667 case GL_INT:
668 case GL_UNSIGNED_INT:
669 /* NOTE: no packed formats w/ BGR format */
670 return (ctx->VersionMajor >= 3 ||
671 ctx->Extensions.EXT_texture_integer)
672 ? GL_NO_ERROR : GL_INVALID_ENUM;
673 default:
674 return GL_INVALID_ENUM;
675 }
676
677 case GL_RGBA_INTEGER_EXT:
678 case GL_BGRA_INTEGER_EXT:
679 switch (type) {
680 case GL_BYTE:
681 case GL_UNSIGNED_BYTE:
682 case GL_SHORT:
683 case GL_UNSIGNED_SHORT:
684 case GL_INT:
685 case GL_UNSIGNED_INT:
686 return (ctx->VersionMajor >= 3 ||
687 ctx->Extensions.EXT_texture_integer)
688 ? GL_NO_ERROR : GL_INVALID_ENUM;
689 case GL_UNSIGNED_SHORT_4_4_4_4:
690 case GL_UNSIGNED_SHORT_4_4_4_4_REV:
691 case GL_UNSIGNED_SHORT_5_5_5_1:
692 case GL_UNSIGNED_SHORT_1_5_5_5_REV:
693 case GL_UNSIGNED_INT_8_8_8_8:
694 case GL_UNSIGNED_INT_8_8_8_8_REV:
695 case GL_UNSIGNED_INT_10_10_10_2:
696 case GL_UNSIGNED_INT_2_10_10_10_REV:
697 return ctx->Extensions.ARB_texture_rgb10_a2ui
698 ? GL_NO_ERROR : GL_INVALID_ENUM;
699 default:
700 return GL_INVALID_ENUM;
701 }
702
703 case GL_LUMINANCE_INTEGER_EXT:
704 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
705 switch (type) {
706 case GL_BYTE:
707 case GL_UNSIGNED_BYTE:
708 case GL_SHORT:
709 case GL_UNSIGNED_SHORT:
710 case GL_INT:
711 case GL_UNSIGNED_INT:
712 return ctx->Extensions.EXT_texture_integer
713 ? GL_NO_ERROR : GL_INVALID_ENUM;
714 default:
715 return GL_INVALID_ENUM;
716 }
717
718 default:
719 return GL_INVALID_ENUM;
720 }
721 return GL_NO_ERROR;
722 }
723
724
725 /**
726 * Test if the given image format is a color/RGBA format (i.e., not color
727 * index, depth, stencil, etc).
728 * \param format the image format value (may by an internal texture format)
729 * \return GL_TRUE if its a color/RGBA format, GL_FALSE otherwise.
730 */
731 GLboolean
732 _mesa_is_color_format(GLenum format)
733 {
734 switch (format) {
735 case GL_RED:
736 case GL_GREEN:
737 case GL_BLUE:
738 case GL_ALPHA:
739 case GL_ALPHA4:
740 case GL_ALPHA8:
741 case GL_ALPHA12:
742 case GL_ALPHA16:
743 case 1:
744 case GL_LUMINANCE:
745 case GL_LUMINANCE4:
746 case GL_LUMINANCE8:
747 case GL_LUMINANCE12:
748 case GL_LUMINANCE16:
749 case 2:
750 case GL_LUMINANCE_ALPHA:
751 case GL_LUMINANCE4_ALPHA4:
752 case GL_LUMINANCE6_ALPHA2:
753 case GL_LUMINANCE8_ALPHA8:
754 case GL_LUMINANCE12_ALPHA4:
755 case GL_LUMINANCE12_ALPHA12:
756 case GL_LUMINANCE16_ALPHA16:
757 case GL_INTENSITY:
758 case GL_INTENSITY4:
759 case GL_INTENSITY8:
760 case GL_INTENSITY12:
761 case GL_INTENSITY16:
762 case GL_R8:
763 case GL_R16:
764 case GL_RG:
765 case GL_RG8:
766 case GL_RG16:
767 case 3:
768 case GL_RGB:
769 case GL_BGR:
770 case GL_R3_G3_B2:
771 case GL_RGB4:
772 case GL_RGB5:
773 case GL_RGB8:
774 case GL_RGB10:
775 case GL_RGB12:
776 case GL_RGB16:
777 case 4:
778 case GL_ABGR_EXT:
779 case GL_RGBA:
780 case GL_BGRA:
781 case GL_RGBA2:
782 case GL_RGBA4:
783 case GL_RGB5_A1:
784 case GL_RGBA8:
785 case GL_RGB10_A2:
786 case GL_RGBA12:
787 case GL_RGBA16:
788 /* float texture formats */
789 case GL_ALPHA16F_ARB:
790 case GL_ALPHA32F_ARB:
791 case GL_LUMINANCE16F_ARB:
792 case GL_LUMINANCE32F_ARB:
793 case GL_LUMINANCE_ALPHA16F_ARB:
794 case GL_LUMINANCE_ALPHA32F_ARB:
795 case GL_INTENSITY16F_ARB:
796 case GL_INTENSITY32F_ARB:
797 case GL_R16F:
798 case GL_R32F:
799 case GL_RG16F:
800 case GL_RG32F:
801 case GL_RGB16F_ARB:
802 case GL_RGB32F_ARB:
803 case GL_RGBA16F_ARB:
804 case GL_RGBA32F_ARB:
805 /* compressed formats */
806 case GL_COMPRESSED_ALPHA:
807 case GL_COMPRESSED_LUMINANCE:
808 case GL_COMPRESSED_LUMINANCE_ALPHA:
809 case GL_COMPRESSED_INTENSITY:
810 case GL_COMPRESSED_RED:
811 case GL_COMPRESSED_RG:
812 case GL_COMPRESSED_RGB:
813 case GL_COMPRESSED_RGBA:
814 case GL_RGB_S3TC:
815 case GL_RGB4_S3TC:
816 case GL_RGBA_S3TC:
817 case GL_RGBA4_S3TC:
818 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT:
819 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT:
820 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT:
821 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT:
822 case GL_COMPRESSED_RGB_FXT1_3DFX:
823 case GL_COMPRESSED_RGBA_FXT1_3DFX:
824 #if FEATURE_EXT_texture_sRGB
825 case GL_SRGB_EXT:
826 case GL_SRGB8_EXT:
827 case GL_SRGB_ALPHA_EXT:
828 case GL_SRGB8_ALPHA8_EXT:
829 case GL_SLUMINANCE_ALPHA_EXT:
830 case GL_SLUMINANCE8_ALPHA8_EXT:
831 case GL_SLUMINANCE_EXT:
832 case GL_SLUMINANCE8_EXT:
833 case GL_COMPRESSED_SRGB_EXT:
834 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT:
835 case GL_COMPRESSED_SRGB_ALPHA_EXT:
836 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:
837 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:
838 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:
839 case GL_COMPRESSED_SLUMINANCE_EXT:
840 case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT:
841 #endif /* FEATURE_EXT_texture_sRGB */
842 case GL_COMPRESSED_RED_RGTC1:
843 case GL_COMPRESSED_SIGNED_RED_RGTC1:
844 case GL_COMPRESSED_RG_RGTC2:
845 case GL_COMPRESSED_SIGNED_RG_RGTC2:
846 case GL_COMPRESSED_LUMINANCE_LATC1_EXT:
847 case GL_COMPRESSED_SIGNED_LUMINANCE_LATC1_EXT:
848 case GL_COMPRESSED_LUMINANCE_ALPHA_LATC2_EXT:
849 case GL_COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2_EXT:
850 case GL_COMPRESSED_LUMINANCE_ALPHA_3DC_ATI:
851 case GL_ETC1_RGB8_OES:
852 /* generic integer formats */
853 case GL_RED_INTEGER_EXT:
854 case GL_GREEN_INTEGER_EXT:
855 case GL_BLUE_INTEGER_EXT:
856 case GL_ALPHA_INTEGER_EXT:
857 case GL_RGB_INTEGER_EXT:
858 case GL_RGBA_INTEGER_EXT:
859 case GL_BGR_INTEGER_EXT:
860 case GL_BGRA_INTEGER_EXT:
861 case GL_RG_INTEGER:
862 case GL_LUMINANCE_INTEGER_EXT:
863 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
864 /* sized integer formats */
865 case GL_RGBA32UI_EXT:
866 case GL_RGB32UI_EXT:
867 case GL_RG32UI:
868 case GL_R32UI:
869 case GL_ALPHA32UI_EXT:
870 case GL_INTENSITY32UI_EXT:
871 case GL_LUMINANCE32UI_EXT:
872 case GL_LUMINANCE_ALPHA32UI_EXT:
873 case GL_RGBA16UI_EXT:
874 case GL_RGB16UI_EXT:
875 case GL_RG16UI:
876 case GL_R16UI:
877 case GL_ALPHA16UI_EXT:
878 case GL_INTENSITY16UI_EXT:
879 case GL_LUMINANCE16UI_EXT:
880 case GL_LUMINANCE_ALPHA16UI_EXT:
881 case GL_RGBA8UI_EXT:
882 case GL_RGB8UI_EXT:
883 case GL_RG8UI:
884 case GL_R8UI:
885 case GL_ALPHA8UI_EXT:
886 case GL_INTENSITY8UI_EXT:
887 case GL_LUMINANCE8UI_EXT:
888 case GL_LUMINANCE_ALPHA8UI_EXT:
889 case GL_RGBA32I_EXT:
890 case GL_RGB32I_EXT:
891 case GL_RG32I:
892 case GL_R32I:
893 case GL_ALPHA32I_EXT:
894 case GL_INTENSITY32I_EXT:
895 case GL_LUMINANCE32I_EXT:
896 case GL_LUMINANCE_ALPHA32I_EXT:
897 case GL_RGBA16I_EXT:
898 case GL_RGB16I_EXT:
899 case GL_RG16I:
900 case GL_R16I:
901 case GL_ALPHA16I_EXT:
902 case GL_INTENSITY16I_EXT:
903 case GL_LUMINANCE16I_EXT:
904 case GL_LUMINANCE_ALPHA16I_EXT:
905 case GL_RGBA8I_EXT:
906 case GL_RGB8I_EXT:
907 case GL_RG8I:
908 case GL_R8I:
909 case GL_ALPHA8I_EXT:
910 case GL_INTENSITY8I_EXT:
911 case GL_LUMINANCE8I_EXT:
912 case GL_LUMINANCE_ALPHA8I_EXT:
913 /* signed, normalized texture formats */
914 case GL_RED_SNORM:
915 case GL_R8_SNORM:
916 case GL_R16_SNORM:
917 case GL_RG_SNORM:
918 case GL_RG8_SNORM:
919 case GL_RG16_SNORM:
920 case GL_RGB_SNORM:
921 case GL_RGB8_SNORM:
922 case GL_RGB16_SNORM:
923 case GL_RGBA_SNORM:
924 case GL_RGBA8_SNORM:
925 case GL_RGBA16_SNORM:
926 case GL_ALPHA_SNORM:
927 case GL_ALPHA8_SNORM:
928 case GL_ALPHA16_SNORM:
929 case GL_LUMINANCE_SNORM:
930 case GL_LUMINANCE8_SNORM:
931 case GL_LUMINANCE16_SNORM:
932 case GL_LUMINANCE_ALPHA_SNORM:
933 case GL_LUMINANCE8_ALPHA8_SNORM:
934 case GL_LUMINANCE16_ALPHA16_SNORM:
935 case GL_INTENSITY_SNORM:
936 case GL_INTENSITY8_SNORM:
937 case GL_INTENSITY16_SNORM:
938 case GL_RGB9_E5:
939 case GL_R11F_G11F_B10F:
940 case GL_RGB10_A2UI:
941 return GL_TRUE;
942 case GL_YCBCR_MESA: /* not considered to be RGB */
943 /* fall-through */
944 default:
945 return GL_FALSE;
946 }
947 }
948
949
950 /**
951 * Test if the given image format is a depth component format.
952 */
953 GLboolean
954 _mesa_is_depth_format(GLenum format)
955 {
956 switch (format) {
957 case GL_DEPTH_COMPONENT:
958 case GL_DEPTH_COMPONENT16:
959 case GL_DEPTH_COMPONENT24:
960 case GL_DEPTH_COMPONENT32:
961 case GL_DEPTH_COMPONENT32F:
962 return GL_TRUE;
963 default:
964 return GL_FALSE;
965 }
966 }
967
968
969 /**
970 * Test if the given image format is a stencil format.
971 */
972 GLboolean
973 _mesa_is_stencil_format(GLenum format)
974 {
975 switch (format) {
976 case GL_STENCIL_INDEX:
977 return GL_TRUE;
978 default:
979 return GL_FALSE;
980 }
981 }
982
983
984 /**
985 * Test if the given image format is a YCbCr format.
986 */
987 GLboolean
988 _mesa_is_ycbcr_format(GLenum format)
989 {
990 switch (format) {
991 case GL_YCBCR_MESA:
992 return GL_TRUE;
993 default:
994 return GL_FALSE;
995 }
996 }
997
998
999 /**
1000 * Test if the given image format is a depth+stencil format.
1001 */
1002 GLboolean
1003 _mesa_is_depthstencil_format(GLenum format)
1004 {
1005 switch (format) {
1006 case GL_DEPTH24_STENCIL8_EXT:
1007 case GL_DEPTH_STENCIL_EXT:
1008 case GL_DEPTH32F_STENCIL8:
1009 return GL_TRUE;
1010 default:
1011 return GL_FALSE;
1012 }
1013 }
1014
1015
1016 /**
1017 * Test if the given image format is a depth or stencil format.
1018 */
1019 GLboolean
1020 _mesa_is_depth_or_stencil_format(GLenum format)
1021 {
1022 switch (format) {
1023 case GL_DEPTH_COMPONENT:
1024 case GL_DEPTH_COMPONENT16:
1025 case GL_DEPTH_COMPONENT24:
1026 case GL_DEPTH_COMPONENT32:
1027 case GL_STENCIL_INDEX:
1028 case GL_STENCIL_INDEX1_EXT:
1029 case GL_STENCIL_INDEX4_EXT:
1030 case GL_STENCIL_INDEX8_EXT:
1031 case GL_STENCIL_INDEX16_EXT:
1032 case GL_DEPTH_STENCIL_EXT:
1033 case GL_DEPTH24_STENCIL8_EXT:
1034 case GL_DEPTH_COMPONENT32F:
1035 case GL_DEPTH32F_STENCIL8:
1036 return GL_TRUE;
1037 default:
1038 return GL_FALSE;
1039 }
1040 }
1041
1042
1043 /**
1044 * Test if the given image format is a dudv format.
1045 */
1046 GLboolean
1047 _mesa_is_dudv_format(GLenum format)
1048 {
1049 switch (format) {
1050 case GL_DUDV_ATI:
1051 case GL_DU8DV8_ATI:
1052 return GL_TRUE;
1053 default:
1054 return GL_FALSE;
1055 }
1056 }
1057
1058
1059 /**
1060 * Test if the given format is an integer (non-normalized) format.
1061 */
1062 GLboolean
1063 _mesa_is_integer_format(GLenum format)
1064 {
1065 switch (format) {
1066 /* generic integer formats */
1067 case GL_RED_INTEGER_EXT:
1068 case GL_GREEN_INTEGER_EXT:
1069 case GL_BLUE_INTEGER_EXT:
1070 case GL_ALPHA_INTEGER_EXT:
1071 case GL_RGB_INTEGER_EXT:
1072 case GL_RGBA_INTEGER_EXT:
1073 case GL_BGR_INTEGER_EXT:
1074 case GL_BGRA_INTEGER_EXT:
1075 case GL_LUMINANCE_INTEGER_EXT:
1076 case GL_LUMINANCE_ALPHA_INTEGER_EXT:
1077 case GL_RG_INTEGER:
1078 /* specific integer formats */
1079 case GL_RGBA32UI_EXT:
1080 case GL_RGB32UI_EXT:
1081 case GL_RG32UI:
1082 case GL_R32UI:
1083 case GL_ALPHA32UI_EXT:
1084 case GL_INTENSITY32UI_EXT:
1085 case GL_LUMINANCE32UI_EXT:
1086 case GL_LUMINANCE_ALPHA32UI_EXT:
1087 case GL_RGBA16UI_EXT:
1088 case GL_RGB16UI_EXT:
1089 case GL_RG16UI:
1090 case GL_R16UI:
1091 case GL_ALPHA16UI_EXT:
1092 case GL_INTENSITY16UI_EXT:
1093 case GL_LUMINANCE16UI_EXT:
1094 case GL_LUMINANCE_ALPHA16UI_EXT:
1095 case GL_RGBA8UI_EXT:
1096 case GL_RGB8UI_EXT:
1097 case GL_RG8UI:
1098 case GL_R8UI:
1099 case GL_ALPHA8UI_EXT:
1100 case GL_INTENSITY8UI_EXT:
1101 case GL_LUMINANCE8UI_EXT:
1102 case GL_LUMINANCE_ALPHA8UI_EXT:
1103 case GL_RGBA32I_EXT:
1104 case GL_RGB32I_EXT:
1105 case GL_RG32I:
1106 case GL_R32I:
1107 case GL_ALPHA32I_EXT:
1108 case GL_INTENSITY32I_EXT:
1109 case GL_LUMINANCE32I_EXT:
1110 case GL_LUMINANCE_ALPHA32I_EXT:
1111 case GL_RGBA16I_EXT:
1112 case GL_RGB16I_EXT:
1113 case GL_RG16I:
1114 case GL_R16I:
1115 case GL_ALPHA16I_EXT:
1116 case GL_INTENSITY16I_EXT:
1117 case GL_LUMINANCE16I_EXT:
1118 case GL_LUMINANCE_ALPHA16I_EXT:
1119 case GL_RGBA8I_EXT:
1120 case GL_RGB8I_EXT:
1121 case GL_RG8I:
1122 case GL_R8I:
1123 case GL_ALPHA8I_EXT:
1124 case GL_INTENSITY8I_EXT:
1125 case GL_LUMINANCE8I_EXT:
1126 case GL_LUMINANCE_ALPHA8I_EXT:
1127 case GL_RGB10_A2UI:
1128 return GL_TRUE;
1129 default:
1130 return GL_FALSE;
1131 }
1132 }
1133
1134
1135 /**
1136 * Test if an image format is a supported compressed format.
1137 * \param format the internal format token provided by the user.
1138 * \return GL_TRUE if compressed, GL_FALSE if uncompressed
1139 */
1140 GLboolean
1141 _mesa_is_compressed_format(struct gl_context *ctx, GLenum format)
1142 {
1143 switch (format) {
1144 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT:
1145 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT:
1146 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT:
1147 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT:
1148 return ctx->Extensions.EXT_texture_compression_s3tc;
1149 case GL_RGB_S3TC:
1150 case GL_RGB4_S3TC:
1151 case GL_RGBA_S3TC:
1152 case GL_RGBA4_S3TC:
1153 return ctx->Extensions.S3_s3tc;
1154 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT:
1155 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:
1156 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:
1157 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:
1158 return ctx->Extensions.EXT_texture_sRGB
1159 && ctx->Extensions.EXT_texture_compression_s3tc;
1160 case GL_COMPRESSED_RGB_FXT1_3DFX:
1161 case GL_COMPRESSED_RGBA_FXT1_3DFX:
1162 return ctx->Extensions.TDFX_texture_compression_FXT1;
1163 case GL_COMPRESSED_RED_RGTC1:
1164 case GL_COMPRESSED_SIGNED_RED_RGTC1:
1165 case GL_COMPRESSED_RG_RGTC2:
1166 case GL_COMPRESSED_SIGNED_RG_RGTC2:
1167 return ctx->Extensions.ARB_texture_compression_rgtc;
1168 case GL_COMPRESSED_LUMINANCE_LATC1_EXT:
1169 case GL_COMPRESSED_SIGNED_LUMINANCE_LATC1_EXT:
1170 case GL_COMPRESSED_LUMINANCE_ALPHA_LATC2_EXT:
1171 case GL_COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2_EXT:
1172 return ctx->Extensions.EXT_texture_compression_latc;
1173 case GL_COMPRESSED_LUMINANCE_ALPHA_3DC_ATI:
1174 return ctx->Extensions.ATI_texture_compression_3dc;
1175 case GL_ETC1_RGB8_OES:
1176 return ctx->Extensions.OES_compressed_ETC1_RGB8_texture;
1177 #if FEATURE_ES
1178 case GL_PALETTE4_RGB8_OES:
1179 case GL_PALETTE4_RGBA8_OES:
1180 case GL_PALETTE4_R5_G6_B5_OES:
1181 case GL_PALETTE4_RGBA4_OES:
1182 case GL_PALETTE4_RGB5_A1_OES:
1183 case GL_PALETTE8_RGB8_OES:
1184 case GL_PALETTE8_RGBA8_OES:
1185 case GL_PALETTE8_R5_G6_B5_OES:
1186 case GL_PALETTE8_RGBA4_OES:
1187 case GL_PALETTE8_RGB5_A1_OES:
1188 return ctx->API == API_OPENGLES;
1189 #endif
1190 default:
1191 return GL_FALSE;
1192 }
1193 }
1194
1195
1196 /**
1197 * Does the given base texture/renderbuffer format have the channel
1198 * named by 'pname'?
1199 */
1200 GLboolean
1201 _mesa_base_format_has_channel(GLenum base_format, GLenum pname)
1202 {
1203 switch (pname) {
1204 case GL_TEXTURE_RED_SIZE:
1205 case GL_TEXTURE_RED_TYPE:
1206 case GL_RENDERBUFFER_RED_SIZE_EXT:
1207 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
1208 if (base_format == GL_RED ||
1209 base_format == GL_RG ||
1210 base_format == GL_RGB ||
1211 base_format == GL_RGBA) {
1212 return GL_TRUE;
1213 }
1214 return GL_FALSE;
1215 case GL_TEXTURE_GREEN_SIZE:
1216 case GL_TEXTURE_GREEN_TYPE:
1217 case GL_RENDERBUFFER_GREEN_SIZE_EXT:
1218 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
1219 if (base_format == GL_RG ||
1220 base_format == GL_RGB ||
1221 base_format == GL_RGBA) {
1222 return GL_TRUE;
1223 }
1224 return GL_FALSE;
1225 case GL_TEXTURE_BLUE_SIZE:
1226 case GL_TEXTURE_BLUE_TYPE:
1227 case GL_RENDERBUFFER_BLUE_SIZE_EXT:
1228 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
1229 if (base_format == GL_RGB ||
1230 base_format == GL_RGBA) {
1231 return GL_TRUE;
1232 }
1233 return GL_FALSE;
1234 case GL_TEXTURE_ALPHA_SIZE:
1235 case GL_TEXTURE_ALPHA_TYPE:
1236 case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
1237 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
1238 if (base_format == GL_RGBA ||
1239 base_format == GL_ALPHA ||
1240 base_format == GL_LUMINANCE_ALPHA) {
1241 return GL_TRUE;
1242 }
1243 return GL_FALSE;
1244 case GL_TEXTURE_LUMINANCE_SIZE:
1245 case GL_TEXTURE_LUMINANCE_TYPE:
1246 if (base_format == GL_LUMINANCE ||
1247 base_format == GL_LUMINANCE_ALPHA) {
1248 return GL_TRUE;
1249 }
1250 return GL_FALSE;
1251 case GL_TEXTURE_INTENSITY_SIZE:
1252 case GL_TEXTURE_INTENSITY_TYPE:
1253 if (base_format == GL_INTENSITY) {
1254 return GL_TRUE;
1255 }
1256 return GL_FALSE;
1257 case GL_TEXTURE_DEPTH_SIZE:
1258 case GL_TEXTURE_DEPTH_TYPE:
1259 case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1260 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
1261 if (base_format == GL_DEPTH_STENCIL ||
1262 base_format == GL_DEPTH_COMPONENT) {
1263 return GL_TRUE;
1264 }
1265 return GL_FALSE;
1266 case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1267 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
1268 if (base_format == GL_DEPTH_STENCIL ||
1269 base_format == GL_STENCIL_INDEX) {
1270 return GL_TRUE;
1271 }
1272 return GL_FALSE;
1273 default:
1274 _mesa_warning(NULL, "%s: Unexpected channel token 0x%x\n",
1275 __FUNCTION__, pname);
1276 return GL_FALSE;
1277 }
1278
1279 return GL_FALSE;
1280 }
1281
1282
1283 /**
1284 * Return the byte offset of a specific pixel in an image (1D, 2D or 3D).
1285 *
1286 * Pixel unpacking/packing parameters are observed according to \p packing.
1287 *
1288 * \param dimensions either 1, 2 or 3 to indicate dimensionality of image
1289 * \param packing the pixelstore attributes
1290 * \param width the image width
1291 * \param height the image height
1292 * \param format the pixel format (must be validated beforehand)
1293 * \param type the pixel data type (must be validated beforehand)
1294 * \param img which image in the volume (0 for 1D or 2D images)
1295 * \param row row of pixel in the image (0 for 1D images)
1296 * \param column column of pixel in the image
1297 *
1298 * \return offset of pixel.
1299 *
1300 * \sa gl_pixelstore_attrib.
1301 */
1302 GLintptr
1303 _mesa_image_offset( GLuint dimensions,
1304 const struct gl_pixelstore_attrib *packing,
1305 GLsizei width, GLsizei height,
1306 GLenum format, GLenum type,
1307 GLint img, GLint row, GLint column )
1308 {
1309 GLint alignment; /* 1, 2 or 4 */
1310 GLint pixels_per_row;
1311 GLint rows_per_image;
1312 GLint skiprows;
1313 GLint skippixels;
1314 GLint skipimages; /* for 3-D volume images */
1315 GLintptr offset;
1316
1317 ASSERT(dimensions >= 1 && dimensions <= 3);
1318
1319 alignment = packing->Alignment;
1320 if (packing->RowLength > 0) {
1321 pixels_per_row = packing->RowLength;
1322 }
1323 else {
1324 pixels_per_row = width;
1325 }
1326 if (packing->ImageHeight > 0) {
1327 rows_per_image = packing->ImageHeight;
1328 }
1329 else {
1330 rows_per_image = height;
1331 }
1332
1333 skippixels = packing->SkipPixels;
1334 /* Note: SKIP_ROWS _is_ used for 1D images */
1335 skiprows = packing->SkipRows;
1336 /* Note: SKIP_IMAGES is only used for 3D images */
1337 skipimages = (dimensions == 3) ? packing->SkipImages : 0;
1338
1339 if (type == GL_BITMAP) {
1340 /* BITMAP data */
1341 GLint bytes_per_row;
1342 GLint bytes_per_image;
1343 /* components per pixel for color or stencil index: */
1344 const GLint comp_per_pixel = 1;
1345
1346 /* The pixel type and format should have been error checked earlier */
1347 assert(format == GL_COLOR_INDEX || format == GL_STENCIL_INDEX);
1348
1349 bytes_per_row = alignment
1350 * CEILING( comp_per_pixel*pixels_per_row, 8*alignment );
1351
1352 bytes_per_image = bytes_per_row * rows_per_image;
1353
1354 offset = (skipimages + img) * bytes_per_image
1355 + (skiprows + row) * bytes_per_row
1356 + (skippixels + column) / 8;
1357 }
1358 else {
1359 /* Non-BITMAP data */
1360 GLint bytes_per_pixel, bytes_per_row, remainder, bytes_per_image;
1361 GLint topOfImage;
1362
1363 bytes_per_pixel = _mesa_bytes_per_pixel( format, type );
1364
1365 /* The pixel type and format should have been error checked earlier */
1366 assert(bytes_per_pixel > 0);
1367
1368 bytes_per_row = pixels_per_row * bytes_per_pixel;
1369 remainder = bytes_per_row % alignment;
1370 if (remainder > 0)
1371 bytes_per_row += (alignment - remainder);
1372
1373 ASSERT(bytes_per_row % alignment == 0);
1374
1375 bytes_per_image = bytes_per_row * rows_per_image;
1376
1377 if (packing->Invert) {
1378 /* set pixel_addr to the last row */
1379 topOfImage = bytes_per_row * (height - 1);
1380 bytes_per_row = -bytes_per_row;
1381 }
1382 else {
1383 topOfImage = 0;
1384 }
1385
1386 /* compute final pixel address */
1387 offset = (skipimages + img) * bytes_per_image
1388 + topOfImage
1389 + (skiprows + row) * bytes_per_row
1390 + (skippixels + column) * bytes_per_pixel;
1391 }
1392
1393 return offset;
1394 }
1395
1396
1397 /**
1398 * Return the address of a specific pixel in an image (1D, 2D or 3D).
1399 *
1400 * Pixel unpacking/packing parameters are observed according to \p packing.
1401 *
1402 * \param dimensions either 1, 2 or 3 to indicate dimensionality of image
1403 * \param packing the pixelstore attributes
1404 * \param image starting address of image data
1405 * \param width the image width
1406 * \param height the image height
1407 * \param format the pixel format (must be validated beforehand)
1408 * \param type the pixel data type (must be validated beforehand)
1409 * \param img which image in the volume (0 for 1D or 2D images)
1410 * \param row row of pixel in the image (0 for 1D images)
1411 * \param column column of pixel in the image
1412 *
1413 * \return address of pixel.
1414 *
1415 * \sa gl_pixelstore_attrib.
1416 */
1417 GLvoid *
1418 _mesa_image_address( GLuint dimensions,
1419 const struct gl_pixelstore_attrib *packing,
1420 const GLvoid *image,
1421 GLsizei width, GLsizei height,
1422 GLenum format, GLenum type,
1423 GLint img, GLint row, GLint column )
1424 {
1425 const GLubyte *addr = (const GLubyte *) image;
1426
1427 addr += _mesa_image_offset(dimensions, packing, width, height,
1428 format, type, img, row, column);
1429
1430 return (GLvoid *) addr;
1431 }
1432
1433
1434 GLvoid *
1435 _mesa_image_address1d( const struct gl_pixelstore_attrib *packing,
1436 const GLvoid *image,
1437 GLsizei width,
1438 GLenum format, GLenum type,
1439 GLint column )
1440 {
1441 return _mesa_image_address(1, packing, image, width, 1,
1442 format, type, 0, 0, column);
1443 }
1444
1445
1446 GLvoid *
1447 _mesa_image_address2d( const struct gl_pixelstore_attrib *packing,
1448 const GLvoid *image,
1449 GLsizei width, GLsizei height,
1450 GLenum format, GLenum type,
1451 GLint row, GLint column )
1452 {
1453 return _mesa_image_address(2, packing, image, width, height,
1454 format, type, 0, row, column);
1455 }
1456
1457
1458 GLvoid *
1459 _mesa_image_address3d( const struct gl_pixelstore_attrib *packing,
1460 const GLvoid *image,
1461 GLsizei width, GLsizei height,
1462 GLenum format, GLenum type,
1463 GLint img, GLint row, GLint column )
1464 {
1465 return _mesa_image_address(3, packing, image, width, height,
1466 format, type, img, row, column);
1467 }
1468
1469
1470
1471 /**
1472 * Compute the stride (in bytes) between image rows.
1473 *
1474 * \param packing the pixelstore attributes
1475 * \param width image width.
1476 * \param format pixel format.
1477 * \param type pixel data type.
1478 *
1479 * \return the stride in bytes for the given parameters, or -1 if error
1480 */
1481 GLint
1482 _mesa_image_row_stride( const struct gl_pixelstore_attrib *packing,
1483 GLint width, GLenum format, GLenum type )
1484 {
1485 GLint bytesPerRow, remainder;
1486
1487 ASSERT(packing);
1488
1489 if (type == GL_BITMAP) {
1490 if (packing->RowLength == 0) {
1491 bytesPerRow = (width + 7) / 8;
1492 }
1493 else {
1494 bytesPerRow = (packing->RowLength + 7) / 8;
1495 }
1496 }
1497 else {
1498 /* Non-BITMAP data */
1499 const GLint bytesPerPixel = _mesa_bytes_per_pixel(format, type);
1500 if (bytesPerPixel <= 0)
1501 return -1; /* error */
1502 if (packing->RowLength == 0) {
1503 bytesPerRow = bytesPerPixel * width;
1504 }
1505 else {
1506 bytesPerRow = bytesPerPixel * packing->RowLength;
1507 }
1508 }
1509
1510 remainder = bytesPerRow % packing->Alignment;
1511 if (remainder > 0) {
1512 bytesPerRow += (packing->Alignment - remainder);
1513 }
1514
1515 if (packing->Invert) {
1516 /* negate the bytes per row (negative row stride) */
1517 bytesPerRow = -bytesPerRow;
1518 }
1519
1520 return bytesPerRow;
1521 }
1522
1523
1524 /*
1525 * Compute the stride between images in a 3D texture (in bytes) for the given
1526 * pixel packing parameters and image width, format and type.
1527 */
1528 GLint
1529 _mesa_image_image_stride( const struct gl_pixelstore_attrib *packing,
1530 GLint width, GLint height,
1531 GLenum format, GLenum type )
1532 {
1533 GLint bytesPerRow, bytesPerImage, remainder;
1534
1535 ASSERT(packing);
1536
1537 if (type == GL_BITMAP) {
1538 if (packing->RowLength == 0) {
1539 bytesPerRow = (width + 7) / 8;
1540 }
1541 else {
1542 bytesPerRow = (packing->RowLength + 7) / 8;
1543 }
1544 }
1545 else {
1546 const GLint bytesPerPixel = _mesa_bytes_per_pixel(format, type);
1547
1548 if (bytesPerPixel <= 0)
1549 return -1; /* error */
1550 if (packing->RowLength == 0) {
1551 bytesPerRow = bytesPerPixel * width;
1552 }
1553 else {
1554 bytesPerRow = bytesPerPixel * packing->RowLength;
1555 }
1556 }
1557
1558 remainder = bytesPerRow % packing->Alignment;
1559 if (remainder > 0)
1560 bytesPerRow += (packing->Alignment - remainder);
1561
1562 if (packing->ImageHeight == 0)
1563 bytesPerImage = bytesPerRow * height;
1564 else
1565 bytesPerImage = bytesPerRow * packing->ImageHeight;
1566
1567 return bytesPerImage;
1568 }
1569
1570
1571
1572 /**
1573 * "Expand" a bitmap from 1-bit per pixel to 8-bits per pixel.
1574 * This is typically used to convert a bitmap into a GLubyte/pixel texture.
1575 * "On" bits will set texels to \p onValue.
1576 * "Off" bits will not modify texels.
1577 * \param width src bitmap width in pixels
1578 * \param height src bitmap height in pixels
1579 * \param unpack bitmap unpacking state
1580 * \param bitmap the src bitmap data
1581 * \param destBuffer start of dest buffer
1582 * \param destStride row stride in dest buffer
1583 * \param onValue if bit is 1, set destBuffer pixel to this value
1584 */
1585 void
1586 _mesa_expand_bitmap(GLsizei width, GLsizei height,
1587 const struct gl_pixelstore_attrib *unpack,
1588 const GLubyte *bitmap,
1589 GLubyte *destBuffer, GLint destStride,
1590 GLubyte onValue)
1591 {
1592 const GLubyte *srcRow = (const GLubyte *)
1593 _mesa_image_address2d(unpack, bitmap, width, height,
1594 GL_COLOR_INDEX, GL_BITMAP, 0, 0);
1595 const GLint srcStride = _mesa_image_row_stride(unpack, width,
1596 GL_COLOR_INDEX, GL_BITMAP);
1597 GLint row, col;
1598
1599 #define SET_PIXEL(COL, ROW) \
1600 destBuffer[(ROW) * destStride + (COL)] = onValue;
1601
1602 for (row = 0; row < height; row++) {
1603 const GLubyte *src = srcRow;
1604
1605 if (unpack->LsbFirst) {
1606 /* Lsb first */
1607 GLubyte mask = 1U << (unpack->SkipPixels & 0x7);
1608 for (col = 0; col < width; col++) {
1609
1610 if (*src & mask) {
1611 SET_PIXEL(col, row);
1612 }
1613
1614 if (mask == 128U) {
1615 src++;
1616 mask = 1U;
1617 }
1618 else {
1619 mask = mask << 1;
1620 }
1621 }
1622
1623 /* get ready for next row */
1624 if (mask != 1)
1625 src++;
1626 }
1627 else {
1628 /* Msb first */
1629 GLubyte mask = 128U >> (unpack->SkipPixels & 0x7);
1630 for (col = 0; col < width; col++) {
1631
1632 if (*src & mask) {
1633 SET_PIXEL(col, row);
1634 }
1635
1636 if (mask == 1U) {
1637 src++;
1638 mask = 128U;
1639 }
1640 else {
1641 mask = mask >> 1;
1642 }
1643 }
1644
1645 /* get ready for next row */
1646 if (mask != 128)
1647 src++;
1648 }
1649
1650 srcRow += srcStride;
1651 } /* row */
1652
1653 #undef SET_PIXEL
1654 }
1655
1656
1657
1658
1659 /**
1660 * Convert an array of RGBA colors from one datatype to another.
1661 * NOTE: src may equal dst. In that case, we use a temporary buffer.
1662 */
1663 void
1664 _mesa_convert_colors(GLenum srcType, const GLvoid *src,
1665 GLenum dstType, GLvoid *dst,
1666 GLuint count, const GLubyte mask[])
1667 {
1668 GLuint *tempBuffer;
1669 const GLboolean useTemp = (src == dst);
1670
1671 tempBuffer = malloc(count * MAX_PIXEL_BYTES);
1672 if (!tempBuffer)
1673 return;
1674
1675 ASSERT(srcType != dstType);
1676
1677 switch (srcType) {
1678 case GL_UNSIGNED_BYTE:
1679 if (dstType == GL_UNSIGNED_SHORT) {
1680 const GLubyte (*src1)[4] = (const GLubyte (*)[4]) src;
1681 GLushort (*dst2)[4] = (GLushort (*)[4]) (useTemp ? tempBuffer : dst);
1682 GLuint i;
1683 for (i = 0; i < count; i++) {
1684 if (!mask || mask[i]) {
1685 dst2[i][RCOMP] = UBYTE_TO_USHORT(src1[i][RCOMP]);
1686 dst2[i][GCOMP] = UBYTE_TO_USHORT(src1[i][GCOMP]);
1687 dst2[i][BCOMP] = UBYTE_TO_USHORT(src1[i][BCOMP]);
1688 dst2[i][ACOMP] = UBYTE_TO_USHORT(src1[i][ACOMP]);
1689 }
1690 }
1691 if (useTemp)
1692 memcpy(dst, tempBuffer, count * 4 * sizeof(GLushort));
1693 }
1694 else {
1695 const GLubyte (*src1)[4] = (const GLubyte (*)[4]) src;
1696 GLfloat (*dst4)[4] = (GLfloat (*)[4]) (useTemp ? tempBuffer : dst);
1697 GLuint i;
1698 ASSERT(dstType == GL_FLOAT);
1699 for (i = 0; i < count; i++) {
1700 if (!mask || mask[i]) {
1701 dst4[i][RCOMP] = UBYTE_TO_FLOAT(src1[i][RCOMP]);
1702 dst4[i][GCOMP] = UBYTE_TO_FLOAT(src1[i][GCOMP]);
1703 dst4[i][BCOMP] = UBYTE_TO_FLOAT(src1[i][BCOMP]);
1704 dst4[i][ACOMP] = UBYTE_TO_FLOAT(src1[i][ACOMP]);
1705 }
1706 }
1707 if (useTemp)
1708 memcpy(dst, tempBuffer, count * 4 * sizeof(GLfloat));
1709 }
1710 break;
1711 case GL_UNSIGNED_SHORT:
1712 if (dstType == GL_UNSIGNED_BYTE) {
1713 const GLushort (*src2)[4] = (const GLushort (*)[4]) src;
1714 GLubyte (*dst1)[4] = (GLubyte (*)[4]) (useTemp ? tempBuffer : dst);
1715 GLuint i;
1716 for (i = 0; i < count; i++) {
1717 if (!mask || mask[i]) {
1718 dst1[i][RCOMP] = USHORT_TO_UBYTE(src2[i][RCOMP]);
1719 dst1[i][GCOMP] = USHORT_TO_UBYTE(src2[i][GCOMP]);
1720 dst1[i][BCOMP] = USHORT_TO_UBYTE(src2[i][BCOMP]);
1721 dst1[i][ACOMP] = USHORT_TO_UBYTE(src2[i][ACOMP]);
1722 }
1723 }
1724 if (useTemp)
1725 memcpy(dst, tempBuffer, count * 4 * sizeof(GLubyte));
1726 }
1727 else {
1728 const GLushort (*src2)[4] = (const GLushort (*)[4]) src;
1729 GLfloat (*dst4)[4] = (GLfloat (*)[4]) (useTemp ? tempBuffer : dst);
1730 GLuint i;
1731 ASSERT(dstType == GL_FLOAT);
1732 for (i = 0; i < count; i++) {
1733 if (!mask || mask[i]) {
1734 dst4[i][RCOMP] = USHORT_TO_FLOAT(src2[i][RCOMP]);
1735 dst4[i][GCOMP] = USHORT_TO_FLOAT(src2[i][GCOMP]);
1736 dst4[i][BCOMP] = USHORT_TO_FLOAT(src2[i][BCOMP]);
1737 dst4[i][ACOMP] = USHORT_TO_FLOAT(src2[i][ACOMP]);
1738 }
1739 }
1740 if (useTemp)
1741 memcpy(dst, tempBuffer, count * 4 * sizeof(GLfloat));
1742 }
1743 break;
1744 case GL_FLOAT:
1745 if (dstType == GL_UNSIGNED_BYTE) {
1746 const GLfloat (*src4)[4] = (const GLfloat (*)[4]) src;
1747 GLubyte (*dst1)[4] = (GLubyte (*)[4]) (useTemp ? tempBuffer : dst);
1748 GLuint i;
1749 for (i = 0; i < count; i++) {
1750 if (!mask || mask[i])
1751 _mesa_unclamped_float_rgba_to_ubyte(dst1[i], src4[i]);
1752 }
1753 if (useTemp)
1754 memcpy(dst, tempBuffer, count * 4 * sizeof(GLubyte));
1755 }
1756 else {
1757 const GLfloat (*src4)[4] = (const GLfloat (*)[4]) src;
1758 GLushort (*dst2)[4] = (GLushort (*)[4]) (useTemp ? tempBuffer : dst);
1759 GLuint i;
1760 ASSERT(dstType == GL_UNSIGNED_SHORT);
1761 for (i = 0; i < count; i++) {
1762 if (!mask || mask[i]) {
1763 UNCLAMPED_FLOAT_TO_USHORT(dst2[i][RCOMP], src4[i][RCOMP]);
1764 UNCLAMPED_FLOAT_TO_USHORT(dst2[i][GCOMP], src4[i][GCOMP]);
1765 UNCLAMPED_FLOAT_TO_USHORT(dst2[i][BCOMP], src4[i][BCOMP]);
1766 UNCLAMPED_FLOAT_TO_USHORT(dst2[i][ACOMP], src4[i][ACOMP]);
1767 }
1768 }
1769 if (useTemp)
1770 memcpy(dst, tempBuffer, count * 4 * sizeof(GLushort));
1771 }
1772 break;
1773 default:
1774 _mesa_problem(NULL, "Invalid datatype in _mesa_convert_colors");
1775 }
1776
1777 free(tempBuffer);
1778 }
1779
1780
1781
1782
1783 /**
1784 * Perform basic clipping for glDrawPixels. The image's position and size
1785 * and the unpack SkipPixels and SkipRows are adjusted so that the image
1786 * region is entirely within the window and scissor bounds.
1787 * NOTE: this will only work when glPixelZoom is (1, 1) or (1, -1).
1788 * If Pixel.ZoomY is -1, *destY will be changed to be the first row which
1789 * we'll actually write. Beforehand, *destY-1 is the first drawing row.
1790 *
1791 * \return GL_TRUE if image is ready for drawing or
1792 * GL_FALSE if image was completely clipped away (draw nothing)
1793 */
1794 GLboolean
1795 _mesa_clip_drawpixels(const struct gl_context *ctx,
1796 GLint *destX, GLint *destY,
1797 GLsizei *width, GLsizei *height,
1798 struct gl_pixelstore_attrib *unpack)
1799 {
1800 const struct gl_framebuffer *buffer = ctx->DrawBuffer;
1801
1802 if (unpack->RowLength == 0) {
1803 unpack->RowLength = *width;
1804 }
1805
1806 ASSERT(ctx->Pixel.ZoomX == 1.0F);
1807 ASSERT(ctx->Pixel.ZoomY == 1.0F || ctx->Pixel.ZoomY == -1.0F);
1808
1809 /* left clipping */
1810 if (*destX < buffer->_Xmin) {
1811 unpack->SkipPixels += (buffer->_Xmin - *destX);
1812 *width -= (buffer->_Xmin - *destX);
1813 *destX = buffer->_Xmin;
1814 }
1815 /* right clipping */
1816 if (*destX + *width > buffer->_Xmax)
1817 *width -= (*destX + *width - buffer->_Xmax);
1818
1819 if (*width <= 0)
1820 return GL_FALSE;
1821
1822 if (ctx->Pixel.ZoomY == 1.0F) {
1823 /* bottom clipping */
1824 if (*destY < buffer->_Ymin) {
1825 unpack->SkipRows += (buffer->_Ymin - *destY);
1826 *height -= (buffer->_Ymin - *destY);
1827 *destY = buffer->_Ymin;
1828 }
1829 /* top clipping */
1830 if (*destY + *height > buffer->_Ymax)
1831 *height -= (*destY + *height - buffer->_Ymax);
1832 }
1833 else { /* upside down */
1834 /* top clipping */
1835 if (*destY > buffer->_Ymax) {
1836 unpack->SkipRows += (*destY - buffer->_Ymax);
1837 *height -= (*destY - buffer->_Ymax);
1838 *destY = buffer->_Ymax;
1839 }
1840 /* bottom clipping */
1841 if (*destY - *height < buffer->_Ymin)
1842 *height -= (buffer->_Ymin - (*destY - *height));
1843 /* adjust destY so it's the first row to write to */
1844 (*destY)--;
1845 }
1846
1847 if (*height <= 0)
1848 return GL_FALSE;
1849
1850 return GL_TRUE;
1851 }
1852
1853
1854 /**
1855 * Perform clipping for glReadPixels. The image's window position
1856 * and size, and the pack skipPixels, skipRows and rowLength are adjusted
1857 * so that the image region is entirely within the window bounds.
1858 * Note: this is different from _mesa_clip_drawpixels() in that the
1859 * scissor box is ignored, and we use the bounds of the current readbuffer
1860 * surface.
1861 *
1862 * \return GL_TRUE if region to read is in bounds
1863 * GL_FALSE if region is completely out of bounds (nothing to read)
1864 */
1865 GLboolean
1866 _mesa_clip_readpixels(const struct gl_context *ctx,
1867 GLint *srcX, GLint *srcY,
1868 GLsizei *width, GLsizei *height,
1869 struct gl_pixelstore_attrib *pack)
1870 {
1871 const struct gl_framebuffer *buffer = ctx->ReadBuffer;
1872
1873 if (pack->RowLength == 0) {
1874 pack->RowLength = *width;
1875 }
1876
1877 /* left clipping */
1878 if (*srcX < 0) {
1879 pack->SkipPixels += (0 - *srcX);
1880 *width -= (0 - *srcX);
1881 *srcX = 0;
1882 }
1883 /* right clipping */
1884 if (*srcX + *width > (GLsizei) buffer->Width)
1885 *width -= (*srcX + *width - buffer->Width);
1886
1887 if (*width <= 0)
1888 return GL_FALSE;
1889
1890 /* bottom clipping */
1891 if (*srcY < 0) {
1892 pack->SkipRows += (0 - *srcY);
1893 *height -= (0 - *srcY);
1894 *srcY = 0;
1895 }
1896 /* top clipping */
1897 if (*srcY + *height > (GLsizei) buffer->Height)
1898 *height -= (*srcY + *height - buffer->Height);
1899
1900 if (*height <= 0)
1901 return GL_FALSE;
1902
1903 return GL_TRUE;
1904 }
1905
1906
1907 /**
1908 * Do clipping for a glCopyTexSubImage call.
1909 * The framebuffer source region might extend outside the framebuffer
1910 * bounds. Clip the source region against the framebuffer bounds and
1911 * adjust the texture/dest position and size accordingly.
1912 *
1913 * \return GL_FALSE if region is totally clipped, GL_TRUE otherwise.
1914 */
1915 GLboolean
1916 _mesa_clip_copytexsubimage(const struct gl_context *ctx,
1917 GLint *destX, GLint *destY,
1918 GLint *srcX, GLint *srcY,
1919 GLsizei *width, GLsizei *height)
1920 {
1921 const struct gl_framebuffer *fb = ctx->ReadBuffer;
1922 const GLint srcX0 = *srcX, srcY0 = *srcY;
1923
1924 if (_mesa_clip_to_region(0, 0, fb->Width, fb->Height,
1925 srcX, srcY, width, height)) {
1926 *destX = *destX + *srcX - srcX0;
1927 *destY = *destY + *srcY - srcY0;
1928
1929 return GL_TRUE;
1930 }
1931 else {
1932 return GL_FALSE;
1933 }
1934 }
1935
1936
1937
1938 /**
1939 * Clip the rectangle defined by (x, y, width, height) against the bounds
1940 * specified by [xmin, xmax) and [ymin, ymax).
1941 * \return GL_FALSE if rect is totally clipped, GL_TRUE otherwise.
1942 */
1943 GLboolean
1944 _mesa_clip_to_region(GLint xmin, GLint ymin,
1945 GLint xmax, GLint ymax,
1946 GLint *x, GLint *y,
1947 GLsizei *width, GLsizei *height )
1948 {
1949 /* left clipping */
1950 if (*x < xmin) {
1951 *width -= (xmin - *x);
1952 *x = xmin;
1953 }
1954
1955 /* right clipping */
1956 if (*x + *width > xmax)
1957 *width -= (*x + *width - xmax);
1958
1959 if (*width <= 0)
1960 return GL_FALSE;
1961
1962 /* bottom (or top) clipping */
1963 if (*y < ymin) {
1964 *height -= (ymin - *y);
1965 *y = ymin;
1966 }
1967
1968 /* top (or bottom) clipping */
1969 if (*y + *height > ymax)
1970 *height -= (*y + *height - ymax);
1971
1972 if (*height <= 0)
1973 return GL_FALSE;
1974
1975 return GL_TRUE;
1976 }
1977
1978
1979 /**
1980 * Clip dst coords against Xmax (or Ymax).
1981 */
1982 static inline void
1983 clip_right_or_top(GLint *srcX0, GLint *srcX1,
1984 GLint *dstX0, GLint *dstX1,
1985 GLint maxValue)
1986 {
1987 GLfloat t, bias;
1988
1989 if (*dstX1 > maxValue) {
1990 /* X1 outside right edge */
1991 ASSERT(*dstX0 < maxValue); /* X0 should be inside right edge */
1992 t = (GLfloat) (maxValue - *dstX0) / (GLfloat) (*dstX1 - *dstX0);
1993 /* chop off [t, 1] part */
1994 ASSERT(t >= 0.0 && t <= 1.0);
1995 *dstX1 = maxValue;
1996 bias = (*srcX0 < *srcX1) ? 0.5F : -0.5F;
1997 *srcX1 = *srcX0 + (GLint) (t * (*srcX1 - *srcX0) + bias);
1998 }
1999 else if (*dstX0 > maxValue) {
2000 /* X0 outside right edge */
2001 ASSERT(*dstX1 < maxValue); /* X1 should be inside right edge */
2002 t = (GLfloat) (maxValue - *dstX1) / (GLfloat) (*dstX0 - *dstX1);
2003 /* chop off [t, 1] part */
2004 ASSERT(t >= 0.0 && t <= 1.0);
2005 *dstX0 = maxValue;
2006 bias = (*srcX0 < *srcX1) ? -0.5F : 0.5F;
2007 *srcX0 = *srcX1 + (GLint) (t * (*srcX0 - *srcX1) + bias);
2008 }
2009 }
2010
2011
2012 /**
2013 * Clip dst coords against Xmin (or Ymin).
2014 */
2015 static inline void
2016 clip_left_or_bottom(GLint *srcX0, GLint *srcX1,
2017 GLint *dstX0, GLint *dstX1,
2018 GLint minValue)
2019 {
2020 GLfloat t, bias;
2021
2022 if (*dstX0 < minValue) {
2023 /* X0 outside left edge */
2024 ASSERT(*dstX1 > minValue); /* X1 should be inside left edge */
2025 t = (GLfloat) (minValue - *dstX0) / (GLfloat) (*dstX1 - *dstX0);
2026 /* chop off [0, t] part */
2027 ASSERT(t >= 0.0 && t <= 1.0);
2028 *dstX0 = minValue;
2029 bias = (*srcX0 < *srcX1) ? 0.5F : -0.5F; /* flipped??? */
2030 *srcX0 = *srcX0 + (GLint) (t * (*srcX1 - *srcX0) + bias);
2031 }
2032 else if (*dstX1 < minValue) {
2033 /* X1 outside left edge */
2034 ASSERT(*dstX0 > minValue); /* X0 should be inside left edge */
2035 t = (GLfloat) (minValue - *dstX1) / (GLfloat) (*dstX0 - *dstX1);
2036 /* chop off [0, t] part */
2037 ASSERT(t >= 0.0 && t <= 1.0);
2038 *dstX1 = minValue;
2039 bias = (*srcX0 < *srcX1) ? 0.5F : -0.5F;
2040 *srcX1 = *srcX1 + (GLint) (t * (*srcX0 - *srcX1) + bias);
2041 }
2042 }
2043
2044
2045 /**
2046 * Do clipping of blit src/dest rectangles.
2047 * The dest rect is clipped against both the buffer bounds and scissor bounds.
2048 * The src rect is just clipped against the buffer bounds.
2049 *
2050 * When either the src or dest rect is clipped, the other is also clipped
2051 * proportionately!
2052 *
2053 * Note that X0 need not be less than X1 (same for Y) for either the source
2054 * and dest rects. That makes the clipping a little trickier.
2055 *
2056 * \return GL_TRUE if anything is left to draw, GL_FALSE if totally clipped
2057 */
2058 GLboolean
2059 _mesa_clip_blit(struct gl_context *ctx,
2060 GLint *srcX0, GLint *srcY0, GLint *srcX1, GLint *srcY1,
2061 GLint *dstX0, GLint *dstY0, GLint *dstX1, GLint *dstY1)
2062 {
2063 const GLint srcXmin = 0;
2064 const GLint srcXmax = ctx->ReadBuffer->Width;
2065 const GLint srcYmin = 0;
2066 const GLint srcYmax = ctx->ReadBuffer->Height;
2067
2068 /* these include scissor bounds */
2069 const GLint dstXmin = ctx->DrawBuffer->_Xmin;
2070 const GLint dstXmax = ctx->DrawBuffer->_Xmax;
2071 const GLint dstYmin = ctx->DrawBuffer->_Ymin;
2072 const GLint dstYmax = ctx->DrawBuffer->_Ymax;
2073
2074 /*
2075 printf("PreClipX: src: %d .. %d dst: %d .. %d\n",
2076 *srcX0, *srcX1, *dstX0, *dstX1);
2077 printf("PreClipY: src: %d .. %d dst: %d .. %d\n",
2078 *srcY0, *srcY1, *dstY0, *dstY1);
2079 */
2080
2081 /* trivial rejection tests */
2082 if (*dstX0 == *dstX1)
2083 return GL_FALSE; /* no width */
2084 if (*dstX0 <= dstXmin && *dstX1 <= dstXmin)
2085 return GL_FALSE; /* totally out (left) of bounds */
2086 if (*dstX0 >= dstXmax && *dstX1 >= dstXmax)
2087 return GL_FALSE; /* totally out (right) of bounds */
2088
2089 if (*dstY0 == *dstY1)
2090 return GL_FALSE;
2091 if (*dstY0 <= dstYmin && *dstY1 <= dstYmin)
2092 return GL_FALSE;
2093 if (*dstY0 >= dstYmax && *dstY1 >= dstYmax)
2094 return GL_FALSE;
2095
2096 if (*srcX0 == *srcX1)
2097 return GL_FALSE;
2098 if (*srcX0 <= srcXmin && *srcX1 <= srcXmin)
2099 return GL_FALSE;
2100 if (*srcX0 >= srcXmax && *srcX1 >= srcXmax)
2101 return GL_FALSE;
2102
2103 if (*srcY0 == *srcY1)
2104 return GL_FALSE;
2105 if (*srcY0 <= srcYmin && *srcY1 <= srcYmin)
2106 return GL_FALSE;
2107 if (*srcY0 >= srcYmax && *srcY1 >= srcYmax)
2108 return GL_FALSE;
2109
2110 /*
2111 * dest clip
2112 */
2113 clip_right_or_top(srcX0, srcX1, dstX0, dstX1, dstXmax);
2114 clip_right_or_top(srcY0, srcY1, dstY0, dstY1, dstYmax);
2115 clip_left_or_bottom(srcX0, srcX1, dstX0, dstX1, dstXmin);
2116 clip_left_or_bottom(srcY0, srcY1, dstY0, dstY1, dstYmin);
2117
2118 /*
2119 * src clip (just swap src/dst values from above)
2120 */
2121 clip_right_or_top(dstX0, dstX1, srcX0, srcX1, srcXmax);
2122 clip_right_or_top(dstY0, dstY1, srcY0, srcY1, srcYmax);
2123 clip_left_or_bottom(dstX0, dstX1, srcX0, srcX1, srcXmin);
2124 clip_left_or_bottom(dstY0, dstY1, srcY0, srcY1, srcYmin);
2125
2126 /*
2127 printf("PostClipX: src: %d .. %d dst: %d .. %d\n",
2128 *srcX0, *srcX1, *dstX0, *dstX1);
2129 printf("PostClipY: src: %d .. %d dst: %d .. %d\n",
2130 *srcY0, *srcY1, *dstY0, *dstY1);
2131 */
2132
2133 ASSERT(*dstX0 >= dstXmin);
2134 ASSERT(*dstX0 <= dstXmax);
2135 ASSERT(*dstX1 >= dstXmin);
2136 ASSERT(*dstX1 <= dstXmax);
2137
2138 ASSERT(*dstY0 >= dstYmin);
2139 ASSERT(*dstY0 <= dstYmax);
2140 ASSERT(*dstY1 >= dstYmin);
2141 ASSERT(*dstY1 <= dstYmax);
2142
2143 ASSERT(*srcX0 >= srcXmin);
2144 ASSERT(*srcX0 <= srcXmax);
2145 ASSERT(*srcX1 >= srcXmin);
2146 ASSERT(*srcX1 <= srcXmax);
2147
2148 ASSERT(*srcY0 >= srcYmin);
2149 ASSERT(*srcY0 <= srcYmax);
2150 ASSERT(*srcY1 >= srcYmin);
2151 ASSERT(*srcY1 <= srcYmax);
2152
2153 return GL_TRUE;
2154 }