-------------------------------------------------------------------
                           glNintendo64()

                A Video Plug-in for N64 Emulators
                             by Orkin
-------------------------------------------------------------------

---------------
 Description
---------------

glNintendo64() is a video plug-in for Nintendo 64 emulators that conform to Zilmar's plug-in specifications v1.3. It is still in relatively early stages, but games like Super Mario 64, Mario Kart, and Star Fox are fully playable, with Zelda 64 and Super Smash Brothers well on their way. The are still many problems though, so if you just want to play some N64 games, I suggest looking for other, more mature plug-ins.

---------------
 Requirements
---------------

Although the plugin will run with any 3-D accelerator card, for several reasons (mostly because I'm lazy), glNintendo64() currently only looks good on nVidia cards supporting the NV_register_combiners extension. This requirement will be removed in subsequent releases...

---------------
 Installation
---------------

Just extract glNintendo64().dll into your desired emulator's plugin folder, select, and run.

---------------
 Compatibility
---------------

Works well with Super Mario 64, Mario Kart 64, and Star Fox 64, possibly others. More advanced games like Banjo-Kazooie, Zelda 64 and Super Smash Brothers are playable, but not very pretty. Feel free to try anything else, but don't be suprised if it doesn't work.

---------------
 Configuration
---------------

Here are explainations of the options in the configuration dialog:

* Full Screen Mode
	Currently disabled (not implemented yet)

* Windowed Resolution

	Tells the plug-in how big to make the rendering window in windowed mode

* Force Bilinear

	Forces bilinear filtering on, even when the ROM says to turn it off

* Wireframe

	Currently disabled (caused the plug-in to crash, will fix later on)

* Alpha Test Sharpness

	Sets the sharpness of alpha tests by changing the value compared against. Overridden when the ROM sets it itself

* Force Microcode

	Allows you to force the microcode in case autodetection fails, not recommended unless you're sure you know what you are doing (could cause the plug-in to crash)

* Show Unsupported Combine Modes in Purple

	Makes unsupported combine modes shown in purple. When disabled, the combiner will use a default combine mode. Really only for debugging purposes.

* Texture cache Size

	Sets the amount of memory to use for texture caching, in megabytes

---------------
 Release Notes
---------------

Version 0.2:

The plug-in has come a long way, but still has a long ways to go. I'm now supporting four microcodes, the texture loading is much better, I have added a config dialog, and fixed many other smaller things. More games are becoming fully emulated, with many more playable, but kinda ugly. Much of the reason why the visual quality is suffering in games like Zelda 64 and Banjo-Kazooie is the lack of multi-texturing support, which is what I'm planning on adding next (along with a new, better, combiner)

For a more complete list of what's new, see the "whatsnew.txt"

Version 0.1:

There's alot I wanted to get into this release that isn't there (i.e. config dialog, fixed ROM browser freezing bug...etc.), but I thought I would go ahead and release before I rewrote the texture loading code. Next release should be much improved over this one, as I'm planning to have much better texture loading, and support for more ucodes (not to mention a config dialog and fixed ROM browser freezing bug).

I know the use of NV_register_combiners will make alot of people unhappy, but it was easier for me this way, and I will add a backup combiner for cards that don't support it later on.

Anyway, for a list of changes, see whatsnew.txt.

---------------
 Credits
---------------

I'd like to give a very special "thank you" to the following people that have aided me during the development of this plug-in, weither through direct contact, or through their source code:

Malcolm, Dave2001, icepir8, zilmar, Azimer, and StrmnNrmn