Track Item Trim
This is a low-level advanced edit primitive over Premiere's coupled start/end/source-in/source-out actions. The four optional values are not independent field assignments: changing a timeline edge can change the corresponding source point, and changing a source point can change the corresponding timeline edge. Do not use four-field trim as a slip operation. Use prTrackItemSlip when timeline edit points must remain fixed. Do not use this block to place source snippets. Use prSequencePlaceItem with sourceInSeconds / sourceOutSeconds. 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 startSeconds and endSeconds to retime the item on the timeline, and inPointSeconds/outPointSeconds to retime the source portion inside it.
Inputs
| Input | Required | Value Kind | Types | Enum Values |
|---|---|---|---|---|
item | yes | expression | — | — |
startSeconds | no | expression | — | — |
endSeconds | no | expression | — | — |
inPointSeconds | no | expression | — | — |
outPointSeconds | no | expression | — | — |
onError | no | expression | enum-string | STOP, CONTINUE, RETURN_FALSE |
storeResultIn | no | variable-name | — | — |
Notes
- This is a low-level advanced edit primitive over Premiere's coupled start/end/source-in/source-out actions.
- The four optional values are not independent field assignments: changing a timeline edge can change the corresponding source point, and changing a source point can change the corresponding timeline edge.
- Do not use four-field trim as a slip operation. Use
prTrackItemSlipwhen timeline edit points must remain fixed. - Do not use this block to place source snippets. Use
prSequencePlaceItemwithsourceInSeconds/sourceOutSeconds.
See Also
- Premiere Reference Paths: Explains Premiere reference path strings for project items, sequences, tracks, timeline items, markers, components, and parameters.