Home | History | Annotate | Download | only in vbo
      1 /**************************************************************************
      2 
      3 Copyright 2002 VMware, Inc.
      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 VMWARE 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 <keithw (at) vmware.com>
     31  *
     32  */
     33 
     34 #ifndef VBO_SAVE_H
     35 #define VBO_SAVE_H
     36 
     37 #include "main/mtypes.h"
     38 #include "vbo.h"
     39 #include "vbo_attrib.h"
     40 
     41 
     42 struct vbo_save_copied_vtx {
     43    fi_type buffer[VBO_ATTRIB_MAX * 4 * VBO_MAX_COPIED_VERTS];
     44    GLuint nr;
     45 };
     46 
     47 
     48 /* For display lists, this structure holds a run of vertices of the
     49  * same format, and a strictly well-formed set of begin/end pairs,
     50  * starting on the first vertex and ending at the last.  Vertex
     51  * copying on buffer breaks is precomputed according to these
     52  * primitives, though there are situations where the copying will need
     53  * correction at execute-time, perhaps by replaying the list as
     54  * immediate mode commands.
     55  *
     56  * On executing this list, the 'current' values may be updated with
     57  * the values of the final vertex, and often no fixup of the start of
     58  * the vertex list is required.
     59  *
     60  * Eval and other commands that don't fit into these vertex lists are
     61  * compiled using the fallback opcode mechanism provided by dlist.c.
     62  */
     63 struct vbo_save_vertex_list {
     64    GLbitfield64 enabled; /**< mask of enabled vbo arrays. */
     65    GLubyte attrsz[VBO_ATTRIB_MAX];
     66    GLenum attrtype[VBO_ATTRIB_MAX];
     67    GLuint vertex_size;  /**< size in GLfloats */
     68 
     69    /* Copy of the final vertex from node->vertex_store->bufferobj.
     70     * Keep this in regular (non-VBO) memory to avoid repeated
     71     * map/unmap of the VBO when updating GL current data.
     72     */
     73    fi_type *current_data;
     74    GLuint current_size;
     75 
     76    GLuint buffer_offset;
     77    GLuint count;                /**< vertex count */
     78    GLuint wrap_count;		/* number of copied vertices at start */
     79    GLboolean dangling_attr_ref;	/* current attr implicitly referenced
     80 				   outside the list */
     81 
     82    struct _mesa_prim *prim;
     83    GLuint prim_count;
     84 
     85    struct vbo_save_vertex_store *vertex_store;
     86    struct vbo_save_primitive_store *prim_store;
     87 };
     88 
     89 /* These buffers should be a reasonable size to support upload to
     90  * hardware.  Current vbo implementation will re-upload on any
     91  * changes, so don't make too big or apps which dynamically create
     92  * dlists and use only a few times will suffer.
     93  *
     94  * Consider stategy of uploading regions from the VBO on demand in the
     95  * case of dynamic vbos.  Then make the dlist code signal that
     96  * likelyhood as it occurs.  No reason we couldn't change usage
     97  * internally even though this probably isn't allowed for client VBOs?
     98  */
     99 #define VBO_SAVE_BUFFER_SIZE (256*1024) /* dwords */
    100 #define VBO_SAVE_PRIM_SIZE   128
    101 #define VBO_SAVE_PRIM_MODE_MASK         0x3f
    102 #define VBO_SAVE_PRIM_WEAK              0x40
    103 #define VBO_SAVE_PRIM_NO_CURRENT_UPDATE 0x80
    104 
    105 #define VBO_SAVE_FALLBACK    0x10000000
    106 
    107 /* Storage to be shared among several vertex_lists.
    108  */
    109 struct vbo_save_vertex_store {
    110    struct gl_buffer_object *bufferobj;
    111    fi_type *buffer;
    112    GLuint used;
    113    GLuint refcount;
    114 };
    115 
    116 struct vbo_save_primitive_store {
    117    struct _mesa_prim buffer[VBO_SAVE_PRIM_SIZE];
    118    GLuint used;
    119    GLuint refcount;
    120 };
    121 
    122 
    123 struct vbo_save_context {
    124    struct gl_context *ctx;
    125    GLvertexformat vtxfmt;
    126    GLvertexformat vtxfmt_noop;  /**< Used if out_of_memory is true */
    127    struct gl_vertex_array arrays[VBO_ATTRIB_MAX];
    128    const struct gl_vertex_array *inputs[VBO_ATTRIB_MAX];
    129 
    130    GLbitfield64 enabled; /**< mask of enabled vbo arrays. */
    131    GLubyte attrsz[VBO_ATTRIB_MAX];  /**< 1, 2, 3 or 4 */
    132    GLenum attrtype[VBO_ATTRIB_MAX];  /**< GL_FLOAT, GL_INT, etc */
    133    GLubyte active_sz[VBO_ATTRIB_MAX];  /**< 1, 2, 3 or 4 */
    134    GLuint vertex_size;  /**< size in GLfloats */
    135 
    136    GLboolean out_of_memory;  /**< True if last VBO allocation failed */
    137 
    138    fi_type *buffer;
    139    GLuint count;
    140    GLuint wrap_count;
    141    GLuint replay_flags;
    142 
    143    struct _mesa_prim *prim;
    144    GLuint prim_count, prim_max;
    145 
    146    struct vbo_save_vertex_store *vertex_store;
    147    struct vbo_save_primitive_store *prim_store;
    148 
    149    fi_type *buffer_ptr;		   /* cursor, points into buffer */
    150    fi_type vertex[VBO_ATTRIB_MAX*4];	   /* current values */
    151    fi_type *attrptr[VBO_ATTRIB_MAX];
    152    GLuint vert_count;
    153    GLuint max_vert;
    154    GLboolean dangling_attr_ref;
    155 
    156    GLuint opcode_vertex_list;
    157 
    158    struct vbo_save_copied_vtx copied;
    159 
    160    fi_type *current[VBO_ATTRIB_MAX]; /* points into ctx->ListState */
    161    GLubyte *currentsz[VBO_ATTRIB_MAX];
    162 };
    163 
    164 void vbo_save_init( struct gl_context *ctx );
    165 void vbo_save_destroy( struct gl_context *ctx );
    166 void vbo_save_fallback( struct gl_context *ctx, GLboolean fallback );
    167 
    168 /* save_loopback.c:
    169  */
    170 void vbo_loopback_vertex_list( struct gl_context *ctx,
    171 			       const GLfloat *buffer,
    172 			       const GLubyte *attrsz,
    173 			       const struct _mesa_prim *prim,
    174 			       GLuint prim_count,
    175 			       GLuint wrap_count,
    176 			       GLuint vertex_size);
    177 
    178 /* Callbacks:
    179  */
    180 void vbo_save_playback_vertex_list( struct gl_context *ctx, void *data );
    181 
    182 void vbo_save_api_init( struct vbo_save_context *save );
    183 
    184 fi_type *
    185 vbo_save_map_vertex_store(struct gl_context *ctx,
    186                           struct vbo_save_vertex_store *vertex_store);
    187 
    188 void
    189 vbo_save_unmap_vertex_store(struct gl_context *ctx,
    190                             struct vbo_save_vertex_store *vertex_store);
    191 
    192 #endif /* VBO_SAVE_H */
    193