...
There have been many changes in Riley in order to overhaul streamline the creation of displays and cameras, as well as to allow for the editing of options. Please note that as of PRMan 24.0, Riley should still be considered an unstable interface.
- The Riley class header file is now namespaced by version (currently 0.3). The Riley class is now accessible as 'riley::vX_Y::Riley'. In order for this to be forward-declarable, a new header 'Riley_version.h" has been added which only contains the versioned namespace information. By default, the versioned namespace is also imported into the 'riley' namespace, so that the various Riley API components can also be accessed by only using 'riley::Riley'.
- The Begin() and End() routines have been removed.
- The use of the term "Master" has been completely replaced with "Prototype" throughout.
- RenderViews are now first class citizens:
- RenderViewId has been added.
- CreateRenderView(), ModifyRenderView(), and DeleteRenderView() has been added.
- The RenderSettings struct has been removed.
- Render() now takes a RenderView, which contains the information about the camera, integrator, and render target to render.
- SetRenderOptions() has been renamed to SetRenderSettings().
- SetActiveCamera() has been renamed to SetDefaultDicingCamera().
- CreateGeometryMasterDeferred() has been removed.
- Several new structs have been added in order to simplify parameter lists for certain routines:
- RenderOutputList (affects RenderTarget and Display routines)
- FilterSize and Extent (affects RenderOutput and RenderTarget routines)
- A new riley::UserId class has been added to facilitate statistics gathering.
- CreateMaterial() and ModifyMaterial() now accept parameter lists.
- The ScopedCoordinateSystem struct has been renamed to CoordinateSystemList.
- CreateDisplayFilterChain() has been replaced with CreateDisplayFilter(), ModifyDisplayFilter(), and DeleteDisplayFilter().
- CreateSampleFilterChain() has been replaced with CreateSampleFilter(), ModifySampleFilter(), and DeleteSampleFilter().
- SetClippingPlanes() has been replaced with CreateClippingPlane(), ModifyClipplingPlaneModifyClippingPlane(), and DeleteClippingPlane().
- CreateRiley() now accepts a RtParamList, which allows the behavior of the Riley variant to be changed based on supplied parameters.
- A new InvalidateTexture() method has been added, allowing textures to be invalidated directly via Riley.
- Two new methods SetRenderOptions() and SetRenderMetadata() have been added to support general options edits. These calls can be made while Render() is running.
- The Id types have been changed from enums to classes.
- Inconsistencies in the order of array parameters and the size of those arrays have been addressed.
- Inconsistencies between the Create and Modify routines with respect to modifiable parameters that have array types have been addressed.
...