GeoCLODapp

This terrain rendering application is located on the Orléans svn : https://traclifo.univ-orleans.fr/DALIA/

Retrieving the application

You can get the main application there

svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/GEOCLODAPP/ your_local_repository/

A reduced set of data is available for testing purpose

svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/GEOCLODDATA/ your_local_repository/

A complete set of data should be on Mirev nodes under /home/dalia-grenoble/GEOCLODDATA/

A web server used for distant rendering and interaction is also available

svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/geoclodappWebServer/ /var/www/geoclodappWebServer/

There is also a "stand-alone" Qt client for the same purpose

svn co https://traclifo.univ-orleans.fr/svn/DALIA/trunk/geoclodappClient your_local_repository/

Installing and running the application

Dependencies:

• 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)
• For the OpenGL viewer : openMPI
• For the video streaming : libxvidcore
• For advanced and remote interactions : flowvr-vrpn
• A video player able to uncompress an XviD stream through rtsp for remote viewing of the rendering (tested with VLC)

During configuration, cmake will check the dependencies according to which parts of the application you chose to build

Configuring:

mkdir $HOME/builds/GEOCLODAPP
cd $HOME/builds/GEOCLODAPP
ccmake $HOME/sources/GEOCLODAPP -DCMAKE_INSTALL_PREFIX=$HOME/myusr/

• This will open the ccmake interface of the application where you may set different paths/options :
  • CMAKE_INSTALL_PREFIX : the path where the compiled modules will be placed
  • GEOCLODDATA_PATH : the path where the modules will try to find the terrain data
  • BUILD_FLOWVR_VIEWER : let you choose if you want to build the viewer and renderer modules that use flowvr-render
  • 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)
  • 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
  • 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)
• By default, only the flowvr viewer will be activated since it will be the most common use inside the DALIA project.

Compiling:

• after having properly configured the application, you just need to do the usual "make install" command in the build folder
• 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.

Launching:

• 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

  . $HOME/myusr/bin/geoclodapp-config.sh
  

• be sure you got a coherent .csv
• the application is launched basically with "flowvr -x geoclodapp -l"
• if both viewers have been built, you can choose which one you use with the option "viewer" :
  • flowvr -x geoclodapp -s -P geoclodapp:viewer=opengl (for opengl)
  • flowvr -x geoclodapp -s -P geoclodapp:viewer=flowvr (for flowvr-render)
• if the streaming module has been built, you can activate it with the "stream" option :
  • flowvr -x geoclodapp -s -P geoclodapp:stream=yes (if only the openGL viewer is present)
  • 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)

Installing and running the web server

Dependencies:

• The web server needs apache2 and php5 to run properly
• 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.

Configuration :

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