home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / raytrace.sit / docs < prev    next >
Encoding:
Text File  |  1988-11-13  |  2.2 KB  |  60 lines
  1. TRACER(99)                  FRITZZ GRAPHICS            TRACER(99)
  2.  
  3.  
  4.  
  5. NAME
  6.      tracer- run a simple ray tracing procedure
  7.  
  8. SYNOPSIS
  9.      tracer -o [filename] -i [filename] -s <filename> -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.      -o Chooses the output data file. If no argument is givin, stdout
  22.         is used. If the option is not used the default is data.dis.
  23.  
  24.      -i Chooses the input (ball) data file. If no argument is given, stdin
  25.         is used. If the option is not used the default is bdata.i.
  26.  
  27.      -s Chooses the file containing the tiling bitmap. It requires an
  28.         an argument. If the option is not used the default is pat.def.
  29.  
  30.      -S Chooses contrast of the pattern. 0.0 is no contrast, 1.0 is maximum
  31.         contrast. 1.0 is the default. (useful for fading during animation)
  32.  
  33. PROGRAM NOTES
  34.      This program generates a file containing a header with x and y sizes,
  35.      followed by the data in 8-bit greyscale, one pixel to a character, in 
  36.      scanlines.
  37.      There are two neccessary input files: ball data, and a pattern bitmap.
  38.      The tiling bitmap can be digitized data, it must be in the form of 
  39.      scan lines no longer than 512 bytes followed by newlines.
  40.      the ball data is of the following form:
  41.  
  42.      x y z rad ior refract reflect diffuse ambient
  43.  
  44.      on each line where x y & z are the coordinates of the center of 
  45.      the ball, rad is the radius of the ball, ior is the index of refraction
  46.      for translucent materials (index of refraction for glass is about 1.5)
  47.      the last four numbers determine how much of each atrribute is used.
  48.      Thus a pure silver ball would have 0.0 1.0 0.0 0.0 as the last numbers,
  49.      and a pure glass ball would have 1.0 0.0 0.0 0.0 .
  50.  
  51.  
  52. FILES
  53.      ./bdata.i    default ball data
  54.      ./pat.def  default floor pattern
  55.      ./data.dis default output file
  56.  
  57. BUGS
  58.      As with any good software, the complexity of this program hides 
  59.      all bugs.
  60.