Startup

<< Back to Proximity Toolkit


This page has a step by step procedure for setting up the Proximity Server in preparation for attaching client applications.

Setting up the Vicon Nexus (Advanced)

  • Before you can use the Nexus, you may need to calibrate it. If so, use the instructions on the Vicon Toolkit page.
  • When you are done calibration, be sure to set the origin point.
    • HOMESPACE: Set the T-square on the floor with the handle pointing in the positive X direction, centred on the lens of camera below the Smartboard (see tape guides on the carpet). This is the designated standard for the origin point - please do not deviate from this because it may interfere with other projects.

Loading the Vicon Nexus for a Session

  • Ensure the Ultranet box is on.
  • Launch the Vicon Nexus application.
  • Wait for all cameras to be showing in green.
  • Create or load the VSK models for all of the subjects that you wish to track. To load an existing object, go to the Resources panel, under the Subjects tab and click on "load a subject".

Setting up the Proximity Server (Advanced)

  • Download and install the Proximity Toolkit.
  • Launch the Proximity Server application.
  • Calibrate the Space, any Displays, Fixed Volumes, and Capture Devices (more info below).

Calibrating the Space (Advanced)

  • Right-click on the root node in the Presences tree (hollow purple box icon), and choose the Calibrate... option. The Calibration panel will appear in the right-hand pane.
  • First, set the Front and Up directions in the Space Orientation panel. This can be done manually, or by capturing a vector from a pointing ray from one of the objects you are tracking. Front is typically the direction from the centre of the space to the focal area. Up is the purpendicular direction from any point on the floor.
    • ex. In the HOMESPACE, Front is the direction toward the Smartboard.
  • Once the direction is set, the Space Bounds panel will become available. You can set these values manually, or track the range of motion of one of your objects. NOTE: It is assumed that the volume origin is within the volume of the space.

Setting Up a Display (Advanced)

A "Display" is a means of corresponding screen space to coordinates in the 3D space, and vice versa. The physical location and orientation of displays are assumed to be relatively static.

  • Right-click the Displays node, underneath the root node, and select the New Display option. An untitled display node will appear in the tree underneath this node.
  • Click the label to rename the display to something meaningful.
  • Right-click the display node and choose Mapping.
  • If the display maps to a particular display device on the local machine, choose the Logical Display option and select the name of the display device from the dropdown menu. Otherwise you may choose Virtual Display, and manually specify the top left, and bottom right corners for the display space.
  • Click Finished and then right-click the display node again, this time choosing Calibrate.
  • Here you can manually set the four corners of the display by typing the values or capturing points from your objects. Or you can use a calibration wizard, which requires a pointing ray from one of your objects.

Setting Up a Volume (Advanced)

A "Volume" is a means of identifying areas of interest within a space. Volumes can be hollow to indicate areas of interest that objects can enter, or solid to indicate areas that objects cannot enter. For example, solid volumes are useful for indicating the spatial properties of furniture.

  • (Instructions coming soon)

Setting Up a Device (Advanced)

A "Device" represents the location and field of view of a hardware device that a module of the Proximity Server is using to obtain data. Certain modules may require Devices to be set up in order for them to accurately calculate proximity data within the desired coordinate system.

  • (Instructions coming soon)