src/mesa/tnl/t_pipeline.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  6.5.3
   4  *
   5  * Copyright (C) 1999-2007  Brian Paul   All Rights Reserved.
   6  *
   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:
  13  *
  14  * The above copyright notice and this permission notice shall be included
  15  * in all copies or substantial portions of the Software.
  16  *
  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.
  23  *
  24  * Authors:
  25  *    Keith Whitwell <keith@tungstengraphics.com>
  26  */
  27
  28 #include "main/glheader.h"
  29 #include "main/context.h"
  30 #include "main/imports.h"
  31 #include "main/state.h"
  32 #include "main/mtypes.h"
  33
  34 #include "t_context.h"
  35 #include "t_pipeline.h"
  36 #include "t_vp_build.h"
  37 #include "t_vertex.h"
  38
  39 void _tnl_install_pipeline( GLcontext *ctx,
  40                             const struct tnl_pipeline_stage **stages )
  41 {
  42    TNLcontext *tnl = TNL_CONTEXT(ctx);
  43    GLuint i;
  44
  45    tnl->pipeline.new_state = ~0;
  46
  47    /* Create a writeable copy of each stage.
  48     */
  49    for (i = 0 ; i < MAX_PIPELINE_STAGES && stages[i] ; i++) {
  50       struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
  51       MEMCPY(s, stages[i], sizeof(*s));
  52       if (s->create)
  53          s->create(ctx, s);
  54    }
  55
  56    tnl->pipeline.nr_stages = i;
  57 }
  58
  59 void _tnl_destroy_pipeline( GLcontext *ctx )
  60 {
  61    TNLcontext *tnl = TNL_CONTEXT(ctx);
  62    GLuint i;
  63
  64    for (i = 0 ; i < tnl->pipeline.nr_stages ; i++) {
  65       struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
  66       if (s->destroy)
  67          s->destroy(s);
  68    }
  69
  70    tnl->pipeline.nr_stages = 0;
  71 }
  72
  73
  74
  75 static GLuint check_input_changes( GLcontext *ctx )
  76 {
  77    TNLcontext *tnl = TNL_CONTEXT(ctx);
  78    GLuint i;
  79
  80    for (i = 0; i <= _TNL_LAST_MAT; i++) {
  81       if (tnl->vb.AttribPtr[i]->size != tnl->pipeline.last_attrib_size[i] ||
  82           tnl->vb.AttribPtr[i]->stride != tnl->pipeline.last_attrib_stride[i]) {
  83          tnl->pipeline.last_attrib_size[i] = tnl->vb.AttribPtr[i]->size;
  84          tnl->pipeline.last_attrib_stride[i] = tnl->vb.AttribPtr[i]->stride;
  85          tnl->pipeline.input_changes |= 1<<i;
  86       }
  87    }
  88
  89    return tnl->pipeline.input_changes;
  90 }
  91
  92
  93 static GLuint check_output_changes( GLcontext *ctx )
  94 {
  95 #if 0
  96    TNLcontext *tnl = TNL_CONTEXT(ctx);
  97
  98    for (i = 0; i < VERT_RESULT_MAX; i++) {
  99       if (tnl->vb.ResultPtr[i]->size != tnl->last_result_size[i] ||
 100           tnl->vb.ResultPtr[i]->stride != tnl->last_result_stride[i]) {
 101          tnl->last_result_size[i] = tnl->vb.ResultPtr[i]->size;
 102          tnl->last_result_stride[i] = tnl->vb.ResultPtr[i]->stride;
 103          tnl->pipeline.output_changes |= 1<<i;
 104       }
 105    }
 106
 107    if (tnl->pipeline.output_changes)
 108       tnl->Driver.NotifyOutputChanges( ctx, tnl->pipeline.output_changes );
 109
 110    return tnl->pipeline.output_changes;
 111 #else
 112    return ~0;
 113 #endif
 114 }
 115
 116
 117 void _tnl_run_pipeline( GLcontext *ctx )
 118 {
 119    TNLcontext *tnl = TNL_CONTEXT(ctx);
 120    unsigned short __tmp;
 121    GLuint i;
 122
 123    if (!tnl->vb.Count)
 124       return;
 125
 126    /* Check for changed input sizes or change in stride to/from zero
 127     * (ie const or non-const).
 128     */
 129    if (check_input_changes( ctx ) || tnl->pipeline.new_state) {
 130       if (ctx->VertexProgram._MaintainTnlProgram)
 131          _tnl_UpdateFixedFunctionProgram( ctx );
 132
 133       for (i = 0; i < tnl->pipeline.nr_stages ; i++) {
 134          struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
 135          if (s->validate)
 136             s->validate( ctx, s );
 137       }
 138
 139       tnl->pipeline.new_state = 0;
 140       tnl->pipeline.input_changes = 0;
 141
 142       /* Pipeline can only change its output in response to either a
 143        * statechange or an input size/stride change.  No other changes
 144        * are allowed.
 145        */
 146       if (check_output_changes( ctx ))
 147          _tnl_notify_pipeline_output_change( ctx );
 148    }
 149
 150    START_FAST_MATH(__tmp);
 151
 152    for (i = 0; i < tnl->pipeline.nr_stages ; i++) {
 153       struct tnl_pipeline_stage *s = &tnl->pipeline.stages[i];
 154       if (!s->run( ctx, s ))
 155          break;
 156    }
 157
 158    END_FAST_MATH(__tmp);
 159 }
 160
 161
 162
 163 /* The default pipeline.  This is useful for software rasterizers, and
 164  * simple hardware rasterizers.  For customization, I don't recommend
 165  * tampering with the internals of these stages in the way that
 166  * drivers did in Mesa 3.4.  These stages are basically black boxes,
 167  * and should be left intact.
 168  *
 169  * To customize the pipeline, consider:
 170  *
 171  * - removing redundant stages (making sure that the software rasterizer
 172  *   can cope with this on fallback paths).  An example is fog
 173  *   coordinate generation, which is not required in the FX driver.
 174  *
 175  * - replacing general-purpose machine-independent stages with
 176  *   general-purpose machine-specific stages.  There is no example of
 177  *   this to date, though it must be borne in mind that all subsequent
 178  *   stages that reference the output of the new stage must cope with
 179  *   any machine-specific data introduced.  This may not be easy
 180  *   unless there are no such stages (ie the new stage is the last in
 181  *   the pipe).
 182  *
 183  * - inserting optimized (but specialized) stages ahead of the
 184  *   general-purpose fallback implementation.  For example, the old
 185  *   fastpath mechanism, which only works when the VB->Elts input is
 186  *   available, can be duplicated by placing the fastpath stage at the
 187  *   head of this pipeline.  Such specialized stages are currently
 188  *   constrained to have no outputs (ie. they must either finish the *
 189  *   pipeline by returning GL_FALSE from run(), or do nothing).
 190  *
 191  * Some work can be done to lift some of the restrictions in the final
 192  * case, if it becomes necessary to do so.
 193  */
 194 const struct tnl_pipeline_stage *_tnl_default_pipeline[] = {
 195    &_tnl_vertex_transform_stage,
 196    &_tnl_normal_transform_stage,
 197    &_tnl_lighting_stage,
 198    &_tnl_texgen_stage,
 199    &_tnl_texture_transform_stage,
 200    &_tnl_point_attenuation_stage,
 201    &_tnl_vertex_program_stage,
 202    &_tnl_fog_coordinate_stage,
 203    &_tnl_render_stage,
 204    NULL
 205 };
 206
 207 const struct tnl_pipeline_stage *_tnl_vp_pipeline[] = {
 208    &_tnl_vertex_program_stage,
 209    &_tnl_render_stage,
 210    NULL
 211 };