--------------------------------------------------------
Boost.Wrapper HowTo	      State: 10-11 January 2000
--------------------------------------------------------

The aim of this document is to provide all the 
Boost.Wrapper users maximal compatibility while using
the wrapper. Also there is described how to solve probs
while the program runs. This document is valid till the
next release of the Boost.Wrapper. For so long, enjoy!!

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

Content:

1.1 Solving the "Flickering Bug"
	1.2 Why is it happening ?!
	1.3 Solve it...

2.1 Getting Boost.Wrapper to run on all Riva cards
	2.2 Getting the latest drivers
	2.3 Checking the glide2x.dll file
	2.4 Wait for further releases

3.2 FAQ
	3.3 Answers to your questions
	3.4 Ask more

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

Read now:

1.1. Solving the "Flickering Bug"

1.2. Why is it happening ?!
     The flicker bug in the program happens because there 
     are several loops (if, for, while etc) in the code
     of the program. All that loops have tasks to perform.
     i.e. One loops queries the OpenGL hardware you have
     or the other is drawing triangles on the screen perma-
     natly. When switching the window, move it or close it
     the flickering starts. That's because the program ends
     the loops but could not find the end of it and so do
     the same over and over again. (neverending) The result
     is the flickering.

1.3. Solve it...
     You actually can't solve (remove) the bug forever. The
     matter of it is, that it is in the program code and you 
     can't edit it though. What you can do, is avoiding it. 
     Do the following:

     1. Start UltraHle and place it like on the screenshots
        on my site. Then start the game and don't move the
        window anymore. Don't click on the button of the
        wrapper in the taskbar or use tab+alt to switch if
        an existing window lays over that fom the B.W.
        Minimize it or close it by clicking right on it's
        button in the taskbar.
     2. Hit "ESC" after the execution of the wrapper to hear
        sound. Nasty bug, gonna remove that one soon. ;)
     3. After finishing emulation and ending up UltraHle
        just click on the "X" of UHLE window to close it and
        then restart the program if you wish to play another
        game.

     After the next release of the Boost.Wrapper, this hopefully
     won't be necessary any more, so bare with me for so long.


2.1. Getting Boost.Wrapper to run on all Riva cards

2.2. Getting the latest drivers
     At first you should download the latest drivers of your
     Riva board from www.NVidia.com and check them for OGL
     compatibility. Then install them, and set up all the
     needed options for OpenGL in the drivers menu.

2.3. Checking the glide2x.dll file
     Check, that you have unzipped the glide2x.dll file from
     the zip into your "ulrahle" directory. If it is there
     check and if it is necessary remove the write-protection
     of it. Also look in the "Properties"-"Version" for the
     official build an mail me with that information at 
     bwrapper@hotmail.com.

2.4. Wait for further releases
     If all that won't work, and there is no reply of mine for
     1 week ;) wait for the next release of the B.W and expect
     more...


3.2. FAQ
	
3.3. Answers to your questions

     Q.: "Why have I only got 10-18 fps on a PII 400 with a TNT?"
     A.: The B.W is at the beginning of it's development. Down-
         loading it, test it and report the bugs will make it
         better and nicer for everyone. As it's at the beginning
         there are some performace lacks. They will be removed
         and there will be speedups for the final version. Till
         than, bare with me and download the betas and test them!

     Q.: "Why have I just got a bland surface on my screen?"
     A.: see at point 2.1 for solutions

     Q.: "Will this wrapper also work with other cards too?"
     A.: Yes, it'll. You can use the wrapper with every other
         graphic card that suport OpenGL too. But the performace
         will be the best on Riva cards.

     Q.: "When's the next release date?" or "Can you send me ROMS?"
     A.: Don't ask such things. I can't tell you the exact release
         date of the next version of the B.W. As it depends on my
         time and condition, so be happy that there "is" a B.W. and
         be honest too. AND NEVER ASK FOR ROMS !! I WON'T SEND YOU
         ANY AND I WON'T TELL YOU WHERE TO GET SOME !! STOP THAT !!

      That were the most asked questions. Hope some fit to yours too.

3.4. Ask more
     
     More to ask, mail me at: bwrapper@hotmail.com and please write the
     matter of the mail in the subject for fast replying.


--------------------------------------------------------
Document written on the 10 January 2000 by MAD MAX
--------------------------------------------------------