aboutsummaryrefslogtreecommitdiffstats
path: root/LINUX_README
blob: 0e93e0e77fdbbe4e60317737cd25bdf67ede1826 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
This documentation assumes you have an nvidia graphics card. We have tested
on Ubuntu 14.04, Debian Stable 7.6, and Fedora 20.

WHAT SETUP IS REQUIRED?

  * Appropriate permissions for Oculus hidraw devices. See
    LibOVR/90-oculus.rules and ConfigurePermissionsAndPackages.sh .
  * Use a non-rotated twinview setup or place the rift on a separate 
    non-rotated X screen.
  * Ensure oculusd is running when using the rift.

BUILD INSTRUCTIONS

  After installing the appropriate packages simply issue 'make' in the root of
  the SDK directory. This will build a release version of Oculus World Demo
  (OWD). To generate debug symbols use 'make DEBUG=1'.

HOW DO I RUN OCULUS WORLD DEMO (OWD)?

  Either run the binary directly from the output directory, or use 'make run'.

SHOULD I ROTATE MY DEVICE'S SCREEN?

  Manual screen rotation is not recommend. If your window is fullscreen on a
  rift device, set the ovrDistortionCap_LinuxDevFullscreen distortion cap to
  have the SDK automatically rotate the distortion mesh on appropriate devices.
  Be aware you will have to account for window size. You can use
  OVR::SDKWindow::findDevScreenForHMD (Displays/OVR_Linux_SDKWindow.h) to
  return the screen offset and dimensions necessary to size your Linux window.
  See Samples/CommonSrc/Platform/Linux_Platform.cpp for an example.

SEPARATE X SCREEN

  ConfigUtil will not currently work across X screens. You will need
  to use TwinView to use ConfigUtil.

TWINVIEW

  You must sync to the Rift's display device for a smooth experience when using
  twinview. To consistently sync to the rift with Twinview setups, set the
  __GL_SYNC_DISPLAY_DEVICE environment variable to the appropriate display
  device before X starts. For example in your /etc/profile you could place the
  following:

    export __GL_SYNC_DISPLAY_DEVICE="DFP-1"

  if you're rift corresponds to DFP-1.

STARTING THE TRACKING SERVICE AUTOMATICALLY

  Start the tracking service when a user is logged in using Xsession files.

UBUNTU USERS

  There was a kernel bug which affected HID devices in 14.04. If you find you
  are receiving feature report failures, please upgrade your distro as the
  bug is now fixed.