Building CavePainting

Setting Up and Checking Everything Out

1. cd $G
   • Before performing this step define $G as your sandbox directory and define CVSROOT as your username@ssh.cs.brown.edu:/research/graphics/cvsroot/
     • An example can be found at Set_up_your_environment_for_diffusion_MRI_processing#Set_up_your_environment
     • The file which you must edit may vary on different operating systems
2. cvs co common
3. cvs co project
4. cvs co import
5. mkdir install_linux
6. cd $G/import
7. svn co https://vrg3d.svn.sourceforge.net/svnroot/vrg3d vrg3d

Installing VRPN

1. cd $G/import/vrpn/kit
2. unzip vrpn_07_26.zip
3. cd $G/import/vrpn/kit/quat
4. make
   • Before performing this step
     • Edit the Makefile
       • Uncomment the line corresponding to your machine's architecture
       • Change INSTALL_DIR on line 31 from /usr/local to $G/install_linux
5. make install
6. cd $G/import/vrpn/kit/vrpn
7. make
   • Before performing this step
     • Edit the Makefile
       • Uncomment the line corresponding to your machine's architecture
       • Change INSTALL_DIR on line 52 from /usr/local to $G/install_linux
8. make install

Installing G3D

1. cd $G/import/g3d/kit
2. unzip G3D-8.01-src_cvs.zip
3. cd $G/import/g3d/kit/G3D
4. ./buildg3d --install all
   • Before performing this step
     • Edit the buildg3d
       • Change installDir on line 105 from '/usr/local' to '$G/install_linux'
         • Actually type in the directory path of $G for this
       • Comment out line 362 "if osx or (ice.utils.shell("locate libzip.a") == ):"
       • Remove one indent from line 363
5. ./buildg3d --install lib

Configuring VRG3D

1. cd $G/import/vrg3d/vrg3d
2. python configure.py -vrpn $G/install_linux -g3d $G/install_linux -vrg3d $G/install_linux
   • If working on a 64 bit system, edit configure.py and make the following replacements before running this command
     • lib/libSDL to lib64/libSDL
     • lib/libGLU to lib64/libGLU
3. make allclean
4. make all
5. make install

Installing MMotion

1. cd $G/common/MMotion
2. make
   • If you get an error with this command edit the $G/common/build/make/directory.make
     • Comment out $(GCC2_SUFFIX) on lines 50 - 53
     • Comment out $(GCC3_SUFFIX) on lines 64 - 67
     • Comment out $(GCC4_SUFFIX) on lines 89 - 92
     • Comment out $(GCCX_SUFFIX) on lines 103 - 106
3. make install
4. make clean

Installing Common Kuchora Packages

1. cd $G/common/kuchora
2. make
3. make install
4. make clean

Installing CavePainting

1. cd $G/project/kuchora/cavepainting
2. make
   • If you get an error
     • Change "$(G_IMPORT)/g3d/g3d_8_$(G_COMPILER)" in $G/common/build/make/g3d.make on line 20 to "$(G)/install_linux"
3. make install

Allowing CavePainting to be Executed

1. cd $G/project/kuchora/cavepainting
2. chmod 775 run

Moving Files and Creating Symbolic Links to Work With Directory Structure

1. mkdir $G/project/kuchora/apps/
2. cd $G/project/kuchora/apps/
3. mv $G/project/kuchora/cavepainting/ $G/project/kuchora/apps/cavepainting
4. cd $G/project/kuchora/
5. ln -s $G/project/kuchora/apps/cavepainting/ cavepainting
6. cd $G/project/kuchora/
7. ln -s $G/common/kuchora/data/ kdata
8. mkdir $G/lib/
9. mkdir $G/lib/kuchora/
10. cd $G/lib/kuchora/
11. ln -s $G/project/kuchora/kdata/images/ images
12. cd $G/lib/kuchora/
13. ln -s $G/project/kuchora/kdata/fonts/ fonts

Running CavePainting in Desktop Mode

Error creating thumbnail: /bin/bash: line 1: /usr/bin/convert: No such file or directory Error code: 127

CavePainting Running in Desktop Mode

1. cd $G/project/kuchora/apps/cavepainting
2. ./run desktop

Running CavePainting in the CAVE

1. cd $G/project/kuchora/apps/cavepainting
2. ./run cave