Type

NewMedia

A probed file, as addMedia, fillSlot, replaceClipMedia and freezeFrame take it: a MediaItem without its id.

Fields

  • hasAudioboolrequired

    Whether the file carries an audio stream.

  • kindMediaKindrequired

    What the host's probe decided the file is.

  • namestringrequired

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

  • pathstringrequired

    Absolute path on disk. Adding a path already in the bin is a no-op, so re-imports cannot duplicate media.

  • audioCodecstringoptional

    Codec of the embedded audio, when there is any.

  • audioTracksAudioTrack[]optional

    Every audio stream, in file order; see MediaItem::audio_tracks. Defaulted so a caller from before the list can still add media.

  • colorSpaceColorSpaceoptional · default "sdr"

    What the probe found the picture recorded in; see MediaItem::color_space. Defaulted, for a caller from before it, to SDR.

  • durationnumberoptional

    Seconds, or None when the container did not report one - clips of such media get a five-second fallback length.

  • frameRatenumberoptional

    Frames per second as a decimal, for display.

  • frameRateFractionstringoptional

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

  • heightintegeroptional

    Pixel height, same terms as width.

  • originMediaOriginoptional

    What made the file, when the editor did; see MediaItem::origin. Defaulted so an import, and a caller from before origins, says nothing.

  • videoCodecstringoptional

    Codec name as probed, e.g. "h264". Informational.

  • widthintegeroptional

    Pixel width, when the probe found one.

Tip

Build one from a media.probe reply: copy path, duration, kind and audioTracks; take width, height, frameRate, frameRateFraction and videoCodec from its video; audioCodec from its audio; hasAudio is whether audio is present; name is the file's basename. Or skip all that with media.import.