PrimaPlayer is a hologram video player with haptic feedback and hologram video actors whose bodies react to the touch of VR controllers. PrimaPlayer works with Oculus Rift, HTC Vive, and other OpenVR-compatible VR headsets, as well as standard 2D displays.

Upon running PrimaPlayer.exe, the software automatically detects if you have a Leap Motion, a VR headset, or neither installed, and renders the video accordingly.

 

Recommended Hardware

Intel Core i5 and GeForce GTX 970, or equivalent AMD hardware.

 

VR Headset And Controller Instructions

HTC Vive and Oculus Touch users need the SteamVR application that can be downloaded from Steam:
http://store.steampowered.com/

Oculus Rift users need to install Oculus Home application:
https://www.oculus.com/en-us/setup/

The "Unknown Sources" option from the General tab of Oculus Home Settings must be enabled for PrimaPlayer to work with Oculus Rift:
http://www.howtogeek.com/wp-content/uploads/2016/06/img_5761a86168132.png

SteamVR is required for Oculus Touch and other OpenVR-compatible VR controllers. The haptic feedback is optimized for HTC Vive controllers, but it also works with Oculus Touch. In the current version the virtual Oculus Touch controller buttons do not have labels on them, so you  need to memorize their functionality (see the below 'Controls' guide).

VR headsets require a Windows 7, 8.1, or 10 operating system, and a DX11 compatible graphics card.

Nvidia recommends that VR headset owners with an Nvidia GPU use GeForce driver version 361.91 or later. We have tested that at least version 368.69 works:
http://www.geforce.com/drivers

AMD recommends that VR headset owners with a Radeon GPU use Radeon Software Crimson Edition 16.3.2 or later:
http://support.amd.com/en-us/download

 

Leap Motion VR Setup

PrimaPlayer supports Leap Motion only in the VR setup, where Leap Motion is attached to a VR headset:
https://developer.leapmotion.com/vr-setup

You need to have the latest Leap Motion 3.1.3+ software (Orion) installed. Make sure that the "Allow Images" option is enabled in General tab of Leap Motion Control Panel. Plug the Leap Motion device into your computer's USB port, and not in the VR headset's USB extension port. We recommend that you acquire the "Universal VR Dev Mount" for Leap Motion, which comes with a 15 foot USB extension cable:
https://store.leapmotion.com/

Leap Motion is only used to increase immersion by allowing you to see your own hands in the virtual world. It is not used for interactive video or navigation controls.

While the Leap Motion sensor is connected, any VR controllers such as those of HTC Vive will not affect the bodies of the hologram actors, so that computing resources are spared.

If the hand images appear upside down in PrimaPlayer, you can turn off the "Auto-orient Tracking" and apply Reverse Orientation from Leap Motion Control Panel. Generally the auto-orientation works quite well.

For best finger tracking results, perform the Leap Motion recalibration:
https://www.youtube.com/watch?v=AXHH-QXqzlI

You could also use the Leap Motion Control Panel Visualizer and try to setup your workspace so that there is a clear contrast between your hands and the background like in this video:
https://www.youtube.com/watch?v=lJ4twi6jaSk

The Leap Motion overlay mode of PrimaPlayer 0.7 is not present in this version, because the latest Leap Motion SDK has temporarily removed the means to implement it. If you want to use the overlay mode, you can do so with Oculus Rift DK1 or DK2 by downloading and running PrimaPlayer 0.7:
https://f001.backblazeb2.com/file/Primavirtual/PrimaPlayer07win.zip

 

Controls
 Rotate view

 Vive controller: rotate (Grip) button

 Oculus Touch: hand (grip) trigger

 Click and drag with right mouse button

 Move view

 Vive controller: move (Menu) button

 Oculus Touch: Y / B button

 Click and drag with left mouse button

 Scroll mouse wheel

 Arrow keys, WASD-keys

 View height  Q- and E-keys
 Pause / Play

 Vive controller: pause/play button

 Oculus Touch: thumb stick button (stick pointing down)

 SPACE

 Fast forward / Step frame forward

 Vive controller: fast forward button

 Oculus Touch: thumb stick button (stick pointing right)

 . (period)

 Rewind / Step frame backward

 Vive controller: rewind button

 Oculus Touch: thumb stick button (stick pointing left)

 , (comma)

 Vibrate & jiggle holograms locally

 Vive controller: trigger button

 Oculus Touch: index finger trigger

 Show / Hide help menu  F1
 Show / Hide FPS display  BACKSPACE
 Show / Hide control panel

 Vive controller: hide/show button

 Oculus Touch: thumb stick button (stick pointing up)

 RETURN

 Enable / Disable edge blur effect  F4
 Toggle main window rendering (VR headset required)  F8
 Enable / Disable interactive skin (Leap Motion or VR controllers)  F11
 Enable / Disable haptics (HTC Vive controllers required)  F12
 Change Leap Motion hand color  H
 Switch between 2D and hologram mode  P

 

Gamepads, such as the wireless Xbox 360 controller, are also supported.

 

VR Headset Issues

If your CPU or GPU do not meet the recommended hardware setup, you might see black tearing. You could also experience so called "judder", where the view inside the VR headset does not animate smoothly when you move your head.

You can try remedying these issues by disabling edge blur effect with F4-key. Disabling interactive skin (F11-key) and haptics (F12-key) will also increase the frame rate and reduce judder.

PrimaPlayer should be displayed correctly in VR headsets with all up-to-date versions of SteamVR (for HTC Vive and other OpenVR-compatible VR headsets) and Oculus Home (for Oculus Rift). We have tested that at least SteamVR build from September 7th 2016 (version 1473196558) and Oculus App Version 1.8.0.277202 work properly.

 

Troubleshooting

If you have multiple GPUs, connect your VR headset HDMI cable to your main GPU display port. Keep SLI turned off.

If the VR headset screen remains black upon starting PrimaPlayer, try restarting SteamVR. You can also try restarting your computer.

If PrimaPlayer freezes upon start-up, bring up Task Manager with CTRL-ALT-DEL, go to "Processes" tab, and end the "PrimaPlayer.exe" process. Restart the application and it should work.

When you run into problems that you can't solve, contact us at
contact@primavr.com