...
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. See the custom presets page if you need to set up collections of presets which are specific to your needs.
Error Handling
Errors encountered during rendering are handled according to the attribute "prmanGlobalStatements.errorHandler":
Error Handler | Behavior |
---|---|
ignore | All errors are ignored and no diagnostic messages are generated |
print | A diagnostic message is generated for each error, every time it occurs The rendering system will attempt to ignore the erroneous information and continue rendering |
printonce | Only generate the diagnostic message upon the first occurrence of the error |
abort | The first error will cause a diagnostic message to be generated and the rendering system will immediately terminate |
abortall | Abort the render on errors generated from Katana as well as prman errors |
Handling errors from RenderMan or Katana can be overridden with the use of error handler override attribute functions. These attribute functions provide the opportunity to alter error handling behavior on a location or error-specific basis. The attribute function is expected to return an attribute containing an integer "abort" attribute indicating whether or not the render should be terminated.
Error handler override functions should be added to the global attributes "prmanGlobalStatements.plugin.katanaErrorHandlerAttrFncs" and "prmanGlobalStatements.plugin.rendermanErrorHandlerAttrFncs".
Logging
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):
...