src/mesa/main/bufferobj.h

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 1999-2008  Brian Paul   All Rights Reserved.
   5  * Copyright (C) 2009  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 OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  21  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  22  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  23  * OTHER DEALINGS IN THE SOFTWARE.
  24  */
  25
  26
  27
  28 #ifndef BUFFEROBJ_H
  29 #define BUFFEROBJ_H
  30
  31 #include <stdbool.h>
  32 #include "mtypes.h"
  33
  34
  35 /*
  36  * Internal functions
  37  */
  38
  39
  40 /** Is the given buffer object currently mapped by the GL user? */
  41 static inline GLboolean
  42 _mesa_bufferobj_mapped(const struct gl_buffer_object *obj,
  43                        gl_map_buffer_index index)
  44 {
  45    return obj->Mappings[index].Pointer != NULL;
  46 }
  47
  48 /** Can we not use this buffer while mapped? */
  49 static inline GLboolean
  50 _mesa_check_disallowed_mapping(const struct gl_buffer_object *obj)
  51 {
  52    return _mesa_bufferobj_mapped(obj, MAP_USER) &&
  53           !(obj->Mappings[MAP_USER].AccessFlags &
  54             GL_MAP_PERSISTENT_BIT);
  55 }
  56
  57 /**
  58  * Is the given buffer object a user-created buffer object?
  59  * Mesa uses default buffer objects in several places.  Default buffers
  60  * always have Name==0.  User created buffers have Name!=0.
  61  */
  62 static inline GLboolean
  63 _mesa_is_bufferobj(const struct gl_buffer_object *obj)
  64 {
  65    return obj != NULL && obj->Name != 0;
  66 }
  67
  68
  69 extern void
  70 _mesa_init_buffer_objects(struct gl_context *ctx);
  71
  72 extern void
  73 _mesa_free_buffer_objects(struct gl_context *ctx);
  74
  75 extern bool
  76 _mesa_handle_bind_buffer_gen(struct gl_context *ctx,
  77                              GLenum target,
  78                              GLuint buffer,
  79                              struct gl_buffer_object **buf_handle,
  80                              const char *caller);
  81
  82 extern void
  83 _mesa_update_default_objects_buffer_objects(struct gl_context *ctx);
  84
  85
  86 extern struct gl_buffer_object *
  87 _mesa_lookup_bufferobj(struct gl_context *ctx, GLuint buffer);
  88
  89 extern struct gl_buffer_object *
  90 _mesa_lookup_bufferobj_locked(struct gl_context *ctx, GLuint buffer);
  91
  92 extern struct gl_buffer_object *
  93 _mesa_lookup_bufferobj_err(struct gl_context *ctx, GLuint buffer,
  94                            const char *caller);
  95
  96 extern void
  97 _mesa_begin_bufferobj_lookups(struct gl_context *ctx);
  98
  99 extern void
 100 _mesa_end_bufferobj_lookups(struct gl_context *ctx);
 101
 102 extern struct gl_buffer_object *
 103 _mesa_multi_bind_lookup_bufferobj(struct gl_context *ctx,
 104                                   const GLuint *buffers,
 105                                   GLuint index, const char *caller);
 106
 107 extern void
 108 _mesa_initialize_buffer_object(struct gl_context *ctx,
 109                                struct gl_buffer_object *obj,
 110                                GLuint name);
 111
 112 extern void
 113 _mesa_reference_buffer_object_(struct gl_context *ctx,
 114                                struct gl_buffer_object **ptr,
 115                                struct gl_buffer_object *bufObj);
 116
 117 static inline void
 118 _mesa_reference_buffer_object(struct gl_context *ctx,
 119                               struct gl_buffer_object **ptr,
 120                               struct gl_buffer_object *bufObj)
 121 {
 122    if (*ptr != bufObj)
 123       _mesa_reference_buffer_object_(ctx, ptr, bufObj);
 124 }
 125
 126 extern GLuint
 127 _mesa_total_buffer_object_memory(struct gl_context *ctx);
 128
 129 extern void
 130 _mesa_init_buffer_object_functions(struct dd_function_table *driver);
 131
 132 extern void
 133 _mesa_buffer_storage(struct gl_context *ctx, struct gl_buffer_object *bufObj,
 134                      GLenum target, GLsizeiptr size, const GLvoid *data,
 135                      GLbitfield flags, const char *func);
 136
 137 extern void
 138 _mesa_buffer_unmap_all_mappings(struct gl_context *ctx,
 139                                 struct gl_buffer_object *bufObj);
 140
 141 extern void
 142 _mesa_buffer_clear_subdata(struct gl_context *ctx,
 143                            GLintptr offset, GLsizeiptr size,
 144                            const GLvoid *clearValue,
 145                            GLsizeiptr clearValueSize,
 146                            struct gl_buffer_object *bufObj);
 147
 148 /*
 149  * API functions
 150  */
 151 void GLAPIENTRY
 152 _mesa_BindBuffer(GLenum target, GLuint buffer);
 153
 154 void GLAPIENTRY
 155 _mesa_DeleteBuffers(GLsizei n, const GLuint * buffer);
 156
 157 void GLAPIENTRY
 158 _mesa_GenBuffers(GLsizei n, GLuint *buffers);
 159
 160 void GLAPIENTRY
 161 _mesa_CreateBuffers(GLsizei n, GLuint *buffers);
 162
 163 GLboolean GLAPIENTRY
 164 _mesa_IsBuffer(GLuint buffer);
 165
 166 void GLAPIENTRY
 167 _mesa_BufferStorage(GLenum target, GLsizeiptr size, const GLvoid *data,
 168                     GLbitfield flags);
 169
 170 void GLAPIENTRY
 171 _mesa_NamedBufferStorage(GLuint buffer, GLsizeiptr size, const GLvoid *data,
 172                          GLbitfield flags);
 173
 174 void GLAPIENTRY
 175 _mesa_BufferData(GLenum target, GLsizeiptrARB size,
 176                  const GLvoid * data, GLenum usage);
 177
 178 void GLAPIENTRY
 179 _mesa_BufferSubData(GLenum target, GLintptrARB offset,
 180                     GLsizeiptrARB size, const GLvoid * data);
 181
 182 void GLAPIENTRY
 183 _mesa_GetBufferSubData(GLenum target, GLintptrARB offset,
 184                        GLsizeiptrARB size, void * data);
 185
 186 void GLAPIENTRY
 187 _mesa_ClearBufferData(GLenum target, GLenum internalformat,
 188                       GLenum format, GLenum type,
 189                       const GLvoid * data);
 190
 191 void GLAPIENTRY
 192 _mesa_ClearBufferSubData(GLenum target, GLenum internalformat,
 193                          GLintptr offset, GLsizeiptr size,
 194                          GLenum format, GLenum type,
 195                          const GLvoid * data);
 196
 197 void * GLAPIENTRY
 198 _mesa_MapBuffer(GLenum target, GLenum access);
 199
 200 GLboolean GLAPIENTRY
 201 _mesa_UnmapBuffer(GLenum target);
 202
 203 void GLAPIENTRY
 204 _mesa_GetBufferParameteriv(GLenum target, GLenum pname, GLint *params);
 205
 206 void GLAPIENTRY
 207 _mesa_GetBufferParameteri64v(GLenum target, GLenum pname, GLint64 *params);
 208
 209 void GLAPIENTRY
 210 _mesa_GetBufferPointerv(GLenum target, GLenum pname, GLvoid **params);
 211
 212 void GLAPIENTRY
 213 _mesa_CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
 214                         GLintptr readOffset, GLintptr writeOffset,
 215                         GLsizeiptr size);
 216
 217 void * GLAPIENTRY
 218 _mesa_MapBufferRange(GLenum target, GLintptr offset, GLsizeiptr length,
 219                      GLbitfield access);
 220
 221 void GLAPIENTRY
 222 _mesa_FlushMappedBufferRange(GLenum target,
 223                              GLintptr offset, GLsizeiptr length);
 224
 225 GLenum GLAPIENTRY
 226 _mesa_ObjectPurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
 227
 228 GLenum GLAPIENTRY
 229 _mesa_ObjectUnpurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
 230
 231 void GLAPIENTRY
 232 _mesa_GetObjectParameterivAPPLE(GLenum objectType, GLuint name,
 233                                 GLenum pname, GLint* params);
 234
 235 void GLAPIENTRY
 236 _mesa_BindBufferRange(GLenum target, GLuint index,
 237                       GLuint buffer, GLintptr offset, GLsizeiptr size);
 238
 239 void GLAPIENTRY
 240 _mesa_BindBufferBase(GLenum target, GLuint index, GLuint buffer);
 241
 242 void GLAPIENTRY
 243 _mesa_BindBuffersRange(GLenum target, GLuint first, GLsizei count,
 244                        const GLuint *buffers,
 245                        const GLintptr *offsets, const GLsizeiptr *sizes);
 246 void GLAPIENTRY
 247 _mesa_BindBuffersBase(GLenum target, GLuint first, GLsizei count,
 248                       const GLuint *buffers);
 249 void GLAPIENTRY
 250 _mesa_InvalidateBufferSubData(GLuint buffer, GLintptr offset,
 251                               GLsizeiptr length);
 252
 253 void GLAPIENTRY
 254 _mesa_InvalidateBufferData(GLuint buffer);
 255
 256
 257 #endif