a library to build Virtual Reality applications with a focus on ease of use and versatility

QVR: a library for Virtual Reality applications


QVR is a library that makes writing Virtual Reality (VR) applications very easy. It is based on Qt and requires no other libraries.

QVR manages all graphics views required for a VR application, based on a configuration for the target VR environment, from multi-node multi-GPU render clusters to head-mounted displays such as the Oculus Rift. A simple change of the configuration file makes the same application run on a completely different setup.

The application only needs to implement a single interface with just a few easily understandable functions. All rendering happens in a single OpenGL context so that there are no context switching and sharing issues. Furthermore the application does not need to care about threads, but is still free to implement any threading model.

QVR allows writing VR applications in pure OpenGL as well as using arbitrary external rendering engines. Examples are provided.

Supported platforms and hardware

The library should work on every platform that has Qt (i.e. all the platforms). Currently tested are Linux, Windows, and Android.

Supported VR hardware includes:

  • Custom large-scale VR labs with multiple GPUs and/or render clusters

  • HTC Vive and SteamVR with OpenVR

  • Oculus Rift with Oculus SDK

  • Google Cardboard and Daydream with Google VR NDK

  • HDK and lots of other head-mounted displays with OSVR

  • Almost all tracking and interaction hardware with VRPN

  • Desktop-based fake-VR for development and testing purposes, including experimental support for webcam-based head-tracking via webcam-head-tracker

The library

Build and install the QVR library libqvr first. After that, you can build and try the example applications.

See the library documentation.

There is also an introductory presentation explaining the concepts of libqvr and how to use it, and a short paper from the Eurographics 2016 Education track explaining the motivation behind it.

Example applications

  • qvr-example-opengl-minimal: a minimal OpenGL-based example application that displays a rotating box.

  • qvr-example-opengl: a simple demo scene based on OpenGL.

  • qvr-example-openscenegraph: a full-featured OpenSceneGraph viewer.

  • qvr-example-vtk: a simple example of a VTK visualization pipeline within a QVR application.

  • qvr-sceneviewer: a viewer for 3D models and scenes in many file formats.

  • qvr-videoplayer: a video screen in the virtual world, for 2D and 3D videos.

  • qvr-vncviewer: a VNC viewer. Put a remote desktop in your virtual world!

  • qvr-identify-displays: a small utility to check the configuration and left/right channel separation.