
 ===  3DFX driver for Quake Army Knife (QuArK)  ===

This is a set of tools that let QuArK take advantage of
a 3DFX-accelerated 3D graphic card. For more info about
QuArK please see http://www.planetquake.com/quark/

This is the fourth version (0.4) of these tools.
These tools require QuArK 4.06 or later !

The package contains two files :

 * Qrk3DFX.txt      you are reading it
 * Qrk3DFX.dll      QuArK-to-3DFX-OpenGL driver

Installation :

You must have GL Quake or GL Hexen II installed before
you can install this package. Altough QuArK fully
supports Quake 2 with this package, you need GL Quake
or GL Hexen II because Qrk3DFX.dll requires a file not
distributed with Quake 2.

1) Move the file QRK3DFX.DLL into your QuArK directory.

2) Make a copy of the version of OPENGL32.DLL found in
    your GL Quake or GL Hexen II directory into your
    QuArK directory. If you have both GL Quake and GL
    Hexen II, any one's OPENGL32.DLL will do - it
    doesn't depend on whether you want to make maps for
    Quake or for Hexen II. For example, if C:\QUARK is
    your QuArK directory and C:\QUAKE in your Quake
    directory, then copy C:\QUAKE\OPENGL32.DLL to
    C:\QUARK\OPENGL32.DLL.

3) To select the new 3DFX driver in QuArK, open the
    "3D-viewer" menu and choose "Select 3D viewer" and
    select QRK3DFX.DLL. After this installation steps,
    which you have to do once only, use the 3D viewer
    as usual.


WARNINGS :

 * Do not delete the original OPENGL32.DLL from your
    Quake or H2 directory !

 * Do not use another 3D viewer as long as this new
    version of OPENGL32.DLL is in your QuArK directory !
    In particular, do not use QuArK's default OpenGL
    viewer !


What's new :

Bug fixes. Please report bugs that you already reported
with version 0.3 if they are not fixed in this release.
I can't test these drivers with all versions of the 3DFX
cards ! It is only tested with a Maxi Gamer 3D.

The bug with strange colors should be fixed. The drivers
determine the color scheme used by the 3DFX card at
start-up. There is no more "Invert colors" menu command
(that was useful to nobody anyway, if I'm not wrong).


What were new in previous versions :

Bug fixes, bug fixes, bug fixes. Other new features from
version 0.2 include :

 * No more separated QUARK_3D.EXE program. Rendering is
    now faster. You can delete QUARK_3D.EXE if it's
    still in your Quake or H2 directory from the
    previous installation of version 0.1 of Qrk3DFX.

 * Full editing enabled. I finally found that 3DFX's
    OpenGL routines transpose some 3D-mapping matrices
    for some unknown reason, which is why I couldn't
    get correct result while trying to translate mouse
    clicks into 3D points.

 * "High speed" mode : computes images twice as small
    and then expand them to fit the window. It doesn't
    look very nice (much like 320x240 compared to
    640x480 in Quake) but it's faster. See the
    3D-viewer menu.

 * The 3DFX card cannot compute images larger than
    640x480 pixels. In windows larger than that, a
    black frame will be displayed.


Disclaimer :

Use all this at your own risk. No warranties. Not for
usage with another program than Quake Army Knife.

Author :

Armin Rigo  (arigo@alphanet.ch)
            (NO FILES at this address please !!)

