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 **************************************************************************/
28 /* Authors: Keith Whitwell <keith@tungstengraphics.com>
31 #include "util/u_memory.h"
32 #include "pipe/p_defines.h"
33 #include "draw_private.h"
34 #include "draw_pipe.h"
35 #include "draw_context.h"
36 #include "draw_vbuf.h"
38 static boolean
points( unsigned prim
)
40 return (prim
== PIPE_PRIM_POINTS
);
43 static boolean
lines( unsigned prim
)
45 return (prim
== PIPE_PRIM_LINES
||
46 prim
== PIPE_PRIM_LINE_STRIP
||
47 prim
== PIPE_PRIM_LINE_LOOP
);
50 static boolean
triangles( unsigned prim
)
52 return prim
>= PIPE_PRIM_TRIANGLES
;
56 * Default version of a function to check if we need any special
57 * pipeline stages, or whether prims/verts can go through untouched.
58 * Don't test for bypass clipping or vs modes, this function is just
59 * about the primitive pipeline stages.
61 * This can be overridden by the driver.
64 draw_need_pipeline(const struct draw_context
*draw
,
65 const struct pipe_rasterizer_state
*rasterizer
,
68 /* If the driver has overridden this, use that version:
71 draw
->render
->need_pipeline
)
73 return draw
->render
->need_pipeline( draw
->render
,
78 /* Don't have to worry about triangles turning into lines/points
79 * and triggering the pipeline, because we have to trigger the
80 * pipeline *anyway* if unfilled mode is active.
85 if (rasterizer
->line_stipple_enable
&& draw
->pipeline
.line_stipple
)
89 if (rasterizer
->line_width
> draw
->pipeline
.wide_line_threshold
)
93 if (rasterizer
->line_smooth
&& draw
->pipeline
.aaline
)
100 if (rasterizer
->point_size
> draw
->pipeline
.wide_point_threshold
)
104 if (rasterizer
->point_smooth
&& draw
->pipeline
.aapoint
)
108 if (rasterizer
->point_sprite
&& draw
->pipeline
.point_sprite
)
115 /* polygon stipple */
116 if (rasterizer
->poly_stipple_enable
&& draw
->pipeline
.pstipple
)
119 /* unfilled polygons */
120 if (rasterizer
->fill_cw
!= PIPE_POLYGON_MODE_FILL
||
121 rasterizer
->fill_ccw
!= PIPE_POLYGON_MODE_FILL
)
125 if (rasterizer
->offset_cw
|| rasterizer
->offset_ccw
)
128 /* two-side lighting */
129 if (rasterizer
->light_twoside
)
133 /* polygon cull - this is difficult - hardware can cull just fine
134 * most of the time (though sometimes CULL_NEITHER is unsupported.
136 * Generally this isn't a reason to require the pipeline, though.
138 if (rasterizer->cull_mode)
148 * Rebuild the rendering pipeline.
150 static struct draw_stage
*validate_pipeline( struct draw_stage
*stage
)
152 struct draw_context
*draw
= stage
->draw
;
153 struct draw_stage
*next
= draw
->pipeline
.rasterize
;
155 int precalc_flat
= 0;
156 boolean wide_lines
, wide_points
;
158 /* Set the validate's next stage to the rasterize stage, so that it
159 * can be found later if needed for flushing.
163 /* drawing wide lines? */
164 wide_lines
= (draw
->rasterizer
->line_width
> draw
->pipeline
.wide_line_threshold
165 && !draw
->rasterizer
->line_smooth
);
167 /* drawing large points? */
168 if (draw
->rasterizer
->point_sprite
&& draw
->pipeline
.point_sprite
)
170 else if (draw
->rasterizer
->point_smooth
&& draw
->pipeline
.aapoint
)
172 else if (draw
->rasterizer
->point_size
> draw
->pipeline
.wide_point_threshold
)
178 * NOTE: we build up the pipeline in end-to-start order.
180 * TODO: make the current primitive part of the state and build
181 * shorter pipelines for lines & points.
184 if (draw
->rasterizer
->line_smooth
&& draw
->pipeline
.aaline
) {
185 draw
->pipeline
.aaline
->next
= next
;
186 next
= draw
->pipeline
.aaline
;
189 if (draw
->rasterizer
->point_smooth
&& draw
->pipeline
.aapoint
) {
190 draw
->pipeline
.aapoint
->next
= next
;
191 next
= draw
->pipeline
.aapoint
;
195 draw
->pipeline
.wide_line
->next
= next
;
196 next
= draw
->pipeline
.wide_line
;
200 if (wide_points
|| draw
->rasterizer
->point_sprite
) {
201 draw
->pipeline
.wide_point
->next
= next
;
202 next
= draw
->pipeline
.wide_point
;
205 if (draw
->rasterizer
->line_stipple_enable
&& draw
->pipeline
.line_stipple
) {
206 draw
->pipeline
.stipple
->next
= next
;
207 next
= draw
->pipeline
.stipple
;
208 precalc_flat
= 1; /* only needed for lines really */
211 if (draw
->rasterizer
->poly_stipple_enable
212 && draw
->pipeline
.pstipple
) {
213 draw
->pipeline
.pstipple
->next
= next
;
214 next
= draw
->pipeline
.pstipple
;
217 if (draw
->rasterizer
->fill_cw
!= PIPE_POLYGON_MODE_FILL
||
218 draw
->rasterizer
->fill_ccw
!= PIPE_POLYGON_MODE_FILL
) {
219 draw
->pipeline
.unfilled
->next
= next
;
220 next
= draw
->pipeline
.unfilled
;
221 precalc_flat
= 1; /* only needed for triangles really */
225 if (draw
->rasterizer
->flatshade
&& precalc_flat
) {
226 draw
->pipeline
.flatshade
->next
= next
;
227 next
= draw
->pipeline
.flatshade
;
230 if (draw
->rasterizer
->offset_cw
||
231 draw
->rasterizer
->offset_ccw
) {
232 draw
->pipeline
.offset
->next
= next
;
233 next
= draw
->pipeline
.offset
;
237 if (draw
->rasterizer
->light_twoside
) {
238 draw
->pipeline
.twoside
->next
= next
;
239 next
= draw
->pipeline
.twoside
;
243 /* Always run the cull stage as we calculate determinant there
246 * This can actually be a win as culling out the triangles can lead
247 * to less work emitting vertices, smaller vertex buffers, etc.
248 * It's difficult to say whether this will be true in general.
250 if (need_det
|| draw
->rasterizer
->cull_mode
) {
251 draw
->pipeline
.cull
->next
= next
;
252 next
= draw
->pipeline
.cull
;
257 if (!draw
->bypass_clipping
)
259 draw
->pipeline
.clip
->next
= next
;
260 next
= draw
->pipeline
.clip
;
264 draw
->pipeline
.first
= next
;
267 debug_printf("draw pipeline:\n");
268 for (next
= draw
->pipeline
.first
; next
; next
= next
->next
)
269 debug_printf(" %s\n", next
->name
);
273 return draw
->pipeline
.first
;
276 static void validate_tri( struct draw_stage
*stage
,
277 struct prim_header
*header
)
279 struct draw_stage
*pipeline
= validate_pipeline( stage
);
280 pipeline
->tri( pipeline
, header
);
283 static void validate_line( struct draw_stage
*stage
,
284 struct prim_header
*header
)
286 struct draw_stage
*pipeline
= validate_pipeline( stage
);
287 pipeline
->line( pipeline
, header
);
290 static void validate_point( struct draw_stage
*stage
,
291 struct prim_header
*header
)
293 struct draw_stage
*pipeline
= validate_pipeline( stage
);
294 pipeline
->point( pipeline
, header
);
297 static void validate_reset_stipple_counter( struct draw_stage
*stage
)
299 struct draw_stage
*pipeline
= validate_pipeline( stage
);
300 pipeline
->reset_stipple_counter( pipeline
);
303 static void validate_flush( struct draw_stage
*stage
,
306 /* May need to pass a backend flush on to the rasterize stage.
309 stage
->next
->flush( stage
->next
, flags
);
313 static void validate_destroy( struct draw_stage
*stage
)
320 * Create validate pipeline stage.
322 struct draw_stage
*draw_validate_stage( struct draw_context
*draw
)
324 struct draw_stage
*stage
= CALLOC_STRUCT(draw_stage
);
329 stage
->name
= "validate";
331 stage
->point
= validate_point
;
332 stage
->line
= validate_line
;
333 stage
->tri
= validate_tri
;
334 stage
->flush
= validate_flush
;
335 stage
->reset_stipple_counter
= validate_reset_stipple_counter
;
336 stage
->destroy
= validate_destroy
;