Contents
Welcome to RenderMan 22.0!
Welcome to RenderMan 22. This release introduces improvements to the previous RenderMan in very significant ways.
There are many additions:
There have also been many subtractions. Please note the deprecated sections below as quite a lot has been removed from RenderMan. This may impact your scripts, plugins, and more.
Please dive right into the release notes below for more detailed information on the rebirth of your favorite renderer!
New Features in 22.0
New Awesome Sauce
Important Differences
- Note that the light angle parameter on lights has been corrected to use the correct measurement in degrees from the edges. This will alter the look of older scenes.
New Ri Calls
- Ri
Deprecated Ri Calls
- RiEdits do not function
New Options
Deprecated Options
- Ri:Clipping
- Ri:DepthOfField
- Ri:PixelFilterName
- Ri:PixelFilterWidth
- camera:zblur - use camera property
- dice:pretessellate
- hider:dofaspect
- limits:nearhither
- polygon:pretessellate
- polygon:nonplanar
- polygon:reducedmemory
Deprecated Camera Options
- nearhither
- focusregion
- zBlurNearDistance
- zBlurNearDiameter
- zBlurNearFocusDistance
- zBlurFarDistance
- zBlurFarDiameter
- zBlurFarFocusDistance
New Attributes
Deprecated Attributes
- Ri:CoordinateSystem
- Ri:ScopedCoordinateSystem
- bound:displacement
- compatibility:oldmotionfactor
- curve:widthminsegments
- derivatives:centered
- derivatives:extrapolate
- dice:instancestrategy
- dice:instanceworlddistancelength
- dice:maxangle
- dice:preservecv
- dice:relativemicropolygonlength
- dice:resetrelativemicropolygonlength
- dice:stitch
- dice:tessellateretainbspline
- displacementbound:transform
- hider:mattemode
- polygon:reducedmemory
- procedural:attributes
- shade:frequency
- shadegroups:attributecombining
- stitchbound:transform
- trace:gritcurves
- volume:compressionerror
- volume:deptherror
Miscellaneous Changes
Known Limitations
Interactive/Live Rendering Limitations
- RiEdits do not function, these are deprecated
- Camera edits do not update, only camera tansformations (Depth of field, focal length, etc requires restart)
- Changes to Presence do not update
- Motion Blur will disappear during interactive rendering with scene changes
- Displacement does not update on changes
- Mesh lights cannot be interchanged as geometry without restart.
RenderMan Pro Server
- Analytical lights placed inside volumes may yield artifacts when made visible to the camera. As a work around, the light camera visibility should be turned off, and a geometry with a similar shape should be used (visible to camera, invisible to transmission and indirect rays), with the proper emissive bxdf.
- Using the '.' character in the handle for an OSL shader could cause unpredictable results during re-rendering.
- Per-Instance baking is not supported, only the reference instance.
- 3d baking: no direct bake-to-ptex support.
- PxrBakePointCloud cannot directly render ptex.
- No RixPTC/pointcloud API (so PxrBakePointCloud cannot read ptc files).
- Sample/Display filter plug-ins do not have access to lighting services for light dependent effects, e.g. lens flare.
- Adding new mesh light on existing geometry during IPR results in double geometry.
- For PxrUPBP, If the light source is inside a volume, that volume needs to be defined as Volume “box”
- For PxrUPBP, To get a volume caustic, the object casting the caustic needs to have higher intersectpriority than the volume.
- For PxrUPBP, Overlapping heterogeneous volumes are not working yet. (However, overlapping homogeneous volumes do work.) This will be resolved in the future.
- When attempting to access an array primvar, you must first check the size of the array primvar and allocate the appropriate space. Not doing so may lead to a crash.
- Points and curves cannot have mesh lights attached to them.
- Deformation motion blurred volumes don't currently work with densityFloatPrimVar or densityColorPrimVar. You will need to use a PxrPrimVar node connected to densityFloat and densityColor instead.
Alpha Limitations
Geometry:
- Full support of implicits
- Blobbies
- Dicing cameras
- Face edits to RIB
- Utilize smoothed normals
- Displacement improvements
- Watertight dicing speed
- Cracks
- Brickmaps
Materials:
- OSL completeness
Volumes:
- Pixar Studio feature – Aggregate Volumes
- Soem bugs with results
Lighting related:
- Light Filter Linking
- Lights in instances
- PxrVCM (may have bugs and performance issues)
- PxrUPBP remains experimental
- Holdouts
- Shadow collectors equiv to 21.x
General features:
- Crop Window support
- Load on Demand
- Procedurals not fully supported
- Some baking features
Performance:
- Some performance issues remain
Image creation:
- Display and Sample Filters
- Denoiser bugs remain
- dPdtime and motion vectors not correct
Pipeline features:
- Checkpoint and recovery
- Cryptomatte support (in progress)
- USD direct read in RenderMan
- Alembic material assignment