1) COMPILING FOR LINUX/UNIX/WINDOWS/PPC ...
===============================================================================

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 as minimum:

	HW-OpenGL 1.2 or later or at least a software-implementation like Mesa
	Qt 4.3 or later; common Linux users should have installed this yet
	GCC 3.4.2 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-3.4.0.tar.gz
	cd zhu3d-3.4.0

	qmake
	make
	make clean

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

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.


2) 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.


3) WINDOWS
===============================================================================

If you fear compiling, there is a precompiled and ready-to-go Zhu3D-package.
Check http://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.
