Using the VR Menu

What is the VR Menu? It is a virtual interface that houses a collection of tools that are accessible while in VR. More tools can be added to the default set, through the use of Python scripting. Some tools perform an action, while others open another panel with more options.

Along the top, if you are in a collaboration session, the names of all participants will be displayed. To disable this feature, use the Python command, vrImmersiveUiService.setHideParticipantsVRPanel(true). Along the bottom are the current file name and time.

Note:

For collaboration session participants not wearing an HMD, all tools accessed through the VR Menu are accessible in the VRED desktop UI.

Home Panel

Before we continue, let's find out how to display the VR Menu.

Displaying the VR Menu

For participants in VR, there are two ways to display the VR Menu, either use a hand gesture or click the corresponding VR Menu controller button for your controller.

learnMore icon For information on how to display and use hands in VR, see Hands in XR.

Now, let's take a look at the default tool set.

Default Tools

The home panel contains the following default options. As mentioned above, more tools can be added using Python scripts.

Variant Sets Variant Sets

Opens the Variant Sets (VSets) panel to access all variant sets created for the scene. Any variant sets set in a scene are automatically loaded into the Variant Sets panel of the VR Menu.

Viewpoint Viewpoints

Opens the Viewpoints panel to access all viewpoints, cameras, and camera tracks created for the scene. For camera and camera track labelling, when there is only one camera, the camera track name is displayed; however, if there are more, they are labelled as the camera name: camera track name.

Cameras and Camera Tracks displayed in the Viewpoints section of the Stream App UI

Any viewpoints set in a scene are automatically loaded into the Viewpoints panel of the VR Menu. However; cameras and camera tracks are not updated in realtime. For the app to detect these changes, you must use Ctrl + R.

Controller/Hand Controller/Hand

Switches between displaying the controllers or hands. To do this another way, see How to Switch Between Hands and Controllers.

To set the displayed default, see Default Visualization.

Hand Poses Only Hand Poses Only

Toggles between using the pointer or hand gestures for communication. When enabled, you can point, give a thumbs up or down, make a fist, punch, or open your hand. It also disables all tools mapped to these button, with the exception of the VR Menu button. Use hand poses to interact with touch sensors and communicate with others, while in a session.

Teleport Ground Teleport Ground

Sets the teleporting ground mode to either On Geometry or On Ground Plane. When Teleport Ground is enabled, teleport around the scene or into spaces, such as inside a car. When disabled, teleport onto geometry in the scene. To set a teleporting Ground Mode preference, see Virtual Reality Preferences.

Teleport Ground

Note:

When Use Camera Height as VR Ground Plane is enabled, the teleporting ground mode changes to the camera height. However, if teleport On Geometry is enabled, Use Camera Height as VR Ground Plane is ignored.

Calibrate Ground Calibrate Ground

Provides a way to set where the ground plane is. When working with a model not created at the origin, participants will need to calibrate the ground to match that of the model.

Calibrate Ground

To change the VR ground plane to the height of the camera, see Use Camera Height as VR Ground Plane and Advanced Viewpoints in MR.

VR Virtual Reality

Switches from the mixed reality mode to virtual reality.

MR Mixed Reality

Switches from virtual reality to the mixed reality mode. Avatars disappears. In their place is the user's nametag, displayed above the user's location.

Clear Clear

Turns off virtual or mixed reality, so the user can see their actual surroundings while still wearing the HMD. This helps the user to avoid cables and other obsticles, as VRED uses the camera lenses of the headset to see the contents of the room.

Place tool Place

Note:

When in a collaborative XR session, the position of objects are syncronized for users. Use for placing objects on and moving them along the ground of the scene, using the laser pointer. These objects must have an assigned scene tag, called Place.

The Place tool uses a similar approach to Teleport for rotating objects, that is rotating your wrist. You can snap the rotation to a 10° angle by pressing the controller's Grip button. Use this when trying to align one object with another. It is also possible to place objects atop one another.

Share Pointer Share Pointer

(Only available for VR Room participants)

Changes whether other participants see or do not see your pointer. The default state is for it to be seen by others, enabled. For you, your pointer will be visible, whether this option is activated or not.

Since the pointer is meant to draw participants' attention to things during a collaboration session, when activating touch sensors or WebEngines, disable Share Pointer. Enable Share Pointer again when you need to get the others' attention.

Marker icon Marker

Only available for Varjo MR mixed reality headset users.

Use a visible marker, known as the origin marker, for easy placement of objects in a mixed reality scene. The coordinate system is automatically synced. Your nodes need to be prepared before entering MR. Check out the Preparing Nodes for Placement section in Markers in Mixed Reality.

Python-created Tools

Python-created tools can also be added to the VR Menu. These tools display this icon Python Tool icon in the upper right corner. See VRED Python Examples for more examples of Python scripts.

VR Menu with added Python options

Show Avatars Show Avatars

Shows or hides avatars. See Hide Avatars in a collaboration session.

Flashlight Flashlight

Only available for VR Room participants. Shows or hides a flashlight. See Showing a flash light in VR.

Note:

As of version 2022.2, we replaced the previous VR flashlight with a new poly model.

New VR poly model flashlight

Gather Users Gather Users

Teleports all users in a collaboration session to a shared location. This enables all participants to look at the same thing from the same view. This is useful for design reviews. See Gather all users in a collaboration session.

Note:

Since participants are teleported without consent, we recommend using this only when necessary. This experience can be a bit unnerving, as participants' view and virtual surrounds instantly change.

Measure Measure

Measures the distance between two selectable points in VR. See Measure distances in VR.

Accessing the Menu

To open the menu, move your index finger to the palm of your other hand. Repeat this gesture to close the VR Menu.

Accessing the menu

Triggering Tools

To trigger a tool, either tap with your virtual hand or use the pointer.

Troubleshooting

See Using the VR Menu if you are having issues with triggering a tool or your real-world hands are behind virtual objects.

How to Scroll Through Lists

There are two ways to scroll through lists in the VR Menu.

  • Click and drag a scroll bar up or down.

    Scroll Bars

  • Press the trigger and move the controller up or down to scroll through lists of options.

Note:

Pressing and releasing the trigger will select the highlighted option.

To exit a panel and return to the previous one, press the X in the top right.

How to Add Functionality to the VR Menu

Use Python add functionality to the VR Menu, such as web content and access to VRED modules.

  1. To see sample Python functions for adding functionality, select File > Open Example > vr > customMenuButton.py and click Open.

  2. Select Edit > Script Editor to open the editor and take a look at the code.

    Python Script Editor Panel

  3. Select Help > Python Documentation to refer to the Python documentation for details on these functions.

For more information on how to create VR Menu entries with Python, see Creating VR Menu Entries.

How to Hide Options in the VR Menu

If there are options you do or don't want displayed in the VR Menu, use Scripts > VR Menu to toggle them on or off.

In the menu bar, select Scripts > VR Menu, then either check an option to display it or uncheck it to hide it.

VR Menu

Variants Set and the VR Menu

How to Remove Variant Sets from the VR Menu

There are two ways to do this:

To turn off the display of Variant Sets in the VR Menu from the desktop, select Scripts > VR Menu > Variant Sets, then remove the check next to it.

To remove Variant Sets from the VR Menu while in VR, so they cannot be seen in VR, use the Variant Sets module.

  1. In the Variant Sets module, select the Variant Set groups to be removed from the left side.

  2. In the General tab, uncheck Show in VR Menu. This removes all the selected Variant Sets from the VR Menu.

    Variant Sets from the VR Menu

    Removed from the VR Menu

How to Display Hidden Variant Sets

To display hidden variant sets groups in the VR Menu, select the variant sets group along the left of the VR Menu, then in the Variant Sets module General tab, check Show in VR Menu.

How to Remove and Display Single Variant Sets

To remove single variant sets from a group, in the Variant Sets module, select the individual variant set, then uncheck Show in VR Menu.

Remove one Variant Set

To display a hidden variant set, select it, then in the General tab, check Show in VR Menu.