Encoder object

app.encoder

Description

The encoder object represents Adobe Media Encoder, and is used for local rendering, outside of Premiere Pro.


Attributes

None.


Methods

Encoder.encodeFile()

app.encoder.encodeFile(filePath, outputPath, presetPath, workArea, removeUponCompletion)

Description

Makes Adobe Media Encoder render (optionally, a specified range from) the specified file, with the specified settings.

Parameters

Argument Type Description
filePath String A path to a file to render.
outputPath String A path to an output file.
presetPath String A path to a preset (.epr) file.
workArea Integer

Integer denoting work area to be used:

  • 0 - ENCODE_ENTIRE
  • 1 - ENCODE_IN_TO_OUT
  • 2 - ENCODE_WORK_AREA
removeUponCompletion Integer If 1, job will be removed once complete.
inPoint Time A Time, for the in point of new file.
outPoint Time A Time, for the out point of new file.

Returns

Returns a job ID as a String, for the render job added to the AME queue, or 0 if unsuccessful.


Encoder.encodeProjectItem()

app.encoder.encodeProjectItem(projectItem, outputPath, presetPath, workArea, removeUponCompletion)

Description

Makes Adobe Media Encoder render (optionally, a specified range from) the specified ProjectItem object, with the specified settings.

Parameters

Argument Type Description
projectItem ProjectItem object A project item to render.
outputPath String A path to an output file.
presetPath String A path to a preset (.epr) file.
workArea Integer

Integer denoting work area to be used:

  • 0 - ENCODE_ENTIRE
  • 1 - ENCODE_IN_TO_OUT
  • 2 - ENCODE_WORK_AREA
removeUponCompletion Integer If 1, job will be removed once complete.

Returns

Returns a job ID as a String, for the render job added to the AME queue, or 0 if unsuccessful.


Encoder.encodeSequence()

app.encoder.encodeSequence(sequence, outputPath, presetPath, workArea, removeUponCompletion)

Description

Makes Adobe Media Encoder render the specified Sequence object, with the specified settings.

Parameters

Argument Type Description
sequence Sequence object A sequence to render.
outputPath String A path to an output file.
presetPath String A path to a preset (.epr) file.
workArea Integer

Integer denoting work area to be used:

  • 0 - ENCODE_ENTIRE
  • 1 - ENCODE_IN_TO_OUT
  • 2 - ENCODE_WORK_AREA
removeUponCompletion Integer If 1, job will be removed once complete.

Returns

Returns a job ID as a String, for the render job added to the AME queue, or 0 if unsuccessful.


Encoder.launchEncoder()

app.encoder.launchEncoder()

Description

Launches Adobe Media Encoder.

Parameters

None.

Returns

Returns 0 if successful.


Encoder.setEmbeddedXMPEnabled()

app.encoder.setEmbeddedXMPEnabled(enabled)

Description

Determines whether embedded XMP metadata, will be output.

Parameters

Argument Type Description
enabled Integer Pass 1 to enable sidecar output, 0 to disable.

Returns

Returns 0 if successful.

Note: Premiere Pro and Adobe Media Encoder will output sidecar XMP for some file formats, and embed XMP for most. The applications make this determination based on numerous factors, and there is no API control to “force” sidecar or embedded output, for formats which normally use “the other approach”.


Encoder.setSidecarXMPEnabled()

app.encoder.setSidecarXMPEnabled(enabled)

Description

Determines whether a sidecar file containing XMP metadata, will be output.

Parameters

Argument Type Description
enabled Integer Pass 1 to enable sidecar output, 0 to disable.

Returns

Returns 0 if successful.


Encoder.startBatch()

app.encoder.startBatch()

Description

Makes Adobe Media Encoder start rendering its render queue.

Parameters

None.

Returns

Returns 0 if successful.