Building & Installation

Building

The plugin will theoretically build for any RenderMan-compatible renderer that implements the pointcloud api but the included CMake build script assumes you have 3Delight or PRMan installed.

Ensure you have Houdini (10.*), either 3Delight (9.0) or PRMan (15.0) and CMake (2.8) installed. You should set the following environment variables before running cmake.

RMAN - set to either 3Delight or PRMan
DELIGHT - (3Delight only) the path to your 3Delight installation.
RMANTREE - (PRMan only) the path to your RPS installation.
HFS - The path to your Houdini install.

Run cmake and then make.

dan@samus:~/code/rmanptcsop$ cmake .
-- The C compiler identification is GNU
-- The CXX compiler identification is GNU
-- Check for working C compiler: /usr/bin/gcc
-- Check for working C compiler: /usr/bin/gcc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Found Houdini: /opt/hfs10.0.528/toolkit/include
-- Found 3Delight: /usr/local/3delight-9.0.9/Linux-x86_64/include
-- Configuring done
-- Generating done
-- Build files have been written to: /home/dan/code/rmanptcsop
dan@samus:~/code/rmanptcsop$ make
Scanning dependencies of target rman_ptc_sop
[ 50%] Building CXX object CMakeFiles/rman_ptc_sop.dir/src/SOP_rmanPtc.cpp.o
[100%] Building CXX object CMakeFiles/rman_ptc_sop.dir/src/GR_rmanPtc.cpp.o
Linking CXX shared library rmanPtcSop.so
[100%] Built target rman_ptc_sop

Once built you will need to copy the plugin and the support files (located in the share subdirectory) to a destination that Houdini recognises. For more information on custom plugins and support file installation locations please refer to the Creating Custom Plugins section of the HDK Documentation.

File	Search Path	Example Destination
Plugin (rmanPtcSop.so)	$HOUDINI_DSO_PATH	$HOME/houdiniX.Y/dso
Operator Icon (rmanPtc.svg)	$HOUDINI_UI_ICON_PATH	$HOME/houdiniX.Y/config/Icons
Help Card (rmanPtc.txt)	$HOUDINI_PATH/help	$HOME/houdiniX.Y/help/nodes/sop

Documentation

RmanPtcSop comes with a Houdini help card but you can also build these documentation pages if you like. Just run doxygen from the project root on the config/docs/doxygen.cfg file and the documentation will be generated in a docs directory.

dan@samus:~/code/rmanptcsop$ doxygen config/docs/doxygen.cfg