src/mesa/main/genmipmap.c

   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
  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
  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
 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
 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
 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
 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
 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
 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
 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
 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 }