mesa: _mesa_CopyBufferSubData() function, and driver fall-back
[mesa.git] / src / mesa / main / bufferobj.h
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.6
4 *
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Copyright (C) 2009 VMware, Inc. All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 */
25
26
27
28 #ifndef BUFFEROBJ_H
29 #define BUFFEROBJ_H
30
31
32 #include "context.h"
33
34
35 /*
36 * Internal functions
37 */
38
39 extern void
40 _mesa_init_buffer_objects( GLcontext *ctx );
41
42 extern void
43 _mesa_update_default_objects_buffer_objects(GLcontext *ctx);
44
45 extern struct gl_buffer_object *
46 _mesa_new_buffer_object( GLcontext *ctx, GLuint name, GLenum target );
47
48 extern void
49 _mesa_delete_buffer_object( GLcontext *ctx, struct gl_buffer_object *bufObj );
50
51 extern struct gl_buffer_object *
52 _mesa_lookup_bufferobj(GLcontext *ctx, GLuint buffer);
53
54 extern void
55 _mesa_initialize_buffer_object( struct gl_buffer_object *obj,
56 GLuint name, GLenum target );
57
58 extern void
59 _mesa_reference_buffer_object(GLcontext *ctx,
60 struct gl_buffer_object **ptr,
61 struct gl_buffer_object *bufObj);
62
63 extern void
64 _mesa_buffer_data( GLcontext *ctx, GLenum target, GLsizeiptrARB size,
65 const GLvoid * data, GLenum usage,
66 struct gl_buffer_object * bufObj );
67
68 extern void
69 _mesa_buffer_subdata( GLcontext *ctx, GLenum target, GLintptrARB offset,
70 GLsizeiptrARB size, const GLvoid * data,
71 struct gl_buffer_object * bufObj );
72
73 extern void
74 _mesa_buffer_get_subdata( GLcontext *ctx, GLenum target, GLintptrARB offset,
75 GLsizeiptrARB size, GLvoid * data,
76 struct gl_buffer_object * bufObj );
77
78 extern void *
79 _mesa_buffer_map( GLcontext *ctx, GLenum target, GLenum access,
80 struct gl_buffer_object * bufObj );
81
82 extern GLboolean
83 _mesa_buffer_unmap( GLcontext *ctx, GLenum target,
84 struct gl_buffer_object * bufObj );
85
86 extern void
87 _mesa_copy_buffer_subdata(GLcontext *ctx,
88 struct gl_buffer_object *src,
89 struct gl_buffer_object *dst,
90 GLintptr readOffset, GLintptr writeOffset,
91 GLsizeiptr size);
92
93 extern GLboolean
94 _mesa_validate_pbo_access(GLuint dimensions,
95 const struct gl_pixelstore_attrib *pack,
96 GLsizei width, GLsizei height, GLsizei depth,
97 GLenum format, GLenum type, const GLvoid *ptr);
98
99 extern const GLubyte *
100 _mesa_map_bitmap_pbo(GLcontext *ctx,
101 const struct gl_pixelstore_attrib *unpack,
102 const GLubyte *bitmap);
103
104 extern void
105 _mesa_unmap_bitmap_pbo(GLcontext *ctx,
106 const struct gl_pixelstore_attrib *unpack);
107
108 extern const GLvoid *
109 _mesa_map_drawpix_pbo(GLcontext *ctx,
110 const struct gl_pixelstore_attrib *unpack,
111 const GLvoid *pixels);
112
113 extern void
114 _mesa_unmap_drawpix_pbo(GLcontext *ctx,
115 const struct gl_pixelstore_attrib *unpack);
116
117 extern void *
118 _mesa_map_readpix_pbo(GLcontext *ctx,
119 const struct gl_pixelstore_attrib *pack,
120 GLvoid *dest);
121
122 extern void
123 _mesa_unmap_readpix_pbo(GLcontext *ctx,
124 const struct gl_pixelstore_attrib *pack);
125
126
127
128 /*
129 * API functions
130 */
131
132 extern void GLAPIENTRY
133 _mesa_BindBufferARB(GLenum target, GLuint buffer);
134
135 extern void GLAPIENTRY
136 _mesa_DeleteBuffersARB(GLsizei n, const GLuint * buffer);
137
138 extern void GLAPIENTRY
139 _mesa_GenBuffersARB(GLsizei n, GLuint * buffer);
140
141 extern GLboolean GLAPIENTRY
142 _mesa_IsBufferARB(GLuint buffer);
143
144 extern void GLAPIENTRY
145 _mesa_BufferDataARB(GLenum target, GLsizeiptrARB size, const GLvoid * data, GLenum usage);
146
147 extern void GLAPIENTRY
148 _mesa_BufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, const GLvoid * data);
149
150 extern void GLAPIENTRY
151 _mesa_GetBufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, void * data);
152
153 extern void * GLAPIENTRY
154 _mesa_MapBufferARB(GLenum target, GLenum access);
155
156 extern GLboolean GLAPIENTRY
157 _mesa_UnmapBufferARB(GLenum target);
158
159 extern void GLAPIENTRY
160 _mesa_GetBufferParameterivARB(GLenum target, GLenum pname, GLint *params);
161
162 extern void GLAPIENTRY
163 _mesa_GetBufferPointervARB(GLenum target, GLenum pname, GLvoid **params);
164
165 extern void GLAPIENTRY
166 _mesa_CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
167 GLintptr readOffset, GLintptr writeOffset,
168 GLsizeiptr size);
169
170 #endif