mmfileinfo

Information about multimedia file

Syntax

info = mmfileinfo(filename)


Description

info = mmfileinfo(filename) returns a structure, info, with fields containing information about the contents of the multimedia file identified by filename. The filename is specified as a character vector or string scalar.

If filename is a URL, mmfileinfo might take a long time to return because it must first download the file. For large files, downloading can take several minutes. To avoid blocking the MATLAB^® command line while this processing takes place, download the file before calling mmfileinfo.

The info structure contains the following fields, listed in the order they appear in the structure.

Field	Description
Filename	Text indicating the name of the file.
Path	Text indicating the absolute path to the file.
Duration	Length of the file in seconds.
Audio	Structure containing information about the audio data in the file. See Audio Data for more information about this data structure.
Video	Structure containing information about the video data in the file. See Video Data for more information about this data structure.

Audio Data

The Audio structure contains the following fields, listed in the order they appear in the structure. If the file does not contain audio data, the fields in the structure are empty.

Field	Description
Format	Text indicating the audio format.
NumChannels	Number of audio channels.

Video Data

The Video structure contains the following fields, listed in the order they appear in the structure. If the file does not contain video data, the fields in the structure are empty.

Field	Description
Format	Text indicating the video format.
Height	Height of the video frame.
Width	Width of the video frame.

Examples

Display information about the example file xylophone.mpg:

info = mmfileinfo('xylophone.mpg')
audio = info.Audio
video = info.Video

MATLAB returns:

info = 
    Filename: 'xylophone.mpg'
        Path: 'matlabroot\toolbox\matlab\audiovideo'
    Duration: 4.7020
       Audio: [1x1 struct]
       Video: [1x1 struct]

audio = 
              Format: 'MPEG'
         NumChannels: 2

video = 
    Format: 'MPEG1'
    Height: 240
     Width: 320

where Path is system-dependent.

Version History

Introduced before R2006a