
				 Cthugha V3.0

		   by the Digital Aasvogel Group. 1993-1994
			    Revision V3.0 - 05May94


Who's this Cthugha dude anyway ?

"Cthugha resembles an enormous burning mass continually varying in shape.
It dwells at or near the star Fomalhaut, from whence it may be called.
It is one of the most obscure and remote of all the Great Old Ones."
Call of Cthulhu - Chaosium

When Cthugha is summoned he is always accompanied by Fire Vampires.

'There appeared thousands of tiny points of light. ... The myriad points of
light were living entities of flame!  For wherever they touched, fire sprang
up.'
The dweller in Darkness, by August Derleth



What does this software do then ?

Audio input seeded image processing.
Cool.
Hook up your CD player to the input of your soundblaster card,
or use your CD-ROM player if you've got one.
Run Cthugha V3.0 (DOS program)
Then play some of your coolest music
- and wow, does your screen look like a 90's lava lamp or what ?



Technical Stuff :

Sound Cards :
Only tested with soundblaster Pro and 16
(Tough - that's all we had, if you want other cards supported get in
touch, and we'll see what we can do.)

Oh yeah, it needs a 386 too :-)
And it *really* wants a 486 with a good-speed graphics card...

Command Line syntax:

CTHUGHA <-lmc> <-t #> <-r #>
	-l linein, -m micrphone, -c CD
	-t #  time for change in ticks (0-32000) (default 200)
	-r #  random ticks (0-32000) (default 750)
	      time delay formula : delay = t + rand()*r
	-x For Debug purposes, generate random noise instead
	   of using the Soundblaster.


Palette File Format :
The format is the same that FRACTINT uses.  If not all color indexes
are specified then they default to black.  The color values are
specified in RGB tupples (0-255), where 0 is black.  Easy !
The software scans the current directory for palette files (ext .MAP)
and uses up to the first 50 it finds.
Format -

255 255 255 comments index 0
... ... ...
255 255 255 comments color index 255


Keyboard Commands :
<esc>	Exit
x	Exit
w	change wave function
f	change flame function
p	changes palette
t	changes table (how it uses the palette)
d	changes display function (up/down etc)
m	massage the audio (figure that one out!!)
-	Drop the sample rate by 1000hz
+	Increase the sample rate by 1000hz
<	Drop the noise threshold (blanking level)
>	Increase the noise threshold (blanking level)
L	Lock modes (No random switching)
<space>	randomally changes something (maybe the same)



Version Stuff :

Incept : ??Sep93

Mod History :

v3.0
 - Resolution from 160x100 to 320x200
 - Added extra waves
 - Added extra flames
 - Added help screen (not finished yet)
 - Other additions that I don't remember

v2.1 25Mar94 zaph
 - Added LOCK mode
 - Added Silence detecter
 - Added Lightning
 
v2.0 09Mar94 zaph  
 - Release version

v1.8 09Mar94 zaph  
 - Added files to system...
 - Load palettes from files

v1.0 ??Sep93 zaph
 - First version, one flame function, one palette



Contact/Shipping/legal things :

CTHUGHA V3.0

Forward messages to Zaph
	Internet zaph@torps.apana.org.au
	Torps Productions BBS +61-3-813-3688
	FidoNet 3:634/386
	Compuserve 100240,2002

SHAREWARE
Free for non-commercial use

Commercial users register for US$20
	PO Box 331 Richmond 3121 Victoria Australia

If you can't afford to register send a video tape of public performance
or send a postcard :-)

If you forward this program on to friends, make it available on a
BBS, etc please include this document (un-adulterated).

If you run a shareware house/store, the disk you sell this program on
is not allowed to be sold for more than US$10.

DISCLAIMER : this software is provided 'as is' without waranty
of any kind implied or expressed.
If it works great.  if it doesn't, then that's your bad luck.
If it has a virus, we didn't put it there - so don't blame us !



Thanks to:


Dean Scully                             Convinced me to release the beast...
millen3@rpi.edu (Neal Millen)           First person to email me with ideas!
moles@torps.apana.org.au (Myles Abbott) Documentation/Ideas
bl2i+@andrew.cmu.edu (Bryan Lewis)      Said nice things about Cthugha
pgray@umr.edu (Paul Gray)               Convinced me to release this version


Good CD's to watch:


Pink Floyd:       The Dark Side Of The Moon
Pink Floyd:       Momentary lapse of reason
Pink Floyd:       (actually, anything by Pink Floyd will do...)
Dire Straits:     Brothers in Arms



SOURCE CODE:

The Source code to V3.0 (or, more accuratly, V3.1) will be released to
the public as soon as I have removed the SB developers kit code from it.

If you are interested in contributing to the source, contact me via the
Internet  zaph@torps.apana.org.au

