Skip to content
月离文档

renderqueueitem

RenderQueueItem object

Section titled “RenderQueueItem object”

app.project.renderQueue.item(index)

Description

Section titled “Description”

The RenderQueueItem object represents an individual item in the render queue. It provides access to the specific settings for an item to be rendered. Create the object by adding a composition to the Render Queue with the RQItemCollection object; see RQItemCollection.add().

Attributes

Section titled “Attributes”

RenderQueueItem.comp

Section titled “RenderQueueItem.comp”

app.project.renderQueue.item(index).comp

Description

Section titled “Description”

The composition that will be rendered by this render-queue item. To change the composition, you must delete this render-queue item and create a new one.

Type

Section titled “Type”

CompItem object; read-only.

RenderQueueItem.elapsedSeconds

Section titled “RenderQueueItem.elapsedSeconds”

app.project.renderQueue.item(index).elapsedSeconds

Description

Section titled “Description”

The number of seconds spent rendering this item.

Type

Section titled “Type”

Integer, or null if item has not been rendered; read-only.

RenderQueueItem.logType

Section titled “RenderQueueItem.logType”

app.project.renderQueue.item(index).logType

Description

Section titled “Description”

A log type for this item, indicating which events should be logged while this item is being rendered.

Type

Section titled “Type”

A LogType enumerated value; (read/write). One of:

  • LogType.ERRORS_ONLY
  • LogType.ERRORS_AND_SETTINGS
  • LogType.ERRORS_AND_PER_FRAME_INFO

RenderQueueItem.numOutputModules

Section titled “RenderQueueItem.numOutputModules”

app.project.renderQueue.item(index).numOutputModules

Description

Section titled “Description”

The total number of Output Modules assigned to this item.

Type

Section titled “Type”

Integer; read-only.

RenderQueueItem.onstatus

Section titled “RenderQueueItem.onstatus”

app.project.renderQueue.item(index).onstatus

Description

Section titled “Description”

The name of a callback function that is called whenever the value of the RenderQueueItem.status attribute changes.

You cannot make changes to render queue items or to the application while rendering is in progress or paused; you can, however, use this callback to pause or stop the rendering process. See RenderQueue.pauseRendering() and RenderQueue.stopRendering(). See also app.onError.

Type

Section titled “Type”

A function name string, or null if no function is assigned.

Example

Section titled “Example”
function myStatusChanged() {
 alert(app.project.renderQueue.item(1).status);
}


app.project.renderQueue.item(1).onstatus = myStatusChanged();
app.project.renderQueue.item(1).render = false; // changes status and shows dialog

RenderQueueItem.outputModules

Section titled “RenderQueueItem.outputModules”

app.project.renderQueue.item(index).outputModules

Description

Section titled “Description”

The collection of Output Modules for the item.

Type

Section titled “Type”

OMCollection object; read-only.

RenderQueueItem.queueItemNotify

Section titled “RenderQueueItem.queueItemNotify”

app.project.renderQueue.item(index).queueItemNotify

Description

Section titled “Description”

Scripts can read and write the Notify checkbox for each individual item in the Render Queue. This is exposed in the UI as a checkbox next to each Render Queue item in the Notify column.

This column is hidden by default and may need to be selected to be visible by right clicking on the Render Queue column headers and choosing Notify.

Type

Section titled “Type”

Boolean; read/write.

RenderQueueItem.render

Section titled “RenderQueueItem.render”

app.project.renderQueue.item(index).render

Description

Section titled “Description”

When true, the item will be rendered when the render queue is started. When set to true, the RenderQueueItem.status is set to RQItemStatus.QUEUED. When set to false, status is set to RQItemStatus.UNQUEUED.

Type

Section titled “Type”

Boolean; read/write.

RenderQueueItem.skipFrames

Section titled “RenderQueueItem.skipFrames”

app.project.renderQueue.item(index).skipFrames

Description

Section titled “Description”

The number of frames to skip when rendering this item. Use this to do rendering tests that are faster than a full render. A value of 0 skip no frames, and results in regular rendering of all frames. A value of 1 skips every other frame. This is equivalent to “rendering on twos.” Higher values skip a larger number of frames. The total length of time remains unchanged. For example, if skip has a value of 1, a sequence output would have half the number of frames and in movie output, each frame would be double the duration.

Type

Section titled “Type”

Integer, in the range [0..99]; read/write.

RenderQueueItem.startTime

Section titled “RenderQueueItem.startTime”

app.project.renderQueue.item(index).startTime

Description

Section titled “Description”

The day and time that this item started rendering.

Type

Section titled “Type”

Date object, or null if the item has not started rendering; read-only.

RenderQueueItem.status

Section titled “RenderQueueItem.status”

app.project.renderQueue.item(index).status

Description

Section titled “Description”

The current render status of the item.

Type

Section titled “Type”

An RQItemStatus enumerated value; read-only. One of:

  • RQItemStatus.WILL_CONTINUE: Rendering process has been paused.
  • RQItemStatus.NEEDS_OUTPUT: Item lacks a valid output path.
  • RQItemStatus.UNQUEUED: Item is listed in the Render Queue panel but composition is not ready to render.
  • RQItemStatus.QUEUED: Composition is ready to render.
  • RQItemStatus.RENDERING: Composition is rendering
  • RQItemStatus.USER_STOPPED: Rendering process was stopped by user or script.
  • RQItemStatus.ERR_STOPPED: Rendering process was stopped due to an error.
  • RQItemStatus.DONE: Rendering process for the item is complete.

RenderQueueItem.templates

Section titled “RenderQueueItem.templates”

app.project.renderQueue.item(index).templates

Description

Section titled “Description”

The names of all Render Settings templates available for the item. See also RenderQueueItem.saveAsTemplate().

Type

Section titled “Type”

Array of strings; read-only.

RenderQueueItem.timeSpanDuration

Section titled “RenderQueueItem.timeSpanDuration”

app.project.renderQueue.item(index).timeSpanDuration

Description

Section titled “Description”

The duration in seconds of the composition to be rendered. The duration is determined by subtracting the start time from the end time. Setting this value is the same as setting a custom end time in the Render Settings dialog box.

Type

Section titled “Type”

Floating-point value; read/write.

RenderQueueItem.timeSpanStart

Section titled “RenderQueueItem.timeSpanStart”

app.project.renderQueue.item(index).timeSpanStart

Description

Section titled “Description”

The time in the composition, in seconds, at which rendering will begin. Setting this value is the same as setting a custom start time in the Render Settings dialog box.

Type

Section titled “Type”

Floating-point value; read/write.

Methods

Section titled “Methods”

RenderQueueItem.applyTemplate()

Section titled “RenderQueueItem.applyTemplate()”

app.project.renderQueue.item(index).applyTemplate(templateName)

Description

Section titled “Description”

Applies a Render Settings template to the item. See also RenderQueueItem.saveAsTemplate() and RenderQueueItem.templates.

Parameters

Section titled “Parameters”
ParameterTypeDescription
templateNameStringThe name of the template to apply.

Returns

Section titled “Returns”

Nothing.

RenderQueueItem.duplicate()

Section titled “RenderQueueItem.duplicate()”

app.project.renderQueue.item(index).duplicate()

Description

Section titled “Description”

Creates a duplicate of this item and adds it this render queue.

Parameters

Section titled “Parameters”

None.

Returns

Section titled “Returns”

RenderQueueItem object.

RenderQueueItem.getSetting()

Section titled “RenderQueueItem.getSetting()”

app.project.renderQueue.item(index).getSetting()

Description

Section titled “Description”

Gets a specific Render Queue Item setting.

Example

Section titled “Example”
// Get current value of render setting's "Proxy Use"
// Key and value strings are English.
var rqItem1_proxyUse = app.project.renderQueue.item(1).getSetting("Proxy Use");


// Get string version of same setting, add "-str" at the end of key string
var rqItem1_proxyUse_str = app.project.renderQueue.item(1).getSetting("Proxy Use-str");

RenderQueueItem.getSettings()

Section titled “RenderQueueItem.getSettings()”

app.project.renderQueue.item(index).getSettings()

Description

Section titled “Description”

Gets all settings for a given Render Queue Item.

Example

Section titled “Example”
// Get object that contains all possible values of all render settings of
// render queue item 1 and convert to JSON format.


var rqItem1_spec_str = app.project.renderQueue.item(1).getSettings(GetSettingsFormat.SPEC);
var rqItem1_spec_str_json = rqItem1_spec_str.toSource();

RenderQueueItem.outputModule()

Section titled “RenderQueueItem.outputModule()”

app.project.renderQueue.item(index).outputModule(index)

Description

Section titled “Description”

Gets an output module with the specified index position.

Parameters

Section titled “Parameters”
ParameterTypeDescription
indexInteger, in the range [1..numOutputModules]The position index of the output module.

Returns

Section titled “Returns”

OutputModule object.

RenderQueueItem.remove()

Section titled “RenderQueueItem.remove()”

app.project.renderQueue.item(index).remove()

Description

Section titled “Description”

Removes this item from the render queue.

Parameters

Section titled “Parameters”

None.

Returns

Section titled “Returns”

Nothing.

RenderQueueItem.saveAsTemplate()

Section titled “RenderQueueItem.saveAsTemplate()”

app.project.renderQueue.item(index).saveAsTemplate(name)

Description

Section titled “Description”

Saves the item’s current render settings as a new template with the specified name.

Parameters

Section titled “Parameters”
ParameterTypeDescription
nameStringThe name of the new template.

Returns

Section titled “Returns”

Nothing.

RenderQueueItem.setSetting()

Section titled “RenderQueueItem.setSetting()”

app.project.renderQueue.item(index).setSetting()

Description

Section titled “Description”

Sets a specific setting for a given Render Queue Item.

Depreciated Source: https://blogs.adobe.com/creativecloud/new-changed-after-effects-cc-2014/?segment=dva

Archived version: https://web.archive.org/web/20200622100656/https://blogs.adobe.com/creativecloud/new-changed-after-effects-cc-2014/?segment=dva

Example

Section titled “Example”
// Set value of "Proxy Use" to "Use All Proxies"


app.project.renderQueue.item(1).setSetting("Proxy Use", "Use All Proxies");


// You can use numbers, too.
// The next line does the same as the previous example.


app.project.renderQueue.item(1).setSetting("Proxy Use", 1);

RenderQueueItem.setSettings()

Section titled “RenderQueueItem.setSettings()”

app.project.renderQueue.item(index).setSettings()

Description

Section titled “Description”

Sets a multiple settings for a given Render Queue Item.

Example

Section titled “Example”
// Get an object that contains string version of settable render setting
// values of render queue item 1.
// To get the values in the number format, use
// GetSettingsFormat.NUMBER_SETTABLE as an argument.


var rqItem1_settable_str = app.project.renderQueue.item(1).getSettings( GetSettingsFormat.STRING_SETTABLE );


// Set render queue item 2 with values that you got from render
//queue item 1.


app.project.renderQueue.item(2).setSettings( rqItem1_settable_str );


// Set render queue item 3 with values you create.


var my_renderSettings = {
 "Color Depth": "32 bits per channel",
 "Quality": "Best",
 "Effects": "All On",
 "Time Span Duration": "1.0",
 "Time Span Start": "2.0"
};


app.project.renderQueue.item(2).setSettings( my_renderSettings );