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