Developer Documentation
Compiling OpenMesh

Tested compilers

OpenMesh has been successfully tested for the following operating systems / compilers. This is only a list of tested compilers. More might be supported but are not tested.

Linux

gcc 4.6.x
gcc 4.7.x
gcc 4.8.x
gcc 4.9.x
clang 3.3
clang 3.4

Windows

Microsoft Visual Studio 2008
Microsoft Visual Studio 2010
Microsoft Visual Studio 2012
Microsoft Visual Studio 2013
Microsoft Visual Studio 2015

Tested MacOS X Compilers

XCode 4.3
XCode 4.4
XCode 4.5
XCode 5.1.1
Apple LLVM version 5.1 (clang-503.0.40) (based on LLVM 3.4svn)

Required libraries (Only for included Apps)

Install the following external libraries / frameworks if you want to use the included Applications:

Qt4/Qt5http://qt-project.org/downloads


Chosing build system

OpenMesh can be built using the cmake build system.

Unix

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

cmake ..            ## Generates the appropriate Makefiles
make                ## Builds the project

You can choose the build type by using cmake with the flag
-DCMAKE_BUILD_TYPE=(Debug|Release)
The default is: Debug
Other flags are:
-DBUILD_APPS=OFF to disable build of applications and
-DCMAKE_INSTALL_PREFIX=<path> to specify the install path.
When calling make install cmake will install OpenMesh into this directory using the subdirectories lib/include/bin.

CMake builds both shared and static under Linux.

Everything will then be build in the Build subdirectory containing the libraries in lib and the binaries in bin.

There are some additional targets:
doc: Builds the Documentation
doc-install: Builds the Documentation and installs it

Note
When you link against the static libraries of OpenMesh and get the error "can not be used when making a shared object; recompile with -fPIC" you need to add "-fPIC" to the CMAKE_CXX_FLAGS. (This is usually added automatically)

Windows

Compiling OpenMesh using CMake

If you want to use cmake to build your Visual Studio 2008 solution file,
download and install CMake from www.cmake.org.
(Note: This is not mandatory since there are already VS2008 solution files included in OpenMesh).

  • Get Visual Studio ( 2008-2013 )
  • Extract OpenMesh source code.
  • Get all required libraries and install them ( including headers! ).
  • Get cmake for windows from http://www.cmake.org/cmake/resources/software.html
  • Start the cmake gui and open the OpenMesh toplevel directory as source directory
  • Choose a build directory (e.g. create a directory called "build" in OpenMesh's root folder)
  • Click on configure .... If any libraries are left unconfigured, you can adjust the path manually. Rerun configure until everything is configured correctly. Attention: Some build variables are only visible in advanced view mode. Select Visual Studio 9 (2008), Visual Studio 10(2010), Visual Studio 11 (2012), Visual Studio 12 (2013) (Depending on your version) as generator.
  • Click generate to create the visual studio project files
  • You can now find a Visual Studio solution file (OpenMesh.sln) in the build directory you chose in cmake
  • Now you can build OpenMesh from within Visual Studio using the newly created project file.

Note: Set the CMAKE_BUILD_TYPE variable to "Release" if you want OpenMesh to be built as release. In Visual Studio choose "Release" in the appropriate select box and build the solution afterwards.



MacOS X

Download and install required libraries as stated above. You can download OpenMesh's sources from www.openmesh.org or check out the latest repository via SVN:
svn co http://www.openmesh.org/svnrepo/OpenMesh/trunk OpenMesh.

Compiling OpenMesh using CMake

We recommend you to use CMake >= 2.8 as build system. This can also easily be installed via MacPorts as well as the Qt >= 4.7 library which is used for some example applications in OpenMesh.
Once installed, change to OpenMesh's root directory and create a directory named e.g. "buildDebug" (assuming you want to build with debug symbols).
Then type in the following command to initially set up the build environment:

cmake ..            ## Generates the appropriate Makefiles

Note: If the build directory is not a subdirectory of OpenMesh's root folder, replace ".." with OpenMesh's absolute (or relative) path. In order to manually set specific build variables, just type:

ccmake .            ## Configure build environment

This opens the CMake configure tool. Change the CMAKE_BUILD_TYPE variable to "Release" in order to prepare build for release configuration. Now, when everything is set up, just type:

make                ## Build OpenMesh

And optionally:

make doc            ## Build OpenMesh's documentation

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.).

CMake builds both shared and static under MacOS X.