| | 1 | = GeoCLODapp = |
| | 2 | |
| | 3 | This terrain rendering application is located on the Orléans svn : https://traclifo.univ-orleans.fr/DALIA/ |
| | 4 | |
| | 5 | == Retrieving the application == |
| | 6 | |
| | 7 | You can get the main application there |
| | 8 | {{{ |
| | 9 | svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/GEOCLODAPP/ your_local_repository/ |
| | 10 | }}} |
| | 11 | |
| | 12 | A reduced set of data is available for testing purpose |
| | 13 | {{{ |
| | 14 | svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/GEOCLODDATA/ your_local_repository/ |
| | 15 | }}} |
| | 16 | |
| | 17 | A complete set of data should be on Mirev nodes under '''/home/dalia-grenoble/GEOCLODDATA/''' |
| | 18 | |
| | 19 | A web server used for distant rendering and interaction is also available |
| | 20 | {{{ |
| | 21 | svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/geoclodappWebServer/ /var/www/geoclodappWebServer/ |
| | 22 | }}} |
| | 23 | |
| | 24 | There is also a "stand-alone" Qt client for the same purpose |
| | 25 | {{{ |
| | 26 | svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/geoclodappClient your_local_repository/ |
| | 27 | }}} |
| | 28 | |
| | 29 | == Installing and running the application == |
| | 30 | |
| | 31 | Dependencies: |
| | 32 | - General : OpenGL, QT, flowvr, flowvr-render (even when not using the flowvr-render renderer the application needs parts of the ftl which is included in it) |
| | 33 | - For the OpenGL viewer : openMPI |
| | 34 | - For the video streaming : libxvidcore |
| | 35 | - For advanced and remote interactions : flowvr-vrpn |
| | 36 | - A video player able to uncompress an XviD stream through rtsp for remote viewing of the rendering (tested with VLC) |
| | 37 | |
| | 38 | During configuration, cmake will check the dependencies according to which parts of the application you chose to build |
| | 39 | |
| | 40 | |
| | 41 | Configuring: |
| | 42 | |
| | 43 | {{{ |
| | 44 | mkdir $HOME/builds/GEOCLODAPP |
| | 45 | cd $HOME/builds/GEOCLODAPP |
| | 46 | ccmake $HOME/sources/GEOCLODAPP -DCMAKE_INSTALL_PREFIX=$HOME/myusr/ |
| | 47 | }}} |
| | 48 | - This will open the ccmake interface of the application where you may set different paths/options : |
| | 49 | * CMAKE_INSTALL_PREFIX : the path where the compiled modules will be placed |
| | 50 | * GEOCLODDATA_PATH : the path where the modules will try to find the terrain data |
| | 51 | * BUILD_FLOWVR_VIEWER : let you choose if you want to build the viewer and renderer modules that use flowvr-render |
| | 52 | * BUILD_OPENGL_VIEWER : let you choose if you want to build the viewer/renderer module that uses opengl (if neither of the two viewers are selected, cmake will issue an error message) |
| | 53 | * BUILD_STREAMING_SUPPORT : let you choose if you want to build the streaming module which permit to view remotely the rendering through a video stream |
| | 54 | * BUILD_VRPN_INTERACTIONS : let you choose if you want to build the modules that use flowvr-vrpn for advanced interaction modes (Joypad and Phantom peripherals support, and NetDevice support which let you interact remotely with the application through a simple web page) |
| | 55 | - By default, only the flowvr viewer will be activated since it will be the most common use inside the DALIA project. |
| | 56 | |
| | 57 | Compiling: |
| | 58 | - after having properly configured the application, you just need to do the usual "make install" command in the build folder |
| | 59 | - the configuration file ''geoclodappConfig.cmake'' will be generated in the ''$HOME/myusr/share/flowvr/cmake'' folder. Projects reusing modules of GEOCLODAPP will need this file to use them. |
| | 60 | |
| | 61 | Launching: |
| | 62 | |
| | 63 | - before launching the application, you must execute the script "geoclodapp-config.sh" (automatically generated in the "bin" sub-folder of the installation folder during the configuration step) which sets up various environnement variables, or add it you your ''.bashrc'' |
| | 64 | {{{ |
| | 65 | . $HOME/myusr/bin/geoclodapp-config.sh |
| | 66 | }}} |
| | 67 | - be sure you got a coherent .csv |
| | 68 | - the application is launched basically with "flowvr -x geoclodapp -l" |
| | 69 | - if both viewers have been built, you can choose which one you use with the option "viewer" : |
| | 70 | * flowvr -x geoclodapp -s -P geoclodapp:viewer=opengl (for opengl) |
| | 71 | * flowvr -x geoclodapp -s -P geoclodapp:viewer=flowvr (for flowvr-render) |
| | 72 | - if the streaming module has been built, you can activate it with the "stream" option : |
| | 73 | * flowvr -x geoclodapp -s -P geoclodapp:stream=yes (if only the openGL viewer is present) |
| | 74 | * flowvr -x geoclodapp -s -P "geoclodapp:viewer=opengl geoclodapp:stream=yes" (if both viewers have bben built, since the streaming only works with the opengl viewer) |
| | 75 | |
| | 76 | |
| | 77 | == Installing and running the web server == |
| | 78 | |
| | 79 | Dependencies: |
| | 80 | - The web server needs apache2 and php5 to run properly |
| | 81 | - The clients who will connect to the web page will need to have the VLC media player and the vlc-mozilla plugin in order to view the video stream inside this web page. |
| | 82 | |
| | 83 | Configuration : |
| | 84 | - The web server need to be installed on the /var/www/geoclodappWebServer folder. It needs to be one a computer where geoclodapp is installed and built with streaming and remote interactions support. |
| | 85 | - After having retrieved the server, you need to run the "configure.sh" script located in /var/www/geoclodappWebServer/ It will try to find the environnement variables set by the "set-geoclodapp-env.sh" script. If it can't, it will ask to enter manually several paths and parameters. |
