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 must be run
as root so it can access the framebuffer (sorry, but this is a result
of how svgalib and linux work, if you know a better way please let me
know).

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;') changes rule.  the rule controls
the basic algorithm used by the effect.  variants of a rule 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 rule it loads a new image, in rotor rule it picks a new
harmony or flame, in the brain it changes the excitation rules.  b is
a variant of v, be sure to try it with the brain.



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 rule 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
-----------------

  B   fade to black
  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
  /   load driver
