src/mesa/main/texformat.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  7.7
   4  *
   5  * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
   6  * Copyright (c) 2008-2009 VMware, Inc.
   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 texformat.c
  29  * Texture formats.
  30  *
  31  * \author Gareth Hughes
  32  * \author Brian Paul
  33  */
  34
  35
  36 #include "context.h"
  37 #include "texcompress.h"
  38 #include "texformat.h"
  39
  40
  41 /**
  42  * Choose an appropriate texture format given the format, type and
  43  * internalFormat parameters passed to glTexImage().
  44  *
  45  * \param ctx  the GL context.
  46  * \param internalFormat  user's prefered internal texture format.
  47  * \param format  incoming image pixel format.
  48  * \param type  incoming image data type.
  49  *
  50  * \return a pointer to a gl_texture_format object which describes the
  51  * choosen texture format, or NULL on failure.
  52  *
  53  * This is called via dd_function_table::ChooseTextureFormat.  Hardware drivers
  54  * will typically override this function with a specialized version.
  55  */
  56 gl_format
  57 _mesa_choose_tex_format( struct gl_context *ctx, GLint internalFormat,
  58                          GLenum format, GLenum type )
  59 {
  60    (void) format;
  61    (void) type;
  62
  63    switch (internalFormat) {
  64       /* shallow RGBA formats */
  65       case 4:
  66       case GL_RGBA:
  67       case GL_RGBA8:
  68          return MESA_FORMAT_RGBA8888;
  69       case GL_RGB5_A1:
  70          return MESA_FORMAT_ARGB1555;
  71       case GL_RGBA2:
  72          return MESA_FORMAT_ARGB4444_REV; /* just to test another format*/
  73       case GL_RGBA4:
  74          return MESA_FORMAT_ARGB4444;
  75
  76       /* deep RGBA formats */
  77       case GL_RGB10_A2:
  78          return MESA_FORMAT_ARGB2101010;
  79
  80       case GL_RGBA12:
  81       case GL_RGBA16:
  82          return MESA_FORMAT_RGBA_16;
  83
  84       /* shallow RGB formats */
  85       case 3:
  86       case GL_RGB:
  87       case GL_RGB8:
  88          return MESA_FORMAT_RGB888;
  89       case GL_R3_G3_B2:
  90          return MESA_FORMAT_RGB332;
  91       case GL_RGB4:
  92          return MESA_FORMAT_RGB565_REV; /* just to test another format */
  93       case GL_RGB5:
  94          return MESA_FORMAT_RGB565;
  95
  96       /* deep RGB formats */
  97       case GL_RGB10:
  98       case GL_RGB12:
  99       case GL_RGB16:
 100          return MESA_FORMAT_RGBA_16;
 101
 102       /* Alpha formats */
 103       case GL_ALPHA:
 104       case GL_ALPHA4:
 105       case GL_ALPHA8:
 106          return MESA_FORMAT_A8;
 107
 108       case GL_ALPHA12:
 109       case GL_ALPHA16:
 110          return MESA_FORMAT_A16;
 111
 112       /* Luminance formats */
 113       case 1:
 114       case GL_LUMINANCE:
 115       case GL_LUMINANCE4:
 116       case GL_LUMINANCE8:
 117          return MESA_FORMAT_L8;
 118
 119       case GL_LUMINANCE12:
 120       case GL_LUMINANCE16:
 121          return MESA_FORMAT_L16;
 122
 123       /* Luminance/Alpha formats */
 124       case GL_LUMINANCE4_ALPHA4:
 125          return MESA_FORMAT_AL44;
 126
 127       case 2:
 128       case GL_LUMINANCE_ALPHA:
 129       case GL_LUMINANCE6_ALPHA2:
 130       case GL_LUMINANCE8_ALPHA8:
 131          return MESA_FORMAT_AL88;
 132
 133       case GL_LUMINANCE12_ALPHA4:
 134       case GL_LUMINANCE12_ALPHA12:
 135       case GL_LUMINANCE16_ALPHA16:
 136          return MESA_FORMAT_AL1616;
 137
 138       case GL_INTENSITY:
 139       case GL_INTENSITY4:
 140       case GL_INTENSITY12:
 141       case GL_INTENSITY16:
 142       case GL_INTENSITY8:
 143          return MESA_FORMAT_I8;
 144
 145       case GL_COLOR_INDEX:
 146       case GL_COLOR_INDEX1_EXT:
 147       case GL_COLOR_INDEX2_EXT:
 148       case GL_COLOR_INDEX4_EXT:
 149       case GL_COLOR_INDEX12_EXT:
 150       case GL_COLOR_INDEX16_EXT:
 151       case GL_COLOR_INDEX8_EXT:
 152          return MESA_FORMAT_CI8;
 153
 154       default:
 155          ; /* fallthrough */
 156    }
 157
 158    if (ctx->Extensions.ARB_depth_texture) {
 159       switch (internalFormat) {
 160          case GL_DEPTH_COMPONENT:
 161          case GL_DEPTH_COMPONENT24:
 162          case GL_DEPTH_COMPONENT32:
 163             return MESA_FORMAT_Z32;
 164          case GL_DEPTH_COMPONENT16:
 165             return MESA_FORMAT_Z16;
 166          default:
 167             ; /* fallthrough */
 168       }
 169    }
 170
 171    switch (internalFormat) {
 172       case GL_COMPRESSED_ALPHA_ARB:
 173          return MESA_FORMAT_A8;
 174       case GL_COMPRESSED_LUMINANCE_ARB:
 175          return MESA_FORMAT_L8;
 176       case GL_COMPRESSED_LUMINANCE_ALPHA_ARB:
 177          return MESA_FORMAT_AL88;
 178       case GL_COMPRESSED_INTENSITY_ARB:
 179          return MESA_FORMAT_I8;
 180       case GL_COMPRESSED_RGB_ARB:
 181          if (ctx->Extensions.EXT_texture_compression_s3tc ||
 182              ctx->Extensions.S3_s3tc)
 183             return MESA_FORMAT_RGB_DXT1;
 184          if (ctx->Extensions.TDFX_texture_compression_FXT1)
 185             return MESA_FORMAT_RGB_FXT1;
 186          return MESA_FORMAT_RGB888;
 187       case GL_COMPRESSED_RGBA_ARB:
 188          if (ctx->Extensions.EXT_texture_compression_s3tc ||
 189              ctx->Extensions.S3_s3tc)
 190             return MESA_FORMAT_RGBA_DXT3; /* Not rgba_dxt1, see spec */
 191          if (ctx->Extensions.TDFX_texture_compression_FXT1)
 192             return MESA_FORMAT_RGBA_FXT1;
 193          return MESA_FORMAT_RGBA8888;
 194       default:
 195          ; /* fallthrough */
 196    }
 197
 198    if (ctx->Extensions.MESA_ycbcr_texture) {
 199       if (internalFormat == GL_YCBCR_MESA) {
 200          if (type == GL_UNSIGNED_SHORT_8_8_MESA)
 201             return MESA_FORMAT_YCBCR;
 202          else
 203             return MESA_FORMAT_YCBCR_REV;
 204       }
 205    }
 206
 207 #if FEATURE_texture_fxt1
 208    if (ctx->Extensions.TDFX_texture_compression_FXT1) {
 209       switch (internalFormat) {
 210          case GL_COMPRESSED_RGB_FXT1_3DFX:
 211             return MESA_FORMAT_RGB_FXT1;
 212          case GL_COMPRESSED_RGBA_FXT1_3DFX:
 213             return MESA_FORMAT_RGBA_FXT1;
 214          default:
 215             ; /* fallthrough */
 216       }
 217    }
 218 #endif
 219
 220 #if FEATURE_texture_s3tc
 221    if (ctx->Extensions.EXT_texture_compression_s3tc) {
 222       switch (internalFormat) {
 223          case GL_COMPRESSED_RGB_S3TC_DXT1_EXT:
 224             return MESA_FORMAT_RGB_DXT1;
 225          case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT:
 226             return MESA_FORMAT_RGBA_DXT1;
 227          case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT:
 228             return MESA_FORMAT_RGBA_DXT3;
 229          case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT:
 230             return MESA_FORMAT_RGBA_DXT5;
 231          default:
 232             ; /* fallthrough */
 233       }
 234    }
 235
 236    if (ctx->Extensions.S3_s3tc) {
 237       switch (internalFormat) {
 238          case GL_RGB_S3TC:
 239          case GL_RGB4_S3TC:
 240             return MESA_FORMAT_RGB_DXT1;
 241          case GL_RGBA_S3TC:
 242          case GL_RGBA4_S3TC:
 243             return MESA_FORMAT_RGBA_DXT3;
 244          default:
 245             ; /* fallthrough */
 246       }
 247    }
 248 #endif
 249
 250    if (ctx->Extensions.ARB_texture_float) {
 251       switch (internalFormat) {
 252          case GL_ALPHA16F_ARB:
 253             return MESA_FORMAT_ALPHA_FLOAT16;
 254          case GL_ALPHA32F_ARB:
 255             return MESA_FORMAT_ALPHA_FLOAT32;
 256          case GL_LUMINANCE16F_ARB:
 257             return MESA_FORMAT_LUMINANCE_FLOAT16;
 258          case GL_LUMINANCE32F_ARB:
 259             return MESA_FORMAT_LUMINANCE_FLOAT32;
 260          case GL_LUMINANCE_ALPHA16F_ARB:
 261             return MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16;
 262          case GL_LUMINANCE_ALPHA32F_ARB:
 263             return MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32;
 264          case GL_INTENSITY16F_ARB:
 265             return MESA_FORMAT_INTENSITY_FLOAT16;
 266          case GL_INTENSITY32F_ARB:
 267             return MESA_FORMAT_INTENSITY_FLOAT32;
 268          case GL_RGB16F_ARB:
 269             return MESA_FORMAT_RGB_FLOAT16;
 270          case GL_RGB32F_ARB:
 271             return MESA_FORMAT_RGB_FLOAT32;
 272          case GL_RGBA16F_ARB:
 273             return MESA_FORMAT_RGBA_FLOAT16;
 274          case GL_RGBA32F_ARB:
 275             return MESA_FORMAT_RGBA_FLOAT32;
 276          default:
 277             ; /* fallthrough */
 278       }
 279    }
 280
 281    if (ctx->Extensions.EXT_packed_depth_stencil) {
 282       switch (internalFormat) {
 283          case GL_DEPTH_STENCIL_EXT:
 284          case GL_DEPTH24_STENCIL8_EXT:
 285             return MESA_FORMAT_Z24_S8;
 286          default:
 287             ; /* fallthrough */
 288       }
 289    }
 290
 291    if (ctx->Extensions.ATI_envmap_bumpmap) {
 292       switch (internalFormat) {
 293          case GL_DUDV_ATI:
 294          case GL_DU8DV8_ATI:
 295             return MESA_FORMAT_DUDV8;
 296          default:
 297             ; /* fallthrough */
 298       }
 299    }
 300
 301    if (ctx->Extensions.MESA_texture_signed_rgba) {
 302       switch (internalFormat) {
 303          case GL_RGBA_SNORM:
 304          case GL_RGBA8_SNORM:
 305             return MESA_FORMAT_SIGNED_RGBA8888;
 306          default:
 307             ; /* fallthrough */
 308       }
 309    }
 310
 311    if (ctx->VersionMajor * 10 + ctx->VersionMinor >= 31) {
 312       switch (internalFormat) {
 313          case GL_RED_SNORM:
 314          case GL_R8_SNORM:
 315             return MESA_FORMAT_SIGNED_R8;
 316          case GL_RG_SNORM:
 317          case GL_RG8_SNORM:
 318             return MESA_FORMAT_SIGNED_RG88;
 319          case GL_RGB_SNORM:
 320          case GL_RGB8_SNORM:
 321             return MESA_FORMAT_SIGNED_RGBX8888;
 322          case GL_RGBA_SNORM:
 323          case GL_RGBA8_SNORM:
 324             return MESA_FORMAT_SIGNED_RGBA8888;
 325          case GL_R16_SNORM:
 326             return MESA_FORMAT_SIGNED_R_16;
 327          case GL_RG16_SNORM:
 328             return MESA_FORMAT_SIGNED_RG_16;
 329          case GL_RGB16_SNORM:
 330             return MESA_FORMAT_SIGNED_RGB_16;
 331          case GL_RGBA16_SNORM:
 332             return MESA_FORMAT_SIGNED_RGBA_16;
 333          default:
 334             ; /* fall-through */
 335       }
 336    }
 337
 338 #if FEATURE_EXT_texture_sRGB
 339    if (ctx->Extensions.EXT_texture_sRGB) {
 340       switch (internalFormat) {
 341          case GL_SRGB_EXT:
 342          case GL_SRGB8_EXT:
 343             return MESA_FORMAT_SRGB8;
 344          case GL_SRGB_ALPHA_EXT:
 345          case GL_SRGB8_ALPHA8_EXT:
 346             return MESA_FORMAT_SRGBA8;
 347          case GL_SLUMINANCE_EXT:
 348          case GL_SLUMINANCE8_EXT:
 349             return MESA_FORMAT_SL8;
 350          case GL_SLUMINANCE_ALPHA_EXT:
 351          case GL_SLUMINANCE8_ALPHA8_EXT:
 352             return MESA_FORMAT_SLA8;
 353          case GL_COMPRESSED_SLUMINANCE_EXT:
 354             return MESA_FORMAT_SL8;
 355          case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT:
 356             return MESA_FORMAT_SLA8;
 357          case GL_COMPRESSED_SRGB_EXT:
 358 #if FEATURE_texture_s3tc
 359             if (ctx->Extensions.EXT_texture_compression_s3tc)
 360                return MESA_FORMAT_SRGB_DXT1;
 361 #endif
 362             return MESA_FORMAT_SRGB8;
 363          case GL_COMPRESSED_SRGB_ALPHA_EXT:
 364 #if FEATURE_texture_s3tc
 365             if (ctx->Extensions.EXT_texture_compression_s3tc)
 366                return MESA_FORMAT_SRGBA_DXT3; /* Not srgba_dxt1, see spec */
 367 #endif
 368             return MESA_FORMAT_SRGBA8;
 369 #if FEATURE_texture_s3tc
 370          case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT:
 371             if (ctx->Extensions.EXT_texture_compression_s3tc)
 372                return MESA_FORMAT_SRGB_DXT1;
 373             break;
 374          case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:
 375             if (ctx->Extensions.EXT_texture_compression_s3tc)
 376                return MESA_FORMAT_SRGBA_DXT1;
 377             break;
 378          case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:
 379             if (ctx->Extensions.EXT_texture_compression_s3tc)
 380                return MESA_FORMAT_SRGBA_DXT3;
 381             break;
 382          case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:
 383             if (ctx->Extensions.EXT_texture_compression_s3tc)
 384                return MESA_FORMAT_SRGBA_DXT5;
 385             break;
 386 #endif
 387          default:
 388             ; /* fallthrough */
 389       }
 390    }
 391 #endif /* FEATURE_EXT_texture_sRGB */
 392
 393    if (ctx->Extensions.EXT_texture_integer) {
 394       switch (internalFormat) {
 395       case GL_RGBA32UI_EXT:
 396       case GL_RGB32UI_EXT:
 397       case GL_ALPHA32UI_EXT:
 398       case GL_INTENSITY32UI_EXT:
 399       case GL_LUMINANCE32UI_EXT:
 400       case GL_LUMINANCE_ALPHA32UI_EXT:
 401          return MESA_FORMAT_RGBA_UINT32;
 402       case GL_RGBA16UI_EXT:
 403       case GL_RGB16UI_EXT:
 404       case GL_ALPHA16UI_EXT:
 405       case GL_INTENSITY16UI_EXT:
 406       case GL_LUMINANCE16UI_EXT:
 407       case GL_LUMINANCE_ALPHA16UI_EXT:
 408          return MESA_FORMAT_RGBA_UINT16;
 409       case GL_RGBA8UI_EXT:
 410       case GL_RGB8UI_EXT:
 411       case GL_ALPHA8UI_EXT:
 412       case GL_INTENSITY8UI_EXT:
 413       case GL_LUMINANCE8UI_EXT:
 414       case GL_LUMINANCE_ALPHA8UI_EXT:
 415          return MESA_FORMAT_RGBA_UINT8;
 416       case GL_RGBA32I_EXT:
 417       case GL_RGB32I_EXT:
 418       case GL_ALPHA32I_EXT:
 419       case GL_INTENSITY32I_EXT:
 420       case GL_LUMINANCE32I_EXT:
 421       case GL_LUMINANCE_ALPHA32I_EXT:
 422          return MESA_FORMAT_RGBA_INT32;
 423       case GL_RGBA16I_EXT:
 424       case GL_RGB16I_EXT:
 425       case GL_ALPHA16I_EXT:
 426       case GL_INTENSITY16I_EXT:
 427       case GL_LUMINANCE16I_EXT:
 428       case GL_LUMINANCE_ALPHA16I_EXT:
 429          return MESA_FORMAT_RGBA_INT16;
 430       case GL_RGBA8I_EXT:
 431       case GL_RGB8I_EXT:
 432       case GL_ALPHA8I_EXT:
 433       case GL_INTENSITY8I_EXT:
 434       case GL_LUMINANCE8I_EXT:
 435       case GL_LUMINANCE_ALPHA8I_EXT:
 436          return MESA_FORMAT_RGBA_INT8;
 437       }
 438    }
 439
 440    if (ctx->Extensions.ARB_texture_rg) {
 441       switch (internalFormat) {
 442       case GL_R8:
 443       case GL_RED:
 444       case GL_COMPRESSED_RED:
 445          return MESA_FORMAT_R8;
 446
 447       case GL_R16:
 448          return MESA_FORMAT_R16;
 449
 450       case GL_RG:
 451       case GL_RG8:
 452       case GL_COMPRESSED_RG:
 453          return MESA_FORMAT_RG88;
 454
 455       case GL_RG16:
 456          return MESA_FORMAT_RG1616;
 457
 458       default:
 459          ; /* fallthrough */
 460       }
 461    }
 462
 463    _mesa_problem(ctx, "unexpected format in _mesa_choose_tex_format()");
 464    return MESA_FORMAT_NONE;
 465 }
 466