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_quad_rasterization
105 && draw
->pipeline
.wide_point_sprites
)
109 if (rasterizer
->point_smooth
&& draw
->pipeline
.aapoint
)
113 if (rasterizer
->sprite_coord_enable
&& draw
->pipeline
.point_sprite
)
120 /* polygon stipple */
121 if (rasterizer
->poly_stipple_enable
&& draw
->pipeline
.pstipple
)
124 /* unfilled polygons */
125 if (rasterizer
->fill_front
!= PIPE_POLYGON_MODE_FILL
||
126 rasterizer
->fill_back
!= PIPE_POLYGON_MODE_FILL
)
130 if (rasterizer
->offset_point
||
131 rasterizer
->offset_line
||
132 rasterizer
->offset_tri
)
135 /* two-side lighting */
136 if (rasterizer
->light_twoside
)
140 /* polygon cull - this is difficult - hardware can cull just fine
141 * most of the time (though sometimes CULL_NEITHER is unsupported.
143 * Generally this isn't a reason to require the pipeline, though.
145 if (rasterizer->cull_mode)
155 * Rebuild the rendering pipeline.
157 static struct draw_stage
*validate_pipeline( struct draw_stage
*stage
)
159 struct draw_context
*draw
= stage
->draw
;
160 struct draw_stage
*next
= draw
->pipeline
.rasterize
;
161 boolean need_det
= FALSE
;
162 boolean precalc_flat
= FALSE
;
163 boolean wide_lines
, wide_points
;
164 const struct pipe_rasterizer_state
*rast
= draw
->rasterizer
;
166 /* Set the validate's next stage to the rasterize stage, so that it
167 * can be found later if needed for flushing.
171 /* drawing wide lines? */
172 wide_lines
= (rast
->line_width
> draw
->pipeline
.wide_line_threshold
173 && !rast
->line_smooth
);
175 /* drawing large/sprite points (but not AA points)? */
176 if (rast
->sprite_coord_enable
&& draw
->pipeline
.point_sprite
)
178 else if (rast
->point_smooth
&& draw
->pipeline
.aapoint
)
180 else if (rast
->point_size
> draw
->pipeline
.wide_point_threshold
)
182 else if (rast
->point_quad_rasterization
&& draw
->pipeline
.wide_point_sprites
)
188 * NOTE: we build up the pipeline in end-to-start order.
190 * TODO: make the current primitive part of the state and build
191 * shorter pipelines for lines & points.
194 if (rast
->line_smooth
&& draw
->pipeline
.aaline
) {
195 draw
->pipeline
.aaline
->next
= next
;
196 next
= draw
->pipeline
.aaline
;
199 if (rast
->point_smooth
&& draw
->pipeline
.aapoint
) {
200 draw
->pipeline
.aapoint
->next
= next
;
201 next
= draw
->pipeline
.aapoint
;
205 draw
->pipeline
.wide_line
->next
= next
;
206 next
= draw
->pipeline
.wide_line
;
211 draw
->pipeline
.wide_point
->next
= next
;
212 next
= draw
->pipeline
.wide_point
;
215 if (rast
->line_stipple_enable
&& draw
->pipeline
.line_stipple
) {
216 draw
->pipeline
.stipple
->next
= next
;
217 next
= draw
->pipeline
.stipple
;
218 precalc_flat
= TRUE
; /* only needed for lines really */
221 if (rast
->poly_stipple_enable
222 && draw
->pipeline
.pstipple
) {
223 draw
->pipeline
.pstipple
->next
= next
;
224 next
= draw
->pipeline
.pstipple
;
227 if (rast
->fill_front
!= PIPE_POLYGON_MODE_FILL
||
228 rast
->fill_back
!= PIPE_POLYGON_MODE_FILL
) {
229 draw
->pipeline
.unfilled
->next
= next
;
230 next
= draw
->pipeline
.unfilled
;
231 precalc_flat
= TRUE
; /* only needed for triangles really */
235 if (rast
->flatshade
&& precalc_flat
) {
236 draw
->pipeline
.flatshade
->next
= next
;
237 next
= draw
->pipeline
.flatshade
;
240 if (rast
->offset_point
||
243 draw
->pipeline
.offset
->next
= next
;
244 next
= draw
->pipeline
.offset
;
248 if (rast
->light_twoside
) {
249 draw
->pipeline
.twoside
->next
= next
;
250 next
= draw
->pipeline
.twoside
;
254 /* Always run the cull stage as we calculate determinant there
257 * This can actually be a win as culling out the triangles can lead
258 * to less work emitting vertices, smaller vertex buffers, etc.
259 * It's difficult to say whether this will be true in general.
261 if (need_det
|| rast
->cull_face
!= PIPE_FACE_NONE
) {
262 draw
->pipeline
.cull
->next
= next
;
263 next
= draw
->pipeline
.cull
;
268 if (draw
->clip_xy
|| draw
->clip_z
|| draw
->clip_user
)
270 draw
->pipeline
.clip
->next
= next
;
271 next
= draw
->pipeline
.clip
;
275 draw
->pipeline
.first
= next
;
278 debug_printf("draw pipeline:\n");
279 for (next
= draw
->pipeline
.first
; next
; next
= next
->next
)
280 debug_printf(" %s\n", next
->name
);
284 return draw
->pipeline
.first
;
287 static void validate_tri( struct draw_stage
*stage
,
288 struct prim_header
*header
)
290 struct draw_stage
*pipeline
= validate_pipeline( stage
);
291 pipeline
->tri( pipeline
, header
);
294 static void validate_line( struct draw_stage
*stage
,
295 struct prim_header
*header
)
297 struct draw_stage
*pipeline
= validate_pipeline( stage
);
298 pipeline
->line( pipeline
, header
);
301 static void validate_point( struct draw_stage
*stage
,
302 struct prim_header
*header
)
304 struct draw_stage
*pipeline
= validate_pipeline( stage
);
305 pipeline
->point( pipeline
, header
);
308 static void validate_reset_stipple_counter( struct draw_stage
*stage
)
310 struct draw_stage
*pipeline
= validate_pipeline( stage
);
311 pipeline
->reset_stipple_counter( pipeline
);
314 static void validate_flush( struct draw_stage
*stage
,
317 /* May need to pass a backend flush on to the rasterize stage.
320 stage
->next
->flush( stage
->next
, flags
);
324 static void validate_destroy( struct draw_stage
*stage
)
331 * Create validate pipeline stage.
333 struct draw_stage
*draw_validate_stage( struct draw_context
*draw
)
335 struct draw_stage
*stage
= CALLOC_STRUCT(draw_stage
);
340 stage
->name
= "validate";
342 stage
->point
= validate_point
;
343 stage
->line
= validate_line
;
344 stage
->tri
= validate_tri
;
345 stage
->flush
= validate_flush
;
346 stage
->reset_stipple_counter
= validate_reset_stipple_counter
;
347 stage
->destroy
= validate_destroy
;