GafferBot at 00:37, 30 August 2025

2025-08-30T00:37:06Z

← Older revision		Revision as of 17:37, 29 August 2025
Line 1:		Line 1:
	~~<blockquote>Note : Gaffer 1.6 is currently in alpha, with~~ a ~~stable release expected for September 2025.</blockquote>~~		This page contains a collated and ordered list of [https://github.com/GafferHQ/gaffer/blob/1.6_maintenance/Changes.md changelog] entries for all Gaffer 1.6.x.x releases up to and including Gaffer '''1.6.0.0'''.

	~~The current alpha release is~~ [https://github.com/GafferHQ/gaffer/~~releases~~/~~tag~~/1.6.0.~~0a3~~ 1.6.0.~~0a3], and a consolidated set of changes from all alphas can be found below~~.

	== Features ==		== Features ==
	* '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver.		* '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver.
	* '''Cycles''' : Updated to version 4.4.0.		* '''Cycles''' : Updated to version 4.4.0.
	* '''DiskBlur''' : Added image node for doing fast variable-radius blur. ~~Will be used as core~~ of ~~upcoming focal blur node~~.		* '''DiskBlur''' : Added image node for doing fast variable-radius blur.
			* '''FocalBlur''' : Added image node for approximating depth of field effects based on an image with a depth channel.
	* '''SceneInspector''' :		* '''SceneInspector''' :
	** Rewrote using the same framework as LightEditor, AttributeEditor and RenderPassEditor.		** Rewrote using the same framework as LightEditor, AttributeEditor and RenderPassEditor.

GafferBot at 17:58, 16 August 2025

2025-08-16T17:58:00Z

← Older revision		Revision as of 10:58, 16 August 2025
Line 1:		Line 1:
	<blockquote>Note : Gaffer 1.6 is currently in alpha, with a stable release ~~planned~~ for September 2025.</blockquote>		<blockquote>Note : Gaffer 1.6 is currently in alpha, with a stable release expected for September 2025.</blockquote>

	The current alpha release is [https://github.com/GafferHQ/gaffer/releases/tag/1.6.0.0a3 1.6.0.0a3], and a consolidated set of changes from all alphas can be found below.		The current alpha release is [https://github.com/GafferHQ/gaffer/releases/tag/1.6.0.0a3 1.6.0.0a3], and a consolidated set of changes from all alphas can be found below.

GafferBot: Created page with "
Note : Gaffer 1.6 is currently in alpha, with a stable release planned for September 2025.
The current alpha release is [https://github.com/GafferHQ/gaffer/releases/tag/1.6.0.0a3 1.6.0.0a3], and a consolidated set of changes from all alphas can be found below. == Features == * '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver. * '''Cycles''' : Updated to..."

2025-08-16T17:55:11Z

Created page with "<blockquote>Note : Gaffer 1.6 is currently in alpha, with a stable release planned for September 2025.</blockquote> The current alpha release is [https://github.com/GafferHQ/gaffer/releases/tag/1.6.0.0a3 1.6.0.0a3], and a consolidated set of changes from all alphas can be found below. == Features == * '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver. * '''Cycles''' : Updated to..."

New page

<blockquote>Note : Gaffer 1.6 is currently in alpha, with a stable release planned for September 2025.</blockquote>

The current alpha release is [https://github.com/GafferHQ/gaffer/releases/tag/1.6.0.0a3 1.6.0.0a3], and a consolidated set of changes from all alphas can be found below.

== Features ==
* '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver.
* '''Cycles''' : Updated to version 4.4.0.
* '''DiskBlur''' : Added image node for doing fast variable-radius blur. Will be used as core of upcoming focal blur node.
* '''SceneInspector''' :
** Rewrote using the same framework as LightEditor, AttributeEditor and RenderPassEditor.
** Added EditScope support, with in-place editing of attributes, options and shader parameters. Editing for other properties is planned for future versions.
** Improved comparison abilities, including the added ability to compare two render passes.
** Added subsections for options and attributes, splitting them by category.
** Added column resizing, including automatic resizing to show long attribute names.
** Added inspection of all shaders and parameters in shader networks.
** Added more detailed inspection of meshes and curves.
** Added more detailed inspection of primitive variables.
* '''ImageSelectionTool''' :
** Added new tool that allows selecting scene paths based on an image. Works with both Catalogue images and images on disk. Has two requirements : an<code>id</code> AOV (added using the<code>ID</code> preset on an<code>Outputs</code> node), and a render manifest (added using StandardOptions > Render Manifest > File Path ).
** Also supports picking instance IDs, using an<code>instanceID</code> aov. Supported when rendering an instancer that is encapsulated ( USD instancers rendered to Arnold are encapsulated by default ).
* '''ColorInspectorTool''' : Moved the Viewer's colour inspectors into a dedicated tool, selected from the toolbar on the left.
* '''OSLObject''' : Added the ability to use<code>pointcloud_search()</code> and<code>pointcloud_get()</code> to query geometry from arbitrary scene locations.
* '''CameraQuery''' : Added a new node to query camera parameters (#6431).

== Improvements ==
* '''DeleteAttributes''' : Optimised case where all attributes are deleted. The input attributes are no longer accessed at all in this case.
* '''ShaderAssignment''' : The<code>scene:path</code> context variable is now available in Switches connected directly to the<code>ShaderAssignment.shader</code> input. This allows different shaders to be assigned to different locations using a single ShaderAssignment node. Please note that the<code>scene:path</code> context variable remains unavailable to the individual shader nodes themselves for performance reasons.
* '''3Delight''', '''Cycles''', '''OpenGL''' : Added support for custom EXR metadata, using<code>header:*</code> parameters on the output definition.
* '''RenderManAttributes''', '''RenderManOptions''' : Plugs now respect minimum and maximum values specified by RenderMan.
* '''RenderManShader''' : Improved GraphEditor labels for parameter RGB and XYZ components.
* '''Cycles''' :
** Improved responsiveness for Viewer camera updates when using Cycles as the viewport renderer. One benchmark shows around a 10x improvement in frame rate.
** Added support for<code>layerName</code> parameter in outputs, to control the naming of channels in EXR outputs.
* '''StandardOptions''' :
** Added render manifest option.
** Added<code>render:cameraInclusions</code>,<code>render:cameraExclusions</code>,<code>render:matteInclusions</code>, and<code>render:matteExclusions</code> options.
* '''CyclesMeshLight''' : Improved presentation of<code>cameraVisibility</code> and<code>lightGroup</code> plugs in the Node Editor.
* '''VisualiserTool''' : Added visualisation of labels for uniform primitive variables, face indices and curve indices.
* '''PathListingWidget''' :
** Improved formatting of Box and Matrix values.
** Improved performance when showing colour values.
** Added support for showing spline values.
* '''GafferUI''' : Added support for drag and dropping numeric vector data onto numeric vector plugs of compatible types ( For example, dropping a list of ints onto a FloatVectorDataPlug ).
* '''Switch''' : Optimised disabled switches using a direct internal connection, even when the<code>index</code> is not constant.
* '''RenderMan''' : Added dedicated viewport visualisers for RenderMan lights.
* '''Viewer''' : Added<code>Add</code> image comparison mode.
* '''LocaliseAttributes''' : Added support for localising global attributes, controlled by the new<code>includeGlobalAttributes</code> plug.
* '''AttributeTweaks''', '''ShaderTweaks''' : Global attributes are now localised when<code>localise</code> is enabled and no matching attribute is found at the target location or any of its ancestors.
* '''AttributeQuery''', '''ShaderQuery''' : Global attributes are now queried when<code>inherit</code> is enabled and no matching attribute is found at the target location or any of its ancestors.
* '''SphereLevelSet''' : Improved performance when evaluating the bounding box.
* '''RenderPassMenu''' : Added a search menu which displays only the render passes matching the search text. The search menu can be disabled by registering the following metadata in a startup file.<code>Gaffer.Metadata.registerValue( Gaffer.ScriptNode, "variables.renderPass.value", "renderPassPlugValueWidget:searchable", False )</code>.
* '''RenderPassEditor''', '''AttributeEditor''', '''LightEditor''', '''SceneInspector''' : Improved presentation of VectorData types in the Inspect popup.
* '''CompoundDataPlugValueWidget''' : Removed unnecessary nesting from the menu for adding plugs.
* '''Arnold''' : Improved readability of shader node names as they appear in statistics and<code>.ass</code> files. They are now formatted as<code>shader:{handle}:{uniqueId}</code> where<code>{handle}</code> is the Gaffer node name of the assigned shader, or if loaded from USD, the prim name.
* '''PrimitiveInspector''' : Added<code>location</code> widget for selecting the location to be inspected.
* '''OptionalValuePlugValueWidget''' : The widget for the<code>enabled</code> plug can now be customised using<code>plugValueWidget:type</code> metadata.
* '''PathListingWidget''' : Improved formatting of TypedVectorData.

== Fixes ==
* '''LocalDispatcher''', '''SystemCommand''',<code>gaffer env</code> : Fixed unwanted upper-casing of environment variable names on Windows (#6371).
* '''OpenGLAttributes''' : The default values of attribute plugs now correctly reflect the default behaviour of the OpenGL renderer.
* '''Arnold''' : Fixed default behaviour of<code>ai:abort_on_license_fail</code> option with Arnold 7.3 and above.
* '''Cycles''' :
** Fixed bugs handling identical cameras with different transforms.
** Fixed handling of<code>cycles:volume_precision</code> attribute, which was previously being ignored.
** Fixed bugs handling unknown VDB grid types.
** Fixed potential crash rendering VDB objects.
** Fixed potential threading-related crashes.
* '''RenderPassEditor''' : Fixed default values displayed for<code>dl:oversampling</code> and<code>dl:quality.shadingsamples</code> options.
* '''PlugLayout''' : Fixed bug resolving<code>layout:index</code> metadata.
* '''ScriptNodeAlgo''' : Stopped polluting the ScriptNode context with<code>ui:*</code> variables. Warnings are now emitted by the UI if anything else causes similar pollution.
* '''Checkerboard''' : Fixed crash when evaluated for non-existent channel name.
* '''PathListingWidget''' :
** Prevented emission of<code>updateFinishedSignal()</code> when a new update is pending anyway.
** Fixed potential threading-related crash.
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :
** Fixed missing history entries when two edits have the same source plug.
** Fixed potential crashes in<code>Show History...</code>.
** Fixed potential UI lag in<code>Show History...</code>.
** Fixed flickering in history window when scrubbing the timeline.
* '''RenderPassEditor''' : Fixed error when deleting a pass while a history window was open for it.
* '''OptionalValuePlugValueWidget''' : Fixed handling of keyword constructor arguments. In particular this meant that<code>parenting</code> arguments did not work.
* '''ScenePathPlugValueWidget''' :
** Fixed context used to evaluate the scene. This is now focus-aware, so the scene browser only shows locations that are available with respect to the current focus.
** Fixed bugs that prevented usage in<code>Editor.Settings</code> nodes.
* '''SceneReader''' : Fixed bug reading USD cameras without authored shutter attributes. Previously, the loaded camera would have an unwanted shutter parameter, but now the shutter parameter is correctly omitted.
* '''SceneWriter''' : Fixed bug writing cameras without a shutter parameter to USD. Previously shutter attributes were authored with default values, but now the shutter attributes are not authored at all.
* '''ImageReader''' : Fixed color-space handling for secondary RGB layers. Previously color transformations were only being applied to the main<code>RGB</code> channels and not to<code>someLayer.RGB</code> (#6524).
* '''ContextQuery''' : Removed<code>Create Context Query...</code> menu item from plugs where it was not relevant.
* '''Menu''' : Executing a non-searchable menu item from a searchable menu no longer causes it to appear as the last used action in the menu's search field.
* '''PathListingWidget''' :
** Fixed ordering of<code>selectionChangedSignal()</code> emission from<code>setColumns()</code> call. It is now emitted when<code>getColumns()</code> returns the new columns, not the old ones.
** Fixed unwanted vertical scrolling caused by<code>setColumns()</code>.
** Columns set to automatically stretch now equally share available space when a PathListingWidget's columns are updated via<code>setColumns()</code>.
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :
** Fixed unwanted vertical scrolling when switching tabs.
** Fixed flickering when switching tabs.

== API ==
* '''Gaffer module''' : Added<code>environment()</code> method, returning a dictionary containing all current environment variables. Unlike<code>os.environ</code>, this preserves case on Windows.
* '''GafferScene'''::RenderManifest : Added class for representing mapping of ids to paths in renders. Supports reading EXR and cryptomatte manifests, and writing EXR manifests.
* '''Metadata''' :
** Added<code>registerValues()</code> function that registers multiple metadata entries from a dictionary of string targets.
** Updated<code>targetsWithMetadata()</code> function to support matching multiple targets.
* '''MetadataAlgo''' : Added<code>createPlugFromMetadata()</code> function.
* '''RenderController''' : Added<code>renderManifest()</code> method.
* '''ImageGadget''' : Added support for showing selected and highlighted ids. Controlled using<code>setIDChannel</code>,<code>setSelectedIDs</code>, and<code>setHighlightID</code>.
* '''ShadingEngine''' : Added support for passing custom pointclouds to the<code>shade()</code> call.
* '''SceneAlgo''' :
**<code>applyCameraGlobals()</code> now always applies the<code>render:overscan[Top/Bottom/Left/Right]</code> options to the camera if they exist in the scene globals.
**<code>applyCameraGlobals()</code> now applies the<code>render:depthOfField</code> option to the<code>depthOfField</code> camera parameter. The<code>fStop</code> camera parameter is no longer overridden to<code>0.0</code> when the<code>render:depthOfField</code> option is<code>False</code> or not specified.
* '''ScenePlug''' : Added optional<code>withGlobalAttributes</code> arguments to<code>fullAttributes()</code> and<code>fullAttributesHash()</code>.
* '''VectorDataWidget''' : Added optional<code>maximumVisibleRows</code> argument.
* '''Path''' : Added<code>contextProperty()</code> method.

== Breaking Changes ==
* '''Arnold''' :
** Removed support for Arnold 7.2.
** Removed<code>GafferArnoldUI.GPUCache.populateGPUCache()</code> function.
* '''ArnoldAttributes''', '''CyclesAttributes''', '''DelightAttributes''', '''OpenGLAttributes''', '''StandardAttributes''', '''USDAttributes''' : Attributes plugs have been renamed to match the name of their attribute (e.g.<code>attributes.visibility</code> is now<code>attributes.scene:visible</code>). Compatibility configs have been provided to allow these nodes to be loaded from scripts saved in earlier Gaffer versions.
* '''ArnoldOptions''', '''CyclesOptions''', '''DelightOptions''', '''StandardOptions''' : Option plugs have been renamed to match the name of their option (e.g.<code>options.renderCamera</code> is now<code>options.render:camera</code>). Compatibility configs have been provided to allow these nodes to be loaded from scripts saved in earlier Gaffer versions.
* '''ArnoldOptions''' : Changed the default value of the<code>ai:texture_max_memory_MB</code> plug to 4096 to match Arnold's default.
* '''StandardNodule''' : Removed deprecated<code>setCompatibleLabelsVisible()</code>.
* '''DeleteAttributes''' : Changed base class and marked as<code>final</code>.
* '''Wrapper''' : The<code>gaffer</code> wrapper on Linux no longer allows a custom Python build to be used. If you wish to use a custom Python, call<code>python _gaffer.py</code> instead.
* '''RenderPasses''', '''DeleteRenderPasses''' : Renamed TypeId enum values to<code>RenderPassesTypeId</code> and<code>DeleteRenderPassesTypeId</code>.
* '''OpenGLAttributes''' : The default values of the attribute plugs authoring the<code>gl:primitive:bound</code>,<code>gl:primitive:outline</code>,<code>gl:primitive:points</code>,<code>gl:primitive:pointColor</code>,<code>gl:primitive:wireframe</code>, and<code>gl:primitive:wireframeColor</code> attributes have changed to match the default behaviour of the OpenGL renderer. Scripts loaded from previous Gaffer versions with these plugs enabled and set to the default value will see a difference in OpenGL renders.
* '''SceneTestCase''' : Removed<code>assertBoxesEqual()</code> and<code>assertBoxesAlmostEqual()</code> methods.
* '''RenderController''' : Removed<code>pathForID()</code>,<code>pathsForIDs()</code>,<code>idForPath()</code> and<code>idsForPaths()</code>. Use<code>renderManifest()</code> instead.
* '''Catalogue''', '''CatalogueSelect''', '''Display''' : Moved from GafferImage module to GafferScene.
* '''StandardAttributes''' : Changed the default value of the<code>linkedLights</code> plug to "defaultLights". Scripts loaded from earlier Gaffer versions containing<code>linkedLights</code> plugs set to the previous default of "" will need to be updated as those plugs will now default to "defaultLights".
* '''ImageView''' : Changed image comparison hotkey from <nowiki><kbd>Q</kbd></nowiki> to <nowiki><kbd>K</kbd></nowiki> ( <nowiki><kbd>Q</kbd></nowiki> now selects the selection tool in the image view, same as in the scene view ).
* '''OSLObject''', '''OSLImage''', '''Expression''' : Removed support for file-based pointclouds.
* '''ContextAlgo''' : Removed deprecated API. Use ScriptNodeAlgo instead, which has been available from Gaffer 1.4.13.0 onwards.
* '''ScriptNodeAlgo''' : Reimplemented using Metadata rather than Context variables for storage. Use the ScriptNodeAlgo API instead of attempting direct access to<code>ui:*</code> context variables.
* '''SceneReader''', '''SceneWriter''' : Changed handling of missing shutter parameters. See Fixes section for more detail.
* '''StandardLightVisualiser''' : Removed protected methods for drawing visualiser elements. These are now part of<code>GafferSceneUI::Private::LightVisualiserAlgo</code>. This namespace can be used by light visualisers, but is currently<code>Private</code> while the API details are being resolved.
* '''AttributeTweaks''' : Tweaks with<code>localise</code> enabled and a mode of<code>CreateIfMissing</code> will now not create an attribute if it is missing from the scene hierarchy, but exists in the globals.
* '''AttributeQuery''' : Queries with<code>inherit</code> enabled will now return a result when querying an attribute that does not exist in the scene hierarchy, but does exist in the globals.
* '''Arnold''' : Changed the naming of shader nodes in the generated Arnold scene.
* '''Path''' : Removed<code>inspectionContext()</code> method. Use<code>contextProperty( "inspector:context" )</code> instead.
* '''SceneInspector''' :
** Removed<code>setTargetPaths()</code> and<code>getTargetPaths()</code> methods. Use the<code>location</code> and<code>compare.location</code> settings plugs instead.
** Removed<code>registerSection()</code> method.
** Removed<code>Diff</code>,<code>SideBySideDiff</code>,<code>TextDiff</code>,<code>Row</code>,<code>Inspector</code>,<code>DiffRow</code>,<code>DiffColumn</code>,<code>Section</code>,<code>LocationSection</code>,<code>HistorySection</code> and<code>SetsSection</code> classes.

== Build ==
* '''Boost''' : Updated to version 1.82.0.
* '''Cortex''' : Updated to version 10.6.0.0a1.
* '''Cycles''' : Updated to version 4.4.0.
* '''FreeType''' : Updated to version 2.13.3.
* '''LibRaw''' : Updated to version 0.21.4.
* '''MaterialX''' : Updated to version 1.39.3.
* '''Minizip''' : Updated to version 3.0.10.
* '''OpenColorIO''' : Updated to version 2.3.2.
* '''OpenEXR''' : Updated to version 3.2.4.
* '''OpenImageIO''' : Updated to version 3.0.6.1.
* '''OpenShadingLanguage''' : Updated to version 1.14.5.1.
* '''OpenSubdiv''' : Updated to version 3.6.0.
* '''OpenVDB''' : Updated to version 11.0.0.
* '''Python''' : Updated to version 3.11.12.
* '''PySide''' : Updated to version 6.5.6.
* '''Qt''' : Updated to version 6.5.6.
* '''Qt.py''' : Updated to version 1.4.6.
* '''USD''' : Updated to version 25.05.01.

Gaffer 1.6 release - Revision history

GafferBot at 00:37, 30 August 2025

GafferBot at 17:58, 16 August 2025