Open topic with navigation

Katana Plugin Configuration

Table Of Content


Supported versions

The plugin is deployed supporting several Katana builds versions. The available plugin versions are located in the Redshift main installation folder:

The Redshift for Katana plugin should be used only with the proper Katana builds. This is the list of the current released plugin versions:


Plugin installation

Linux

Run the .run file. After installation, Redshift and the Katana plugin will be installed in /usr/Maxon Redshift 20XX default folder. The Katana plugin will be in the subfolder Plugins/Katana.
To use Redshift with Katana, you'll need to edit the Katana launch script file to include the following lines, just before the katana launch exec line:

#render plugins
export LD_LIBRARY_PATH="/usr/Maxon Redshift 20XX/bin:${LD_LIBRARY_PATH}"
export KATANA_RESOURCES=/usr/Maxon Redshift 20XX/Plugins/Katana/katana2.5v4
export DEFAULT_RENDERER=Redshift

The above example shows an installation for Katana 2.5v4 in the default Redshift install location. Depending on your Katana version, please change the version number shown in KATANA_RESOURCES.


Windows

Run the exe file. After installation, Redshift and the Katana plugin will be installed in the C:\Program Files\Maxon Redshift 20XX default folder. The Katana plugin will be in the subfolder Plugins\Katana. Log files, your license file (if using a node-locked license) and the Redshift preferences file are also stored in C:\Program Files\Maxon Redshift 20XX. To use Redshift with Katana, you'll need to edit your Katana launch script .bat file to include the plugin configuration variables. Inside the plugin folder there is a standard script file (launchRedshift4Katana.bat) that you can use as reference:

rem Redshift for Katana script
set "KATANA_VERSION=2.5v4"
set "KATANA_HOME=C:\Program Files\Katana%KATANA_VERSION%"
set "REDSHIFT_HOME=C:\Program Files\Maxon Redshift 20XX\bin"
set "REDSHIFT4KATANA_HOME=C:\Program Files\Maxon Redshift 20XX\Plugins\Katana\%KATANA_VERSION%"
set DEFAULT_RENDERER=Redshift
set "KATANA_TAGLINE=With Redshift 2.5"
set REDSHIFT_CACHE_BUDGET=
set REDSHIFT_CACHE_FOLDER=
set REDSHIFT_SELECTED_CUDA_DEVICES=
set "path=%REDSHIFT_HOME%;%path%"
set "KATANA_RESOURCES=%REDSHIFT4KATANA_HOME%"
"%KATANA_HOME%\bin\katanaBin.exe"

The above example shows an installation for Katana 2.5v4 in the default Redshift install location. Depending on your Katana version, please change the version number shown in KATANA_VERSION.


Environment Variables

The Katana plugin can get some configuration parameters from environment variables, that can be defined in the Katana launch script. The plugin supports these variables: