home *** CD-ROM | disk | FTP | other *** search
/ Freelog Special Edition 10 / FreelogHS10.iso / Divers / Bomb / manual.txt < prev    next >
Text File  |  2001-11-04  |  7KB  |  275 lines
  1.  
  2.           Bomb v1.28 11/4/2001
  3.  
  4.            organic visual music
  5.  
  6.           http://draves.org/bomb
  7.  
  8.  
  9.  
  10.      scroll down with arrow/page keys
  11.  
  12.  
  13.  
  14.  
  15.      >>>>> table of contents <<<<<
  16.  
  17.       basic operation
  18.       keyboard commands
  19.       more commands
  20.       other organs
  21.       color controls
  22.       image library
  23.       sound input
  24.  
  25.  
  26.  
  27.      >>>>> basic operation <<<<<
  28.  
  29. If you run Bomb and leave it alone (ie
  30. don't touch the keyboard), it will go
  31. into automatic mode (automode).  Select
  32. an audio source with the regular windows
  33. control panel, relax, and enjoy.  Use
  34. Control-C or ESC to exit.
  35.  
  36. A collection of about 20 parameters
  37. control how the image on the screen
  38. changes.  Each parameter set defines a
  39. particular texture, shape, or effect.
  40. As long as the parameters remain
  41. unchanged the same basic visual pattern
  42. will evolve on screen.  In automode the
  43. parameters are occasionally varied at
  44. random.
  45.  
  46. Bomb starts out with roughly the same
  47. parameters every time: a boiling texture
  48. dissolving the title page. If you wait,
  49. the parameters will change and new
  50. effects will appear.
  51.  
  52.  
  53.  
  54.     >>>>> keyboard commands <<<<<
  55.  
  56. It's also possible to change the
  57. parameters manually with the keyboard.
  58. The space bar randomizes all parameters
  59. and clears the screen.  It can be used
  60. as a 'reject button': if Bomb is doing
  61. something stupid, hit the space bar and
  62. a new (and hopefully better) effect will
  63. appear.  This is the crudest possible
  64. control.
  65.  
  66. The rest of the keys are mapped to
  67. commands that adjust the various
  68. parameters.  The normal layout is
  69. described below.  Access to the
  70. easier-to-remember 'mood organ' mappings
  71. follow.
  72.  
  73. The middle row of keys (asdfghjkl;')
  74. changes the rule.  The rule controls the
  75. basic algorithm used by the effect.
  76. Variants of a rule can be accessed by
  77. pressing the same key repeatedly (try
  78. hitting 'f' or 'g' several times).  Here
  79. are the keys, rules, and the number of
  80. variations:
  81.  
  82.   a  rug          3
  83.   s  image rug    1
  84.   d  react/diffuse 2
  85.   f  rotor/flame  9
  86.   g  acidlife     2
  87.   h  multi rug    1
  88.   j  anneal rug   2
  89.   k  slip         1
  90.   l  rug rug      1
  91.   ;  brain rug    1
  92.   '  fish/slugs   2
  93.   A  static       1
  94.   F  fuse         4
  95.   G  quad         1
  96.  
  97.  
  98. The lower row of keys (zxcvbn) randomize
  99. individual parameters for finer control:
  100.  
  101.   z  change speed/texture
  102.   x  fill screen
  103.   c  change color
  104.   v  next shape
  105.   b  next shape II
  106.   n  toggle rhythm/sound
  107.   m  next shape III
  108.  
  109. v is context sensitive, think of it as
  110. getting the 'next shape'.  Eg in image
  111. rule it loads a new image, in rotor rule
  112. it picks a new harmony or flame, in the
  113. brain it changes the excitation rules.
  114. b is a variant of v, be sure to try it
  115. with the brain.  Use m and b with
  116. react/diffuse.  m in image mode uses the
  117. image sequences.
  118.  
  119.  
  120.  
  121. The top row selects an individual
  122. parameter to vary.  After the parameter
  123. is selected, the ,. keys (unshifted <>)
  124. move the value up and down.  Eg while in
  125. image rule try pressing r, then several
  126. commas.  You can also type a number
  127. followed by RETURN to enter a specific
  128. value, or repeatedly hit the parameter
  129. key to increment/toggle the value (try
  130. uuuu).
  131.  
  132.   q  color map
  133.   w  beat size
  134.   e  beat speed
  135.   r  texture/speed
  136.   t  # icons in window
  137.   y  icon sequence
  138.   u  toggle smooth color
  139.   i  texture/mask -- unusable
  140.   o  misc
  141.   p  blit rect size
  142.   [  speed of shape change
  143.   ]  speed of driver rule
  144.   \  assoc search time
  145.   {  hot time
  146.   }  cool time
  147.   |  brain rule
  148.   P  brain shift
  149.   O  cycle bkg (in rug2)
  150.   I  smooth/random underflow
  151.  
  152.  
  153.  
  154.     >>>>> more commands <<<<<
  155.  
  156.   B   fade to black
  157.   Q   enter automode
  158.   0   (zero) disable automode
  159.   L   toggle mode lock
  160.   =   dump frame to dribble dir
  161.   +   toggle periodic dribble
  162.   Z   new image and clear screen
  163.   WER pulse colormap
  164.   C   invert driver
  165.   /   load driver
  166.   D   permute colormap by rotating bits
  167.   S   toggle smooth/plain cmap
  168.   J   double board horiz
  169.   H   double board vert
  170.   ^F  toggle display frame rate and levels
  171.  
  172.  
  173.  
  174.       >>>>> other organs <<<<<
  175.  
  176. The above keyboard commands allow
  177. exploration of Bomb's entire parameter
  178. space, but by using clumsy
  179. random-walking and type-a-number
  180. interfaces.  Keyboard mappings called
  181. 'organs' allow you to (eg) map a single
  182. parameter across the whole keyboard.  in
  183. these modes the space bar and
  184. exit-program commands still function,
  185. but all the other keys (including shift
  186. and control combinations) are mapped to
  187. the parameter.
  188.  
  189. the basic organs are
  190.  
  191.   1     standard
  192.   2     mood
  193.   3     shape
  194.   4     color
  195.  
  196. [[ currently the digits 1-4 have been
  197. hijacked and are bound to change the
  198. organ rather than type-in-numbers ]]
  199.  
  200. Bomb starts out with the standard organ
  201. described above.  The shape organ drives
  202. with different images.  The color organ
  203. picks the colormap (even keys produce
  204. smooth/looped colors; odd keys produce
  205. plain colormaps).  The mood organ binds
  206. entire parameter sets to individual keys
  207. (only a-n so far).
  208.  
  209. The n key toggles use of audio, if
  210. available and applicable.
  211.  
  212.  
  213.  
  214.      >>>>> color controls <<<<<
  215.  
  216. Hit the q key repeatedly to change the
  217. color palette.  Use the S key to change
  218. the interpretation of the palette.
  219. There are three interpretations: smooth,
  220. semi-smooth, and rough.  The c key sets
  221. a new and random palette and
  222. interpretation, and may also set a
  223. special palette such as grayscale or
  224. heat.  The B key fades to black.
  225.  
  226. Or use the color-organ: press 4 then
  227. press any other key.  Press 1 to end
  228. color selection with the organ.
  229.  
  230.  
  231.  
  232.      >>>>> image library <<<<<
  233.  
  234. Image mode (on the s key) and Fuse mode
  235. (on the F key) display images that are
  236. read from files.  Normally you switch
  237. which image is displayed with the vbZm
  238. keys.  The images are stored in a
  239. directory named 'suck' in gif and ppm
  240. format.  Bomb just uses whatever images
  241. are found in that directory so it should
  242. be easy to use your own.
  243.  
  244. The images are also related to each
  245. other visually and symbolically.  The
  246. file 'seq-data' specifies sequences of
  247. images by name.
  248.  
  249.  
  250.  
  251.      >>>>> sound input <<<<<
  252.  
  253. Bomb opens the default audio input
  254. device.  The regular Windows "Sounds and
  255. Multimedia" control panel has a "Sound
  256. Recording" panel where the device can be
  257. set to the microphone, CD-audio,
  258. line-in, or line-out (depending on your
  259. hardware and operating system).  You
  260. should set the recording level on the
  261. high side because Bomb has its own level
  262. control.
  263.  
  264. The up and down arrow keys adjust the
  265. audio levels while Bomb is running (they
  266. scroll while the help file is
  267. displayed).  Use Control-F to display
  268. the audio level, the peak level, the
  269. bias leval (the ambient sound level) and
  270. the frame rate (from left to right).
  271. Peaks of 30 to 70 are usually fine.
  272.  
  273.  
  274.      >>>>> the end <<<<<
  275.