Release Notes for Nuke and Hiero 12.2v9

Release Date

09 September 2021

Warning:  As a result of the current COVID-19 government recommendations here in the UK, much of the Nuke team is still working from home. Currently, Foundry cannot guarantee that our usual high standards of QA have been applied to Nuke's monitor output functionality, including VR headset support, in this release.

Qualified Operating Systems

macOS Mojave (10.14) or macOS Catalina (10.15)

Note:  We recommend macOS Mojave customers update to 10.14.6 to take advantage of performance enhancements.

Windows 10 (64-bit)

CentOS 7.4, 7.5, and 7.6 (64-bit)

Note:  The VFX Platform 2019 upgrade includes library versions that are only compatible with CentOS 7.4, or later.

Other operating systems may work, but have not been fully tested.

Requirements for Nuke's GPU Acceleration

If you want to enable Nuke to calculate certain nodes using the GPU, there are some additional requirements.


An NVIDIA GPU with compute capability 3.0 (Kepler) or above. A list of the compute capabilities of NVIDIA GPUs is available at

Note:  The compute capability is a property of the GPU hardware and can't be altered by a software update.

With graphics drivers capable of running CUDA 10.1 or above. On Windows and Linux, CUDA graphics drivers are bundled with the regular drivers for your NVIDIA GPU. Driver versions 418.96 (Windows) and 418.39 (Linux), or above are required. See for more information.

Note:  We recommend using the latest graphics drivers, where possible, regardless of operating system.


Note:  Bit-wise equality between GPU and CPU holds in most cases, but for some operations there are limitations to the accuracy possible with this configuration.

On Windows and Linux, an AMD GPU from the following list:

Note:  Other AMD GPUs may work, but have not been fully tested.

Radeon™ RX 480

Radeon™ Pro WX 7100

Radeon™ Pro WX 9100

Radeon™ Pro WX 8200

Radeon™ Pro W5700

Note:  For information on the recommended driver for each GPU, see

On Mac, AMD GPUs are supported on any late 2013 Mac Pro, mid 2015 MacBook Pros onward, and late 2017 iMac Pros.

Warning:  Although AMD GPUs are enabled on other Mac models, they are not officially supported and used at your own risk.

Multi-GPU Processing

Nuke's GPU support includes an Enable multi-GPU support option. When enabled in the preferences, GPU processing is shared between the available GPUs for extra processing speed.

Note:  Multi-GPU processing is only available for identical GPUs in the same machine. For example, two NVIDIA GeForce GTX 1080s or two AMD Radeon™ Pro WX 9100s.

New Features

• ID 244774 - Timeline Editing: You can now copy and paste shots and soft effects between different projects in the same Nuke Studio or Hiero session and between Nuke Studio and Hiero sessions.

Feature Enhancements

There are no feature enhancements in this release.

Bug Fixes

• ID 351910 - Timeline Editing: Copying a sequence into a new project did not work as expected.

• ID 380723 - Read/Write: Clicking Load Settings from RMD in .r3d files written using IPP2 incorrectly enabled the Colorspace and Gamma Curve controls.

• ID 413707 - EdgeExtend: The Matte has no fully white pixels to sample from error message was not ignored correctly in some cases, causing renders to fail unnecessarily.

• ID 435284 - Python: Calling nuke.message() or nuke.alert() did not pause processing on the main thread as expected.

• ID 440798 - Timeline Editing: Using the Ripple Delete (Shift+Backspace) shortcut in the timeline occasionally offset frames incorrectly.

• ID 462986 - Read/Write: Importing .mov files with custom resolutions occasionally caused the application to crash.

• ID 484526 - Python: Dragging and dropping a custom PySide2 widget on a panel in Nuke caused the application to crash.

• ID 484726 - Soft Effects: Undoing cut or delete operations on cloned effects occasionally decoupled the clone state, reverting it to a standard effect.

• ID 484839 - Linux only: The size of the Nuke installation bundle increased unexpectedly.

• ID 484879 - Soft Effects: Cutting and pasting a clone occasionally created a standard effect, rather than a clone.

• ID 485146 - Developer Info: Nuke's arg parser used a too-small, signed int for memory limits.

New Known Issues Specific to Nuke 12.2

This section covers new known issues and gives workarounds for them, where appropriate.

Note:  Changes to the way motion vectors are calculated in Nuke 12.2 cause any node using the Local option for motion estimation, such as Kronos and VectorGenerator, to render slightly different vectors when compared to legacy versions of Nuke. The default Regularized motion estimation method is unaffected.

• ID 474957 - Monitor Output: The AJA T-Tap device does not currently work with Nuke.

• ID 472462 - Frame Server: Nuke frame server processes do not currently free RAM after completing a render.

• ID 472336 - Linux only: Adding certain MOV/QuickTime files containing audio to timeline causes Nuke Studio to crash.

• ID 471373 - macOS Nuke Indie only: C_STMap is incorrectly recognized as a custom plug-in and cannot be loaded.

• ID 468956 - Read/Write: Importing .aaf files with the file browser Preview panel open causes Nuke Studio to crash.

• ID 466754 - USD: Enabling read from file in a Camera or Axis node's Properties and then clicking No in the popup does not disable read from file as expected.

• ID 466720 - USD: Copy/pasting a .usd file from a browser into the Node Graph adds a / (forward slash) to the file path and displays a No such file or directory error.
As a workaround, delete the / and press enter to display the import dialog as normal.

• ID 466485 - Linux only: Nuke can not read .r3d files without CUDA libraries available on the machine.
As a workaround, you can manually install the CUDA libraries from NVIDIA, even if you don't have an NVIDIA GPU installed.

• ID 461944 - Python: Changing a Read node from an image sequence to a container file format Pythonically causes Nuke to crash if the Read node has postage stamp set to a static frame.

• ID 460411 - Read/Write: Rereading a .mov encoded with mov32 settings using the file control in legacy scripts causes Nuke to crash.

• ID 460240 - masOS only: Existing export presets using the deprecated mov32 codecs cause Hiero to crash on export.
As a workaround, recreate the preset in a Hiero 12.2 release

• ID 460038 - Particles: Secondary particles emitted from other particles do not render as expected.

• ID 459609 - USD: The Scenegraph does not automatically expand the first layer of items when loaded for the first time.

• ID 448524 - macOS only: The resolution restriction informational message for Nuke Indie contains incorrect text.

• ID 444347 - Export: Presets that rely on mov32 do not populate the Content field in the Export dialog.

• ID 443296 - Windows only: The Nuke Indie icon is incorrect.

• ID 442165 - MOV: Writing out .mov files using the H.264 codec at resolutions above the 4K limit imposed by the codec causes Nuke to crash.

• ID 441979 - USD: Deselecting a group in the USD importer and then enabling view entire scenegraph does not load the group.

• ID 441555 - USD: Clicking Cancel in the USD import dialog and then enabling view entire scenegraph does not load the .usd file as expected.

• ID 441439 - R3D: Red decode CPU performance is slower in Nuke 12.2 compared to 12.1 builds.

• ID 440943 - USD: Expanding parent and children groups in the scenegraph manually does not create the horizontal scroll bar correctly.
As a workaround, right-click and select expand all to display the scroll bar.

• ID 440057 - Roaming: Hiero license roaming with a Nuke Studio license stack is not working as expected.
As a workaround, launch Nuke Studio and select LicenseRoaming and then set the Workspace to Conforming.

• ID 439856 - Sync Review: Client sessions do not cache sequences as expected when the Viewer A/B mode is active on the Host before the Client connects.

• ID 439011 - ApplyMaterial: Selecting filter > name and then clicking choose incorrectly displays Load state icons.

• ID 439002 - ApplyMaterial: Selecting filter > name and then clicking choose allows editing of the read-only names in the scenegraph.

• ID 436560/436551 - Sync Review: The formatting in the Sync Session panel and Host and Connect dialogs is inconsistent.

• ID 434956 - USD: Columns in the Scenegraph tab can only be rearranged once.

• ID 434574 - File Formats Update: Reading .mxf files in the HybridLogGamma colorspace defaults to linear incorrectly.

• ID 432438 - Vertex UV values are occasionally displayed incorrectly for .abc and .usd files.

• ID 430779 - File Formats Update: All deprecated IPP2 .r3d colorspaces appear the same as current colorspaces.

• ID 430760 - File Formats Update: DRAGONcolor2 and REDcolor4 use the same IPP2 .r3d colorspace.

• ID 429788 - macOS only: Legacy mov32 presets are no longer retained, choosing a preset always displays the Don't show this message dialog.

• ID 425200 - Read/Write: Legacy Write node Motion JPEG A/B files do not display the Quality control with mov64 selected as the encoder.

• ID 424070 - RIP: Ops requesting unused inputs occasionally prevent images being released from the device cache.

Developer Notes

As Nuke develops, we sometimes have to make changes to the API and ABI under the hood. We try to keep these changes to a minimum and only for certain releases, but from time to time API and ABI compatibility is not guaranteed. See the following table for the situations when you may have to recompile your plug-ins and/or make changes to the source code.

Release Type






12.0v1 to 12.0v2





12.0v1 to 12.1v1




12.0v1 to 13.0v1


Additionally, node Class() names occasionally change between major releases. While these changes do not affect legacy scripts, you may not get the results you were expecting if a node class has been modified. The file, used to create Nuke's node toolbar, contains all the current node class names and is located in <install_directory>/plugins/nukescripts/ for reference.

As an example, between Nuke 9 and Nuke 10, the CameraShake node Class() changed from CameraShake2 to CameraShake3. In the file for the two releases, the entries for the CameraShake node appear as follows:

m.addCommand("CameraShake", "nuke.createNode(\"CameraShake2\")", icon="CameraShake.png")
m.addCommand("CameraShake", "nuke.createNode(\"CameraShake3\")", icon="CameraShake.png")