Quake 2 Verite V1000 Renderer (beta 5) - MODIFIED 1/13/98

This is the beta 5 release of ref_v1k.dll (Verite V1000 renderer) for Id Software's Quake 2.
It requires a Rendition Verite-based graphics card (such as the Diamond Stealth II, Canopus 
Total 3D, Sierra Screamin' 3D, Intergraph Intense 3D 100, or Creative Labs 3D Blaster PCI).
It will work on V1000 and V2000-family chips, but is optimized for the V1000 and may not
give increased performance on the V2000.

This new beta fixes problems with transperant water and a few other bugs found in beta 3, and
a incorporates some fixes from Id not present in beta 4.

To install the renderer, just copy the ref_v1k.dll into the directory where you installed 
Quake 2.  Then at the Q2 console, type

    vid_ref v1k

Notes:

ref_v1k requires Verite Windows 95 drivers which support RRedline.  If you do not already 
have drivers from your card manufacturer that support RRedline, check their web site.  If 
they are not yet available, they should be soon.  In the meantime, V1000 reference
drivers can be downloaded from Rendition at http://www.rendition.com/downloads.html.  

Note: Reference drivers are not supported by Rendition or any graphics card manufacturers.  
They are provided for test purposes only, and may not work properly or at all.
Use them at your own risk...

Compatibility issues:
	* Canopus' 2.20.06 drivers have some odd bug that will cause visual anomalies
	  and crashes.  Try the Rendition reference drivers.

	* Creative Labs' RRedline beta drivers from May 8, 1997 have a microcode bug 
	  that prevents particles from being drawn.  You can either get the v10003d.uc 
	  file from Rendition's reference drivers, or use 
		v1k_antialias 4
	  to draw round particles, which do draw correctly

	* Intergraph's RRedline beta drivers have a microcode bug that prevents particles
	  from being drawn.  You can either get the v10003d.uc file from Rendition's
	  reference drivers, or use 
		v1k_antialias 4
	  to draw round particles, which do draw correctly
	  In addition, running the game will corrupt the Windows system palette on 
	  Intergraph's drivers.

ref_v1k will only run on a 16-bit desktop display setting.

Currently only 320x240, 400x300, 512x384, and 640x480 are available.  800x600 is available
on the V2000 family of processors.

400x300 is not supported in fullscreen mode on some drivers.

For some reason, on some machines, if your desktop resolution is 1280x1024, setting Quake 2
to 512x384 full screen will show a black screen.  The game is still running, though, so
you can try to recover.

*** GAMMA
RRedline currently does not support gamma correction in windowed mode.  Most Windows
display drivers, however, have a control panel that will allow you to adjust your desktop
gamma.  If you play in windowed mode and want to adjust the gamma, do it that way.  ref_v1k
will use that gamma setting.

Display buffers will be interleaved if possible on the V1000.  (See note below.)




New command line variable(s)

=============================================

v1k_antialias (default 0)
    will antialias one or more of the world, objects, and particles
	1 = world
	2 = objects
	4 = particles

    add one or more of these together to antialias any combination.  For example:

		v1k_antialias 5

    would antialias the world and particles

v1k_mode
    sets the video mode
	0 = 320x240
	1 = 400x300
	2 = 512x384
	3 = 640x480
	4 = 800x600 (V2x00 only)
	higher res modes are not available in this release

	* Note that 400x300 is not available in fullscreen mode on some cards

v1k_waterwarp (default 1/enabled)
    enables or disables the warp effect when under water

v1k_nopageflip (default 0)
    if set to one, will use copy double buffering rather than page flipping to
    update the display.  This can sometimes be a performance win because the game
    can avoid waiting for vertical retrace.  On the down side, you may see image
    tearing

v1k_surfacelookup (default 1)
    determines whether the Verite (value = 1) or the CPU (value = 0) should
    translate textures into 16 bit format.  This is a performance tweak that gives
    different results at different resolutions and on different processors.  Try
    it for the resolution(s) you like.  Your mileage may vary


***** NEW *****
v1k_refreshrate (default 60)
    Refresh rate in Hz
    determines the refresh rate for fullscreen modes.  Valid values are >= 1.0, but the
    actual refresh rate will be constrained to valid values.  The minimum refresh rate
    is typically 60, so any value below that will give 60Hz.  Any value that is not a
    valid refresh rate for the given mode will select the highest refresh rate below the
    specified value.
    Will not take effect until the next mode set.

=============================================

Other files in this ZIP:

v10003d.uc:  the RRedline microcode which fixes the particle bug on the Creative and
	Intergraph RRedline drivers discussed above.  To prevent problems with other 
	programs, put this file in the Quake 2 directory.

v100032.dll: the DirectDraw driver for the V1000
	If your current display drivers do not support the interleaved display on the V1000, 
	replace the v100032.dll in your windows\system directory with this one.  This driver 
	must be in that directory to function.  Be sure to make a backup of your existing 
	driver before using this one.  Also note that if you are using your card 
	manufacturer's drivers, the name if the driver may be different.  This is a hack,
	and may cause serious problems, so be careful...

Please post bug reports on Rendition's discusion server at http://www.rendition.com/forums.html,
or go directly to news://news.rendition.com/rendition.games.support.quake to see what experiences 
other users have been having. If you can't access the forums, please mail bug reports to 
webmaster@rendition.com

	Frag on...

		Rendition's ISV Team


