Sequence Create Subsequence
Creates Premiere's native independent subsequence from the explicit clip Track Items in `items`. Premiere copies whole selected items; source Sequence in/out points do not trim items that cross those boundaries. The block temporarily replaces and then restores the source Sequence selection; it never falls back to ambient selection. `ignoreTrackTargeting` defaults to true. Naming, bin placement, collision handling, and identity outputs follow the same contract as prSequenceClone. Track Item refs are index-addressed snapshots; relist after later structural timeline mutations.
Inputs
| Input | Required | Value Kind | Types | Enum Values |
|---|---|---|---|---|
sequence | no | expression | — | — |
items | yes | expression | — | — |
ignoreTrackTargeting | no | expression | — | — |
name | yes | expression | — | — |
targetBin | no | expression | — | — |
onNameCollision | no | expression | — | — |
onError | no | expression | enum-string | STOP, CONTINUE, RETURN_FALSE |
storeResultIn | no | variable-name | — | — |
storeAppliedNameIn | no | variable-name | — | — |
storeGuidIn | no | variable-name | — | — |
storeProjectItemIn | no | variable-name | — | — |
Notes
- Creates Premiere's native independent subsequence from explicit clip Track Item refs.
- Premiere copies each selected Track Item as a whole. Source Sequence in/out points do not trim items that cross those boundaries; isolate exact ranges before calling this block or use a native explicit-range capability when one is available.
itemsis required; the block never falls back to ambient selection.- All items must belong to
sequence, which defaults to the active Sequence. - The block snapshots the source Sequence selection, temporarily selects exactly
items, calls Premiere's nativecreateSubsequence, and restores the prior source selection before returning. - If restoration of the prior selection fails after Premiere created the subsequence, the block deletes that new subsequence and reports failure. This intentionally preserves the promised source-UI-state contract rather than returning an output after incomplete cleanup.
ignoreTrackTargetingdefaults totrueso track-targeting UI state does not silently change the requested content.name,targetBin,onNameCollision, and the four result variables use the same identity contract asprSequenceClone.- The returned Sequence is independent rather than a live nest. Its detailed transition, caption, marker, track-effect, automation, time-origin, and Undo behavior remains subject to the documented real-host support matrix.
See Also
- Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.