Export Project Item Frames

Category: Pr Rendering

Exports a batch of source-context still frames from a clip project item. Provide exactly one sampling mode: `timesSeconds`, `intervalSeconds`, or `sampleCount`. Use `range=PROJECT_ITEM_IN_OUT` for the current project-item range or `range=MEDIA_DURATION` for full source-media inspection.

Inputs

Input	Required	Value Kind	Types	Enum Values
item	yes	expression	reference, string	—
outputFolder	yes	expression	string	—
timesSeconds	no	expression	array	—
intervalSeconds	no	expression	number	—
sampleCount	no	expression	number	—
range	no	expression	enum-string	PROJECT_ITEM_IN_OUT, MEDIA_DURATION
width	no	expression	number	—
height	no	expression	number	—
sizePreset	no	expression	enum-string	TINY, SMALL, MEDIUM, HIGH, NATIVE
format	no	expression	—	—
filenamePrefix	no	expression	string	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	variable-name	—

Notes

• Exports multiple source-context still frames from a clip project item.
• Provide exactly one sampling mode: timesSeconds, intervalSeconds, or sampleCount.
• range=PROJECT_ITEM_IN_OUT uses the current project-item in/out when available and otherwise falls back to readable media bounds.
• range=MEDIA_DURATION samples across the full readable media duration.
• This block is for source-content inspection. Use prExportSequenceFrames when the final edited timeline appearance matters.
• The implementation may use temporary matching sequences internally, so this block requires Premiere write permission.
• Do not rely on this block to preserve or restore the active sequence UI state. Use explicit sequence refs for follow-up operations.
• storeResultIn stores a list of exported frame metadata objects with path, timeSeconds, width, and height.

See Also

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