home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 2000 April & May / AMIGA_2000_04.iso / patches / mesa3.1 / samples / readme < prev    next >
Text File  |  1999-08-18  |  13KB  |  521 lines
  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.
  521.