2 * mesa 3-D graphics library
4 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 * OTHER DEALINGS IN THE SOFTWARE.
26 * \brief Public interface to the VBO module
27 * \author Keith Whitwell
35 #include "main/glheader.h"
41 struct gl_vertex_array
;
43 struct gl_transform_feedback_object
;
47 GLuint mode
:8; /**< GL_POINTS, GL_LINES, GL_QUAD_STRIP, etc */
52 GLuint no_current_update
:1;
63 GLsizeiptr indirect_offset
;
66 /* Would like to call this a "vbo_index_buffer", but this would be
67 * confusing as the indices are not neccessarily yet in a non-null
70 struct _mesa_index_buffer
74 struct gl_buffer_object
*obj
;
81 _vbo_CreateContext(struct gl_context
*ctx
);
84 _vbo_DestroyContext(struct gl_context
*ctx
);
87 vbo_exec_invalidate_state(struct gl_context
*ctx
);
90 _vbo_install_exec_vtxfmt(struct gl_context
*ctx
);
93 vbo_initialize_exec_dispatch(const struct gl_context
*ctx
,
94 struct _glapi_table
*exec
);
97 vbo_initialize_save_dispatch(const struct gl_context
*ctx
,
98 struct _glapi_table
*exec
);
101 vbo_exec_FlushVertices(struct gl_context
*ctx
, GLuint flags
);
104 vbo_save_SaveFlushVertices(struct gl_context
*ctx
);
107 vbo_save_NotifyBegin(struct gl_context
*ctx
, GLenum mode
);
110 vbo_save_NewList(struct gl_context
*ctx
, GLuint list
, GLenum mode
);
113 vbo_save_EndList(struct gl_context
*ctx
);
116 vbo_save_BeginCallList(struct gl_context
*ctx
, struct gl_display_list
*list
);
119 vbo_save_EndCallList(struct gl_context
*ctx
);
123 * For indirect array drawing:
129 * GLuint baseInstance; // in GL 4.2 and later, must be zero otherwise
130 * } DrawArraysIndirectCommand;
132 * For indirect indexed drawing:
139 * GLuint baseInstance; // in GL 4.2 and later, must be zero otherwise
140 * } DrawElementsIndirectCommand;
145 * Draw a number of primitives.
146 * \param prims array [nr_prims] describing what to draw (prim type,
147 * vertex count, first index, instance count, etc).
148 * \param arrays array of vertex arrays for draw
149 * \param ib index buffer for indexed drawing, NULL for array drawing
150 * \param index_bounds_valid are min_index and max_index valid?
151 * \param min_index lowest vertex index used
152 * \param max_index highest vertex index used
153 * \param tfb_vertcount if non-null, indicates which transform feedback
154 * object has the vertex count.
155 * \param tfb_stream If called via DrawTransformFeedbackStream, specifies the
156 * vertex stream buffer from which to get the vertex count.
157 * \param indirect If any prims are indirect, this specifies the buffer
158 * to find the "DrawArrays/ElementsIndirectCommand" data.
159 * This may be deprecated in the future
161 typedef void (*vbo_draw_func
)(struct gl_context
*ctx
,
162 const struct gl_vertex_array
* arrays
,
163 const struct _mesa_prim
*prims
,
165 const struct _mesa_index_buffer
*ib
,
166 GLboolean index_bounds_valid
,
169 struct gl_transform_feedback_object
*tfb_vertcount
,
171 struct gl_buffer_object
*indirect
);
176 /* Utility function to cope with various constraints on tnl modules or
177 * hardware. This can be used to split an incoming set of arrays and
178 * primitives against the following constraints:
179 * - Maximum number of indices in index buffer.
180 * - Maximum number of vertices referenced by index buffer.
181 * - Maximum hardware vertex buffer size.
187 GLuint max_vb_size
; /* bytes */
192 _vbo_draw_indirect(struct gl_context
*ctx
, GLuint mode
,
193 struct gl_buffer_object
*indirect_data
,
194 GLsizeiptr indirect_offset
, unsigned draw_count
,
196 struct gl_buffer_object
*indirect_draw_count_buffer
,
197 GLsizeiptr indirect_draw_count_offset
,
198 const struct _mesa_index_buffer
*ib
);
202 vbo_split_prims(struct gl_context
*ctx
,
203 const struct gl_vertex_array
*arrays
,
204 const struct _mesa_prim
*prim
,
206 const struct _mesa_index_buffer
*ib
,
210 const struct split_limits
*limits
);
214 vbo_delete_minmax_cache(struct gl_buffer_object
*bufferObj
);
217 vbo_get_minmax_indices(struct gl_context
*ctx
, const struct _mesa_prim
*prim
,
218 const struct _mesa_index_buffer
*ib
,
219 GLuint
*min_index
, GLuint
*max_index
, GLuint nr_prims
);
222 vbo_use_buffer_objects(struct gl_context
*ctx
);
225 vbo_always_unmap_buffers(struct gl_context
*ctx
);
228 vbo_sw_primitive_restart(struct gl_context
*ctx
,
229 const struct _mesa_prim
*prim
,
231 const struct _mesa_index_buffer
*ib
,
232 struct gl_buffer_object
*indirect
);
236 * Utility that tracks and updates the current array entries.
241 * Array of inputs to be set to the _DrawArrays pointer.
242 * The array contains pointers into the _DrawVAO and to the vbo modules
243 * current values. The array of pointers is updated incrementally
244 * based on the current and vertex_processing_mode values below.
246 struct gl_vertex_array inputs
[VERT_ATTRIB_MAX
];
247 /** Those VERT_BIT_'s where the inputs array point to current values. */
249 /** Store which aliasing current values - generics or materials - are set. */
250 gl_vertex_processing_mode vertex_processing_mode
;
258 _vbo_init_inputs(struct vbo_inputs
*inputs
);
262 * Update the gl_vertex_array array inside the vbo_inputs structure
263 * provided the current _VPMode, the provided vao and
264 * the vao's enabled arrays filtered by the filter bitmask.
267 _vbo_update_inputs(struct gl_context
*ctx
, struct vbo_inputs
*inputs
);
271 _es_Color4f(GLfloat r
, GLfloat g
, GLfloat b
, GLfloat a
);
274 _es_Normal3f(GLfloat x
, GLfloat y
, GLfloat z
);
277 _es_MultiTexCoord4f(GLenum target
, GLfloat s
, GLfloat t
, GLfloat r
, GLfloat q
);
280 _es_Materialfv(GLenum face
, GLenum pname
, const GLfloat
*params
);
283 _es_Materialf(GLenum face
, GLenum pname
, GLfloat param
);
286 _es_VertexAttrib4f(GLuint index
, GLfloat x
, GLfloat y
, GLfloat z
, GLfloat w
);
289 _es_VertexAttrib1f(GLuint indx
, GLfloat x
);
292 _es_VertexAttrib1fv(GLuint indx
, const GLfloat
* values
);
295 _es_VertexAttrib2f(GLuint indx
, GLfloat x
, GLfloat y
);
298 _es_VertexAttrib2fv(GLuint indx
, const GLfloat
* values
);
301 _es_VertexAttrib3f(GLuint indx
, GLfloat x
, GLfloat y
, GLfloat z
);
304 _es_VertexAttrib3fv(GLuint indx
, const GLfloat
* values
);
307 _es_VertexAttrib4fv(GLuint indx
, const GLfloat
* values
);