1 /*
2  * Mesa 3-D graphics library
3  *
4  * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
5  * Copyright (C) 2009-2011  VMware, Inc.  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  * THE AUTHORS 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 PBO_H
27 #define PBO_H
28 
29 
30 #include "mtypes.h"
31 
32 
33 extern GLboolean
34 _mesa_validate_pbo_access(GLuint dimensions,
35                           const struct gl_pixelstore_attrib *pack,
36                           GLsizei width, GLsizei height, GLsizei depth,
37                           GLenum format, GLenum type, GLsizei clientMemSize,
38                           const GLvoid *ptr);
39 
40 extern const GLvoid *
41 _mesa_map_pbo_source(struct gl_context *ctx,
42                      const struct gl_pixelstore_attrib *unpack,
43                      const GLvoid *src);
44 
45 extern const GLvoid *
46 _mesa_map_validate_pbo_source(struct gl_context *ctx,
47                               GLuint dimensions,
48                               const struct gl_pixelstore_attrib *unpack,
49                               GLsizei width, GLsizei height, GLsizei depth,
50                               GLenum format, GLenum type, GLsizei clientMemSize,
51                               const GLvoid *ptr, const char *where);
52 
53 extern void
54 _mesa_unmap_pbo_source(struct gl_context *ctx,
55                        const struct gl_pixelstore_attrib *unpack);
56 
57 extern void *
58 _mesa_map_pbo_dest(struct gl_context *ctx,
59                    const struct gl_pixelstore_attrib *pack,
60                    GLvoid *dest);
61 
62 extern GLvoid *
63 _mesa_map_validate_pbo_dest(struct gl_context *ctx,
64                             GLuint dimensions,
65                             const struct gl_pixelstore_attrib *unpack,
66                             GLsizei width, GLsizei height, GLsizei depth,
67                             GLenum format, GLenum type, GLsizei clientMemSize,
68                             GLvoid *ptr, const char *where);
69 
70 extern void
71 _mesa_unmap_pbo_dest(struct gl_context *ctx,
72                      const struct gl_pixelstore_attrib *pack);
73 
74 
75 extern const GLvoid *
76 _mesa_validate_pbo_teximage(struct gl_context *ctx, GLuint dimensions,
77 			    GLsizei width, GLsizei height, GLsizei depth,
78 			    GLenum format, GLenum type, const GLvoid *pixels,
79 			    const struct gl_pixelstore_attrib *unpack,
80 			    const char *funcName);
81 
82 extern const GLvoid *
83 _mesa_validate_pbo_compressed_teximage(struct gl_context *ctx,
84                                     GLsizei imageSize, const GLvoid *pixels,
85                                     const struct gl_pixelstore_attrib *packing,
86                                     const char *funcName);
87 
88 extern void
89 _mesa_unmap_teximage_pbo(struct gl_context *ctx,
90                          const struct gl_pixelstore_attrib *unpack);
91 
92 
93 #endif
94