home Support Download pictures credits contact
Logo
 

Support

 
Getting started


1. Requirements:

3D-Rescue needs an Unix or GNU/Linux system with at least GCC verson
3.0 and an recent version of the OpenSceneGraph (OSG) library.

2. Installation:

To compile the program, is is usually sufficient to run the following
commands on a shell:

   ./configure
   make

This should create the binary file 3Drescue.

3. Troubleshooting:

Problem: ./configure fails with one of the following errors:
         Can't find OSG headers.
         Can't find OSG library

Solution:
        Either you don't have the OpenSceneGraph library installed, or
        gcc can't find the library files.

        If you installed OSG, call ./configure with the
        --with-osg=<dir> parameter and specify the location of the
        OSG-files. (Usually this is /usr/ or /usr/local/)




Using the 3D viewer

1. Commandline parameters:

You can get an overview over the available parameters by typing

    ./3Drescue --help

on a console prompt. Some common use-cases are detailed in the following lines.

Online:
Connecting to a kernel (specifiying a port is only necessary if your kernel is not using
the default port):

    ./3Drescue -H <hostname>
    or
    ./3Drescue -H <hostname> -p port

Offline:
Replaying a logfile:

    ./3Drescue -f <rescue.log> -a <action.log>
    or
    ./3Drescue -d <directory>

The second command will search for a rescue.log and action.log in the
specified directory.

Compare a run with a previous one:

   ./3Drescue (-f <filename> | -H <hostname>) -cf <rescue.log>


2. Mouse controls:

3D-View:
Hold the left mousebutton and drag the mouse to rotate the view.
Hold the middle button and drag to pan the view.
Hold the right button and move up/down to zoom.

2D-View:
Click on a building in order to center the 3D-View on this building.

3. Keyboard controls:

3D/2D-View:
q       Quit
,       Reduce speed
.       Increase speed
t       toggle building transparency
f       toggle fires
s       Toggle smoke

3D-View:
<space> Center view

Graph window:
<left>  cycle trough graphs backwards
<right>  cycle trough graphs forwards

4. Color codes

    green   -   civilian or refuge
    red        -   fire brigade or fire department
    yellow  -   police or police office
    white   -   ambulance team or ambulance station