2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (c) 2008-2009 VMware, Inc.
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:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
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.
38 /* OpenGL doesn't have GL_UNSIGNED_BYTE_4_4, so we must define our own type
39 * for GL_LUMINANCE4_ALPHA4. */
40 #define MESA_UNSIGNED_BYTE_4_4 (GL_UNSIGNED_BYTE<<1)
44 * Mesa texture/renderbuffer image formats.
51 * \name Basic hardware formats
54 /* msb <------ TEXEL BITS -----------> lsb */
55 /* ---- ---- ---- ---- ---- ---- ---- ---- */
56 MESA_FORMAT_RGBA8888, /* RRRR RRRR GGGG GGGG BBBB BBBB AAAA AAAA */
57 MESA_FORMAT_RGBA8888_REV, /* AAAA AAAA BBBB BBBB GGGG GGGG RRRR RRRR */
58 MESA_FORMAT_ARGB8888, /* AAAA AAAA RRRR RRRR GGGG GGGG BBBB BBBB */
59 MESA_FORMAT_ARGB8888_REV, /* BBBB BBBB GGGG GGGG RRRR RRRR AAAA AAAA */
60 MESA_FORMAT_XRGB8888, /* xxxx xxxx RRRR RRRR GGGG GGGG BBBB BBBB */
61 MESA_FORMAT_XRGB8888_REV, /* BBBB BBBB GGGG GGGG RRRR RRRR xxxx xxxx */
62 MESA_FORMAT_RGB888, /* RRRR RRRR GGGG GGGG BBBB BBBB */
63 MESA_FORMAT_BGR888, /* BBBB BBBB GGGG GGGG RRRR RRRR */
64 MESA_FORMAT_RGB565, /* RRRR RGGG GGGB BBBB */
65 MESA_FORMAT_RGB565_REV, /* GGGB BBBB RRRR RGGG */
66 MESA_FORMAT_ARGB4444, /* AAAA RRRR GGGG BBBB */
67 MESA_FORMAT_ARGB4444_REV, /* GGGG BBBB AAAA RRRR */
68 MESA_FORMAT_RGBA5551, /* RRRR RGGG GGBB BBBA */
69 MESA_FORMAT_ARGB1555, /* ARRR RRGG GGGB BBBB */
70 MESA_FORMAT_ARGB1555_REV, /* GGGB BBBB ARRR RRGG */
71 MESA_FORMAT_AL44, /* AAAA LLLL */
72 MESA_FORMAT_AL88, /* AAAA AAAA LLLL LLLL */
73 MESA_FORMAT_AL88_REV, /* LLLL LLLL AAAA AAAA */
74 MESA_FORMAT_AL1616, /* AAAA AAAA AAAA AAAA LLLL LLLL LLLL LLLL */
75 MESA_FORMAT_AL1616_REV, /* LLLL LLLL LLLL LLLL AAAA AAAA AAAA AAAA */
76 MESA_FORMAT_RGB332, /* RRRG GGBB */
77 MESA_FORMAT_A8, /* AAAA AAAA */
78 MESA_FORMAT_A16, /* AAAA AAAA AAAA AAAA */
79 MESA_FORMAT_L8, /* LLLL LLLL */
80 MESA_FORMAT_L16, /* LLLL LLLL LLLL LLLL */
81 MESA_FORMAT_I8, /* IIII IIII */
82 MESA_FORMAT_I16, /* IIII IIII IIII IIII */
83 MESA_FORMAT_YCBCR, /* YYYY YYYY UorV UorV */
84 MESA_FORMAT_YCBCR_REV, /* UorV UorV YYYY YYYY */
85 MESA_FORMAT_R8, /* RRRR RRRR */
86 MESA_FORMAT_RG88, /* RRRR RRRR GGGG GGGG */
87 MESA_FORMAT_RG88_REV, /* GGGG GGGG RRRR RRRR */
88 MESA_FORMAT_R16, /* RRRR RRRR RRRR RRRR */
89 MESA_FORMAT_RG1616, /* RRRR RRRR RRRR RRRR GGGG GGGG GGGG GGGG */
90 MESA_FORMAT_RG1616_REV, /* GGGG GGGG GGGG GGGG RRRR RRRR RRRR RRRR */
91 MESA_FORMAT_ARGB2101010, /* AARR RRRR RRRR GGGG GGGG GGBB BBBB BBBB */
92 MESA_FORMAT_Z24_S8, /* ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ SSSS SSSS */
93 MESA_FORMAT_S8_Z24, /* SSSS SSSS ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ */
94 MESA_FORMAT_Z16, /* ZZZZ ZZZZ ZZZZ ZZZZ */
95 MESA_FORMAT_X8_Z24, /* xxxx xxxx ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ */
96 MESA_FORMAT_Z24_X8, /* ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ xxxx xxxx */
97 MESA_FORMAT_Z32, /* ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ ZZZZ */
98 MESA_FORMAT_S8, /* SSSS SSSS */
102 * \name 8-bit/channel sRGB formats
110 MESA_FORMAT_SRGB_DXT1,
111 MESA_FORMAT_SRGBA_DXT1,
112 MESA_FORMAT_SRGBA_DXT3,
113 MESA_FORMAT_SRGBA_DXT5,
117 * \name Compressed texture formats.
120 MESA_FORMAT_RGB_FXT1,
121 MESA_FORMAT_RGBA_FXT1,
122 MESA_FORMAT_RGB_DXT1,
123 MESA_FORMAT_RGBA_DXT1,
124 MESA_FORMAT_RGBA_DXT3,
125 MESA_FORMAT_RGBA_DXT5,
129 * \name Floating point texture formats.
132 MESA_FORMAT_RGBA_FLOAT32,
133 MESA_FORMAT_RGBA_FLOAT16,
134 MESA_FORMAT_RGB_FLOAT32,
135 MESA_FORMAT_RGB_FLOAT16,
136 MESA_FORMAT_ALPHA_FLOAT32,
137 MESA_FORMAT_ALPHA_FLOAT16,
138 MESA_FORMAT_LUMINANCE_FLOAT32,
139 MESA_FORMAT_LUMINANCE_FLOAT16,
140 MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32,
141 MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16,
142 MESA_FORMAT_INTENSITY_FLOAT32,
143 MESA_FORMAT_INTENSITY_FLOAT16,
144 MESA_FORMAT_R_FLOAT32,
145 MESA_FORMAT_R_FLOAT16,
146 MESA_FORMAT_RG_FLOAT32,
147 MESA_FORMAT_RG_FLOAT16,
151 * \name Non-normalized signed integer formats.
152 * XXX Note: these are just stand-ins for some better hardware
153 * formats TBD such as BGRA or ARGB.
155 MESA_FORMAT_ALPHA_UINT8,
156 MESA_FORMAT_ALPHA_UINT16,
157 MESA_FORMAT_ALPHA_UINT32,
158 MESA_FORMAT_ALPHA_INT8,
159 MESA_FORMAT_ALPHA_INT16,
160 MESA_FORMAT_ALPHA_INT32,
162 MESA_FORMAT_INTENSITY_UINT8,
163 MESA_FORMAT_INTENSITY_UINT16,
164 MESA_FORMAT_INTENSITY_UINT32,
165 MESA_FORMAT_INTENSITY_INT8,
166 MESA_FORMAT_INTENSITY_INT16,
167 MESA_FORMAT_INTENSITY_INT32,
169 MESA_FORMAT_LUMINANCE_UINT8,
170 MESA_FORMAT_LUMINANCE_UINT16,
171 MESA_FORMAT_LUMINANCE_UINT32,
172 MESA_FORMAT_LUMINANCE_INT8,
173 MESA_FORMAT_LUMINANCE_INT16,
174 MESA_FORMAT_LUMINANCE_INT32,
176 MESA_FORMAT_LUMINANCE_ALPHA_UINT8,
177 MESA_FORMAT_LUMINANCE_ALPHA_UINT16,
178 MESA_FORMAT_LUMINANCE_ALPHA_UINT32,
179 MESA_FORMAT_LUMINANCE_ALPHA_INT8,
180 MESA_FORMAT_LUMINANCE_ALPHA_INT16,
181 MESA_FORMAT_LUMINANCE_ALPHA_INT32,
185 MESA_FORMAT_RGB_INT8,
186 MESA_FORMAT_RGBA_INT8,
188 MESA_FORMAT_RG_INT16,
189 MESA_FORMAT_RGB_INT16,
190 MESA_FORMAT_RGBA_INT16,
192 MESA_FORMAT_RG_INT32,
193 MESA_FORMAT_RGB_INT32,
194 MESA_FORMAT_RGBA_INT32,
197 * \name Non-normalized unsigned integer formats.
200 MESA_FORMAT_RG_UINT8,
201 MESA_FORMAT_RGB_UINT8,
202 MESA_FORMAT_RGBA_UINT8,
203 MESA_FORMAT_R_UINT16,
204 MESA_FORMAT_RG_UINT16,
205 MESA_FORMAT_RGB_UINT16,
206 MESA_FORMAT_RGBA_UINT16,
207 MESA_FORMAT_R_UINT32,
208 MESA_FORMAT_RG_UINT32,
209 MESA_FORMAT_RGB_UINT32,
210 MESA_FORMAT_RGBA_UINT32,
212 /* msb <------ TEXEL BITS -----------> lsb */
213 /* ---- ---- ---- ---- ---- ---- ---- ---- */
215 * \name Signed fixed point texture formats.
218 MESA_FORMAT_DUDV8, /* DUDU DUDU DVDV DVDV */
219 MESA_FORMAT_SIGNED_R8, /* RRRR RRRR */
220 MESA_FORMAT_SIGNED_RG88_REV, /* GGGG GGGG RRRR RRRR */
221 MESA_FORMAT_SIGNED_RGBX8888, /* RRRR RRRR GGGG GGGG BBBB BBBB xxxx xxxx */
222 MESA_FORMAT_SIGNED_RGBA8888, /* RRRR RRRR GGGG GGGG BBBB BBBB AAAA AAAA */
223 MESA_FORMAT_SIGNED_RGBA8888_REV,/*AAAA AAAA BBBB BBBB GGGG GGGG RRRR RRRR */
224 MESA_FORMAT_SIGNED_R16, /* RRRR RRRR RRRR RRRR */
225 MESA_FORMAT_SIGNED_GR1616, /* GGGG GGGG GGGG GGGG RRRR RRRR RRRR RRRR */
226 MESA_FORMAT_SIGNED_RGB_16, /* ushort[0]=R, ushort[1]=G, ushort[2]=B */
227 MESA_FORMAT_SIGNED_RGBA_16, /* ... */
228 MESA_FORMAT_RGBA_16, /* ... */
232 MESA_FORMAT_RED_RGTC1,
233 MESA_FORMAT_SIGNED_RED_RGTC1,
234 MESA_FORMAT_RG_RGTC2,
235 MESA_FORMAT_SIGNED_RG_RGTC2,
240 MESA_FORMAT_SIGNED_L_LATC1,
241 MESA_FORMAT_LA_LATC2,
242 MESA_FORMAT_SIGNED_LA_LATC2,
245 MESA_FORMAT_SIGNED_A8, /* AAAA AAAA */
246 MESA_FORMAT_SIGNED_L8, /* LLLL LLLL */
247 MESA_FORMAT_SIGNED_AL88, /* AAAA AAAA LLLL LLLL */
248 MESA_FORMAT_SIGNED_I8, /* IIII IIII */
249 MESA_FORMAT_SIGNED_A16, /* AAAA AAAA AAAA AAAA */
250 MESA_FORMAT_SIGNED_L16, /* LLLL LLLL LLLL LLLL */
251 MESA_FORMAT_SIGNED_AL1616, /* AAAA AAAA AAAA AAAA LLLL LLLL LLLL LLLL */
252 MESA_FORMAT_SIGNED_I16, /* IIII IIII IIII IIII */
254 MESA_FORMAT_RGB9_E5_FLOAT,
255 MESA_FORMAT_R11_G11_B10_FLOAT,
257 MESA_FORMAT_Z32_FLOAT,
258 MESA_FORMAT_Z32_FLOAT_X24S8,
265 _mesa_get_format_name(gl_format format);
268 _mesa_get_format_bytes(gl_format format);
271 _mesa_get_format_bits(gl_format format, GLenum pname);
274 _mesa_get_format_datatype(gl_format format);
277 _mesa_get_format_base_format(gl_format format);
280 _mesa_get_format_block_size(gl_format format, GLuint *bw, GLuint *bh);
283 _mesa_is_format_compressed(gl_format format);
286 _mesa_is_format_packed_depth_stencil(gl_format format);
289 _mesa_is_format_integer_color(gl_format format);
292 _mesa_get_format_color_encoding(gl_format format);
295 _mesa_format_image_size(gl_format format, GLsizei width,
296 GLsizei height, GLsizei depth);
299 _mesa_format_image_size64(gl_format format, GLsizei width,
300 GLsizei height, GLsizei depth);
303 _mesa_format_row_stride(gl_format format, GLsizei width);
306 _mesa_format_to_type_and_comps(gl_format format,
307 GLenum *datatype, GLuint *comps);
310 _mesa_test_formats(void);
313 _mesa_get_srgb_format_linear(gl_format format);
316 _mesa_get_uncompressed_format(gl_format format);
319 _mesa_format_num_components(gl_format format);
322 #endif /* FORMATS_H */