how to run and use bomb
-----------------------

make sure you run the program in the same directory as you unpacked
it, otherwise it won't be able to find its datafiles.

it accepts no command-line switches.

if you run it and leave it alone (ie don't touch the keyboard), it
will go into automatic mode (automode).  put on your favorite audio
CD, sit back, and enjoy the show.  use Control-C to exit.

how the image on the screen changes is controlled by a collection of
parameters.  each parameter set defines a particular texture, shape,
or effect.  as long as the parameters remain unchanged the same basic
visual pattern will evolve on screen.  in automode the parameters are
occasionally varied at random.

`bomb' starts out with roughly the same parameters every time: a
brownish boiling texture dissolving the title page. if you wait, the
parameters will change and new effects will appear.

keyboard commands
-----------------

it's also possible to change the parameters manually with the
keyboard.  the space bar randomizes all parameters and clears the
screen.  it can be used as a `reject button': if the program is doing
something stupid, hit the space bar and a new (and hopefully better)
effect will appear.  this is the crudest possible control.

the middle row of keys (asdfghjkl;') change mode.  the mode controls
the basic algorithm used by the effect.  variants of a mode can be
accessed by pressing the same key repeatedly (eg try hitting 'f' or
'k' several times).

  a  rug
  s  image rug
  d  static
  f  rotor/flame
  g  acidlife
  h  multi rug
  j  anneal rug
  k  slip
  l  rug rug
  ;  brain rug
  '  fish/slugs


the lower row of keys (zxcvbn) randomize individual parameters for
finer control:

  z  change speed/texture
  x  fill screen
  c  change color
  n  toggle rhythm

v is context sensitive, think of it as getting the `next shape'.  eg
in image mode it loads a new image, in rotor mode it picks a new
harmony or flame, in the brain it changes the excitation rules.  b is
a variant of v.


the top row selects an individual parameter to vary.  after the
parameter is selected, the ,. keys (unshifted <>) move the value up
and down.  eg while in image mode try pressing r, then several commas.
you can also type a number followed by RETURN to enter a specific
value.  see the source code for a list of the parameters.


advanced behavior
-----------------

  Q   enter automode
  0   (zero) disable automode
  L   toggle mode lock
  =   dump frame to dribble dir
  Z   new image and clear screen (good for image mode)
  F   enter fuse mode (highly experimental)
  WER pulse colormap
  C   invert driver
