reactos/lib/mesa32/src/main/texformat.h

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  6.1
   4  *
   5  * Copyright (C) 1999-2004  Brian Paul   All Rights Reserved.
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this software and associated documentation files (the "Software"),
   9  * to deal in the Software without restriction, including without limitation
  10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  11  * and/or sell copies of the Software, and to permit persons to whom the
  12  * Software is furnished to do so, subject to the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be included
  15  * in all copies or substantial portions of the Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  21  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25
  26 /**
  27  * \file texformat.h
  28  * Texture formats definitions.
  29  *
  30  * \author Gareth Hughes
  31  */
  32
  33
  34 #ifndef TEXFORMAT_H
  35 #define TEXFORMAT_H
  36
  37
  38 #include "mtypes.h"
  39
  40
  41 /**
  42  * Mesa internal texture image formats.
  43  * All texture images are stored in one of these formats.
  44  *
  45  * NOTE: when you add a new format, be sure to update the do_row()
  46  * function in texstore.c used for auto mipmap generation.
  47  */
  48 enum _format {
  49    /**
  50     * \name Hardware-friendly formats.
  51     *
  52     * Drivers can override the default formats and convert texture images to
  53     * one of these as required.  The driver's
  54     * dd_function_table::ChooseTextureFormat function will choose one of these
  55     * formats.
  56     *
  57     * \note In the default case, some of these formats will be duplicates of
  58     * the generic formats listed below.  However, these formats guarantee their
  59     * internal component sizes, while GLchan may vary between GLubyte, GLushort
  60     * and GLfloat.
  61     */
  62    /*@{*/
  63                                 /* msb <------ TEXEL BITS -----------> lsb */
  64                                 /* ---- ---- ---- ---- ---- ---- ---- ---- */
  65    MESA_FORMAT_RGBA8888,        /* RRRR RRRR GGGG GGGG BBBB BBBB AAAA AAAA */
  66    MESA_FORMAT_RGBA8888_REV,    /* AAAA AAAA BBBB BBBB GGGG GGGG RRRR RRRR */
  67    MESA_FORMAT_ARGB8888,        /* AAAA AAAA RRRR RRRR GGGG GGGG BBBB BBBB */
  68    MESA_FORMAT_ARGB8888_REV,    /* BBBB BBBB GGGG GGGG RRRR RRRR AAAA AAAA */
  69    MESA_FORMAT_RGB888,          /*           RRRR RRRR GGGG GGGG BBBB BBBB */
  70    MESA_FORMAT_BGR888,          /*           BBBB BBBB GGGG GGGG RRRR RRRR */
  71    MESA_FORMAT_RGB565,          /*                     RRRR RGGG GGGB BBBB */
  72    MESA_FORMAT_RGB565_REV,      /*                     GGGB BBBB RRRR RGGG */
  73    MESA_FORMAT_ARGB4444,        /*                     AAAA RRRR GGGG BBBB */
  74    MESA_FORMAT_ARGB4444_REV,    /*                     GGGG BBBB AAAA RRRR */
  75    MESA_FORMAT_ARGB1555,        /*                     ARRR RRGG GGGB BBBB */
  76    MESA_FORMAT_ARGB1555_REV,    /*                     GGGB BBBB ARRR RRGG */
  77    MESA_FORMAT_AL88,            /*                     AAAA AAAA LLLL LLLL */
  78    MESA_FORMAT_AL88_REV,        /*                     LLLL LLLL AAAA AAAA */
  79    MESA_FORMAT_RGB332,          /*                               RRRG GGBB */
  80    MESA_FORMAT_A8,              /*                               AAAA AAAA */
  81    MESA_FORMAT_L8,              /*                               LLLL LLLL */
  82    MESA_FORMAT_I8,              /*                               IIII IIII */
  83    MESA_FORMAT_CI8,             /*                               CCCC CCCC */
  84    MESA_FORMAT_YCBCR,           /*                     YYYY YYYY UorV UorV */
  85    MESA_FORMAT_YCBCR_REV,       /*                     UorV UorV YYYY YYYY */
  86    /*@}*/
  87
  88    /**
  89     * \name Compressed texture formats.
  90     */
  91    /*@{*/
  92    MESA_FORMAT_RGB_FXT1,
  93    MESA_FORMAT_RGBA_FXT1,
  94    MESA_FORMAT_RGB_DXT1,
  95    MESA_FORMAT_RGBA_DXT1,
  96    MESA_FORMAT_RGBA_DXT3,
  97    MESA_FORMAT_RGBA_DXT5,
  98    /*@}*/
  99
 100    /**
 101     * \name Generic GLchan-based formats.
 102     *
 103     * Software-oriented texture formats.  Texels are arrays of GLchan
 104     * values so there are no byte order issues.
 105     *
 106     * \note Because these are based on the GLchan data type, one cannot assume
 107     * 8 bits per channel with these formats.  If you require GLubyte channels,
 108     * use one of the hardware formats above.
 109     */
 110    /*@{*/
 111    MESA_FORMAT_RGBA,
 112    MESA_FORMAT_RGB,
 113    MESA_FORMAT_ALPHA,
 114    MESA_FORMAT_LUMINANCE,
 115    MESA_FORMAT_LUMINANCE_ALPHA,
 116    MESA_FORMAT_INTENSITY,
 117    /*@}*/
 118
 119    /**
 120     * Depth textures
 121     */
 122    /*@{*/
 123    MESA_FORMAT_DEPTH_COMPONENT_FLOAT32,
 124    MESA_FORMAT_DEPTH_COMPONENT16,
 125    /*@}*/
 126
 127    /**
 128     * \name Floating point texture formats.
 129     */
 130    /*@{*/
 131    MESA_FORMAT_RGBA_FLOAT32,
 132    MESA_FORMAT_RGBA_FLOAT16,
 133    MESA_FORMAT_RGB_FLOAT32,
 134    MESA_FORMAT_RGB_FLOAT16,
 135    MESA_FORMAT_ALPHA_FLOAT32,
 136    MESA_FORMAT_ALPHA_FLOAT16,
 137    MESA_FORMAT_LUMINANCE_FLOAT32,
 138    MESA_FORMAT_LUMINANCE_FLOAT16,
 139    MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32,
 140    MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16,
 141    MESA_FORMAT_INTENSITY_FLOAT32,
 142    MESA_FORMAT_INTENSITY_FLOAT16
 143    /*@}*/
 144 };
 145
 146
 147 /** GLchan-valued formats */
 148 /*@{*/
 149 extern const struct gl_texture_format _mesa_texformat_rgba;
 150 extern const struct gl_texture_format _mesa_texformat_rgb;
 151 extern const struct gl_texture_format _mesa_texformat_alpha;
 152 extern const struct gl_texture_format _mesa_texformat_luminance;
 153 extern const struct gl_texture_format _mesa_texformat_luminance_alpha;
 154 extern const struct gl_texture_format _mesa_texformat_intensity;
 155 /*@}*/
 156
 157 /** Depth textures */
 158 /*@{*/
 159 extern const struct gl_texture_format _mesa_texformat_depth_component_float32;
 160 extern const struct gl_texture_format _mesa_texformat_depth_component16;
 161 /*@}*/
 162
 163 /** Floating point texture formats */
 164 /*@{*/
 165 extern const struct gl_texture_format _mesa_texformat_rgba_float32;
 166 extern const struct gl_texture_format _mesa_texformat_rgba_float16;
 167 extern const struct gl_texture_format _mesa_texformat_rgb_float32;
 168 extern const struct gl_texture_format _mesa_texformat_rgb_float16;
 169 extern const struct gl_texture_format _mesa_texformat_alpha_float32;
 170 extern const struct gl_texture_format _mesa_texformat_alpha_float16;
 171 extern const struct gl_texture_format _mesa_texformat_luminance_float32;
 172 extern const struct gl_texture_format _mesa_texformat_luminance_float16;
 173 extern const struct gl_texture_format _mesa_texformat_luminance_alpha_float32;
 174 extern const struct gl_texture_format _mesa_texformat_luminance_alpha_float16;
 175 extern const struct gl_texture_format _mesa_texformat_intensity_float32;
 176 extern const struct gl_texture_format _mesa_texformat_intensity_float16;
 177 /*@}*/
 178
 179 /** \name Assorted hardware-friendly formats */
 180 /*@{*/
 181 extern const struct gl_texture_format _mesa_texformat_rgba8888;
 182 extern const struct gl_texture_format _mesa_texformat_rgba8888_rev;
 183 extern const struct gl_texture_format _mesa_texformat_argb8888;
 184 extern const struct gl_texture_format _mesa_texformat_argb8888_rev;
 185 extern const struct gl_texture_format _mesa_texformat_rgb888;
 186 extern const struct gl_texture_format _mesa_texformat_bgr888;
 187 extern const struct gl_texture_format _mesa_texformat_rgb565;
 188 extern const struct gl_texture_format _mesa_texformat_rgb565_rev;
 189 extern const struct gl_texture_format _mesa_texformat_argb4444;
 190 extern const struct gl_texture_format _mesa_texformat_argb4444_rev;
 191 extern const struct gl_texture_format _mesa_texformat_argb1555;
 192 extern const struct gl_texture_format _mesa_texformat_argb1555_rev;
 193 extern const struct gl_texture_format _mesa_texformat_al88;
 194 extern const struct gl_texture_format _mesa_texformat_al88_rev;
 195 extern const struct gl_texture_format _mesa_texformat_rgb332;
 196 extern const struct gl_texture_format _mesa_texformat_a8;
 197 extern const struct gl_texture_format _mesa_texformat_l8;
 198 extern const struct gl_texture_format _mesa_texformat_i8;
 199 extern const struct gl_texture_format _mesa_texformat_ci8;
 200
 201 /*@}*/
 202
 203 /** \name YCbCr formats */
 204 /*@{*/
 205 extern const struct gl_texture_format _mesa_texformat_ycbcr;
 206 extern const struct gl_texture_format _mesa_texformat_ycbcr_rev;
 207 /*@}*/
 208
 209 /** \name Compressed formats */
 210 /*@{*/
 211 extern const struct gl_texture_format _mesa_texformat_rgb_fxt1;
 212 extern const struct gl_texture_format _mesa_texformat_rgba_fxt1;
 213 extern const struct gl_texture_format _mesa_texformat_rgb_dxt1;
 214 extern const struct gl_texture_format _mesa_texformat_rgba_dxt1;
 215 extern const struct gl_texture_format _mesa_texformat_rgba_dxt3;
 216 extern const struct gl_texture_format _mesa_texformat_rgba_dxt5;
 217 /*@}*/
 218
 219 /** \name The null format */
 220 /*@{*/
 221 extern const struct gl_texture_format _mesa_null_texformat;
 222 /*@}*/
 223
 224
 225 extern const struct gl_texture_format *
 226 _mesa_choose_tex_format( GLcontext *ctx, GLint internalFormat,
 227                          GLenum format, GLenum type );
 228
 229 #endif