Man Linux: Main Page and Category List

NAME

       MP4FileInfo - Return a textual summary of an mp4 file

SYNTAX

       #include <mp4.h>

       char* MP4FileInfo(
            const char* mp4FileName,
            MP4TrackId trackId = MP4_INVALID_TRACK_ID
       );

ARGUMENTS

       hFile
              Specifies  the  name  of  the  mp4  file  to which the operation
              applies.

       trackId
              Specifies a track for which a summary is desired. If  the  value
              is  MP4_INVALID_TRACK_ID,  the  summary  info is created for all
              tracks in the mp4 file.

RETURN VALUES

       Upon success, a malloc’ed string containing the summary info.  Upon  an
       error, NULL.

DESCRIPTION

       MP4FileInfo  provides  a  string that contains a textual summary of the
       contents of an mp4 file. This includes the track id’s, the track  type,
       and  track  specific information. For example, for a video track, media
       encoding, image size, frame rate, and bitrate are summarized.

       Note that the returned string is  malloc’ed,  so  it  is  the  caller’s
       responsibility  to free() the string to prevent memory leaks. Also note
       that the returned string contains newlines and tabs which  may  or  may
       not be desirable.

       The following is an example of the output of MP4Info():

       Track   Type   Info
       1        video  MPEG-4  Simple @ L3, 119.625 secs, 1008 kbps, 352x288 @
       24.00 fps
       2       audio  MPEG-4, 119.327 secs, 128 kbps, 44100 Hz
       3       hint   Payload MP4V-ES for track 1
       4       hint   Payload mpeg4-generic for track 2
       5       od     Object Descriptors
       6       scene  BIFS

SEE ALSO

       MP4(3) MP4Info(3)