Setup guide

Unity | Introduction | 7
Monitor Setup
To get the best experience, you and your users should always configure the Rift correctly.
In Windows 7 and Windows 8, you can change Windows' display settings by right-clicking on the desktop and
selecting Screen resolution.
• It is possible to clone the same image on all of your displays. To ensure each display uses the correct
frequency, Oculus recommends extending the desktop instead of cloning it.
• If you are using the Rift in extended mode, it should be set to its native resolution. This is 1920x1080 for DK2
and 1280x800 for DK1.
On Mac systems open System Preferences, and then navigate to Displays.
• As with Windows, it is possible to mirror the same image on all of your displays. Oculus recommends against
mirroring. Click Arrangement and ensure Mirror Displays is not enabled.
• Some Unity applications will only run on the main display. In the Arrangement screen, drag the white bar onto
the Rift's blue box to make it the main display.
• Always use the Rift's native resolution and frequency. Click Gather Windows. For DK2, the resolution
should be Scaled to 1080p, the rotation should be 90° and the refresh rate should be 75 Hertz. For DK1, the
resolution should be 1280x800, the rotation should be Standard, and the refresh rate should be 60 Hertz.
Recommended Configuration
We recommend the following settings in your project:
• On Windows, enable Direct3D 11. D3D 11 and OpenGL expose the most advanced VR rendering
capabilities. In some cases, using D3D 9 may result in slightly reduced visual quality or performance.
• Use the Linear Color Space. Linear lighting is not only more correct for shading, it also causes Unity to
perform sRGB read/write to the eye textures. This helps reduce aliasing during VR distortion rendering,
where the eye textures are interpolated with slightly greater dynamic range.
• Never clone displays. When the Rift is cloned with another display, the application may not vsync properly.
This leads to visible tearing or judder (stuttering or vibrating motion).
• On Windows, always run DirectToRift.exe. Even in extended mode, DirectToRift.exe makes your application
run full-screen on the Rift.
• When using the Unity editor, use extended display mode. Direct mode is currently supported only for
standalone players. Using it with the Unity editor will result in a black screen on the Rift.
Preparing for Development: Mobile SDK
When developing for mobile, please be sure to fully review all of the relevant performance and design
documentation, especially the Best Practices: Mobile. Mobile apps are subject to more stringent limitations and
requirements and computational limitations which should be taken into consideration from the ground up.
Entitlement checking, used to protect apps from unauthorized distribution, is disabled by default in Unity. For
more information and instructions, see "VrPlatform Entitlement Checks" in the Mobile SDK documentation.
We hope that the process of getting your Oculus device integrated into your Unity environment is a fun and easy
experience.