home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / graphics / graphtal.lha / Graphtal / graphtal.readme < prev    next >
Text File  |  1993-09-05  |  4KB  |  140 lines
  1. Short: Trees,Plants...from grammars(rayshade)
  2.  
  3. DESCRIPTION
  4.      graphtal is a tool for manipulating  spT0L-systems  (context
  5.      free, table oriented L-systems with stochastic productions).
  6.      graphtal reads a file containing an L-system description and
  7.      starts  the interpretation. In addition, graphtal is able to
  8.      interpret the result graphically, producing different  kinds
  9.      of output.
  10.  
  11.      The main reference for the program is the book  The  Virtual
  12.      Laboratory:  The Algorithmic Beauty of Plants by P. Prusink-
  13.      iewicz and A. Lindenmayer. The language used in graphtal  is
  14.      different  from  the  one  in the book and will be described
  15.      completely in this document.
  16.  
  17.  
  18. DEVICE DRIVERS
  19.   EXAMPLE DEVICE
  20.      The example driver produces a ASCII dump of  the  primitives
  21.      generated.  It shows the easiest way to implement a driver.
  22.  
  23.   BBOX DEVICE
  24.      The bbox driver computes the bounding box and gives  a  hint
  25.      for  the viewing parameters of the objects defined by the L-
  26.      system description.  This is useful  for  the  flat  device,
  27.      which does no automatic view computations.
  28.  
  29.   LINE DEVICE (X11,AMIGA)
  30.      This driver generates a simple line drawing  of  the  object
  31.      defined  by  the  L-system.  Line  width,  color,  textures,
  32.      spheres, macros and library object are not supported by this
  33.      driver.  Viewing parameters are automatically set, when none
  34.      are provided by the user.
  35.  
  36.   WIRE DEVICE (X11,AMIGA)
  37.      The wire device driver draws a more realistic image  of  the
  38.      object  than line device. Not supported are colors, textures
  39.      and  library  objects.   Viewing  parameters  are  also  set
  40.      automatically, when none are provided.
  41.  
  42.   FLAT DEVICE
  43.      The flat device works with a z-buffer  algorithm,  which  is
  44.      able  to shade convex and concave polygons. Shading calcula-
  45.      tions are done with regard to the light  source  located  at
  46.      the  eyepoint.  The  driver does not depend on the number of
  47.      polygons, therefore even very large scenes  can  be  visual-
  48.      ized.  As a drawback of this feature, the viewing parameters
  49.      have to be provided by the user (use BBOX DEVICE  to  calcu-
  50.      late  them).  Textures and library objects are not supported
  51.      by this driver.  The output of the rendering process  is  an
  52.      image in ppm format (portable pixmap). 
  53.  
  54.  
  55.   RAYSHADE DEVICE
  56.      The rayshade device is the most complete of all the drivers.
  57.      It  generates  output for the raytracer rayshade. The driver
  58.      produces at least two output files:
  59.  
  60.      graphtal -d rayshade anExample.lsys
  61.      generates the files default.ray and default.ray.def
  62.  
  63.      graphtal -d rayshade -O anExample.ray
  64.      generates the files anExample.ray and anExample.ray.def.
  65.  
  66.      The file name.ray contains the  options  for  the  rendering
  67.      process  and  in  the name.ray.def file the geometric primi-
  68.      tives are stored.  For each macro definition,  the  rayshade
  69.      driver    produces    it's    own   file   with   the   name
  70.      macrName.ray.def. If library objects are used, a  file  with
  71.      the  name  libraryName.ray.lib  must be provided by the user
  72.      for each object.
  73.  
  74.  
  75. AUTHOR
  76.      Christoph Streit (streit@iam.unibe.ch)
  77.  
  78. AMIGA PORT
  79.      Lucas Ammon (lammon@iamexwi.unibe.ch)
  80.  
  81.  
  82. COPYRIGHT NOTICE
  83.      Copyright (C) 1992 Christoph Streit
  84.  
  85.      All rights reserved.
  86.  
  87.      This software may be freely copied, modified, and  redistri-
  88.      buted  provided  that  this copyright notice is preserved on
  89.      all copies.
  90.  
  91.      You may not distribute this software, in whole or  in  part,
  92.      as  part  of any commercial product without the express con-
  93.      sent of the authors.
  94.  
  95.      There is no warranty or other guarantee of fitness  of  this
  96.      software for any purpose.  It is provided solely "as is".
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                   Last change: October 27, 1992                16
  137.  
  138.  
  139.  
  140.