src/mesa/tnl/t_array_api.c

   1 /* $Id: t_array_api.c,v 1.30 2003/02/17 16:36:07 brianp Exp $ */
   2
   3 /*
   4  * Mesa 3-D graphics library
   5  * Version:  4.1
   6  *
   7  * Copyright (C) 1999-2002  Brian Paul   All Rights Reserved.
   8  *
   9  * Permission is hereby granted, free of charge, to any person obtaining a
  10  * copy of this software and associated documentation files (the "Software"),
  11  * to deal in the Software without restriction, including without limitation
  12  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  13  * and/or sell copies of the Software, and to permit persons to whom the
  14  * Software is furnished to do so, subject to the following conditions:
  15  *
  16  * The above copyright notice and this permission notice shall be included
  17  * in all copies or substantial portions of the Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  20  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  22  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  23  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  24  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  */
  26
  27 /**
  28  * \file t_array_api.c
  29  * \brief Vertex array API functions (glDrawArrays, etc)
  30  * \author Keith Whitwell
  31  */
  32
  33 #include "glheader.h"
  34 #include "api_validate.h"
  35 #include "context.h"
  36 #include "imports.h"
  37 #include "macros.h"
  38 #include "mmath.h"
  39 #include "mtypes.h"
  40 #include "state.h"
  41
  42 #include "array_cache/acache.h"
  43
  44 #include "t_array_api.h"
  45 #include "t_array_import.h"
  46 #include "t_imm_api.h"
  47 #include "t_imm_exec.h"
  48 #include "t_context.h"
  49 #include "t_pipeline.h"
  50
  51 static void fallback_drawarrays( GLcontext *ctx, GLenum mode, GLint start,
  52                                  GLsizei count )
  53 {
  54    if (_tnl_hard_begin( ctx, mode )) {
  55       GLint i;
  56       for (i = start; i < count; i++)
  57          glArrayElement( i );
  58       glEnd();
  59    }
  60 }
  61
  62
  63 static void fallback_drawelements( GLcontext *ctx, GLenum mode, GLsizei count,
  64                                    const GLuint *indices)
  65 {
  66    if (_tnl_hard_begin(ctx, mode)) {
  67       GLint i;
  68       for (i = 0 ; i < count ; i++)
  69          glArrayElement( indices[i] );
  70       glEnd();
  71    }
  72 }
  73
  74
  75 static void _tnl_draw_range_elements( GLcontext *ctx, GLenum mode,
  76                                       GLuint start, GLuint end,
  77                                       GLsizei count, const GLuint *indices )
  78
  79 {
  80    TNLcontext *tnl = TNL_CONTEXT(ctx);
  81    FLUSH_CURRENT( ctx, 0 );
  82
  83    /*  _mesa_debug(ctx, "%s\n", __FUNCTION__); */
  84    if (tnl->pipeline.build_state_changes)
  85       _tnl_validate_pipeline( ctx );
  86
  87    _tnl_vb_bind_arrays( ctx, start, end );
  88
  89    tnl->vb.FirstPrimitive = 0;
  90    tnl->vb.Primitive[0] = mode | PRIM_BEGIN | PRIM_END | PRIM_LAST;
  91    tnl->vb.PrimitiveLength[0] = count;
  92    tnl->vb.Elts = (GLuint *)indices;
  93
  94    if (ctx->Array.LockCount)
  95       tnl->Driver.RunPipeline( ctx );
  96    else {
  97       /* Note that arrays may have changed before/after execution.
  98        */
  99       tnl->pipeline.run_input_changes |= ctx->Array._Enabled;
 100       tnl->Driver.RunPipeline( ctx );
 101       tnl->pipeline.run_input_changes |= ctx->Array._Enabled;
 102    }
 103 }
 104
 105
 106
 107 /**
 108  * Called via the GL API dispatcher.
 109  */
 110 void
 111 _tnl_DrawArrays(GLenum mode, GLint start, GLsizei count)
 112 {
 113    GET_CURRENT_CONTEXT(ctx);
 114    TNLcontext *tnl = TNL_CONTEXT(ctx);
 115    struct vertex_buffer *VB = &tnl->vb;
 116    GLuint thresh = (ctx->Driver.NeedFlush & FLUSH_STORED_VERTICES) ? 30 : 10;
 117
 118    if (MESA_VERBOSE & VERBOSE_API)
 119       _mesa_debug(NULL, "_tnl_DrawArrays %d %d\n", start, count);
 120
 121    /* Check arguments, etc.
 122     */
 123    if (!_mesa_validate_DrawArrays( ctx, mode, start, count ))
 124       return;
 125
 126    if (tnl->pipeline.build_state_changes)
 127       _tnl_validate_pipeline( ctx );
 128
 129    if (ctx->CompileFlag) {
 130       fallback_drawarrays( ctx, mode, start, start + count );
 131    }
 132    else if (!ctx->Array.LockCount && (GLuint) count < thresh) {
 133       /* Small primitives: attempt to share a vb (at the expense of
 134        * using the immediate interface).
 135       */
 136       fallback_drawarrays( ctx, mode, start, start + count );
 137    }
 138    else if (ctx->Array.LockCount &&
 139             count < (GLint) ctx->Const.MaxArrayLockSize) {
 140
 141       /* Locked primitives which can fit in a single vertex buffer:
 142        */
 143       FLUSH_CURRENT( ctx, 0 );
 144
 145       if (start < (GLint) ctx->Array.LockFirst)
 146          start = ctx->Array.LockFirst;
 147       if (start + count > (GLint) ctx->Array.LockCount)
 148          count = ctx->Array.LockCount - start;
 149
 150       /* Locked drawarrays.  Reuse any previously transformed data.
 151        */
 152       _tnl_vb_bind_arrays( ctx, ctx->Array.LockFirst, ctx->Array.LockCount );
 153       VB->FirstPrimitive = start;
 154       VB->Primitive[start] = mode | PRIM_BEGIN | PRIM_END | PRIM_LAST;
 155       VB->PrimitiveLength[start] = count;
 156       tnl->Driver.RunPipeline( ctx );
 157    }
 158    else {
 159       int bufsz = 256;          /* Use a small buffer for cache goodness */
 160       int j, nr;
 161       int minimum, modulo, skip;
 162
 163       /* Large primitives requiring decomposition to multiple vertex
 164        * buffers:
 165        */
 166       switch (mode) {
 167       case GL_POINTS:
 168          minimum = 0;
 169          modulo = 1;
 170          skip = 0;
 171          break;
 172       case GL_LINES:
 173          minimum = 1;
 174          modulo = 2;
 175          skip = 1;
 176          break;
 177       case GL_LINE_STRIP:
 178          minimum = 1;
 179          modulo = 1;
 180          skip = 0;
 181          break;
 182       case GL_TRIANGLES:
 183          minimum = 2;
 184          modulo = 3;
 185          skip = 2;
 186          break;
 187       case GL_TRIANGLE_STRIP:
 188          minimum = 2;
 189          modulo = 1;
 190          skip = 0;
 191          break;
 192       case GL_QUADS:
 193          minimum = 3;
 194          modulo = 4;
 195          skip = 3;
 196          break;
 197       case GL_QUAD_STRIP:
 198          minimum = 3;
 199          modulo = 2;
 200          skip = 0;
 201          break;
 202       case GL_LINE_LOOP:
 203       case GL_TRIANGLE_FAN:
 204       case GL_POLYGON:
 205       default:
 206          /* Primitives requiring a copied vertex (fan-like primitives)
 207           * must use the slow path if they cannot fit in a single
 208           * vertex buffer.
 209           */
 210          if (count < (GLint) ctx->Const.MaxArrayLockSize) {
 211             bufsz = ctx->Const.MaxArrayLockSize;
 212             minimum = 0;
 213             modulo = 1;
 214             skip = 0;
 215          }
 216          else {
 217             fallback_drawarrays( ctx, mode, start, start + count );
 218             return;
 219          }
 220       }
 221
 222       FLUSH_CURRENT( ctx, 0 );
 223
 224       bufsz -= bufsz % modulo;
 225       bufsz -= minimum;
 226       count += start;
 227
 228       for (j = start + minimum ; j < count ; j += nr + skip ) {
 229
 230          nr = MIN2( bufsz, count - j );
 231
 232          _tnl_vb_bind_arrays( ctx, j - minimum, j + nr );
 233
 234          VB->FirstPrimitive = 0;
 235          VB->Primitive[0] = mode | PRIM_BEGIN | PRIM_END | PRIM_LAST;
 236          VB->PrimitiveLength[0] = nr + minimum;
 237          tnl->pipeline.run_input_changes |= ctx->Array._Enabled;
 238          tnl->Driver.RunPipeline( ctx );
 239          tnl->pipeline.run_input_changes |= ctx->Array._Enabled;
 240       }
 241    }
 242 }
 243
 244
 245 /**
 246  * Called via the GL API dispatcher.
 247  */
 248 void
 249 _tnl_DrawRangeElements(GLenum mode,
 250                        GLuint start, GLuint end,
 251                        GLsizei count, GLenum type, const GLvoid *indices)
 252 {
 253    GET_CURRENT_CONTEXT(ctx);
 254    GLuint *ui_indices;
 255
 256    if (MESA_VERBOSE & VERBOSE_API)
 257       _mesa_debug(NULL, "_tnl_DrawRangeElements %d %d %d\n", start, end, count);
 258
 259    /* Check arguments, etc.
 260     */
 261    if (!_mesa_validate_DrawRangeElements( ctx, mode, start, end, count,
 262                                           type, indices ))
 263       return;
 264
 265    ui_indices = (GLuint *)_ac_import_elements( ctx, GL_UNSIGNED_INT,
 266                                                count, type, indices );
 267
 268
 269    if (ctx->CompileFlag) {
 270       /* Can't do anything when compiling:
 271        */
 272       fallback_drawelements( ctx, mode, count, ui_indices );
 273    }
 274    else if (ctx->Array.LockCount) {
 275       /* Are the arrays already locked?  If so we currently have to look
 276        * at the whole locked range.
 277        */
 278       if (start >= ctx->Array.LockFirst && end <= ctx->Array.LockCount)
 279          _tnl_draw_range_elements( ctx, mode,
 280                                    ctx->Array.LockFirst,
 281                                    ctx->Array.LockCount,
 282                                    count, ui_indices );
 283       else {
 284          /* The spec says referencing elements outside the locked
 285           * range is undefined.  I'm going to make it a noop this time
 286           * round, maybe come up with something beter before 3.6.
 287           *
 288           * May be able to get away with just setting LockCount==0,
 289           * though this raises the problems of dependent state.  May
 290           * have to call glUnlockArrays() directly?
 291           *
 292           * Or scan the list and replace bad indices?
 293           */
 294          _mesa_problem( ctx,
 295                      "DrawRangeElements references "
 296                      "elements outside locked range.");
 297       }
 298    }
 299    else if (end + 1 - start < ctx->Const.MaxArrayLockSize) {
 300       /* The arrays aren't locked but we can still fit them inside a
 301        * single vertexbuffer.
 302        */
 303       _tnl_draw_range_elements( ctx, mode, start, end + 1, count, ui_indices );
 304    } else {
 305       /* Range is too big to optimize:
 306        */
 307       fallback_drawelements( ctx, mode, count, ui_indices );
 308    }
 309 }
 310
 311
 312
 313 /**
 314  * Called via the GL API dispatcher.
 315  */
 316 void
 317 _tnl_DrawElements(GLenum mode, GLsizei count, GLenum type,
 318                   const GLvoid *indices)
 319 {
 320    GET_CURRENT_CONTEXT(ctx);
 321    GLuint *ui_indices;
 322
 323    if (MESA_VERBOSE & VERBOSE_API)
 324       _mesa_debug(NULL, "_tnl_DrawElements %d\n", count);
 325
 326    /* Check arguments, etc.
 327     */
 328    if (!_mesa_validate_DrawElements( ctx, mode, count, type, indices ))
 329       return;
 330
 331    ui_indices = (GLuint *)_ac_import_elements( ctx, GL_UNSIGNED_INT,
 332                                                count, type, indices );
 333
 334    if (ctx->CompileFlag) {
 335       /* Can't do anything when compiling:
 336        */
 337       fallback_drawelements( ctx, mode, count, ui_indices );
 338    }
 339    else if (ctx->Array.LockCount) {
 340       _tnl_draw_range_elements( ctx, mode,
 341                                 ctx->Array.LockFirst,
 342                                 ctx->Array.LockCount,
 343                                 count, ui_indices );
 344    }
 345    else {
 346       /* Scan the index list and see if we can use the locked path anyway.
 347        */
 348       GLuint max_elt = 0;
 349       GLint i;
 350
 351       for (i = 0 ; i < count ; i++)
 352          if (ui_indices[i] > max_elt)
 353             max_elt = ui_indices[i];
 354
 355       if (max_elt < ctx->Const.MaxArrayLockSize && /* can we use it? */
 356           max_elt < (GLuint) count)                /* do we want to use it? */
 357          _tnl_draw_range_elements( ctx, mode, 0, max_elt+1, count, ui_indices );
 358       else
 359          fallback_drawelements( ctx, mode, count, ui_indices );
 360    }
 361 }
 362
 363
 364 /**
 365  * Initialize context's vertex array fields.  Called during T 'n L context
 366  * creation.
 367  */
 368 void _tnl_array_init( GLcontext *ctx )
 369 {
 370    TNLcontext *tnl = TNL_CONTEXT(ctx);
 371    struct vertex_arrays *tmp = &tnl->array_inputs;
 372    GLvertexformat *vfmt = &(TNL_CONTEXT(ctx)->vtxfmt);
 373    GLuint i;
 374
 375    vfmt->DrawArrays = _tnl_DrawArrays;
 376    vfmt->DrawElements = _tnl_DrawElements;
 377    vfmt->DrawRangeElements = _tnl_DrawRangeElements;
 378
 379    /* Setup vector pointers that will be used to bind arrays to VB's.
 380     */
 381    _mesa_vector4f_init( &tmp->Obj, 0, 0 );
 382    _mesa_vector4f_init( &tmp->Normal, 0, 0 );
 383    _mesa_vector4f_init( &tmp->FogCoord, 0, 0 );
 384    _mesa_vector1ui_init( &tmp->Index, 0, 0 );
 385    _mesa_vector1ub_init( &tmp->EdgeFlag, 0, 0 );
 386
 387    for (i = 0; i < ctx->Const.MaxTextureUnits; i++)
 388       _mesa_vector4f_init( &tmp->TexCoord[i], 0, 0);
 389
 390    tnl->tmp_primitive = (GLuint *)MALLOC(sizeof(GLuint)*tnl->vb.Size);
 391    tnl->tmp_primitive_length = (GLuint *)MALLOC(sizeof(GLuint)*tnl->vb.Size);
 392 }
 393
 394
 395 /**
 396  * Destroy the context's vertex array stuff.
 397  * Called during T 'n L context destruction.
 398  */
 399 void _tnl_array_destroy( GLcontext *ctx )
 400 {
 401    TNLcontext *tnl = TNL_CONTEXT(ctx);
 402    if (tnl->tmp_primitive_length) FREE(tnl->tmp_primitive_length);
 403    if (tnl->tmp_primitive) FREE(tnl->tmp_primitive);
 404 }