Skip to main content

Get Sequence Property

Category: Pr Sequences Get Sequence Property block screenshot

Reads one property from a sequence, using the active sequence by default when `sequence` is omitted. The `HAS_OBJECT_MASK` property reports whether Premiere currently sees any object mask usage on that sequence.

Inputs​

InputRequiredValue KindTypesEnum Values
sequencenoexpressionreference, string, null—
propertyyesstringenum-stringNAME, GUID, TIMEBASE, VIDEO_DISPLAY_FORMAT, AUDIO_DISPLAY_FORMAT, VIDEO_FRAME_RATE, AUDIO_SAMPLE_RATE, AUDIO_TRACK_COUNT, VIDEO_TRACK_COUNT, CAPTION_TRACK_COUNT, IN_POINT, OUT_POINT, WORK_AREA_IN_POINT_SECONDS, WORK_AREA_OUT_POINT_SECONDS, END_TIME, ZERO_POINT, PLAYER_POSITION, HAS_OBJECT_MASK, IS_DONE_ANALYZING_FOR_VIDEO_EFFECTS

Notes​

  • Reads properties directly from sequence context (sequence optional; active sequence by default).
  • WORK_AREA_IN_POINT_SECONDS and WORK_AREA_OUT_POINT_SECONDS read Premiere's Work Area bounds as finite seconds (26.5+). These are not Sequence In/Out or export-range settings. Each property requires only its corresponding WorkAreaUtils getter; missing APIs or invalid native values fail explicitly, with no fallback to Sequence In/Out.
  • Work Area reads do not commit pending grouped Actions. Read after the intended mutation has committed. Use prSequenceSetWorkArea for writes, not prSetSequenceProperty.
  • Includes timing-audit metadata such as VIDEO_DISPLAY_FORMAT, AUDIO_DISPLAY_FORMAT, VIDEO_FRAME_RATE, and AUDIO_SAMPLE_RATE.
  • HAS_OBJECT_MASK reports whether Premiere currently sees any object mask usage on that sequence.
  • Display-format values are returned as stable DSL strings when known, otherwise as UNKNOWN_*_TYPE_<number> so host drift stays visible.

See Also​

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

Examples​

Create Sequence From Local `.sqpreset` Path

Creates a sequence from a fixed local `.sqpreset` path. This stays visible as the canonical local-path counterpart to the portable embedded-preset example, and its runtime check confirms that the unusual 2000x1000 frame size really came from the preset.

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

Topics: sequence creation, presets, runtime validation

Source: patterns/ex-sequence-create-from-preset-fixed-path.json

Download JSON

Read Active Sequence Summary

Reads the active sequence name and video track count.

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

Topics: sequence inspection

Source: patterns/ex-sequence-read-active-summary.json

Download JSON

Render Active-Sequence Frames At Equal Distances To Fixed Folder

Exports a small evenly spaced set of `.png` frames across the active sequence to a fixed folder path, so visual timeline sampling can be runtime-validated deterministically.

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

Topics: frame export, visual probing, timeline sampling, runtime validation

Source: patterns/ex-sequence-render-active-sequence-frames-equal-distances-fixed-folder.json

Download JSON