Multi-channel projection software designed for domes
Branch: master
Clone or download
Latest commit 5c33fad Nov 15, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin/data Update default xml settings Jan 31, 2016
src Un-define debug Oct 2, 2015
vDome.xcodeproj Update of-0.9.0 Sep 25, 2015
.gitignore
LICENSE Remove md extension Feb 27, 2015
Makefile
Project.xcconfig Update of-0.9.0 Sep 25, 2015
README.md Update README.md Nov 15, 2018
addons.make
config.make Update of-0.9.0 Sep 25, 2015
icon.rc Update of-0.9.0 Sep 25, 2015
logo.icns Add custom icon Dec 17, 2013
openFrameworks-Info.plist Update of-0.9.0 Sep 25, 2015
vDome.cbp Update of-0.9.0 Sep 25, 2015
vDome.filters Rename VS project to vDome Apr 23, 2014
vDome.sln Update of-0.9.0 Sep 25, 2015
vDome.user Rename VS project to vDome Apr 23, 2014
vDome.vcxproj
vDome.vcxproj.filters Update of-0.9.0 Sep 25, 2015
vDome.vcxproj.user Update of-0.9.0 Sep 25, 2015
vDome.workspace Add codeblocks files Jun 18, 2014

README.md

vDome

Multi-channel projection software designed for domes. Provides real-time warping and slicing for domemaster input.
Developed by Charles Veasey for the Institute of American Indian Arts (IAIA).

Windows Builds:
https://drive.google.com/drive/folders/0B4gYtwXbgYOhZXlMSUlkV1lCUEU

v0.1) The version that matches the manual.

v0.2) The unfinished version including the media player.

Note: this project is no longer active. You may want to check out this actively developed software:
https://github.com/paperManu/splash

Overview

vDome is an application designed to calibrate multiple projectors on a hemispherical dome surface and display a domemaster formatted video, image, or interactive application. vDome also supports the playback of HD video files. vDome is generally used in two ways: 1) as a media player and 2) as a background process that listens to hardware/software input streams such as cameras, capture cards, and inter-application protocols such as Syphon, Spout, and Video4Linux.

As a media player vDome utilizes native os media libraries and accepts most common file formats and codecs of the operating system. In general:

  • Mac OS X: QuickTime, AV Foundation, HAP
  • Win 7/8: Windows Media Foundation, DirectShow, QuickTime, HAP
  • Linux: GStreamer

For optimized video playback, use the following codecs:

  • OS X: ProRes 422 and H.264
  • Windows 8.1: H.264 and WMF
  • Linux Ubuntu: H.264

To assist in media playback and creating playlists check out the vDome Player interface:
https://github.com/charlesveasey/vDome-player

Capture and camera inputs are hardware video stream solutions. A capture card is a flexible solution that allows one to run any application on the dome by sending the video output of one computer into another machine running vDome. With this, vDome essentially becomes the 2nd monitor on your production machine. Drag the After Effects or Unity preview window onto the dome and edit in real-time, play videos through your favorite media player: Quicktime, VLC, etc.

Syphon is a graphic interapplication protocol for OS X:
http://syphon.v002.info

Spout is a graphic interapplication protocol for Windows:
http://spout.zeal.co

Video4Linux is a graphic interapplication protocol for Linux:
http://en.wikipedia.org/wiki/Video4Linux

Compiling

All

Mac

  • Suggested IDE: Xcode v5.1.1
  • Syphon needs to be copied to Frameworks
    • Under target, add a Copy Files Build Phase. Drag the Syphon.framework into this phase.
  • Clone to: openFrameworks/addons:

Win

Linux

  • Install openFrameworks dependencies, see INSTALL.md in openFrameworks linux package
  • Suggested IDE: Code::Blocks 10.04
  • Can also run make in root directory

Installation

Mac

Win

Linux

Setup and Calibration

Initial setup is done in XML (setting resolution, number of projectors, and input type). Calibration is done directly on the dome. For more information see the manual:
https://docs.google.com/document/d/1EHPpExjznFF6X0YTY5acLS0MNkEbtVFsLBCoJ2HHQlQ/


Funding provided by the United States Department of Defense. Based on prior research from the University of New Mexico (UNM) and IAIA with funding provided by the National Science Foundation.

Thanks to research by the ARTS Labs at UNM and Paul Bourke at the University of Western Australia.