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? */
42static inline GLboolean
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 */
53static inline GLboolean
54_mesa_is_bufferobj(const struct gl_buffer_object *obj)
55{
56   return obj != NULL && obj->Name != 0;
57}
58
59
60extern void
61_mesa_init_buffer_objects( struct gl_context *ctx );
62
63extern void
64_mesa_free_buffer_objects( struct gl_context *ctx );
65
66extern void
67_mesa_update_default_objects_buffer_objects(struct gl_context *ctx);
68
69
70extern struct gl_buffer_object *
71_mesa_lookup_bufferobj(struct gl_context *ctx, GLuint buffer);
72
73extern void
74_mesa_initialize_buffer_object( struct gl_context *ctx,
75				struct gl_buffer_object *obj,
76				GLuint name, GLenum target );
77
78extern void
79_mesa_reference_buffer_object_(struct gl_context *ctx,
80                               struct gl_buffer_object **ptr,
81                               struct gl_buffer_object *bufObj);
82
83static inline void
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
92extern GLuint
93_mesa_total_buffer_object_memory(struct gl_context *ctx);
94
95extern void
96_mesa_init_buffer_object_functions(struct dd_function_table *driver);
97
98
99/*
100 * API functions
101 */
102
103extern void GLAPIENTRY
104_mesa_BindBufferARB(GLenum target, GLuint buffer);
105
106extern void GLAPIENTRY
107_mesa_DeleteBuffersARB(GLsizei n, const GLuint * buffer);
108
109extern void GLAPIENTRY
110_mesa_GenBuffersARB(GLsizei n, GLuint * buffer);
111
112extern GLboolean GLAPIENTRY
113_mesa_IsBufferARB(GLuint buffer);
114
115extern void GLAPIENTRY
116_mesa_BufferDataARB(GLenum target, GLsizeiptrARB size, const GLvoid * data, GLenum usage);
117
118extern void GLAPIENTRY
119_mesa_BufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, const GLvoid * data);
120
121extern void GLAPIENTRY
122_mesa_GetBufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, void * data);
123
124extern void * GLAPIENTRY
125_mesa_MapBufferARB(GLenum target, GLenum access);
126
127extern GLboolean GLAPIENTRY
128_mesa_UnmapBufferARB(GLenum target);
129
130extern void GLAPIENTRY
131_mesa_GetBufferParameterivARB(GLenum target, GLenum pname, GLint *params);
132
133extern void GLAPIENTRY
134_mesa_GetBufferParameteri64v(GLenum target, GLenum pname, GLint64 *params);
135
136extern void GLAPIENTRY
137_mesa_GetBufferPointervARB(GLenum target, GLenum pname, GLvoid **params);
138
139extern void GLAPIENTRY
140_mesa_CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
141                        GLintptr readOffset, GLintptr writeOffset,
142                        GLsizeiptr size);
143
144extern void * GLAPIENTRY
145_mesa_MapBufferRange(GLenum target, GLintptr offset, GLsizeiptr length,
146                     GLbitfield access);
147
148extern void GLAPIENTRY
149_mesa_FlushMappedBufferRange(GLenum target, GLintptr offset, GLsizeiptr length);
150
151#if FEATURE_APPLE_object_purgeable
152extern GLenum GLAPIENTRY
153_mesa_ObjectPurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
154
155extern GLenum GLAPIENTRY
156_mesa_ObjectUnpurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
157
158extern void GLAPIENTRY
159_mesa_GetObjectParameterivAPPLE(GLenum objectType, GLuint name, GLenum pname, GLint* params);
160#endif
161
162void GLAPIENTRY
163_mesa_BindBufferBase(GLenum target, GLuint index, GLuint buffer);
164
165void GLAPIENTRY
166_mesa_BindBufferRange(GLenum target, GLuint index,
167                      GLuint buffer, GLintptr offset, GLsizeiptr size);
168
169extern void
170_mesa_init_bufferobj_dispatch(struct gl_context *ctx,
171                              struct _glapi_table *disp);
172
173#endif
174