Mercurial > mplayer.hg
annotate DOCS/tech/nut.txt @ 20911:5ab1e8c8f749
bump date of NUT spec for previous commit
author | ods15 |
---|---|
date | Tue, 14 Nov 2006 17:05:20 +0000 |
parents | 824cb042e035 |
children | e53110c2d071 |
rev | line source |
---|---|
19056
36f993b7f91d
freeze (this is pretty much oded shimons patch from a few month ago)
michael
parents:
18899
diff
changeset
|
1 ================================== |
20911 | 2 NUT Open Container Format 20061114 |
19056
36f993b7f91d
freeze (this is pretty much oded shimons patch from a few month ago)
michael
parents:
18899
diff
changeset
|
3 ================================== |
9294 | 4 |
5 | |
6 | |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
7 Intro: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
8 ====== |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
9 |
20649 | 10 NUT is a Free multimedia container format for storeage of audio, video, |
11 subtitles and related user defined streams, it provides exact timestamps for | |
12 synchronization and seeking, is simple, has low overhead and can recover | |
13 in case of errors in the stream | |
14 | |
15 other common multimedia container formats are AVI, OGG, Matroska, MP4, MOV | |
16 ASF, MPEG-PS, MPEG-TS | |
17 | |
18 | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
19 Features / goals: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
20 (supported by the format, not necessarily by a specific implementation) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
21 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
22 Simple |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
23 use the same encoding for nearly all fields |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
24 simple decoding, so slow CPUs (and embedded systems) can handle it |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
25 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
26 Extendible |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
27 no limit for the possible values of all fields (using universal vlc) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
28 allow adding of new headers in the future |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
29 allow adding more fields at the end of headers |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
30 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
31 Compact |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
32 ~0.2% overhead, for normal bitrates |
17438 | 33 index is <100kb per hour |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
34 a usual header for a file is about 100 bytes (audio + video headers together) |
17326 | 35 a packet header is about ~1-5 bytes |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
36 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
37 Error resistant |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
38 seeking / playback without an index |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
39 headers & index can be repeated |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
40 damaged files can be played back with minimal data loss and fast |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
41 resync times |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
42 |
19056
36f993b7f91d
freeze (this is pretty much oded shimons patch from a few month ago)
michael
parents:
18899
diff
changeset
|
43 The spec is frozen. All files following spec will be compatible unless the |
36f993b7f91d
freeze (this is pretty much oded shimons patch from a few month ago)
michael
parents:
18899
diff
changeset
|
44 spec is unfrozen. |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
45 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
46 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
47 Definitions: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
48 ============ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
49 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
50 MUST the specific part must be done to conform to this standard |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
51 SHOULD it is recommended to be done that way, but not strictly required |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
52 |
20622 | 53 keyframe |
20772 | 54 A keyframe is a frame from which you can start decoding, a more |
55 exact definition is below | |
20631 | 56 The nth frame is a keyframe if and only if frames n, n+1, ... in |
57 presentation order (that are all frames with a pts >= frame[n].pts) can | |
58 be decoded successfully without reference to frames prior n in storeage | |
59 order (that are all frames with a dts < frame[n].dts) | |
60 if no such frames exist (for example due to use of overlapped transforms | |
61 like the MDCT in an audio codec) then the definition shall be extended | |
62 by droping n out of the set of frames which must be decodable, if this | |
63 is still insufficient then n+1 shall be droped, and so on until there is | |
64 a keyframe | |
20633
44ea011155d1
attempt to fix the unbound future frame issue with keyframes on the muxer side
michael
parents:
20631
diff
changeset
|
65 every frame which is marked as a keyframe MUST be a keyframe according to |
44ea011155d1
attempt to fix the unbound future frame issue with keyframes on the muxer side
michael
parents:
20631
diff
changeset
|
66 the defintion above, a muxer MUST mark every frame it knows is a keyframe |
44ea011155d1
attempt to fix the unbound future frame issue with keyframes on the muxer side
michael
parents:
20631
diff
changeset
|
67 as such, a muxer SHOULD NOT analyze future frames to determine the |
44ea011155d1
attempt to fix the unbound future frame issue with keyframes on the muxer side
michael
parents:
20631
diff
changeset
|
68 keyframe status of the current frame but instead just set the frame as |
44ea011155d1
attempt to fix the unbound future frame issue with keyframes on the muxer side
michael
parents:
20631
diff
changeset
|
69 non keyframe |
20622 | 70 (FIXME maybe move somewhere else?) |
20870 | 71 pts |
72 presentation time of the first frame/sample that is completed by decoding | |
73 the coded frame. | |
74 dts | |
75 of a frame is the time when it is input into the decoder | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
76 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
77 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
78 Syntax: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
79 ======= |
9294 | 80 |
16428 | 81 Since NUT heavily uses variable length fields, the simplest way to describe it |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
82 is using a pseudocode approach. |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
83 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
84 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
85 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
86 Conventions: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
87 ============ |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
88 |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
89 The data types have a name, used in the bitstream syntax description, a short |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
90 text description and a pseudocode (functional) definition, optional notes may |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
91 follow: |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
92 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
93 name (text description) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
94 functional definition |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
95 [Optional notes] |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
96 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
97 The bitstream syntax elements have a tagname and a functional definition, they |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
98 are presented in a bottom up approach, again optional notes may follow and |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
99 are reproduced in the tag description: |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
100 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
101 name: (optional note) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
102 functional definition |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
103 [Optional notes] |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
104 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
105 The in-depth tag description follows the bitstream syntax. |
16428 | 106 The functional definition has a C-like syntax. |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
107 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
108 |
12209 | 109 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
110 Type definitions: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
111 ================= |
12209 | 112 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
113 f(n) (n fixed bits in big-endian order) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
114 u(n) (unsigned number encoded in n bits in MSB-first order) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
115 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
116 v (variable length value, unsigned) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
117 value=0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
118 do{ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
119 more_data u(1) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
120 data u(7) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
121 value= 128*value + data |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
122 }while(more_data) |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
123 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
124 s (variable length value, signed) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
125 temp v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
126 temp++ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
127 if(temp&1) value= -(temp>>1) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
128 else value= (temp>>1) |
9323 | 129 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
130 b (binary data or string, to be use in vb, see below) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
131 for(i=0; i<length; i++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
132 data[i] u(8) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
133 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
134 [Note: strings MUST be encoded in UTF-8] |
17835 | 135 [Note: the character NUL (U+0000) is not legal within |
136 or at the end of a string.] | |
9295 | 137 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
138 vb (variable length binary data or string) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
139 length v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
140 value b |
12117 | 141 |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
142 t (v coded universal timestamp) |
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
143 tmp v |
17872 | 144 id= tmp % time_base_count |
145 value= (tmp / time_base_count) * time_base[id] | |
9295 | 146 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
147 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
148 Bitstream syntax: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
149 ================= |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
150 |
20618
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
151 file: |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
152 file_id_string |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
153 while(!eof){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
154 if(next_byte == 'N'){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
155 packet_header |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
156 switch(startcode){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
157 case main_startcode: main_header; break; |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
158 case stream_startcode:stream_header; break; |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
159 case info_startcode: info_packet; break; |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
160 case index_startcode: index; break; |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
161 case syncpoint_startcode: syncpoint; break; |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
162 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
163 packet_footer |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
164 }else |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
165 frame |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
166 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
167 |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
168 the structure of a undamaged file should look like the following, but |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
169 demuxers should be flexible and be able to deal with damaged headers so the |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
170 above is a better loop in practice (not to mention its simpler) |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
171 note, demuxers MUST be able to deal with new and unknown headers |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
172 |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
173 file: |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
174 file_id_string |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
175 while(!eof){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
176 packet_header, main_header, packet_footer |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
177 reserved_headers |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
178 for(i=0; i<stream_count; i++){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
179 packet_header, stream_header, packet_footer |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
180 reserved_headers |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
181 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
182 while(next_code == info_startcode){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
183 packet_header, info_packet, packet_footer |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
184 reserved_headers |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
185 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
186 if(next_code == index_startcode){ |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
187 packet_header, index_packet, packet_footer |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
188 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
189 if (!eof) while(next_code != main_startcode){ |
20910
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
190 packet_header, syncpoint, packet_footer |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
191 do{ |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
192 frame |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
193 }while(next_code == framecode); |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
194 reserved_headers |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
195 while(next_code == info_startcode){ |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
196 packet_header, info_packet, packet_footer |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
197 reserved_headers |
20618
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
198 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
199 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
200 } |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
201 |
4f0d58f5b10d
move file up so its found first, this probably improves readability
michael
parents:
20468
diff
changeset
|
202 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
203 Common elements: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
204 ---------------- |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
205 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
206 reserved_bytes: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
207 for(i=0; i<forward_ptr - length_of_non_reserved; i++) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
208 reserved u(8) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
209 [a demuxer MUST ignore any reserved bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
210 a muxer MUST NOT write any reserved bytes, as this would make it |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
211 impossible to add new fields at the end of packets in the future |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
212 in a compatible way] |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
213 |
17845 | 214 packet_header |
215 startcode f(64) | |
216 forward_ptr v | |
217 if(forward_ptr > 4096) | |
218 header_checksum u(32) | |
219 | |
220 packet_footer | |
221 reserved_bytes | |
222 checksum u(32) | |
17873 | 223 [Note: in index packet, reserved_bytes comes before index_ptr] |
17845 | 224 |
225 reserved_headers | |
226 while(next_byte == 'N' && next_code != main_startcode | |
227 && next_code != stream_startcode | |
228 && next_code != info_startcode | |
229 && next_code != index_startcode | |
230 && next_code != syncpoint_startcode){ | |
231 packet_header | |
232 packet_footer | |
233 } | |
234 | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
235 Headers: |
10824 | 236 |
20619 | 237 main_header: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
238 version v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
239 stream_count v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
240 max_distance v |
17872 | 241 time_base_count v |
242 for(i=0; i<time_base_count; i++) | |
243 time_base_nom v | |
244 time_base_denom v | |
245 time_base[i]= time_base_nom/time_base_denom | |
17437 | 246 tmp_pts=0 |
247 tmp_mul=1 | |
248 tmp_stream=0 | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
249 for(i=0; i<256; ){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
250 tmp_flag v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
251 tmp_fields v |
17719
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
252 if(tmp_fields>0) tmp_pts s |
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
253 if(tmp_fields>1) tmp_mul v |
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
254 if(tmp_fields>2) tmp_stream v |
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
255 if(tmp_fields>3) tmp_size v |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
256 else tmp_size=0 |
17719
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
257 if(tmp_fields>4) tmp_res v |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
258 else tmp_res=0 |
17719
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
259 if(tmp_fields>5) count v |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
260 else count= tmp_mul - tmp_size |
17719
6f1bc4789a5d
update tmp_field numbers (pretty much just cosmetic)
michael
parents:
17718
diff
changeset
|
261 for(j=6; j<tmp_fields; j++){ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
262 tmp_reserved[i] v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
263 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
264 for(j=0; j<count && i<256; j++, i++){ |
17612 | 265 if (i == 'N') { |
17718 | 266 flags[i]= FLAG_INVALID; |
17612 | 267 j--; |
268 continue; | |
269 } | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
270 flags[i]= tmp_flag; |
17887 | 271 stream_id[i]= tmp_stream; |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
272 data_size_mul[i]= tmp_mul; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
273 data_size_lsb[i]= tmp_size + j; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
274 pts_delta[i]= tmp_pts; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
275 reserved_count[i]= tmp_res; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
276 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
277 } |
9294 | 278 |
279 stream_header: | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
280 stream_id v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
281 stream_class v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
282 fourcc vb |
17872 | 283 time_base_id v |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
284 msb_pts_shift v |
17577 | 285 max_pts_distance v |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
286 decode_delay v |
17939 | 287 stream_flags v |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
288 codec_specific_data vb |
17640 | 289 if(stream_class == video){ |
290 width v | |
291 height v | |
292 sample_width v | |
293 sample_height v | |
294 colorspace_type v | |
295 }else if(stream_class == audio){ | |
296 samplerate_nom v | |
297 samplerate_denom v | |
298 channel_count v | |
299 } | |
16429 | 300 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
301 Basic Packets: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
302 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
303 frame: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
304 frame_code f(8) |
17718 | 305 frame_flags= flags[frame_code] |
306 if(frame_flags&FLAG_CODED){ | |
307 coded_flags v | |
308 frame_flags ^= coded_flags | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
309 } |
17887 | 310 if(frame_flags&FLAG_STREAM_ID){ |
311 stream_id v | |
312 } | |
313 if(frame_flags&FLAG_CODED_PTS){ | |
314 coded_pts v | |
315 } | |
17718 | 316 if(frame_flags&FLAG_SIZE_MSB){ |
317 data_size_msb v | |
17437 | 318 } |
17887 | 319 if(frame_flags&FLAG_RESERVED) |
320 reserved_count[frame_code] v | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
321 for(i=0; i<reserved_count[frame_code]; i++) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
322 reserved v |
17723 | 323 if(frame_flags&FLAG_CHECKSUM){ |
17711 | 324 checksum u(32) |
17584 | 325 } |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
326 data |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
327 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
328 index: |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
329 max_pts t |
17438 | 330 syncpoints v |
17720 | 331 for(i=0; i<syncpoints; i++){ |
17800 | 332 syncpoint_pos_div16 v |
17438 | 333 } |
334 for(i=0; i<stream_count; i++){ | |
17615
363d23eb55d3
fix index, first keyframe cannot be written with pts=0
ods15
parents:
17612
diff
changeset
|
335 last_pts= -1 |
17720 | 336 for(j=0; j<syncpoints; ){ |
17438 | 337 x v |
338 type= x & 1 | |
339 x>>=1 | |
17455 | 340 n=j |
17438 | 341 if(type){ |
342 flag= x & 1 | |
343 x>>=1 | |
344 while(x--) | |
17455 | 345 has_keyframe[n++][i]=flag |
346 has_keyframe[n++][i]=!flag; | |
17438 | 347 }else{ |
348 while(x != 1){ | |
17455 | 349 has_keyframe[n++][i]=x&1; |
17438 | 350 x>>=1; |
351 } | |
352 } | |
17455 | 353 for(; j<n && j<syncpoints; j++){ |
354 if (!has_keyframe[j][i]) continue | |
355 A v | |
17531 | 356 if(!A){ |
357 A v | |
358 B v | |
359 eor_pts[j][i] = last_pts + A + B | |
360 }else | |
361 B=0 | |
362 keyframe_pts[j][i] = last_pts + A | |
363 last_pts += A + B | |
17455 | 364 } |
17438 | 365 } |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
366 } |
17873 | 367 reserved_bytes |
17726 | 368 index_ptr u(64) |
9294 | 369 |
17711 | 370 info_packet: |
17669 | 371 stream_id_plus1 v |
20658 | 372 chapter_id s (Note due to a typo this was v |
373 until 2006-11-04) | |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
374 chapter_start t |
17708 | 375 chapter_len v |
17669 | 376 count v |
377 for(i=0; i<count; i++){ | |
378 name vb | |
379 value s | |
380 if (value==-1){ | |
381 type= "UTF-8" | |
382 value vb | |
383 }else if (value==-2){ | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
384 type vb |
17669 | 385 value vb |
386 }else if (value==-3){ | |
17685 | 387 type= "s" |
17326 | 388 value s |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
389 }else if (value==-4){ |
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
390 type= "t" |
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
391 value t |
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
392 }else if (value<-4){ |
17685 | 393 type= "r" |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
394 value.den= -value-4 |
17669 | 395 value.num s |
396 }else{ | |
17685 | 397 type= "v" |
17669 | 398 } |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
399 } |
16506 | 400 |
17326 | 401 syncpoint: |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
402 global_key_pts t |
17800 | 403 back_ptr_div16 v |
12413 | 404 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
405 Complete definition: |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
406 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
407 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
408 Tag description: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
409 ---------------- |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
410 |
12242 | 411 file_id_string |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
412 "nut/multimedia container\0" |
20822 | 413 the very first thing in every nut file, usefull for identifying nut |
414 files | |
9323 | 415 |
416 *_startcode | |
20468 | 417 all startcodes start with 'N' |
12162 | 418 |
419 main_startcode | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
420 0x7A561F5F04ADULL + (((uint64_t)('N'<<8) + 'M')<<48) |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
421 |
12162 | 422 stream_starcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
423 0x11405BF2F9DBULL + (((uint64_t)('N'<<8) + 'S')<<48) |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
424 |
17326 | 425 syncpoint_startcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
426 0xE4ADEECA4569ULL + (((uint64_t)('N'<<8) + 'K')<<48) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
427 |
12162 | 428 index_startcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
429 0xDD672F23E64EULL + (((uint64_t)('N'<<8) + 'X')<<48) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
430 |
12162 | 431 info_startcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
432 0xAB68B596BA78ULL + (((uint64_t)('N'<<8) + 'I')<<48) |
9294 | 433 |
434 version | |
19056
36f993b7f91d
freeze (this is pretty much oded shimons patch from a few month ago)
michael
parents:
18899
diff
changeset
|
435 NUT version. The current value is 3. All lower values are pre-freeze |
12238 | 436 |
20822 | 437 stream_count |
438 number of streams in this file | |
439 | |
20823 | 440 time_base_count |
441 number of different time bases in this file | |
442 this MUST NOT be 0 | |
443 | |
17439
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
444 forward_ptr |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
445 size of the packet data (exactly the distance from the first byte |
17808
278206dd6fbd
clarify, header_checksum is not included in forward_ptr and in packet checksum
ods15
parents:
17801
diff
changeset
|
446 after the packet_header to the first byte of the next packet) |
20822 | 447 every nut packet contains a forward_ptr immedeatly after its startcode |
448 with the exception of frame_code based packets, the forward pointer | |
449 can be used to skip over the packet without decoding its contents | |
17439
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
450 |
12333 | 451 max_distance |
17944 | 452 max distance between startcodes. If p1 and p2 are the byte |
453 positions of the first byte of two consecutive startcodes, then | |
454 p2-p1 MUST be less than or equal to max_distance unless the entire | |
455 span from p1 to p2 comprises a single packet or a syncpoint | |
456 followed by a single frame. This imposition places efficient upper | |
457 bounds on seek operations and allows for the detection of damaged | |
458 frame headers, should a chain of frame headers pass max_distance | |
459 without encountering any startcode. | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
460 |
17439
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
461 syncpoints SHOULD be placed immediately before a keyframe if the |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
462 previous frame of the same stream was a non-keyframe, unless such |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
463 non-keyframe - keyframe transitions are very frequent |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
464 |
17722 | 465 SHOULD be set to <=32768 |
17823
7f81c9ffa0b4
change max_distance back to 64kb and set max frame size to 2*max_distance.
ods15
parents:
17811
diff
changeset
|
466 if the stored value is >65536 then max_distance MUST be set to 65536 |
12501 | 467 |
17823
7f81c9ffa0b4
change max_distance back to 64kb and set max frame size to 2*max_distance.
ods15
parents:
17811
diff
changeset
|
468 This is also half the max frame size without a checksum after the |
7f81c9ffa0b4
change max_distance back to 64kb and set max frame size to 2*max_distance.
ods15
parents:
17811
diff
changeset
|
469 frameheader. |
17799 | 470 |
471 | |
17577 | 472 max_pts_distance |
473 max absoloute difference of pts of new frame from last_pts in the | |
17944 | 474 timebase of the stream, without a checksum after the frameheader. |
475 A frame header MUST include a checksum if abs(pts-last_pts) is | |
476 strictly greater than max_pts_distance. | |
17711 | 477 Note that last_pts is not necessarily the pts of the last frame |
17577 | 478 on the same stream, as it is altered by syncpoint timestamps. |
17801 | 479 SHOULD NOT be higher than 1/timebase |
17577 | 480 |
16429 | 481 stream_id |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
482 Stream identifier |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
483 stream_id MUST be < stream_count |
9294 | 484 |
485 stream_class | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
486 0 video |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
487 1 audio |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
488 2 subtiles |
17793 | 489 3 userdata |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
490 Note: the remaining values are reserved and MUST NOT be used |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
491 a demuxer MUST ignore streams with reserved classes |
9294 | 492 |
493 fourcc | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
494 identification for the codec |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
495 example: "H264" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
496 MUST contain 2 or 4 bytes, note, this might be increased in the future |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
497 if needed |
18899 | 498 the id values used are the same as in avi, so if a codec uses a specific |
499 fourcc in avi then the same fourcc MUST be used here | |
9294 | 500 |
9297 | 501 time_base_nom / time_base_denom = time_base |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
502 the length of a timer tick in seconds, this MUST be equal to the 1/fps |
17939 | 503 if FLAG_FIXED_FPS is set |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
504 time_base_nom and time_base_denom MUST NOT be 0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
505 time_base_nom and time_base_denom MUST be relatively prime |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
506 time_base_denom MUST be < 2^31 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
507 examples: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
508 fps time_base_nom time_base_denom |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
509 30 1 30 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
510 29.97 1001 30000 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
511 23.976 1001 24000 |
17883 | 512 There MUST NOT be 2 identical timebases in a file. |
513 There SHOULD NOT be more timebases than streams. | |
9294 | 514 |
17872 | 515 time_base_id |
20829 | 516 index into the time_base table |
20836 | 517 MUST be < time_base_count |
17872 | 518 |
17328 | 519 convert_ts |
520 To switch from 2 different timebases, the following calculation is | |
521 defined: | |
12413 | 522 |
17328 | 523 ln = from_time_base_nom*to_time_base_denom |
524 sn = from_timestamp | |
525 d1 = from_time_base_denom | |
526 d2 = to_time_base_nom | |
527 timestamp = (ln/d1*sn + ln%d1*sn/d1)/d2 | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
528 Note: this calculation MUST be done with unsigned 64 bit integers, and |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
529 is equivalent to (ln*sn)/(d1*d2) but this would require a 96bit integer |
12413 | 530 |
17532 | 531 compare_ts |
532 Compares timestamps from 2 different timebases, | |
533 if a is before b then compare_ts(a, b) = -1 | |
534 if a is after b then compare_ts(a, b) = 1 | |
535 else compare_ts(a, b) = 0 | |
536 | |
537 Care must be taken that this is done exactly with no rounding errors, | |
538 simply casting to float or double and doing the obvious | |
539 a*timebase > b*timebase is not compliant or correct, neither is the | |
540 same with integers, and | |
541 a*a_timebase.num*b_timebase.den > b*b_timebase.num*a_timebase.den | |
542 will overflow. One possible implementation which shouldn't overflow | |
543 within the range of legal timestamps and timebases is: | |
544 | |
545 if (convert_ts(a, a_timebase, b_timebase) < b) return -1; | |
546 if (convert_ts(b, b_timebase, a_timebase) < a) return 1; | |
547 return 0; | |
548 | |
16429 | 549 msb_pts_shift |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
550 amount of bits in lsb_pts |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
551 MUST be <16 |
9294 | 552 |
12333 | 553 decode_delay |
20870 | 554 size of the reordering buffer used to convert pts to dts |
555 codecs which dont support b frames normaly use 0 | |
556 mpeg1/mpeg2 style codecs with b frames use 1 | |
557 h264 style b pyramid uses 2 | |
558 h264 and future codecs might need values >2 | |
559 audio codecs generally use 0 (we arent aware of any which doesnt | |
560 but its theoretically possible that one exists which needs it >0) | |
17639
56ec8716e25b
some cleanup. enforce decode_delay to not be too high.
ods15
parents:
17615
diff
changeset
|
561 decode_delay MUST NOT be set higher than necessary for a codec. |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
562 |
17939 | 563 stream_flags |
564 Bit Name Description | |
565 1 FLAG_FIXED_FPS indicates that the fps is fixed | |
9294 | 566 |
9356 | 567 codec_specific_data |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
568 private global data for a codec (could be huffman tables or ...) |
19105 | 569 if a codec has a global header it SHOULD be placed in here instead of |
570 at the start of every keyframe | |
571 the exact format is specified in the codec spec | |
19121 | 572 for H.264 the NAL units MUST be formated as in a bytestream |
573 (with 00 00 01 prefixes) | |
12082 | 574 |
575 frame_code | |
20775 | 576 frame_code is a 8bit field which exists before every frame, it can |
577 store part of the size of the frame, the stream number, the timestamp | |
578 and some flags amongth other things, what is not directly stored | |
579 in it but is needed is stored in various fields immedeatly after it | |
580 the values stored in it can be found in the main header | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
581 the value 78 ('N') is forbidden to ensure that the byte is always |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
582 different from the first byte of any startcode |
17794
ea0d4bc79bf1
0x00 and 0xFF should be invalid (libnut does that already and it seems like a good idea to recommand)
michael
parents:
17793
diff
changeset
|
583 a muxer SHOULD mark 0x00 and 0xFF as invalid to improve error |
ea0d4bc79bf1
0x00 and 0xFF should be invalid (libnut does that already and it seems like a good idea to recommand)
michael
parents:
17793
diff
changeset
|
584 detection |
9420 | 585 |
17718 | 586 flags[frame_code], frame_flags |
17940 | 587 Bit Name Description |
17809 | 588 1 FLAG_KEY if set, frame is keyframe |
589 2 FLAG_EOR if set, stream has no relevance on | |
17824 | 590 presentation. (EOR) |
17887 | 591 8 FLAG_CODED_PTS if set, coded_pts is in the frame header |
592 16 FLAG_STREAM_ID if set, stream_id is coded in the frame header | |
17809 | 593 32 FLAG_SIZE_MSB if set, data_size_msb is at frame header, |
594 otherwise data_size_msb is 0 | |
595 64 FLAG_CHECKSUM if set then the frame header contains a checksum | |
17887 | 596 128 FLAG_RESERVED if set, reserved_count is coded in the frame header |
17809 | 597 4096 FLAG_CODED if set, coded_flags are stored in the frame header. |
598 8192 FLAG_INVALID if set, frame_code is invalid. | |
17437 | 599 |
600 EOR frames MUST be zero-length and must be set keyframe. | |
601 All streams SHOULD end with EOR, where the pts of the EOR indicates the | |
602 end presentation time of the final frame. | |
603 An EOR set stream is unset by the first content frames. | |
17551 | 604 EOR can only be unset in streams with zero decode_delay . |
17944 | 605 FLAG_CHECKSUM MUST be set if the frame's data_size is strictly greater than |
606 2*max_distance or the difference abs(pts-last_pts) is strictly greater than | |
607 max_pts_distance (where pts represents this frame's pts and last_pts is | |
608 defined as below). | |
12110
a34dc5a369ca
restrictions to ensure that O(log n) seeking and error recovery is possible
michael
parents:
12084
diff
changeset
|
609 |
20460 | 610 last_pts |
611 the timestamp of the last frame with the same stream_id as the current | |
612 if there is no such frame between the last syncpoint and the current | |
613 frame then the syncpoint timestamp is used, see global_key_pts | |
614 | |
17887 | 615 stream_id[frame_code] |
20778 | 616 if FLAG_STREAM_ID is not set then this is the stream number for the |
617 frame following this frame_code | |
618 if FLAG_STREAM_ID is set then this value has no meaning | |
17826 | 619 MUST be <250 |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
620 |
12082 | 621 data_size_mul[frame_code] |
20778 | 622 if FLAG_SIZE_MSB is set then data_size_msb which is stored after the |
623 frame code is multiplied with it and forms the more significant part | |
624 of the size of the following frame | |
625 if FLAG_SIZE_MSB is not set then this field has no meaning | |
17826 | 626 MUST be <16384 |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
627 |
12082 | 628 data_size_lsb[frame_code] |
20778 | 629 the less significant part of the size of the following frame |
630 this added together with data_size_mul*data_size_msb is the size of | |
631 the following frame | |
17826 | 632 MUST be <16384 |
12082 | 633 |
16429 | 634 pts_delta[frame_code] |
17826 | 635 MUST be <16384 and >-16384 |
20460 | 636 if FLAG_CODED_PTS is set in the flags of the current frame then this |
637 value MUST be ignored, if FLAG_CODED_PTS is not set then pts_delta is the | |
638 difference between the current pts and last_pts | |
12413 | 639 |
17640 | 640 reserved_count[frame_code] |
17825
2a20b0884be8
better max for frame code values, still allowing compact implementation
ods15
parents:
17824
diff
changeset
|
641 MUST be <256 |
17640 | 642 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
643 data_size |
20778 | 644 the size of the following frame |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
645 data_size= data_size_lsb + data_size_msb*data_size_mul; |
12082 | 646 |
16429 | 647 coded_pts |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
648 if coded_pts < (1<<msb_pts_shift) then it is an lsb |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
649 pts, otherwise it is a full pts + (1<<msb_pts_shift) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
650 lsb pts is converted to a full pts by: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
651 mask = (1<<msb_pts_shift)-1; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
652 delta = last_pts - mask/2 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
653 pts = ((pts_lsb-delta)&mask) + delta |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
654 |
16429 | 655 lsb_pts |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
656 least significant bits of the pts in time_base precision |
9294 | 657 Example: IBBP display order |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
658 keyframe pts=0 -> pts=0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
659 frame lsb_pts=3 -> pts=3 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
660 frame lsb_pts=1 -> pts=1 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
661 frame lsb_pts=2 -> pts=2 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
662 ... |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
663 keyframe msb_pts=257 -> pts=257 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
664 frame lsb_pts=255 -> pts=255 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
665 frame lsb_pts=0 -> pts=256 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
666 frame lsb_pts=4 -> pts=260 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
667 frame lsb_pts=2 -> pts=258 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
668 frame lsb_pts=3 -> pts=259 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
669 all pts's of keyframes of a single stream MUST be monotone |
9294 | 670 |
12333 | 671 dts |
20780 | 672 decoding timestamp |
673 the dts of a frame is the timestamp of the first sample which is | |
674 output by a decoder when it is feeded with the frame, note that the | |
675 data output is not neccesarily what is coded in the frame, but may | |
676 be data from previous frames | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
677 dts is calculated by using a decode_delay+1 sized buffer for each |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
678 stream, into which the current pts is inserted and the element with |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
679 the smallest value is removed, this is then the current dts |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
680 this buffer is initalized with decode_delay -1 elements |
17327 | 681 |
682 Pts of all frames in all streams MUST be bigger or equal to dts of all | |
17437 | 683 previous frames in all streams, compared in common timebase. (EOR |
684 frames are NOT exempt from this rule) | |
20846
c1e47896ad80
least restrictive dts ordering rule which ensures frames are in decoding order
michael
parents:
20836
diff
changeset
|
685 Dts of all frames MUST be bigger or equal to dts of all previous frames |
c1e47896ad80
least restrictive dts ordering rule which ensures frames are in decoding order
michael
parents:
20836
diff
changeset
|
686 in the same stream |
12333 | 687 |
9294 | 688 width/height |
20780 | 689 width and height of the video in pixels |
17730 | 690 MUST be set to the coded width/height, MUST NOT be 0 |
9294 | 691 |
692 sample_width/sample_height (aspect ratio) | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
693 sample_width is the horizontal distance between samples |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
694 sample_width and sample_height MUST be relatively prime if not zero |
17795
a4e7458d61ed
little clarification of sample_width/sample_height
michael
parents:
17794
diff
changeset
|
695 both MUST be 0 if unknown otherwise both MUST be non zero |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
696 |
10158
93e5428d0b3e
some changes (michael: is the colorspace_type field needed?)
alex
parents:
10061
diff
changeset
|
697 colorspace_type |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
698 0 unknown |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
699 1 ITU Rec 624 / ITU Rec 601 Y range: 16..235 Cb/Cr range: 16..240 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
700 2 ITU Rec 709 Y range: 16..235 Cb/Cr range: 16..240 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
701 17 ITU Rec 624 / ITU Rec 601 Y range: 0..255 Cb/Cr range: 0..255 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
702 18 ITU Rec 709 Y range: 0..255 Cb/Cr range: 0..255 |
10166 | 703 |
12333 | 704 samplerate_nom / samplerate_denom = samplerate |
17730 | 705 the number of samples per second, MUST NOT be 0 |
9294 | 706 |
17683 | 707 crc32 checksum |
17710 | 708 Generator polynomial is 0x104C11DB7. Starting value is zero. |
17683 | 709 |
9294 | 710 checksum |
17577 | 711 crc32 checksum |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
712 checksum is calculated for the area pointed to by forward_ptr not |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
713 including the checksum itself (from first byte after the |
17808
278206dd6fbd
clarify, header_checksum is not included in forward_ptr and in packet checksum
ods15
parents:
17801
diff
changeset
|
714 packet_header until last byte before the checksum). |
17711 | 715 for frame headers the checksum contains the framecode byte and all |
716 following bytes upto the checksum itself | |
9294 | 717 |
17792 | 718 header_checksum |
719 checksum over the startcode and forward pointer | |
720 | |
17640 | 721 Syncpoint tags: |
722 --------------- | |
723 | |
17800 | 724 back_ptr_div16 |
725 back_ptr = back_ptr_div16 * 16 + 15 | |
726 back_ptr must point to a position within 16 bytes of a syncpoint | |
17439
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
727 startcode. This syncpoint MUST be the closest syncpoint such that at |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
728 least one keyframe with a pts lower or equal to the original syncpoint's |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
729 global_key_pts for all streams lies between it and the current syncpoint. |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
730 |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
731 A stream where EOR is set is to be ignored for back_ptr. |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
732 |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
733 global_key_pts |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
734 After a syncpoint, last_pts of each stream is to be set to: |
17872 | 735 last_pts[i] = convert_ts(global_key_pts, time_base[id], time_base[i]) |
17439
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
736 |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
737 global_key_pts MUST be bigger or equal to dts of all past frames across |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
738 all streams, and smaller or equal to pts of all future frames. |
f6e39517d5b6
cosmetic change, shift stuff around to more logical places
ods15
parents:
17438
diff
changeset
|
739 |
17640 | 740 Index tags: |
741 ----------- | |
742 | |
16429 | 743 max_pts |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
744 The highest pts in the entire file |
9294 | 745 |
17800 | 746 syncpoint_pos_div16 |
747 offset from begginning of file to up to 15 bytes before the syncpoint | |
17438 | 748 referred to in this index entry. Relative to position of last |
749 syncpoint. | |
750 | |
751 has_keyframe | |
752 indicates whether this stream has a keyframe between this syncpoint and | |
753 the last syncpoint. | |
754 | |
755 keyframe_pts | |
756 The pts of the first keyframe for this stream in the region between the | |
17531 | 757 2 syncpoints, in the stream's timebase. (EOR frames are also keyframes) |
758 | |
759 eor_pts | |
760 Coded only if EOR is set at the position of the syncpoint. The pts of | |
761 that EOR. EOR is unset by the first keyframe after it. | |
9294 | 762 |
16429 | 763 index_ptr |
17726 | 764 Length in bytes of the entire index, from the first byte of the |
765 startcode until the last byte of the checksum. | |
766 Note: A demuxer can use this to find the index when it is written at | |
767 EOF, as index_ptr will always be 12 bytes before the end of file if | |
768 there is an index at all. | |
769 | |
16429 | 770 |
17640 | 771 Info tags: |
772 ---------- | |
773 | |
17669 | 774 stream_id_plus1 |
775 Stream this info packet applies to. If zero, packet applies to whole | |
776 file. | |
777 | |
778 chapter_id | |
779 Id of chapter this packet applies to. If zero, packet applies to whole | |
780 file. Positive chapter_id's are real chapters and MUST NOT overlap. | |
781 Negative chapter_id indicate a sub region of file and not a real | |
782 chapter. chapter_id MUST be unique to the region it represents. | |
17711 | 783 chapter_id n MUST not be used unless there are at least n chapters in the |
784 file | |
17669 | 785 |
786 chapter_start | |
17796
6edc4492b777
universal timestamp (= stream_id + timestamp in stream timebase)
michael
parents:
17795
diff
changeset
|
787 timestamp of start of chapter |
17669 | 788 |
789 chapter_len | |
790 Length of chapter in same timebase of chapter_start. | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
791 |
9323 | 792 type |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
793 for example: "UTF8" -> string or "JPEG" -> JPEG image |
17685 | 794 "v" -> unsigned integer |
795 "s" -> signed integer | |
796 "r" -> rational | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
797 Note: nonstandard fields should be prefixed by "X-" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
798 Note: MUST be less than 6 byte long (might be increased to 64 later) |
9323 | 799 |
13308
8ff17d153414
info packet is now file global, while meta pakcet is stream specific, as discussed with Rich
alex
parents:
13047
diff
changeset
|
800 info packet types |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
801 the name of the info entry, valid names are |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
802 "Author" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
803 "Description" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
804 "Copyright" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
805 "Encoder" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
806 the name & version of the software used for encoding |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
807 "Title" |
17669 | 808 "Cover" (allowed types are "PNG" and "JPEG") |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
809 image of the (CD, DVD, VHS, ..) cover (preferably PNG or JPEG) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
810 "Source" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
811 "DVD", "VCD", "CD", "MD", "FM radio", "VHS", "TV", "LD" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
812 Optional: appended PAL, NTSC, SECAM, ... in parentheses |
18899 | 813 "SourceContainer" |
814 "nut", "mkv", "mov", "avi", "ogg", "rm", "mpeg-ps", "mpeg-ts", "raw" | |
815 "SourceCodecTag" | |
816 the source codec id like a fourcc which was used to store a specific | |
817 stream in its SourceContainer | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
818 "CaptureDevice" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
819 "BT878", "BT848", "webcam", ... (more exact names are fine too) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
820 "CreationTime" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
821 "2003-01-20 20:13:15Z", ... |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
822 (ISO 8601 format, see http://www.cl.cam.ac.uk/~mgk25/iso-time.html) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
823 Note: do not forget the timezone |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
824 "Keywords" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
825 "Language" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
826 ISO 639 and ISO 3166 for language/country code |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
827 something like "eng" (US english), can be 0 if unknown |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
828 and "multi" if several languages |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
829 see http://www.loc.gov/standards/iso639-2/englangn.html |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
830 and http://www.din.de/gremien/nas/nabd/iso3166ma/codlstp1/en_listp1.html |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
831 the language code |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
832 "Disposition" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
833 "original", "dub" (translated), "comment", "lyrics", "karaoke" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
834 Note: if someone needs some others, please tell us about them, so we |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
835 can add them to the official standard (if they are sane) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
836 Note: nonstandard fields should be prefixed by "X-" |
17686 | 837 Note: names of fields SHOULD be in English if a word with the same |
17653 | 838 meaning exists in English |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
839 Note: MUST be less than 64 bytes long |
9295 | 840 |
841 value | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
842 value of this name/type pair |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
843 |
9310 | 844 stuffing |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
845 0x80 can be placed in front of any type v entry for stuffing purposes |
17797
b1d80d05eaa8
limit stuffing to prevent header_checksum from endup being useless due to a gb of 0x80 after a 'N'
michael
parents:
17796
diff
changeset
|
846 except the forward_ptr and all fields in the frame header where a |
b1d80d05eaa8
limit stuffing to prevent header_checksum from endup being useless due to a gb of 0x80 after a 'N'
michael
parents:
17796
diff
changeset
|
847 maximum of 8 stuffing bytes per field are allowed |
9294 | 848 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
849 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
850 Structure: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
851 ---------- |
9294 | 852 |
853 the headers MUST be in exactly the following order (to simplify demuxer design) | |
854 main header | |
855 stream_header (id=0) | |
856 stream_header (id=1) | |
857 ... | |
858 stream_header (id=n) | |
859 | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
860 headers may be repeated, but if they are, then they MUST all be repeated |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
861 together and repeated headers MUST be identical |
17547 | 862 |
863 Each set of repeated headers not at the beginning or end of the file SHOULD | |
864 be stored at the earliest possible position after 2^x where x is | |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
865 an integer and the file end, so the headers may be repeated at 4102 if that is |
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
866 the closest position after 2^12=4096 at which the headers can be placed |
9294 | 867 |
17547 | 868 Note: this allows an implementation reading the file to locate backup |
869 headers in O(log filesize) time as opposed to O(filesize) | |
870 | |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
871 headers MUST be placed at least at the start of the file and immediately before |
12501 | 872 the index or at the file end if there is no index |
16428 | 873 headers MUST be repeated at least twice (so they exist three times in a file) |
9295 | 874 |
16685 | 875 there MUST be a sync point immediately before the first frame after any headers |
12503 | 876 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
877 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
878 Index: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
879 ------ |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
880 |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
881 Note: with realtime streaming, there is no end, so no index there either |
17533 | 882 Index MAY only be repeated after main headers. |
17726 | 883 If an index is written anywhere in the file, it MUST be written at end of |
884 file as well. | |
9310 | 885 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
886 |
17669 | 887 Info: |
888 ----- | |
889 | |
20910
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
890 All info packets stored after a main header set MUST also have an identical |
17771 | 891 info packet after every main-stream-header set |
9310 | 892 |
20910
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
893 All info packets not stored after a main header set MUST have |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
894 chapter_id!=0 . |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
895 |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
896 Info packets SHOULD be written after main header sets in non realtime |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
897 streams. |
824cb042e035
allow info packets to appear in mid-stream, outside of main headers.
ods15
parents:
20870
diff
changeset
|
898 |
17771 | 899 If a demuxer has seen several info packets with the same chapter_id and |
900 stream_id then it MUST ignore all but the one with the highest position in | |
901 the file | |
17669 | 902 |
20650 | 903 demxuxers SHOULD NOT search the whole file for info packets |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
904 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
905 demuxer (non-normative): |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
906 ------------------------ |
12501 | 907 |
16428 | 908 in the absence of a valid header at the beginning, players SHOULD search for |
909 backup headers starting at offset 2^x; for each x players SHOULD end their | |
910 search at a particular offset when any startcode is found (including syncpoint) | |
12501 | 911 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
912 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
913 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
914 Semantic requirements: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
915 ====================== |
16429 | 916 |
17018
baf593fcf738
Change MUST to SHOULD have disposition and if applicable language tags.
al
parents:
16843
diff
changeset
|
917 If more than one stream of a given stream class is present, each one SHOULD |
16429 | 918 have info tags specifying disposition, and if applicable, language. |
17018
baf593fcf738
Change MUST to SHOULD have disposition and if applicable language tags.
al
parents:
16843
diff
changeset
|
919 It often highly improves usability and is therefore strongly encouraged. |
16429 | 920 |
921 A demuxer MUST NOT demux a stream which contains more than one stream, or which | |
922 is wrapped in a structure to facilitate more than one stream or otherwise | |
923 duplicate the role of a container. any such file is to be considered invalid. | |
17798
2d02868030f0
double muxing examples (cant hurt to explictly mention the most common)
michael
parents:
17797
diff
changeset
|
924 for example vorbis in ogg in nut is invalid, as is |
2d02868030f0
double muxing examples (cant hurt to explictly mention the most common)
michael
parents:
17797
diff
changeset
|
925 mpegvideo+mpegaudio in mpeg-ps/ts in nut or dvvideo + dvaudio in dv in nut |
16429 | 926 |
12501 | 927 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
928 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
929 Sample code (Public Domain, & untested): |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
930 ======================================== |
9294 | 931 |
932 typedef BufferContext{ | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
933 uint8_t *buf; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
934 uint8_t *buf_ptr; |
9294 | 935 }BufferContext; |
936 | |
937 static inline uint64_t get_bytes(BufferContext *bc, int count){ | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
938 uint64_t val=0; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
939 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
940 assert(count>0 && count<9); |
9294 | 941 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
942 for(i=0; i<count; i++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
943 val <<=8; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
944 val += *(bc->buf_ptr++); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
945 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
946 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
947 return val; |
9294 | 948 } |
949 | |
950 static inline void put_bytes(BufferContext *bc, int count, uint64_t val){ | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
951 uint64_t val=0; |
9294 | 952 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
953 assert(count>0 && count<9); |
9294 | 954 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
955 for(i=count-1; i>=0; i--){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
956 *(bc->buf_ptr++)= val >> (8*i); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
957 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
958 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
959 return val; |
9294 | 960 } |
961 | |
10061 | 962 static inline uint64_t get_v(BufferContext *bc){ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
963 uint64_t val= 0; |
9294 | 964 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
965 for(; space_left(bc) > 0; ){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
966 int tmp= *(bc->buf_ptr++); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
967 if(tmp&0x80) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
968 val= (val<<7) + tmp - 0x80; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
969 else |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
970 return (val<<7) + tmp; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
971 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
972 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
973 return -1; |
9294 | 974 } |
975 | |
10061 | 976 static inline int put_v(BufferContext *bc, uint64_t val){ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
977 int i; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
978 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
979 if(space_left(bc) < 9) return -1; |
9294 | 980 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
981 val &= 0x7FFFFFFFFFFFFFFFULL; // FIXME can only encode upto 63 bits currently |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
982 for(i=7; ; i+=7){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
983 if(val>>i == 0) break; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
984 } |
9294 | 985 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
986 for(i-=7; i>0; i-=7){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
987 *(bc->buf_ptr++)= 0x80 | (val>>i); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
988 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
989 *(bc->buf_ptr++)= val&0x7F; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
990 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
991 return 0; |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
992 } |
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
993 |
12333 | 994 static int64_t get_dts(int64_t pts, int64_t *pts_cache, int delay, int reset){ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
995 if(reset) memset(pts_cache, -1, delay*sizeof(int64_t)); |
12333 | 996 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
997 while(delay--){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
998 int64_t t= pts_cache[delay]; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
999 if(t < pts){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
1000 pts_cache[delay]= pts; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
1001 pts= t; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
1002 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
1003 } |
12333 | 1004 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
1005 return pts; |
12333 | 1006 } |
1007 | |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
1008 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
1009 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
1010 Authors: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
1011 ======== |
10158
93e5428d0b3e
some changes (michael: is the colorspace_type field needed?)
alex
parents:
10061
diff
changeset
|
1012 |
16428 | 1013 Folks from the MPlayer developers mailing list (http://www.mplayerhq.hu/). |
1014 Authors in alphabetical order: (FIXME! Tell us if we left you out) | |
16843 | 1015 Beregszaszi, Alex (alex@fsn.hu) |
1016 Bunkus, Moritz (moritz@bunkus.org) | |
1017 Diedrich, Tobias (ranma+mplayer@tdiedrich.de) | |
1018 Felker, Rich (dalias@aerifal.cx) | |
1019 Franz, Fabian (FabianFranz@gmx.de) | |
1020 Gereoffy, Arpad (arpi@thot.banki.hu) | |
1021 Hess, Andreas (jaska@gmx.net) | |
1022 Niedermayer, Michael (michaelni@gmx.at) | |
1023 Shimon, Oded (ods15@ods15.dyndns.org) |