CAVE Audio & Video Library
Table of Contents
- 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 use the download page.
- 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.
Troubleshooting