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 "texcompress_fxt1.h"
  39 #include "texcompress_s3tc.h"
  40 #include "texformat.h"
  41
  42
  43 /**
  44  * Choose an appropriate texture format given the format, type and
  45  * internalFormat parameters passed to glTexImage().
  46  *
  47  * \param ctx  the GL context.
  48  * \param internalFormat  user's prefered internal texture format.
  49  * \param format  incoming image pixel format.
  50  * \param type  incoming image data type.
  51  *
  52  * \return a pointer to a gl_texture_format object which describes the
  53  * choosen texture format, or NULL on failure.
  54  *
  55  * This is called via dd_function_table::ChooseTextureFormat.  Hardware drivers
  56  * will typically override this function with a specialized version.
  57  */
  58 gl_format
  59 _mesa_choose_tex_format( GLcontext *ctx, GLint internalFormat,
  60                          GLenum format, GLenum type )
  61 {
  62    (void) format;
  63    (void) type;
  64
  65    switch (internalFormat) {
  66       /* RGBA formats */
  67       case 4:
  68       case GL_RGBA:
  69       case GL_RGB10_A2:
  70       case GL_RGBA12:
  71       case GL_RGBA16:
  72       case GL_RGBA8:
  73          return MESA_FORMAT_RGBA8888;
  74       case GL_RGB5_A1:
  75          return MESA_FORMAT_ARGB1555;
  76       case GL_RGBA2:
  77          return MESA_FORMAT_ARGB4444_REV; /* just to test another format*/
  78       case GL_RGBA4:
  79          return MESA_FORMAT_ARGB4444;
  80
  81       /* RGB formats */
  82       case 3:
  83       case GL_RGB:
  84       case GL_RGB10:
  85       case GL_RGB12:
  86       case GL_RGB16:
  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       /* Alpha formats */
  97       case GL_ALPHA:
  98       case GL_ALPHA4:
  99       case GL_ALPHA12:
 100       case GL_ALPHA16:
 101       case GL_ALPHA8:
 102          return MESA_FORMAT_A8;
 103
 104       /* Luminance formats */
 105       case 1:
 106       case GL_LUMINANCE:
 107       case GL_LUMINANCE4:
 108       case GL_LUMINANCE12:
 109       case GL_LUMINANCE16:
 110       case GL_LUMINANCE8:
 111          return MESA_FORMAT_L8;
 112
 113       /* Luminance/Alpha formats */
 114       case 2:
 115       case GL_LUMINANCE_ALPHA:
 116       case GL_LUMINANCE4_ALPHA4:
 117       case GL_LUMINANCE6_ALPHA2:
 118       case GL_LUMINANCE8_ALPHA8:
 119          return MESA_FORMAT_AL88;
 120
 121       case GL_LUMINANCE12_ALPHA4:
 122       case GL_LUMINANCE12_ALPHA12:
 123       case GL_LUMINANCE16_ALPHA16:
 124          return MESA_FORMAT_AL1616;
 125
 126       case GL_INTENSITY:
 127       case GL_INTENSITY4:
 128       case GL_INTENSITY12:
 129       case GL_INTENSITY16:
 130       case GL_INTENSITY8:
 131          return MESA_FORMAT_I8;
 132
 133       case GL_COLOR_INDEX:
 134       case GL_COLOR_INDEX1_EXT:
 135       case GL_COLOR_INDEX2_EXT:
 136       case GL_COLOR_INDEX4_EXT:
 137       case GL_COLOR_INDEX12_EXT:
 138       case GL_COLOR_INDEX16_EXT:
 139       case GL_COLOR_INDEX8_EXT:
 140          return MESA_FORMAT_CI8;
 141
 142       default:
 143          ; /* fallthrough */
 144    }
 145
 146    if (ctx->Extensions.ARB_depth_texture) {
 147       switch (internalFormat) {
 148          case GL_DEPTH_COMPONENT:
 149          case GL_DEPTH_COMPONENT24:
 150          case GL_DEPTH_COMPONENT32:
 151             return MESA_FORMAT_Z32;
 152          case GL_DEPTH_COMPONENT16:
 153             return MESA_FORMAT_Z16;
 154          default:
 155             ; /* fallthrough */
 156       }
 157    }
 158
 159    switch (internalFormat) {
 160       case GL_COMPRESSED_ALPHA_ARB:
 161          return MESA_FORMAT_A8;
 162       case GL_COMPRESSED_LUMINANCE_ARB:
 163          return MESA_FORMAT_L8;
 164       case GL_COMPRESSED_LUMINANCE_ALPHA_ARB:
 165          return MESA_FORMAT_AL88;
 166       case GL_COMPRESSED_INTENSITY_ARB:
 167          return MESA_FORMAT_I8;
 168       case GL_COMPRESSED_RGB_ARB:
 169          if (ctx->Extensions.EXT_texture_compression_s3tc ||
 170              ctx->Extensions.S3_s3tc)
 171             return MESA_FORMAT_RGB_DXT1;
 172          if (ctx->Extensions.TDFX_texture_compression_FXT1)
 173             return MESA_FORMAT_RGB_FXT1;
 174          return MESA_FORMAT_RGB888;
 175       case GL_COMPRESSED_RGBA_ARB:
 176          if (ctx->Extensions.EXT_texture_compression_s3tc ||
 177              ctx->Extensions.S3_s3tc)
 178             return MESA_FORMAT_RGBA_DXT3; /* Not rgba_dxt1, see spec */
 179          if (ctx->Extensions.TDFX_texture_compression_FXT1)
 180             return MESA_FORMAT_RGBA_FXT1;
 181          return MESA_FORMAT_RGBA8888;
 182       default:
 183          ; /* fallthrough */
 184    }
 185
 186    if (ctx->Extensions.MESA_ycbcr_texture) {
 187       if (internalFormat == GL_YCBCR_MESA) {
 188          if (type == GL_UNSIGNED_SHORT_8_8_MESA)
 189             return MESA_FORMAT_YCBCR;
 190          else
 191             return MESA_FORMAT_YCBCR_REV;
 192       }
 193    }
 194
 195 #if FEATURE_texture_fxt1
 196    if (ctx->Extensions.TDFX_texture_compression_FXT1) {
 197       switch (internalFormat) {
 198          case GL_COMPRESSED_RGB_FXT1_3DFX:
 199             return MESA_FORMAT_RGB_FXT1;
 200          case GL_COMPRESSED_RGBA_FXT1_3DFX:
 201             return MESA_FORMAT_RGBA_FXT1;
 202          default:
 203             ; /* fallthrough */
 204       }
 205    }
 206 #endif
 207
 208 #if FEATURE_texture_s3tc
 209    if (ctx->Extensions.EXT_texture_compression_s3tc) {
 210       switch (internalFormat) {
 211          case GL_COMPRESSED_RGB_S3TC_DXT1_EXT:
 212             return MESA_FORMAT_RGB_DXT1;
 213          case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT:
 214             return MESA_FORMAT_RGBA_DXT1;
 215          case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT:
 216             return MESA_FORMAT_RGBA_DXT3;
 217          case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT:
 218             return MESA_FORMAT_RGBA_DXT5;
 219          default:
 220             ; /* fallthrough */
 221       }
 222    }
 223
 224    if (ctx->Extensions.S3_s3tc) {
 225       switch (internalFormat) {
 226          case GL_RGB_S3TC:
 227          case GL_RGB4_S3TC:
 228             return MESA_FORMAT_RGB_DXT1;
 229          case GL_RGBA_S3TC:
 230          case GL_RGBA4_S3TC:
 231             return MESA_FORMAT_RGBA_DXT3;
 232          default:
 233             ; /* fallthrough */
 234       }
 235    }
 236 #endif
 237
 238    if (ctx->Extensions.ARB_texture_float) {
 239       switch (internalFormat) {
 240          case GL_ALPHA16F_ARB:
 241             return MESA_FORMAT_ALPHA_FLOAT16;
 242          case GL_ALPHA32F_ARB:
 243             return MESA_FORMAT_ALPHA_FLOAT32;
 244          case GL_LUMINANCE16F_ARB:
 245             return MESA_FORMAT_LUMINANCE_FLOAT16;
 246          case GL_LUMINANCE32F_ARB:
 247             return MESA_FORMAT_LUMINANCE_FLOAT32;
 248          case GL_LUMINANCE_ALPHA16F_ARB:
 249             return MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16;
 250          case GL_LUMINANCE_ALPHA32F_ARB:
 251             return MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32;
 252          case GL_INTENSITY16F_ARB:
 253             return MESA_FORMAT_INTENSITY_FLOAT16;
 254          case GL_INTENSITY32F_ARB:
 255             return MESA_FORMAT_INTENSITY_FLOAT32;
 256          case GL_RGB16F_ARB:
 257             return MESA_FORMAT_RGB_FLOAT16;
 258          case GL_RGB32F_ARB:
 259             return MESA_FORMAT_RGB_FLOAT32;
 260          case GL_RGBA16F_ARB:
 261             return MESA_FORMAT_RGBA_FLOAT16;
 262          case GL_RGBA32F_ARB:
 263             return MESA_FORMAT_RGBA_FLOAT32;
 264          default:
 265             ; /* fallthrough */
 266       }
 267    }
 268
 269    if (ctx->Extensions.EXT_packed_depth_stencil) {
 270       switch (internalFormat) {
 271          case GL_DEPTH_STENCIL_EXT:
 272          case GL_DEPTH24_STENCIL8_EXT:
 273             return MESA_FORMAT_Z24_S8;
 274          default:
 275             ; /* fallthrough */
 276       }
 277    }
 278
 279    if (ctx->Extensions.ATI_envmap_bumpmap) {
 280       switch (internalFormat) {
 281          case GL_DUDV_ATI:
 282          case GL_DU8DV8_ATI:
 283             return MESA_FORMAT_DUDV8;
 284          default:
 285             ; /* fallthrough */
 286       }
 287    }
 288
 289    if (ctx->Extensions.MESA_texture_signed_rgba) {
 290       switch (internalFormat) {
 291          case GL_RGBA_SNORM:
 292          case GL_RGBA8_SNORM:
 293             return MESA_FORMAT_SIGNED_RGBA8888;
 294          default:
 295             ; /* fallthrough */
 296       }
 297    }
 298
 299
 300 #if FEATURE_EXT_texture_sRGB
 301    if (ctx->Extensions.EXT_texture_sRGB) {
 302       switch (internalFormat) {
 303          case GL_SRGB_EXT:
 304          case GL_SRGB8_EXT:
 305             return MESA_FORMAT_SRGB8;
 306          case GL_SRGB_ALPHA_EXT:
 307          case GL_SRGB8_ALPHA8_EXT:
 308             return MESA_FORMAT_SRGBA8;
 309          case GL_SLUMINANCE_EXT:
 310          case GL_SLUMINANCE8_EXT:
 311             return MESA_FORMAT_SL8;
 312          case GL_SLUMINANCE_ALPHA_EXT:
 313          case GL_SLUMINANCE8_ALPHA8_EXT:
 314             return MESA_FORMAT_SLA8;
 315          case GL_COMPRESSED_SLUMINANCE_EXT:
 316             return MESA_FORMAT_SL8;
 317          case GL_COMPRESSED_SLUMINANCE_ALPHA_EXT:
 318             return MESA_FORMAT_SLA8;
 319          case GL_COMPRESSED_SRGB_EXT:
 320 #if FEATURE_texture_s3tc
 321             if (ctx->Extensions.EXT_texture_compression_s3tc)
 322                return MESA_FORMAT_SRGB_DXT1;
 323 #endif
 324             return MESA_FORMAT_SRGB8;
 325          case GL_COMPRESSED_SRGB_ALPHA_EXT:
 326 #if FEATURE_texture_s3tc
 327             if (ctx->Extensions.EXT_texture_compression_s3tc)
 328                return MESA_FORMAT_SRGBA_DXT3; /* Not srgba_dxt1, see spec */
 329 #endif
 330             return MESA_FORMAT_SRGBA8;
 331 #if FEATURE_texture_s3tc
 332          case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT:
 333             if (ctx->Extensions.EXT_texture_compression_s3tc)
 334                return MESA_FORMAT_SRGB_DXT1;
 335             break;
 336          case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT:
 337             if (ctx->Extensions.EXT_texture_compression_s3tc)
 338                return MESA_FORMAT_SRGBA_DXT1;
 339             break;
 340          case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT:
 341             if (ctx->Extensions.EXT_texture_compression_s3tc)
 342                return MESA_FORMAT_SRGBA_DXT3;
 343             break;
 344          case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT:
 345             if (ctx->Extensions.EXT_texture_compression_s3tc)
 346                return MESA_FORMAT_SRGBA_DXT5;
 347             break;
 348 #endif
 349          default:
 350             ; /* fallthrough */
 351       }
 352    }
 353 #endif /* FEATURE_EXT_texture_sRGB */
 354
 355    _mesa_problem(ctx, "unexpected format in _mesa_choose_tex_format()");
 356    return MESA_FORMAT_NONE;
 357 }
 358