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
.![../../_images/addons_3d-view_vr-scene-inspection_interface.jpg](../../_images/addons_3d-view_vr-scene-inspection_interface.jpg)
VR Session
![../../_images/addons_3d-view_vr-scene-inspection_vr-session.jpg](../../_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](../../_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](../../_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
〇
Activates a landmark, making it change the base pose of the VR view.
- Add
+
Create a landmark.
- Remove
-
Delete the selected landmark.
- Add from Session
⊕
Create a landmark from the viewer pose of the running VR session.
- Landmark Controls
v
- Add Landmark from Camera
Add a new landmark from the active camera object.
- Update Custom Landmark
Update the selected landmark from the current VR viewer pose.
- Cursor to Landmark
Move the 3D Cursor to the selected landmark.
- Scene Camera to Landmark
Position the scene camera at the selected landmark.
- Camera from Landmark
Create a new camera from 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](../../_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](../../_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
- File
viewport_vr_preview folder
- 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.