reactos/dll/opengl/mesa/vbo/vbo_save.h

   1 /**************************************************************************
   2
   3 Copyright 2002 Tungsten Graphics Inc., Cedar Park, Texas.
   4
   5 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 on the rights to use, copy, modify, merge, publish, distribute, sub
  11 license, and/or sell copies of the Software, and to permit persons to whom
  12 the Software is furnished to do so, subject to the following conditions:
  13
  14 The above copyright notice and this permission notice (including the next
  15 paragraph) shall be included in all copies or substantial portions of the
  16 Software.
  17
  18 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20 FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  21 TUNGSTEN GRAPHICS AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
  22 DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  23 OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  24 USE OR OTHER DEALINGS IN THE SOFTWARE.
  25
  26 **************************************************************************/
  27
  28 /*
  29  * Authors:
  30  *   Keith Whitwell <keith@tungstengraphics.com>
  31  *
  32  */
  33
  34 #ifndef VBO_SAVE_H
  35 #define VBO_SAVE_H
  36
  37 #include "main/mfeatures.h"
  38 #include "main/mtypes.h"
  39 #include "vbo.h"
  40 #include "vbo_attrib.h"
  41
  42
  43 struct vbo_save_copied_vtx {
  44    GLfloat buffer[VBO_ATTRIB_MAX * 4 * VBO_MAX_COPIED_VERTS];
  45    GLuint nr;
  46 };
  47
  48
  49 /* For display lists, this structure holds a run of vertices of the
  50  * same format, and a strictly well-formed set of begin/end pairs,
  51  * starting on the first vertex and ending at the last.  Vertex
  52  * copying on buffer breaks is precomputed according to these
  53  * primitives, though there are situations where the copying will need
  54  * correction at execute-time, perhaps by replaying the list as
  55  * immediate mode commands.
  56  *
  57  * On executing this list, the 'current' values may be updated with
  58  * the values of the final vertex, and often no fixup of the start of
  59  * the vertex list is required.
  60  *
  61  * Eval and other commands that don't fit into these vertex lists are
  62  * compiled using the fallback opcode mechanism provided by dlist.c.
  63  */
  64 struct vbo_save_vertex_list {
  65    GLubyte attrsz[VBO_ATTRIB_MAX];
  66    GLuint vertex_size;
  67
  68    /* Copy of the final vertex from node->vertex_store->bufferobj.
  69     * Keep this in regular (non-VBO) memory to avoid repeated
  70     * map/unmap of the VBO when updating GL current data.
  71     */
  72    GLfloat *current_data;
  73    GLuint current_size;
  74
  75    GLuint buffer_offset;
  76    GLuint count;                /**< vertex count */
  77    GLuint wrap_count;           /* number of copied vertices at start */
  78    GLboolean dangling_attr_ref; /* current attr implicitly referenced
  79                                    outside the list */
  80
  81    struct _mesa_prim *prim;
  82    GLuint prim_count;
  83
  84    struct vbo_save_vertex_store *vertex_store;
  85    struct vbo_save_primitive_store *prim_store;
  86 };
  87
  88 /* These buffers should be a reasonable size to support upload to
  89  * hardware.  Current vbo implementation will re-upload on any
  90  * changes, so don't make too big or apps which dynamically create
  91  * dlists and use only a few times will suffer.
  92  *
  93  * Consider stategy of uploading regions from the VBO on demand in the
  94  * case of dynamic vbos.  Then make the dlist code signal that
  95  * likelyhood as it occurs.  No reason we couldn't change usage
  96  * internally even though this probably isn't allowed for client VBOs?
  97  */
  98 #define VBO_SAVE_BUFFER_SIZE (8*1024) /* dwords */
  99 #define VBO_SAVE_PRIM_SIZE   128
 100 #define VBO_SAVE_PRIM_MODE_MASK         0x3f
 101 #define VBO_SAVE_PRIM_WEAK              0x40
 102 #define VBO_SAVE_PRIM_NO_CURRENT_UPDATE 0x80
 103
 104 #define VBO_SAVE_FALLBACK    0x10000000
 105
 106 /* Storage to be shared among several vertex_lists.
 107  */
 108 struct vbo_save_vertex_store {
 109    struct gl_buffer_object *bufferobj;
 110    GLfloat *buffer;
 111    GLuint used;
 112    GLuint refcount;
 113 };
 114
 115 struct vbo_save_primitive_store {
 116    struct _mesa_prim buffer[VBO_SAVE_PRIM_SIZE];
 117    GLuint used;
 118    GLuint refcount;
 119 };
 120
 121
 122 struct vbo_save_context {
 123    struct gl_context *ctx;
 124    GLvertexformat vtxfmt;
 125    GLvertexformat vtxfmt_noop;  /**< Used if out_of_memory is true */
 126    struct gl_client_array arrays[VBO_ATTRIB_MAX];
 127    const struct gl_client_array *inputs[VBO_ATTRIB_MAX];
 128
 129    GLubyte attrsz[VBO_ATTRIB_MAX];
 130    GLubyte active_sz[VBO_ATTRIB_MAX];
 131    GLuint vertex_size;
 132
 133    GLboolean out_of_memory;  /**< True if last VBO allocation failed */
 134
 135    GLfloat *buffer;
 136    GLuint count;
 137    GLuint wrap_count;
 138    GLuint replay_flags;
 139
 140    struct _mesa_prim *prim;
 141    GLuint prim_count, prim_max;
 142
 143    struct vbo_save_vertex_store *vertex_store;
 144    struct vbo_save_primitive_store *prim_store;
 145
 146    GLfloat *buffer_ptr;            /* cursor, points into buffer */
 147    GLfloat vertex[VBO_ATTRIB_MAX*4];       /* current values */
 148    GLfloat *attrptr[VBO_ATTRIB_MAX];
 149    GLuint vert_count;
 150    GLuint max_vert;
 151    GLboolean dangling_attr_ref;
 152
 153    GLuint opcode_vertex_list;
 154
 155    struct vbo_save_copied_vtx copied;
 156
 157    GLfloat *current[VBO_ATTRIB_MAX]; /* points into ctx->ListState */
 158    GLubyte *currentsz[VBO_ATTRIB_MAX];
 159 };
 160
 161 #if FEATURE_dlist
 162
 163 void vbo_save_init( struct gl_context *ctx );
 164 void vbo_save_destroy( struct gl_context *ctx );
 165 void vbo_save_fallback( struct gl_context *ctx, GLboolean fallback );
 166
 167 /* save_loopback.c:
 168  */
 169 void vbo_loopback_vertex_list( struct gl_context *ctx,
 170                                const GLfloat *buffer,
 171                                const GLubyte *attrsz,
 172                                const struct _mesa_prim *prim,
 173                                GLuint prim_count,
 174                                GLuint wrap_count,
 175                                GLuint vertex_size);
 176
 177 /* Callbacks:
 178  */
 179 void vbo_save_EndList( struct gl_context *ctx );
 180 void vbo_save_NewList( struct gl_context *ctx, GLuint list, GLenum mode );
 181 void vbo_save_EndCallList( struct gl_context *ctx );
 182 void vbo_save_BeginCallList( struct gl_context *ctx, struct gl_display_list *list );
 183 void vbo_save_SaveFlushVertices( struct gl_context *ctx );
 184 GLboolean vbo_save_NotifyBegin( struct gl_context *ctx, GLenum mode );
 185
 186 void vbo_save_playback_vertex_list( struct gl_context *ctx, void *data );
 187
 188 void vbo_save_api_init( struct vbo_save_context *save );
 189
 190 #else /* FEATURE_dlist */
 191
 192 static inline void
 193 vbo_save_init( struct gl_context *ctx )
 194 {
 195 }
 196
 197 static inline void
 198 vbo_save_destroy( struct gl_context *ctx )
 199 {
 200 }
 201
 202 #endif /* FEATURE_dlist */
 203
 204 #endif /* VBO_SAVE_H */