Installation

A few steps must be undertaken for Katana to be able to load and render with the Golaem plugin.

Installing the Golaem For Katana Plugin

The Golaem for Katana plugin can be found in its own section on the Golaem Download Page and it has the following directory structure:

Adding Golaem For Katana Plugin to your Environment

Then, for Katana to be able to find the Golaem For Katana Plugin, its path needs to be added to the predefined KATANA_RESOURCES environment variable. Depending on the used rendering engine, it is also required to define where can be found the Golaem for Arnold, Renderman or Redshift plugins. There are many ways to add a path to an environment variable, however for our test, we chose to create a bat / shell file to launch Katana with the correct environment.

In the script below, the XX needs to be replaced with the right rendering plugin directory version as explained here
.

Linux

#!/bin/sh
# Set Environment Variables for Golaem
export GLM_INSTALL_PATH=/home/golaem/Golaem-7.3-Katana3.0-linux
# Set Environment Variables for Katana
export LD_LIBRARY_PATH=${GLM_INSTALL_PATH}/lib:${LD_LIBRARY_PATH}
export KATANA_RESOURCES=${GLM_INSTALL_PATH}/procedurals/katana:${KATANA_RESOURCES}
export KATANA_POST_PYTHONPATH=${GLM_INSTALL_PATH}/procedurals/katana/Python
# Set Environment Variables for Arnold For Katana
export ARNOLD_PLUGIN_PATH=${GLM_INSTALL_PATH}/procedurals/arnold/XX:${GLM_INSTALL_PATH}/shaders/arnold/XX:${ARNOLD_PLUGIN_PATH}
export DEFAULT_RENDERER=arnold
# Set Environment Variables for Renderman For Katana
export RMAN_DSOPATH=${GLM_INSTALL_PATH}/procedurals/renderman/XX
export RMAN_RIXPLUGINPATH=${GLM_INSTALL_PATH}/shaders/renderman/XX:${RMANTREE}/lib/plugins
export DEFAULT_RENDERER=prman
# Set Environment Variables for Redshift
export REDSHIFT_PROCEDURALSPATH=${GLM_INSTALL_PATH}/procedurals/redshift/XX:${REDSHIFT_PROCEDURALSPATH}
export DEFAULT_RENDERER=Redshift
# Launch Katana
/usr/local/Katana3.1/katana

Windows

:: Set Environment Variables for Golaem
set GLM_INSTALL_PATH=C:\Golaem\Golaem-7.3-Katana3.0-windows
:: Set Environment Variables for Katana
set PATH=%GLM_INSTALL_PATH%\bin;%PATH%
set KATANA_RESOURCES=%GLM_INSTALL_PATH%\procedurals\katana;%KATANA_RESOURCES%
set KATANA_POST_PYTHONPATH=%GLM_INSTALL_PATH%\procedurals\katana\Python
:: Set Environment Variables for Arnold For Katana
set ARNOLD_PLUGIN_PATH=%GLM_INSTALL_PATH%/procedurals/arnold/XX;%GLM_INSTALL_PATH%/shaders/arnold/XX;%ARNOLD_PLUGIN_PATH%
set DEFAULT_RENDERER=arnold
:: Set Environment Variables for Renderman For Katana
set RMAN_DSOPATH=%GLM_INSTALL_PATH%/procedurals/renderman/XX;%RMAN_DSOPATH%
set RMAN_RIXPLUGINPATH=%GLM_INSTALL_PATH%/shaders/renderman/XX:%RMANTREE%/lib/plugins
set DEFAULT_RENDERER=prman
:: Set Environment Variables for Redshift
set REDSHIFT_PROCEDURALSPATH=%GLM_INSTALL_PATH%/procedurals/redshift/XX;%REDSHIFT_PROCEDURALSPATH%
set DEFAULT_RENDERER=Redshift
:: Launch Katana
"C:\Program Files\Katana3.1\bin\katanaBin.exe"
Beware, to this date, Renderman For Katanana does not interpret ; (semicolon) as a valid separator for his own variables. So although all other variables will need ; as a separator, you need to use : (colon) for the RMAN_RIXPLUGINPATH variable