Search Tips

Search is based on keyword.

`Ex: "Procedures"`

Do not search with natural language

`Ex: "How do I write a new procedure?"`

Give Feedback Support Portal

# Release Notes for Nuke and Hiero 11.1v1

# Release Date

07 December 2017

# Qualified Operating Systems

• macOS Sierra (10.12) or macOS High Sierra (10.13)

• Windows 7 or Windows 10 (64-bit)

• CentOS 6 or CentOS 7 (64-bit)

Note: If you intend to use floating licenses with Hiero 11.1, you'll need to upgrade the version of RLM used in the Foundry Licensing Tools (FLT) on your server. See Foundry Knowledge Base article Q100320 for information.

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 2.0 (Fermi) or above. A list of the compute capabilities of NVIDIA GPUs is available at www.nvidia.co.uk/object/cuda_gpus_uk.html.

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 8.0 & 6.5 or above.

• On Windows and Linux, CUDA graphics drivers are bundled with the regular drivers for your NVIDIA GPU. Driver version r361 or above is required.

Go to http://www.nvidia.com/Download/Find.aspx?lang=en-us for more information.

• On Mac, the CUDA driver is separate from the NVIDIA graphics driver and must be installed, if you don't have it already. The minimum requirement is driver version r361 which can be downloaded from www.nvidia.com/drivers.

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

#### AMD

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

Windows GPU | Driver | Linux GPU | Driver
--- | --- | --- | ---
AMD FirePro W8100 | 17.Q2.1 | AMD FirePro W8100 | 17.Q2.1
AMD FirePro W9100 | 17.Q2.1 | AMD FirePro W9100 | 17.Q2.1
AMD Radeon R9 Fury X | 17.4.3 - 17.6.2 | AMD Radeon R9 Fury X | 17.10
AMD Radeon RX 480 | 17.Q2.1 | AMD Radeon RX 480 | 17.Q2.1
AMD Radeon Pro WX 7100 | 17.4.3 - 17.6.2 | AMD Radeon Pro WX 7100 | 17.10

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

• On Mac an AMD FirePro GPU on late 2013 Mac Pro 6,1, mid 2015 MacBook Pro 11,5, and late 2016 MacBook Pro 13,3, running OS X 10.9.3 'Mavericks', or later.

#### 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 FirePro W9100s.

# New Features

### Localization Improvements

Nuke and Nuke Studio's file localization feature has been improved. The Preferences > Performance > Localization menu has been updated, offering a new manual mode as well as color codes to indicate the state of localized Read nodes and source clips.

The new manual localization mode does not localize any files automatically, but checks in the background for updates to the source files, notifying you if they become outdated. When the localization policy is set to on demand or on you can update outdated Read nodes and source clips by clicking the Update button in the Properties panel.

The improvements also include a new pause localization on script/project load preference. When enabled, no new localization takes place when you load a script or project, which can speed-up load times.

### Timeline Read Nodes

You can now double-click Nuke Studio source clips and shots on the timeline to open Read node-like Properties panels. Timeline Read nodes contain a subset of the full Read node controls, including file path, localization policy, and colorspace. For specialized Reads, like R3D and ARRIRAW, additional controls are available, just like in the Node Graph.

In addition, source clip properties are accessible through the same Python API as Nuke, improving scripting capabilities and integration into existing pipelines.

### Visual Diagnostics

Nuke can now display accurate script profile data onscreen or output it to .csv or .xml file to help you troubleshoot bottlenecks in slow scripts. When visual diagnostics are calculating, timing information is displayed in the Node Graph, and the nodes themselves are colored according to the proportion of the total processing time spent in each one. The data is then displayed in the Profile tab as a bar or pie chart, timeline, or as a table.

# Feature Enhancements

• ID 143908 - Expressions: A new Performance > Expressions > Mode preference has been added, controlling how expressions in the Node Graph are evaluated. After an initial evaluation on all expressions to find dependencies, the default mode, Lazy, only re-evaluates expressions when needed. This can help with UI performance in some circumstances.

If you require constant expression evaluation, set the Mode to Always, which causes Hiero to behave as in previous releases.

• ID 169843 - BlinkScript: An error message is now printed in the Viewer, as well as in the initial error dialog, providing more information about compilation errors.

• ID 173220 - The BlinkScript node and soft effect now support float3x3 and float4x4 matrix constructors.

# Bug Fixes

• ID 132111 - Crop: Linked expressions within the box controls didn't evaluate the expressions correctly.

• ID 145446 - Using a custom viewerProcess displayed a Bad value for colorspace error.

• ID 150512 - Writing files on a render farm ignored the render_order option, resulting in Can't rename .tmp to final, File exists errors.

• ID 157428 - Opening a script with an invalid viewerProcess displayed a RuntimeError.

• ID 160138 - Mirror: Adding a Mirror node to a script cropped the bounding box to the visible format, discarding overscan.

• ID 161753 - Custom viewerProcesses were not ignored in terminal mode.

• ID 163781 - Nuke Assist: TimeOffset nodes did not work as expected until the script was saved.

• ID 169841 - Soft Effects: The BlinkScript effect did not accept parameter names containing a leading underscore.

• ID 171095 - BlinkScript: Compilation error messages were not dismissed from the Viewer when the error was addressed.

• ID 195996 - Read: Nuke Studio always read H264 encoded source clips using the mov64 reader.

• ID 199229 - Timeline Editing: Scrubbing the playhead in sequences containing audio tracks was slow to respond.

• ID 199893 - CornerPin: Expression linking controls using Tcl did not work as expected.

• ID 216806 - The public DD::Image interface for the OCIOColorSpace node could not initialize certain values and occasionally caused Hiero to crash.

• ID 221017 - Opening a script with a missing viewerProcess LUT from the terminal did not work as expected.

• ID 227320 - Windows only: Increasing the motionblur value in Transform nodes caused Hiero to become unresponsive on machines with high thread counts.

• ID 228773 - Localization: Reads did not fall back to the source files when the localized files were deleted.

• ID 238700 - OFlow: Loading certain scripts containing OFlow nodes exported from Nuke Studio caused Nuke to crash.

• ID 238873 - Deep: Viewing the depth channel in a customer script caused Hiero to crash.

• ID 246196 - Deep: Processing Deep nodes was occasionally slower on NVIDIA Quadro series GPUs.

• ID 246227 - Reading certain large resolution images at certain zoom levels caused Hiero to crash.

• ID 253077 - macOS only: Localization did not work as expected when using Preferences > General > path substitutions.

• ID 253451 - Monitor Output: 10-bit output from Blackmagic 4K Extreme 12G cards was not supported outside the SMPTE-range due to limitations in the current Blackmagic drivers.

• ID 266300 - Create Comp: Exporting multiple shots to the same comp didn't use the correct start frame.

• ID 266423 - Timeline Editing: Playing back audio in a source Viewer placed the playhead well outside the audio's timecode.

• ID 270623 - Deep: Writing Deep .exr files with LensDistortion rendered files containing scanline errors when read back in.

• ID 271069 - Node trees containing multiple Transform nodes calculating motionblur and expressions caused Hiero to become unresponsive.

• ID 272435 - Windows only: Setting a Comp Disk Caching > temp directory in the Preferences caused Hiero to become unresponsive.

• ID 273671 - Documentation: The Documentation > Release Notes link from Nuke's menu bar pointed to the wrong URL.

• ID 274184 - Hiero's version number was incorrect in the command line.

• ID 275417 - Create Comp: Exporting a single comp containing multiple clips ignored any Custom frame range values.

• ID 275698 - macOS only: Adjusting the analysis area in a Denoise node caused Hiero to crash.

• ID 275718 - Deep: Rendering a DeepWrite that referenced a DeepRead with no file specified caused Hiero to crash.

• ID 278036 - Localization: The Cache > Localization > Force Update > Selected menu option did not work as expected.

• ID 278678 - Documentation: It was not clear in the documentation that the Camera node's near clipping plane must be set to a positive value to produce sensible results.

• ID 279107 - Denoise: Setting temporal processing to ≥ 4 displayed CUDA errors.

• ID 279446 - LensDistortion: The 3DE Radial Fisheye preset produced splatting artifacts in Undistort mode.

• ID 286596 - OCIO: Setting Project Settings > OCIO config to aces_1.0.1 reset the Viewer LUT.

• ID 304710 - Linux only: Analyzing and tracking in PointCloudGenerator displayed a blank Progress dialog over the top of the working Progress dialog.

• ID 304723 - Export: The Version token number field in Nuke Studio did not accepted 00 as a version number.

• ID 306164 - BlinkScript: The Rolling Kernel example in the documentation did not work as expected.

• ID 306252 - Documentation: The ? help button for the VectorToMotion node pointed to the wrong URL.

• ID 306303 - Export: The all tracks option in Nuke Studio's Export dialog included disabled tracks in the output.

• ID 306614 - Channels in .exr files, other than the RGBA channel set, appeared opaque rather than premultiplied.

• ID 308133 - Workspaces: Double-clicking on a comp container occasionally opened the Node Graph as a floating window.

• ID 310034 - LiveGroups: Clicking Reload in the Properties of a LiveGroup containing User knobs returned unlinked knobs to the default value.

• ID 310292 - Switching shot version in the timeline using the Alt+up or down keyboard shortcuts only worked once.

• ID 310512 - macOS only: Dock icons were occasionally grayed-out after closing and reopening the application.

• ID 310594 - Deep: The DeepToPoints node did not generate a point cloud correctly when a Camera was connected.

• ID 312397 - Wiping between two images with Use GPU for viewer when possible enabled in the Preferences, stopped the Viewer gain and gamma controls having any effect.

• ID 312552 - macOS only: Opening .wav files in the Timeline View displayed a red square overlay.

• ID 312944 - Clamp: Adjusting the minimum control clamped to incorrect values.

• ID 312983 - Linux only: Canceling and restarting a CameraTracker progress dialog created multiple blank progress dialogs.

• ID 315478 - Windows only: The Clamp node did not clamp negative values to 0.

• ID 315660 - Soft Effects: Keyframes were not updating correctly in Transform effects imported from Premiere .xml timelines.

• ID 316429 - Analytics: Agreeing to submit usage statistics printed user information in the terminal.

• ID 316775 - PlanarTracker: Selecting a CornerPin2D track type in the control above the Viewer caused Hiero to crash.

• ID 316797/321837 - Hiero and Nuke Studio printed multiple Qt errors in the terminal during normal operation, such as QPainter and QOpenGLContext.

• ID 317082 - Timeline Disk Caching: The invalid cache warning displayed even when the database was empty.

• ID 318107 - Timeline Editing: Muting an audio track caused pointer moves to scroll up and down in the timeline.

• ID 320055 - Audio: Adding certain .mp4 encoded source clips to a sequence did not playback audio correctly.

• ID 321018 - Export: Transcoding to the .tga format with the Channels control set to all did not work as expected.

• ID 321222 - Undo: Changing a control's value multiple times and then undoing reverted the control to its first value, ignoring the intermediate values.

• ID 321929 - Expressions: Hiero reported errors for expressions that didn't exist, rather than warnings, causing renders to exit with a return code of 1.

• ID 322214 - Transform: Adjusting the shutter control with motionblur enabled inverted any rotation values.

• ID 323369 - Localization: Loading a customer script caused Hiero to crash.

# New Known Issues Specific to this Release

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

## New Known Issues Specific to Nuke

• ID 322487 - LiveGroups: Clicking Open in a LiveGroup's Properties panel does not work as expected with the [python {nuke.script_directory()}] relative path expression in the file control.

• ID 316577 - macOS only: Current localization progress does not update if the pointer focus is on Hiero's menu bar.

• ID 312350 - Visual Diagnostics: The Profile tab occasionally flickers when the application window is maximized.

• ID 309417 - Documentation: The Python Developers Guide incorrectly references the outdated PySide and PyQt4 modules.

• ID 309259 - Documentation: The Python Developers Guide incorrectly references Qt 4.8.5 source code.

For links to the correct source files, see the Nuke Developers page under Nuke Qt binaries and source files: https://www.foundry.com/products/nuke/developers

• ID 277875 - VFX Platform: Switching workspace occasionally draws the new workspace incorrectly.

• ID 154977 - Deep: The DeepColorCorrect node culls Deep samples incorrectly.

## New Known Issues Specific to Nuke Studio and Hiero

• ID 323777 - Timeline Editing: Playing back audio-only files stops the Viewer refreshing correctly.

• ID 323322 - Timeline Disk Cache: Opening or closing a soft effect's Properties panel temporarily clears cached frames within the extent of the effect.

• ID 323132 - Timeline Read Nodes: Clicking rescan in the Properties panel does not work as expected for certain split sequences.

• ID 322687 - Clicking rescan in the Properties panel makes undoing changes to the original range controls unreliable.

• ID 322584 - The playhead does not move as expected during playback of audio files opened in the Timeline View.

• ID 314088 - Windows only: The first frame of localized files in the outdated state, colored red, do not always update correctly.

• ID 313849 - Localization: Reading certain multiview .exr files causes Hiero to crash.

As a workaround, rename or move your .nuke folder and re-launch Hiero to refresh the uistate.ini file.

• ID 313013 - Timeline Read Nodes: Opening the Node Graph from the Project bin and then returning to the timeline environment behaves as if the left mouse button is held down.

As a workaround, left-click in the timeline to cancel the mouse press.

• ID 310067 - Timeline Read Nodes: Loading large projects is currently slower than expected.

# Other Known Issues

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

## Known Issues Specific to Nuke

#### AudioRead

• ID 18924 - Changes to the rate control value are not honored when ratesource is toggled between file and custom.

• ID 18666 - Changing the sample rate has no effect on playback in a Flipbook.

• ID 18465 - The time range control doesn’t limit the range when an endtime is specified.

• ID 18451 - Flipbooking doesn't honor the time range knob.

• ID 18217 - Redo keyframe generation doesn't replace the keys.

• ID 18213 - Changing Draw Style in the Curve Editor or Dope Sheet doesn't redraw the curves correctly.

#### BlinkScript/CUDA

• ID 43319 - CUDA: Scripts containing GPU accelerated nodes, such as ZDefocus, display a CUDA error when the OS wakes up from sleep mode.

As a workaround, close and reopen Hiero to reactivate the CUDA drivers.

#### CameraTracker

• ID 40798 - Centering a track in the Viewer does not work as expected in proxy or downrez modes.

• ID 37411 - Sequences containing alpha channels display the alpha premultiplied by the image in reference thumbnails, rather than just the RGB values.

#### Deep

• ID 43383 - Executing a script in command-line mode that reads in a deep image and then writes it to disk, causes Nuke to crash.

As a workaround, run the script from the Script Editor inside Hiero.

• ID 40145 - Hiero occasionally reads and writes Deep .exr files with a pixel aspect ratio of 1.

As a workaround, preview the .exr in the file browser before reading it into Hiero.

#### Dope Sheet

• ID 43463 - Scripts containing Ocula's O_VerticalAligner plug-in cause Hiero to crash when you execute Analyze Sequence with the Dope Sheet open.

• ID 40206 - Adding a curve to the Dope Sheet and then deleting it causes Hiero to crash.

• ID 39426 - Undoing individually animated text characters removes their keys completely from the Dope Sheet.

• ID 39156 - Keys remapped with descending TimeWarp lookup curves don't snap to frames when frame snap is enabled.

• ID 38910 - Keys from Viewer buffers not currently being viewed are still visible.

• ID 38630 - Read and TimeClip representations disappear in the Dope Sheet if they are set to have a non-empty frame expression.

• ID 37869 - The Dope Sheet is not updated correctly when a Retime's speed control is animated.

• ID 37815 - Multiple instances of the same clip within one AppendClip are only represented once in the Dope Sheet.

#### EditGeo

• ID 38954 - The transform handle of selections in the Viewer is not updated between frames on geometry with animation baked into its vertices.

To update the transform handle, toggle the axis alignment control between object and average normal.

• ID 38699 - Changing the visibility of objects within an Alembic Scene Graph causes geometry to ignore the EditGeo node.

• ID 38670 - Setting a keyframe can be slow to update the Viewer with the appropriate keyframe marker.

• ID 36094 - Setting axis alignment to average normal displays the axis incorrectly on edge and corner vertices.

#### Flipbook

• ID 271435 - Flipbook: Using the flipbook with nuBridge installed causes Hiero to crash.

• ID 201156 - Hiero's flipbook defaults to the Write node's colorspace, which can result in different output when compared to the Viewer.

As a workaround, either flipbook the node upstream of the Write node, or enable Burn in the LUT in the Flipbook dialog.

• ID 47005 - In the Flipbook Viewer, clicking the Go to start button always goes to frame 0, even if the clip doesn't start at 0.

• ID 47005 - Enabling Burn in the LUT in the Flipbook dialog uses the rec709 LUT for both rec709 and rec1886.

#### Frame Server

• ID 273472 - Canceling or pausing a comp render in the Background Renders panel displays errors in the terminal.

• ID 272523 - Non-contiguous frame ranges cannot currently be flipbooked.

#### GPU

• ID 45018 - R3D: Only half float linear gamma space works with GPU debayering.

#### Import Nuke

• ID 40131 - Importing Nuke in a Python script destroys sys.argv, making command-line arguments unavailable.

As a workaround, preserve sys.argv in another variable before you import Nuke.

• ID 39836 - Importing Nuke hangs when there are Qt conflicts between Nuke and other applications.

• ID 38963 - Calling import nuke terminates the Python session if no applicable license is available.

#### Linux Only

• ID 271807 - Linux only: Adjusting pane or window borders left and right causes redraw lag.

• ID 270776 - Linux only: QWebEngine is currently missing from the Qt 5.6.1 build.

• ID 199990 - In some situations NVIDIA Quadro Linux drivers 319.23 can cause Hiero to hang during start up.

As a workaround, update your drivers to 361.42.

• ID 49262 - Scrubbing in the timeline in large projects can force memory use to hit 100%, causing Hiero to become unresponsive.

• ID 43766 - Calling uuid.uuid4() causes Hiero to crash due to a bug in libc.

As a workaround, launch Hiero from the command-line using:

LD_PRELOAD=/lib64/libuuid.so.1 ./Nuke8.0

• ID 42581 - Keyboard Shortcuts: Using Ctrl+C to quit Hiero from the command-line when a dialog box is open displays an error.

• ID 39537 - Using a Blackmagic Decklink Extreme 2 card causes Nuke to become unresponsive.

#### LiveGroups

• ID 274174 - Reloading a LiveGroup currently resets all edited User knobs.

• ID 272281 - Adding a user knob and then undoing the action sets expression links to nodes with matching names in main Node Graph.

#### Mac OS X Only

• Installation - If you're running Mac OS X 10.10 "Yosemite", you may need to install alternative NVIDIA CUDA drivers so that Hiero can detect your GPU correctly. You can obtain the required drivers directly from NVIDIA here:

http://www.nvidia.com/object/macosx-cuda-6.5.18-driver.html.

• ID 228076 - The PySide QtUiTools library is currently missing from the Nuke build.

• ID 163543 - Mac OS X 10.11 only: Dragging handles in the 3D Comp Viewer can be slow to respond.

• ID 50371 - Script corruption can occasionally occur on Mac OS X 10.9 (Mavericks), and above, when writing to SMB 2.1 and SMB 3 Sharepoint locations.

• ID 50182 - Nuke cannot be launched from the Finder if it has already been launched from the Terminal.

• ID 43343 - Modifying the label of a Python user knob causes Hiero to crash.

• ID 39429 - Crash Reporting: The 'save to' dialog is hidden behind the crash report dialog when you click Save Report.

• ID 38686 - Enabling Use GPU if available on supported nodes, such as Kronos, in more than one instance of Nuke at the same time, can cause display corruption and/or entire system freezes. This seems particularly likely to occur on GPUs with low amounts of RAM, such as the GeForce GT 650M.

As a workaround, upgrade your NVIDIA drivers, or if this is not possible, only enable GPU acceleration in one instance of Nuke at a time.

• ID 35123 - PrmanRender: If you're using Mac OS X 10.8 (Mountain Lion) or above, make sure X11 is installed on your system. Unlike previous versions of OS X, 10.8 and above do not have X11 installed by default.

For more information, see http://support.apple.com/kb/HT5293.

• ID 34697 - Launching Nuke from a network shared drive causes Nuke to crash on launch.

As a workaround, either:

• tarball the installation from Mac OS X and unzip it on the alternate file system (using NFS or Samba, depending on source), or

• using the command-line, copy the installation from Mac OS X to the network location using the same file system as the destination.

• ID 33970 - Using a node, such as Grade, as a custom viewer process outputs a blank Viewer.

As a workaround, adjust the Viewer gain control to refresh the Viewer.

• ID 22062 - Nuke doesn't currently give the option to restore the autosave of an unsaved script, except when Nuke is run from the command-line.

• ID 13638 - The following graphics cards are not currently supported for Mac:

• ATI Radeon X1600

• ATI Radeon X1900

Users with these cards are able to render from the command-line, but in GUI sessions, the Node Graph renders incorrectly due to a requirement of OpenGL 2 drivers.

• ID 12048 - Nuke crashes if you activate screen sharing when there is no screen plugged in.

• ID 11776 - Node text appears aliased, unclear, or garbled at certain zoom levels.

#### ModelBuilder

• ID 41352 - Setting the segments control to a negative number causes Hiero to crash.

• ID 41148 - Editing geometry UVs and then switching the Viewer to look at the geometry through a ScanlineRender node causes Hiero to crash.

#### Monitor Out

• ID 250107 - Monitor Output: 10-bit output from Blackmagic DeckLink HD Extreme 3D+ cards at the extents of color ranges is incorrect.

As a workaround, using the Desktop Video Setup utility, ensure that the SDI Settings 4:4:4 RGB checkbox is enabled and the SDI Configuration is set to Single Link.

• ID 40942 - AJA Io Express: Enabling monitor output causes Hiero to crash.

• ID 37700 - AJA Kona LHe+ 2k formats are not displayed correctly.

#### OCIO

• ID 201193 - Read node Metadata tabs occasionally include irrelevant in and out colorspace controls.

#### Particles

• ID 41259 - ParticleCache: Setting emit from > points and connecting the emit input to geometry, does not render all frames to the .nkpc file.

• ID 39796 - ParticleCache nodes upstream of ScanlineRender nodes display ParticleCache is out-of-date errors for negative frame numbers.

• ID 39210 - ParticleCache: Error messages displayed when read from file is toggled on and off are not reliably cleared when rendering through ScanlineRender.

• ID 37254 - The progress bar does not cancel if you scrub to a frame that has already been calculated within the particle system.

• ID 18268 - Enabling color from texture always renders a solid white alpha for the texture.

• ID 17520 - Geometry representation textures are displayed even when display is set to off.

• ID 17243 - Using sprites instead of geometry representations causes particles to render behind the 3D grid lines.

#### Pixel Analyzer and Scopes

• ID 44176 - PixelAnalyzer: The full frame sampling mode doesn't work immediately in the timeline Viewer when the analyzer is initially added to the layout.

• ID 39180 - Scopes: Switching to a layout with a scope window, while rendering, forces the Viewer bounding box to 1x1 for that frame.

• ID 36508 - Scopes do not currently update when zooming into the Viewer.

• ID 36491 - Scopes clip color values between 0 and 1 when Preferences > Scopes > Include viewer color transforms is enabled.

#### PrmanRender

• In the Nuke camera, the window roll control is not yet mapped to RenderMan.

• ID 27648 - After a security update for Mac OS X, Nuke is unable to load the PrmanRender plug-in the environment.plist file when in GUI mode.

See http://support.apple.com/kb/TS4267 for more information.

#### Python

• ID 271373 - A QOpenGLContext::swapBuffers() called with non-exposed window, behavior is undefined error is occasionally printed on the command line.

• ID 44296 - Running nuke.scriptOpen() at the same time as creating a Python panel causes Hiero to crash.

• ID 40994 - Rendering an Alembic camera using a Python script produces incorrect values when run from the command-line.

Run the script from Hiero's Script Editor to avoid this issue.

• ID 40645 - Using setInput() within an onCreateCallback doesn't work as expected.

• ID 40534 - Using Python to set metadata in ModifyMetadata nodes does not work from the command-line.

To work around this issue, run the Python script from Hiero's Script Editor.

• ID 39308 - Accessing a node's x and y positions using the xpos and ypos controls reports incorrect values.

As a workaround, either call nuke.Node.xpos() or nuke.Node.ypos() first, or ensure no nodes are currently selected in the Node Graph.

• ID 38994 - nuke.Node.screenWidth() and screenHeight() are incorrect when a node is first created if it has an autolabel.

• ID 8063 - Creating many new nodes with nuke.createNode() and the in-panel argument at default (True) may crash when too many node control panels are created too quickly. The workaround is to pass the in-panel argument as False or else use nuke.nodes.NodeClass() (where NodeClass is the type of node to create) to create the node and then connect it to the currently selected node manually.

• ID 6455 - You should not call the Python command nuke.restoreWindowLayout() from the Script Editor as that can cause Nuke to crash. Instead, you can use the same command from your menu.py, restore layouts by selecting Layout > Restore Layout, or use a custom menu or toolbar item.

• Nuke sometimes reports errors in Groups and Gizmos, appearing similar to the following:

groupName.NodeName.knobname: unexpected 'k' in '0.knobname'

The problem is most likely that there is an expression using the input TCL command and doesn't validate that there is an input connected. An example expression:

[input parent 0].translate.x

The input command returns 0 when it can't find the requested input, which generates an expression of '0.knobname' that doesn't refer to anything. The fix is to restructure the expression to use the value TCL command and specify a default value to return in the case that the expression is invalid. It takes the form:

[value [input parent inputnumber].knob defaultValue]

Here is the modified example:

[value [input parent 0].translate.x 0]

The modified example returns 0 in the event that there is no input 0, and no longer results in an error message.

• There is a Python syntax conflict when assigning knob names on the fly with nuke.nodes.<node>() if the knob is called 'in'.

For example, this gives a syntax error:

nuke.nodes.Shuffle(in = 'depth')

while this works because 'in' is a string here and not a keyword:

sh = nuke.nodes.Shuffle()

sh['in'].setValue('depth')

#### RayRender

• ID 230256 - Soft Shadows are not currently supported.

• ID 197294 - Reflection occlusion is not currently supported.

• ID 196980 - Clipped alpha shadows are not currently supported.

• ID 196776 - Multiple bounce reflecton is not currently supported.

• ID 196124 - RayRender does not currently support refraction.

• ID 195051 - The Wireframe shader node, located in 3D > Shader > Wireframe, is not supported by RayRender.

• ID 195004 - Custom lens shaders/projection modes are not currently supported.

• ID 194819 - RayRender does not currently support Deep workflows.

• ID 191108 - Particle sprites are not currently supported.

• ID 174849 - The Displacement shader node, located in 3D > Shader, is not currently supported by RayRender.

#### Read and Write

• ID 50046 - The default colorspace values when writing using .mov codecs differ in command-line and GUI modes.

• ID 48935 - MXF: Importing a certain JPEG2000 file causes Hiero to crash or display the file incorrectly.

• ID 47256 - MXF: Super whites are currently displayed as white in the Timeline Viewer.

• ID 47248 - MXF: Setting debayer quality to High Quality on some Sony RAW files displays an error decoding frame message in the Comp Viewer.

• ID 42717 - Certain .exr files rendered from Modo display the alpha channel rather than the rgba channels by default.

• ID 41006 - The last audio frame of a QuickTime encoded with AAC compression is muted.

• ID 40684 - Rendering certain h264 encoded .mp4 files using the mov32 encoder results in color shifts using QuickTime 10.3 codecs.

• ID 40533 - There are slight differences in color and sharpness when rendering Alexa footage to ProRes 4444.

• ID 40074 - Writing out stereo .sxr files with additional channels does not write out both eyes correctly.

• ID 39165 - ReadGeo: When reading in .fbx files, the transform/scale state can become incorrect while toggling the read transform from file in combination with all objects and/or read on each frame.

• ID 35611 - Writing .exrs with the Write node's interleave control set to channels adds a superfluous main view.

• ID 33863 - FBX geometry: Faces on geometry read in from .fbx files are not connected to neighboring faces, leaving gaps in certain circumstances.

This issue is particularly visible when using the EditGeo node, which should not allow you to remove faces from the geometry.

• ID 31424 - Sub-sampling in .exr files is not currently supported.

• ID 27211 - Alembic: The state of the Viewer Lock Frame control is not always honored for .abc files.

As a workaround, ensure that ReadGeo > read on each frame is enabled.

• ID 21663 - Read: After reading in a stereo/multiview .exr file and choosing not to add new views to the project, subsequent reads of any stereo/multiview .exr files won’t give the option to add new views.

• If you have trouble with FBX files, it may be because they were written with an older version of FBX. If they load very slowly, it is also possible that they are ASCII rather than binary. To get around these problems, you can use the FBX converter on the Autodesk website. It converts between various different formats, including older FBX versions, ASCII, and binary, and is available on Windows, Mac OS X, and Linux.

To download the FBX converter:

1. Go to http://usa.autodesk.com/adsk/servlet/pc/item?siteID=123112&id=10775855.

2. Scroll down to FBX Converter and click on one of the links to start the download.

#### Render codecs

Rendering with certain codecs occasionally causes Nuke to crash. Due to this, we recommend the following:

• If you're using the Sorensen Video codec, it's recommended you use the Sorensen Video 3 codec instead. If you're unable to switch to Sorensen Video 3, try using a format smaller than 2K for better performance.

• If you're experiencing crashes with Cineform HD, try updating your Cineform codec to version 5 or above. You may need to download the Neoplayer at http://estore.cineform.com/neoplayer.aspx.

• If you're using Avid Meridien, you should only write out in NTSC and PAL.

#### Roto/RotoPaint Open Splines

• ID 42997 - Rendering artifacts can occur if the feather control is used in conjunction with the feather handles in the Viewer.

• ID 42995 - Stereo: Adding an open spline creates the spline in the left view only by default.

As a workaround, select the shape and then manually change the Properties view control to include both views.

• ID 42991 - Python API: Moving points on an open spline using Python causes Hiero to crash.

• ID 42932 - Rendering artifacts can appear where the spline hull crosses over itself with negative feather values.

• ID 42422 - Rotating the tangent of an end point occasionally causes the hull to behave erratically.

• ID 42413 - Holding Ctrl/Cmd to move a point's tangent handles independently causes defects in the hull or feather.

• ID 42412 - Changing the Viewer overlay visibility, such as from always to never, occasionally produces artifacts in the spline's hull.

• ID 42390 - It is not possible to increase the width for individual points if the overall width is set to 0.

• ID 42387/42310 - Cusped points occasionally cause hull rendering artifacts.

• ID 40962 - Animated splines with varying width and feather occasionally contain slight rendering glitches inside the hull.

• ID 40433 - Roto Open Splines - Shape of hull/feather curve can look incorrect when width changes greatly from one point to the next

• ID 36219 - The Select Feather Points tool does not work consistently between the Open Spline and Bezier tools.

#### Other Roto/RotoPaint Bugs

• ID 41917 - RotoPaint shape colors don't change when expression linked to another RotoPaint color.

• ID 32459 - RotoPaint: Undoing a point move that created a keyframe doesn't currently undo the keyframe creation.

• ID 32450 - RotoPaint Stereo: Attempting to undo multiple split-control transforms on the same shape reverts the shape to its original position.

• ID 31552 - Point handles for paint strokes, whose lifetime doesn’t extend to the current frame, disappear when drag-selected.

As a workaround, select the shape in the curves list to re-display the points.

• ID 30920 - Expression linking extra matrices in the Transform tab doesn’t work as expected.

Note: This also applies to SplineWarp matrices.

• ID 30551 - Several levels of smoothing applied to one shape are carried over to subsequent shapes for a single smooth operation.

• ID 29170 - The cut, copy, and paste keyboard shortcuts don't work for entries in the curves list.

• ID 28838 - Gizmos from Nuke 6 containing Roto/RotoPaint nodes should be recreated in Nuke 8, but bear in mind that they won’t be backwards compatible with Nuke 6 once converted, unless you follow the instructions below:

Nuke 6 scripts containing Roto display a conversion prompt when you open them in Nuke 8:

• Click Save As to convert the script to the Nuke 8 Roto format, or

• Click Ignore to load the Nuke 6 format into Nuke 8. You might select this option if:

- You don't intend to make any changes, or

- You want to overwrite the file with a Nuke 7 and 8 only Roto format when saving.

If you want Nuke 8 scripts to load in Nuke 6, use the convertToNuke6 or convertDirectoryToNuke6 Python functions when running Nuke 8 in command-line only mode:

Note: The conversion functions cannot convert stereo-split curves as they are not supported by Nuke 6.

• To convert individual .nk scripts:

convertToNuke6(fromScript, toScript, overwrite = False)

• To convert all .nk scripts in a given directory:

convertDirectoryToNuke6(fromDir, toDir, matchPattern =.*\.nk, overwrite = False)

Note: The pattern is a regular expression.

An example single script conversion and rename to the same directory, from the command-line (or Terminal):

$ <NukeInstallDir>/Nuke8.0v1 -t

>>> import nuke.rotopaint

>>> nuke.rotopaint.convertToNuke6(/tmp/myRoto8.nk, /tmp/myRoto6.nk)

• ID 26855 - The undo and redo buttons in the Properties panel didn’t work as expected and have been disabled.

The workaround is to use the undo (Ctrl/Cmd+Z) and redo (Ctrl/Cmd+Y) keyboard shortcuts or the Edit menu instead.

• ID 21361 - Artifacts are produced until mouse up when painting over a stroke on another frame.

• ID 11524 - Adding strokes/shapes in RotoPaint is slow when there is another RotoPaint after it.

• ID 9238 - Painting on Mac OS X and Linux is slower when the paint cursor is near the edges of the screen.

• The foreground onion skin overlay updates as you paint, rather than only updating with the new stroke on pen up.

• It is not currently possible to clone RotoPaint nodes.

• Interactivity of laying down strokes/shapes in the Viewer may be faster when motion blur is disabled on the layer you are working in.

#### ScanlineRender

• ID 38329 - Deep renders from ScanlineRender currently ignore the ScanlineRender's bg input.

• ID 38205 - Deep: Depth, motion, position, and normals information is occasionally incorrect in semi transparent areas.

• ID 37967 - Deep: Geometry with alpha 0 renders black when the deep output is converted to an image.

#### SmartVector Toolset

• ID 275683 - SmartVector: Due to VFX Platform library changes, vectors generated by the Nuke 11 SmartVector toolset do not match legacy versions. For example, vectors generated by Nuke 11.0v1 do not match those generated by Nuke 10.5v4.

• ID 196455 - Rendering vectors after correcting the file control in the SmartVector node occasionally displays a spurious No such file or directory error.

As a workaround, scrub to a different frame to remove the message.

• ID 175605 - Entering a partial file path in the SmartVector file control and then clicking the file browser icon does not open the file browser.

As a workaround, click OK on the error message and then click the file browser icon again.

#### Text

• ID 48418 - Different operating systems handle the Shadows tab shrink/expand control differently, producing inconsistent output.

• ID 39556 - In text edit mode, it is not currently possible to edit text attributes when the Viewer overlay is disabled.

• ID 39552 - Transforming animation groups using an expression-linked Transform node does not work as expected.

As a workaround, expression link the translate x and y controls separately.

• ID 39291 - Splitting the transform control on the Group tab splits all controls.

• ID 39239 - Transforming a character generated from an expression, and then going to a frame where the character no longer exists, results in the transformation being lost.

• ID 39130 - Splitting the message field does not work as expected.

• ID 38789 - Viewer toolbar controls steal cursor focus.

• ID 38425 - The undo history becomes unreliable when the panel focus changes.

• ID 36372 - Selecting a TCL expression in the message field doesn't always select the result in the Viewer.

#### Tracker

• ID 40542 - After tracking and centering a track, the Viewer no longer caches when playing back the tracked frames.

As a workaround, you can enable full frame processing, though this may increase render times.

• ID 40038 - Ctrl/Cmd clicking in the Viewer to select a pixel and then adding a track, sets the tracking anchor coordinates to 0,0.

• ID 39225 - Moving tracking anchors is occasionally unresponsive and jerky.

• ID 39200 - Holding Shift and clicking tracks in the Viewer doesn't add to the current selection.

• ID 38356 - The zoom window occasionally doesn't update correctly when scrubbing between frames.

• ID 32359/32353 - Right-clicking on a point in the Viewer doesn’t always update the available Link to > Tracker linking dialog or Tracker options.

As a workaround, close and re-open the Roto/RotoPaint properties panel to update the Link to menu.

• ID 29382 - Tracking keyframes with different sized patterns doesn’t work as expected.

As a workaround, keyframe patterns should, where possible, be of comparable sizes.

#### VFX Platform

• You may experience issues when importing PySide modules into their Python scripts due to the migration from PySide 1.2.2 to PySide 2.0.

In some cases, you can just change calls to:

import Pyside.some_module

to:

try:

import Pyside.some_module

except:

import Pyside2.some_module

However, the definition of some classes has moved between modules in PySide 2.0. This particularly affects any Widget related classes, which have been moved from QtGui to QtWidgets, however there are other cases where this may be experienced.

If you experience any problems with this, please refer to the Qt 5.6.1 documentation, or contact support.foundry.com.

• ID 282593 - Switching to a fullscreen workspace on the primary monitor occasionally causes the secondary monitor to turn black.

• ID 280371 - Mac OS X/macOS only: OpenGL errors are printed on the command line when using an ATI Radeon 5770 GPU.

• ID 277548 - A QComboBox with a custom QCompleter currently emits incorrect signals.

• ID 275719 - Mac OS X/macOS only: The Help > About Hiero pop-up is positioned incorrectly on some machines.

• ID 275251 - Mac OS X/macOS only: Hovering over clip instances in the timeline does not change the pointer icon.

• ID 275246/270914 - The terminal or command line displays libpng warning: iCCP: cHRM chunk does not match sRGB on start-up.

• ID 274301 - Node toolbar menu items do not always deselect correctly.

• ID 274264 - CameraTracker results from Hiero 11.1 are not identical to previous versions of Hiero, though the differences are negligible.

• ID 272767 - Launching Nuke from the terminal with the -b argument has been deprecated as a result of library upgrades to comply with the VFX Platform 2017 requirements. There are two workarounds available on Mac and Linux :

• Run Nuke from the Terminal with & added to the launch command. This allows Hiero to run in the background and returns the command prompt, but closing the Terminal still causes Hiero to close. For example:

./Nuke11.1v1 --studio &

• Run Nuke from the Terminal using the nohup command. This allows Hiero to run in the background and returns the command prompt, but closing the Terminal does not cause Hiero to close. For example:

nohup ./Nuke11.1v1 --studio &

Tip: The nohup command prints output to /Users/<username>/nohup.out or /home/<username>/nohup.out by default, but you can specify a different file by appending > /filepath/filename to the command. For example:

nohup ./Nuke11.1v1 --studio & > /Users/<username>/nuke.out

• ID 272750 - The remove all panels button in the node Properties panel is displayed inconsistently.

• ID 272504 - The timeline Viewer in and out point previews are not working as expected when scrubbing.

• ID 272442/281108 - The Licensing dialog jitters when moved around the screen.

• ID 272338 - The Windows command prompt displays QWidget::paintEngine: Should no longer be called on launch.

• ID 272274 - Closing Nuke Studio does not remove the application icon from the task bar.

• ID 271632 - Hiero prints a libDeckLinkAPI.so error in the terminal on launch.

#### Warpers

• ID 32340 - SplineWarp: Using Ctrl/Cmd+drag to create rectangles and ellipses doesn't display an overlay until pen-up.

• ID 32083 - SplineWarp: Deleting all but one point on a curve resets its correspondence points to 0,0, which cannot be undone.

• ID 32082 - SplineWarp: Correspondence points are too sensitive when control points are removed.

• ID 32079 - SplineWarp: Moving correspondence points on curves with no keyframes cannot currently be undone.

• ID 30429 - SplineWarp: Transform links are not maintained when the source curve is moved to a new layer.

• ID 31322 - SplineWarp/GridWarp: Preview doesn't handle upstream transforms correctly.

• ID 20000 - GridWarp: When using cropped input, moving control points causes the Viewer to display the cropped image and the black area between the crop box and the format when merged over a background.

• ID 19995 - GridWarp: Locked source and destination grids still allow adding and removing grid lines.

• ID 19835 - SplineWarp/GridWarp: The Viewer LUT is incorrect in morph mode, when mix is set at an intermediate value.

• ID 19755 - SplineWarp: Placing correspondence points at each end of an open spline causes rendering problems.

• ID 19565 - GridWarp: The Viewer does not show the correct mix amount when in morph mode with mix set at an intermediate value.

• ID 19386 - GridWarp: All keyframes are removed from the Dope Sheet after undoing, rather than just the latest, and the keyframes remain on the timeline and in the properties.

• ID 19148 - SplineWarp: Rendering fails if a curve is reduced to a single point.

• ID 19079 - SplineWarp: The C keyboard shortcut does not currently select the Add Correspondence Point tool.

• ID 18712 - GridWarp: The timeline currently shows both source and destination keyframes, even if a grid is not visible in the Viewer.

• ID 18709 - GridWarp: Rotating the transform jack with both grids selected, but in different positions, does not undo as expected.

• ID 18342 - SplineWarp: The spline keyframe + button does not add keys to the Curve Editor or Dope Sheet.

• ID 18304 - GridWarp: Existing control point keyframes are not cleared when you draw a new grid using the Draw Boundary Viewer button.

• ID 18019 - GridWarp: You cannot select all grid points in the Curve Editor using Ctrl/Cmd+A shortcut.

• ID 18012 - GridWarp: The grid can flicker between white and gray when zooming in and out of the Viewer, particularly when the grid is subdivided.

• ID 17697 - GridWarp: In stereo mode, the right view is labeled as default when you split controls into separate views.

#### Windows Only

• Hiero Non-commercial: Navigating to Help > License, clicking Deactivate or Deauthorize, and then clicking Quit, causes Hiero Non-commercial to crash on exit.

As a workaround, change the mode a few times until it work as expected.

• ID 198430 - Hiero cannot read DNxHD .mxf files that have spaces in the file name.

• ID 46759 - File Browser: Location defaults (such as Home, Root, etc.) may not display if you have a previously saved FileChooser_Favorites.pref file in your ~/.nuke directory.

As a workaround, move or rename the FileChooser_Favorites.pref file, and re-launch Nuke.

• ID 40407 - When using a tablet, Hiero does not automatically switch to Eraser mode when you use the erase end of the pen.

• ID 39636 - QuickTime: The Blackmagic 10 bit (v210) codec defaults to the YCbCr 8-bit 422 (2vuy) pixel format due to a bug in the codec, resulting in solid green frames.

As a workaround, manually set the pixel format to b64a RGB to preserve image fidelity.

• ID 35800 - Scopes: The alpha channel doesn't update correctly when modified through a node, such as Primatte or Shuffle, even after the node is removed from the Node Graph.

• ID 28921 - Changing the 3D selection mode does not update until you click in the Viewer.

#### Miscellaneous

• ID 273462 - Licensing: Nuke cannot retrieve a license from the license server when the hostname contains .local.

• ID 272296 - Adding a user knob and then undoing the action doesn't remove the added knob.

• ID 271804 - Documentation: The node Properties panel ? link to the reference documentation doesn't work as expected.

• ID 271456 - UI: Some interface elements appear larger than usual when compared to previous versions of Hiero.

• ID 271256 - Denoise: Rendering frames to disk with a Temporal Frame Offset greater than 1 causes Hiero to crash.

• ID 271074 - PointCloudGenerator: Track Points does not work as expected when creating a point cloud from CameraTracker data.

• ID 228258 - Calling fromScript() on a knob that has not been added causes Hiero to crash.

• ID 226394 - Preferences: There are currently duplicate Script Editor controls under Other in the Preferences dialog.

• ID 169458 - Compositing Viewer: Setting the gamma control to 0 with Panels > Viewer (Comp) > use GPU for Viewer when possible enabled in the preferences, renders the alpha channel black.

• ID 168350 - AMD GPUs are reported as ATI GPUs in the node properties and --gpulist on the command line.

• ID 50715 - ZDefocus: Switching the filter type to image causes Hiero to crash in a customer script.

• ID 49803 - AJA Monitor Output: Setting the NUKE_AJA_CHANNEL environment variable to 4 when the NUKE_AJA_DUALOUTPUT environment variable is set, streams the output to SDI3, rather than SDI4.

• ID 49186 - ColorCorrect: Adding an expression to the curves on the Ranges tab and then changing a value, such as Gain, causes Hiero to crash.

• ID 46488 - Switching between certain workspaces displays black in the Viewer until the frame is changed.

• ID 46441 - ParticleBounce: Using custom geometry as the bounce object in a particle system occasionally allows particles to pass through the bounce surface.

• ID 42339 - The Modo Viewer control scheme (Preferences > Panels > Viewer Handles > 3D control type) does not work as expected.

• ID 42240 - Setting a channel with a non-standard name to use as the Viewer's alpha channel doesn't work as expected.

• ID 42159 - Nodes that use the Iop::sample() call to get input pixels, such as LensDistortion, perform poorly when they are downstream of nodes using PlanarIop, such as Denoise.

• ID 41450 - AppendClip forces upstream nodes to re-evaluate on every frame.

• ID 41411 - Loading a script from a disconnected network drive creates an empty script with the same name as the file path to the original.

Warning: If you save this empty script when the network drive is reconnected, the original is overwritten.

• ID 41122 - MatchGrade: Match Different Clip mode does not allow you to set keyframes on the Target for .mov clips with a frame range offset.

• ID 40617 - Some filter nodes, such as Erode (fast), are caching more slowly than in previous versions.

• ID 39459 - Virtual Sliders: Clicking the left-mouse button, while holding down the middle-mouse button, pastes values into the control.

• ID 39407 - Project3D: The node class name has changed to Project3D2. As a result, the Nuke<>Mari bridge won't work unless all instances of Project3D are renamed appropriately in the mari_bridge.py file.

• ID 39365 - The Viewer headlamp control can not currently be managed using expression links.

• ID 39287 - Plug-ins: Loading scripts with plug-ins compiled against older versions removes the nodes from the Node Graph.

• ID 39260 - Custom knobs on Groups and NoOp nodes cannot be retimed.

• ID 39122 - Switching the Viewer to wipe mode and wiping between inputs with different format sizes causes corruption and constant refreshing in the Viewer.

• ID 38713 - Capture: Roto opacity and feather settings are not included in captured images.

• ID 35661 - Capture: Capturing the Viewer with a custom file path saves the file path in the script, resulting in error when the path doesn't exist:

Flipbook render failed: viewerCaptureOp: Cannot write to specified path

• ID 35659 - Capture: Capturing a 3D scene containing lights produces Viewer flashes in the captured images.

• ID 32856 - PositionToPoints: Textures occasionally disappear during playback or when mousing over the Viewer.

• ID 32666 - FrameHold nodes have no effect on Deep nodes.

• ID 32628 - DeepToPoints: Command-line rendering appears to calculate renders even when render is set to off.

• ID 32497 - The R3D parameter labels in Nuke aren’t entirely consistent with REDCINE-X and Hiero.

• ID 32219 - DepthToPosition: Reading depth information from the same layer as the output layer produces corrupt output.

As a workaround, shuffle the depth information to an alternate layer.

• ID 32118 - Card3D: When motionblur is enabled in the properties, FrameHold and TimeOffset nodes are ignored when connected to the cam or axis inputs.

• ID 31803 - Using Shift+drag on a control’s animation icon only copies the value for the current frame, not the entire expression.

• ID 31714 - In the Viewer settings, enabling 3D > show_prim_bbox does not display individual bounding boxes for polymesh primitives.

• ID 31310 - TimeOffset: Checking reverse input doesn’t affect cameras, lights, or axes.

• ID 31238 - RAM cache: Any action that changes a frame’s hash value, it’s unique identifier, causes the cache to release. Actions such as adjusting the Viewer Gamma, Gain, or channels dropdown affect the frame hash.

• ID 30502 - Copying and pasting spline keys does not work as expected in the Dope Sheet.

Note: This known issue only applies to Roto and SplineWarp keys.

• ID 30256 - Script Editor: Flagging a control as invisible using setFlag() is not honored when the node is copy/pasted in the Node Graph.

• ID 30173 - Manipulating 3D handles in the 2D Viewer is unreliable.

• ID 29677 - Connecting a FrameHold node to an animated Camera and connecting both to a Scene node only displays the animated Camera in the Viewer. There should be two cameras: one static and one animated.

• ID 29083 - Using Create Camera in the 3D Viewer only sets position and rotation. The focal length of the new camera does not match that of the Viewer camera.

• ID 28291 - Nuke crashes on start up if the disk cache location set in the Preferences is no longer available.

• ID 20431 - CameraTracker: It’s not possible to pick colors in the Viewer with the control panel open.

• ID 20204 - Multitexturing: When Preferences > Viewers > Multiframe is enabled, increasing downrez in the Viewer toolbar can cause textures to flicker in the 3D Viewer.

You can switch back to Classic mode or avoid using proxy in 3D to workaround this issue.

• ID 19933 - ReadGeo: Geometry occasionally doesn't display as a solid until you click in the Viewer.

• ID 19185 - Attaching an FBX ReadGeo to the Viewer occasionally causes a slight graphical glitch in the Properties panel.

• ID 18649 - The transform jack is currently scaling incorrectly from the corner pivot point.

• ID 12505 - Motion Vector output has been improved, but still doesn't work properly because some large polygons are clipped by the front camera plane.

You can minimize this effect by increasing the geometry tessellation max parameter.

• ID 12424 - Ultimatte: Overlays are not updating correctly or reverting when panning or zooming.

• ID 11620 - In the 3D Viewer, there is currently a conflict between 3D geometry selection and points drawn with RotoPaint. This only occurs if you have two Viewers open, one in 2D mode and the other in 3D mode, and you have the panel for the RotoPaint visible.

• ID 9521 - Currently, the Nuke Viewer cannot cache very large plate sequences in float. The limit per frame is 50MB. If your frames are larger than this, you may need to switch to proxy mode for the caching to work.

• ID 5922 - At the moment, cloning does not work properly with all OFX nodes. This affects, but is not restricted to, any nodes that have an analysis pass.

• ID 5690 - Windows run-time libraries are not packaged properly with Nuke.

Nuke runs correctly from a network install on Windows without specifically installing the run-time libraries, though we still recommend that you do so as there are still some minor problems without them.

• ID 5083 - Flipbooking the output of the Anaglyph node asks which view you want to render. This question is unnecessary as the result is an anaglyph image. Irrespective of what view you choose, the flipbook output is the same.

• File types in Windows and Mac OS X are associated with the standard version of Nuke by default, so if you save a script on NukeX using features that are only included in NukeX (such as CameraTracker or FurnaceCore) and then double-click on the script icon to open it, it opens in standard Nuke instead of NukeX.

• CameraTracker: Canceling lens distortion initialization results in corrupt tracks.

• 3D Camera: If you want to navigate through the 3D point cloud created by the CameraTracker node when using Create Scene:

• Select the Camera that was created in the 3D view when using the Create Scene button.

• Press F to focus on the selected Camera. You can now navigate around the cloud. Do not try to focus (using F) on the point cloud. The resulting tumble camera movement is likely to be jumpy.

• Plug-ins installed using the Nuke Plug-in Installer may not work correctly as they were compiled against an earlier version of Nuke.

## Known Issues Specific to Nuke Studio and Hiero

#### AAF

• ID 274824 - Elastic keyframes imported from Avid do not translate correctly into Nuke Studio.

#### Create Comp

• Multi-view, such as stereoscopic, is not supported for clip instances created using right-click Effects > Create Comp.

• ID 47044 - Inserting scripts into comps containing Text nodes using unsupported fonts causes Nuke Studio to crash when the Text nodes are disabled.

• ID 46470 - Create Comp: Enabling Collate Shot Name in the comp export preset offsets the comp frame range compared to the annotations precomp frame range.

• ID 41665 - There are currently no options to load or overwrite an existing script when you select Create Comp.

#### Exporting

• ID 49024 - Enabling the Collate... options in the Export dialog when exporting ignores the Media tab Output Resolution setting for the track above, and produces output with incorrect formatting.

• ID 47828 - Exporting retimed or reversed clips as .xml does not work as expected when imported into Final Cut Pro.

• ID 46403 - Controls set in the Export dialog Content tab occasionally default to the values from the Nuke Write Node Content preset.

#### Linux Only

• ID 282599 - Linux only: Input and timecode metadata is currently incorrect in the timeline Viewer if the framerate is changed.

• ID 239672 - Reading files from NTFS disks/partitions can be extremely slow, particularly for large files. This is a limitation of Linux NTFS file systems, rather than Foundry products.

We recommend avoiding timeline playback that relies on source footage from NTFS disks/partitions.

• ID 235327 - CPU usage can reach 100% on a single thread during flipbooking, causing Hiero to become unresponsive.

• ID 167058 - PulseAudio (ALSA) can cause Nuke Studio to crash or impair playback.

As a workaround, you can stop the pulseaudio daemon:

1. Open /etc/pulse/client.conf

2. Set autospawn = no and daemon-binary to /bin/true. Ensure these lines are not commented out.

3. Call ps -e | grep pulse to check the process is still running.

4. Call pulseaudio --kill

5. Call ps -e | grep pulse again to check the process has stopped.

• Linux only: Nuke Studio does not currently support any QuickTime audio reading. Support for audio on Linux is scheduled for a later release.

• ID 32613 - Dragging clips to the timeline with certain older NVIDIA drivers occasionally causes Nuke Studio to crash.

As a workaround, ensure that you have the latest NVIDIA drivers installed, available from:

www.nvidia.com/Download/index.aspx?lang=en-us

#### Mac OS X Only

• ID 39113 - QuickTime ProApps Codecs v1.0.3 break HDV and XDCAM on Mac OS X 10.7.5, and earlier.

This is a codec issue rather than an application issue.

• ID 34779 - The shortcut for Clear In/Out Points (Alt+U) is not always triggered correctly due to a conflict with the combination for the umlaut symbol.

To work around this, press U momentarily before Alt+U.

#### OCIO

• ID 198348 - Saving and closing a project that uses an OCIO config, and then relocating the Hiero install path, causes a Could not load OpenColorIO config error on reload.

#### Preferences

• The Preferences > Path substitution table for cross platform compatibility currently only comes into effect at project load, not EDL/XML import.

As a workaround, import your sequence and set the Path substitution rule, then save the project and reload to force the conversion.

#### Python API

• ID 50113 - QActions are not added to the Edit menu in the menu bar when finding the menu action by name.

As a workaround, use the objectName (foundry.menu.edit), where possible.

• ID 44394 - Calling hiero.core.addPathRemap() does not work for soft effect file paths.

#### Read and Write

• ID 278312 - Read/Write: The import progress bar occasionally persists after the import is complete, and cannot be closed.

As a workaround, save and close the project, then restart Nuke Studio and reload the project.

• ID 269150 - ARRIRAW: ProRes clips from the Alexa SXT camera cannot currently be read by Nuke Studio.

• ID 49912 - HieroPlayer: Projects created in version 1.9, or earlier, are not editable in HieroPlayer 9.0.

• ID 46174 - XML: Shot names are occasionally not imported correctly from Adobe Premiere .xml files.

• ID 46100 - Exporting: Export speeds may be slower than expected. This may be due to the Rendering preference set to limit renderer.
As a workaround, you can change the preference Performance > Threads/Processes > Rendering > export renders to no renderer limits to improve rendering speeds. You can also experiment with the custom renderer limits to adjust performance on your machine.

• ID 39897 - Importing and playing back very large format .tif files causes Nuke Studio to crash.

• ID 39557 - Writing .exrs with 200+ layers, when interleave is set to channels, can be sluggish.

• ID 36726 - Executing Clip > Rescan Clip Range displays frame read errors if the rescan adds frames to the clip.

• ID 35080 - QuickTime: Certain files read into Nuke Studio with a different start timecode to other applications, such as Premiere or Resolve.

• ID 31549 - Single layer exports from multi-pass clips fail if the selected layer is not a default Nuke layer, such as depth or motion.

• ID 28067 - Certain formats produce no monitor output, such as 2K 23.98 and 720P 25.

• ID 18880 - R3D: The aspect ratio of anamorphic .r3d footage is not displayed correctly when added to the timeline.

#### Soft Effects

• ID 280413 - Soft Effects: The Text effect cursor placement shifts incorrectly after typing first character.

• ID 278275 - Soft Effects: Closing a Timewarp effect's Properties panel disrupts the interface briefly.

• ID 275314 - Soft Effects: Additional keyframes are added incorrectly when animating Text effects.

• ID 230536 - The Burn-in effect does not maintain a constant text baseline for all characters when the format is changed.

• ID 175574 - Undo and redo of Properties panel changes can be unreliable if a soft effect delete is in the same undo stack.

• ID 50442 - TimeWarp: Applying a TimeWarp to a clip instance occasionally causes the associated sequence bin item to display an error.

• ID 50441 - TimeWarp: Applying a TimeWarp to clip instances retimed to values other than 100% does not work as expected.

• ID 49771 - Text/Burn-in: Nuke Studio doesn’t warn you if the font used in an effect could not be found.

• ID 49298 - Burn-in: The Burn-in effect does not auto-update when switching between sequences until the playhead is moved.

• ID 49112 - Dissolve transitions do not work as expected in Custom soft effects, based on the examples provided here:

<install_directory>/pythonextensions/site-packages/hiero/examples/custom_soft_effect.py

• ID 48970 - Burn-in: Burn-in elements are not updated automatically when the underlying metadata is updated.

As a workaround, either change the frame displayed in the Viewer or choose an alternate element from the dropdown controls.

• ID 48878 - Burn-in: The Burn-in effect is currently a gizmo and cannot be cloned on the timeline.

• ID 48098 - Adding a transition when a Text effect containing an expression is on a track above, causes text rendering to fail during the transition.

• ID 48097 - Adding a transition when a Text effect containing an expression is on a track above, causes the text size to reset.

• ID 47075 - Exporting sequences containing clip-level Text effects using the [frame] expression writes incorrect frame numbers.

• ID 45835 - Expression links are incorrectly allowed between node and soft effect controls in the Properties panel, if the node and effect names are identical.

• ID 42438 - Effects are only visible in the Viewer if there is a clip instance below them in the timeline.

• ID 42401 - Renaming a soft effect does not update the clip instance until you click in the timeline.

• ID 42307 - Adding soft effects at clip level, using Open In > Timeline View, is only available using the toolbar button on the timeline panel. The right-click Effects menu is currently disabled.

#### Timeline

• ID 43913 - Locking a track currently prevents adding clip instances from the locked track to the Viewer input buffers. You can still open clip instances in the various right-click Open In options and access clip instance metadata.

• ID 41745 - It is not currently possible to drag-and-drop a clip to a new track between or below existing tracks.

As a workaround, drag the clip to a new top-level track and then manually move the track to the required position.

• ID 27484 - It is not currently possible to alter the Output Resolution of clips opened using the right-click Open in Timeline option.

#### Timeline Disk Caching

• ID 280256 - Opening a Text effect's Properties panel directly after project load causes the cache bar to disappear.

• ID 272897 - Caching continues after closing the project associated with the frames being cached.

• ID 272541 - Changing the root directory for cached files can cause the disk cache state to become inconsistent.

• ID 272450 - A TimelineCache folder is added incorrectly to the Hiero install directory.

• ID 270934 - The caching logic does not currently account for gaps in sequences, resulting in the caching state icon remaining gray for fully cached sequences.

#### Windows Only

• ID 49339 - Soft Effects: The background on Burn-in effects, when enabled, alters size depending on the timecode displayed.

• ID 28701 - Nuke Studio cannot currently parse Unicode characters during export.

#### Miscellaneous

• ID 272723 - Closing Nuke Studio when it was launched from the command line does not end all Hiero processes.

• ID 200015 - Selecting multiple bin clips can cause the right-click menu to respond slowly.

• ID 167919 - Localization: Re-importing clips into the Node Graph or project bin multiple times retains the original localization policies settings.

• ID 50490 - Audio: Zooming in on a waveform displays a Failed to decode audio error in the timeline.

• ID 50102 - Adding a custom Hiero window to a workspace and then saving it as the Nuke default workspace causes Nuke to crash on start up.

• ID 46235 - Comps with relative paths are not currently working when imported into the project.

• ID 42462 - Cache pausing stops working if any change is made to the timeline.

# Developer Notes

Here are the changes relevant to developers. See Help > Documentation from the Hiero menu bar or www.thefoundry.co.uk/products/nuke/developers/110/ndkdevguide/appendixc/index.html for more information.

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 plugins and/or make changes to the source code.

Release Type | Example | Compatibility | Recompile | Rewrite
--- | --- | --- | --- | ---
Version | 10.0v1 to 10.0v2 | API and ABI |  |
Point | 10.0v1 to 10.5v1 | API |  |
Major | 10.0v1 to 11.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 247793 - Python: The <install_dir>/pythonextensions/site-packages/hiero/ui/init_.py file referred to hiero.core.rawArgs incorrectly.

• ID 314080 - Python: Calling nuke.clone(nuke.selectedNode(), inpanel=False) ignored the inpanel flag and created a new panel.

• ID 322312 - Building Qt 5.6.1 from the package on Foundry.com did not work as expected.