--------------------
Glide64 readme

Glide64 
Version 0.5 
Developer: Gonetz
Original author: Dave2001
Other coders: Gugaman

Neither I, nor anyone who is working with me, take ANY responsibility for your actions or if this program causes harm to anything, including you and your computer, in any way, physically or mentally.
--------------------

Table of Contents
1. What is Glide64?
2. Why Glide?
3. Will Glide64 work on my computer?
4. What games work with Glide64?
5. Help! What do all these configuration options mean?
6. Can I use Glide64 with a glide wrapper?
7. Can I help with the project?
8. Troubleshooting FAQ
9. Contacting me
10. Glide64 homepage

-------------------
1. What is Glide64?
-------------------

Glide64 is a graphics plugin for Nintendo 64 emulators that allows 3dfx glide card users to run games better than they would be able to with other plugins.

-------------
2. Why Glide?
-------------

Glide is an awesome API Because...

* It is standard throughout all 3dfx cards so that no matter which card you run it on, it will look the same.
* It is insanely fast.
* It is very easy to learn and program in.
* Voodoo cards do not have very good compatability with Direct3D or OpenGL.

------------------------------------
3. Will Glide64 work on my computer?
------------------------------------

Glide64 should work on any computer that uses a 3dfx glide based card.  These are:

3dfx Voodoo Banshee
3dfx Voodoo 1
3dfx Voodoo 2
3dfx Voodoo 3
3dfx Voodoo 4
3dfx Voodoo 5

or any other card based on these.

If you do not have one of these cards, do NOT email me asking if it works, because it probably doesn't.  If you have a card other than the ones listed above, use another plugin instead, or use the eVoodoo 3 glide wrapper.  See section 6 for more details on this.

Note: If you are using a Voodoo 2, you cannot use a resolution higher than 800x600 because it doesn't have enough memory for the z buffer.

--------------------------------
4. What games work with Glide64?
--------------------------------

Glide64 currently supports several uCodes.  As of this release, the uCode # will be automatically detected, so you won't have to worry about setting it.

See compatibility list for a list of games and their current compatibility with Glide64.

------------------------------------------------------
5. Help! What do all these configuration options mean?
------------------------------------------------------

You can hold your mouse over any option in the configuration window to open a tooltip window describing it.  Also shown is the recommended (and default) setting.

Most of the options in the "Debug/Misc" section are for debugging purposes only and should not be set.

------------------------------------------
6. Can I use Glide64 with a glide wrapper?
------------------------------------------

There is now a Glide3x wrapper called eVoodoo 3.
The eVoodoo site is: http://evoodoo.emulation64.com/
Please note that this wrapper is significantly slower than glide and causes problems that are not otherwise there, so do NOT tell me about ANY graphics problems while using this wrapper.  Also, I take no part in the development of this wrapper.

Glide3x is a completely different API than Glide2x, so using a Glide2x wrapper (the ones that worked with UltraHLE) will not work.

-------------------------------
7. Can I help with the project?
-------------------------------

Sure.  Help is always appreciated.  In order to help, you need to know or learn C++ and Glide ON YOUR OWN, and download my sources from my webpage (http://glide64.emuxhaven.net).  You can also find information on how to debug there.  Do not email me until you have actually done something to improve it.  Read the coding rules on the downloads page before mailing me.

----------------------
8. Troubleshooting FAQ
----------------------

1) Glide64 won't initialize or crashes when I try to switch to fullscreen mode.
2) I see red stuff everywhere, what does it all mean?
3) I get a message that says "Error: uCode crc not found in INI..."
4) Why don't I see anything?  The PJ64 window stays blank!

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

Question #1
Q) Glide64 won't initialize or crashes when I try to switch to fullscreen mode.

A) First of all, if you do not have one of these cards, or a card based on one of these, use a different plugin or the Glide3x wrapper (eVoodoo 3) because Glide64 will not work:

3dfx Voodoo Banshee
3dfx Voodoo 1
3dfx Voodoo 2
3dfx Voodoo 3
3dfx Voodoo 4
3dfx Voodoo 5

If you have one of these cards and it still won't work:
1. UPDATE YOUR DRIVERS at www.voodoofiles.com!  This is one of the most common problems people have.  Even if you think you have the most current, update them again!
2. Are you in fullscreen mode?  You MUST be in fullscreen mode to see anything!
3. If you have a Voodoo2, make sure you are not running on a resolution higher than 800x600
4. Look in Ogy's compatibility list to make sure that the game you are trying to run is compatible with Glide64
5. If you are using eVoodoo, expect Glide64 to run worse than it would on a 3dfx-based card.
6. Post the problem on the Glide64 message board
7. Contact me (see below)

Question #2
Q) I see red stuff everywhere, what does it all mean?

A) The "red stuff" is an object that has an unimplemented combine mode.  This just means we haven't looked at it and had time to implement it yet.  One possible solution would be to disable the option "? combiners as red" (unknown combiners as red).

Question #3
Q) I get a message that says "Error: uCode crc not found in INI..."

A) This is because you did not extract the Glide64.ini file into the plugins directory along with the dll, causing the plugin to create a default ini without the uCode autodetection section.  You will not be able to autodetect uCodes unless you extract the INI from the zip file.

Question #4
Q) Why don't I see anything?  The PJ64 window stays blank!

A) This is because Glide cannot be run in a window.  Once you switch to fullscreen mode (Alt+Enter), you will be able to see things.  Also, you can set the 'On loading a ROM go to fullscreen'.

----------------
9. Contacting me
----------------

Post the problem on the message board instead of contacting me if possible!

Only contact me if you really have to!

RULES:
1. NO ROM REQUESTS.
2. NO BETA REQUESTS.
3. No asking if <enter game here> works.
4. No reporting of graphics errors, Glide64 should work mostly the same on all voodoo cards, if it happens on your computer, it also happens on mine.  I can understand breaking this rule if it's something really good.
5. No graphic error reporting while using a Glide3x wrapper. (eVoodoo)

If you still need to contact me, my email address is Gonetz@ngs.ru

--------------------
10. Glide64 homepage
--------------------

The Glide64 homepage is located at:
http://glide64.emuxhaven.net

The Glide64 IRC channel is located on EFnet at #Glide64
NO ROM REQUESTS, NO BETA REQUESTS
