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
audioCodecstringoptionalCodec of the embedded audio, when there is any.
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 -
hasAudiostill 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.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.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.
durationnumberoptionalSeconds. None when the container did not say.
frameRatenumberoptionalFrames per second as a decimal - convenient for display, not exact.
frameRateFractionstringoptionalThe exact fraction the engine works in, e.g. "30000/1001".
hasAudiobooloptional · default falseWhether the file carries an audio stream; gates
DetachAudio.heightintegeroptionalPixel 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.
What the probe decided the file is; fixes which
ClipKindits clips get.namestringoptional · default ""Display name in the bin, normally the file's basename.
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.
placeholderbooloptionalTrue 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.videoCodecstringoptionalCodec name as the probe reported it, e.g. "h264". Informational.
widthintegeroptionalPixel width, when the file has pictures and the probe found one.