3 * A collection of format conversion utility functions.
7 * Mesa 3-D graphics library
9 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
10 * Copyright (C) 2014 Intel Corporation All Rights Reserved.
12 * Permission is hereby granted, free of charge, to any person obtaining a
13 * copy of this software and associated documentation files (the "Software"),
14 * to deal in the Software without restriction, including without limitation
15 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
16 * and/or sell copies of the Software, and to permit persons to whom the
17 * Software is furnished to do so, subject to the following conditions:
19 * The above copyright notice and this permission notice shall be included
20 * in all copies or substantial portions of the Software.
22 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
23 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
25 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
26 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
27 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
28 * OTHER DEALINGS IN THE SOFTWARE.
31 #ifndef FORMAT_UTILS_H
32 #define FORMAT_UTILS_H
37 #include "util/rounding.h"
38 #include "util/half_float.h"
40 extern const mesa_array_format RGBA32_FLOAT
;
41 extern const mesa_array_format RGBA8_UBYTE
;
42 extern const mesa_array_format RGBA32_UINT
;
43 extern const mesa_array_format RGBA32_INT
;
45 /* Only guaranteed to work for BITS <= 32 */
46 #define MAX_UINT(BITS) ((BITS) == 32 ? UINT32_MAX : ((1u << (BITS)) - 1))
47 #define MAX_INT(BITS) ((int)MAX_UINT((BITS) - 1))
48 #define MIN_INT(BITS) ((BITS) == 32 ? INT32_MIN : (-(1 << (BITS - 1))))
50 /* Extends an integer of size SRC_BITS to one of size DST_BITS linearly */
51 #define EXTEND_NORMALIZED_INT(X, SRC_BITS, DST_BITS) \
52 (((X) * (int)(MAX_UINT(DST_BITS) / MAX_UINT(SRC_BITS))) + \
53 ((DST_BITS % SRC_BITS) ? ((X) >> (SRC_BITS - DST_BITS % SRC_BITS)) : 0))
56 _mesa_unorm_to_float(unsigned x
, unsigned src_bits
)
58 return x
* (1.0f
/ (float)MAX_UINT(src_bits
));
62 _mesa_snorm_to_float(int x
, unsigned src_bits
)
64 if (x
<= -MAX_INT(src_bits
))
67 return x
* (1.0f
/ (float)MAX_INT(src_bits
));
70 static inline uint16_t
71 _mesa_unorm_to_half(unsigned x
, unsigned src_bits
)
73 return _mesa_float_to_half(_mesa_unorm_to_float(x
, src_bits
));
76 static inline uint16_t
77 _mesa_snorm_to_half(int x
, unsigned src_bits
)
79 return _mesa_float_to_half(_mesa_snorm_to_float(x
, src_bits
));
82 static inline unsigned
83 _mesa_float_to_unorm(float x
, unsigned dst_bits
)
88 return MAX_UINT(dst_bits
);
90 return _mesa_lroundevenf(x
* MAX_UINT(dst_bits
));
93 static inline unsigned
94 _mesa_half_to_unorm(uint16_t x
, unsigned dst_bits
)
96 return _mesa_float_to_unorm(_mesa_half_to_float(x
), dst_bits
);
99 static inline unsigned
100 _mesa_unorm_to_unorm(unsigned x
, unsigned src_bits
, unsigned dst_bits
)
102 if (src_bits
< dst_bits
) {
103 return EXTEND_NORMALIZED_INT(x
, src_bits
, dst_bits
);
104 } else if (src_bits
> dst_bits
) {
105 unsigned src_half
= (1 << (src_bits
- 1)) - 1;
107 if (src_bits
+ dst_bits
> sizeof(x
) * 8) {
108 assert(src_bits
+ dst_bits
<= sizeof(uint64_t) * 8);
109 return (((uint64_t) x
* MAX_UINT(dst_bits
) + src_half
) /
112 return (x
* MAX_UINT(dst_bits
) + src_half
) / MAX_UINT(src_bits
);
119 static inline unsigned
120 _mesa_snorm_to_unorm(int x
, unsigned src_bits
, unsigned dst_bits
)
125 return _mesa_unorm_to_unorm(x
, src_bits
- 1, dst_bits
);
129 _mesa_float_to_snorm(float x
, unsigned dst_bits
)
132 return -MAX_INT(dst_bits
);
134 return MAX_INT(dst_bits
);
136 return _mesa_lroundevenf(x
* MAX_INT(dst_bits
));
140 _mesa_half_to_snorm(uint16_t x
, unsigned dst_bits
)
142 return _mesa_float_to_snorm(_mesa_half_to_float(x
), dst_bits
);
146 _mesa_unorm_to_snorm(unsigned x
, unsigned src_bits
, unsigned dst_bits
)
148 return _mesa_unorm_to_unorm(x
, src_bits
, dst_bits
- 1);
152 _mesa_snorm_to_snorm(int x
, unsigned src_bits
, unsigned dst_bits
)
154 if (x
< -MAX_INT(src_bits
))
155 return -MAX_INT(dst_bits
);
156 else if (src_bits
< dst_bits
)
157 return EXTEND_NORMALIZED_INT(x
, src_bits
- 1, dst_bits
- 1);
159 return x
>> (src_bits
- dst_bits
);
162 static inline unsigned
163 _mesa_unsigned_to_unsigned(unsigned src
, unsigned dst_size
)
165 return MIN2(src
, MAX_UINT(dst_size
));
169 _mesa_unsigned_to_signed(unsigned src
, unsigned dst_size
)
171 return MIN2(src
, (unsigned)MAX_INT(dst_size
));
175 _mesa_signed_to_signed(int src
, unsigned dst_size
)
177 return CLAMP(src
, MIN_INT(dst_size
), MAX_INT(dst_size
));
180 static inline unsigned
181 _mesa_signed_to_unsigned(int src
, unsigned dst_size
)
183 return CLAMP(src
, 0, MAX_UINT(dst_size
));
186 static inline unsigned
187 _mesa_float_to_unsigned(float src
, unsigned dst_bits
)
191 if (src
> (float)MAX_UINT(dst_bits
))
192 return MAX_UINT(dst_bits
);
193 return _mesa_signed_to_unsigned(src
, dst_bits
);
196 static inline unsigned
197 _mesa_float_to_signed(float src
, unsigned dst_bits
)
199 if (src
< (float)(-MAX_INT(dst_bits
)))
200 return -MAX_INT(dst_bits
);
201 if (src
> (float)MAX_INT(dst_bits
))
202 return MAX_INT(dst_bits
);
203 return _mesa_signed_to_signed(src
, dst_bits
);
206 static inline unsigned
207 _mesa_half_to_unsigned(uint16_t src
, unsigned dst_bits
)
209 if (_mesa_half_is_negative(src
))
211 return _mesa_unsigned_to_unsigned(_mesa_float_to_half(src
), dst_bits
);
214 static inline unsigned
215 _mesa_half_to_signed(uint16_t src
, unsigned dst_bits
)
217 return _mesa_float_to_signed(_mesa_half_to_float(src
), dst_bits
);
221 _mesa_format_to_array(mesa_format
, GLenum
*type
, int *num_components
,
222 uint8_t swizzle
[4], bool *normalized
);
225 _mesa_swizzle_and_convert(void *dst
,
226 enum mesa_array_format_datatype dst_type
,
227 int num_dst_channels
,
229 enum mesa_array_format_datatype src_type
,
230 int num_src_channels
,
231 const uint8_t swizzle
[4], bool normalized
, int count
);
234 _mesa_compute_rgba2base2rgba_component_mapping(GLenum baseFormat
, uint8_t *map
);
237 _mesa_format_convert(void *void_dst
, uint32_t dst_format
, size_t dst_stride
,
238 void *void_src
, uint32_t src_format
, size_t src_stride
,
239 size_t width
, size_t height
, uint8_t *rebase_swizzle
);