Camera Position Visualizer User Manual
Table of contents
Overview
Ultraleap Camera Position Visualizer Tool |
---|
Launch Camera Position Visualizer 🖥️ |
The Ultraleap Camera Position Visualizer tool is designed primarily for kiosk manufacturers and integrators.
Its purpose is to:
- Help determine the ideal position for an Ultraleap camera module, relative to a kiosk set-up.
- Simulate the kiosk set-up, enabling the user to test different Ultraleap camera placements to help optimize placement and angle.
- Show an indicative representation of the tracking range and field of view for Ultraleap camera modules.
How it works:
- The virtual kiosk screen can be customized to different screen sizes and orientations.
- A sample screenshot of the kiosk interface is uploaded which projects onto the virtual kiosk screen within the tool.
- This then allows visualization of how the 3D zone where the Ultraleap camera is able to track hands maps to button locations in the kiosk interface.
Important: An Ultraleap camera module is not a requirement for using the Camera Position Visualizer. The tool is entirely driven by a mouse and keyboard and can help inform customers on which Ultraleap camera is likely to meet their requirements.
Ultraleap Camera Position Visualizer Tool |
---|
Launch Camera Position Visualizer 🖥️ |
3D Controls
General 3D Controls
Control | Description |
---|---|
Pan 3D View | Press and hold right mouse button within the Camera Position Visualizer 3D Window and move the mouse |
Rotate 3D View | Press and hold left mouse button within the Camera Position Visualizer 3D Window and move the mouse |
Zoom Camera | Scroll up and down to adjust 3D Window zoom |
Ultraleap Camera Controls
Control | Description | Example |
---|---|---|
Select the Ultraleap Camera | Left mouse click on the device. The device is located at the centre of the displayed tracking zone. | ![]() |
Move the Ultraleap Camera | Once the Ultraleap camera is selected, a 3D gizmo will appear over the device. Hovering over any of the axes whilst pressing and holding the left mouse button and simultaneously dragging the mouse will move the device along the chosen axis. As the device is moved around, the Tracking settings position will also update in the Control Panel to the left. | ![]() |
Rotate the Ultraleap Camera | Using the same method as moving the Ultraleap camera, left mouse click to select the device and bring up the 3D gizmo. By default, this will display the Translate gizmo (represented by 3 colored arrows showing the axes of movement). Press the “E” key on the keyboard to switch the gizmo to rotation. This will change the gizmo into three arcs which can be individually dragged using the left mouse button to rotate the device to the desired angle. | ![]() |
Note: When you have the device selected, it is possible to toggle between Translate (move the device) and Rotate (tilt the device) by pressing the “E” key for rotation and the “W” key for translation. | ||
Toggle the Measurements display | By pressing the Spacebar, users can toggle measurement information on/off in the 3D view. This will display width and height information for the screen as well as the distance of the Ultraleap camera from the screen. | ![]() |
Fixed Camera View Keys
It is often desirable to quickly visualize your setup from various angles to better assess the camera’s tracking zone. The Ultraleap Camera Position Visualizer includes the following preset camera views to help with this, accessible via hotkeys:
![]() | ![]() | ![]() |
---|---|---|
Front view: F key | Right view: R key | Left view: L key |
![]() | ![]() |
---|---|
Top view: T key | Angled view: D key |
Control Panel Settings
The Control Panel on the left side of the tool contains menus and input fields allowing the user to adjust the placement and orientation of elements within the 3D Window.
For example, the user can manually 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
The user can 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.
Selecting the Tracking Fields
The tracking fields are the visualized tracking zones that can be seen within the 3D Window, representing the Maximum, Optimal and Untrackable (i.e., too close) tracking regions of the Ultraleap Camera. One or more options can be selected from this dropdown menu so they can 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.
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 the display.
Adjusting Screen Size
The Screen Size dropdown menu allows common screen sizes to be selected.
The Custom option in the dropdown menu also allows for the input of non-conventional screen sizes.
Adjusting Screen Orientation
The Screen Orientation dropdown allows for a portrait or landscape orientation to be selected.
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 (centimeters) 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, representing 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 also 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 users to import a 3D model of their kiosk into the application to use as 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
On import, 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 properly 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 for any reason you need to remove from the scene 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 be reset to the defaults and any images loaded during a browser session will not be stored.
![]() | ![]() |
---|---|
Option to add custom image to the screen | Preview of a sample image on the screen |
Rotating the Screen Image
![]() |
---|
It is possible to rotate the screen image in 90-degree intervals by using the rotate image button next to the “Set Screen Image” button. This can be used to orient the image correctly relative to the user. |
We are always looking to improve our products and welcome user feedback. If you have any suggestions, questions, comments or concerns please contact support@ultraleap.com. ❤️