Recent changes to Installation

Installation modified by Nikolaus Vahrenkamp

Nikolaus Vahrenkamp — Tue, 30 Sep 2014 20:46:17 -0000

--- v52
+++ v53
@@ -107,6 +107,7 @@
 The version 3.1.3 comes with a VS9 solution (located at build/msvc9/). For VS10+ you need to adapt some minor things (see below). Don't forget to set the COINDIR environment variable before building the install project.
   * SoQt: Can be found here: https://bitbucket.org/Coin3D/soqt
  Compile it (be sure the environment variable COINDIR is set properly). The current version (1.5.0) can be compiled with VS9 by using the solution file that is located in build/msvc9/soqt1.sln. 
+  * If you run into troubles compiling Coin3D/SoQt have a look here: [Coin3D_Win_Help](Coin3D_Win_Help)

 _Windows Environment Variables_

Installation modified by Nikolaus Vahrenkamp

Nikolaus Vahrenkamp — Tue, 30 Sep 2014 20:40:42 -0000

--- v51
+++ v52
@@ -100,99 +100,15 @@
 _Download and install dependencies_

   * CMake can be installed with the provided installer: http://www.cmake.org/cmake/resources/software.html 
-  * Boost can be installed with the installers provided here: http://www.boostpro.com/download/ or you can build the libraries from source: http://www.boost.org 
+  * Boost binaries for windows can be found here: http://sourceforge.net/projects/boost/files/boost-binaries/ or you can build the libraries from source: http://www.boost.org 
   * Eigen is a header-only library that can be found here: http://eigen.tuxfamily.org. Eigen must not be configured or installed, it's enough to extract the files. 
   * Qt can be installed via the Qt SDK installer. http://qt-project.org/downloads 
-  * Coin3D: Get the latest release version (currently 3.1.3) from <http: www.coin3d.org="">. For VS compilers up to VS9, there is a page describing how to compile Coin on Windows: http://www.coin3d.org/doc/windows. For VS2010 we found out that you can use the build\msvc9\coin3.sln file (don't forget to set the COINDIR environment variable as described in Coin's windows help page).
-  * SoQt: Download the library from http://www.coin3d.org/lib/soqt/ and compile it (be sure the environment variable COINDIR is set properly). The current version (1.5.0) can be compiled with VS2010 by using the solution file that is located in build/msvc9/soqt1.sln. 
-    
-    If you have issues that some moc_*.icc files are missing, you have to enable the according *.h files in the VS-solution menue. 
-    For some reasons building seems to be disabled for some headers, which is needed for moc'ing: 
-    Right click on the disabled header in the solution menue and select Properties. Then be sure the entry 'Excluded Form build' is set to 'no'.
+  * Coin3D: Coin3D can be found at https://bitbucket.org/Coin3D/coin/wiki/Home
+The version 3.1.3 comes with a VS9 solution (located at build/msvc9/). For VS10+ you need to adapt some minor things (see below). Don't forget to set the COINDIR environment variable before building the install project.
+  * SoQt: Can be found here: https://bitbucket.org/Coin3D/soqt
+ Compile it (be sure the environment variable COINDIR is set properly). The current version (1.5.0) can be compiled with VS9 by using the solution file that is located in build/msvc9/soqt1.sln. 

-If you get an error related to the ScXMLStateMachine class this may help: 
-  
-~~~~~~  
-Change file Coin-3.1.3\src\scxml\ScXMLStateMachine.cpp line 334
-from:
-   transitions.push_back(PImpl::StateTransition(NULL, PRIVATE(this)->initializer.get()));
-to:
-   transitions.push_back(PImpl::StateTransition((ScXMLObject*)NULL, PRIVATE(this)->initializer.get()));
-~~~~~~
-
-If you run into errors related to HAVE_STDDEF_H or HAVE_INT8_T you need to adjust three files: 
-
-Change file build/msvc9/include/Inventor/system/inttypes.h:
-
-~~~~~~
-/* The <inttypes.h> header file. *
-//#define HAVE_INTTYPES_H
-/* The <stdint.h> header file. */
-//////////////////////// CHANGED /////////////////////////////////////////
-#define HAVE_STDINT_H 1
-//////////////////////// CHANGED /////////////////////////////////////////
-
-...
-
-/* If the system defines any of the types "on it's own", the
-   respective #define will be set below. */
-/* #undef HAVE_INT8_T */
-/* #undef HAVE_UINT8_T */
-/* #undef HAVE_INT16_T */
-/* #undef HAVE_UINT16_T */
-/* #undef HAVE_INT32_T */
-/* #undef HAVE_UINT32_T */
-/* #undef HAVE_INT64_T */
-/* #undef HAVE_UINT64_T */
-//////////////////////////// ADDED /////////////////////////////////////
-#define HAVE_INT8_T 1
-#define HAVE_UINT8_T 1
-#define HAVE_INT16_T 1
-#define HAVE_UINT16_T 1
-#define HAVE_INT32_T 1
-#define HAVE_UINT32_T 1
-#define HAVE_INT64_T 1
-#define HAVE_UINT64_T 1
-#define HAVE_INTPTR_T 1
-#define HAVE_UINTPTR_T 1
-//////////////////////////// ADDED /////////////////////////////////////
-~~~~~~
-
-In addition you need to change the files build/msvc9/src/config-debug.h and build/msvc9/src/config-release.h:
-    
-~~~~~~
-/* define this if the type is available on the system */
-/* #undef HAVE_INT16_T */
-
-/* define this if the type is available on the system */
-/* #undef HAVE_INT32_T */
-
-/* define this if the type is available on the system */
-/* #undef HAVE_INT64_T */
-
-/* define this if the type is available on the system */
-/* #undef HAVE_INT8_T */
-
-//////////////////////////// ADDED /////////////////////////////////////
-#define HAVE_INT8_T 
-#define HAVE_UINT8_T 
-#define HAVE_INT16_T 
-#define HAVE_UINT16_T 
-#define HAVE_INT32_T 
-#define HAVE_UINT32_T 
-#define HAVE_INT64_T 
-#define HAVE_UINT64_T 
-//////////////////////////// ADDED /////////////////////////////////////
-
-...
-
-/* Define to 1 if you have the <stdint.h> header file. */
-/* #undef HAVE_STDINT_H */
-//////////////////////////// ADDED /////////////////////////////////////
-#define HAVE_STDINT_H 1
-//////////////////////////// ADDED /////////////////////////////////////
-~~~~~~
-
+   
 _Windows Environment Variables_

 In order to allow smooth development we recommend to setup your windows envrionment variables according to your installation. Check, if the following entries are present at your system:

Installation modified by Nikolaus Vahrenkamp

Nikolaus Vahrenkamp — Tue, 30 Sep 2014 19:29:05 -0000

--- v50
+++ v51
@@ -50,12 +50,6 @@
      With this setup, visualization is disabled and hence, no collision detection can be performed. Nevertheless all operations which do not rely on 3d models, e.g. coordinate transformations, are still available.

-On an Ubuntu 14.04 system you can install the libraries (with coin support) the following way (on other systems the names of the libraries may differ slightly):
-
-~~~~~~~
-sudo apt-get install build-essential libboost-all-dev libeigen3-dev libsoqt4-dev libcoin80-dev cmake cmake-gui libqt4-dev subversion
-~~~~~~~
-
 ## Linux

 Simox is tested on several Ubuntu platforms and there shouldn't be any problems with other distributions (if you observe any strange behaviors, please let us know). 
@@ -63,8 +57,14 @@
   * In order to setup the dependencies, you could either 
     * have a look at the package manager of your distribution (maybe the libs you will need are already installed) 
     * or you install them by _hand_, i.e. compile and install the sources. 
+    * On an Ubuntu 14.04 system you can install the libraries (with coin support) the following way (on other systems the names of the libraries may differ slightly):
+
+~~~~~~~
+        sudo apt-get install build-essential libboost-all-dev libeigen3-dev libsoqt4-dev libcoin80-dev cmake cmake-gui libqt4-dev subversion
+~~~~~~~
+
   * create a build directory, e.g. `<path_to_your_simox_checkout>/build`
-  * Setup your environment variables 
+  * Setup your environment variables (not needed if the dependencies were installed to the standard linux system paths, e.g. when the package management system was used)
     * Eigen3_DIR -> Path to Eigen3 
     * BOOST_ROOT -> The Boost directory 
     * Coin3D_DIR -> The Coin3D library

Installation modified by Nikolaus Vahrenkamp

Nikolaus Vahrenkamp — Tue, 30 Sep 2014 10:24:08 -0000

--- v49
+++ v50
@@ -53,7 +53,7 @@
 On an Ubuntu 14.04 system you can install the libraries (with coin support) the following way (on other systems the names of the libraries may differ slightly):

 ~~~~~~~
-sudo apt-get install build-essential libboost-all-dev libeigen3-dev libsoqt4-dev libcoin80-dev cmake cmake-gui libqt4-dev
+sudo apt-get install build-essential libboost-all-dev libeigen3-dev libsoqt4-dev libcoin80-dev cmake cmake-gui libqt4-dev subversion
 ~~~~~~~

 ## Linux

Installation modified by Nikolaus Vahrenkamp

Nikolaus Vahrenkamp — Mon, 11 Aug 2014 11:03:58 -0000

--- v48
+++ v49
@@ -33,6 +33,7 @@
   * CMake >=2.8.3: A cross-platform, open-source build system. http://www.cmake.org/ 
   * Boost >=1.42: Provides free peer-reviewed portable C++ source libraries. http://www.boost.org 
   * Eigen >=3.0: A header-only C++ template library for linear algebra: matrices, vectors, and numerical solvers. http://eigen.tuxfamily.org 
+

 _Visualization / 3D Model support_

@@ -47,6 +48,13 @@
     * OpenSceneGraph >=3.0: A high performance 3D graphics toolkit. http://www.openscenegraph.org 
   3. No visualization support 
      With this setup, visualization is disabled and hence, no collision detection can be performed. Nevertheless all operations which do not rely on 3d models, e.g. coordinate transformations, are still available. 
+
+
+On an Ubuntu 14.04 system you can install the libraries (with coin support) the following way (on other systems the names of the libraries may differ slightly):
+
+~~~~~~~
+sudo apt-get install build-essential libboost-all-dev libeigen3-dev libsoqt4-dev libcoin80-dev cmake cmake-gui libqt4-dev
+~~~~~~~

 ## Linux

Installation modified by Valerij Wittenbeck

Valerij Wittenbeck — Wed, 02 Jul 2014 10:20:03 -0000

--- v47
+++ v48
@@ -5,11 +5,12 @@
 You have the choice of either installing the simox package from our PPA or by compiling the sources (see below). The PPA/package currently is available only on Ubuntu distributions starting from Precise (12.04) up to and including Trusty (14.04).

 First, add the PPA to your list of repositories and then install the package via apt-get: 
-    
-    sudo add-apt-repository ppa:simox-dev/ppa
-    sudo apt-get update
-    sudo apt-get install simox
-    
+
+~~~~~~
+sudo add-apt-repository ppa:simox-dev/ppa
+sudo apt-get update
+sudo apt-get install simox
+~~~~~~

 Keep in mind that this will only install simox without any special options enabled (e.g. bullet) and with Coin visualization support. 

@@ -17,9 +18,9 @@

 Retrieve the sources with:  

-    
-    svn co https://svn.code.sf.net/p/simox/code/trunk simox
-    
+~~~~~~    
+svn co https://svn.code.sf.net/p/simox/code/trunk simox
+~~~~~~

 Or use a GUI-based SVN client to grab the sources from:  

@@ -62,15 +63,16 @@
     * SoQt_DIR -> the SoQt lib (Has to be compiled with the used Coin3D and Qt version) 
     * QT_QMAKE_EXECUTABLE -> The complete path to the qmake binary file. Usually located at `/bin/qmake` 
     * Simox_DIR -> The path to your simox checkout 
-    * An exemplary setup could look like this (**Adjust the paths according to your setup!**). You can create a simox_setpath.sh file and by calling _source simox_setpath.sh_ all exports are set in your shell environment. 
-    
-            export Eigen3_DIR=~/libs/Eigen3/include/eigen3
-            export QT_QMAKE_EXECUTABLE=~/libs/Qt-4.7.4/bin/qmake
-            export BOOST_ROOT=~/libs/boost/1.47.0
-            export SoQt_DIR=~/libs/Coin3D
-            export Coin3D_DIR=~/libs/Coin3D
-            export Simox_DIR=~/simox
-    
+    * An exemplary setup could look like this (**Adjust the paths according to your setup!**). You can create a simox_setpath.sh file and by calling `source simox_setpath.sh` all exports are set in your shell environment. 
+
+~~~~~~
+       export Eigen3_DIR=~/libs/Eigen3/include/eigen3
+       export QT_QMAKE_EXECUTABLE=~/libs/Qt-4.7.4/bin/qmake
+       export BOOST_ROOT=~/libs/boost/1.47.0
+       export SoQt_DIR=~/libs/Coin3D
+       export Coin3D_DIR=~/libs/Coin3D
+       export Simox_DIR=~/simox
+~~~~~~    

   * Create make files: 
     * go to your build directory: `cd $Simox_DIR`
@@ -79,21 +81,21 @@
   * Compile Simox 
     * Now Simox with all examples can be compiled by typing 'make'. Optionally you can specify how many processes should be used for compiling (e.g. 'make -j4') 
   * IDE 
-    * You can use the make files within your favorite IDE, like Eclipse http://www.eclipse.org or QtCreator http://qt.nokia.com/products/developer-tools/ (which can be used also for non-Qt projects) 
+    * You can use the make files within your favorite IDE, like Eclipse http://www.eclipse.org or QtCreator http://qt-project.org/doc/qt-5/topics-app-development.html (which can be used also for non-Qt projects) 

 ## Windows

 _IDE / Compiler_

-On Windows we recommend the Visual Studio series for development. Microsoft provides a free version, the Visual Studio Express Edition: http://www.microsoft.com/visualstudio/en-us/products/2010-editions/express. (todo: maybe the platform SDK or the Windows SDK have to installed with the VS express edition.) 
+On Windows we recommend the Visual Studio series for development. Microsoft provides a free version, the Visual Studio Express Edition: . (todo: maybe the platform SDK or the Windows SDK have to installed with the VS express edition.) 

 _Download and install dependencies_

   * CMake can be installed with the provided installer: http://www.cmake.org/cmake/resources/software.html 
   * Boost can be installed with the installers provided here: http://www.boostpro.com/download/ or you can build the libraries from source: http://www.boost.org 
   * Eigen is a header-only library that can be found here: http://eigen.tuxfamily.org. Eigen must not be configured or installed, it's enough to extract the files. 
-  * Qt can be installed via the Qt SDK installer. http://qt.nokia.com/downloads 
-  * Coin3D: Get the latest release version (currently 3.1.3) from http://www.coin3d.org. For VS compilers up to VS9, there is a page describing how to compile Coin on Windows: http://www.coin3d.org/doc/windows. For VS2010 we found out that you can use the build\msvc9\coin3.sln file (don't forget to set the COINDIR environment variable as described in Coin's windows help page).
+  * Qt can be installed via the Qt SDK installer. http://qt-project.org/downloads 
+  * Coin3D: Get the latest release version (currently 3.1.3) from . For VS compilers up to VS9, there is a page describing how to compile Coin on Windows: http://www.coin3d.org/doc/windows. For VS2010 we found out that you can use the build\msvc9\coin3.sln file (don't forget to set the COINDIR environment variable as described in Coin's windows help page).
   * SoQt: Download the library from http://www.coin3d.org/lib/soqt/ and compile it (be sure the environment variable COINDIR is set properly). The current version (1.5.0) can be compiled with VS2010 by using the solution file that is located in build/msvc9/soqt1.sln. 

     If you have issues that some moc_*.icc files are missing, you have to enable the according *.h files in the VS-solution menue. 
@@ -101,85 +103,87 @@
     Right click on the disabled header in the solution menue and select Properties. Then be sure the entry 'Excluded Form build' is set to 'no'.

 If you get an error related to the ScXMLStateMachine class this may help: 
-    
-    Change file Coin-3.1.3\src\scxml\ScXMLStateMachine.cpp line 334
-    from:
-        transitions.push_back(PImpl::StateTransition(NULL, PRIVATE(this)->initializer.get()));
-    to:
-        transitions.push_back(PImpl::StateTransition((ScXMLObject*)NULL, PRIVATE(this)->initializer.get()));
-
-
+  
+~~~~~~  
+Change file Coin-3.1.3\src\scxml\ScXMLStateMachine.cpp line 334
+from:
+   transitions.push_back(PImpl::StateTransition(NULL, PRIVATE(this)->initializer.get()));
+to:
+   transitions.push_back(PImpl::StateTransition((ScXMLObject*)NULL, PRIVATE(this)->initializer.get()));
+~~~~~~

 If you run into errors related to HAVE_STDDEF_H or HAVE_INT8_T you need to adjust three files: 

 Change file build/msvc9/include/Inventor/system/inttypes.h:
-    
-    /* The  header file. *
-    //#define HAVE_INTTYPES_H
-    /* The  header file. */
-    //////////////////////// CHANGED /////////////////////////////////////////
-    #define HAVE_STDINT_H 1
-    //////////////////////// CHANGED /////////////////////////////////////////
-    
-    ...
-    
-    /* If the system defines any of the types "on it's own", the
-       respective #define will be set below. */
-    /* #undef HAVE_INT8_T */
-    /* #undef HAVE_UINT8_T */
-    /* #undef HAVE_INT16_T */
-    /* #undef HAVE_UINT16_T */
-    /* #undef HAVE_INT32_T */
-    /* #undef HAVE_UINT32_T */
-    /* #undef HAVE_INT64_T */
-    /* #undef HAVE_UINT64_T */
-    //////////////////////////// ADDED /////////////////////////////////////
-    #define HAVE_INT8_T 1
-    #define HAVE_UINT8_T 1
-    #define HAVE_INT16_T 1
-    #define HAVE_UINT16_T 1
-    #define HAVE_INT32_T 1
-    #define HAVE_UINT32_T 1
-    #define HAVE_INT64_T 1
-    #define HAVE_UINT64_T 1
-    #define HAVE_INTPTR_T 1
-    #define HAVE_UINTPTR_T 1
-    //////////////////////////// ADDED /////////////////////////////////////
-
+
+~~~~~~
+/* The  header file. *
+//#define HAVE_INTTYPES_H
+/* The  header file. */
+//////////////////////// CHANGED /////////////////////////////////////////
+#define HAVE_STDINT_H 1
+//////////////////////// CHANGED /////////////////////////////////////////
+
+...
+
+/* If the system defines any of the types "on it's own", the
+   respective #define will be set below. */
+/* #undef HAVE_INT8_T */
+/* #undef HAVE_UINT8_T */
+/* #undef HAVE_INT16_T */
+/* #undef HAVE_UINT16_T */
+/* #undef HAVE_INT32_T */
+/* #undef HAVE_UINT32_T */
+/* #undef HAVE_INT64_T */
+/* #undef HAVE_UINT64_T */
+//////////////////////////// ADDED /////////////////////////////////////
+#define HAVE_INT8_T 1
+#define HAVE_UINT8_T 1
+#define HAVE_INT16_T 1
+#define HAVE_UINT16_T 1
+#define HAVE_INT32_T 1
+#define HAVE_UINT32_T 1
+#define HAVE_INT64_T 1
+#define HAVE_UINT64_T 1
+#define HAVE_INTPTR_T 1
+#define HAVE_UINTPTR_T 1
+//////////////////////////// ADDED /////////////////////////////////////
+~~~~~~

 In addition you need to change the files build/msvc9/src/config-debug.h and build/msvc9/src/config-release.h:

-    /* define this if the type is available on the system */
-    /* #undef HAVE_INT16_T */
-    
-    /* define this if the type is available on the system */
-    /* #undef HAVE_INT32_T */
-    
-    /* define this if the type is available on the system */
-    /* #undef HAVE_INT64_T */
-    
-    /* define this if the type is available on the system */
-    /* #undef HAVE_INT8_T */
-    
-    //////////////////////////// ADDED /////////////////////////////////////
-    #define HAVE_INT8_T 
-    #define HAVE_UINT8_T 
-    #define HAVE_INT16_T 
-    #define HAVE_UINT16_T 
-    #define HAVE_INT32_T 
-    #define HAVE_UINT32_T 
-    #define HAVE_INT64_T 
-    #define HAVE_UINT64_T 
-    //////////////////////////// ADDED /////////////////////////////////////
-    
-    ...
-    
-    /* Define to 1 if you have the  header file. */
-    /* #undef HAVE_STDINT_H */
-    //////////////////////////// ADDED /////////////////////////////////////
-    #define HAVE_STDINT_H 1
-    //////////////////////////// ADDED /////////////////////////////////////
-    
+~~~~~~
+/* define this if the type is available on the system */
+/* #undef HAVE_INT16_T */
+
+/* define this if the type is available on the system */
+/* #undef HAVE_INT32_T */
+
+/* define this if the type is available on the system */
+/* #undef HAVE_INT64_T */
+
+/* define this if the type is available on the system */
+/* #undef HAVE_INT8_T */
+
+//////////////////////////// ADDED /////////////////////////////////////
+#define HAVE_INT8_T 
+#define HAVE_UINT8_T 
+#define HAVE_INT16_T 
+#define HAVE_UINT16_T 
+#define HAVE_INT32_T 
+#define HAVE_UINT32_T 
+#define HAVE_INT64_T 
+#define HAVE_UINT64_T 
+//////////////////////////// ADDED /////////////////////////////////////
+
+...
+
+/* Define to 1 if you have the  header file. */
+/* #undef HAVE_STDINT_H */
+//////////////////////////// ADDED /////////////////////////////////////
+#define HAVE_STDINT_H 1
+//////////////////////////// ADDED /////////////////////////////////////
+~~~~~~

 _Windows Environment Variables_

Installation modified by Valerij Wittenbeck

Valerij Wittenbeck — Wed, 02 Jul 2014 07:34:06 -0000

--- v46
+++ v47
@@ -202,12 +202,12 @@

 You can use cmake, ccmake (on linux) or cmake-gui for setting up the compilation process. 

-  * Create a build directory (e.g. $Simox_DIR/build) and configure simox with _cmake .._ or by starting _cmake-gui_. 
+  * Create a build directory (e.g. $Simox_DIR/build) and configure simox with `cmake ..` or by starting `cmake-gui`. 
   * Check, if all paths are found correctly. 
   * configure (until all entries are valid) and generate make/solution files 
-  * Compile with _make_ or open generated project files in your IDE (E.g. a cmake visual studio generator will create the following solution file $Simox_DIR/build/Simox.sln) 
+  * Compile with `make` or open generated project files in your IDE (E.g. a cmake visual studio generator will create the following solution file $Simox_DIR/build/Simox.sln) 
   * The libraries will be located at BUILD_DIR/lib and all binaries go to BUILD_DIR/bin 
-  * Debug / Release: On linux and mac you can switch between debug and release by setting the CMAKE_BUILD_TYPE variable either to _Debug_ or to _Release_. When compiling with VisualStudio, you can select the build type within your IDE. 
+  * Debug / Release: On linux and mac you can switch between debug and release by setting the CMAKE_BUILD_TYPE variable either to `Debug` or to `Release`. When compiling with VisualStudio, you can select the build type within your IDE. 

 Here is an exemplary setup with cmake-gui:

Installation modified by Valerij Wittenbeck

Valerij Wittenbeck — Tue, 01 Jul 2014 10:43:10 -0000

--- v45
+++ v46
@@ -54,13 +54,13 @@
   * In order to setup the dependencies, you could either 
     * have a look at the package manager of your distribution (maybe the libs you will need are already installed) 
     * or you install them by _hand_, i.e. compile and install the sources. 
-  * create a build directory, e.g. _/build_
+  * create a build directory, e.g. `/build`
   * Setup your environment variables 
     * Eigen3_DIR -> Path to Eigen3 
     * BOOST_ROOT -> The Boost directory 
     * Coin3D_DIR -> The Coin3D library 
     * SoQt_DIR -> the SoQt lib (Has to be compiled with the used Coin3D and Qt version) 
-    * QT_QMAKE_EXECUTABLE -> The complete path to the qmake binary file. Usually located at /bin/qmake 
+    * QT_QMAKE_EXECUTABLE -> The complete path to the qmake binary file. Usually located at `/bin/qmake` 
     * Simox_DIR -> The path to your simox checkout 
     * An exemplary setup could look like this (**Adjust the paths according to your setup!**). You can create a simox_setpath.sh file and by calling _source simox_setpath.sh_ all exports are set in your shell environment.

Installation modified by Valerij Wittenbeck

Valerij Wittenbeck — Tue, 01 Jul 2014 10:37:22 -0000

--- v44
+++ v45
@@ -29,21 +29,21 @@

 You will need the following libraries installed on your system: 

-  * CMake >=2.8.3: A cross-platform, open-source build system. http://www.cmake.org/ 
-  * Boost >=1.42: Provides free peer-reviewed portable C++ source libraries. http://www.boost.org 
-  * Eigen >=3.0: A header-only C++ template library for linear algebra: matrices, vectors, and numerical solvers. http://eigen.tuxfamily.org 
+  * CMake >=2.8.3: A cross-platform, open-source build system. http://www.cmake.org/ 
+  * Boost >=1.42: Provides free peer-reviewed portable C++ source libraries. http://www.boost.org 
+  * Eigen >=3.0: A header-only C++ template library for linear algebra: matrices, vectors, and numerical solvers. http://eigen.tuxfamily.org 

 _Visualization / 3D Model support_

   1. Coin3D/Qt (**recommended**) 
      For 3D visualization support Simox offers a plugin-like mechanism that can be extended in order to make your favorite 3D library usable. In the current version Coin3D/Qt support is already implemented allowing to handle Open Inventor file formats (.iv, .vrml) in combination with Qt-based GUIs. If you want to use this visualization supported you will additionally need the following libraries: 
-    * Qt >=4.6 (<5): Cross-platform application and UI framework. QT versions>=5 are not yet supported. http://qt-project.org/downloads 
-    * Coin3D >=3.1.3: A high-level, retained-mode toolkit for effective 3D graphics development. https://bitbucket.org/Coin3D/coin 
-    * SoQt >=1.5: A set of Qt GUI bindings for Coin3D library. https://bitbucket.org/Coin3D/soqt 
+    * Qt >=4.6 (<5): Cross-platform application and UI framework. QT versions>=5 are not yet supported. http://qt-project.org/downloads 
+    * Coin3D >=3.1.3: A high-level, retained-mode toolkit for effective 3D graphics development. https://bitbucket.org/Coin3D/coin 
+    * SoQt >=1.5: A set of Qt GUI bindings for Coin3D library. https://bitbucket.org/Coin3D/soqt 
   2. OpenSceneGraph 
      With OpenSceneGraph (OSG) a LGPL library can be used with Simox (instaed of the GPL-library Coin3D). OSG supports several file formats for 3D-model loading, e.g. 3dc, 3ds, flt, geo, iv, ive, lwo, md2, obj, osg, whereas some of them depend on external libraries which must be present on your system. Have a look at OSG's installation and plugin help pages. 
-    * Qt >=4.6 (<5): Cross-platform application and UI framework. QT versions>=5 are not yet supported. http://qt-project.org/downloads 
-    * OpenSceneGraph >=3.0: A high performance 3D graphics toolkit. http://www.openscenegraph.org 
+    * Qt >=4.6 (<5): Cross-platform application and UI framework. QT versions>=5 are not yet supported. http://qt-project.org/downloads 
+    * OpenSceneGraph >=3.0: A high performance 3D graphics toolkit. http://www.openscenegraph.org 
   3. No visualization support 
      With this setup, visualization is disabled and hence, no collision detection can be performed. Nevertheless all operations which do not rely on 3d models, e.g. coordinate transformations, are still available. 

@@ -54,14 +54,14 @@
   * In order to setup the dependencies, you could either 
     * have a look at the package manager of your distribution (maybe the libs you will need are already installed) 
     * or you install them by _hand_, i.e. compile and install the sources. 
-  * create a build directory, e.g. _<path_to_your_simox_checkout>/build_
+  * create a build directory, e.g. _/build_
   * Setup your environment variables 
-    * Eigen3_DIR -> Path to Eigen3 
-    * BOOST_ROOT -> The Boost directory 
-    * Coin3D_DIR -> The Coin3D library 
-    * SoQt_DIR -> the SoQt lib (Has to be compiled with the used Coin3D and Qt version) 
-    * QT_QMAKE_EXECUTABLE -> The complete path to the qmake binary file. Usually located at <QtDir>/bin/qmake 
-    * Simox_DIR -> The path to your simox checkout 
+    * Eigen3_DIR -> Path to Eigen3 
+    * BOOST_ROOT -> The Boost directory 
+    * Coin3D_DIR -> The Coin3D library 
+    * SoQt_DIR -> the SoQt lib (Has to be compiled with the used Coin3D and Qt version) 
+    * QT_QMAKE_EXECUTABLE -> The complete path to the qmake binary file. Usually located at /bin/qmake 
+    * Simox_DIR -> The path to your simox checkout 
     * An exemplary setup could look like this (**Adjust the paths according to your setup!**). You can create a simox_setpath.sh file and by calling _source simox_setpath.sh_ all exports are set in your shell environment. 

             export Eigen3_DIR=~/libs/Eigen3/include/eigen3
@@ -104,9 +104,9 @@

     Change file Coin-3.1.3\src\scxml\ScXMLStateMachine.cpp line 334
     from:
-        transitions.push_back(PImpl::StateTransition(NULL, PRIVATE(this)->initializer.get()));
+        transitions.push_back(PImpl::StateTransition(NULL, PRIVATE(this)->initializer.get()));
     to:
-        transitions.push_back(PImpl::StateTransition((ScXMLObject*)NULL, PRIVATE(this)->initializer.get()));
+        transitions.push_back(PImpl::StateTransition((ScXMLObject*)NULL, PRIVATE(this)->initializer.get()));

@@ -114,9 +114,9 @@

 Change file build/msvc9/include/Inventor/system/inttypes.h:

-    /* The <inttypes.h> header file. *
+    /* The  header file. *
     //#define HAVE_INTTYPES_H
-    /* The <stdint.h> header file. */
+    /* The  header file. */
     //////////////////////// CHANGED /////////////////////////////////////////
     #define HAVE_STDINT_H 1
     //////////////////////// CHANGED /////////////////////////////////////////
@@ -174,7 +174,7 @@

     ...

-    /* Define to 1 if you have the <stdint.h> header file. */
+    /* Define to 1 if you have the  header file. */
     /* #undef HAVE_STDINT_H */
     //////////////////////////// ADDED /////////////////////////////////////
     #define HAVE_STDINT_H 1
@@ -185,10 +185,10 @@

 In order to allow smooth development we recommend to setup your windows envrionment variables according to your installation. Check, if the following entries are present at your system: 

-  * BOOSTDIR -> the boost directory 
-  * COINDIR -> The Coin3D install directory 
-  * QTDIR -> The Qt directory 
-  * Simox_DIR -> The directory where you checked out the simox source code. 
+  * BOOSTDIR -> the boost directory 
+  * COINDIR -> The Coin3D install directory 
+  * QTDIR -> The Qt directory 
+  * Simox_DIR -> The directory where you checked out the simox source code. 
   * The **Path** variable should contain the following entries: 
     * %QTDIR%\bin 
     * %COINDIR%\bin

Installation modified by Valerij Wittenbeck

Valerij Wittenbeck — Tue, 01 Jul 2014 09:52:08 -0000

--- v43
+++ v44
@@ -23,7 +23,7 @@

 Or use a GUI-based SVN client to grab the sources from:  

-    https://svn.code.sf.net/p/simox/code/trunk
+https://svn.code.sf.net/p/simox/code/trunk

 # Install dependencies

@@ -93,7 +93,12 @@
   * Boost can be installed with the installers provided here: http://www.boostpro.com/download/ or you can build the libraries from source: http://www.boost.org 
   * Eigen is a header-only library that can be found here: http://eigen.tuxfamily.org. Eigen must not be configured or installed, it's enough to extract the files. 
   * Qt can be installed via the Qt SDK installer. http://qt.nokia.com/downloads 
-  * Coin3D: Get the latest release version (currently 3.1.3) from http://www.coin3d.org. For VS compilers up to VS9, there is a page describing how to compile Coin on Windows: http://www.coin3d.org/doc/windows. For VS2010 we found out that you can use the build\msvc9\coin3.sln file (don't forget to set the COINDIR environment variable as described in Coin's windows help page). 
+  * Coin3D: Get the latest release version (currently 3.1.3) from http://www.coin3d.org. For VS compilers up to VS9, there is a page describing how to compile Coin on Windows: http://www.coin3d.org/doc/windows. For VS2010 we found out that you can use the build\msvc9\coin3.sln file (don't forget to set the COINDIR environment variable as described in Coin's windows help page).
+  * SoQt: Download the library from http://www.coin3d.org/lib/soqt/ and compile it (be sure the environment variable COINDIR is set properly). The current version (1.5.0) can be compiled with VS2010 by using the solution file that is located in build/msvc9/soqt1.sln. 
+    
+    If you have issues that some moc_*.icc files are missing, you have to enable the according *.h files in the VS-solution menue. 
+    For some reasons building seems to be disabled for some headers, which is needed for moc'ing: 
+    Right click on the disabled header in the solution menue and select Properties. Then be sure the entry 'Excluded Form build' is set to 'no'.

 If you get an error related to the ScXMLStateMachine class this may help: 

@@ -176,17 +181,6 @@
     //////////////////////////// ADDED /////////////////////////////////////

-  
-
-
-  * SoQt: Download the library from http://www.coin3d.org/lib/soqt/ and compile it (be sure the environment variable COINDIR is set properly). The current version (1.5.0) can be compiled with VS2010 by using the solution file that is located in build/msvc9/soqt1.sln. 
-    
-    If you have issues that some moc_*.icc files are missing, you have to enable the according *.h files in the VS-solution menue. 
-    For some reasons building seems to be disabled for some headers, which is needed for moc'ing: 
-    Right click on the disabled header in the solution menue and select Properties. Then be sure the entry 'Excluded Form build' is set to 'no'.
-    
-    
-
 _Windows Environment Variables_

 In order to allow smooth development we recommend to setup your windows envrionment variables according to your installation. Check, if the following entries are present at your system: