RenderQueue object¶
app.project.renderQueue
Description
The RenderQueue object represents the render automation process, the data and functionality that is available through the Render Queue panel of a particular After Effects project. Attributes provide access to items in the render queue and their render status. Methods can start, pause, and stop the rendering process. The RenderQueueItem object provides access to the specific settings for an item to be rendered.
Attributes¶
RenderQueue.canQueueInAME¶
app.project.renderQueue.canQueueInAME
Note
This functionality was added in After Effects 14.0 (CC 2017)
Description
indicates whether or not there are queued render items in the After Effects render queue. Only queued items can be added to the AME queue.
Type
Boolean; read-only.
RenderQueue.queueNotify¶
app.project.renderQueue.queueNotify
Note
This functionality was added in After Effects 22.0 (2022)
Description
Read or write the Notify property for the entire Render Queue. This is exposed in the UI as a checkbox in the lower right corner of the Render Queue panel.
Type
Boolean; read/write.
RenderQueue.items¶
app.project.renderQueue.items
Description
A collection of all items in the render queue. See RenderQueueItem object.
Type
RQItemCollection object; read-only.
RenderQueue.numItems¶
app.project.renderQueue.numItems
Description
The total number of items in the render queue.
Type
Integer; read-only.
RenderQueue.rendering¶
app.project.renderQueue.rendering
Description
When true, the rendering process is in progress or paused. When false, it is stopped.
Type
Boolean; read-only.
Methods¶
RenderQueue.item()¶
app.project.renderQueue.item(index)
Description
Gets a specified item from the ite ms collection.
Parameters
index
The position index of the item. An integer in the range [0..numItems]
.
Returns
RenderQueue.pauseRendering()¶
app.project.renderQueue.pauseRendering(pause)
Description
Pauses the current rendering process, or continues a paused rendering process. This is the same as clicking Pause in the Render Queue panel during a render. You can call this method from an RenderQueueItem.onstatus or app.onError callback.
Parameters
|
True to pause a current render process, false to continue a paused render. |
Returns
Nothing.
RenderQueue.render()¶
app.project.renderQueue.render()
Description
Starts the rendering process. This is the same as clicking Render in the Render Queue panel. The method does not return until the render process is complete. To pause or stop the rendering process, call RenderQueue.pauseRendering() or RenderQueue.stopRendering() from an onError
or onstatus
callback.
To respond to errors during the rendering process, define a callback function in app.onError.
To respond to changes in the status of a particular item while the render is progressing, define a callback function in RenderQueueItem.onstatus in the associated RenderQueueItem object.
Parameters
None.
Returns
Nothing.
RenderQueue.showWindow()¶
app.project.renderQueue.showWindow(doShow)
Description
Shows or hides the Render Queue panel.
Parameters
|
When true, show the Render Queue panel. When false, hide it. |
Returns
Nothing.
RenderQueue.stopRendering()¶
app.project.renderQueue.stopRendering()
Description
Stops the rendering process. This is the same as clicking Stop in the Render Queue panel during a render. You can call this method from an RenderQueueItem.onstatus or app.onError callback.
Parameters
None.
Returns
Nothing.
RenderQueue.queueInAME()¶
app.project.renderQueue.queueInAME(render_immediately_in_AME)
Note
This functionality was added in After Effects 14.0 (CC 2017)
Description
Calls the Queue In AME command. This method requires passing a boolean value, telling AME whether to only queue the render items (false) or if AME should also start processing its queue (true).
Note
This requires Adobe Media Encoder CC 2017 (11.0) or later.
Note
When AME receives the queued items, it applies the most recently used encoding preset. If render_immediately_in_AME
is set to true, you will not have an opportunity to change the encoding settings.
Parameters
|
Telling AME whether to only queue the render items ( |
Returns
Nothing.
Example
The following sample code checks to see if there are queued items in the render queue, and if so queues them in AME but does not immediately start rendering:
// Scripting support for Queue in AME.
// Requires Adobe Media Encoder 11.0.
if (app.project.renderQueue.canQueueInAME === true) {
// Send queued items to AME, but do not start rendering.
app.project.renderQueue.queueInAME(false);
} else {
alert("There are no queued item in the Render Queue.");
}