Nuke

This plugin integrates Prism into Foundry Nuke.

Supported Nuke versions: 13.0+ (Python 3)

Setup

The plugin can be installed from the Prism Hub. After the plugin is installed, the Prism integration needs to be added to the Nuke preferences folder. This can be done in the Prism User Settings -> "DCCs apps".

This is the path, which should be selected for the integration: %USERPROFILE%\.nuke

Accessing Prism in Nuke

Prism is available inside Nuke from the "Prism" menu in the main menu bar.

The menu contains options to:

• save and version up your scene

• save, version up your scene and add a description/thumbnail

• open the Project Browser

• Update Read nodes to the latest media versions

• open the Prism Settings

Additionally there is a PrismWrite available to export images and videos to the Prism project.

Saving Scenefiles

You can save new scenefile versions using the options in the Prism menu or by opening the Project Browser and selecting "Create new version from current" in the context menu in the "Scenefiles" tab.

Importing media

To import objects from your Prism project into Nuke you can navigate to a media version in your Project Browser. You can then rightclick the image and select "Import images..." or simply drag&drop it into Nuke.

In addition, media can be accessed from the Prism project within the Nuke Read node.

Rendering media

To render out media from Nuke into your Prism project you can use the "WritePrism" node. In addition Prism render settings are accessible within default Nuke Write node as well.

The exported images can be found in the "Media" tab in the Prism Project Browser.

Scene Building

In Nuke the Scene Building tool can be launched via the Project Browser:

Project Browser > Scenefiles tab > Files > Context menu > Build new Scene

Result

A scene file is created during the building process. The framerange, fps and resolution is applied.

Scene Building Settings

Further steps will take place if they are specified in the settings:

Prism Settings > Project > Scene Building > Nuke

Nuke Steps

Load Media:

If enabled, tagged media files will be loaded depending on the entity and department of the executed Scene Building.

Further Reading

For further information about the Scene Building tool: Scene Building

Adding Prism integration using environment variables

It is possible to use environment variables to add the Prism integration to Nuke instead of adding the Prism integration into the Nuke User Preferences.

The following environment variables need to be defined:

PRISM_ROOT = C:\Program Files\Prism2
NUKE_PATH = C:\ProgramData\Prism2\plugins\Nuke\Integration

These environment variables can be set in the system settings.

To load the Prism Nuke plugin from a central location in your studio you can set the NUKE_PATH environment variable and point it to a folder on your network storage. In that folder create a menu.py with the following content:

import os
os.environ["PRISM_ROOT"] = "C:\\Program Files\\Prism2"
nuke.pluginAddPath("C:\\ProgramData\\Prism2\\plugins\\Nuke\\Integration")

Environment Variables

The Nuke plugin can be configured using the following environment variables:

Name	Description
PRISM_NUKE_CHECK_MEDIA_ON_SCENE_OPEN	Defines if Prism shows a popup when open Nuke scenefiles if the are newer media versions available for any read nodes (e.g. 0, default 1)
PRISM_NUKE_LOAD_MEDIA	Defines which media identifiers to load when building a new scenefile (default: "plate*, light*")
PRISM_NUKE_READ_ADD_KNOBS	Defines if Prism adds custom knobs on the Nuke Read node (e.g. 0, default: 1)
PRISM_NUKE_SUBMISSION_INCREMENT_SCENE	Defines if the Nuke scenefile will be versioned up when submitting renderjobs (e.g. 1, default: 0)
PRISM_NUKE_SUBMISSION_VERSION_WARNING	Defines if a warning gets shown when submitting a write node as a previous version, which might overwrite files. (e.g. 1, default: 0)
PRISM_NUKE_TRACK_UNCONNECTED_DEPENDENCIES	Defines if dependencies are tracked also from nodes, which are not connected to any Write node. (e.g. 0, default: 1)
PRISM_NUKE_WRITE_ADD_KNOBS	Defines if Prism adds custom knobs on the Nuke Write node (e.g. 0, default: 1)

Troubleshooting

"numpy" related warnings and errors

For some features like media previews or media conversions Prism uses a Python module named numpy.

You might encounter warnings or errors if Prism doesn't provide a numpy version, which is compatible with the Python version of your Nuke installation.

In these cases the error can be resolved by installing numpy manually by running this script in the Nuke script editor (Nuke might become unresponsive for a moment while this command gets executed):

import os, sys, subprocess;
subprocess.run([os.path.dirname(sys.executable) + "/python.exe", '-m', 'pip', 'install', '--user', 'numpy'])