2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2004 Brian Paul All Rights Reserved.
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 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27 * \brief Vertex array API functions (glDrawArrays, etc)
28 * \author Keith Whitwell
32 #include "api_validate.h"
39 #include "array_cache/acache.h"
41 #include "t_array_api.h"
42 #include "t_array_import.h"
43 #include "t_save_api.h"
44 #include "t_context.h"
45 #include "t_pipeline.h"
47 static void fallback_drawarrays( GLcontext
*ctx
, GLenum mode
, GLint start
,
52 assert(!ctx
->CompileFlag
);
53 assert(ctx
->Driver
.CurrentExecPrimitive
== GL_POLYGON
+1);
56 for (i
= 0; i
< count
; i
++)
57 GL_CALL(ArrayElement
)( start
+ i
);
62 static void fallback_drawelements( GLcontext
*ctx
, GLenum mode
, GLsizei count
,
63 const GLuint
*indices
)
67 assert(!ctx
->CompileFlag
);
68 assert(ctx
->Driver
.CurrentExecPrimitive
== GL_POLYGON
+1);
70 /* Here, indices will already reflect the buffer object if active */
73 for (i
= 0 ; i
< count
; i
++) {
74 GL_CALL(ArrayElement
)( indices
[i
] );
80 /* Note this function no longer takes a 'start' value, the range is
81 * assumed to start at zero. The old trick of subtracting 'start'
82 * from each index won't work if the indices are not in writeable
85 static void _tnl_draw_range_elements( GLcontext
*ctx
, GLenum mode
,
87 GLsizei index_count
, GLuint
*indices
)
90 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
92 FLUSH_CURRENT( ctx
, 0 );
94 _tnl_vb_bind_arrays( ctx
, 0, max_index
);
96 tnl
->vb
.Primitive
= &prim
;
97 tnl
->vb
.Primitive
[0].mode
= mode
| PRIM_BEGIN
| PRIM_END
;
98 tnl
->vb
.Primitive
[0].start
= 0;
99 tnl
->vb
.Primitive
[0].count
= index_count
;
100 tnl
->vb
.PrimitiveCount
= 1;
102 tnl
->vb
.Elts
= (GLuint
*)indices
;
104 tnl
->Driver
.RunPipeline( ctx
);
110 * Called via the GL API dispatcher.
113 _tnl_DrawArrays(GLenum mode
, GLint start
, GLsizei count
)
115 GET_CURRENT_CONTEXT(ctx
);
116 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
117 GLuint thresh
= (ctx
->Driver
.NeedFlush
& FLUSH_STORED_VERTICES
) ? 30 : 10;
119 if (MESA_VERBOSE
& VERBOSE_API
)
120 _mesa_debug(NULL
, "_tnl_DrawArrays %d %d\n", start
, count
);
122 /* Check arguments, etc.
124 if (!_mesa_validate_DrawArrays( ctx
, mode
, start
, count
))
127 assert(!ctx
->CompileFlag
);
129 if (!ctx
->Array
.LockCount
&& (GLuint
) count
< thresh
) {
130 /* Small primitives: attempt to share a vb (at the expense of
131 * using the immediate interface).
133 fallback_drawarrays( ctx
, mode
, start
, count
);
135 else if (start
>= (GLint
) ctx
->Array
.LockFirst
&&
136 start
+ count
<= (GLint
)(ctx
->Array
.LockFirst
+ ctx
->Array
.LockCount
)) {
138 struct tnl_prim prim
;
140 /* Locked primitives which can fit in a single vertex buffer:
142 FLUSH_CURRENT( ctx
, 0 );
144 /* Locked drawarrays. Reuse any previously transformed data.
146 _tnl_vb_bind_arrays( ctx
, ctx
->Array
.LockFirst
,
147 ctx
->Array
.LockFirst
+ ctx
->Array
.LockCount
);
149 tnl
->vb
.Primitive
= &prim
;
150 tnl
->vb
.Primitive
[0].mode
= mode
| PRIM_BEGIN
| PRIM_END
;
151 tnl
->vb
.Primitive
[0].start
= start
;
152 tnl
->vb
.Primitive
[0].count
= count
;
153 tnl
->vb
.PrimitiveCount
= 1;
155 tnl
->Driver
.RunPipeline( ctx
);
158 int bufsz
= 256; /* Use a small buffer for cache goodness */
160 int minimum
, modulo
, skip
;
162 /* Large primitives requiring decomposition to multiple vertex
186 case GL_TRIANGLE_STRIP
:
202 case GL_TRIANGLE_FAN
:
205 /* Primitives requiring a copied vertex (fan-like primitives)
206 * must use the slow path if they cannot fit in a single
209 if (count
<= (GLint
) ctx
->Const
.MaxArrayLockSize
) {
210 bufsz
= ctx
->Const
.MaxArrayLockSize
;
216 fallback_drawarrays( ctx
, mode
, start
, count
);
221 FLUSH_CURRENT( ctx
, 0 );
223 bufsz
-= bufsz
% modulo
;
227 for (j
= start
+ minimum
; j
< count
; j
+= nr
+ skip
) {
229 struct tnl_prim prim
;
231 nr
= MIN2( bufsz
, count
- j
);
233 /* XXX is the last parameter a count or index into the array??? */
234 _tnl_vb_bind_arrays( ctx
, j
- minimum
, j
+ nr
);
236 tnl
->vb
.Primitive
= &prim
;
237 tnl
->vb
.Primitive
[0].mode
= mode
;
239 if (j
== start
+ minimum
)
240 tnl
->vb
.Primitive
[0].mode
|= PRIM_BEGIN
;
242 if (j
+ nr
+ skip
>= count
)
243 tnl
->vb
.Primitive
[0].mode
|= PRIM_END
;
245 tnl
->vb
.Primitive
[0].start
= 0;
246 tnl
->vb
.Primitive
[0].count
= nr
+ minimum
;
247 tnl
->vb
.PrimitiveCount
= 1;
249 tnl
->Driver
.RunPipeline( ctx
);
256 * Called via the GL API dispatcher.
259 _tnl_DrawRangeElements(GLenum mode
,
260 GLuint start
, GLuint end
,
261 GLsizei count
, GLenum type
, const GLvoid
*indices
)
263 GET_CURRENT_CONTEXT(ctx
);
266 if (MESA_VERBOSE
& VERBOSE_API
)
267 _mesa_debug(NULL
, "_tnl_DrawRangeElements %d %d %d\n", start
, end
, count
);
269 if (ctx
->Array
.ElementArrayBufferObj
->Name
) {
270 /* use indices in the buffer object */
271 if (!ctx
->Array
.ElementArrayBufferObj
->Data
) {
273 "DrawRangeElements with empty vertex elements buffer!");
276 /* actual address is the sum of pointers */
277 indices
= (const GLvoid
*)
278 ADD_POINTERS(ctx
->Array
.ElementArrayBufferObj
->Data
,
279 (const GLubyte
*) indices
);
282 /* Check arguments, etc.
284 if (!_mesa_validate_DrawRangeElements( ctx
, mode
, start
, end
, count
,
288 ui_indices
= (GLuint
*)_ac_import_elements( ctx
, GL_UNSIGNED_INT
,
289 count
, type
, indices
);
292 assert(!ctx
->CompileFlag
);
294 if (ctx
->Array
.LockCount
) {
295 /* Are the arrays already locked? If so we currently have to look
296 * at the whole locked range.
299 if (start
== 0 && ctx
->Array
.LockFirst
== 0 &&
300 end
< (ctx
->Array
.LockFirst
+ ctx
->Array
.LockCount
))
301 _tnl_draw_range_elements( ctx
, mode
,
302 ctx
->Array
.LockCount
,
305 fallback_drawelements( ctx
, mode
, count
, ui_indices
);
308 else if (start
== 0 && end
< ctx
->Const
.MaxArrayLockSize
) {
309 /* The arrays aren't locked but we can still fit them inside a
310 * single vertexbuffer.
312 _tnl_draw_range_elements( ctx
, mode
, end
+ 1, count
, ui_indices
);
315 /* Range is too big to optimize:
317 fallback_drawelements( ctx
, mode
, count
, ui_indices
);
324 * Called via the GL API dispatcher.
327 _tnl_DrawElements(GLenum mode
, GLsizei count
, GLenum type
,
328 const GLvoid
*indices
)
330 GET_CURRENT_CONTEXT(ctx
);
333 if (MESA_VERBOSE
& VERBOSE_API
)
334 _mesa_debug(NULL
, "_tnl_DrawElements %d\n", count
);
336 /* Check arguments, etc. */
337 if (!_mesa_validate_DrawElements( ctx
, mode
, count
, type
, indices
))
340 if (ctx
->Array
.ElementArrayBufferObj
->Name
) {
341 /* actual address is the sum of pointers */
342 indices
= (const GLvoid
*)
343 ADD_POINTERS(ctx
->Array
.ElementArrayBufferObj
->Data
,
344 (const GLubyte
*) indices
);
347 ui_indices
= (GLuint
*)_ac_import_elements( ctx
, GL_UNSIGNED_INT
,
348 count
, type
, indices
);
350 assert(!ctx
->CompileFlag
);
352 if (ctx
->Array
.LockCount
) {
353 if (ctx
->Array
.LockFirst
== 0)
354 _tnl_draw_range_elements( ctx
, mode
,
355 ctx
->Array
.LockCount
,
358 fallback_drawelements( ctx
, mode
, count
, ui_indices
);
361 /* Scan the index list and see if we can use the locked path anyway.
366 for (i
= 0 ; i
< count
; i
++)
367 if (ui_indices
[i
] > max_elt
)
368 max_elt
= ui_indices
[i
];
370 if (max_elt
< ctx
->Const
.MaxArrayLockSize
&& /* can we use it? */
371 max_elt
< (GLuint
) count
) /* do we want to use it? */
372 _tnl_draw_range_elements( ctx
, mode
, max_elt
+1, count
, ui_indices
);
374 fallback_drawelements( ctx
, mode
, count
, ui_indices
);
380 * Initialize context's vertex array fields. Called during T 'n L context
383 void _tnl_array_init( GLcontext
*ctx
)
385 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
386 struct tnl_vertex_arrays
*tmp
= &tnl
->array_inputs
;
387 GLvertexformat
*vfmt
= &(TNL_CONTEXT(ctx
)->exec_vtxfmt
);
390 vfmt
->DrawArrays
= _tnl_DrawArrays
;
391 vfmt
->DrawElements
= _tnl_DrawElements
;
392 vfmt
->DrawRangeElements
= _tnl_DrawRangeElements
;
394 /* Setup vector pointers that will be used to bind arrays to VB's.
396 _mesa_vector4f_init( &tmp
->Obj
, 0, NULL
);
397 _mesa_vector4f_init( &tmp
->Normal
, 0, NULL
);
398 _mesa_vector4f_init( &tmp
->FogCoord
, 0, NULL
);
399 _mesa_vector4f_init( &tmp
->Index
, 0, NULL
);
401 for (i
= 0; i
< ctx
->Const
.MaxTextureUnits
; i
++)
402 _mesa_vector4f_init( &tmp
->TexCoord
[i
], 0, NULL
);
407 * Destroy the context's vertex array stuff.
408 * Called during T 'n L context destruction.
410 void _tnl_array_destroy( GLcontext
*ctx
)