Track Item Slip

Category: Pr Tracks & Clips

offsetSeconds is a relative offset in source-media time. Source handles are checked in source-relative 0..duration seconds. A media file's embedded timecode start does not change this public DSL time domain. Positive values select later source media; negative values select earlier source media. Timeline start, timeline end, and timeline duration are preserved. Source in and source out both change by the same offset. This is a non-ripple operation. Neighboring clips and other tracks are not intentionally changed. The operation fails when Premiere cannot satisfy the requested source range, for example because source handles are insufficient. The operation also fails before mutation when the track item does not expose reliable source-media bounds. This conservative behavior prevents Premiere from partially applying an invalid slip on virtual or otherwise unsupported source types. The public DSL time unit remains seconds. Use prFramesToTime when an editor-facing frame count must be converted explicitly at a known frame rate. 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
item	yes	expression	—	—
offsetSeconds	yes	expression	—	—
onError	no	expression	enum-string	STOP, CONTINUE, RETURN_FALSE
storeResultIn	no	variable-name	—	—

Notes

• offsetSeconds is a relative offset in source-media time.
• Source handles are checked in source-relative 0..duration seconds. A media file's embedded timecode start does not change this public DSL time domain.
• Positive values select later source media; negative values select earlier source media.
• Timeline start, timeline end, and timeline duration are preserved.
• Source in and source out both change by the same offset.
• This is a non-ripple operation. Neighboring clips and other tracks are not intentionally changed.
• The operation fails when Premiere cannot satisfy the requested source range, for example because source handles are insufficient.
• The operation also fails before mutation when the track item does not expose reliable source-media bounds. This conservative behavior prevents Premiere from partially applying an invalid slip on virtual or otherwise unsupported source types.
• The public DSL time unit remains seconds. Use prFramesToTime when an editor-facing frame count must be converted explicitly at a known frame rate.

See Also

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

Examples

Slip And Move A Track Item Without Affecting Neighbors

Creates three clips with gaps, slips and moves the middle clip, and verifies that both surrounding clips remain unchanged.

kind: Pattern · format: runtime-dsl · validation: MCP fixture

Topics: track items, slip edit, move edit, non-ripple editing, timeline invariants

Source: patterns/ex-track-item-slip-and-move-preserve-neighbors.json

Download JSON