REQUIREMENTS, DOCUMENTATION & GENERAL
==================================================================================

Zhu3D runs under Linux/Unix, Windows 98-XP and Mac OS X and supports different
CPU's as well as different API's like KDE, Gnome or Motiv. Your operating system
must support OpenGL or at least a compatible software implementation like Mesa.

The absolute minimum screen-size is 1024x768. Hardware accelerated OpenGL is
recomended, but a reasonably newer card from the DirectX8/9-generation will do
the job. For simple viewing even an ancient PC without HW-OpenGL is sufficient.
But with enabled motion blur, big textures and doing heavy animations with
narrow grids you will need any CPU/GPU-power you can get.

Have a look in the doc-directory for further information! In your work-directory
you will find a lot of commented examples.

The strange program name was inspired by Zhu Shijie, a genius ancient Chinese
mathematician. If you are interested, you find some historic remarks in the help.


HINTS
==================================================================================

Zhu3D is pretty stable and reliable. Nevertheless some hints and observations:

Due to driver issues under Linux some AMD/ATI-cards may fail, when HW-acceleration
is turned on. Updating your old ATI-driver will mostly solve this problem and is
strongly recommended anyhow.

When handling mathematically "strange" functions or moving to "huge" number-
regions, tessellation may result in odd views. The documentation gives further
hints, how to handle those extreme cases.

PostScript file-generation and/or printing is somehow depending on your printer/
driver-backend. These may crash, when print/file dimensions are too big. Under
Windows my configuration printed up to a 8000x8000 resolution without problems,
under my current Linux e.g only up to 2000x2000.

Compared to function- and parameter-mode texturing in iso-mode works somehow
different. This is not an error. Applied in iso-mode the texture mapping as a
matter principal never can be as perfect as in the other modes. Nevertheless
interesting effects are possible.


WINDOWS PECULIARITIES/LIMITATIONS
==================================================================================

Sorry Windows-folks, there are some deficiencies and peculiarities I did not want
to fiddle arround. So you have to face some (very small) limitiations:

* Under Windows - especially the older versions - the measuring of the GPU/CPU-
utilization may be a bit erratic. In this field the Linux timers perform somehow
better (up to factor 18000) in terms of precision.

* Textures are a grain more brilliant under Linux/Unix.

* Postscript as output file format is supported under Linux/Unix only.

* The compiler or the system-libraries are failing in the range of really high
precision calculations. Due to this phenomenon the solver-precision is limited
to 11 digits.

* Under Linux/KDE language support for Chinese works out of the box. Windows users
have to play a little install/reboot-adventure for the East-Asian language pack
before.

* Morphing: There may be some (very rare and special) combinations of user driven
events, where Zhu3D even may crash. I did a lot to prevent this, but my Windows XP/
SP2 behaves like a princess when it comes to precise and quick thread/timer-
reactions (see above).



PROGRAMMING
==================================================================================

A short word to Qt4 from Trolltech: As I really dislike non-portable code, I
hardly ever wrote GUI-programs. This project initially was started to test if
the promises from Trolltech hold true. They do. It is a powerful GUI-framework
for platform-independent solutions. Even without prior experience, I managed to
port my old C-code-basis within a few days.


NEW VERSIONS
==================================================================================
Currently updates are found under www.kde-apps.org/content/show.php?content=43071
what may change in future. Look at www.qt-apps.org than or just google in this
case. A detailed version history you will find under ./src/changelog.txt


CONTACT
==================================================================================

If you have wishes, suggestions or just a supernice graph you want to share, mail
to: zhu3d(at)aon.at. I will try to respond as reliable as I can, but don't put a
hat on a hen. Sometimes I am simply under stress with my regular work.


LICENSE
==================================================================================

This program may be used under the terms of the GNU General Public License version
2 as published by the Free Software Foundation and appearing in the file
license.gpl included in this package.

This program is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

(C) 1991-2007 Heinz van Saanen