2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 2009 VMware, Inc. All Rights Reserved.
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
42 * Normally, BYTE_TO_FLOAT(0) returns 0.00392 That causes problems when
43 * we later convert the float to a packed integer value (such as for
44 * GL_RGB5_A1) because we'll wind up with a non-zero value.
46 * We redefine the macros here so zero is handled correctly.
49 #define BYTE_TO_FLOAT(B) ((B) == 0 ? 0.0F : ((2.0F * (B) + 1.0F) * (1.0F/255.0F)))
52 #define SHORT_TO_FLOAT(S) ((S) == 0 ? 0.0F : ((2.0F * (S) + 1.0F) * (1.0F/65535.0F)))
56 /** Compute ceiling of integer quotient of A divided by B. */
57 #define CEILING( A, B ) ( (A) % (B) == 0 ? (A)/(B) : (A)/(B)+1 )
61 * \return GL_TRUE if type is packed pixel type, GL_FALSE otherwise.
64 _mesa_type_is_packed(GLenum type
)
67 case GL_UNSIGNED_BYTE_3_3_2
:
68 case GL_UNSIGNED_BYTE_2_3_3_REV
:
69 case GL_UNSIGNED_SHORT_5_6_5
:
70 case GL_UNSIGNED_SHORT_5_6_5_REV
:
71 case GL_UNSIGNED_SHORT_4_4_4_4
:
72 case GL_UNSIGNED_SHORT_4_4_4_4_REV
:
73 case GL_UNSIGNED_SHORT_5_5_5_1
:
74 case GL_UNSIGNED_SHORT_1_5_5_5_REV
:
75 case GL_UNSIGNED_INT_8_8_8_8
:
76 case GL_UNSIGNED_INT_8_8_8_8_REV
:
77 case GL_UNSIGNED_INT_10_10_10_2
:
78 case GL_UNSIGNED_INT_2_10_10_10_REV
:
79 case GL_UNSIGNED_SHORT_8_8_MESA
:
80 case GL_UNSIGNED_SHORT_8_8_REV_MESA
:
81 case GL_UNSIGNED_INT_24_8_EXT
:
91 * Flip the order of the 2 bytes in each word in the given array.
94 * \param n number of words.
97 _mesa_swap2( GLushort
*p
, GLuint n
)
100 for (i
= 0; i
< n
; i
++) {
101 p
[i
] = (p
[i
] >> 8) | ((p
[i
] << 8) & 0xff00);
108 * Flip the order of the 4 bytes in each word in the given array.
111 _mesa_swap4( GLuint
*p
, GLuint n
)
114 for (i
= 0; i
< n
; i
++) {
117 | ((b
>> 8) & 0xff00)
118 | ((b
<< 8) & 0xff0000)
119 | ((b
<< 24) & 0xff000000);
126 * Get the size of a GL data type.
128 * \param type GL data type.
130 * \return the size, in bytes, of the given data type, 0 if a GL_BITMAP, or -1
131 * if an invalid type enum.
134 _mesa_sizeof_type( GLenum type
)
139 case GL_UNSIGNED_BYTE
:
140 return sizeof(GLubyte
);
142 return sizeof(GLbyte
);
143 case GL_UNSIGNED_SHORT
:
144 return sizeof(GLushort
);
146 return sizeof(GLshort
);
147 case GL_UNSIGNED_INT
:
148 return sizeof(GLuint
);
150 return sizeof(GLint
);
152 return sizeof(GLfloat
);
154 return sizeof(GLdouble
);
155 case GL_HALF_FLOAT_ARB
:
156 return sizeof(GLhalfARB
);
164 * Same as _mesa_sizeof_type() but also accepting the packed pixel
168 _mesa_sizeof_packed_type( GLenum type
)
173 case GL_UNSIGNED_BYTE
:
174 return sizeof(GLubyte
);
176 return sizeof(GLbyte
);
177 case GL_UNSIGNED_SHORT
:
178 return sizeof(GLushort
);
180 return sizeof(GLshort
);
181 case GL_UNSIGNED_INT
:
182 return sizeof(GLuint
);
184 return sizeof(GLint
);
185 case GL_HALF_FLOAT_ARB
:
186 return sizeof(GLhalfARB
);
188 return sizeof(GLfloat
);
189 case GL_UNSIGNED_BYTE_3_3_2
:
190 return sizeof(GLubyte
);
191 case GL_UNSIGNED_BYTE_2_3_3_REV
:
192 return sizeof(GLubyte
);
193 case GL_UNSIGNED_SHORT_5_6_5
:
194 return sizeof(GLushort
);
195 case GL_UNSIGNED_SHORT_5_6_5_REV
:
196 return sizeof(GLushort
);
197 case GL_UNSIGNED_SHORT_4_4_4_4
:
198 return sizeof(GLushort
);
199 case GL_UNSIGNED_SHORT_4_4_4_4_REV
:
200 return sizeof(GLushort
);
201 case GL_UNSIGNED_SHORT_5_5_5_1
:
202 return sizeof(GLushort
);
203 case GL_UNSIGNED_SHORT_1_5_5_5_REV
:
204 return sizeof(GLushort
);
205 case GL_UNSIGNED_INT_8_8_8_8
:
206 return sizeof(GLuint
);
207 case GL_UNSIGNED_INT_8_8_8_8_REV
:
208 return sizeof(GLuint
);
209 case GL_UNSIGNED_INT_10_10_10_2
:
210 return sizeof(GLuint
);
211 case GL_UNSIGNED_INT_2_10_10_10_REV
:
212 return sizeof(GLuint
);
213 case GL_UNSIGNED_SHORT_8_8_MESA
:
214 case GL_UNSIGNED_SHORT_8_8_REV_MESA
:
215 return sizeof(GLushort
);
216 case GL_UNSIGNED_INT_24_8_EXT
:
217 return sizeof(GLuint
);
225 * Get the number of components in a pixel format.
227 * \param format pixel format.
229 * \return the number of components in the given format, or -1 if a bad format.
232 _mesa_components_in_format( GLenum format
)
236 case GL_COLOR_INDEX1_EXT
:
237 case GL_COLOR_INDEX2_EXT
:
238 case GL_COLOR_INDEX4_EXT
:
239 case GL_COLOR_INDEX8_EXT
:
240 case GL_COLOR_INDEX12_EXT
:
241 case GL_COLOR_INDEX16_EXT
:
242 case GL_STENCIL_INDEX
:
243 case GL_DEPTH_COMPONENT
:
245 case GL_RED_INTEGER_EXT
:
247 case GL_GREEN_INTEGER_EXT
:
249 case GL_BLUE_INTEGER_EXT
:
251 case GL_ALPHA_INTEGER_EXT
:
253 case GL_LUMINANCE_INTEGER_EXT
:
256 case GL_LUMINANCE_ALPHA
:
257 case GL_LUMINANCE_ALPHA_INTEGER_EXT
:
261 case GL_RGB_INTEGER_EXT
:
264 case GL_RGBA_INTEGER_EXT
:
274 case GL_DEPTH_STENCIL_EXT
:
286 * Get the bytes per pixel of pixel format type pair.
288 * \param format pixel format.
289 * \param type pixel type.
291 * \return bytes per pixel, or -1 if a bad format or type was given.
294 _mesa_bytes_per_pixel( GLenum format
, GLenum type
)
296 GLint comps
= _mesa_components_in_format( format
);
302 return 0; /* special case */
304 case GL_UNSIGNED_BYTE
:
305 return comps
* sizeof(GLubyte
);
307 case GL_UNSIGNED_SHORT
:
308 return comps
* sizeof(GLshort
);
310 case GL_UNSIGNED_INT
:
311 return comps
* sizeof(GLint
);
313 return comps
* sizeof(GLfloat
);
314 case GL_HALF_FLOAT_ARB
:
315 return comps
* sizeof(GLhalfARB
);
316 case GL_UNSIGNED_BYTE_3_3_2
:
317 case GL_UNSIGNED_BYTE_2_3_3_REV
:
318 if (format
== GL_RGB
|| format
== GL_BGR
)
319 return sizeof(GLubyte
);
321 return -1; /* error */
322 case GL_UNSIGNED_SHORT_5_6_5
:
323 case GL_UNSIGNED_SHORT_5_6_5_REV
:
324 if (format
== GL_RGB
|| format
== GL_BGR
)
325 return sizeof(GLushort
);
327 return -1; /* error */
328 case GL_UNSIGNED_SHORT_4_4_4_4
:
329 case GL_UNSIGNED_SHORT_4_4_4_4_REV
:
330 case GL_UNSIGNED_SHORT_5_5_5_1
:
331 case GL_UNSIGNED_SHORT_1_5_5_5_REV
:
332 if (format
== GL_RGBA
|| format
== GL_BGRA
|| format
== GL_ABGR_EXT
)
333 return sizeof(GLushort
);
336 case GL_UNSIGNED_INT_8_8_8_8
:
337 case GL_UNSIGNED_INT_8_8_8_8_REV
:
338 case GL_UNSIGNED_INT_10_10_10_2
:
339 case GL_UNSIGNED_INT_2_10_10_10_REV
:
340 if (format
== GL_RGBA
|| format
== GL_BGRA
|| format
== GL_ABGR_EXT
)
341 return sizeof(GLuint
);
344 case GL_UNSIGNED_SHORT_8_8_MESA
:
345 case GL_UNSIGNED_SHORT_8_8_REV_MESA
:
346 if (format
== GL_YCBCR_MESA
)
347 return sizeof(GLushort
);
350 case GL_UNSIGNED_INT_24_8_EXT
:
351 if (format
== GL_DEPTH_STENCIL_EXT
)
352 return sizeof(GLuint
);
362 * Test for a legal pixel format and type.
364 * \param format pixel format.
365 * \param type pixel type.
367 * \return GL_TRUE if the given pixel format and type are legal, or GL_FALSE
371 _mesa_is_legal_format_and_type( struct gl_context
*ctx
, GLenum format
, GLenum type
)
375 case GL_STENCIL_INDEX
:
379 case GL_UNSIGNED_BYTE
:
381 case GL_UNSIGNED_SHORT
:
383 case GL_UNSIGNED_INT
:
386 case GL_HALF_FLOAT_ARB
:
387 return ctx
->Extensions
.ARB_half_float_pixel
;
395 #if 0 /* not legal! see table 3.6 of the 1.5 spec */
399 case GL_LUMINANCE_ALPHA
:
400 case GL_DEPTH_COMPONENT
:
403 case GL_UNSIGNED_BYTE
:
405 case GL_UNSIGNED_SHORT
:
407 case GL_UNSIGNED_INT
:
410 case GL_HALF_FLOAT_ARB
:
411 return ctx
->Extensions
.ARB_half_float_pixel
;
416 if (!ctx
->Extensions
.ARB_texture_rg
)
421 case GL_UNSIGNED_BYTE
:
423 case GL_UNSIGNED_SHORT
:
425 case GL_UNSIGNED_INT
:
428 case GL_HALF_FLOAT_ARB
:
429 return ctx
->Extensions
.ARB_half_float_pixel
;
436 case GL_UNSIGNED_BYTE
:
438 case GL_UNSIGNED_SHORT
:
440 case GL_UNSIGNED_INT
:
442 case GL_UNSIGNED_BYTE_3_3_2
:
443 case GL_UNSIGNED_BYTE_2_3_3_REV
:
444 case GL_UNSIGNED_SHORT_5_6_5
:
445 case GL_UNSIGNED_SHORT_5_6_5_REV
:
447 case GL_HALF_FLOAT_ARB
:
448 return ctx
->Extensions
.ARB_half_float_pixel
;
454 /* NOTE: no packed types are supported with BGR. That's
455 * intentional, according to the GL spec.
458 case GL_UNSIGNED_BYTE
:
460 case GL_UNSIGNED_SHORT
:
462 case GL_UNSIGNED_INT
:
465 case GL_HALF_FLOAT_ARB
:
466 return ctx
->Extensions
.ARB_half_float_pixel
;
475 case GL_UNSIGNED_BYTE
:
477 case GL_UNSIGNED_SHORT
:
479 case GL_UNSIGNED_INT
:
481 case GL_UNSIGNED_SHORT_4_4_4_4
:
482 case GL_UNSIGNED_SHORT_4_4_4_4_REV
:
483 case GL_UNSIGNED_SHORT_5_5_5_1
:
484 case GL_UNSIGNED_SHORT_1_5_5_5_REV
:
485 case GL_UNSIGNED_INT_8_8_8_8
:
486 case GL_UNSIGNED_INT_8_8_8_8_REV
:
487 case GL_UNSIGNED_INT_10_10_10_2
:
488 case GL_UNSIGNED_INT_2_10_10_10_REV
:
490 case GL_HALF_FLOAT_ARB
:
491 return ctx
->Extensions
.ARB_half_float_pixel
;
496 if (type
== GL_UNSIGNED_SHORT_8_8_MESA
||
497 type
== GL_UNSIGNED_SHORT_8_8_REV_MESA
)
501 case GL_DEPTH_STENCIL_EXT
:
502 if (ctx
->Extensions
.EXT_packed_depth_stencil
503 && type
== GL_UNSIGNED_INT_24_8_EXT
)
511 case GL_UNSIGNED_BYTE
:
513 case GL_UNSIGNED_SHORT
:
515 case GL_UNSIGNED_INT
:
522 /* integer-valued formats */
523 case GL_RED_INTEGER_EXT
:
524 case GL_GREEN_INTEGER_EXT
:
525 case GL_BLUE_INTEGER_EXT
:
526 case GL_ALPHA_INTEGER_EXT
:
529 case GL_UNSIGNED_BYTE
:
531 case GL_UNSIGNED_SHORT
:
533 case GL_UNSIGNED_INT
:
534 return ctx
->Extensions
.EXT_texture_integer
;
539 case GL_RGB_INTEGER_EXT
:
542 case GL_UNSIGNED_BYTE
:
544 case GL_UNSIGNED_SHORT
:
546 case GL_UNSIGNED_INT
:
547 case GL_UNSIGNED_BYTE_3_3_2
:
548 case GL_UNSIGNED_BYTE_2_3_3_REV
:
549 case GL_UNSIGNED_SHORT_5_6_5
:
550 case GL_UNSIGNED_SHORT_5_6_5_REV
:
551 return ctx
->Extensions
.EXT_texture_integer
;
556 case GL_BGR_INTEGER_EXT
:
559 case GL_UNSIGNED_BYTE
:
561 case GL_UNSIGNED_SHORT
:
563 case GL_UNSIGNED_INT
:
564 /* NOTE: no packed formats w/ BGR format */
565 return ctx
->Extensions
.EXT_texture_integer
;
570 case GL_RGBA_INTEGER_EXT
:
571 case GL_BGRA_INTEGER_EXT
:
574 case GL_UNSIGNED_BYTE
:
576 case GL_UNSIGNED_SHORT
:
578 case GL_UNSIGNED_INT
:
580 case GL_UNSIGNED_SHORT_4_4_4_4
:
581 case GL_UNSIGNED_SHORT_4_4_4_4_REV
:
582 case GL_UNSIGNED_SHORT_5_5_5_1
:
583 case GL_UNSIGNED_SHORT_1_5_5_5_REV
:
584 case GL_UNSIGNED_INT_8_8_8_8
:
585 case GL_UNSIGNED_INT_8_8_8_8_REV
:
586 case GL_UNSIGNED_INT_10_10_10_2
:
587 case GL_UNSIGNED_INT_2_10_10_10_REV
:
588 return ctx
->Extensions
.EXT_texture_integer
;
593 case GL_LUMINANCE_INTEGER_EXT
:
594 case GL_LUMINANCE_ALPHA_INTEGER_EXT
:
597 case GL_UNSIGNED_BYTE
:
599 case GL_UNSIGNED_SHORT
:
601 case GL_UNSIGNED_INT
:
602 return ctx
->Extensions
.EXT_texture_integer
;
615 * Test if the given image format is a color/RGBA format (i.e., not color
616 * index, depth, stencil, etc).
617 * \param format the image format value (may by an internal texture format)
618 * \return GL_TRUE if its a color/RGBA format, GL_FALSE otherwise.
621 _mesa_is_color_format(GLenum format
)
639 case GL_LUMINANCE_ALPHA
:
640 case GL_LUMINANCE4_ALPHA4
:
641 case GL_LUMINANCE6_ALPHA2
:
642 case GL_LUMINANCE8_ALPHA8
:
643 case GL_LUMINANCE12_ALPHA4
:
644 case GL_LUMINANCE12_ALPHA12
:
645 case GL_LUMINANCE16_ALPHA16
:
677 /* float texture formats */
678 case GL_ALPHA16F_ARB
:
679 case GL_ALPHA32F_ARB
:
680 case GL_LUMINANCE16F_ARB
:
681 case GL_LUMINANCE32F_ARB
:
682 case GL_LUMINANCE_ALPHA16F_ARB
:
683 case GL_LUMINANCE_ALPHA32F_ARB
:
684 case GL_INTENSITY16F_ARB
:
685 case GL_INTENSITY32F_ARB
:
694 /* compressed formats */
695 case GL_COMPRESSED_ALPHA
:
696 case GL_COMPRESSED_LUMINANCE
:
697 case GL_COMPRESSED_LUMINANCE_ALPHA
:
698 case GL_COMPRESSED_INTENSITY
:
699 case GL_COMPRESSED_RED
:
700 case GL_COMPRESSED_RG
:
701 case GL_COMPRESSED_RGB
:
702 case GL_COMPRESSED_RGBA
:
707 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT
:
708 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
:
709 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
:
710 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
:
711 case GL_COMPRESSED_RGB_FXT1_3DFX
:
712 case GL_COMPRESSED_RGBA_FXT1_3DFX
:
713 #if FEATURE_EXT_texture_sRGB
716 case GL_SRGB_ALPHA_EXT
:
717 case GL_SRGB8_ALPHA8_EXT
:
718 case GL_SLUMINANCE_ALPHA_EXT
:
719 case GL_SLUMINANCE8_ALPHA8_EXT
:
720 case GL_SLUMINANCE_EXT
:
721 case GL_SLUMINANCE8_EXT
:
722 case GL_COMPRESSED_SRGB_EXT
:
723 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
:
724 case GL_COMPRESSED_SRGB_ALPHA_EXT
:
725 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
:
726 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
:
727 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
:
728 case GL_COMPRESSED_SLUMINANCE_EXT
:
729 case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT
:
730 #endif /* FEATURE_EXT_texture_sRGB */
731 case GL_COMPRESSED_RED_RGTC1
:
732 case GL_COMPRESSED_SIGNED_RED_RGTC1
:
733 case GL_COMPRESSED_RG_RGTC2
:
734 case GL_COMPRESSED_SIGNED_RG_RGTC2
:
735 /* signed, normalized texture formats */
738 /* generic integer formats */
739 case GL_RED_INTEGER_EXT
:
740 case GL_GREEN_INTEGER_EXT
:
741 case GL_BLUE_INTEGER_EXT
:
742 case GL_ALPHA_INTEGER_EXT
:
743 case GL_RGB_INTEGER_EXT
:
744 case GL_RGBA_INTEGER_EXT
:
745 case GL_BGR_INTEGER_EXT
:
746 case GL_BGRA_INTEGER_EXT
:
747 case GL_LUMINANCE_INTEGER_EXT
:
748 case GL_LUMINANCE_ALPHA_INTEGER_EXT
:
749 /* sized integer formats */
750 case GL_RGBA32UI_EXT
:
752 case GL_ALPHA32UI_EXT
:
753 case GL_INTENSITY32UI_EXT
:
754 case GL_LUMINANCE32UI_EXT
:
755 case GL_LUMINANCE_ALPHA32UI_EXT
:
756 case GL_RGBA16UI_EXT
:
758 case GL_ALPHA16UI_EXT
:
759 case GL_INTENSITY16UI_EXT
:
760 case GL_LUMINANCE16UI_EXT
:
761 case GL_LUMINANCE_ALPHA16UI_EXT
:
764 case GL_ALPHA8UI_EXT
:
765 case GL_INTENSITY8UI_EXT
:
766 case GL_LUMINANCE8UI_EXT
:
767 case GL_LUMINANCE_ALPHA8UI_EXT
:
770 case GL_ALPHA32I_EXT
:
771 case GL_INTENSITY32I_EXT
:
772 case GL_LUMINANCE32I_EXT
:
773 case GL_LUMINANCE_ALPHA32I_EXT
:
776 case GL_ALPHA16I_EXT
:
777 case GL_INTENSITY16I_EXT
:
778 case GL_LUMINANCE16I_EXT
:
779 case GL_LUMINANCE_ALPHA16I_EXT
:
783 case GL_INTENSITY8I_EXT
:
784 case GL_LUMINANCE8I_EXT
:
785 case GL_LUMINANCE_ALPHA8I_EXT
:
787 case GL_YCBCR_MESA
: /* not considered to be RGB */
796 * Test if the given image format is a color index format.
799 _mesa_is_index_format(GLenum format
)
803 case GL_COLOR_INDEX1_EXT
:
804 case GL_COLOR_INDEX2_EXT
:
805 case GL_COLOR_INDEX4_EXT
:
806 case GL_COLOR_INDEX8_EXT
:
807 case GL_COLOR_INDEX12_EXT
:
808 case GL_COLOR_INDEX16_EXT
:
817 * Test if the given image format is a depth component format.
820 _mesa_is_depth_format(GLenum format
)
823 case GL_DEPTH_COMPONENT
:
824 case GL_DEPTH_COMPONENT16
:
825 case GL_DEPTH_COMPONENT24
:
826 case GL_DEPTH_COMPONENT32
:
835 * Test if the given image format is a stencil format.
838 _mesa_is_stencil_format(GLenum format
)
841 case GL_STENCIL_INDEX
:
842 case GL_DEPTH_STENCIL
:
851 * Test if the given image format is a YCbCr format.
854 _mesa_is_ycbcr_format(GLenum format
)
866 * Test if the given image format is a depth+stencil format.
869 _mesa_is_depthstencil_format(GLenum format
)
872 case GL_DEPTH24_STENCIL8_EXT
:
873 case GL_DEPTH_STENCIL_EXT
:
882 * Test if the given image format is a depth or stencil format.
885 _mesa_is_depth_or_stencil_format(GLenum format
)
888 case GL_DEPTH_COMPONENT
:
889 case GL_DEPTH_COMPONENT16
:
890 case GL_DEPTH_COMPONENT24
:
891 case GL_DEPTH_COMPONENT32
:
892 case GL_STENCIL_INDEX
:
893 case GL_STENCIL_INDEX1_EXT
:
894 case GL_STENCIL_INDEX4_EXT
:
895 case GL_STENCIL_INDEX8_EXT
:
896 case GL_STENCIL_INDEX16_EXT
:
897 case GL_DEPTH_STENCIL_EXT
:
898 case GL_DEPTH24_STENCIL8_EXT
:
907 * Test if the given image format is a dudv format.
910 _mesa_is_dudv_format(GLenum format
)
923 * Test if the given format is an integer (non-normalized) format.
926 _mesa_is_integer_format(GLenum format
)
929 /* generic integer formats */
930 case GL_RED_INTEGER_EXT
:
931 case GL_GREEN_INTEGER_EXT
:
932 case GL_BLUE_INTEGER_EXT
:
933 case GL_ALPHA_INTEGER_EXT
:
934 case GL_RGB_INTEGER_EXT
:
935 case GL_RGBA_INTEGER_EXT
:
936 case GL_BGR_INTEGER_EXT
:
937 case GL_BGRA_INTEGER_EXT
:
938 case GL_LUMINANCE_INTEGER_EXT
:
939 case GL_LUMINANCE_ALPHA_INTEGER_EXT
:
940 /* specific integer formats */
941 case GL_RGBA32UI_EXT
:
943 case GL_ALPHA32UI_EXT
:
944 case GL_INTENSITY32UI_EXT
:
945 case GL_LUMINANCE32UI_EXT
:
946 case GL_LUMINANCE_ALPHA32UI_EXT
:
947 case GL_RGBA16UI_EXT
:
949 case GL_ALPHA16UI_EXT
:
950 case GL_INTENSITY16UI_EXT
:
951 case GL_LUMINANCE16UI_EXT
:
952 case GL_LUMINANCE_ALPHA16UI_EXT
:
955 case GL_ALPHA8UI_EXT
:
956 case GL_INTENSITY8UI_EXT
:
957 case GL_LUMINANCE8UI_EXT
:
958 case GL_LUMINANCE_ALPHA8UI_EXT
:
961 case GL_ALPHA32I_EXT
:
962 case GL_INTENSITY32I_EXT
:
963 case GL_LUMINANCE32I_EXT
:
964 case GL_LUMINANCE_ALPHA32I_EXT
:
967 case GL_ALPHA16I_EXT
:
968 case GL_INTENSITY16I_EXT
:
969 case GL_LUMINANCE16I_EXT
:
970 case GL_LUMINANCE_ALPHA16I_EXT
:
974 case GL_INTENSITY8I_EXT
:
975 case GL_LUMINANCE8I_EXT
:
976 case GL_LUMINANCE_ALPHA8I_EXT
:
985 * Test if an image format is a supported compressed format.
986 * \param format the internal format token provided by the user.
987 * \return GL_TRUE if compressed, GL_FALSE if uncompressed
990 _mesa_is_compressed_format(struct gl_context
*ctx
, GLenum format
)
993 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT
:
994 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
:
995 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
:
996 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
:
997 return ctx
->Extensions
.EXT_texture_compression_s3tc
;
1002 return ctx
->Extensions
.S3_s3tc
;
1003 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
:
1004 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
:
1005 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
:
1006 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
:
1007 return ctx
->Extensions
.EXT_texture_sRGB
1008 && ctx
->Extensions
.EXT_texture_compression_s3tc
;
1009 case GL_COMPRESSED_RGB_FXT1_3DFX
:
1010 case GL_COMPRESSED_RGBA_FXT1_3DFX
:
1011 return ctx
->Extensions
.TDFX_texture_compression_FXT1
;
1012 case GL_COMPRESSED_RED_RGTC1
:
1013 case GL_COMPRESSED_SIGNED_RED_RGTC1
:
1014 case GL_COMPRESSED_RG_RGTC2
:
1015 case GL_COMPRESSED_SIGNED_RG_RGTC2
:
1016 return ctx
->Extensions
.ARB_texture_compression_rgtc
;
1024 * Return the address of a specific pixel in an image (1D, 2D or 3D).
1026 * Pixel unpacking/packing parameters are observed according to \p packing.
1028 * \param dimensions either 1, 2 or 3 to indicate dimensionality of image
1029 * \param image starting address of image data
1030 * \param width the image width
1031 * \param height theimage height
1032 * \param format the pixel format
1033 * \param type the pixel data type
1034 * \param packing the pixelstore attributes
1035 * \param img which image in the volume (0 for 1D or 2D images)
1036 * \param row row of pixel in the image (0 for 1D images)
1037 * \param column column of pixel in the image
1039 * \return address of pixel on success, or NULL on error.
1041 * \sa gl_pixelstore_attrib.
1044 _mesa_image_address( GLuint dimensions
,
1045 const struct gl_pixelstore_attrib
*packing
,
1046 const GLvoid
*image
,
1047 GLsizei width
, GLsizei height
,
1048 GLenum format
, GLenum type
,
1049 GLint img
, GLint row
, GLint column
)
1051 GLint alignment
; /* 1, 2 or 4 */
1052 GLint pixels_per_row
;
1053 GLint rows_per_image
;
1056 GLint skipimages
; /* for 3-D volume images */
1057 GLubyte
*pixel_addr
;
1059 ASSERT(dimensions
>= 1 && dimensions
<= 3);
1061 alignment
= packing
->Alignment
;
1062 if (packing
->RowLength
> 0) {
1063 pixels_per_row
= packing
->RowLength
;
1066 pixels_per_row
= width
;
1068 if (packing
->ImageHeight
> 0) {
1069 rows_per_image
= packing
->ImageHeight
;
1072 rows_per_image
= height
;
1075 skippixels
= packing
->SkipPixels
;
1076 /* Note: SKIP_ROWS _is_ used for 1D images */
1077 skiprows
= packing
->SkipRows
;
1078 /* Note: SKIP_IMAGES is only used for 3D images */
1079 skipimages
= (dimensions
== 3) ? packing
->SkipImages
: 0;
1081 if (type
== GL_BITMAP
) {
1083 GLint comp_per_pixel
; /* components per pixel */
1084 GLint bytes_per_comp
; /* bytes per component */
1085 GLint bytes_per_row
;
1086 GLint bytes_per_image
;
1088 /* Compute bytes per component */
1089 bytes_per_comp
= _mesa_sizeof_packed_type( type
);
1090 if (bytes_per_comp
< 0) {
1094 /* Compute number of components per pixel */
1095 comp_per_pixel
= _mesa_components_in_format( format
);
1096 if (comp_per_pixel
< 0) {
1100 bytes_per_row
= alignment
1101 * CEILING( comp_per_pixel
*pixels_per_row
, 8*alignment
);
1103 bytes_per_image
= bytes_per_row
* rows_per_image
;
1105 pixel_addr
= (GLubyte
*) image
1106 + (skipimages
+ img
) * bytes_per_image
1107 + (skiprows
+ row
) * bytes_per_row
1108 + (skippixels
+ column
) / 8;
1111 /* Non-BITMAP data */
1112 GLint bytes_per_pixel
, bytes_per_row
, remainder
, bytes_per_image
;
1115 bytes_per_pixel
= _mesa_bytes_per_pixel( format
, type
);
1117 /* The pixel type and format should have been error checked earlier */
1118 assert(bytes_per_pixel
> 0);
1120 bytes_per_row
= pixels_per_row
* bytes_per_pixel
;
1121 remainder
= bytes_per_row
% alignment
;
1123 bytes_per_row
+= (alignment
- remainder
);
1125 ASSERT(bytes_per_row
% alignment
== 0);
1127 bytes_per_image
= bytes_per_row
* rows_per_image
;
1129 if (packing
->Invert
) {
1130 /* set pixel_addr to the last row */
1131 topOfImage
= bytes_per_row
* (height
- 1);
1132 bytes_per_row
= -bytes_per_row
;
1138 /* compute final pixel address */
1139 pixel_addr
= (GLubyte
*) image
1140 + (skipimages
+ img
) * bytes_per_image
1142 + (skiprows
+ row
) * bytes_per_row
1143 + (skippixels
+ column
) * bytes_per_pixel
;
1146 return (GLvoid
*) pixel_addr
;
1151 _mesa_image_address1d( const struct gl_pixelstore_attrib
*packing
,
1152 const GLvoid
*image
,
1154 GLenum format
, GLenum type
,
1157 return _mesa_image_address(1, packing
, image
, width
, 1,
1158 format
, type
, 0, 0, column
);
1163 _mesa_image_address2d( const struct gl_pixelstore_attrib
*packing
,
1164 const GLvoid
*image
,
1165 GLsizei width
, GLsizei height
,
1166 GLenum format
, GLenum type
,
1167 GLint row
, GLint column
)
1169 return _mesa_image_address(2, packing
, image
, width
, height
,
1170 format
, type
, 0, row
, column
);
1175 _mesa_image_address3d( const struct gl_pixelstore_attrib
*packing
,
1176 const GLvoid
*image
,
1177 GLsizei width
, GLsizei height
,
1178 GLenum format
, GLenum type
,
1179 GLint img
, GLint row
, GLint column
)
1181 return _mesa_image_address(3, packing
, image
, width
, height
,
1182 format
, type
, img
, row
, column
);
1188 * Compute the stride (in bytes) between image rows.
1190 * \param packing the pixelstore attributes
1191 * \param width image width.
1192 * \param format pixel format.
1193 * \param type pixel data type.
1195 * \return the stride in bytes for the given parameters, or -1 if error
1198 _mesa_image_row_stride( const struct gl_pixelstore_attrib
*packing
,
1199 GLint width
, GLenum format
, GLenum type
)
1201 GLint bytesPerRow
, remainder
;
1205 if (type
== GL_BITMAP
) {
1206 if (packing
->RowLength
== 0) {
1207 bytesPerRow
= (width
+ 7) / 8;
1210 bytesPerRow
= (packing
->RowLength
+ 7) / 8;
1214 /* Non-BITMAP data */
1215 const GLint bytesPerPixel
= _mesa_bytes_per_pixel(format
, type
);
1216 if (bytesPerPixel
<= 0)
1217 return -1; /* error */
1218 if (packing
->RowLength
== 0) {
1219 bytesPerRow
= bytesPerPixel
* width
;
1222 bytesPerRow
= bytesPerPixel
* packing
->RowLength
;
1226 remainder
= bytesPerRow
% packing
->Alignment
;
1227 if (remainder
> 0) {
1228 bytesPerRow
+= (packing
->Alignment
- remainder
);
1231 if (packing
->Invert
) {
1232 /* negate the bytes per row (negative row stride) */
1233 bytesPerRow
= -bytesPerRow
;
1241 * Compute the stride between images in a 3D texture (in bytes) for the given
1242 * pixel packing parameters and image width, format and type.
1245 _mesa_image_image_stride( const struct gl_pixelstore_attrib
*packing
,
1246 GLint width
, GLint height
,
1247 GLenum format
, GLenum type
)
1249 GLint bytesPerRow
, bytesPerImage
, remainder
;
1253 if (type
== GL_BITMAP
) {
1254 if (packing
->RowLength
== 0) {
1255 bytesPerRow
= (width
+ 7) / 8;
1258 bytesPerRow
= (packing
->RowLength
+ 7) / 8;
1262 const GLint bytesPerPixel
= _mesa_bytes_per_pixel(format
, type
);
1264 if (bytesPerPixel
<= 0)
1265 return -1; /* error */
1266 if (packing
->RowLength
== 0) {
1267 bytesPerRow
= bytesPerPixel
* width
;
1270 bytesPerRow
= bytesPerPixel
* packing
->RowLength
;
1274 remainder
= bytesPerRow
% packing
->Alignment
;
1276 bytesPerRow
+= (packing
->Alignment
- remainder
);
1278 if (packing
->ImageHeight
== 0)
1279 bytesPerImage
= bytesPerRow
* height
;
1281 bytesPerImage
= bytesPerRow
* packing
->ImageHeight
;
1283 return bytesPerImage
;
1289 * "Expand" a bitmap from 1-bit per pixel to 8-bits per pixel.
1290 * This is typically used to convert a bitmap into a GLubyte/pixel texture.
1291 * "On" bits will set texels to \p onValue.
1292 * "Off" bits will not modify texels.
1293 * \param width src bitmap width in pixels
1294 * \param height src bitmap height in pixels
1295 * \param unpack bitmap unpacking state
1296 * \param bitmap the src bitmap data
1297 * \param destBuffer start of dest buffer
1298 * \param destStride row stride in dest buffer
1299 * \param onValue if bit is 1, set destBuffer pixel to this value
1302 _mesa_expand_bitmap(GLsizei width
, GLsizei height
,
1303 const struct gl_pixelstore_attrib
*unpack
,
1304 const GLubyte
*bitmap
,
1305 GLubyte
*destBuffer
, GLint destStride
,
1308 const GLubyte
*srcRow
= (const GLubyte
*)
1309 _mesa_image_address2d(unpack
, bitmap
, width
, height
,
1310 GL_COLOR_INDEX
, GL_BITMAP
, 0, 0);
1311 const GLint srcStride
= _mesa_image_row_stride(unpack
, width
,
1312 GL_COLOR_INDEX
, GL_BITMAP
);
1315 #define SET_PIXEL(COL, ROW) \
1316 destBuffer[(ROW) * destStride + (COL)] = onValue;
1318 for (row
= 0; row
< height
; row
++) {
1319 const GLubyte
*src
= srcRow
;
1321 if (unpack
->LsbFirst
) {
1323 GLubyte mask
= 1U << (unpack
->SkipPixels
& 0x7);
1324 for (col
= 0; col
< width
; col
++) {
1327 SET_PIXEL(col
, row
);
1339 /* get ready for next row */
1345 GLubyte mask
= 128U >> (unpack
->SkipPixels
& 0x7);
1346 for (col
= 0; col
< width
; col
++) {
1349 SET_PIXEL(col
, row
);
1361 /* get ready for next row */
1366 srcRow
+= srcStride
;
1376 * Convert an array of RGBA colors from one datatype to another.
1377 * NOTE: src may equal dst. In that case, we use a temporary buffer.
1380 _mesa_convert_colors(GLenum srcType
, const GLvoid
*src
,
1381 GLenum dstType
, GLvoid
*dst
,
1382 GLuint count
, const GLubyte mask
[])
1384 GLuint tempBuffer
[MAX_WIDTH
][4];
1385 const GLboolean useTemp
= (src
== dst
);
1387 ASSERT(srcType
!= dstType
);
1390 case GL_UNSIGNED_BYTE
:
1391 if (dstType
== GL_UNSIGNED_SHORT
) {
1392 const GLubyte (*src1
)[4] = (const GLubyte (*)[4]) src
;
1393 GLushort (*dst2
)[4] = (GLushort (*)[4]) (useTemp
? tempBuffer
: dst
);
1395 for (i
= 0; i
< count
; i
++) {
1396 if (!mask
|| mask
[i
]) {
1397 dst2
[i
][RCOMP
] = UBYTE_TO_USHORT(src1
[i
][RCOMP
]);
1398 dst2
[i
][GCOMP
] = UBYTE_TO_USHORT(src1
[i
][GCOMP
]);
1399 dst2
[i
][BCOMP
] = UBYTE_TO_USHORT(src1
[i
][BCOMP
]);
1400 dst2
[i
][ACOMP
] = UBYTE_TO_USHORT(src1
[i
][ACOMP
]);
1404 memcpy(dst
, tempBuffer
, count
* 4 * sizeof(GLushort
));
1407 const GLubyte (*src1
)[4] = (const GLubyte (*)[4]) src
;
1408 GLfloat (*dst4
)[4] = (GLfloat (*)[4]) (useTemp
? tempBuffer
: dst
);
1410 ASSERT(dstType
== GL_FLOAT
);
1411 for (i
= 0; i
< count
; i
++) {
1412 if (!mask
|| mask
[i
]) {
1413 dst4
[i
][RCOMP
] = UBYTE_TO_FLOAT(src1
[i
][RCOMP
]);
1414 dst4
[i
][GCOMP
] = UBYTE_TO_FLOAT(src1
[i
][GCOMP
]);
1415 dst4
[i
][BCOMP
] = UBYTE_TO_FLOAT(src1
[i
][BCOMP
]);
1416 dst4
[i
][ACOMP
] = UBYTE_TO_FLOAT(src1
[i
][ACOMP
]);
1420 memcpy(dst
, tempBuffer
, count
* 4 * sizeof(GLfloat
));
1423 case GL_UNSIGNED_SHORT
:
1424 if (dstType
== GL_UNSIGNED_BYTE
) {
1425 const GLushort (*src2
)[4] = (const GLushort (*)[4]) src
;
1426 GLubyte (*dst1
)[4] = (GLubyte (*)[4]) (useTemp
? tempBuffer
: dst
);
1428 for (i
= 0; i
< count
; i
++) {
1429 if (!mask
|| mask
[i
]) {
1430 dst1
[i
][RCOMP
] = USHORT_TO_UBYTE(src2
[i
][RCOMP
]);
1431 dst1
[i
][GCOMP
] = USHORT_TO_UBYTE(src2
[i
][GCOMP
]);
1432 dst1
[i
][BCOMP
] = USHORT_TO_UBYTE(src2
[i
][BCOMP
]);
1433 dst1
[i
][ACOMP
] = USHORT_TO_UBYTE(src2
[i
][ACOMP
]);
1437 memcpy(dst
, tempBuffer
, count
* 4 * sizeof(GLubyte
));
1440 const GLushort (*src2
)[4] = (const GLushort (*)[4]) src
;
1441 GLfloat (*dst4
)[4] = (GLfloat (*)[4]) (useTemp
? tempBuffer
: dst
);
1443 ASSERT(dstType
== GL_FLOAT
);
1444 for (i
= 0; i
< count
; i
++) {
1445 if (!mask
|| mask
[i
]) {
1446 dst4
[i
][RCOMP
] = USHORT_TO_FLOAT(src2
[i
][RCOMP
]);
1447 dst4
[i
][GCOMP
] = USHORT_TO_FLOAT(src2
[i
][GCOMP
]);
1448 dst4
[i
][BCOMP
] = USHORT_TO_FLOAT(src2
[i
][BCOMP
]);
1449 dst4
[i
][ACOMP
] = USHORT_TO_FLOAT(src2
[i
][ACOMP
]);
1453 memcpy(dst
, tempBuffer
, count
* 4 * sizeof(GLfloat
));
1457 if (dstType
== GL_UNSIGNED_BYTE
) {
1458 const GLfloat (*src4
)[4] = (const GLfloat (*)[4]) src
;
1459 GLubyte (*dst1
)[4] = (GLubyte (*)[4]) (useTemp
? tempBuffer
: dst
);
1461 for (i
= 0; i
< count
; i
++) {
1462 if (!mask
|| mask
[i
]) {
1463 UNCLAMPED_FLOAT_TO_UBYTE(dst1
[i
][RCOMP
], src4
[i
][RCOMP
]);
1464 UNCLAMPED_FLOAT_TO_UBYTE(dst1
[i
][GCOMP
], src4
[i
][GCOMP
]);
1465 UNCLAMPED_FLOAT_TO_UBYTE(dst1
[i
][BCOMP
], src4
[i
][BCOMP
]);
1466 UNCLAMPED_FLOAT_TO_UBYTE(dst1
[i
][ACOMP
], src4
[i
][ACOMP
]);
1470 memcpy(dst
, tempBuffer
, count
* 4 * sizeof(GLubyte
));
1473 const GLfloat (*src4
)[4] = (const GLfloat (*)[4]) src
;
1474 GLushort (*dst2
)[4] = (GLushort (*)[4]) (useTemp
? tempBuffer
: dst
);
1476 ASSERT(dstType
== GL_UNSIGNED_SHORT
);
1477 for (i
= 0; i
< count
; i
++) {
1478 if (!mask
|| mask
[i
]) {
1479 UNCLAMPED_FLOAT_TO_USHORT(dst2
[i
][RCOMP
], src4
[i
][RCOMP
]);
1480 UNCLAMPED_FLOAT_TO_USHORT(dst2
[i
][GCOMP
], src4
[i
][GCOMP
]);
1481 UNCLAMPED_FLOAT_TO_USHORT(dst2
[i
][BCOMP
], src4
[i
][BCOMP
]);
1482 UNCLAMPED_FLOAT_TO_USHORT(dst2
[i
][ACOMP
], src4
[i
][ACOMP
]);
1486 memcpy(dst
, tempBuffer
, count
* 4 * sizeof(GLushort
));
1490 _mesa_problem(NULL
, "Invalid datatype in _mesa_convert_colors");
1498 * Perform basic clipping for glDrawPixels. The image's position and size
1499 * and the unpack SkipPixels and SkipRows are adjusted so that the image
1500 * region is entirely within the window and scissor bounds.
1501 * NOTE: this will only work when glPixelZoom is (1, 1) or (1, -1).
1502 * If Pixel.ZoomY is -1, *destY will be changed to be the first row which
1503 * we'll actually write. Beforehand, *destY-1 is the first drawing row.
1505 * \return GL_TRUE if image is ready for drawing or
1506 * GL_FALSE if image was completely clipped away (draw nothing)
1509 _mesa_clip_drawpixels(const struct gl_context
*ctx
,
1510 GLint
*destX
, GLint
*destY
,
1511 GLsizei
*width
, GLsizei
*height
,
1512 struct gl_pixelstore_attrib
*unpack
)
1514 const struct gl_framebuffer
*buffer
= ctx
->DrawBuffer
;
1516 if (unpack
->RowLength
== 0) {
1517 unpack
->RowLength
= *width
;
1520 ASSERT(ctx
->Pixel
.ZoomX
== 1.0F
);
1521 ASSERT(ctx
->Pixel
.ZoomY
== 1.0F
|| ctx
->Pixel
.ZoomY
== -1.0F
);
1524 if (*destX
< buffer
->_Xmin
) {
1525 unpack
->SkipPixels
+= (buffer
->_Xmin
- *destX
);
1526 *width
-= (buffer
->_Xmin
- *destX
);
1527 *destX
= buffer
->_Xmin
;
1529 /* right clipping */
1530 if (*destX
+ *width
> buffer
->_Xmax
)
1531 *width
-= (*destX
+ *width
- buffer
->_Xmax
);
1536 if (ctx
->Pixel
.ZoomY
== 1.0F
) {
1537 /* bottom clipping */
1538 if (*destY
< buffer
->_Ymin
) {
1539 unpack
->SkipRows
+= (buffer
->_Ymin
- *destY
);
1540 *height
-= (buffer
->_Ymin
- *destY
);
1541 *destY
= buffer
->_Ymin
;
1544 if (*destY
+ *height
> buffer
->_Ymax
)
1545 *height
-= (*destY
+ *height
- buffer
->_Ymax
);
1547 else { /* upside down */
1549 if (*destY
> buffer
->_Ymax
) {
1550 unpack
->SkipRows
+= (*destY
- buffer
->_Ymax
);
1551 *height
-= (*destY
- buffer
->_Ymax
);
1552 *destY
= buffer
->_Ymax
;
1554 /* bottom clipping */
1555 if (*destY
- *height
< buffer
->_Ymin
)
1556 *height
-= (buffer
->_Ymin
- (*destY
- *height
));
1557 /* adjust destY so it's the first row to write to */
1569 * Perform clipping for glReadPixels. The image's window position
1570 * and size, and the pack skipPixels, skipRows and rowLength are adjusted
1571 * so that the image region is entirely within the window bounds.
1572 * Note: this is different from _mesa_clip_drawpixels() in that the
1573 * scissor box is ignored, and we use the bounds of the current readbuffer
1576 * \return GL_TRUE if image is ready for drawing or
1577 * GL_FALSE if image was completely clipped away (draw nothing)
1580 _mesa_clip_readpixels(const struct gl_context
*ctx
,
1581 GLint
*srcX
, GLint
*srcY
,
1582 GLsizei
*width
, GLsizei
*height
,
1583 struct gl_pixelstore_attrib
*pack
)
1585 const struct gl_framebuffer
*buffer
= ctx
->ReadBuffer
;
1587 if (pack
->RowLength
== 0) {
1588 pack
->RowLength
= *width
;
1593 pack
->SkipPixels
+= (0 - *srcX
);
1594 *width
-= (0 - *srcX
);
1597 /* right clipping */
1598 if (*srcX
+ *width
> (GLsizei
) buffer
->Width
)
1599 *width
-= (*srcX
+ *width
- buffer
->Width
);
1604 /* bottom clipping */
1606 pack
->SkipRows
+= (0 - *srcY
);
1607 *height
-= (0 - *srcY
);
1611 if (*srcY
+ *height
> (GLsizei
) buffer
->Height
)
1612 *height
-= (*srcY
+ *height
- buffer
->Height
);
1622 * Do clipping for a glCopyTexSubImage call.
1623 * The framebuffer source region might extend outside the framebuffer
1624 * bounds. Clip the source region against the framebuffer bounds and
1625 * adjust the texture/dest position and size accordingly.
1627 * \return GL_FALSE if region is totally clipped, GL_TRUE otherwise.
1630 _mesa_clip_copytexsubimage(const struct gl_context
*ctx
,
1631 GLint
*destX
, GLint
*destY
,
1632 GLint
*srcX
, GLint
*srcY
,
1633 GLsizei
*width
, GLsizei
*height
)
1635 const struct gl_framebuffer
*fb
= ctx
->ReadBuffer
;
1636 const GLint srcX0
= *srcX
, srcY0
= *srcY
;
1638 if (_mesa_clip_to_region(0, 0, fb
->Width
, fb
->Height
,
1639 srcX
, srcY
, width
, height
)) {
1640 *destX
= *destX
+ *srcX
- srcX0
;
1641 *destY
= *destY
+ *srcY
- srcY0
;
1653 * Clip the rectangle defined by (x, y, width, height) against the bounds
1654 * specified by [xmin, xmax) and [ymin, ymax).
1655 * \return GL_FALSE if rect is totally clipped, GL_TRUE otherwise.
1658 _mesa_clip_to_region(GLint xmin
, GLint ymin
,
1659 GLint xmax
, GLint ymax
,
1661 GLsizei
*width
, GLsizei
*height
)
1665 *width
-= (xmin
- *x
);
1669 /* right clipping */
1670 if (*x
+ *width
> xmax
)
1671 *width
-= (*x
+ *width
- xmax
);
1676 /* bottom (or top) clipping */
1678 *height
-= (ymin
- *y
);
1682 /* top (or bottom) clipping */
1683 if (*y
+ *height
> ymax
)
1684 *height
-= (*y
+ *height
- ymax
);
1694 * Clip dst coords against Xmax (or Ymax).
1697 clip_right_or_top(GLint
*srcX0
, GLint
*srcX1
,
1698 GLint
*dstX0
, GLint
*dstX1
,
1703 if (*dstX1
> maxValue
) {
1704 /* X1 outside right edge */
1705 ASSERT(*dstX0
< maxValue
); /* X0 should be inside right edge */
1706 t
= (GLfloat
) (maxValue
- *dstX0
) / (GLfloat
) (*dstX1
- *dstX0
);
1707 /* chop off [t, 1] part */
1708 ASSERT(t
>= 0.0 && t
<= 1.0);
1710 bias
= (*srcX0
< *srcX1
) ? 0.5F
: -0.5F
;
1711 *srcX1
= *srcX0
+ (GLint
) (t
* (*srcX1
- *srcX0
) + bias
);
1713 else if (*dstX0
> maxValue
) {
1714 /* X0 outside right edge */
1715 ASSERT(*dstX1
< maxValue
); /* X1 should be inside right edge */
1716 t
= (GLfloat
) (maxValue
- *dstX1
) / (GLfloat
) (*dstX0
- *dstX1
);
1717 /* chop off [t, 1] part */
1718 ASSERT(t
>= 0.0 && t
<= 1.0);
1720 bias
= (*srcX0
< *srcX1
) ? -0.5F
: 0.5F
;
1721 *srcX0
= *srcX1
+ (GLint
) (t
* (*srcX0
- *srcX1
) + bias
);
1727 * Clip dst coords against Xmin (or Ymin).
1730 clip_left_or_bottom(GLint
*srcX0
, GLint
*srcX1
,
1731 GLint
*dstX0
, GLint
*dstX1
,
1736 if (*dstX0
< minValue
) {
1737 /* X0 outside left edge */
1738 ASSERT(*dstX1
> minValue
); /* X1 should be inside left edge */
1739 t
= (GLfloat
) (minValue
- *dstX0
) / (GLfloat
) (*dstX1
- *dstX0
);
1740 /* chop off [0, t] part */
1741 ASSERT(t
>= 0.0 && t
<= 1.0);
1743 bias
= (*srcX0
< *srcX1
) ? 0.5F
: -0.5F
; /* flipped??? */
1744 *srcX0
= *srcX0
+ (GLint
) (t
* (*srcX1
- *srcX0
) + bias
);
1746 else if (*dstX1
< minValue
) {
1747 /* X1 outside left edge */
1748 ASSERT(*dstX0
> minValue
); /* X0 should be inside left edge */
1749 t
= (GLfloat
) (minValue
- *dstX1
) / (GLfloat
) (*dstX0
- *dstX1
);
1750 /* chop off [0, t] part */
1751 ASSERT(t
>= 0.0 && t
<= 1.0);
1753 bias
= (*srcX0
< *srcX1
) ? 0.5F
: -0.5F
;
1754 *srcX1
= *srcX1
+ (GLint
) (t
* (*srcX0
- *srcX1
) + bias
);
1760 * Do clipping of blit src/dest rectangles.
1761 * The dest rect is clipped against both the buffer bounds and scissor bounds.
1762 * The src rect is just clipped against the buffer bounds.
1764 * When either the src or dest rect is clipped, the other is also clipped
1767 * Note that X0 need not be less than X1 (same for Y) for either the source
1768 * and dest rects. That makes the clipping a little trickier.
1770 * \return GL_TRUE if anything is left to draw, GL_FALSE if totally clipped
1773 _mesa_clip_blit(struct gl_context
*ctx
,
1774 GLint
*srcX0
, GLint
*srcY0
, GLint
*srcX1
, GLint
*srcY1
,
1775 GLint
*dstX0
, GLint
*dstY0
, GLint
*dstX1
, GLint
*dstY1
)
1777 const GLint srcXmin
= 0;
1778 const GLint srcXmax
= ctx
->ReadBuffer
->Width
;
1779 const GLint srcYmin
= 0;
1780 const GLint srcYmax
= ctx
->ReadBuffer
->Height
;
1782 /* these include scissor bounds */
1783 const GLint dstXmin
= ctx
->DrawBuffer
->_Xmin
;
1784 const GLint dstXmax
= ctx
->DrawBuffer
->_Xmax
;
1785 const GLint dstYmin
= ctx
->DrawBuffer
->_Ymin
;
1786 const GLint dstYmax
= ctx
->DrawBuffer
->_Ymax
;
1789 printf("PreClipX: src: %d .. %d dst: %d .. %d\n",
1790 *srcX0, *srcX1, *dstX0, *dstX1);
1791 printf("PreClipY: src: %d .. %d dst: %d .. %d\n",
1792 *srcY0, *srcY1, *dstY0, *dstY1);
1795 /* trivial rejection tests */
1796 if (*dstX0
== *dstX1
)
1797 return GL_FALSE
; /* no width */
1798 if (*dstX0
<= dstXmin
&& *dstX1
<= dstXmin
)
1799 return GL_FALSE
; /* totally out (left) of bounds */
1800 if (*dstX0
>= dstXmax
&& *dstX1
>= dstXmax
)
1801 return GL_FALSE
; /* totally out (right) of bounds */
1803 if (*dstY0
== *dstY1
)
1805 if (*dstY0
<= dstYmin
&& *dstY1
<= dstYmin
)
1807 if (*dstY0
>= dstYmax
&& *dstY1
>= dstYmax
)
1810 if (*srcX0
== *srcX1
)
1812 if (*srcX0
<= srcXmin
&& *srcX1
<= srcXmin
)
1814 if (*srcX0
>= srcXmax
&& *srcX1
>= srcXmax
)
1817 if (*srcY0
== *srcY1
)
1819 if (*srcY0
<= srcYmin
&& *srcY1
<= srcYmin
)
1821 if (*srcY0
>= srcYmax
&& *srcY1
>= srcYmax
)
1827 clip_right_or_top(srcX0
, srcX1
, dstX0
, dstX1
, dstXmax
);
1828 clip_right_or_top(srcY0
, srcY1
, dstY0
, dstY1
, dstYmax
);
1829 clip_left_or_bottom(srcX0
, srcX1
, dstX0
, dstX1
, dstXmin
);
1830 clip_left_or_bottom(srcY0
, srcY1
, dstY0
, dstY1
, dstYmin
);
1833 * src clip (just swap src/dst values from above)
1835 clip_right_or_top(dstX0
, dstX1
, srcX0
, srcX1
, srcXmax
);
1836 clip_right_or_top(dstY0
, dstY1
, srcY0
, srcY1
, srcYmax
);
1837 clip_left_or_bottom(dstX0
, dstX1
, srcX0
, srcX1
, srcXmin
);
1838 clip_left_or_bottom(dstY0
, dstY1
, srcY0
, srcY1
, srcYmin
);
1841 printf("PostClipX: src: %d .. %d dst: %d .. %d\n",
1842 *srcX0, *srcX1, *dstX0, *dstX1);
1843 printf("PostClipY: src: %d .. %d dst: %d .. %d\n",
1844 *srcY0, *srcY1, *dstY0, *dstY1);
1847 ASSERT(*dstX0
>= dstXmin
);
1848 ASSERT(*dstX0
<= dstXmax
);
1849 ASSERT(*dstX1
>= dstXmin
);
1850 ASSERT(*dstX1
<= dstXmax
);
1852 ASSERT(*dstY0
>= dstYmin
);
1853 ASSERT(*dstY0
<= dstYmax
);
1854 ASSERT(*dstY1
>= dstYmin
);
1855 ASSERT(*dstY1
<= dstYmax
);
1857 ASSERT(*srcX0
>= srcXmin
);
1858 ASSERT(*srcX0
<= srcXmax
);
1859 ASSERT(*srcX1
>= srcXmin
);
1860 ASSERT(*srcX1
<= srcXmax
);
1862 ASSERT(*srcY0
>= srcYmin
);
1863 ASSERT(*srcY0
<= srcYmax
);
1864 ASSERT(*srcY1
>= srcYmin
);
1865 ASSERT(*srcY1
<= srcYmax
);