src/mesa/main/image.h

   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
  26 #ifndef IMAGE_H
  27 #define IMAGE_H
  28
  29
  30 #include "mtypes.h"
  31
  32
  33 extern void
  34 _mesa_swap2( GLushort *p, GLuint n );
  35
  36 extern void
  37 _mesa_swap4( GLuint *p, GLuint n );
  38
  39 extern GLboolean
  40 _mesa_type_is_packed(GLenum type);
  41
  42 extern GLint
  43 _mesa_sizeof_type( GLenum type );
  44
  45 extern GLint
  46 _mesa_sizeof_packed_type( GLenum type );
  47
  48 extern GLint
  49 _mesa_components_in_format( GLenum format );
  50
  51 extern GLint
  52 _mesa_bytes_per_pixel( GLenum format, GLenum type );
  53
  54 extern GLboolean
  55 _mesa_is_legal_format_and_type( struct gl_context *ctx, GLenum format, GLenum type );
  56
  57 extern GLboolean
  58 _mesa_is_color_format(GLenum format);
  59
  60 extern GLboolean
  61 _mesa_is_index_format(GLenum format);
  62
  63 extern GLboolean
  64 _mesa_is_depth_format(GLenum format);
  65
  66 extern GLboolean
  67 _mesa_is_stencil_format(GLenum format);
  68
  69 extern GLboolean
  70 _mesa_is_ycbcr_format(GLenum format);
  71
  72 extern GLboolean
  73 _mesa_is_depthstencil_format(GLenum format);
  74
  75 extern GLboolean
  76 _mesa_is_depth_or_stencil_format(GLenum format);
  77
  78 extern GLboolean
  79 _mesa_is_dudv_format(GLenum format);
  80
  81 extern GLboolean
  82 _mesa_is_integer_format(GLenum format);
  83
  84 extern GLboolean
  85 _mesa_is_compressed_format(struct gl_context *ctx, GLenum format);
  86
  87 extern GLvoid *
  88 _mesa_image_address( GLuint dimensions,
  89                      const struct gl_pixelstore_attrib *packing,
  90                      const GLvoid *image,
  91                      GLsizei width, GLsizei height,
  92                      GLenum format, GLenum type,
  93                      GLint img, GLint row, GLint column );
  94
  95 extern GLvoid *
  96 _mesa_image_address1d( const struct gl_pixelstore_attrib *packing,
  97                        const GLvoid *image,
  98                        GLsizei width,
  99                        GLenum format, GLenum type,
 100                        GLint column );
 101
 102 extern GLvoid *
 103 _mesa_image_address2d( const struct gl_pixelstore_attrib *packing,
 104                        const GLvoid *image,
 105                        GLsizei width, GLsizei height,
 106                        GLenum format, GLenum type,
 107                        GLint row, GLint column );
 108
 109 extern GLvoid *
 110 _mesa_image_address3d( const struct gl_pixelstore_attrib *packing,
 111                        const GLvoid *image,
 112                        GLsizei width, GLsizei height,
 113                        GLenum format, GLenum type,
 114                        GLint img, GLint row, GLint column );
 115
 116
 117 extern GLint
 118 _mesa_image_row_stride( const struct gl_pixelstore_attrib *packing,
 119                         GLint width, GLenum format, GLenum type );
 120
 121
 122 extern GLint
 123 _mesa_image_image_stride( const struct gl_pixelstore_attrib *packing,
 124                           GLint width, GLint height,
 125                           GLenum format, GLenum type );
 126
 127 extern void
 128 _mesa_unpack_polygon_stipple( const GLubyte *pattern, GLuint dest[32],
 129                               const struct gl_pixelstore_attrib *unpacking );
 130
 131
 132 extern void
 133 _mesa_pack_polygon_stipple( const GLuint pattern[32], GLubyte *dest,
 134                             const struct gl_pixelstore_attrib *packing );
 135
 136
 137 extern GLvoid *
 138 _mesa_unpack_bitmap( GLint width, GLint height, const GLubyte *pixels,
 139                      const struct gl_pixelstore_attrib *packing );
 140
 141 extern void
 142 _mesa_pack_bitmap( GLint width, GLint height, const GLubyte *source,
 143                    GLubyte *dest, const struct gl_pixelstore_attrib *packing );
 144
 145 extern void
 146 _mesa_expand_bitmap(GLsizei width, GLsizei height,
 147                     const struct gl_pixelstore_attrib *unpack,
 148                     const GLubyte *bitmap,
 149                     GLubyte *destBuffer, GLint destStride,
 150                     GLubyte onValue);
 151
 152
 153 /** \name Pixel processing functions */
 154 /*@{*/
 155
 156 extern void
 157 _mesa_scale_and_bias_rgba(GLuint n, GLfloat rgba[][4],
 158                           GLfloat rScale, GLfloat gScale,
 159                           GLfloat bScale, GLfloat aScale,
 160                           GLfloat rBias, GLfloat gBias,
 161                           GLfloat bBias, GLfloat aBias);
 162
 163 extern void
 164 _mesa_map_rgba(const struct gl_context *ctx, GLuint n, GLfloat rgba[][4]);
 165
 166 extern void
 167 _mesa_lookup_rgba_float(const struct gl_color_table *table,
 168                         GLuint n, GLfloat rgba[][4]);
 169
 170 extern void
 171 _mesa_lookup_rgba_ubyte(const struct gl_color_table *table,
 172                         GLuint n, GLubyte rgba[][4]);
 173
 174
 175 extern void
 176 _mesa_map_ci_to_rgba(const struct gl_context *ctx,
 177                      GLuint n, const GLuint index[], GLfloat rgba[][4]);
 178
 179
 180 extern void
 181 _mesa_map_ci8_to_rgba8(const struct gl_context *ctx, GLuint n, const GLubyte index[],
 182                        GLubyte rgba[][4]);
 183
 184
 185 extern void
 186 _mesa_scale_and_bias_depth(const struct gl_context *ctx, GLuint n,
 187                            GLfloat depthValues[]);
 188
 189 extern void
 190 _mesa_scale_and_bias_depth_uint(const struct gl_context *ctx, GLuint n,
 191                                 GLuint depthValues[]);
 192
 193 extern void
 194 _mesa_apply_rgba_transfer_ops(struct gl_context *ctx, GLbitfield transferOps,
 195                               GLuint n, GLfloat rgba[][4]);
 196
 197
 198 extern void
 199 _mesa_apply_ci_transfer_ops(const struct gl_context *ctx, GLbitfield transferOps,
 200                             GLuint n, GLuint indexes[]);
 201
 202
 203 extern void
 204 _mesa_apply_stencil_transfer_ops(const struct gl_context *ctx, GLuint n,
 205                                  GLstencil stencil[]);
 206
 207
 208 extern void
 209 _mesa_pack_rgba_span_float( struct gl_context *ctx, GLuint n, GLfloat rgba[][4],
 210                             GLenum dstFormat, GLenum dstType, GLvoid *dstAddr,
 211                             const struct gl_pixelstore_attrib *dstPacking,
 212                             GLbitfield transferOps );
 213
 214
 215 extern void
 216 _mesa_unpack_color_span_chan( struct gl_context *ctx,
 217                               GLuint n, GLenum dstFormat, GLchan dest[],
 218                               GLenum srcFormat, GLenum srcType,
 219                               const GLvoid *source,
 220                               const struct gl_pixelstore_attrib *srcPacking,
 221                               GLbitfield transferOps );
 222
 223
 224 extern void
 225 _mesa_unpack_color_span_float( struct gl_context *ctx,
 226                                GLuint n, GLenum dstFormat, GLfloat dest[],
 227                                GLenum srcFormat, GLenum srcType,
 228                                const GLvoid *source,
 229                                const struct gl_pixelstore_attrib *srcPacking,
 230                                GLbitfield transferOps );
 231
 232 extern void
 233 _mesa_unpack_dudv_span_byte( struct gl_context *ctx,
 234                              GLuint n, GLenum dstFormat, GLbyte dest[],
 235                              GLenum srcFormat, GLenum srcType,
 236                              const GLvoid *source,
 237                              const struct gl_pixelstore_attrib *srcPacking,
 238                              GLbitfield transferOps );
 239
 240 extern void
 241 _mesa_unpack_index_span( const struct gl_context *ctx, GLuint n,
 242                          GLenum dstType, GLvoid *dest,
 243                          GLenum srcType, const GLvoid *source,
 244                          const struct gl_pixelstore_attrib *srcPacking,
 245                          GLbitfield transferOps );
 246
 247
 248 extern void
 249 _mesa_pack_index_span( const struct gl_context *ctx, GLuint n,
 250                        GLenum dstType, GLvoid *dest, const GLuint *source,
 251                        const struct gl_pixelstore_attrib *dstPacking,
 252                        GLbitfield transferOps );
 253
 254
 255 extern void
 256 _mesa_unpack_stencil_span( const struct gl_context *ctx, GLuint n,
 257                            GLenum dstType, GLvoid *dest,
 258                            GLenum srcType, const GLvoid *source,
 259                            const struct gl_pixelstore_attrib *srcPacking,
 260                            GLbitfield transferOps );
 261
 262 extern void
 263 _mesa_pack_stencil_span( const struct gl_context *ctx, GLuint n,
 264                          GLenum dstType, GLvoid *dest, const GLstencil *source,
 265                          const struct gl_pixelstore_attrib *dstPacking );
 266
 267
 268 extern void
 269 _mesa_unpack_depth_span( const struct gl_context *ctx, GLuint n,
 270                          GLenum dstType, GLvoid *dest, GLuint depthMax,
 271                          GLenum srcType, const GLvoid *source,
 272                          const struct gl_pixelstore_attrib *srcPacking );
 273
 274 extern void
 275 _mesa_pack_depth_span( const struct gl_context *ctx, GLuint n, GLvoid *dest,
 276                        GLenum dstType, const GLfloat *depthSpan,
 277                        const struct gl_pixelstore_attrib *dstPacking );
 278
 279
 280 extern void
 281 _mesa_pack_depth_stencil_span(const struct gl_context *ctx, GLuint n, GLuint *dest,
 282                               const GLfloat *depthVals,
 283                               const GLstencil *stencilVals,
 284                               const struct gl_pixelstore_attrib *dstPacking);
 285
 286
 287 extern void *
 288 _mesa_unpack_image( GLuint dimensions,
 289                     GLsizei width, GLsizei height, GLsizei depth,
 290                     GLenum format, GLenum type, const GLvoid *pixels,
 291                     const struct gl_pixelstore_attrib *unpack );
 292
 293
 294 extern void
 295 _mesa_convert_colors(GLenum srcType, const GLvoid *src,
 296                      GLenum dstType, GLvoid *dst,
 297                      GLuint count, const GLubyte mask[]);
 298
 299
 300 extern GLboolean
 301 _mesa_clip_drawpixels(const struct gl_context *ctx,
 302                       GLint *destX, GLint *destY,
 303                       GLsizei *width, GLsizei *height,
 304                       struct gl_pixelstore_attrib *unpack);
 305
 306
 307 extern GLboolean
 308 _mesa_clip_readpixels(const struct gl_context *ctx,
 309                       GLint *srcX, GLint *srcY,
 310                       GLsizei *width, GLsizei *height,
 311                       struct gl_pixelstore_attrib *pack);
 312
 313 extern GLboolean
 314 _mesa_clip_copytexsubimage(const struct gl_context *ctx,
 315                            GLint *destX, GLint *destY,
 316                            GLint *srcX, GLint *srcY,
 317                            GLsizei *width, GLsizei *height);
 318
 319 extern GLboolean
 320 _mesa_clip_to_region(GLint xmin, GLint ymin,
 321                      GLint xmax, GLint ymax,
 322                      GLint *x, GLint *y,
 323                      GLsizei *width, GLsizei *height );
 324
 325 extern GLboolean
 326 _mesa_clip_blit(struct gl_context *ctx,
 327                 GLint *srcX0, GLint *srcY0, GLint *srcX1, GLint *srcY1,
 328                 GLint *dstX0, GLint *dstY0, GLint *dstX1, GLint *dstY1);
 329
 330
 331 #endif