Skip to main content

Get Project Item Timing Descriptor

Category: Pr Bins & Project Items Get Project Item Timing Descriptor block screenshot

Returns the whole normalized descriptor when `property` is omitted, or one selected field when `property` is supplied. Numeric media timing and Project Item state come from typed APIs. The `-400000` sentinel is normalized to null only for the verified Project Item In/Out fields. Source-timecode value and format come only from explicitly present Dynamic Media XMP `altTimecode` or `startTimecode` fields, with provenance retained. The block never reads visible Project Panel columns or Project Metadata and never treats those metadata domains as automatic fallbacks. Drop/Non-Drop is not inferred from nominal frame rate. Supported source timecode requires a valid value and recognized explicit XMP format; absent data, read failures, unknown formats, and unsupported classifications have distinct statuses. `project_item_kind` classifies composition safety; it does not distinguish video, audio, and still footage, and the current host surface cannot reliably identify subclips.

Inputs​

InputRequiredValue KindTypesEnum Values
itemyesexpressionreference, string—
propertynoenumenum-stringproject_item_kind, media_start_seconds_or_null, media_duration_seconds_or_null, current_in_seconds_or_null, current_out_seconds_or_null, interpreted_frame_rate_or_null, has_proxy_or_null, proxy_path_or_null, source_timecode_value_or_null, source_timecode_format_or_null, source_timecode_status, source_timecode_provenance, warnings

Notes​

  • Returns a normalized descriptor object when property is omitted, or the selected field when property is supplied.
  • Numeric media start/duration, current Project Item In/Out, interpreted frame rate, and proxy state come from typed APIs. The verified -400000 unset sentinel is normalized to null for Project Item In/Out only.
  • Source-timecode value and format come only from explicitly present Dynamic Media XMP altTimecode or startTimecode fields. The returned provenance identifies which recognized container supplied them.
  • This expression never consults visible Project Panel columns or complete Project Metadata. Those remain separate data surfaces and are not automatic fallbacks.
  • Drop/Non-Drop is never inferred from nominal frame rate. SUPPORTED requires a syntactically valid value plus a recognized explicit XMP format. Incomplete or unknown-format evidence is NEEDS_EXPLICIT_CHOICE, an absent pair is UNAVAILABLE, an XMP read failure is UNVERIFIED, and an unknown or unsupported compound classification is UNSUPPORTED.
  • project_item_kind is a composition-safety classification, not a promise to distinguish video, audio, or still media. The current public host surface does not identify subclips reliably; callers must not treat FOOTAGE as proof that an item is not a subclip when that distinction matters.
  • Proxy path/state are reported separately; timing continues to describe the master Project Item contract.
  • The expression currently performs fresh sequential host reads on every call. This deliberately favors current values and deterministic UXP access over unmeasured caching; measure representative tables before adding a run-scoped snapshot optimization.

See Also​

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