...
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 "prmanGlobalSettings.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 |
If Katana or RfK cannot process a location as it prepares the Katana scenegraph for rendering it will set the type of the location to "error" which is a fatal error indicating that the render should be terminated. Less critical errors on specific locations during the Katana scenegraph traversal can be flagged as an "errorMessage" attribute on the location, with a second attribute "errorSeverity" to indicate the level of severity of the problem.
Handling of these errors can be overridden with the use of error handler override attribute functions. These attribute functions give the opportunity to alter error handling behavior on a location-specific basis. The attribute function is given the location path and the location's attributes as input and 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 attribute "prmanGlobalStatements.plugin.errorHandlerAttrFncs". If none are specified then error handling proceeds according to the prman errorHandler, and locations of type "error" will terminate the render.
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):
...