UnigineScript
The Language
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins
Content Creation
Materials
Unigine Material Library
Tutorials

AppOculus Plugin

An AppOculus plugin is used to support the Oculus Rift head-mounted display.

It can be rendered in both the windowed and the full screen mode.

Valley benchmark working in Oculus Rift mode

Notice
The HD mode is also supported.

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

  1. Plug in the Oculus Rift
  2. Get and configure the Oculus Rift SDK
  3. Implement the application logic and launch the AppOculus plugin on the application start-up

See Also

To run the plugin sample from the Unigine SDK Browser, press the AppOculus plugin button on the Plugin Samples tab.

Launching AppOculus

To launch the plugin, specify the extern_plugin command line option and STEREO_OCULUS define on the start-up:

Shell commands
main_x86d -extern_plugin "AppOculus" -extern_define STEREO_OCULUS
				
Notice
If the extern_define STEREO_OCULUS is not specified, a scene will be rendered incorrectly for the right eye.

Also you can create a new project with Oculus support by checking the Oculus support option on the New Project tab of the Unigine SDK Browser.

Head-tracking support is available by default.

Notice
On Linux, there is no head tracking support. On Mac OS X, head tracking is available only for 64-bit application version.

Plugin Compilation

Full Oculus SDK sources are required for the AppOculus plugin compilation:

  1. Get the Oculus Rift SDK
  2. Set path to the <Oculus Rift SDK>/LibOVR folder in the OCULUSROOT environment variable:
    Shell commands
    OCULUSROOT=<Oculus Rift SDK>/LibOVR
    						
  3. Compile the plugin with the build script:
    Shell commands
    C:\UnigineSDK\utils>build.py --plugin AppOculus
    						
    You can also compile the plugin manually with Scons:
    • Go to the <UnigineSDK>\source\plugins\App\AppOculus via the command line
    • Type scons and press ENTER:
      Shell commands
      C:\UnigineSDK\source\plugins\App\AppOculus>scons
      								
Last update: 2017-07-03