home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / fractrace / !FracTrace / FTS-Def < prev    next >
Text File  |  1990-07-22  |  16KB  |  334 lines
  1. FracTrace Script (FTS) command descriptions
  2. -------------------------------------------
  3.  
  4. An FTS file is a plain ASCII text file containing the commands and their
  5. right parameters to describe a fractal surface and its rendering in 
  6. FracTrace.
  7.  
  8. Lines may contain : - a single command
  9.                     - multiple commands, separated by a semi-colon ';'
  10.                     - comments, preceded by a back-slash '\'
  11.                     - the combination of both commands and comments
  12.  
  13. Some good examples of FTS files can be found in the 'FTS-Files' directory.
  14.  
  15. A description of each individual command follows underneath:
  16.  
  17.  
  18. Command              Description
  19. -----------------------------------------------------------------------------
  20. Title                Sets the title for the current surface(s). This title is
  21.                      used for all file-handling. A string of maximum eight
  22.                      characters is given as the sole parameter.
  23.                      Example: Title Snowy
  24.  
  25. Frames               Sets the maximum number of 'frames'. The parameter is an
  26.                      integer. 
  27.                      Example: Frames 24
  28.  
  29. Scope                Sets the range of frames to be rendered. If you have set
  30.                      the maximum number of frames to, say 24, it is possible
  31.                      to set the range of frames to be rendered to any
  32.                      interval within 1..24. The two parameters are the 
  33.                      minimum and maximum frame number.
  34.                      Example: Scope 3,18
  35.  
  36. Mandelbrot           Tells the program that the set to be used is the
  37.                      Mandelbrot Set. This command takes no parameters.
  38.  
  39. Julia                Tells the program that the set to be used is a Julia
  40.                      Set. This command takes no parameters.
  41.  
  42. Resolution           Sets the resolution of the surface to be calculated and/
  43.                      or rendered. The units for this resolution may be 
  44.                      regarded as pixels. The two parameters are the x and y 
  45.                      resolution of the surface.
  46.                      Example: Resolution 300,300
  47.  
  48. Range                Sets the range in the complex plane for the part of the
  49.                      set that is to be calculated and/or rendered. The four
  50.                      parameters are minimum x, maximum x (real axis), minimum
  51.                      y, maximum y (imaginary axis). These values can best be
  52.                      obtained from a normal Mandelbrot plotting program!
  53.                      Example: Range -1.5,1.5,-1.5,1.5
  54.  
  55. Cval                 Sets the real and imaginary part of the point to 
  56.                      calculate and/or render the Julia Set of. The two 
  57.                      parameters are the real and imaginary part of the point.
  58.                      Example: Cval 0.32,0.043
  59.  
  60. Smoothness           Sets the smoothness of the surface. The higher the
  61.                      smoothness-value, the smoother the surface, and the more
  62.                      calculations will be performed to obtain the potential 
  63.                      of a point on the surface! The sole parameter is an
  64.                      integer, which really should be at least about 100!
  65.                      Example: Smoothness 120
  66.  
  67. Depth                Sets the depth of the iterations in the calculation of 
  68.                      the potential of a point. The higher the value, the more
  69.                      precise the set will be calculated, and again, the 
  70.                      longer it takes to calculate a point-potential. The 
  71.                      parameter is an integer in the range 1..127!!!
  72.                      Example: Depth 100
  73.  
  74. Mountains            Tells the program to render the surface as a mountain.
  75.                      This command takes no parameters.
  76.  
  77. Valleys              Tells the program to render the surface as a valley.
  78.                      This command takes no parameters.
  79.  
  80. Light                Sets the direction of the light-vector. This vector
  81.                      need not be normalised. Note that this vector is the
  82.                      direction of the light-rays, ie. it points away from the
  83.                      light source! The three parameters are the x, y, and z
  84.                      components of the vector. (z always should be negative!)
  85.                      Example: Light 0.5,1,-2        
  86.  
  87. Brightness           Sets the brightness of the light-source. The higher the
  88.                      value, the brighter the light. The sole parameter is an
  89.                      integer.
  90.                      Example: Brightness 78
  91.  
  92. Steepness            Sets the steepness of the mountain/valley slopes. The
  93.                      higher the value, the steeper the slopes. Note that the
  94.                      magnitude of this value is disproportional with size of
  95.                      the region indicated with the range command. The sole
  96.                      parameter is an integer.
  97.                      Example: Steepness 240
  98.  
  99. Dithering            Sets the color-dithering factor. Because the program
  100.                      only uses 16 colors to render an image (due to the 4bit
  101.                      nature of mode 12), abrupt color changes on the surface
  102.                      may give a non-realistic feel to the image. Therefore,
  103.                      a simple technique, called random dithering, is used to
  104.                      produce intermediate 'pseudo-colors', which make the
  105.                      color changes seem quite continuous. A value of 1 means
  106.                      no color dithering. The sole parameter is an integer.
  107.                      Example: Dithering 16
  108.  
  109. Shadows              Tells the program wether to calculate shadows or not.
  110.                      The calculation of shadows slows down the rendering
  111.                      quite drastically. The parameter is a string of the form
  112.                      'On' or 'Off'.
  113.                      Example: Shadows On
  114.  
  115. Interpolation        Tells the program wether to interpolate values in the
  116.                      horizontal direction. Interpolating doubles the time 
  117.                      needed for rendering an image, but it produces more
  118.                      detail. An image created with interpolation off has
  119.                      'mode 9' resolution, whereas images created with
  120.                      interpolation on have a true 'mode 12' resolution.
  121.                      The parameter is a string of the form 'On' or 'Off'.
  122.                      Example: Interpolation Off
  123.  
  124. Offset               Sets the two 'screen offsets' for the image. A 
  125.                      horizontal offset of 0 would place the image to the left
  126.                      edge of the screen. A vertical offset of 0 would place
  127.                      the image half way below the bottom edge of the screen.
  128.                      Normally, the x (horizontal) offset should remain at 40,
  129.                      and the y (vertical) offset should vary between 240 and
  130.                      480, depending on the angle at which to view the 
  131.                      image. The two parameters are the x and y offsets.
  132.                      Example: Offset 40,380
  133.  
  134. Angle                Sets the viewing angles. The first value is the x angle,
  135.                      a value of 0 makes you look at the image 'head-on'.
  136.                      The second value is the y angle, which should be in the
  137.                      range 15..90 to get a meaningful view on the image, 30
  138.                      being a quite reasonable average. In the current 
  139.                      versions of FracTrace, the x angle is best kept at 0!
  140.                      The two parameters are the x and y viewing angles.
  141.                      Example: Angle 0,25
  142.  
  143. Increment            Sets the x and y 'OS-Unit' increment steps when 
  144.                      rendering the surface. These values are both best kept
  145.                      at 4!
  146.                      Example: Increment 4,4
  147.  
  148. Slope Front          Sets the front-slope range and steepness. For some 
  149.                      images it will be necessary to use this feature to avoid
  150.                      the artificial cut-off of the front-most edge of the
  151.                      surface. When