Mercurial > mplayer.hg
annotate DOCS/tech/mpcf.txt @ 16965:d8755974657a
attempt to fix missing and/or broken boundary checks
author | reimar |
---|---|
date | Thu, 10 Nov 2005 20:41:11 +0000 |
parents | 21fa9b28ca75 |
children | baf593fcf738 |
rev | line source |
---|---|
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
1 ======================================== |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
2 NUT Open Container Format DRAFT 20050909 |
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 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
24 index is <10kb per hour (1 keyframe every 3sec) |
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) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
26 a packet header is about ~1-8 bytes |
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] |
9295 | 101 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
102 vb (variable length binary data or string) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
103 length v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
104 value b |
12117 | 105 |
9295 | 106 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
107 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
108 Bitstream syntax: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
109 ================= |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
110 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
111 Common elements: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
112 ---------------- |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
113 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
114 packet header: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
115 forward ptr v |
9294 | 116 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
117 align_byte: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
118 while(not byte aligned) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
119 one f(1) |
9294 | 120 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
121 reserved_bytes: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
122 for(i=0; i<forward_ptr - length_of_non_reserved; i++) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
123 reserved u(8) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
124 [a demuxer MUST ignore any reserved bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
125 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
|
126 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
|
127 in a compatible way] |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
128 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
129 Headers: |
10824 | 130 |
9294 | 131 main header: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
132 main_startcode f(64) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
133 packet header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
134 version v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
135 stream_count v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
136 max_distance v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
137 max_index_distance v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
138 global_time_base_nom v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
139 global_time_base_denom v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
140 for(i=0; i<256; ){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
141 tmp_flag v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
142 tmp_fields v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
143 if(tmp_fields>0) tmp_pts s |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
144 if(tmp_fields>1) tmp_mul v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
145 if(tmp_fields>2) tmp_stream v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
146 if(tmp_fields>3) tmp_size v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
147 else tmp_size=0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
148 if(tmp_fields>4) tmp_res v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
149 else tmp_res=0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
150 if(tmp_fields>5) count v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
151 else count= tmp_mul - tmp_size |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
152 for(j=6; j<tmp_fields; j++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
153 tmp_reserved[i] v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
154 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
155 for(j=0; j<count && i<256; j++, i++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
156 flags[i]= tmp_flag; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
157 stream_id_plus1[i]= tmp_stream; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
158 data_size_mul[i]= tmp_mul; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
159 data_size_lsb[i]= tmp_size + j; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
160 pts_delta[i]= tmp_pts; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
161 reserved_count[i]= tmp_res; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
162 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
163 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
164 reserved_bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
165 checksum u(32) |
9294 | 166 |
167 stream_header: | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
168 stream_startcode f(64) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
169 packet_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
170 stream_id v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
171 stream_class v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
172 fourcc vb |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
173 time_base_nom v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
174 time_base_denom v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
175 msb_pts_shift v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
176 decode_delay v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
177 fixed_fps u(1) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
178 reserved u(7) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
179 codec_specific_data vb |
9294 | 180 |
181 video_stream_header: | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
182 stream_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
183 width v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
184 height v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
185 sample_width v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
186 sample_height v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
187 colorspace_type v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
188 reserved_bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
189 checksum u(32) |
9294 | 190 |
191 audio_stream_header: | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
192 stream_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
193 samplerate_nom v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
194 samplerate_denom v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
195 channel_count v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
196 reserved_bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
197 checksum u(32) |
9420 | 198 |
16429 | 199 other_stream_header: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
200 stream_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
201 reserved_bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
202 checksum u(32) |
16429 | 203 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
204 Basic Packets: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
205 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
206 frame: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
207 frame_code f(8) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
208 if(stream_id_plus1[frame_code]==0){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
209 stream_id v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
210 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
211 if(pts_delta[frame_code]==0){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
212 coded_pts v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
213 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
214 if(flags[frame_code]&1){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
215 data_size_msb v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
216 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
217 for(i=0; i<reserved_count[frame_code]; i++) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
218 reserved v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
219 data |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
220 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
221 index: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
222 index_startcode f(64) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
223 packet header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
224 stream_id v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
225 max_pts v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
226 index_length v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
227 for(i=0; i<index_length; i++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
228 index_pts v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
229 index_position v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
230 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
231 reserved_bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
232 checksum u(32) |
9294 | 233 |
16506 | 234 info_frame: (optional) |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
235 for(;;){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
236 id v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
237 if(id==0) break |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
238 name= info_table[id][0] |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
239 type= info_table[id][1] |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
240 if(type==NULL) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
241 type vb |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
242 if(name==NULL) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
243 name vb |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
244 if(type=="v") |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
245 value v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
246 else |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
247 value vb |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
248 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
249 reserved_bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
250 checksum u(32) |
16506 | 251 |
252 info_packet: (optional) | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
253 info_startcode f(64) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
254 packet header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
255 info_frame |
16506 | 256 |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
257 sync_point: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
258 frame_startcode f(64) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
259 global_timestamp v |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
260 back_ptr v |
12413 | 261 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
262 Complete definition: |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
263 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
264 file: |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
265 file_id_string |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
266 while(!eof && next_code != index_startcode){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
267 main_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
268 for(i=0; i<stream_count; i++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
269 if(next_packet==video_stream_header) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
270 video_stream_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
271 else if(next_packet==audio_stream_header) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
272 audio_stream_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
273 else |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
274 other_stream_header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
275 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
276 while(next_code == info_startcode){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
277 info_packet |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
278 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
279 while(next_code != main_startcode){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
280 if(next_code == frame_startcode) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
281 sync_point |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
282 frame |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
283 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
284 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
285 if (next_code == index_startcode){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
286 while(!eof){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
287 index |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
288 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
289 index_ptr u(64) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
290 } |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
291 |
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
292 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
293 Tag description: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
294 ---------------- |
14854
ebc5136f2a56
some comments and whitespace changes by (Luca Barbato <lu_zero gentoo org>)
michael
parents:
14471
diff
changeset
|
295 |
9294 | 296 forward_ptr |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
297 size of the packet data (exactly the distance from the first byte |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
298 after the forward_ptr to the first byte of the next packet) |
12242 | 299 |
16506 | 300 back_ptr |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
301 real_back_ptr = back_ptr * 8 + 7 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
302 real_back_ptr must point to a position such that a syncpoint |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
303 startcode begins within the next 8 bytes, and such that at least |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
304 one keyframe for each stream lies between the syncpoint to which |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
305 real_back_ptr points, and the current syncpoint. |
16506 | 306 |
12242 | 307 file_id_string |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
308 "nut/multimedia container\0" |
9323 | 309 |
310 *_startcode | |
12162 | 311 all startcodes start with 'N' |
312 | |
313 main_startcode | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
314 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
|
315 |
12162 | 316 stream_starcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
317 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
|
318 |
12333 | 319 frame_startcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
320 0xE4ADEECA4569ULL + (((uint64_t)('N'<<8) + 'K')<<48) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
321 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
322 frame_startcodes SHOULD be placed immediately before a keyframe if the |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
323 previous frame of the same stream was a non-keyframe, unless such |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
324 non-keyframe - keyframe transitions are very frequent |
12365
dc05db3f172f
additional start_code rule (implemenattion does this since a long time already)
michael
parents:
12333
diff
changeset
|
325 |
12162 | 326 index_startcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
327 0xDD672F23E64EULL + (((uint64_t)('N'<<8) + 'X')<<48) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
328 |
12162 | 329 info_startcode |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
330 0xAB68B596BA78ULL + (((uint64_t)('N'<<8) + 'I')<<48) |
9294 | 331 |
332 version | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
333 NUT version. The current value is 2. |
12238 | 334 |
12333 | 335 max_distance |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
336 max distance of frame_startcodes, the distance may only be larger if |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
337 there is only a single frame between the two frame_startcodes this can |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
338 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
|
339 results in too long of a chain |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
340 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
341 SHOULD be set to <=32768 or at least <=65536 unless there is a very |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
342 good reason to set it higher, otherwise reasonable error recovery will |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
343 be impossible |
12501 | 344 |
14919
1d4861b2ac4a
returning to the old index at the end system, alternatives are too complex with questionable advantages
michael
parents:
14911
diff
changeset
|
345 max_index_distance |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
346 max distance of keyframes which are represented in the index, the |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
347 distance between consecutive entries A and B may only be larger if |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
348 there are no keyframes within this stream between A and B |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
349 SHOULD be set to <=32768 or at least <=65536 unless there is a very |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
350 good reason to set it higher |
12501 | 351 |
16429 | 352 stream_id |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
353 Stream identifier |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
354 stream_id MUST be < stream_count |
9294 | 355 |
356 stream_class | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
357 0 video |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
358 1 audio |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
359 2 subtiles |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
360 3 metadata |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
361 4 userdata |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
362 in metadata streams each frame contains exactly one info frame |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
363 Note: the remaining values are reserved and MUST NOT be used |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
364 a demuxer MUST ignore streams with reserved classes |
9294 | 365 |
366 fourcc | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
367 identification for the codec |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
368 example: "H264" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
369 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
|
370 if needed |
9294 | 371 |
9297 | 372 time_base_nom / time_base_denom = time_base |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
373 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
|
374 if fixed_fps is 1 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
375 time_base_nom and time_base_denom MUST NOT be 0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
376 time_base_nom and time_base_denom MUST be relatively prime |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
377 time_base_denom MUST be < 2^31 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
378 examples: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
379 fps time_base_nom time_base_denom |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
380 30 1 30 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
381 29.97 1001 30000 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
382 23.976 1001 24000 |
9294 | 383 |
12413 | 384 global_time_base_nom / global_time_base_denom = global_time_base |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
385 the length of a timer tick in seconds |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
386 global_time_base_nom and global_time_base_denom MUST NOT be 0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
387 global_time_base_nom and global_time_base_denom MUST be relatively prime |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
388 global_time_base_denom MUST be < 2^31 |
12413 | 389 |
390 global_timestamp | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
391 timestamp in global_time_base units |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
392 when a global_timestamp is encountered the last_pts of all |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
393 streams is set to the following: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
394 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
395 ln = global_time_base_nom*time_base_denom |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
396 sn = global_timestamp |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
397 d1 = global_time_base_denom |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
398 d2 = time_base_nom |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
399 last_pts = (ln/d1*sn + ln%d1*sn/d1)/d2 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
400 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
|
401 is equivalent to (ln*sn)/(d1*d2) but this would require a 96bit integer |
12413 | 402 |
16429 | 403 msb_pts_shift |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
404 amount of bits in lsb_pts |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
405 MUST be <16 |
9294 | 406 |
12333 | 407 decode_delay |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
408 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
|
409 dts from pts |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
410 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
|
411 B-frames, may be larger for future codecs |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
412 |
9294 | 413 fixed_fps |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
414 1 indicates that the fps is fixed |
9294 | 415 |
9356 | 416 codec_specific_data |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
417 private global data for a codec (could be huffman tables or ...) |
12082 | 418 |
419 frame_code | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
420 the meaning of this byte is stored in the main header |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
421 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
|
422 different from the first byte of any startcode |
9420 | 423 |
12082 | 424 flags[frame_code] |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
425 first of the flags from MSB to LSB are called KD |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
426 if D is 1 then data_size_msb is coded, otherwise data_size_msb is 0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
427 K is the keyframe_type |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
428 0 -> no keyframe, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
429 1 -> keyframe, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
430 flags=4 can be used to mark illegal frame_code bytes |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
431 frame_code=78 must have flags=4 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
432 Note: frames MUST NOT depend(1) upon frames prior to the last |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
433 frame_startcode |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
434 Important: depend(1) means dependency on the container level (NUT) not |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
435 dependency on the codec level |
12110
a34dc5a369ca
restrictions to ensure that O(log n) seeking and error recovery is possible
michael
parents:
12084
diff
changeset
|
436 |
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
|
437 stream_id_plus1[frame_code] |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
438 must be <250 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
439 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
|
440 |
12082 | 441 data_size_mul[frame_code] |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
442 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
|
443 |
12082 | 444 data_size_lsb[frame_code] |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
445 must be <16384 |
12082 | 446 |
16429 | 447 pts_delta[frame_code] |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
448 must be <16384 and >-16384 |
12413 | 449 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
450 data_size |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
451 data_size= data_size_lsb + data_size_msb*data_size_mul; |
12082 | 452 |
16429 | 453 coded_pts |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
454 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
|
455 pts, otherwise it is a full pts + (1<<msb_pts_shift) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
456 lsb pts is converted to a full pts by: |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
457 mask = (1<<msb_pts_shift)-1; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
458 delta = last_pts - mask/2 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
459 pts = ((pts_lsb-delta)&mask) + delta |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
460 |
16429 | 461 lsb_pts |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
462 least significant bits of the pts in time_base precision |
9294 | 463 Example: IBBP display order |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
464 keyframe pts=0 -> pts=0 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
465 frame lsb_pts=3 -> pts=3 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
466 frame lsb_pts=1 -> pts=1 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
467 frame lsb_pts=2 -> pts=2 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
468 ... |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
469 keyframe msb_pts=257 -> pts=257 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
470 frame lsb_pts=255 -> pts=255 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
471 frame lsb_pts=0 -> pts=256 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
472 frame lsb_pts=4 -> pts=260 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
473 frame lsb_pts=2 -> pts=258 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
474 frame lsb_pts=3 -> pts=259 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
475 all pts's of keyframes of a single stream MUST be monotone |
9294 | 476 |
12333 | 477 dts |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
478 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
|
479 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
|
480 the smallest value is removed, this is then the current dts |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
481 this buffer is initalized with decode_delay -1 elements |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
482 all frames must be monotone, that means a frame |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
483 which occurs later in the stream must have a larger or equal dts |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
484 than an earlier frame |
12333 | 485 |
9294 | 486 width/height |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
487 MUST be set to the coded width/height |
9294 | 488 |
489 sample_width/sample_height (aspect ratio) | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
490 sample_width is the horizontal distance between samples |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
491 sample_width and sample_height MUST be relatively prime if not zero |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
492 MUST be 0 if unknown |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
493 |
10158
93e5428d0b3e
some changes (michael: is the colorspace_type field needed?)
alex
parents:
10061
diff
changeset
|
494 colorspace_type |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
495 0 unknown |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
496 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
|
497 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
|
498 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
|
499 18 ITU Rec 709 Y range: 0..255 Cb/Cr range: 0..255 |
10166 | 500 |
12333 | 501 samplerate_nom / samplerate_denom = samplerate |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
502 the number of samples per second |
9294 | 503 |
504 checksum | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
505 adler32 checksum |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
506 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
|
507 including the checksum itself (from first byte after the |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
508 forward_ptr until last byte before the checksum). |
9294 | 509 |
16429 | 510 max_pts |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
511 The highest pts in the stream. |
16429 | 512 |
513 index_pts | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
514 value of the pts of a keyframe relative to the last keyframe |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
515 stored in this index |
9294 | 516 |
517 index_position | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
518 position in bytes of the first byte of a keyframe, relative to the |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
519 last keyframe stored in this index |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
520 there MUST be no keyframe with the same stream_id as this index between |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
521 two consecutive index entries if they are more than max_index_distance |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
522 apart |
9294 | 523 |
16429 | 524 index_ptr |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
525 Length in bytes from the first byte of the first index startcode |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
526 to the first byte of the index_ptr. If there is no index, index_ptr |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
527 MUST NOT be written. |
16429 | 528 |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
529 id |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
530 the ID of the type/name pair, so it is more compact |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
531 0 means end |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
532 |
9323 | 533 type |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
534 for example: "UTF8" -> string or "JPEG" -> JPEG image |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
535 Note: nonstandard fields should be prefixed by "X-" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
536 Note: MUST be less than 6 byte long (might be increased to 64 later) |
9323 | 537 |
13308
8ff17d153414
info packet is now file global, while meta pakcet is stream specific, as discussed with Rich
alex
parents:
13047
diff
changeset
|
538 info packet types |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
539 the name of the info entry, valid names are |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
540 "StreamId" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
541 the stream(s) to which the info packet applies |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
542 "Author" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
543 "Description" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
544 "Copyright" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
545 "Encoder" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
546 the name & version of the software used for encoding |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
547 "Title" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
548 "Cover" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
549 image of the (CD, DVD, VHS, ..) cover (preferably PNG or JPEG) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
550 "Source" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
551 "DVD", "VCD", "CD", "MD", "FM radio", "VHS", "TV", "LD" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
552 Optional: appended PAL, NTSC, SECAM, ... in parentheses |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
553 "CaptureDevice" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
554 "BT878", "BT848", "webcam", ... (more exact names are fine too) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
555 "CreationTime" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
556 "2003-01-20 20:13:15Z", ... |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
557 (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
|
558 Note: do not forget the timezone |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
559 "Keywords" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
560 "TotalTime" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
561 total length of the stream in msecs |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
562 "Language" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
563 ISO 639 and ISO 3166 for language/country code |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
564 something like "eng" (US english), can be 0 if unknown |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
565 and "multi" if several languages |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
566 see http://www.loc.gov/standards/iso639-2/englangn.html |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
567 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
|
568 the language code |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
569 "Disposition" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
570 "original", "dub" (translated), "comment", "lyrics", "karaoke" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
571 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
|
572 can add them to the official standard (if they are sane) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
573 Note: nonstandard fields should be prefixed by "X-" |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
574 Note: MUST be less than 64 bytes long |
9295 | 575 |
576 value | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
577 value of this name/type pair |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
578 |
9310 | 579 stuffing |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
580 0x80 can be placed in front of any type v entry for stuffing purposes |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
581 |
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
582 info_table[][2]={ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
583 {NULL , NULL }, // end |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
584 {NULL , NULL }, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
585 {NULL , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
586 {NULL , "v"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
587 {NULL , "s"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
588 {"StreamId" , "v"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
589 {"Author" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
590 {"Titel" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
591 {"Language" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
592 {"Description" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
593 {"Copyright" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
594 {"Encoder" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
595 {"Keyword" , "UTF8"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
596 {"Cover" , "JPEG"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
597 {"Cover" , "PNG"}, |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
598 {"Disposition" , "UTF8"}, |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
599 }; |
9294 | 600 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
601 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
602 Structure: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
603 ---------- |
9294 | 604 |
605 the headers MUST be in exactly the following order (to simplify demuxer design) | |
606 main header | |
607 stream_header (id=0) | |
608 stream_header (id=1) | |
609 ... | |
610 stream_header (id=n) | |
611 | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
612 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
|
613 together and repeated headers MUST be identical |
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
614 headers MAY only repeat at the closest possible positions after 2^x where x is |
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
615 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
|
616 the closest position after 2^12=4096 at which the headers can be placed |
9294 | 617 |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
618 headers MUST be placed at least at the start of the file and immediately before |
12501 | 619 the index or at the file end if there is no index |
16428 | 620 headers MUST be repeated at least twice (so they exist three times in a file) |
9295 | 621 |
16685 | 622 there MUST be a sync point immediately before the first frame after any headers |
12503 | 623 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
624 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
625 Index: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
626 ------ |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
627 |
15008
0a43341c8bfd
less amateurish-looking mpcf.txt patch by (Jeff >snacky ikaruga co uk<)
michael
parents:
14919
diff
changeset
|
628 Note: with realtime streaming, there is no end, so no index there either |
16429 | 629 An index SHOULD be written for every stream. Indices MUST be placed at end |
630 of file. Indices MAY be repeated for a stream. | |
9310 | 631 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
632 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
633 Info frames: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
634 ------------ |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
635 |
16506 | 636 Info frames can be used to describe the file or some part of it (chapters) |
9310 | 637 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
638 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
639 Unknown packets: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
640 ---------------- |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
641 |
12184 | 642 MUST be ignored by the demuxer |
9310 | 643 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
644 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
645 demuxer (non-normative): |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
646 ------------------------ |
12501 | 647 |
16428 | 648 in the absence of a valid header at the beginning, players SHOULD search for |
649 backup headers starting at offset 2^x; for each x players SHOULD end their | |
650 search at a particular offset when any startcode is found (including syncpoint) | |
12501 | 651 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
652 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
653 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
654 Semantic requirements: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
655 ====================== |
16429 | 656 |
657 If more than one stream of a given stream class is present, each one MUST | |
658 have info tags specifying disposition, and if applicable, language. | |
659 | |
660 A demuxer MUST NOT demux a stream which contains more than one stream, or which | |
661 is wrapped in a structure to facilitate more than one stream or otherwise | |
662 duplicate the role of a container. any such file is to be considered invalid. | |
663 | |
12501 | 664 |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
665 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
666 Sample code (Public Domain, & untested): |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
667 ======================================== |
9294 | 668 |
669 typedef BufferContext{ | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
670 uint8_t *buf; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
671 uint8_t *buf_ptr; |
9294 | 672 }BufferContext; |
673 | |
674 static inline uint64_t get_bytes(BufferContext *bc, int count){ | |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
675 uint64_t val=0; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
676 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
677 assert(count>0 && count<9); |
9294 | 678 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
679 for(i=0; i<count; i++){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
680 val <<=8; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
681 val += *(bc->buf_ptr++); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
682 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
683 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
684 return val; |
9294 | 685 } |
686 | |
687 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
|
688 uint64_t val=0; |
9294 | 689 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
690 assert(count>0 && count<9); |
9294 | 691 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
692 for(i=count-1; i>=0; i--){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
693 *(bc->buf_ptr++)= val >> (8*i); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
694 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
695 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
696 return val; |
9294 | 697 } |
698 | |
10061 | 699 static inline uint64_t get_v(BufferContext *bc){ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
700 uint64_t val= 0; |
9294 | 701 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
702 for(; space_left(bc) > 0; ){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
703 int tmp= *(bc->buf_ptr++); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
704 if(tmp&0x80) |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
705 val= (val<<7) + tmp - 0x80; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
706 else |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
707 return (val<<7) + tmp; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
708 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
709 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
710 return -1; |
9294 | 711 } |
712 | |
10061 | 713 static inline int put_v(BufferContext *bc, uint64_t val){ |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
714 int i; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
715 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
716 if(space_left(bc) < 9) return -1; |
9294 | 717 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
718 val &= 0x7FFFFFFFFFFFFFFFULL; // FIXME can only encode upto 63 bits currently |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
719 for(i=7; ; i+=7){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
720 if(val>>i == 0) break; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
721 } |
9294 | 722 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
723 for(i-=7; i>0; i-=7){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
724 *(bc->buf_ptr++)= 0x80 | (val>>i); |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
725 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
726 *(bc->buf_ptr++)= val&0x7F; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
727 |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
728 return 0; |
9579
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
729 } |
89d27a306886
*signed int vlc (needs only 5 lines of code so its no increase of complexity)
michael
parents:
9422
diff
changeset
|
730 |
12333 | 731 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
|
732 if(reset) memset(pts_cache, -1, delay*sizeof(int64_t)); |
12333 | 733 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
734 while(delay--){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
735 int64_t t= pts_cache[delay]; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
736 if(t < pts){ |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
737 pts_cache[delay]= pts; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
738 pts= t; |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
739 } |
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
740 } |
12333 | 741 |
16686
93d4be7ef83e
cosmetic reformatting: tabs --> spaces, prettyprinting, trailing whitespace
diego
parents:
16685
diff
changeset
|
742 return pts; |
12333 | 743 } |
744 | |
16842
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
745 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
746 |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
747 Authors: |
d977560c702b
Reformat section titles so that it becomes easier to tell sections and
diego
parents:
16686
diff
changeset
|
748 ======== |
10158
93e5428d0b3e
some changes (michael: is the colorspace_type field needed?)
alex
parents:
10061
diff
changeset
|
749 |
16428 | 750 Folks from the MPlayer developers mailing list (http://www.mplayerhq.hu/). |
751 Authors in alphabetical order: (FIXME! Tell us if we left you out) | |
16843 | 752 Beregszaszi, Alex (alex@fsn.hu) |
753 Bunkus, Moritz (moritz@bunkus.org) | |
754 Diedrich, Tobias (ranma+mplayer@tdiedrich.de) | |
755 Felker, Rich (dalias@aerifal.cx) | |
756 Franz, Fabian (FabianFranz@gmx.de) | |
757 Gereoffy, Arpad (arpi@thot.banki.hu) | |
758 Hess, Andreas (jaska@gmx.net) | |
759 Niedermayer, Michael (michaelni@gmx.at) | |
760 Shimon, Oded (ods15@ods15.dyndns.org) |