home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / Raytracing / Tools / RIP_DUST.LHA / dust / dusthelp / Introduction < prev    next >
Encoding:
Text File  |  1995-03-08  |  1.8 KB  |  49 lines
  1.                           Introduction
  2. -----------------------------------------------------------------
  3.  
  4.  Dust operates on different kinds of structures:
  5.   objects, particle-objects, windows, textures and brushes.
  6.  
  7.  Every structure can be reached specifiing its identifier, there
  8.  are the following identifiers:
  9.   objectID, particleID, windowID, textureID and brushID.
  10.  
  11.  Dust is a kind of a programming language so it interpretes
  12.  commands, knows mathematical expressions, global variables
  13.  and can perform loops.
  14.  
  15.  All commands have an unique structure:
  16.   identifier([<argument1>[,<argument2>[,...]]]).
  17.  Identifiers are lower case, arguments enclosed in "[" and "]" are
  18.  optional.
  19.  
  20.  All numeric arguments can be omitted as mathematical expressions
  21.  containing global variables, rounding is done automatically, e.g.
  22.   "load(4/3,obj)" is identical to "load(1,obj)".
  23.  
  24.  You can define global variables using the CALC-command or the
  25.  online-calculator-mode, e.g.:
  26.   "calc("a=3*sin(46")".
  27.  
  28.  Strings, e.g. filenames can contain special format-characters.
  29.  If a Dust-command recognises such a format-character it inserts the
  30.  recent value of the loop-counter. The loop-counter is equal to the
  31.  loop-variable of the innerst FOR-loop or the value ACTVAL outside of
  32.  loops.
  33.  Example:
  34.   "load(1,obj.%)" will load "obj.0034" if the loop-counter is 34.
  35.  
  36.  
  37.  If you want to lineracombine some F/X you will need loops and the
  38.  FRAME-commands.
  39.  Example:
  40.   The command
  41.    "XYZ(<objectID>,<n>,<filename>)"
  42.   performs such an effect creating n objects. In case of a linear-
  43.   combination it's not necessary to save all object to disk.
  44.   Usually there is a complementary command of the structure
  45.    "XYZFRAME(<objectID>,<n>,<i>,<dest>)" which only creates the
  46.   i-th object of the sequence and stores it to buffer dest.
  47.  For more explanation the example-script "interfere.bat".
  48.  
  49.