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