https://www.gaffer.wiki/w/api.php?action=feedcontributions&feedformat=atom&user=GafferBotGaffer Wiki - User contributions [en]2026-04-11T01:17:43ZUser contributionsMediaWiki 1.43.1https://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=654Template:LatestGafferVersion2026-03-31T01:49:56Z<p>GafferBot: </p>
<hr />
<div>1.6.15.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=653Template:LatestGafferVersion2026-03-27T03:19:48Z<p>GafferBot: </p>
<hr />
<div>1.6.14.2</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=651Template:LatestGafferVersion2026-03-18T02:44:05Z<p>GafferBot: </p>
<hr />
<div>1.6.14.1</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=649Template:LatestGafferVersion2026-02-28T05:23:42Z<p>GafferBot: </p>
<hr />
<div>1.6.13.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=645Template:LatestGafferVersion2026-02-21T17:39:45Z<p>GafferBot: </p>
<hr />
<div>1.6.12.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=635Template:LatestGafferVersion2026-01-30T05:12:00Z<p>GafferBot: </p>
<hr />
<div>1.6.10.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=634Template:LatestGafferVersion2026-01-08T03:59:10Z<p>GafferBot: </p>
<hr />
<div>1.6.8.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=633Template:LatestGafferVersion2025-12-17T04:40:51Z<p>GafferBot: </p>
<hr />
<div>1.6.7.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=632Template:LatestGafferVersion2025-11-30T00:28:58Z<p>GafferBot: </p>
<hr />
<div>1.6.6.1</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=631Template:LatestGafferVersion2025-11-27T05:18:36Z<p>GafferBot: </p>
<hr />
<div>1.6.6.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=630Template:LatestGafferVersion2025-11-14T00:42:06Z<p>GafferBot: </p>
<hr />
<div>1.6.5.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=629Template:LatestGafferVersion2025-11-03T00:34:32Z<p>GafferBot: </p>
<hr />
<div>1.6.4.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Learning_resources&diff=628Learning resources2025-10-31T21:06:30Z<p>GafferBot: </p>
<hr />
<div>== Tutorials ==<br />
<br />
* {{GafferDocumentationLink|GettingStarted/TutorialAssemblingTheGafferBot/index.html|Assembling the Gaffer Bot - Gaffer Documentation}}<br />
* [https://www.patreon.com/posts/introduction-to-94873751 Introduction to Gaffer - Brian Hanke]<br />
* [https://blog.gafferhq.org/?cat=10 Artist Tips - GafferHQ Blog]<br />
* [https://blog.gafferhq.org/?cat=35 Dev and Pipeline Tips - GafferHQ Blog]<br />
<br />
== Tutorial Videos ==<br />
{{#ev:vimeo|202088156}}<br />
{{#ev:youtube|lAgBcOFMf5k}}<br />
{{#ev:youtube|RiPmGDhxjGw}}<br />
{{#ev:youtube|qJWtai73TB8}}<br />
{{#ev:youtube|aKUMRKPbdZI}}<br />
<br />
== Production Examples ==<br />
{{#ev:youtube|jtjDbAHbPuE}}<br />
{{#ev:vimeo|739832240}}<br />
{{#ev:vimeo|739832094}}<br />
{{#ev:vimeo|739832505}}<br />
<br />
== User Groups ==<br />
{{#ev:vimeo|1131945768}}<br />
{{#ev:vimeo|1036919633}}<br />
{{#ev:vimeo|923093356}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=627Template:LatestGafferVersion2025-10-11T01:21:56Z<p>GafferBot: </p>
<hr />
<div>1.6.3.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=626Template:LatestGafferVersion2025-10-02T05:06:37Z<p>GafferBot: </p>
<hr />
<div>1.6.2.1</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=625Template:LatestGafferVersion2025-09-25T04:47:38Z<p>GafferBot: </p>
<hr />
<div>1.6.2.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=624Template:LatestGafferVersion2025-09-19T06:26:17Z<p>GafferBot: </p>
<hr />
<div>1.6.1.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Getting_started_with_Gaffer&diff=608Getting started with Gaffer2025-09-03T04:35:28Z<p>GafferBot: /* Configuring renderers */</p>
<hr />
<div>== Intro to Gaffer ==<br />
<br />
{{#ev:vimeo|739829903}}<br />
<br />
== Installing Gaffer ==<br />
<br />
=== Downloading a release ===<br />
The latest release is available to download from [https://www.gafferhq.org/download gafferhq.org]. Previous releases can be downloaded from the GitHub [https://github.com/GafferHQ/gaffer/releases releases] page. <br />
<br />
=== Installation ===<br />
Each Gaffer release is a standalone archive that just requires extraction to the location you wish to run Gaffer from. See the {{GafferDocumentationLink|GettingStarted/InstallingGaffer/index.html|documentation}} for more information.<br />
<br />
==== Windows ====<br />
<br />
On Windows, the [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170 Microsoft Visual C++ Redistributable] must be installed. If you see errors related to missing VCRUNTIME files such as VCRUNTIME140.dll, the redestributable will need to be downloaded and installed before Gaffer can be launched.<br />
<br />
=== 3rd party installers ===<br />
<br />
Brian Hanke maintains a Windows installer that downloads and extracts Gaffer releases. It can be downloaded from [https://github.com/BrianHanke/gaffer_windows_installer GitHub].<br />
<br />
== Configuring renderers ==<br />
<br />
=== Cycles ===<br />
Gaffer comes pre-installed with Cycles, so no additional configuration is required.<br />
<br />
{{ info | To disable Cycles, set the <code>GAFFERCYCLES_HIDE_UI</code> environment variable to <code>1</code>. }}<br />
<br />
=== Arnold ===<br />
Gaffer currently supports Arnold <code>7.3.x.x</code> and <code>7.4.x.x</code> releases. Earlier versions of Arnold are no longer compatible.<br />
<br />
{{ info | Note that Gaffer requires an Arnold SDK release to be installed - a MtoA, HtoA, KtoA etc release will not work. }}<br />
<br />
To configure Gaffer to use Arnold, the <code>ARNOLD_ROOT</code> environment variable must point to the root directory of the Arnold release to use. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-arnold|documentation}} for more information.<br />
<br />
=== 3Delight ===<br />
To configure Gaffer to use 3Delight, the <code>DELIGHT</code> environment variable must point to the root directory of the 3Delight release to use. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-3delight|documentation}} for more information.<br />
<br />
=== RenderMan ===<br />
RenderMan support is in active development and can be used in current Gaffer 1.6 releases by setting the <code>RMANTREE</code> environment variable to point to the root directory of a RenderMan Pro Server 26.3 installation. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-renderman|documentation}} for more information.<br />
<br />
== Running Gaffer ==<br />
<br />
=== GUI Mode ===<br />
<br />
Gaffer is launched via a wrapper script found in the <code>bin</code> directory, this wrapper is named <code>gaffer</code> on Linux and <code>gaffer.cmd</code> on Windows<br />
<br />
==== Linux ====<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer</code> }}<br />
<br />
==== Windows ====<br />
<br />
{{ info | <code>C:/software/gaffer-{{latestGafferVersion}}-windows/bin/gaffer.cmd</code> }}<br />
<br />
=== Command line execution ===<br />
<br />
Gaffer scripts can be executed on the command line via the {{GafferDocumentationLink|Reference/CommandLineReference/execute.html|execute}} app, or dispatched locally or to a render farm via the {{GafferDocumentationLink|Reference/CommandLineReference/dispatch.html|dispatch}} app.<br />
<br />
=== Additional utilities ===<br />
<br />
A Gaffer release includes a number of additional utility applications in the <code>bin</code> directory, such as [https://openusd.org/release/toolset.html#usdview usdview], [https://openimageio.readthedocs.io/en/stable/oiiotool.html oiiotool] and [http://www.alembic.io abcecho]. These tools can be run via the {{GafferDocumentationLink|Reference/CommandLineReference/env.html|env}} app.<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env usdview /path/to/file.usda</code> }}<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env oiiotool /path/to/image.exr</code> }}<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env abcecho /path/to/file.abc</code> }}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Getting_started_with_Gaffer&diff=607Getting started with Gaffer2025-09-03T04:33:13Z<p>GafferBot: /* RenderMan */</p>
<hr />
<div>== Intro to Gaffer ==<br />
<br />
{{#ev:vimeo|739829903}}<br />
<br />
== Installing Gaffer ==<br />
<br />
=== Downloading a release ===<br />
The latest release is available to download from [https://www.gafferhq.org/download gafferhq.org]. Previous releases can be downloaded from the GitHub [https://github.com/GafferHQ/gaffer/releases releases] page. <br />
<br />
=== Installation ===<br />
Each Gaffer release is a standalone archive that just requires extraction to the location you wish to run Gaffer from. See the {{GafferDocumentationLink|GettingStarted/InstallingGaffer/index.html|documentation}} for more information.<br />
<br />
==== Windows ====<br />
<br />
On Windows, the [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170 Microsoft Visual C++ Redistributable] must be installed. If you see errors related to missing VCRUNTIME files such as VCRUNTIME140.dll, the redestributable will need to be downloaded and installed before Gaffer can be launched.<br />
<br />
=== 3rd party installers ===<br />
<br />
Brian Hanke maintains a Windows installer that downloads and extracts Gaffer releases. It can be downloaded from [https://github.com/BrianHanke/gaffer_windows_installer GitHub].<br />
<br />
== Configuring renderers ==<br />
<br />
=== Cycles ===<br />
Gaffer comes pre-installed with Cycles, so no additional configuration is required.<br />
<br />
{{ info | To disable Cycles, set the <code>GAFFERCYCLES_HIDE_UI</code> environment variable to <code>1</code>. }}<br />
<br />
=== Arnold ===<br />
Gaffer currently supports Arnold <code>7.3.x.x</code> and <code>7.4.x.x</code> releases. Earlier versions of Arnold are no longer compatible.<br />
<br />
{{ info | Note that Gaffer requires an Arnold SDK release to be installed - a MtoA, HtoA, KtoA etc release will not work. }}<br />
<br />
To configure Gaffer to use Arnold, the <code>ARNOLD_ROOT</code> environment variable must point to the root directory of the Arnold release to use. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-arnold|documentation}} for more information.<br />
<br />
=== 3Delight ===<br />
To configure Gaffer to use 3Delight, the <code>DELIGHT</code> environment variable must point to the root directory of the 3Delight release to use. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-3delight|documentation}} for more information.<br />
<br />
=== RenderMan ===<br />
RenderMan support is in active development and can be used in current Gaffer 1.6 releases by:<br />
<br />
* Setting the <code>RMANTREE</code> environment variable to point to the root directory of a RenderMan Pro Server 26.3 installation<br />
<br />
== Running Gaffer ==<br />
<br />
=== GUI Mode ===<br />
<br />
Gaffer is launched via a wrapper script found in the <code>bin</code> directory, this wrapper is named <code>gaffer</code> on Linux and <code>gaffer.cmd</code> on Windows<br />
<br />
==== Linux ====<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer</code> }}<br />
<br />
==== Windows ====<br />
<br />
{{ info | <code>C:/software/gaffer-{{latestGafferVersion}}-windows/bin/gaffer.cmd</code> }}<br />
<br />
=== Command line execution ===<br />
<br />
Gaffer scripts can be executed on the command line via the {{GafferDocumentationLink|Reference/CommandLineReference/execute.html|execute}} app, or dispatched locally or to a render farm via the {{GafferDocumentationLink|Reference/CommandLineReference/dispatch.html|dispatch}} app.<br />
<br />
=== Additional utilities ===<br />
<br />
A Gaffer release includes a number of additional utility applications in the <code>bin</code> directory, such as [https://openusd.org/release/toolset.html#usdview usdview], [https://openimageio.readthedocs.io/en/stable/oiiotool.html oiiotool] and [http://www.alembic.io abcecho]. These tools can be run via the {{GafferDocumentationLink|Reference/CommandLineReference/env.html|env}} app.<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env usdview /path/to/file.usda</code> }}<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env oiiotool /path/to/image.exr</code> }}<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env abcecho /path/to/file.abc</code> }}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Getting_started_with_Gaffer&diff=606Getting started with Gaffer2025-09-03T04:32:47Z<p>GafferBot: /* Arnold */</p>
<hr />
<div>== Intro to Gaffer ==<br />
<br />
{{#ev:vimeo|739829903}}<br />
<br />
== Installing Gaffer ==<br />
<br />
=== Downloading a release ===<br />
The latest release is available to download from [https://www.gafferhq.org/download gafferhq.org]. Previous releases can be downloaded from the GitHub [https://github.com/GafferHQ/gaffer/releases releases] page. <br />
<br />
=== Installation ===<br />
Each Gaffer release is a standalone archive that just requires extraction to the location you wish to run Gaffer from. See the {{GafferDocumentationLink|GettingStarted/InstallingGaffer/index.html|documentation}} for more information.<br />
<br />
==== Windows ====<br />
<br />
On Windows, the [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170 Microsoft Visual C++ Redistributable] must be installed. If you see errors related to missing VCRUNTIME files such as VCRUNTIME140.dll, the redestributable will need to be downloaded and installed before Gaffer can be launched.<br />
<br />
=== 3rd party installers ===<br />
<br />
Brian Hanke maintains a Windows installer that downloads and extracts Gaffer releases. It can be downloaded from [https://github.com/BrianHanke/gaffer_windows_installer GitHub].<br />
<br />
== Configuring renderers ==<br />
<br />
=== Cycles ===<br />
Gaffer comes pre-installed with Cycles, so no additional configuration is required.<br />
<br />
{{ info | To disable Cycles, set the <code>GAFFERCYCLES_HIDE_UI</code> environment variable to <code>1</code>. }}<br />
<br />
=== Arnold ===<br />
Gaffer currently supports Arnold <code>7.3.x.x</code> and <code>7.4.x.x</code> releases. Earlier versions of Arnold are no longer compatible.<br />
<br />
{{ info | Note that Gaffer requires an Arnold SDK release to be installed - a MtoA, HtoA, KtoA etc release will not work. }}<br />
<br />
To configure Gaffer to use Arnold, the <code>ARNOLD_ROOT</code> environment variable must point to the root directory of the Arnold release to use. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-arnold|documentation}} for more information.<br />
<br />
=== 3Delight ===<br />
To configure Gaffer to use 3Delight, the <code>DELIGHT</code> environment variable must point to the root directory of the 3Delight release to use. See the Gaffer {{GafferDocumentationLink|GettingStarted/ConfiguringGafferForThirdPartyTools/index.html#configuring-gaffer-for-3delight|documentation}} for more information.<br />
<br />
=== RenderMan ===<br />
RenderMan support is in active development and can be tested in current Gaffer 1.5 releases by:<br />
<br />
* Setting the <code>RMANTREE</code> environment variable to point to the root directory of a RenderMan Pro Server 26.3 installation<br />
* Setting the <code>GAFFERRENDERMAN_FEATURE_PREVIEW</code> environment variable to a value of <code>1</code><br />
<br />
== Running Gaffer ==<br />
<br />
=== GUI Mode ===<br />
<br />
Gaffer is launched via a wrapper script found in the <code>bin</code> directory, this wrapper is named <code>gaffer</code> on Linux and <code>gaffer.cmd</code> on Windows<br />
<br />
==== Linux ====<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer</code> }}<br />
<br />
==== Windows ====<br />
<br />
{{ info | <code>C:/software/gaffer-{{latestGafferVersion}}-windows/bin/gaffer.cmd</code> }}<br />
<br />
=== Command line execution ===<br />
<br />
Gaffer scripts can be executed on the command line via the {{GafferDocumentationLink|Reference/CommandLineReference/execute.html|execute}} app, or dispatched locally or to a render farm via the {{GafferDocumentationLink|Reference/CommandLineReference/dispatch.html|dispatch}} app.<br />
<br />
=== Additional utilities ===<br />
<br />
A Gaffer release includes a number of additional utility applications in the <code>bin</code> directory, such as [https://openusd.org/release/toolset.html#usdview usdview], [https://openimageio.readthedocs.io/en/stable/oiiotool.html oiiotool] and [http://www.alembic.io abcecho]. These tools can be run via the {{GafferDocumentationLink|Reference/CommandLineReference/env.html|env}} app.<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env usdview /path/to/file.usda</code> }}<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env oiiotool /path/to/image.exr</code> }}<br />
<br />
{{ info | <code>/opt/gaffer-{{latestGafferVersion}}-linux-gcc11/bin/gaffer env abcecho /path/to/file.abc</code> }}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Query&diff=605Category:Nodes:Query2025-08-30T00:43:40Z<p>GafferBot: Created page with "== Query Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Query' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Query Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Query'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=CameraQuery&diff=604CameraQuery2025-08-30T00:41:13Z<p>GafferBot: Created page with "{{Node |namespace=GafferScene |description=Queries parameters from a camera, creating an output for each query. |categories=Camera, Query }}"</p>
<hr />
<div>{{Node<br />
|namespace=GafferScene<br />
|description=Queries parameters from a camera, creating an output for each query.<br />
|categories=Camera, Query<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=FocalBlur&diff=603FocalBlur2025-08-30T00:40:27Z<p>GafferBot: Created page with "{{Node |namespace=GafferOSL |description=Renders depth of field effects based on a 2D image with a depth channel. |categories=ImageFilter }}"</p>
<hr />
<div>{{Node<br />
|namespace=GafferOSL<br />
|description=Renders depth of field effects based on a 2D image with a depth channel.<br />
|categories=ImageFilter<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=DiskBlur&diff=602DiskBlur2025-08-30T00:38:48Z<p>GafferBot: Created page with "{{Node |namespace=GafferImage |description=A special disk blur node which efficiently supports large radius blurs, and allows for a variable radius. Works by rendering each input pixel as a disk in the output, using special acceleration structures that make rendering large disks fast. Suitable as a building block for focal blur. |categories=ImageFilter }}"</p>
<hr />
<div>{{Node<br />
|namespace=GafferImage<br />
|description=A special disk blur node which efficiently supports large radius blurs, and allows for a variable radius. Works by rendering each input pixel as a disk in the output, using special acceleration structures that make rendering large disks fast. Suitable as a building block for focal blur.<br />
|categories=ImageFilter<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=601Template:LatestGafferVersion2025-08-30T00:37:48Z<p>GafferBot: </p>
<hr />
<div>1.6.0.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Gaffer_1.6_release&diff=600Gaffer 1.6 release2025-08-30T00:37:06Z<p>GafferBot: </p>
<hr />
<div>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'''.<br />
<br />
== Features ==<br />
* '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver.<br />
* '''Cycles''' : Updated to version 4.4.0.<br />
* '''DiskBlur''' : Added image node for doing fast variable-radius blur.<br />
* '''FocalBlur''' : Added image node for approximating depth of field effects based on an image with a depth channel.<br />
* '''SceneInspector''' :<br />
** Rewrote using the same framework as LightEditor, AttributeEditor and RenderPassEditor.<br />
** Added EditScope support, with in-place editing of attributes, options and shader parameters. Editing for other properties is planned for future versions.<br />
** Improved comparison abilities, including the added ability to compare two render passes.<br />
** Added subsections for options and attributes, splitting them by category.<br />
** Added column resizing, including automatic resizing to show long attribute names.<br />
** Added inspection of all shaders and parameters in shader networks.<br />
** Added more detailed inspection of meshes and curves.<br />
** Added more detailed inspection of primitive variables.<br />
* '''ImageSelectionTool''' :<br />
** 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 ).<br />
** 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 ).<br />
* '''ColorInspectorTool''' : Moved the Viewer's colour inspectors into a dedicated tool, selected from the toolbar on the left.<br />
* '''OSLObject''' : Added the ability to use<code>pointcloud_search()</code> and<code>pointcloud_get()</code> to query geometry from arbitrary scene locations.<br />
* '''CameraQuery''' : Added a new node to query camera parameters (#6431).<br />
<br />
== Improvements ==<br />
* '''DeleteAttributes''' : Optimised case where all attributes are deleted. The input attributes are no longer accessed at all in this case.<br />
* '''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.<br />
* '''3Delight''', '''Cycles''', '''OpenGL''' : Added support for custom EXR metadata, using<code>header:*</code> parameters on the output definition.<br />
* '''RenderManAttributes''', '''RenderManOptions''' : Plugs now respect minimum and maximum values specified by RenderMan.<br />
* '''RenderManShader''' : Improved GraphEditor labels for parameter RGB and XYZ components.<br />
* '''Cycles''' :<br />
** Improved responsiveness for Viewer camera updates when using Cycles as the viewport renderer. One benchmark shows around a 10x improvement in frame rate.<br />
** Added support for<code>layerName</code> parameter in outputs, to control the naming of channels in EXR outputs.<br />
* '''StandardOptions''' :<br />
** Added render manifest option.<br />
** Added<code>render:cameraInclusions</code>,<code>render:cameraExclusions</code>,<code>render:matteInclusions</code>, and<code>render:matteExclusions</code> options.<br />
* '''CyclesMeshLight''' : Improved presentation of<code>cameraVisibility</code> and<code>lightGroup</code> plugs in the Node Editor.<br />
* '''VisualiserTool''' : Added visualisation of labels for uniform primitive variables, face indices and curve indices.<br />
* '''PathListingWidget''' :<br />
** Improved formatting of Box and Matrix values.<br />
** Improved performance when showing colour values.<br />
** Added support for showing spline values.<br />
* '''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 ).<br />
* '''Switch''' : Optimised disabled switches using a direct internal connection, even when the<code>index</code> is not constant.<br />
* '''RenderMan''' : Added dedicated viewport visualisers for RenderMan lights.<br />
* '''Viewer''' : Added<code>Add</code> image comparison mode.<br />
* '''LocaliseAttributes''' : Added support for localising global attributes, controlled by the new<code>includeGlobalAttributes</code> plug.<br />
* '''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.<br />
* '''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.<br />
* '''SphereLevelSet''' : Improved performance when evaluating the bounding box.<br />
* '''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>.<br />
* '''RenderPassEditor''', '''AttributeEditor''', '''LightEditor''', '''SceneInspector''' : Improved presentation of VectorData types in the Inspect popup.<br />
* '''CompoundDataPlugValueWidget''' : Removed unnecessary nesting from the menu for adding plugs.<br />
* '''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.<br />
* '''PrimitiveInspector''' : Added<code>location</code> widget for selecting the location to be inspected.<br />
* '''OptionalValuePlugValueWidget''' : The widget for the<code>enabled</code> plug can now be customised using<code>plugValueWidget:type</code> metadata.<br />
* '''PathListingWidget''' : Improved formatting of TypedVectorData.<br />
<br />
== Fixes ==<br />
* '''LocalDispatcher''', '''SystemCommand''',<code>gaffer env</code> : Fixed unwanted upper-casing of environment variable names on Windows (#6371).<br />
* '''OpenGLAttributes''' : The default values of attribute plugs now correctly reflect the default behaviour of the OpenGL renderer.<br />
* '''Arnold''' : Fixed default behaviour of<code>ai:abort_on_license_fail</code> option with Arnold 7.3 and above.<br />
* '''Cycles''' :<br />
** Fixed bugs handling identical cameras with different transforms.<br />
** Fixed handling of<code>cycles:volume_precision</code> attribute, which was previously being ignored.<br />
** Fixed bugs handling unknown VDB grid types.<br />
** Fixed potential crash rendering VDB objects.<br />
** Fixed potential threading-related crashes.<br />
* '''RenderPassEditor''' : Fixed default values displayed for<code>dl:oversampling</code> and<code>dl:quality.shadingsamples</code> options.<br />
* '''PlugLayout''' : Fixed bug resolving<code>layout:index</code> metadata.<br />
* '''ScriptNodeAlgo''' : Stopped polluting the ScriptNode context with<code>ui:*</code> variables. Warnings are now emitted by the UI if anything else causes similar pollution.<br />
* '''Checkerboard''' : Fixed crash when evaluated for non-existent channel name.<br />
* '''PathListingWidget''' :<br />
** Prevented emission of<code>updateFinishedSignal()</code> when a new update is pending anyway.<br />
** Fixed potential threading-related crash.<br />
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :<br />
** Fixed missing history entries when two edits have the same source plug.<br />
** Fixed potential crashes in<code>Show History...</code>.<br />
** Fixed potential UI lag in<code>Show History...</code>.<br />
** Fixed flickering in history window when scrubbing the timeline.<br />
* '''RenderPassEditor''' : Fixed error when deleting a pass while a history window was open for it.<br />
* '''OptionalValuePlugValueWidget''' : Fixed handling of keyword constructor arguments. In particular this meant that<code>parenting</code> arguments did not work.<br />
* '''ScenePathPlugValueWidget''' :<br />
** 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.<br />
** Fixed bugs that prevented usage in<code>Editor.Settings</code> nodes.<br />
* '''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.<br />
* '''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.<br />
* '''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).<br />
* '''ContextQuery''' : Removed<code>Create Context Query...</code> menu item from plugs where it was not relevant.<br />
* '''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.<br />
* '''PathListingWidget''' :<br />
** 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.<br />
** Fixed unwanted vertical scrolling caused by<code>setColumns()</code>.<br />
** Columns set to automatically stretch now equally share available space when a PathListingWidget's columns are updated via<code>setColumns()</code>.<br />
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :<br />
** Fixed unwanted vertical scrolling when switching tabs.<br />
** Fixed flickering when switching tabs.<br />
<br />
== API ==<br />
* '''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.<br />
* '''GafferScene'''::RenderManifest : Added class for representing mapping of ids to paths in renders. Supports reading EXR and cryptomatte manifests, and writing EXR manifests.<br />
* '''Metadata''' :<br />
** Added<code>registerValues()</code> function that registers multiple metadata entries from a dictionary of string targets.<br />
** Updated<code>targetsWithMetadata()</code> function to support matching multiple targets.<br />
* '''MetadataAlgo''' : Added<code>createPlugFromMetadata()</code> function.<br />
* '''RenderController''' : Added<code>renderManifest()</code> method.<br />
* '''ImageGadget''' : Added support for showing selected and highlighted ids. Controlled using<code>setIDChannel</code>,<code>setSelectedIDs</code>, and<code>setHighlightID</code>.<br />
* '''ShadingEngine''' : Added support for passing custom pointclouds to the<code>shade()</code> call.<br />
* '''SceneAlgo''' :<br />
**<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.<br />
**<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.<br />
* '''ScenePlug''' : Added optional<code>withGlobalAttributes</code> arguments to<code>fullAttributes()</code> and<code>fullAttributesHash()</code>.<br />
* '''VectorDataWidget''' : Added optional<code>maximumVisibleRows</code> argument.<br />
* '''Path''' : Added<code>contextProperty()</code> method.<br />
<br />
== Breaking Changes ==<br />
* '''Arnold''' :<br />
** Removed support for Arnold 7.2.<br />
** Removed<code>GafferArnoldUI.GPUCache.populateGPUCache()</code> function.<br />
* '''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.<br />
* '''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.<br />
* '''ArnoldOptions''' : Changed the default value of the<code>ai:texture_max_memory_MB</code> plug to 4096 to match Arnold's default.<br />
* '''StandardNodule''' : Removed deprecated<code>setCompatibleLabelsVisible()</code>.<br />
* '''DeleteAttributes''' : Changed base class and marked as<code>final</code>.<br />
* '''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.<br />
* '''RenderPasses''', '''DeleteRenderPasses''' : Renamed TypeId enum values to<code>RenderPassesTypeId</code> and<code>DeleteRenderPassesTypeId</code>.<br />
* '''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.<br />
* '''SceneTestCase''' : Removed<code>assertBoxesEqual()</code> and<code>assertBoxesAlmostEqual()</code> methods.<br />
* '''RenderController''' : Removed<code>pathForID()</code>,<code>pathsForIDs()</code>,<code>idForPath()</code> and<code>idsForPaths()</code>. Use<code>renderManifest()</code> instead.<br />
* '''Catalogue''', '''CatalogueSelect''', '''Display''' : Moved from GafferImage module to GafferScene.<br />
* '''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".<br />
* '''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 ).<br />
* '''OSLObject''', '''OSLImage''', '''Expression''' : Removed support for file-based pointclouds.<br />
* '''ContextAlgo''' : Removed deprecated API. Use ScriptNodeAlgo instead, which has been available from Gaffer 1.4.13.0 onwards.<br />
* '''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.<br />
* '''SceneReader''', '''SceneWriter''' : Changed handling of missing shutter parameters. See Fixes section for more detail.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''Arnold''' : Changed the naming of shader nodes in the generated Arnold scene.<br />
* '''Path''' : Removed<code>inspectionContext()</code> method. Use<code>contextProperty( "inspector:context" )</code> instead.<br />
* '''SceneInspector''' :<br />
** Removed<code>setTargetPaths()</code> and<code>getTargetPaths()</code> methods. Use the<code>location</code> and<code>compare.location</code> settings plugs instead.<br />
** Removed<code>registerSection()</code> method.<br />
** 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.<br />
<br />
== Build ==<br />
* '''Boost''' : Updated to version 1.82.0.<br />
* '''Cortex''' : Updated to version 10.6.0.0a1.<br />
* '''Cycles''' : Updated to version 4.4.0.<br />
* '''FreeType''' : Updated to version 2.13.3.<br />
* '''LibRaw''' : Updated to version 0.21.4.<br />
* '''MaterialX''' : Updated to version 1.39.3.<br />
* '''Minizip''' : Updated to version 3.0.10.<br />
* '''OpenColorIO''' : Updated to version 2.3.2.<br />
* '''OpenEXR''' : Updated to version 3.2.4.<br />
* '''OpenImageIO''' : Updated to version 3.0.6.1.<br />
* '''OpenShadingLanguage''' : Updated to version 1.14.5.1.<br />
* '''OpenSubdiv''' : Updated to version 3.6.0.<br />
* '''OpenVDB''' : Updated to version 11.0.0.<br />
* '''Python''' : Updated to version 3.11.12.<br />
* '''PySide''' : Updated to version 6.5.6.<br />
* '''Qt''' : Updated to version 6.5.6.<br />
* '''Qt.py''' : Updated to version 1.4.6.<br />
* '''USD''' : Updated to version 25.05.01.</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Gaffer_1.6_release&diff=582Gaffer 1.6 release2025-08-16T17:58:00Z<p>GafferBot: </p>
<hr />
<div><blockquote>Note : Gaffer 1.6 is currently in alpha, with a stable release expected for September 2025.</blockquote><br />
<br />
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.<br />
<br />
== Features ==<br />
* '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver.<br />
* '''Cycles''' : Updated to version 4.4.0.<br />
* '''DiskBlur''' : Added image node for doing fast variable-radius blur. Will be used as core of upcoming focal blur node.<br />
* '''SceneInspector''' :<br />
** Rewrote using the same framework as LightEditor, AttributeEditor and RenderPassEditor.<br />
** Added EditScope support, with in-place editing of attributes, options and shader parameters. Editing for other properties is planned for future versions.<br />
** Improved comparison abilities, including the added ability to compare two render passes.<br />
** Added subsections for options and attributes, splitting them by category.<br />
** Added column resizing, including automatic resizing to show long attribute names.<br />
** Added inspection of all shaders and parameters in shader networks.<br />
** Added more detailed inspection of meshes and curves.<br />
** Added more detailed inspection of primitive variables.<br />
* '''ImageSelectionTool''' :<br />
** 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 ).<br />
** 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 ).<br />
* '''ColorInspectorTool''' : Moved the Viewer's colour inspectors into a dedicated tool, selected from the toolbar on the left.<br />
* '''OSLObject''' : Added the ability to use<code>pointcloud_search()</code> and<code>pointcloud_get()</code> to query geometry from arbitrary scene locations.<br />
* '''CameraQuery''' : Added a new node to query camera parameters (#6431).<br />
<br />
== Improvements ==<br />
* '''DeleteAttributes''' : Optimised case where all attributes are deleted. The input attributes are no longer accessed at all in this case.<br />
* '''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.<br />
* '''3Delight''', '''Cycles''', '''OpenGL''' : Added support for custom EXR metadata, using<code>header:*</code> parameters on the output definition.<br />
* '''RenderManAttributes''', '''RenderManOptions''' : Plugs now respect minimum and maximum values specified by RenderMan.<br />
* '''RenderManShader''' : Improved GraphEditor labels for parameter RGB and XYZ components.<br />
* '''Cycles''' :<br />
** Improved responsiveness for Viewer camera updates when using Cycles as the viewport renderer. One benchmark shows around a 10x improvement in frame rate.<br />
** Added support for<code>layerName</code> parameter in outputs, to control the naming of channels in EXR outputs.<br />
* '''StandardOptions''' :<br />
** Added render manifest option.<br />
** Added<code>render:cameraInclusions</code>,<code>render:cameraExclusions</code>,<code>render:matteInclusions</code>, and<code>render:matteExclusions</code> options.<br />
* '''CyclesMeshLight''' : Improved presentation of<code>cameraVisibility</code> and<code>lightGroup</code> plugs in the Node Editor.<br />
* '''VisualiserTool''' : Added visualisation of labels for uniform primitive variables, face indices and curve indices.<br />
* '''PathListingWidget''' :<br />
** Improved formatting of Box and Matrix values.<br />
** Improved performance when showing colour values.<br />
** Added support for showing spline values.<br />
* '''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 ).<br />
* '''Switch''' : Optimised disabled switches using a direct internal connection, even when the<code>index</code> is not constant.<br />
* '''RenderMan''' : Added dedicated viewport visualisers for RenderMan lights.<br />
* '''Viewer''' : Added<code>Add</code> image comparison mode.<br />
* '''LocaliseAttributes''' : Added support for localising global attributes, controlled by the new<code>includeGlobalAttributes</code> plug.<br />
* '''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.<br />
* '''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.<br />
* '''SphereLevelSet''' : Improved performance when evaluating the bounding box.<br />
* '''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>.<br />
* '''RenderPassEditor''', '''AttributeEditor''', '''LightEditor''', '''SceneInspector''' : Improved presentation of VectorData types in the Inspect popup.<br />
* '''CompoundDataPlugValueWidget''' : Removed unnecessary nesting from the menu for adding plugs.<br />
* '''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.<br />
* '''PrimitiveInspector''' : Added<code>location</code> widget for selecting the location to be inspected.<br />
* '''OptionalValuePlugValueWidget''' : The widget for the<code>enabled</code> plug can now be customised using<code>plugValueWidget:type</code> metadata.<br />
* '''PathListingWidget''' : Improved formatting of TypedVectorData.<br />
<br />
== Fixes ==<br />
* '''LocalDispatcher''', '''SystemCommand''',<code>gaffer env</code> : Fixed unwanted upper-casing of environment variable names on Windows (#6371).<br />
* '''OpenGLAttributes''' : The default values of attribute plugs now correctly reflect the default behaviour of the OpenGL renderer.<br />
* '''Arnold''' : Fixed default behaviour of<code>ai:abort_on_license_fail</code> option with Arnold 7.3 and above.<br />
* '''Cycles''' :<br />
** Fixed bugs handling identical cameras with different transforms.<br />
** Fixed handling of<code>cycles:volume_precision</code> attribute, which was previously being ignored.<br />
** Fixed bugs handling unknown VDB grid types.<br />
** Fixed potential crash rendering VDB objects.<br />
** Fixed potential threading-related crashes.<br />
* '''RenderPassEditor''' : Fixed default values displayed for<code>dl:oversampling</code> and<code>dl:quality.shadingsamples</code> options.<br />
* '''PlugLayout''' : Fixed bug resolving<code>layout:index</code> metadata.<br />
* '''ScriptNodeAlgo''' : Stopped polluting the ScriptNode context with<code>ui:*</code> variables. Warnings are now emitted by the UI if anything else causes similar pollution.<br />
* '''Checkerboard''' : Fixed crash when evaluated for non-existent channel name.<br />
* '''PathListingWidget''' :<br />
** Prevented emission of<code>updateFinishedSignal()</code> when a new update is pending anyway.<br />
** Fixed potential threading-related crash.<br />
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :<br />
** Fixed missing history entries when two edits have the same source plug.<br />
** Fixed potential crashes in<code>Show History...</code>.<br />
** Fixed potential UI lag in<code>Show History...</code>.<br />
** Fixed flickering in history window when scrubbing the timeline.<br />
* '''RenderPassEditor''' : Fixed error when deleting a pass while a history window was open for it.<br />
* '''OptionalValuePlugValueWidget''' : Fixed handling of keyword constructor arguments. In particular this meant that<code>parenting</code> arguments did not work.<br />
* '''ScenePathPlugValueWidget''' :<br />
** 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.<br />
** Fixed bugs that prevented usage in<code>Editor.Settings</code> nodes.<br />
* '''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.<br />
* '''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.<br />
* '''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).<br />
* '''ContextQuery''' : Removed<code>Create Context Query...</code> menu item from plugs where it was not relevant.<br />
* '''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.<br />
* '''PathListingWidget''' :<br />
** 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.<br />
** Fixed unwanted vertical scrolling caused by<code>setColumns()</code>.<br />
** Columns set to automatically stretch now equally share available space when a PathListingWidget's columns are updated via<code>setColumns()</code>.<br />
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :<br />
** Fixed unwanted vertical scrolling when switching tabs.<br />
** Fixed flickering when switching tabs.<br />
<br />
== API ==<br />
* '''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.<br />
* '''GafferScene'''::RenderManifest : Added class for representing mapping of ids to paths in renders. Supports reading EXR and cryptomatte manifests, and writing EXR manifests.<br />
* '''Metadata''' :<br />
** Added<code>registerValues()</code> function that registers multiple metadata entries from a dictionary of string targets.<br />
** Updated<code>targetsWithMetadata()</code> function to support matching multiple targets.<br />
* '''MetadataAlgo''' : Added<code>createPlugFromMetadata()</code> function.<br />
* '''RenderController''' : Added<code>renderManifest()</code> method.<br />
* '''ImageGadget''' : Added support for showing selected and highlighted ids. Controlled using<code>setIDChannel</code>,<code>setSelectedIDs</code>, and<code>setHighlightID</code>.<br />
* '''ShadingEngine''' : Added support for passing custom pointclouds to the<code>shade()</code> call.<br />
* '''SceneAlgo''' :<br />
**<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.<br />
**<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.<br />
* '''ScenePlug''' : Added optional<code>withGlobalAttributes</code> arguments to<code>fullAttributes()</code> and<code>fullAttributesHash()</code>.<br />
* '''VectorDataWidget''' : Added optional<code>maximumVisibleRows</code> argument.<br />
* '''Path''' : Added<code>contextProperty()</code> method.<br />
<br />
== Breaking Changes ==<br />
* '''Arnold''' :<br />
** Removed support for Arnold 7.2.<br />
** Removed<code>GafferArnoldUI.GPUCache.populateGPUCache()</code> function.<br />
* '''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.<br />
* '''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.<br />
* '''ArnoldOptions''' : Changed the default value of the<code>ai:texture_max_memory_MB</code> plug to 4096 to match Arnold's default.<br />
* '''StandardNodule''' : Removed deprecated<code>setCompatibleLabelsVisible()</code>.<br />
* '''DeleteAttributes''' : Changed base class and marked as<code>final</code>.<br />
* '''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.<br />
* '''RenderPasses''', '''DeleteRenderPasses''' : Renamed TypeId enum values to<code>RenderPassesTypeId</code> and<code>DeleteRenderPassesTypeId</code>.<br />
* '''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.<br />
* '''SceneTestCase''' : Removed<code>assertBoxesEqual()</code> and<code>assertBoxesAlmostEqual()</code> methods.<br />
* '''RenderController''' : Removed<code>pathForID()</code>,<code>pathsForIDs()</code>,<code>idForPath()</code> and<code>idsForPaths()</code>. Use<code>renderManifest()</code> instead.<br />
* '''Catalogue''', '''CatalogueSelect''', '''Display''' : Moved from GafferImage module to GafferScene.<br />
* '''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".<br />
* '''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 ).<br />
* '''OSLObject''', '''OSLImage''', '''Expression''' : Removed support for file-based pointclouds.<br />
* '''ContextAlgo''' : Removed deprecated API. Use ScriptNodeAlgo instead, which has been available from Gaffer 1.4.13.0 onwards.<br />
* '''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.<br />
* '''SceneReader''', '''SceneWriter''' : Changed handling of missing shutter parameters. See Fixes section for more detail.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''Arnold''' : Changed the naming of shader nodes in the generated Arnold scene.<br />
* '''Path''' : Removed<code>inspectionContext()</code> method. Use<code>contextProperty( "inspector:context" )</code> instead.<br />
* '''SceneInspector''' :<br />
** Removed<code>setTargetPaths()</code> and<code>getTargetPaths()</code> methods. Use the<code>location</code> and<code>compare.location</code> settings plugs instead.<br />
** Removed<code>registerSection()</code> method.<br />
** 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.<br />
<br />
== Build ==<br />
* '''Boost''' : Updated to version 1.82.0.<br />
* '''Cortex''' : Updated to version 10.6.0.0a1.<br />
* '''Cycles''' : Updated to version 4.4.0.<br />
* '''FreeType''' : Updated to version 2.13.3.<br />
* '''LibRaw''' : Updated to version 0.21.4.<br />
* '''MaterialX''' : Updated to version 1.39.3.<br />
* '''Minizip''' : Updated to version 3.0.10.<br />
* '''OpenColorIO''' : Updated to version 2.3.2.<br />
* '''OpenEXR''' : Updated to version 3.2.4.<br />
* '''OpenImageIO''' : Updated to version 3.0.6.1.<br />
* '''OpenShadingLanguage''' : Updated to version 1.14.5.1.<br />
* '''OpenSubdiv''' : Updated to version 3.6.0.<br />
* '''OpenVDB''' : Updated to version 11.0.0.<br />
* '''Python''' : Updated to version 3.11.12.<br />
* '''PySide''' : Updated to version 6.5.6.<br />
* '''Qt''' : Updated to version 6.5.6.<br />
* '''Qt.py''' : Updated to version 1.4.6.<br />
* '''USD''' : Updated to version 25.05.01.</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Gaffer_1.6_release&diff=581Gaffer 1.6 release2025-08-16T17:55:11Z<p>GafferBot: 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..."</p>
<hr />
<div><blockquote>Note : Gaffer 1.6 is currently in alpha, with a stable release planned for September 2025.</blockquote><br />
<br />
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.<br />
<br />
== Features ==<br />
* '''Arnold''' : Added multi-layer EXR support. All outputs with the same filename are now written to the same file via a single output driver.<br />
* '''Cycles''' : Updated to version 4.4.0.<br />
* '''DiskBlur''' : Added image node for doing fast variable-radius blur. Will be used as core of upcoming focal blur node.<br />
* '''SceneInspector''' :<br />
** Rewrote using the same framework as LightEditor, AttributeEditor and RenderPassEditor.<br />
** Added EditScope support, with in-place editing of attributes, options and shader parameters. Editing for other properties is planned for future versions.<br />
** Improved comparison abilities, including the added ability to compare two render passes.<br />
** Added subsections for options and attributes, splitting them by category.<br />
** Added column resizing, including automatic resizing to show long attribute names.<br />
** Added inspection of all shaders and parameters in shader networks.<br />
** Added more detailed inspection of meshes and curves.<br />
** Added more detailed inspection of primitive variables.<br />
* '''ImageSelectionTool''' :<br />
** 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 ).<br />
** 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 ).<br />
* '''ColorInspectorTool''' : Moved the Viewer's colour inspectors into a dedicated tool, selected from the toolbar on the left.<br />
* '''OSLObject''' : Added the ability to use<code>pointcloud_search()</code> and<code>pointcloud_get()</code> to query geometry from arbitrary scene locations.<br />
* '''CameraQuery''' : Added a new node to query camera parameters (#6431).<br />
<br />
== Improvements ==<br />
* '''DeleteAttributes''' : Optimised case where all attributes are deleted. The input attributes are no longer accessed at all in this case.<br />
* '''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.<br />
* '''3Delight''', '''Cycles''', '''OpenGL''' : Added support for custom EXR metadata, using<code>header:*</code> parameters on the output definition.<br />
* '''RenderManAttributes''', '''RenderManOptions''' : Plugs now respect minimum and maximum values specified by RenderMan.<br />
* '''RenderManShader''' : Improved GraphEditor labels for parameter RGB and XYZ components.<br />
* '''Cycles''' :<br />
** Improved responsiveness for Viewer camera updates when using Cycles as the viewport renderer. One benchmark shows around a 10x improvement in frame rate.<br />
** Added support for<code>layerName</code> parameter in outputs, to control the naming of channels in EXR outputs.<br />
* '''StandardOptions''' :<br />
** Added render manifest option.<br />
** Added<code>render:cameraInclusions</code>,<code>render:cameraExclusions</code>,<code>render:matteInclusions</code>, and<code>render:matteExclusions</code> options.<br />
* '''CyclesMeshLight''' : Improved presentation of<code>cameraVisibility</code> and<code>lightGroup</code> plugs in the Node Editor.<br />
* '''VisualiserTool''' : Added visualisation of labels for uniform primitive variables, face indices and curve indices.<br />
* '''PathListingWidget''' :<br />
** Improved formatting of Box and Matrix values.<br />
** Improved performance when showing colour values.<br />
** Added support for showing spline values.<br />
* '''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 ).<br />
* '''Switch''' : Optimised disabled switches using a direct internal connection, even when the<code>index</code> is not constant.<br />
* '''RenderMan''' : Added dedicated viewport visualisers for RenderMan lights.<br />
* '''Viewer''' : Added<code>Add</code> image comparison mode.<br />
* '''LocaliseAttributes''' : Added support for localising global attributes, controlled by the new<code>includeGlobalAttributes</code> plug.<br />
* '''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.<br />
* '''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.<br />
* '''SphereLevelSet''' : Improved performance when evaluating the bounding box.<br />
* '''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>.<br />
* '''RenderPassEditor''', '''AttributeEditor''', '''LightEditor''', '''SceneInspector''' : Improved presentation of VectorData types in the Inspect popup.<br />
* '''CompoundDataPlugValueWidget''' : Removed unnecessary nesting from the menu for adding plugs.<br />
* '''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.<br />
* '''PrimitiveInspector''' : Added<code>location</code> widget for selecting the location to be inspected.<br />
* '''OptionalValuePlugValueWidget''' : The widget for the<code>enabled</code> plug can now be customised using<code>plugValueWidget:type</code> metadata.<br />
* '''PathListingWidget''' : Improved formatting of TypedVectorData.<br />
<br />
== Fixes ==<br />
* '''LocalDispatcher''', '''SystemCommand''',<code>gaffer env</code> : Fixed unwanted upper-casing of environment variable names on Windows (#6371).<br />
* '''OpenGLAttributes''' : The default values of attribute plugs now correctly reflect the default behaviour of the OpenGL renderer.<br />
* '''Arnold''' : Fixed default behaviour of<code>ai:abort_on_license_fail</code> option with Arnold 7.3 and above.<br />
* '''Cycles''' :<br />
** Fixed bugs handling identical cameras with different transforms.<br />
** Fixed handling of<code>cycles:volume_precision</code> attribute, which was previously being ignored.<br />
** Fixed bugs handling unknown VDB grid types.<br />
** Fixed potential crash rendering VDB objects.<br />
** Fixed potential threading-related crashes.<br />
* '''RenderPassEditor''' : Fixed default values displayed for<code>dl:oversampling</code> and<code>dl:quality.shadingsamples</code> options.<br />
* '''PlugLayout''' : Fixed bug resolving<code>layout:index</code> metadata.<br />
* '''ScriptNodeAlgo''' : Stopped polluting the ScriptNode context with<code>ui:*</code> variables. Warnings are now emitted by the UI if anything else causes similar pollution.<br />
* '''Checkerboard''' : Fixed crash when evaluated for non-existent channel name.<br />
* '''PathListingWidget''' :<br />
** Prevented emission of<code>updateFinishedSignal()</code> when a new update is pending anyway.<br />
** Fixed potential threading-related crash.<br />
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :<br />
** Fixed missing history entries when two edits have the same source plug.<br />
** Fixed potential crashes in<code>Show History...</code>.<br />
** Fixed potential UI lag in<code>Show History...</code>.<br />
** Fixed flickering in history window when scrubbing the timeline.<br />
* '''RenderPassEditor''' : Fixed error when deleting a pass while a history window was open for it.<br />
* '''OptionalValuePlugValueWidget''' : Fixed handling of keyword constructor arguments. In particular this meant that<code>parenting</code> arguments did not work.<br />
* '''ScenePathPlugValueWidget''' :<br />
** 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.<br />
** Fixed bugs that prevented usage in<code>Editor.Settings</code> nodes.<br />
* '''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.<br />
* '''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.<br />
* '''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).<br />
* '''ContextQuery''' : Removed<code>Create Context Query...</code> menu item from plugs where it was not relevant.<br />
* '''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.<br />
* '''PathListingWidget''' :<br />
** 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.<br />
** Fixed unwanted vertical scrolling caused by<code>setColumns()</code>.<br />
** Columns set to automatically stretch now equally share available space when a PathListingWidget's columns are updated via<code>setColumns()</code>.<br />
* '''LightEditor''', '''RenderPassEditor''', '''AttributeEditor''' :<br />
** Fixed unwanted vertical scrolling when switching tabs.<br />
** Fixed flickering when switching tabs.<br />
<br />
== API ==<br />
* '''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.<br />
* '''GafferScene'''::RenderManifest : Added class for representing mapping of ids to paths in renders. Supports reading EXR and cryptomatte manifests, and writing EXR manifests.<br />
* '''Metadata''' :<br />
** Added<code>registerValues()</code> function that registers multiple metadata entries from a dictionary of string targets.<br />
** Updated<code>targetsWithMetadata()</code> function to support matching multiple targets.<br />
* '''MetadataAlgo''' : Added<code>createPlugFromMetadata()</code> function.<br />
* '''RenderController''' : Added<code>renderManifest()</code> method.<br />
* '''ImageGadget''' : Added support for showing selected and highlighted ids. Controlled using<code>setIDChannel</code>,<code>setSelectedIDs</code>, and<code>setHighlightID</code>.<br />
* '''ShadingEngine''' : Added support for passing custom pointclouds to the<code>shade()</code> call.<br />
* '''SceneAlgo''' :<br />
**<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.<br />
**<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.<br />
* '''ScenePlug''' : Added optional<code>withGlobalAttributes</code> arguments to<code>fullAttributes()</code> and<code>fullAttributesHash()</code>.<br />
* '''VectorDataWidget''' : Added optional<code>maximumVisibleRows</code> argument.<br />
* '''Path''' : Added<code>contextProperty()</code> method.<br />
<br />
== Breaking Changes ==<br />
* '''Arnold''' :<br />
** Removed support for Arnold 7.2.<br />
** Removed<code>GafferArnoldUI.GPUCache.populateGPUCache()</code> function.<br />
* '''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.<br />
* '''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.<br />
* '''ArnoldOptions''' : Changed the default value of the<code>ai:texture_max_memory_MB</code> plug to 4096 to match Arnold's default.<br />
* '''StandardNodule''' : Removed deprecated<code>setCompatibleLabelsVisible()</code>.<br />
* '''DeleteAttributes''' : Changed base class and marked as<code>final</code>.<br />
* '''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.<br />
* '''RenderPasses''', '''DeleteRenderPasses''' : Renamed TypeId enum values to<code>RenderPassesTypeId</code> and<code>DeleteRenderPassesTypeId</code>.<br />
* '''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.<br />
* '''SceneTestCase''' : Removed<code>assertBoxesEqual()</code> and<code>assertBoxesAlmostEqual()</code> methods.<br />
* '''RenderController''' : Removed<code>pathForID()</code>,<code>pathsForIDs()</code>,<code>idForPath()</code> and<code>idsForPaths()</code>. Use<code>renderManifest()</code> instead.<br />
* '''Catalogue''', '''CatalogueSelect''', '''Display''' : Moved from GafferImage module to GafferScene.<br />
* '''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".<br />
* '''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 ).<br />
* '''OSLObject''', '''OSLImage''', '''Expression''' : Removed support for file-based pointclouds.<br />
* '''ContextAlgo''' : Removed deprecated API. Use ScriptNodeAlgo instead, which has been available from Gaffer 1.4.13.0 onwards.<br />
* '''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.<br />
* '''SceneReader''', '''SceneWriter''' : Changed handling of missing shutter parameters. See Fixes section for more detail.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''Arnold''' : Changed the naming of shader nodes in the generated Arnold scene.<br />
* '''Path''' : Removed<code>inspectionContext()</code> method. Use<code>contextProperty( "inspector:context" )</code> instead.<br />
* '''SceneInspector''' :<br />
** Removed<code>setTargetPaths()</code> and<code>getTargetPaths()</code> methods. Use the<code>location</code> and<code>compare.location</code> settings plugs instead.<br />
** Removed<code>registerSection()</code> method.<br />
** 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.<br />
<br />
== Build ==<br />
* '''Boost''' : Updated to version 1.82.0.<br />
* '''Cortex''' : Updated to version 10.6.0.0a1.<br />
* '''Cycles''' : Updated to version 4.4.0.<br />
* '''FreeType''' : Updated to version 2.13.3.<br />
* '''LibRaw''' : Updated to version 0.21.4.<br />
* '''MaterialX''' : Updated to version 1.39.3.<br />
* '''Minizip''' : Updated to version 3.0.10.<br />
* '''OpenColorIO''' : Updated to version 2.3.2.<br />
* '''OpenEXR''' : Updated to version 3.2.4.<br />
* '''OpenImageIO''' : Updated to version 3.0.6.1.<br />
* '''OpenShadingLanguage''' : Updated to version 1.14.5.1.<br />
* '''OpenSubdiv''' : Updated to version 3.6.0.<br />
* '''OpenVDB''' : Updated to version 11.0.0.<br />
* '''Python''' : Updated to version 3.11.12.<br />
* '''PySide''' : Updated to version 6.5.6.<br />
* '''Qt''' : Updated to version 6.5.6.<br />
* '''Qt.py''' : Updated to version 1.4.6.<br />
* '''USD''' : Updated to version 25.05.01.</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=548Template:LatestGafferVersion2025-07-28T15:38:23Z<p>GafferBot: </p>
<hr />
<div>1.5.16.1</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=525Template:LatestGafferVersion2025-07-10T23:16:56Z<p>GafferBot: </p>
<hr />
<div>1.5.16.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Template:LatestGafferVersion&diff=522Template:LatestGafferVersion2025-06-12T17:35:17Z<p>GafferBot: </p>
<hr />
<div>1.5.15.0</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Encapsulate&diff=518Encapsulate2025-05-19T22:54:30Z<p>GafferBot: </p>
<hr />
<div>{{Node<br />
|namespace=GafferScene<br />
|description=Encapsulates a portion of the scene by collapsing the hierarchy and replacing it with a procedural which will be evaluated at render time.<br />
|categories=Capsule, Hierarchy<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Set&diff=517Category:Nodes:Set2025-05-19T22:52:48Z<p>GafferBot: Created page with "== Set Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Set' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Set Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Set'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:ContextVariable&diff=516Category:Nodes:ContextVariable2025-05-19T22:52:28Z<p>GafferBot: Created page with "== Context Variable Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'ContextVariable' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Context Variable Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'ContextVariable'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Cycles&diff=515Category:Nodes:Cycles2025-05-19T22:51:36Z<p>GafferBot: /* Hierarchy Nodes */</p>
<hr />
<div>== Cycles Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Cycles'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Cycles&diff=514Category:Nodes:Cycles2025-05-19T22:51:30Z<p>GafferBot: Created page with "== Hierarchy Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Cycles' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Hierarchy Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Cycles'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Attribute&diff=513Category:Nodes:Attribute2025-05-19T22:51:07Z<p>GafferBot: Created page with "== Attribute Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Attribute' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Attribute Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Attribute'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Option&diff=512Category:Nodes:Option2025-05-19T22:50:03Z<p>GafferBot: Created page with "== Option Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Option' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Option Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Option'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:RenderMan&diff=511Category:Nodes:RenderMan2025-05-19T22:49:43Z<p>GafferBot: Created page with "== RenderMan Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'RenderMan' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== RenderMan Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'RenderMan'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:USD&diff=510Category:Nodes:USD2025-05-19T22:49:24Z<p>GafferBot: Created page with "== USD Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'USD' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== USD Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'USD'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Alembic&diff=509Category:Nodes:Alembic2025-05-19T22:48:58Z<p>GafferBot: Created page with "== Alembic Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Alembic' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Alembic Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Alembic'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Cube&diff=508Cube2025-05-19T22:48:08Z<p>GafferBot: </p>
<hr />
<div>{{Node<br />
|namespace=GafferScene<br />
|description=Produces scenes containing a cube.<br />
|categories=Create, Primitive, Mesh<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Mesh&diff=507Category:Nodes:Mesh2025-05-19T22:47:34Z<p>GafferBot: Created page with "== Mesh Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Mesh' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Mesh Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Mesh'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:RenderPass&diff=506Category:Nodes:RenderPass2025-05-19T22:47:13Z<p>GafferBot: Created page with "== Render Pass Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'RenderPass' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Render Pass Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'RenderPass'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:OCIO&diff=505Category:Nodes:OCIO2025-05-19T22:46:51Z<p>GafferBot: Created page with "== OCIO Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'OCIO' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== OCIO Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'OCIO'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:ImageTransform&diff=504Category:Nodes:ImageTransform2025-05-19T22:46:27Z<p>GafferBot: Created page with "== Image Transform Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'ImageTransform' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Image Transform Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'ImageTransform'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:GafferArnold&diff=503Category:Nodes:GafferArnold2025-05-19T22:45:58Z<p>GafferBot: Created page with "== Hierarchy Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.namespace='GafferArnold' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Hierarchy Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.namespace='GafferArnold'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Constraint&diff=502Category:Nodes:Constraint2025-05-19T22:45:24Z<p>GafferBot: Created page with "== Constraint Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Constraint' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Constraint Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Constraint'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Arnold&diff=501Category:Nodes:Arnold2025-05-19T22:45:01Z<p>GafferBot: Created page with "== Arnold Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Arnold' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Arnold Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Arnold'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBothttps://www.gaffer.wiki/w/index.php?title=Category:Nodes:Curve&diff=500Category:Nodes:Curve2025-05-19T22:44:34Z<p>GafferBot: Created page with "== Curve Nodes == {{#cargo_query: tables=Nodes |fields=Nodes._pageName=Name,Nodes.description=Description |where=Nodes.categories HOLDS 'Curve' |limit=500 |format=dynamic table |column widths=180px }}"</p>
<hr />
<div>== Curve Nodes ==<br />
{{#cargo_query:<br />
tables=Nodes<br />
|fields=Nodes._pageName=Name,Nodes.description=Description<br />
|where=Nodes.categories HOLDS 'Curve'<br />
|limit=500<br />
|format=dynamic table<br />
|column widths=180px<br />
}}</div>GafferBot