3 * Mesa 3-D graphics library
6 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 * Keith Whitwell <keith@tungstengraphics.com>
29 /* Helper for drivers which find themselves rendering a range of
30 * indices starting somewhere above zero. Typically the application
31 * is issuing multiple DrawArrays() or DrawElements() to draw
32 * successive primitives layed out linearly in the vertex arrays.
33 * Unless the vertex arrays are all in a VBO, the OpenGL semantics
34 * imply that we need to re-upload the vertex data on each draw call.
35 * In that case, we want to avoid starting the upload at zero, as it
36 * will mean every draw call uploads an increasing amount of not-used
37 * vertex data. Worse - in the software tnl module, all those
38 * vertices will be transformed and lit.
40 * If we just upload the new data, however, the indices will be
41 * incorrect as we tend to upload each set of vertex data to a new
44 * This file provides a helper to adjust the arrays, primitives and
45 * indices of a draw call so that it can be re-issued with a min_index
49 #include "main/glheader.h"
50 #include "main/imports.h"
51 #include "main/mtypes.h"
54 #include "vbo_attrib.h"
57 #define REBASE(TYPE) \
58 static void *rebase_##TYPE( const void *ptr, \
62 const TYPE *in = (TYPE *)ptr; \
63 TYPE *tmp_indices = malloc(count * sizeof(TYPE)); \
66 for (i = 0; i < count; i++) \
67 tmp_indices[i] = in[i] - min_index; \
69 return (void *)tmp_indices; \
77 /* Adjust primitives, indices and vertex definitions so that min_index
78 * becomes zero. There are lots of reasons for wanting to do this, eg:
81 * - any time min_index != 0, otherwise unused vertices lower than
82 * min_index will be transformed.
85 * - if ib != NULL and min_index != 0, otherwise vertices lower than
86 * min_index will be uploaded. Requires adjusting index values.
88 * - if ib == NULL and min_index != 0, just for convenience so this doesn't
89 * have to be handled within the driver.
91 * Hardware tnl with VBO support:
92 * - as above, but only when vertices are not (all?) in VBO's.
93 * - can't save time by trying to upload half a vbo - typically it is
96 void vbo_rebase_prims( struct gl_context
*ctx
,
97 const struct gl_client_array
*arrays
[],
98 const struct _mesa_prim
*prim
,
100 const struct _mesa_index_buffer
*ib
,
105 struct gl_client_array tmp_arrays
[VBO_ATTRIB_MAX
];
106 const struct gl_client_array
*tmp_array_pointers
[VBO_ATTRIB_MAX
];
108 struct _mesa_index_buffer tmp_ib
;
109 struct _mesa_prim
*tmp_prims
= NULL
;
110 void *tmp_indices
= NULL
;
113 assert(min_index
!= 0);
116 printf("%s %d..%d\n", __FUNCTION__
, min_index
, max_index
);
120 /* Unfortunately need to adjust each index individually.
122 GLboolean map_ib
= ib
->obj
->Name
&& !ib
->obj
->Pointer
;
126 ctx
->Driver
.MapBufferRange(ctx
, 0, ib
->obj
->Size
, GL_MAP_READ_BIT
,
130 ptr
= ADD_POINTERS(ib
->obj
->Pointer
, ib
->ptr
);
132 /* Some users might prefer it if we translated elements to
133 * GLuints here. Others wouldn't...
136 case GL_UNSIGNED_INT
:
137 tmp_indices
= rebase_GLuint( ptr
, ib
->count
, min_index
);
139 case GL_UNSIGNED_SHORT
:
140 tmp_indices
= rebase_GLushort( ptr
, ib
->count
, min_index
);
142 case GL_UNSIGNED_BYTE
:
143 tmp_indices
= rebase_GLubyte( ptr
, ib
->count
, min_index
);
148 ctx
->Driver
.UnmapBuffer(ctx
, ib
->obj
);
150 tmp_ib
.obj
= ctx
->Shared
->NullBufferObj
;
151 tmp_ib
.ptr
= tmp_indices
;
152 tmp_ib
.count
= ib
->count
;
153 tmp_ib
.type
= ib
->type
;
158 /* Otherwise the primitives need adjustment.
160 tmp_prims
= (struct _mesa_prim
*)malloc(sizeof(*prim
) * nr_prims
);
162 for (i
= 0; i
< nr_prims
; i
++) {
163 /* If this fails, it could indicate an application error:
165 assert(prim
[i
].start
>= min_index
);
167 tmp_prims
[i
] = prim
[i
];
168 tmp_prims
[i
].start
-= min_index
;
174 /* Just need to adjust the pointer values on each incoming array.
175 * This works for VBO and non-vbo rendering and shouldn't pesimize
176 * VBO-based upload schemes. However this may still not be a fast
177 * path for hardware tnl for VBO based rendering as most machines
178 * will be happier if you just specify a starting vertex value in
181 * For drivers with hardware tnl, you only want to do this if you
182 * are forced to, eg non-VBO indexed rendering with start != 0.
184 for (i
= 0; i
< VBO_ATTRIB_MAX
; i
++) {
185 tmp_arrays
[i
] = *arrays
[i
];
186 tmp_arrays
[i
].Ptr
+= min_index
* tmp_arrays
[i
].StrideB
;
187 tmp_array_pointers
[i
] = &tmp_arrays
[i
];
190 /* Re-issue the draw call.
199 max_index
- min_index
);