home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume5 / tracer / README.DOC < prev    next >
Encoding:
Text File  |  1989-02-03  |  2.2 KB  |  64 lines
  1.  
  2.  
  3.  
  4. TRACER(99)                  FRITZZ GRAPHICS            TRACER(99)
  5.  
  6.  
  7.  
  8. NAME
  9.      tracer- run a simple ray tracing procedure
  10.  
  11. SYNOPSIS
  12.      tracer -o [filename] -i [filename] -s <filename> -S<number>
  13.  
  14. DESCRIPTION
  15.      Tracer is a program developed originally to study how
  16.      ray tracing works, and was later modified to the present state
  17.      to make it more compatible for animated film production.
  18.  
  19.      It is capable of depicting a number of balls (up to 150)
  20.      and a plane that is covered with a tiling of any bitmapped picture.
  21.  
  22.  
  23. OPTIONS
  24.      -o Chooses the output data file. If no argument is givin, stdout
  25.         is used. If the option is not used the default is data.dis.
  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 bdata.i.
  29.  
  30.      -s Chooses the file containing the tiling bitmap. It requires an
  31.         an argument. If the option is not used the default is pat.def.
  32.  
  33.      -S Chooses contrast of the pattern. 0.0 is no contrast, 1.0 is maximum
  34.         contrast. 1.0 is the default. (useful for fading during animation)
  35.  
  36. PROGRAM NOTES
  37.      This program generates a file containing a header with x and y sizes,
  38.      followed by the data in 8-bit greyscale, one pixel to a character, in 
  39.      scanlines.
  40.      There are two neccessary input files: ball data, and a pattern bitmap.
  41.      The tiling bitmap can be digitized data, it must be in the form of 
  42.      scan lines no longer than 512 bytes followed by newlines.
  43.      the ball data is of the following form:
  44.  
  45.      x y z rad ior refract reflect diffuse ambient
  46.  
  47.      on each line where x y & z are the coordinates of the center of 
  48.      the ball, rad is the radius of the ball, ior is the index of refraction
  49.      for translucent materials (index of refraction for glass is about 1.5)
  50.      the last four numbers determine how much of each atrribute is used.
  51.      Thus a pure silver ball would have 0.0 1.0 0.0 0.0 as the last numbers,
  52.      and a pure glass ball would have 1.0 0.0 0.0 0.0 .
  53.  
  54.  
  55. FILES
  56.      ./bdata.i    default ball data
  57.      ./pat.def  default floor pattern
  58.      ./data.dis default output file
  59.  
  60. BUGS
  61.      As with any good software, the complexity of this program hides 
  62.      all bugs.
  63.  
  64.