2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2007 Brian Paul All Rights Reserved.
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 * Keith Whitwell <keith@tungstengraphics.com>
28 #include "main/glheader.h"
29 #include "main/context.h"
30 #include "main/imports.h"
31 #include "main/mtypes.h"
33 #include "t_context.h"
34 #include "t_pipeline.h"
35 #include "t_vp_build.h"
38 void _tnl_install_pipeline( struct gl_context *ctx,
39 const struct tnl_pipeline_stage **stages )
41 TNLcontext *tnl = TNL_CONTEXT(ctx);
44 tnl->pipeline.new_state = ~0;
46 /* Create a writeable copy of each stage.
48 for (i = 0 ; i < MAX_PIPELINE_STAGES && stages[i] ; i++) {
49 struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
50 memcpy(s, stages[i], sizeof(*s));
55 tnl->pipeline.nr_stages = i;
58 void _tnl_destroy_pipeline( struct gl_context *ctx )
60 TNLcontext *tnl = TNL_CONTEXT(ctx);
63 for (i = 0 ; i < tnl->pipeline.nr_stages ; i++) {
64 struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
69 tnl->pipeline.nr_stages = 0;
74 static GLuint check_input_changes( struct gl_context *ctx )
76 TNLcontext *tnl = TNL_CONTEXT(ctx);
79 for (i = 0; i <= _TNL_LAST_MAT; i++) {
80 if (tnl->vb.AttribPtr[i]->size != tnl->pipeline.last_attrib_size[i] ||
81 tnl->vb.AttribPtr[i]->stride != tnl->pipeline.last_attrib_stride[i]) {
82 tnl->pipeline.last_attrib_size[i] = tnl->vb.AttribPtr[i]->size;
83 tnl->pipeline.last_attrib_stride[i] = tnl->vb.AttribPtr[i]->stride;
84 tnl->pipeline.input_changes |= 1<<i;
88 return tnl->pipeline.input_changes;
92 static GLuint check_output_changes( struct gl_context *ctx )
95 TNLcontext *tnl = TNL_CONTEXT(ctx);
97 for (i = 0; i < VERT_RESULT_MAX; i++) {
98 if (tnl->vb.ResultPtr[i]->size != tnl->last_result_size[i] ||
99 tnl->vb.ResultPtr[i]->stride != tnl->last_result_stride[i]) {
100 tnl->last_result_size[i] = tnl->vb.ResultPtr[i]->size;
101 tnl->last_result_stride[i] = tnl->vb.ResultPtr[i]->stride;
102 tnl->pipeline.output_changes |= 1<<i;
106 if (tnl->pipeline.output_changes)
107 tnl->Driver.NotifyOutputChanges( ctx, tnl->pipeline.output_changes );
109 return tnl->pipeline.output_changes;
116 void _tnl_run_pipeline( struct gl_context *ctx )
118 TNLcontext *tnl = TNL_CONTEXT(ctx);
119 unsigned short __tmp;
125 /* Check for changed input sizes or change in stride to/from zero
126 * (ie const or non-const).
128 if (check_input_changes( ctx ) || tnl->pipeline.new_state) {
129 if (ctx->VertexProgram._MaintainTnlProgram)
130 _tnl_UpdateFixedFunctionProgram( ctx );
132 for (i = 0; i < tnl->pipeline.nr_stages ; i++) {
133 struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
135 s->validate( ctx, s );
138 tnl->pipeline.new_state = 0;
139 tnl->pipeline.input_changes = 0;
141 /* Pipeline can only change its output in response to either a
142 * statechange or an input size/stride change. No other changes
145 if (check_output_changes( ctx ))
146 _tnl_notify_pipeline_output_change( ctx );
149 START_FAST_MATH(__tmp);
151 for (i = 0; i < tnl->pipeline.nr_stages ; i++) {
152 struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
153 if (!s->run( ctx, s ))
157 END_FAST_MATH(__tmp);
162 /* The default pipeline. This is useful for software rasterizers, and
163 * simple hardware rasterizers. For customization, I don't recommend
164 * tampering with the internals of these stages in the way that
165 * drivers did in Mesa 3.4. These stages are basically black boxes,
166 * and should be left intact.
168 * To customize the pipeline, consider:
170 * - removing redundant stages (making sure that the software rasterizer
171 * can cope with this on fallback paths). An example is fog
172 * coordinate generation, which is not required in the FX driver.
174 * - replacing general-purpose machine-independent stages with
175 * general-purpose machine-specific stages. There is no example of
176 * this to date, though it must be borne in mind that all subsequent
177 * stages that reference the output of the new stage must cope with
178 * any machine-specific data introduced. This may not be easy
179 * unless there are no such stages (ie the new stage is the last in
182 * - inserting optimized (but specialized) stages ahead of the
183 * general-purpose fallback implementation. For example, the old
184 * fastpath mechanism, which only works when the VB->Elts input is
185 * available, can be duplicated by placing the fastpath stage at the
186 * head of this pipeline. Such specialized stages are currently
187 * constrained to have no outputs (ie. they must either finish the *
188 * pipeline by returning GL_FALSE from run(), or do nothing).
190 * Some work can be done to lift some of the restrictions in the final
191 * case, if it becomes necessary to do so.
193 const struct tnl_pipeline_stage *_tnl_default_pipeline[] = {
194 &_tnl_vertex_transform_stage,
195 &_tnl_normal_transform_stage,
196 &_tnl_lighting_stage,
198 &_tnl_texture_transform_stage,
199 &_tnl_point_attenuation_stage,
200 &_tnl_vertex_program_stage,
201 &_tnl_fog_coordinate_stage,
206 const struct tnl_pipeline_stage *_tnl_vp_pipeline[] = {
207 &_tnl_vertex_program_stage,