Icon

This is the documentation for an older version of Qube. The latest version of the documentation can be found here: Qube

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Below are instructions on your first steps submitting After Effects jobs with Qube!

 

Panel
titleStep 1 (First Time Only)

The After effects Jobtype comes with the standard install of Qube! and does not require a specific jobtype to be installed 

InApp Installation:

Image RemovedImage Added

File > Install App UI > Install Aerender (AppFinder) App UI...

Panel
titleStep 2 (First Time Only)

Once installed there are a few things that need to be done before using the script

Open General Preferences
Image RemovedImage Added
Mac: After Effects > Preferences > General...
PC: File > Preferences >General...
Tick "Allow Scripts to Write Files and Access Network"
Image RemovedImage Added
Panel
titleStep 3 (First Time Only)

Select "Qube_SetPath.jsx"

Image RemovedImage Added 

 File > Scripts > Qube_SetPath.jsx

This will prompt you with

Image RemovedImage Added

Enter the correct path to the Qube application

Mac Defaults: /Applications/pfx/qube/qube.app

PC Defaults: C:\Program Files (x86)\pfx\qube\bin\qube.exe

Panel
titleStep 4

With a scene loaded in After effects select "QubeAppFinder_Submit_RenderQueue.jsx"

Image RemovedImage Added

File > Scripts > QubeAppFinder_Submit_RenderQueue.jsx

 

This will present a pre filled submission UI

Image RemovedImage Added 

Panel
titleStep 5

Ensure sections marked in red have the correct details

Click submit

For further details on the submission UI look in the right panel

Panel
titleTroubleshooting

If you find you are getting errors here are some useful links for troubleshooting

Troubleshooting Flowcharts 

Below Is an expandable view of the AppFinder Jobs > "Aerender (AppFinder) Job..." Jobtype Submission UI

Note

Not all sections need to be filled in in order to render only the fields marked in red are required


Please click on the text below the section of interest

 

Image RemovedImage Added

Excerpt Include
_SimpleCMD_QubeJobBasics
nopaneltrue
_SimpleCMD_QubeJobBasics

Excerpt Include
_SimpleCMD_QubeFrameRangeWithChunk
nopaneltrue
_SimpleCMD_QubeFrameRangeWithChunk

Excerpt Include
_SimpleCMD_PreviewFramesSubmission
nopaneltrue
_SimpleCMD_PreviewFramesSubmission

Image RemovedImage Added

Expand
titleRequired

CS Version

Tooltip - Select version numbers to make an educated guess at where aerender is found on the remote worker.

Info

Use the spinners to enter the required version of After effects

executable

Tooltip - Leave it set to "_AE_" to allow the job to find the right version of aerender on the worker.

Info

Left default qube will automatically find the version of After Effects on the worker

Project File

Tooltip - Path to After Effects project (required)

Info

Browse or enter manually the location of the project file to be rendered. This is a required field for submission

Important: Best practise is to ensure the project file and all of its dependant files such as textures are on network storage accessible by the workers.

After effects requires all plugins and fonts to be installed and licensed on every worker

Image RemovedImage Added

Expand
titleContent (required to see job frame range and % complete)

Composition

Tooltip - The Composition to render

Info

(required if specifying frame range or other overrides listed below) If the comp is in the render queue already, and in a queueable state, then (only) the first queueable instance of that comp on the render queue will be rendered. If the comp is in the project but not in the render queue, then it will be added to the render queue and rendered. If no -comp argument is provided, aerender will render the entire render queue as is. In this case (no -comp), the only other arguments used will be -project, -log, -v, -mem_usage, and -close; the -RStemplate, -OMtemplate, -output, -s, -e, and -i arguments will be ignored.

clear explaination needed

Render Queue Index

Tooltip - specifies a render queue item to be rendered. Options that make sense when rendering a single render queue item are available like with the -comp flag.

Info

Enter the numeric value to override scene render queue index settings

Image RemovedImage Added

Expand
titleOptional (used if comp or render queue index specified)

Render Settings

Tooltip - the name of a template to apply to the render queue item.If the template does not exist it is an error. Default is to use the render template already defined for the item. Can only set if Composition option specified

Info

Enter manually or select from drop-down

Output Module

Tooltip - name of a template to apply to the output module. If the template does not exist it is an error. Default is to use the template already defined for the output module. Can only set if Composition option specified NOTE: Distributing a render across multiple machines requires image sequence output. That is usually best set in the AfterEffects Project or the Output File Path override.

Info

Enter manually or select from drop-down

Important: when choosing the output format be aware that extensions such as .MOV or .AVI can not be distributed across the farm. Please select an image sequence based format such as .TIF etc

Output File Path

Tooltip - Specifying the destination render file. Default is the path already in the project file. For image sequences (the preferred method for distributed rendering) use # to denote frames. For example: /Volumes/Stuff/output/proj1/frames[####].psd. Can only set if Composition option specified.

Info

Browse or manually enter the location of the output image directory you wish to generate

Important: Best practise is to ensure outputs are written to network storage accessible by the workers

Memory Usage

Tooltip - (image_cache_percent max_mem_percent) where image_cache_percent specifies the maximum percent of memory used to cache already rendered images/footage, and max_mem_percent specifies the total percent of memory that can be used by After Effects.

Info

Enter the numeric value to override scene memory usage settings

Image RemovedImage Added

Expand
titleOptional

Verbosity

Tooltip - specifies the type of messages reported

Info

Choose the level of detail you would like the logs to provide

Image RemovedImage Added

Excerpt Include
_SimpleCmd_CmdTemplate
nopaneltrue
_SimpleCmd_CmdTemplate

Excerpt Include
_SimpleCMD_QubeJobTags
nopaneltrue
_SimpleCMD_QubeJobTags

Excerpt Include
_SimpleCMD_QubeWorkerSelection
nopaneltrue
_SimpleCMD_QubeWorkerSelection

Excerpt Include
_SimpleCmd_AdvancedJobControl
nopaneltrue
_SimpleCmd_AdvancedJobControl

Excerpt Include
_SimpleCMD_QubeJobEnvironment
nopaneltrue
_SimpleCMD_QubeJobEnvironment

Excerpt Include
_simplecmd_QubeRuntimeenv
nopaneltrue
_simplecmd_QubeRuntimeenv

Image RemovedImage Added

Excerpt Include
_SimpleCmd_jobValidation
nopaneltrue
_SimpleCmd_jobValidation

Excerpt Include
_SimpleCMD_QubeActions
nopaneltrue
_SimpleCMD_QubeActions

Excerpt Include
_simplecmd_qubenotes
nopaneltrue
_simplecmd_qubenotes