*******************E-mail:rob.muller@kagi.com*******************************

Readme.txt for UniRefresh v1.42                              October 11 2000

0.  Help! My video card does not support VBE 3.0.
1.  Introduction
2.  Installation
3.  How does it work?
4.  The menu
5.  System requirements
6.  Miscellaneous
7.  What to expect in future versions
8.  Known problems/limitations
9.  License/registration
10. Acknowledgements
11. Contacting the author


0.   Help! My video card does not support VBE 3.0.
      
     This is the number one question being asked.
     VBE 3.0 is supported by all the cards with the following chipsets:
     * all NVIDIA chips starting with RIVA 128:
       RIVA 128/TNT/TNT2/GeForce/GeForce2.
     * all 3dfx chips starting with Banshee: 
       Banshee/Voodoo3/Voodoo4/Voodoo5/Voodoo6.

     All other video cards do NOT support VBE 3.0.

     If your video card does not support VBE 3.0, the only possibility left
     is Scitech Display Doctor. http://www.scitechsoft.com
     SDD has not been updated for the last two years. If you have a video
     card that is not supported by SDD you are out of luck: there is no 
     other way to get VBE 3.0. 

1.   Introduction.
     
     UniRefresh is a shareware universal dos refresh rate utility.
     It is easy to use, the only data needed are the specifications of
     the monitor.
     It consists of two parts:
     a setup program (setup.exe) and a TSR (Terminate Stay Resident)
     program (unirfrsh.com).
     The setup program calculates the timings for the refresh rates
     and saves these timings in a file.
     The TSR (resident part only 208 bytes) reads the refresh rate
     data needed for setting a video mode from the file that was
     created by the setup program.
     
2.   Installation.
     
     *   Unzip the archive in any directory and run setup.exe to
         configure UniRefresh.
     *   From the menu choose "Configure monitor".
     *   Fill in the specifications of your monitor. (according to the
         manual)
     *   From the main menu choose "Automatic configuration".
     *   Select "View/set refresh rates" to see what refresh rates are
         calculated for the video modes.
     *   Save the configuration before returning to dos.
     
     Ready. Now you can start using UniRefresh by typing "unirfrsh" at
     the command prompt.
     If you want the TSR to unload, type in "unirfrsh" once again.
     
     Notes:
     Four frequencies need to be configured, minimum/maximum
     vertical/horizontal frequency. Look in the manual of the monitor
     and fill in these four frequencies. If you "overclock" your
     monitor it can be seriously damaged, so fill in the values
     according to the manual.
     UniRefresh needs a multi scanning monitor. Do not use UniRefresh
     if the attached monitor is not multi scanning.
     If you don't know one or both maximum frequencies don't use
     UniRefresh.
     If you don't know the minimum horizontal frequency, I suggest
     filling in 30 kHz.
     If you don't know the minimum vertical frequency, I suggest
     filling in 60 Hz.
     
3.   How does it work?
     
     UniRefresh uses a TSR to intercept the setting of a VESA video
     mode. If the requested video mode is a VESA video mode and if the
     refresh rate needs to be changed, the TSR reads the timing data
     from the data file and uses this to do a VESA VBE 3.0 set mode
     call with refresh rate information. UniRefresh also sets refresh
     rates for 3dfx cards (Banshee and newer) when using dos Glide.
     
4.   The Menu.
     
     View/set        Select a video mode in the left window. On the
     refresh rates   right side, you see the calculated frequencies
                     and some other information. If "t" is pressed the
                     (banked) video mode is tested with the calculated
                     timings and a test screen will be displayed so you
                     can adjust the screen with the monitor's 
                     adjustments. At the test screen press "c" to 
                     change centering/sizing.
                     Changing centering/sizing through VBE bios is
                     slow. If it is too slow, enable DirectMove, now
                     sizing/centering is done through direct writing to
                     video registers. It is possible that this causes
                     problems (it is tested on 3dfx and NVIDIA cards)
                     then turn DirectMove off to use the bios again.
                     Press enter to change the refresh rate for the
                     selected video mode.
                     Press del to delete the timings for the selected
                     video mode.
                     
                     MaxPixelClock: maximum pixelclock (pixels per
                     second) the video adapter returned for this video
                     mode. This isn't a very interesting value.
                     
                     MaxVFreqCard: maximum vertical frequency
                     calculated according to MaxPixelClock. This is
                     the maximum refresh rate the video board can
                     deliver for the selected video mode.
                     
                     MaxVFreqMonitor: maximum refresh rate the
                     attached monitor can handle at this resolution.
		
                     MinVFreq: minimum refresh rate available.
                     
                     Available: is the video mode available as
                     returned by the VBE.
                     
                     Support: if yes UniRefresh changes the refresh
                     rate of this video mode. If a correct refresh rate
                     has been calculated, Support will be yes.
                     
                     ErrorCalc: Yes if an error occurred while
                     calculating the refresh rate. 
                     
                     Vertical frequency: the frequency at which the
                     complete screen is repainted (the refresh rate).
                     
                     Horizontal frequency: lines per second
                      (There are about 5% more lines on a screen than
                     are displayed.)
                     
                     PixelClock: pixels per second
                     (There are about 30% more pixels per line than
                     are displayed.)
                     
     Auto            This will calculate the refresh rate for all
     configuration   modes automatically.
                     
     Configure       Don't mess around with these values, look in the
     monitor         manual of the monitor.
                     See the Installation part above for more details.
                     
     General         Only one option is available at the moment
     Options         (Ignore double scan bit). The 3dfx Banshee and Voodoo3
                     erroneously report that double scanning is not
                     available. This is causing problems with low res modes.
                     When enabling this option, UniRefresh ignores the
                     double scan bit and assumes double scanning is
                     available when necessary.
                     
     View VBE        Information which is returned by the VESA VBE
     information     (VESA bios extension).
                     
     Save            This saves the data to a file (timings.dat). The
     configuration   TSR retrieves all the data needed to set the
                     correct refresh rate from this file.
                     
     Quit setup      Quit the setup program and return to DOS.
                     
5.   System requirements
     
     *   Video adapter with VESA VBE 3.0 support
     *   MS-DOS v3.3 or higher
     *   80386 or better
     *   Multi scanning monitor
     
6.   Miscellaneous
     
     If a runtime error occurs the type and location of the error will
     be logged in a file named "debug.log".
     
     Before the setup program or the TSR load, things like the
     information returned by the VBE and the integrity of the data
     file are checked. If you change the video adapter (to another
     type), both programs will detect a change in hardware. This will
     prevent the TSR to load. You then have to run the setup program
     to reconfigure UniRefresh.
     If you need to load a driver for VBE 3.0 support you have to do
     this before loading the TSR. Otherwise, the TSR will not detect
     VBE 3.0. If you have a video adapter with VBE 3.0 support in BIOS
     and you start to use a software driver for VBE support (like
     SciTech Display Doctor/Univbe) the TSR will detect a change in
     hardware.
     
7.   What to expect in future versions
     
     *   Integration of the resident part in the setup program, so
         only one program is needed.

8.   Known problems/limitations

     There are no other problems known then are listed here. So, if you have
     a problem with this software, please let me know.

     *   Windows really messes up things when you switch to the desktop and
         back to dos again with alt-tab. The setup program contains a 
         workaround for most of these problems, only 4bpp modes are still
         messed up (the mode is correctly restored, but the registers are
         overwritten with values for a different resolution)
         The TSR also contains a workaround for alt-tab problems. 4bpp modes
         and modes with mode numbers greater than 17fh are still messed up.
         (windows removes bit 7 of the mode number, so 1f6h becomes 176h)
     *   V3 and Banshee report that double scanning is not supported for any
         mode. Because of this, the refresh rates for low resolution modes
         need to be very high to reach the minimum horizontal frequency.
         3dfx is aware of this problem. (Enable "ignore double scan bit" in
         the "General options" menu to solve this problem)
     *   Only the top half of the screen is shown with low resolutions and
         refresh rate control on V3 and Banshee. This is a bug in the BIOS
         of these chips. 3dfx is aware of this problem. (Enable "ignore
         double scan bit" in the "General options" menu to solve this
         problem)
     *   Refresh rate control doesn't work with 800x600x4bpp modes on V3 and
         Banshee. This is a bug in the BIOS of these chips. 3dfx is aware of
         this problem.
     *   The TSR locks one file handle. This will probably cause no 
         problems, if it does, increase the maximum number of file handles 
         available. ('files=xx' in config.sys)       
     *   Some network redirectors/cd rom drivers cause problems when loaded 
         after UniRefresh has loaded because UniRefresh locks one file 
         handle. Solution: load the network redirector/cd rom driver before 
         loading UniRefresh.

9.   License/registration

     UniRefresh is shareware. You may use this fully working version for an
     evaluation period of up to 21 days. If you decide to use this software
     after this period you have to register it for $15 (USD).

     You can register UniRefresh online at http://order.kagi.com/?2GC

     Why register?
     Registering is all about supporting the author. When you register the
     software the author can make more time free for programming and buy 
     more hardware.

     You can also support me by sending computer parts. I want a second 
     computer solely for testing purposes. My current second machine is a 
     486 with no PCI slots so that is of little use for testing video cards.
     Please contact me if you think you can help me with hardware.
     The only part I have yet for my second machine is a video card.

     This package may be distributed freely as long as the included files 
     are unmodified and this text file is included.

10.  Acknowledgements

     Mondain for his numerous emails concerning almost every aspect of 
     UniRefresh.

     Wendell Martin Jr with his Voodoo3 for helping me to correct some
     problems with the V3.

     Brian Gregory for helping me to solve various problems with the 
     Banshee.

     Kevin White for helping me sorting out some problems with the 3dfx
     cards. 

     Thanks to all those who gave feedback.
     
11.  Contacting the author
     
     If you have questions/comments, find a bug, have problems with
     UniRefresh or if you just (dis)like UniRefresh sent me an email.
     If you have found a bug don't forget to attach "debug.log" (if
     that file exists in the UniRefresh directory)
     If you have problems/found a bug please give detailed information
     like:
     *   The information returned by the VBE (accessible via the main
         menu)
     *   Type of video card/CPU/operating system
     *   Type of software VBE driver if present
     *   Program with which the problem/bug occurred
     
     
     
     Rob Muller
     Email        : rob.muller@kagi.com
     WWW          : http://unirefresh.demonews.com
     Registration : http://order.kagi.com/?2GC
     
     
     
     

DISCLAIMER

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE DISTRIBUTED "AS IS"
AND WITHOUT ANY WARRANTIES WHETHER EXPRESSED OR IMPLIED. NO
RESPONSIBILITIES FOR POSSIBLE DAMAGES OR EVEN FUNCTIONALITY CAN
BE TAKEN. THE USER MUST ASSUME THE ENTIRE RISK OF USING THIS
PROGRAM. ALL TRADEMARKS ARE PROPERTY OF THEIR RESPECTIVE OWNERS.
