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 "mfeatures.h"
33 #include "mtypes.h"
34 
35 
36 /*
37  * Internal functions
38  */
39 
40 
41 /** Is the given buffer object currently mapped? */
42 static inline GLboolean
_mesa_bufferobj_mapped(const struct gl_buffer_object * obj)43 _mesa_bufferobj_mapped(const struct gl_buffer_object *obj)
44 {
45    return obj->Pointer != NULL;
46 }
47 
48 /**
49  * Is the given buffer object a user-created buffer object?
50  * Mesa uses default buffer objects in several places.  Default buffers
51  * always have Name==0.  User created buffers have Name!=0.
52  */
53 static inline GLboolean
_mesa_is_bufferobj(const struct gl_buffer_object * obj)54 _mesa_is_bufferobj(const struct gl_buffer_object *obj)
55 {
56    return obj != NULL && obj->Name != 0;
57 }
58 
59 
60 extern void
61 _mesa_init_buffer_objects( struct gl_context *ctx );
62 
63 extern void
64 _mesa_free_buffer_objects( struct gl_context *ctx );
65 
66 extern void
67 _mesa_update_default_objects_buffer_objects(struct gl_context *ctx);
68 
69 
70 extern struct gl_buffer_object *
71 _mesa_lookup_bufferobj(struct gl_context *ctx, GLuint buffer);
72 
73 extern void
74 _mesa_initialize_buffer_object( struct gl_context *ctx,
75 				struct gl_buffer_object *obj,
76 				GLuint name, GLenum target );
77 
78 extern void
79 _mesa_reference_buffer_object_(struct gl_context *ctx,
80                                struct gl_buffer_object **ptr,
81                                struct gl_buffer_object *bufObj);
82 
83 static inline void
_mesa_reference_buffer_object(struct gl_context * ctx,struct gl_buffer_object ** ptr,struct gl_buffer_object * bufObj)84 _mesa_reference_buffer_object(struct gl_context *ctx,
85                               struct gl_buffer_object **ptr,
86                               struct gl_buffer_object *bufObj)
87 {
88    if (*ptr != bufObj)
89       _mesa_reference_buffer_object_(ctx, ptr, bufObj);
90 }
91 
92 extern GLuint
93 _mesa_total_buffer_object_memory(struct gl_context *ctx);
94 
95 extern void
96 _mesa_init_buffer_object_functions(struct dd_function_table *driver);
97 
98 
99 /*
100  * API functions
101  */
102 
103 extern void GLAPIENTRY
104 _mesa_BindBufferARB(GLenum target, GLuint buffer);
105 
106 extern void GLAPIENTRY
107 _mesa_DeleteBuffersARB(GLsizei n, const GLuint * buffer);
108 
109 extern void GLAPIENTRY
110 _mesa_GenBuffersARB(GLsizei n, GLuint * buffer);
111 
112 extern GLboolean GLAPIENTRY
113 _mesa_IsBufferARB(GLuint buffer);
114 
115 extern void GLAPIENTRY
116 _mesa_BufferDataARB(GLenum target, GLsizeiptrARB size, const GLvoid * data, GLenum usage);
117 
118 extern void GLAPIENTRY
119 _mesa_BufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, const GLvoid * data);
120 
121 extern void GLAPIENTRY
122 _mesa_GetBufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, void * data);
123 
124 extern void * GLAPIENTRY
125 _mesa_MapBufferARB(GLenum target, GLenum access);
126 
127 extern GLboolean GLAPIENTRY
128 _mesa_UnmapBufferARB(GLenum target);
129 
130 extern void GLAPIENTRY
131 _mesa_GetBufferParameterivARB(GLenum target, GLenum pname, GLint *params);
132 
133 extern void GLAPIENTRY
134 _mesa_GetBufferParameteri64v(GLenum target, GLenum pname, GLint64 *params);
135 
136 extern void GLAPIENTRY
137 _mesa_GetBufferPointervARB(GLenum target, GLenum pname, GLvoid **params);
138 
139 extern void GLAPIENTRY
140 _mesa_CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
141                         GLintptr readOffset, GLintptr writeOffset,
142                         GLsizeiptr size);
143 
144 extern void * GLAPIENTRY
145 _mesa_MapBufferRange(GLenum target, GLintptr offset, GLsizeiptr length,
146                      GLbitfield access);
147 
148 extern void GLAPIENTRY
149 _mesa_FlushMappedBufferRange(GLenum target, GLintptr offset, GLsizeiptr length);
150 
151 #if FEATURE_APPLE_object_purgeable
152 extern GLenum GLAPIENTRY
153 _mesa_ObjectPurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
154 
155 extern GLenum GLAPIENTRY
156 _mesa_ObjectUnpurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
157 
158 extern void GLAPIENTRY
159 _mesa_GetObjectParameterivAPPLE(GLenum objectType, GLuint name, GLenum pname, GLint* params);
160 #endif
161 
162 void GLAPIENTRY
163 _mesa_BindBufferBase(GLenum target, GLuint index, GLuint buffer);
164 
165 void GLAPIENTRY
166 _mesa_BindBufferRange(GLenum target, GLuint index,
167                       GLuint buffer, GLintptr offset, GLsizeiptr size);
168 
169 extern void
170 _mesa_init_bufferobj_dispatch(struct gl_context *ctx,
171                               struct _glapi_table *disp);
172 
173 #endif
174