Contents
Welcome to RenderMan 21.0 for Katana
RenderMan for Katana (RfK) capitalizes on the changes made for newer versions of Katana and continues full support of the latest RenderMan ProServer 21.0.
We're especially pleased to have improved stability in Live Rendering and simplified workflows using macros for repetitive tasks. Light and material edits during Live Rendering should be more robust with complex networks and perform better overall. Adding analytic lights is a now breeze with a single click or shortcut. You can even add lights during Live Rendering!
We also introduce GafferThree light packages to handle the above improvements as well as direct control of light visibility.
This current release offers support for:
- Katana2.0v5
- Katana2.1v2
- RenderMan ProServer 21.0
Note that we no longer support Katana 1.x versions.
Please see the release notes below for all the new capabilities and known issues!
What's New
Better Defaults
New Material!
All New Lights!
Texture Baking
Denoise Improvements
Occlusion Integrator
PxrDirt
Improved Holdout Workflows
Physical Camera
OSL Patterns are Native
Additional Changes
- txmake no longer manipulates input images to conform to the OpenEXR latlong specification. An input image is converted directly to an OpenEXR format latlong texture with no image manipulation. The -extraargs exrlatlong flag is no longer needed or supported.
- Originally introduced in 20.6 as an option, PxrPathTracer now tracks the diffusedepth and speculardepth separately from each other based on which lobe of the BSDF is sampled. Previously rays that have both diffuse and specular contributions increment both the diffuse and specular depths. The new behavior is more intuitive and produce expected results when adjusting the trace:maxdiffusedepth and trace:maxspeculardepth attributes. This comes at the cost of, in some cases, effectively doubling the number of indirect ray bounces which can cause look differences and/or increase render times.
- There are now PrmanGlobalStatements and PrmanObjectStatements nodes to replace PrmanGlobalSettings and PrmanObjectSettings. Updates to these nodes are handled internally without requiring an update script.
- Camera visibility is now a parameter in the gaffer for Pxr lights.
- You can now add a mesh light by simply selecting an object and creating a "PxrMeshLight"
- You can now add lights during live rendering (note that in Katana 2.1 a new light is not automatically activated, you'll need to turn it on manually). See Known Limitations below.
- Material edits will update when only the material is marked as live. I.e. if you have a large number of objects with the same material you no longer need to mark all the objects live in order to update that material interactively. This will only work for “non-rebinding” edits. E.g. you can change a color but not change out a shader or enable a layer.
- Removed the ability to apply any scale PxrDome & PxrDistant lights
- Bxdf "PxrBlack" is assigned to mesh lights by default. This can be overridden by assigning a Bxdf to the light or the geometry source. PxrBlack is assigned to prevent secondary scattering from the light itself.
- Hierarchical material edits no longer incur an over-abundance of updates to Prman.
- Light muting is now handled natively using Ri overrides; RfK no longer uses 'intensity=0' as an mute edit workaround.
- Katana can now dynamically load custom integrators.
Miscellaneous Changes
Added the darkfalloff hider parameter to PrmanGlobalStatements in the raytrace hider section.
PrmanLightFilterCreate now supports light filter sharing! You can now either create light filters parented under a light or light filters that are referenced by any number of lights by setting the value of the “Shared Light Filter” parameter.
Portal light no longer inherits dome light transforms
The RfK package no longer contains deprecated files pertaining to RMS and Slim.
- No longer support light detail tag.
Plugin directories have moved to a new location:
Previously $RFKTREE/lib/katana/Resources/PRMan20 $RFKTREE/lib/katana/Src/PRMan20 Now it is $RFKTREE/plugins/Resources/PRMan21 $RFKTREE/plugins/Src/PRMan21
Known Limitations
Live Rendering
- Light linking edits are not currently supported.
- Lights can be added during live rendering however, due to a bug in Katana 2.1, a newly-added light is not automatically 'live' and does not inherit its live state from the parent. When adding a light with Katana 2.1 you will need to manually activate that light in the Scene Graph. Newly added lights work correctly in Katana 2.0.
- Adding mesh lights during live rendering creates duplicate geometry, upon re-render this is solved.
- Changes to light filters are not processed unless the associated lights are also marked 'live'.
- Alembic geometry mesh light transform edits (i.e. Transform3D changes) are not updated correctly during live rendering.
- ROI can now be disabled during live rendering however it will not take into account the crop window settings
- Muting a PxrDomeLight with PxrPortalLight children does not successfully mute the portal lights.
- "Disable Local Assignment" does not work during live rendering with parameters of OSL shaders (e.g. PxrLayer and PxrLayerMixer).
- Disabling and re-enabling layers in PxrLayerMixer can cause instability in Live Rendering.
- Texture changes are not currently supported during live rendering.
Other limitations
- User attributes must have explicit "type" and "value" attributes set.
- If an object is assigned a material that has been disabled or does not exist the geometry will not render at all.
- If you are rendering to 'it' the Monitor tab must be open for the Render Log tab to receive output from Katana and prman.
- Although direct non-identity scaling has been removed from the PxrDomeLight and PxrDistantLight it is still possible to get an indirect scale via a constrained or inherited location. If the indirect scale is negative the Pxr light will flip to a reverse orientation.
- The "relative" transform mode for PxrBarnLightFilter, PxrCookieLightFilter, and PxrGoboLightFilter is not yet supported.
- RenderMan light filters are fully supported by RfK however due to restrictions in the current GafferThree API they must be created using the PrmanLightFilterCreate macro.
- PxrPortalLights are fully supported however they must be created in a separate GafferThree node with a reference created back to its dome light.
- Bake renders only work as Disk Renders. The render will fail for Live and Preview Renders.
- Those who were on the beta will find that any scenes using the 'Live Render' quality preset on PrmanGlobalStatements will get an error that says "Live Render". This is because the preset name has changed to "Draft". Change the Quality Preset value to "Draft" and the error will go away. The holdout_teapot.katana example scene also has this problem.