Skip to content

Volumetric Capture Application

perukas edited this page Jan 21, 2019 · 15 revisions

Volumetric Capture Application User-Guide

First time usage: Once you have installed all the required software packages:

1. Name each Intel RealSense Device and save their intrinsic parameters

  • Plug an Intel RealSense device on the Workstation-PC to add the connected device to the device repository.
  • Follow instructions on Device Repository Page to add a device to the Device Repository
  • Repeat for all the devices you are going to use.

If the devices' intrinsic parameters are not saved in the device repository you will not be able to calibrate the system

2. Starting the Volumetric Capture application

  • First, make sure that the devices are plugged on the Intel NUCs, and that each NUC mini-PC as well as the Workstation-PC are connected to the Network switch.
  • When you first start the Volumetric Capture application it should connect automatically to the RabbitMQ broker running on the Workstation-PC. If that is not the case, or if RabbitMQ broker runs on a different PC, you can start the application from a command-line with the following arguments:

volumetric_capture.exe -b <rabbit_mq_broker_local_ip> -u <rabbit_mq_username> -p <rabbit_mq_password>

  • The application's GUI when the application starts:

accessibility text

  • The GUI is divided in widgets. Each widget is responsible for a different aspect of the application workflow.

accessibility text

  1. Device Connection Manager Widget

  2. Connected Devices Widget

  3. Device Parameters Widget

  4. Record Widget

  5. Workflow Parameters Widget

  6. Viewport Control Widget

Application Workflow

1. Connection Manager Widget

When you first start the application, each of the named devices should appear on the Connection Manager Widget. From this widget you can connect all of the devices at once, or connect each device separately. In addition, you can modify the devices' connection Profile, or configure which device should be the Master device when using HW sync.

  • Connect a device:

accessibility text

In order to connect a device you have to select which device to connect by clicking on the checkbox next to that device, and click the "Connect" Button. If you want to connect all of the devices at once, you can click the "Connect All" Button.
  • Changing the Connection Profile.

accessibility text

Connection Profiles control the resolution of the color and the depth streams. The available Profiles are the following:

  • RGBD - FHD -> (color & depth: 1920 x 1080)
  • RGBD - VGA -> (color & depth: 640 x 480)
  • RGB - FHD, D - FHD / 2 -> (color: 1920 x 1080, depth: 1920 x 1080 resized to 960 x 540)
  • RGB - VGA, D - VGA / 2 -> (color: 640 x 480. depth: depth: 640 x 480 resized to 320 x 240)
  • RGB - FHD, D - FHD / 4 -> (color: 1920 x 1080, depth: 1920 x 1080 resized to 480 x 270)
  • RGB - VGA, D - FHD / 4 -> (color: 640 x 480, depth: 1920 x 1080 resized to 480 x 270)

If you have a slow connection, or if the Network Switch is not unmanaged you can select a Profile with lower resolution than Full HD. The default selected Profile is RGB - FHD, D - FHD / 4 which has no problems with the recommended Network switch.

  • Set Master device for HW device synchronization:

accessibility text

From the drop-down menu next to the "Connect All" Button, you can select which device will be the Master device in a Hardware sync scenario. In order to use the hardware sync feature, you need to have the HW sync cable assembled, and all of the devices connected via the GPIO port which is on the top of the device.

Finally, when all of the devices are connected, each device viewport should appear on screen.

accessibility text