Release Notes for Nuke and Hiero 12.2v11
21 July 2022
Qualified Operating Systems
• macOS Mojave (10.14.x) or macOS Catalina (10.15.x)
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 https://developer.nvidia.com/cuda-gpus
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 https://www.nvidia.com/Download/Find.aspx 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 https://www.amd.com/en/support
• 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.
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.
There are no new features in this release.
There are no feature enhancements in this release.
• ID 373092 - Monitor Out: After a gap in the timeline, the first frame of a shot during playback on the monitor was occasionally the last frame of the previous shot.
• ID 379217 - Read/Write: Rendered .exr files did not obtain their node_hash from the Write node.
• ID 404412 - AAF: Certain .aaf files with retimes were interpreted incorrectly as full length clips in Hiero or Nuke Studio.
• ID 429243 - Preferences: The path substitutions table did not extend as expected to accommodate multiple rows.
• ID 429245 - Preferences: Using / (slashes) or spaces in path substitutions in the Preferences padded table rows incorrectly, making the UI unusable.
• ID 434387 - Windows only: Setting the UI scale to 150% or higher and moving Nuke to a second monitor stopped the floating color pickers working as expected.
• ID 484567 - Preferences: Adding a new entry to the path substitutions table occasionally added two rows.
• ID 486534 - Read/Write: Reading certain .exr files caused Nuke Studio to crash.
• ID 495347 - Read/Write: Animated Transform nodes upstream of VectorDistort nodes caused the first frame to render incorrectly from the command line and in interactive sessions with the Frame Server.
• ID 501884 - Timeline Editing: Blended shots that did not start at frame 0, incorrectly offset the last frame of the blend track by 1 frame.
• ID 510841 - AAF: Importing certain .aaf files from Avid or Resolve didn't align some shots in the timeline as expected.
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 510492 - Soft Effects: Changing the File Type to mov in the Export dialog causes expressions on disabled Text and Burn-In effects to display a TypeError: expected str, bytes or os.PathLike object, not NoneType error on the command line.
• ID 505168 - 3D Pivot Point: Actions selected from the snap menu are sometimes applied to the wrong object.
• ID 503234 - Windows only: Calling nuke.execute() on a script containing a Write node set to file type >mov from the Python application shipped with Nuke displays a Write1 cannot be executed for multiple frames error.
• ID 497944 - Python: Calling hiero.core.events.postEvent() displays an AttributeError: 'module' object has no attribute 'postEvent' error.
• ID 496257 - Python: Creating multiple soft effects Pythonically results in effects with the same name.
• ID 495461 - Colorspace: Exporting from Hiero or Nuke Studio with a non-default colorspace does not create a Write node as expected and displays an Unable to create Write node with invalid color space error.
• ID 495073 - Erode: Viewing an Erode node when part of a 3D scene with a large resolution uses an excessive amount of RAM.
• ID 494269 - Read/Write: Importing certain resolution Apple ProRes 422 files from Adobe Media Encoder displays a Mov64Reader: Failed to decode frame, the output buffer is not 16-bit aligned error.
• ID 492205 - Sync Review: Attempting to host a review session between Nuke Studio and Hiero on the same machine does not work as expected and occasionally causes the connecting application to crash.
• ID 488282 - Python: Calling nuke.execute() in a Python file from the command line causes Nuke to crash.
• ID 485240 - macOS only: Decloning a soft effect results in two effects with the same name.
• ID 483253 - macOS only: Importing certain .mov files causes Hiero and Nuke Studio to crash.
• 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 470465 - Preferences: The Performance > Hardware > disable blink cache control has a misleading label and tooltip.
• 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 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 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 License > Roaming 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 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.
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.
12.0v1 to 12.0v2
API and ABI
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 toolbars.py 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 toolbars.py 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")