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 "texcompress.h"
38 #include "texformat.h"
40 #define RETURN_IF_SUPPORTED(f) do { \
41 if (ctx->TextureFormatSupported[f]) \
46 * Choose an appropriate texture format given the format, type and
47 * internalFormat parameters passed to glTexImage().
49 * \param ctx the GL context.
50 * \param internalFormat user's prefered internal texture format.
51 * \param format incoming image pixel format.
52 * \param type incoming image data type.
54 * \return a pointer to a gl_texture_format object which describes the
55 * choosen texture format, or NULL on failure.
57 * This is called via dd_function_table::ChooseTextureFormat. Hardware drivers
58 * will typically override this function with a specialized version.
61 _mesa_choose_tex_format( struct gl_context
*ctx
, GLint internalFormat
,
62 GLenum format
, GLenum type
)
67 switch (internalFormat
) {
68 /* shallow RGBA formats */
71 if (type
== GL_UNSIGNED_SHORT_4_4_4_4_REV
) {
72 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444
);
73 } else if (type
== GL_UNSIGNED_SHORT_1_5_5_5_REV
) {
74 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB1555
);
76 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
77 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
81 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
82 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
85 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB1555
);
88 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444_REV
); /* just to test another format*/
89 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444
);
92 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB4444
);
95 /* deep RGBA formats */
97 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB2101010
);
98 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
102 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_16
);
103 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_16
);
104 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
105 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
108 /* shallow RGB formats */
112 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB888
);
113 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
114 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
117 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB332
);
118 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB888
);
119 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
120 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
123 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB565_REV
); /* just to test another format */
124 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB565
);
127 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB565
);
130 /* deep RGB formats */
134 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_16
);
135 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
136 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
143 RETURN_IF_SUPPORTED(MESA_FORMAT_A8
);
148 RETURN_IF_SUPPORTED(MESA_FORMAT_A16
);
149 RETURN_IF_SUPPORTED(MESA_FORMAT_A8
);
152 /* Luminance formats */
157 RETURN_IF_SUPPORTED(MESA_FORMAT_L8
);
162 RETURN_IF_SUPPORTED(MESA_FORMAT_L16
);
163 RETURN_IF_SUPPORTED(MESA_FORMAT_L8
);
166 /* Luminance/Alpha formats */
167 case GL_LUMINANCE4_ALPHA4
:
168 RETURN_IF_SUPPORTED(MESA_FORMAT_AL44
);
169 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
173 case GL_LUMINANCE_ALPHA
:
174 case GL_LUMINANCE6_ALPHA2
:
175 case GL_LUMINANCE8_ALPHA8
:
176 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
179 case GL_LUMINANCE12_ALPHA4
:
180 case GL_LUMINANCE12_ALPHA12
:
181 case GL_LUMINANCE16_ALPHA16
:
182 RETURN_IF_SUPPORTED(MESA_FORMAT_AL1616
);
183 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
189 RETURN_IF_SUPPORTED(MESA_FORMAT_I8
);
194 RETURN_IF_SUPPORTED(MESA_FORMAT_I16
);
195 RETURN_IF_SUPPORTED(MESA_FORMAT_I8
);
199 case GL_COLOR_INDEX1_EXT
:
200 case GL_COLOR_INDEX2_EXT
:
201 case GL_COLOR_INDEX4_EXT
:
202 case GL_COLOR_INDEX12_EXT
:
203 case GL_COLOR_INDEX16_EXT
:
204 case GL_COLOR_INDEX8_EXT
:
205 RETURN_IF_SUPPORTED(MESA_FORMAT_CI8
);
212 if (ctx
->Extensions
.ARB_depth_texture
) {
213 switch (internalFormat
) {
214 case GL_DEPTH_COMPONENT
:
215 case GL_DEPTH_COMPONENT24
:
216 case GL_DEPTH_COMPONENT32
:
217 RETURN_IF_SUPPORTED(MESA_FORMAT_Z32
);
218 RETURN_IF_SUPPORTED(MESA_FORMAT_S8_Z24
);
220 case GL_DEPTH_COMPONENT16
:
221 RETURN_IF_SUPPORTED(MESA_FORMAT_Z16
);
222 RETURN_IF_SUPPORTED(MESA_FORMAT_S8_Z24
);
228 switch (internalFormat
) {
229 case GL_COMPRESSED_ALPHA_ARB
:
230 RETURN_IF_SUPPORTED(MESA_FORMAT_A8
);
232 case GL_COMPRESSED_LUMINANCE_ARB
:
233 RETURN_IF_SUPPORTED(MESA_FORMAT_L8
);
235 case GL_COMPRESSED_LUMINANCE_ALPHA_ARB
:
236 RETURN_IF_SUPPORTED(MESA_FORMAT_AL88
);
238 case GL_COMPRESSED_INTENSITY_ARB
:
239 RETURN_IF_SUPPORTED(MESA_FORMAT_I8
);
241 case GL_COMPRESSED_RGB_ARB
:
242 if (ctx
->Extensions
.EXT_texture_compression_s3tc
||
243 ctx
->Extensions
.S3_s3tc
)
244 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_DXT1
);
245 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
)
246 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FXT1
);
247 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB888
);
248 RETURN_IF_SUPPORTED(MESA_FORMAT_XRGB8888
);
249 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
251 case GL_COMPRESSED_RGBA_ARB
:
252 if (ctx
->Extensions
.EXT_texture_compression_s3tc
||
253 ctx
->Extensions
.S3_s3tc
)
254 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT3
); /* Not rgba_dxt1, see spec */
255 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
)
256 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FXT1
);
257 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA8888
);
258 RETURN_IF_SUPPORTED(MESA_FORMAT_ARGB8888
);
264 if (ctx
->Extensions
.MESA_ycbcr_texture
) {
265 if (internalFormat
== GL_YCBCR_MESA
) {
266 if (type
== GL_UNSIGNED_SHORT_8_8_MESA
)
267 RETURN_IF_SUPPORTED(MESA_FORMAT_YCBCR
);
269 RETURN_IF_SUPPORTED(MESA_FORMAT_YCBCR_REV
);
273 #if FEATURE_texture_fxt1
274 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
) {
275 switch (internalFormat
) {
276 case GL_COMPRESSED_RGB_FXT1_3DFX
:
277 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FXT1
);
279 case GL_COMPRESSED_RGBA_FXT1_3DFX
:
280 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FXT1
);
288 #if FEATURE_texture_s3tc
289 if (ctx
->Extensions
.EXT_texture_compression_s3tc
) {
290 switch (internalFormat
) {
291 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT
:
292 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_DXT1
);
294 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
:
295 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT1
);
297 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
:
298 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT3
);
300 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
:
301 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT5
);
308 if (ctx
->Extensions
.S3_s3tc
) {
309 switch (internalFormat
) {
312 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_DXT1
);
316 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_DXT3
);
324 if (ctx
->Extensions
.ARB_texture_float
) {
325 switch (internalFormat
) {
326 case GL_ALPHA16F_ARB
:
327 RETURN_IF_SUPPORTED(MESA_FORMAT_ALPHA_FLOAT16
);
329 case GL_ALPHA32F_ARB
:
330 RETURN_IF_SUPPORTED(MESA_FORMAT_ALPHA_FLOAT32
);
332 case GL_LUMINANCE16F_ARB
:
333 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_FLOAT16
);
335 case GL_LUMINANCE32F_ARB
:
336 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_FLOAT32
);
338 case GL_LUMINANCE_ALPHA16F_ARB
:
339 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16
);
341 case GL_LUMINANCE_ALPHA32F_ARB
:
342 RETURN_IF_SUPPORTED(MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32
);
344 case GL_INTENSITY16F_ARB
:
345 RETURN_IF_SUPPORTED(MESA_FORMAT_INTENSITY_FLOAT16
);
347 case GL_INTENSITY32F_ARB
:
348 RETURN_IF_SUPPORTED(MESA_FORMAT_INTENSITY_FLOAT32
);
351 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FLOAT16
);
354 RETURN_IF_SUPPORTED(MESA_FORMAT_RGB_FLOAT32
);
357 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FLOAT16
);
360 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_FLOAT32
);
367 if (ctx
->Extensions
.EXT_packed_depth_stencil
) {
368 switch (internalFormat
) {
369 case GL_DEPTH_STENCIL_EXT
:
370 case GL_DEPTH24_STENCIL8_EXT
:
371 RETURN_IF_SUPPORTED(MESA_FORMAT_Z24_S8
);
372 RETURN_IF_SUPPORTED(MESA_FORMAT_S8_Z24
);
379 if (ctx
->Extensions
.ATI_envmap_bumpmap
) {
380 switch (internalFormat
) {
383 RETURN_IF_SUPPORTED(MESA_FORMAT_DUDV8
);
390 if (ctx
->Extensions
.MESA_texture_signed_rgba
) {
391 switch (internalFormat
) {
394 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA8888
);
395 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA8888_REV
);
402 if (ctx
->VersionMajor
* 10 + ctx
->VersionMinor
>= 31) {
403 switch (internalFormat
) {
406 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_R8
);
410 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RG88
);
414 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBX8888
);
418 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA8888
);
421 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_R_16
);
424 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RG_16
);
427 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGB_16
);
429 case GL_RGBA16_SNORM
:
430 RETURN_IF_SUPPORTED(MESA_FORMAT_SIGNED_RGBA_16
);
437 #if FEATURE_EXT_texture_sRGB
438 if (ctx
->Extensions
.EXT_texture_sRGB
) {
439 switch (internalFormat
) {
442 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB8
);
443 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
445 case GL_SRGB_ALPHA_EXT
:
446 case GL_SRGB8_ALPHA8_EXT
:
447 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA8
);
448 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
450 case GL_SLUMINANCE_EXT
:
451 case GL_SLUMINANCE8_EXT
:
452 RETURN_IF_SUPPORTED(MESA_FORMAT_SL8
);
453 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
455 case GL_SLUMINANCE_ALPHA_EXT
:
456 case GL_SLUMINANCE8_ALPHA8_EXT
:
457 RETURN_IF_SUPPORTED(MESA_FORMAT_SLA8
);
458 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
460 case GL_COMPRESSED_SLUMINANCE_EXT
:
461 RETURN_IF_SUPPORTED(MESA_FORMAT_SL8
);
462 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
464 case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT
:
465 RETURN_IF_SUPPORTED(MESA_FORMAT_SLA8
);
466 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
468 case GL_COMPRESSED_SRGB_EXT
:
469 #if FEATURE_texture_s3tc
470 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
471 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB_DXT1
);
473 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB8
);
474 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
476 case GL_COMPRESSED_SRGB_ALPHA_EXT
:
477 #if FEATURE_texture_s3tc
478 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
479 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT3
); /* Not srgba_dxt1, see spec */
481 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA8
);
482 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
484 #if FEATURE_texture_s3tc
485 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
:
486 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
487 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGB_DXT1
);
488 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
490 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
:
491 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
492 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT1
);
493 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
495 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
:
496 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
497 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT3
);
498 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
500 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
:
501 if (ctx
->Extensions
.EXT_texture_compression_s3tc
)
502 RETURN_IF_SUPPORTED(MESA_FORMAT_SRGBA_DXT5
);
503 RETURN_IF_SUPPORTED(MESA_FORMAT_SARGB8
);
510 #endif /* FEATURE_EXT_texture_sRGB */
512 if (ctx
->Extensions
.EXT_texture_integer
) {
513 switch (internalFormat
) {
514 case GL_RGBA32UI_EXT
:
516 case GL_ALPHA32UI_EXT
:
517 case GL_INTENSITY32UI_EXT
:
518 case GL_LUMINANCE32UI_EXT
:
519 case GL_LUMINANCE_ALPHA32UI_EXT
:
520 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_UINT32
);
522 case GL_RGBA16UI_EXT
:
524 case GL_ALPHA16UI_EXT
:
525 case GL_INTENSITY16UI_EXT
:
526 case GL_LUMINANCE16UI_EXT
:
527 case GL_LUMINANCE_ALPHA16UI_EXT
:
528 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_UINT16
);
532 case GL_ALPHA8UI_EXT
:
533 case GL_INTENSITY8UI_EXT
:
534 case GL_LUMINANCE8UI_EXT
:
535 case GL_LUMINANCE_ALPHA8UI_EXT
:
536 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_UINT8
);
540 case GL_ALPHA32I_EXT
:
541 case GL_INTENSITY32I_EXT
:
542 case GL_LUMINANCE32I_EXT
:
543 case GL_LUMINANCE_ALPHA32I_EXT
:
544 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_INT32
);
548 case GL_ALPHA16I_EXT
:
549 case GL_INTENSITY16I_EXT
:
550 case GL_LUMINANCE16I_EXT
:
551 case GL_LUMINANCE_ALPHA16I_EXT
:
552 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_INT16
);
557 case GL_INTENSITY8I_EXT
:
558 case GL_LUMINANCE8I_EXT
:
559 case GL_LUMINANCE_ALPHA8I_EXT
:
560 RETURN_IF_SUPPORTED(MESA_FORMAT_RGBA_INT8
);
565 if (ctx
->Extensions
.ARB_texture_rg
) {
566 switch (internalFormat
) {
569 case GL_COMPRESSED_RED
:
570 RETURN_IF_SUPPORTED(MESA_FORMAT_R8
);
574 RETURN_IF_SUPPORTED(MESA_FORMAT_R16
);
579 case GL_COMPRESSED_RG
:
580 RETURN_IF_SUPPORTED(MESA_FORMAT_RG88
);
584 RETURN_IF_SUPPORTED(MESA_FORMAT_RG1616
);
592 _mesa_problem(ctx
, "unexpected format in _mesa_choose_tex_format()");
593 return MESA_FORMAT_NONE
;