This page provides information for how best to render using V-Ray RT for use with VR headsets like the Oculus Rift or HTC Vive.
V-Ray RT can be setup to view active renders through VR headsets such as the Oculus Rift or HTC Vive. This way, when rendering a 6x1 stereo cube panorama, users can utilize a VR headset to view the render in proper virtual space as it renders as opposed to seeing the render as a flat image in the VFB. With the help of a MAXScript, it is possible to update the position of the camera with a game controller to move around in the virtual space while V-Ray RT updates and refreshes the render from the new camera location.
V-Ray RT Output to Headset Setup
1. Confirm headset display is installed properly.
If using Oculus Rift then install Oculus Rift PC runtime:
Direct internet connection is needed to login to Oculus Account. It seems that it does not work through a proxy. You need at least 5 GB disk space on your C: drive.
This step is not needed if using HTC Vive.
Oculus Rift only: connect headset to the default graphics adapter (it will not work if connected to other graphic adapters).
In the Oculus app, enable apps from unknown sources: turn on Oculus Settings > General > Unknown Sources
For HTC Vive support, install Steam and Steam VR:
This is needed in order to use the OpenVR interface for HTC Vive, Oculus Rift and other VR devices. This step is optional for Oculus Rift.
2. Check that the headset is working and displays its home scene correctly.
V-Ray Production Render Settings
- Turn off Image filter
- Select Camera Type to Cube 6x1
- Render resolution width must be divisible by 6
V-Ray RT ActiveShade Settings
- Select Stereo mode > Oculus Rift (mono), Oculus Rift (stereo), OpenVR (mono) or OpenVR (stereo)
- Select suitable image output size, for example 3000x500. You may start with a lower resolution.
- Select RT Engine type > Using GPU (CUDA/OpenCL) engines is recommended. Use CPU, if your GPU is not suitable for rendering your scene (not enough memory or other limitations), but expect possible slower render times.
- Render Device Select > exclude the default render adapter. Using the same adapter for GPU rendering and VR display will result in frame drops and poor VR experience. DR session with the local host excluded should work fine.
3. Start ActiveShade. The first render will start slowly since it takes some time to load the Oculus VR library.
The information in this section will help explain how to use MAXScript to navigate around the VR environment with a game controller. Below is a download link to a sample MAXScript that sets the buttons and analog sticks in a general configuration to get you up and running. For more details,please see comments in the top section of the script file.
Access to VR controllers state
Access to VR controllers state is available in ActiveShade mode. Currently, the controller state is only accessible during Oculus Rift preview sessions (Stereo mode = Oculus rift).
You can refer to the current renderer and check to see if it supports VR controller interfaces from MAXScript:
VR controller interfaces
Assuming that variables ivrayrt and rt are initialized as stated above, you can list the VR controllers related interface properties:
The interfaces are also available as renderer properties:
All VR controller interfaces are uniform – they contain the same methods and properties regardless of controller type. Interface information can be displayed as follows:
VR controller interface details
|connected||True if the corresponding controller is connected; otherwise false.|
|timeInSeconds||System time of last controller state update.|
|Left and right finger trigger positions, in the range of 0.0 to 1.0.|
|Left and right grip button positions, in the range of 0.0 to 1.0.|
Left and right thumb stick position coordinates in the range of -1.0 to 1.0, as point2 values.
|buttons, touches||Boolean properties that represent the state of various buttons and sensors on the controller.|
|setNotifyCallback <callback> <threshold>|
Sets notification MAXScript that will be executed whenever controller state changes.
setNotifyCallback Sample Use
Sets notification callback which outputs left index trigger position of the XBox controller whenever its state changes:
Stop receiving notifications from the XBox controller:
Process notifications from two different controllers using a common callback:
Focus method in VRay RT is settable using MAXScript:
stereo_focus can take the following values:
0 - parallel
1 - rotation
2 - shear transform
- Head orientation tracking is only supported when rendering a panorama using the Cube 6x1 camera.
- Rotation and shear use camera target distance as a "zero parallax" plane distance.
- In order to get a comfortable feel, you must set the camera target distance to a high value. Alternatively, you can change the stereo_focus method to 0 (parallel) using MAXScript.
- Shear is not supported for panorama renders.