Addon to bring virtual reality devices to the Blender viewport
Python
Switch branches/tags
Nothing to show
Clone or download
Latest commit 8361cf1 Jul 25, 2016

README.md

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

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

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