home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / malstr21.zip / MAELSTRM.DOC < prev    next >
Text File  |  1991-09-07  |  4KB  |  98 lines
  1.                                    9/07/1991
  2.  
  3.             M A E L S T R 0 M  ver. 2.1
  4.  
  5.              Copyright(c) 1990, 1991  James Harford
  6.  
  7.  
  8.   Description:     VGA display awash with multicolored currents, rapids,
  9.          and eddies ..    This is the COLOR version!
  10.  
  11.   Restrictions:  MAELSTR0M is "freeware".  It may be copied and distributed
  12.          providing an unmodified copy of file MALSTR21.ZIP (9/07/91)
  13.          is included.
  14.  
  15.   Requirements:  VGA supporting 256K  mode.
  16.  
  17.   Operation:     Type MAELSTRM and press Enter.
  18.          The control keys are
  19.              Esc   =  Quit,
  20.              "+"   =  Speed up animation.
  21.              "-"   =  Slow down animation.
  22.              "c"   =  Change the color scheme.
  23.              "k"   =  "keep" current image (see command line options
  24.                    T<n> and C below).
  25.          space bar =  Begin a new image.
  26.  
  27.   Optional command line parameters:
  28.  
  29.       S        Screensaver mode.  No title and footer. The entire screen
  30.            is used to display the image.
  31.  
  32.       I<0-2>   Image drawing mode.
  33.  
  34.            I0 = Image drawn in 3 vertical passes.  First pass draws every
  35.             third horizontal scan line of image, giving user a quick
  36.             but coarse preview image.  Passes two and three complete
  37.             the image.    This is the default drawing mode.
  38.  
  39.            I1 = Similar to I0, except that previous image is allowed
  40.             to show in the gaps left by passes one and two until
  41.             finally overwritten by pass three.    This appears as
  42.             a gradual fadeover to the new image.
  43.  
  44.            I2 = Image drawn in 1 vertical pass.  Image gradually overwrites
  45.             previous image.  Useful when high resolution is desired
  46.             at all times.
  47.  
  48.       T<0-59>  Display time -- number of minutes before drawing a new pattern.
  49.            The default is no limit.   The current pattern may be kept
  50.            indefinitely by pressing "k" while it is being drawn or
  51.            displayed.  Pressing the space bar re-activates the display time
  52.            option as specified by the "T" command-line parameter.
  53.  
  54.       C        Select a new color scheme when beginning a new image.  This
  55.            may be overridden by pressing "k".  It is re-activated by
  56.            pressing "c".
  57.  
  58.       E        Except for the initial vortex display, the images are derived
  59.            from equations describing the electric field surrounding a set
  60.            of stationary point charges in a two-dimensional space.    There
  61.            are two families of lines in an image -- lines of electric
  62.            force, and lines of equipotential.
  63.  
  64.            Each line of force begins and ends on a charge.    The number of
  65.            lines meeting at a charge determines its magnitude, so each
  66.            point charge is a multiple of a fundamental unit "the line".
  67.            (It would be hard to write this program if that were not the
  68.            case!)
  69.  
  70.            Each line of equipotential represents a set of points of
  71.            equal potential energy and is a closed (simple) curve.
  72.  
  73.            The command parameter E forces the program to use the same
  74.            charge value for calculating lines of force as for lines of
  75.            equipotential.  Otherwise, to increase visual interest,
  76.            different magnitudes are assigned to the same point charge
  77.            for the two families of lines.
  78.  
  79.  
  80.       L<line limit>  Limits the density of lines, as well as the maximum number
  81.            of lines of force meeting at a point charge.  Default is 15.
  82.  
  83.  
  84.       F        Faster drawing (by not waiting for vertical retrace).  This
  85.            may result in increased flicker on some systems.
  86.  
  87. Credit:
  88.  
  89.     MAELSTROM was created using Borland's Turbo Pascal version 6.0 and
  90.     uses VGA256.BGI from Borland''s BGI Toolbox 1.0.
  91.  
  92.     Inspired by the display of an impressive screensaver product for the
  93.     Macintosh called Flowfazer, by Utopia Grokware, Sausalito, CA.
  94.  
  95.     Thanks also to Jon Harford for his assistence.
  96.  
  97. Comments welcome!  Send to Jim Harford, CompuServe ID 70313,750.
  98.