Skip to main content

Apply Transition

Category: Pr Tracks & Clips Apply Transition block screenshot

Adds a transition at the Track Item's IN, OUT or BOTH edges. An explicitly supplied durationSeconds is converted to the nearest native tick, not to a frame. An omitted duration retains Premiere's native default; edge and neighbor-mode options are unchanged. Track Item Trim/Move/Clone and Transition duration use the same nearest-tick conversion: computed seconds such as 0.7999999999999999 normalize to the intended tick count. When that count exceeds JavaScript's safe-integer range, the host falls back to the native seconds factory and emits a precision warning. Native Timeline operations may still quantize or couple edit points; read their actual committed state. This conversion alone does not certify native frame rounding or Undo behavior. 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 edge to choose whether the transition is applied at the start or end of the item. Use neighborMode to control how Premiere balances the transition against neighboring clips. If durationSeconds is set, the block requests that transition duration.

Inputs​

InputRequiredValue KindTypesEnum Values
itemyesexpression——
edgenoexpression——
neighborModenoexpression——
transitionNamenoexpression——
durationSecondsnoexpression——
onErrornoexpressionenum-stringSTOP, CONTINUE, RETURN_FALSE
storeResultInnovariable-name——

Notes​

  • Adds a transition at the Track Item's IN, OUT or BOTH edges.
  • An explicitly supplied durationSeconds is converted to the nearest native tick, not to a frame. An omitted duration retains Premiere's native default; edge and neighbor-mode options are unchanged.
  • Track Item Trim/Move/Clone and Transition duration use the same nearest-tick conversion: computed seconds such as 0.7999999999999999 normalize to the intended tick count. When that count exceeds JavaScript's safe-integer range, the host falls back to the native seconds factory and emits a precision warning. Native Timeline operations may still quantize or couple edit points; read their actual committed state. This conversion alone does not certify native frame rounding or Undo behavior.

See Also​

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

Examples​

Apply One Transition On An Isolated Sequence

Creates a fresh sequence from one source item, applies a single-sided transition to the first clip, and verifies that one transition item was added.

kind: Pattern · format: runtime-dsl · validation: Schema only

Topics: transitions, track item mutation

Source: patterns/ex-transition-apply-single-sided-on-isolated-sequence.json

Download JSON