Skip to main content

Track Item Trim

Category: Pr Tracks & Clips Track Item Trim block screenshot

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

InputRequiredValue KindTypesEnum Values
itemyesexpression
startSecondsnoexpression
endSecondsnoexpression
inPointSecondsnoexpression
outPointSecondsnoexpression
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-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 prTrackItemSlip when timeline edit points must remain fixed.
  • Do not use this block to place source snippets. Use prSequencePlaceItem with sourceInSeconds / sourceOutSeconds.

See Also

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