home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 001-099 / ff066.lzh / RayTracer / tracer.man < prev    next >
Text File  |  1987-04-12  |  5KB  |  109 lines
  1.  TRACER(69)                  FRITZZ GRAPHICS            TRACER(69)
  2.  
  3.  
  4.  
  5. NAME
  6.      tracer- run a simple ray tracing procedure
  7.  
  8. SYNOPSIS
  9.      tracer -r -o [file] -i [file] -p [file] -s <file> -a<number> -S<number>
  10.  
  11. DESCRIPTION
  12.      Tracer is a program developed originally to study how
  13.      ray tracing works, and was later modified to the present state
  14.      to make it more compatible for animated film production.
  15.  
  16.      It is capable of depicting a number of balls (up to 150)
  17.      and a plane that is covered with a tiling of any bitmapped picture.
  18.  
  19.  
  20. OPTIONS
  21.      -r If used, causes the output to be computed and output rotated 90
  22.     degrees counterclockwise.  Good for printing wide images.
  23.  
  24.      -o Chooses the output picture file. If the option is not used, the
  25.     default is tracer.pic.
  26.  
  27.      -i Chooses the input (ball) data file. If no argument is given, stdin
  28.         is used. If the option is not used the default is tracer.ball.
  29.  
  30.      -p Chooses the parameters data file.  If no argument is given, stdin
  31.     is used. If the option is not used, the default is tracer.param.
  32.  
  33.      -s Chooses the file containing the tiling bitmap. It requires an
  34.         an argument. If the option is not used the default is tracer.pat.
  35.  
  36.      -a Chooses level of antialiasing.  Value must be an integer from 1 to
  37.         9.  Determines number of subcells computed per pixel.  Default is 1.
  38.  
  39.      -S Chooses contrast of the pattern. 0.0 is no contrast, 1.0 is maximum
  40.         contrast. 1.0 is the default. (useful for fading during animation)
  41.  
  42. PROGRAM NOTES
  43.      This program generates an IFF file in 640 x 400, 16 color mode, use any
  44.      of the standard IFF viewers to examine the results.
  45.  
  46.      There are three necessary input files: ball data, the parameters file,
  47.      and a pattern bitmap.  The tiling bitmap can be digitized data, it must
  48.      be in the form of scan lines no longer than 512 bytes followed by newlines.
  49.      
  50.      The ball data is of the following form:
  51.  
  52.      x y z rad ior refract reflect diffuse ambient
  53.  
  54.      on each line where x y & z are the coordinates of the center of 
  55.      the ball, rad is the radius of the ball, ior is the index of refraction
  56.      for translucent materials (index of refraction for glass is about 1.5)
  57.      the last four numbers determine how much of each atrribute is used.
  58.      Thus a pure silver ball would have 0.0 1.0 0.0 0.0 as the last numbers,
  59.      and a pure glass ball would have 1.0 0.0 0.0 0.0 .
  60.  
  61.      The parameters file is of the following form:
  62.  
  63.      xmin xmax ymin ymax xpix ypix ar vpx vpy vpz lsx lsy lsz lsrad
  64.  
  65.      Here xmin, xmax, ymin, and ymax define the view port through which the
  66.      scene is computed.  The number of computed pixels in each axis are
  67.      determined by xpix and ypix.  The aspect ratio (ar), if positive, applies
  68.      to the final image.  If negative, it applies to each pixel.  In either 
  69.      case, the viewport is adjusted to fit entirely in the final image.  If
  70.      the aspect ratio is zero, the given viewport is divided into xpix*ypix
  71.      pixels and computed without further ado.  The location of the viewing
  72.      point is given by vpx, vpy, and vpz.  The light source position and
  73.      radius are in lsx, lsy, lsz, and lsrad.
  74.  
  75.      The antialiasing scheme merely breaks each pixel down into a square array
  76.      of subcells, computes the intensity of each, and uses the average of
  77.      their values as the value for the entire pixel.  For instance, an input
  78.      of "-a5" uses a 5 x 5 array of subcells.  This results in a remarkable
  79.      reduction of aliasing, at the expense of (in this case) 25 times longer
  80.      run time. ( warning: use only if you have alot of time on your hands )
  81.  
  82. FILES
  83.      tracer.pic        default output file
  84.      tracer.ball    default ball data
  85.      tracer.param    default parms file
  86.      tracer.pat        default floor pattern
  87.  
  88. AUTHORS
  89.      friedrich knauss        - original author
  90.      Steve Williams & Jim Horn  - added anti-aliasing and parameter files
  91.      Mark C Reichert        - added fast amiga math and IFF auto-save
  92.  
  93. BUGS
  94.      As with any good software, the complexity of this program hides 
  95.      all bugs.
  96.  
  97.      There is sometimes a bug which causes a divide by zero fault. This
  98.      occurs rarely due to some "bad" ball specifications. If you can find
  99.      the source of this, please try to find some way to let me ( mcr ) know
  100.      where the fault lies.
  101.  
  102.      Also, if you want to be able to do a ctrl-C to stop this program at
  103.      any point, you should run it directly for a cli, not from a shell
  104.      because most shells are not capable of passing on the break to their
  105.      subprocesses ( unless Matt Dillon has fixed that by the time you 
  106.      are reading this ).
  107.  
  108.  
  109.