docs/README.D3D

                     DirectX 6 Driver for Mesa 3.0


This software is distributed under the terms of the GNU Library
General Public License, see the LICENSE file for details.



What do you need ?
------------------

	- A PC with a DirectX 6 video driver installed.

	- Mesa 3.0

	- The 3Dfx Glide library 2.3 or later for your OS (the 2.4 works fine).
	  The Voodoo2 requires the Glide library 2.51. The Glide 3.0 is not
	  compatible with the Glide 2.x so it doesn't work with the current
	  version of the driver;

	- Visual C++ 5.0 is only compiler test but others should be ok with
       changes to the makefiles (CFLAGS/LFLAGS).

	- DirectX 6 SDK (was a MS download but not sure if still available).

	- SoftIce or another debugger that will get DPF's is nice.


Tested on:
----------
	Windows 95
  	Windows 98
	Windows NT 5.0 (beta 2)


What is able to do ?
--------------------

	- the driver will try and use DirectX to rasterize the OpenGL primitives
	that are sent to the driver.  The driver will fall back to SW  if the rendering 
	context is too big.  The fallback to SW still uses DirectDraw.  If the driver
	fails to support and operation (accum, stencil, etc) then it will try and get
	Mesa to render it in SW.  DirectX 6 features that are unsupported by the 
	installed DirectX 6 driver will be mapped to some other best fit feature.


How to compile:
---------------

	These instructions assume you have Visual C++ installed.

	  You might need to increase you enviroment space.  You can do this by 
	adding the following statement to you config.sys.

	shell=C:\COMMAND.COM C:\ /p /e:8198

	  Next setup you compiler enviroment by running vcvars32.bat in the Visual C++
 	'bin' directoy.

	c:\DevStudio\VC\bin\vcvars32.bat

	  Modify the D3D makefile to point at your SDK install.  Example has the SDK
	installed on my 'f' drive in the root.

	file: \Mesa-3.0\src\makefile.d3d

	SDKROOT=f:\mssdk

	  Now you can simply make the project.  If you look in the makefile you can see
	I have some different targets like 'install'.  

	nmake /f makefile.d3d


FAQ:
----

	1) I don't think the driver is using my DirectX driver.

 	  This maybe true as the current version will only select the Primary D3D driver
	installed.  If you 3D card is the secondary (3dfx) then your out of luck for this
	release.

	2) The driver seems like its not HW accelerated.

	  If you have a video card with limited memory then you might want to try and 
	change your destop resolution to a low setting (640x480x16) so that the 3D part
	of the card has more resources.  Remeber the driver can't make the card better...

	3) Nothing works.

	  Make sure you have a DirectX '6' driver installed.  Check you driver docs for this
	info or use the SDK info utilities.
	  The final 'dll' is named opengl32.dll and is either in the same directory as the 
	OpenGL program or in your system directory (x:\windows\system or x:\winnt\system32).
	  Check your destop resolution.  Most DirectX 6 drivers will only support 16bit and
	32bit color depth.  To find out for sure you can check the DirectX Info Viewer in
	the SDK.
	  

	4) Rendering doesn't look right.

	  Sometimes this is because the card doesn't support a feature that that is required.
	This is usually due to unsupported alpha functions (test/blend) or texture mapping.
	Some cards suffer from too small of an alpha channel.  The driver does its best to
	fallback on unsupported features.  This is not to say the driver may not have a bug(s).

	5) Textures look bad.

	  No mipmapping in this release.


Thanks to:
----------

Brian Paul




Leigh McRae (leigh@altsoftware.com)
February 9, 1999