RenderToolbox Wiki: RenderToolbox Install Linux

RenderToolbox Install Linux

How to install the Render Toolbox and its components on Linux

System Requirements:

Some flavor of Linux (not sure which ones work).
Radiance, compiled and on the system path (http://radsite.lbl.gov/radiance/HOME.html)
OpenEXR, compiled and on the system path (http://www.openexr.com)
The Subversion version control system installed on your computer (http://subversion.tigris.org/)
MATLAB (http://www.mathworks.com)
The latest version of Psychtoolbox (http://www.psychtoolbox), installed and on the Matlab path.

1. Download RenderToolbox and SimToolbox from the svn server:

Create two new directories; one for RenderToolbox and one for SimToolbox.
Download the toolbox from the SVN repository:

Anonymously

svn co https://platypus.psych.upenn.edu/repos/rendertoolbox/trunk /path/to/RenderToolbox/folder
svn co https://platypus.psych.upenn.edu/repos/simtoolbox/trunk /path/to/SimToolbox/folder

or as a contributing developer (you'll need to contact David Brainard for this)

svn co --username yourusername https://platypus.psych.upenn.edu/repos/rendertoolbox/trunk /path/to/RenderToolbox/folder
svn co --username yourusername https://platypus.psych.upenn.edu/repos/simtoolbox/trunk /path/to/SimToolbox/folder

RenderToolbox, SimToolbox, and all of their components will download, which may take a little while.
It is best to install this toolbox on a local drive for performance reasons.

2. Add RenderToolbox_2.0 and SimToolbox to the MATLAB path:

Open Matlab and run (e.g.)

>> addpath(genpath('/the/path/to/RenderToolbox/RenderToolbox_2.0'));
>> addpath(genpath('/the/path/to/SimToolbox'));
>> path(RemoveSVNPaths);

Here replace the path being added by the appropriate path for where you have installed the RenderToolbox and SimToolbox
You can also have these toolbxes added to your path at startup time by editing startup.m or manually adding and saving the path via the "Set Path" option under the File menu.

3. Compile and install PBRT_batchRender:

cd into the PBRT_batchRender_1.1 directory and then type

make clean
make

Add an environment variable PBRT_SEARCHPATH to your system and set it to the the full path of PBRT_batchRender_1.1/bin. Also add this path to your system's searchpath. For instance, add to your ~/.bashrc file a line like:

export PBRT_SEARCHPATH="/the/path/to/RenderToolbox/PBRT_batchRender_1.1/bin"
export PATH=${PATH}:${PBRT_SEARCHPATH}

If you get "Undefined symbol" or similar errors during the compilation just after "Linking pbrt" appears on the screen, the problem is probably with libraries in the OpenEXR/lib-linux folder (after compiling the files in PBRT_batchRender_1.1/core, the compiler links the resulting object files with these libraries). Try downloading a fresh version of these libraries from http://www.openexr.com/downloads.html, and follow the instructions in the README file to compile the source (though you do not need to run "make install" at the end of the README).

4. Make sure that both PBRT_batchRender_1.1/bin and the directory containing radiance are on Matlab's binary search path. Apparently linux inherits this path from the system, so the above steps should take care of this.

5. Compile and install PBRT_original:

cd into /the/path/to/RenderToolbox_2.0/PBRT_original and type,

make clean
make

If you get compilation errors, follow the directions above for downloading a new version of the OpenEXR libraries.

Now, in RenderToolbox_2.0/PBRT_original, open pbrt_orig in a text editor. When you have just checked it out, it will look something like this:

#!/bin/bash
PBRT_SEARCHPATH="/path/to/replace/PBRT_original/bin"
export PBRT_SEARCHPATH
echo " "
echo "PBRT_SEARCHPATH set to:$PBRT_SEARCHPATH"
echo "Calling $PBRT_SEARCHPATH/pbrt $*"
echo " "
/path/to/replace/PBRT_original/bin/pbrt $*

Change the first line to

PBRT_SEARCHPATH="/your/path/RenderToolbox_2.0/PBRT_original/bin"

and the last line to (noting the "$*" at the end, with a space before it)

/your/path/RenderToolbox_2.0/PBRT_original/bin/pbrt $*

Now make a link to this file in /usr/local/bin:
Log in as root, cd into /usr/local/bin, and type "ln -s /your/full/path/to/RenderToolbox_2.0/PBRT_original/pbrt_orig ." (note the trailing dot).

Now, cd into RenderToolbox_2.0/Utilities/exrtofloat and type the following:

make clean
make

Then make a link from the resulting binary file into your /usr/local/bin directory as follows:

Log in as root, cd into /usr/local/bin, and type "ln -s /your/path/to/RenderToolbox_2.0/Utilities/exrtofloat/exrtofloat ." Note the two "exrtofloat"s in the path, and the last dot.

6. Run BatchRender on the pre-made sphere example to test that everything is working correctly. (Well, this does not test the Maya plugin part.)

In Matlab, cd into RenderToolbox/examples/sphere_renderer folder.
Make sure everything is cleaned out and run the script:

unix('./clean.sh');
Render_BatchRender

If everything is configured correctly, it will render a sphere with both Radiance and PBRT. The results will be in the monitor_image_data subfolder.

RenderToolbox Wiki : BatchRenderLinux

RenderToolbox Install Linux