1 /**************************************************************************
3 * Copyright 2007 VMware, Inc.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
30 * Vertex buffer drawing stage.
32 * \author Jose Fonseca <jfonseca@vmware.com>
33 * \author Keith Whitwell <keithw@vmware.com>
37 #include "util/u_debug.h"
38 #include "util/u_math.h"
39 #include "util/u_memory.h"
41 #include "draw_vbuf.h"
42 #include "draw_private.h"
43 #include "draw_vertex.h"
44 #include "draw_pipe.h"
45 #include "translate/translate.h"
46 #include "translate/translate_cache.h"
50 * Vertex buffer emit stage.
53 struct draw_stage stage
; /**< This must be first (base class) */
55 struct vbuf_render
*render
;
57 const struct vertex_info
*vinfo
;
59 /** Vertex size in bytes */
62 struct translate
*translate
;
64 /* FIXME: we have no guarantee that 'unsigned' is 32bit */
66 /** Vertices in hardware format */
69 unsigned max_vertices
;
77 /* Cache point size somewhere its address won't change:
82 struct translate_cache
*cache
;
87 * Basically a cast wrapper.
89 static inline struct vbuf_stage
*
90 vbuf_stage( struct draw_stage
*stage
)
93 return (struct vbuf_stage
*)stage
;
97 static void vbuf_flush_vertices( struct vbuf_stage
*vbuf
);
98 static void vbuf_alloc_vertices( struct vbuf_stage
*vbuf
);
101 static inline boolean
102 overflow( void *map
, void *ptr
, unsigned bytes
, unsigned bufsz
)
104 unsigned long used
= (unsigned long) ((char *)ptr
- (char *)map
);
105 return (used
+ bytes
) > bufsz
;
110 check_space( struct vbuf_stage
*vbuf
, unsigned nr
)
112 if (vbuf
->nr_vertices
+ nr
> vbuf
->max_vertices
||
113 vbuf
->nr_indices
+ nr
> vbuf
->max_indices
)
115 vbuf_flush_vertices( vbuf
);
116 vbuf_alloc_vertices( vbuf
);
124 * Extract the needed fields from post-transformed vertex and emit
125 * a hardware(driver) vertex.
126 * Recall that the vertices are constructed by the 'draw' module and
127 * have a couple of slots at the beginning (1-dword header, 4-dword
128 * clip pos) that we ignore here. We only use the vertex->data[] fields.
131 emit_vertex( struct vbuf_stage
*vbuf
,
132 struct vertex_header
*vertex
)
134 if (vertex
->vertex_id
== UNDEFINED_VERTEX_ID
&& vbuf
->vertex_ptr
) {
135 /* Hmm - vertices are emitted one at a time - better make sure
136 * set_buffer is efficient. Consider a special one-shot mode for
139 /* Note: we really do want data[0] here, not data[pos]:
141 vbuf
->translate
->set_buffer(vbuf
->translate
, 0, vertex
->data
[0], 0, ~0);
142 vbuf
->translate
->run(vbuf
->translate
, 0, 1, 0, 0, vbuf
->vertex_ptr
);
144 if (0) draw_dump_emitted_vertex(vbuf
->vinfo
, (uint8_t *)vbuf
->vertex_ptr
);
146 vbuf
->vertex_ptr
+= vbuf
->vertex_size
/4;
147 vertex
->vertex_id
= vbuf
->nr_vertices
++;
150 return (ushort
)vertex
->vertex_id
;
155 vbuf_tri( struct draw_stage
*stage
,
156 struct prim_header
*prim
)
158 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
161 check_space( vbuf
, 3 );
163 for (i
= 0; i
< 3; i
++) {
164 vbuf
->indices
[vbuf
->nr_indices
++] = emit_vertex( vbuf
, prim
->v
[i
] );
170 vbuf_line( struct draw_stage
*stage
,
171 struct prim_header
*prim
)
173 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
176 check_space( vbuf
, 2 );
178 for (i
= 0; i
< 2; i
++) {
179 vbuf
->indices
[vbuf
->nr_indices
++] = emit_vertex( vbuf
, prim
->v
[i
] );
185 vbuf_point( struct draw_stage
*stage
,
186 struct prim_header
*prim
)
188 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
190 check_space( vbuf
, 1 );
192 vbuf
->indices
[vbuf
->nr_indices
++] = emit_vertex( vbuf
, prim
->v
[0] );
199 * Set the prim type for subsequent vertices.
200 * This may result in a new vertex size. The existing vbuffer (if any)
201 * will be flushed if needed and a new one allocated.
204 vbuf_start_prim( struct vbuf_stage
*vbuf
, uint prim
)
206 struct translate_key hw_key
;
209 const struct vertex_info
*vinfo
;
211 vbuf
->render
->set_primitive(vbuf
->render
, prim
);
213 /* Must do this after set_primitive() above:
215 * XXX: need some state managment to track when this needs to be
216 * recalculated. The driver should tell us whether there was a
219 vbuf
->vinfo
= vbuf
->render
->get_vertex_info(vbuf
->render
);
221 vbuf
->vertex_size
= vinfo
->size
* sizeof(float);
223 /* Translate from pipeline vertices to hw vertices.
227 for (i
= 0; i
< vinfo
->num_attribs
; i
++) {
228 unsigned emit_sz
= 0;
229 unsigned src_buffer
= 0;
230 enum pipe_format output_format
;
231 unsigned src_offset
= (vinfo
->attrib
[i
].src_index
* 4 * sizeof(float) );
233 output_format
= draw_translate_vinfo_format(vinfo
->attrib
[i
].emit
);
234 emit_sz
= draw_translate_vinfo_size(vinfo
->attrib
[i
].emit
);
236 /* doesn't handle EMIT_OMIT */
237 assert(emit_sz
!= 0);
239 if (vinfo
->attrib
[i
].emit
== EMIT_1F_PSIZE
) {
243 else if (vinfo
->attrib
[i
].src_index
== DRAW_ATTR_NONEXIST
) {
244 /* elements which don't exist will get assigned zeros */
249 hw_key
.element
[i
].type
= TRANSLATE_ELEMENT_NORMAL
;
250 hw_key
.element
[i
].input_format
= PIPE_FORMAT_R32G32B32A32_FLOAT
;
251 hw_key
.element
[i
].input_buffer
= src_buffer
;
252 hw_key
.element
[i
].input_offset
= src_offset
;
253 hw_key
.element
[i
].instance_divisor
= 0;
254 hw_key
.element
[i
].output_format
= output_format
;
255 hw_key
.element
[i
].output_offset
= dst_offset
;
257 dst_offset
+= emit_sz
;
260 hw_key
.nr_elements
= vinfo
->num_attribs
;
261 hw_key
.output_stride
= vbuf
->vertex_size
;
263 /* Don't bother with caching at this stage:
265 if (!vbuf
->translate
||
266 translate_key_compare(&vbuf
->translate
->key
, &hw_key
) != 0)
268 translate_key_sanitize(&hw_key
);
269 vbuf
->translate
= translate_cache_find(vbuf
->cache
, &hw_key
);
271 vbuf
->translate
->set_buffer(vbuf
->translate
, 1, &vbuf
->point_size
, 0, ~0);
272 vbuf
->translate
->set_buffer(vbuf
->translate
, 2, &vbuf
->zero4
[0], 0, ~0);
275 vbuf
->point_size
= vbuf
->stage
.draw
->rasterizer
->point_size
;
277 /* Allocate new buffer?
279 assert(vbuf
->vertices
== NULL
);
280 vbuf_alloc_vertices(vbuf
);
285 vbuf_first_tri( struct draw_stage
*stage
,
286 struct prim_header
*prim
)
288 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
290 vbuf_flush_vertices( vbuf
);
291 vbuf_start_prim(vbuf
, PIPE_PRIM_TRIANGLES
);
292 stage
->tri
= vbuf_tri
;
293 stage
->tri( stage
, prim
);
298 vbuf_first_line( struct draw_stage
*stage
,
299 struct prim_header
*prim
)
301 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
303 vbuf_flush_vertices( vbuf
);
304 vbuf_start_prim(vbuf
, PIPE_PRIM_LINES
);
305 stage
->line
= vbuf_line
;
306 stage
->line( stage
, prim
);
311 vbuf_first_point( struct draw_stage
*stage
,
312 struct prim_header
*prim
)
314 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
316 vbuf_flush_vertices(vbuf
);
317 vbuf_start_prim(vbuf
, PIPE_PRIM_POINTS
);
318 stage
->point
= vbuf_point
;
319 stage
->point( stage
, prim
);
325 * Flush existing vertex buffer and allocate a new one.
328 vbuf_flush_vertices( struct vbuf_stage
*vbuf
)
332 vbuf
->render
->unmap_vertices( vbuf
->render
, 0, vbuf
->nr_vertices
- 1 );
334 if (vbuf
->nr_indices
)
336 vbuf
->render
->draw_elements(vbuf
->render
,
340 vbuf
->nr_indices
= 0;
343 /* Reset temporary vertices ids */
344 if(vbuf
->nr_vertices
)
345 draw_reset_vertex_ids( vbuf
->stage
.draw
);
347 /* Free the vertex buffer */
348 vbuf
->render
->release_vertices( vbuf
->render
);
350 vbuf
->max_vertices
= vbuf
->nr_vertices
= 0;
351 vbuf
->vertex_ptr
= vbuf
->vertices
= NULL
;
354 /* Reset point/line/tri function pointers.
355 * If (for example) we transition from points to tris and back to points
356 * again, we need to call the vbuf_first_point() function again to flush
357 * the triangles before drawing more points. This can happen when drawing
358 * with front polygon mode = filled and back polygon mode = line or point.
360 vbuf
->stage
.point
= vbuf_first_point
;
361 vbuf
->stage
.line
= vbuf_first_line
;
362 vbuf
->stage
.tri
= vbuf_first_tri
;
367 vbuf_alloc_vertices( struct vbuf_stage
*vbuf
)
369 if (vbuf
->vertex_ptr
) {
370 assert(!vbuf
->nr_indices
);
371 assert(!vbuf
->vertices
);
374 /* Allocate a new vertex buffer */
375 vbuf
->max_vertices
= vbuf
->render
->max_vertex_buffer_bytes
/ vbuf
->vertex_size
;
377 if(vbuf
->max_vertices
>= UNDEFINED_VERTEX_ID
)
378 vbuf
->max_vertices
= UNDEFINED_VERTEX_ID
- 1;
380 /* Must always succeed -- driver gives us a
381 * 'max_vertex_buffer_bytes' which it guarantees it can allocate,
382 * and it will flush itself if necessary to do so. If this does
383 * fail, we are basically without usable hardware.
385 vbuf
->render
->allocate_vertices(vbuf
->render
,
386 (ushort
) vbuf
->vertex_size
,
387 (ushort
) vbuf
->max_vertices
);
389 vbuf
->vertices
= (uint
*) vbuf
->render
->map_vertices( vbuf
->render
);
391 vbuf
->vertex_ptr
= vbuf
->vertices
;
397 vbuf_flush( struct draw_stage
*stage
, unsigned flags
)
399 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
401 vbuf_flush_vertices( vbuf
);
406 vbuf_reset_stipple_counter( struct draw_stage
*stage
)
408 /* XXX: Need to do something here for hardware with linestipple.
414 static void vbuf_destroy( struct draw_stage
*stage
)
416 struct vbuf_stage
*vbuf
= vbuf_stage( stage
);
419 align_free( vbuf
->indices
);
422 vbuf
->render
->destroy( vbuf
->render
);
425 translate_cache_destroy(vbuf
->cache
);
432 * Create a new primitive vbuf/render stage.
434 struct draw_stage
*draw_vbuf_stage( struct draw_context
*draw
,
435 struct vbuf_render
*render
)
437 struct vbuf_stage
*vbuf
= CALLOC_STRUCT(vbuf_stage
);
441 vbuf
->stage
.draw
= draw
;
442 vbuf
->stage
.name
= "vbuf";
443 vbuf
->stage
.point
= vbuf_first_point
;
444 vbuf
->stage
.line
= vbuf_first_line
;
445 vbuf
->stage
.tri
= vbuf_first_tri
;
446 vbuf
->stage
.flush
= vbuf_flush
;
447 vbuf
->stage
.reset_stipple_counter
= vbuf_reset_stipple_counter
;
448 vbuf
->stage
.destroy
= vbuf_destroy
;
450 vbuf
->render
= render
;
451 vbuf
->max_indices
= MIN2(render
->max_indices
, UNDEFINED_VERTEX_ID
-1);
453 vbuf
->indices
= (ushort
*) align_malloc(vbuf
->max_indices
*
454 sizeof(vbuf
->indices
[0]),
459 vbuf
->cache
= translate_cache_create();
463 vbuf
->vertices
= NULL
;
464 vbuf
->vertex_ptr
= vbuf
->vertices
;
466 vbuf
->zero4
[0] = vbuf
->zero4
[1] = vbuf
->zero4
[2] = vbuf
->zero4
[3] = 0.0f
;
472 vbuf_destroy(&vbuf
->stage
);