src/mesa/math/m_debug_xform.c

   1 /* $Id: m_debug_xform.c,v 1.5 2001/03/12 00:48:41 gareth Exp $ */
   2
   3 /*
   4  * Mesa 3-D graphics library
   5  * Version:  3.5
   6  *
   7  * Copyright (C) 1999-2001  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  * Updated for P6 architecture by Gareth Hughes.
  29  */
  30
  31 #include "glheader.h"
  32 #include "context.h"
  33 #include "macros.h"
  34 #include "mem.h"
  35
  36 #include "m_matrix.h"
  37 #include "m_xform.h"
  38
  39 #include "m_debug.h"
  40 #include "m_debug_util.h"
  41
  42 #ifdef DEBUG  /* This code only used for debugging */
  43
  44
  45 /* Overhead of profiling counter in cycles.  Automatically adjusted to
  46  * your machine at run time - counter initialization should give very
  47  * consistent results.
  48  */
  49 long counter_overhead = 0;
  50
  51 /* This is the value of the environment variable MESA_PROFILE, and is
  52  * used to determine if we should benchmark the functions as well as
  53  * verify their correctness.
  54  */
  55 char *mesa_profile = NULL;
  56
  57
  58 static int m_general[16] = {
  59    VAR, VAR, VAR, VAR,
  60    VAR, VAR, VAR, VAR,
  61    VAR, VAR, VAR, VAR,
  62    VAR, VAR, VAR, VAR
  63 };
  64 static int m_identity[16] = {
  65    ONE, NIL, NIL, NIL,
  66    NIL, ONE, NIL, NIL,
  67    NIL, NIL, ONE, NIL,
  68    NIL, NIL, NIL, ONE
  69 };
  70 static int  m_2d[16]  = {
  71    VAR, VAR, NIL, VAR,
  72    VAR, VAR, NIL, VAR,
  73    NIL, NIL, ONE, NIL,
  74    NIL, NIL, NIL, ONE
  75 };
  76 static int m_2d_no_rot[16] = {
  77    VAR, NIL, NIL, VAR,
  78    NIL, VAR, NIL, VAR,
  79    NIL, NIL, ONE, NIL,
  80    NIL, NIL, NIL, ONE
  81 };
  82 static int m_3d[16] = {
  83    VAR, VAR, VAR, VAR,
  84    VAR, VAR, VAR, VAR,
  85    VAR, VAR, VAR, VAR,
  86    NIL, NIL, NIL, ONE
  87 };
  88 static int m_3d_no_rot[16] = {
  89    VAR, NIL, NIL, VAR,
  90    NIL, VAR, NIL, VAR,
  91    NIL, NIL, VAR, VAR,
  92    NIL, NIL, NIL, ONE
  93 };
  94 static int m_perspective[16] = {
  95    VAR, NIL, VAR, NIL,
  96    NIL, VAR, VAR, NIL,
  97    NIL, NIL, VAR, VAR,
  98    NIL, NIL, NEG, NIL
  99 };
 100 static int *templates[7] = {
 101    m_general,
 102    m_identity,
 103    m_3d_no_rot,
 104    m_perspective,
 105    m_2d,
 106    m_2d_no_rot,
 107    m_3d
 108 };
 109 static int mtypes[7] = {
 110    MATRIX_GENERAL,
 111    MATRIX_IDENTITY,
 112    MATRIX_3D_NO_ROT,
 113    MATRIX_PERSPECTIVE,
 114    MATRIX_2D,
 115    MATRIX_2D_NO_ROT,
 116    MATRIX_3D
 117 };
 118 static char *mstrings[7] = {
 119    "MATRIX_GENERAL",
 120    "MATRIX_IDENTITY",
 121    "MATRIX_3D_NO_ROT",
 122    "MATRIX_PERSPECTIVE",
 123    "MATRIX_2D",
 124    "MATRIX_2D_NO_ROT",
 125    "MATRIX_3D"
 126 };
 127
 128
 129 /* ================================================================
 130  * Reference transformations
 131  */
 132
 133 static void ref_transform( GLvector4f *dst,
 134                            const GLmatrix *mat,
 135                            const GLvector4f *src,
 136                            const GLubyte *clipmask,
 137                            const GLubyte flag )
 138 {
 139    GLuint i;
 140    GLfloat *s = (GLfloat *)src->start;
 141    GLfloat (*d)[4] = (GLfloat (*)[4])dst->start;
 142    const GLfloat *m = mat->m;
 143
 144    (void) clipmask;
 145    (void) flag;
 146
 147    for ( i = 0 ; i < src->count ; i++ ) {
 148       TRANSFORM_POINT( d[i], m, s );
 149       s = (GLfloat *)((char *)s + src->stride);
 150    }
 151 }
 152
 153
 154 /* ================================================================
 155  * Vertex transformation tests
 156  */
 157
 158 static GLfloat s[TEST_COUNT][5] ALIGN16;
 159 static GLfloat d[TEST_COUNT][4] ALIGN16;
 160 static GLfloat r[TEST_COUNT][4] ALIGN16;
 161
 162 static int test_transform_function( transform_func func, int psize, int mtype,
 163                                     int masked, long *cycles )
 164 {
 165    GLvector4f source[1], dest[1], ref[1];
 166    GLmatrix mat[1];
 167    GLfloat *m;
 168    GLubyte mask[TEST_COUNT];
 169    int i, j;
 170 #ifdef  RUN_DEBUG_BENCHMARK
 171    int cycle_i;                /* the counter for the benchmarks we run */
 172 #endif
 173
 174    (void) cycles;
 175
 176    if ( psize > 4 ) {
 177       _mesa_problem( NULL, "test_transform_function called with psize > 4\n" );
 178       return 0;
 179    }
 180
 181    mat->m = (GLfloat *) ALIGN_MALLOC( 16 * sizeof(GLfloat), 16 );
 182    mat->type = mtypes[mtype];
 183
 184    m = mat->m;
 185
 186    init_matrix( m );
 187
 188    for ( i = 0 ; i < 4 ; i++ ) {
 189       for ( j = 0 ; j < 4 ; j++ ) {
 190          switch ( templates[mtype][i * 4 + j] ) {
 191          case NIL:
 192             m[j * 4 + i] = 0.0;
 193             break;
 194          case ONE:
 195             m[j * 4 + i] = 1.0;
 196             break;
 197          case NEG:
 198             m[j * 4 + i] = -1.0;
 199             break;
 200          case VAR:
 201             break;
 202          default:
 203             abort();
 204          }
 205       }
 206    }
 207
 208    for ( i = 0 ; i < TEST_COUNT ; i++) {
 209       mask[i] = i % 2;                          /* mask every 2nd element */
 210       ASSIGN_4V( d[i], 0.0, 0.0, 0.0, 1.0 );
 211       ASSIGN_4V( s[i], 0.0, 0.0, 0.0, 1.0 );
 212       for ( j = 0 ; j < psize ; j++ )
 213          s[i][j] = rnd();
 214    }
 215
 216    source->data = (GLfloat(*)[4])s;
 217    source->start = (GLfloat *)s;
 218    source->count = TEST_COUNT;
 219    source->stride = sizeof(s[0]);
 220    source->size = 4;
 221    source->flags = 0;
 222
 223    dest->data = (GLfloat(*)[4])d;
 224    dest->start = (GLfloat *)d;
 225    dest->count = TEST_COUNT;
 226    dest->stride = sizeof(float[4]);
 227    dest->size = 0;
 228    dest->flags = 0;
 229
 230    ref->data = (GLfloat(*)[4])r;
 231    ref->start = (GLfloat *)r;
 232    ref->count = TEST_COUNT;
 233    ref->stride = sizeof(float[4]);
 234    ref->size = 0;
 235    ref->flags = 0;
 236
 237    ref_transform( ref, mat, source, NULL, 0 );
 238
 239    if ( mesa_profile ) {
 240       if ( masked ) {
 241          BEGIN_RACE( *cycles );
 242          func( dest, mat->m, source, mask, 1 );
 243          END_RACE( *cycles );
 244       } else {
 245          BEGIN_RACE( *cycles );
 246          func( dest, mat->m, source, NULL, 0 );
 247          END_RACE( *cycles );
 248      }
 249    }
 250    else {
 251       if ( masked ) {
 252          func( dest, mat->m, source, mask, 1 );
 253       } else {
 254          func( dest, mat->m, source, NULL, 0 );
 255       }
 256    }
 257
 258    for ( i = 0 ; i < TEST_COUNT ; i++ ) {
 259       if ( masked && (mask[i] & 1) )
 260          continue;
 261
 262       for ( j = 0 ; j < 4 ; j++ ) {
 263          if ( significand_match( d[i][j], r[i][j] ) < REQUIRED_PRECISION ) {
 264             printf( "-----------------------------\n" );
 265             printf( "(i = %i, j = %i)\n", i, j );
 266             printf( "%f \t %f \t [diff = %e - %i bit missed]\n",
 267                     d[i][0], r[i][0], r[i][0]-d[i][0],
 268                     MAX_PRECISION - significand_match( d[i][0], r[i][0] ) );
 269             printf( "%f \t %f \t [diff = %e - %i bit missed]\n",
 270                     d[i][1], r[i][1], r[i][1]-d[i][1],
 271                     MAX_PRECISION - significand_match( d[i][1], r[i][1] ) );
 272             printf( "%f \t %f \t [diff = %e - %i bit missed]\n",
 273                     d[i][2], r[i][2], r[i][2]-d[i][2],
 274                     MAX_PRECISION - significand_match( d[i][2], r[i][2] ) );
 275             printf( "%f \t %f \t [diff = %e - %i bit missed]\n",
 276                     d[i][3], r[i][3], r[i][3]-d[i][3],
 277                     MAX_PRECISION - significand_match( d[i][3], r[i][3] ) );
 278             return 0;
 279          }
 280       }
 281    }
 282
 283    ALIGN_FREE( mat->m );
 284    return 1;
 285 }
 286
 287 void _math_test_all_transform_functions( char *description )
 288 {
 289    int masked, psize, mtype;
 290    long benchmark_tab[2][4][7];
 291    static int first_time = 1;
 292
 293    if ( first_time ) {
 294       first_time = 0;
 295       mesa_profile = getenv( "MESA_PROFILE" );
 296    }
 297
 298 #ifdef RUN_DEBUG_BENCHMARK
 299    if ( mesa_profile ) {
 300       if ( !counter_overhead ) {
 301          INIT_COUNTER();
 302          printf( "counter overhead: %ld cycles\n\n", counter_overhead );
 303       }
 304       printf( "transform results after hooking in %s functions:\n", description );
 305    }
 306 #endif
 307
 308    for ( masked = 0 ; masked <= 1 ; masked++ ) {
 309       int cma = masked ? 1 : 0;
 310       char *cmastring = masked ? "CULL_MASK_ACTIVE" : "0";
 311
 312 #ifdef RUN_DEBUG_BENCHMARK
 313       if ( mesa_profile ) {
 314          printf( "\n culling: %s \n", masked ? "CULL_MASK_ACTIVE" : "0" );
 315          for ( psize = 1 ; psize <= 4 ; psize++ ) {
 316             printf( " p%d\t", psize );
 317          }
 318          printf( "\n--------------------------------------------------------\n" );
 319       }
 320 #endif
 321
 322       for ( mtype = 0 ; mtype < 7 ; mtype++ ) {
 323          for ( psize = 1 ; psize <= 4 ; psize++ ) {
 324             transform_func func = _mesa_transform_tab[cma][psize][mtypes[mtype]];
 325             long *cycles = &(benchmark_tab[cma][psize-1][mtype]);
 326
 327             if ( test_transform_function( func, psize, mtype,
 328                                           masked, cycles ) == 0 ) {
 329                char buf[100];
 330                sprintf( buf, "_mesa_transform_tab[%s][%d][%s] failed test (%s)",
 331                         cmastring, psize, mstrings[mtype], description );
 332                _mesa_problem( NULL, buf );
 333             }
 334 #ifdef RUN_DEBUG_BENCHMARK
 335             if ( mesa_profile )
 336                printf( " %li\t", benchmark_tab[cma][psize-1][mtype] );
 337 #endif
 338          }
 339 #ifdef RUN_DEBUG_BENCHMARK
 340          if ( mesa_profile )
 341             printf( " | [%s]\n", mstrings[mtype] );
 342 #endif
 343       }
 344 #ifdef RUN_DEBUG_BENCHMARK
 345       if ( mesa_profile )
 346          printf( "\n" );
 347 #endif
 348    }
 349 }
 350
 351
 352 #endif /* DEBUG */