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 ib index buffer for indexed drawing, NULL for array drawing
149 * \param index_bounds_valid are min_index and max_index valid?
150 * \param min_index lowest vertex index used
151 * \param max_index highest vertex index used
152 * \param tfb_vertcount describes TFB output, or NULL
153 * \param stream If called via DrawTransformFeedback, specifies the vertex
154 * stream buffer from which to get the vertex count
155 * \param indirect If any prims are indirect, this specifies the buffer
156 * to find the "DrawArrays/ElementsIndirectCommand" data.
157 * This may be deprecated in the future
159 typedef void (*vbo_draw_func
)(struct gl_context
*ctx
,
160 const struct _mesa_prim
*prims
,
162 const struct _mesa_index_buffer
*ib
,
163 GLboolean index_bounds_valid
,
166 struct gl_transform_feedback_object
*tfb_vertcount
,
168 struct gl_buffer_object
*indirect
);
172 * Draw a primitive, getting the vertex count, instance count, start
173 * vertex, etc. from a buffer object.
174 * \param mode GL_POINTS, GL_LINES, GL_TRIANGLE_STRIP, etc.
175 * \param indirect_data buffer to get "DrawArrays/ElementsIndirectCommand" data
176 * \param indirect_offset offset of first primitive in indrect_data buffer
177 * \param draw_count number of primitives to draw
178 * \param stride stride, in bytes, between "DrawArrays/ElementsIndirectCommand"
180 * \param indirect_draw_count_buffer if non-NULL specifies a buffer to get the
181 * real draw_count value. Used for
182 * GL_ARB_indirect_parameters.
183 * \param indirect_draw_count_offset offset to the draw_count value in
184 * indirect_draw_count_buffer
185 * \param ib index buffer for indexed drawing, NULL otherwise.
187 typedef void (*vbo_indirect_draw_func
)(
188 struct gl_context
*ctx
,
190 struct gl_buffer_object
*indirect_data
,
191 GLsizeiptr indirect_offset
,
194 struct gl_buffer_object
*indirect_draw_count_buffer
,
195 GLsizeiptr indirect_draw_count_offset
,
196 const struct _mesa_index_buffer
*ib
);
201 /* Utility function to cope with various constraints on tnl modules or
202 * hardware. This can be used to split an incoming set of arrays and
203 * primitives against the following constraints:
204 * - Maximum number of indices in index buffer.
205 * - Maximum number of vertices referenced by index buffer.
206 * - Maximum hardware vertex buffer size.
212 GLuint max_vb_size
; /* bytes */
217 vbo_split_prims(struct gl_context
*ctx
,
218 const struct gl_vertex_array
*arrays
[],
219 const struct _mesa_prim
*prim
,
221 const struct _mesa_index_buffer
*ib
,
225 const struct split_limits
*limits
);
229 vbo_rebase_prims(struct gl_context
*ctx
,
230 const struct gl_vertex_array
*arrays
[],
231 const struct _mesa_prim
*prim
,
233 const struct _mesa_index_buffer
*ib
,
240 vbo_delete_minmax_cache(struct gl_buffer_object
*bufferObj
);
243 vbo_get_minmax_indices(struct gl_context
*ctx
, const struct _mesa_prim
*prim
,
244 const struct _mesa_index_buffer
*ib
,
245 GLuint
*min_index
, GLuint
*max_index
, GLuint nr_prims
);
248 vbo_use_buffer_objects(struct gl_context
*ctx
);
251 vbo_always_unmap_buffers(struct gl_context
*ctx
);
254 vbo_set_draw_func(struct gl_context
*ctx
, vbo_draw_func func
);
257 vbo_set_indirect_draw_func(struct gl_context
*ctx
,
258 vbo_indirect_draw_func func
);
261 vbo_sw_primitive_restart(struct gl_context
*ctx
,
262 const struct _mesa_prim
*prim
,
264 const struct _mesa_index_buffer
*ib
,
265 struct gl_buffer_object
*indirect
);
268 _es_Color4f(GLfloat r
, GLfloat g
, GLfloat b
, GLfloat a
);
271 _es_Normal3f(GLfloat x
, GLfloat y
, GLfloat z
);
274 _es_MultiTexCoord4f(GLenum target
, GLfloat s
, GLfloat t
, GLfloat r
, GLfloat q
);
277 _es_Materialfv(GLenum face
, GLenum pname
, const GLfloat
*params
);
280 _es_Materialf(GLenum face
, GLenum pname
, GLfloat param
);
283 _es_VertexAttrib4f(GLuint index
, GLfloat x
, GLfloat y
, GLfloat z
, GLfloat w
);
286 _es_VertexAttrib1f(GLuint indx
, GLfloat x
);
289 _es_VertexAttrib1fv(GLuint indx
, const GLfloat
* values
);
292 _es_VertexAttrib2f(GLuint indx
, GLfloat x
, GLfloat y
);
295 _es_VertexAttrib2fv(GLuint indx
, const GLfloat
* values
);
298 _es_VertexAttrib3f(GLuint indx
, GLfloat x
, GLfloat y
, GLfloat z
);
301 _es_VertexAttrib3fv(GLuint indx
, const GLfloat
* values
);
304 _es_VertexAttrib4fv(GLuint indx
, const GLfloat
* values
);