First Run

Starting the Virtual Vision Simulator

1. Open up a Terminal and change to the Virtual Vision Simulator directory. Here you will see four directories: config, dependencies, media and src.
2. Now change to the src directory which contains three different applications.
3. We want to run the Virtual Vision Simulator. This can be done by executingthe following command.
   
   python 3D_Simulator.py -d ../config/sample
   You should now see a window showing a view of the Virtual Vision Simulator. The d flag is used to specify the location of the scenario configuration files. A sample scenario is provided in the config/sample directory.

4. Press the left and right arrow keys on the keyboard to toggle between the different cameras. The sample scenario comes with three cameras. A top down view of the scene is also provided.

5. We will now move on to starting the sample client and connecting to the Virtual Vision Simulator.

Starting the sample client

1. Use the left or right arrow keys to change to camera 2. The camera that is being displayed is shown at the top of the image.
2. Open another Terminal window and change to the Virtual Vision Simulator directory.
3. Now change to the src directory.
4. Start a sample client by executing the following command:
   python sample_client.py
   You should now see a window showing the sample clients interface.

5. Try pressing some of the buttons to see what happens.
NOTE: By default, the sample client tries to connect to an active PTZ camera.
6. Open up a third Terminal window
7. Now change to the src directory
8. Start a sample client that connects to a static camera by executing the following command
   python sample_client.py --static
9. A new window will open up with the same interface as before, however pressing the pan/til/zoom buttons will have no effect on the camera. You can only get an image or set the resolution.

Connecting to a Virtual Vision Simulator that is running on a different machine

1. Follow the instructions above to start a Virtual Vision Simulator.
2. Press the i button on your keyboard.
3. You should now see an overlay that shows information about the ip address and port the Virtual Vision Simulator is using as well as information about the cameras that are available.
NOTE: Your computer may have multiple IP addresses, so the right one might not be displayed.
4. Open up another Terminal window and change to the Virtual Vision Simulator directory.
5. Now change to the src directory.
6. Start a sample client by executing the following command:
   python sample_client.py -a 192.168.1.100 -p 9099
   The a flag is used to specify the ip address of the simulation server, while the p flag is used to specify the port.