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