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(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  */
110 void
_mesa_generate_texture_mipmap(struct gl_context * ctx,struct gl_texture_object * texObj,GLenum target,bool dsa)111 _mesa_generate_texture_mipmap(struct gl_context *ctx,
112                               struct gl_texture_object *texObj, GLenum target,
113                               bool dsa)
114 {
115    struct gl_texture_image *srcImage;
116    const char *suffix = dsa ? "Texture" : "";
117 
118    FLUSH_VERTICES(ctx, 0);
119 
120    if (texObj->BaseLevel >= texObj->MaxLevel) {
121       /* nothing to do */
122       return;
123    }
124 
125    if (texObj->Target == GL_TEXTURE_CUBE_MAP &&
126        !_mesa_cube_complete(texObj)) {
127       _mesa_error(ctx, GL_INVALID_OPERATION,
128                   "glGenerate%sMipmap(incomplete cube map)", suffix);
129       return;
130    }
131 
132    _mesa_lock_texture(ctx, texObj);
133 
134    srcImage = _mesa_select_tex_image(texObj, target, texObj->BaseLevel);
135    if (!srcImage) {
136       _mesa_unlock_texture(ctx, texObj);
137       _mesa_error(ctx, GL_INVALID_OPERATION,
138                   "glGenerate%sMipmap(zero size base image)", suffix);
139       return;
140    }
141 
142    if (!_mesa_is_valid_generate_texture_mipmap_internalformat(ctx,
143                                                               srcImage->InternalFormat)) {
144       _mesa_unlock_texture(ctx, texObj);
145       _mesa_error(ctx, GL_INVALID_OPERATION,
146                   "glGenerate%sMipmap(invalid internal format %s)", suffix,
147                   _mesa_enum_to_string(srcImage->InternalFormat));
148       return;
149    }
150 
151    if (srcImage->Width == 0 || srcImage->Height == 0) {
152       _mesa_unlock_texture(ctx, texObj);
153       return;
154    }
155 
156    if (target == GL_TEXTURE_CUBE_MAP) {
157       GLuint face;
158       for (face = 0; face < 6; face++) {
159          ctx->Driver.GenerateMipmap(ctx,
160                       GL_TEXTURE_CUBE_MAP_POSITIVE_X + face, texObj);
161       }
162    }
163    else {
164       ctx->Driver.GenerateMipmap(ctx, target, texObj);
165    }
166    _mesa_unlock_texture(ctx, texObj);
167 }
168 
169 /**
170  * Generate all the mipmap levels below the base level.
171  * Note: this GL function would be more useful if one could specify a
172  * cube face, a set of array slices, etc.
173  */
174 void GLAPIENTRY
_mesa_GenerateMipmap(GLenum target)175 _mesa_GenerateMipmap(GLenum target)
176 {
177    struct gl_texture_object *texObj;
178    GET_CURRENT_CONTEXT(ctx);
179 
180    if (!_mesa_is_valid_generate_texture_mipmap_target(ctx, target)) {
181       _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateMipmap(target=%s)",
182                   _mesa_enum_to_string(target));
183       return;
184    }
185 
186    texObj = _mesa_get_current_tex_object(ctx, target);
187    if (!texObj)
188       return;
189 
190    _mesa_generate_texture_mipmap(ctx, texObj, target, false);
191 }
192 
193 /**
194  * Generate all the mipmap levels below the base level.
195  */
196 void GLAPIENTRY
_mesa_GenerateTextureMipmap(GLuint texture)197 _mesa_GenerateTextureMipmap(GLuint texture)
198 {
199    struct gl_texture_object *texObj;
200    GET_CURRENT_CONTEXT(ctx);
201 
202    texObj = _mesa_lookup_texture_err(ctx, texture, "glGenerateTextureMipmap");
203    if (!texObj)
204       return;
205 
206    if (!_mesa_is_valid_generate_texture_mipmap_target(ctx, texObj->Target)) {
207       _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateTextureMipmap(target=%s)",
208                   _mesa_enum_to_string(texObj->Target));
209       return;
210    }
211 
212    _mesa_generate_texture_mipmap(ctx, texObj, texObj->Target, true);
213 }
214