2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
6 * Copyright (c) 2008 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.
29 * Helper functions for texture compression.
37 #include "mfeatures.h"
39 #include "texcompress.h"
43 * Return list of (and count of) all specific texture compression
44 * formats that are supported.
46 * \param ctx the GL context
47 * \param formats the resulting format list (may be NULL).
48 * \param all if true return all formats, even those with some kind
49 * of restrictions/limitations (See GL_ARB_texture_compression
50 * spec for more info).
52 * \return number of formats.
55 _mesa_get_compressed_formats(struct gl_context
*ctx
, GLint
*formats
, GLboolean all
)
58 if (ctx
->Extensions
.TDFX_texture_compression_FXT1
) {
60 formats
[n
++] = GL_COMPRESSED_RGB_FXT1_3DFX
;
61 formats
[n
++] = GL_COMPRESSED_RGBA_FXT1_3DFX
;
67 /* don't return RGTC - ARB_texture_compression_rgtc query 19 */
68 if (ctx
->Extensions
.EXT_texture_compression_s3tc
) {
70 formats
[n
++] = GL_COMPRESSED_RGB_S3TC_DXT1_EXT
;
71 /* This format has some restrictions/limitations and so should
72 * not be returned via the GL_COMPRESSED_TEXTURE_FORMATS query.
73 * Specifically, all transparent pixels become black. NVIDIA
74 * omits this format too.
77 formats
[n
++] = GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
;
78 formats
[n
++] = GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
;
79 formats
[n
++] = GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
;
87 if (ctx
->Extensions
.S3_s3tc
) {
89 formats
[n
++] = GL_RGB_S3TC
;
90 formats
[n
++] = GL_RGB4_S3TC
;
91 formats
[n
++] = GL_RGBA_S3TC
;
92 formats
[n
++] = GL_RGBA4_S3TC
;
98 #if FEATURE_EXT_texture_sRGB
99 if (ctx
->Extensions
.EXT_texture_sRGB
) {
101 formats
[n
++] = GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
;
102 formats
[n
++] = GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
;
103 formats
[n
++] = GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
;
104 formats
[n
++] = GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
;
110 #endif /* FEATURE_EXT_texture_sRGB */
113 #if FEATURE_ES1 || FEATURE_ES2
115 formats
[n
++] = GL_PALETTE4_RGB8_OES
;
116 formats
[n
++] = GL_PALETTE4_RGBA8_OES
;
117 formats
[n
++] = GL_PALETTE4_R5_G6_B5_OES
;
118 formats
[n
++] = GL_PALETTE4_RGBA4_OES
;
119 formats
[n
++] = GL_PALETTE4_RGB5_A1_OES
;
120 formats
[n
++] = GL_PALETTE8_RGB8_OES
;
121 formats
[n
++] = GL_PALETTE8_RGBA8_OES
;
122 formats
[n
++] = GL_PALETTE8_R5_G6_B5_OES
;
123 formats
[n
++] = GL_PALETTE8_RGBA4_OES
;
124 formats
[n
++] = GL_PALETTE8_RGB5_A1_OES
;
134 * Convert a compressed MESA_FORMAT_x to a GLenum.
137 _mesa_glenum_to_compressed_format(GLenum format
)
140 case GL_COMPRESSED_RGB_FXT1_3DFX
:
141 return MESA_FORMAT_RGB_FXT1
;
142 case GL_COMPRESSED_RGBA_FXT1_3DFX
:
143 return MESA_FORMAT_RGBA_FXT1
;
145 case GL_COMPRESSED_RGB_S3TC_DXT1_EXT
:
147 return MESA_FORMAT_RGB_DXT1
;
148 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
:
150 return MESA_FORMAT_RGBA_DXT1
;
151 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
:
153 return MESA_FORMAT_RGBA_DXT3
;
154 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
:
156 return MESA_FORMAT_RGBA_DXT5
;
158 case GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
:
159 return MESA_FORMAT_SRGB_DXT1
;
160 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
:
161 return MESA_FORMAT_SRGBA_DXT1
;
162 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
:
163 return MESA_FORMAT_SRGBA_DXT3
;
164 case GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
:
165 return MESA_FORMAT_SRGBA_DXT5
;
167 case GL_COMPRESSED_RED_RGTC1
:
168 return MESA_FORMAT_RED_RGTC1
;
169 case GL_COMPRESSED_SIGNED_RED_RGTC1
:
170 return MESA_FORMAT_SIGNED_RED_RGTC1
;
171 case GL_COMPRESSED_RG_RGTC2
:
172 return MESA_FORMAT_RG_RGTC2
;
173 case GL_COMPRESSED_SIGNED_RG_RGTC2
:
174 return MESA_FORMAT_SIGNED_RG_RGTC2
;
176 case GL_COMPRESSED_LUMINANCE_LATC1_EXT
:
177 return MESA_FORMAT_L_LATC1
;
178 case GL_COMPRESSED_SIGNED_LUMINANCE_LATC1_EXT
:
179 return MESA_FORMAT_SIGNED_L_LATC1
;
180 case GL_COMPRESSED_LUMINANCE_ALPHA_LATC2_EXT
:
181 return MESA_FORMAT_LA_LATC2
;
182 case GL_COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2_EXT
:
183 return MESA_FORMAT_SIGNED_LA_LATC2
;
186 return MESA_FORMAT_NONE
;
192 * Given a compressed MESA_FORMAT_x value, return the corresponding
193 * GLenum for that format.
194 * This is needed for glGetTexLevelParameter(GL_TEXTURE_INTERNAL_FORMAT)
195 * which must return the specific texture format used when the user might
196 * have originally specified a generic compressed format in their
197 * glTexImage2D() call.
198 * For non-compressed textures, we always return the user-specified
199 * internal format unchanged.
202 _mesa_compressed_format_to_glenum(struct gl_context
*ctx
, GLuint mesaFormat
)
204 switch (mesaFormat
) {
205 #if FEATURE_texture_fxt1
206 case MESA_FORMAT_RGB_FXT1
:
207 return GL_COMPRESSED_RGB_FXT1_3DFX
;
208 case MESA_FORMAT_RGBA_FXT1
:
209 return GL_COMPRESSED_RGBA_FXT1_3DFX
;
211 #if FEATURE_texture_s3tc
212 case MESA_FORMAT_RGB_DXT1
:
213 return GL_COMPRESSED_RGB_S3TC_DXT1_EXT
;
214 case MESA_FORMAT_RGBA_DXT1
:
215 return GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
;
216 case MESA_FORMAT_RGBA_DXT3
:
217 return GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
;
218 case MESA_FORMAT_RGBA_DXT5
:
219 return GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
;
220 #if FEATURE_EXT_texture_sRGB
221 case MESA_FORMAT_SRGB_DXT1
:
222 return GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
;
223 case MESA_FORMAT_SRGBA_DXT1
:
224 return GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
;
225 case MESA_FORMAT_SRGBA_DXT3
:
226 return GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
;
227 case MESA_FORMAT_SRGBA_DXT5
:
228 return GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
;
232 case MESA_FORMAT_RED_RGTC1
:
233 return GL_COMPRESSED_RED_RGTC1
;
234 case MESA_FORMAT_SIGNED_RED_RGTC1
:
235 return GL_COMPRESSED_SIGNED_RED_RGTC1
;
236 case MESA_FORMAT_RG_RGTC2
:
237 return GL_COMPRESSED_RG_RGTC2
;
238 case MESA_FORMAT_SIGNED_RG_RGTC2
:
239 return GL_COMPRESSED_SIGNED_RG_RGTC2
;
241 case MESA_FORMAT_L_LATC1
:
242 return GL_COMPRESSED_LUMINANCE_LATC1_EXT
;
243 case MESA_FORMAT_SIGNED_L_LATC1
:
244 return GL_COMPRESSED_SIGNED_LUMINANCE_LATC1_EXT
;
245 case MESA_FORMAT_LA_LATC2
:
246 return GL_COMPRESSED_LUMINANCE_ALPHA_LATC2_EXT
;
247 case MESA_FORMAT_SIGNED_LA_LATC2
:
248 return GL_COMPRESSED_SIGNED_LUMINANCE_ALPHA_LATC2_EXT
;
251 _mesa_problem(ctx
, "Unexpected mesa texture format in"
252 " _mesa_compressed_format_to_glenum()");
259 * Return the address of the pixel at (col, row, img) in a
260 * compressed texture image.
261 * \param col, row, img - image position (3D), should be a multiple of the
262 * format's block size.
263 * \param format - compressed image format
264 * \param width - image width (stride) in pixels
265 * \param image - the image address
266 * \return address of pixel at (row, col, img)
269 _mesa_compressed_image_address(GLint col
, GLint row
, GLint img
,
270 gl_format mesaFormat
,
271 GLsizei width
, const GLubyte
*image
)
273 /* XXX only 2D images implemented, not 3D */
274 const GLuint blockSize
= _mesa_get_format_bytes(mesaFormat
);
278 _mesa_get_format_block_size(mesaFormat
, &bw
, &bh
);
280 ASSERT(col
% bw
== 0);
281 ASSERT(row
% bh
== 0);
283 offset
= ((width
+ bw
- 1) / bw
) * (row
/ bh
) + col
/ bw
;
286 return (GLubyte
*) image
+ offset
;