* Add a duration field to the AVPacket
[ffmpeg.git] / libav / avformat.h
1
2 #define LIBAV_VERSION_INT 0x000406  
3 #define LIBAV_VERSION     "0.4.6"
4 #define LIBAV_BUILD       4600
5
6 #include "avcodec.h"
7
8 #include "avio.h"
9
10 /* packet functions */
11
12 typedef struct AVPacket {
13     INT64 pts;
14     UINT8 *data;
15     int size;
16     int stream_index;
17     int flags;
18     int duration;       
19 #define PKT_FLAG_KEY   0x0001
20 #define PKT_FLAG_DROPPED_FRAME   0x0002
21 } AVPacket; 
22
23 int av_new_packet(AVPacket *pkt, int size);
24 void av_free_packet(AVPacket *pkt);
25
26 /*************************************************/
27 /* output formats */
28
29 struct AVFormatContext;
30 struct AVFormatInputContext;
31
32 typedef struct AVFormatParameters {
33     int frame_rate;
34     int sample_rate;
35     int channels;
36     int width;
37     int height;
38     enum PixelFormat pix_fmt;
39 } AVFormatParameters;
40
41 typedef struct AVFormat {
42     const char *name;
43     const char *long_name;
44     const char *mime_type;
45     const char *extensions; /* comma separated extensions */
46
47     /* output support */
48     enum CodecID audio_codec; /* default audio codec */
49     enum CodecID video_codec; /* default video codec */
50     int (*write_header)(struct AVFormatContext *);
51     int (*write_packet)(struct AVFormatContext *, 
52                         int stream_index,
53                         unsigned char *buf, int size, int force_pts);
54     int (*write_trailer)(struct AVFormatContext *);
55
56     /* optional input support */
57     /* read the format header and initialize the AVFormatInputContext
58        structure. Return 0 if OK. 'ap' if non NULL contains
59        additionnal paramters. Only used in raw format right now */
60     int (*read_header)(struct AVFormatContext *,
61                        AVFormatParameters *ap);
62     /* read one packet and put it in 'pkt'. pts and flags are also set */
63     int (*read_packet)(struct AVFormatContext *, AVPacket *pkt);
64     /* close the stream. The AVFormatContext and AVStreams are not
65        freed by this function */
66     int (*read_close)(struct AVFormatContext *);
67     /* seek at or before a given pts (given in microsecond). The pts
68        origin is defined by the stream */
69     int (*read_seek)(struct AVFormatContext *, INT64 pts);
70     int flags;
71 #define AVFMT_NOFILE        0x0001 /* no file should be opened */
72 #define AVFMT_NEEDNUMBER    0x0002 /* needs '%d' in filename */ 
73     struct AVFormat *next;
74 } AVFormat;
75
76 typedef struct AVStream {
77     int id;       /* internal stream id */
78     AVCodecContext codec; /* codec context */
79     void *priv_data;
80 } AVStream;
81
82 #define MAX_STREAMS 20
83
84 /* format I/O context */
85 typedef struct AVFormatContext {
86     struct AVFormat *format;
87     void *priv_data;
88     ByteIOContext pb;
89     int nb_streams;
90     AVStream *streams[MAX_STREAMS];
91     char filename[1024]; /* input or output filename */
92     /* stream info */
93     char title[512];
94     char author[512];
95     char copyright[512];
96     char comment[512];
97     /* This buffer is only needed when packets were already buffered but
98        not decoded, for example to get the codec parameters in mpeg
99        streams */
100    struct AVPacketList *packet_buffer;
101 } AVFormatContext;
102
103 typedef struct AVPacketList {
104     AVPacket pkt;
105     struct AVPacketList *next;
106 } AVPacketList;
107
108 extern AVFormat *first_format;
109
110 /* rv10enc.c */
111 extern AVFormat rm_format;
112
113 /* mpegmux.c */
114 extern AVFormat mpeg_mux_format;
115
116 /* asfenc.c */
117 extern AVFormat asf_format;
118
119 /* avienc.c */
120 extern AVFormat avi_format;
121
122 /* mov.c */
123 extern AVFormat mov_format;
124 extern AVFormat mp4_format;
125
126 /* jpegenc.c */
127 extern AVFormat mpjpeg_format;
128 extern AVFormat jpeg_format;
129 extern AVFormat single_jpeg_format;
130
131 /* swfenc.c */
132 extern AVFormat swf_format;
133
134 /* gif.c */
135 extern AVFormat gif_format;
136 /* au.c */
137 extern AVFormat au_format;
138
139 /* wav.c */
140 extern AVFormat wav_format;
141
142 /* img.c */
143 extern AVFormat pgm_format;
144 extern AVFormat ppm_format;
145 extern AVFormat pgmyuv_format;
146 extern AVFormat imgyuv_format;
147
148 extern AVFormat pgmpipe_format;
149 extern AVFormat pgmyuvpipe_format;
150 extern AVFormat ppmpipe_format;
151
152 /* raw.c */
153 extern AVFormat mp2_format;
154 extern AVFormat ac3_format;
155 extern AVFormat h263_format;
156 extern AVFormat mpeg1video_format;
157 extern AVFormat mjpeg_format;
158 extern AVFormat pcm_s16le_format;
159 extern AVFormat pcm_s16be_format;
160 extern AVFormat pcm_u16le_format;
161 extern AVFormat pcm_u16be_format;
162 extern AVFormat pcm_s8_format;
163 extern AVFormat pcm_u8_format;
164 extern AVFormat pcm_mulaw_format;
165 extern AVFormat pcm_alaw_format;
166 extern AVFormat rawvideo_format;
167
168 /* ffm.c */
169 extern AVFormat ffm_format;
170
171 /* formats.c */
172
173 #define MKTAG(a,b,c,d) (a | (b << 8) | (c << 16) | (d << 24))
174 #define MKBETAG(a,b,c,d) (d | (c << 8) | (b << 16) | (a << 24))
175
176 void register_avformat(AVFormat *format);
177 AVFormat *guess_format(const char *short_name, const char *filename, const char *mime_type);
178
179 int strstart(const char *str, const char *val, const char **ptr);
180 void nstrcpy(char *buf, int buf_size, const char *str);
181 int match_ext(const char *filename, const char *extensions);
182
183 void register_all(void);
184
185 INT64 gettime(void);
186
187 typedef struct FifoBuffer {
188     UINT8 *buffer;
189     UINT8 *rptr, *wptr, *end;
190 } FifoBuffer;
191
192 int fifo_init(FifoBuffer *f, int size);
193 void fifo_free(FifoBuffer *f);
194 int fifo_size(FifoBuffer *f, UINT8 *rptr);
195 int fifo_read(FifoBuffer *f, UINT8 *buf, int buf_size, UINT8 **rptr_ptr);
196 void fifo_write(FifoBuffer *f, UINT8 *buf, int size, UINT8 **wptr_ptr);
197
198 AVFormatContext *av_open_input_file(const char *filename, 
199                                     const char *format_name,
200                                     int buf_size,
201                                     AVFormatParameters *ap);
202 int av_read_packet(AVFormatContext *s, AVPacket *pkt);
203 void av_close_input_file(AVFormatContext *s);
204
205 int av_write_packet(AVFormatContext *s, AVPacket *pkt, int force_pts);
206
207 void dump_format(AVFormatContext *ic,
208                  int index, 
209                  const char *url,
210                  int is_output);
211 int parse_image_size(int *width_ptr, int *height_ptr, const char *str);
212 INT64 gettime(void);
213 INT64 parse_date(const char *datestr, int duration);
214
215 /* ffm specific for ffserver */
216 #define FFM_PACKET_SIZE 4096
217 offset_t ffm_read_write_index(int fd);
218 void ffm_write_write_index(int fd, offset_t pos);
219 void ffm_set_write_index(AVFormatContext *s, offset_t pos, offset_t file_size);
220
221 int find_info_tag(char *arg, int arg_size, const char *tag1, const char *info);
222
223 int get_frame_filename(char *buf, int buf_size,
224                        const char *path, int number);
225
226 /* grab/output specific */
227 extern AVFormat video_grab_device_format;
228 extern AVFormat audio_device_format;
229
230 extern const char *v4l_device;
231 extern const char *audio_device;