Gaffer 0.60.0.0b1

[johnhaddon]

Note : This version is built against Arnold 6.2.0.1, and is not compatible with earlier Arnold versions.

Features

• Spreadsheet : Added drag and drop reordering of rows.

Improvements

• Serialisation : Reduced script save times by around 50%.
• Expression :
  • Improved performance of Python expression evaluation when the same result is required in multiple threads. Specific expression benchmarks have shown a 10x speedup and some production scenes show an overall 15-30% improvement. Caution : This can expose pre-existing bugs in other nodes - see Breaking Changes for details.
  • Improved error message when Python expression assigns an invalid value.
• Numeric Bookmarks : Changed the Editor 1-9 hotkeys to follow the bookmark rather than pinning it (Editor Focus Redesign : Prototype 2 #4074).
• Editors : Simplified the Editor Focus Menu, removing some seldom used (but potentially ambiguous) modes (Editor Focus Redesign : Prototype 2 #4074).
• Timeline :
  • Added support for sub-frame dragging with a Ctrl modifier, and fixed snapping of the frame indicator for regular drag operations.
  • The current frame is now drawn next to the playhead.
• Increased image processing tile size from 64 pixels to 128 pixels. This reduces per-tile overhead on large images, dramatically increasing effective image performance in many cases.
• SceneNode/SceneProcessor : Enforced that the value of the enabled plug may not be varied using the scene:path context variable. Attempts to do so could result in the generation of invalid scenes. Filters are the appropriate way to enable or disable a node on a per-location basis, and should be used instead. This change yielded a 5-10% performance improvement for a moderately complex scene.
• OSLImage : Avoided some unnecessary computes and hashing when calculating channel names or passing through channel data unaltered.
• Context : Optimized hash() method, and reduced overhead in EditableScope.
• NameSwitch/Spreadsheet : Rows with an empty name are now treated as if they were disabled. See Breaking Changes for further details.
• ContextVariables : Improved performance by around 50%.
• FilterResults : Improved performance.
• SceneAlgo : Reduced threading overhead for parallelProcessLocations(), parallelTraverse() and filteredParallelTraverse(). This is particularly noticeable when visiting locations with many children.

Fixes

• ScriptNode : Fixed bugs that allowed global variables to remain in the context after they had been disabled, renamed or deleted.
• PlugValueWidget : Fixed bug that tried to update the widget before all graph edits were complete.
• UDIMQuery and OSLImage : Fixed incorrectly isolated TBB which could cause hang when other nodes use Standard cache policy. Now uses TaskCollaboration to improve performance.
• Wrapper : Removed the PYTHONHOME environment variable. This fixes problems running Gaffer in python-enabled versions of gdb.

API

• Context :
  • Refactored to allow EditableScope to avoid memory allocation where possible.
    • Added fast non-allocating EditableScope::set( name, const T * ) overload. This should be used in preference to the old set( name const T & ) method.
  • Added EditableScope::setAllocated() method to replace the old set() method in the rare circumstance where allocation is required.
    • Added variableHash() method, which returns the hash for an individual variable.
    • Added getIfExists() method, which returns nullptr if a variable doesn't exist.
  • Added getAsData() method, which returns a copy of a variable as IECore::Data.
  • Added TypeDescription registration class, which must be used to register any custom data types used in context variables.
• GraphComponent : Added reorderChildren() and childrenReorderedSignal() methods.
• Serialisation : Added addModule() method, for adding imports to the serialisation.
• Slider :
  • Added optional value snapping for drag and button press operations. This is controlled via the setSnapIncrement() and getSnapIncrement() methods.
  • Added setHoverPositionVisible() and getHoverPositionVisible() accessors to control an optional position indicator drawn under the pointer.
• Expression : Added Engine::executeCachePolicy() method which must be implemented by subclasses.
• ImageAlgo : Added constants for the default channel names - channelNameR etc.
• SceneAlgo : Added optional root argument to filteredParallelTraverse( scene, pathMatcher ).

Breaking Changes

• NameSwitch/Spreadsheet : Rows with an empty name are now treated as if they were disabled. Previously they would cause confusion by being matched against empty selectors. Use the default row for empty selectors instead, or alternatively use a catch-all * row.
• Context :
  • Removed Ownership enum. The copy constructor now always performs a full copy.
  • Removed changed() method.
    • Removed _copy argument from get() Python binding.
• Slider/NumericSlider :
  • Refactored Slider to provide all the functionality of NumericSlider, and removed NumericSlider.
  • Renamed initial constructor argument from value to values.
  • Removed setPositions()/getPositions() and setPosition()/getPosition() methods from Slider. Use setValues()/getValues() and setValue()/getValue() instead.
  • Removed positionChangedSignal() from Slider. Use valueChangedSignal() instead.
  • Removed PositionChangedReason from Slider. Use ValueChangedReason instead.
  • Removed setPositionIncrement()/getPositionIncrement() from Slider. Use setIncrement()/getIncrement() instead.
  • Replaced _drawPosition() method with _drawValue().
• StandardOptions : Removed cameraBlur plug. This never functioned as advertised, as the regular transformBlur and deformationBlur blur settings were applied to cameras instead. As before, a StandardAttributes node may be used to customise blur for individual cameras.
• SceneAlgo :
  • Changed signature of the following methods to use GafferScene::FilterPlug : matchingPaths, filteredParallelTraverse, Detail::ThreadableFilteredFunctor.
  • Removed filteredParallelTraverse() overload which accepted a Filter *. Pass filter->outPlug() instead.
• DeleteFaces / DeletePoints / DeleteCurves : The PrimitiveVariable name is now taken verbatim, rather than stripping whitespace.
• Serialisation :
  • Disabled copy construction.
  • The following methods now take a const object & where they used to take object & :
    • modulePath()
    • classPath()
  • The following methods now take a Serialisation & argument where they used to take const Serialisation & :
    • constructor()
    • postConstructor()
    • postHierarchy()
    • postScript()
• ValuePlugBinding :
  • repr() now takes a Serialisation * where it used to take a const Serialisation *.
  • valueRepr() now has an optional serialisation argument.
• Metadata : Renamed signal types :
  • NodeValueChangedSignal -> LegacyNodeValueChangedSignal
  • PlugValueChangedSignal -> LegacyPlugValueChangedSignal
  • NodeValueChangedSignal2 -> NodeValueChangedSignal
  • PlugValueChangedSignal2 -> PlugValueChangedSignal
• MetadataBinding :
  • Added serialisation required argument to metadataSerialisation().
  • Removed metadataModuleDependencies() method. Module dependencies are now declared automatically by metadataSerialisation().
• Editors : Removed the 'Follow Scene Selection' mode from the Node Editor Focus menu (Editor Focus Redesign : Prototype 2 #4074).
• GafferSceneUI : Removed SourceSet.
• ScriptNode : Added private member data.
• Expression : Changed the Python expression cache policy to Standard. This executes expressions behind a lock, and can cause hangs if buggy upstream nodes perform TBB tasks without an appropriate TaskIsolation or TaskCollaboration policy. In this case, the GAFFER_PYTHONEXPRESSION_CACHEPOLICY environment variable may be set to Legacy or TaskIsolation while the bugs are fixed.
• Node : Removed plugFlagsChangedSignal(). We aim to phase flags out completely in future, and none of the current flags are expected to be changed after construction.
• ContextProcessor : Added storage argument to processContext() method.
• FilteredChildIterator/FilteredRecursiveChildIterator : Annotated all namespace-level typedefs with [[deprecated]]. These were already documented as deprecated in Gaffer 0.59.0.0, but their use will now trigger compiler warnings. Please use the class-level typedefs instead, for example Plug::Iterator in place of PlugIterator.

Build

• Moved minimum required C++ standard to C++14.
• Moved minimum required TBB version to 2018 Update 3.
• Dependencies : Updated to GafferHQ/dependencies 3.0.0 :
  • OpenImageIO 2.2.11.1.
  • LibTIFF 4.1.0.
  • OpenShadingLanguage 1.11.11.0.
  • LLVM 10.0.1.
  • OpenVDB 7.2.2.
  • Cortex 10.2.0.0.

---

This discussion was created from the release Gaffer 0.60.0.0b1.