reducing minimum supported picture size
[libav.git] / libavformat / avformat.h
CommitLineData
fb025625
FB
1#ifndef AVFORMAT_H
2#define AVFORMAT_H
de6d9b64 3
02d697aa
ZK
4#ifdef __cplusplus
5extern "C" {
6#endif
7
30bc6613
MN
8#define LIBAVFORMAT_VERSION_INT ((49<<16)+(1<<8)+0)
9#define LIBAVFORMAT_VERSION 49.1.0
5aa083ee 10#define LIBAVFORMAT_BUILD LIBAVFORMAT_VERSION_INT
8026c3b5 11
5aa083ee 12#define LIBAVFORMAT_IDENT "Lavf" AV_STRINGIFY(LIBAVFORMAT_VERSION)
4b1f4f23 13
f71869a4 14#include <time.h>
67070e4f 15#include <stdio.h> /* FILE */
de6d9b64
FB
16#include "avcodec.h"
17
de6d9b64
FB
18#include "avio.h"
19
20/* packet functions */
21
ee404803
FB
22#ifndef MAXINT64
23#define MAXINT64 int64_t_C(0x7fffffffffffffff)
24#endif
25
26#ifndef MININT64
27#define MININT64 int64_t_C(0x8000000000000000)
28#endif
29
de6d9b64 30typedef struct AVPacket {
2692067a
MN
31 int64_t pts; ///< presentation time stamp in time_base units
32 int64_t dts; ///< decompression time stamp in time_base units
0c1a9eda 33 uint8_t *data;
6fa5a56c
FB
34 int size;
35 int stream_index;
36 int flags;
2692067a 37 int duration; ///< presentation duration in time_base units (0 if not available)
6fa5a56c
FB
38 void (*destruct)(struct AVPacket *);
39 void *priv;
2692067a 40 int64_t pos; ///< byte position in stream, -1 if unknown
de6d9b64 41} AVPacket;
6fa5a56c
FB
42#define PKT_FLAG_KEY 0x0001
43
63dd1377 44void av_destruct_packet_nofree(AVPacket *pkt);
90ad92b3 45void av_destruct_packet(AVPacket *pkt);
63dd1377 46
da24c5e3 47/* initialize optional fields of a packet */
6fa5a56c
FB
48static inline void av_init_packet(AVPacket *pkt)
49{
50 pkt->pts = AV_NOPTS_VALUE;
fb2758c8 51 pkt->dts = AV_NOPTS_VALUE;
2692067a 52 pkt->pos = -1;
fb2758c8 53 pkt->duration = 0;
6fa5a56c
FB
54 pkt->flags = 0;
55 pkt->stream_index = 0;
63dd1377 56 pkt->destruct= av_destruct_packet_nofree;
6fa5a56c 57}
de6d9b64
FB
58
59int av_new_packet(AVPacket *pkt, int size);
2692067a 60int av_get_packet(ByteIOContext *s, AVPacket *pkt, int size);
fb2758c8 61int av_dup_packet(AVPacket *pkt);
6fa5a56c
FB
62
63/**
64 * Free a packet
65 *
66 * @param pkt packet to free
67 */
68static inline void av_free_packet(AVPacket *pkt)
69{
342474ab
MN
70 if (pkt && pkt->destruct) {
71 pkt->destruct(pkt);
72 }
6fa5a56c 73}
de6d9b64
FB
74
75/*************************************************/
916c80e9
FB
76/* fractional numbers for exact pts handling */
77
78/* the exact value of the fractional number is: 'val + num / den'. num
79 is assumed to be such as 0 <= num < den */
80typedef struct AVFrac {
0c1a9eda 81 int64_t val, num, den;
916c80e9
FB
82} AVFrac;
83
0c1a9eda
ZK
84void av_frac_init(AVFrac *f, int64_t val, int64_t num, int64_t den);
85void av_frac_add(AVFrac *f, int64_t incr);
86void av_frac_set(AVFrac *f, int64_t val);
916c80e9
FB
87
88/*************************************************/
b9a281db 89/* input/output formats */
de6d9b64
FB
90
91struct AVFormatContext;
b9a281db
FB
92
93/* this structure contains the data a format has to probe a file */
94typedef struct AVProbeData {
5c91a675 95 const char *filename;
b9a281db
FB
96 unsigned char *buf;
97 int buf_size;
98} AVProbeData;
99
100#define AVPROBE_SCORE_MAX 100
de6d9b64
FB
101
102typedef struct AVFormatParameters {
c0df9d75 103 AVRational time_base;
de6d9b64
FB
104 int sample_rate;
105 int channels;
106 int width;
107 int height;
4606ac8d 108 enum PixelFormat pix_fmt;
290c5fa6 109 struct AVImageFormat *image_format;
7f172339 110 int channel; /* used to select dv channel */
6beefa40 111 const char *device; /* video, audio or DV device */
e3ee3283 112 const char *standard; /* tv standard, NTSC, PAL, SECAM */
da24c5e3
FB
113 int mpeg2ts_raw:1; /* force raw MPEG2 transport stream output, if possible */
114 int mpeg2ts_compute_pcr:1; /* compute exact PCR for each transport
115 stream packet (only meaningful if
116 mpeg2ts_raw is TRUE */
fb2758c8
FB
117 int initial_pause:1; /* do not begin to play the stream
118 immediately (RTSP only) */
5b6d5596
MN
119 enum CodecID video_codec_id;
120 enum CodecID audio_codec_id;
de6d9b64
FB
121} AVFormatParameters;
122
b9a281db
FB
123#define AVFMT_NOFILE 0x0001 /* no file should be opened */
124#define AVFMT_NEEDNUMBER 0x0002 /* needs '%d' in filename */
b9a281db 125#define AVFMT_SHOW_IDS 0x0008 /* show format stream IDs numbers */
fb025625
FB
126#define AVFMT_RAWPICTURE 0x0020 /* format wants AVPicture structure for
127 raw picture data */
c64d476c 128#define AVFMT_GLOBALHEADER 0x0040 /* format wants global header */
b9a281db
FB
129
130typedef struct AVOutputFormat {
de6d9b64
FB
131 const char *name;
132 const char *long_name;
133 const char *mime_type;
134 const char *extensions; /* comma separated extensions */
b9a281db
FB
135 /* size of private data so that it can be allocated in the wrapper */
136 int priv_data_size;
de6d9b64
FB
137 /* output support */
138 enum CodecID audio_codec; /* default audio codec */
139 enum CodecID video_codec; /* default video codec */
140 int (*write_header)(struct AVFormatContext *);
e928649b 141 int (*write_packet)(struct AVFormatContext *, AVPacket *pkt);
de6d9b64 142 int (*write_trailer)(struct AVFormatContext *);
c64d476c 143 /* can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER, AVFMT_GLOBALHEADER */
b9a281db 144 int flags;
290c5fa6
FB
145 /* currently only used to set pixel format if not YUV420P */
146 int (*set_parameters)(struct AVFormatContext *, AVFormatParameters *);
fe2d6fe2 147 int (*interleave_packet)(struct AVFormatContext *, AVPacket *out, AVPacket *in, int flush);
b9a281db
FB
148 /* private fields */
149 struct AVOutputFormat *next;
150} AVOutputFormat;
de6d9b64 151
b9a281db
FB
152typedef struct AVInputFormat {
153 const char *name;
154 const char *long_name;
155 /* size of private data so that it can be allocated in the wrapper */
156 int priv_data_size;
157 /* tell if a given file has a chance of being parsing by this format */
158 int (*read_probe)(AVProbeData *);
159 /* read the format header and initialize the AVFormatContext
de6d9b64 160 structure. Return 0 if OK. 'ap' if non NULL contains
b9a281db
FB
161 additionnal paramters. Only used in raw format right
162 now. 'av_new_stream' should be called to create new streams. */
de6d9b64
FB
163 int (*read_header)(struct AVFormatContext *,
164 AVFormatParameters *ap);
b9a281db
FB
165 /* read one packet and put it in 'pkt'. pts and flags are also
166 set. 'av_new_stream' can be called only if the flag
da24c5e3 167 AVFMTCTX_NOHEADER is used. */
de6d9b64
FB
168 int (*read_packet)(struct AVFormatContext *, AVPacket *pkt);
169 /* close the stream. The AVFormatContext and AVStreams are not
170 freed by this function */
171 int (*read_close)(struct AVFormatContext *);
3ba1438d
MN
172 /**
173 * seek to a given timestamp relative to the frames in
174 * stream component stream_index
175 * @param stream_index must not be -1
176 * @param flags selects which direction should be preferred if no exact
177 * match is available
178 */
fb2758c8 179 int (*read_seek)(struct AVFormatContext *,
3ba1438d 180 int stream_index, int64_t timestamp, int flags);
8d14a25c
MN
181 /**
182 * gets the next timestamp in AV_TIME_BASE units.
183 */
184 int64_t (*read_timestamp)(struct AVFormatContext *s, int stream_index,
185 int64_t *pos, int64_t pos_limit);
da24c5e3 186 /* can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER */
de6d9b64 187 int flags;
b9a281db
FB
188 /* if extensions are defined, then no probe is done. You should
189 usually not use extension format guessing because it is not
190 reliable enough */
191 const char *extensions;
192 /* general purpose read only value that the format can use */
193 int value;
fb2758c8
FB
194
195 /* start/resume playing - only meaningful if using a network based format
196 (RTSP) */
197 int (*read_play)(struct AVFormatContext *);
198
199 /* pause playing - only meaningful if using a network based format
200 (RTSP) */
201 int (*read_pause)(struct AVFormatContext *);
202
b9a281db
FB
203 /* private fields */
204 struct AVInputFormat *next;
205} AVInputFormat;
de6d9b64 206
fb2758c8
FB
207typedef struct AVIndexEntry {
208 int64_t pos;
209 int64_t timestamp;
210#define AVINDEX_KEYFRAME 0x0001
b754978a 211/* the following 2 flags indicate that the next/prev keyframe is known, and scaning for it isnt needed */
fb2758c8 212 int flags;
3e9245a9 213 int min_distance; /* min distance between this and the previous keyframe, used to avoid unneeded searching */
fb2758c8
FB
214} AVIndexEntry;
215
de6d9b64 216typedef struct AVStream {
b9a281db
FB
217 int index; /* stream index in AVFormatContext */
218 int id; /* format specific stream id */
01f4895c 219 AVCodecContext *codec; /* codec context */
b4b87d48
MN
220 /**
221 * real base frame rate of the stream.
222 * for example if the timebase is 1/90000 and all frames have either
223 * approximately 3600 or 1800 timer ticks then r_frame_rate will be 50/1
224 */
225 AVRational r_frame_rate;
de6d9b64 226 void *priv_data;
b9a281db 227 /* internal data used in av_find_stream_info() */
fb2758c8
FB
228 int64_t codec_info_duration;
229 int codec_info_nb_frames;
da24c5e3 230 /* encoding: PTS generation when outputing stream */
1e51d801 231 AVFrac pts;
9ee91c2f
MN
232 AVRational time_base;
233 int pts_wrap_bits; /* number of bits in pts (used for wrapping control) */
a48b7a6b
FB
234 /* ffmpeg.c private use */
235 int stream_copy; /* if TRUE, just copy stream */
f3356e9c 236 enum AVDiscard discard; ///< selects which packets can be discarded at will and dont need to be demuxed
b4aea108 237 //FIXME move stuff to a flags field?
1e491e29
MN
238 /* quality, as it has been removed from AVCodecContext and put in AVVideoFrame
239 * MN:dunno if thats the right place, for it */
240 float quality;
ee404803
FB
241 /* decoding: position of the first frame of the component, in
242 AV_TIME_BASE fractional seconds. */
243 int64_t start_time;
244 /* decoding: duration of the stream, in AV_TIME_BASE fractional
245 seconds. */
246 int64_t duration;
fb2758c8 247
09730260
FB
248 char language[4]; /* ISO 639 3-letter language code (empty string if undefined) */
249
fb2758c8 250 /* av_read_frame() support */
7cbaa7ba 251 int need_parsing; ///< 1->full parsing needed, 2->only parse headers dont repack
fb2758c8 252 struct AVCodecParserContext *parser;
6ec87caa 253
fb2758c8
FB
254 int64_t cur_dts;
255 int last_IP_duration;
77405fc8 256 int64_t last_IP_pts;
fb2758c8
FB
257 /* av_seek_frame() support */
258 AVIndexEntry *index_entries; /* only used if the format does not
259 support seeking natively */
260 int nb_index_entries;
261 int index_entries_allocated_size;
b4b87d48
MN
262
263 int64_t nb_frames; ///< number of frames in this stream if known or 0
de6d9b64
FB
264} AVStream;
265
da24c5e3
FB
266#define AVFMTCTX_NOHEADER 0x0001 /* signal that no header is present
267 (streams are added dynamically) */
268
de6d9b64
FB
269#define MAX_STREAMS 20
270
271/* format I/O context */
272typedef struct AVFormatContext {
7fea94ce 273 const AVClass *av_class; /* set by av_alloc_format_context */
b9a281db
FB
274 /* can only be iformat or oformat, not both at the same time */
275 struct AVInputFormat *iformat;
276 struct AVOutputFormat *oformat;
de6d9b64
FB
277 void *priv_data;
278 ByteIOContext pb;
279 int nb_streams;
280 AVStream *streams[MAX_STREAMS];
281 char filename[1024]; /* input or output filename */
282 /* stream info */
4568325a 283 int64_t timestamp;
de6d9b64
FB
284 char title[512];
285 char author[512];
286 char copyright[512];
287 char comment[512];
6a58e151
FB
288 char album[512];
289 int year; /* ID3 year, 0 if none */
290 int track; /* track number, 0 if none */
291 char genre[32]; /* ID3 genre */
292
da24c5e3 293 int ctx_flags; /* format specific flags, see AVFMTCTX_xx */
916c80e9 294 /* private data for pts handling (do not modify directly) */
de6d9b64
FB
295 /* This buffer is only needed when packets were already buffered but
296 not decoded, for example to get the codec parameters in mpeg
297 streams */
ee404803
FB
298 struct AVPacketList *packet_buffer;
299
300 /* decoding: position of the first frame of the component, in
301 AV_TIME_BASE fractional seconds. NEVER set this value directly:
302 it is deduced from the AVStream values. */
303 int64_t start_time;
304 /* decoding: duration of the stream, in AV_TIME_BASE fractional
305 seconds. NEVER set this value directly: it is deduced from the
306 AVStream values. */
307 int64_t duration;
308 /* decoding: total file size. 0 if unknown */
309 int64_t file_size;
310 /* decoding: total stream bitrate in bit/s, 0 if not
311 available. Never set it directly if the file_size and the
312 duration are known as ffmpeg can compute it automatically. */
313 int bit_rate;
fb2758c8
FB
314
315 /* av_read_frame() support */
316 AVStream *cur_st;
317 const uint8_t *cur_ptr;
318 int cur_len;
319 AVPacket cur_pkt;
320
fb2758c8
FB
321 /* av_seek_frame() support */
322 int64_t data_offset; /* offset of the first packet */
323 int index_built;
2db3c638
MN
324
325 int mux_rate;
326 int packet_size;
17c88cb0
MN
327 int preload;
328 int max_delay;
8108551a
TK
329
330#define AVFMT_NOOUTPUTLOOP -1
331#define AVFMT_INFINITEOUTPUTLOOP 0
332 /* number of times to loop output in formats that support it */
333 int loop_output;
334
30bc6613
MN
335 int flags;
336#define AVFMT_FLAG_GENPTS 0x0001 ///< generate pts if missing even if it requires parsing future frames
de6d9b64
FB
337} AVFormatContext;
338
339typedef struct AVPacketList {
340 AVPacket pkt;
341 struct AVPacketList *next;
342} AVPacketList;
343
b9a281db
FB
344extern AVInputFormat *first_iformat;
345extern AVOutputFormat *first_oformat;
de6d9b64 346
290c5fa6
FB
347/* still image support */
348struct AVInputImageContext;
349typedef struct AVInputImageContext AVInputImageContext;
350
351typedef struct AVImageInfo {
352 enum PixelFormat pix_fmt; /* requested pixel format */
353 int width; /* requested width */
354 int height; /* requested height */
7e2e1abf 355 int interleaved; /* image is interleaved (e.g. interleaved GIF) */
290c5fa6
FB
356 AVPicture pict; /* returned allocated image */
357} AVImageInfo;
358
3b1a27e0 359/* AVImageFormat.flags field constants */
7e2e1abf 360#define AVIMAGE_INTERLEAVED 0x0001 /* image format support interleaved output */
3b1a27e0 361
290c5fa6
FB
362typedef struct AVImageFormat {
363 const char *name;
364 const char *extensions;
365 /* tell if a given file has a chance of being parsing by this format */
366 int (*img_probe)(AVProbeData *);
367 /* read a whole image. 'alloc_cb' is called when the image size is
368 known so that the caller can allocate the image. If 'allo_cb'
369 returns non zero, then the parsing is aborted. Return '0' if
370 OK. */
371 int (*img_read)(ByteIOContext *,
372 int (*alloc_cb)(void *, AVImageInfo *info), void *);
373 /* write the image */
374 int supported_pixel_formats; /* mask of supported formats for output */
375 int (*img_write)(ByteIOContext *, AVImageInfo *);
3b1a27e0 376 int flags;
290c5fa6
FB
377 struct AVImageFormat *next;
378} AVImageFormat;
379
380void av_register_image_format(AVImageFormat *img_fmt);
381AVImageFormat *av_probe_image_format(AVProbeData *pd);
382AVImageFormat *guess_image_format(const char *filename);
5b6d5596 383enum CodecID av_guess_image2_codec(const char *filename);
290c5fa6
FB
384int av_read_image(ByteIOContext *pb, const char *filename,
385 AVImageFormat *fmt,
386 int (*alloc_cb)(void *, AVImageInfo *info), void *opaque);
387int av_write_image(ByteIOContext *pb, AVImageFormat *fmt, AVImageInfo *img);
388
389extern AVImageFormat *first_image_format;
390
391extern AVImageFormat pnm_image_format;
392extern AVImageFormat pbm_image_format;
393extern AVImageFormat pgm_image_format;
394extern AVImageFormat ppm_image_format;
8975ba81 395extern AVImageFormat pam_image_format;
290c5fa6
FB
396extern AVImageFormat pgmyuv_image_format;
397extern AVImageFormat yuv_image_format;
3a13f6bd 398#ifdef CONFIG_ZLIB
0e04e4e9 399extern AVImageFormat png_image_format;
3a13f6bd 400#endif
0250738f 401extern AVImageFormat jpeg_image_format;
cdc90af0 402extern AVImageFormat gif_image_format;
6a91ec51 403extern AVImageFormat sgi_image_format;
290c5fa6 404
b9a281db
FB
405/* XXX: use automatic init with either ELF sections or C file parser */
406/* modules */
de6d9b64 407
b9a281db 408/* mpeg.c */
ee404803 409extern AVInputFormat mpegps_demux;
b9a281db
FB
410int mpegps_init(void);
411
412/* mpegts.c */
413extern AVInputFormat mpegts_demux;
414int mpegts_init(void);
de6d9b64 415
b9a281db
FB
416/* rm.c */
417int rm_init(void);
418
419/* crc.c */
420int crc_init(void);
421
422/* img.c */
423int img_init(void);
424
03cfe134
MN
425/* img2.c */
426int img2_init(void);
427
b9a281db
FB
428/* asf.c */
429int asf_init(void);
de6d9b64
FB
430
431/* avienc.c */
b9a281db 432int avienc_init(void);
de6d9b64 433
b9a281db
FB
434/* avidec.c */
435int avidec_init(void);
6cea494e 436
b9a281db
FB
437/* swf.c */
438int swf_init(void);
439
440/* mov.c */
441int mov_init(void);
de6d9b64 442
1cb5f7fd
MN
443/* movenc.c */
444int movenc_init(void);
445
d4f5d74a
GM
446/* flvenc.c */
447int flvenc_init(void);
448
449/* flvdec.c */
450int flvdec_init(void);
451
b9a281db
FB
452/* jpeg.c */
453int jpeg_init(void);
de6d9b64 454
6cea494e 455/* gif.c */
b9a281db
FB
456int gif_init(void);
457
6cea494e 458/* au.c */
b9a281db 459int au_init(void);
6cea494e 460
bc634f6f
ZK
461/* amr.c */
462int amr_init(void);
463
de6d9b64 464/* wav.c */
c3775e54 465int ff_wav_init(void);
de6d9b64 466
93a23627
VM
467/* mmf.c */
468int ff_mmf_init(void);
469
de6d9b64 470/* raw.c */
fb2758c8 471int pcm_read_seek(AVFormatContext *s,
7b3c1382 472 int stream_index, int64_t timestamp, int flags);
b9a281db 473int raw_init(void);
de6d9b64 474
6a58e151
FB
475/* mp3.c */
476int mp3_init(void);
477
2864dfd5
RFI
478/* yuv4mpeg.c */
479int yuv4mpeg_init(void);
480
9146ca37 481/* ogg2.c */
81e0d0b4
MH
482int ogg_init(void);
483
9146ca37
MR
484/* ogg.c */
485int libogg_init(void);
486
f20dca40 487/* dv.c */
c3775e54 488int ff_dv_init(void);
f20dca40 489
de6d9b64 490/* ffm.c */
b9a281db 491int ffm_init(void);
de6d9b64 492
fb025625
FB
493/* rtsp.c */
494extern AVInputFormat redir_demux;
495int redir_open(AVFormatContext **ic_ptr, ByteIOContext *f);
496
3c96b4ef
MM
497/* 4xm.c */
498int fourxm_init(void);
499
3f16d933
MM
500/* psxstr.c */
501int str_init(void);
502
3ef8be2b
MM
503/* idroq.c */
504int roq_init(void);
505
506/* ipmovie.c */
507int ipmovie_init(void);
508
3aa180b8
AB
509/* nut.c */
510int nut_init(void);
511
493645eb
MM
512/* wc3movie.c */
513int wc3_init(void);
514
2fdf638b
MM
515/* westwood.c */
516int westwood_init(void);
517
518/* segafilm.c */
519int film_init(void);
520
4120a53a
MM
521/* idcin.c */
522int idcin_init(void);
523
42cad81a
MM
524/* flic.c */
525int flic_init(void);
526
a7eb3c8d
MM
527/* sierravmd.c */
528int vmd_init(void);
529
08abe0fd
MN
530/* matroska.c */
531int matroska_init(void);
532
d08d7142
MM
533/* sol.c */
534int sol_init(void);
535
ad81a9fe
MM
536/* electronicarts.c */
537int ea_init(void);
538
27d5f18f
FR
539/* nsvdec.c */
540int nsvdec_init(void);
541
fb025625
FB
542#include "rtp.h"
543
544#include "rtsp.h"
545
290c5fa6
FB
546/* yuv4mpeg.c */
547extern AVOutputFormat yuv4mpegpipe_oformat;
548
b9a281db 549/* utils.c */
b9a281db
FB
550void av_register_input_format(AVInputFormat *format);
551void av_register_output_format(AVOutputFormat *format);
36ada60c
PG
552AVOutputFormat *guess_stream_format(const char *short_name,
553 const char *filename, const char *mime_type);
b9a281db
FB
554AVOutputFormat *guess_format(const char *short_name,
555 const char *filename, const char *mime_type);
5b6d5596
MN
556enum CodecID av_guess_codec(AVOutputFormat *fmt, const char *short_name,
557 const char *filename, const char *mime_type, enum CodecType type);
de6d9b64 558
fb2758c8
FB
559void av_hex_dump(FILE *f, uint8_t *buf, int size);
560void av_pkt_dump(FILE *f, AVPacket *pkt, int dump_payload);
de6d9b64 561
94988531 562void av_register_all(void);
de6d9b64
FB
563
564typedef struct FifoBuffer {
0c1a9eda
ZK
565 uint8_t *buffer;
566 uint8_t *rptr, *wptr, *end;
de6d9b64
FB
567} FifoBuffer;
568
569int fifo_init(FifoBuffer *f, int size);
570void fifo_free(FifoBuffer *f);
0c1a9eda
ZK
571int fifo_size(FifoBuffer *f, uint8_t *rptr);
572int fifo_read(FifoBuffer *f, uint8_t *buf, int buf_size, uint8_t **rptr_ptr);
573void fifo_write(FifoBuffer *f, uint8_t *buf, int size, uint8_t **wptr_ptr);
7000a175 574int put_fifo(ByteIOContext *pb, FifoBuffer *f, int buf_size, uint8_t **rptr_ptr);
568e18b1 575void fifo_realloc(FifoBuffer *f, unsigned int size);
de6d9b64 576
b9a281db
FB
577/* media file input */
578AVInputFormat *av_find_input_format(const char *short_name);
94988531 579AVInputFormat *av_probe_input_format(AVProbeData *pd, int is_opened);
da24c5e3
FB
580int av_open_input_stream(AVFormatContext **ic_ptr,
581 ByteIOContext *pb, const char *filename,
582 AVInputFormat *fmt, AVFormatParameters *ap);
b9a281db
FB
583int av_open_input_file(AVFormatContext **ic_ptr, const char *filename,
584 AVInputFormat *fmt,
585 int buf_size,
586 AVFormatParameters *ap);
bc874dae
MB
587/* no av_open for output, so applications will need this: */
588AVFormatContext *av_alloc_format_context(void);
b9a281db
FB
589
590#define AVERROR_UNKNOWN (-1) /* unknown error */
591#define AVERROR_IO (-2) /* i/o error */
592#define AVERROR_NUMEXPECTED (-3) /* number syntax expected in filename */
593#define AVERROR_INVALIDDATA (-4) /* invalid data found */
594#define AVERROR_NOMEM (-5) /* not enough memory */
595#define AVERROR_NOFMT (-6) /* unknown format */
fb2758c8
FB
596#define AVERROR_NOTSUPP (-7) /* operation not supported */
597
b9a281db 598int av_find_stream_info(AVFormatContext *ic);
de6d9b64 599int av_read_packet(AVFormatContext *s, AVPacket *pkt);
fb2758c8 600int av_read_frame(AVFormatContext *s, AVPacket *pkt);
3ba1438d 601int av_seek_frame(AVFormatContext *s, int stream_index, int64_t timestamp, int flags);
fb2758c8
FB
602int av_read_play(AVFormatContext *s);
603int av_read_pause(AVFormatContext *s);
de6d9b64 604void av_close_input_file(AVFormatContext *s);
b9a281db 605AVStream *av_new_stream(AVFormatContext *s, int id);
9ee91c2f 606void av_set_pts_info(AVStream *s, int pts_wrap_bits,
916c80e9 607 int pts_num, int pts_den);
de6d9b64 608
3ba1438d
MN
609#define AVSEEK_FLAG_BACKWARD 1 ///< seek backward
610#define AVSEEK_FLAG_BYTE 2 ///< seeking based on position in bytes
27a5fe5f 611#define AVSEEK_FLAG_ANY 4 ///< seek to any frame, even non keyframes
3ba1438d 612
b754978a 613int av_find_default_stream_index(AVFormatContext *s);
dc56fc38 614int av_index_search_timestamp(AVStream *st, int64_t timestamp, int flags);
3e9245a9
MN
615int av_add_index_entry(AVStream *st,
616 int64_t pos, int64_t timestamp, int distance, int flags);
3ba1438d 617int av_seek_frame_binary(AVFormatContext *s, int stream_index, int64_t target_ts, int flags);
b754978a 618
b9a281db 619/* media file output */
290c5fa6 620int av_set_parameters(AVFormatContext *s, AVFormatParameters *ap);
b9a281db 621int av_write_header(AVFormatContext *s);
e928649b 622int av_write_frame(AVFormatContext *s, AVPacket *pkt);
3c895fc0 623int av_interleaved_write_frame(AVFormatContext *s, AVPacket *pkt);
e928649b 624
b9a281db 625int av_write_trailer(AVFormatContext *s);
de6d9b64
FB
626
627void dump_format(AVFormatContext *ic,
628 int index,
629 const char *url,
630 int is_output);
631int parse_image_size(int *width_ptr, int *height_ptr, const char *str);
445f1b83 632int parse_frame_rate(int *frame_rate, int *frame_rate_base, const char *arg);
0c1a9eda 633int64_t parse_date(const char *datestr, int duration);
de6d9b64 634
0c1a9eda 635int64_t av_gettime(void);
94988531 636
de6d9b64
FB
637/* ffm specific for ffserver */
638#define FFM_PACKET_SIZE 4096
639offset_t ffm_read_write_index(int fd);
640void ffm_write_write_index(int fd, offset_t pos);
641void ffm_set_write_index(AVFormatContext *s, offset_t pos, offset_t file_size);
642
643int find_info_tag(char *arg, int arg_size, const char *tag1, const char *info);
644
813cae4b
FB
645int get_frame_filename(char *buf, int buf_size,
646 const char *path, int number);
b9a281db 647int filename_number_test(const char *filename);
96baaa6a 648
b9a281db
FB
649/* grab specific */
650int video_grab_init(void);
651int audio_init(void);
96baaa6a 652
86fd51fb
FB
653/* DV1394 */
654int dv1394_init(void);
f02be79d 655int dc1394_init(void);
fb025625
FB
656
657#ifdef HAVE_AV_CONFIG_H
f71869a4
FB
658
659#include "os_support.h"
660
fb025625
FB
661int strstart(const char *str, const char *val, const char **ptr);
662int stristart(const char *str, const char *val, const char **ptr);
663void pstrcpy(char *buf, int buf_size, const char *str);
664char *pstrcat(char *buf, int buf_size, const char *s);
fb025625 665
39f472c3
FB
666void __dynarray_add(unsigned long **tab_ptr, int *nb_ptr, unsigned long elem);
667
e4e70d2e 668#ifdef __GNUC__
39f472c3
FB
669#define dynarray_add(tab, nb_ptr, elem)\
670do {\
671 typeof(tab) _tab = (tab);\
672 typeof(elem) _elem = (elem);\
673 (void)sizeof(**_tab == _elem); /* check that types are compatible */\
674 __dynarray_add((unsigned long **)_tab, nb_ptr, (unsigned long)_elem);\
675} while(0)
e4e70d2e
FH
676#else
677#define dynarray_add(tab, nb_ptr, elem)\
678do {\
679 __dynarray_add((unsigned long **)(tab), nb_ptr, (unsigned long)(elem));\
680} while(0)
681#endif
39f472c3 682
f71869a4 683time_t mktimegm(struct tm *tm);
0c9fc6e1 684struct tm *brktimegm(time_t secs, struct tm *tm);
f71869a4
FB
685const char *small_strptime(const char *p, const char *fmt,
686 struct tm *dt);
687
fb025625
FB
688struct in_addr;
689int resolve_host(struct in_addr *sin_addr, const char *hostname);
690
691void url_split(char *proto, int proto_size,
6ba5cbc6 692 char *authorization, int authorization_size,
fb025625
FB
693 char *hostname, int hostname_size,
694 int *port_ptr,
695 char *path, int path_size,
696 const char *url);
697
a941f391
FB
698int match_ext(const char *filename, const char *extensions);
699
fb025625
FB
700#endif /* HAVE_AV_CONFIG_H */
701
02d697aa
ZK
702#ifdef __cplusplus
703}
704#endif
705
fb025625 706#endif /* AVFORMAT_H */
f3356e9c 707