src/mesa/main/readpix.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  7.1
   4  *
   5  * Copyright (C) 1999-2008  Brian Paul   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  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  21  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25 #include "glheader.h"
  26 #include "imports.h"
  27 #include "bufferobj.h"
  28 #include "context.h"
  29 #include "readpix.h"
  30 #include "framebuffer.h"
  31 #include "image.h"
  32 #include "state.h"
  33
  34
  35 /**
  36  * Do error checking of the format/type parameters to glReadPixels and
  37  * glDrawPixels.
  38  * \param drawing if GL_TRUE do checking for DrawPixels, else do checking
  39  *                for ReadPixels.
  40  * \return GL_TRUE if error detected, GL_FALSE if no errors
  41  */
  42 GLboolean
  43 _mesa_error_check_format_type(GLcontext *ctx, GLenum format, GLenum type,
  44                               GLboolean drawing)
  45 {
  46    const char *readDraw = drawing ? "Draw" : "Read";
  47    const GLboolean reading = !drawing;
  48
  49    /* state validation should have already been done */
  50    ASSERT(ctx->NewState == 0x0);
  51
  52    if (ctx->Extensions.EXT_packed_depth_stencil
  53        && type == GL_UNSIGNED_INT_24_8_EXT
  54        && format != GL_DEPTH_STENCIL_EXT) {
  55       _mesa_error(ctx, GL_INVALID_OPERATION,
  56                   "gl%sPixels(format is not GL_DEPTH_STENCIL_EXT)", readDraw);
  57       return GL_TRUE;
  58    }
  59
  60    /* basic combinations test */
  61    if (!_mesa_is_legal_format_and_type(ctx, format, type)) {
  62       _mesa_error(ctx, GL_INVALID_ENUM,
  63                   "gl%sPixels(format or type)", readDraw);
  64       return GL_TRUE;
  65    }
  66
  67    /* additional checks */
  68    switch (format) {
  69    case GL_RED:
  70    case GL_GREEN:
  71    case GL_BLUE:
  72    case GL_ALPHA:
  73    case GL_LUMINANCE:
  74    case GL_LUMINANCE_ALPHA:
  75    case GL_RGB:
  76    case GL_BGR:
  77    case GL_RGBA:
  78    case GL_BGRA:
  79    case GL_ABGR_EXT:
  80       if (drawing) {
  81          if (!ctx->DrawBuffer->Visual.rgbMode) {
  82             _mesa_error(ctx, GL_INVALID_OPERATION,
  83                    "glDrawPixels(drawing RGB pixels into color index buffer)");
  84             return GL_TRUE;
  85          }
  86       }
  87       else {
  88          /* reading */
  89          if (!_mesa_source_buffer_exists(ctx, GL_COLOR)) {
  90             _mesa_error(ctx, GL_INVALID_OPERATION,
  91                         "glReadPixels(no color buffer)");
  92             return GL_TRUE;
  93          }
  94       }
  95       break;
  96    case GL_COLOR_INDEX:
  97       if (drawing) {
  98          if (ctx->DrawBuffer->Visual.rgbMode &&
  99              (ctx->PixelMaps.ItoR.Size == 0 ||
 100               ctx->PixelMaps.ItoG.Size == 0 ||
 101               ctx->PixelMaps.ItoB.Size == 0)) {
 102             _mesa_error(ctx, GL_INVALID_OPERATION,
 103                    "glDrawPixels(drawing color index pixels into RGB buffer)");
 104             return GL_TRUE;
 105          }
 106       }
 107       else {
 108          /* reading */
 109          if (!_mesa_source_buffer_exists(ctx, GL_COLOR)) {
 110             _mesa_error(ctx, GL_INVALID_OPERATION,
 111                         "glReadPixels(no color buffer)");
 112             return GL_TRUE;
 113          }
 114       }
 115       break;
 116    case GL_STENCIL_INDEX:
 117       if ((drawing && !_mesa_dest_buffer_exists(ctx, format)) ||
 118           (reading && !_mesa_source_buffer_exists(ctx, format))) {
 119          _mesa_error(ctx, GL_INVALID_OPERATION,
 120                      "gl%sPixels(no stencil buffer)", readDraw);
 121          return GL_TRUE;
 122       }
 123       break;
 124    case GL_DEPTH_COMPONENT:
 125       if ((drawing && !_mesa_dest_buffer_exists(ctx, format))) {
 126          _mesa_error(ctx, GL_INVALID_OPERATION,
 127                      "gl%sPixels(no depth buffer)", readDraw);
 128          return GL_TRUE;
 129       }
 130       break;
 131    case GL_DEPTH_STENCIL_EXT:
 132       if (!ctx->Extensions.EXT_packed_depth_stencil ||
 133           type != GL_UNSIGNED_INT_24_8_EXT) {
 134          _mesa_error(ctx, GL_INVALID_ENUM, "gl%sPixels(type)", readDraw);
 135          return GL_TRUE;
 136       }
 137       if ((drawing && !_mesa_dest_buffer_exists(ctx, format)) ||
 138           (reading && !_mesa_source_buffer_exists(ctx, format))) {
 139          _mesa_error(ctx, GL_INVALID_OPERATION,
 140                      "gl%sPixels(no depth or stencil buffer)", readDraw);
 141          return GL_TRUE;
 142       }
 143       break;
 144    default:
 145       /* this should have been caught in _mesa_is_legal_format_type() */
 146       _mesa_problem(ctx, "unexpected format in _mesa_%sPixels", readDraw);
 147       return GL_TRUE;
 148    }
 149
 150    /* no errors */
 151    return GL_FALSE;
 152 }
 153
 154
 155
 156 void GLAPIENTRY
 157 _mesa_ReadPixels( GLint x, GLint y, GLsizei width, GLsizei height,
 158                   GLenum format, GLenum type, GLvoid *pixels )
 159 {
 160    GET_CURRENT_CONTEXT(ctx);
 161    ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx);
 162
 163    FLUSH_CURRENT(ctx, 0);
 164
 165    if (width < 0 || height < 0) {
 166       _mesa_error( ctx, GL_INVALID_VALUE,
 167                    "glReadPixels(width=%d height=%d)", width, height );
 168       return;
 169    }
 170
 171    if (ctx->NewState)
 172       _mesa_update_state(ctx);
 173
 174    if (_mesa_error_check_format_type(ctx, format, type, GL_FALSE)) {
 175       /* found an error */
 176       return;
 177    }
 178
 179    if (ctx->ReadBuffer->_Status != GL_FRAMEBUFFER_COMPLETE_EXT) {
 180       _mesa_error(ctx, GL_INVALID_FRAMEBUFFER_OPERATION_EXT,
 181                   "glReadPixels(incomplete framebuffer)" );
 182       return;
 183    }
 184
 185    if (!_mesa_source_buffer_exists(ctx, format)) {
 186       _mesa_error(ctx, GL_INVALID_OPERATION, "glReadPixels(no readbuffer)");
 187       return;
 188    }
 189
 190    if (width == 0 || height == 0)
 191       return; /* nothing to do */
 192
 193    if (_mesa_is_bufferobj(ctx->Pack.BufferObj)) {
 194       if (!_mesa_validate_pbo_access(2, &ctx->Pack, width, height, 1,
 195                                      format, type, pixels)) {
 196          _mesa_error(ctx, GL_INVALID_OPERATION,
 197                      "glReadPixels(invalid PBO access)");
 198          return;
 199       }
 200
 201       if (_mesa_bufferobj_mapped(ctx->Pack.BufferObj)) {
 202          /* buffer is mapped - that's an error */
 203          _mesa_error(ctx, GL_INVALID_OPERATION, "glReadPixels(PBO is mapped)");
 204          return;
 205       }
 206    }
 207
 208    ctx->Driver.ReadPixels(ctx, x, y, width, height,
 209                           format, type, &ctx->Pack, pixels);
 210 }