/* * Mesa 3-D graphics library * Version: 3.4.1 * * Copyright (C) 1999-2000 Brian Paul All Rights Reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #ifdef PC_HEADER #include "all.h" #else #include "glheader.h" #include "alphabuf.h" #include "context.h" #include "depth.h" #include "feedback.h" #include "image.h" #include "macros.h" #include "mem.h" #include "pixel.h" #include "readpix.h" #include "span.h" #include "state.h" #include "stencil.h" #include "types.h" #endif /* * Read a block of color index pixels. */ static void read_index_pixels( GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum type, GLvoid *pixels, const struct gl_pixelstore_attrib *packing ) { GLint i, j, readWidth; /* error checking */ if (ctx->Visual->RGBAflag) { gl_error( ctx, GL_INVALID_OPERATION, "glReadPixels" ); return; } ASSERT(ctx->Driver.SetReadBuffer); (*ctx->Driver.SetReadBuffer)(ctx, ctx->ReadBuffer, ctx->Pixel.DriverReadBuffer); readWidth = (width > MAX_WIDTH) ? MAX_WIDTH : width; /* process image row by row */ for (j=0;jDriver.ReadCI32Span)( ctx, readWidth, x, y, index ); if (ctx->Pixel.IndexShift!=0 || ctx->Pixel.IndexOffset!=0) { _mesa_shift_and_offset_ci( ctx, readWidth, index); } if (ctx->Pixel.MapColorFlag) { _mesa_map_ci(ctx, readWidth, index); } dest = _mesa_image_address(packing, pixels, width, height, GL_COLOR_INDEX, type, 0, j, 0); switch (type) { case GL_UNSIGNED_BYTE: { GLubyte *dst = (GLubyte *) dest; for (i=0;iSwapBytes) { _mesa_swap2( (GLushort *) dst, readWidth ); } } break; case GL_SHORT: { GLshort *dst = (GLshort *) dest; for (i=0;iSwapBytes) { _mesa_swap2( (GLushort *) dst, readWidth ); } } break; case GL_UNSIGNED_INT: { GLuint *dst = (GLuint *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_INT: { GLint *dst = (GLint *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_FLOAT: { GLfloat *dst = (GLfloat *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; default: gl_error( ctx, GL_INVALID_ENUM, "glReadPixels(type)" ); j = height + 1; /* exit loop */ } } (*ctx->Driver.SetReadBuffer)(ctx, ctx->DrawBuffer, ctx->Color.DriverDrawBuffer); } static void read_depth_pixels( GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum type, GLvoid *pixels, const struct gl_pixelstore_attrib *packing ) { GLint i, j, readWidth; GLboolean bias_or_scale; /* Error checking */ if (ctx->Visual->DepthBits <= 0) { /* No depth buffer */ gl_error( ctx, GL_INVALID_OPERATION, "glReadPixels" ); return; } readWidth = (width > MAX_WIDTH) ? MAX_WIDTH : width; if (type != GL_BYTE && type != GL_UNSIGNED_BYTE && type != GL_SHORT && type != GL_UNSIGNED_SHORT && type != GL_INT && type != GL_UNSIGNED_INT && type != GL_FLOAT) { gl_error( ctx, GL_INVALID_OPERATION, "glReadPixels(depth type)"); return; } bias_or_scale = ctx->Pixel.DepthBias!=0.0 || ctx->Pixel.DepthScale!=1.0; if (type==GL_UNSIGNED_SHORT && ctx->Visual->DepthBits == 16 && !bias_or_scale && !packing->SwapBytes) { /* Special case: directly read 16-bit unsigned depth values. */ for (j=0;jVisual->DepthBits == 32 && !bias_or_scale && !packing->SwapBytes) { /* Special case: directly read 32-bit unsigned depth values. */ for (j=0;jPixel.DepthScale + ctx->Pixel.DepthBias; depth[i] = CLAMP( d, 0.0F, 1.0F ); } } dest = _mesa_image_address(packing, pixels, width, height, GL_DEPTH_COMPONENT, type, 0, j, 0); switch (type) { case GL_UNSIGNED_BYTE: { GLubyte *dst = (GLubyte *) dest; for (i=0;iSwapBytes) { _mesa_swap2( (GLushort *) dst, readWidth ); } } break; case GL_SHORT: { GLshort *dst = (GLshort *) dest; for (i=0;iSwapBytes) { _mesa_swap2( (GLushort *) dst, readWidth ); } } break; case GL_UNSIGNED_INT: { GLuint *dst = (GLuint *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_INT: { GLint *dst = (GLint *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_FLOAT: { GLfloat *dst = (GLfloat *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; default: gl_error( ctx, GL_INVALID_ENUM, "glReadPixels(type)" ); } } } } static void read_stencil_pixels( GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum type, GLvoid *pixels, const struct gl_pixelstore_attrib *packing ) { GLboolean shift_or_offset; GLint i, j, readWidth; if (type != GL_BYTE && type != GL_UNSIGNED_BYTE && type != GL_SHORT && type != GL_UNSIGNED_SHORT && type != GL_INT && type != GL_UNSIGNED_INT && type != GL_FLOAT && type != GL_BITMAP) { gl_error( ctx, GL_INVALID_OPERATION, "glReadPixels(stencil type)"); return; } readWidth = (width > MAX_WIDTH) ? MAX_WIDTH : width; if (ctx->Visual->StencilBits<=0) { /* No stencil buffer */ gl_error( ctx, GL_INVALID_OPERATION, "glReadPixels" ); return; } shift_or_offset = ctx->Pixel.IndexShift!=0 || ctx->Pixel.IndexOffset!=0; /* process image row by row */ for (j=0;jPixel.MapStencilFlag) { _mesa_map_stencil( ctx, readWidth, stencil ); } dest = _mesa_image_address( packing, pixels, width, height, GL_STENCIL_INDEX, type, 0, j, 0 ); switch (type) { case GL_UNSIGNED_BYTE: if (sizeof(GLstencil) == 8) { MEMCPY( dest, stencil, readWidth ); } else { GLubyte *dst = (GLubyte *) dest; for (i=0;iSwapBytes) { _mesa_swap2( (GLushort *) dst, readWidth ); } } break; case GL_SHORT: { GLshort *dst = (GLshort *) dest; for (i=0;iSwapBytes) { _mesa_swap2( (GLushort *) dst, readWidth ); } } break; case GL_UNSIGNED_INT: { GLuint *dst = (GLuint *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_INT: { GLint *dst = (GLint *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_FLOAT: { GLfloat *dst = (GLfloat *) dest; for (i=0;iSwapBytes) { _mesa_swap4( (GLuint *) dst, readWidth ); } } break; case GL_BITMAP: if (packing->LsbFirst) { GLubyte *dst = (GLubyte*) dest; GLint shift = 0; for (i = 0; i < readWidth; i++) { if (shift == 0) *dst = 0; *dst |= ((stencil != 0) << shift); shift++; if (shift == 8) { shift = 0; dst++; } } } else { GLubyte *dst = (GLubyte*) dest; GLint shift = 7; for (i = 0; i < readWidth; i++) { if (shift == 7) *dst = 0; *dst |= ((stencil != 0) << shift); shift--; if (shift < 0) { shift = 7; dst++; } } } break; default: gl_error( ctx, GL_INVALID_ENUM, "glReadPixels(type)" ); } } } /* * Optimized glReadPixels for particular pixel formats: * GL_UNSIGNED_BYTE, GL_RGBA * when pixel scaling, biasing and mapping are disabled. */ static GLboolean read_fast_rgba_pixels( GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, GLvoid *pixels, const struct gl_pixelstore_attrib *packing ) { GLboolean applyTransferOps; applyTransferOps = ctx->Pixel.ScaleOrBiasRGBA || ctx->Pixel.MapColorFlag || ctx->ColorMatrix.type != MATRIX_IDENTITY || ctx->Pixel.ScaleOrBiasRGBApcm || ctx->Pixel.ColorTableEnabled || ctx->Pixel.PostColorMatrixColorTableEnabled || ctx->Pixel.MinMaxEnabled || ctx->Pixel.HistogramEnabled; /* can't do scale, bias, mapping, etc */ if (applyTransferOps) return GL_FALSE; /* can't do fancy pixel packing */ if (packing->Alignment != 1 || packing->SwapBytes || packing->LsbFirst) return GL_FALSE; { GLint srcX = x; GLint srcY = y; GLint readWidth = width; /* actual width read */ GLint readHeight = height; /* actual height read */ GLint skipPixels = packing->SkipPixels; GLint skipRows = packing->SkipRows; GLint rowLength; if (packing->RowLength > 0) rowLength = packing->RowLength; else rowLength = width; /* horizontal clipping */ if (srcX < ctx->ReadBuffer->Xmin) { skipPixels += (ctx->ReadBuffer->Xmin - srcX); readWidth -= (ctx->ReadBuffer->Xmin - srcX); srcX = ctx->ReadBuffer->Xmin; } if (srcX + readWidth > ctx->ReadBuffer->Xmax) readWidth -= (srcX + readWidth - ctx->ReadBuffer->Xmax - 1); if (readWidth <= 0) return GL_TRUE; /* vertical clipping */ if (srcY < ctx->ReadBuffer->Ymin) { skipRows += (ctx->ReadBuffer->Ymin - srcY); readHeight -= (ctx->ReadBuffer->Ymin - srcY); srcY = ctx->ReadBuffer->Ymin; } if (srcY + readHeight > ctx->ReadBuffer->Ymax) readHeight -= (srcY + readHeight - ctx->ReadBuffer->Ymax - 1); if (readHeight <= 0) return GL_TRUE; /* * Ready to read! * The window region at (destX, destY) of size (readWidth, readHeight) * will be read back. * We'll write pixel data to buffer pointed to by "pixels" but we'll * skip "skipRows" rows and skip "skipPixels" pixels/row. */ if (format==GL_RGBA && type==GL_UNSIGNED_BYTE) { GLubyte *dest = (GLubyte *) pixels + (skipRows * rowLength + skipPixels) * 4; GLint row; for (row=0; rowDriver.ReadRGBASpan)(ctx, readWidth, srcX, srcY, (GLubyte (*)[4]) dest); if (ctx->DrawBuffer->UseSoftwareAlphaBuffers) { _mesa_read_alpha_span(ctx, readWidth, srcX, srcY, (GLubyte (*)[4]) dest); } dest += rowLength * 4; srcY++; } return GL_TRUE; } else { /* can't do this format/type combination */ return GL_FALSE; } } } /* * This function converts an array of GLchan colors to GLfloat colors. * Most importantly, it undoes the non-uniform quantization of pixel * values introduced when we convert shallow (< 8 bit) pixel values * to GLubytes in the ctx->Driver.ReadRGBASpan() functions. * This fixes a number of OpenGL conformance failures when running on * 16bpp displays, for example. */ static void ubyte_to_float_span(const GLcontext *ctx, GLuint n, CONST GLubyte rgba[][4], GLfloat rgbaf[][4]) { const GLuint rShift = 8 - ctx->Visual->RedBits; const GLuint gShift = 8 - ctx->Visual->GreenBits; const GLuint bShift = 8 - ctx->Visual->BlueBits; GLuint aShift; const GLfloat rScale = 1.0 / (GLfloat) ((1 << ctx->Visual->RedBits ) - 1); const GLfloat gScale = 1.0 / (GLfloat) ((1 << ctx->Visual->GreenBits) - 1); const GLfloat bScale = 1.0 / (GLfloat) ((1 << ctx->Visual->BlueBits ) - 1); GLfloat aScale; GLuint i; if (ctx->Visual->AlphaBits > 0) { aShift = 8 - ctx->Visual->AlphaBits; aScale = 1.0 / (GLfloat) ((1 << ctx->Visual->AlphaBits) - 1); } else { aShift = 0; aScale = 1.0F / 255.0F; } for (i = 0; i < n; i++) { const GLint r = rgba[i][RCOMP] >> rShift; const GLint g = rgba[i][GCOMP] >> gShift; const GLint b = rgba[i][BCOMP] >> bShift; const GLint a = rgba[i][ACOMP] >> aShift; rgbaf[i][RCOMP] = (GLfloat) r * rScale; rgbaf[i][GCOMP] = (GLfloat) g * gScale; rgbaf[i][BCOMP] = (GLfloat) b * bScale; rgbaf[i][ACOMP] = (GLfloat) a * aScale; } } /* * Read R, G, B, A, RGB, L, or LA pixels. */ static void read_rgba_pixels( GLcontext *ctx, GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, GLvoid *pixels, const struct gl_pixelstore_attrib *packing ) { GLint readWidth; (*ctx->Driver.SetReadBuffer)(ctx, ctx->ReadBuffer, ctx->Pixel.DriverReadBuffer); /* Try optimized path first */ if (read_fast_rgba_pixels( ctx, x, y, width, height, format, type, pixels, packing )) { (*ctx->Driver.SetReadBuffer)(ctx, ctx->DrawBuffer, ctx->Color.DriverDrawBuffer); return; /* done! */ } readWidth = (width > MAX_WIDTH) ? MAX_WIDTH : width; /* do error checking on pixel type, format was already checked by caller */ switch (type) { case GL_UNSIGNED_BYTE: case GL_BYTE: case GL_UNSIGNED_SHORT: case GL_SHORT: case GL_UNSIGNED_INT: case GL_INT: case GL_FLOAT: case GL_UNSIGNED_BYTE_3_3_2: case GL_UNSIGNED_BYTE_2_3_3_REV: case GL_UNSIGNED_SHORT_5_6_5: case GL_UNSIGNED_SHORT_5_6_5_REV: case GL_UNSIGNED_SHORT_4_4_4_4: case GL_UNSIGNED_SHORT_4_4_4_4_REV: case GL_UNSIGNED_SHORT_5_5_5_1: case GL_UNSIGNED_SHORT_1_5_5_5_REV: case GL_UNSIGNED_INT_8_8_8_8: case GL_UNSIGNED_INT_8_8_8_8_REV: case GL_UNSIGNED_INT_10_10_10_2: case GL_UNSIGNED_INT_2_10_10_10_REV: /* valid pixel type */ break; default: gl_error( ctx, GL_INVALID_ENUM, "glReadPixels(type)" ); return; } if (!_mesa_is_legal_format_and_type(format, type) || format == GL_INTENSITY) { gl_error(ctx, GL_INVALID_OPERATION, "glReadPixels(format or type)"); return; } if (ctx->Visual->RGBAflag) { GLint j; for (j=0;jReadBuffer, readWidth, x, y, rgba ); dest = _mesa_image_address( packing, pixels, width, height, format, type, 0, j, 0); if (ctx->Visual->RedBits < 8 || ctx->Visual->GreenBits < 8 || ctx->Visual->BlueBits < 8) { /* Requantize the color values into floating point and go from * there. This fixes conformance failures with 16-bit color * buffers, for example. */ GLfloat rgbaf[MAX_WIDTH][4]; ubyte_to_float_span(ctx, readWidth, (CONST GLubyte (*)[4]) rgba, rgbaf); _mesa_pack_float_rgba_span(ctx, readWidth, (CONST GLfloat (*)[4]) rgbaf, format, type, dest, packing, GL_TRUE); } else { /* GLubytes are fine */ _mesa_pack_rgba_span(ctx, readWidth, (CONST GLchan (*)[4]) rgba, format, type, dest, packing, GL_TRUE); } } } else { /* Convert color index pixels to RGBA */ GLint j; for (j=0;jDriver.ReadCI32Span)( ctx, readWidth, x, y, index ); if (ctx->Pixel.IndexShift!=0 || ctx->Pixel.IndexOffset!=0) { _mesa_map_ci( ctx, readWidth, index ); } _mesa_map_ci_to_rgba_ubyte(ctx, readWidth, index, rgba ); dest = _mesa_image_address( packing, pixels, width, height, format, type, 0, j, 0); _mesa_pack_rgba_span( ctx, readWidth, (CONST GLubyte (*)[4]) rgba, format, type, dest, packing, GL_TRUE ); } } (*ctx->Driver.SetReadBuffer)( ctx, ctx->DrawBuffer, ctx->Color.DriverDrawBuffer ); } void _mesa_ReadPixels( GLint x, GLint y, GLsizei width, GLsizei height, GLenum format, GLenum type, GLvoid *pixels ) { GET_CURRENT_CONTEXT(ctx); ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx, "glReadPixels"); if (!pixels) { gl_error( ctx, GL_INVALID_VALUE, "glReadPixels(pixels)" ); return; } if (ctx->NewState) { gl_update_state(ctx); } if (ctx->Driver.ReadPixels && (*ctx->Driver.ReadPixels)(ctx, x, y, width, height, format, type, &ctx->Pack, pixels)) return; RENDER_START(ctx); switch (format) { case GL_COLOR_INDEX: read_index_pixels(ctx, x, y, width, height, type, pixels, &ctx->Pack); break; case GL_STENCIL_INDEX: read_stencil_pixels(ctx, x,y, width,height, type, pixels, &ctx->Pack); break; case GL_DEPTH_COMPONENT: read_depth_pixels(ctx, x, y, width, height, type, pixels, &ctx->Pack); break; case GL_RED: case GL_GREEN: case GL_BLUE: case GL_ALPHA: case GL_RGB: case GL_LUMINANCE: case GL_LUMINANCE_ALPHA: case GL_RGBA: case GL_BGR: case GL_BGRA: case GL_ABGR_EXT: read_rgba_pixels(ctx, x, y, width, height, format, type, pixels, &ctx->Pack); break; default: gl_error( ctx, GL_INVALID_ENUM, "glReadPixels(format)" ); } RENDER_FINISH(ctx); }