1 /*
2 * Mesa 3-D graphics library
3 *
4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
5 * Copyright (C) 1999-2013 VMware, Inc. All Rights Reserved.
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 /*
28 * glGenerateMipmap function
29 */
30
31 #include "context.h"
32 #include "enums.h"
33 #include "genmipmap.h"
34 #include "glformats.h"
35 #include "macros.h"
36 #include "mtypes.h"
37 #include "teximage.h"
38 #include "texobj.h"
39 #include "hash.h"
40
41 bool
_mesa_is_valid_generate_texture_mipmap_target(struct gl_context * ctx,GLenum target)42 _mesa_is_valid_generate_texture_mipmap_target(struct gl_context *ctx,
43 GLenum target)
44 {
45 bool error;
46
47 switch (target) {
48 case GL_TEXTURE_1D:
49 error = _mesa_is_gles(ctx);
50 break;
51 case GL_TEXTURE_2D:
52 error = false;
53 break;
54 case GL_TEXTURE_3D:
55 error = ctx->API == API_OPENGLES;
56 break;
57 case GL_TEXTURE_CUBE_MAP:
58 error = !ctx->Extensions.ARB_texture_cube_map;
59 break;
60 case GL_TEXTURE_1D_ARRAY:
61 error = _mesa_is_gles(ctx) || !ctx->Extensions.EXT_texture_array;
62 break;
63 case GL_TEXTURE_2D_ARRAY:
64 error = (_mesa_is_gles(ctx) && ctx->Version < 30)
65 || !ctx->Extensions.EXT_texture_array;
66 break;
67 case GL_TEXTURE_CUBE_MAP_ARRAY:
68 error = !_mesa_has_texture_cube_map_array(ctx);
69 break;
70 default:
71 error = true;
72 }
73
74 return !error;
75 }
76
77 bool
_mesa_is_valid_generate_texture_mipmap_internalformat(struct gl_context * ctx,GLenum internalformat)78 _mesa_is_valid_generate_texture_mipmap_internalformat(struct gl_context *ctx,
79 GLenum internalformat)
80 {
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."
87 *
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.
91 */
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));
98 }
99
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));
104 }
105
106 /**
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.
110 */
111 static ALWAYS_INLINE void
generate_texture_mipmap(struct gl_context * ctx,struct gl_texture_object * texObj,GLenum target,const char * caller)112 generate_texture_mipmap(struct gl_context *ctx,
113 struct gl_texture_object *texObj, GLenum target,
114 const char* caller)
115 {
116 struct gl_texture_image *srcImage;
117
118 FLUSH_VERTICES(ctx, 0);
119
120 if (texObj->BaseLevel >= texObj->MaxLevel) {
121 /* nothing to do */
122 return;
123 }
124
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);
129 return;
130 }
131
132 _mesa_lock_texture(ctx, texObj);
133
134 srcImage = _mesa_select_tex_image(texObj, target, texObj->BaseLevel);
135 if (caller) {
136 if (!srcImage) {
137 _mesa_unlock_texture(ctx, texObj);
138 _mesa_error(ctx, GL_INVALID_OPERATION,
139 "%s(zero size base image)", caller);
140 return;
141 }
142
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));
149 return;
150 }
151 }
152
153 if (srcImage->Width == 0 || srcImage->Height == 0) {
154 _mesa_unlock_texture(ctx, texObj);
155 return;
156 }
157
158 if (target == GL_TEXTURE_CUBE_MAP) {
159 GLuint face;
160 for (face = 0; face < 6; face++) {
161 ctx->Driver.GenerateMipmap(ctx,
162 GL_TEXTURE_CUBE_MAP_POSITIVE_X + face, texObj);
163 }
164 }
165 else {
166 ctx->Driver.GenerateMipmap(ctx, target, texObj);
167 }
168 _mesa_unlock_texture(ctx, texObj);
169 }
170
171 /**
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.
175 */
176 void GLAPIENTRY
_mesa_GenerateMipmap_no_error(GLenum target)177 _mesa_GenerateMipmap_no_error(GLenum target)
178 {
179 GET_CURRENT_CONTEXT(ctx);
180
181 struct gl_texture_object *texObj = _mesa_get_current_tex_object(ctx, target);
182 generate_texture_mipmap(ctx, texObj, target, NULL);
183 }
184
185 void GLAPIENTRY
_mesa_GenerateMipmap(GLenum target)186 _mesa_GenerateMipmap(GLenum target)
187 {
188 struct gl_texture_object *texObj;
189 GET_CURRENT_CONTEXT(ctx);
190
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));
194 return;
195 }
196
197 texObj = _mesa_get_current_tex_object(ctx, target);
198 if (!texObj)
199 return;
200
201 generate_texture_mipmap(ctx, texObj, target, "glGenerateMipmap");
202 }
203
204 /**
205 * Generate all the mipmap levels below the base level.
206 */
207 void GLAPIENTRY
_mesa_GenerateTextureMipmap_no_error(GLuint texture)208 _mesa_GenerateTextureMipmap_no_error(GLuint texture)
209 {
210 GET_CURRENT_CONTEXT(ctx);
211
212 struct gl_texture_object *texObj = _mesa_lookup_texture(ctx, texture);
213 generate_texture_mipmap(ctx, texObj, texObj->Target, NULL);
214 }
215
216 static void
validate_params_and_generate_mipmap(struct gl_texture_object * texObj,const char * caller)217 validate_params_and_generate_mipmap(struct gl_texture_object *texObj, const char* caller)
218 {
219 GET_CURRENT_CONTEXT(ctx);
220
221 if (!texObj)
222 return;
223
224 if (!_mesa_is_valid_generate_texture_mipmap_target(ctx, texObj->Target)) {
225 _mesa_error(ctx, GL_INVALID_ENUM, "%s(target=%s)",
226 caller,
227 _mesa_enum_to_string(texObj->Target));
228 return;
229 }
230
231 generate_texture_mipmap(ctx, texObj, texObj->Target, caller);
232 }
233
234 void GLAPIENTRY
_mesa_GenerateTextureMipmap(GLuint texture)235 _mesa_GenerateTextureMipmap(GLuint texture)
236 {
237 struct gl_texture_object *texObj;
238 GET_CURRENT_CONTEXT(ctx);
239
240 texObj = _mesa_lookup_texture_err(ctx, texture, "glGenerateTextureMipmap");
241 validate_params_and_generate_mipmap(texObj, "glGenerateTextureMipmap");
242 }
243
244 void GLAPIENTRY
_mesa_GenerateTextureMipmapEXT(GLuint texture,GLenum target)245 _mesa_GenerateTextureMipmapEXT(GLuint texture, GLenum target)
246 {
247 struct gl_texture_object *texObj;
248 GET_CURRENT_CONTEXT(ctx);
249
250 texObj = _mesa_lookup_or_create_texture(ctx, target, texture,
251 false, true,
252 "glGenerateTextureMipmapEXT");
253 validate_params_and_generate_mipmap(texObj,
254 "glGenerateTextureMipmapEXT");
255 }
256
257 void GLAPIENTRY
_mesa_GenerateMultiTexMipmapEXT(GLenum texunit,GLenum target)258 _mesa_GenerateMultiTexMipmapEXT(GLenum texunit, GLenum target)
259 {
260 struct gl_texture_object *texObj;
261 GET_CURRENT_CONTEXT(ctx);
262
263 texObj = _mesa_get_texobj_by_target_and_texunit(ctx, target,
264 texunit - GL_TEXTURE0,
265 true,
266 "glGenerateMultiTexMipmapEXT");
267 validate_params_and_generate_mipmap(texObj,
268 "glGenerateMultiTexMipmapEXT");
269 }
270