The Arnold for Katana plugin comes with Arnold core bundled but without the SDK. Setting it up generally requires pointing to your license server(s), setting
KATANA_RESOURCES, and And launching Katana.
Run the downloaded installer, which will pop up a window to walk you through the installation process. You should have installed your desired Katana version previously.
KtoA has a bundled script for launching KtoA with your desired version of Katana. It is recommended to customize that script (or a copy of it) for your environment , and use it or a shortcut to it to launch KtoA. See the files
launchKtoA.sh (Linux) and
launchKtoA.bat (Windows) for a typical launch script.
KtoA comes bundled with Arnold core and is tuned to work with the version it is bundled with. It also has additional plugins, such as common shaders, volume plugins (OpenVDB volumes), kick, the Arnold Python API, and so on. Generally, to launch Katana with KtoA, you just need to expand the KtoA tarball and set the following environment variables, customized to your environment (the PATH and license variables are not required):
On Linux, after installing Katana and downloading KtoA, the following environment variables ought to be set, and an example of each is given:
KTOA_ROOTis a convenience convenient for setting the other environment variables; neither KtoA nor Katana make direct use of it.
PATHcould be modified to include at least the KtoA bin directory and directory, and additionally, you can include
$KATANA_HOMEas well to place the
katanabinary in your path for convenience.
KATANA_RESOURCESshould be set or modified to include the KtoA renderer resources; this is simply the path to the KtoA installation directory.
On Linux, if If you are using a bash shell on Linux, you should consider creating a script to set the main environment variables and launch Katana for you.
Katana to Arnold KtoA ships with multiple USD plugins, a Render Delegate, a Node Registry Plugin, a custom build of Foundry's KatanaUsdPlugins, and plugins for UsdIn.
These plugins can be activated by either using the launch scripts or manually setting the environment variables listed below.
Katana to Arnold KtoA includes two components from Arnold-USD to allow using Arnold directly in the Hydra Viewport.
KtoA includes a custom build of Foundry's Katana USD Plugins, which replaces Katana's one when using the launch scripts. There is also a set of plugins for UsdIn, named KatanaUsdArnold, included in the installation. These allow importing Arnold specific information, like shaders, using UsdIn.
KTOA_LOAD_VERBOSITY:how chatty do you want Arnold to be when loading shaders/plugins for eplugins e.g. for Katana material nodes. Values are
debugis the default. This can help diagnose issues such as missing shaders or OSL shaders that can't be compiled.
PYTHONPATH:you may want to extend this to include the python subdirectory of your Arnold installation (
(deprecated) ARNOLD_SHADERLIB_PATH: you may extend the areas that Katana searches for your Arnold shaders with this variable
ARNOLD_PLUGIN_PATH: you may extend the directories that KtoA searches for your Arnold shaders, procedurals, volumes, drivers, etc. plugins
PATH: if you wish to use kick or maketx directly from KtoA, please append to this the path to the bin subdirectory of KtoA
LD_LIBRARY_PATH: usually does not need to be set, but to get access to libai.so it may be necessary to append the bin subdirectory of KtoA
(deprecated) ARNOLDTREE:This is not used anymore. It is used to specify the path to your Arnold installation root. This is not used by Arnold itself, but by Katana's Arnold integration; if you do not set this, you could instead symlink the path from your Arnold installation to
foundry_LICENSEis set to your port and license server for Katana, e.g. 4101@localhost 4101@localhost; please see The Foundry's documentation on licensing of Katana for more information
ADSKFLEX_LICENSE_FILEis set to your
port@hostfor Autodesk CLM licensing of Arnold
solidangle_LICENSEis set to your port and license server for Arnold, e.g. 5053@localhost 5053@localhost; or, it is set to the path of your node-lock license file
(deprecated) ARNOLD_LICENSE_HOSTis set to your license server for Arnold, possibly localhost
(deprecated) ARNOLD_LICENSE_PORTis set to your license server's port, usually 5053