Quickstart

As smartLink is a helper for nodes in our nodegraph, let’s open an Nuke script that contains some nodes. Our example script contains some Read nodes and Camera nodes.

_images/start_nodegraph.png

Organizing nodes with the Backdrop Manager

Let’s group all of our Read nodes under a custom backdrop node using smartLink’s Backdrop Manager. We will then create links for these Read nodes in order to use them down the line and keep our sources in one place. The Backdrop Manager lets us choose custom backdrops from a preset list. Custom backdrops include custom names, icons and colors and you can create your own custom presets.

Let’s select the Read nodes and navigate to our menubar and select: cragl -> smartLink -> Backdrop Manager. A quicker way is using the shortcut Alt+B which can be changed to any other shortcut in the Shortcut Editor.

_images/menubar_backdrop_manager.jpg

The upcoming window lets us create backdrops from a preset list. Let’s choose Plate from the drop down.

_images/backdrop_manager_startup.jpg

Below, we can enter a custom name that will be displayed in the label of our Backdrop node. Let’s leave it empty, so that our preset name ‘Plate’ will be used instead. Clicking the settings button at the top right lets us edit the preset backdrops and create custom ones. For more information, please have a look at the backdrop manager. When we are done, let’s click the Create button. All read nodes are grouped under a Plate Backdrop node that contains a specific label, icon and color.

_images/backdrop_reads.jpg

Switching node classes

The nodes in the smartLinker are grouped by node classes. Clicking the buttons at the top cycles through all node classes. Let’s for instance click the Camera tab and this will show all Cameras for our current Nuke script.

_images/camera_nodes.jpg

The second camera reads from a file which will be shown in the link element for this node. Hovering over it shows the whole path as a tooltip.

Searching nodes

Once your script becomes bigger, the smartLinker’s nodes list can become quite long. In order to quickly find nodes, you can use the smartLinker’s search field at the top right. This will will search for node names, labels and file paths and thus offers a lot more than the built in functionality in Nuke. Let’s for instance search for all background elements. So let’s type in bg and smartLink will filter for all elements that have bg either in their node name, file path or label.

_images/search1.jpg

Editing node classes

By default, smartLink shows only Read nodes, ReadGeo nodes and Cameras. But you can always add other node classes and change the order to your needs. For that, click one of the class buttons at the top of the smartLinker and choose edit from the context menu.

_images/edit_node_classes_context.jpg

The class buttons will be hidden and an input field shows up, in which you can add new classes and change the order to your needs. Let’s for instance add the Write node class to the smartLinker.

_images/edit_node_classes.jpg

Creating links for Write nodes is maybe not what we want, but still, having the ability to see all Write nodes in one spot and having the ability to jump between these quickly can become useful.

Using favorites

smartLink offers a feature which is called favorite. Using this functionality, you can create a collection of all your important nodes in your Nuke script that you need to return to often and that you need to access quickly.

We have added a few more nodes to our node graph. We are now interested to quickly access our Camera node and our custom controller that drives multiple nodes. For that, let’s open the smartLinker and click the first section, the star icon, which reveals the favorite section.

_images/favorite_section.jpg

In here we see a + button. Let’s select our Camera node and click the + button. Our Camera node will be added to the favorites section.

_images/favorites_add_camera.jpg

Let’s do the same for our custom controller. So let’s select it and press the + button.

_images/favorites_add_ctrl.jpg

You can also use the shortcut Alt + L to favorite one node or several nodes. The favorites will be saved within your Nuke script and remain also after closing your Nuke script.

Tinting nodes

smartLink lets you tint your nodes and links in one go so that you can find them quicker in the smartLinker, but also inside your nodegraph. Let’s for instance tint our ship Read node. In the smartLinker let’s switch to the Read section to show all Read nodes. Let’s hover over the ship Read node in the smartLinker and right click it to show more options. In here let’s choose Tint -> Set.

_images/tint_context.jpg

In the upcoming color picker we are free to choose any color that we would like. Let’s select a light blue and click ok. The source Read node, all links and the node in the smartLinker are tinted in one go for us.

_images/tinted1.jpg

Changing layouts

smartLink offers a horizontal- and a vertical layout. By clicking the small icon next to the settings icon at the bottom left you can switch between these layouts. The chosen layout will be remembered.

_images/layout_vertical.jpg

Dockable smartLinker

The smartLinker can also be used as a dockable window. With that you have it permanently at your fingertips and can save it with your layout. To create a dockable smartLinker choose on of your pane menu boxes in any layout section and choose Windows -> Custom -> smartLinker.

_images/dockable_command.jpg

You can then save this as a layout (Workspace -> Save workspace…) so that smartLink shows up once you launch Nuke.

_images/dockable1.jpg

Settings

smartLink contains multiple settings so that you can customize it to your needs. To open the settings, please click the settings button at the bottom left of the smartLinker. The settings section shows up. For more information about all offered settings, please have a look at the settings section.

_images/settings.jpg

Shortcut Editor

smartLink offers shortcuts for various actions. You can use smartLink’s Shortcut Editor to customize the shortcuts to your needs. To launch the Shortcut Editor, navigate to your menubar and choose cragl -> smartLink -> ShortcutEditor. For more information about this window, please have a look at the Shortcut Editor section.

_images/shortcut_editor.jpg