Release Notes for Nuke and Hiero 12.1v3

Release Date

11 June 2020

Warning:  As a result of the current COVID-19 lockdown here in the UK, 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)

• Windows 10 (64-bit)

• CentOS 7.4 (64-bit), or later

Note:  The VFX Platform 2019 upgrade includes library versions that are only compatible with CentOS 7.4, or later. Nuke 12.1 is qualified on the Centos 7.4, 7.5, and 7.6 distributions.

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.

NVIDIA

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.

AMD

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 SSG

• Radeon™ Pro WX 8200

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.

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

There are no new features in this release.

Feature Enhancements

There are no feature enhancements in this release.

Bug Fixes

• ID 226712 - Localization: Enabling background renders > start background render on comp save in the Preferences did not update localized frames correctly.

• ID 327638 - Loading large scripts containing NukeX nodes occasionally made node connections incorrectly.

• ID 332424 - Denoise: Enabling Temporal Processing on .exr clips with an out of bounds bounding box displayed CUDA errors in the Viewer.

• ID 334169 - Linux only: Enabling Fullscreen mode (Alt+S) retained window borders incorrectly.

• ID 381879 - LiveGroups: Selecting File > New Comp stopped LiveGroup edit warnings displaying correctly.

• ID 399025 - Tracker: Enabling the Bounding Box Warning in the Preferences caused certain Group nodes not connected to the node tree to display errors, which stopped tracking working as expected.

• ID 399154 - Versioning up or down with corrupted or incomplete versions available in the stack caused the application to crash.

• ID 399421 - Particles: TimeOffset nodes did not pass-through ParticleEmitter transform information.

• ID 400101 - High DPI: The Sparkles node bounding box outline was thinner and smaller than in older versions of Nuke.

• ID 400387 - High DPI: F_RigRemoval's controls were smaller and the default removal area was more square than in older versions of Nuke.

• ID 400465 - High DPI: C_CameraSolver's outline and points were thinner than in older versions of Nuke.

• ID 400476 - High DPI: C_Tracker's points were thinner than in older versions of Nuke.

• ID 400504 - High DPI: The AdjustBBox Viewer overlays were smaller and thinner than in older versions of Nuke.

• ID 400543 - High DPI: The Wipe controls in Nuke Studio were smaller and thinner than in older versions of Nuke.

• ID 401168 - High DPI: The DeepCrop Viewer widget was thinner than in older versions of Nuke.

• ID 402613 - High DPI: The icons for the edit controls in the Properties panel were blurred.

• ID 405258 - ReadGeo: Dragging an .abc or .fbx file into the Node Graph created a ReadGeo node, rather than a ReadGeo2 node.

• ID 409405 - Versioning up a clip in the same directory as a Nuke script with the same name caused the application to crash.

• ID 410543 - High DPI: The Frame Rate dropdown in the Sequence Properties in Nuke Studio was too long.

• ID 413861 - Export: Re-exporting certain comps did not work as expected.

• ID 415428 - Documentation: The Help > Documentation page Guide to Writing Blink Kernels link was incorrect.

• ID 416120 - LiveGroups: The Node tab Copy to group button did not work as expected for LiveGroups with custom tile colors.

• ID 416121 - LiveGroups: The Node tab Copy to group button did not copy custom user knobs to the Group.

• ID 418261 - High DPI: The pulldown knob spacing was different to older versions of Nuke.

• ID 419010 - Timeline Editing: Enabling and disabling track visibility was slow compared to older versions of Nuke Studio.

• ID 419697 - High DPI: The active state of certain interface elements was hard to determine due to lack of contrast.

• ID 419911 - Version Linking: The Details view could not be re-ordered by link status.

• ID 419924 - Selecting Cache > RAM Cache> Clear Playback Cache stopped certain .mov files playing back as expected.

• ID 420675 - Linux only: The RotoPaint ripple edit outline in the Viewer did not draw correctly.

• ID 422242 - High DPI: The active state of some buttons, such as the RotoPaint Viewer tools, was hard to see due to a lack of outline or contrast.

• ID 430317 - LensDistortion: Enabling Viewer downrez scaled the image incorrectly if the Viewer was not attached to the LensDistortion node.

• ID 431262 - Versioning up and down multiple shot selections only affected the first shot in the selection.

• ID 431516 - Alembic: Dragging mutli-mesh .abc files into the Node Graph did not work as expected.

New Known Issues Specific to Nuke 12.1

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

Note:  NVIDIA GPUs with compute capability of 3.0 (Kepler) cannot process .r3d files due to a known issue in the R3D SDK preventing decoding and debayering. Nuke defaults to CPU processing when reading .r3d files with these cards installed. A list of the compute capabilities of NVIDIA GPUs is available at: www.nvidia.co.uk/object/cuda_gpus_uk.html

• ID 436088 - C_CamerSolver: Setting the Lens Type to Rectilinear with multiple camera inputs and use GPU if available enabled renders black frames.
As a workaround, disable use GPU if available.

• ID 434748 - Python: nuke.message() popups created using PySide2 display the OK button incorrectly.

• ID 434387 - Windows only: Setting the UI scale to 150% or higher and moving Nuke to a second monitor stops floating color pickers working as expected.
As a workaround, locate the uistate.ini file here:
C:\Users\<username>\.nuke\uistate.ini
Remove the ColorPicker entry under [WindowLocations]. For example:
[WindowLocations]
ColorPicker=@Rect(943 324 555 200)

• ID 433153 - Viewer: Adding the custom_guides.py example file to the ../Python/Startup/ directory disables the overlay guides popup selector.

• ID 432414 - ARRIRAW: Clicking Load settings from metadata does not reset controls in the Properties panel if the current frame is outside the clip's frame range.

• ID 431603 - UI: Some filter names, such as cubic and impulse, changed case causing legacy scripts to display errors.

• ID 430184 - LensDistortion: Attempting to calculate distortion on clips with anamorphic (non-square) pixel ratios constrains feature and line detection to within the square pixel ratio area of the Viewer.

• ID 429749 - Reading in QuickTime reference files causes Nuke to crash.

• ID 427037 - UI: Adjusting the size of the node Properties > Node tab causes the font controls to resize incorrectly.

• ID 424122 - Windows only: Adjacent menu options have no break between their highlights on high DPI screens.

• ID 420685 - Linux only: Qt does not always follow local monitor scaling correctly.

• ID 420608 - High DPI: Flipbooking to HieroPlayer on a 4K Monitor occasionally doesn't work as expected.

• ID 420589 - C_CameraSolver: Running out of memory produces different results when matching and solving rigs.

• ID 419186 - High DPI: Dragging windows between screens with different resolutions occasionally scales the size of the window content, but not the window itself.

• ID 419183 - High DPI: Panel extend icons are not drawn correctly.

• ID 418778 - Read/Write: MJPEG A and B are currently written with incorrect Matrix settings.

• ID 418433 - High DPI: Some panel borders exhibit artifacts or discoloration.

• ID 418315 - High DPI: The UI is rendered incorrectly when waking the computer from sleep.
As a workaround, click anywhere in the UI to redraw the interface.

• ID 418027 - Windows only: The right-click menu in the Curve Editor sometimes scales to the wrong size.

• ID 417583 - C_DisparityGenerator: Processing is slower in CUDA than in OpenCL.

• ID 417418 - MXF DNxHR: Exporting files with the OP Atom and reading the files back into Nuke does not display the Tape ID metadata. In Avid, the Tape ID metadata is read correctly.

• ID 417408 - High DPI: The Preferences window doesn't scale correctly on non-4K monitors when they are set as the primary.

• ID 417100 - Windows only: Using the ! operator on an integer image in Blink causes Nuke to crash due to a call to an unimplemented virtual function.
As a workaround, add .x on the end of !p_conditions(). This avoids ! being unimplemented for int<1> on Windows.

• ID 416659 - Windows only: Disconnecting a Shuffle input and then swapping the Input Layers occasionally causes Nuke to crash.

• ID 416571 - High DPI: Pane edges are displayed with pixel artifacts in larger tabs.

• ID 416388 - High DPI: An extra line is displayed at the end of the progress bar on the Tracker node.

• ID 416134 - High DPI: The contents of a floating window don't fit properly when moved from a non-4K monitor to a 4K monitor.
As a workaround, re-scale the floating window to pop the view back into the right place.

• ID 415836 - High DPI: Properties containing a graph widget are not displaying correctly when moved to a non-4K screen.

• ID 415673 - High DPI: When the file browser is dragged to a non-4K monitor, multiple versions of the icons appear.

• ID 412221 - Backdrop: The border on Backdrop nodes in the Node Graph does not scale at different zoom levels.

• ID 412218 - Backdrop: The border on Backdrop nodes in the Node Graph appears uneven at certain zoom levels.

• ID 412116 - Windows only: The audio build of Nuke plays multi-channel audio at lower audible levels on Windows 10 when using SoundBlaster PCI card or a generic USB interface.

• ID 411468 - macOS only: Exporting Apple ProRes 444 .mov files displays irrelevant errors on completion.

• ID 410556 - High DPI: The Multiple Views (V) icon on track items is no longer transparent.

• ID 406686 - Linux only: Switching from 4K to a non-4K screen can cause the UI to display incorrectly.

• ID 404708 - High DPI: Moving floating panels between monitors does not work as expected if scaling is not set to 100%.

• ID 399226 - High DPI: The color swatches in the Preferences are not aligned with the text.

• ID 388445 - Linux only: Resetting the Workspace on a 4K monitor sends the workspace to the main monitor. If it's not a 4K monitor, the scale doesn't reset and context menus are not in the correct place.
As a workaround, right-click anywhere in the UI to correct the scaling.

• ID 388422 - High DPI: Bin items keep their orange highlighting after being deselected.

• ID 384455 - Windows only: Resetting a workspace and then moving it to 4K monitor causes some panels to overlap.

• ID 384433 - High DPI: After resizing the Viewer, artifacts appear above and below the Viewer controls.

Developer Notes

Here are the changes relevant to developers. See Help > Documentation from the Nuke menu bar or https://learn.foundry.com/nuke/developers/121/ndkdevguide/appendixc/index.html for more information.

As Nuke develops, we sometimes have to make changes to the application programming interface (API) and application binary interface (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	Example	Compatibility	Recompile	Rewrite
Version	11.2v1 to 11.2v2	API and ABI
Point	11.1v1 to 11.2v1	API
Major	11.0v1 to 12.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")

New Features

There are no new features in this release.

Feature Enhancements

There are no feature enhancements in this release.

Bug Fixes

• ID 303603 - Windows only: Calling nuke.executeInMainThreadWithResult() in the Script Editor displayed a SystemError: "error return without exception set" message.

• ID 402548 - NDK: Mouse-over events called deepEngine() unnecessarily.

• ID 405270 - Python: Moving a soft effect to a different frame Pythonically marked the effect as invalid.

• ID 410467 - Python: PyScript_Knob keyword arguments were not called correctly within the function.

• ID 420676 - Python: The KnobChanged callback did not update Colorspace knobs correctly.

• ID 425392 - NDK: OpenColorIO 1.1.1 in Nuke 12.0 leaked symbols from a statically linked library.

• ID 430081 - BlinkScript: Using the normalize() function in a Blinkscript kernel displayed an Error compiling kernel: Error compiling kernel for GPU error.

• ID 431332 - NDK: libstudio.so exported boost_python symbols incorrectly.

• ID 431656 - Python: Moving a soft effect to a different frame Pythonically caused Nuke Studio to crash.

• ID 431761 - BlinkScript: The cross() function did not iterate correctly.