


					      @TM
			      R E A L T I M E
			      
			   
			   First Release 16-05-97
				Version  0.4






	Sections:

	1.- The boring licence.
	2.- Introduction.
	3.- Requeriments.
	4.- Usage.
	5.- Where get last version, credits, developer,...


	BTW1: I hate writing docs.
	BTW2: Sorry by my bad english :)

	  ///                 ---------------                  ///


	1.- LICENCE
	-----------

		This software (for now, this version 0.4) is absolutely
	free. You can distribute it freely in all kind of software support.
	But for comercial use, contact creator; see section 5 below.
	It comes WITHOUT any kind of "warranty". Use at YOUR OWN RISK.
	This software is mail-ware, send me a mail if you try it!



	2.- INTRODUCTION
	----------------

		The main idea for make REALTIME (RT) was born while I was
	watching FRACTINT (v. 19.5) and hearing music. I use F1 to F10 and
	1 to 9 keys to try to syncronize music and display while FRACTINT
	was in "color cycling mode". Then, why I cannot make these
	parameter vary automaticaly with the music sampled with a sound
	card? YES, this is the mainly idea!. RT vary these parameters
	depending of the music sampled in the sound card. It uses the FFT
	(Fast Fourier Transform) to get this!. Is a frecuency based system.
	Viewing Cthugha (v. 5.3) program, also contribute to get the idea.
	RT moves the palette (color cycling) of a loaded image (PCX) 
	like FRACTINT, based on the sound like Cthugha.

		It have a cool feature, for example, to make LIVE-ACTS.
	It loads all files especified (see section 4), and it displays
	the files randomly, with a especified time.

		I develope this program mainly for make music LIVE-ACTS 
	with image support (sincronized!), to make the event cool!

		Ultra cool effect!! Animate your fractal files with 
	realtime music played in your soundcard (DSP).

	********
	WARNING: IT'S COOL, if you use FRACTAL IMAGES!!!!!! 
	********
		(fractals generated by FRACTINT, of course)



	3.- REQUERIMENTS
	----------------

		RT needs (minim):

			- MS-DOS ...
			- VGA display (VESA if you want load high resolution
			  images).
			- SoundBlaster 16 or above.

		It supports only PCX format graphic files, all 256 colors and
	even width (the library I use, fails if width of a PCX is odd, ???)
	It don't scale the image on screen if it don't fits. Simply, put
	an mode enough great, and center on screen. Supports up to 1280x1024
	resolution files.
	
	If you have some great code for doing scale, support for more graphic 
	file formats, other sound cards (using DMA for record data), etc ...,
	please, CONTACT ME NOW, see end document. (Or if you know where are
	this code :) )
	
	Tested on Pentium 133, S3 Trio 64+, SB16, SB32, MS-DOS, WIN95.


	
	4.- USAGE
	---------

		Sintax: REALTIME [file] [[basetime] [[maxtime]]]
		or    : REALTIME -h for online help

	where:

	    file: file to be displayed, <*> and <?> are allowed.
		  Default *.pcx
	basetime: time that an image will be displayed. Default 60 seconds.
	 maxtime: random time between (0-maxtime) added to basetime.
		  Default 30 seconds.

	If you only want put second parameter, you need put the first, sorry.
	If you miss a parameter, it gets the default value.
	Maxim number of load files is 1000, hard coded; enough, I think :)

	For example:

		REALTIME *.pcx 0

		Loads all PCX files in the current directory and randomly
		displays, with a random time between 0 to 30 sec.
		
		REALTIME *.pcx 0 0

		Idem, but displays the first random image all time.
		0 is infinite :)

		REALTIME *.pcx 5 0

		Displays each image randomly every 5 seconds.

		REALTIME *.pcx 20 50

		Displays each image randomly, 20 sec always, with a random
		time between 0 to 50 seconds.


	KEYS while running:

		-ESC, quit program.
		-RETURN, next image (overrides remaining time).
		-BARSPACE, changes something randomly (colors, speed, ...)
		 in the same image.
		-'P', pause.
		-Right, left direction keys: rotate forward or backward 
		 colors.


	CODE EXIT ERRORS:

		0 - "No errors :)"
		1 - "Sound device not found"
		2 - "Opening PCX image"
		3 - "Only 256 colors PCX files supported :("
		4 - "This program only runs if you have a VGA adapter"
		5 - "Cannot put VESA mode"
		6 - "Displaying PCX image"
		7 - "PCX files not found"
		8 - "Getting memory"
		9 - "Odd width in some PCX readed are not allowed. Only even
		     width"


		Try modify the volume of the SB, with a mixer, outside RT.
		Experiment with different volumes, I've volume very high, to
		get more effect. It depends, experiment!.

		It looks more cool if you use music that have many changes,
		like break-beat, dance, etc. For example, I tried:
		Chemical Brothers (the best view), Apollo Four Forty,
		Laurent Garnier, Depeche Mode, ... But I tried with Ministry,
		Garbage, and didn't look cool, because guitars make the
		spectrum very equal and without great variations. It depends
		too, from the images (fractals) you use.
		For that, try all, experiment!.



	5.- CREDITS
	-----------

		Developed entirely by Fermin Molina (Fucker).
			
			fermin@eup.udl.es

		member of 
		
			XtEnSiOnS Of Mind
		
		http://jupiter.eup.udl.es/xm

		Last versions above, and REALTIME home page, too, if
		I do it some day!
		
		In other sites (music related) may be (is) avalaible.

		
		BUGS: fermin@eup.udl.es
		

	BONUS PROGRAM:
		Ah! I've included one analizer wave spectrum and oscilloscope,
		called: gfdma4.exe (v. 0.4, too). Use "-h" option alone for
		more help.


***********Thanks to:

		Santy (the other member of XtEnSiOnS Of Mind) for                
		his inconditional support.

		Developers of Fractint (v. 19.5) & Cthugha (5.3)
		
		Q-57, Kavern, Florida 135 (best disco in Spain)

		Sala del CEL, another disco (projecting Cthugha in it!)

		Members of Demo group GATZAN
	       
		Neighbours, for hear my music to 5 a.m. or more :)

		And many, many other people ...



	Last words:


		HELP ME!
		--------


	If you have or know where is code to add support for GUS and more
	graphic file formats, please, send me, I will include this early.
	I thinking about release source code. If you want develope
	some new part, ask me, don't hesitate!\n\n");

	I've a GUS PnP Pro with 8.5 MB, how I program it?


---
Fermin Molina
fermin@eup.udl.es

	
	COOL REALTIME!!

