...
| Environment Variable | Default Installation Paths |
|---|---|
RMANTREE | /opt/pixar/RenderManProServer-2223.05 |
| /opt/pixar/RenderManForKatana-2223.05-katana2katana4.60/plugins/Resources/PRMan22PRMan23 |
RMAN_SHADERPATH and/or RMAN_RIXPLUGINPATH environment variables to include your specific paths. These environment variables replace rather than append to the default paths, so you will need to include the default paths as well.Output Path Variable
You can direct the render log output to another location if necessary using the following environment variable: RFK_REDIRECT_OUTPUT
You can also use RFK_OVERRIDE_RENDER_ACTION When set, this overrides the default processing for render outputs to always render directly to the renderLocation specified in the RenderOutputDefine node without any copying or processing from Katana.
Shader Discovery
During startup RenderMan for Katana will automatically load all "discoverable" shaders. Shaders are discoverable if they are found in a search path and (for non-OSL shaders) have an associated Args file. The standard shader search path mechanism is used when searching for shaders with on the specified environment variable search paths specified either with PrmanGlobalStatements settings or environment variables:
| ShaderType | Environment VariablePrmanGlobalStatements attribute | Default Path | |
|---|---|---|---|
| OSL | RMAN_SHADERPATHoptions.searchpath.shader | $RMANTREE/lib/shaders | |
| Plugin (C++) | RMAN_RIXPLUGINPATH | options.searchpath.rixplugin | $RMANTREE/lib/plugins |
If both the environment variable and the search path attribute in PrmanGlobalStatements are set, the resulting search path will be the union of the two strings with the environment variable taking precedence.
Recursion
RfK will automatically recurse down a shader path to find shaders in subdirectories. By default it will recurse down 3 subdirectories. This is configurable using the shaderPathRecursionLimit setting in the RfK config file, config.xml.
Args Files
The args files need to be in an Args directory. See the setup in RMANTREE/lib/plugins for an example. Something like this:
RMAN_RIXPLUGINPATH directory:
$RMAN_RIXPLUGINPATH/pattern_remap.so |
$RMAN_RIXPLUGINPATH/Args/pattern_remap.args |
You can find out more about Args files in the developer docs download.