MesaFX runtime tuning

The following environment variables affect MesaFX. Those that affect Glide
only, are beyond the scope of this section. Entries that don't have a "Value"
field, can have any value whatsoever
	ex: set MESA_FX_IGNORE_CMBEXT=y

"Note" (*) means that the environment variable affects Glide, too; also, if
the var is not found in the environment, it is searched in windoze registry.
"Note" (!) means that the environment variable is not working as expected;
may have undefined effects, might have effects only at Glide level or might
not have any effect whatsoever. Caveat emptor! Those are to be revised soon.

It is recommended to leave the envvars alone, so that Mesa/Glide will run with
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)
	Desc: force single-TMU
	Note: (*)
	Value: "1"
FX_GLIDE_SWAPPENDINGCOUNT
	OS: all
	HW: all
	Desc: max # of buffers allowed to build up
	Note: (*) (!)
	Value: "0", "1", "2" or "3"
FX_GLIDE_SWAPINTERVAL
	OS: all
	HW: all
	Desc: number of vertical retraces to wait before swapping
	Note: (*) (!) works only at Glide-level?
SSTH3_SLI_AA_CONFIGURATION
	OS: all
	HW: VSA100-based cards
	Desc: SLI/AA setup
	Note: (*) (!) works only at Glide-level?
	Value:
	    1, 2, 4 chip cards
		"0" - SLI & AA disable
		"1" - SLI disabled, 2 sample AA enabled
	    2, 4 chip cards
		"2" - 2-way SLI enabled, AA disabled
		"3" - 2-way SLI enabled, 2 sample AA enabled
		"4" - SLI disabled, 4 sample AA enabled
	    4 chip cards
		"5" - 4-way SLI enabled, AA disabled
		"6" - 4-way SLI enabled, 2 sample AA enabled
		"7" - 2-way SLI enabled, 4 sample AA enabled
		"8" - SLI disabled, 8 sample AA enabled 
SST_DUALHEAD
	OS: win32
	HW: ?
	Desc: ?
	Note: (!) disabled?
MESA_FX_NO_SIGNALS
	OS: linux
	HW: all
	Desc: avoid installing signals
	Note: (!) untested!
MESA_FX_INFO
	OS: all
	HW: all
	Desc: verbose to stderr
	Value: any; special value "r" to redirect stderr to MESA.LOG
MESA_FX_POINTCAST
	OS: all
	HW: dual-TMU cards (some Voodoo1, Voodoo2, Avenger, Napalm)
	Desc: try to use pointcast palette
	Note: may give adverse effects on UMA cards (Avenger, Napalm)
MESA_FX_IGNORE_PALEXT
	OS: all
	HW: all
	Desc: disable 6666 palette
MESA_FX_IGNORE_PIXEXT
	OS: all
	HW: Napalm
	Desc: force 565 16bpp mode (traditional Voodoo, no 32/15bpp)
MESA_FX_IGNORE_TEXFMT
	OS: all
	HW: Napalm
	Desc: disable 32bit textures
MESA_FX_IGNORE_CMBEXT
	OS: all
	HW: Napalm
	Desc: disable Napalm combiners (color/alpha/texture)
	Note: this option allows dual-TMU cards perform single-pass
	      trilinear, but some advanced (multi)texturing modes
	      won't work (GL_EXT_texture_env_combine)
MESA_FX_IGNORE_MIREXT
	OS: all
	HW: all
	Desc: disable mirror extension
MESA_FX_IGNORE_TEXUMA
	OS: all
	HW: all
	Desc: disable UMA
MESA_FX_IGNORE_TEXUS2
	OS: all
	HW: all
	Desc: disable Texus2
MESA_FX_MAXLOD
	OS: all
	HW: non VSA-100 cards
	Desc: enable large texture support using SW rescaling
	Value:
	    "9"  - 512x512 textures
	    "10" - 1024x1024 textures
	    "11" - 2048x2048 textures
MESA_GLX_FX
	OS: linux
	HW: Voodoo1, Rush, Voodoo2
	Desc: display mode
	Note: (!) experimental: "w" may work in Win32 using non-V1/V2 HW
	Value:
	    "w" - windowed mode
	    "f" - fullscreen mode
	    "d" - disable glide driver

Have fun and good luck! :D

dborca 'at' 3dfxzone 'dot' it
koolsmoky 'at' 3dfxzone 'dot' it

http://www.mesa3d.org/
http://www.geocities.com/dborca/