u_format.csv revision b48359184e36ecd11510e9c87e3db535935c99e2
1########################################################################### 2# 3# Copyright 2009-2010 VMware, Inc. 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 THE AUTHORS 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# This CSV file has the input data for u_format.h's struct 29# util_format_description. 30# 31# Each format entry contains: 32# - name, per enum pipe_format 33# - layout, per enum util_format_layout, in shortened lower caps 34# - pixel block's width 35# - pixel block's height 36# - channel encoding (only meaningful for plain layout), containing for each 37# channel the following information: 38# - type, one of 39# - 'x': void 40# - 'u': unsigned 41# - 's': signed 42# - 'h': fixed 43# - 'f': FLOAT 44# - optionally followed by 'n' if it is normalized 45# - number of bits 46# - channel swizzle 47# - color space: rgb, yub, sz 48# 49# See also: 50# - http://msdn.microsoft.com/en-us/library/bb172558.aspx (D3D9) 51# - http://msdn.microsoft.com/en-us/library/bb205073.aspx#mapping_texture_formats (D3D9 -> D3D10) 52# - http://msdn.microsoft.com/en-us/library/bb173059.aspx (D3D10) 53# 54# Note that GL doesn't really specify the layout of internal formats. See 55# OpenGL 2.1 specification, Table 3.16, on the "Correspondence of sized 56# internal formats to base in- ternal formats, and desired component 57# resolutions for each sized internal format." 58 59# None 60# Described as regular uint_8 bytes, i.e. PIPE_FORMAT_R8_USCALED 61PIPE_FORMAT_NONE , plain, 1, 1, u8 , , , , x001, rgb 62 63# Typical rendertarget formats 64PIPE_FORMAT_B8G8R8A8_UNORM , plain, 1, 1, un8 , un8 , un8 , un8 , zyxw, rgb 65PIPE_FORMAT_B8G8R8X8_UNORM , plain, 1, 1, un8 , un8 , un8 , x8 , zyx1, rgb 66PIPE_FORMAT_A8R8G8B8_UNORM , plain, 1, 1, un8 , un8 , un8 , un8 , yzwx, rgb 67PIPE_FORMAT_X8R8G8B8_UNORM , plain, 1, 1, x8 , un8 , un8 , un8 , yzw1, rgb 68PIPE_FORMAT_A8B8G8R8_UNORM , plain, 1, 1, un8 , un8 , un8 , un8 , wzyx, rgb 69PIPE_FORMAT_X8B8G8R8_UNORM , plain, 1, 1, x8 , un8 , un8 , un8 , wzy1, rgb 70# PIPE_FORMAT_R8G8B8A8_UNORM is below 71PIPE_FORMAT_R8G8B8X8_UNORM , plain, 1, 1, un8 , un8 , un8 , x8 , xyz1, rgb 72PIPE_FORMAT_B5G5R5X1_UNORM , plain, 1, 1, un5 , un5 , un5 , x1 , zyx1, rgb 73PIPE_FORMAT_B5G5R5A1_UNORM , plain, 1, 1, un5 , un5 , un5 , un1 , zyxw, rgb 74PIPE_FORMAT_B4G4R4A4_UNORM , plain, 1, 1, un4 , un4 , un4 , un4 , zyxw, rgb 75PIPE_FORMAT_B4G4R4X4_UNORM , plain, 1, 1, un4 , un4 , un4 , x4 , zyx1, rgb 76PIPE_FORMAT_B5G6R5_UNORM , plain, 1, 1, un5 , un6 , un5 , , zyx1, rgb 77PIPE_FORMAT_R10G10B10A2_UNORM , plain, 1, 1, un10, un10, un10, un2 , xyzw, rgb 78PIPE_FORMAT_B10G10R10A2_UNORM , plain, 1, 1, un10, un10, un10, un2 , zyxw, rgb 79PIPE_FORMAT_B2G3R3_UNORM , plain, 1, 1, un2 , un3 , un3 , , zyx1, rgb 80 81# Luminance/Intensity/Alpha formats 82PIPE_FORMAT_L8_UNORM , plain, 1, 1, un8 , , , , xxx1, rgb 83PIPE_FORMAT_A8_UNORM , plain, 1, 1, un8 , , , , 000x, rgb 84PIPE_FORMAT_I8_UNORM , plain, 1, 1, un8 , , , , xxxx, rgb 85PIPE_FORMAT_L4A4_UNORM , plain, 1, 1, un4 , un4 , , , xxxy, rgb 86PIPE_FORMAT_L8A8_UNORM , plain, 1, 1, un8 , un8 , , , xxxy, rgb 87PIPE_FORMAT_L16_UNORM , plain, 1, 1, un16, , , , xxx1, rgb 88PIPE_FORMAT_A16_UNORM , plain, 1, 1, un16, , , , 000x, rgb 89PIPE_FORMAT_I16_UNORM , plain, 1, 1, un16, , , , xxxx, rgb 90PIPE_FORMAT_L16A16_UNORM , plain, 1, 1, un16, un16, , , xxxy, rgb 91PIPE_FORMAT_A8_SNORM , plain, 1, 1, sn8 , , , , 000x, rgb 92PIPE_FORMAT_L8_SNORM , plain, 1, 1, sn8 , , , , xxx1, rgb 93PIPE_FORMAT_L8A8_SNORM , plain, 1, 1, sn8 , sn8 , , , xxxy, rgb 94PIPE_FORMAT_I8_SNORM , plain, 1, 1, sn8 , , , , xxxx, rgb 95PIPE_FORMAT_A16_SNORM , plain, 1, 1, sn16, , , , 000x, rgb 96PIPE_FORMAT_L16_SNORM , plain, 1, 1, sn16, , , , xxx1, rgb 97PIPE_FORMAT_L16A16_SNORM , plain, 1, 1, sn16, sn16, , , xxxy, rgb 98PIPE_FORMAT_I16_SNORM , plain, 1, 1, sn16, , , , xxxx, rgb 99PIPE_FORMAT_A16_FLOAT , plain, 1, 1, f16 , , , , 000x, rgb 100PIPE_FORMAT_L16_FLOAT , plain, 1, 1, f16 , , , , xxx1, rgb 101PIPE_FORMAT_L16A16_FLOAT , plain, 1, 1, f16 , f16 , , , xxxy, rgb 102PIPE_FORMAT_I16_FLOAT , plain, 1, 1, f16 , , , , xxxx, rgb 103PIPE_FORMAT_A32_FLOAT , plain, 1, 1, f32 , , , , 000x, rgb 104PIPE_FORMAT_L32_FLOAT , plain, 1, 1, f32 , , , , xxx1, rgb 105PIPE_FORMAT_L32A32_FLOAT , plain, 1, 1, f32 , f32 , , , xxxy, rgb 106PIPE_FORMAT_I32_FLOAT , plain, 1, 1, f32 , , , , xxxx, rgb 107 108# SRGB formats 109PIPE_FORMAT_L8_SRGB , plain, 1, 1, un8 , , , , xxx1, srgb 110PIPE_FORMAT_L8A8_SRGB , plain, 1, 1, un8 , un8 , , , xxxy, srgb 111PIPE_FORMAT_R8G8B8_SRGB , plain, 1, 1, un8 , un8 , un8 , , xyz1, srgb 112PIPE_FORMAT_R8G8B8A8_SRGB , plain, 1, 1, un8 , un8 , un8 , un8 , xyzw, srgb 113PIPE_FORMAT_A8B8G8R8_SRGB , plain, 1, 1, un8 , un8 , un8 , un8 , wzyx, srgb 114PIPE_FORMAT_X8B8G8R8_SRGB , plain, 1, 1, x8 , un8 , un8 , un8 , wzy1, srgb 115PIPE_FORMAT_B8G8R8A8_SRGB , plain, 1, 1, un8 , un8 , un8 , un8 , zyxw, srgb 116PIPE_FORMAT_B8G8R8X8_SRGB , plain, 1, 1, un8 , un8 , un8 , x8 , zyx1, srgb 117PIPE_FORMAT_A8R8G8B8_SRGB , plain, 1, 1, un8 , un8 , un8 , un8 , yzwx, srgb 118PIPE_FORMAT_X8R8G8B8_SRGB , plain, 1, 1, x8 , un8 , un8 , un8 , yzw1, srgb 119 120# Mixed-sign formats (typically used for bump map textures) 121PIPE_FORMAT_R8SG8SB8UX8U_NORM , plain, 1, 1, sn8 , sn8 , un8 , x8 , xyz1, rgb 122PIPE_FORMAT_R10SG10SB10SA2U_NORM , plain, 1, 1, sn10, sn10, sn10, un2 , xyzw, rgb 123PIPE_FORMAT_R5SG5SB6U_NORM , plain, 1, 1, sn5 , sn5 , un6 , , xyz1, rgb 124 125# Depth-stencil formats 126PIPE_FORMAT_S8_USCALED , plain, 1, 1, u8 , , , , _x__, zs 127PIPE_FORMAT_Z16_UNORM , plain, 1, 1, un16, , , , x___, zs 128PIPE_FORMAT_Z32_UNORM , plain, 1, 1, un32, , , , x___, zs 129PIPE_FORMAT_Z32_FLOAT , plain, 1, 1, f32 , , , , x___, zs 130PIPE_FORMAT_Z24_UNORM_S8_USCALED , plain, 1, 1, un24, u8 , , , xy__, zs 131PIPE_FORMAT_S8_USCALED_Z24_UNORM , plain, 1, 1, u8 , un24, , , yx__, zs 132PIPE_FORMAT_X24S8_USCALED , plain, 1, 1, x24, u8 , , , _y__, zs 133PIPE_FORMAT_S8X24_USCALED , plain, 1, 1, u8 , x24 , , , _x__, zs 134PIPE_FORMAT_Z24X8_UNORM , plain, 1, 1, un24, x8 , , , x___, zs 135PIPE_FORMAT_X8Z24_UNORM , plain, 1, 1, x8 , un24, , , y___, zs 136PIPE_FORMAT_Z32_FLOAT_S8X24_USCALED , plain, 1, 1, f32, u8 , x24 , , xy__, zs 137PIPE_FORMAT_X32_S8X24_USCALED , plain, 1, 1, x32, u8 , x24 , , _y__, zs 138 139# YUV formats 140# http://www.fourcc.org/yuv.php#UYVY 141PIPE_FORMAT_UYVY , subsampled, 2, 1, x32 , , , , xyz1, yuv 142# http://www.fourcc.org/yuv.php#YUYV (a.k.a http://www.fourcc.org/yuv.php#YUY2) 143PIPE_FORMAT_YUYV , subsampled, 2, 1, x32 , , , , xyz1, yuv 144# same subsampling but with rgb channels 145PIPE_FORMAT_R8G8_B8G8_UNORM , subsampled, 2, 1, x32 , , , , xyz1, rgb 146PIPE_FORMAT_G8R8_G8B8_UNORM , subsampled, 2, 1, x32 , , , , xyz1, rgb 147 148# some special formats not fitting anywhere else 149PIPE_FORMAT_R10G10B10A2_USCALED , plain, 1, 1, u10 , u10 , u10 , u2 , xyzw, rgb 150PIPE_FORMAT_R11G11B10_FLOAT , other, 1, 1, x32 , , , , xyz1, rgb 151PIPE_FORMAT_R9G9B9E5_FLOAT , other, 1, 1, x32 , , , , xyz1, rgb 152PIPE_FORMAT_R1_UNORM , other, 8, 1, x8 , , , , x001, rgb 153# A.k.a. D3DFMT_CxV8U8 154PIPE_FORMAT_R8G8Bx_SNORM , other, 1, 1, sn8 , sn8 , , , xyz1, rgb 155 156# Compressed formats 157# - http://en.wikipedia.org/wiki/S3_Texture_Compression 158# - http://www.opengl.org/registry/specs/EXT/texture_compression_s3tc.txt 159# - http://www.opengl.org/registry/specs/ARB/texture_compression_rgtc.txt 160# - http://www.opengl.org/registry/specs/EXT/texture_compression_latc.txt 161# - http://msdn.microsoft.com/en-us/library/bb694531.aspx 162PIPE_FORMAT_DXT1_RGB , s3tc, 4, 4, x64 , , , , xyz1, rgb 163PIPE_FORMAT_DXT1_RGBA , s3tc, 4, 4, x64 , , , , xyzw, rgb 164PIPE_FORMAT_DXT3_RGBA , s3tc, 4, 4, x128, , , , xyzw, rgb 165PIPE_FORMAT_DXT5_RGBA , s3tc, 4, 4, x128, , , , xyzw, rgb 166PIPE_FORMAT_DXT1_SRGB , s3tc, 4, 4, x64 , , , , xyz1, srgb 167PIPE_FORMAT_DXT1_SRGBA , s3tc, 4, 4, x64 , , , , xyzw, srgb 168PIPE_FORMAT_DXT3_SRGBA , s3tc, 4, 4, x128, , , , xyzw, srgb 169PIPE_FORMAT_DXT5_SRGBA , s3tc, 4, 4, x128, , , , xyzw, srgb 170 171PIPE_FORMAT_RGTC1_UNORM , rgtc, 4, 4, x64, , , , x001, rgb 172PIPE_FORMAT_RGTC1_SNORM , rgtc, 4, 4, x64, , , , x001, rgb 173PIPE_FORMAT_RGTC2_UNORM , rgtc, 4, 4, x128, , , , xy01, rgb 174PIPE_FORMAT_RGTC2_SNORM , rgtc, 4, 4, x128, , , , xy01, rgb 175 176PIPE_FORMAT_LATC1_UNORM , rgtc, 4, 4, x64, , , , xxx1, rgb 177PIPE_FORMAT_LATC1_SNORM , rgtc, 4, 4, x64, , , , xxx1, rgb 178PIPE_FORMAT_LATC2_UNORM , rgtc, 4, 4, x128, , , , xxxy, rgb 179PIPE_FORMAT_LATC2_SNORM , rgtc, 4, 4, x128, , , , xxxy, rgb 180 181# Straightforward D3D10-like formats (also used for 182# vertex buffer element description) 183# 184# See also: 185# - src/gallium/auxiliary/translate/translate_generic.c 186# - src/mesa/state_tracker/st_draw.c 187PIPE_FORMAT_R64_FLOAT , plain, 1, 1, f64 , , , , x001, rgb 188PIPE_FORMAT_R64G64_FLOAT , plain, 1, 1, f64 , f64 , , , xy01, rgb 189PIPE_FORMAT_R64G64B64_FLOAT , plain, 1, 1, f64 , f64 , f64 , , xyz1, rgb 190PIPE_FORMAT_R64G64B64A64_FLOAT , plain, 1, 1, f64 , f64 , f64 , f64 , xyzw, rgb 191PIPE_FORMAT_R32_FLOAT , plain, 1, 1, f32 , , , , x001, rgb 192PIPE_FORMAT_R32G32_FLOAT , plain, 1, 1, f32 , f32 , , , xy01, rgb 193PIPE_FORMAT_R32G32B32_FLOAT , plain, 1, 1, f32 , f32 , f32 , , xyz1, rgb 194PIPE_FORMAT_R32G32B32A32_FLOAT , plain, 1, 1, f32 , f32 , f32 , f32 , xyzw, rgb 195PIPE_FORMAT_R32_UNORM , plain, 1, 1, un32, , , , x001, rgb 196PIPE_FORMAT_R32G32_UNORM , plain, 1, 1, un32, un32, , , xy01, rgb 197PIPE_FORMAT_R32G32B32_UNORM , plain, 1, 1, un32, un32, un32, , xyz1, rgb 198PIPE_FORMAT_R32G32B32A32_UNORM , plain, 1, 1, un32, un32, un32, un32, xyzw, rgb 199PIPE_FORMAT_R32_USCALED , plain, 1, 1, u32 , , , , x001, rgb 200PIPE_FORMAT_R32G32_USCALED , plain, 1, 1, u32 , u32 , , , xy01, rgb 201PIPE_FORMAT_R32G32B32_USCALED , plain, 1, 1, u32 , u32 , u32 , , xyz1, rgb 202PIPE_FORMAT_R32G32B32A32_USCALED , plain, 1, 1, u32 , u32 , u32 , u32 , xyzw, rgb 203PIPE_FORMAT_R32_SNORM , plain, 1, 1, sn32, , , , x001, rgb 204PIPE_FORMAT_R32G32_SNORM , plain, 1, 1, sn32, sn32, , , xy01, rgb 205PIPE_FORMAT_R32G32B32_SNORM , plain, 1, 1, sn32, sn32, sn32, , xyz1, rgb 206PIPE_FORMAT_R32G32B32A32_SNORM , plain, 1, 1, sn32, sn32, sn32, sn32, xyzw, rgb 207PIPE_FORMAT_R32_SSCALED , plain, 1, 1, s32 , , , , x001, rgb 208PIPE_FORMAT_R32G32_SSCALED , plain, 1, 1, s32 , s32 , , , xy01, rgb 209PIPE_FORMAT_R32G32B32_SSCALED , plain, 1, 1, s32 , s32 , s32 , , xyz1, rgb 210PIPE_FORMAT_R32G32B32A32_SSCALED , plain, 1, 1, s32 , s32 , s32 , s32 , xyzw, rgb 211PIPE_FORMAT_R16_FLOAT , plain, 1, 1, f16 , , , , x001, rgb 212PIPE_FORMAT_R16G16_FLOAT , plain, 1, 1, f16 , f16 , , , xy01, rgb 213PIPE_FORMAT_R16G16B16_FLOAT , plain, 1, 1, f16 , f16 , f16 , , xyz1, rgb 214PIPE_FORMAT_R16G16B16A16_FLOAT , plain, 1, 1, f16 , f16 , f16 , f16 , xyzw, rgb 215PIPE_FORMAT_R16_UNORM , plain, 1, 1, un16, , , , x001, rgb 216PIPE_FORMAT_R16G16_UNORM , plain, 1, 1, un16, un16, , , xy01, rgb 217PIPE_FORMAT_R16G16B16_UNORM , plain, 1, 1, un16, un16, un16, , xyz1, rgb 218PIPE_FORMAT_R16G16B16A16_UNORM , plain, 1, 1, un16, un16, un16, un16, xyzw, rgb 219PIPE_FORMAT_R16_USCALED , plain, 1, 1, u16 , , , , x001, rgb 220PIPE_FORMAT_R16G16_USCALED , plain, 1, 1, u16 , u16 , , , xy01, rgb 221PIPE_FORMAT_R16G16B16_USCALED , plain, 1, 1, u16 , u16 , u16 , , xyz1, rgb 222PIPE_FORMAT_R16G16B16A16_USCALED , plain, 1, 1, u16 , u16 , u16 , u16 , xyzw, rgb 223PIPE_FORMAT_R16_SNORM , plain, 1, 1, sn16, , , , x001, rgb 224PIPE_FORMAT_R16G16_SNORM , plain, 1, 1, sn16, sn16, , , xy01, rgb 225PIPE_FORMAT_R16G16B16_SNORM , plain, 1, 1, sn16, sn16, sn16, , xyz1, rgb 226PIPE_FORMAT_R16G16B16A16_SNORM , plain, 1, 1, sn16, sn16, sn16, sn16, xyzw, rgb 227PIPE_FORMAT_R16_SSCALED , plain, 1, 1, s16 , , , , x001, rgb 228PIPE_FORMAT_R16G16_SSCALED , plain, 1, 1, s16 , s16 , , , xy01, rgb 229PIPE_FORMAT_R16G16B16_SSCALED , plain, 1, 1, s16 , s16 , s16 , , xyz1, rgb 230PIPE_FORMAT_R16G16B16A16_SSCALED , plain, 1, 1, s16 , s16 , s16 , s16 , xyzw, rgb 231PIPE_FORMAT_R8_UNORM , plain, 1, 1, un8 , , , , x001, rgb 232PIPE_FORMAT_R8G8_UNORM , plain, 1, 1, un8 , un8 , , , xy01, rgb 233PIPE_FORMAT_R8G8B8_UNORM , plain, 1, 1, un8 , un8 , un8 , , xyz1, rgb 234PIPE_FORMAT_R8G8B8A8_UNORM , plain, 1, 1, un8 , un8 , un8 , un8 , xyzw, rgb 235PIPE_FORMAT_R8_USCALED , plain, 1, 1, u8 , , , , x001, rgb 236PIPE_FORMAT_R8G8_USCALED , plain, 1, 1, u8 , u8 , , , xy01, rgb 237PIPE_FORMAT_R8G8B8_USCALED , plain, 1, 1, u8 , u8 , u8 , , xyz1, rgb 238PIPE_FORMAT_R8G8B8A8_USCALED , plain, 1, 1, u8 , u8 , u8 , u8 , xyzw, rgb 239PIPE_FORMAT_R8_SNORM , plain, 1, 1, sn8 , , , , x001, rgb 240PIPE_FORMAT_R8G8_SNORM , plain, 1, 1, sn8 , sn8 , , , xy01, rgb 241PIPE_FORMAT_R8G8B8_SNORM , plain, 1, 1, sn8 , sn8 , sn8 , , xyz1, rgb 242PIPE_FORMAT_R8G8B8A8_SNORM , plain, 1, 1, sn8 , sn8 , sn8 , sn8 , xyzw, rgb 243PIPE_FORMAT_R8_SSCALED , plain, 1, 1, s8 , , , , x001, rgb 244PIPE_FORMAT_R8G8_SSCALED , plain, 1, 1, s8 , s8 , , , xy01, rgb 245PIPE_FORMAT_R8G8B8_SSCALED , plain, 1, 1, s8 , s8 , s8 , , xyz1, rgb 246PIPE_FORMAT_R8G8B8A8_SSCALED , plain, 1, 1, s8 , s8 , s8 , s8 , xyzw, rgb 247 248# GL-specific vertex buffer element formats 249# A.k.a. GL_FIXED 250PIPE_FORMAT_R32_FIXED , plain, 1, 1, h32 , , , , x001, rgb 251PIPE_FORMAT_R32G32_FIXED , plain, 1, 1, h32 , h32 , , , xy01, rgb 252PIPE_FORMAT_R32G32B32_FIXED , plain, 1, 1, h32 , h32 , h32 , , xyz1, rgb 253PIPE_FORMAT_R32G32B32A32_FIXED , plain, 1, 1, h32 , h32 , h32 , h32 , xyzw, rgb 254 255# D3D9-specific vertex buffer element formats 256# See also: 257# - http://msdn.microsoft.com/en-us/library/bb172533.aspx 258# A.k.a. D3DDECLTYPE_UDEC3 259PIPE_FORMAT_R10G10B10X2_USCALED , plain, 1, 1, u10 , u10 , u10 , x2 , xyz1, rgb 260# A.k.a. D3DDECLTYPE_DEC3N 261PIPE_FORMAT_R10G10B10X2_SNORM , plain, 1, 1, sn10, sn10, sn10 , x2 , xyz1, rgb 262