Page tree


The settings for controlling renders in RenderMan for Katana can be loosely divided into two categories:  render output and render input.  Render "output" refers to things like camera, resolution and crop window; these attributes are primarily in the RenderSettings node.  Render "input" refers to RenderMan options and attributes as well as RfK plugin configuration.  Access to these are primarily in the PrmanGlobalStatements and PrmanObjectStatements nodes.


The RenderSettings node is a native Katana node described in detail in the Katana online documentation.  The most common attributes to be aware of are:




Camera through which to render.



Which renderer to use.



Size of the output image.

Commonly-used Attributes in RenderSettings Node

PrmanGlobalStatements and PrmanObjectStatements

RenderMan's power and flexibility means that a large amount of control is given to the user through its wide variety of settings.  All of these settings are exposed in RfK through the PrmanGlobalStatements and PrmanObjectStatements.  The attributes in PrmanGlobalStatements are used to control RenderMan's global Options.  PrmanObjectSettings is used for per-location Attributes.  Since there are only a small number of settings used regularly in both of these nodes, they are each set up to hide the less common attributes by default. The Parameter Layout setting is used to expand or collapse collections of attributes based on common usage:  Simple, Advanced, or all. That said, even the Simple layout exposes numerous settings. Below are most useful settings in PrmanGlobalStatements:




Upper bound on the acceptable estimated variance of the pixel values from the true pixel values.


0 (64)

Explicit limit for the number of samples. Increase for higher quality, slower render.



The destination framebuffer for Preview and Live Rendering. Set to 'it' to use RenderMan Image Tool.

Commonly-used Options in PrmanGlobalStatements


PrmanObjectStatements are connected to a specific location in the scene graph (e.g. an object, a hierarchy or CEL grouping).  Common things to control with this node are visibility attributes and trace depth.  Below is a description of a few common settings in PrmanObjectStatements:



Controls the visibility of subsequent primitives to the camera.



Controls the visibility of primitives to transmission (shadow) rays.

trace.maxdiffusedepth1Limit the number of diffuse bounces for indirect illuminance relative to the associated primitive.
trace.maxspeculardepth2Limit the number of specular bounces for indirect illuminance relative to the associated primitive.

Commonly-used Options in PrmanObjectStatements


As an additional aid these nodes each have settings presets which will adjust RenderMan controls according to type of render:  Default, Draft, Intermediate, or High Quality.  The differences between these presets are minimal but significant.  They are best used for quick switching and for reference values.  Note that changes you make to the settings do not "stick" the preset; they will be lost if you change to a different preset.



Currently the log level defaults to "INFO", determined by the log configuration file in KATANA_HOME. In order to change the log level we copy the configuration file, change the level and set and environment variable (using Linux):


cp $KATANA_HOME/bin/log.conf $KATANA_RESOURCES/Logging/log.conf

edit log.conf and change the "rootLogger" to the desired level: "ERROR", "WARN", "INFO", "DEBUG"


Similar workflow in Windows, create the $KATANA_RESOURCES/Logging Folder, copy the log.conf file and change the "rootLogger" value to the listed options.