building.docu

/*! \page buildingOpenFlipper Building OpenFlipper
 *
 * \section dependencies Dependencies
 * 
 * OpenFlipper is developed on top of the Qt framework. This framework provides
 * easy cross platform development. Therefore an installed version of qt with
 * at least version 4.5 is required. We use the cmake MakeFile generator to build 
 * OpenFlipper.
 *
 * \section reqlibs Required libraries
 * <ul>
 * <li> Qt >= 4.5 ( http://www.qtsoftware.com/downloads )</li>
 * <li> GLUT      ( http://www.opengl.org/resources/libraries/glut/ )</li>
 * <li> GLEW      ( http://glew.sourceforge.net )</li>
 * <li> freetype2 ( optional http://www.freetype.org/freetype2/index.html )</li>
 * <li> ftgl      ( optional http://sourceforge.net/projects/ftgl/)</li>
 * </ul> 
 *
 * \section bs Build System
 * The build system uses cmake to generate all makefiles.
 *
 * \section build_cmake Building OpenFlipper using Cmake
 *
 * For the following section CMake >= 2.6.x has to be installed.
 * In the toplevel directory of OpenFlipper is a CMakeLists.txt
 * file that specifies the build configuration and targets. In most cases
 * this file should be left untouched. Additional functions and environment
 * settings are to be found in the cmake directory in the toplevel folder.
 * See following subsections for information on how to build OpenFlipper
 * for your specific operating system.
 *
 * \subsection cmake_blinux Building OpenFlipper under Linux
 *
 * <ul>
 * <li> First install the required libraries (see above)<br />
 * <li> Extract the source code or get it via svn:<br />
 * <code><b> svn co http://www-i8.informatik.rwth-aachen.de/svnrepo/OpenFlipper/branches/Free OpenFlipper</b></code></li>
 * <li> Create a build directory (e.g. <b>build</b>) in the toplevel directory: <code><b>mkdir build</b></code></li>
 * <li> Change to the newly created directory <code><b>cd build</b></code> and type <code><b>cmake ..</b></code></li>
 * <li> Now call  <b>make</b> to build OpenFlipper </li>
 * </ul>
 *
 * To switch between debug and release build, use <br />
 * <b>cmake -DCMAKE_BUILD_TYPE=Release ..</b><br />
 * <br />
 * To change the install path use<br />
 * <b>-DCMAKE_INSTALL_PREFIX=[path]</b><br />
 *
 * The created application (binaries, libs and shared files) are located in the <b>Build</b>
 * directory.
 *
 * \subsection cmake_bwin Building OpenFlipper under Windows
 *
 * <ul>
 * <li> Get Visual Studio >= 2008 </li>
 * <li> Get and Install Qt ( >= 4.5 , Visual Studio Version ) </li>
 * <li> Set the QTDIR Variable to your Qt Installation directory:<br />
 * <br />
 *      <b>Windows Vista/7:</b> <br />
 *      Open the Control Panel<br />
 *      Select System and Security -> System -> Advanced System settings<br />
 *      Click on "Advanced" tab<br />
 *      At the bottom click on "Environment Variables"<br />
 *      In the bottom window,check if there is already a QTDIR entry and modify it or use "Add" to create it<br />
 *      Set the path to your QT installation directory<br />
 * <br />
 *      <b>Windows XP:</b> <br />
 *      Open the Control Panel<br />
 *      Select System<br />
 *      Click on "Advanced" tab<br />
 *      At the bottom click on "Environment Variables"<br />
 *      In the bottom window,check if there is already a QTDIR entry and modify it or use "Add" to create it<br />
 *      Set the path to your QT installation directory<br />
 * <br />
 * </li>
 * <li> Extract OpenFlipper source code. ( If you want to use svn  you can get a free svn client from http://tortoisesvn.net/downloads ) </li>
 * <li> Download the glew library and install it (The best way is to install it to c:\\libs\\glew directory ).)<br />
        The c:\\libs\\glew\\lib subdirectory should contain the dll and the *.lib files)<br />
        The headers should be located in the c:\\libs\\glew\\include\\gl subdirectory</li>
 * <li> Rearrange the files in the glut-3.7 directory such that)<br />
        all *.lib and *.dll files are in a c:\\libs\\glut-3.7\\lib subdirectory)<br />
        and the glut.h file is moved to the subdirectory c:\\libs\\glut-3.7\\include\\gl\\glut.h</li>
 * <li> Get cmake for windows from http://www.cmake.org/cmake/resources/software.html <li>
 * <li> Start the cmake gui and select the OpenFlipper toplevel directory as source directory </li>
 * \image html cmake-source.png
 * <li> Choose a build directory (e.g. a subdirectory called \c build-release in OpenFlipper's root dir)</li>
 * \image html cmake-builddir.png
 * <li> Click on configure </li>
 * \image html cmake-configuregenerate.png
 * <li>Choose a generator for Visual Studio (according to your Visual Studio version)....</li>
 * \image html cmake-generator.png
 * <li>
 * If the configuration fails because of libraries and/or headers which have not been found, an error message will be printed in the bottom window.
 * You can adjust the paths in cmake-gui manually in the large window. Note that some build variables are only visible in Advanced Mode.
 * You can change view modes of cmake-gui via the select box on the top. </li>
 * <li>Rerun configure until everything is configured correctly and no more red rows or errors are shown.</li>
 * <li> Click generate to create the visual studio project files </li>
 * <li> You can now find a Visual Studio solution file (OpenFlipper.sln) in the <b>build directory</b> directory you chose in cmake.</li>
 * <li> Now you can build OpenFlipper from within Visual Studio using the newly created project file by starting Build Solution. </li>
 * </ul> 
 *
 * Note: If you want to build OpenFlipper as release, you have to set the CMAKE_BUILD_TYPE variable to "Release" before configuring
 * and generating the Visual Studio solution file. Choose then build type "Release" in Visual Studio and build the solution.
 * \image html cmake-buildtype.png
 *
 * \subsection cmake_bmacos Building OpenFlipper under MacOS X
 *
 * <ul>
 * <li> First install the required libraries<br />
 *      To get all required libraries you should use the macports project: http://www.macports.org/ <br />
 *      <br />
 *      Install at least the following ports: <br />
 *      qt4-mac<br />
 *      glew<br />
 *      glut<br />
 *      cmake<br />
 *<br />
 *      As additional ports we recommend the following<br />
 *      ftgl<br />
 *      fftw-3<br />
 *      qwt52<br />
 *      subversion<br />
 *      doxygen<br />
 * <li> Extract the source code or get it via svn:<br />
 * <code><b> svn co http://www-i8.informatik.rwth-aachen.de/svnrepo/OpenFlipper/branches/Free OpenFlipper</b></code></li>
 * <li> Create a build directory (e.g. <b>build</b>) in the toplevel directory: <code><b>mkdir build</b></code></li>
 * <li> Change to the newly created directory ( <code><b>cd build</b></code> ) and type <code><b>cmake ..</b></code> or if you want to build in release mode type <code><b> cmake -DCMAKE_BUILD_TYPE=Release ..</b></code></li>
 * <li> Now call <b>make</b> to build OpenFlipper </li>
 * </ul>
 *
 * The created application bundle (that contains binaries, libs and shared files) can be found in the <b>Build</b>
 * directory.
 *
 * \section cmake_plugin Building OpenFlipper Plugins with CMake
 *
 * Building plugins with CMake is very simple. The OpenFlipper CMake build system
 * expects a CMakeLists.txt file in each of the plugin's directories.
 * So when developing a plugin, just make sure there is a CMakeLists.txt in
 * your plugin's directory. In this file include the global file plugin.cmake
 * which specifies the openflipper_plugin() function:
 *
 * <code>include(plugin)</code>
 *
 * You then have to add the following line which configures the build parameters
 * of your plugin:
 *
 * <code>openflipper_plugin()</code>
 *
 * Note: There are several parameters that one can pass to this function.
 * Usage:
 *
 * \include example/cmake_plugin_usage.txt
 *
 * For a detailed description of the parameters see the CMake documentation.
 * For an example of how to build a simple plugin see \ref ex1.
 *
 */