texstore.h revision 1ad7b99925e044f82e635f746c1ef2df77f69ac9 
1/*
2 * Mesa 3-D graphics library
3 * Version:  6.5
4 *
5 * Copyright (C) 1999-2005  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/**
27 * \file texstore.h
28 * Texture image storage routines.
29 *
30 * \author Brian Paul
31 */
32
33
34#ifndef TEXSTORE_H
35#define TEXSTORE_H
36
37
38#include "mtypes.h"
39
40/* Macro just to save some typing */
41#define STORE_PARAMS \
42	GLcontext *ctx, GLuint dims, \
43	GLenum baseInternalFormat, \
44	const struct gl_texture_format *dstFormat, \
45	GLvoid *dstAddr, \
46	GLint dstXoffset, GLint dstYoffset, GLint dstZoffset, \
47	GLint dstRowStride, GLint dstImageStride, \
48	GLint srcWidth, GLint srcHeight, GLint srcDepth, \
49	GLenum srcFormat, GLenum srcType, \
50	const GLvoid *srcAddr, \
51	const struct gl_pixelstore_attrib *srcPacking
52
53
54extern GLboolean _mesa_texstore_rgba(STORE_PARAMS);
55extern GLboolean _mesa_texstore_color_index(STORE_PARAMS);
56extern GLboolean _mesa_texstore_depth_component16(STORE_PARAMS);
57extern GLboolean _mesa_texstore_depth_component_float32(STORE_PARAMS);
58extern GLboolean _mesa_texstore_rgba8888(STORE_PARAMS);
59extern GLboolean _mesa_texstore_argb8888(STORE_PARAMS);
60extern GLboolean _mesa_texstore_rgb888(STORE_PARAMS);
61extern GLboolean _mesa_texstore_bgr888(STORE_PARAMS);
62extern GLboolean _mesa_texstore_rgb565(STORE_PARAMS);
63extern GLboolean _mesa_texstore_rgb565_rev(STORE_PARAMS);
64extern GLboolean _mesa_texstore_argb4444(STORE_PARAMS);
65extern GLboolean _mesa_texstore_argb4444_rev(STORE_PARAMS);
66extern GLboolean _mesa_texstore_argb1555(STORE_PARAMS);
67extern GLboolean _mesa_texstore_argb1555_rev(STORE_PARAMS);
68extern GLboolean _mesa_texstore_al88(STORE_PARAMS);
69extern GLboolean _mesa_texstore_al88_rev(STORE_PARAMS);
70extern GLboolean _mesa_texstore_rgb332(STORE_PARAMS);
71extern GLboolean _mesa_texstore_a8(STORE_PARAMS);
72extern GLboolean _mesa_texstore_ci8(STORE_PARAMS);
73extern GLboolean _mesa_texstore_ycbcr(STORE_PARAMS);
74extern GLboolean _mesa_texstore_z24_s8(STORE_PARAMS);
75extern GLboolean _mesa_texstore_rgba_float32(STORE_PARAMS);
76extern GLboolean _mesa_texstore_rgba_float16(STORE_PARAMS);
77extern GLboolean _mesa_texstore_rgb_fxt1(STORE_PARAMS);
78extern GLboolean _mesa_texstore_rgba_fxt1(STORE_PARAMS);
79extern GLboolean _mesa_texstore_rgb_dxt1(STORE_PARAMS);
80extern GLboolean _mesa_texstore_rgba_dxt1(STORE_PARAMS);
81extern GLboolean _mesa_texstore_rgba_dxt3(STORE_PARAMS);
82extern GLboolean _mesa_texstore_rgba_dxt5(STORE_PARAMS);
83
84
85extern GLchan *
86_mesa_make_temp_chan_image(GLcontext *ctx, GLuint dims,
87                           GLenum logicalBaseFormat,
88                           GLenum textureBaseFormat,
89                           GLint srcWidth, GLint srcHeight, GLint srcDepth,
90                           GLenum srcFormat, GLenum srcType,
91                           const GLvoid *srcAddr,
92                           const struct gl_pixelstore_attrib *srcPacking);
93
94
95extern void
96_mesa_store_teximage1d(GLcontext *ctx, GLenum target, GLint level,
97                       GLint internalFormat,
98                       GLint width, GLint border,
99                       GLenum format, GLenum type, const GLvoid *pixels,
100                       const struct gl_pixelstore_attrib *packing,
101                       struct gl_texture_object *texObj,
102                       struct gl_texture_image *texImage);
103
104
105extern void
106_mesa_store_teximage2d(GLcontext *ctx, GLenum target, GLint level,
107                       GLint internalFormat,
108                       GLint width, GLint height, GLint border,
109                       GLenum format, GLenum type, const GLvoid *pixels,
110                       const struct gl_pixelstore_attrib *packing,
111                       struct gl_texture_object *texObj,
112                       struct gl_texture_image *texImage);
113
114
115extern void
116_mesa_store_teximage3d(GLcontext *ctx, GLenum target, GLint level,
117                       GLint internalFormat,
118                       GLint width, GLint height, GLint depth, GLint border,
119                       GLenum format, GLenum type, const GLvoid *pixels,
120                       const struct gl_pixelstore_attrib *packing,
121                       struct gl_texture_object *texObj,
122                       struct gl_texture_image *texImage);
123
124
125extern void
126_mesa_store_texsubimage1d(GLcontext *ctx, GLenum target, GLint level,
127                          GLint xoffset, GLint width,
128                          GLenum format, GLenum type, const GLvoid *pixels,
129                          const struct gl_pixelstore_attrib *packing,
130                          struct gl_texture_object *texObj,
131                          struct gl_texture_image *texImage);
132
133
134extern void
135_mesa_store_texsubimage2d(GLcontext *ctx, GLenum target, GLint level,
136                          GLint xoffset, GLint yoffset,
137                          GLint width, GLint height,
138                          GLenum format, GLenum type, const GLvoid *pixels,
139                          const struct gl_pixelstore_attrib *packing,
140                          struct gl_texture_object *texObj,
141                          struct gl_texture_image *texImage);
142
143
144extern void
145_mesa_store_texsubimage3d(GLcontext *ctx, GLenum target, GLint level,
146                          GLint xoffset, GLint yoffset, GLint zoffset,
147                          GLint width, GLint height, GLint depth,
148                          GLenum format, GLenum type, const GLvoid *pixels,
149                          const struct gl_pixelstore_attrib *packing,
150                          struct gl_texture_object *texObj,
151                          struct gl_texture_image *texImage);
152
153
154extern void
155_mesa_store_compressed_teximage1d(GLcontext *ctx, GLenum target, GLint level,
156                                  GLint internalFormat,
157                                  GLint width, GLint border,
158                                  GLsizei imageSize, const GLvoid *data,
159                                  struct gl_texture_object *texObj,
160                                  struct gl_texture_image *texImage);
161
162extern void
163_mesa_store_compressed_teximage2d(GLcontext *ctx, GLenum target, GLint level,
164                                  GLint internalFormat,
165                                  GLint width, GLint height, GLint border,
166                                  GLsizei imageSize, const GLvoid *data,
167                                  struct gl_texture_object *texObj,
168                                  struct gl_texture_image *texImage);
169
170extern void
171_mesa_store_compressed_teximage3d(GLcontext *ctx, GLenum target, GLint level,
172                                  GLint internalFormat,
173                                  GLint width, GLint height, GLint depth,
174                                  GLint border,
175                                  GLsizei imageSize, const GLvoid *data,
176                                  struct gl_texture_object *texObj,
177                                  struct gl_texture_image *texImage);
178
179
180extern void
181_mesa_store_compressed_texsubimage1d(GLcontext *ctx, GLenum target,
182                                     GLint level,
183                                     GLint xoffset, GLsizei width,
184                                     GLenum format,
185                                     GLsizei imageSize, const GLvoid *data,
186                                     struct gl_texture_object *texObj,
187                                     struct gl_texture_image *texImage);
188
189extern void
190_mesa_store_compressed_texsubimage2d(GLcontext *ctx, GLenum target,
191                                     GLint level,
192                                     GLint xoffset, GLint yoffset,
193                                     GLsizei width, GLsizei height,
194                                     GLenum format,
195                                     GLsizei imageSize, const GLvoid *data,
196                                     struct gl_texture_object *texObj,
197                                     struct gl_texture_image *texImage);
198
199extern void
200_mesa_store_compressed_texsubimage3d(GLcontext *ctx, GLenum target,
201                                GLint level,
202                                GLint xoffset, GLint yoffset, GLint zoffset,
203                                GLsizei width, GLsizei height, GLsizei depth,
204                                GLenum format,
205                                GLsizei imageSize, const GLvoid *data,
206                                struct gl_texture_object *texObj,
207                                struct gl_texture_image *texImage);
208
209
210extern void
211_mesa_generate_mipmap(GLcontext *ctx, GLenum target,
212                      const struct gl_texture_unit *texUnit,
213                      struct gl_texture_object *texObj);
214
215
216extern void
217_mesa_rescale_teximage2d(GLuint bytesPerPixel,
218                         GLuint srcStrideInPixels,
219                         GLuint dstRowStride,
220                         GLint srcWidth, GLint srcHeight,
221                         GLint dstWidth, GLint dstHeight,
222                         const GLvoid *srcImage, GLvoid *dstImage);
223
224extern void
225_mesa_upscale_teximage2d(GLsizei inWidth, GLsizei inHeight,
226                         GLsizei outWidth, GLsizei outHeight,
227                         GLint comps, const GLchan *src, GLint srcRowStride,
228                         GLchan *dest);
229
230
231extern void
232_mesa_get_teximage(GLcontext *ctx, GLenum target, GLint level,
233                   GLenum format, GLenum type, GLvoid *pixels,
234                   const struct gl_texture_object *texObj,
235                   const struct gl_texture_image *texImage);
236
237
238extern void
239_mesa_get_compressed_teximage(GLcontext *ctx, GLenum target, GLint level,
240                              GLvoid *img,
241                              const struct gl_texture_object *texObj,
242                              const struct gl_texture_image *texImage);
243
244extern const GLvoid *
245_mesa_validate_pbo_teximage(GLcontext *ctx, GLuint dimensions,
246			    GLsizei width, GLsizei height, GLsizei depth,
247			    GLenum format, GLenum type, const GLvoid *pixels,
248			    const struct gl_pixelstore_attrib *unpack,
249			    const char *funcName);
250
251extern const GLvoid *
252_mesa_validate_pbo_compressed_teximage(GLcontext *ctx,
253                                    GLsizei imageSize, const GLvoid *pixels,
254                                    const struct gl_pixelstore_attrib *packing,
255                                    const char *funcName);
256
257extern void
258_mesa_unmap_teximage_pbo(GLcontext *ctx,
259                         const struct gl_pixelstore_attrib *unpack);
260
261
262#endif
263