Build instructions

[ Unix/Linux | Windows | qmake ]

This page describes shortly how to build the Mesh Viewer from source on Unix and Windows systems. It is assumed that all required libraries are already installed.

1. Unpack the source code
2. Change to the source directory and depending on the Mesh Viewer version you want to build execute "make":
   • "make GLUT" for building the GLUT version of Mesh Viewer
   • "make QT3" for building the Qt 3 version of Mesh Viewer
   • "make QT4" for building the Qt 4 version of Mesh Viewer

In case the compiler or linker could not find certain include files or libraries, you may need to edit the first lines of the Makefile. "INCPATH" and "LIBPATH" specify where compiler and linker search for include and library files, respectively.

This is a description on how to build Mesh Viewer with Microsoft Visual C++ 2003 and Qt 3.

1. Unpack the source code
2. Generate the Qt meta object source code, which is required for the Qt signal/slot mechanism to work, with the Meta Object Compiler (MOC). MOC is located in the bin directory of your Qt installation, e.g. "c:/Programme/qt-win-free-msvc-3.3.4/bin".

   Generate the moc source code for the following four header files:

   • mview.h
   • viewpointdialog.h
   • coordinates.h
   • glmesh.h
   Example: moc mview.h > mview.moc.cpp
3. Create a new "Windows" project with MS Visual C++
4. Add the Mesh Viewer source code (cpp files from the directories qt3, mesh and mathvector) and generated moc files to the project. Do not add the files in the glut and qt4 directories.
5. Set the following C/C++ compiler options:
   • Add the location of your Qt 3 include files to the include directories
   • Add "WIN32" to the preprocessor definitions (should be standard)
   • Disable precompiled headers
6. Set the following linker options:
   • Add the following libraries to the input libraries (Additional Dependencies):

     From the MS Visual Studio Platform SDK:

     • OpenGL32.Lib
     • Glu32.Lib

     These libraries are located in ...\Microsoft Visual Studio .NET 2003\Vc7\PlatformSDK\Lib

     From Qt 3:

     • qt-mt3.lib
     • qtmain.lib

   • Ignore the "msvcrt" library
   • Set "SubSystem" to "Windows"

Alternatively, qmake can be used for generting a Makefile or project for Microsoft Visual studio. qmake is distributed together with Qt. It is located in the bin directory of your Qt installation.

1. Unpack the source code
2. Change to the source directory and depending on the Mesh Viewer version you want to build execute "qmake":
   • "qmake mview.pro GUI=GLUT" for building the GLUT makefile
   • "qmake mview.pro GUI=QT3" for building the Qt 3 makefile
   • "qmake mview.pro GUI=QT4" for building the Qt 4 makefile
3. Execute "make"

Note that building a makefile for the Qt 3 or Qt 4 version requires the Qt 3 or Qt 4 qmake, respecevely. Generating a Microsoft Visual studio project has not been tested.