Oculus Rift Output with Oculus Plugin

The Oculus plugin is used to support the Oculus Rift head-mounted display. For the correct work of the plugin Oculus Rift PC Runtime is required. Note that your customers must have runtime installed as well. The plugin supports all HMD types supported by the latest Oculus Rift PC Runtime (including Oculus Rift CV1 (Consumer Version).

The Oculus plugin provides the VR mode that allows for rendering to both the Oculus Rift head-mounted display and the PC display. When the VR mode is disabled, the image is rendered only to the PC display. The mode can be toggled by using the engine.oculus.setEnabled() function.

Both the windowed and the full screen modes are supported. On the PC display the image is rendered as follows:

See Also#

To use the Oculus Rift virtual display with Unigine, perform the following:

1. Get and set up the latest Oculus Rift PC Runtime.
2. Create a new project with Oculus support via UNIGINE SDK Browser: click Video Output Options, check the Oculus support (Oculus plugin) option in the form that opens and click OK.
   Notice

   To add Oculus support to an existing project, in UNIGINE SDK Browser, click Other Actions -> Configure Project -> Video Output Options -> Oculus support (Oculus plugin) -> Ok.

   

3. Implement the application logic by using functions of the Oculus plugin API.
4. Plug in the Oculus Rift virtual display.
5. Launch the Oculus plugin on the application start-up.

To launch the plugin, specify the extern_plugin command line option on the application start-up:

main_x64.exe -extern_plugin "UnigineOculus"

If you run the application via UNIGINE SDK Browser, set the Stereo 3D option to Oculus Rift in the Options tab and click Apply:

Oculus Options#

main_x64d -extern_plugin "UnigineOculus" -oculus_density 1.0 -oculus_scale 8.0

The following console commands can be run for the Oculus plugin.