2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
5 * Copyright (C) 1999-2013 VMware, Inc. All Rights Reserved.
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:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
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.
28 * glGenerateMipmap function
33 #include "genmipmap.h"
34 #include "glformats.h"
42 _mesa_is_valid_generate_texture_mipmap_target(struct gl_context
*ctx
,
49 error
= _mesa_is_gles(ctx
);
55 error
= ctx
->API
== API_OPENGLES
;
57 case GL_TEXTURE_CUBE_MAP
:
58 error
= !ctx
->Extensions
.ARB_texture_cube_map
;
60 case GL_TEXTURE_1D_ARRAY
:
61 error
= _mesa_is_gles(ctx
) || !ctx
->Extensions
.EXT_texture_array
;
63 case GL_TEXTURE_2D_ARRAY
:
64 error
= (_mesa_is_gles(ctx
) && ctx
->Version
< 30)
65 || !ctx
->Extensions
.EXT_texture_array
;
67 case GL_TEXTURE_CUBE_MAP_ARRAY
:
68 error
= !_mesa_has_texture_cube_map_array(ctx
);
78 _mesa_is_valid_generate_texture_mipmap_internalformat(struct gl_context
*ctx
,
79 GLenum internalformat
)
81 if (_mesa_is_gles3(ctx
)) {
82 /* From the ES 3.2 specification's description of GenerateMipmap():
83 * "An INVALID_OPERATION error is generated if the levelbase array was
84 * not specified with an unsized internal format from table 8.3 or a
85 * sized internal format that is both color-renderable and
86 * texture-filterable according to table 8.10."
88 * GL_EXT_texture_format_BGRA8888 adds a GL_BGRA_EXT unsized internal
89 * format, and includes it in a very similar looking table. So we
90 * include it here as well.
92 return internalformat
== GL_RGBA
|| internalformat
== GL_RGB
||
93 internalformat
== GL_LUMINANCE_ALPHA
||
94 internalformat
== GL_LUMINANCE
|| internalformat
== GL_ALPHA
||
95 internalformat
== GL_BGRA_EXT
||
96 (_mesa_is_es3_color_renderable(ctx
, internalformat
) &&
97 _mesa_is_es3_texture_filterable(ctx
, internalformat
));
100 return (!_mesa_is_enum_format_integer(internalformat
) &&
101 !_mesa_is_depthstencil_format(internalformat
) &&
102 !_mesa_is_astc_format(internalformat
) &&
103 !_mesa_is_stencil_format(internalformat
));
107 * Implements glGenerateMipmap and glGenerateTextureMipmap.
108 * Generates all the mipmap levels below the base level.
109 * Error-checking is done only if caller is not NULL.
111 static ALWAYS_INLINE
void
112 generate_texture_mipmap(struct gl_context
*ctx
,
113 struct gl_texture_object
*texObj
, GLenum target
,
116 struct gl_texture_image
*srcImage
;
118 FLUSH_VERTICES(ctx
, 0);
120 if (texObj
->BaseLevel
>= texObj
->MaxLevel
) {
125 if (caller
&& texObj
->Target
== GL_TEXTURE_CUBE_MAP
&&
126 !_mesa_cube_complete(texObj
)) {
127 _mesa_error(ctx
, GL_INVALID_OPERATION
,
128 "%s(incomplete cube map)", caller
);
132 _mesa_lock_texture(ctx
, texObj
);
134 srcImage
= _mesa_select_tex_image(texObj
, target
, texObj
->BaseLevel
);
137 _mesa_unlock_texture(ctx
, texObj
);
138 _mesa_error(ctx
, GL_INVALID_OPERATION
,
139 "%s(zero size base image)", caller
);
143 if (!_mesa_is_valid_generate_texture_mipmap_internalformat(ctx
,
144 srcImage
->InternalFormat
)) {
145 _mesa_unlock_texture(ctx
, texObj
);
146 _mesa_error(ctx
, GL_INVALID_OPERATION
,
147 "%s(invalid internal format %s)", caller
,
148 _mesa_enum_to_string(srcImage
->InternalFormat
));
153 if (srcImage
->Width
== 0 || srcImage
->Height
== 0) {
154 _mesa_unlock_texture(ctx
, texObj
);
158 if (target
== GL_TEXTURE_CUBE_MAP
) {
160 for (face
= 0; face
< 6; face
++) {
161 ctx
->Driver
.GenerateMipmap(ctx
,
162 GL_TEXTURE_CUBE_MAP_POSITIVE_X
+ face
, texObj
);
166 ctx
->Driver
.GenerateMipmap(ctx
, target
, texObj
);
168 _mesa_unlock_texture(ctx
, texObj
);
172 * Generate all the mipmap levels below the base level.
173 * Note: this GL function would be more useful if one could specify a
174 * cube face, a set of array slices, etc.
177 _mesa_GenerateMipmap_no_error(GLenum target
)
179 GET_CURRENT_CONTEXT(ctx
);
181 struct gl_texture_object
*texObj
= _mesa_get_current_tex_object(ctx
, target
);
182 generate_texture_mipmap(ctx
, texObj
, target
, NULL
);
186 _mesa_GenerateMipmap(GLenum target
)
188 struct gl_texture_object
*texObj
;
189 GET_CURRENT_CONTEXT(ctx
);
191 if (!_mesa_is_valid_generate_texture_mipmap_target(ctx
, target
)) {
192 _mesa_error(ctx
, GL_INVALID_ENUM
, "glGenerateMipmap(target=%s)",
193 _mesa_enum_to_string(target
));
197 texObj
= _mesa_get_current_tex_object(ctx
, target
);
201 generate_texture_mipmap(ctx
, texObj
, target
, "glGenerateMipmap");
205 * Generate all the mipmap levels below the base level.
208 _mesa_GenerateTextureMipmap_no_error(GLuint texture
)
210 GET_CURRENT_CONTEXT(ctx
);
212 struct gl_texture_object
*texObj
= _mesa_lookup_texture(ctx
, texture
);
213 generate_texture_mipmap(ctx
, texObj
, texObj
->Target
, NULL
);
217 validate_params_and_generate_mipmap(struct gl_texture_object
*texObj
, const char* caller
)
219 GET_CURRENT_CONTEXT(ctx
);
224 if (!_mesa_is_valid_generate_texture_mipmap_target(ctx
, texObj
->Target
)) {
225 _mesa_error(ctx
, GL_INVALID_ENUM
, "%s(target=%s)",
227 _mesa_enum_to_string(texObj
->Target
));
231 generate_texture_mipmap(ctx
, texObj
, texObj
->Target
, caller
);
235 _mesa_GenerateTextureMipmap(GLuint texture
)
237 struct gl_texture_object
*texObj
;
238 GET_CURRENT_CONTEXT(ctx
);
240 texObj
= _mesa_lookup_texture_err(ctx
, texture
, "glGenerateTextureMipmap");
241 validate_params_and_generate_mipmap(texObj
, "glGenerateTextureMipmap");