src/gallium/include/pipe/p_format.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
   4  * All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the
   8  * "Software"), to deal in the Software without restriction, including
   9  * without limitation the rights to use, copy, modify, merge, publish,
  10  * distribute, sub license, and/or sell copies of the Software, and to
  11  * permit persons to whom the Software is furnished to do so, subject to
  12  * the following conditions:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * 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
  20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  21  * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
  22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  *
  26  **************************************************************************/
  27
  28 #ifndef PIPE_FORMAT_H
  29 #define PIPE_FORMAT_H
  30
  31 #include <stdio.h> /* for sprintf */
  32
  33 #include "p_compiler.h"
  34 #include "p_debug.h"
  35
  36 #ifdef __cplusplus
  37 extern "C" {
  38 #endif
  39
  40 /**
  41  * The pipe_format enum is a 32-bit wide bitfield that encodes all the
  42  * information needed to uniquely describe a pixel format.
  43  */
  44
  45 /**
  46  * Possible format layouts are encoded in the first 2 bits.
  47  * The interpretation of the remaining 30 bits depends on a particular
  48  * format layout.
  49  */
  50 #define PIPE_FORMAT_LAYOUT_RGBAZS   0
  51 #define PIPE_FORMAT_LAYOUT_YCBCR    1
  52 #define PIPE_FORMAT_LAYOUT_DXT      2  /**< XXX temporary? */
  53
  54
  55 static INLINE uint pf_layout(uint f)  /**< PIPE_FORMAT_LAYOUT_ */
  56 {
  57    return f & 0x3;
  58 }
  59
  60 /**
  61  * RGBAZS Format Layout.
  62  */
  63
  64 /**
  65  * Format component selectors for RGBAZS layout.
  66  */
  67 #define PIPE_FORMAT_COMP_R    0
  68 #define PIPE_FORMAT_COMP_G    1
  69 #define PIPE_FORMAT_COMP_B    2
  70 #define PIPE_FORMAT_COMP_A    3
  71 #define PIPE_FORMAT_COMP_0    4
  72 #define PIPE_FORMAT_COMP_1    5
  73 #define PIPE_FORMAT_COMP_Z    6
  74 #define PIPE_FORMAT_COMP_S    7
  75
  76 /**
  77  * Format types for RGBAZS layout.
  78  */
  79 #define PIPE_FORMAT_TYPE_UNKNOWN 0
  80 #define PIPE_FORMAT_TYPE_FLOAT   1  /**< 16/32/64-bit/channel formats */
  81 #define PIPE_FORMAT_TYPE_UNORM   2  /**< uints, normalized to [0,1] */
  82 #define PIPE_FORMAT_TYPE_SNORM   3  /**< ints, normalized to [-1,1] */
  83 #define PIPE_FORMAT_TYPE_USCALED 4  /**< uints, not normalized */
  84 #define PIPE_FORMAT_TYPE_SSCALED 5  /**< ints, not normalized */
  85 #define PIPE_FORMAT_TYPE_SRGB    6  /**< sRGB colorspace */
  86
  87
  88 /**
  89  * Because the destination vector is assumed to be RGBA FLOAT, we
  90  * need to know how to swizzle and expand components from the source
  91  * vector.
  92  * Let's take U_A1_R5_G5_B5 as an example. X swizzle is A, X size
  93  * is 1 bit and type is UNORM. So we take the most significant bit
  94  * from source vector, convert 0 to 0.0 and 1 to 1.0 and save it
  95  * in the last component of the destination RGBA component.
  96  * Next, Y swizzle is R, Y size is 5 and type is UNORM. We normalize
  97  * those 5 bits into [0.0; 1.0] range and put it into second
  98  * component of the destination vector. Rinse and repeat for
  99  * components Z and W.
 100  * If any of size fields is zero, it means the source format contains
 101  * less than four components.
 102  * If any swizzle is 0 or 1, the corresponding destination component
 103  * should be filled with 0.0 and 1.0, respectively.
 104  */
 105 typedef uint pipe_format_rgbazs_t;
 106
 107 static INLINE uint pf_get(pipe_format_rgbazs_t f, uint shift, uint mask)
 108 {
 109    return (f >> shift) & mask;
 110 }
 111
 112 /* XXX: The bit layout needs to be revised, can't currently encode 10-bit components. */
 113
 114 #define pf_swizzle_x(f)       pf_get(f, 2, 0x7)  /**< PIPE_FORMAT_COMP_ */
 115 #define pf_swizzle_y(f)       pf_get(f, 5, 0x7)  /**< PIPE_FORMAT_COMP_ */
 116 #define pf_swizzle_z(f)       pf_get(f, 8, 0x7)  /**< PIPE_FORMAT_COMP_ */
 117 #define pf_swizzle_w(f)       pf_get(f, 11, 0x7) /**< PIPE_FORMAT_COMP_ */
 118 #define pf_swizzle_xyzw(f,i)  pf_get(f, 2+((i)*3), 0x7)
 119 #define pf_size_x(f)          pf_get(f, 14, 0x7) /**< Size of X */
 120 #define pf_size_y(f)          pf_get(f, 17, 0x7) /**< Size of Y */
 121 #define pf_size_z(f)          pf_get(f, 20, 0x7) /**< Size of Z */
 122 #define pf_size_w(f)          pf_get(f, 23, 0x7) /**< Size of W */
 123 #define pf_size_xyzw(f,i)     pf_get(f, 14+((i)*3), 0x7)
 124 #define pf_exp8(f)            pf_get(f, 26, 0x3) /**< Scale size by 8 ^ exp8 */
 125 #define pf_type(f)            pf_get(f, 28, 0xf) /**< PIPE_FORMAT_TYPE_ */
 126
 127 /**
 128  * Helper macro to encode the above structure into a 32-bit value.
 129  */
 130 #define _PIPE_FORMAT_RGBAZS( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, EXP8, TYPE ) (\
 131    (PIPE_FORMAT_LAYOUT_RGBAZS << 0) |\
 132    ((SWZ) << 2) |\
 133    ((SIZEX) << 14) |\
 134    ((SIZEY) << 17) |\
 135    ((SIZEZ) << 20) |\
 136    ((SIZEW) << 23) |\
 137    ((EXP8) << 26) |\
 138    ((TYPE) << 28) )
 139
 140 /**
 141  * Helper macro to encode the swizzle part of the structure above.
 142  */
 143 #define _PIPE_FORMAT_SWZ( SWZX, SWZY, SWZZ, SWZW ) (((SWZX) << 0) | ((SWZY) << 3) | ((SWZZ) << 6) | ((SWZW) << 9))
 144
 145 /**
 146  * Shorthand macro for RGBAZS layout with component sizes in 1-bit units.
 147  */
 148 #define _PIPE_FORMAT_RGBAZS_1( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, TYPE )\
 149    _PIPE_FORMAT_RGBAZS( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, 0, TYPE )
 150
 151 /**
 152  * Shorthand macro for RGBAZS layout with component sizes in 8-bit units.
 153  */
 154 #define _PIPE_FORMAT_RGBAZS_8( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, TYPE )\
 155    _PIPE_FORMAT_RGBAZS( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, 1, TYPE )
 156
 157 /**
 158  * Shorthand macro for RGBAZS layout with component sizes in 64-bit units.
 159  */
 160 #define _PIPE_FORMAT_RGBAZS_64( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, TYPE )\
 161    _PIPE_FORMAT_RGBAZS( SWZ, SIZEX, SIZEY, SIZEZ, SIZEW, 2, TYPE )
 162
 163 /**
 164  * Shorthand macro for common format swizzles.
 165  */
 166 #define _PIPE_FORMAT_R000 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 167 #define _PIPE_FORMAT_RG00 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_G, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 168 #define _PIPE_FORMAT_RGB0 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_G, PIPE_FORMAT_COMP_B, PIPE_FORMAT_COMP_0 )
 169 #define _PIPE_FORMAT_RGBA _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_G, PIPE_FORMAT_COMP_B, PIPE_FORMAT_COMP_A )
 170 #define _PIPE_FORMAT_ARGB _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_A, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_G, PIPE_FORMAT_COMP_B )
 171 #define _PIPE_FORMAT_BGRA _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_B, PIPE_FORMAT_COMP_G, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_A )
 172 #define _PIPE_FORMAT_0000 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 173 #define _PIPE_FORMAT_000R _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_R )
 174 #define _PIPE_FORMAT_RRR1 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_1 )
 175 #define _PIPE_FORMAT_RRRR _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R )
 176 #define _PIPE_FORMAT_RRRG _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_R, PIPE_FORMAT_COMP_G )
 177 #define _PIPE_FORMAT_Z000 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_Z, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 178 #define _PIPE_FORMAT_SZ00 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_S, PIPE_FORMAT_COMP_Z, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 179 #define _PIPE_FORMAT_ZS00 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_Z, PIPE_FORMAT_COMP_S, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 180 #define _PIPE_FORMAT_S000 _PIPE_FORMAT_SWZ( PIPE_FORMAT_COMP_S, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0, PIPE_FORMAT_COMP_0 )
 181
 182 /**
 183  * YCBCR Format Layout.
 184  */
 185
 186 /**
 187  * This only contains a flag that indicates whether the format is reversed or
 188  * not.
 189  */
 190 typedef uint pipe_format_ycbcr_t;
 191
 192 /**
 193  * Helper macro to encode the above structure into a 32-bit value.
 194  */
 195 #define _PIPE_FORMAT_YCBCR( REV ) (\
 196    (PIPE_FORMAT_LAYOUT_YCBCR << 0) |\
 197    ((REV) << 2) )
 198
 199 static INLINE uint pf_rev(pipe_format_ycbcr_t f)
 200 {
 201    return (f >> 2) & 0x1;
 202 }
 203
 204
 205 /**
 206   * Compresssed format layouts (this will probably change)
 207   */
 208 #define _PIPE_FORMAT_DXT( LEVEL, RSIZE, GSIZE, BSIZE, ASIZE ) \
 209    ((PIPE_FORMAT_LAYOUT_DXT << 0) | \
 210     ((LEVEL) << 2) | \
 211     ((RSIZE) << 5) | \
 212     ((GSIZE) << 8) | \
 213     ((BSIZE) << 11) | \
 214     ((ASIZE) << 14) )
 215
 216
 217
 218 /**
 219  * Texture/surface image formats (preliminary)
 220  */
 221
 222 /* KW: Added lots of surface formats to support vertex element layout
 223  * definitions, and eventually render-to-vertex-buffer.  Could
 224  * consider making float/int/uint/scaled/normalized a separate
 225  * parameter, but on the other hand there are special cases like
 226  * z24s8, compressed textures, ycbcr, etc that won't fit that model.
 227  */
 228
 229 enum pipe_format {
 230    PIPE_FORMAT_NONE                  = _PIPE_FORMAT_RGBAZS_1 ( _PIPE_FORMAT_0000, 0, 0, 0, 0, PIPE_FORMAT_TYPE_UNKNOWN ),
 231    PIPE_FORMAT_A8R8G8B8_UNORM        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_ARGB, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ),
 232    PIPE_FORMAT_B8G8R8A8_UNORM        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_BGRA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ),
 233    PIPE_FORMAT_A1R5G5B5_UNORM        = _PIPE_FORMAT_RGBAZS_1 ( _PIPE_FORMAT_ARGB, 1, 5, 5, 5, PIPE_FORMAT_TYPE_UNORM ),
 234    PIPE_FORMAT_A4R4G4B4_UNORM        = _PIPE_FORMAT_RGBAZS_1 ( _PIPE_FORMAT_ARGB, 4, 4, 4, 4, PIPE_FORMAT_TYPE_UNORM ),
 235    PIPE_FORMAT_R5G6B5_UNORM          = _PIPE_FORMAT_RGBAZS_1 ( _PIPE_FORMAT_RGB0, 5, 6, 5, 0, PIPE_FORMAT_TYPE_UNORM ),
 236    PIPE_FORMAT_U_L8                  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RRR1, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ), /**< ubyte luminance */
 237    PIPE_FORMAT_U_A8                  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_000R, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ), /**< ubyte alpha */
 238    PIPE_FORMAT_U_I8                  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RRRR, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ), /**< ubyte intensity */
 239    PIPE_FORMAT_U_A8_L8               = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RRRG, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ), /**< ubyte alpha, luminance */
 240    PIPE_FORMAT_YCBCR                 = _PIPE_FORMAT_YCBCR( 0 ),
 241    PIPE_FORMAT_YCBCR_REV             = _PIPE_FORMAT_YCBCR( 1 ),
 242    PIPE_FORMAT_Z16_UNORM             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_Z000, 2, 0, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 243    PIPE_FORMAT_Z32_UNORM             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_Z000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 244    PIPE_FORMAT_Z32_FLOAT             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_Z000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_FLOAT ),
 245    PIPE_FORMAT_S8Z24_UNORM           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_SZ00, 1, 3, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 246    PIPE_FORMAT_Z24S8_UNORM           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_ZS00, 3, 1, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 247    PIPE_FORMAT_S8_UNORM              = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_S000, 1, 0, 0, 0, PIPE_FORMAT_TYPE_UNORM ), /**< ubyte stencil */
 248    PIPE_FORMAT_R64_FLOAT             = _PIPE_FORMAT_RGBAZS_64( _PIPE_FORMAT_R000, 1, 0, 0, 0, PIPE_FORMAT_TYPE_FLOAT ),
 249    PIPE_FORMAT_R64G64_FLOAT          = _PIPE_FORMAT_RGBAZS_64( _PIPE_FORMAT_RG00, 1, 1, 0, 0, PIPE_FORMAT_TYPE_FLOAT ),
 250    PIPE_FORMAT_R64G64B64_FLOAT       = _PIPE_FORMAT_RGBAZS_64( _PIPE_FORMAT_RGB0, 1, 1, 1, 0, PIPE_FORMAT_TYPE_FLOAT ),
 251    PIPE_FORMAT_R64G64B64A64_FLOAT    = _PIPE_FORMAT_RGBAZS_64( _PIPE_FORMAT_RGBA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_FLOAT ),
 252    PIPE_FORMAT_R32_FLOAT             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_FLOAT ),
 253    PIPE_FORMAT_R32G32_FLOAT          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 4, 4, 0, 0, PIPE_FORMAT_TYPE_FLOAT ),
 254    PIPE_FORMAT_R32G32B32_FLOAT       = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 4, 4, 4, 0, PIPE_FORMAT_TYPE_FLOAT ),
 255    PIPE_FORMAT_R32G32B32A32_FLOAT    = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 4, 4, 4, 4, PIPE_FORMAT_TYPE_FLOAT ),
 256    PIPE_FORMAT_R32_UNORM             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 257    PIPE_FORMAT_R32G32_UNORM          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 4, 4, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 258    PIPE_FORMAT_R32G32B32_UNORM       = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 4, 4, 4, 0, PIPE_FORMAT_TYPE_UNORM ),
 259    PIPE_FORMAT_R32G32B32A32_UNORM    = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 4, 4, 4, 4, PIPE_FORMAT_TYPE_UNORM ),
 260    PIPE_FORMAT_R32_USCALED           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_USCALED ),
 261    PIPE_FORMAT_R32G32_USCALED        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 4, 4, 0, 0, PIPE_FORMAT_TYPE_USCALED ),
 262    PIPE_FORMAT_R32G32B32_USCALED     = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 4, 4, 4, 0, PIPE_FORMAT_TYPE_USCALED ),
 263    PIPE_FORMAT_R32G32B32A32_USCALED  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 4, 4, 4, 4, PIPE_FORMAT_TYPE_USCALED ),
 264    PIPE_FORMAT_R32_SNORM             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_SNORM ),
 265    PIPE_FORMAT_R32G32_SNORM          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 4, 4, 0, 0, PIPE_FORMAT_TYPE_SNORM ),
 266    PIPE_FORMAT_R32G32B32_SNORM       = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 4, 4, 4, 0, PIPE_FORMAT_TYPE_SNORM ),
 267    PIPE_FORMAT_R32G32B32A32_SNORM    = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 4, 4, 4, 4, PIPE_FORMAT_TYPE_SNORM ),
 268    PIPE_FORMAT_R32_SSCALED           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 4, 0, 0, 0, PIPE_FORMAT_TYPE_SSCALED ),
 269    PIPE_FORMAT_R32G32_SSCALED        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 4, 4, 0, 0, PIPE_FORMAT_TYPE_SSCALED ),
 270    PIPE_FORMAT_R32G32B32_SSCALED     = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 4, 4, 4, 0, PIPE_FORMAT_TYPE_SSCALED ),
 271    PIPE_FORMAT_R32G32B32A32_SSCALED  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 4, 4, 4, 4, PIPE_FORMAT_TYPE_SSCALED ),
 272    PIPE_FORMAT_R16_UNORM             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 2, 0, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 273    PIPE_FORMAT_R16G16_UNORM          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 2, 2, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 274    PIPE_FORMAT_R16G16B16_UNORM       = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 2, 2, 2, 0, PIPE_FORMAT_TYPE_UNORM ),
 275    PIPE_FORMAT_R16G16B16A16_UNORM    = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 2, 2, 2, 2, PIPE_FORMAT_TYPE_UNORM ),
 276    PIPE_FORMAT_R16_USCALED           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 2, 0, 0, 0, PIPE_FORMAT_TYPE_USCALED ),
 277    PIPE_FORMAT_R16G16_USCALED        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 2, 2, 0, 0, PIPE_FORMAT_TYPE_USCALED ),
 278    PIPE_FORMAT_R16G16B16_USCALED     = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 2, 2, 2, 0, PIPE_FORMAT_TYPE_USCALED ),
 279    PIPE_FORMAT_R16G16B16A16_USCALED  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 2, 2, 2, 2, PIPE_FORMAT_TYPE_USCALED ),
 280    PIPE_FORMAT_R16_SNORM             = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 2, 0, 0, 0, PIPE_FORMAT_TYPE_SNORM ),
 281    PIPE_FORMAT_R16G16_SNORM          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 2, 2, 0, 0, PIPE_FORMAT_TYPE_SNORM ),
 282    PIPE_FORMAT_R16G16B16_SNORM       = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 2, 2, 2, 0, PIPE_FORMAT_TYPE_SNORM ),
 283    PIPE_FORMAT_R16G16B16A16_SNORM    = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 2, 2, 2, 2, PIPE_FORMAT_TYPE_SNORM ),
 284    PIPE_FORMAT_R16_SSCALED           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 2, 0, 0, 0, PIPE_FORMAT_TYPE_SSCALED ),
 285    PIPE_FORMAT_R16G16_SSCALED        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 2, 2, 0, 0, PIPE_FORMAT_TYPE_SSCALED ),
 286    PIPE_FORMAT_R16G16B16_SSCALED     = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 2, 2, 2, 0, PIPE_FORMAT_TYPE_SSCALED ),
 287    PIPE_FORMAT_R16G16B16A16_SSCALED  = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 2, 2, 2, 2, PIPE_FORMAT_TYPE_SSCALED ),
 288    PIPE_FORMAT_R8_UNORM              = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 1, 0, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 289    PIPE_FORMAT_R8G8_UNORM            = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 1, 1, 0, 0, PIPE_FORMAT_TYPE_UNORM ),
 290    PIPE_FORMAT_R8G8B8_UNORM          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 1, 1, 1, 0, PIPE_FORMAT_TYPE_UNORM ),
 291    PIPE_FORMAT_R8G8B8A8_UNORM        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_UNORM ),
 292    PIPE_FORMAT_R8_USCALED            = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 1, 0, 0, 0, PIPE_FORMAT_TYPE_USCALED ),
 293    PIPE_FORMAT_R8G8_USCALED          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 1, 1, 0, 0, PIPE_FORMAT_TYPE_USCALED ),
 294    PIPE_FORMAT_R8G8B8_USCALED        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 1, 1, 1, 0, PIPE_FORMAT_TYPE_USCALED ),
 295    PIPE_FORMAT_R8G8B8A8_USCALED      = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_USCALED ),
 296    PIPE_FORMAT_R8_SNORM              = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 1, 0, 0, 0, PIPE_FORMAT_TYPE_SNORM ),
 297    PIPE_FORMAT_R8G8_SNORM            = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 1, 1, 0, 0, PIPE_FORMAT_TYPE_SNORM ),
 298    PIPE_FORMAT_R8G8B8_SNORM          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 1, 1, 1, 0, PIPE_FORMAT_TYPE_SNORM ),
 299    PIPE_FORMAT_R8G8B8A8_SNORM        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_SNORM ),
 300    PIPE_FORMAT_R8_SSCALED            = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_R000, 1, 0, 0, 0, PIPE_FORMAT_TYPE_SSCALED ),
 301    PIPE_FORMAT_R8G8_SSCALED          = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RG00, 1, 1, 0, 0, PIPE_FORMAT_TYPE_SSCALED ),
 302    PIPE_FORMAT_R8G8B8_SSCALED        = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 1, 1, 1, 0, PIPE_FORMAT_TYPE_SSCALED ),
 303    PIPE_FORMAT_R8G8B8A8_SSCALED      = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_SSCALED ),
 304    /* sRGB formats */
 305    PIPE_FORMAT_L8_SRGB               = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RRR1, 1, 1, 1, 1, PIPE_FORMAT_TYPE_SRGB ),
 306    PIPE_FORMAT_A8_L8_SRGB            = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RRRG, 1, 1, 1, 1, PIPE_FORMAT_TYPE_SRGB ),
 307    PIPE_FORMAT_R8G8B8_SRGB           = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGB0, 1, 1, 1, 0, PIPE_FORMAT_TYPE_SRGB ),
 308    PIPE_FORMAT_R8G8B8A8_SRGB         = _PIPE_FORMAT_RGBAZS_8 ( _PIPE_FORMAT_RGBA, 1, 1, 1, 1, PIPE_FORMAT_TYPE_SRGB ),
 309
 310    /* compressed formats */
 311    PIPE_FORMAT_DXT1_RGB              = _PIPE_FORMAT_DXT( 1, 8, 8, 8, 0 ),
 312    PIPE_FORMAT_DXT1_RGBA             = _PIPE_FORMAT_DXT( 1, 8, 8, 8, 8 ),
 313    PIPE_FORMAT_DXT3_RGBA             = _PIPE_FORMAT_DXT( 3, 8, 8, 8, 8 ),
 314    PIPE_FORMAT_DXT5_RGBA             = _PIPE_FORMAT_DXT( 5, 8, 8, 8, 8 )
 315 };
 316
 317
 318 /**
 319  * Unsigned 8-bit stencil format.
 320  * XXX should remove this, but S8_UNORM is a poor name
 321  */
 322 #define PIPE_FORMAT_U_S8                  PIPE_FORMAT_S8_UNORM
 323
 324
 325 /**
 326  * Builds pipe format name from format token.
 327  */
 328 static INLINE char *pf_sprint_name( char *str, enum pipe_format format )
 329 {
 330    strcpy( str, "PIPE_FORMAT_" );
 331    switch (pf_layout( format )) {
 332    case PIPE_FORMAT_LAYOUT_RGBAZS:
 333       {
 334          pipe_format_rgbazs_t rgbazs = (pipe_format_rgbazs_t) format;
 335          uint                 i;
 336          uint                 scale = 1 << (pf_exp8( rgbazs ) * 3);
 337
 338          for (i = 0; i < 4; i++) {
 339             uint  size = pf_size_xyzw( rgbazs, i );
 340
 341             if (size == 0) {
 342                break;
 343             }
 344             switch (pf_swizzle_xyzw( rgbazs, i )) {
 345             case PIPE_FORMAT_COMP_R:
 346                strcat( str, "R" );
 347                break;
 348             case PIPE_FORMAT_COMP_G:
 349                strcat( str, "G" );
 350                break;
 351             case PIPE_FORMAT_COMP_B:
 352                strcat( str, "B" );
 353                break;
 354             case PIPE_FORMAT_COMP_A:
 355                strcat( str, "A" );
 356                break;
 357             case PIPE_FORMAT_COMP_0:
 358                strcat( str, "0" );
 359                break;
 360             case PIPE_FORMAT_COMP_1:
 361                strcat( str, "1" );
 362                break;
 363             case PIPE_FORMAT_COMP_Z:
 364                strcat( str, "Z" );
 365                break;
 366             case PIPE_FORMAT_COMP_S:
 367                strcat( str, "S" );
 368                break;
 369             }
 370             sprintf( &str[strlen( str )], "%u", size * scale );
 371          }
 372          if (i != 0) {
 373             strcat( str, "_" );
 374          }
 375          switch (pf_type( rgbazs )) {
 376          case PIPE_FORMAT_TYPE_UNKNOWN:
 377             strcat( str, "NONE" );
 378             break;
 379          case PIPE_FORMAT_TYPE_FLOAT:
 380             strcat( str, "FLOAT" );
 381             break;
 382          case PIPE_FORMAT_TYPE_UNORM:
 383             strcat( str, "UNORM" );
 384             break;
 385          case PIPE_FORMAT_TYPE_SNORM:
 386             strcat( str, "SNORM" );
 387             break;
 388          case PIPE_FORMAT_TYPE_USCALED:
 389             strcat( str, "USCALED" );
 390             break;
 391          case PIPE_FORMAT_TYPE_SSCALED:
 392             strcat( str, "SSCALED" );
 393             break;
 394          }
 395       }
 396       break;
 397    case PIPE_FORMAT_LAYOUT_YCBCR:
 398       {
 399          pipe_format_ycbcr_t  ycbcr = (pipe_format_ycbcr_t) format;
 400
 401          strcat( str, "YCBCR" );
 402          if (pf_rev( ycbcr )) {
 403             strcat( str, "_REV" );
 404          }
 405       }
 406       break;
 407    }
 408    return str;
 409 }
 410
 411 /**
 412  * Return bits for a particular component.
 413  * \param comp  component index, starting at 0
 414  */
 415 static INLINE uint pf_get_component_bits( enum pipe_format format, uint comp )
 416 {
 417    uint size;
 418
 419    if (pf_swizzle_x(format) == comp) {
 420       size = pf_size_x(format);
 421    }
 422    else if (pf_swizzle_y(format) == comp) {
 423       size = pf_size_y(format);
 424    }
 425    else if (pf_swizzle_z(format) == comp) {
 426       size = pf_size_z(format);
 427    }
 428    else if (pf_swizzle_w(format) == comp) {
 429       size = pf_size_w(format);
 430    }
 431    else {
 432       size = 0;
 433    }
 434    return size << (pf_exp8(format) * 3);
 435 }
 436
 437 /**
 438  * Return total bits needed for the pixel format.
 439  */
 440 static INLINE uint pf_get_bits( enum pipe_format format )
 441 {
 442    switch (pf_layout(format)) {
 443    case PIPE_FORMAT_LAYOUT_RGBAZS:
 444       return
 445          pf_get_component_bits( format, PIPE_FORMAT_COMP_R ) +
 446          pf_get_component_bits( format, PIPE_FORMAT_COMP_G ) +
 447          pf_get_component_bits( format, PIPE_FORMAT_COMP_B ) +
 448          pf_get_component_bits( format, PIPE_FORMAT_COMP_A ) +
 449          pf_get_component_bits( format, PIPE_FORMAT_COMP_Z ) +
 450          pf_get_component_bits( format, PIPE_FORMAT_COMP_S );
 451    case PIPE_FORMAT_LAYOUT_YCBCR:
 452       assert( format == PIPE_FORMAT_YCBCR || format == PIPE_FORMAT_YCBCR_REV );
 453       /* return effective bits per pixel */
 454       return 16;
 455    default:
 456       assert( 0 );
 457       return 0;
 458    }
 459 }
 460
 461 /**
 462  * Return bytes per pixel for the given format.
 463  */
 464 static INLINE uint pf_get_size( enum pipe_format format )
 465 {
 466    assert(pf_get_bits(format) % 8 == 0);
 467    return pf_get_bits(format) / 8;
 468 }
 469
 470 #ifdef __cplusplus
 471 }
 472 #endif
 473
 474 #endif