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_is_gles(ctx) ||
  69               !ctx->Extensions.ARB_texture_cube_map_array;
  70       break;
  71    default:
  72       error = true;
  73    }
  74
  75    return !error;
  76 }
  77
  78 bool
  79 _mesa_is_valid_generate_texture_mipmap_internalformat(struct gl_context *ctx,
  80                                                       GLenum internalformat)
  81 {
  82    if (_mesa_is_gles3(ctx)) {
  83       /* From the ES 3.2 specification's description of GenerateMipmap():
  84        * "An INVALID_OPERATION error is generated if the levelbase array was
  85        *  not specified with an unsized internal format from table 8.3 or a
  86        *  sized internal format that is both color-renderable and
  87        *  texture-filterable according to table 8.10."
  88        */
  89       return internalformat == GL_RGBA || internalformat == GL_RGB ||
  90              internalformat == GL_LUMINANCE_ALPHA ||
  91              internalformat == GL_LUMINANCE || internalformat == GL_ALPHA ||
  92              (_mesa_is_es3_color_renderable(internalformat) &&
  93               _mesa_is_es3_texture_filterable(internalformat));
  94    }
  95
  96    return (!_mesa_is_enum_format_integer(internalformat) &&
  97            !_mesa_is_depthstencil_format(internalformat) &&
  98            !_mesa_is_astc_format(internalformat) &&
  99            !_mesa_is_stencil_format(internalformat));
 100 }
 101
 102 /**
 103  * Implements glGenerateMipmap and glGenerateTextureMipmap.
 104  * Generates all the mipmap levels below the base level.
 105  */
 106 void
 107 _mesa_generate_texture_mipmap(struct gl_context *ctx,
 108                               struct gl_texture_object *texObj, GLenum target,
 109                               bool dsa)
 110 {
 111    struct gl_texture_image *srcImage;
 112    const char *suffix = dsa ? "Texture" : "";
 113
 114    FLUSH_VERTICES(ctx, 0);
 115
 116    if (texObj->BaseLevel >= texObj->MaxLevel) {
 117       /* nothing to do */
 118       return;
 119    }
 120
 121    if (texObj->Target == GL_TEXTURE_CUBE_MAP &&
 122        !_mesa_cube_complete(texObj)) {
 123       _mesa_error(ctx, GL_INVALID_OPERATION,
 124                   "glGenerate%sMipmap(incomplete cube map)", suffix);
 125       return;
 126    }
 127
 128    _mesa_lock_texture(ctx, texObj);
 129
 130    srcImage = _mesa_select_tex_image(texObj, target, texObj->BaseLevel);
 131    if (!srcImage) {
 132       _mesa_unlock_texture(ctx, texObj);
 133       _mesa_error(ctx, GL_INVALID_OPERATION,
 134                   "glGenerate%sMipmap(zero size base image)", suffix);
 135       return;
 136    }
 137
 138    if (!_mesa_is_valid_generate_texture_mipmap_internalformat(ctx,
 139                                                               srcImage->InternalFormat)) {
 140       _mesa_unlock_texture(ctx, texObj);
 141       _mesa_error(ctx, GL_INVALID_OPERATION,
 142                   "glGenerate%sMipmap(invalid internal format)", suffix);
 143       return;
 144    }
 145
 146    if (target == GL_TEXTURE_CUBE_MAP) {
 147       GLuint face;
 148       for (face = 0; face < 6; face++) {
 149          ctx->Driver.GenerateMipmap(ctx,
 150                       GL_TEXTURE_CUBE_MAP_POSITIVE_X + face, texObj);
 151       }
 152    }
 153    else {
 154       ctx->Driver.GenerateMipmap(ctx, target, texObj);
 155    }
 156    _mesa_unlock_texture(ctx, texObj);
 157 }
 158
 159 /**
 160  * Generate all the mipmap levels below the base level.
 161  * Note: this GL function would be more useful if one could specify a
 162  * cube face, a set of array slices, etc.
 163  */
 164 void GLAPIENTRY
 165 _mesa_GenerateMipmap(GLenum target)
 166 {
 167    struct gl_texture_object *texObj;
 168    GET_CURRENT_CONTEXT(ctx);
 169
 170    if (!_mesa_is_valid_generate_texture_mipmap_target(ctx, target)) {
 171       _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateMipmap(target=%s)",
 172                   _mesa_enum_to_string(target));
 173       return;
 174    }
 175
 176    texObj = _mesa_get_current_tex_object(ctx, target);
 177    if (!texObj)
 178       return;
 179
 180    _mesa_generate_texture_mipmap(ctx, texObj, target, false);
 181 }
 182
 183 /**
 184  * Generate all the mipmap levels below the base level.
 185  */
 186 void GLAPIENTRY
 187 _mesa_GenerateTextureMipmap(GLuint texture)
 188 {
 189    struct gl_texture_object *texObj;
 190    GET_CURRENT_CONTEXT(ctx);
 191
 192    texObj = _mesa_lookup_texture_err(ctx, texture, "glGenerateTextureMipmap");
 193    if (!texObj)
 194       return;
 195
 196    if (!_mesa_is_valid_generate_texture_mipmap_target(ctx, texObj->Target)) {
 197       _mesa_error(ctx, GL_INVALID_ENUM, "glGenerateTextureMipmap(target=%s)",
 198                   _mesa_enum_to_string(texObj->Target));
 199       return;
 200    }
 201
 202    _mesa_generate_texture_mipmap(ctx, texObj, texObj->Target, true);
 203 }