Multi-channel projection software designed for domes
C++ C Makefile GLSL
Clone or download
Latest commit 3f1c336 Apr 2, 2018

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 Indian American 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.