path: root/src/mesa/main/formats.h

/*
 * Mesa 3-D graphics library
 *
 * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
 * Copyright (c) 2008-2009  VMware, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included
 * in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 * OTHER DEALINGS IN THE SOFTWARE.
 */

/*
 * Authors:
 *   Brian Paul
 */


#ifndef FORMATS_H
#define FORMATS_H


#include <GL/gl.h>


#ifdef __cplusplus
extern "C" {
#endif


/**
 * OpenGL doesn't have GL_UNSIGNED_BYTE_4_4, so we must define our own type
 * for GL_LUMINANCE4_ALPHA4.
 */
#define MESA_UNSIGNED_BYTE_4_4 (GL_UNSIGNED_BYTE<<1)


/**
 * Max number of bytes for any non-compressed pixel format below, or for
 * intermediate pixel storage in Mesa.  This should never be less than
 * 16.  Maybe 32 someday?
 */
#define MAX_PIXEL_BYTES 16


/**
 * Mesa texture/renderbuffer image formats.
 */
typedef enum
{
   MESA_FORMAT_NONE = 0,

   /**
    * \name Basic hardware formats
    *
    * The mesa format name specification is as follows:
    *
    *  There shall be 3 naming format base types: those for component array
    *  formats (type A); those for compressed formats (type C); and those for
    *  packed component formats (type P). With type A formats, color component
    *  order does not change with endianess. Each format name shall begin with
    *  MESA_FORMAT_, followed by a component label (from the Component Label
    *  list below) for each component in the order that the component(s) occur
    *  in the format, except for non-linear color formats where the first
    *  letter shall be 'S'. For type P formats, each component label is
    *  followed by the number of bits that represent it in the fundamental
    *  data type used by the format.
    *
    *  Following the listing of the component labels shall be an underscore; a
    *  compression type followed by an underscore for Type C formats only; a
    *  storage type from the list below; and a bit with for type A formats,
    *  which is the bit width for each array element.
    *
    *
    *  ----------    Format Base Type A: Array ----------
    *  MESA_FORMAT_[component list]_[storage type][array element bit width]
    *
    *  examples:
    *  MESA_FORMAT_A_SNORM8     - uchar[i] = A
    *  MESA_FORMAT_RGBA_16 - ushort[i * 4 + 0] = R, ushort[i * 4 + 1] = G,
    *                             ushort[i * 4 + 2] = B, ushort[i * 4 + 3] = A
    *  MESA_FORMAT_Z_UNORM32    - float[i] = Z
    *
    *
    *
    *  ----------    Format Base Type C: Compressed ----------
    *  MESA_FORMAT_[component list*][_*][compression type][storage type*]
    *  * where required
    *
    *  examples:
    *  MESA_FORMAT_RGB_ETC1
    *  MESA_FORMAT_RGBA_ETC2
    *  MESA_FORMAT_LATC1_UNORM
    *  MESA_FORMAT_RGBA_FXT1
    *
    *
    *
    *  ----------    Format Base Type P: Packed  ----------
    *  MESA_FORMAT_[[component list,bit width][storage type*][_]][_][storage type**]
    *   * when type differs between component
    *   ** when type applies to all components
    *
    *  examples:                   msb <------ TEXEL BITS -----------> lsb
    *  MESA_FORMAT_A8B8G8R8_UNORM, AAAA AAAA BBBB BBBB GGGG GGGG RRRR RRRR
    *  MESA_FORMAT_R5G6B5_UNORM                        RRRR RGGG GGGB BBBB
    *  MESA_FORMAT_B4G4R4X4_UNORM                      BBBB GGGG RRRR XXXX
    *  MESA_FORMAT_Z32_FLOAT_S8X24_UINT
    *  MESA_FORMAT_R10G10B10A2_UINT
    *  MESA_FORMAT_R9G9B9E5_FLOAT
    *
    *
    *
    *  ----------    Component Labels: ----------
    *  A - Alpha
    *  B - Blue
    *  DU - Delta U
    *  DV - Delta V
    *  E - Shared Exponent
    *  G - Green
    *  I - Intensity
    *  L - Luminance
    *  R - Red
    *  S - Stencil (when not followed by RGB or RGBA)
    *  U - Chrominance
    *  V - Chrominance
    *  Y - Luma
    *  X - Packing bits
    *  Z - Depth
    *
    *
    *
    *  ----------    Type C Compression Types: ----------
    *  DXT1 - Color component labels shall be given
    *  DXT3 - Color component labels shall be given
    *  DXT5 - Color component labels shall be given
    *  ETC1 - No other information required
    *  ETC2 - No other information required
    *  FXT1 - Color component labels shall be given
    *  FXT3 - Color component labels shall be given
    *  LATC1 - Fundamental data type shall be given
    *  LATC2 - Fundamental data type shall be given
    *  RGTC1 - Color component labels and data type shall be given
    *  RGTC2 - Color component labels and data type shall be given
    *
    *
    *
    *  ----------    Storage Types: ----------
    *  FLOAT
    *  SINT
    *  UINT
    *  SNORM
    *  UNORM
    *  SRGB - RGB components, or L are UNORMs in sRGB color space.
    *         Alpha, if present is linear.
    *
    *
    *   ----------   Type A Format List (based on format_unpack.c):
    *  BGR_UNORM8
    *  RGB_UNORM8
    *  A_UNORM8
    *  A_UNORM16
    *  L_UNORM8
    *  L_UNORM16
    *  I_UNORM8
    *  I_UNOMR16
    *  R_UNORM8
    *  R_UNORM16
    *  Z_UNORM16
    *  Z_UNORM32
    *  Z_FLOAT32
    *  S_UINT8
    *  BGR_SRGB8
    *  L_SRGB8
    *  RGBA_FLOAT32
    *  RGBA_FLOAT16
    *  RGB_FLOAT32
    *  RGB_FLOAT16
    *  A_FLOAT32
    *  A_FLOAT16
    *  L_FLOAT32
    *  L_FLOAT16
    *  LA_FLOAT32
    *  LA_FLOAT16
    *  I_FLOAT32
    *  I_FLOAT16
    *  R_FLOAT32
    *  R_FLOAT16
    *  RG_FLOAT32
    *  RG_FLOAT16
    *  A_UINT8
    *  A_UINT16
    *  A_UINT32
    *  A_SINT8
    *  A_SINT16
    *  A_SINT32
    *  I_UINT8
    *  I_UINT16
    *  I_UINT32
    *  I_SINT8
    *  I_SINT16
    *  I_SINT32
    *  L_UINT8
    *  L_UINT16
    *  L_UINT32
    *  L_SINT8
    *  L_SINT16
    *  L_SINT32
    *  LA_UINT8
    *  LA_UINT16
    *  LA_UINT32
    *  LA_SINT8
    *  LA_SINT16
    *  LA_SINT32
    *  R_SINT8
    *  RG_SINT8
    *  RGB_SINT8
    *  RGBA_SINT8
    *  R_SINT16
    *  RG_SINT16
    *  RGB_SINT16
    *  RGBA_SINT16
    *  R_SINT32
    *  RG_SINT32
    *  RGB_SINT32
    *  RGBA_SINT32
    *  R_SINT16
    *  R_SINT32
    *  R_UINT8
    *  RG_UINT8
    *  RGB_UINT8
    *  RGBA_UINT8
    *  R_UINT16
    *  RG_UINT16
    *  RGB_UINT16
    *  RGBA_UINT16
    *  R_UINT32
    *  RG_UINT32
    *  RGB_UINT32
    *  RGBA_UINT32
    *  R_UINT16
    *  R_UINT32
    *  R_SNORM8
    *  R_SNORM16
    *  RGB_SNORM16
    *  RGBA_SNORM16
    *  RGBA_UNORM16
    *  A_SNORM8
    *  L_SNORM8
    *  I_SNORM8
    *  A_SNORM16
    *  L_SNORM16
    *  LA_SNORM16
    *  I_SNORM16
    *  RGBX_UINT8
    *  RGBX_SINT8
    *  RGBX_UNORM16
    *  RGBX_SNORM16
    *  RGBX_FLOAT16
    *  RGBX_UINT16
    *  RGBX_SINT16
    *  RGBX_FLOAT32
    *  RGBX_UINT32
    *  RGBX_SINT32
    *
    *
    *
    *   ----------   Type P Format List (based on format_unpack.c):
    *  A8B8G8R8_UNORM
    *  R8G8B8A8_UNORM
    *  B8G8R8A8_UNORM
    *  A8R8G8B8_UNORM
    *  X8B8G8R8_UNORM
    *  R8G8B8X8_UNORM
    *  B8G8R8X8_UNORM
    *  X8R8G8B8_UNORM
    *  B5G6R5_UNORM
    *  R5G6B5_UNORM
    *  B4G4R4A4_UNORM
    *  A4R4G4B4_UNORM
    *  A1B5G5R5_UNORM
    *  B5G5R5A1_UNORM
    *  A1R5G5B5_UNORM
    *  L4A4_UNORM
    *  L8A8_UNORM
    *  A8L8_UNORM
    *  L16A16_UNORM
    *  A16L16_UNORM
    *  B2G3R3_UNORM
    *  YCBCR
    *  YCBCR_REV
    *  R8G8_UNORM
    *  G8R8_UNORM
    *  R16G16_UNORM
    *  G16R16_UNORM
    *  B10G10R10A2_UNORM
    *  B10G10R10A2_UINT
    *  R10G10B10A2_UINT
    *  S8_UINT_Z24_UNORM
    *  Z24_UNORM_S8_UINT
    *  Z24_UNORM_X8_UINT
    *  X8_UINT_Z24_UNORM
    *  Z32_FLOAT_S8X24_UINT
    *  A8R8G8B8_SRGB
    *  B8G8R8A8_SRGB
    *  L8A8_SRGB
    *  R8G8_SNORM
    *  X8B8G8R8_SNORM
    *  A8B8G8R8_SNORM
    *  R8G8B8A8_SNORM
    *  R16G16_SNORM
    *  L8A8_SNORM
    *  R9G9B9E5_FLOAT
    *  R11G11B10_FLOAT
    *  B4G4R4X4_UNORM
    *  B5G5R5X1_UNORM
    *  R8G8_SNORM
    *  R8G8B8X8_SNORM
    *  R8G8B8X8_SRGB
    *  B10G10R10X2_UNORM
    *  R10G10B10A2_UNORM
    *  G8R8_SINT
    *  G16R16_SINT
    *  B8G8R8X8_SRGB
    *
    */
   /*@{*/

   /* Type P formats */          /* msb <------ TEXEL BITS -----------> lsb */
                                 /* ---- ---- ---- ---- ---- ---- ---- ---- */
   MESA_FORMAT_A8B8G8R8_UNORM,   /* RRRR RRRR GGGG GGGG BBBB BBBB AAAA AAAA */
   MESA_FORMAT_R8G8B8A8_UNORM,   /* AAAA AAAA BBBB BBBB GGGG GGGG RRRR RRRR */
   MESA_FORMAT_B8G8R8A8_UNORM,   /* AAAA AAAA RRRR RRRR GGGG GGGG BBBB BBBB */
   MESA_FORMAT_A8R8G8B8_UNORM,   /* BBBB BBBB GGGG GGGG RRRR RRRR AAAA AAAA */
   MESA_FORMAT_X8B8G8R8_UNORM,   /* RRRR RRRR GGGG GGGG BBBB BBBB xxxx xxxx */
   MESA_FORMAT_R8G8B8X8_UNORM,   /* xxxx xxxx BBBB BBBB GGGG GGGG RRRR RRRR */
   MESA_FORMAT_B8G8R8X8_UNORM,   /* xxxx xxxx RRRR RRRR GGGG GGGG BBBB BBBB */
   MESA_FORMAT_X8R8G8B8_UNORM,   /* BBBB BBBB GGGG GGGG RRRR RRRR xxxx xxxx */

   /* Type A formats */
   MESA_FORMAT_BGR_UNORM8,    /* uchar[i * 3] = B, [i * 3 + 1] = G, [i *3 + 2] = R */
   MESA_FORMAT_RGB_UNORM8,    /* uchar[i * 3] = R, [i * 3 + 1] = G, [i *3 + 2] = B */

   /* Type P formats */
   MESA_FORMAT_B5G6R5_UNORM,                         /* RRRR RGGG GGGB BBBB */
   MESA_FORMAT_R5G6B5_UNORM,                         /* BBBB BGGG GGGR RRRR */
   MESA_FORMAT_B4G4R4A4_UNORM,                       /* AAAA RRRR GGGG BBBB */
   MESA_FORMAT_A4R4G4B4_UNORM,                       /* BBBB GGGG RRRR AAAA */
   MESA_FORMAT_A1B5G5R5_UNORM,                       /* RRRR RGGG GGBB BBBA */
   MESA_FORMAT_B5G5R5A1_UNORM,                       /* ARRR RRGG GGGB BBBB */
   MESA_FORMAT_A1R5G5B5_UNORM,                       /* BBBB BGGG GGRR RRRA */
   MESA_FORMAT_L4A4_UNORM,                                     /* AAAA LLLL */
   MESA_FORMAT_L8A8_UNORM,                           /* AAAA AAAA LLLL LLLL */
   MESA_FORMAT_A8L8_UNORM,                           /* LLLL LLLL AAAA AAAA */
   MESA_FORMAT_L16A16_UNORM,     /* AAAA AAAA AAAA AAAA LLLL LLLL LLLL LLLL */
   MESA_FORMAT_A16L16_UNORM,     /* LLLL LLLL LLLL LLLL AAAA AAAA AAAA AAAA */
   MESA_FORMAT_B2G3R3_UNORM,                                   /* RRRG GGBB */

   /* Type A formats */
   MESA_FORMAT_A_UNORM8,     /* uchar[i] = A */
   MESA_FORMAT_A_UNORM16,    /* ushort[i] = A */
   MESA_FORMAT_L_UNORM8,     /* uchar[i] = L */
   MESA_FORMAT_L_UNORM16,    /* ushort[i] = L */
   MESA_FORMAT_I_UNORM8,     /* uchar[i] = I */
   MESA_FORMAT_I_UNORM16,    /* ushort[i] = I */

   /* Type P formats */
   MESA_FORMAT_YCBCR,         /*                     YYYY YYYY UorV UorV */
   MESA_FORMAT_YCBCR_REV,     /*                     UorV UorV YYYY YYYY */

   /* Type A format(s) */
   MESA_FORMAT_R_UNORM8,      /* uchar[i] = R */

   /* Type P formats */
   MESA_FORMAT_R8G8_UNORM,                           /* GGGG GGGG RRRR RRRR */
   MESA_FORMAT_G8R8_UNORM,                           /* RRRR RRRR GGGG GGGG */

   /* Type A format(s) */
   MESA_FORMAT_R_UNORM16,     /* ushort[i] = R */

   /* Type P formats */
   MESA_FORMAT_R16G16_UNORM,     /* GGGG GGGG GGGG GGGG RRRR RRRR RRRR RRRR */
   MESA_FORMAT_G16R16_UNORM,     /* RRRR RRRR RRRR RRRR GGGG GGGG GGGG GGGG */
   MESA_FORMAT_B10G10R10A2_UNORM,/* AARR RRRR RRRR GGGG GGGG GGBB BBBB BBBB */
   MESA_FORMAT_S8_UINT_Z24_UNORM,/* ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ SSSS SSSS */
   MESA_FORMAT_Z24_UNORM_S8_UINT,/* SSSS SSSS ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ */

   /* Type A format(s) */
   MESA_FORMAT_Z_UNORM16,     /* ushort[i] = Z */

   /* Type P formats */
   MESA_FORMAT_Z24_UNORM_X8_UINT,/* xxxx xxxx ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ */
   MESA_FORMAT_X8Z24_UNORM,      /* ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ xxxx xxxx */

   /* Type A formats */
   MESA_FORMAT_Z_UNORM32,     /* uint[i] = Z */
   MESA_FORMAT_S_UINT8,       /* uchar[i] = S */
   /*@}*/

   /**
    * \name 8-bit/channel sRGB formats
    */
   /*@{*/
   /* Type A format(s) */
   MESA_FORMAT_BGR_SRGB8,     /* uchar[i * 3] = B, [i * 3 + 1] = G, [i *3 + 2] = R */

   /* Type P formats */
   MESA_FORMAT_A8B8G8R8_SRGB,    /* RRRR RRRR GGGG GGGG BBBB BBBB AAAA AAAA */
   MESA_FORMAT_B8G8R8A8_SRGB,    /* AAAA AAAA RRRR RRRR GGGG GGGG BBBB BBBB */

   /* Type A format(s) */
   MESA_FORMAT_L_SRGB8,       /* uchar[i] = L */

   /* Type P formats */
   MESA_FORMAT_L8A8_SRGB,                            /* AAAA AAAA LLLL LLLL */

   /* Type C formats */
   MESA_FORMAT_SRGB_DXT1,
   MESA_FORMAT_SRGBA_DXT1,
   MESA_FORMAT_SRGBA_DXT3,
   MESA_FORMAT_SRGBA_DXT5,
   /*@}*/

   /**
    * \name Compressed texture formats.
    */
   /*@{*/
   /* Type C formats */
   MESA_FORMAT_RGB_FXT1,
   MESA_FORMAT_RGBA_FXT1,
   MESA_FORMAT_RGB_DXT1,
   MESA_FORMAT_RGBA_DXT1,
   MESA_FORMAT_RGBA_DXT3,
   MESA_FORMAT_RGBA_DXT5,
   /*@}*/

   /**
    * \name Floating point texture formats.
    */
   /*@{*/

   /* Type A formats */
   MESA_FORMAT_RGBA_FLOAT32,  /* float[i * 4] = R, [i * 4 + 1] = G, [i * 4 + 2] = B, [i * 4 + 3] = A */
   MESA_FORMAT_RGBA_FLOAT16,
   MESA_FORMAT_RGB_FLOAT32,
   MESA_FORMAT_RGB_FLOAT16,
   MESA_FORMAT_A_FLOAT32,
   MESA_FORMAT_A_FLOAT16,
   MESA_FORMAT_L_FLOAT32,
   MESA_FORMAT_L_FLOAT16,
   MESA_FORMAT_LA_FLOAT32,
   MESA_FORMAT_LA_FLOAT16,
   MESA_FORMAT_I_FLOAT32,
   MESA_FORMAT_I_FLOAT16,
   MESA_FORMAT_R_FLOAT32,
   MESA_FORMAT_R_FLOAT16,
   MESA_FORMAT_RG_FLOAT32,
   MESA_FORMAT_RG_FLOAT16,
   /*@}*/

   /**
    * \name Non-normalized signed integer formats.
    * XXX Note: these are just stand-ins for some better hardware
    * formats TBD such as BGRA or ARGB.
    */

   /* Type A formats */
   MESA_FORMAT_A_UINT8,
   MESA_FORMAT_A_UINT16,
   MESA_FORMAT_A_UINT32,
   MESA_FORMAT_A_SINT8,
   MESA_FORMAT_A_SINT16,
   MESA_FORMAT_A_SINT32,

   MESA_FORMAT_I_UINT8,
   MESA_FORMAT_I_UINT16,
   MESA_FORMAT_I_UINT32,
   MESA_FORMAT_I_SINT8,
   MESA_FORMAT_I_SINT16,
   MESA_FORMAT_I_SINT32,

   MESA_FORMAT_L_UINT8,
   MESA_FORMAT_L_UINT16,
   MESA_FORMAT_L_UINT32,
   MESA_FORMAT_L_SINT8,
   MESA_FORMAT_L_SINT16,
   MESA_FORMAT_L_SINT32,
   MESA_FORMAT_LA_UINT8,
   MESA_FORMAT_LA_UINT16,
   MESA_FORMAT_LA_UINT32,
   MESA_FORMAT_LA_SINT8,
   MESA_FORMAT_LA_SINT16,
   MESA_FORMAT_LA_SINT32,

   MESA_FORMAT_R_SINT8,
   MESA_FORMAT_RG_SINT8,
   MESA_FORMAT_RGB_SINT8,
   MESA_FORMAT_RGBA_SINT8,
   MESA_FORMAT_R_SINT16,
   MESA_FORMAT_RG_SINT16,
   MESA_FORMAT_RGB_SINT16,
   MESA_FORMAT_RGBA_SINT16,

   MESA_FORMAT_R_SINT32,
   MESA_FORMAT_RG_SINT32,
   MESA_FORMAT_RGB_SINT32,
   MESA_FORMAT_RGBA_SINT32,

   /**
    * \name Non-normalized unsigned integer formats.
    */
   /* Type A format(s) */
   MESA_FORMAT_R_UINT8,
   MESA_FORMAT_RG_UINT8,
   MESA_FORMAT_RGB_UINT8,
   MESA_FORMAT_RGBA_UINT8,

   MESA_FORMAT_R_UINT16,
   MESA_FORMAT_RG_UINT16,
   MESA_FORMAT_RGB_UINT16,
   MESA_FORMAT_RGBA_UINT16,

   MESA_FORMAT_R_UINT32,
   MESA_FORMAT_RG_UINT32,
   MESA_FORMAT_RGB_UINT32,
   MESA_FORMAT_RGBA_UINT32,

                                 /* msb <------ TEXEL BITS -----------> lsb */
                                 /* ---- ---- ---- ---- ---- ---- ---- ---- */
   /**
    * \name Signed fixed point texture formats.
    */
   /*@{*/
   MESA_FORMAT_DUDV8,             /*                     DUDU DUDU DVDV DVDV */

   /* Type A format(s) */
   MESA_FORMAT_R_SNORM8,      /* char[i] = R */

   /* Type P formats */
   MESA_FORMAT_R8G8_SNORM,                           /* GGGG GGGG RRRR RRRR */
   MESA_FORMAT_X8B8G8R8_SNORM,   /* RRRR RRRR GGGG GGGG BBBB BBBB xxxx xxxx */
   MESA_FORMAT_A8B8G8R8_SNORM,   /* RRRR RRRR GGGG GGGG BBBB BBBB AAAA AAAA */
   MESA_FORMAT_R8G8B8A8_SNORM,   /* AAAA AAAA BBBB BBBB GGGG GGGG RRRR RRRR */

   /* Type A format(s) */
   MESA_FORMAT_R_SNORM16,     /* short[i] = R */

   /* Type P format(s) */
   MESA_FORMAT_R16G16_SNORM,     /* GGGG GGGG GGGG GGGG RRRR RRRR RRRR RRRR */

   /* Type A format(s) */
   MESA_FORMAT_RGB_SNORM16,   /* short[i * 3] = R, [i * 3 + 1] = G, [i *3 + 2] = B */
   MESA_FORMAT_RGBA_SNORM16,  /* ... */
   MESA_FORMAT_RGBA_UNORM16,  /* ... */
   /*@}*/

   /*@{*/
   /* Type C formats */
   MESA_FORMAT_R_RGTC1_UNORM,
   MESA_FORMAT_R_RGTC1_SNORM,
   MESA_FORMAT_RG_RGTC2_UNORM,
   MESA_FORMAT_RG_RGTC2_SNORM,
   /*@}*/

   /*@{*/
   MESA_FORMAT_L_LATC1_UNORM,
   MESA_FORMAT_L_LATC1_SNORM,
   MESA_FORMAT_LA_LATC2_UNORM,
   MESA_FORMAT_LA_LATC2_SNORM,
   /*@}*/

   MESA_FORMAT_ETC1_RGB8,
   MESA_FORMAT_ETC2_RGB8,
   MESA_FORMAT_ETC2_SRGB8,
   MESA_FORMAT_ETC2_RGBA8_EAC,
   MESA_FORMAT_ETC2_SRGB8_ALPHA8_EAC,
   MESA_FORMAT_ETC2_R11_EAC,
   MESA_FORMAT_ETC2_RG11_EAC,
   MESA_FORMAT_ETC2_SIGNED_R11_EAC,
   MESA_FORMAT_ETC2_SIGNED_RG11_EAC,
   MESA_FORMAT_ETC2_RGB8_PUNCHTHROUGH_ALPHA1,
   MESA_FORMAT_ETC2_SRGB8_PUNCHTHROUGH_ALPHA1,

   /* Type A format(s) */
   MESA_FORMAT_A_SNORM8,      /* char[i] = A */
   MESA_FORMAT_L_SNORM8,      /* char[i] = L */

   /* Type P format(s) */
   MESA_FORMAT_L8A8_SNORM,                           /* AAAA AAAA LLLL LLLL */

   /* Type A format(s) */
   MESA_FORMAT_I_SNORM8,      /* char[i] = I */
   MESA_FORMAT_A_SNORM16,     /* short[i] = A */
   MESA_FORMAT_L_SNORM16,     /* short[i] = L */
   MESA_FORMAT_LA_SNORM16,    /* short[i * 2] = L, [i * 2 + 1] = A */
   MESA_FORMAT_I_SNORM16,     /* short[i] = I */

   /* Type P format(s) */
   MESA_FORMAT_R9G9B9E5_FLOAT,
   MESA_FORMAT_R11G11B10_FLOAT,   /* BBBB BBBB BBGG GGGG GGGG GRRR RRRR RRRR */

   /* Type A format(s) */
   MESA_FORMAT_Z_FLOAT32,

   /* Type P formats */
   MESA_FORMAT_Z32_FLOAT_S8X24_UINT, /* (float, x24s8) */

   MESA_FORMAT_B10G10R10A2_UINT, /* AARR RRRR RRRR GGGG GGGG GGBB BBBB BBBB */
   MESA_FORMAT_R10G10B10A2_UINT, /* AABB BBBB BBBB GGGG GGGG GGRR RRRR RRRR */

   MESA_FORMAT_B4G4R4X4_UNORM,                       /* xxxx RRRR GGGG BBBB */
   MESA_FORMAT_B5G5R5X1_UNORM,                       /* xRRR RRGG GGGB BBBB */
   MESA_FORMAT_R8G8B8X8_SNORM,   /* xxxx xxxx BBBB BBBB GGGG GGGG RRRR RRRR */
   MESA_FORMAT_R8G8B8X8_SRGB,    /* xxxx xxxx BBBB BBBB GGGG GGGG RRRR RRRR */

   /* Type A formats */
   MESA_FORMAT_RGBX_UINT8,    /* uchar[i * 4] = R, [i * 4 + 1] = G, [i * 4 + 2] = B, [i * 4 + 3] = x */
   MESA_FORMAT_RGBX_SINT8,    /* char[i * 4] = R, [i * 4 + 1] = G, [i * 4 + 2] = B, [i * 4 + 3] = x  */

   /* Type P format(s) */
   MESA_FORMAT_B10G10R10X2_UNORM,/* xxRR RRRR RRRR GGGG GGGG GGBB BBBB BBBB */

   /* Type A formats */
   MESA_FORMAT_RGBX_UNORM16,  /* ushort[i * 4] = R, [i * 4 + 1] = G, [i * 4 + 2] = B, [i * 4 + 3] = x */
   MESA_FORMAT_RGBX_SNORM16,  /* ... */
   MESA_FORMAT_RGBX_FLOAT16,  /* ... */
   MESA_FORMAT_RGBX_UINT16,   /* ... */
   MESA_FORMAT_RGBX_SINT16,   /* ... */

   MESA_FORMAT_RGBX_FLOAT32,  /* float[i * 4] = R, [i * 4 + 1] = G, [i * 4 + 2] = B, [i * 4 + 3] = x */
   MESA_FORMAT_RGBX_UINT32,   /* ... */
   MESA_FORMAT_RGBX_SINT32,   /* ... */

   /* Type P formats */
   MESA_FORMAT_R10G10B10A2_UNORM, /* AABB BBBB BBBB GGGG GGGG GGRR RRRR RRRR */
   MESA_FORMAT_G8R8_SNORM,        /*                     RRRR RRRR GGGG GGGG */
   MESA_FORMAT_G16R16_SNORM,      /* RRRR RRRR RRRR RRRR GGGG GGGG GGGG GGGG */

   MESA_FORMAT_B8G8R8X8_SRGB,     /* xxxx xxxx RRRR RRRR GGGG GGGG BBBB BBBB */

   MESA_FORMAT_COUNT
} mesa_format;


extern const char *
_mesa_get_format_name(mesa_format format);

extern GLint
_mesa_get_format_bytes(mesa_format format);

extern GLint
_mesa_get_format_bits(mesa_format format, GLenum pname);

extern GLuint
_mesa_get_format_max_bits(mesa_format format);

extern GLenum
_mesa_get_format_datatype(mesa_format format);

extern GLenum
_mesa_get_format_base_format(mesa_format format);

extern void
_mesa_get_format_block_size(mesa_format format, GLuint *bw, GLuint *bh);

extern GLboolean
_mesa_is_format_compressed(mesa_format format);

extern GLboolean
_mesa_is_format_packed_depth_stencil(mesa_format format);

extern GLboolean
_mesa_is_format_integer_color(mesa_format format);

extern GLboolean
_mesa_is_format_unsigned(mesa_format format);

extern GLboolean
_mesa_is_format_signed(mesa_format format);

extern GLenum
_mesa_get_format_color_encoding(mesa_format format);

extern GLuint
_mesa_format_image_size(mesa_format format, GLsizei width,
                        GLsizei height, GLsizei depth);

extern uint64_t
_mesa_format_image_size64(mesa_format format, GLsizei width,
                          GLsizei height, GLsizei depth);

extern GLint
_mesa_format_row_stride(mesa_format format, GLsizei width);

extern void
_mesa_format_to_type_and_comps(mesa_format format,
                               GLenum *datatype, GLuint *comps);

extern void
_mesa_test_formats(void);

extern mesa_format
_mesa_get_srgb_format_linear(mesa_format format);

extern mesa_format
_mesa_get_uncompressed_format(mesa_format format);

extern GLuint
_mesa_format_num_components(mesa_format format);

GLboolean
_mesa_format_matches_format_and_type(mesa_format mesa_format,
				     GLenum format, GLenum type,
                                     GLboolean swapBytes);

#ifdef __cplusplus
}
#endif

#endif /* FORMATS_H */