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 void *
  83 _mesa_buffer_map_range( GLcontext *ctx, GLenum target, GLintptr offset,
  84                         GLsizeiptr length, GLbitfield access,
  85                         struct gl_buffer_object *bufObj );
  86
  87 extern void
  88 _mesa_buffer_flush_mapped_range( GLcontext *ctx, GLenum target,
  89                                  GLintptr offset, GLsizeiptr length,
  90                                  struct gl_buffer_object *obj );
  91
  92 extern GLboolean
  93 _mesa_buffer_unmap( GLcontext *ctx, GLenum target,
  94                     struct gl_buffer_object * bufObj );
  95
  96 extern void
  97 _mesa_copy_buffer_subdata(GLcontext *ctx,
  98                           struct gl_buffer_object *src,
  99                           struct gl_buffer_object *dst,
 100                           GLintptr readOffset, GLintptr writeOffset,
 101                           GLsizeiptr size);
 102
 103 extern GLboolean
 104 _mesa_validate_pbo_access(GLuint dimensions,
 105                           const struct gl_pixelstore_attrib *pack,
 106                           GLsizei width, GLsizei height, GLsizei depth,
 107                           GLenum format, GLenum type, const GLvoid *ptr);
 108
 109 extern const GLubyte *
 110 _mesa_map_bitmap_pbo(GLcontext *ctx,
 111                      const struct gl_pixelstore_attrib *unpack,
 112                      const GLubyte *bitmap);
 113
 114 extern void
 115 _mesa_unmap_bitmap_pbo(GLcontext *ctx,
 116                        const struct gl_pixelstore_attrib *unpack);
 117
 118 extern const GLvoid *
 119 _mesa_map_drawpix_pbo(GLcontext *ctx,
 120                       const struct gl_pixelstore_attrib *unpack,
 121                       const GLvoid *pixels);
 122
 123 extern void
 124 _mesa_unmap_drawpix_pbo(GLcontext *ctx,
 125                         const struct gl_pixelstore_attrib *unpack);
 126
 127 extern void *
 128 _mesa_map_readpix_pbo(GLcontext *ctx,
 129                       const struct gl_pixelstore_attrib *pack,
 130                       GLvoid *dest);
 131
 132 extern void
 133 _mesa_unmap_readpix_pbo(GLcontext *ctx,
 134                         const struct gl_pixelstore_attrib *pack);
 135
 136
 137
 138 /*
 139  * API functions
 140  */
 141
 142 extern void GLAPIENTRY
 143 _mesa_BindBufferARB(GLenum target, GLuint buffer);
 144
 145 extern void GLAPIENTRY
 146 _mesa_DeleteBuffersARB(GLsizei n, const GLuint * buffer);
 147
 148 extern void GLAPIENTRY
 149 _mesa_GenBuffersARB(GLsizei n, GLuint * buffer);
 150
 151 extern GLboolean GLAPIENTRY
 152 _mesa_IsBufferARB(GLuint buffer);
 153
 154 extern void GLAPIENTRY
 155 _mesa_BufferDataARB(GLenum target, GLsizeiptrARB size, const GLvoid * data, GLenum usage);
 156
 157 extern void GLAPIENTRY
 158 _mesa_BufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, const GLvoid * data);
 159
 160 extern void GLAPIENTRY
 161 _mesa_GetBufferSubDataARB(GLenum target, GLintptrARB offset, GLsizeiptrARB size, void * data);
 162
 163 extern void * GLAPIENTRY
 164 _mesa_MapBufferARB(GLenum target, GLenum access);
 165
 166 extern GLboolean GLAPIENTRY
 167 _mesa_UnmapBufferARB(GLenum target);
 168
 169 extern void GLAPIENTRY
 170 _mesa_GetBufferParameterivARB(GLenum target, GLenum pname, GLint *params);
 171
 172 extern void GLAPIENTRY
 173 _mesa_GetBufferPointervARB(GLenum target, GLenum pname, GLvoid **params);
 174
 175 extern void GLAPIENTRY
 176 _mesa_CopyBufferSubData(GLenum readTarget, GLenum writeTarget,
 177                         GLintptr readOffset, GLintptr writeOffset,
 178                         GLsizeiptr size);
 179
 180 extern void * GLAPIENTRY
 181 _mesa_MapBufferRange(GLenum target, GLintptr offset, GLsizeiptr length,
 182                      GLbitfield access);
 183
 184 extern void GLAPIENTRY
 185 _mesa_FlushMappedBufferRange(GLenum target, GLintptr offset, GLsizeiptr length);
 186
 187 #endif