src/mesa/drivers/common/meta_generate_mipmap.c

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 2009  VMware, Inc.  All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a
   7  * copy of this software and associated documentation files (the "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included
  14  * in all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  22  * OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25 /**
  26  * Meta operations.  Some GL operations can be expressed in terms of
  27  * other GL operations.  For example, glBlitFramebuffer() can be done
  28  * with texture mapping and glClear() can be done with polygon rendering.
  29  *
  30  * \author Brian Paul
  31  */
  32
  33 #include "main/arrayobj.h"
  34 #include "main/buffers.h"
  35 #include "main/enums.h"
  36 #include "main/enable.h"
  37 #include "main/fbobject.h"
  38 #include "main/macros.h"
  39 #include "main/mipmap.h"
  40 #include "main/teximage.h"
  41 #include "main/texobj.h"
  42 #include "main/texparam.h"
  43 #include "main/varray.h"
  44 #include "main/viewport.h"
  45 #include "drivers/common/meta.h"
  46
  47 /**
  48  * Bind a particular texture level/layer to mipmap->FBO's GL_COLOR_ATTACHMENT0.
  49  */
  50 static void
  51 bind_fbo_image(struct gl_texture_object *texObj, GLenum target,
  52                GLuint level, GLuint layer)
  53 {
  54    switch (target) {
  55    case GL_TEXTURE_1D:
  56       _mesa_FramebufferTexture1D(GL_FRAMEBUFFER,
  57                                  GL_COLOR_ATTACHMENT0,
  58                                  target,
  59                                  texObj->Name,
  60                                  level);
  61       break;
  62    case GL_TEXTURE_1D_ARRAY:
  63    case GL_TEXTURE_2D_ARRAY:
  64    case GL_TEXTURE_3D:
  65       _mesa_FramebufferTextureLayer(GL_FRAMEBUFFER,
  66                                     GL_COLOR_ATTACHMENT0,
  67                                     texObj->Name,
  68                                     level,
  69                                     layer);
  70       break;
  71    default: /* 2D / cube */
  72       _mesa_FramebufferTexture2D(GL_FRAMEBUFFER,
  73                                  GL_COLOR_ATTACHMENT0,
  74                                  target,
  75                                  texObj->Name,
  76                                  level);
  77    }
  78 }
  79
  80 /**
  81  * Check if the call to _mesa_meta_GenerateMipmap() will require a
  82  * software fallback.  The fallback path will require that the texture
  83  * images are mapped.
  84  * \return GL_TRUE if a fallback is needed, GL_FALSE otherwise
  85  */
  86 static bool
  87 fallback_required(struct gl_context *ctx, GLenum target,
  88                   struct gl_texture_object *texObj)
  89 {
  90    const GLuint fboSave = ctx->DrawBuffer->Name;
  91    struct gen_mipmap_state *mipmap = &ctx->Meta->Mipmap;
  92    struct gl_texture_image *baseImage;
  93    GLuint srcLevel;
  94    GLenum status;
  95
  96    /* check for fallbacks */
  97    if (target == GL_TEXTURE_3D || target == GL_TEXTURE_1D_ARRAY) {
  98       _mesa_perf_debug(ctx, MESA_DEBUG_SEVERITY_HIGH,
  99                        "glGenerateMipmap() to %s target\n",
 100                        _mesa_lookup_enum_by_nr(target));
 101       return true;
 102    }
 103
 104    srcLevel = texObj->BaseLevel;
 105    baseImage = _mesa_select_tex_image(ctx, texObj, target, srcLevel);
 106    if (!baseImage) {
 107       _mesa_perf_debug(ctx, MESA_DEBUG_SEVERITY_HIGH,
 108                        "glGenerateMipmap() couldn't find base teximage\n");
 109       return true;
 110    }
 111
 112    if (_mesa_is_format_compressed(baseImage->TexFormat)) {
 113       _mesa_perf_debug(ctx, MESA_DEBUG_SEVERITY_HIGH,
 114                        "glGenerateMipmap() with %s format\n",
 115                        _mesa_get_format_name(baseImage->TexFormat));
 116       return true;
 117    }
 118
 119    if (_mesa_get_format_color_encoding(baseImage->TexFormat) == GL_SRGB &&
 120        !ctx->Extensions.EXT_texture_sRGB_decode) {
 121       /* The texture format is sRGB but we can't turn off sRGB->linear
 122        * texture sample conversion.  So we won't be able to generate the
 123        * right colors when rendering.  Need to use a fallback.
 124        */
 125       _mesa_perf_debug(ctx, MESA_DEBUG_SEVERITY_HIGH,
 126                        "glGenerateMipmap() of sRGB texture without "
 127                        "sRGB decode\n");
 128       return true;
 129    }
 130
 131    /*
 132     * Test that we can actually render in the texture's format.
 133     */
 134    if (!mipmap->FBO)
 135       _mesa_GenFramebuffers(1, &mipmap->FBO);
 136    _mesa_BindFramebuffer(GL_FRAMEBUFFER_EXT, mipmap->FBO);
 137
 138    bind_fbo_image(texObj, target, srcLevel, 0);
 139
 140    status = _mesa_CheckFramebufferStatus(GL_FRAMEBUFFER_EXT);
 141
 142    _mesa_BindFramebuffer(GL_FRAMEBUFFER_EXT, fboSave);
 143
 144    if (status != GL_FRAMEBUFFER_COMPLETE_EXT) {
 145       _mesa_perf_debug(ctx, MESA_DEBUG_SEVERITY_HIGH,
 146                        "glGenerateMipmap() got incomplete FBO\n");
 147       return true;
 148    }
 149
 150    return false;
 151 }
 152
 153 void
 154 _mesa_meta_glsl_generate_mipmap_cleanup(struct gen_mipmap_state *mipmap)
 155 {
 156    if (mipmap->VAO == 0)
 157       return;
 158    _mesa_DeleteVertexArrays(1, &mipmap->VAO);
 159    mipmap->VAO = 0;
 160    _mesa_DeleteBuffers(1, &mipmap->VBO);
 161    mipmap->VBO = 0;
 162
 163    _mesa_meta_blit_shader_table_cleanup(&mipmap->shaders);
 164 }
 165
 166 /**
 167  * Called via ctx->Driver.GenerateMipmap()
 168  * Note: We don't yet support 3D textures, 1D/2D array textures or texture
 169  * borders.
 170  */
 171 void
 172 _mesa_meta_GenerateMipmap(struct gl_context *ctx, GLenum target,
 173                           struct gl_texture_object *texObj)
 174 {
 175    struct gen_mipmap_state *mipmap = &ctx->Meta->Mipmap;
 176    struct vertex verts[4];
 177    const GLuint baseLevel = texObj->BaseLevel;
 178    const GLuint maxLevel = texObj->MaxLevel;
 179    const GLint maxLevelSave = texObj->MaxLevel;
 180    const GLboolean genMipmapSave = texObj->GenerateMipmap;
 181    const GLuint fboSave = ctx->DrawBuffer->Name;
 182    const GLuint currentTexUnitSave = ctx->Texture.CurrentUnit;
 183    const GLboolean use_glsl_version = ctx->Extensions.ARB_vertex_shader &&
 184                                       ctx->Extensions.ARB_fragment_shader;
 185    GLenum faceTarget;
 186    GLuint dstLevel;
 187    GLuint samplerSave;
 188
 189    if (fallback_required(ctx, target, texObj)) {
 190       _mesa_generate_mipmap(ctx, target, texObj);
 191       return;
 192    }
 193
 194    if (target >= GL_TEXTURE_CUBE_MAP_POSITIVE_X &&
 195        target <= GL_TEXTURE_CUBE_MAP_NEGATIVE_Z) {
 196       faceTarget = target;
 197       target = GL_TEXTURE_CUBE_MAP;
 198    } else {
 199       faceTarget = target;
 200    }
 201
 202    _mesa_meta_begin(ctx, MESA_META_ALL);
 203
 204    /* Choose between glsl version and fixed function version of
 205     * GenerateMipmap function.
 206     */
 207    if (use_glsl_version) {
 208       _mesa_meta_setup_vertex_objects(&mipmap->VAO, &mipmap->VBO, true,
 209                                       2, 3, 0);
 210       _mesa_meta_setup_blit_shader(ctx, target, &mipmap->shaders);
 211    } else {
 212       _mesa_meta_setup_ff_tnl_for_blit(&mipmap->VAO, &mipmap->VBO, 3);
 213       _mesa_set_enable(ctx, target, GL_TRUE);
 214    }
 215
 216    samplerSave = ctx->Texture.Unit[ctx->Texture.CurrentUnit].Sampler ?
 217       ctx->Texture.Unit[ctx->Texture.CurrentUnit].Sampler->Name : 0;
 218
 219    if (currentTexUnitSave != 0)
 220       _mesa_BindTexture(target, texObj->Name);
 221
 222    if (!mipmap->Sampler) {
 223       _mesa_GenSamplers(1, &mipmap->Sampler);
 224       _mesa_BindSampler(ctx->Texture.CurrentUnit, mipmap->Sampler);
 225
 226       _mesa_SamplerParameteri(mipmap->Sampler,
 227                               GL_TEXTURE_MIN_FILTER,
 228                               GL_LINEAR_MIPMAP_LINEAR);
 229       _mesa_SamplerParameteri(mipmap->Sampler, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
 230       _mesa_SamplerParameteri(mipmap->Sampler, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
 231       _mesa_SamplerParameteri(mipmap->Sampler, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);
 232       _mesa_SamplerParameteri(mipmap->Sampler, GL_TEXTURE_WRAP_R, GL_CLAMP_TO_EDGE);
 233
 234       /* We don't want to encode or decode sRGB values; treat them as linear.
 235        * This is not technically correct for GLES3 but we don't get any API
 236        * error at the moment.
 237        */
 238       if (ctx->Extensions.EXT_texture_sRGB_decode) {
 239          _mesa_SamplerParameteri(mipmap->Sampler, GL_TEXTURE_SRGB_DECODE_EXT,
 240                GL_SKIP_DECODE_EXT);
 241       }
 242    } else {
 243       _mesa_BindSampler(ctx->Texture.CurrentUnit, mipmap->Sampler);
 244    }
 245
 246    assert(mipmap->FBO != 0);
 247    _mesa_BindFramebuffer(GL_FRAMEBUFFER_EXT, mipmap->FBO);
 248
 249    _mesa_TexParameteri(target, GL_GENERATE_MIPMAP, GL_FALSE);
 250
 251    /* Silence valgrind warnings about reading uninitialized stack. */
 252    memset(verts, 0, sizeof(verts));
 253
 254    /* setup vertex positions */
 255    verts[0].x = -1.0F;
 256    verts[0].y = -1.0F;
 257    verts[1].x =  1.0F;
 258    verts[1].y = -1.0F;
 259    verts[2].x =  1.0F;
 260    verts[2].y =  1.0F;
 261    verts[3].x = -1.0F;
 262    verts[3].y =  1.0F;
 263
 264    /* texture is already locked, unlock now */
 265    _mesa_unlock_texture(ctx, texObj);
 266
 267    for (dstLevel = baseLevel + 1; dstLevel <= maxLevel; dstLevel++) {
 268       const struct gl_texture_image *srcImage;
 269       const GLuint srcLevel = dstLevel - 1;
 270       GLuint layer;
 271       GLsizei srcWidth, srcHeight, srcDepth;
 272       GLsizei dstWidth, dstHeight, dstDepth;
 273
 274       srcImage = _mesa_select_tex_image(ctx, texObj, faceTarget, srcLevel);
 275       assert(srcImage->Border == 0);
 276
 277       /* src size */
 278       srcWidth = srcImage->Width;
 279       srcHeight = srcImage->Height;
 280       srcDepth = srcImage->Depth;
 281
 282       /* new dst size */
 283       dstWidth = minify(srcWidth, 1);
 284       dstHeight = minify(srcHeight, 1);
 285       dstDepth = target == GL_TEXTURE_3D ? minify(srcDepth, 1) : srcDepth;
 286
 287       if (dstWidth == srcImage->Width &&
 288           dstHeight == srcImage->Height &&
 289           dstDepth == srcImage->Depth) {
 290          /* all done */
 291          break;
 292       }
 293
 294       /* Allocate storage for the destination mipmap image(s) */
 295
 296       /* Set MaxLevel large enough to hold the new level when we allocate it */
 297       _mesa_TexParameteri(target, GL_TEXTURE_MAX_LEVEL, dstLevel);
 298
 299       if (!_mesa_prepare_mipmap_level(ctx, texObj, dstLevel,
 300                                       dstWidth, dstHeight, dstDepth,
 301                                       srcImage->Border,
 302                                       srcImage->InternalFormat,
 303                                       srcImage->TexFormat)) {
 304          /* All done.  We either ran out of memory or we would go beyond the
 305           * last valid level of an immutable texture if we continued.
 306           */
 307          break;
 308       }
 309
 310       /* limit minification to src level */
 311       _mesa_TexParameteri(target, GL_TEXTURE_MAX_LEVEL, srcLevel);
 312
 313       /* setup viewport */
 314       _mesa_set_viewport(ctx, 0, 0, 0, dstWidth, dstHeight);
 315       _mesa_DrawBuffer(GL_COLOR_ATTACHMENT0);
 316
 317       for (layer = 0; layer < dstDepth; ++layer) {
 318          /* Setup texture coordinates */
 319          _mesa_meta_setup_texture_coords(faceTarget,
 320                                          layer,
 321                                          0, 0, 1, /* width, height never used here */
 322                                          verts[0].tex,
 323                                          verts[1].tex,
 324                                          verts[2].tex,
 325                                          verts[3].tex);
 326
 327          /* upload vertex data */
 328          _mesa_BufferData(GL_ARRAY_BUFFER_ARB, sizeof(verts),
 329                           verts, GL_DYNAMIC_DRAW_ARB);
 330
 331          bind_fbo_image(texObj, faceTarget, dstLevel, layer);
 332
 333          /* sanity check */
 334          if (_mesa_CheckFramebufferStatus(GL_FRAMEBUFFER) !=
 335              GL_FRAMEBUFFER_COMPLETE) {
 336             _mesa_problem(ctx, "Unexpected incomplete framebuffer in "
 337                           "_mesa_meta_GenerateMipmap()");
 338             break;
 339          }
 340
 341          assert(dstWidth == ctx->DrawBuffer->Width);
 342          assert(dstHeight == ctx->DrawBuffer->Height);
 343
 344          _mesa_DrawArrays(GL_TRIANGLE_FAN, 0, 4);
 345       }
 346    }
 347
 348    _mesa_lock_texture(ctx, texObj); /* relock */
 349
 350    _mesa_BindSampler(ctx->Texture.CurrentUnit, samplerSave);
 351
 352    _mesa_meta_end(ctx);
 353
 354    _mesa_TexParameteri(target, GL_TEXTURE_MAX_LEVEL, maxLevelSave);
 355    if (genMipmapSave)
 356       _mesa_TexParameteri(target, GL_GENERATE_MIPMAP, genMipmapSave);
 357
 358    _mesa_BindFramebuffer(GL_FRAMEBUFFER_EXT, fboSave);
 359 }