Camera Position Visualizer User Manual

Table of contents

1. Overview
   1. Launch Camera Position Visualizer   
2. 3D Controls
   1. General 3D Controls
   2. Ultraleap Camera Controls
   3. Fixed Camera View Keys
3. Control Panel Settings
   1. Tracking Settings Panel Overview
      1. Selecting an Ultraleap Camera
      2. Camera Position and Camera Tilt Input Fields
      3. Selecting the Tracking Fields
   2. Display Settings Panel Overview
      1. Adjusting Screen Size
      2. Adjusting Screen Orientation
      3. Adjusting Screen Tilt
   3. Miscellaneous Settings Panel Overview
      1. Units of Measurement
      2. Avatar Controls
      3. Choose Model
      4. Model Scale
      5. Use Box Collider
      6. Adjusting an Imported Model’s Position and Rotation
      7. Deleting an Imported Model
4. Setting and Adjusting the Screen Image
   1. Rotating the Screen Image

Overview

The Ultraleap Camera Position Visualizer (CPV) tool is designed primarily for kiosk manufacturers and integrators.

Its purpose is to:

• Help determine the ideal position for an Ultraleap camera module.
• Simulate the kiosk setup – test different Ultraleap camera placements to help optimize placement and angle.
• Show a representation of the tracking range and field of view for Ultraleap camera modules.

How it works:

• Customize the virtual kiosk screen to different screen sizes and orientations.
• Upload a sample screenshot of your kiosk interface. This is projected onto the virtual kiosk screen within the tool.
• The CPV tool generates a visualization of the 3D zone where the Ultraleap camera is able to track hands and maps to button locations in the kiosk interface.

Important: You do not need an Ultraleap camera module to use the Camera Position Visualizer. Explore the CPV to help decide which Ultraleap camera best meets your requirements.

Launch Camera Position Visualizer   

3D Controls

General 3D Controls

Ultraleap Camera Controls

Fixed Camera View Keys

You can quickly visualize your setup from various angles to assess the camera’s tracking zone. The CPV includes the following preset camera views, accessible via hotkeys:

Control Panel Settings

The Control Panel on the left side of the tool contains menus and input fields. Here you can adjust the placement and orientation of elements within the 3D Window.

For example, enter values here to precisely adjust the position/orientation of the Ultraleap camera. If the Ultraleap camera is adjusted manually in the 3D Window, these values will update accordingly.

Tracking Settings Panel Overview

Selecting an Ultraleap Camera

Choose which Ultraleap camera to visualize using the dropdown menu in the Tracking Settings panel. For smaller screens we recommend the Leap Motion Controller. For larger screens, we recommend the Stereo IR 170 Camera Module.

Camera Position and Camera Tilt Input Fields

Use the table below to determine the best measurements to enter into the Camera Position and Tilt Input Fields for the position of the camera module to visualise its tracking fields.

Our standard hand tracking SDK supports Above Facing Screen and Below camera module mounting positions within TouchFree.

A third position, Above Facing User, is available by contacting Ultraleap.

Selecting the Tracking Fields

The tracking fields are the visualized tracking zones that can be seen within the 3D Window. Choose between the Maximum, Optimal and Untrackable regions of the Ultraleap Camera. Select one or more options from this dropdown menu and they will be visualized in the 3D Window.

Note that the tracking fields vary depending on the type of Ultraleap camera that has been selected.

Display Settings Panel Overview

The Display Settings Panel allows the user to customize the size and orientation of the virtual display.

Adjusting Screen Size

Choose from a set of common screen sizes and ratios, or select the Custom option at the bottom of the dropdown list to enter the exact dimensions of your display.

The Screen Size dropdown menu allows common screen sizes to be selected.

The Custom option in the dropdown menu allows for the input of non-conventional screen sizes.

Adjusting Screen Orientation

Use the Screen Orientation dropdown to select portrait or landscape orientation.

Adjusting Screen Tilt

Some screen and kiosk set-ups involve screens tilted to angles other than 90 degrees. The Screen Tilt controls allow for adjustment to the tilt of the screen relative to the user. Exact values can be added using the input fields, or the slider can be used to quickly adjust the screen orientation.

Miscellaneous Settings Panel Overview

Units of Measurement

The Units dropdown menu allows for either metric (centimetres) or imperial (inches) to be selected. This affects all values adjusted within the tool.

Avatar Controls

By default, a mid-sized user avatar will be present in the 3D Window. This represents an average user interacting with a display/kiosk. This can be toggled on/off in the Miscellaneous Settings panel. The height of the avatar can be adjusted to simulate how different users might orient relative to a kiosk.

Choose Model

Selecting this button will bring up a dialog that allows you to import a 3D model of your kiosk into the application. You can use this as a reference alongside the tracking volumes of the Ultraleap cameras. OBJ file formats are supported. It is recommended you limit the polygon count of the models to under 25K in order to facilitate rapid importing and smooth performance.

Once selected, the resulting dialog will let users choose a file from their computer. Alternatively they can type the path and name of the file in the input field.

Once you have selected your OBJ file, click the Import button to load the model into the 3D View. Note: The more complex the 3D model is (i.e. polygon count) the longer it will take to import.

Model Scale

Different CAD and 3D model programs can have different scale values. The default “1” here will import the model in the exact scale of the source software.

Use Box Collider

By default the tool will apply a generic box collider to the imported model rather than the more complex mesh collider. This is an option to increase performance on lower-end computers.

Applying a box collider does not affect the look of the model, it is only used for assessing the Ultraleap tracking volume. Generally, the mesh collider will give a more accurate representation of the tracking volume, but the box collider will afford performance increases.

Adjusting an Imported Model’s Position and Rotation

Users can adjust the position of an imported model in the same way as they adjust the position of the Ultraleap camera.

• Select an imported model by left clicking on it. The model will highlight orange.
• The transform widget will appear. (Note: depending on the model, the widget may be obstructed by the model geometry).
• Users can left click and drag on one of the axis arrows to move the model along a specific axis. To rotate the model, press the E key to activate rotation mode and click and drag on one of the arcs to rotate the model. You can return to adjusting the position by pressing the W key.

Deleting an Imported Model

If you need to remove a model that you have imported, simply left click to select the model (highlighting it orange) and press the Delete key.

Note: You may import multiple models into the scene.

Setting and Adjusting the Screen Image

In the Top/Middle of the 3D Window is a button labeled Set Screen Image. Select this using the left mouse button to choose an image to display on the virtual kiosk screen.

The Select image file button appears, which when pressed will bring up an explorer window to locate an image to use. (Cancel will exit this control without choosing an image file.)

Note: If another website is opened, or the browser containing the Ultraleap Camera Position Visualizer is closed, the settings will reset to the defaults. Any images loaded during a browser session will not be stored.

Rotating the Screen Image

---

If you have any suggestions, questions, comments or concerns please contact support@ultraleap.com.

---

Table of contents

• Launch CPV Tool

---