07/31/96

source.txt

MCLK has been in public release for over a year.  Just a few comments...
MCLK was the first C++ program I wrote.  It was more of a learning experience
than a professional programming project.  Among other things, MCLK's
user-interface should have been more user-friendly.  One day, I'll dig up
MCLK and laugh.  Heheh, I shouldn't ridicule my own creations, but I couldn't
resist :)

--------------------------------------------------

MCLK's source code is broken into two major components...

1)	MCLK.CPP
	Actual program with main() function.  User-interface simply calls
	the chips.lib (chips.lib does all the work.)

2)	CHIPS.LIB, which is composed of many sub-components
		VGA.CPP		//  Class declarations for the BASE class
				//  of all derived SVGA chipsets

		S3.CPP		//  Contains all S3 code, except for detection
				//  plenty of feedback from Trio64 owners,
				//  also works on the Virge

		CIRRUS.CPP	//  Contains the Cirrus code
				//  

		DETECT.CPP	//  Contains code to detect video hardware...
				//  Dependent on the other code (vga.cpp
								 s3.cpp, etc.)
				//  detection code isn't very robust
				//  misidentifies a lot of Trio64V+ chips

		TRIDENT.CPP	//  Contains the Trident 9440/96XX MCLK code
				//  I tested it on my 9680PCI, so I know it
				//  works

		W32P.CPP 	//  Okay, it's back in the chips.lib
				//  However, auto-detect routine "skips" w32p

	And of course, the CPP files reference the appropriate .H header files.
	In theory, you can recompile this program with just ONE SVGA class.
	S3, CIRRUS, and W32P are SVGA classes.  Of course, you'd need to
	change the detect() routine.


CHIPS.PRJ
	Turbo C++ 3.0 project file, load this and you can recompile CHIPS.LIB

MCLK.PRJ
	Turbo C++ 3.0 project file, if CHIPS.LIB is present, you can recompile
		the main exeuctable program.

.......................
If you're interested in learning more about your SVGA card, here is a partial
list of vendors.  Keep in mind that MCLK has no official support from any
of the vendors.

ATI Technologies
http://www.atitech.ca

Cirrus Logic
ftp.cirrus.com
http://www.cirrus.com
ui-support@cirrus.com

Oak Technologies
http://www.oaktech.com

S3 incorporated, Literature Department
2770 San Tomas Expressway
Santa Clara, CA 95051-0968
(408) 980-5400
(408)-980-5444 FAX
(408)-654-5676 BBS
http://www.s3.com

Trident Microsystems, Inc.
(415) 691-1016 BBS
(408) 738-3194 Tech support
http://www.trid.com

Tseng Laboratories, Inc.
http://www.tseng.com

.......................

email: liaor@uci.edu

Compiler: Borland's Turbo C++ 3.0 (DOS)
Help from VGADOC3.ZIP, Cirrus Logic GD542x & 543x/544x databooks, S3 801/805,
S3 Trio32/64, S3 Trio64V+, S3 Vision866/868/964/968, S3 Virge, S3 Virge/VX
databook(s)

Additional thanks to the author of VGADOC4B, Finn Thoegersen.

Thanks to all you users who tried my program.  Your feedback allowed me to
scrub out a few bugs.