Download

libQGLViewer installation

libQGLViewer can easily be installed on many architectures. It was successfully installed on Linux, Windows, Mac OS X, SGI IRIX and QNX. Let me know if you encountered problems that could be reported on this page or if you compiled it on another architecture.

libQGLViewer is distributed under the GNU-GPL license and is distributed as-is with no guarantee.

Select your architecture : or see the Qt section

Previous versions of the library are still available in the repository.

Linux and Unix

The easiest way to install the library on Linux is to use the RPM pre-compiled version (see the RPM page for other rpm):

rpm -Uvh libQGLViewer-1.3.4-1.i586.rpm libQGLViewer-devel-1.3.4-1.i586.rpm

You can also directly compile the sources (release 1):

> tar -xzf libQGLViewer-1.3.4.tar.gz
> cd libQGLViewer-1.3.4/src
> qmake [INCLUDE_DIR=...] [LIB_DIR=...] 
> make
> make install

In case of compilation troubles, edit config.h and src.pro.
The default install directories are /usr/local/include/QGLViewer and /usr/local/lib.
The optional INCLUDE_DIR and LIB_DIR parameters let you customize your installation paths (useful if you do not have root privileges).
qmake PREFIX=dir is equivalent to qmake LIB_DIR=dir/lib INCLUDE_DIR=dir/include (example : qmake PREFIX=$HOME).
If your Qt version is lower than 3.1, you need to link with the glut library.
Uncomment a line in src.pro as explained and get the rpm or apt-get libglut3-dev).

Once this is done, compile and test the examples :

> cd ../examples
> qmake [INCLUDE_DIR=...] [LIB_DIR=...] (use the same parameters as above)
> make

Mac OS X

The installation procedure is essentially identical to the one described in the Linux section. The GL and GLUT paths may have to be tuned in config.h and src.pro.

New, June 2003 : Qt is now freely available for Mac OS X architechtures ! Get the latest version to take advantage of all the library features.

Windows

If not already done, check the Tools/Customize/Add-ins and Macro Files/QMsDev Add in box to use Qt
Download the sources libQGLViewer-1.3.4.zip.
Extract the archive and go to the src directory. Qt 2.3 users, see below.
Use the Open Qt project function of MS Visual on src.pro to create a dsp file (if it does not work, try to move the libQGLViewer directory under your Qt directory).
In case of problem, use qmake -win32 -t vclib -o libQGLViewer.dsp src.pro in a DOS console instead.
Open the generated .dsp workspace and compile the library (make sure you select Release as the Build active configuration).
Move files in your standard directories : all the .h include files should go in a QGLViewer directory; QGLViewer.lib and QGLViewer.dll should be moved in a library directory (tune the Tools-Options-Directories-Library path accordingly if needed).
Compile and test the examples, using the same Generate QT project procedure to convert .pro files into .dsp workspaces.
Non-developers can also directly download the QGLViewer-1.3.4.dll.

If your Qt version is lower than 3.1, install the GLUT library (add the paths to GLUT in your Tools-Options-Directories configuration if needed).

New, April 2003 : libQGLViewer now compiles with the free version 2.3 :

Use QGLViewer.pro instead of src.pro to create the .dsp file.
The Qt 2.3 icon says Generate Qt project instead of Open Qt project.
In case of problem, use qmake -win32 -t vclib -o QGLViewer.dsp QGLViewer.pro in a DOS console instead.
Add /GX in Project/Settings/C-C++/General/Project Option to limit warnings.
Edit qglviewer.h and change saveSnapshot() on line ~412.
Compile the library.
When compiling the examples, edit the .pro and remove the end of the file as explained.
Screenshot saving is not supported with Qt 2.3.

If you don't have Qt 3.x, an other option is to install the cigwin linux emulator, with the Qt-KDE port. You should then be able to use the latest Linux version of libQGLViewer (this was not tested, please send me an e-mail if you try).

Qt installation

You need to have the Qt library installed in order to run libQGLViewer. Check the Qt FAQ in case of problem:

Linux and Unix

Qt is probably already installed on your machine, or available on your distribution CDs. You may however have to install the qt3-devel (Mandrake and redhat rpm) or

aptget
libqt3-mt-dev

(debian) development package. The complete Qt/X11 non commercial version can also freely be downloaded.

Try to compile a simple Qt example and check the Qt FAQ page in case of problem. You will probably need to set some Qt variables:

tcsh > setenv QTDIR /usr/lib/qt3 (/usr/share/qt on debian)
bash > export QTDIR=/usr/lib/qt3 (/usr/share/qt on debian)
> set PATH=${PATH}:${QTDIR}/bin/
> set LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${QTDIR}/lib

If only the non-threaded version of Qt is installed on your machine (libqt.so instead of libqt-mt.so), simply remove thread from src/src.pro and examples' .pro.

Windows

Download the free Qt/Windows non commercial version (ver 2.3), or the Qt/Desktop 30 day evaluation version (ver 3.1). Screenshot saving are not supported with the free 2.3 version. There also seems to be a problem with inherited signals in Qt 2.3, and pointers to Frames in KeyFrameInterpolator are hence disabled.

Mac OS X

Download the free Qt/Desktop version for Mac. X11 is also freely available from the apple web site.

Please let me know if you encountered specific installation problems that could be reported on this page.

Last modified on Tuesday, July 22 2003.