<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>libQGLViewer installation</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<link href="qglviewer.css" rel="stylesheet" type="text/css" />
<link rel="shortcut icon" href="images/qglviewer.ico" type="image/x-icon" />
<link rel="icon" href="images/qglviewer.icon.png" type="image/png" />
</head>
<body>
<table class="banner">
<tr>
<td align="center"><a class="qindex" href="index.html"><b>Home</b></a></td>
<td align="center"><a class="qindex" href="refManual/hierarchy.html"><b>Documentation</b></a></td>
<td align="center" class="qindexHL"><b>Download</b></td>
<td align="center"><a class="qindex" href="examples/index.html"><b>Screenshots</b></a></td>
<td align="center"><a class="qindex" href="developer.html"><b>Developer</b></a></td>
</tr>
</table>
<h1>libQGLViewer installation</h1>
<p>
libQGLViewer can easily be installed on many architectures. It was successfully installed on Linux,
Windows, Mac OS X, SGI IRIX and QNX.
<a href="mailto:Gilles.Debunne at imag dot fr?Subject=QGLViewer installation">Let me know</a> if you
encountered problems that could be reported on this page or if you compiled it on another
architecture.
</p><p>
libQGLViewer is distributed under the <a href="http://www.fsf.org/licenses/">GNU-GPL</a> license and is
distributed as-is with no guarantee.
</p><p>
Select your architecture :
<a href="#linux"><img src="images/linux.png" width="49" height="54" align="middle" alt="linux" border="0"/></a>
<a href="#mac"><img src="images/mac.png" width="55" height="54" align="middle" alt="mac" border="0"/></a>
<a href="#windows"><img src="images/windows.png" width="55" height="54" align="middle" alt="windows" border="0"/></a>
or see the Qt section <a href="#qt"><img src="images/qt.png" width="38" height="40" align="middle" alt="Qt" border="0"/></a>
</p><p>
Previous versions of the library are still available in the <a href="src">repository</a>.
</p>
<a name="linux">
<h2><img src="images/linux.png" width="49" height="54" align="middle" alt="linux"/>Linux and Unix</h2></a>
The easiest way to install the library on Linux is to use the RPM pre-compiled version (see the <a href="rpm.html">RPM page</a> for other rpm):<br/>
<pre>
rpm -Uvh <a href="http://artis.imag.fr/Members/Gilles.Debunne/QGLViewer/src/libQGLViewer-1.3.6-1.i586.rpm">libQGLViewer-1.3.6-1.i586.rpm</a> <a href="http://artis.imag.fr/Members/Gilles.Debunne/QGLViewer/src/libQGLViewer-devel-1.3.6-1.i586.rpm">libQGLViewer-devel-1.3.6-1.i586.rpm</a>
</pre>
<br/>
You can also directly compile the sources :
<pre>
> tar -xzf <a href="http://artis.imag.fr/Members/Gilles.Debunne/QGLViewer/src/libQGLViewer-1.3.6.tar.gz">libQGLViewer-1.3.6.tar.gz</a> (release 1)
> cd libQGLViewer-1.3.6/QGLViewer
> qmake [INCLUDE_DIR=...] [LIB_DIR=...]
> make
> make install
</pre>
<ul>
<li>In case of compilation troubles, edit <code>config.h</code> and <code>QGLViewer.pro</code>.</li>
<li>The default install directories are <code>/usr/local/include/QGLViewer</code> and
<code>/usr/local/lib</code>.</li>
<li>The optional <code>INCLUDE_DIR</code> and <code>LIB_DIR</code>
parameters let you customize these installation paths (useful if you do not have root
privileges).</li>
<li><code>qmake PREFIX=<i>dir</i></code> is equivalent to <code>qmake LIB_DIR=<i>dir</i>/lib
INCLUDE_DIR=<i>dir</i>/include</code> (example : <code>qmake PREFIX=$HOME</code>).</li>
<li>If your Qt version is lower than 3.1, you need to link with the <code>glut</code> library :
uncomment a line in <code>QGLViewer.pro</code> as explained.<br/>
(<code>glut</code> can be installed with a <a href="http://rpmfind.net/linux/rpm2html/search.php?query=glut-devel">rpm</a> or <code>apt-get
libglut3-dev</code>).</li>
</ul>
Once the library is installed, compile and test the <a href="examples/index.html">examples</a> :
<pre>
> cd ../examples
> qmake [INCLUDE_DIR=...] [LIB_DIR=...] (use the same parameters as above, or use
qmake INCLUDE_DIR=../.. LIB_DIR=../../QGLViewer if you didn't "install" the library)
> make
</pre>
<b>Note</b> : You may have to <code>setenv LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/local/lib</code>
since recent distributions (Mandrake 9.2) don't have it.
<b>Attention</b> : Recent gcc compilers (Mandrake 9.2) have a bug and you need to replace
<code>release</code> by <code>debug</code> in the <code>CONFIG += ...</code> line of <code>QGLViewer.pro</code>.
<a name="mac">
<h2><img src="images/mac.png" width="55" height="54" align="middle" alt="mac"/>Mac OS X</h2></a>
The installation procedure is essentially identical to the one described in the <a href="#linux">Linux</a>
section. The <code>GL</code> (and <code>GLUT</code> with old Qt) path may have to be tuned in <code>config.h</code> and
<code>QGLViewer.pro</code>.
<p>
The distributed version is designed for non-threaded versions of Qt. If you compiled Qt with the
thread option, simply look for <code>thread</code> in the <code>macx/CONFIG</code> section of
<code>.pro</code> files.
</p>
<a name="windows">
<h2><img src="images/windows.png" width="55" height="54" align="middle" alt="windows"/>Windows</h2></a>
<ul>
<li>If not already done, check the <i>Tools/Customize/Add-ins and Macro Files/QMsDev Add in</i> box in MSDev to use Qt</li>
<li>Download the sources <a href="http://artis.imag.fr/Members/Gilles.Debunne/QGLViewer/src/libQGLViewer-1.3.6.zip">libQGLViewer-1.3.6.zip</a>.</li>
<li>Extract the archive and go to the <code>QGLViewer</code> directory.</li>
<li>Use the <i>Open Qt project</i> function of MS Visual on <code>QGLViewer.pro</code> to create a
<code>.dsp</code> file.<br/>
<a href="http://www.trolltech.com"><img src="images/qt.png" width="19" height="20" align="middle" alt="Qt" border="0"/></a> version 2.3 :
replace <code>QGLViewer.pro</code> by <code>QGLViewer.Qt2.3.pro</code> and then use <i>Generate Qt project</i>.</li>
<li>In case of problem, use <code>qmake -win32 -t vclib -o libQGLViewer.dsp QGLViewer.pro</code> in a DOS console instead.</li>
<li>Open the generated <code>.dsp</code> workspace and make sure you select
<code>Release</code> as the <code>Build</code> active configuration.
<br/>
<a href="http://www.trolltech.com"><img src="images/qt.png" width="19" height="20" align="middle" alt="Qt" border="0"/></a> version 2.3 :
add <code>/GX</code> in <i>Project/Settings/C-C++/General/Project Option</i> to limit warnings.
<li>Build the library.</li>
<li>Copy <code>QGLViewer.dll</code> in a standard library directory, such as <code>C:\WINNT\system32</code>.</li>
<li>Add the path to <code>libQGLViewer-1.3.6</code> to your
<i>Project-QGLViewer properties-C/C++-General-Additional Include Directories</i>
(<i>Tools-Options-Directories-include files</i> with MSVC 6.0).</li>
<li>Add the path to <code>libQGLViewer-1.3.6\QGLViewer\Release</code> to your
<i>Linker-General-Additional Library Directories</i>
(<i>Tools-Options-Directories-Library files</i> with MSVC 6.0).</li>
<li>Compile and test the <a href="examples/index.html">examples</a>, using the same <i>Generate QT
project</i> procedure to convert <code>.pro</code> files into <code>.dsp</code> workspaces.
<br/>
<a href="http://www.trolltech.com"><img src="images/qt.png" width="19" height="20" align="middle" alt="Qt" border="0"/></a> version 2.3 :
edit the <code>.pro</code> and remove the end of the file as explained.
<br/>
<a href="http://www.trolltech.com"><img src="images/qt.png" width="19" height="20" align="middle" alt="Qt" border="0"/></a> version 2.3 :
screenshot saving is not supported with Qt 2.3.</li>
<!-- <li>Non-developers can also directly download the
<a href="http://artis.imag.fr/Members/Gilles.Debunne/QGLViewer/src/QGLViewer-1.3.6.dll.zip">QGLViewer-1.3.6.dll</a>.</li> -->
</ul>
<p>
If your Qt version is lower than 3.1, install the
<a href="http://www.xmission.com/~nate/glut.html"><code>GLUT library</code></a> (add the paths to
<code>GLUT</code> in your <i>Tools-Options-Directories</i> configuration if needed).
</p><p>
<b>October 2003</b> : The free Qt-2.3 version is no longer distributed by Qt :(<br/>
<b>January 2004</b> : However, this <a
href="http://www.trolltech.com/download/qt/download_noncomm.html">trolltech web page</a> provides a link.
</p><p>
An option is to install the <a href="http://www.cygwin.com/">cigwin</a> linux emulator, with
the <a href="http://kde-cygwin.sourceforge.net/">Qt-KDE</a> port. You should then be able to use the
latest <a href="#linux">Linux</a> version of libQGLViewer. This was successfully tested, althought
Qt had to be recomplied.
</p>
<a name="qt">
<h2><img src="images/qt.png" width="38" height="40" align="middle" alt="Qt" border="0"/>Qt installation</h2></a>
You need to have the <a href="http://www.trolltech.com">Qt</a> library installed
in order to run libQGLViewer. Check the <a href="http://www.trolltech.com/developer/faqs/installation.html">Qt FAQ</a> in case of problem:
<h4><img src="images/linux.png" width="49" height="54" align="middle" alt="linux"/>Linux and Unix</h4>
Qt is probably already installed on your machine, or available on your distribution CDs. You may
however have to install the <code>qt3-devel</code> (Mandrake and redhat rpm) or <code>aptget
libqt3-mt-dev</code> (debian) development package. The complete Qt/X11 non commercial version can
also freely be <a href="http://www.trolltech.com/developer/download/">downloaded</a>.
<p>
Try to compile a simple Qt example and check the
<a href="http://www.trolltech.com/developer/faqs/installation.html">Qt FAQ</a> page in case of
problem. You will probably need to set some Qt variables:
</p>
<pre>
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
</pre>
<p>
If only the non-threaded version of Qt is installed on your machine (<code>libqt.so</code> instead
of <code>libqt-mt.so</code>), simply remove <code>thread</code> from <code>QGLViewer/QGLViewer.pro</code> and examples' <code>.pro</code>.
</p>
<h4><img src="images/mac.png" width="55" height="54" align="middle" alt="mac"/>Mac OS X</h4>
<a href="http://www.trolltech.com/download/qt/mac.html">Download</a> the free Qt/Desktop version for Mac. Qt-X11 is also freely available from the apple web site.
<h4><img src="images/windows.png" width="55" height="54" align="middle" alt="windows"/>Windows</h4>
<a href="http://www.trolltech.com/developer/download/">Download</a> 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 <code>Frames</code> in <code>KeyFrameInterpolator</code> are
hence disabled.
,br/>
With MS Visual Studio 6, you need to check the <i>Tools/Customize/Add-ins and Macro Files/QMsDev Add
in</i> box in MSDev in order to use Qt.
<p>
Please <a href="mailto:Gilles.Debunne at imag dot fr?Subject=QGLViewer RPM">let me know</a> if you
encountered specific installation problems that could be reported on this page.
</p>
<p>
<a href="http://validator.w3.org/check/referer"><img src="images/xhtml.png" alt="Valid XHTML 1.0!" height="31" width="88" border="0"/></a>
<a href="http://jigsaw.w3.org/css-validator/check/referer"><img src="images/css.png" alt="Valid CSS!" width="88" height="31" border="0"/></a>
<i>Last modified on Wednesday, February 11, 2004.</i>
</p>
</body>
</html>
distrib
>
Mandriva
>
10.0
>
i586
>
media
>
contrib
>
by-pkgid
>
9347541fe87a5ea3f3b8dbc50f660e8e
>
files
>
33
