[Menu Bar] Resourses at ARSC Science at ARSC Newsroom Support About ARSC ARSC Home

VR Juggler Libraries

Description

VR Juggler is a C++ based, cross platform set of virtual reality libraries available on all Linux systems at ARSC. Several rendering APIs are available including OpenGL and OSG. Example applications including Makefiles are available in /usr/local/pkg/vrjuggler/current/share/vrjuggler/samples.

 

Setup

VR Juggler requires a number of environment variables to be set for the libraries to function properly during compilation and execution. There is a module available for VR Juggler which will set all required environment variables. 

module load vrjuggler

See the Linux workstation introduction page for more details on the modules package.

Alternately, If you choose not to use the vrjuggler module, the typical values of these environment variables are listed below for both csh/tcsh users as well as ksh/bash users.

VR Juggler environment variables for csh/tcsh

setenv VJ_BASE_DIR /usr/local/pkg/vrjuggler/current
setenv PATH ${PATH}:${VJ_BASE_DIR}/bin
setenv DZR_BASE_DIR ${VJ_BASE_DIR}/share/Doozer
setenv JCCL_BASE_DIR ${VJ_BASE_DIR}
setenv VJ_CONFIG_FILES ${VJ_BASE_DIR}/share/vrjuggler/data/configFiles
setenv VJ_CFG_PATH ${VJ_BASE_DIR}/share/vrjuggler/data/configFiles
setenv VPR_DEBUG_NOTIFY_LEVEL 2
setenv VPR_DEBUG_ENABLE 1
setenv JDK_HOME /opt/java/jdk1.5.0_05
set juggler_libs="${VJ_BASE_DIR}/lib:/usr/local/lib64:/usr/local/lib"
if ( $?LD_LIBRARY_PATH ) then
    setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:$juggler_libs
else
    setenv LD_LIBRARY_PATH $juggler_libs
endif
unset juggler_libs

VR Juggler environment variables for ksh/bash

export VJ_BASE_DIR=/usr/local/pkg/vrjuggler/current
export PATH=${PATH}:${VJ_BASE_DIR}/bin
export DZR_BASE_DIR=${VJ_BASE_DIR}/share/Doozer
export JCCL_BASE_DIR=${VJ_BASE_DIR}
export VJ_CONFIG_FILES=${VJ_BASE_DIR}/share/vrjuggler/data/configFiles
export VJ_CFG_PATH=${VJ_BASE_DIR}/share/vrjuggler/data/configFiles
export VPR_DEBUG_NOTIFY_LEVEL=2
export VPR_DEBUG_ENABLE=1
export JDK_HOME=/opt/java/jdk1.5.0_05
juggler_libs="${VJ_BASE_DIR}/lib:/usr/local/lib64:/usr/local/lib"
if [ -z "$LD_LIBRARY_PATH" ]; then
    export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$juggler_libs
else
    export LD_LIBRARY_PATH=$juggler_libs
fi
unset juggler_libs

In addition, a symbolic link is normally created from the user's home directory to the directory containing runtime configuration files. An example of how this is done is listed below.


    ln -s $VJ_BASE_DIR/share/vrjuggler/data/configFiles/ ~/.vjconfig

 

Building

VR Juggler utilizes a build system (Doozer) which determines the build requirements for an application and abstracts the design of the Makefile from the build environment. Because of this, makefiles for VR Juggler 2.0 applications require that gmake (the GNU version of make) be used. Example Makefiles can be found in the samples directory.

 

Running

VR Juggler applications normally require one or more configuration files to be passed to the application as parameters during execution. These configuration files determine how the program accepts input and where graphics are rendered. The following command runs an application using the standard simulator.

./myApp ~/.vjconfig/simstandalone.config

Other configuration files are available for the various configurations of the MD Flying Flex System in the Discovery Lab (See /usr/local/pkg/vrjuggler/current/share/vrjuggler/data/configFiles for other options).

 

File Locations

Libraries: /usr/local/pkg/vrjuggler/current/lib
Header files: /usr/local/pkg/vrjuggler/current/include

 

Features

 

More Information

 

Arctic Region Supercomputing Center
PO Box 756020, Fairbanks, AK 99775 | voice: 907-450-8600 | email:

home | search | about | support | news | science | resources