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 "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
  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
  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
  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
  93 extern void
  94 _mesa_init_buffer_object_functions(struct dd_function_table *driver);
  95
  96
  97 /*
  98  * API functions
  99  */
 100
 101 extern void GLAPIENTRY
 102 _mesa_BindBufferARB(GLenum target, GLuint buffer);
 103
 104 extern void GLAPIENTRY
 105 _mesa_DeleteBuffersARB(GLsizei n, const GLuint * buffer);
 106
 107 extern void GLAPIENTRY
 108 _mesa_GenBuffersARB(GLsizei n, GLuint * buffer);
 109
 110 extern GLboolean GLAPIENTRY
 111 _mesa_IsBufferARB(GLuint buffer);
 112
 113 extern void GLAPIENTRY
 114 _mesa_BufferDataARB(GLenum target, GLsizeiptrARB size, const GLvoid * data, GLenum usage);
 115
 116 extern void GLAPIENTRY
 117 _mesa_BufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, const GLvoid * data);
 118
 119 extern void GLAPIENTRY
 120 _mesa_GetBufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, void * data);
 121
 122 extern void * GLAPIENTRY
 123 _mesa_MapBufferARB(GLenum target, GLenum access);
 124
 125 extern GLboolean GLAPIENTRY
 126 _mesa_UnmapBufferARB(GLenum target);
 127
 128 extern void GLAPIENTRY
 129 _mesa_GetBufferParameterivARB(GLenum target, GLenum pname, GLint *params);
 130
 131 extern void GLAPIENTRY
 132 _mesa_GetBufferParameteri64v(GLenum target, GLenum pname, GLint64 *params);
 133
 134 extern void GLAPIENTRY
 135 _mesa_GetBufferPointervARB(GLenum target, GLenum pname, GLvoid **params);
 136
 137 extern void GLAPIENTRY
 138 _mesa_CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
 139                         GLintptr readOffset, GLintptr writeOffset,
 140                         GLsizeiptr size);
 141
 142 extern void * GLAPIENTRY
 143 _mesa_MapBufferRange(GLenum target, GLintptr offset, GLsizeiptr length,
 144                      GLbitfield access);
 145
 146 extern void GLAPIENTRY
 147 _mesa_FlushMappedBufferRange(GLenum target, GLintptr offset, GLsizeiptr length);
 148
 149 #if FEATURE_APPLE_object_purgeable
 150 extern GLenum GLAPIENTRY
 151 _mesa_ObjectPurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
 152
 153 extern GLenum GLAPIENTRY
 154 _mesa_ObjectUnpurgeableAPPLE(GLenum objectType, GLuint name, GLenum option);
 155
 156 extern void GLAPIENTRY
 157 _mesa_GetObjectParameterivAPPLE(GLenum objectType, GLuint name, GLenum pname, GLint* params);
 158 #endif
 159
 160 #endif