Type

MediaItem

One entry of the bin. The probe's findings are stored, so a project opens meaningfully even when the file is missing.

Fields

  • audioCodecstringoptional

    Codec of the embedded audio, when there is any.

  • audioTracksAudioTrack[]optional

    Every audio stream the file carries, in file order, when the probe listed them. Empty for a file without sound and for a document from before the list was kept - hasAudio still says whether there is sound at all. More than one is a recording with its tracks apart, and what lets a clip choose between them. Skipped when empty, so documents without such media stay byte-identical.

  • colorRangeColorRangeoptional

    The levels the picture is read as, over the file's own tag; see ColorRange. Absent, and left out of the document, for the tag.

  • colorSpaceColorSpaceoptional

    What the probe found the picture recorded in: HLG or PQ for HDR. Left out of the document for SDR - and absent from one written before it was kept, which reads as SDR.

  • durationnumberoptional

    Seconds. None when the container did not say.

  • frameRatenumberoptional

    Frames per second as a decimal - convenient for display, not exact.

  • frameRateFractionstringoptional

    The exact fraction the engine works in, e.g. "30000/1001".

  • hasAudiobooloptional · default false

    Whether the file carries an audio stream; gates DetachAudio.

  • heightintegeroptional

    Pixel height, same terms as width.

  • idstringoptional · default ""

    Minted by the editor ("m1", "m2", ...) and never re-issued, even across a save/load - clips reference media by this id.

  • kindMediaKindoptional · default "video"

    What the probe decided the file is; fixes which ClipKind its clips get.

  • namestringoptional · default ""

    Display name in the bin, normally the file's basename.

  • originMediaOriginoptional

    Where the file came from when the editor made it; see MediaOrigin. Absent, and left out of the document, for an import, and read as absent when it names an origin this build does not know - the file is still a file, just one shelved with the imports.

  • pathstringoptional · default ""

    Absolute path on the user's disk. Doubles as the duplicate check: adding the same path twice is a no-op.

  • placeholderbooloptional

    True when this item is a template slot: a stand-in whose metadata says what kind of media belongs here, waiting to be replaced by the user's own file (Command::FillSlot). In a creator's own project the path is still real; only a packed template bundle blanks it. Skipped when false, so documents without templates stay byte-identical.

  • videoCodecstringoptional

    Codec name as the probe reported it, e.g. "h264". Informational.

  • widthintegeroptional

    Pixel width, when the file has pictures and the probe found one.