"ds3" is a program to set the 3rd clock on Diamond Stealth 24 video cards.
To my knowledge, this program contains no Diamond-proprietary code; I only
added ease-of-use features to "s3.c", which in turn was in part derived
from the "Batman" posting (which is of unknown origin).

This posting is not intended to encourage, nor discourage people from
buying Diamond video cards.  It is only intended to enable those who
have already bought Diamond Stealth cards to use them more effectively.

"ds3" allows you to specify which dot clock frequency you want (in MHz),
rather than having to tell it random numbers like "5 9".  It has only been
tested with a Diamond STL 24 VL, though it is derived from code tested on
a Diamond STL Pro and will probably also work on a non-VL Diamond STL 24.

The dot clock is set nicely this way, but the vertical frequency is not so 
easy.  In s3, as long as the first number (e.g. in s3 5 9) was from 1 to 6,
it didn't seem make any difference at all what it was.  If anyone can
figure out how to set the vertical frequency, go ahead!  I think the
comments/variable names in the code have vertical and horizontal mixed up.

For some reason, it does not work properly with the mono X-server when used
as the "clockprog", even though I went to great pains to ensure that it would
accept and act on the right parameters.  XS3-0.4.4 ignores "clockprog"
altogether.  The end result is that you must set the desired 3rd clock setting
prior to starting X, and comment out the "clockprog" line.  This works quite
well over a wide range of frequencies, from 640x480 at 62 Hz all the way
up to 1024x768 at 76 Hz.

WARNING: this program allows you to set your clock to frequencies which may
exceed you monitor's capabilities, particularly if you have an older or lower-
quality monitor!

*** Frequencies which work great on one monitor may cause monitor damage ***
*** and/or video card damage when used with a different monitor.         ***

It is YOUR RESPONSIBILITY to ensure that any setting you use meets the
safe operating parameters of your monitor.  Please also see additional
warnings in the accompanying Xconfig.stl24 file.

Files included:
	ds3	Linux .99pl12a libc 4.4.1 binary
	ds3.c	source
	s3lib.s	assembly source for additional routines (unchanged from "s3")
	ds3.txt	this file
	Makefile
	Xconfig.stl24

syntax:

ds3 -a				## lists out all avaiable clocks
ds3 -n <Freq>			## just checks on the frequency you specify
ds3 [ <Freq> [ clock ID ] ]	## actually sets the clock; ignores clock ID

niemidc@oasis.gtegsc.com	15 Aug 1993
