libQGLViewer installation
linux Unix systems mac

linuxLinux and Unix

RPM installation

The easiest way to install the library on Linux is to use the pre-compiled RPM:
rpm -Uvh libQGLViewer-1.3.8-3.i586.rpm libQGLViewer-devel-1.3.8-3.i586.rpm
This will install the following files: If you want to change the installation prefix, say to /usr/local instead of the default /usr, use rpm -Uvh --prefix /usr/local ... in the above line instead.

Compiling from the tarball sources

You can also directly compile the tarball sources (version 1.3.8, release 3):
tar -xzf libQGLViewer-1.3.8.tar.gz
cd libQGLViewer-1.3.8/QGLViewer
qmake [PREFIX=...] [INCLUDE_DIR=...] [LIB_DIR=...] [DOC_DIR=...]
make
make install
The qmake flags are optionnal and let you customize your installation directories. A typical usage would be qmake PREFIX=$HOME. Here are the default values:
- Flag -      - Default value -
PREFIX        /usr
INCLUDE_DIR   PREFIX/include
LIB_DIR       PREFIX/lib
DOC_DIR       PREFIX/share/doc
If your Qt version is lower than 3.1, you need to link with the glut library : uncomment a line in QGLViewer.pro as explained (glut can be installed with a rpm or apt-get libglut3-dev).

Compiling the examples

Once the library is installed, compile and test the examples:
cd ../examples
qmake [PREFIX=...] [INCLUDE_DIR=...] [LIB_DIR=...]
  # use the same parameters as above, or use
  # qmake INCLUDE_DIR=../.. LIB_DIR=../../QGLViewer if you didn't "make install" the library)
make

Compiling the RPM source package

First install the RPM source package as follows:
rpmbuild --rebuild libQGLViewer-1.3.8-3.src.rpm
cd /usr/src/RPM/RPMS/i586/ (or /usr/src/redhat/RPMS/i586, see the rpmbuild last log lines)
rpm -Uvh libQGLViewer-*1.3.8-3.i?86.rpm
Then, optionally edit the sources to fit your local installation, and then recompile your RPM:
rpm -Uvh libQGLViewer-1.3.8-3.src.rpm
  # Edit /usr/src/[redhat|RPM]/SPECS/libQGLViewer-1.3.8.spec (tune QTDIR, install dir,...)
  # Uncompress the sources in /usr/src/[redhat|RPM]/SOURCES/libQGLViewer-1.3.8.tar.gz, edit, and recompress.
rpmbuild -ba /usr/src/[redhat|RPM]/SPECS/libQGLViewer-1.3.8.spec
rpm -Uvh /usr/src/[redhat|RPM]/RPMS/i?86/libQGLViewer-*1.3.8-3.i?86.rpm

linux   Qt Qt installation

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

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 from Trolltech.

Try to compile a simple Qt example and check the Qt FAQ page in case of problem.

If your shell is tcsh or csh (use echo $SHELL to know), add these lines to your .login:
setenv QTDIR /usr/lib/qt3 (/usr/share/qt on debian)
setenv PATH ${PATH}:${QTDIR}/bin/
setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${QTDIR}/lib
With bash, zsh or sh, add these lines to your .profile:
export QTDIR=/usr/lib/qt3 (/usr/share/qt on debian)
export PATH=${PATH}:${QTDIR}/bin/
export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${QTDIR}/lib
If you installed libQGLViewer in a custom directory, add the path to this directory in LD_LIBRARY_PATH as is done above for ${QTDIR}/lib.

If only the non-threaded version of Qt is installed on your machine (libqt.so instead of libqt-mt.so in ${QTDIR}/lib), simply remove thread from QGLViewer/QGLViewer.pro and examples' .pro.

macMac OS X

The installation procedure is essentially identical to the one described in the Linux tarball section:
tar -xzf libQGLViewer-1.3.8.tar.gz (release 3)
cd libQGLViewer-1.3.8/QGLViewer
qmake [PREFIX=...] [INCLUDE_DIR=...] [LIB_DIR=...] [DOC_DIR=...]
make
make install
See the Linux section for the default parameters values. The GL (and GLUT with old Qt versions) path may have to be tuned in config.h and QGLViewer.pro.

Threads are activated with the darwin-g++ version and disabled with macx. Add or remove thread in the CONFIG section of .pro files if this does not correpond to your configuration.

If your Qt version is lower than 3.1, you need to link with the glut library. Install glut and uncomment a line in QGLViewer.pro as explained.

mac   Qt Qt installation

Qt is available under two versions for the mac architecture : You have to define some variables as is detailed in the Qt linux section. Check their current values first.
If your shell is tcsh or csh (use echo $SHELL to know), add these lines to your .login:
setenv QTDIR /sw (or where ever Qt was installed)
setenv PATH ${PATH}:${QTDIR}/bin/
setenv DYLD_LIBRARY_PATH ${DYLD_LIBRARY_PATH}:${QTDIR}/lib
setenv QMAKESPEC darwin-g++ (or macx-g++ or macx-mwerks or macx-pbuilder)
With bash, zsh or sh, add these lines to your .profile:
export QTDIR=/sw (or where ever Qt was installed)
export PATH=${PATH}:${QTDIR}/bin/
export DYLD_LIBRARY_PATH=${DYLD_LIBRARY_PATH}:${QTDIR}/lib
export QMAKESPEC=darwin-g++ (or macx-g++ or macx-mwerks or macx-pbuilder)
Your QMAKESPEC should correspond to your Qt installation : macx-g++ for Qt/Mac (or macx-mwerks with CodeWarrior, macx-pbuilder with Project Builder) and darwin-g++ for X11. Compile a simple Qt example to check your configuration.

If you installed libQGLViewer in a custom directory, add the path to this directory in DYLD_LIBRARY_PATH as is done above for ${QTDIR}/lib.

Troubleshooting

When installing the QGLViewer library, you may be prompted some dependency error messages. Missing RPMs can be downloaded from these sites : rpmfind.net, pbone.net and Google.

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

Valid XHTML 1.0! Valid CSS! Last modified on Wednesday, July 7, 2004.