Type
NewMedia
A probed file, as addMedia, fillSlot, replaceClipMedia and freezeFrame
take it: a MediaItem without its id.
Fields
hasAudioboolrequiredWhether the file carries an audio stream.
What the host's probe decided the file is.
namestringrequiredDisplay name for the bin, normally the file's basename.
pathstringrequiredAbsolute path on disk. Adding a path already in the bin is a no-op, so re-imports cannot duplicate media.
audioCodecstringoptionalCodec of the embedded audio, when there is any.
Every audio stream, in file order; see
MediaItem::audio_tracks. Defaulted so a caller from before the list can still add media.What the probe found the picture recorded in; see
MediaItem::color_space. Defaulted, for a caller from before it, to SDR.durationnumberoptionalSeconds, or None when the container did not report one - clips of such media get a five-second fallback length.
frameRatenumberoptionalFrames per second as a decimal, for display.
frameRateFractionstringoptionalThe exact rate fraction the engine works in, e.g. "30000/1001".
heightintegeroptionalPixel height, same terms as
width.What made the file, when the editor did; see
MediaItem::origin. Defaulted so an import, and a caller from before origins, says nothing.videoCodecstringoptionalCodec name as probed, e.g. "h264". Informational.
widthintegeroptionalPixel width, when the probe found one.
Tip
Build one from a
media.probereply: copypath,duration,kindandaudioTracks; takewidth,height,frameRate,frameRateFractionandvideoCodecfrom itsvideo;audioCodecfrom itsaudio;hasAudiois whetheraudiois present;nameis the file's basename. Or skip all that withmedia.import.