docs: document glMultiDrawElements() fix
[mesa.git] / docs / README.3DFX
index b1145b7f807c9c0db94366d468f8be390dfdee7f..037e8fa7cc6c3a32977cfc2ec026679fc35a4eac 100644 (file)
@@ -3,49 +3,46 @@
 
 
 
-Mesa-6.1 release notes:
------------------------
-
-1) Glide2 support has been ceased; please visit the Glide SourceForge and
-   help us improve Glide3.
-2) The current release is a WIP; among other things, the Linux build works
-   only to some extent. Voodoo Rush not fully supported. Any help will be
-   appreciated.
-3) Although Mesa is designed to work with any Glide3, it would benefit from
-   interacting with newer Glide libraries, which can export functions like:
-   `grGetRegistryOrEnvironmentStringExt', `grSetNumPendingBuffers', Texus2
-   and pointcast palette. The latest Glide3 can be reached here:
-       http://sourceforge.net/projects/glide/
-
+Requirements:
+-------------
 
+A Voodoo-based videocard/accelerator
+DOS (with DJGPP), Windows9x/2k (with MinGW), Linux
+Glide3x library for your OS
 
-Known supported HW/OS:
-----------------------
-
-Voodoo-based videocards/accelerators
-DOS (DJGPP), Windows9x/2k (MinGW/MSVC), Linux
+http://sourceforge.net/projects/glide/
 
 
 
 How to compile:
 ---------------
 
-DJGPP/MinGW:
+DJGPP:
    Place the Glide3 SDK in the top Mesa directory:
-       $(MESA)/glide3/include/*.h
+       $(MESA)/glide3/include/
+               3dfx.h, g3ext.h, glide.h, glidesys.h, glideutl.h, sst1vid.h
        $(MESA)/glide3/lib/
-   Required headers:
-       3dfx.h, g3ext.h, glide.h, glidesys.h, glideutl.h, sst1vid.h
-   Required libraries:
-       OS specific
+               libgld3x.a, libgld3i.a, glide3x.dxe
    Type:
        make -f Makefile.DJ X86=1 FX=1
-       or
+   Look into the makefile for further information.
+
+MinGW:
+   Place the Glide3 SDK in the top Mesa directory:
+       $(MESA)/glide3/include/
+               3dfx.h, g3ext.h, glide.h, glidesys.h, glideutl.h, sst1vid.h
+       $(MESA)/glide3/lib/
+               libglide3x.a, glide3x.dll
+   Type:
        make -f Makefile.mgw X86=1 FX=1
-   Look into the corresponding makefiles for further information.
+   Look into the makefile for further information.
 
 Linux:
    Place the Glide3 SDK in /usr/local/glide
+       /usr/local/glide/include/
+               3dfx.h, g3ext.h, glide.h, glidesys.h, glideutl.h, sst1vid.h
+       /usr/local/glide/lib/
+               libglide3x.a, libglide3x.so
    Type:
        make linux-glide
        or
@@ -60,12 +57,10 @@ FX_DEBUG
        enable driver debug code
 FX_TRAP_GLIDE
        enable Glide trace code
+FX_PACKEDCOLOR
+       use packed color in vertex structure
 FX_TC_NAPALM
-       map GL_COMPRESSED_RGB[A] to FXT1. This will have effect on Napalm
-       only (can coexist with FX_TC_NCC, but has higher priority)
-FX_TC_NCC
-       map GL_COMPRESSED_RGB[A] to NCC. This will have effect on any 3dfx
-       HW (can coexist with FX_TC_NAPALM, but has lesser priority)
+       map GL_COMPRESSED_RGB[A] to FXT1. Works with VSA100-based cards only.
 FX_COMPRESS_S3TC_AS_FXT1_HACK
        map S3TC to FXT1
 FX_RESCALE_BIG_TEXURES_HACK
@@ -93,7 +88,7 @@ default values. Use them only when you experience crashes or strange behavior.
 
 FX_GLIDE_NUM_TMU
        OS: all
-       HW: dual-TMU cards (some Voodoo1, Voodoo2, Avenger, Napalm)
+       HW: dual-TMU cards (Voodoo2, Avenger, Napalm)
        Desc: force single-TMU
        Note: (*)
        Value: "1"
@@ -102,7 +97,7 @@ FX_GLIDE_SWAPPENDINGCOUNT
        HW: all
        Desc: max # of buffers allowed to build up
        Note: (*) (!)
-       Value: "0", "1", "2" or "3"
+       Value: "0", "1", "2", "3", "4", "5" or "6"
 FX_GLIDE_SWAPINTERVAL
        OS: all
        HW: all
@@ -141,6 +136,11 @@ MESA_FX_INFO
        HW: all
        Desc: verbose to stderr
        Value: any; special value "r" to redirect stderr to MESA.LOG
+MESA_FX_NOSNAP
+       OS: all
+       HW: Voodoo1, Rush, Banshee
+       Desc: do not snap vertices inside Mesa
+       Note: to be used with Glide3x that snaps vertices internally
 MESA_FX_POINTCAST
        OS: all
        HW: dual-TMU cards (some Voodoo1, Voodoo2, Avenger, Napalm)
@@ -185,6 +185,25 @@ MESA_FX_MAXLOD
            "9"  - 512x512 textures
            "10" - 1024x1024 textures
            "11" - 2048x2048 textures
+MESA_FX_ALLOW_VP
+       OS: all
+       HW: all
+       Desc: allow vertex program extensions
+MESA_GLX_FX
+       OS: linux
+       HW: Voodoo1, Rush, Voodoo2
+       Desc: display mode
+       Note: (!) experimental
+       Value:
+           "w" - windowed mode
+           "f" - fullscreen mode
+           "d" - disable glide driver
+       OS: win32
+       HW: Rush, Banshee, Avenger, Napalm
+       Desc: display mode
+       Note: (!) experimental
+       Value:
+           "w" - windowed mode