virtual_reality_viewport icon indicating copy to clipboard operation
virtual_reality_viewport copied to clipboard

Addon to bring virtual reality devices to the Blender viewport

Virtual Reality Viewport

Addon to bring virtual reality devices to the Blender viewport.

This is work in progress, use at your own risk.

Pre-Requisite

  • Blender 2.77 (https://builder.blender.org/download)

Oculus Legacy (Linux, Mac, Windows)

  • Oculus 0.5 runtime

Oculus (Windows)

  • Oculus 1.5 runtime

How to Use

In the User Preferences, Add-ons, 3D View: Virtual Reality Viewport select the Display Backend you want to use.

In the viewport go to the toolshelf, select the Virtual Reality tab, click on the Virtual Reality button and follow the on-screen instructions.

Current State

Video of an old version of the plugin working:

Video of plugin in action

Easy Installation

You can get the latest version of the Addon here: http://www.dalaifelinto.com/ftp/builds/space_view3d_virtual_reality.zip

Advanced Installation

In a terminal paste the following commands:

$ git clone https://github.com/dfelinto/virtual_reality_viewport.git
$ cd virtual_reality_viewport
$ git submodule update --init --recursive --remote
$ zip -x __pycache__ -x */.git* -r9 space_view3d_virtual_reality.zip space_view3d_virtual_reality

Now install the space_view3d_virtual_reality.zip in Blender as an addon.

Update

In a terminal paste the following commands:

$ git pull origin master
$ git submodule update --recursive --remote

Followed by the rsync command for your OS:

Mac:

$ rsync -rv --exclude=.DS_Store --exclude=.git --exclude=*.blend1 --exclude=*.blend2 --exclude=*.swp --exclude=*.swo space_view3d_virtual_reality ~/Library/Application\ Support/Blender/2.76/scripts/addons/

Linux:

$ rsync -rv --exclude=.DS_Store --exclude=.git --exclude=*.blend1 --exclude=*.blend2 --exclude=*.swp --exclude=*.swo space_view3d_virtual_reality ~/.config/blender/2.76/scripts/addons/

Optionally, instead of rsync you can generate a new .zip, remove the previous version of the addon and re-install it.

Roadmap

  • Upgrade Oculus SDK 0.7 to 1.3
  • Extend the external bridge library to support other HMD devices

Credits

  • Oculus SDK 0.5 wrapper by https://github.com/jherico/python-ovrsdk
  • Oculus SDK 0.7/1.5 bridge: Dalai Felinto and Djalma Lucio @ Visgraf / IMPA
  • Blender Addon - Dalai Felinto - http://www.dalaifelinto.com

Old Versions

For the previous version (with support for Oculus DK1 via runtime 0.7): http://www.dalaifelinto.com/ftp/builds/space_view3d_virtual_reality_dk1.zip

Acknowledgements

  • Visgraf / IMPA - for supporting the core of the addon development
  • Djalma Lucio for peer review and discussions about the bridge implementation
  • Campbell Barton - for reviewing and contributing to the patches for Blender core
  • Thanks for all the testers