Job Submission

You can submit jobs from within KeyShot by installing the integrated submission script, or you can submit them from the Monitor. The instructions for installing the integrated submission script can be found further down this page.

job_options adv_options

To submit from within KeyShot, open the scripting console (Window -> Scripting Console) and then run the script Starting in KeyShot 7.2 you can also submit by pressing the Send to Deadline button in KeyShot’s Render window.

../_images/keyshot_deadline_submit.png ../_images/keyshot_deadline_submit_integrated.png

Submission Options

The general Deadline options are explained in the Job Submission documentation, and the Draft/Integration options are explained in the Draft and Integration documentation. The KeyShot specific options are:

  • KeyShot File: The KeyShot file to be rendered.
  • Output File: The filename of the image(s) to be rendered.
  • Include All Render Layers: If enabled, all Render Layers will be rendered.
  • Include Alpha: If Enabled, include the alpha pass in the rendered file.
  • Override Render Passes: If enabled, the render passes selected in the submitter will be used instead of those defined within the scene.
  • Quality To Render By: Determine whether to render based on the Maximum Number of Samples, Maximum Time, or a combination of both.

Plug-in Configuration

You can configure the KeyShot plug-in settings from the Monitor. While in super user mode, select Tools -> Configure Plugins and select the KeyShot plug-in from the list on the left.


Render Executables

  • KeyShot Executable: The path to the KeyShot executable file used for rendering. Enter alternative paths on separate lines. Different executable paths can be configured for each version installed on your render nodes.

Licensing Options

  • Use Render Node Licenses: If enabled, KeyShot will use render node licenses. Otherwise, KeyShot will use pro licenses.
  • Slaves To Use Pro License: A list of Slaves that should use a KeyShot pro license instead of a render node license. Use a , to separate multiple Slave names, for example: slave001,slave002,slave003

Integrated Submission Script Setup

The following procedures describe how to install the integrated KeyShot submission script. This script allows for submitting KeyShot render jobs to Deadline directly from within the KeyShot GUI. The script and the following installation procedure has been tested with KeyShot 6 and later.

Submitter Installer

Manual Installation

KeyShot 6 and 7

  • Within KeyShot open the Script Console (Window -> Scripting Console).
  • On the Scripts tab of the Script Console import the file located at <repository>/submission/KeyShot/Client.

KeyShot 7.2 and Forward

  • Copy <Repository>\submission\KeyShot\Client\ to: %localappdata%\Thinkbox\Deadline[VERSION]\submitters\KeyShotSubmitter on Windows or ~/Library/Application Support/Thinkbox/Deadline[VERSION]/submitters/KeyShotSubmitter on OSX (where [VERSION] is the major version of Deadline such as 10):
  • Copy <Repository>\submission\KeyShot\Client\deadline.json to the root directory of your KeyShot resources directory. The KeyShot resources folder can be found in KeyShot by going to the Folder Preferences tab of the Preferences window.
  • Update the deadline.json file that was copied by replacing HOMEDIR with the directory that you copied to.


Which versions of KeyShot are supported?

KeyShot 6 and later is supported.

Can I use KeyShot Render Node Licenses?

Yes, in order to use KeyShot render node licenses, you must enable “Use Render Node Licenses” in the Plugin Configuration. Doing so will make all slaves except a specified whitelist use render node Licenses.

Error Messages and Meanings

This is a collection of known KeyShot error messages and their meanings, as well as possible solutions. We want to keep this list as up to date as possible, so if you run into an error message that isn’t listed here, please email Deadline Support and let us know.

Exception during render: Renderer returned non-zero error code, -1.

When this error message is printed it normally means that KeyShot was unable to pull a render node license. Please ensure that the slave is able to access the license server and that render node licenses are available or add this slave to the “Slaves To Use Pro Licenses” in they KeyShot Plugin Configuration Menu.