Varjo Lab Tools

Varjo Lab Tools is intended for experienced Varjo users who want to get more out of their Varjo hardware and compatible applications. You can get Varjo Lab Tools from Downloads. Varjo Base must be installed and running to use Lab Tools.

You can find further information on the different tools inside Varjo Lab Tools. Press ? for individual tooltips.

Varjo Lab Tools is constantly updated based on feedback from our user community.

Note that other applications may control and override the values that you set in Lab Tools.

Modes

Lab Tools has two modes: One for editing your setup and another for using it. You can change between modes at any time by pressing the mode buttons.

Save & Load

You can save and load setups in Lab Tools. To duplicate a setup on another computer, save your setup and copy it to another computer.

Masking

Create masks to mix real life with virtual content. Masks can be mixed with chroma key to create more complex setups.

Add a mask mesh either by importing 3D models (in OBJ format) or by using the VR mask editing tools in Lab Tools.

Using masks with Lab Tools comes with a performance penalty, and we recommend creating mask support directly in your application if possible.

Each mask has its own values that can be edited individually. When using a VR controller to create a mask, these values typically do not need to be edited. If you don’t have access to a VR controller, you can import new masks and reposition them using the following values:

Hand mask

You can generate a mask mesh from your hands. Based on the skeletal structure provided by our hand tracking, a simple 3D mask mesh is placed over your hands.

Masking VR controls

You can create and edit masks in VR. Only a single connected controller is required. While the graphics will always show a Vive controller, you can use other controllers as well.

Note: Mask creation in VR is not intended to be a full 3D modelling suite, but rather a quick tool to create simple masks. For more complex and fully accurate masks, we recommend that you create them in your preferred 3D modelling suite and import them into Lab Tools.

Change page

Switch between pages page by pressing the Menu button. Change tools by pressing the touchpad. Use a tool by pressing the trigger. The VR UI in Lab Tools consists of three pages. Page 1: Mask tools Page 2: Vertex tools Page 3: Selector settings

Page 1: Mask tools

Add mask

Creates a new mask. Opens the mask anchor selection.

Mask anchor selection

When creating a new mask, you need to select an anchor for the mask.

World origin: The origin point of the world. This usually refers to the center of the room and floor level.

Varjo Marker: A printed marker from Varjo. The behavior and id of a marker can be adjusted in the 2D interface.

XR device: Any connected and tracked device, for example a headset, controller, or tracking puck. The device id can be changed in the 2D interface.

Cancel: Cancel creating a new mask.

Confirm your selection by pressing the trigger. The anchor nearest to the cursor and of the selected type is used. After you select an anchor type, the tool changes to Add vertex so that you can begin modelling the mask.

Select mask

Select the mask nearest to the cursor. After you select a mask, the tool changes to Move vertex so you can begin editing the mask.

Move mask

Hold the trigger to move the mask nearest to the cursor.

Remove mask

Delete the mask nearest to the cursor.

Page 2: Vertex tools

Add vertex

Add a new vertex connected to the two nearest vertices to create a triangle.

Move vertex

Hold the trigger to move the vertex nearest to the cursor.

Fill polygon

Create a new triangle between the three closest vertices.

Remove vertex

Remove a vertex and all connected triangles.

Page 3: 3D cursor settings

Cursor distance

With this feature you can reach further than your hand and controller can. Press up or down on the touchpad to move the cursor forwards or backwards.

Cursor smoothness

With this feature you can smooth controller movement to be more stable. Press left or right on the touchpad to increase or decrease the smoothness of your cursor movement.

Masking modes

Masking is a very versatile and powerful feature. Here are some examples of what you can achieve with different masking setups.

Restricted

Show the video pass-through image (VST) in the mask.

Example case: Show a controller in VR (e.g., a steering wheel).

Restricted with chroma key

Show the video pass-through image (VST) and chroma in the mask.

Example case: Show a controller using chroma in VR in a limited chroma room (e.g., a green steering wheel).

Extended

Show VR in the mask.

Example case: Show the real world outside of a virtual cockpit.

Extended with chroma key

Show VR in the mask and chroma elsewhere.

Example case: Cut out the ceiling of a green room in a limited chroma room.

Reduce with chroma key

Show the video pass-through image (VST) in the mask and chroma elsewhere.

Example case: Cut out a window in a full chroma room (e.g., show a TV with green content on it)

Camera settings

You can control various video pass-through camera settings with Varjo Lab Tools. This allows you to adjust your mixed reality experience to suit more challenging visual conditions, where the default behavior may not be suitable.

Video depth testing

You can adjust or override the current settings for video depth testing. For example, this allows you to see your real hands inside the application.

Chroma key settings

You can enable global chroma key and override current chroma settings. This disables chroma key option from Varjo Base.