Creating LiveGroups

You can create empty LiveGroups to read in existing .nk scripts or select a set of nodes in the Node Graph and create a LiveGroup to contain those nodes, with the option to write them out to a new .nk script.

Note: If you create and publish a LiveGroup Pythonically, you need to add xpos and ypos values to the nodes in the Node Graph to position them correctly before you publish the LiveGroup. See Nuke's Python Developer's Guide for more information.

Importing an Existing Script into a LiveGroup

In Nuke's Toolbar, select Other > LiveGroup.

A new Node Graph tab opens showing the empty LiveGroup.

Enter the location of the .nk script in the file control or browse to its location and click Open.

A warning displays, informing you that there are differences between the local script and the saved script.

Click Yes to overwrite the local script with the saved script.

The LiveGroup icon turns gray and the LiveGroup tab updates to show the contents of the imported .nk script. The LiveGroup is locked as indicated by the padlock on the LiveGroup's tab and it behaves like regular Nuke Precomp node.

Note: Click Open in the LiveGroup's Properties to start a new Nuke session containing just the LiveGroup's contents.

Adding Nodes to a LiveGroup

Select all the nodes you want to nest inside the LiveGroup.

Do one of the following:

• Press Tab in the Node Graph, type LiveGroup and press enter,

• Press Ctrl/Cmd+L, or

• Right-click and select Edit > Node > Group > Collapse To LiveGroup.

The LiveGroup icon turns yellow and a LiveGroup tab shows the contents of the node. The LiveGroup is not locked and it behaves like regular Nuke Group node.

Viewing Nodes Inside a LiveGroup

In the LiveGroup's Properties panel, click the S button in the top-right corner.

A new Node Graph tab opens containing the nested nodes. LiveGroups contain a LiveInput and Output node by default, which points to the source script so that artists can collaborate without depending on Read nodes in the LiveGroup.

See Referencing a Source Script Using LiveInputs below for more information.

Referencing a Source Script Using LiveInputs

The LiveInput node can reference any LiveGroup within a script, eliminating the need to include the required assets in the sub-script. The only requirements are that the sub-script and source script have been saved and the LiveGroups you intend to connect to are pointing at the new sub-script.

Create a LiveInput node in the sub-script and then save the script.

In the source script, create a LiveGroup node and enter the sub-script name in the file control.

Save the source script.

In the sub-script, enter the source script name in the file control and click Reload.

Select the LiveGroup you want to reference from the liveGroup dropdown.