2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (c) 2008-2009 VMware, Inc.
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.
31 * \author Gareth Hughes
37 #include "mfeatures.h"
39 #include "texcompress.h"
40 #include "texformat.h"
42 #define RETURN_IF_SUPPORTED(f) do { \
43 if (ctx->TextureFormatSupported[f]) \
48 * Choose an appropriate texture format given the format, type and
49 * internalFormat parameters passed to glTexImage().
51 * \param ctx the GL context.
52 * \param internalFormat user's prefered internal texture format.
53 * \param format incoming image pixel format.
54 * \param type incoming image data type.
56 * \return a pointer to a gl_texture_format object which describes the
57 * choosen texture format, or NULL on failure.
59 * This is called via dd_function_table::ChooseTextureFormat. Hardware drivers
60 * will typically override this function with a specialized version.
63 _mesa_choose_tex_format( struct gl_context
*ctx
, GLint internalFormat
,
64 GLenum format
, GLenum type
)
69 switch (internalFormat
) {
70 /* shallow RGBA formats */
73 if (type
== GL_UNSIGNED_SHORT_4_4_4_4_REV
) {
74 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444
);
75 } else if (type
== GL_UNSIGNED_SHORT_1_5_5_5_REV
) {
76 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB1555
);
78 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
79 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
83 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
84 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
87 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB1555
);
90 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444_REV
); /* just to test another format*/
91 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444
);
94 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444
);
97 /* deep RGBA formats */
99 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB2101010
);
100 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
104 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_16
);
105 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_16
);
106 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
107 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
110 /* shallow RGB formats */
114 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB888
);
115 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
116 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
119 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB332
);
120 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB888
);
121 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
122 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
125 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB565_REV
); /* just to test another format */
126 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB565
);
129 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB565
);
132 /* deep RGB formats */
136 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_16
);
137 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
138 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
145 RETURN_IF_SUPPORTED(MESA_FORMAT_A8
);
150 RETURN_IF_SUPPORTED(MESA_FORMAT_A16
);
151 RETURN_IF_SUPPORTED(MESA_FORMAT_A8
);
154 /* Luminance formats */
159 RETURN_IF_SUPPORTED(MESA_FORMAT_L8
);
164 RETURN_IF_SUPPORTED(MESA_FORMAT_L16
);
165 RETURN_IF_SUPPORTED(MESA_FORMAT_L8
);
168 /* Luminance/Alpha formats */
169 case GL_LUMINANCE4_ALPHA4
:
170 RETURN_IF_SUPPORTED(MESA_FORMAT_AL44
);
171 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
175 case GL_LUMINANCE_ALPHA
:
176 case GL_LUMINANCE6_ALPHA2
:
177 case GL_LUMINANCE8_ALPHA8
:
178 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
181 case GL_LUMINANCE12_ALPHA4
:
182 case GL_LUMINANCE12_ALPHA12
:
183 case GL_LUMINANCE16_ALPHA16
:
184 RETURN_IF_SUPPORTED(MESA_FORMAT_AL1616
);
185 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
191 RETURN_IF_SUPPORTED(MESA_FORMAT_I8
);
196 RETURN_IF_SUPPORTED(MESA_FORMAT_I16
);
197 RETURN_IF_SUPPORTED(MESA_FORMAT_I8
);
201 case GL_COLOR_INDEX1_EXT
:
202 case GL_COLOR_INDEX2_EXT
:
203 case GL_COLOR_INDEX4_EXT
:
204 case GL_COLOR_INDEX12_EXT
:
205 case GL_COLOR_INDEX16_EXT
:
206 case GL_COLOR_INDEX8_EXT
:
207 RETURN_IF_SUPPORTED(MESA_FORMAT_CI8
);
214 if (ctx
->Extensions
.ARB_depth_texture
) {
215 switch (internalFormat
) {
216 case GL_DEPTH_COMPONENT
:
217 case GL_DEPTH_COMPONENT24
:
218 case GL_DEPTH_COMPONENT32
:
219 RETURN_IF_SUPPORTED(MESA_FORMAT_Z32
);
220 RETURN_IF_SUPPORTED(MESA_FORMAT_S8_Z24
);
222 case GL_DEPTH_COMPONENT16
:
223 RETURN_IF_SUPPORTED(MESA_FORMAT_Z16
);
224 RETURN_IF_SUPPORTED(MESA_FORMAT_S8_Z24
);
230 switch (internalFormat
) {
231 case GL_COMPRESSED_ALPHA_ARB
:
232 RETURN_IF_SUPPORTED(MESA_FORMAT_A8
);
234 case GL_COMPRESSED_LUMINANCE_ARB
:
235 RETURN_IF_SUPPORTED(MESA_FORMAT_L8
);
237 case GL_COMPRESSED_LUMINANCE_ALPHA_ARB
:
238 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
240 case GL_COMPRESSED_INTENSITY_ARB
:
241 RETURN_IF_SUPPORTED(MESA_FORMAT_I8
);
243 case GL_COMPRESSED_RGB_ARB
:
244 if (ctx
->Extensions
.EXT_texture_compression_s3tc
||
245 ctx
->Extensions
.S3_s3tc
)
246 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_DXT1
);
247 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
)
248 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FXT1
);
249 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB888
);
250 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
251 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
253 case GL_COMPRESSED_RGBA_ARB
:
254 if (ctx
->Extensions
.EXT_texture_compression_s3tc
||
255 ctx
->Extensions
.S3_s3tc
)
256 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT3
); /* Not rgba_dxt1, see spec */
257 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
)
258 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FXT1
);
259 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
260 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
266 if (ctx
->Extensions
.MESA_ycbcr_texture
) {
267 if (internalFormat
== GL_YCBCR_MESA
) {
268 if (type
== GL_UNSIGNED_SHORT_8_8_MESA
)
269 RETURN_IF_SUPPORTED(MESA_FORMAT_YCBCR
);
271 RETURN_IF_SUPPORTED(MESA_FORMAT_YCBCR_REV
);
275 #if FEATURE_texture_fxt1
276 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
) {
277 switch (internalFormat
) {
278 case GL_COMPRESSED_RGB_FXT1_3DFX
:
279 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FXT1
);
281 case GL_COMPRESSED_RGBA_FXT1_3DFX
:
282 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FXT1
);
290 #if FEATURE_texture_s3tc
291 if (ctx
->Extensions
.EXT_texture_compression_s3tc
) {
292 switch (internalFormat
) {
293 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT
:
294 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_DXT1
);
296 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
:
297 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT1
);
299 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
:
300 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT3
);
302 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
:
303 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT5
);
310 if (ctx
->Extensions
.S3_s3tc
) {
311 switch (internalFormat
) {
314 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_DXT1
);
318 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT3
);
326 if (ctx
->Extensions
.ARB_texture_float
) {
327 switch (internalFormat
) {
328 case GL_ALPHA16F_ARB
:
329 RETURN_IF_SUPPORTED(MESA_FORMAT_ALPHA_FLOAT16
);
331 case GL_ALPHA32F_ARB
:
332 RETURN_IF_SUPPORTED(MESA_FORMAT_ALPHA_FLOAT32
);
334 case GL_LUMINANCE16F_ARB
:
335 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_FLOAT16
);
337 case GL_LUMINANCE32F_ARB
:
338 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_FLOAT32
);
340 case GL_LUMINANCE_ALPHA16F_ARB
:
341 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16
);
343 case GL_LUMINANCE_ALPHA32F_ARB
:
344 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32
);
346 case GL_INTENSITY16F_ARB
:
347 RETURN_IF_SUPPORTED(MESA_FORMAT_INTENSITY_FLOAT16
);
349 case GL_INTENSITY32F_ARB
:
350 RETURN_IF_SUPPORTED(MESA_FORMAT_INTENSITY_FLOAT32
);
353 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FLOAT16
);
356 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FLOAT32
);
359 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FLOAT16
);
362 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FLOAT32
);
369 if (ctx
->Extensions
.EXT_packed_depth_stencil
) {
370 switch (internalFormat
) {
371 case GL_DEPTH_STENCIL_EXT
:
372 case GL_DEPTH24_STENCIL8_EXT
:
373 RETURN_IF_SUPPORTED(MESA_FORMAT_Z24_S8
);
374 RETURN_IF_SUPPORTED(MESA_FORMAT_S8_Z24
);
381 if (ctx
->Extensions
.ATI_envmap_bumpmap
) {
382 switch (internalFormat
) {
385 RETURN_IF_SUPPORTED(MESA_FORMAT_DUDV8
);
392 if (ctx
->Extensions
.MESA_texture_signed_rgba
) {
393 switch (internalFormat
) {
396 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA8888
);
397 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA8888_REV
);
404 if (ctx
->VersionMajor
* 10 + ctx
->VersionMinor
>= 31) {
405 switch (internalFormat
) {
408 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_R8
);
412 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RG88
);
416 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBX8888
);
420 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA8888
);
423 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_R_16
);
426 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RG_16
);
429 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGB_16
);
431 case GL_RGBA16_SNORM
:
432 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA_16
);
439 #if FEATURE_EXT_texture_sRGB
440 if (ctx
->Extensions
.EXT_texture_sRGB
) {
441 switch (internalFormat
) {
444 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB8
);
445 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
447 case GL_SRGB_ALPHA_EXT
:
448 case GL_SRGB8_ALPHA8_EXT
:
449 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA8
);
450 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
452 case GL_SLUMINANCE_EXT
:
453 case GL_SLUMINANCE8_EXT
:
454 RETURN_IF_SUPPORTED(MESA_FORMAT_SL8
);
455 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
457 case GL_SLUMINANCE_ALPHA_EXT
:
458 case GL_SLUMINANCE8_ALPHA8_EXT
:
459 RETURN_IF_SUPPORTED(MESA_FORMAT_SLA8
);
460 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
462 case GL_COMPRESSED_SLUMINANCE_EXT
:
463 RETURN_IF_SUPPORTED(MESA_FORMAT_SL8
);
464 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
466 case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT
:
467 RETURN_IF_SUPPORTED(MESA_FORMAT_SLA8
);
468 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
470 case GL_COMPRESSED_SRGB_EXT
:
471 #if FEATURE_texture_s3tc
472 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
473 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB_DXT1
);
475 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB8
);
476 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
478 case GL_COMPRESSED_SRGB_ALPHA_EXT
:
479 #if FEATURE_texture_s3tc
480 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
481 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT3
); /* Not srgba_dxt1, see spec */
483 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA8
);
484 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
486 #if FEATURE_texture_s3tc
487 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
:
488 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
489 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB_DXT1
);
490 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
492 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
:
493 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
494 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT1
);
495 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
497 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
:
498 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
499 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT3
);
500 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
502 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
:
503 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
504 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT5
);
505 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
512 #endif /* FEATURE_EXT_texture_sRGB */
514 if (ctx
->Extensions
.EXT_texture_integer
) {
515 switch (internalFormat
) {
516 case GL_RGBA32UI_EXT
:
518 case GL_ALPHA32UI_EXT
:
519 case GL_INTENSITY32UI_EXT
:
520 case GL_LUMINANCE32UI_EXT
:
521 case GL_LUMINANCE_ALPHA32UI_EXT
:
522 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_UINT32
);
524 case GL_RGBA16UI_EXT
:
526 case GL_ALPHA16UI_EXT
:
527 case GL_INTENSITY16UI_EXT
:
528 case GL_LUMINANCE16UI_EXT
:
529 case GL_LUMINANCE_ALPHA16UI_EXT
:
530 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_UINT16
);
534 case GL_ALPHA8UI_EXT
:
535 case GL_INTENSITY8UI_EXT
:
536 case GL_LUMINANCE8UI_EXT
:
537 case GL_LUMINANCE_ALPHA8UI_EXT
:
538 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_UINT8
);
542 case GL_ALPHA32I_EXT
:
543 case GL_INTENSITY32I_EXT
:
544 case GL_LUMINANCE32I_EXT
:
545 case GL_LUMINANCE_ALPHA32I_EXT
:
546 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_INT32
);
550 case GL_ALPHA16I_EXT
:
551 case GL_INTENSITY16I_EXT
:
552 case GL_LUMINANCE16I_EXT
:
553 case GL_LUMINANCE_ALPHA16I_EXT
:
554 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_INT16
);
559 case GL_INTENSITY8I_EXT
:
560 case GL_LUMINANCE8I_EXT
:
561 case GL_LUMINANCE_ALPHA8I_EXT
:
562 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_INT8
);
567 if (ctx
->Extensions
.ARB_texture_rg
) {
568 switch (internalFormat
) {
571 case GL_COMPRESSED_RED
:
572 RETURN_IF_SUPPORTED(MESA_FORMAT_R8
);
576 RETURN_IF_SUPPORTED(MESA_FORMAT_R16
);
581 case GL_COMPRESSED_RG
:
582 RETURN_IF_SUPPORTED(MESA_FORMAT_RG88
);
586 RETURN_IF_SUPPORTED(MESA_FORMAT_RG1616
);
594 _mesa_problem(ctx
, "unexpected format in _mesa_choose_tex_format()");
595 return MESA_FORMAT_NONE
;