Installing QGLViewer:
=====================

unzip the file and put it in a directory. Be sure to have your
QTDIR environment variable pointed to your local Qt installation.


Installing using configure:
---------------------------
Just as usual with configure scripts a simple

   ./configure && make && make install

should give you an installed viewer. Try

   ./configure --help

to learn about optional configuration items, you will
like the '--prefix' and perhaps the '--with-moc', '--with-uic',
'--with-includes' and '--with-libs' ones.
Note that you need to have GNU make available, which may
be installed as gmake on your system.


Installation using tmake:
-------------------------
tmake can be obtained from www.troll.no as public software
(latest version is 1.7). Change directory to the directory
where you placed the source directories. To generate the
Makefiles using tmake launch the supplied install-tmake.sh
(or the install-tmake.bat one if you happen to run NT) script:

   ./install-tmake.sh

or alternatively create the makefiles manually

   tmake -o Makefile qglviewer.pro
   tmake -o src/Makefile src/src.pro
   tmake -o examples/Makefile examples/example.pro
   cd examples && make tmake_all && cd ..

Finally, build the library and the example program (you might also use
nmake or gmake depending on your system configuration):

   make


Installation with Windows:
--------------------------

The only way to use QGLViewer with Windows is to compile using
the tmake Makefiles. Proceed as noted above and use the

   install-tmake.bat

script. Of course you need to have tmake (and thus perl) and
Qt installed on your system and environment variables set to
the appropriate paths.

Note that for QGLViewer to work as expected you need to turn
on exception handling and RTTI support within your compiler,
at best include the necessary switches in your tmake config
(its the /GR and /GX flags for MSVC).

Building a Debian Package:
--------------------------

QGLViewer can be built as a debian package using yada. If you 
happen to have a cvs checkout without anything sensible in your 
debian subdirectory, you can create the necessary files with :
yada rebuild [rules,control,..].
