1 WHAT SETUP IS REQUIRED?

2

3 * Appropriate permissions for Oculus hidraw devices. See

4 LibOVR/90-oculus.rules and ConfigureDebian.sh.

5 * Use a multihead setup with one X screen spanning both displays (such as

6 NVidia TwinView) or place the rift on an independent X screen.

7 * Ensure oculusd is running when using the rift.

8

9 BUILD INSTRUCTIONS

10

11 After installing the appropriate packages issue 'make' in the root of

12 the SDK directory. This will build a release version of Oculus World Demo

13 (OWD). To generate debug symbols use 'make DEBUG=1'.

14

15 HOW DO I RUN OCULUS WORLD DEMO (OWD)?

16

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

18

19 SHOULD I ROTATE MY DEVICE'S SCREEN?

20

21 Manual screen rotation is not recommended. If your window is fullscreen on a

22 rift device, set the ovrDistortionCap_LinuxDevFullscreen distortion cap to

23 have the SDK automatically rotate the distortion mesh on appropriate devices.

24 Be aware you will have to account for window size. You can use

25 OVR::SDKWindow::findDevScreenForHMD (Displays/OVR_Linux_SDKWindow.h) to

26 return the screen offset and dimensions necessary to size your Linux window.

27 See Samples/CommonSrc/Platform/Linux_Platform.cpp for an example.

28

29 TWINVIEW

30

31 You must sync to the Rift's display device for a smooth experience when using

32 TwinView. To consistently sync to the rift with TwinView setups, set the

33 __GL_SYNC_DISPLAY_DEVICE environment variable to the appropriate display

34 device before X starts. For example in your /etc/profile you could place the

35 following:

36

37 export __GL_SYNC_DISPLAY_DEVICE="DFP-1"

38

39 if your rift corresponds to DFP-1.

40

41 STARTING THE TRACKING SERVICE AUTOMATICALLY

42

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

44

45 UBUNTU USERS

46

47 There was a ubuntu-specific kernel bug which affected HID devices in 14.04.

48 If you are receiving feature report failures try upgrading your distro

49 (dist-upgrade).

50

51 KNOWN ISSUES

52

53 * OWD vsync initially disabled on Radeon proprietary.

54 * Frame loss on NVidia TwinView setups. Use an independent X screen for an

55 optimal experience.

56 * Mesa DK2 latency tester does not function properly in OWD.

57