FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
asf.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2000, 2001 Fabrice Bellard
3  *
4  * This file is part of FFmpeg.
5  *
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.
10  *
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.
15  *
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
19  */
20 
21 #ifndef AVFORMAT_ASF_H
22 #define AVFORMAT_ASF_H
23 
24 #include <stdint.h>
25 #include "avformat.h"
26 #include "metadata.h"
27 #include "riff.h"
28 
29 #define PACKET_SIZE 3200
30 
31 typedef struct ASFPayload {
33  uint16_t size;
34 } ASFPayload;
35 
36 typedef struct ASFStream {
37  int num;
38  unsigned char seq;
39  /* use for reading */
43  int timestamp;
44  int64_t duration;
46 
47  int ds_span; /* descrambling */
50 
51  int64_t packet_pos;
52 
54 
56  uint32_t palette[256];
57 
60 } ASFStream;
61 
62 typedef struct ASFMainHeader {
63  ff_asf_guid guid; ///< generated by client computer
64  uint64_t file_size; /**< in bytes
65  * invalid if broadcasting */
66  uint64_t create_time; /**< time of creation, in 100-nanosecond units since 1.1.1601
67  * invalid if broadcasting */
68  uint64_t play_time; /**< play time, in 100-nanosecond units
69  * invalid if broadcasting */
70  uint64_t send_time; /**< time to send file, in 100-nanosecond units
71  * invalid if broadcasting (could be ignored) */
72  uint32_t preroll; /**< timestamp of the first packet, in milliseconds
73  * if nonzero - subtract from time */
74  uint32_t ignore; ///< preroll is 64bit - but let's just ignore it
75  uint32_t flags; /**< 0x01 - broadcast
76  * 0x02 - seekable
77  * rest is reserved should be 0 */
78  uint32_t min_pktsize; /**< size of a data packet
79  * invalid if broadcasting */
80  uint32_t max_pktsize; /**< shall be the same as for min_pktsize
81  * invalid if broadcasting */
82  uint32_t max_bitrate; /**< bandwidth of stream in bps
83  * should be the sum of bitrates of the
84  * individual media streams */
86 
87 
88 typedef struct ASFIndex {
89  uint32_t packet_number;
90  uint16_t packet_count;
91  uint64_t send_time;
92  uint64_t offset;
93 } ASFIndex;
94 
95 extern const ff_asf_guid ff_asf_header;
96 extern const ff_asf_guid ff_asf_file_header;
99 extern const ff_asf_guid ff_asf_audio_stream;
102 extern const ff_asf_guid ff_asf_video_stream;
103 extern const ff_asf_guid ff_asf_jfif_media;
109 extern const ff_asf_guid ff_asf_data_header;
110 extern const ff_asf_guid ff_asf_head1_guid;
111 extern const ff_asf_guid ff_asf_head2_guid;
118 extern const ff_asf_guid ff_asf_marker_header;
119 extern const ff_asf_guid ff_asf_reserved_4;
120 extern const ff_asf_guid ff_asf_my_guid;
121 extern const ff_asf_guid ff_asf_language_guid;
125 
126 extern const AVMetadataConv ff_asf_metadata_conv[];
127 
128 #define ASF_PACKET_FLAG_ERROR_CORRECTION_PRESENT 0x80 //1000 0000
129 
130 
131 // ASF data packet structure
132 // =========================
133 //
134 //
135 // -----------------------------------
136 // | Error Correction Data | Optional
137 // -----------------------------------
138 // | Payload Parsing Information (PPI) |
139 // -----------------------------------
140 // | Payload Data |
141 // -----------------------------------
142 // | Padding Data |
143 // -----------------------------------
144 
145 
146 // PPI_FLAG - Payload parsing information flags
147 #define ASF_PPI_FLAG_MULTIPLE_PAYLOADS_PRESENT 1
148 
149 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_BYTE 0x02 //0000 0010
150 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_WORD 0x04 //0000 0100
151 #define ASF_PPI_FLAG_SEQUENCE_FIELD_IS_DWORD 0x06 //0000 0110
152 #define ASF_PPI_MASK_SEQUENCE_FIELD_SIZE 0x06 //0000 0110
153 
154 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_BYTE 0x08 //0000 1000
155 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_WORD 0x10 //0001 0000
156 #define ASF_PPI_FLAG_PADDING_LENGTH_FIELD_IS_DWORD 0x18 //0001 1000
157 #define ASF_PPI_MASK_PADDING_LENGTH_FIELD_SIZE 0x18 //0001 1000
158 
159 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_BYTE 0x20 //0010 0000
160 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_WORD 0x40 //0100 0000
161 #define ASF_PPI_FLAG_PACKET_LENGTH_FIELD_IS_DWORD 0x60 //0110 0000
162 #define ASF_PPI_MASK_PACKET_LENGTH_FIELD_SIZE 0x60 //0110 0000
163 
164 // PL_FLAG - Payload flags
165 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_BYTE 0x01 //0000 0001
166 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_WORD 0x02 //0000 0010
167 #define ASF_PL_FLAG_REPLICATED_DATA_LENGTH_FIELD_IS_DWORD 0x03 //0000 0011
168 #define ASF_PL_MASK_REPLICATED_DATA_LENGTH_FIELD_SIZE 0x03 //0000 0011
169 
170 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_BYTE 0x04 //0000 0100
171 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_WORD 0x08 //0000 1000
172 #define ASF_PL_FLAG_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_IS_DWORD 0x0c //0000 1100
173 #define ASF_PL_MASK_OFFSET_INTO_MEDIA_OBJECT_LENGTH_FIELD_SIZE 0x0c //0000 1100
174 
175 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_BYTE 0x10 //0001 0000
176 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_WORD 0x20 //0010 0000
177 #define ASF_PL_FLAG_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_IS_DWORD 0x30 //0011 0000
178 #define ASF_PL_MASK_MEDIA_OBJECT_NUMBER_LENGTH_FIELD_SIZE 0x30 //0011 0000
179 
180 #define ASF_PL_FLAG_STREAM_NUMBER_LENGTH_FIELD_IS_BYTE 0x40 //0100 0000
181 #define ASF_PL_MASK_STREAM_NUMBER_LENGTH_FIELD_SIZE 0xc0 //1100 0000
182 
183 #define ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_BYTE 0x40 //0100 0000
184 #define ASF_PL_FLAG_PAYLOAD_LENGTH_FIELD_IS_WORD 0x80 //1000 0000
185 #define ASF_PL_MASK_PAYLOAD_LENGTH_FIELD_SIZE 0xc0 //1100 0000
186 
187 #define ASF_PL_FLAG_KEY_FRAME 0x80 //1000 0000
188 
190 
191 void ff_put_guid(AVIOContext *s, const ff_asf_guid *g);
192 
193 #endif /* AVFORMAT_ASF_H */