Commit b832c5fd authored by Mike Kremer's avatar Mike Kremer

Updated compiling instructions with respect to the new integrated build system support for cmake

git-svn-id: http://www.openmesh.org/svnrepo/OpenMesh/trunk@121 fdac6126-5c0c-442c-9429-916003d36597
parent 8c22bed9
...@@ -35,7 +35,7 @@ The following naming conventions are used for the OpenMesh code: ...@@ -35,7 +35,7 @@ The following naming conventions are used for the OpenMesh code:
\section compilers Tested compilers \section compilers Tested compilers
%OpenMesh has been tested sucessfully for the following operating %OpenMesh has been successfully tested for the following operating
systems / compilers: systems / compilers:
<table> <table>
...@@ -51,13 +51,13 @@ gcc 4.3.x<br> ...@@ -51,13 +51,13 @@ gcc 4.3.x<br>
Microsoft Visual Studio 2008<br> Microsoft Visual Studio 2008<br>
</td></tr> </td></tr>
<tr><td> MacOS X <br>(Panther and Tiger)</td><td> <tr><td> MacOS X <br>(Panther, Tiger and Leopard)</td><td>
gcc 4.0 <br> gcc 4.0 <br>
gcc 4.2 <br>
</td></tr> </td></tr>
</table> </table>
\section sec_compiling_unix Unix \section sec_compiling_unix Unix
Install the following external libraries / frameworks:<br><br> Install the following external libraries / frameworks:<br><br>
...@@ -66,17 +66,56 @@ Install the following external libraries / frameworks:<br><br> ...@@ -66,17 +66,56 @@ Install the following external libraries / frameworks:<br><br>
<tr><td>Qt4</td><td><a href="http://www.qtsoftware.com/downloads" target="_blank">http://www.qtsoftware.com/downloads</a></td></tr> <tr><td>Qt4</td><td><a href="http://www.qtsoftware.com/downloads" target="_blank">http://www.qtsoftware.com/downloads</a></td></tr>
<tr><td>GLEW</td><td><a href="http://glew.sourceforge.net/" target="_blank">http://glew.sourceforge.net/</a></td></tr> <tr><td>GLEW</td><td><a href="http://glew.sourceforge.net/" target="_blank">http://glew.sourceforge.net/</a></td></tr>
</table><br><br> </table><br><br>
In order to compile and install OpenMesh, enter following commands in OpenMesh's root directory:<br><br>
\section build_systems Chosing build system
OpenMesh can be built either using <b>qmake</b> (that already comes along
with the qt framework) or <b>cmake</b>. Since both systems work and will be supported
in future releases, the choice of what build system to use is left to the user.
\subsection linux_using_cmake Compiling OpenMesh using CMake
In order to compile OpenMesh, create a directory named e.g. "build" in
OpenMesh's root directory. Change to the newly created directory and type
<br/><br/>
<tt>
cmake&nbsp;..&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Generates the appropriate Makefiles<br>
make&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Builds the project (use 'make debug' to build debug version)<br>
</tt><br>
The application will be found under "Build/bin" in the recently created build folder.
Build also contains the shared objects needed by the application.
\subsection linux_using_qmake Compiling OpenMesh using QMake
In order to compile OpenMesh, enter following commands in OpenMesh's root directory:<br><br>
<tt> <tt>
qmake&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Generates the appropriate Makefiles<br> qmake&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Generates the appropriate Makefiles<br>
make&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Builds the project (use 'make debug' to build debug version)<br> make&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Builds the project (use 'make debug' to build debug version)<br>
</tt><br> </tt><br>
When using the \c qmake command, make sure to use Qt version 4 (some linux distributions<br> Make sure to use Qt version 4 (some linux distributions<br>
use the link \c qmake-qt4 against the executable). use the link \c qmake-qt4 against the executable).
\section sec_compiling_windows Windows \section sec_compiling_windows Windows
Prerequisites:<br><br> \subsection windows_using_cmake Compiling OpenMesh using CMake
If you want to use cmake to build your Visual Studio 2008 solution file,<br>
download and install CMake from <a href="http://www.cmake.org/cmake/resources/software.html">www.cmake.org</a>.<br>
(Note: This is not mandatory since there are already VS2008 solution files included in OpenMesh).<br><br>
Install the OpenGL Extension Wrangler Library (GLEW) from <a href="http://glew.sourceforge.net" target="_blank">http://glew.sourceforge.net</a>.
<br>
<br>
<ul>
<li>In Microsoft Visual Studio 2008 open <tt> Tools->Visual Studio command prompt </tt></li>
<li>Go to the folder of your application and create a folder named e.g. build and change to it</li>
<li>Now execute <tt>cmake ..</tt> (make sure PATH contains cmake's binary path)</li>
<li>Open the resulting visual studio solution ( *.sln ) which is to be found in the recently created build directory</li>
<li>Choose which build target to use ( Debug/Release )</li>
<li>Choose \c Build \c solution from the build menu</li>
</ul>
\subsection windows_using_qmake Compiling OpenMesh using QMake
If you want to use qmake to build your Visual Studio 2008 solution file,<br> If you want to use qmake to build your Visual Studio 2008 solution file,<br>
download and install the Qt4 framework from <a href="http://www.qtsoftware.com/downloads" target="_blank">Trolltech</a>.<br> download and install the Qt4 framework from <a href="http://www.qtsoftware.com/downloads" target="_blank">Trolltech</a>.<br>
(Note: This is not mandatory since there are already VS2008 solution files included in OpenMesh).<br><br> (Note: This is not mandatory since there are already VS2008 solution files included in OpenMesh).<br><br>
...@@ -93,28 +132,41 @@ for GLEW and GLUT such that they match the installed ones (see comments to find ...@@ -93,28 +132,41 @@ for GLEW and GLUT such that they match the installed ones (see comments to find
<li>Choose \c Build \c solution from the build menu</li> <li>Choose \c Build \c solution from the build menu</li>
</ul> </ul>
\section sec_compiling_macosx MacOSX \section sec_compiling_macosx MacOS X
Download and install the Qt4 framework from <a href="http://www.qtsoftware.com/downloads" target="_blank">Trolltech</a>.<br> Download and install the Qt4 framework from <a href="http://www.qtsoftware.com/downloads" target="_blank">Trolltech</a>.<br>
Because some of the examples depend on the GLEW library, it's recommended to install glew via the darwin portage Because some of the examples depend on the GLEW library, it's recommended to install glew via the darwin portage
system <a href="http://www.finkproject.org" target="_blank">fink</a>.<br> system <a href="http://darwinports.com/" target="_blank">darwin ports</a>.<br>
If you have not installed fink yet, follow the instructions given on their site in order to install it.<br> If you have not installed it yet, follow the instructions given on their site in order to install it.<br>
Type Type
<tt> <tt>
sudo fink install glew sudo port -v install glew
</tt> </tt>
to install glew headers and libraries. ( Fink usually installs header files to \c /sw/include and libraries to \c /sw/lib. )<br> to install glew headers and libraries. ( Darwin ports usually installs header files to \c /usr/local/include and libraries to \c /usr/local/lib. )<br>
<br> <br>
( If you don't want to use fink and install the libraries manually instead -or via darwin ports-, make sure that<br>
the right paths are specified in \c OpenMesh/qmake/packages/packages.Darwin ) \subsection mac_using_cmake Compiling OpenMesh using CMake
If you're using cmake as preferred build system create a directory
named e.g. in OpenMesh's root directory and change to it.
<br/><br/>
<tt>
cmake&nbsp;..&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Generates the appropriate Makefiles<br>
make&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Builds the project (use 'make debug' to build debug version)<br>
</tt><br>
The mac application bundle will be found under "Build" in the recently created build folder.
It automatically contains all needed shared objects (libs, fonts, textures, etc.).
\subsection mac_using_qmake Compiling OpenMesh using QMake
Adapt the header paths of at least GLEW (optional freetype, FTGL,...) in file <b>OpenMesh/qmake/packages/packages.Darwin</b>.
<br><br> <br><br>
In order to compile and install OpenMesh, open a Terminal window and enter following commands in OpenMesh's root directory:<br><br> In order to compile and install OpenMesh, open a Terminal window and enter following commands in OpenMesh's root directory:<br><br>
<tt> <tt>
qmake -spec macx-g++&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Generates the appropriate Makefiles<br> qmake -spec macx-g++&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Generates the appropriate Makefiles<br>
make release&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Builds the project (use 'make debug' to build debug version)<br> make&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;## Builds the project (use 'make debug' to build debug version)<br>
</tt> </tt>
**/ **/
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment