Skip to main content

Render Timeline Clip Safely

Category: Pr Rendering Render Timeline Clip Safely block screenshot

Renders one video Track Item through an atomic temporary-sequence lifecycle. Atomically clones the owning sequence, renders immediately, waits for a stable output, and normally deletes all temporary sequences. FULL_TIMELINE_RESULT requires startSeconds/endSeconds and includes every visible/audible timeline layer in that range. ISOLATED_CLIP_EFFECTS creates a subsequence from only the requested video Track Item, preserving direct clip effects while excluding adjustment layers, other tracks, transitions, graphics, captions, and sequence audio. Existing outputs are never overwritten. On an ambiguous output timeout, temporary sequence refs are retained and returned in the structured result. item must be a video CLIP Track Item reference. The owning sequence is derived from that reference. This is a lifecycle block: it clones the owning sequence, commits any temporary range changes before export, renders immediately, waits until the output is stable for five seconds, restores the prior active sequence, and normally deletes every temporary sequence it created. FULL_TIMELINE_RESULT requires startSeconds and endSeconds. It renders the cloned sequence over that interval, so adjustment layers, graphics, captions, overlapping tracks, track effects, and the sequence audio mix remain part of the result. ISOLATED_CLIP_EFFECTS creates a native subsequence from exactly the requested video Track Item on the clone and renders that entire subsequence. It preserves effects applied directly to the clip but excludes adjustment layers, other tracks, transitions, graphics, captions, and sequence audio. Handles are intentionally unsupported in this mode. outputPath and presetPath are required. The block refuses to overwrite an existing output. storeResultIn receives { ok, completion, retainedSequenceRefs, message? }. completion is COMPLETED, RENDER_REJECTED, or OUTPUT_TIMEOUT. After an ambiguous output timeout, the block restores the prior active sequence but deliberately retains its temporary sequences, because Premiere may still be writing from them. Surface retainedSequenceRefs to the user for inspection and manual cleanup. Cleanup is owned by this host-backed statement and therefore does not depend on DSL transaction mode or on a later DSL statement running after cancellation. Use onError to decide whether errors stop the script, continue, or return false when the block supports it. If storeResultIn is set, the block also writes a result variable back to your graph. Use presetPath to choose the sequence preset. Without it, Premiere uses its default behavior for new sequences.

Inputs​

InputRequiredValue KindTypesEnum Values
itemyesexpressionstring—
modeyesexpressionenum-stringFULL_TIMELINE_RESULT, ISOLATED_CLIP_EFFECTS
startSecondsnoexpressionnumber—
endSecondsnoexpressionnumber—
outputPathyesexpressionstring—
presetPathyesexpressionstring—
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-namevariable-name—
storeOkInnovariable-namevariable-name—
storeCompletionInnovariable-namevariable-name—
storeRetainedSequencesInnovariable-namevariable-name—
storeMessageInnovariable-namevariable-name—

Notes​

  • item must be a video CLIP Track Item reference. The owning sequence is derived from that reference.
  • This is a lifecycle block: it clones the owning sequence, commits any temporary range changes before export, renders immediately, waits until the output is stable for five seconds, restores the prior active sequence, and normally deletes every temporary sequence it created.
  • FULL_TIMELINE_RESULT requires startSeconds and endSeconds. It renders the cloned sequence over that interval, so adjustment layers, graphics, captions, overlapping tracks, track effects, and the sequence audio mix remain part of the result.
  • ISOLATED_CLIP_EFFECTS creates a native subsequence from exactly the requested video Track Item on the clone and renders that entire subsequence. It preserves effects applied directly to the clip but excludes adjustment layers, other tracks, transitions, graphics, captions, and sequence audio. Handles are intentionally unsupported in this mode.
  • outputPath and presetPath are required. The block refuses to overwrite an existing output.
  • storeResultIn receives { ok, completion, retainedSequenceRefs, message? }. completion is COMPLETED, RENDER_REJECTED, or OUTPUT_TIMEOUT.
  • After an ambiguous output timeout, the block restores the prior active sequence but deliberately retains its temporary sequences, because Premiere may still be writing from them. Surface retainedSequenceRefs to the user for inspection and manual cleanup.
  • Cleanup is owned by this host-backed statement and therefore does not depend on DSL transaction mode or on a later DSL statement running after cancellation.

See Also​

  • Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.

Examples​

Export Timeline Clips As Separate Files

Exports matching video Track Items as the complete timeline result, as an isolated clip with directly applied effects, or as the used source-file range.

kind: Recipe · format: persisted-document · validation: Manual workspace

Topics: rendering and export, timeline clips, clip effects, adjustment layers, source ranges, safe cleanup

Source: recipes/ex-render-timeline-clips-as-separate-files.json

Download JSON