3 * Mesa 3-D graphics library
6 * Copyright (C) 1999-2003 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>
35 #include "math/m_translate.h"
36 #include "math/m_xform.h"
38 #include "t_context.h"
39 #include "t_pipeline.h"
42 void _tnl_install_pipeline( GLcontext
*ctx
,
43 const struct tnl_pipeline_stage
**stages
)
45 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
46 struct tnl_pipeline
*pipe
= &tnl
->pipeline
;
49 ASSERT(pipe
->nr_stages
== 0);
51 pipe
->run_state_changes
= ~0;
52 pipe
->run_input_changes
= ~0;
53 pipe
->build_state_changes
= ~0;
54 pipe
->build_state_trigger
= 0;
57 /* Create a writeable copy of each stage.
59 for (i
= 0 ; i
< MAX_PIPELINE_STAGES
&& stages
[i
] ; i
++) {
60 MEMCPY( &pipe
->stages
[i
], stages
[i
], sizeof( **stages
));
61 pipe
->build_state_trigger
|= pipe
->stages
[i
].check_state
;
64 MEMSET( &pipe
->stages
[i
], 0, sizeof( **stages
));
69 void _tnl_destroy_pipeline( GLcontext
*ctx
)
71 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
74 for (i
= 0 ; i
< tnl
->pipeline
.nr_stages
; i
++)
75 tnl
->pipeline
.stages
[i
].destroy( &tnl
->pipeline
.stages
[i
] );
77 tnl
->pipeline
.nr_stages
= 0;
80 /* TODO: merge validate with run.
82 void _tnl_validate_pipeline( GLcontext
*ctx
)
84 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
85 struct tnl_pipeline
*pipe
= &tnl
->pipeline
;
86 struct tnl_pipeline_stage
*s
= pipe
->stages
;
87 GLuint newstate
= pipe
->build_state_changes
;
89 GLuint changed_inputs
= 0;
92 pipe
->build_state_changes
= 0;
94 for ( ; s
->check
; s
++) {
96 s
->changed_inputs
|= s
->inputs
& changed_inputs
;
98 if (s
->check_state
& newstate
) {
100 GLuint old_outputs
= s
->outputs
;
103 changed_inputs
|= old_outputs
;
110 pipe
->inputs
|= s
->inputs
& ~generated
;
111 generated
|= s
->outputs
;
118 void _tnl_run_pipeline( GLcontext
*ctx
)
120 TNLcontext
*tnl
= TNL_CONTEXT(ctx
);
121 struct tnl_pipeline
*pipe
= &tnl
->pipeline
;
122 struct tnl_pipeline_stage
*s
= pipe
->stages
;
123 GLuint changed_state
= pipe
->run_state_changes
;
124 GLuint changed_inputs
= pipe
->run_input_changes
;
125 GLboolean running
= GL_TRUE
;
126 #ifdef HAVE_FAST_MATH
127 unsigned short __tmp
;
133 pipe
->run_state_changes
= 0;
134 pipe
->run_input_changes
= 0;
138 ASSERT(pipe
->build_state_changes
== 0);
140 #ifdef HAVE_FAST_MATH
141 START_FAST_MATH(__tmp
);
144 /* If something changes in the pipeline, tag all subsequent stages
145 * using this value for recalculation. Inactive stages have their
146 * state and inputs examined to try to keep cached data alive over
149 for ( ; s
->run
; s
++) {
150 s
->changed_inputs
|= s
->inputs
& changed_inputs
;
152 if (s
->run_state
& changed_state
)
153 s
->changed_inputs
= s
->inputs
;
155 if (s
->active
&& running
) {
156 if (s
->changed_inputs
)
157 changed_inputs
|= s
->outputs
;
159 running
= s
->run( ctx
, s
);
161 s
->changed_inputs
= 0;
165 #ifdef HAVE_FAST_MATH
166 END_FAST_MATH(__tmp
);
172 /* The default pipeline. This is useful for software rasterizers, and
173 * simple hardware rasterizers. For customization, I don't recommend
174 * tampering with the internals of these stages in the way that
175 * drivers did in Mesa 3.4. These stages are basically black boxes,
176 * and should be left intact.
178 * To customize the pipeline, consider:
180 * - removing redundant stages (making sure that the software rasterizer
181 * can cope with this on fallback paths). An example is fog
182 * coordinate generation, which is not required in the FX driver.
184 * - replacing general-purpose machine-independent stages with
185 * general-purpose machine-specific stages. There is no example of
186 * this to date, though it must be borne in mind that all subsequent
187 * stages that reference the output of the new stage must cope with
188 * any machine-specific data introduced. This may not be easy
189 * unless there are no such stages (ie the new stage is the last in
192 * - inserting optimized (but specialized) stages ahead of the
193 * general-purpose fallback implementation. For example, the old
194 * fastpath mechanism, which only works when the VB->Elts input is
195 * available, can be duplicated by placing the fastpath stage at the
196 * head of this pipeline. Such specialized stages are currently
197 * constrained to have no outputs (ie. they must either finish the *
198 * pipeline by returning GL_FALSE from run(), or do nothing).
200 * Some work can be done to lift some of the restrictions in the final
201 * case, if it becomes necessary to do so.
203 const struct tnl_pipeline_stage
*_tnl_default_pipeline
[] = {
204 &_tnl_vertex_transform_stage
,
205 &_tnl_normal_transform_stage
,
206 &_tnl_lighting_stage
,
207 &_tnl_fog_coordinate_stage
,
209 &_tnl_texture_transform_stage
,
210 &_tnl_point_attenuation_stage
,
211 #if defined(FEATURE_NV_vertex_program) || defined(FEATURE_ARB_vertex_program)
212 &_tnl_vertex_program_stage
,