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