README for VT-CAVE CCC_atom ver 1.0
This program is based on Limbo 0.5, Atomview and CCC ver 3.1. For
more specific information on the code itself and how atomview was merged
with the CCC the files "code_changes" and "code_overview" within the tar
file. This page covers how to set-up ccc_atom version 1.0 to run
on your machine and contains the following information:
1. Initial Setup (same as CCC version 3.1):
1.
Download the ccc_atom-bin-SGI.tar.gz file, the curses.tar file and the
optional atoms.tgz file from our
site
OR
if you think you may want to modify the code then you will need the following
instead: the ccc_atom-src.tar.gz file, the new
CAVERN
tar file, the curses.tar file, and the optional atoms.tgz from our
site.
For
Compiled Code Users (ccc_atom-bin-SGI.tar.gz)
– The
binary executables were made for N32 using threads. Unless you want to
change these values or modify the code it is recommended to use this method.
2.
Unzip and untar the ccc_atom file.This
can be put anywhere and will create a ccc_atom directory upon unzipping.
3.
Unzip and untar the optional atoms.tgz file.Because
ccc_atom does not transfer the atom files between participants (too big
and too many) there must be a standard common place that everybody puts
their models. This place was chosen to be the ccc_atom directory
itself. So the atom files must be untarred and placed within this
directory for the program to work correctly when you wish to connect to
other servers.
4.
The curses file should be put in the perl5 directory and untarred from
there (it will add some necessary perl scripts). You will most likely have
to be logged on as root to do this.
For
Source Code Users (ccc_atom-src.tar.gz)
2. Untar
the first two files (ccc_atom and CAVERN). These can be put anywhere, but
both should be in the same base directory (e.g. both untarred in /users/people/homer/
will create /users/people/homer/CAVERN and /users/people/homer/ccc_atom).
3. Unzip
and untar the optional atoms.tgz file.The
models can be put anywhere, but for convenience should most likely be put
within the ccc32 directory or a subdirectory within this.
4. The
curses file should be put in the perl5 directory and untarred from there
(it will add some necessary perl scripts). You will most likely have to
be logged on as root to do this.
5. Limbo
was made to be able to operate on 32, N32 and 64 bit operating systems.If
you know which one you are then you should modify the Makefile within the
ccc_atom directory to refer to the appropriate thread or sproc files (you
can also choose between sproc or thread).The
line looks like this:
Include usrnew/people/gredward/CAVERN/CAVERN_MAKEFILE_INCLUDES_PTHREAD_N32
If you want to use 64 bit then change the
N32 to 64 (..._PTHREAD_64), and similarly for 32.You
will also have to change the CAVERN directory references within the first
12 lines so that it knows where to look for your CAVERN and CAVE directories
(step 7).
6.
Also within the ccc_atom directory you must change the CAVERN_MAKEFILE_INCLUDES_N32
(or 32) file to refer to where you put the CAVERN directory.
7. Within
the CAVERN directory you have to change the appropriate PTHREAD or SPROC
include file (the one you chose to use in step 5) to reference your CAVERN
and CAVE directory.
e.g.
CAVERN=/usrnew/people/gredward/CAVERN
8. Now
to compile the code you must be in the ccc_atom directory, then type "make
all".
2. How to Run CCC_atom:
1. To run the ccc_atom, enter the ccc_atom directory
and type startCCC.
2. You are now presented with many options:
- Name: whatever you want your
name to appear as in the world. By default it will use your username,
but you can change this to be
whatever you want for the purposes of the CCC.
- I want to work: alone will mean that
you cannot meet with other people in a common world somewhere. If
you want to work with others
then keep the default of collaborating in world
named limbo. If there is another world you wish to use then replace
limbo by this.
- Connecting to: to be the server
or work alone keep the default. To connect to someone else enter
their computer address name (i.e. viz8.sv.vt.edu) or the IP address of
the computer you want to connect to.
- Running on: if you want the menu system
then select desktop. If you want the voice commands then select CAVE.
If you want to run voice commands you will have to have a separate voice
recognition software package and you will need to run a "throw -p grammar"
session. For more information on this please refer to the voice
recognition section of the ccc
web page.
- Remove other people...: This option
is a timeout option for deleting users that may have become inactive or
have lost the connection. If you plan to wait a long time for someone while
doing nothing then you may want to set this value to be quite high.
On the downside, if the value is high and the person becomes disconnected
in a non-standard way (if they exit normally there is no problem), then
your computer will still think they are they for a long time and will create
multiple copies of them if they try to log in to the world again during
this period.
- Start the CCC: start your engines!!!
:)
Greg
Edwards
Virginia Tech
VT-CAVE
Created 10/16/99, Revised 05/12/00
http://www.sv.vt.edu/future/cave/software/cccatom/install_atom.html