Mark Used Source Ranges

Category: Pr Markers

Accepts an explicit list of source Project Item refs and refreshes only this tool's owned source markers. Selected bins, Sequences, and Multicam sources are ineligible targets. Uses selected ordinary source Project Items as explicit targets, recursively maps enabled video/audio placement windows through ordinary nested sequences, and refreshes only markers with the tool's exact terminal ownership tag. Status is OK, NO_ELIGIBLE_SOURCES, MULTICAM_UNSUPPORTED, or ERROR. MULTICAM_UNSUPPORTED performs no marker writes. includeNestOnly defaults to false. Recursively maps enabled clip ranges through ordinary nested Sequences. It keeps video and audio coverage separate, partitions overlaps into non-overlapping Video, Audio, and Video + Audio markers, and maps constant speed and reverse playback into source-relative time. includeNestOnly=false is the default. When true, white Nest only markers show eligible ranges found inside structurally related nests but outside every contributing root placement window. Disabled Track Items and muted Tracks do not contribute. Used means an enabled Timeline placement; the block does not render pixels, evaluate opacity/occlusion, or measure final audio routing. Multicam Project Items are recognized through IS_MULTICAM_CLIP. Because the selected camera angle and audio routing are not part of this contract, any encountered Multicam returns MULTICAM_UNSUPPORTED before marker mutation and stores its names in storeMulticamNamesIn. Status values are OK, NO_ELIGIBLE_SOURCES, MULTICAM_UNSUPPORTED, and ERROR. storeResultIn is true for OK and the successful no-eligible-target no-op, false for Multicam refusal or RETURN_FALSE errors. Ownership requires the exact terminal comment line [automation-agent:used-source-range:v1]. Other markers are preserved. A complete zero-use result removes prior owned markers on the selected source. The block computes the complete plan before writing. It creates and colors missing markers before deleting obsolete owned markers, and makes a best-effort cleanup of newly created markers if creation fails. If sequence is omitted, the block uses the active sequence when supported. 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.

Inputs

Input	Required	Value Kind	Types	Enum Values
sources	yes	expression	array	—
sequence	no	expression	reference, string, null	—
includeNestOnly	no	expression	boolean	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeStatusIn	no	variable-name	variable-name	—
storeRangeCountIn	no	variable-name	variable-name	—
storeSourceCountIn	no	variable-name	variable-name	—
storeMulticamNamesIn	no	variable-name	variable-name	—
storeResultIn	no	variable-name	variable-name	—

Notes

• Accepts an explicit list of source Project Item refs and refreshes only this tool's owned source markers. Selected bins, Sequences, and Multicam sources are ineligible targets.
• Recursively maps enabled clip ranges through ordinary nested Sequences. It keeps video and audio coverage separate, partitions overlaps into non-overlapping Video, Audio, and Video + Audio markers, and maps constant speed and reverse playback into source-relative time.
• includeNestOnly=false is the default. When true, white Nest only markers show eligible ranges found inside structurally related nests but outside every contributing root placement window.
• Disabled Track Items and muted Tracks do not contribute. Used means an enabled Timeline placement; the block does not render pixels, evaluate opacity/occlusion, or measure final audio routing.
• Multicam Project Items are recognized through IS_MULTICAM_CLIP. Because the selected camera angle and audio routing are not part of this contract, any encountered Multicam returns MULTICAM_UNSUPPORTED before marker mutation and stores its names in storeMulticamNamesIn.
• Status values are OK, NO_ELIGIBLE_SOURCES, MULTICAM_UNSUPPORTED, and ERROR. storeResultIn is true for OK and the successful no-eligible-target no-op, false for Multicam refusal or RETURN_FALSE errors.
• Ownership requires the exact terminal comment line [automation-agent:used-source-range:v1]. Other markers are preserved. A complete zero-use result removes prior owned markers on the selected source.
• The block computes the complete plan before writing. It creates and colors missing markers before deleting obsolete owned markers, and makes a best-effort cleanup of newly created markers if creation fails.

See Also

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