Talk:CavePainting

Notes from dfk

The following comes from an October, 2008 email between Jadrian and Dan. The various bits of information here should be fleshed out and put on real wiki pages.

> 1) Is there any documentation for getting Drawing on Air running in
> the fishtank?  Two years ago, running it was an almost entirely manual
> affair, and I never got it working without assistance.

No documentation, but it's not that bad:

1. on windows, set 2 environment variables:
G = /cygdrive/c/gfx/tools/WIN32
G_WIN = C:/gfx/tools/WIN32

2. on linux, start vrpn by running:  start-vrpn-fishtank, should be in
your path as it is located in $G/bin

3. on windows start the haptic server by double clicking
Kuchora-Force-Server.bat (may not be the exact name, but whatever .bat
file you find in $G/src/kuchora/apps/forceServer)  You need to be
holding the pen in the reset (zero) position and orientation while the
program starts.

4. on linux, start up Drawing on Air (there's probably an installed
version, look in src/kuchora/apps/cavepainting/Makefile) or run from
the src directory:
cd $G/src/kuchora/apps/cavepainting
run fishtank

> 2) Is there documentation of the command line parameters / config file
> parameters for CavePainting?  I can scrape the old stuff for mono
> operation from old kiosk scripts, but I'd like to prefer to re-use
> previous documentation if possible.

Everything should default to something reasonable, there's no
documentation other than what you find in the source.  If you have
something specific, I can try to answer.  Oh, I guess you're asking
about running in mono.  This option needs to be sent to VRG3D, since
that is the library that opens up the GL window.  Typically is is done
by using the first command line argument to specify the VRG3D display
option to use.  VRG3D should have a bunch of display configuration
files that get installed in $G/lib/VRG3D.  You'll probably see
caveleft.vrsetup caveright.vrsetup, etc..  I think there should
already be caveleftmono.vrsetup, etc..  You need to make sure the cave
run script starts the programs up on each wall with the mono version
of the display config files.  At one point, we had a script to do
this.  I think there was vrg3d-runcave for stereo and
vrg3d-runcave-mono for mono or something like that.

> 3) I grepped through some of the kuchora source to create a table of
> shortcut commands, but I didn't see anything about recording video or
> the auto-rocking feature you set up for the desktop app.  How do I do
> those things?

You can do the auto-rocking by running the program on the desktop with
a -c Viewer=1 option.  This loads up the viewpoint controlled defined
in $G/src/kuchora/basesrc/ViewerHCI.*, you'll find the keyboard
commands to control the rocking in the header file there.

For video, all I've done is run the programs on my laptop and then use
a program I grabbed from the web to capture video from the screen and
save it to a file.  There's no built-in video capture, although this
may soon be possible without too much work, since I think some video
routines have been added to the latest G3D release.