CAVE Audio & Video Library

Overview
Legal
Release Notes
Installation
Use of CAVEav
Programmers Notes
Example
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:

fileCAVcam - saves each frame of video into a sequentially numbered file. The files are in rgb format.
shmCAVcam - saves each frame of video into a slot in a shared ring buffer structure. Other applications can then use that ring buffer structure as a video source.
netCAVcam - saves each frame of video into a slot in a shared ring buffer structure. The vic tool uses the ring buffer as a video source and sends the video out to the network.

Legal

Release Notes

Release 1.0 : The First Release

CAVEav 1.0 requires:

OpenGL
Irix 6.x, and
The CAVE library version 2.6

Installation

In order to install CAVEav follow these steps:

ftp the distribution file from ftp.mcs.anl.gov, in the /pub/futures-lab/CAVE directory, named CAVEav.tar.gz. Or fetch it via the WWW.
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)
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.

You must call CAVcam constructors before CAVEInit().
You must call CAVcam->Init(...) after CAVEInit().

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.