1) COMPILING FOR LINUX/UNIX/WINDOWS/PPC et al
===============================================================================

Zhu3D was designed for Linux, but as it is using the powerful Qt-Framework it
can be compiled under different Unices, Windows or Mac OS X too. To make the
compilation process as easy as possible, dependencies are reduced to an
absolute minimum.

A declared goal of Zhu3D is to compile without any single compiler warning
under different systems and compilers. If you face warnings, give me a short
notice please.

What is needed:

	HW-OpenGL 1.2 or later or at least a software-implementation like Mesa
	Qt 4.3.0 or later; common Linux users should have installed this yet
	GCC 3.4.0 or later; respectively MinGW for Windows

The newest version of Qt4 you will find under www.trolltech.com. If everything
is prepared, first untar the package and generate your makefile, then compile
and clean up finally:

	tar zxvf zhu3d-4.1.6.tar.gz
	cd zhu3d-4.1.6

	qmake
	make
	make clean

SSE3: When you want to enable SSE3, switch it on in the file zhu3d.pro before
you go on with qmake, make and make clean. Look at zhu3d.pro for deatils.

HINT: Of course you have to use the "right" qmake for Qt4.x and not some
version from the 3.x-series, which may be installed on many machines too.
When you face troubles, check your version with qmake --version and - if
neccessary - use the correct one instead.

NOTES: For Intel ICC compilers use "qmake -spec linux-icc" instead of qmake.
Look at the file intel-icc.txt for more details.


2) TESTED PLATFORMS
===============================================================================

To ensure release quality and a broad range of compatibility, Zhu3D is tested
on miscellaneous platforms and compilers before being published. Currently these
are:

OS               Bit    CPU          Qt4*    Compiler*     Graphic card
-------------------------------------------------------------------------------
openSuse 11.0    64     Core 2 Duo   4.4.3   gcc 4.3.1     Nvidia 8600 GT
Suse 10.0        32     Athlon XP    4.3.1   icc 10.1      AMD/ATI 9600 XT
Suse 10.0        32     Athlon XP    4.3.1   gcc 4.0.2     AMD/ATI 9600 XT
Windows XP/SP2   32     Athlon XP    4.4.3   mingw 3.4.2   AMD/ATI 9600 XT

*) The Qt 4.4.0 release version had a severe bug (entry 211114) affecting Zhu3D
and German localizations. With version Qt 4.4.1 Trolltech fixed this gracefully.

*) Currently icc 10.1 has quirks with gcc 4.3.x compatibility. See intel-icc.txt
for details. Many, many months have elapsed now, but unfortunately Intel failed
to deliver a patch so far:-(

Quite sure there are more tested platforms as packagers would respond in the case
of failures. If you have a very uncommon or completely uncovered platform, you
may act as additional tester. Please contact zhu3d (at) aon.at for this.

Just for curiosity I tested Zhu3D on virtual machines. On Qemu 0.9.1 it runs slow
due to missing hardware-OpenGL, but near to perfect. With Wine 1.1.0 the bench-
mark even runs a tick faster than in the "original". Wine handles all major tasks,
but some minor things fail however.


3) PACKAGING/TAYLORING
===============================================================================

The work-directory as well as the textures need NO write privileges in
any case, because they easely can be redefined within Zhu3D at runtime.
Look at the file zhu3d.pri for more details.


4) WINDOWS
===============================================================================

If you fear compiling, there is a precompiled and ready-to-go Zhu3D-package.
Check http://www.sourceforge.net/projects/zhu3d/ for this.

Zhu3D needs no installation and does not touch your system settings. All
settings like languages, general appearence or path settings are done
dynamically at runtime and are remembered within Zhu3D itself.

Compiling by yourself is easy and can be done with a few clicks and commands:

- Download and install latest qt-win-opensource-4.x-mingw.exe
- Download and decrompress the zhu3d-x.y.z.tar.gz
- Qt4 contains a folder "imageformats". Search this and copy it as a whole
  into the Zhu3D directory

Now the preparations are done and you are ready to compile. Open a commandline
shell, change into the zuh3d-directory and enter:

	qmake
	mingw32-make
	mingw32-make clean

Thats all. If you wish, you simply can move your zhu3d-directory now wherever
you want.
