VR Scene Inspection

The VR Scene Inspection add-on exposes and extends the native virtual reality features of Blender in the user interface. The feature set is limited to scene inspection use cases. More advanced use cases may be enabled through further development inside of Blender.

VR support in Blender is based on the OpenXR specification and requires some set up steps. These are explained in the Head-Mounted Displays (HMD) section.

Activation

  • Open Blender and go to Preferences then the Add-ons tab.

  • Click 3D View then VR Scene Inspection to enable the script.

Interface

Located in the 3D Viewport ‣ Sidebar ‣ VR tab.

../../_images/addons_3d-view_vr-scene-inspection_interface.jpg

VR Session

../../_images/addons_3d-view_vr-scene-inspection_vr-session.jpg
Start VR Session

Try to set up a connection to the OpenXR platform to share the viewport with an HMD.

Tracking
Positional

Only track rotational changes of the head, do not allow the HMD to affect the location of the viewer in virtual space.

Absolute

Skip eye offsets that are normally added for placing the viewer exactly at landmarks. This allows the tracking origin to be defined independently of the HMD position.

Use Controller Actions

Enable default controller actions for viewport navigation, controller tracking, and haptics.

View

../../_images/addons_3d-view_vr-scene-inspection_view.jpg
Show
Floor

Set visibility of the ground plane in the VR view.

Annotations

Set visibility of annotation strokes in the VR view.

Selection

Set visibility of selection outlines in the VR view.

Controllers

Set visibility of VR motion controllers. Requires enabling the Use Controller Actions option.

Custom Overlays

Set visibility of custom operator drawing (e.g. default teleport beam).

Controller Style

Preferred visualization of VR motion controllers.

Clip Start/End

Clipping values of the VR view, as in the 3D Viewport.

Landmarks

Landmarks are used to store reusable base poses (position and rotation) for the viewer in the virtual space. In addition, a base viewer reference scale can be set for landmarks of types Custom Object and Custom Pose.

../../_images/addons_3d-view_vr-scene-inspection_landmarks.jpg
Landmark

A list view.

Selected Landmark

Defines which landmark’s settings are shown below the list. Changing the selected landmark does not have an influence on the VR view.

Activate (circle icon)

Activates a landmark, making it change the base pose of the VR view.

Add +

Create a landmark.

Remove -

Deletes the selected landmark.

Type
Scene Camera

Follow the scene’s active camera to define the base pose of the viewer.

Custom Object

Set an arbitrary object to define the base pose of the viewer.

Custom Pose

Manually define a position and rotation to use as the base pose of the viewer.

Action Maps

../../_images/addons_3d-view_vr-scene-inspection_action-maps.jpg
Gamepad

Use input from a gamepad (Microsoft Xbox Controller) instead of motion controllers for VR actions such as viewport navigation.

Extensions

Enable additional controller bindings to ensure correct input-to-action mappings. Note that a given extension may not be supported by all VR platforms.

HP Reverb G2

Enable bindings for the HP Reverb G2 controllers.

HTC Vive Cosmos

Enable bindings for the HTC Vive Cosmos controllers.

Huawei

Enable bindings for the Huawei controllers.

Viewport Feedback

../../_images/addons_3d-view_vr-scene-inspection_viewport-feedback.jpg
Show VR Camera

Draw an indicator of the current VR viewer pose (location and rotation in the virtual space) in the current 3D Viewport.

Show VR Controllers

Draw indicators of tracked VR motion controllers in the current 3D viewport. Requires enabling the Use Controller Actions option.

Show Landmarks

Draw landmark indicators in the current 3D Viewport.

Mirror VR Session

Make the current 3D Viewport follow the perspective of the VR view.

Reference

Category

3D View

Description

View the viewport with virtual reality glasses (head-mounted displays).

Location

3D Viewport ‣ Sidebar ‣ VR tab

File

viewport_vr_preview/__init__.py

Author

Julian Eisel, Sebastian Koenig, Peter Kim

Maintainer

Julian Eisel, Peter Kim

License

GPL

Support Level

Official

Note

This add-on is bundled with Blender.