Present3D Setup

Present3D has many set up options to help set up with stereo, screen size, screen distance, the look cursors and many others. These are can be set up either in the command line before a presentation is launched or in the configuration file for the command shell (.tcshrc or .bashrc). The example below is an example of a configuration file for the tcsh shell: 

setenv PRESENT3D_HOME /path/to/application/directory 
setenv PATH ${PATH}:${PRESENT3D_HOME}/bin:/usr/local/lib/ 
setenv DYLD_LIBRARY_PATH ${PRESENT3D_HOME}/lib:${PRESENT3D_HOME}:/lib/osgPlugins 

setenv OSG_FILE_PATH "~/OpenSceneGraph-Data:~/present3D/ 
 
setenv DYLD_BIND_AT_LAUNCH 

source /sw/bin/init.csh 

setenv OSG_EYE_SEPARATION  0.06 
setenv OSG_SCREEN_DISTANCE 2.0 
setenv OSG_SCREEN_HEIGHT  1.26 
setenv OSG_SCREEN_WIDTH  1.68 
setenv OSG_STEREO ON 
setenv OSG_STEREO_MODE HORIZONTAL_SPLIT 
setenv OSG_SPLIT_STEREO_HORIZONTAL_EYE_MAPPING LEFT_EYE_RIGHT_VIEWPORT 
setenv P3D_CURSOR /Applications/cursors/crosshair.tiff 
setenv OSG_NOTIFY_LEVEL Always
  • setenv OSG_EYE_SEPARATION 0.06 This sets the eye separation for the stereo setup, this should normally be left 0.06 (60 mm).
  • setenv OSG_SCREEN_DISTANCE 2.0 This is the distance in meters from the screen to the design eye point, or main viewer/person. Changing this will reduce or increase the apparent stereo effect, it will also affect the computation of near and far planes, and if clipping occurs with certain data-sets changing this value to a larger distance may resolve the problem.
  • setenv OSG_SCREEN_HEIGHT 1.26 This should be set to the actual dimensions of the screen (meters) that is being used. When using projection remember to preserve the proportions of the source, i.e. 4x3 or 5x4.
  • setenv OSG_SCREEN_WIDTH 1.68 This should be set to the actual dimensions of the screen (meters) that is being used. When using projection remember to preserve the proportions of the source, i.e. 4x3 or 5x4.
  • setenv OSG_STEREO ON To switch stereo off change to : setenv OSG_STEREO OFF
  • setenv OSG_STEREO_MODE HORIZONTAL_SPLIT This controls the stereo options, for anaglyphic change to : setenv OSG_STEREO_MODE ANAGLYPHIC
  • setenv OSG_SPLIT_STEREO_HORIZONTAL_EYE_MAPPING LEFT_EYE_RIGHT_VIEWPORT To enable Present3D to be used with other stereo applications where the eyes have been set incorrectly. Comment out if not required by adding a hash (alt 3 on UK keyboard) :

#setenv OSG_SPLIT_STEREO_HORIZONTAL_EYE_MAPPING LEFT_EYE_RIGHT_VIEWPORT

  • setenv P3D_CURSOR /Applications/cursors/crosshair1.tiff this allows you to change the way the cursor looks, just change the path to an image file of the cursor you wish to use.
  • setenv OSG_NOTIFY_LEVEL always this suppresses any errors or command line feed back, which is a important when presenting.