view Plugins/Input/aac/libmp4v2/API_CHANGES @ 250:b9e6cdce7219 trunk

[svn] Reduce code duplication and add a return statement.

Changes in xxxx
---------------
Change to MP4Create and MP4Modify to allow flags to be set for 64 bit
to allow Quicktime compatibility
Change to MP4CloneTrack and MP4CopyTrack for when you copy a hint
track - you must now specify the track ID in the new file for the
reference track.

Changes in 0.9.9
---------------------------
Added support for ISMA's Ismacrypt specification:
  MP4GetTrackEsdsObjectTypeId replaces MP4GetTrackAudioType 
  and MP4GetTrackVideoType.
  MP4EncAndCloneTrack is used instead of MP4CloneTrack to encrypt a track
  while cloning it.
  MP4EncAndCopyTrack is used instead of MP4CopyTrack to encrypt a track 
  while copying it.
  MP4AddEncAudioTrack adds an encrypted audio track.
  MP4AddEncVideoTrack adds an encrypted video track. 
  

Changes in 0.9.8
---------------------------
  MP4WriteSample - changed "uint8_t * data" to "const uint8_t *data"

Changes from 0.9.6
---------------------------
Modified
  MP4SetHintTrackRtpPayload
    payload parameter to get a dynamic payload is MP4_SET_DYNAMIC_PAYLOAD
    (value 0xff) instead of 0.

Changes from 0.9.5 to 0.9.6
---------------------------
Modified
    MP4GetHintTrackRtpPayload
    MP4SetHintTrackRtpPayload
       get/set the encoding params (a=rtpmap <payloadname>/<timescale>[/<encoding params>])

Changes from 0.9.4 to 0.9.5
---------------------------
Added
    MP4GetTrackAudioMpeg4Type()
        Returns MPEG-4 Audio type (e.g. AAC, CELP, HXVC, MIDI, etc.)
    MP4ReadSampleFromTime()
        Variant of MP4ReadSample() that uses time instead of sample id
        (basically MP4GetSampleIdFromTime() + MP4ReadSample())
    MP4Info()
    MP4FileInfo()
        Returns summary info on tracks in file (from util/mp4info.cpp)

    The following functions add support for mp4 authoring/editting:

    MP4CloneTrack()
        Make a copy of a specified track, without media samples
    MP4CopyTrack()
        Make a copy of a specified track, with or without media samples
    MP4CopySample()
        Make a copy of a specified media sample

    MP4AddTrackEdit()
        Add a track edit list element
    MP4DeleteTrackEdit()
        Delete a track edit list element
    MP4GetTrackNumberOfEdits()
        Return the number of track edit list elements
    MP4GetTrackEditTotalDuration()
        Return the total duration of the track edit list
    MP4GetTrackEditStart()
        Return the edit start time for the edit list element
    MP4GetTrackEditMediaStart()
        Return the media start time for the edit list element
    MP4SetTrackEditMediaStart()
        Set the media start time for the edit list element
    MP4GetTrackEditDuration()
        Return the edit list element duration
    MP4SetTrackEditDuration()
        Set the edit list element duration
    MP4GetTrackEditDwell()
        Return the edit list element dwell parameter, see man page
    MP4SetTrackEditDwell()
        Set the edit list element dwell parameter, see man page
    MP4ReadSampleFromEditTime()
        Apply the edit list timeline to reading a sample
    MP4GetSampleIdFromEditTime()
        Return the sample id for a specified time on the edit list timeline

Modified
    MP4GetSampleIdFromTime()
        Semantic change - now returns sample id corresponding 
        to specified time, not the sample id with the smallest positive
        start time difference from the specified time.


Changes from 0.9.3 to 0.9.4
---------------------------
Added
    MP4GetTrackVideoFrameRate()
        Returns video frame rate (average rate if video is variable rate).

    MP4GetTrackBitRate()
        Returns track average bit rate in bits-per-second.

Changes from 0.9.2 to 0.9.3
---------------------------
Modified
    MP4Optimize()
        Second argument, newFileName, can now be NULL in which case
        a temporary file is created for the results of the optimization.
        Upon success, the existing file specified with the first argument 
        is overwritten with the optimized file.

    MP4GetNumberOfTracks()
    MP4FindTrackId()
        Both have a new optional argument, subType, with default value 0.
        The subType can be specified for audio and video tracks to
        match only a specific encoding type. See man page for more details.

Added
    MP4GetTrackVideoWidth()
        Returns video width in pixels. See man page for caveat.

    MP4GetTrackVideoHeight()
        Returns video height in pixels. See man page for caveat.