CAVE Audio & Video Library

Table of Contents

  1. Overview
  2. Legal
  3. Release Notes
  4. Installation
  5. Use of CAVEav
  6. Programmers Notes
  7. Example
  8. Troubleshooting

Overview

The CAVEav library is a set of objects that allow CAVE programmers to incorporate audio and video into CAVE applications. It will, in the future, enable programmers to collect information about multicast sessions, join, leave, create and destroy both multicast and unicast sessions. The CAVEav library is leveraging the existing tools, vic, vat and sdr to handle the underlying transportation details.

CAVcam

The CAVcam class of objects are cameras that can be placed in CAVE applications that will capture video streams from the application. Different CAVcam objects do different things with the video streams they capture:

Legal

Release Notes

Release 1.0 : The First Release

CAVEav 1.0 requires:

Installation

In order to install CAVEav follow these steps:
  1. ftp the distribution file from ftp.mcs.anl.gov, in the /pub/futures-lab/CAVE directory, named CAVEav.tar.gz. Or use the download page.
  2. use the configure script in the top level directory to configure CAVEav, the important options are --with-cavepath=<path to cave lib 2.6> and --with-vic=<path to vic> (configure --help lists all the options)
  3. while in the top level directory, run make, if that is successful, run make install. This will install the header files and library in the location you specified in the makefile.

Support Information

The CAVEav Mailing List is the first place you should send mail, should you have any questions or concerns.

Use of CAVEav

In order to successfully use the CAVEav library, I've listed the hard and fast rules here. If you have a problem with some component of CAVEav not working, check that you are not violating any of these rules first, then send mail.

Vic Installation

The netCAVcam object requires that an augmented vic program be installed, there is a binary version of this program available via ftp from ftp.mcs.anl.gov, or you can retrieve it via WWW. When you configure and compile CAVEav, you specify --with-vic=<path> to tell the CAVEav library where to find this vic. If you've retrieved a binary release of CAVEav, then the library is compiled with the path '../bin/vic'.

Programmers Notes

The collection of classes provided to support the CAVEav library is documented with doc++.

Example

There is an example application included in the CAVEav release that scuttles a small triangular object up the wall in front of the user.

Troubleshooting