src/gallium/auxiliary/draw/draw_pipe.c

   1 /**************************************************************************
   2  *
   3  * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
   4  * All Rights Reserved.
   5  *
   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:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  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.
  25  *
  26  **************************************************************************/
  27
  28  /*
  29   * Authors:
  30   *   Keith Whitwell <keith@tungstengraphics.com>
  31   */
  32
  33 #include "draw/draw_private.h"
  34 #include "draw/draw_pipe.h"
  35 #include "util/u_debug.h"
  36
  37
  38
  39 boolean draw_pipeline_init( struct draw_context *draw )
  40 {
  41    /* create pipeline stages */
  42    draw->pipeline.wide_line  = draw_wide_line_stage( draw );
  43    draw->pipeline.wide_point = draw_wide_point_stage( draw );
  44    draw->pipeline.stipple   = draw_stipple_stage( draw );
  45    draw->pipeline.unfilled  = draw_unfilled_stage( draw );
  46    draw->pipeline.twoside   = draw_twoside_stage( draw );
  47    draw->pipeline.offset    = draw_offset_stage( draw );
  48    draw->pipeline.clip      = draw_clip_stage( draw );
  49    draw->pipeline.flatshade = draw_flatshade_stage( draw );
  50    draw->pipeline.cull      = draw_cull_stage( draw );
  51    draw->pipeline.validate  = draw_validate_stage( draw );
  52    draw->pipeline.first     = draw->pipeline.validate;
  53
  54    if (!draw->pipeline.wide_line ||
  55        !draw->pipeline.wide_point ||
  56        !draw->pipeline.stipple ||
  57        !draw->pipeline.unfilled ||
  58        !draw->pipeline.twoside ||
  59        !draw->pipeline.offset ||
  60        !draw->pipeline.clip ||
  61        !draw->pipeline.flatshade ||
  62        !draw->pipeline.cull ||
  63        !draw->pipeline.validate)
  64       return FALSE;
  65
  66    /* these defaults are oriented toward the needs of softpipe */
  67    draw->pipeline.wide_point_threshold = 1000000.0f; /* infinity */
  68    draw->pipeline.wide_line_threshold = 1.0f;
  69    draw->pipeline.wide_point_sprites = FALSE;
  70    draw->pipeline.line_stipple = TRUE;
  71    draw->pipeline.point_sprite = TRUE;
  72
  73    return TRUE;
  74 }
  75
  76
  77 void draw_pipeline_destroy( struct draw_context *draw )
  78 {
  79    if (draw->pipeline.wide_line)
  80       draw->pipeline.wide_line->destroy( draw->pipeline.wide_line );
  81    if (draw->pipeline.wide_point)
  82       draw->pipeline.wide_point->destroy( draw->pipeline.wide_point );
  83    if (draw->pipeline.stipple)
  84       draw->pipeline.stipple->destroy( draw->pipeline.stipple );
  85    if (draw->pipeline.unfilled)
  86       draw->pipeline.unfilled->destroy( draw->pipeline.unfilled );
  87    if (draw->pipeline.twoside)
  88       draw->pipeline.twoside->destroy( draw->pipeline.twoside );
  89    if (draw->pipeline.offset)
  90       draw->pipeline.offset->destroy( draw->pipeline.offset );
  91    if (draw->pipeline.clip)
  92       draw->pipeline.clip->destroy( draw->pipeline.clip );
  93    if (draw->pipeline.flatshade)
  94       draw->pipeline.flatshade->destroy( draw->pipeline.flatshade );
  95    if (draw->pipeline.cull)
  96       draw->pipeline.cull->destroy( draw->pipeline.cull );
  97    if (draw->pipeline.validate)
  98       draw->pipeline.validate->destroy( draw->pipeline.validate );
  99    if (draw->pipeline.aaline)
 100       draw->pipeline.aaline->destroy( draw->pipeline.aaline );
 101    if (draw->pipeline.aapoint)
 102       draw->pipeline.aapoint->destroy( draw->pipeline.aapoint );
 103    if (draw->pipeline.pstipple)
 104       draw->pipeline.pstipple->destroy( draw->pipeline.pstipple );
 105    if (draw->pipeline.rasterize)
 106       draw->pipeline.rasterize->destroy( draw->pipeline.rasterize );
 107 }
 108
 109
 110
 111 /**
 112  * Build primitive to render a point with vertex at v0.
 113  */
 114 static void do_point( struct draw_context *draw,
 115                       const char *v0 )
 116 {
 117    struct prim_header prim;
 118
 119    prim.flags = 0;
 120    prim.pad = 0;
 121    prim.v[0] = (struct vertex_header *)v0;
 122
 123    draw->pipeline.first->point( draw->pipeline.first, &prim );
 124 }
 125
 126
 127 /**
 128  * Build primitive to render a line with vertices at v0, v1.
 129  * \param flags  bitmask of DRAW_PIPE_EDGE_x, DRAW_PIPE_RESET_STIPPLE
 130  */
 131 static void do_line( struct draw_context *draw,
 132                      ushort flags,
 133                      const char *v0,
 134                      const char *v1 )
 135 {
 136    struct prim_header prim;
 137
 138    prim.flags = flags;
 139    prim.pad = 0;
 140    prim.v[0] = (struct vertex_header *)v0;
 141    prim.v[1] = (struct vertex_header *)v1;
 142
 143    draw->pipeline.first->line( draw->pipeline.first, &prim );
 144 }
 145
 146
 147 /**
 148  * Build primitive to render a triangle with vertices at v0, v1, v2.
 149  * \param flags  bitmask of DRAW_PIPE_EDGE_x, DRAW_PIPE_RESET_STIPPLE
 150  */
 151 static void do_triangle( struct draw_context *draw,
 152                          ushort flags,
 153                          char *v0,
 154                          char *v1,
 155                          char *v2 )
 156 {
 157    struct prim_header prim;
 158
 159    prim.v[0] = (struct vertex_header *)v0;
 160    prim.v[1] = (struct vertex_header *)v1;
 161    prim.v[2] = (struct vertex_header *)v2;
 162    prim.flags = flags;
 163    prim.pad = 0;
 164
 165    draw->pipeline.first->tri( draw->pipeline.first, &prim );
 166 }
 167
 168
 169 /*
 170  * Set up macros for draw_pt_decompose.h template code.
 171  * This code uses vertex indexes / elements.
 172  */
 173
 174 #define TRIANGLE(flags,i0,i1,i2)                                  \
 175    do {                                                           \
 176       do_triangle( draw,                                          \
 177                    flags,                                         \
 178                    verts + stride * (i0),                         \
 179                    verts + stride * (i1),                         \
 180                    verts + stride * (i2) );                       \
 181    } while (0)
 182
 183 #define LINE(flags,i0,i1)                                         \
 184    do {                                                           \
 185       do_line( draw,                                              \
 186                flags,                                             \
 187                verts + stride * (i0),                             \
 188                verts + stride * (i1) );                           \
 189    } while (0)
 190
 191 #define POINT(i0)                               \
 192    do {                                         \
 193       do_point( draw, verts + stride * (i0) );  \
 194    } while (0)
 195
 196 #define GET_ELT(idx) (elts[idx])
 197
 198 #define FUNC pipe_run_elts
 199 #define FUNC_VARS                               \
 200     struct draw_context *draw,                  \
 201     unsigned prim,                              \
 202     unsigned prim_flags,                        \
 203     struct vertex_header *vertices,             \
 204     unsigned stride,                            \
 205     const ushort *elts,                         \
 206     unsigned count
 207
 208 #include "draw_pt_decompose.h"
 209
 210
 211
 212 /**
 213  * Code to run the pipeline on a fairly arbitrary collection of vertices.
 214  * For drawing indexed primitives.
 215  *
 216  * Vertex headers must be pre-initialized with the
 217  * UNDEFINED_VERTEX_ID, this code will cause that id to become
 218  * overwritten, so it may have to be reset if there is the intention
 219  * to reuse the vertices.
 220  *
 221  * This code provides a callback to reset the vertex id's which the
 222  * draw_vbuf.c code uses when it has to perform a flush.
 223  */
 224 void draw_pipeline_run( struct draw_context *draw,
 225                         const struct draw_vertex_info *vert_info,
 226                         const struct draw_prim_info *prim_info)
 227 {
 228    unsigned i, start;
 229
 230    draw->pipeline.verts = (char *)vert_info->verts;
 231    draw->pipeline.vertex_stride = vert_info->stride;
 232    draw->pipeline.vertex_count = vert_info->count;
 233
 234    for (start = i = 0;
 235         i < prim_info->primitive_count;
 236         start += prim_info->primitive_lengths[i], i++)
 237    {
 238       const unsigned count = prim_info->primitive_lengths[i];
 239
 240 #if DEBUG
 241       /* Warn if one of the element indexes go outside the vertex buffer */
 242       {
 243          unsigned max_index = 0x0, i;
 244          /* find the largest element index */
 245          for (i = 0; i < count; i++) {
 246             unsigned int index = prim_info->elts[start + i];
 247             if (index > max_index)
 248                max_index = index;
 249          }
 250          if (max_index >= vert_info->count) {
 251             debug_printf("%s: max_index (%u) outside vertex buffer (%u)\n",
 252                          __FUNCTION__,
 253                          max_index,
 254                          vert_info->count);
 255          }
 256       }
 257 #endif
 258
 259       pipe_run_elts(draw,
 260                     prim_info->prim,
 261                     prim_info->flags,
 262                     vert_info->verts,
 263                     vert_info->stride,
 264                     prim_info->elts + start,
 265                     count);
 266    }
 267
 268    draw->pipeline.verts = NULL;
 269    draw->pipeline.vertex_count = 0;
 270 }
 271
 272
 273 /*
 274  * Set up macros for draw_pt_decompose.h template code.
 275  * This code is for non-indexed (aka linear) rendering (no elts).
 276  */
 277
 278 #define TRIANGLE(flags,i0,i1,i2)       \
 279    do_triangle( draw, flags,           \
 280                 verts + stride * (i0), \
 281                 verts + stride * (i1), \
 282                 verts + stride * (i2) )
 283
 284 #define LINE(flags,i0,i1)              \
 285    do_line( draw, flags,               \
 286             verts + stride * (i0),     \
 287             verts + stride * (i1) )
 288
 289 #define POINT(i0)                      \
 290    do_point( draw, verts + stride * (i0) )
 291
 292
 293 #define GET_ELT(idx) (idx)
 294
 295 #define FUNC pipe_run_linear
 296 #define FUNC_VARS                      \
 297     struct draw_context *draw,         \
 298     unsigned prim,                     \
 299     unsigned prim_flags,               \
 300     struct vertex_header *vertices,    \
 301     unsigned stride,                   \
 302     unsigned count
 303
 304 #include "draw_pt_decompose.h"
 305
 306
 307 /*
 308  * For drawing non-indexed primitives.
 309  */
 310 void draw_pipeline_run_linear( struct draw_context *draw,
 311                                const struct draw_vertex_info *vert_info,
 312                                const struct draw_prim_info *prim_info)
 313 {
 314    unsigned i, start;
 315
 316    for (start = i = 0;
 317         i < prim_info->primitive_count;
 318         start += prim_info->primitive_lengths[i], i++)
 319    {
 320       unsigned count = prim_info->primitive_lengths[i];
 321       char *verts = ((char*)vert_info->verts) +
 322                     (start * vert_info->stride);
 323
 324       draw->pipeline.verts = verts;
 325       draw->pipeline.vertex_stride = vert_info->stride;
 326       draw->pipeline.vertex_count = count;
 327
 328       assert(count <= vert_info->count);
 329
 330       pipe_run_linear(draw,
 331                       prim_info->prim,
 332                       prim_info->flags,
 333                       (struct vertex_header*)verts,
 334                       vert_info->stride,
 335                       count);
 336    }
 337
 338    draw->pipeline.verts = NULL;
 339    draw->pipeline.vertex_count = 0;
 340 }
 341
 342
 343 void draw_pipeline_flush( struct draw_context *draw,
 344                           unsigned flags )
 345 {
 346    draw->pipeline.first->flush( draw->pipeline.first, flags );
 347    draw->pipeline.first = draw->pipeline.validate;
 348 }