xref: /aosp_15_r20/external/mesa3d/src/mesa/main/formats.c (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Mesa 3-D graphics library
3  *
4  * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
5  * Copyright (c) 2008-2009  VMware, Inc.
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a
8  * copy of this software and associated documentation files (the "Software"),
9  * to deal in the Software without restriction, including without limitation
10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11  * and/or sell copies of the Software, and to permit persons to whom the
12  * Software is furnished to do so, subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice shall be included
15  * in all copies or substantial portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
21  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
22  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23  * OTHER DEALINGS IN THE SOFTWARE.
24  */
25 
26 
27 #include "errors.h"
28 
29 #include "formats.h"
30 #include "macros.h"
31 #include "glformats.h"
32 #include "c11/threads.h"
33 #include "util/hash_table.h"
34 
35 /**
36  * Information about texture formats.
37  */
38 struct mesa_format_info
39 {
40    mesa_format Name;
41 
42    /** text name for debugging */
43    const char *StrName;
44 
45    enum mesa_format_layout Layout;
46 
47    /**
48     * Base format is one of GL_RED, GL_RG, GL_RGB, GL_RGBA, GL_ALPHA,
49     * GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_INTENSITY, GL_YCBCR_MESA,
50     * GL_DEPTH_COMPONENT, GL_STENCIL_INDEX, GL_DEPTH_STENCIL.
51     */
52    GLenum BaseFormat;
53 
54    /**
55     * Logical data type: one of  GL_UNSIGNED_NORMALIZED, GL_SIGNED_NORMALIZED,
56     * GL_UNSIGNED_INT, GL_INT, GL_FLOAT.
57     */
58    GLenum DataType;
59 
60    uint8_t RedBits;
61    uint8_t GreenBits;
62    uint8_t BlueBits;
63    uint8_t AlphaBits;
64    uint8_t LuminanceBits;
65    uint8_t IntensityBits;
66    uint8_t DepthBits;
67    uint8_t StencilBits;
68 
69    bool IsSRGBFormat;
70 
71    /**
72     * To describe compressed formats.  If not compressed, Width=Height=Depth=1.
73     */
74    uint8_t BlockWidth, BlockHeight, BlockDepth;
75    uint8_t BytesPerBlock;
76 
77    uint8_t Swizzle[4];
78    mesa_array_format ArrayFormat;
79 };
80 
81 #include "format_info.h"
82 
83 static const struct mesa_format_info *
_mesa_get_format_info(mesa_format format)84 _mesa_get_format_info(mesa_format format)
85 {
86    const struct mesa_format_info *info = &format_info[format];
87    STATIC_ASSERT(ARRAY_SIZE(format_info) == MESA_FORMAT_COUNT);
88 
89    /* The MESA_FORMAT_* enums are sparse, don't return a format info
90     * for empty entries.
91     */
92    if (info->Name == MESA_FORMAT_NONE && format != MESA_FORMAT_NONE)
93       return NULL;
94 
95    assert(info->Name == format);
96    return info;
97 }
98 
99 
100 /** Return string name of format (for debugging) */
101 const char *
_mesa_get_format_name(mesa_format format)102 _mesa_get_format_name(mesa_format format)
103 {
104    const struct mesa_format_info *info = _mesa_get_format_info(format);
105    if (!info)
106       return NULL;
107    return info->StrName;
108 }
109 
110 
111 
112 /**
113  * Return bytes needed to store a block of pixels in the given format.
114  * Normally, a block is 1x1 (a single pixel).  But for compressed formats
115  * a block may be 4x4 or 8x4, etc.
116  *
117  * Note: return is signed, so as not to coerce math to unsigned. cf. fdo #37351
118  */
119 int
_mesa_get_format_bytes(mesa_format format)120 _mesa_get_format_bytes(mesa_format format)
121 {
122    if (_mesa_format_is_mesa_array_format(format)) {
123       return _mesa_array_format_get_type_size(format) *
124              _mesa_array_format_get_num_channels(format);
125    }
126 
127    const struct mesa_format_info *info = _mesa_get_format_info(format);
128    assert(info->BytesPerBlock);
129    assert(info->BytesPerBlock <= MAX_PIXEL_BYTES ||
130           _mesa_is_format_compressed(format));
131    return info->BytesPerBlock;
132 }
133 
134 
135 /**
136  * Return bits per component for the given format.
137  * \param format  one of MESA_FORMAT_x
138  * \param pname  the component, such as GL_RED_BITS, GL_TEXTURE_BLUE_BITS, etc.
139  */
140 GLint
_mesa_get_format_bits(mesa_format format,GLenum pname)141 _mesa_get_format_bits(mesa_format format, GLenum pname)
142 {
143    const struct mesa_format_info *info = _mesa_get_format_info(format);
144 
145    switch (pname) {
146    case GL_RED_BITS:
147    case GL_TEXTURE_RED_SIZE:
148    case GL_RENDERBUFFER_RED_SIZE:
149    case GL_FRAMEBUFFER_ATTACHMENT_RED_SIZE:
150    case GL_INTERNALFORMAT_RED_SIZE:
151       return info->RedBits;
152    case GL_GREEN_BITS:
153    case GL_TEXTURE_GREEN_SIZE:
154    case GL_RENDERBUFFER_GREEN_SIZE:
155    case GL_FRAMEBUFFER_ATTACHMENT_GREEN_SIZE:
156    case GL_INTERNALFORMAT_GREEN_SIZE:
157       return info->GreenBits;
158    case GL_BLUE_BITS:
159    case GL_TEXTURE_BLUE_SIZE:
160    case GL_RENDERBUFFER_BLUE_SIZE:
161    case GL_FRAMEBUFFER_ATTACHMENT_BLUE_SIZE:
162    case GL_INTERNALFORMAT_BLUE_SIZE:
163       return info->BlueBits;
164    case GL_ALPHA_BITS:
165    case GL_TEXTURE_ALPHA_SIZE:
166    case GL_RENDERBUFFER_ALPHA_SIZE:
167    case GL_FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE:
168    case GL_INTERNALFORMAT_ALPHA_SIZE:
169       return info->AlphaBits;
170    case GL_TEXTURE_INTENSITY_SIZE:
171       return info->IntensityBits;
172    case GL_TEXTURE_LUMINANCE_SIZE:
173       return info->LuminanceBits;
174    case GL_INDEX_BITS:
175       return 0;
176    case GL_DEPTH_BITS:
177    case GL_TEXTURE_DEPTH_SIZE:
178    case GL_RENDERBUFFER_DEPTH_SIZE:
179    case GL_FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE:
180    case GL_INTERNALFORMAT_DEPTH_SIZE:
181       return info->DepthBits;
182    case GL_STENCIL_BITS:
183    case GL_TEXTURE_STENCIL_SIZE:
184    case GL_RENDERBUFFER_STENCIL_SIZE:
185    case GL_FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE:
186    case GL_INTERNALFORMAT_STENCIL_SIZE:
187       return info->StencilBits;
188    default:
189       _mesa_problem(NULL, "bad pname in _mesa_get_format_bits()");
190       return 0;
191    }
192 }
193 
194 
195 unsigned int
_mesa_get_format_max_bits(mesa_format format)196 _mesa_get_format_max_bits(mesa_format format)
197 {
198    const struct mesa_format_info *info = _mesa_get_format_info(format);
199    unsigned int max = MAX2(info->RedBits, info->GreenBits);
200    max = MAX2(max, info->BlueBits);
201    max = MAX2(max, info->AlphaBits);
202    max = MAX2(max, info->LuminanceBits);
203    max = MAX2(max, info->IntensityBits);
204    max = MAX2(max, info->DepthBits);
205    max = MAX2(max, info->StencilBits);
206    return max;
207 }
208 
209 
210 /**
211  * Return the layout type of the given format.
212  */
213 extern enum mesa_format_layout
_mesa_get_format_layout(mesa_format format)214 _mesa_get_format_layout(mesa_format format)
215 {
216    const struct mesa_format_info *info = _mesa_get_format_info(format);
217    return info->Layout;
218 }
219 
220 
221 /**
222  * Return the data type (or more specifically, the data representation)
223  * for the given format.
224  * The return value will be one of:
225  *    GL_UNSIGNED_NORMALIZED = unsigned int representing [0,1]
226  *    GL_SIGNED_NORMALIZED = signed int representing [-1, 1]
227  *    GL_UNSIGNED_INT = an ordinary unsigned integer
228  *    GL_INT = an ordinary signed integer
229  *    GL_FLOAT = an ordinary float
230  */
231 GLenum
_mesa_get_format_datatype(mesa_format format)232 _mesa_get_format_datatype(mesa_format format)
233 {
234    const struct mesa_format_info *info = _mesa_get_format_info(format);
235    return info->DataType;
236 }
237 
238 static GLenum
get_base_format_for_array_format(mesa_array_format format)239 get_base_format_for_array_format(mesa_array_format format)
240 {
241    uint8_t swizzle[4];
242    int num_channels;
243 
244    switch (_mesa_array_format_get_base_format(format)) {
245    case MESA_ARRAY_FORMAT_BASE_FORMAT_DEPTH:
246       return GL_DEPTH_COMPONENT;
247    case MESA_ARRAY_FORMAT_BASE_FORMAT_STENCIL:
248       return GL_STENCIL_INDEX;
249    case MESA_ARRAY_FORMAT_BASE_FORMAT_RGBA_VARIANTS:
250       break;
251    }
252 
253    _mesa_array_format_get_swizzle(format, swizzle);
254    num_channels = _mesa_array_format_get_num_channels(format);
255 
256    switch (num_channels) {
257    case 4:
258       /* FIXME: RGBX formats have 4 channels, but their base format is GL_RGB.
259        * This is not really a problem for now because we only create array
260        * formats from GL format/type combinations, and these cannot specify
261        * RGBX formats.
262        */
263       return GL_RGBA;
264    case 3:
265       return GL_RGB;
266    case 2:
267       if (swizzle[0] == 0 &&
268           swizzle[1] == 0 &&
269           swizzle[2] == 0 &&
270           swizzle[3] == 1)
271          return GL_LUMINANCE_ALPHA;
272       if (swizzle[0] == 1 &&
273           swizzle[1] == 1 &&
274           swizzle[2] == 1 &&
275           swizzle[3] == 0)
276          return GL_LUMINANCE_ALPHA;
277       if (swizzle[0] == 0 &&
278           swizzle[1] == 1 &&
279           swizzle[2] == 4 &&
280           swizzle[3] == 5)
281          return GL_RG;
282       if (swizzle[0] == 1 &&
283           swizzle[1] == 0 &&
284           swizzle[2] == 4 &&
285           swizzle[3] == 5)
286          return GL_RG;
287       break;
288    case 1:
289       if (swizzle[0] == 0 &&
290           swizzle[1] == 0 &&
291           swizzle[2] == 0 &&
292           swizzle[3] == 5)
293          return GL_LUMINANCE;
294       if (swizzle[0] == 0 &&
295           swizzle[1] == 0 &&
296           swizzle[2] == 0 &&
297           swizzle[3] == 0)
298          return GL_INTENSITY;
299       if (swizzle[0] <= MESA_FORMAT_SWIZZLE_W)
300          return GL_RED;
301       if (swizzle[1] <= MESA_FORMAT_SWIZZLE_W)
302          return GL_GREEN;
303       if (swizzle[2] <= MESA_FORMAT_SWIZZLE_W)
304          return GL_BLUE;
305       if (swizzle[3] <= MESA_FORMAT_SWIZZLE_W)
306          return GL_ALPHA;
307       break;
308    }
309 
310    unreachable("Unsupported format");
311 }
312 
313 /**
314  * Return the basic format for the given type.  The result will be one of
315  * GL_RGB, GL_RGBA, GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_INTENSITY,
316  * GL_YCBCR_MESA, GL_DEPTH_COMPONENT, GL_STENCIL_INDEX, GL_DEPTH_STENCIL.
317  * This functions accepts a mesa_format or a mesa_array_format.
318  */
319 GLenum
_mesa_get_format_base_format(uint32_t format)320 _mesa_get_format_base_format(uint32_t format)
321 {
322    if (!_mesa_format_is_mesa_array_format(format)) {
323       const struct mesa_format_info *info = _mesa_get_format_info(format);
324       return info->BaseFormat;
325    } else {
326       return get_base_format_for_array_format(format);
327    }
328 }
329 
330 
331 /**
332  * Return the block size (in pixels) for the given format.  Normally
333  * the block size is 1x1.  But compressed formats will have block sizes
334  * of 4x4 or 8x4 pixels, etc.
335  * \param bw  returns block width in pixels
336  * \param bh  returns block height in pixels
337  */
338 void
_mesa_get_format_block_size(mesa_format format,unsigned int * bw,unsigned int * bh)339 _mesa_get_format_block_size(mesa_format format,
340                             unsigned int *bw, unsigned int *bh)
341 {
342    const struct mesa_format_info *info = _mesa_get_format_info(format);
343    /* Use _mesa_get_format_block_size_3d() for 3D blocks. */
344    assert(info->BlockDepth == 1);
345 
346    *bw = info->BlockWidth;
347    *bh = info->BlockHeight;
348 }
349 
350 
351 /**
352  * Return the block size (in pixels) for the given format. Normally
353  * the block size is 1x1x1. But compressed formats will have block
354  * sizes of 4x4x4, 3x3x3 pixels, etc.
355  * \param bw  returns block width in pixels
356  * \param bh  returns block height in pixels
357  * \param bd  returns block depth in pixels
358  */
359 void
_mesa_get_format_block_size_3d(mesa_format format,unsigned int * bw,unsigned int * bh,unsigned int * bd)360 _mesa_get_format_block_size_3d(mesa_format format,
361                                unsigned int *bw,
362                                unsigned int *bh,
363                                unsigned int *bd)
364 {
365    const struct mesa_format_info *info = _mesa_get_format_info(format);
366    *bw = info->BlockWidth;
367    *bh = info->BlockHeight;
368    *bd = info->BlockDepth;
369 }
370 
371 
372 /**
373  * Returns the an array of four numbers representing the transformation
374  * from the RGBA or SZ colorspace to the given format.  For array formats,
375  * the i'th RGBA component is given by:
376  *
377  * if (swizzle[i] <= MESA_FORMAT_SWIZZLE_W)
378  *    comp = data[swizzle[i]];
379  * else if (swizzle[i] == MESA_FORMAT_SWIZZLE_ZERO)
380  *    comp = 0;
381  * else if (swizzle[i] == MESA_FORMAT_SWIZZLE_ONE)
382  *    comp = 1;
383  * else if (swizzle[i] == MESA_FORMAT_SWIZZLE_NONE)
384  *    // data does not contain a channel of this format
385  *
386  * For packed formats, the swizzle gives the number of components left of
387  * the least significant bit.
388  *
389  * Compressed formats have no swizzle.
390  */
391 void
_mesa_get_format_swizzle(mesa_format format,uint8_t swizzle_out[4])392 _mesa_get_format_swizzle(mesa_format format, uint8_t swizzle_out[4])
393 {
394    const struct mesa_format_info *info = _mesa_get_format_info(format);
395    memcpy(swizzle_out, info->Swizzle, sizeof(info->Swizzle));
396 }
397 
398 mesa_array_format
_mesa_array_format_flip_channels(mesa_array_format format)399 _mesa_array_format_flip_channels(mesa_array_format format)
400 {
401    int num_channels;
402    uint8_t swizzle[4];
403 
404    num_channels = _mesa_array_format_get_num_channels(format);
405    _mesa_array_format_get_swizzle(format, swizzle);
406 
407    if (num_channels == 1 || num_channels == 3)
408       return format;
409 
410    if (num_channels == 2) {
411       /* Assert that the swizzle makes sense for 2 channels */
412       for (unsigned i = 0; i < 4; i++)
413          assert(swizzle[i] != 2 && swizzle[i] != 3);
414 
415       static const uint8_t flip_xy[7] = { 1, 0, 2, 3, 4, 5, 6 };
416       _mesa_array_format_set_swizzle(&format,
417                                      flip_xy[swizzle[0]], flip_xy[swizzle[1]],
418                                      flip_xy[swizzle[2]], flip_xy[swizzle[3]]);
419       return format;
420    }
421 
422    if (num_channels == 4) {
423       static const uint8_t flip[7] = { 3, 2, 1, 0, 4, 5, 6 };
424       _mesa_array_format_set_swizzle(&format,
425                                      flip[swizzle[0]], flip[swizzle[1]],
426                                      flip[swizzle[2]], flip[swizzle[3]]);
427       return format;
428    }
429 
430    unreachable("Invalid array format");
431 }
432 
433 static uint32_t
_mesa_format_info_to_array_format(const struct mesa_format_info * info)434 _mesa_format_info_to_array_format(const struct mesa_format_info *info)
435 {
436 #if UTIL_ARCH_BIG_ENDIAN
437    if (info->ArrayFormat && info->Layout == MESA_FORMAT_LAYOUT_PACKED)
438       return _mesa_array_format_flip_channels(info->ArrayFormat);
439    else
440 #endif
441       return info->ArrayFormat;
442 }
443 
444 uint32_t
_mesa_format_to_array_format(mesa_format format)445 _mesa_format_to_array_format(mesa_format format)
446 {
447    const struct mesa_format_info *info = _mesa_get_format_info(format);
448    return _mesa_format_info_to_array_format(info);
449 }
450 
451 static struct hash_table *format_array_format_table;
452 static once_flag format_array_format_table_exists = ONCE_FLAG_INIT;
453 
454 static void
format_array_format_table_destroy(void)455 format_array_format_table_destroy(void)
456 {
457    _mesa_hash_table_destroy(format_array_format_table, NULL);
458 }
459 
460 static bool
array_formats_equal(const void * a,const void * b)461 array_formats_equal(const void *a, const void *b)
462 {
463    return (intptr_t)a == (intptr_t)b;
464 }
465 
466 static void
format_array_format_table_init(void)467 format_array_format_table_init(void)
468 {
469    const struct mesa_format_info *info;
470    mesa_array_format array_format;
471    unsigned f;
472 
473    format_array_format_table = _mesa_hash_table_create(NULL, NULL,
474                                                        array_formats_equal);
475 
476    if (!format_array_format_table) {
477       _mesa_error_no_memory(__func__);
478       return;
479    }
480 
481    for (f = 1; f < MESA_FORMAT_COUNT; ++f) {
482       info = _mesa_get_format_info(f);
483       if (!info || !info->ArrayFormat)
484          continue;
485 
486       /* All sRGB formats should have an equivalent UNORM format, and that's
487        * the one we want in the table.
488        */
489       if (_mesa_is_format_srgb(f))
490          continue;
491 
492       array_format = _mesa_format_info_to_array_format(info);
493       _mesa_hash_table_insert_pre_hashed(format_array_format_table,
494                                          array_format,
495                                          (void *)(intptr_t)array_format,
496                                          (void *)(intptr_t)f);
497    }
498 
499    atexit(format_array_format_table_destroy);
500 }
501 
502 mesa_format
_mesa_format_from_array_format(uint32_t array_format)503 _mesa_format_from_array_format(uint32_t array_format)
504 {
505    struct hash_entry *entry;
506 
507    assert(_mesa_format_is_mesa_array_format(array_format));
508 
509    call_once(&format_array_format_table_exists, format_array_format_table_init);
510 
511    if (!format_array_format_table) {
512       static const once_flag once_flag_init = ONCE_FLAG_INIT;
513       format_array_format_table_exists = once_flag_init;
514       return MESA_FORMAT_NONE;
515    }
516 
517    entry = _mesa_hash_table_search_pre_hashed(format_array_format_table,
518                                               array_format,
519                                               (void *)(intptr_t)array_format);
520    if (entry)
521       return (intptr_t)entry->data;
522    else
523       return MESA_FORMAT_NONE;
524 }
525 
526 /** Is the given format a compressed format? */
527 bool
_mesa_is_format_compressed(mesa_format format)528 _mesa_is_format_compressed(mesa_format format)
529 {
530    const struct mesa_format_info *info = _mesa_get_format_info(format);
531    return info->BlockWidth > 1 || info->BlockHeight > 1;
532 }
533 
534 
535 /**
536  * Determine if the given format represents a packed depth/stencil buffer.
537  */
538 bool
_mesa_is_format_packed_depth_stencil(mesa_format format)539 _mesa_is_format_packed_depth_stencil(mesa_format format)
540 {
541    const struct mesa_format_info *info = _mesa_get_format_info(format);
542 
543    return info->BaseFormat == GL_DEPTH_STENCIL;
544 }
545 
546 
547 /**
548  * Is the given format a signed/unsigned integer color format?
549  */
550 bool
_mesa_is_format_integer_color(mesa_format format)551 _mesa_is_format_integer_color(mesa_format format)
552 {
553    const struct mesa_format_info *info = _mesa_get_format_info(format);
554    return (info->DataType == GL_INT || info->DataType == GL_UNSIGNED_INT) &&
555       info->BaseFormat != GL_DEPTH_COMPONENT &&
556       info->BaseFormat != GL_DEPTH_STENCIL &&
557       info->BaseFormat != GL_STENCIL_INDEX;
558 }
559 
560 
561 /**
562  * Is the given format an unsigned integer format?
563  */
564 bool
_mesa_is_format_unsigned(mesa_format format)565 _mesa_is_format_unsigned(mesa_format format)
566 {
567    const struct mesa_format_info *info = _mesa_get_format_info(format);
568    return _mesa_is_type_unsigned(info->DataType);
569 }
570 
571 
572 /**
573  * Does the given format store signed values?
574  */
575 bool
_mesa_is_format_signed(mesa_format format)576 _mesa_is_format_signed(mesa_format format)
577 {
578    if (format == MESA_FORMAT_R11G11B10_FLOAT ||
579        format == MESA_FORMAT_R9G9B9E5_FLOAT) {
580       /* these packed float formats only store unsigned values */
581       return false;
582    }
583    else {
584       const struct mesa_format_info *info = _mesa_get_format_info(format);
585       return (info->DataType == GL_SIGNED_NORMALIZED ||
586               info->DataType == GL_INT ||
587               info->DataType == GL_FLOAT);
588    }
589 }
590 
591 /**
592  * Is the given format an integer format?
593  */
594 bool
_mesa_is_format_integer(mesa_format format)595 _mesa_is_format_integer(mesa_format format)
596 {
597    const struct mesa_format_info *info = _mesa_get_format_info(format);
598    return (info->DataType == GL_INT || info->DataType == GL_UNSIGNED_INT);
599 }
600 
601 
602 /**
603  * Return true if the given format is a color format.
604  */
605 bool
_mesa_is_format_color_format(mesa_format format)606 _mesa_is_format_color_format(mesa_format format)
607 {
608    const struct mesa_format_info *info = _mesa_get_format_info(format);
609    switch (info->BaseFormat) {
610    case GL_DEPTH_COMPONENT:
611    case GL_STENCIL_INDEX:
612    case GL_DEPTH_STENCIL:
613       return false;
614    default:
615       return true;
616    }
617 }
618 
619 bool
_mesa_is_format_srgb(mesa_format format)620 _mesa_is_format_srgb(mesa_format format)
621 {
622    const struct mesa_format_info *info = _mesa_get_format_info(format);
623    return info->IsSRGBFormat;
624 }
625 
626 /**
627  * Return TRUE if format is an ETC2 compressed format specified
628  * by GL_ARB_ES3_compatibility.
629  */
630 bool
_mesa_is_format_etc2(mesa_format format)631 _mesa_is_format_etc2(mesa_format format)
632 {
633    return _mesa_get_format_layout(format) == MESA_FORMAT_LAYOUT_ETC2;
634 }
635 
636 
637 /**
638  * Return TRUE if format is an ASTC 2D compressed format.
639  */
640 bool
_mesa_is_format_astc_2d(mesa_format format)641 _mesa_is_format_astc_2d(mesa_format format)
642 {
643    const struct mesa_format_info *info = _mesa_get_format_info(format);
644    return info->Layout == MESA_FORMAT_LAYOUT_ASTC && info->BlockDepth == 1;
645 }
646 
647 
648 /**
649  * Return TRUE if format is an S3TC compressed format.
650  */
651 bool
_mesa_is_format_s3tc(mesa_format format)652 _mesa_is_format_s3tc(mesa_format format)
653 {
654    return _mesa_get_format_layout(format) == MESA_FORMAT_LAYOUT_S3TC;
655 }
656 
657 
658 /**
659  * Return TRUE if format is an RGTC compressed format.
660  */
661 bool
_mesa_is_format_rgtc(mesa_format format)662 _mesa_is_format_rgtc(mesa_format format)
663 {
664    return _mesa_get_format_layout(format) == MESA_FORMAT_LAYOUT_RGTC;
665 }
666 
667 
668 /**
669  * Return TRUE if format is an LATC compressed format.
670  */
671 bool
_mesa_is_format_latc(mesa_format format)672 _mesa_is_format_latc(mesa_format format)
673 {
674    return _mesa_get_format_layout(format) == MESA_FORMAT_LAYOUT_LATC;
675 }
676 
677 
678 /**
679  * Return TRUE if format is an BPTC compressed format.
680  */
681 bool
_mesa_is_format_bptc(mesa_format format)682 _mesa_is_format_bptc(mesa_format format)
683 {
684    return _mesa_get_format_layout(format) == MESA_FORMAT_LAYOUT_BPTC;
685 }
686 
687 
688 /**
689  * If the given format is a compressed format, return a corresponding
690  * uncompressed format.
691  */
692 mesa_format
_mesa_get_uncompressed_format(mesa_format format)693 _mesa_get_uncompressed_format(mesa_format format)
694 {
695    switch (format) {
696    case MESA_FORMAT_RGB_FXT1:
697       return MESA_FORMAT_BGR_UNORM8;
698    case MESA_FORMAT_RGBA_FXT1:
699       return MESA_FORMAT_A8B8G8R8_UNORM;
700    case MESA_FORMAT_RGB_DXT1:
701    case MESA_FORMAT_SRGB_DXT1:
702       return MESA_FORMAT_BGR_UNORM8;
703    case MESA_FORMAT_RGBA_DXT1:
704    case MESA_FORMAT_SRGBA_DXT1:
705       return MESA_FORMAT_A8B8G8R8_UNORM;
706    case MESA_FORMAT_RGBA_DXT3:
707    case MESA_FORMAT_SRGBA_DXT3:
708       return MESA_FORMAT_A8B8G8R8_UNORM;
709    case MESA_FORMAT_RGBA_DXT5:
710    case MESA_FORMAT_SRGBA_DXT5:
711       return MESA_FORMAT_A8B8G8R8_UNORM;
712    case MESA_FORMAT_R_RGTC1_UNORM:
713       return MESA_FORMAT_R_UNORM8;
714    case MESA_FORMAT_R_RGTC1_SNORM:
715       return MESA_FORMAT_R_SNORM8;
716    case MESA_FORMAT_RG_RGTC2_UNORM:
717       return MESA_FORMAT_RG_UNORM8;
718    case MESA_FORMAT_RG_RGTC2_SNORM:
719       return MESA_FORMAT_RG_SNORM8;
720    case MESA_FORMAT_L_LATC1_UNORM:
721       return MESA_FORMAT_L_UNORM8;
722    case MESA_FORMAT_L_LATC1_SNORM:
723       return MESA_FORMAT_L_SNORM8;
724    case MESA_FORMAT_LA_LATC2_UNORM:
725       return MESA_FORMAT_LA_UNORM8;
726    case MESA_FORMAT_LA_LATC2_SNORM:
727       return MESA_FORMAT_LA_SNORM8;
728    case MESA_FORMAT_ETC1_RGB8:
729    case MESA_FORMAT_ETC2_RGB8:
730    case MESA_FORMAT_ETC2_SRGB8:
731    case MESA_FORMAT_ATC_RGB:
732       return MESA_FORMAT_BGR_UNORM8;
733    case MESA_FORMAT_ETC2_RGBA8_EAC:
734    case MESA_FORMAT_ETC2_SRGB8_ALPHA8_EAC:
735    case MESA_FORMAT_ETC2_RGB8_PUNCHTHROUGH_ALPHA1:
736    case MESA_FORMAT_ETC2_SRGB8_PUNCHTHROUGH_ALPHA1:
737    case MESA_FORMAT_ATC_RGBA_EXPLICIT:
738    case MESA_FORMAT_ATC_RGBA_INTERPOLATED:
739       return MESA_FORMAT_A8B8G8R8_UNORM;
740    case MESA_FORMAT_ETC2_R11_EAC:
741    case MESA_FORMAT_ETC2_SIGNED_R11_EAC:
742       return MESA_FORMAT_R_UNORM16;
743    case MESA_FORMAT_ETC2_RG11_EAC:
744    case MESA_FORMAT_ETC2_SIGNED_RG11_EAC:
745       return MESA_FORMAT_RG_UNORM16;
746    case MESA_FORMAT_BPTC_RGBA_UNORM:
747    case MESA_FORMAT_BPTC_SRGB_ALPHA_UNORM:
748       return MESA_FORMAT_A8B8G8R8_UNORM;
749    case MESA_FORMAT_BPTC_RGB_UNSIGNED_FLOAT:
750    case MESA_FORMAT_BPTC_RGB_SIGNED_FLOAT:
751       return MESA_FORMAT_RGB_FLOAT32;
752    default:
753       assert(!_mesa_is_format_compressed(format));
754       return format;
755    }
756 }
757 
758 
759 unsigned int
_mesa_format_num_components(mesa_format format)760 _mesa_format_num_components(mesa_format format)
761 {
762    const struct mesa_format_info *info = _mesa_get_format_info(format);
763    return ((info->RedBits > 0) +
764            (info->GreenBits > 0) +
765            (info->BlueBits > 0) +
766            (info->AlphaBits > 0) +
767            (info->LuminanceBits > 0) +
768            (info->IntensityBits > 0) +
769            (info->DepthBits > 0) +
770            (info->StencilBits > 0));
771 }
772 
773 
774 /**
775  * Returns true if a color format has data stored in the R/G/B/A channels,
776  * given an index from 0 to 3.
777  */
778 bool
_mesa_format_has_color_component(mesa_format format,int component)779 _mesa_format_has_color_component(mesa_format format, int component)
780 {
781    const struct mesa_format_info *info = _mesa_get_format_info(format);
782 
783    assert(info->BaseFormat != GL_DEPTH_COMPONENT &&
784           info->BaseFormat != GL_DEPTH_STENCIL &&
785           info->BaseFormat != GL_STENCIL_INDEX);
786 
787    switch (component) {
788    case 0:
789       return (info->RedBits + info->IntensityBits + info->LuminanceBits) > 0;
790    case 1:
791       return (info->GreenBits + info->IntensityBits + info->LuminanceBits) > 0;
792    case 2:
793       return (info->BlueBits + info->IntensityBits + info->LuminanceBits) > 0;
794    case 3:
795       return (info->AlphaBits + info->IntensityBits) > 0;
796    default:
797       assert(!"Invalid color component: must be 0..3");
798       return false;
799    }
800 }
801 
802 
803 /**
804  * Return number of bytes needed to store an image of the given size
805  * in the given format.
806  */
807 uint32_t
_mesa_format_image_size(mesa_format format,int width,int height,int depth)808 _mesa_format_image_size(mesa_format format, int width,
809                         int height, int depth)
810 {
811    const struct mesa_format_info *info = _mesa_get_format_info(format);
812    uint32_t sz;
813    /* Strictly speaking, a conditional isn't needed here */
814    if (info->BlockWidth > 1 || info->BlockHeight > 1 || info->BlockDepth > 1) {
815       /* compressed format (2D only for now) */
816       const uint32_t bw = info->BlockWidth;
817       const uint32_t bh = info->BlockHeight;
818       const uint32_t bd = info->BlockDepth;
819       const uint32_t wblocks = (width + bw - 1) / bw;
820       const uint32_t hblocks = (height + bh - 1) / bh;
821       const uint32_t dblocks = (depth + bd - 1) / bd;
822       sz = wblocks * hblocks * dblocks * info->BytesPerBlock;
823    } else
824       /* non-compressed */
825       sz = width * height * depth * info->BytesPerBlock;
826 
827    return sz;
828 }
829 
830 
831 /**
832  * Same as _mesa_format_image_size() but returns a 64-bit value to
833  * accommodate very large textures.
834  */
835 uint64_t
_mesa_format_image_size64(mesa_format format,int width,int height,int depth)836 _mesa_format_image_size64(mesa_format format, int width,
837                           int height, int depth)
838 {
839    const struct mesa_format_info *info = _mesa_get_format_info(format);
840    uint64_t sz;
841    /* Strictly speaking, a conditional isn't needed here */
842    if (info->BlockWidth > 1 || info->BlockHeight > 1 || info->BlockDepth > 1) {
843       /* compressed format (2D only for now) */
844       const uint64_t bw = info->BlockWidth;
845       const uint64_t bh = info->BlockHeight;
846       const uint64_t bd = info->BlockDepth;
847       const uint64_t wblocks = (width + bw - 1) / bw;
848       const uint64_t hblocks = (height + bh - 1) / bh;
849       const uint64_t dblocks = (depth + bd - 1) / bd;
850       sz = wblocks * hblocks * dblocks * info->BytesPerBlock;
851    } else
852       /* non-compressed */
853       sz = ((uint64_t) width * (uint64_t) height *
854             (uint64_t) depth * info->BytesPerBlock);
855 
856    return sz;
857 }
858 
859 
860 
861 int32_t
_mesa_format_row_stride(mesa_format format,int width)862 _mesa_format_row_stride(mesa_format format, int width)
863 {
864    const struct mesa_format_info *info = _mesa_get_format_info(format);
865    /* Strictly speaking, a conditional isn't needed here */
866    if (info->BlockWidth > 1 || info->BlockHeight > 1) {
867       /* compressed format */
868       const uint32_t bw = info->BlockWidth;
869       const uint32_t wblocks = (width + bw - 1) / bw;
870       const int32_t stride = wblocks * info->BytesPerBlock;
871       return stride;
872    }
873    else {
874       const int32_t stride = width * info->BytesPerBlock;
875       return stride;
876    }
877 }
878 
879 
880 
881 /**
882  * Return datatype and number of components per texel for the given
883  * uncompressed mesa_format. Only used for mipmap generation code.
884  */
885 GLenum
_mesa_uncompressed_format_to_type(mesa_format format)886 _mesa_uncompressed_format_to_type(mesa_format format)
887 {
888    switch (format) {
889    case MESA_FORMAT_A8B8G8R8_UNORM:
890    case MESA_FORMAT_R8G8B8A8_UNORM:
891    case MESA_FORMAT_B8G8R8A8_UNORM:
892    case MESA_FORMAT_A8R8G8B8_UNORM:
893    case MESA_FORMAT_X8B8G8R8_UNORM:
894    case MESA_FORMAT_R8G8B8X8_UNORM:
895    case MESA_FORMAT_B8G8R8X8_UNORM:
896    case MESA_FORMAT_X8R8G8B8_UNORM:
897    case MESA_FORMAT_A8B8G8R8_UINT:
898    case MESA_FORMAT_R8G8B8A8_UINT:
899    case MESA_FORMAT_B8G8R8A8_UINT:
900    case MESA_FORMAT_A8R8G8B8_UINT:
901    case MESA_FORMAT_BGR_UNORM8:
902    case MESA_FORMAT_RGB_UNORM8:
903    case MESA_FORMAT_LA_UNORM8:
904    case MESA_FORMAT_RG_UNORM8:
905    case MESA_FORMAT_A_UNORM8:
906    case MESA_FORMAT_L_UNORM8:
907    case MESA_FORMAT_I_UNORM8:
908    case MESA_FORMAT_R_UNORM8:
909    case MESA_FORMAT_S_UINT8:
910    case MESA_FORMAT_BGR_SRGB8:
911    case MESA_FORMAT_A8B8G8R8_SRGB:
912    case MESA_FORMAT_B8G8R8A8_SRGB:
913    case MESA_FORMAT_A8R8G8B8_SRGB:
914    case MESA_FORMAT_R8G8B8A8_SRGB:
915    case MESA_FORMAT_L_SRGB8:
916    case MESA_FORMAT_R_SRGB8:
917    case MESA_FORMAT_LA_SRGB8:
918    case MESA_FORMAT_RG_SRGB8:
919    case MESA_FORMAT_A_UINT8:
920    case MESA_FORMAT_L_UINT8:
921    case MESA_FORMAT_I_UINT8:
922    case MESA_FORMAT_LA_UINT8:
923    case MESA_FORMAT_R_UINT8:
924    case MESA_FORMAT_RG_UINT8:
925    case MESA_FORMAT_RGB_UINT8:
926    case MESA_FORMAT_R8G8B8X8_SRGB:
927    case MESA_FORMAT_X8B8G8R8_SRGB:
928    case MESA_FORMAT_RGBX_UINT8:
929    case MESA_FORMAT_B8G8R8X8_SRGB:
930    case MESA_FORMAT_X8R8G8B8_SRGB:
931       return GL_UNSIGNED_BYTE;
932 
933    case MESA_FORMAT_B5G6R5_UNORM:
934    case MESA_FORMAT_R5G6B5_UNORM:
935    case MESA_FORMAT_B5G6R5_UINT:
936    case MESA_FORMAT_R5G6B5_UINT:
937       return GL_UNSIGNED_SHORT_5_6_5;
938 
939    case MESA_FORMAT_B4G4R4A4_UNORM:
940    case MESA_FORMAT_A4R4G4B4_UNORM:
941    case MESA_FORMAT_B4G4R4X4_UNORM:
942    case MESA_FORMAT_B4G4R4A4_UINT:
943    case MESA_FORMAT_A4R4G4B4_UINT:
944    case MESA_FORMAT_A4B4G4R4_UNORM:
945    case MESA_FORMAT_A4B4G4R4_UINT:
946    case MESA_FORMAT_R4G4B4A4_UNORM:
947    case MESA_FORMAT_R4G4B4A4_UINT:
948       return GL_UNSIGNED_SHORT_4_4_4_4;
949 
950    case MESA_FORMAT_B5G5R5A1_UNORM:
951    case MESA_FORMAT_A1R5G5B5_UNORM:
952    case MESA_FORMAT_B5G5R5X1_UNORM:
953    case MESA_FORMAT_B5G5R5A1_UINT:
954    case MESA_FORMAT_A1R5G5B5_UINT:
955    case MESA_FORMAT_R5G5B5A1_UNORM:
956    case MESA_FORMAT_R5G5B5A1_UINT:
957       return GL_UNSIGNED_SHORT_5_5_5_1;
958 
959    case MESA_FORMAT_B10G10R10A2_UNORM:
960    case MESA_FORMAT_B10G10R10A2_UINT:
961    case MESA_FORMAT_R10G10B10A2_UINT:
962    case MESA_FORMAT_B10G10R10X2_UNORM:
963    case MESA_FORMAT_R10G10B10X2_UNORM:
964    case MESA_FORMAT_R10G10B10A2_UNORM:
965       return GL_UNSIGNED_INT_2_10_10_10_REV;
966 
967    case MESA_FORMAT_A1B5G5R5_UNORM:
968    case MESA_FORMAT_A1B5G5R5_UINT:
969    case MESA_FORMAT_X1B5G5R5_UNORM:
970       return GL_UNSIGNED_SHORT_5_5_5_1;
971 
972    case MESA_FORMAT_L4A4_UNORM:
973       return MESA_UNSIGNED_BYTE_4_4;
974 
975    case MESA_FORMAT_LA_UNORM16:
976    case MESA_FORMAT_RG_UNORM16:
977    case MESA_FORMAT_R_UNORM16:
978    case MESA_FORMAT_A_UNORM16:
979    case MESA_FORMAT_L_UNORM16:
980    case MESA_FORMAT_I_UNORM16:
981    case MESA_FORMAT_YCBCR:
982    case MESA_FORMAT_YCBCR_REV:
983    case MESA_FORMAT_RG_RB_UNORM8:
984    case MESA_FORMAT_RB_RG_UNORM8:
985    case MESA_FORMAT_GR_BR_UNORM8:
986    case MESA_FORMAT_BR_GR_UNORM8:
987    case MESA_FORMAT_Z_UNORM16:
988    case MESA_FORMAT_RGBA_UNORM16:
989    case MESA_FORMAT_A_UINT16:
990    case MESA_FORMAT_L_UINT16:
991    case MESA_FORMAT_I_UINT16:
992    case MESA_FORMAT_LA_UINT16:
993    case MESA_FORMAT_R_UINT16:
994    case MESA_FORMAT_RG_UINT16:
995    case MESA_FORMAT_RGB_UINT16:
996    case MESA_FORMAT_RGBA_UINT16:
997    case MESA_FORMAT_RGBX_UNORM16:
998    case MESA_FORMAT_RGBX_UINT16:
999       return GL_UNSIGNED_SHORT;
1000 
1001    case MESA_FORMAT_R3G3B2_UNORM:
1002    case MESA_FORMAT_R3G3B2_UINT:
1003       return GL_UNSIGNED_BYTE_2_3_3_REV;
1004 
1005    case MESA_FORMAT_A2B10G10R10_UNORM:
1006    case MESA_FORMAT_A2B10G10R10_UINT:
1007    case MESA_FORMAT_A2R10G10B10_UNORM:
1008    case MESA_FORMAT_A2R10G10B10_UINT:
1009       return GL_UNSIGNED_INT_10_10_10_2;
1010 
1011    case MESA_FORMAT_B2G3R3_UNORM:
1012    case MESA_FORMAT_B2G3R3_UINT:
1013       return GL_UNSIGNED_BYTE_3_3_2;
1014 
1015    case MESA_FORMAT_S8_UINT_Z24_UNORM:
1016       return GL_UNSIGNED_INT_24_8_MESA;
1017 
1018    case MESA_FORMAT_Z24_UNORM_S8_UINT:
1019       return GL_UNSIGNED_INT_8_24_REV_MESA;
1020 
1021    case MESA_FORMAT_Z24_UNORM_X8_UINT:
1022    case MESA_FORMAT_X8_UINT_Z24_UNORM:
1023    case MESA_FORMAT_Z_UNORM32:
1024    case MESA_FORMAT_A_UINT32:
1025    case MESA_FORMAT_L_UINT32:
1026    case MESA_FORMAT_I_UINT32:
1027    case MESA_FORMAT_LA_UINT32:
1028    case MESA_FORMAT_R_UINT32:
1029    case MESA_FORMAT_RG_UINT32:
1030    case MESA_FORMAT_RGB_UINT32:
1031    case MESA_FORMAT_RGBA_UINT32:
1032    case MESA_FORMAT_RGBX_UINT32:
1033       return GL_UNSIGNED_INT;
1034 
1035    case MESA_FORMAT_Z_FLOAT32:
1036    case MESA_FORMAT_RGBA_FLOAT32:
1037    case MESA_FORMAT_RGB_FLOAT32:
1038    case MESA_FORMAT_LA_FLOAT32:
1039    case MESA_FORMAT_RG_FLOAT32:
1040    case MESA_FORMAT_A_FLOAT32:
1041    case MESA_FORMAT_L_FLOAT32:
1042    case MESA_FORMAT_I_FLOAT32:
1043    case MESA_FORMAT_R_FLOAT32:
1044    case MESA_FORMAT_RGBX_FLOAT32:
1045       return GL_FLOAT;
1046 
1047    case MESA_FORMAT_Z32_FLOAT_S8X24_UINT:
1048       return GL_FLOAT_32_UNSIGNED_INT_24_8_REV;
1049 
1050    case MESA_FORMAT_R_SNORM8:
1051    case MESA_FORMAT_A_SNORM8:
1052    case MESA_FORMAT_L_SNORM8:
1053    case MESA_FORMAT_I_SNORM8:
1054    case MESA_FORMAT_RG_SNORM8:
1055    case MESA_FORMAT_LA_SNORM8:
1056    case MESA_FORMAT_A8B8G8R8_SNORM:
1057    case MESA_FORMAT_R8G8B8A8_SNORM:
1058    case MESA_FORMAT_X8B8G8R8_SNORM:
1059    case MESA_FORMAT_A_SINT8:
1060    case MESA_FORMAT_L_SINT8:
1061    case MESA_FORMAT_I_SINT8:
1062    case MESA_FORMAT_LA_SINT8:
1063    case MESA_FORMAT_R_SINT8:
1064    case MESA_FORMAT_RG_SINT8:
1065    case MESA_FORMAT_RGB_SINT8:
1066    case MESA_FORMAT_RGBA_SINT8:
1067    case MESA_FORMAT_R8G8B8X8_SNORM:
1068    case MESA_FORMAT_RGBX_SINT8:
1069       return GL_BYTE;
1070 
1071    case MESA_FORMAT_R_SNORM16:
1072    case MESA_FORMAT_A_SNORM16:
1073    case MESA_FORMAT_L_SNORM16:
1074    case MESA_FORMAT_I_SNORM16:
1075    case MESA_FORMAT_RG_SNORM16:
1076    case MESA_FORMAT_LA_SNORM16:
1077    case MESA_FORMAT_RGB_SNORM16:
1078    case MESA_FORMAT_RGBA_SNORM16:
1079    case MESA_FORMAT_A_SINT16:
1080    case MESA_FORMAT_L_SINT16:
1081    case MESA_FORMAT_I_SINT16:
1082    case MESA_FORMAT_LA_SINT16:
1083    case MESA_FORMAT_R_SINT16:
1084    case MESA_FORMAT_RG_SINT16:
1085    case MESA_FORMAT_RGB_SINT16:
1086    case MESA_FORMAT_RGBA_SINT16:
1087    case MESA_FORMAT_RGBX_SNORM16:
1088    case MESA_FORMAT_RGBX_SINT16:
1089       return GL_SHORT;
1090 
1091 
1092    case MESA_FORMAT_RGBA_FLOAT16:
1093    case MESA_FORMAT_RGB_FLOAT16:
1094    case MESA_FORMAT_LA_FLOAT16:
1095    case MESA_FORMAT_RG_FLOAT16:
1096    case MESA_FORMAT_A_FLOAT16:
1097    case MESA_FORMAT_L_FLOAT16:
1098    case MESA_FORMAT_I_FLOAT16:
1099    case MESA_FORMAT_R_FLOAT16:
1100    case MESA_FORMAT_RGBX_FLOAT16:
1101       return GL_HALF_FLOAT;
1102 
1103    case MESA_FORMAT_A_SINT32:
1104    case MESA_FORMAT_L_SINT32:
1105    case MESA_FORMAT_I_SINT32:
1106    case MESA_FORMAT_LA_SINT32:
1107    case MESA_FORMAT_R_SINT32:
1108    case MESA_FORMAT_RG_SINT32:
1109    case MESA_FORMAT_RGB_SINT32:
1110    case MESA_FORMAT_RGBA_SINT32:
1111    case MESA_FORMAT_RGBX_SINT32:
1112       return GL_INT;
1113 
1114    case MESA_FORMAT_R9G9B9E5_FLOAT:
1115       return GL_UNSIGNED_INT_5_9_9_9_REV;
1116 
1117    case MESA_FORMAT_R11G11B10_FLOAT:
1118       return GL_UNSIGNED_INT_10F_11F_11F_REV;
1119 
1120    case MESA_FORMAT_COUNT:
1121       assert(0);
1122       return GL_NONE;
1123    default: {
1124       const char *name = _mesa_get_format_name(format);
1125       /* Warn if any formats are not handled */
1126       _mesa_problem(NULL, "bad format %s in _mesa_uncompressed_format_to_type_and_comps",
1127                     name ? name : "???");
1128       assert(format == MESA_FORMAT_NONE ||
1129              _mesa_is_format_compressed(format));
1130       return GL_NONE;
1131    }
1132    }
1133 }
1134 
1135 /**
1136  * Check if a mesa_format exactly matches a GL format/type combination
1137  * such that we can use memcpy() from one to the other.
1138  * \param mesa_format  a MESA_FORMAT_x value
1139  * \param format  the user-specified image format
1140  * \param type  the user-specified image datatype
1141  * \param swapBytes  typically the current pixel pack/unpack byteswap state
1142  * \param[out] error GL_NO_ERROR if format is an expected input.
1143  *                   GL_INVALID_ENUM if format is an unexpected input.
1144  * \return true if the formats match, false otherwise.
1145  */
1146 bool
_mesa_format_matches_format_and_type(mesa_format mformat,GLenum format,GLenum type,bool swapBytes,GLenum * error)1147 _mesa_format_matches_format_and_type(mesa_format mformat,
1148 				     GLenum format, GLenum type,
1149 				     bool swapBytes, GLenum *error)
1150 {
1151    if (error)
1152       *error = GL_NO_ERROR;
1153 
1154    if (_mesa_is_format_compressed(mformat)) {
1155       if (error)
1156          *error = GL_INVALID_ENUM;
1157       return false;
1158    }
1159 
1160    if (swapBytes && !_mesa_swap_bytes_in_type_enum(&type))
1161       return false;
1162 
1163    /* format/type don't include srgb and should match regardless of it. */
1164    mformat = _mesa_get_srgb_format_linear(mformat);
1165 
1166    /* intensity formats are uploaded with GL_RED, and we want to find
1167     * memcpy matches for them.
1168     */
1169    mformat = _mesa_get_intensity_format_red(mformat);
1170 
1171    if (format == GL_COLOR_INDEX)
1172       return false;
1173 
1174    mesa_format other_format = _mesa_format_from_format_and_type(format, type);
1175    if (_mesa_format_is_mesa_array_format(other_format))
1176       other_format = _mesa_format_from_array_format(other_format);
1177 
1178    return other_format == mformat;
1179 }
1180 
1181