progs/samples/README

   1 /*
   2  * Copyright (c) 1991, 1992, 1993 Silicon Graphics, Inc.
   3  *
   4  * Permission to use, copy, modify, distribute, and sell this software and
   5  * its documentation for any purpose is hereby granted without fee, provided
   6  * that (i) the above copyright notices and this permission notice appear in
   7  * all copies of the software and related documentation, and (ii) the name of
   8  * Silicon Graphics may not be used in any advertising or
   9  * publicity relating to the software without the specific, prior written
  10  * permission of Silicon Graphics.
  11  *
  12  * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF
  13  * ANY KIND,
  14  * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  15  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  16  *
  17  * IN NO EVENT SHALL SILICON GRAPHICS BE LIABLE FOR
  18  * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  19  * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  20  * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
  21  * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  22  * OF THIS SOFTWARE.
  23  */
  24
  25 accum - Accumulation test.
  26     - RGBA, SB/DB (SB default).
  27     - cmd line options:
  28         -sb     Single buffer mode.
  29         -db     Double buffer mode.
  30     - keys:
  31         ESC     Quit
  32         1       Use filled polygon mode.
  33         2       Use outlined polygon mode.
  34
  35 bitmap1 - Bitmap test.
  36     - RGBA/CI (RGBA default), SB/DB (SB default).
  37     - cmd line options:
  38         -rgb    RGBA mode.
  39         -ci     Color index mode.
  40         -sb     Single buffer mode.
  41         -db     Double buffer mode.
  42     - keys:
  43         ESC     Quit.
  44
  45 bitmap2 - Bitmap test.
  46     - RGBA/CI (RGBA default), SB/DB (SB default).
  47     - cmd line options:
  48         -rgb    RGBA mode.
  49         -ci     Color index mode.
  50         -sb     Single buffer mode.
  51         -db     Double buffer mode.
  52     - keys:
  53         ESC     Quit.
  54         1       Toggle display list mode.
  55         2       Toggle color animation mode.
  56
  57 copy - Pixel copy test.
  58     - RGBA, SB/DB (SB default).
  59     - cmd line options:
  60         -sb             Single buffer mode.
  61         -db             Double buffer mode.
  62         -dr             Direct render mode.
  63         -ir             Indirect render mode.
  64         -f <file name>  RGB image file.
  65     - keys:
  66         ESC             Quit.
  67         Z               Increase zoom factor.
  68         z               Decrease zoom factor.
  69     - mouse input:
  70         Left            Copy location.
  71
  72 cursor - Cursor test.
  73     - RGBA/CI (RGBA default), SB/DB (SB default).
  74     - cmd line options:
  75         -rgb    RGBA mode.
  76         -ci     Color index mode.
  77         -sb     Single buffer mode.
  78         -db     Double buffer mode.
  79     - keys:
  80         ESC     Quit.
  81         SPACE   switch cursor color.
  82
  83 depth - Z buffer test.
  84     - RGBA/CI (RGBA default), SB/DB (SB default).
  85     - cmd line options:
  86         -rgb    RGBA mode.
  87         -ci     Color index mode.
  88         -sb     Single buffer mode.
  89         -db     Double buffer mode.
  90     - keys:
  91         ESC     Quit.
  92         1       Toggle anti-aliased mode.
  93         2       Toggle stipple mode.
  94
  95 eval - Evaluator test.
  96     - RGBA, SB/DB (SB default).
  97     - cmd line options:
  98         -sb     Single buffer mode.
  99         -db     Double buffer mode.
 100     - keys:
 101         ESC     Quit.
 102         LEFT    Rotate.
 103         RIGHT   Rotate.
 104         UP      Rotate.
 105         DOWN    Rotate.
 106         1       Toggle dimensions.
 107         2       Toggle dimensions.
 108         e       Use eval mode.
 109         m       Use mesh mode.
 110         f       Toggle polygon mode.
 111         p       Toggle point mode.
 112         c       Toggle color mode.
 113         t       Toggle texture mode.
 114         l       Toggle lighting mode.
 115
 116 fog - Fog test.
 117     - RGBA/CI (RGBA default), SB/DB (SB default).
 118     - cmd line options:
 119         -rgb    RGBA mode.
 120         -ci     Color index mode.
 121         -sb     Single buffer mode.
 122         -db     Double buffer mode.
 123     - keys:
 124         ESC     Quit.
 125         LEFT    Rotate.
 126         RIGHT   Rotate.
 127         UP      Rotate.
 128         DOWN    Rotate.
 129         D       Increase fog density.
 130         d       Decrease fog density.
 131
 132 font - font test.
 133     - RGBA/CI (RGBA default), SB/DB (SB default).
 134     - cmd line options:
 135         -rgb    RGBA mode.
 136         -ci     Color index mode.
 137         -sb     Single buffer mode.
 138         -db     Double buffer mode.
 139     - keys:
 140         ESC     Quit.
 141         Left    Shift left.
 142         Right   Shift right.
 143         Up      Shift up.
 144         Down    Shift down.
 145         n       Shift in.
 146         m       Shift out.
 147         q       Scale up x.
 148         w       Scale down x.
 149         a       Scale up y.
 150         s       Scale down y.
 151         z       Scale up z.
 152         x       Scale down z.
 153         e       Rotate clockwise x.
 154         r       Rotate counter-clockwise x.
 155         d       Rotate clockwise y.
 156         f       Rotate counter-clockwise y.
 157         c       Rotate clockwise z.
 158         v       Rotate counter-clockwise z.
 159
 160 line - Line test.
 161     - RGBA/CI (RGBA default), SB/DB (SB default).
 162     - cmd line options:
 163         -rgb    RGBA mode.
 164         -ci     Color index mode.
 165         -sb     Single buffer mode.
 166         -db     Double buffer mode.
 167     - keys:
 168         ESC     Quit.
 169         W       Increase line width.
 170         w       Decrease line width.
 171         1       Toggle stipple mode.
 172         2       Toggle anti-aliased mode.
 173
 174 logo - Demo.
 175     - RGBA/CI (RGBA default), SB/DB (SB default).
 176     - cmd line options:
 177         -rgb    RGBA mode.
 178         -ci     Color index mode.
 179         -sb     Single buffer mode.
 180         -db     Double buffer mode.
 181     - keys:
 182         ESC     Quit.
 183         LEFT    Rotate.
 184         RIGHT   Rotate
 185         UP      Move clipping plane.
 186         DOWN    Move clipping plane.
 187         Z       Translate.
 188         z       Translate.
 189         1       Use GL_POINT polygon mode.
 190         2       Use GL_LINE polygon mode.
 191         3       Use GL_FILL polygon mode.
 192         p       Toggle polygon fill modes.
 193         4       Use GL_NICEST for GL_POLYGON_SMOOTH_HINT.
 194         5       Use anti-aliased polygon mode.
 195         6       Use aliased polygon mode.
 196         8       Toggle dither mode.
 197         9       Toggle stipple polygon mode.
 198         0       Toggle flat/smooth shading mode.
 199         q       Disable cull mode.
 200         w       Use front face cull mode.
 201         e       Use back face cull mode.
 202         r       Use clockwise front face mode.
 203         t       Use counter-clockwise front face mode.
 204         y       Use MSB first stipple pattern.
 205         u       Use LSB first stipple pattern.
 206         a       Use brick texture map.
 207         s       Use checker texture map.
 208         d       Disable texture map.
 209         f       Use decal texture environment mode.
 210         g       Use modulate texture environment mode.
 211
 212 nurb - Nurb test.
 213     - RGBA, SB/DB (SB default).
 214     - cmd line options:
 215         -sb     Single buffer mode.
 216         -db     Double buffer mode.
 217     - keys:
 218         ESC     Quit.
 219         LEFT    Rotate.
 220         RIGHT   Rotate.
 221         UP      Rotate.
 222         DOWN    Rotate.
 223
 224 olympic - Olymipic rings demo.
 225     - RGBA/CI (RGBA default), SB/DB (SB default).
 226     - cmd line options:
 227         -rgb    RGBA mode.
 228         -ci     Color index mode.
 229         -sb     Single buffer mode.
 230         -db     Double buffer mode.
 231     - keys:
 232         ESC     Quit.
 233         SPACE   Restart demo.
 234
 235 overlay - Overlay plane demo.
 236     - RGBA, SB/DB (SB default).
 237     - cmd line options:
 238         -sb     Single buffer mode.
 239         -db     Double buffer mode.
 240     - keys:
 241         ESC     Quit.
 242         SPACE   Toggle star weird movement mode.
 243         t       Toggle star turbo mode.
 244
 245 point - Point test.
 246     - RGBA/CI (RGBA default), SB/DB (SB default).
 247     - cmd line options:
 248         -rgb    RGBA mode.
 249         -ci     Color index mode.
 250         -sb     Single buffer mode.
 251         -db     Double buffer mode.
 252     - keys:
 253         ESC     Quit.
 254         LEFT    Translate.
 255         RIGHT   Translate.
 256         UP      Translate.
 257         DOWN    Translate.
 258         W       Increase point width.
 259         w       Decrease point width.
 260         1       Toggle anti-aliased mode.
 261
 262 prim - Primitive test.
 263     - RGBA/CI (RGBA default), SB/DB (SB default).
 264     - cmd line options:
 265         -rgb    RGBA mode.
 266         -ci     Color index mode.
 267         -sb     Single buffer mode.
 268         -db     Double buffer mode.
 269     - keys:
 270         ESC     Quit.
 271         1       Toggle flat/smooth shade mode.
 272         2       Toggle outlined/filled polygon mode.
 273         3       Toggle color mask mode.
 274
 275 quad - Quadric test.
 276     - RGBA/CI (RGBA default), SB/DB (SB default).
 277     - cmd line options:
 278         -rgb            RGBA mode.
 279         -ci             Color index mode.
 280         -sb             Single buffer mode.
 281         -db             Double buffer mode.
 282         -dr             Direct render mode.
 283         -ir             Indirect render mode.
 284         -f <file name>  texture file.
 285     - keys:
 286         ESC             Quit.
 287         LEFT            Rotate.
 288         RIGHT           Rotate.
 289         UP              Rotate.
 290         DOWN            Rotate.
 291         X               Rotate.
 292         x               Rotate.
 293         1               Use GLU_FILL draw style.
 294         2               Use GLU_POINT draw style.
 295         3               Use GLU_LINE draw style.
 296         4               Use GLU_SILHOUETTE draw style.
 297         0               Toggle flat/smooth shade mode.
 298         f               Cylce through quadrics.
 299         d               Toggle orientation.
 300         A               Increase number of stacks.
 301         a               Decrease number of stacks.
 302         S               Increase number of slices.
 303         s               Decrease number of slices.
 304         G               Increase radius1.
 305         g               Decrease radius1.
 306         J               Increase radius2.
 307         j               Decrease radius2.
 308         H               Increase height.
 309         h               Decrease height.
 310         K               Increase angle1.
 311         k               Decrease angle1.
 312         L               Increase angle2.
 313         l               Decrease angle2.
 314         z               Toggle texture mode.
 315         q               Disable cull mode.
 316         w               Use front face cull mode.
 317         e               Use back face cull mode.
 318         r               Use clockwise front face mode.
 319         t               Use counter-clockwise front face mode.
 320         y               Toggle dither mode.
 321
 322 select - Selection test.
 323     - RGBA, SB.
 324     - cmd line options:
 325     - keys:
 326         ESC     Quit.
 327         LEFT    Rotate.
 328         RIGHT   Rotate.
 329         Z       Increase zoom factor.
 330         z       Decrease zoom factor.
 331         d       Zoom at current mouse location.
 332         f       Print feedback information.
 333         l       Toggle outlined/filled polygon mode.
 334     - mouse:
 335         Left    Recolor selected triangle.
 336         Center  Enlarge selected triangle.
 337         Right   Delete selected triangle.
 338
 339 shape - shape test.
 340     - RGBA/CI (RGBA default), SB/DB (SB default).
 341     - cmd line options:
 342         -rgb    RGBA mode.
 343         -ci     Color index mode.
 344         -sb     Single buffer mode.
 345         -db     Double buffer mode.
 346     - keys:
 347         ESC     Quit.
 348         Left    Shift left.
 349         Right   Shift right.
 350         Up      Shift up.
 351         Down    Shift down.
 352         n       Shift in.
 353         m       Shift out.
 354         q       Scale up x.
 355         w       Scale down x.
 356         a       Scale up y.
 357         s       Scale down y.
 358         z       Scale up z.
 359         x       Scale down z.
 360         e       Rotate clockwise x.
 361         r       Rotate counter-clockwise x.
 362         d       Rotate clockwise y.
 363         f       Rotate counter-clockwise y.
 364         c       Rotate clockwise z.
 365         v       Rotate counter-clockwise z.
 366         SPACE   switch shapes.
 367
 368 speed - Speed test.
 369     - RGBA/CI (RGBA default), SB/DB (SB default).
 370     - cmd line options:
 371         -rgb    RGBA mode.
 372         -ci     Color index mode.
 373         -sb     Single buffer mode.
 374         -db     Double buffer mode.
 375     - keys:
 376         ESC     Quit.
 377         a       Toggle anti-aliased mode.
 378         d       Toggle z buffering mode.
 379         f       Toggle fog mode.
 380         F       Toggle fog hint mode.
 381         s       Toggle flat/smooth shading mode.
 382         t       Toggle texturing mode.
 383
 384 sphere - Spheremap test.
 385     - RGBA, SB/DB (SB default).
 386     - cmd line options:
 387         -sb             Single buffer mode.
 388         -db             Double buffer mode.
 389         -dr             Direct render mode.
 390         -ir             Indirect render mode.
 391         -f <file name>  texture file.
 392         -3              Use RGB components.
 393         -4              Use RGBA components.
 394     - keys:
 395         ESC             Quit.
 396         LEFT            Rotate about the y axis.
 397         RIGHT           Rotate about the y axis.
 398         UP              Rotate about the x axis.
 399         DOWN            Rotate about the x axis.
 400         a               Toggle auto rotate mode.
 401         c               toggle between cylinder or cube object.
 402         t               Use torus object.
 403         d               Use decal texture mode.
 404         m               Use modulate texture mode.
 405         l               Toggle lighted mode.
 406         f               Toggle fog mode.
 407         0               Use nearest magification filter.
 408         1               Use linear magification.
 409         2               Use nearest minification filter.
 410         3               Use linear minification filter.
 411         4               Use nearest-mipmap-nearest minification filter.
 412         5               Use nearest-mipmap-linear minification filter.
 413         6               Use linear-mipmap-nearest minification filter.
 414         7               Use linear-mipmap-linear minification filter.
 415
 416 star - Demo.
 417     - RGBA, SB/DB (SB default).
 418     - cmd line options:
 419         -sb     Single buffer mode.
 420         -db     Double buffer mode.
 421     - keys:
 422         ESC     Quit.
 423         SPACE   Toggle weird movement mode.
 424         t       Toggle turbo mode.
 425
 426 stencil - Stencil test.
 427     - RGBA, SB.
 428     - cmd line options:
 429
 430 stretch - Texture test.
 431     - RGBA, SB.
 432     - cmd line options:
 433         -sb             Single buffer mode.
 434         -db             Double buffer mode.
 435         -dr             Direct render mode.
 436         -ir             Indirect render mode.
 437         -f <file name>  texture file.
 438     - keys:
 439         ESC             Quit.
 440         SPACE           Start animation.
 441     - mouse:
 442         Left            Added stretch point.
 443
 444 texture - Texture test.
 445     - RGBA, SB/DB (SB default).
 446     - cmd line options:
 447         -sb             Single buffer mode.
 448         -db             Double buffer mode.
 449         -dr             Direct render mode.
 450         -ir             Indirect render mode.
 451         -f <file name>  texture file.
 452     - keys:
 453         ESC             Quit.
 454         LEFT            Rotate.
 455         RIGHT           Rotate.
 456         UP              Rotate.
 457         DOWN            Rotate.
 458         T               Translate.
 459         t               Translate.
 460         s               Toggle sphere map mode.
 461         0               Use nearest magification filter.
 462         1               Use linear magification filter.
 463         2               Use nearest minification filter.
 464         3               Use linear minification filter.
 465         4               Use nearest-mipmap-nearest minification filter.
 466         5               Use nearest-mipmap-linear minification filter.
 467         6               Use linear-mipmap-nearest minification filter.
 468         7               Use linear-mipmap-linear minification filter.
 469
 470 tri - Triangle test.
 471     - RGBA/CI (RGBA default), SB/DB (SB default).
 472     - cmd line options:
 473         -rgb    RGBA mode.
 474         -ci     Color index mode.
 475         -sb     Single buffer mode.
 476         -db     Double buffer mode.
 477     - keys:
 478         ESC     Quit.
 479         LEFT    Translate.
 480         RIGHT   Translate.
 481         Z       Increase zoom factor.
 482         z       Decrease zoom factor.
 483         1       Use point polygon mode.
 484         2       Use line polygon mode.
 485         3       Use filled polygon mode.
 486         4       Use point primitive.
 487         5       Use line-loop primitive.
 488         6       Use polygon primitive.
 489         7       Toggle cull mode.
 490         8       Use clockwise/counter-clockwise front face mode.
 491         9       Toggle front/back face cull mode.
 492         v       Toggle show verticies mode.
 493         s       Toggle flat/smooth shade mode.
 494         h       Toggle hide bottom triangle mode.
 495         o       Toggle outline mode.
 496         m       Toggle dither mode.
 497         0       Toggle anti-aliased mode.
 498
 499 wave - Demo.
 500     - RGBA/CI (RGBA default), SB/DB (SB default).
 501     - cmd line options:
 502         -rgb            RGBA mode.
 503         -ci             Color index mode.
 504         -sb             Single buffer mode.
 505         -db             Double buffer mode.
 506         -dr             Direct render mode.
 507         -ir             Indirect render mode.
 508         -grid <x> <y>   Number of grids.
 509         -size <number>  Size of grid.
 510         -wave <number>  Height of wave (floating point number).
 511         -frames <count> Number of frames.
 512     - keys:
 513         ESC             Quit.
 514         c               Toggle contouring mode.
 515         s               Toggle flat/smooth shade mode.
 516         l               Toggle lighting mode.
 517         d               Toggle depth checking mode.
 518         SPACE           Toggle step/animation mode.
 519         n               Single step in step mode.
 520         a               Toggle spin mode.