1 /**************************************************************************
3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
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 TUNGSTEN GRAPHICS 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 Keith Whitwell <keith@tungstengraphics.com>
33 * \author Jose Fonseca <jrfonsec@tungstengraphics.com>
40 #include "pipe/p_compiler.h"
43 struct pipe_rasterizer_state
;
46 struct pipe_query_data_pipeline_statistics
;
50 * Interface for hardware vertex buffer rendering.
55 * Driver limits. May be tuned lower to improve cache hits on
59 unsigned max_vertex_buffer_bytes
;
62 * Query if the hardware driver needs assistance for a particular
63 * combination of rasterizer state and primitive.
67 boolean (*need_pipeline
)(const struct vbuf_render
*render
,
68 const struct pipe_rasterizer_state
*rasterizer
,
73 * Get the hardware vertex format.
75 * XXX: have this in draw_context instead?
77 const struct vertex_info
*(*get_vertex_info
)( struct vbuf_render
* );
80 * Request a destination for vertices.
81 * Hardware renderers will use ttm memory, others will just malloc
84 boolean (*allocate_vertices
)( struct vbuf_render
*,
88 void *(*map_vertices
)( struct vbuf_render
* );
89 void (*unmap_vertices
)( struct vbuf_render
*,
94 * Notify the renderer of the current primitive when it changes.
95 * Must succeed for TRIANGLES, LINES and POINTS. Other prims at
96 * the discretion of the driver, for the benefit of the passthrough
99 void (*set_primitive
)( struct vbuf_render
*, unsigned prim
);
102 * Draw indexed primitives. Note that indices are ushort. The driver
103 * must complete this call, if necessary splitting the index list itself.
105 void (*draw_elements
)( struct vbuf_render
*,
106 const ushort
*indices
,
109 /* Draw non-indexed primitives.
111 void (*draw_arrays
)( struct vbuf_render
*,
116 * Called when vbuf is done with this set of vertices:
118 void (*release_vertices
)( struct vbuf_render
* );
120 void (*destroy
)( struct vbuf_render
* );
124 * Called after writing data to the stream out buffers
126 void (*set_stream_output_info
)( struct vbuf_render
*vbufr
,
127 unsigned primitive_count
,
128 unsigned vertices_count
,
129 unsigned primitive_generated
);
132 * Called after all relevant statistics have been accumulated.
134 void (*pipeline_statistics
)(
135 struct vbuf_render
*vbufr
,
136 const struct pipe_query_data_pipeline_statistics
*stats
);
142 draw_vbuf_stage( struct draw_context
*draw
,
143 struct vbuf_render
*render
);
146 #endif /*DRAW_VBUF_H_*/