2 * Copyright (c) 2000, 2001 Fabrice Bellard
4 * This file is part of FFmpeg.
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 #ifndef AVFORMAT_ASF_H
22 #define AVFORMAT_ASF_H
27 #define PACKET_SIZE 3200
38 int ds_span; /* descrambling */
46 typedef uint8_t GUID[16];
49 GUID guid; ///< generated by client computer
50 uint64_t file_size; /**< in bytes
51 * invalid if broadcasting */
52 uint64_t create_time; /**< time of creation, in 100-nanosecond units since 1.1.1601
53 * invalid if broadcasting */
54 uint64_t play_time; /**< play time, in 100-nanosecond units
55 * invalid if broadcasting */
56 uint64_t send_time; /**< time to send file, in 100-nanosecond units
57 * invalid if broadcasting (could be ignored) */
58 uint32_t preroll; /**< timestamp of the first packet, in milliseconds
59 * if nonzero - subtract from time */
60 uint32_t ignore; ///< preroll is 64bit - but let's just ignore it
61 uint32_t flags; /**< 0x01 - broadcast
63 * rest is reserved should be 0 */
64 uint32_t min_pktsize; /**< size of a data packet
65 * invalid if broadcasting */
66 uint32_t max_pktsize; /**< shall be the same as for min_pktsize
67 * invalid if broadcasting */
68 uint32_t max_bitrate; /**< bandwith of stream in bps
69 * should be the sum of bitrates of the
70 * individual media streams */
75 uint32_t packet_number;
76 uint16_t packet_count;
82 unsigned int packet_size;
84 int asfid2avid[128]; ///< conversion table from asf ID 2 AVStream ID
85 ASFStream streams[128]; ///< it's max number and it's not that big
86 uint32_t stream_bitrates[128]; ///< max number of streams, bitrate for each (for streaming)
87 /* non streamed additonnal info */
88 uint64_t nb_packets; ///< how many packets are there in the file, invalid if broadcasting
89 int64_t duration; ///< in 100ns units
91 unsigned char multi_payloads_present;
93 int packet_timestamp_start;
94 int packet_timestamp_end;
95 unsigned int packet_nb_payloads;
97 uint8_t packet_buf[PACKET_SIZE];
99 /* only for reading */
100 uint64_t data_offset; ///< beginning of the first data packet
101 uint64_t data_object_offset; ///< data object offset (excl. GUID & size)
102 uint64_t data_object_size; ///< size of the data object
109 int packet_timestamp;
110 int packet_segsizetype;
113 int packet_replic_size;
114 int packet_key_frame;
116 unsigned int packet_frag_offset;
117 unsigned int packet_frag_size;
118 int64_t packet_frag_timestamp;
119 int packet_multi_size;
121 int packet_time_delta;
122 int packet_time_start;
128 int64_t last_indexed_pts;
130 uint32_t nb_index_count;
131 uint32_t nb_index_memory_alloc;
132 uint16_t maximum_packet;
134 ASFStream* asf_st; ///< currently decoded stream
137 extern const GUID ff_asf_header;
138 extern const GUID ff_asf_file_header;
139 extern const GUID ff_asf_stream_header;
140 extern const GUID ff_asf_ext_stream_header;
141 extern const GUID ff_asf_audio_stream;
142 extern const GUID ff_asf_audio_conceal_none;
143 extern const GUID ff_asf_audio_conceal_spread;
144 extern const GUID ff_asf_video_stream;
145 extern const GUID ff_asf_video_conceal_none;
146 extern const GUID ff_asf_command_stream;
147 extern const GUID ff_asf_comment_header;
148 extern const GUID ff_asf_codec_comment_header;
149 extern const GUID ff_asf_codec_comment1_header;
150 extern const GUID ff_asf_data_header;
151 extern const GUID ff_asf_head1_guid;
152 extern const GUID ff_asf_head2_guid;
153 extern const GUID ff_asf_extended_content_header;
154 extern const GUID ff_asf_simple_index_header;
155 extern const GUID ff_asf_ext_stream_embed_stream_header;
156 extern const GUID ff_asf_ext_stream_audio_stream;
157 extern const GUID ff_asf_metadata_header;
158 extern const GUID ff_asf_my_guid;
160 #define ASF_PACKET_FLAG_ERROR_CORRECTION_PRESENT 0x80 //1000 0000
163 // ASF data packet structure
164 // =========================
167 // -----------------------------------
168 // | Error Correction Data | Optional
169 // -----------------------------------
170 // | Payload Parsing Information (PPI) |
171 // -----------------------------------
173 // -----------------------------------
175 // -----------------------------------
178 // PPI_FLAG - Payload parsing information flags
179 #define ASF_PPI_FLAG_MULTIPLE_PAYLOADS_PRESENT 1
181 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_BYTE 0x02 //0000 0010
182 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_WORD 0x04 //0000 0100
183 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_DWORD 0x06 //0000 0110
184 #define ASF_PPI_MASK_SEQUENCE_FIELD_SIZE 0x06 //0000 0110
186 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_BYTE 0x08 //0000 1000
187 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_WORD 0x10 //0001 0000
188 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_DWORD 0x18 //0001 1000
189 #define ASF_PPI_MASK_PADDING_LENGTH_FIELD_SIZE 0x18 //0001 1000
191 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_BYTE 0x20 //0010 0000
192 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_WORD 0x40 //0100 0000
193 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_DWORD 0x60 //0110 0000
194 #define ASF_PPI_MASK_PACKET_LENGTH_FIELD_SIZE 0x60 //0110 0000
196 // PL_FLAG - Payload flags
197 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_BYTE 0x01 //0000 0001
198 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_WORD 0x02 //0000 0010
199 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_DWORD 0x03 //0000 0011
200 #define ASF_PL_MASK_REPLICATED_DATA_LENGTH_FIELD_SIZE 0x03 //0000 0011
202 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_BYTE 0x04 //0000 0100
203 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_WORD 0x08 //0000 1000
204 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_DWORD 0x0c //0000 1100
205 #define ASF_PL_MASK_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_SIZE 0x0c //0000 1100
207 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_BYTE 0x10 //0001 0000
208 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_WORD 0x20 //0010 0000
209 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_DWORD 0x30 //0011 0000
210 #define ASF_PL_MASK_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_SIZE 0x30 //0011 0000
212 #define ASF_PL_FLAG_STREAM_NUMBER_LENGTH_FIELD_IS_BYTE 0x40 //0100 0000
213 #define ASF_PL_MASK_STREAM_NUMBER_LENGTH_FIELD_SIZE 0xc0 //1100 0000
215 #define ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_BYTE 0x40 //0100 0000
216 #define ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_WORD 0x80 //1000 0000
217 #define ASF_PL_MASK_PAYLOAD_LENGTH_FIELD_SIZE 0xc0 //1100 0000
219 #define ASF_PL_FLAG_KEY_FRAME 0x80 //1000 0000
221 extern AVInputFormat asf_demuxer;
224 * Load a single ASF packet into the demuxer.
225 * @param s demux context
226 * @param pb context to read data from
227 * @returns 0 on success, <0 on error
229 int ff_asf_get_packet(AVFormatContext *s, ByteIOContext *pb);
232 * Parse data from individual ASF packets (which were previously loaded
233 * with asf_get_packet()).
234 * @param s demux context
235 * @param pb context to read data from
236 * @param pkt pointer to store packet data into
237 * @returns 0 if data was stored in pkt, <0 on error or 1 if more ASF
238 * packets need to be loaded (through asf_get_packet())
240 int ff_asf_parse_packet(AVFormatContext *s, ByteIOContext *pb, AVPacket *pkt);
242 #endif /* AVFORMAT_ASF_H */