annotate Plugins/Input/aac/libmp4v2/API_CHANGES @ 790:8f437afc4f4a trunk

[svn] - more sanity checking
author nenolod
date Fri, 03 Mar 2006 20:09:52 -0800
parents fa848bd484d8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
61
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
1 Changes in xxxx
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
2 ---------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
3 Change to MP4Create and MP4Modify to allow flags to be set for 64 bit
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
4 to allow Quicktime compatibility
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
5 Change to MP4CloneTrack and MP4CopyTrack for when you copy a hint
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
6 track - you must now specify the track ID in the new file for the
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
7 reference track.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
8
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
9 Changes in 0.9.9
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
10 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
11 Added support for ISMA's Ismacrypt specification:
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
12 MP4GetTrackEsdsObjectTypeId replaces MP4GetTrackAudioType
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
13 and MP4GetTrackVideoType.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
14 MP4EncAndCloneTrack is used instead of MP4CloneTrack to encrypt a track
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
15 while cloning it.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
16 MP4EncAndCopyTrack is used instead of MP4CopyTrack to encrypt a track
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
17 while copying it.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
18 MP4AddEncAudioTrack adds an encrypted audio track.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
19 MP4AddEncVideoTrack adds an encrypted video track.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
20
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
21
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
22 Changes in 0.9.8
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
23 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
24 MP4WriteSample - changed "uint8_t * data" to "const uint8_t *data"
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
25
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
26 Changes from 0.9.6
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
27 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
28 Modified
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
29 MP4SetHintTrackRtpPayload
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
30 payload parameter to get a dynamic payload is MP4_SET_DYNAMIC_PAYLOAD
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
31 (value 0xff) instead of 0.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
32
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
33 Changes from 0.9.5 to 0.9.6
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
34 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
35 Modified
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
36 MP4GetHintTrackRtpPayload
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
37 MP4SetHintTrackRtpPayload
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
38 get/set the encoding params (a=rtpmap <payloadname>/<timescale>[/<encoding params>])
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
39
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
40 Changes from 0.9.4 to 0.9.5
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
41 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
42 Added
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
43 MP4GetTrackAudioMpeg4Type()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
44 Returns MPEG-4 Audio type (e.g. AAC, CELP, HXVC, MIDI, etc.)
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
45 MP4ReadSampleFromTime()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
46 Variant of MP4ReadSample() that uses time instead of sample id
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
47 (basically MP4GetSampleIdFromTime() + MP4ReadSample())
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
48 MP4Info()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
49 MP4FileInfo()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
50 Returns summary info on tracks in file (from util/mp4info.cpp)
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
51
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
52 The following functions add support for mp4 authoring/editting:
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
53
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
54 MP4CloneTrack()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
55 Make a copy of a specified track, without media samples
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
56 MP4CopyTrack()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
57 Make a copy of a specified track, with or without media samples
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
58 MP4CopySample()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
59 Make a copy of a specified media sample
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
60
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
61 MP4AddTrackEdit()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
62 Add a track edit list element
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
63 MP4DeleteTrackEdit()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
64 Delete a track edit list element
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
65 MP4GetTrackNumberOfEdits()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
66 Return the number of track edit list elements
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
67 MP4GetTrackEditTotalDuration()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
68 Return the total duration of the track edit list
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
69 MP4GetTrackEditStart()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
70 Return the edit start time for the edit list element
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
71 MP4GetTrackEditMediaStart()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
72 Return the media start time for the edit list element
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
73 MP4SetTrackEditMediaStart()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
74 Set the media start time for the edit list element
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
75 MP4GetTrackEditDuration()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
76 Return the edit list element duration
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
77 MP4SetTrackEditDuration()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
78 Set the edit list element duration
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
79 MP4GetTrackEditDwell()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
80 Return the edit list element dwell parameter, see man page
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
81 MP4SetTrackEditDwell()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
82 Set the edit list element dwell parameter, see man page
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
83 MP4ReadSampleFromEditTime()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
84 Apply the edit list timeline to reading a sample
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
85 MP4GetSampleIdFromEditTime()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
86 Return the sample id for a specified time on the edit list timeline
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
87
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
88 Modified
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
89 MP4GetSampleIdFromTime()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
90 Semantic change - now returns sample id corresponding
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
91 to specified time, not the sample id with the smallest positive
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
92 start time difference from the specified time.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
93
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
94
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
95 Changes from 0.9.3 to 0.9.4
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
96 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
97 Added
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
98 MP4GetTrackVideoFrameRate()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
99 Returns video frame rate (average rate if video is variable rate).
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
100
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
101 MP4GetTrackBitRate()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
102 Returns track average bit rate in bits-per-second.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
103
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
104 Changes from 0.9.2 to 0.9.3
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
105 ---------------------------
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
106 Modified
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
107 MP4Optimize()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
108 Second argument, newFileName, can now be NULL in which case
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
109 a temporary file is created for the results of the optimization.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
110 Upon success, the existing file specified with the first argument
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
111 is overwritten with the optimized file.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
112
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
113 MP4GetNumberOfTracks()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
114 MP4FindTrackId()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
115 Both have a new optional argument, subType, with default value 0.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
116 The subType can be specified for audio and video tracks to
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
117 match only a specific encoding type. See man page for more details.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
118
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
119 Added
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
120 MP4GetTrackVideoWidth()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
121 Returns video width in pixels. See man page for caveat.
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
122
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
123 MP4GetTrackVideoHeight()
fa848bd484d8 [svn] Move plugins to Plugins/
nenolod
parents:
diff changeset
124 Returns video height in pixels. See man page for caveat.