projects / mesa.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
Merge remote branch 'origin/master' into pipe-video
[mesa.git] / src / mesa / main / formats.c
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.7
4 *
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (c) 2008-2009 VMware, Inc.
7 *
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:
14 *
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions 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 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.
24 */
25
26
27 #include "imports.h"
28 #include "formats.h"
29 #include "mfeatures.h"
30
31
32 /**
33 * Information about texture formats.
34 */
35 struct gl_format_info
36 {
37 gl_format Name;
38
39 /** text name for debugging */
40 const char *StrName;
41
42 /**
43 * Base format is one of GL_RED, GL_RG, GL_RGB, GL_RGBA, GL_ALPHA,
44 * GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_INTENSITY, GL_YCBCR_MESA,
45 * GL_COLOR_INDEX, GL_DEPTH_COMPONENT, GL_STENCIL_INDEX,
46 * GL_DEPTH_STENCIL, GL_DUDV_ATI.
47 */
48 GLenum BaseFormat;
49
50 /**
51 * Logical data type: one of GL_UNSIGNED_NORMALIZED, GL_SIGNED_NORMALED,
52 * GL_UNSIGNED_INT, GL_INT, GL_FLOAT.
53 */
54 GLenum DataType;
55
56 GLubyte RedBits;
57 GLubyte GreenBits;
58 GLubyte BlueBits;
59 GLubyte AlphaBits;
60 GLubyte LuminanceBits;
61 GLubyte IntensityBits;
62 GLubyte IndexBits;
63 GLubyte DepthBits;
64 GLubyte StencilBits;
65
66 /**
67 * To describe compressed formats. If not compressed, Width=Height=1.
68 */
69 GLubyte BlockWidth, BlockHeight;
70 GLubyte BytesPerBlock;
71 };
72
73
74 /**
75 * Info about each format.
76 * These must be in the same order as the MESA_FORMAT_* enums so that
77 * we can do lookups without searching.
78 */
79 static struct gl_format_info format_info[MESA_FORMAT_COUNT] =
80 {
81 {
82 MESA_FORMAT_NONE, /* Name */
83 "MESA_FORMAT_NONE", /* StrName */
84 GL_NONE, /* BaseFormat */
85 GL_NONE, /* DataType */
86 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
87 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
88 0, 0, 0 /* BlockWidth/Height,Bytes */
89 },
90 {
91 MESA_FORMAT_RGBA8888, /* Name */
92 "MESA_FORMAT_RGBA8888", /* StrName */
93 GL_RGBA, /* BaseFormat */
94 GL_UNSIGNED_NORMALIZED, /* DataType */
95 8, 8, 8, 8, /* Red/Green/Blue/AlphaBits */
96 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
97 1, 1, 4 /* BlockWidth/Height,Bytes */
98 },
99 {
100 MESA_FORMAT_RGBA8888_REV, /* Name */
101 "MESA_FORMAT_RGBA8888_REV", /* StrName */
102 GL_RGBA, /* BaseFormat */
103 GL_UNSIGNED_NORMALIZED, /* DataType */
104 8, 8, 8, 8, /* Red/Green/Blue/AlphaBits */
105 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
106 1, 1, 4 /* BlockWidth/Height,Bytes */
107 },
108 {
109 MESA_FORMAT_ARGB8888, /* Name */
110 "MESA_FORMAT_ARGB8888", /* StrName */
111 GL_RGBA, /* BaseFormat */
112 GL_UNSIGNED_NORMALIZED, /* DataType */
113 8, 8, 8, 8, /* Red/Green/Blue/AlphaBits */
114 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
115 1, 1, 4 /* BlockWidth/Height,Bytes */
116 },
117 {
118 MESA_FORMAT_ARGB8888_REV, /* Name */
119 "MESA_FORMAT_ARGB8888_REV", /* StrName */
120 GL_RGBA, /* BaseFormat */
121 GL_UNSIGNED_NORMALIZED, /* DataType */
122 8, 8, 8, 8, /* Red/Green/Blue/AlphaBits */
123 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
124 1, 1, 4 /* BlockWidth/Height,Bytes */
125 },
126 {
127 MESA_FORMAT_XRGB8888, /* Name */
128 "MESA_FORMAT_XRGB8888", /* StrName */
129 GL_RGB, /* BaseFormat */
130 GL_UNSIGNED_NORMALIZED, /* DataType */
131 8, 8, 8, 0, /* Red/Green/Blue/AlphaBits */
132 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
133 1, 1, 4 /* BlockWidth/Height,Bytes */
134 },
135 {
136 MESA_FORMAT_XRGB8888_REV, /* Name */
137 "MESA_FORMAT_XRGB8888_REV", /* StrName */
138 GL_RGB, /* BaseFormat */
139 GL_UNSIGNED_NORMALIZED, /* DataType */
140 8, 8, 8, 0, /* Red/Green/Blue/AlphaBits */
141 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
142 1, 1, 4 /* BlockWidth/Height,Bytes */
143 },
144 {
145 MESA_FORMAT_RGB888, /* Name */
146 "MESA_FORMAT_RGB888", /* StrName */
147 GL_RGB, /* BaseFormat */
148 GL_UNSIGNED_NORMALIZED, /* DataType */
149 8, 8, 8, 0, /* Red/Green/Blue/AlphaBits */
150 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
151 1, 1, 3 /* BlockWidth/Height,Bytes */
152 },
153 {
154 MESA_FORMAT_BGR888, /* Name */
155 "MESA_FORMAT_BGR888", /* StrName */
156 GL_RGB, /* BaseFormat */
157 GL_UNSIGNED_NORMALIZED, /* DataType */
158 8, 8, 8, 0, /* Red/Green/Blue/AlphaBits */
159 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
160 1, 1, 3 /* BlockWidth/Height,Bytes */
161 },
162 {
163 MESA_FORMAT_RGB565, /* Name */
164 "MESA_FORMAT_RGB565", /* StrName */
165 GL_RGB, /* BaseFormat */
166 GL_UNSIGNED_NORMALIZED, /* DataType */
167 5, 6, 5, 0, /* Red/Green/Blue/AlphaBits */
168 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
169 1, 1, 2 /* BlockWidth/Height,Bytes */
170 },
171 {
172 MESA_FORMAT_RGB565_REV, /* Name */
173 "MESA_FORMAT_RGB565_REV", /* StrName */
174 GL_RGB, /* BaseFormat */
175 GL_UNSIGNED_NORMALIZED, /* DataType */
176 5, 6, 5, 0, /* Red/Green/Blue/AlphaBits */
177 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
178 1, 1, 2 /* BlockWidth/Height,Bytes */
179 },
180 {
181 MESA_FORMAT_ARGB4444, /* Name */
182 "MESA_FORMAT_ARGB4444", /* StrName */
183 GL_RGBA, /* BaseFormat */
184 GL_UNSIGNED_NORMALIZED, /* DataType */
185 4, 4, 4, 4, /* Red/Green/Blue/AlphaBits */
186 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
187 1, 1, 2 /* BlockWidth/Height,Bytes */
188 },
189 {
190 MESA_FORMAT_ARGB4444_REV, /* Name */
191 "MESA_FORMAT_ARGB4444_REV", /* StrName */
192 GL_RGBA, /* BaseFormat */
193 GL_UNSIGNED_NORMALIZED, /* DataType */
194 4, 4, 4, 4, /* Red/Green/Blue/AlphaBits */
195 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
196 1, 1, 2 /* BlockWidth/Height,Bytes */
197 },
198 {
199 MESA_FORMAT_RGBA5551, /* Name */
200 "MESA_FORMAT_RGBA5551", /* StrName */
201 GL_RGBA, /* BaseFormat */
202 GL_UNSIGNED_NORMALIZED, /* DataType */
203 5, 5, 5, 1, /* Red/Green/Blue/AlphaBits */
204 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
205 1, 1, 2 /* BlockWidth/Height,Bytes */
206 },
207 {
208 MESA_FORMAT_ARGB1555, /* Name */
209 "MESA_FORMAT_ARGB1555", /* StrName */
210 GL_RGBA, /* BaseFormat */
211 GL_UNSIGNED_NORMALIZED, /* DataType */
212 5, 5, 5, 1, /* Red/Green/Blue/AlphaBits */
213 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
214 1, 1, 2 /* BlockWidth/Height,Bytes */
215 },
216 {
217 MESA_FORMAT_ARGB1555_REV, /* Name */
218 "MESA_FORMAT_ARGB1555_REV", /* StrName */
219 GL_RGBA, /* BaseFormat */
220 GL_UNSIGNED_NORMALIZED, /* DataType */
221 5, 5, 5, 1, /* Red/Green/Blue/AlphaBits */
222 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
223 1, 1, 2 /* BlockWidth/Height,Bytes */
224 },
225 {
226 MESA_FORMAT_AL44, /* Name */
227 "MESA_FORMAT_AL44", /* StrName */
228 GL_LUMINANCE_ALPHA, /* BaseFormat */
229 GL_UNSIGNED_NORMALIZED, /* DataType */
230 0, 0, 0, 4, /* Red/Green/Blue/AlphaBits */
231 4, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
232 1, 1, 1 /* BlockWidth/Height,Bytes */
233 },
234 {
235 MESA_FORMAT_AL88, /* Name */
236 "MESA_FORMAT_AL88", /* StrName */
237 GL_LUMINANCE_ALPHA, /* BaseFormat */
238 GL_UNSIGNED_NORMALIZED, /* DataType */
239 0, 0, 0, 8, /* Red/Green/Blue/AlphaBits */
240 8, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
241 1, 1, 2 /* BlockWidth/Height,Bytes */
242 },
243 {
244 MESA_FORMAT_AL88_REV, /* Name */
245 "MESA_FORMAT_AL88_REV", /* StrName */
246 GL_LUMINANCE_ALPHA, /* BaseFormat */
247 GL_UNSIGNED_NORMALIZED, /* DataType */
248 0, 0, 0, 8, /* Red/Green/Blue/AlphaBits */
249 8, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
250 1, 1, 2 /* BlockWidth/Height,Bytes */
251 },
252 {
253 MESA_FORMAT_AL1616, /* Name */
254 "MESA_FORMAT_AL1616", /* StrName */
255 GL_LUMINANCE_ALPHA, /* BaseFormat */
256 GL_UNSIGNED_NORMALIZED, /* DataType */
257 0, 0, 0, 16, /* Red/Green/Blue/AlphaBits */
258 16, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
259 1, 1, 4 /* BlockWidth/Height,Bytes */
260 },
261 {
262 MESA_FORMAT_AL1616_REV, /* Name */
263 "MESA_FORMAT_AL1616_REV", /* StrName */
264 GL_LUMINANCE_ALPHA, /* BaseFormat */
265 GL_UNSIGNED_NORMALIZED, /* DataType */
266 0, 0, 0, 16, /* Red/Green/Blue/AlphaBits */
267 16, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
268 1, 1, 4 /* BlockWidth/Height,Bytes */
269 },
270 {
271 MESA_FORMAT_RGB332, /* Name */
272 "MESA_FORMAT_RGB332", /* StrName */
273 GL_RGB, /* BaseFormat */
274 GL_UNSIGNED_NORMALIZED, /* DataType */
275 3, 3, 2, 0, /* Red/Green/Blue/AlphaBits */
276 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
277 1, 1, 1 /* BlockWidth/Height,Bytes */
278 },
279 {
280 MESA_FORMAT_A8, /* Name */
281 "MESA_FORMAT_A8", /* StrName */
282 GL_ALPHA, /* BaseFormat */
283 GL_UNSIGNED_NORMALIZED, /* DataType */
284 0, 0, 0, 8, /* Red/Green/Blue/AlphaBits */
285 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
286 1, 1, 1 /* BlockWidth/Height,Bytes */
287 },
288 {
289 MESA_FORMAT_A16, /* Name */
290 "MESA_FORMAT_A16", /* StrName */
291 GL_ALPHA, /* BaseFormat */
292 GL_UNSIGNED_NORMALIZED, /* DataType */
293 0, 0, 0, 16, /* Red/Green/Blue/AlphaBits */
294 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
295 1, 1, 2 /* BlockWidth/Height,Bytes */
296 },
297 {
298 MESA_FORMAT_L8, /* Name */
299 "MESA_FORMAT_L8", /* StrName */
300 GL_LUMINANCE, /* BaseFormat */
301 GL_UNSIGNED_NORMALIZED, /* DataType */
302 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
303 8, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
304 1, 1, 1 /* BlockWidth/Height,Bytes */
305 },
306 {
307 MESA_FORMAT_L16, /* Name */
308 "MESA_FORMAT_L16", /* StrName */
309 GL_LUMINANCE, /* BaseFormat */
310 GL_UNSIGNED_NORMALIZED, /* DataType */
311 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
312 16, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
313 1, 1, 2 /* BlockWidth/Height,Bytes */
314 },
315 {
316 MESA_FORMAT_I8, /* Name */
317 "MESA_FORMAT_I8", /* StrName */
318 GL_INTENSITY, /* BaseFormat */
319 GL_UNSIGNED_NORMALIZED, /* DataType */
320 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
321 0, 8, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
322 1, 1, 1 /* BlockWidth/Height,Bytes */
323 },
324 {
325 MESA_FORMAT_I16, /* Name */
326 "MESA_FORMAT_I16", /* StrName */
327 GL_INTENSITY, /* BaseFormat */
328 GL_UNSIGNED_NORMALIZED, /* DataType */
329 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
330 0, 16, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
331 1, 1, 2 /* BlockWidth/Height,Bytes */
332 },
333 {
334 MESA_FORMAT_CI8, /* Name */
335 "MESA_FORMAT_CI8", /* StrName */
336 GL_COLOR_INDEX, /* BaseFormat */
337 GL_UNSIGNED_INT, /* DataType */
338 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
339 0, 0, 8, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
340 1, 1, 1 /* BlockWidth/Height,Bytes */
341 },
342 {
343 MESA_FORMAT_YCBCR, /* Name */
344 "MESA_FORMAT_YCBCR", /* StrName */
345 GL_YCBCR_MESA, /* BaseFormat */
346 GL_UNSIGNED_NORMALIZED, /* DataType */
347 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
348 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
349 1, 1, 2 /* BlockWidth/Height,Bytes */
350 },
351 {
352 MESA_FORMAT_YCBCR_REV, /* Name */
353 "MESA_FORMAT_YCBCR_REV", /* StrName */
354 GL_YCBCR_MESA, /* BaseFormat */
355 GL_UNSIGNED_NORMALIZED, /* DataType */
356 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
357 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
358 1, 1, 2 /* BlockWidth/Height,Bytes */
359 },
360 {
361 MESA_FORMAT_R8,
362 "MESA_FORMAT_R8",
363 GL_RED,
364 GL_UNSIGNED_NORMALIZED,
365 8, 0, 0, 0,
366 0, 0, 0, 0, 0,
367 1, 1, 1
368 },
369 {
370 MESA_FORMAT_RG88,
371 "MESA_FORMAT_RG88",
372 GL_RG,
373 GL_UNSIGNED_NORMALIZED,
374 8, 8, 0, 0,
375 0, 0, 0, 0, 0,
376 1, 1, 2
377 },
378 {
379 MESA_FORMAT_RG88_REV,
380 "MESA_FORMAT_RG88_REV",
381 GL_RG,
382 GL_UNSIGNED_NORMALIZED,
383 8, 8, 0, 0,
384 0, 0, 0, 0, 0,
385 1, 1, 2
386 },
387 {
388 MESA_FORMAT_R16,
389 "MESA_FORMAT_R16",
390 GL_RED,
391 GL_UNSIGNED_NORMALIZED,
392 16, 0, 0, 0,
393 0, 0, 0, 0, 0,
394 1, 1, 2
395 },
396 {
397 MESA_FORMAT_RG1616,
398 "MESA_FORMAT_RG1616",
399 GL_RG,
400 GL_UNSIGNED_NORMALIZED,
401 16, 16, 0, 0,
402 0, 0, 0, 0, 0,
403 1, 1, 4
404 },
405 {
406 MESA_FORMAT_RG1616_REV,
407 "MESA_FORMAT_RG1616_REV",
408 GL_RG,
409 GL_UNSIGNED_NORMALIZED,
410 16, 16, 0, 0,
411 0, 0, 0, 0, 0,
412 1, 1, 4
413 },
414 {
415 MESA_FORMAT_ARGB2101010,
416 "MESA_FORMAT_ARGB2101010",
417 GL_RGBA,
418 GL_UNSIGNED_NORMALIZED,
419 10, 10, 10, 2,
420 0, 0, 0, 0, 0,
421 1, 1, 4
422 },
423 {
424 MESA_FORMAT_Z24_S8, /* Name */
425 "MESA_FORMAT_Z24_S8", /* StrName */
426 GL_DEPTH_STENCIL, /* BaseFormat */
427 GL_UNSIGNED_INT, /* DataType */
428 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
429 0, 0, 0, 24, 8, /* Lum/Int/Index/Depth/StencilBits */
430 1, 1, 4 /* BlockWidth/Height,Bytes */
431 },
432 {
433 MESA_FORMAT_S8_Z24, /* Name */
434 "MESA_FORMAT_S8_Z24", /* StrName */
435 GL_DEPTH_STENCIL, /* BaseFormat */
436 GL_UNSIGNED_INT, /* DataType */
437 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
438 0, 0, 0, 24, 8, /* Lum/Int/Index/Depth/StencilBits */
439 1, 1, 4 /* BlockWidth/Height,Bytes */
440 },
441 {
442 MESA_FORMAT_Z16, /* Name */
443 "MESA_FORMAT_Z16", /* StrName */
444 GL_DEPTH_COMPONENT, /* BaseFormat */
445 GL_UNSIGNED_INT, /* DataType */
446 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
447 0, 0, 0, 16, 0, /* Lum/Int/Index/Depth/StencilBits */
448 1, 1, 2 /* BlockWidth/Height,Bytes */
449 },
450 {
451 MESA_FORMAT_X8_Z24, /* Name */
452 "MESA_FORMAT_X8_Z24", /* StrName */
453 GL_DEPTH_COMPONENT, /* BaseFormat */
454 GL_UNSIGNED_INT, /* DataType */
455 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
456 0, 0, 0, 24, 0, /* Lum/Int/Index/Depth/StencilBits */
457 1, 1, 4 /* BlockWidth/Height,Bytes */
458 },
459 {
460 MESA_FORMAT_Z24_X8, /* Name */
461 "MESA_FORMAT_Z24_X8", /* StrName */
462 GL_DEPTH_COMPONENT, /* BaseFormat */
463 GL_UNSIGNED_INT, /* DataType */
464 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
465 0, 0, 0, 24, 0, /* Lum/Int/Index/Depth/StencilBits */
466 1, 1, 4 /* BlockWidth/Height,Bytes */
467 },
468 {
469 MESA_FORMAT_Z32, /* Name */
470 "MESA_FORMAT_Z32", /* StrName */
471 GL_DEPTH_COMPONENT, /* BaseFormat */
472 GL_UNSIGNED_INT, /* DataType */
473 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
474 0, 0, 0, 32, 0, /* Lum/Int/Index/Depth/StencilBits */
475 1, 1, 4 /* BlockWidth/Height,Bytes */
476 },
477 {
478 MESA_FORMAT_S8, /* Name */
479 "MESA_FORMAT_S8", /* StrName */
480 GL_STENCIL_INDEX, /* BaseFormat */
481 GL_UNSIGNED_INT, /* DataType */
482 0, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
483 0, 0, 0, 0, 8, /* Lum/Int/Index/Depth/StencilBits */
484 1, 1, 1 /* BlockWidth/Height,Bytes */
485 },
486 {
487 MESA_FORMAT_SRGB8,
488 "MESA_FORMAT_SRGB8",
489 GL_RGB,
490 GL_UNSIGNED_NORMALIZED,
491 8, 8, 8, 0,
492 0, 0, 0, 0, 0,
493 1, 1, 3
494 },
495 {
496 MESA_FORMAT_SRGBA8,
497 "MESA_FORMAT_SRGBA8",
498 GL_RGBA,
499 GL_UNSIGNED_NORMALIZED,
500 8, 8, 8, 8,
501 0, 0, 0, 0, 0,
502 1, 1, 4
503 },
504 {
505 MESA_FORMAT_SARGB8,
506 "MESA_FORMAT_SARGB8",
507 GL_RGBA,
508 GL_UNSIGNED_NORMALIZED,
509 8, 8, 8, 8,
510 0, 0, 0, 0, 0,
511 1, 1, 4
512 },
513 {
514 MESA_FORMAT_SL8,
515 "MESA_FORMAT_SL8",
516 GL_LUMINANCE,
517 GL_UNSIGNED_NORMALIZED,
518 0, 0, 0, 0,
519 8, 0, 0, 0, 0,
520 1, 1, 1
521 },
522 {
523 MESA_FORMAT_SLA8,
524 "MESA_FORMAT_SLA8",
525 GL_LUMINANCE_ALPHA,
526 GL_UNSIGNED_NORMALIZED,
527 0, 0, 0, 8,
528 8, 0, 0, 0, 0,
529 1, 1, 2
530 },
531 {
532 MESA_FORMAT_SRGB_DXT1, /* Name */
533 "MESA_FORMAT_SRGB_DXT1", /* StrName */
534 GL_RGB, /* BaseFormat */
535 GL_UNSIGNED_NORMALIZED, /* DataType */
536 4, 4, 4, 0, /* approx Red/Green/Blue/AlphaBits */
537 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
538 4, 4, 8 /* 8 bytes per 4x4 block */
539 },
540 {
541 MESA_FORMAT_SRGBA_DXT1,
542 "MESA_FORMAT_SRGBA_DXT1",
543 GL_RGBA,
544 GL_UNSIGNED_NORMALIZED,
545 4, 4, 4, 4,
546 0, 0, 0, 0, 0,
547 4, 4, 8 /* 8 bytes per 4x4 block */
548 },
549 {
550 MESA_FORMAT_SRGBA_DXT3,
551 "MESA_FORMAT_SRGBA_DXT3",
552 GL_RGBA,
553 GL_UNSIGNED_NORMALIZED,
554 4, 4, 4, 4,
555 0, 0, 0, 0, 0,
556 4, 4, 16 /* 16 bytes per 4x4 block */
557 },
558 {
559 MESA_FORMAT_SRGBA_DXT5,
560 "MESA_FORMAT_SRGBA_DXT5",
561 GL_RGBA,
562 GL_UNSIGNED_NORMALIZED,
563 4, 4, 4, 4,
564 0, 0, 0, 0, 0,
565 4, 4, 16 /* 16 bytes per 4x4 block */
566 },
567
568 {
569 MESA_FORMAT_RGB_FXT1,
570 "MESA_FORMAT_RGB_FXT1",
571 GL_RGB,
572 GL_UNSIGNED_NORMALIZED,
573 4, 4, 4, 0, /* approx Red/Green/BlueBits */
574 0, 0, 0, 0, 0,
575 8, 4, 16 /* 16 bytes per 8x4 block */
576 },
577 {
578 MESA_FORMAT_RGBA_FXT1,
579 "MESA_FORMAT_RGBA_FXT1",
580 GL_RGBA,
581 GL_UNSIGNED_NORMALIZED,
582 4, 4, 4, 1, /* approx Red/Green/Blue/AlphaBits */
583 0, 0, 0, 0, 0,
584 8, 4, 16 /* 16 bytes per 8x4 block */
585 },
586
587 {
588 MESA_FORMAT_RGB_DXT1, /* Name */
589 "MESA_FORMAT_RGB_DXT1", /* StrName */
590 GL_RGB, /* BaseFormat */
591 GL_UNSIGNED_NORMALIZED, /* DataType */
592 4, 4, 4, 0, /* approx Red/Green/Blue/AlphaBits */
593 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
594 4, 4, 8 /* 8 bytes per 4x4 block */
595 },
596 {
597 MESA_FORMAT_RGBA_DXT1,
598 "MESA_FORMAT_RGBA_DXT1",
599 GL_RGBA,
600 GL_UNSIGNED_NORMALIZED,
601 4, 4, 4, 4,
602 0, 0, 0, 0, 0,
603 4, 4, 8 /* 8 bytes per 4x4 block */
604 },
605 {
606 MESA_FORMAT_RGBA_DXT3,
607 "MESA_FORMAT_RGBA_DXT3",
608 GL_RGBA,
609 GL_UNSIGNED_NORMALIZED,
610 4, 4, 4, 4,
611 0, 0, 0, 0, 0,
612 4, 4, 16 /* 16 bytes per 4x4 block */
613 },
614 {
615 MESA_FORMAT_RGBA_DXT5,
616 "MESA_FORMAT_RGBA_DXT5",
617 GL_RGBA,
618 GL_UNSIGNED_NORMALIZED,
619 4, 4, 4, 4,
620 0, 0, 0, 0, 0,
621 4, 4, 16 /* 16 bytes per 4x4 block */
622 },
623 {
624 MESA_FORMAT_RGBA_FLOAT32,
625 "MESA_FORMAT_RGBA_FLOAT32",
626 GL_RGBA,
627 GL_FLOAT,
628 32, 32, 32, 32,
629 0, 0, 0, 0, 0,
630 1, 1, 16
631 },
632 {
633 MESA_FORMAT_RGBA_FLOAT16,
634 "MESA_FORMAT_RGBA_FLOAT16",
635 GL_RGBA,
636 GL_FLOAT,
637 16, 16, 16, 16,
638 0, 0, 0, 0, 0,
639 1, 1, 8
640 },
641 {
642 MESA_FORMAT_RGB_FLOAT32,
643 "MESA_FORMAT_RGB_FLOAT32",
644 GL_RGB,
645 GL_FLOAT,
646 32, 32, 32, 0,
647 0, 0, 0, 0, 0,
648 1, 1, 12
649 },
650 {
651 MESA_FORMAT_RGB_FLOAT16,
652 "MESA_FORMAT_RGB_FLOAT16",
653 GL_RGB,
654 GL_FLOAT,
655 16, 16, 16, 0,
656 0, 0, 0, 0, 0,
657 1, 1, 6
658 },
659 {
660 MESA_FORMAT_ALPHA_FLOAT32,
661 "MESA_FORMAT_ALPHA_FLOAT32",
662 GL_ALPHA,
663 GL_FLOAT,
664 0, 0, 0, 32,
665 0, 0, 0, 0, 0,
666 1, 1, 4
667 },
668 {
669 MESA_FORMAT_ALPHA_FLOAT16,
670 "MESA_FORMAT_ALPHA_FLOAT16",
671 GL_ALPHA,
672 GL_FLOAT,
673 0, 0, 0, 16,
674 0, 0, 0, 0, 0,
675 1, 1, 2
676 },
677 {
678 MESA_FORMAT_LUMINANCE_FLOAT32,
679 "MESA_FORMAT_LUMINANCE_FLOAT32",
680 GL_ALPHA,
681 GL_FLOAT,
682 0, 0, 0, 0,
683 32, 0, 0, 0, 0,
684 1, 1, 4
685 },
686 {
687 MESA_FORMAT_LUMINANCE_FLOAT16,
688 "MESA_FORMAT_LUMINANCE_FLOAT16",
689 GL_ALPHA,
690 GL_FLOAT,
691 0, 0, 0, 0,
692 16, 0, 0, 0, 0,
693 1, 1, 2
694 },
695 {
696 MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32,
697 "MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32",
698 GL_LUMINANCE_ALPHA,
699 GL_FLOAT,
700 0, 0, 0, 32,
701 32, 0, 0, 0, 0,
702 1, 1, 8
703 },
704 {
705 MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16,
706 "MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16",
707 GL_LUMINANCE_ALPHA,
708 GL_FLOAT,
709 0, 0, 0, 16,
710 16, 0, 0, 0, 0,
711 1, 1, 4
712 },
713 {
714 MESA_FORMAT_INTENSITY_FLOAT32,
715 "MESA_FORMAT_INTENSITY_FLOAT32",
716 GL_INTENSITY,
717 GL_FLOAT,
718 0, 0, 0, 0,
719 0, 32, 0, 0, 0,
720 1, 1, 4
721 },
722 {
723 MESA_FORMAT_INTENSITY_FLOAT16,
724 "MESA_FORMAT_INTENSITY_FLOAT16",
725 GL_INTENSITY,
726 GL_FLOAT,
727 0, 0, 0, 0,
728 0, 16, 0, 0, 0,
729 1, 1, 2
730 },
731
732 /* unnormalized signed int formats */
733 {
734 MESA_FORMAT_RGBA_INT8,
735 "MESA_FORMAT_RGBA_INT8",
736 GL_RGBA,
737 GL_INT,
738 8, 8, 8, 8,
739 0, 0, 0, 0, 0,
740 1, 1, 4
741 },
742 {
743 MESA_FORMAT_RGBA_INT16,
744 "MESA_FORMAT_RGBA_INT16",
745 GL_RGBA,
746 GL_INT,
747 16, 16, 16, 16,
748 0, 0, 0, 0, 0,
749 1, 1, 8
750 },
751 {
752 MESA_FORMAT_RGBA_INT32,
753 "MESA_FORMAT_RGBA_INT32",
754 GL_RGBA,
755 GL_INT,
756 32, 32, 32, 32,
757 0, 0, 0, 0, 0,
758 1, 1, 16
759 },
760
761 /* unnormalized unsigned int formats */
762 {
763 MESA_FORMAT_RGBA_UINT8,
764 "MESA_FORMAT_RGBA_UINT8",
765 GL_RGBA,
766 GL_UNSIGNED_INT,
767 8, 8, 8, 8,
768 0, 0, 0, 0, 0,
769 1, 1, 4
770 },
771 {
772 MESA_FORMAT_RGBA_UINT16,
773 "MESA_FORMAT_RGBA_UINT16",
774 GL_RGBA,
775 GL_UNSIGNED_INT,
776 16, 16, 16, 16,
777 0, 0, 0, 0, 0,
778 1, 1, 8
779 },
780 {
781 MESA_FORMAT_RGBA_UINT32,
782 "MESA_FORMAT_RGBA_UINT32",
783 GL_RGBA,
784 GL_UNSIGNED_INT,
785 32, 32, 32, 32,
786 0, 0, 0, 0, 0,
787 1, 1, 16
788 },
789
790
791 {
792 MESA_FORMAT_DUDV8,
793 "MESA_FORMAT_DUDV8",
794 GL_DUDV_ATI,
795 GL_SIGNED_NORMALIZED,
796 0, 0, 0, 0,
797 0, 0, 0, 0, 0,
798 1, 1, 2
799 },
800
801 /* Signed 8 bits / channel */
802 {
803 MESA_FORMAT_SIGNED_R8, /* Name */
804 "MESA_FORMAT_SIGNED_R8", /* StrName */
805 GL_RED, /* BaseFormat */
806 GL_SIGNED_NORMALIZED, /* DataType */
807 8, 0, 0, 0, /* Red/Green/Blue/AlphaBits */
808 0, 0, 0, 0, 0, /* Lum/Int/Index/Depth/StencilBits */
809 1, 1, 1 /* BlockWidth/Height,Bytes */
810 },
811 {
812 MESA_FORMAT_SIGNED_RG88,
813 "MESA_FORMAT_SIGNED_RG88",
814 GL_RG,
815 GL_SIGNED_NORMALIZED,
816 8, 8, 0, 0,
817 0, 0, 0, 0, 0,
818 1, 1, 2
819 },
820 {
821 MESA_FORMAT_SIGNED_RGBX8888,
822 "MESA_FORMAT_SIGNED_RGBX8888",
823 GL_RGB,
824 GL_SIGNED_NORMALIZED,
825 8, 8, 8, 0,
826 0, 0, 0, 0, 0,
827 1, 1, 4 /* 4 bpp, but no alpha */
828 },
829 {
830 MESA_FORMAT_SIGNED_RGBA8888,
831 "MESA_FORMAT_SIGNED_RGBA8888",
832 GL_RGBA,
833 GL_SIGNED_NORMALIZED,
834 8, 8, 8, 8,
835 0, 0, 0, 0, 0,
836 1, 1, 4
837 },
838 {
839 MESA_FORMAT_SIGNED_RGBA8888_REV,
840 "MESA_FORMAT_SIGNED_RGBA8888_REV",
841 GL_RGBA,
842 GL_SIGNED_NORMALIZED,
843 8, 8, 8, 8,
844 0, 0, 0, 0, 0,
845 1, 1, 4
846 },
847
848 /* Signed 16 bits / channel */
849 {
850 MESA_FORMAT_SIGNED_R_16,
851 "MESA_FORMAT_SIGNED_R_16",
852 GL_RED,
853 GL_SIGNED_NORMALIZED,
854 16, 0, 0, 0,
855 0, 0, 0, 0, 0,
856 1, 1, 2
857 },
858 {
859 MESA_FORMAT_SIGNED_RG_16,
860 "MESA_FORMAT_SIGNED_RG_16",
861 GL_RG,
862 GL_SIGNED_NORMALIZED,
863 16, 16, 0, 0,
864 0, 0, 0, 0, 0,
865 1, 1, 4
866 },
867 {
868 MESA_FORMAT_SIGNED_RGB_16,
869 "MESA_FORMAT_SIGNED_RGB_16",
870 GL_RGB,
871 GL_SIGNED_NORMALIZED,
872 16, 16, 16, 0,
873 0, 0, 0, 0, 0,
874 1, 1, 6
875 },
876 {
877 MESA_FORMAT_SIGNED_RGBA_16,
878 "MESA_FORMAT_SIGNED_RGBA_16",
879 GL_RGBA,
880 GL_SIGNED_NORMALIZED,
881 16, 16, 16, 16,
882 0, 0, 0, 0, 0,
883 1, 1, 8
884 },
885 {
886 MESA_FORMAT_RGBA_16,
887 "MESA_FORMAT_RGBA_16",
888 GL_RGBA,
889 GL_UNSIGNED_NORMALIZED,
890 16, 16, 16, 16,
891 0, 0, 0, 0, 0,
892 1, 1, 8
893 },
894 {
895 MESA_FORMAT_RED_RGTC1,
896 "MESA_FORMAT_RED_RGTC1",
897 GL_RED,
898 GL_UNSIGNED_NORMALIZED,
899 4, 0, 0, 0,
900 0, 0, 0, 0, 0,
901 4, 4, 8 /* 8 bytes per 4x4 block */
902 },
903 {
904 MESA_FORMAT_SIGNED_RED_RGTC1,
905 "MESA_FORMAT_SIGNED_RED_RGTC1",
906 GL_RED,
907 GL_SIGNED_NORMALIZED,
908 4, 0, 0, 0,
909 0, 0, 0, 0, 0,
910 4, 4, 8 /* 8 bytes per 4x4 block */
911 },
912 {
913 MESA_FORMAT_RG_RGTC2,
914 "MESA_FORMAT_RG_RGTC2",
915 GL_RG,
916 GL_UNSIGNED_NORMALIZED,
917 4, 4, 0, 0,
918 0, 0, 0, 0, 0,
919 4, 4, 16 /* 16 bytes per 4x4 block */
920 },
921 {
922 MESA_FORMAT_SIGNED_RG_RGTC2,
923 "MESA_FORMAT_SIGNED_RG_RGTC2",
924 GL_RG,
925 GL_SIGNED_NORMALIZED,
926 4, 4, 0, 0,
927 0, 0, 0, 0, 0,
928 4, 4, 16 /* 16 bytes per 4x4 block */
929 },
930 };
931
932
933
934 static const struct gl_format_info *
935 _mesa_get_format_info(gl_format format)
936 {
937 const struct gl_format_info *info = &format_info[format];
938 assert(info->Name == format);
939 return info;
940 }
941
942
943 /** Return string name of format (for debugging) */
944 const char *
945 _mesa_get_format_name(gl_format format)
946 {
947 const struct gl_format_info *info = _mesa_get_format_info(format);
948 return info->StrName;
949 }
950
951
952
953 /**
954 * Return bytes needed to store a block of pixels in the given format.
955 * Normally, a block is 1x1 (a single pixel). But for compressed formats
956 * a block may be 4x4 or 8x4, etc.
957 */
958 GLuint
959 _mesa_get_format_bytes(gl_format format)
960 {
961 const struct gl_format_info *info = _mesa_get_format_info(format);
962 ASSERT(info->BytesPerBlock);
963 return info->BytesPerBlock;
964 }
965
966
967 /**
968 * Return bits per component for the given format.
969 * \param format one of MESA_FORMAT_x
970 * \param pname the component, such as GL_RED_BITS, GL_TEXTURE_BLUE_BITS, etc.
971 */
972 GLint
973 _mesa_get_format_bits(gl_format format, GLenum pname)
974 {
975 const struct gl_format_info *info = _mesa_get_format_info(format);
976
977 switch (pname) {
978 case GL_RED_BITS:
979 case GL_TEXTURE_RED_SIZE:
980 case GL_RENDERBUFFER_RED_SIZE_EXT:
981 case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
982 return info->RedBits;
983 case GL_GREEN_BITS:
984 case GL_TEXTURE_GREEN_SIZE:
985 case GL_RENDERBUFFER_GREEN_SIZE_EXT:
986 case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
987 return info->GreenBits;
988 case GL_BLUE_BITS:
989 case GL_TEXTURE_BLUE_SIZE:
990 case GL_RENDERBUFFER_BLUE_SIZE_EXT:
991 case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
992 return info->BlueBits;
993 case GL_ALPHA_BITS:
994 case GL_TEXTURE_ALPHA_SIZE:
995 case GL_RENDERBUFFER_ALPHA_SIZE_EXT:
996 case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
997 return info->AlphaBits;
998 case GL_TEXTURE_INTENSITY_SIZE:
999 return info->IntensityBits;
1000 case GL_TEXTURE_LUMINANCE_SIZE:
1001 return info->LuminanceBits;
1002 case GL_INDEX_BITS:
1003 case GL_TEXTURE_INDEX_SIZE_EXT:
1004 return info->IndexBits;
1005 case GL_DEPTH_BITS:
1006 case GL_TEXTURE_DEPTH_SIZE_ARB:
1007 case GL_RENDERBUFFER_DEPTH_SIZE_EXT:
1008 case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
1009 return info->DepthBits;
1010 case GL_STENCIL_BITS:
1011 case GL_TEXTURE_STENCIL_SIZE_EXT:
1012 case GL_RENDERBUFFER_STENCIL_SIZE_EXT:
1013 case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
1014 return info->StencilBits;
1015 default:
1016 _mesa_problem(NULL, "bad pname in _mesa_get_format_bits()");
1017 return 0;
1018 }
1019 }
1020
1021
1022 /**
1023 * Return the data type (or more specifically, the data representation)
1024 * for the given format.
1025 * The return value will be one of:
1026 * GL_UNSIGNED_NORMALIZED = unsigned int representing [0,1]
1027 * GL_SIGNED_NORMALIZED = signed int representing [-1, 1]
1028 * GL_UNSIGNED_INT = an ordinary unsigned integer
1029 * GL_INT = an ordinary signed integer
1030 * GL_FLOAT = an ordinary float
1031 */
1032 GLenum
1033 _mesa_get_format_datatype(gl_format format)
1034 {
1035 const struct gl_format_info *info = _mesa_get_format_info(format);
1036 return info->DataType;
1037 }
1038
1039
1040 /**
1041 * Return the basic format for the given type. The result will be
1042 * one of GL_RGB, GL_RGBA, GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA,
1043 * GL_INTENSITY, GL_YCBCR_MESA, GL_COLOR_INDEX, GL_DEPTH_COMPONENT,
1044 * GL_STENCIL_INDEX, GL_DEPTH_STENCIL.
1045 */
1046 GLenum
1047 _mesa_get_format_base_format(gl_format format)
1048 {
1049 const struct gl_format_info *info = _mesa_get_format_info(format);
1050 return info->BaseFormat;
1051 }
1052
1053
1054 /**
1055 * Return the block size (in pixels) for the given format. Normally
1056 * the block size is 1x1. But compressed formats will have block sizes
1057 * of 4x4 or 8x4 pixels, etc.
1058 * \param bw returns block width in pixels
1059 * \param bh returns block height in pixels
1060 */
1061 void
1062 _mesa_get_format_block_size(gl_format format, GLuint *bw, GLuint *bh)
1063 {
1064 const struct gl_format_info *info = _mesa_get_format_info(format);
1065 *bw = info->BlockWidth;
1066 *bh = info->BlockHeight;
1067 }
1068
1069
1070 /** Is the given format a compressed format? */
1071 GLboolean
1072 _mesa_is_format_compressed(gl_format format)
1073 {
1074 const struct gl_format_info *info = _mesa_get_format_info(format);
1075 return info->BlockWidth > 1 || info->BlockHeight > 1;
1076 }
1077
1078
1079 /**
1080 * Determine if the given format represents a packed depth/stencil buffer.
1081 */
1082 GLboolean
1083 _mesa_is_format_packed_depth_stencil(gl_format format)
1084 {
1085 const struct gl_format_info *info = _mesa_get_format_info(format);
1086
1087 return info->BaseFormat == GL_DEPTH_STENCIL;
1088 }
1089
1090
1091 /**
1092 * Is the given format a signed/unsigned integer color format?
1093 */
1094 GLboolean
1095 _mesa_is_format_integer_color(gl_format format)
1096 {
1097 const struct gl_format_info *info = _mesa_get_format_info(format);
1098 return (info->DataType == GL_INT || info->DataType == GL_UNSIGNED_INT) &&
1099 info->BaseFormat != GL_DEPTH_COMPONENT &&
1100 info->BaseFormat != GL_DEPTH_STENCIL &&
1101 info->BaseFormat != GL_STENCIL_INDEX;
1102 }
1103
1104
1105 /**
1106 * Return color encoding for given format.
1107 * \return GL_LINEAR or GL_SRGB
1108 */
1109 GLenum
1110 _mesa_get_format_color_encoding(gl_format format)
1111 {
1112 /* XXX this info should be encoded in gl_format_info */
1113 switch (format) {
1114 case MESA_FORMAT_SRGB8:
1115 case MESA_FORMAT_SRGBA8:
1116 case MESA_FORMAT_SARGB8:
1117 case MESA_FORMAT_SL8:
1118 case MESA_FORMAT_SLA8:
1119 case MESA_FORMAT_SRGB_DXT1:
1120 case MESA_FORMAT_SRGBA_DXT1:
1121 case MESA_FORMAT_SRGBA_DXT3:
1122 case MESA_FORMAT_SRGBA_DXT5:
1123 return GL_SRGB;
1124 default:
1125 return GL_LINEAR;
1126 }
1127 }
1128
1129
1130 /**
1131 * For an sRGB format, return the corresponding linear color space format.
1132 * For non-sRGB formats, return the format as-is.
1133 */
1134 gl_format
1135 _mesa_get_srgb_format_linear(gl_format format)
1136 {
1137 switch (format) {
1138 case MESA_FORMAT_SRGB8:
1139 format = MESA_FORMAT_RGB888;
1140 break;
1141 case MESA_FORMAT_SRGBA8:
1142 format = MESA_FORMAT_RGBA8888;
1143 break;
1144 case MESA_FORMAT_SARGB8:
1145 format = MESA_FORMAT_ARGB8888;
1146 break;
1147 case MESA_FORMAT_SL8:
1148 format = MESA_FORMAT_L8;
1149 break;
1150 case MESA_FORMAT_SLA8:
1151 format = MESA_FORMAT_AL88;
1152 break;
1153 case MESA_FORMAT_SRGB_DXT1:
1154 format = MESA_FORMAT_RGB_DXT1;
1155 break;
1156 case MESA_FORMAT_SRGBA_DXT1:
1157 format = MESA_FORMAT_RGBA_DXT1;
1158 break;
1159 case MESA_FORMAT_SRGBA_DXT3:
1160 format = MESA_FORMAT_RGBA_DXT3;
1161 break;
1162 case MESA_FORMAT_SRGBA_DXT5:
1163 format = MESA_FORMAT_RGBA_DXT5;
1164 break;
1165 default:
1166 break;
1167 }
1168 return format;
1169 }
1170
1171
1172 /**
1173 * Return number of bytes needed to store an image of the given size
1174 * in the given format.
1175 */
1176 GLuint
1177 _mesa_format_image_size(gl_format format, GLsizei width,
1178 GLsizei height, GLsizei depth)
1179 {
1180 const struct gl_format_info *info = _mesa_get_format_info(format);
1181 /* Strictly speaking, a conditional isn't needed here */
1182 if (info->BlockWidth > 1 || info->BlockHeight > 1) {
1183 /* compressed format (2D only for now) */
1184 const GLuint bw = info->BlockWidth, bh = info->BlockHeight;
1185 const GLuint wblocks = (width + bw - 1) / bw;
1186 const GLuint hblocks = (height + bh - 1) / bh;
1187 const GLuint sz = wblocks * hblocks * info->BytesPerBlock;
1188 assert(depth == 1);
1189 return sz;
1190 }
1191 else {
1192 /* non-compressed */
1193 const GLuint sz = width * height * depth * info->BytesPerBlock;
1194 return sz;
1195 }
1196 }
1197
1198
1199 /**
1200 * Same as _mesa_format_image_size() but returns a 64-bit value to
1201 * accomodate very large textures.
1202 */
1203 uint64_t
1204 _mesa_format_image_size64(gl_format format, GLsizei width,
1205 GLsizei height, GLsizei depth)
1206 {
1207 const struct gl_format_info *info = _mesa_get_format_info(format);
1208 /* Strictly speaking, a conditional isn't needed here */
1209 if (info->BlockWidth > 1 || info->BlockHeight > 1) {
1210 /* compressed format (2D only for now) */
1211 const uint64_t bw = info->BlockWidth, bh = info->BlockHeight;
1212 const uint64_t wblocks = (width + bw - 1) / bw;
1213 const uint64_t hblocks = (height + bh - 1) / bh;
1214 const uint64_t sz = wblocks * hblocks * info->BytesPerBlock;
1215 assert(depth == 1);
1216 return sz;
1217 }
1218 else {
1219 /* non-compressed */
1220 const uint64_t sz = ((uint64_t) width *
1221 (uint64_t) height *
1222 (uint64_t) depth *
1223 info->BytesPerBlock);
1224 return sz;
1225 }
1226 }
1227
1228
1229
1230 GLint
1231 _mesa_format_row_stride(gl_format format, GLsizei width)
1232 {
1233 const struct gl_format_info *info = _mesa_get_format_info(format);
1234 /* Strictly speaking, a conditional isn't needed here */
1235 if (info->BlockWidth > 1 || info->BlockHeight > 1) {
1236 /* compressed format */
1237 const GLuint bw = info->BlockWidth;
1238 const GLuint wblocks = (width + bw - 1) / bw;
1239 const GLint stride = wblocks * info->BytesPerBlock;
1240 return stride;
1241 }
1242 else {
1243 const GLint stride = width * info->BytesPerBlock;
1244 return stride;
1245 }
1246 }
1247
1248
1249 /**
1250 * Debug/test: check that all formats are handled in the
1251 * _mesa_format_to_type_and_comps() function. When new pixel formats
1252 * are added to Mesa, that function needs to be updated.
1253 * This is a no-op after the first call.
1254 */
1255 static void
1256 check_format_to_type_and_comps(void)
1257 {
1258 gl_format f;
1259
1260 for (f = MESA_FORMAT_NONE + 1; f < MESA_FORMAT_COUNT; f++) {
1261 GLenum datatype = 0;
1262 GLuint comps = 0;
1263 /* This function will emit a problem/warning if the format is
1264 * not handled.
1265 */
1266 _mesa_format_to_type_and_comps(f, &datatype, &comps);
1267 }
1268 }
1269
1270
1271 /**
1272 * Do sanity checking of the format info table.
1273 */
1274 void
1275 _mesa_test_formats(void)
1276 {
1277 GLuint i;
1278
1279 assert(Elements(format_info) == MESA_FORMAT_COUNT);
1280
1281 for (i = 0; i < MESA_FORMAT_COUNT; i++) {
1282 const struct gl_format_info *info = _mesa_get_format_info(i);
1283 assert(info);
1284
1285 assert(info->Name == i);
1286
1287 if (info->Name == MESA_FORMAT_NONE)
1288 continue;
1289
1290 if (info->BlockWidth == 1 && info->BlockHeight == 1) {
1291 if (info->RedBits > 0) {
1292 GLuint t = info->RedBits + info->GreenBits
1293 + info->BlueBits + info->AlphaBits;
1294 assert(t / 8 <= info->BytesPerBlock);
1295 (void) t;
1296 }
1297 }
1298
1299 assert(info->DataType == GL_UNSIGNED_NORMALIZED ||
1300 info->DataType == GL_SIGNED_NORMALIZED ||
1301 info->DataType == GL_UNSIGNED_INT ||
1302 info->DataType == GL_INT ||
1303 info->DataType == GL_FLOAT);
1304
1305 if (info->BaseFormat == GL_RGB) {
1306 assert(info->RedBits > 0);
1307 assert(info->GreenBits > 0);
1308 assert(info->BlueBits > 0);
1309 assert(info->AlphaBits == 0);
1310 assert(info->LuminanceBits == 0);
1311 assert(info->IntensityBits == 0);
1312 }
1313 else if (info->BaseFormat == GL_RGBA) {
1314 assert(info->RedBits > 0);
1315 assert(info->GreenBits > 0);
1316 assert(info->BlueBits > 0);
1317 assert(info->AlphaBits > 0);
1318 assert(info->LuminanceBits == 0);
1319 assert(info->IntensityBits == 0);
1320 }
1321 else if (info->BaseFormat == GL_RG) {
1322 assert(info->RedBits > 0);
1323 assert(info->GreenBits > 0);
1324 assert(info->BlueBits == 0);
1325 assert(info->AlphaBits == 0);
1326 assert(info->LuminanceBits == 0);
1327 assert(info->IntensityBits == 0);
1328 }
1329 else if (info->BaseFormat == GL_RED) {
1330 assert(info->RedBits > 0);
1331 assert(info->GreenBits == 0);
1332 assert(info->BlueBits == 0);
1333 assert(info->AlphaBits == 0);
1334 assert(info->LuminanceBits == 0);
1335 assert(info->IntensityBits == 0);
1336 }
1337 else if (info->BaseFormat == GL_LUMINANCE) {
1338 assert(info->RedBits == 0);
1339 assert(info->GreenBits == 0);
1340 assert(info->BlueBits == 0);
1341 assert(info->AlphaBits == 0);
1342 assert(info->LuminanceBits > 0);
1343 assert(info->IntensityBits == 0);
1344 }
1345 else if (info->BaseFormat == GL_INTENSITY) {
1346 assert(info->RedBits == 0);
1347 assert(info->GreenBits == 0);
1348 assert(info->BlueBits == 0);
1349 assert(info->AlphaBits == 0);
1350 assert(info->LuminanceBits == 0);
1351 assert(info->IntensityBits > 0);
1352 }
1353 }
1354
1355 check_format_to_type_and_comps();
1356 }
1357
1358
1359
1360 /**
1361 * Return datatype and number of components per texel for the given gl_format.
1362 * Only used for mipmap generation code.
1363 */
1364 void
1365 _mesa_format_to_type_and_comps(gl_format format,
1366 GLenum *datatype, GLuint *comps)
1367 {
1368 switch (format) {
1369 case MESA_FORMAT_RGBA8888:
1370 case MESA_FORMAT_RGBA8888_REV:
1371 case MESA_FORMAT_ARGB8888:
1372 case MESA_FORMAT_ARGB8888_REV:
1373 case MESA_FORMAT_XRGB8888:
1374 case MESA_FORMAT_XRGB8888_REV:
1375 *datatype = GL_UNSIGNED_BYTE;
1376 *comps = 4;
1377 return;
1378 case MESA_FORMAT_RGB888:
1379 case MESA_FORMAT_BGR888:
1380 *datatype = GL_UNSIGNED_BYTE;
1381 *comps = 3;
1382 return;
1383 case MESA_FORMAT_RGB565:
1384 case MESA_FORMAT_RGB565_REV:
1385 *datatype = GL_UNSIGNED_SHORT_5_6_5;
1386 *comps = 3;
1387 return;
1388
1389 case MESA_FORMAT_ARGB4444:
1390 case MESA_FORMAT_ARGB4444_REV:
1391 *datatype = GL_UNSIGNED_SHORT_4_4_4_4;
1392 *comps = 4;
1393 return;
1394
1395 case MESA_FORMAT_ARGB1555:
1396 case MESA_FORMAT_ARGB1555_REV:
1397 *datatype = GL_UNSIGNED_SHORT_1_5_5_5_REV;
1398 *comps = 4;
1399 return;
1400
1401 case MESA_FORMAT_ARGB2101010:
1402 *datatype = GL_UNSIGNED_INT_2_10_10_10_REV;
1403 *comps = 4;
1404 return;
1405
1406 case MESA_FORMAT_RGBA5551:
1407 *datatype = GL_UNSIGNED_SHORT_5_5_5_1;
1408 *comps = 4;
1409 return;
1410
1411 case MESA_FORMAT_AL44:
1412 *datatype = MESA_UNSIGNED_BYTE_4_4;
1413 *comps = 2;
1414 return;
1415
1416 case MESA_FORMAT_AL88:
1417 case MESA_FORMAT_AL88_REV:
1418 case MESA_FORMAT_RG88:
1419 case MESA_FORMAT_RG88_REV:
1420 *datatype = GL_UNSIGNED_BYTE;
1421 *comps = 2;
1422 return;
1423
1424 case MESA_FORMAT_AL1616:
1425 case MESA_FORMAT_AL1616_REV:
1426 case MESA_FORMAT_RG1616:
1427 case MESA_FORMAT_RG1616_REV:
1428 *datatype = GL_UNSIGNED_SHORT;
1429 *comps = 2;
1430 return;
1431
1432 case MESA_FORMAT_R16:
1433 case MESA_FORMAT_A16:
1434 case MESA_FORMAT_L16:
1435 case MESA_FORMAT_I16:
1436 *datatype = GL_UNSIGNED_SHORT;
1437 *comps = 1;
1438 return;
1439
1440 case MESA_FORMAT_RGB332:
1441 *datatype = GL_UNSIGNED_BYTE_3_3_2;
1442 *comps = 3;
1443 return;
1444
1445 case MESA_FORMAT_A8:
1446 case MESA_FORMAT_L8:
1447 case MESA_FORMAT_I8:
1448 case MESA_FORMAT_CI8:
1449 case MESA_FORMAT_R8:
1450 case MESA_FORMAT_S8:
1451 *datatype = GL_UNSIGNED_BYTE;
1452 *comps = 1;
1453 return;
1454
1455 case MESA_FORMAT_YCBCR:
1456 case MESA_FORMAT_YCBCR_REV:
1457 *datatype = GL_UNSIGNED_SHORT;
1458 *comps = 2;
1459 return;
1460
1461 case MESA_FORMAT_Z24_S8:
1462 *datatype = GL_UNSIGNED_INT;
1463 *comps = 1; /* XXX OK? */
1464 return;
1465
1466 case MESA_FORMAT_S8_Z24:
1467 *datatype = GL_UNSIGNED_INT;
1468 *comps = 1; /* XXX OK? */
1469 return;
1470
1471 case MESA_FORMAT_Z16:
1472 *datatype = GL_UNSIGNED_SHORT;
1473 *comps = 1;
1474 return;
1475
1476 case MESA_FORMAT_X8_Z24:
1477 *datatype = GL_UNSIGNED_INT;
1478 *comps = 1;
1479 return;
1480
1481 case MESA_FORMAT_Z24_X8:
1482 *datatype = GL_UNSIGNED_INT;
1483 *comps = 1;
1484 return;
1485
1486 case MESA_FORMAT_Z32:
1487 *datatype = GL_UNSIGNED_INT;
1488 *comps = 1;
1489 return;
1490
1491 case MESA_FORMAT_DUDV8:
1492 *datatype = GL_BYTE;
1493 *comps = 2;
1494 return;
1495
1496 case MESA_FORMAT_SIGNED_R8:
1497 *datatype = GL_BYTE;
1498 *comps = 1;
1499 return;
1500 case MESA_FORMAT_SIGNED_RG88:
1501 *datatype = GL_BYTE;
1502 *comps = 2;
1503 return;
1504 case MESA_FORMAT_SIGNED_RGBA8888:
1505 case MESA_FORMAT_SIGNED_RGBA8888_REV:
1506 case MESA_FORMAT_SIGNED_RGBX8888:
1507 *datatype = GL_BYTE;
1508 *comps = 4;
1509 return;
1510
1511 case MESA_FORMAT_RGBA_16:
1512 *datatype = GL_UNSIGNED_SHORT;
1513 *comps = 4;
1514 return;
1515
1516 case MESA_FORMAT_SIGNED_R_16:
1517 *datatype = GL_SHORT;
1518 *comps = 1;
1519 return;
1520 case MESA_FORMAT_SIGNED_RG_16:
1521 *datatype = GL_SHORT;
1522 *comps = 2;
1523 return;
1524 case MESA_FORMAT_SIGNED_RGB_16:
1525 *datatype = GL_SHORT;
1526 *comps = 3;
1527 return;
1528 case MESA_FORMAT_SIGNED_RGBA_16:
1529 *datatype = GL_SHORT;
1530 *comps = 4;
1531 return;
1532
1533 #if FEATURE_EXT_texture_sRGB
1534 case MESA_FORMAT_SRGB8:
1535 *datatype = GL_UNSIGNED_BYTE;
1536 *comps = 3;
1537 return;
1538 case MESA_FORMAT_SRGBA8:
1539 case MESA_FORMAT_SARGB8:
1540 *datatype = GL_UNSIGNED_BYTE;
1541 *comps = 4;
1542 return;
1543 case MESA_FORMAT_SL8:
1544 *datatype = GL_UNSIGNED_BYTE;
1545 *comps = 1;
1546 return;
1547 case MESA_FORMAT_SLA8:
1548 *datatype = GL_UNSIGNED_BYTE;
1549 *comps = 2;
1550 return;
1551 #endif
1552
1553 #if FEATURE_texture_fxt1
1554 case MESA_FORMAT_RGB_FXT1:
1555 case MESA_FORMAT_RGBA_FXT1:
1556 #endif
1557 #if FEATURE_texture_s3tc
1558 case MESA_FORMAT_RGB_DXT1:
1559 case MESA_FORMAT_RGBA_DXT1:
1560 case MESA_FORMAT_RGBA_DXT3:
1561 case MESA_FORMAT_RGBA_DXT5:
1562 #if FEATURE_EXT_texture_sRGB
1563 case MESA_FORMAT_SRGB_DXT1:
1564 case MESA_FORMAT_SRGBA_DXT1:
1565 case MESA_FORMAT_SRGBA_DXT3:
1566 case MESA_FORMAT_SRGBA_DXT5:
1567 #endif
1568 #endif
1569 case MESA_FORMAT_RED_RGTC1:
1570 case MESA_FORMAT_SIGNED_RED_RGTC1:
1571 case MESA_FORMAT_RG_RGTC2:
1572 case MESA_FORMAT_SIGNED_RG_RGTC2:
1573 /* XXX generate error instead? */
1574 *datatype = GL_UNSIGNED_BYTE;
1575 *comps = 0;
1576 return;
1577
1578 case MESA_FORMAT_RGBA_FLOAT32:
1579 *datatype = GL_FLOAT;
1580 *comps = 4;
1581 return;
1582 case MESA_FORMAT_RGBA_FLOAT16:
1583 *datatype = GL_HALF_FLOAT_ARB;
1584 *comps = 4;
1585 return;
1586 case MESA_FORMAT_RGB_FLOAT32:
1587 *datatype = GL_FLOAT;
1588 *comps = 3;
1589 return;
1590 case MESA_FORMAT_RGB_FLOAT16:
1591 *datatype = GL_HALF_FLOAT_ARB;
1592 *comps = 3;
1593 return;
1594 case MESA_FORMAT_LUMINANCE_ALPHA_FLOAT32:
1595 *datatype = GL_FLOAT;
1596 *comps = 2;
1597 return;
1598 case MESA_FORMAT_LUMINANCE_ALPHA_FLOAT16:
1599 *datatype = GL_HALF_FLOAT_ARB;
1600 *comps = 2;
1601 return;
1602 case MESA_FORMAT_ALPHA_FLOAT32:
1603 case MESA_FORMAT_LUMINANCE_FLOAT32:
1604 case MESA_FORMAT_INTENSITY_FLOAT32:
1605 *datatype = GL_FLOAT;
1606 *comps = 1;
1607 return;
1608 case MESA_FORMAT_ALPHA_FLOAT16:
1609 case MESA_FORMAT_LUMINANCE_FLOAT16:
1610 case MESA_FORMAT_INTENSITY_FLOAT16:
1611 *datatype = GL_HALF_FLOAT_ARB;
1612 *comps = 1;
1613 return;
1614
1615 case MESA_FORMAT_RGBA_INT8:
1616 *datatype = GL_BYTE;
1617 *comps = 4;
1618 return;
1619 case MESA_FORMAT_RGBA_INT16:
1620 *datatype = GL_SHORT;
1621 *comps = 4;
1622 return;
1623 case MESA_FORMAT_RGBA_INT32:
1624 *datatype = GL_INT;
1625 *comps = 4;
1626 return;
1627
1628 /**
1629 * \name Non-normalized unsigned integer formats.
1630 */
1631 case MESA_FORMAT_RGBA_UINT8:
1632 *datatype = GL_UNSIGNED_BYTE;
1633 *comps = 4;
1634 return;
1635 case MESA_FORMAT_RGBA_UINT16:
1636 *datatype = GL_UNSIGNED_SHORT;
1637 *comps = 4;
1638 return;
1639 case MESA_FORMAT_RGBA_UINT32:
1640 *datatype = GL_UNSIGNED_INT;
1641 *comps = 4;
1642 return;
1643
1644 case MESA_FORMAT_COUNT:
1645 assert(0);
1646 return;
1647
1648 case MESA_FORMAT_NONE:
1649 /* For debug builds, warn if any formats are not handled */
1650 #ifdef DEBUG
1651 default:
1652 #endif
1653 _mesa_problem(NULL, "bad format %s in _mesa_format_to_type_and_comps",
1654 _mesa_get_format_name(format));
1655 *datatype = 0;
1656 *comps = 1;
1657 }
1658 }