home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / sound / cthugha5.zip / CTHUGHA.DOC < prev    next >
Text File  |  1994-08-20  |  11KB  |  339 lines
  1.  
  2.                                  Cthugha V5.0
  3.                           'An Oscilliscope on Acid'
  4.  
  5.                     by the Digital Aasvogel Group. 1993-1994
  6.                             Revision V5.0 - 29Jun94 zaph    
  7.  
  8.  
  9.  
  10.                        Who's this Cthugha dude anyway ?
  11. -----------------------------------------------------------------------
  12. "Cthugha resembles an enormous burning mass continually varying in shape.
  13. It dwells at or near the star Fomalhaut, from whence it may be called.
  14. It is one of the most obscure and remote of all the Great Old Ones."
  15. Call of Cthulhu - Chaosium
  16.  
  17. When Cthugha is summoned he is always accompanied by Fire Vampires.
  18.  
  19. 'There appeared thousands of tiny points of light. ... The myriad points of
  20. light were living entities of flame!  For wherever they touched, fire sprang
  21. up.'
  22. The dweller in Darkness, by August Derleth
  23.  
  24.  
  25.  
  26.                       What does this software do then ?
  27. -----------------------------------------------------------------------
  28. Audio input seeded image processing.
  29. Cool.
  30. Hook up your CD player to the input of your soundblaster card,
  31. or use your CD-ROM player if you've got one.
  32. Run Cthugha (DOS program)
  33. Then play some of your coolest music
  34. - and wow, does your screen look like a 90's lava lamp or what ?
  35.  
  36. Cthugha 'listens' to your music, and changes the display dynamically
  37. to the sound.  
  38.  
  39. Ever looked an an oscilliscope of your voice or of music ?
  40.  
  41. Think of this as an oscilliscope on acid.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                             Technical Stuff :
  48. -----------------------------------------------------------------------
  49.  
  50. Sound Cards :
  51.  
  52. Tested with soundblaster Pro and 16
  53. Tested with GUS
  54. **PROBABLY DOESN'T WORK WITH A PAS AT THE MOMENT :-(
  55.  
  56. (Sorry - that's all we had, if you want other cards supported get in
  57. touch, and we'll see what we can do.)
  58.  
  59. Oh yeah, it needs a 386 too :-)
  60. And it *really* wants a 486 with a good-speed graphics card...
  61. And it *flys* with a Pentium PCI machine :-)
  62.  
  63. Command Line syntax:
  64.  
  65. Cthugha: Command line options
  66. (These are Case sensitive commands)
  67.  
  68.   -L,-M,-C  : Use Line/Mic/CD as input
  69.   -G,-S,-P  : Use GUS/SB/PAS (default: search)
  70.   -O        : Use OLD SB code (useful for PAS or other cards that dont work)
  71.   -s,-m     : Default to STEREO/MONO
  72.   -i,-e     : Disable Inbuilt/External Palettes
  73.  
  74.   -T <num>  : Minimum frames before changing
  75.   -R <num>  : extra random frames before changing
  76.               time delay formula : delay = t + rand()%r
  77.  
  78.   -V <0-255>: Set input volume to <0-255>
  79.   -v <rate> : VU bar sample rate (Default=4000)
  80.  
  81.   -Q <num>  : Number of frames before silence change <def:200>
  82.   -f <num>  : Start with flame   #<num>
  83.   -w <num>  : Start with wave    #<num>
  84.   -p <num>  : Start with palette #<num>
  85.   -l        : Lock to first wave/flame/palette
  86.  
  87.   -d        : Pause just before running (usually for debug)
  88.   -X,-x     : Debug mode (no sound source needed) - generate random noise
  89.   -t <fname>: Load alternate Translation table file
  90.   -q <fname>: Load alternate Quiet strings from a text file
  91.   -I <fname>: Load settings from .ini file
  92.  
  93.   -B <num>  : Set the beat volume level to #<num>                <def:220>
  94.   -b <num>  : Set the number of beats to #<num> (0,-ve to disable) <def:16>
  95. (Notes on BEATS):
  96.   The BEAT flags allow the screen to try to change on a regular number of
  97.   loud beats...  Usually this matches either a drum beat, or loud vocals..
  98.   If you set the values too low, everything starts going crazy :-)
  99.   This would be better implemented as a frequency based system, but since
  100.   the FFT code isnt going yet...
  101.  
  102. Keyboard Commands (While running) :
  103.  
  104. - +     Drop/Increase the sample rate by 1000hz
  105. < >     Drop/Increase the noise threshold (blanking level)
  106.  
  107. i       write current setting to INI file
  108.  
  109. w       change wave function
  110. f       change flame function
  111. p       changes palette
  112. t       changes table (how it uses the palette)
  113. d       changes display function (up/down etc)
  114. m       massage the audio (figure that one out!!)
  115. L       Lock modes (No random switching)
  116. c       CD player interface
  117. <space> randomally changes something (maybe the same)
  118. *       Stereo/Mono toggle
  119. !       Toggle Translation Table
  120.  
  121. <esc>   Exit
  122. x       Exit
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                             More Tech Stuff :
  130. -----------------------------------------------------------------------
  131.  
  132. Palette File Format :
  133. The format is the same that FRACTINT uses.  If not all color indexes
  134. are specified then they default to black.  The color values are
  135. specified in RGB tupples (0-255), where 0 is black.  Easy !
  136. The software scans the current directory for palette files (ext .MAP)
  137. and uses up to the first 25 it finds.
  138. Format -
  139.  
  140. 255 255 255 comments index 0
  141. ... ... ...
  142. 255 255 255 comments color index 255
  143.  
  144. If you come up with a good palette file, 
  145. email it to zaph@torps.apana.org.au
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                               Translation Tables:
  153. -----------------------------------------------------------------------
  154. These tables are used to design just about ANY effect, without recompiling
  155. the source to Cthugha!!!
  156.  
  157. Here's how they work.
  158. You generate a table, 320x204, of integers - the integer represents the
  159. SOURCE pixel for this DESTINATION pixel.
  160.  
  161. e.g  in a small 3x3 world..
  162. 123
  163. 456
  164. 789    would do nothing
  165.  
  166. 236
  167. 519
  168. 478    would rotate around the edge, and pop back to the center...
  169.  
  170. Read the source to GENTABLE.C to try to work out how it works, or send me
  171. some email!
  172.  
  173. Several tables are included with Cthugha - try them with the -t <fname>
  174. option.  Currently, only one table can be loaded for a given run of Cthugha.
  175.  
  176.  
  177.  
  178.  
  179.                                  Quiet Strings:
  180. -----------------------------------------------------------------------
  181. If everything goes quiet for a while, then Cthugha will pop up one of 
  182. 19 strings to the screen
  183. Each string can be up to 19 characters long, and can be read from a text
  184. file with the following command line parameter
  185.  
  186. cthugha -q filename
  187.  
  188. The first 19 characters of each line are used for the string table.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                          Contact/Shipping/legal things :
  195. -----------------------------------------------------------------------
  196. CTHUGHA V5.0
  197.  
  198. Forward messages to Zaph
  199.     Internet zaph@torps.apana.org.au
  200.     Torps Productions BBS +61-3-813-3688
  201.     FidoNet 3:634/386                   (FREQ CTHUGHA for the latest version)
  202.     Compuserve 100240,2002  (I'd rather use Internet...)
  203.  
  204.     or:
  205.  
  206.     Zaph
  207.     PO Box 331 
  208.     Richmond 3121 
  209.     Victoria, Australia
  210.  
  211.  
  212. SHAREWARE  (PostcardWare/CDWare)
  213. Free for non-commercial use  -  Send a Postcard to show your appreciation
  214. If you have more money than you know what to do with, then send me a CD
  215. of something you like listening to with Cthugha on the screen...
  216.  
  217. Really, there's no point sending me a cheque for $20-$30, because its going
  218. to cost to get it cashed anyway, and I'd probably go out and buy a CD with
  219. the money, so - if you want to send more than a postcard,  why not just send
  220. a CD instead ??
  221.  
  222. Commercial users register for US$50 (or AUS$50)
  223. (Previous versions were US$20, but it costs that much to cash the cheque!)
  224.  
  225.     Kevin Burfitt
  226.     PO Box 331
  227.     Richmond 3121 
  228.     Victoria, Australia
  229.  
  230.  
  231. If you can't afford to register send a video tape of public performance
  232. or send a postcard :-)
  233.  
  234. If you forward this program on to friends, make it available on a
  235. BBS, etc please include this document (un-adulterated).
  236.  
  237. If you run a shareware house/store, the disk you sell this program on
  238. is not allowed to be sold for more than US$20.
  239.  
  240. DISCLAIMER : this software is provided 'as is' without waranty
  241. of any kind implied or expressed.
  242.  
  243. If it works, great.
  244. If it doesn't, then that's your bad luck - send us some mail and we will try
  245. to fix it.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.                                   Thanks to:
  252. -----------------------------------------------------------------------
  253. Coders:
  254.  
  255. zaph@torps.apana.org.au       (Kevin Burfitt)   Thats me :-)
  256. moles@torps.apana.org.au      (Myles Abbott)    Documentation/Ideas
  257. u23783@vicvm.