Building CavePainting

Currently, this has only been tested and shown to work on the CCV test curved wall at 94 Waterman.

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://svn.code.sf.net/p/vrg3d/code/ 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
9. cd $G/import/vrpn/kit/vrpn/server_src
10. make
    • Before performing this step
      • Edit the Makefile
        • Uncomment the line corresponding to your machine's architecture
        • Change INSTALL_DIR on line 29 from /usr/local to $G/install_linux
11. 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 update
   • Before performing this step
     • Edit 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
   • If you encounter an error related to usleep, a discussion of this bug can be found here
5. ./buildg3d --install lib

Configuring VRG3D

VRG3D Documentation

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
       • If you're on the Brown CS system, you may have to substitute /lib with /lib/x86_64-linux-gnu
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/compile.gcc.local.make
     • Comment out $(GCC2_SUFFIX) on lines 50 - 53
     • Comment out $(GCC3_SUFFIX) on lines 64 - 67
     • Comment out $(GCC4_SUFFIX) on lines 90 - 93
     • Comment out $(GCCX_SUFFIX) on lines 104 - 107
   • If the environment variable GARCH is not set, set it, or you will be prompted to do so
3. make install

Installing Common Kuchora Packages

1. cd $G/common/kuchora
2. make
   • Before performing this step the second time
     • Edit $G/common/kuchora/base/KuchoraBaseApp.H and make the following replacements before running this command:
       • "_camera" to "_cameras[0]" on line 42
3. make install

Installing CavePainting

1. cd $G/project/kuchora/cavepainting
2. make
   • If you get an error about missing -lGLG3D
     • Change "$(G_IMPORT)/g3d/g3d_8_$(G_COMPILER)" in $G/common/build/make/g3d.make on line 20 and "$(G_IMPORT)/g3d/g3d_8.01_$(G_COMPILER)_64" on line 17 to "$(G)/install_linux"
   • If you get an error about missing -lvrg3d:
     • Substitute lib64 with lib on line 18 of $G/common/build/make/vrg3d.make. The sed command 's/lib64/lib/g' should fix this.
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