Mercurial > libavformat.hg
annotate avformat.h @ 1967:8c20d8c19e1f libavformat
fix demuxing of IMAG0002.ASF
author | michael |
---|---|
date | Fri, 30 Mar 2007 16:20:40 +0000 |
parents | 7ccf23e42481 |
children | cf1622476eb7 |
rev | line source |
---|---|
1306
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
1 /* |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
2 * copyright (c) 2001 Fabrice Bellard |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
3 * |
1358
0899bfe4105c
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
1332
diff
changeset
|
4 * This file is part of FFmpeg. |
0899bfe4105c
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
1332
diff
changeset
|
5 * |
0899bfe4105c
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
1332
diff
changeset
|
6 * FFmpeg is free software; you can redistribute it and/or |
1306
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
7 * modify it under the terms of the GNU Lesser General Public |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
8 * License as published by the Free Software Foundation; either |
1358
0899bfe4105c
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
1332
diff
changeset
|
9 * version 2.1 of the License, or (at your option) any later version. |
1306
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
10 * |
1358
0899bfe4105c
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
1332
diff
changeset
|
11 * FFmpeg is distributed in the hope that it will be useful, |
1306
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
14 * Lesser General Public License for more details. |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
15 * |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
16 * You should have received a copy of the GNU Lesser General Public |
1358
0899bfe4105c
Change license headers to say 'FFmpeg' instead of 'this program/this library'
diego
parents:
1332
diff
changeset
|
17 * License along with FFmpeg; if not, write to the Free Software |
1306
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
19 */ |
8bf9be9bb107
Add official LGPL license headers to the files that were missing them.
diego
parents:
1304
diff
changeset
|
20 |
0 | 21 #ifndef AVFORMAT_H |
22 #define AVFORMAT_H | |
23 | |
39 | 24 #ifdef __cplusplus |
25 extern "C" { | |
26 #endif | |
27 | |
1918 | 28 #define LIBAVFORMAT_VERSION_INT ((51<<16)+(11<<8)+0) |
29 #define LIBAVFORMAT_VERSION 51.11.0 | |
829 | 30 #define LIBAVFORMAT_BUILD LIBAVFORMAT_VERSION_INT |
218 | 31 |
829 | 32 #define LIBAVFORMAT_IDENT "Lavf" AV_STRINGIFY(LIBAVFORMAT_VERSION) |
0 | 33 |
230
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
34 #include <time.h> |
314 | 35 #include <stdio.h> /* FILE */ |
0 | 36 #include "avcodec.h" |
37 | |
38 #include "avio.h" | |
39 | |
40 /* packet functions */ | |
41 | |
42 typedef struct AVPacket { | |
775 | 43 int64_t pts; ///< presentation time stamp in time_base units |
44 int64_t dts; ///< decompression time stamp in time_base units | |
65 | 45 uint8_t *data; |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
46 int size; |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
47 int stream_index; |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
48 int flags; |
775 | 49 int duration; ///< presentation duration in time_base units (0 if not available) |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
50 void (*destruct)(struct AVPacket *); |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
51 void *priv; |
775 | 52 int64_t pos; ///< byte position in stream, -1 if unknown |
885 | 53 } AVPacket; |
0 | 54 #define PKT_FLAG_KEY 0x0001 |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
55 |
535 | 56 void av_destruct_packet_nofree(AVPacket *pkt); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
57 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
58 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
59 * Default packet destructor. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
60 */ |
797
f5a231a9a2f1
support changing in bitstream global headers into extradata style and back
michael
parents:
795
diff
changeset
|
61 void av_destruct_packet(AVPacket *pkt); |
535 | 62 |
293
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
63 /* initialize optional fields of a packet */ |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
64 static inline void av_init_packet(AVPacket *pkt) |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
65 { |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
66 pkt->pts = AV_NOPTS_VALUE; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
67 pkt->dts = AV_NOPTS_VALUE; |
775 | 68 pkt->pos = -1; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
69 pkt->duration = 0; |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
70 pkt->flags = 0; |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
71 pkt->stream_index = 0; |
535 | 72 pkt->destruct= av_destruct_packet_nofree; |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
73 } |
0 | 74 |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
75 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
76 * Allocate the payload of a packet and intialized its fields to default values. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
77 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
78 * @param pkt packet |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
79 * @param size wanted payload size |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
80 * @return 0 if OK. AVERROR_xxx otherwise. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
81 */ |
0 | 82 int av_new_packet(AVPacket *pkt, int size); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
83 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
84 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
85 * Allocate and read the payload of a packet and intialized its fields to default values. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
86 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
87 * @param pkt packet |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
88 * @param size wanted payload size |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
89 * @return >0 (read size) if OK. AVERROR_xxx otherwise. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
90 */ |
775 | 91 int av_get_packet(ByteIOContext *s, AVPacket *pkt, int size); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
92 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
93 /** |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
94 * @warning This is a hack - the packet memory allocation stuff is broken. The |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
95 * packet is allocated if it was not really allocated |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
96 */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
97 int av_dup_packet(AVPacket *pkt); |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
98 |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
99 /** |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
100 * Free a packet |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
101 * |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
102 * @param pkt packet to free |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
103 */ |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
104 static inline void av_free_packet(AVPacket *pkt) |
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
105 { |
163
470456bd0065
av_free_packet SEGV fix by (Arthur van Hoff (javanator))
michaelni
parents:
159
diff
changeset
|
106 if (pkt && pkt->destruct) { |
887 | 107 pkt->destruct(pkt); |
163
470456bd0065
av_free_packet SEGV fix by (Arthur van Hoff (javanator))
michaelni
parents:
159
diff
changeset
|
108 } |
53
fb671d87824e
zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents:
52
diff
changeset
|
109 } |
0 | 110 |
111 /*************************************************/ | |
112 /* fractional numbers for exact pts handling */ | |
113 | |
114 /* the exact value of the fractional number is: 'val + num / den'. num | |
115 is assumed to be such as 0 <= num < den */ | |
116 typedef struct AVFrac { | |
885 | 117 int64_t val, num, den; |
1258 | 118 } AVFrac attribute_deprecated; |
0 | 119 |
120 /*************************************************/ | |
121 /* input/output formats */ | |
122 | |
1677
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
123 struct AVCodecTag; |
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
124 |
0 | 125 struct AVFormatContext; |
126 | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
127 /** this structure contains the data a format has to probe a file */ |
0 | 128 typedef struct AVProbeData { |
64 | 129 const char *filename; |
0 | 130 unsigned char *buf; |
131 int buf_size; | |
132 } AVProbeData; | |
133 | |
1304 | 134 #define AVPROBE_SCORE_MAX 100 ///< max score, half of that is used for file extension based detection |
0 | 135 |
136 typedef struct AVFormatParameters { | |
743 | 137 AVRational time_base; |
0 | 138 int sample_rate; |
139 int channels; | |
140 int width; | |
141 int height; | |
142 enum PixelFormat pix_fmt; | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
143 int channel; /**< used to select dv channel */ |
1795
62792a60f740
implement new grabbing interface, as described here:
gpoirier
parents:
1787
diff
changeset
|
144 #if LIBAVFORMAT_VERSION_INT < (52<<16) |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
145 const char *device; /**< video, audio or DV device */ |
1795
62792a60f740
implement new grabbing interface, as described here:
gpoirier
parents:
1787
diff
changeset
|
146 #endif |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
147 const char *standard; /**< tv standard, NTSC, PAL, SECAM */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
148 int mpeg2ts_raw:1; /**< force raw MPEG2 transport stream output, if possible */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
149 int mpeg2ts_compute_pcr:1; /**< compute exact PCR for each transport |
293
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
150 stream packet (only meaningful if |
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
151 mpeg2ts_raw is TRUE */ |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
152 int initial_pause:1; /**< do not begin to play the stream |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
153 immediately (RTSP only) */ |
1278 | 154 int prealloced_context:1; |
583 | 155 enum CodecID video_codec_id; |
156 enum CodecID audio_codec_id; | |
0 | 157 } AVFormatParameters; |
158 | |
1675 | 159 //! demuxer will use url_fopen, no opened file should be provided by the caller |
160 #define AVFMT_NOFILE 0x0001 | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
161 #define AVFMT_NEEDNUMBER 0x0002 /**< needs '%d' in filename */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
162 #define AVFMT_SHOW_IDS 0x0008 /**< show format stream IDs numbers */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
163 #define AVFMT_RAWPICTURE 0x0020 /**< format wants AVPicture structure for |
0 | 164 raw picture data */ |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
165 #define AVFMT_GLOBALHEADER 0x0040 /**< format wants global header */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
166 #define AVFMT_NOTIMESTAMPS 0x0080 /**< format doesnt need / has any timestamps */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
167 #define AVFMT_GENERIC_INDEX 0x0100 /**< use generic index building code */ |
0 | 168 |
169 typedef struct AVOutputFormat { | |
170 const char *name; | |
171 const char *long_name; | |
172 const char *mime_type; | |
1879 | 173 const char *extensions; /**< comma separated filename extensions */ |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
174 /** size of private data so that it can be allocated in the wrapper */ |
0 | 175 int priv_data_size; |
176 /* output support */ | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
177 enum CodecID audio_codec; /**< default audio codec */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
178 enum CodecID video_codec; /**< default video codec */ |
0 | 179 int (*write_header)(struct AVFormatContext *); |
468 | 180 int (*write_packet)(struct AVFormatContext *, AVPacket *pkt); |
0 | 181 int (*write_trailer)(struct AVFormatContext *); |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
182 /** can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER, AVFMT_GLOBALHEADER */ |
0 | 183 int flags; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
184 /** currently only used to set pixel format if not YUV420P */ |
17
e1200dd82537
added simple still image format support to simplify image and imagepipe video formats
bellard
parents:
5
diff
changeset
|
185 int (*set_parameters)(struct AVFormatContext *, AVFormatParameters *); |
536
76c47c58064f
move packet interleaving function into AVOutputFormat, so it can be overriden easily instead of doing reordering twice if the muxer needs some other interleaving then dts based
michael
parents:
535
diff
changeset
|
186 int (*interleave_packet)(struct AVFormatContext *, AVPacket *out, AVPacket *in, int flush); |
1677
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
187 |
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
188 /** |
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
189 * list of supported codec_id-codec_tag pairs, ordered by "better choice first" |
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
190 * the arrays are all CODEC_ID_NONE terminated |
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
191 */ |
1679 | 192 const struct AVCodecTag **codec_tag; |
1677
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
193 |
0 | 194 /* private fields */ |
195 struct AVOutputFormat *next; | |
196 } AVOutputFormat; | |
197 | |
198 typedef struct AVInputFormat { | |
199 const char *name; | |
200 const char *long_name; | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
201 /** size of private data so that it can be allocated in the wrapper */ |
0 | 202 int priv_data_size; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
203 /** tell if a given file has a chance of being parsing by this format */ |
0 | 204 int (*read_probe)(AVProbeData *); |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
205 /** read the format header and initialize the AVFormatContext |
0 | 206 structure. Return 0 if OK. 'ap' if non NULL contains |
207 additionnal paramters. Only used in raw format right | |
208 now. 'av_new_stream' should be called to create new streams. */ | |
209 int (*read_header)(struct AVFormatContext *, | |
210 AVFormatParameters *ap); | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
211 /** read one packet and put it in 'pkt'. pts and flags are also |
0 | 212 set. 'av_new_stream' can be called only if the flag |
293
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
213 AVFMTCTX_NOHEADER is used. */ |
0 | 214 int (*read_packet)(struct AVFormatContext *, AVPacket *pkt); |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
215 /** close the stream. The AVFormatContext and AVStreams are not |
0 | 216 freed by this function */ |
217 int (*read_close)(struct AVFormatContext *); | |
885 | 218 /** |
219 * seek to a given timestamp relative to the frames in | |
555 | 220 * stream component stream_index |
221 * @param stream_index must not be -1 | |
885 | 222 * @param flags selects which direction should be preferred if no exact |
555 | 223 * match is available |
224 */ | |
885 | 225 int (*read_seek)(struct AVFormatContext *, |
555 | 226 int stream_index, int64_t timestamp, int flags); |
437
50bae308f71e
moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents:
420
diff
changeset
|
227 /** |
50bae308f71e
moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents:
420
diff
changeset
|
228 * gets the next timestamp in AV_TIME_BASE units. |
50bae308f71e
moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents:
420
diff
changeset
|
229 */ |
50bae308f71e
moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents:
420
diff
changeset
|
230 int64_t (*read_timestamp)(struct AVFormatContext *s, int stream_index, |
50bae308f71e
moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents:
420
diff
changeset
|
231 int64_t *pos, int64_t pos_limit); |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
232 /** can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER */ |
0 | 233 int flags; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
234 /** if extensions are defined, then no probe is done. You should |
0 | 235 usually not use extension format guessing because it is not |
236 reliable enough */ | |
237 const char *extensions; | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
238 /** general purpose read only value that the format can use */ |
0 | 239 int value; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
240 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
241 /** start/resume playing - only meaningful if using a network based format |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
242 (RTSP) */ |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
243 int (*read_play)(struct AVFormatContext *); |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
244 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
245 /** pause playing - only meaningful if using a network based format |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
246 (RTSP) */ |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
247 int (*read_pause)(struct AVFormatContext *); |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
248 |
1679 | 249 const struct AVCodecTag **codec_tag; |
1677
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
250 |
0 | 251 /* private fields */ |
252 struct AVInputFormat *next; | |
253 } AVInputFormat; | |
254 | |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
255 typedef struct AVIndexEntry { |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
256 int64_t pos; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
257 int64_t timestamp; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
258 #define AVINDEX_KEYFRAME 0x0001 |
979 | 259 int flags:2; |
260 int size:30; //yeah trying to keep the size of this small to reduce memory requirements (its 24 vs 32 byte due to possible 8byte align) | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
261 int min_distance; /**< min distance between this and the previous keyframe, used to avoid unneeded searching */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
262 } AVIndexEntry; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
263 |
0 | 264 typedef struct AVStream { |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
265 int index; /**< stream index in AVFormatContext */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
266 int id; /**< format specific stream id */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
267 AVCodecContext *codec; /**< codec context */ |
793 | 268 /** |
269 * real base frame rate of the stream. | |
1486 | 270 * this is the lowest framerate with which all timestamps can be |
271 * represented accurately (its the least common multiple of all | |
272 * framerates in the stream), Note, this value is just a guess! | |
885 | 273 * for example if the timebase is 1/90000 and all frames have either |
793 | 274 * approximately 3600 or 1800 timer ticks then r_frame_rate will be 50/1 |
275 */ | |
276 AVRational r_frame_rate; | |
0 | 277 void *priv_data; |
1906
330115d147d6
remove codec_info_duration/nb_frames from AVStream
bcoudurier
parents:
1879
diff
changeset
|
278 #if LIBAVFORMAT_VERSION_INT < (52<<16) |
0 | 279 /* internal data used in av_find_stream_info() */ |
885 | 280 int64_t codec_info_duration; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
281 int codec_info_nb_frames; |
1906
330115d147d6
remove codec_info_duration/nb_frames from AVStream
bcoudurier
parents:
1879
diff
changeset
|
282 #endif |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
283 /** encoding: PTS generation when outputing stream */ |
0 | 284 AVFrac pts; |
844
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
285 |
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
286 /** |
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
287 * this is the fundamental unit of time (in seconds) in terms |
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
288 * of which frame timestamps are represented. for fixed-fps content, |
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
289 * timebase should be 1/framerate and timestamp increments should be |
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
290 * identically 1. |
35e372e6a6c3
time_base description by Rich Felker | dalias, aerifal cx
michael
parents:
842
diff
changeset
|
291 */ |
462
b69898ffc92a
move time_base (pts_num/pts_den) from AVFormatContext -> AVStream
michael
parents:
437
diff
changeset
|
292 AVRational time_base; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
293 int pts_wrap_bits; /**< number of bits in pts (used for wrapping control) */ |
0 | 294 /* ffmpeg.c private use */ |
1878 | 295 int stream_copy; /**< if set, just copy stream */ |
708 | 296 enum AVDiscard discard; ///< selects which packets can be discarded at will and dont need to be demuxed |
650 | 297 //FIXME move stuff to a flags field? |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
298 /** quality, as it has been removed from AVCodecContext and put in AVVideoFrame |
5 | 299 * MN:dunno if thats the right place, for it */ |
885 | 300 float quality; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
301 /** decoding: position of the first frame of the component, in |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
302 AV_TIME_BASE fractional seconds. */ |
885 | 303 int64_t start_time; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
304 /** decoding: duration of the stream, in AV_TIME_BASE fractional |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
305 seconds. */ |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
306 int64_t duration; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
307 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
308 char language[4]; /** ISO 639 3-letter language code (empty string if undefined) */ |
784 | 309 |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
310 /* av_read_frame() support */ |
842 | 311 int need_parsing; ///< 1->full parsing needed, 2->only parse headers dont repack |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
312 struct AVCodecParserContext *parser; |
334
7f089db11f9a
fixed incorrect PTS/DTS logic in MPEG video case (caused rare PTS glitches if start codes were between two PES packets)
bellard
parents:
315
diff
changeset
|
313 |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
314 int64_t cur_dts; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
315 int last_IP_duration; |
464 | 316 int64_t last_IP_pts; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
317 /* av_seek_frame() support */ |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
318 AVIndexEntry *index_entries; /**< only used if the format does not |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
319 support seeking natively */ |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
320 int nb_index_entries; |
1332 | 321 unsigned int index_entries_allocated_size; |
885 | 322 |
793 | 323 int64_t nb_frames; ///< number of frames in this stream if known or 0 |
1285
b5226e679a31
fix b pyramid in mp4 muxing if no dts are provided to the muxer
michael
parents:
1279
diff
changeset
|
324 |
b5226e679a31
fix b pyramid in mp4 muxing if no dts are provided to the muxer
michael
parents:
1279
diff
changeset
|
325 #define MAX_REORDER_DELAY 4 |
b5226e679a31
fix b pyramid in mp4 muxing if no dts are provided to the muxer
michael
parents:
1279
diff
changeset
|
326 int64_t pts_buffer[MAX_REORDER_DELAY+1]; |
0 | 327 } AVStream; |
328 | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
329 #define AVFMTCTX_NOHEADER 0x0001 /**< signal that no header is present |
293
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
330 (streams are added dynamically) */ |
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
331 |
0 | 332 #define MAX_STREAMS 20 |
333 | |
334 /* format I/O context */ | |
335 typedef struct AVFormatContext { | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
336 const AVClass *av_class; /**< set by av_alloc_format_context */ |
0 | 337 /* can only be iformat or oformat, not both at the same time */ |
338 struct AVInputFormat *iformat; | |
339 struct AVOutputFormat *oformat; | |
340 void *priv_data; | |
341 ByteIOContext pb; | |
1663 | 342 unsigned int nb_streams; |
0 | 343 AVStream *streams[MAX_STREAMS]; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
344 char filename[1024]; /**< input or output filename */ |
0 | 345 /* stream info */ |
420
e440fb884442
* making it possible to specify recording date and time in a stream
romansh
parents:
384
diff
changeset
|
346 int64_t timestamp; |
0 | 347 char title[512]; |
348 char author[512]; | |
349 char copyright[512]; | |
350 char comment[512]; | |
234 | 351 char album[512]; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
352 int year; /**< ID3 year, 0 if none */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
353 int track; /**< track number, 0 if none */ |
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
354 char genre[32]; /**< ID3 genre */ |
234 | 355 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
356 int ctx_flags; /**< format specific flags, see AVFMTCTX_xx */ |
0 | 357 /* private data for pts handling (do not modify directly) */ |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
358 /** This buffer is only needed when packets were already buffered but |
0 | 359 not decoded, for example to get the codec parameters in mpeg |
360 streams */ | |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
361 struct AVPacketList *packet_buffer; |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
362 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
363 /** decoding: position of the first frame of the component, in |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
364 AV_TIME_BASE fractional seconds. NEVER set this value directly: |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
365 it is deduced from the AVStream values. */ |
885 | 366 int64_t start_time; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
367 /** decoding: duration of the stream, in AV_TIME_BASE fractional |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
368 seconds. NEVER set this value directly: it is deduced from the |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
369 AVStream values. */ |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
370 int64_t duration; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
371 /** decoding: total file size. 0 if unknown */ |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
372 int64_t file_size; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
373 /** decoding: total stream bitrate in bit/s, 0 if not |
186
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
374 available. Never set it directly if the file_size and the |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
375 duration are known as ffmpeg can compute it automatically. */ |
2265d21a04c8
added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents:
184
diff
changeset
|
376 int bit_rate; |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
377 |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
378 /* av_read_frame() support */ |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
379 AVStream *cur_st; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
380 const uint8_t *cur_ptr; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
381 int cur_len; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
382 AVPacket cur_pkt; |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
383 |
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
384 /* av_seek_frame() support */ |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
385 int64_t data_offset; /** offset of the first packet */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
386 int index_built; |
885 | 387 |
551 | 388 int mux_rate; |
389 int packet_size; | |
566 | 390 int preload; |
391 int max_delay; | |
790
80aec794c2ed
Animated GIF looping patch by (Todd Kirby // ffmpeg.php gmail com)
michael
parents:
784
diff
changeset
|
392 |
885 | 393 #define AVFMT_NOOUTPUTLOOP -1 |
394 #define AVFMT_INFINITEOUTPUTLOOP 0 | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
395 /** number of times to loop output in formats that support it */ |
790
80aec794c2ed
Animated GIF looping patch by (Todd Kirby // ffmpeg.php gmail com)
michael
parents:
784
diff
changeset
|
396 int loop_output; |
885 | 397 |
841
ba7631ba33a7
support fixing missing pts by parsing future frames
michael
parents:
829
diff
changeset
|
398 int flags; |
ba7631ba33a7
support fixing missing pts by parsing future frames
michael
parents:
829
diff
changeset
|
399 #define AVFMT_FLAG_GENPTS 0x0001 ///< generate pts if missing even if it requires parsing future frames |
1294
12398b868e18
ignore index parameter to ignore the ODML index in avi
michael
parents:
1291
diff
changeset
|
400 #define AVFMT_FLAG_IGNIDX 0x0002 ///< ignore index |
1175
8b53c0f3e7ad
add loop_input to AVFormatContext, getting rid of old hack
mru
parents:
1167
diff
changeset
|
401 |
8b53c0f3e7ad
add loop_input to AVFormatContext, getting rid of old hack
mru
parents:
1167
diff
changeset
|
402 int loop_input; |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
403 /** decoding: size of data to probe; encoding unused */ |
1279
a12e0b434174
added option probesize; at the moment only used by mpegts.c
nicodvb
parents:
1278
diff
changeset
|
404 unsigned int probesize; |
1720
1a8d1f66c867
make av_find_stream_info() duration user selectable
michael
parents:
1679
diff
changeset
|
405 |
1a8d1f66c867
make av_find_stream_info() duration user selectable
michael
parents:
1679
diff
changeset
|
406 /** |
1a8d1f66c867
make av_find_stream_info() duration user selectable
michael
parents:
1679
diff
changeset
|
407 * maximum duration in AV_TIME_BASE units over which the input should be analyzed in av_find_stream_info() |
1a8d1f66c867
make av_find_stream_info() duration user selectable
michael
parents:
1679
diff
changeset
|
408 */ |
1a8d1f66c867
make av_find_stream_info() duration user selectable
michael
parents:
1679
diff
changeset
|
409 int max_analyze_duration; |
1778
d8c6b719a070
add key field to AVFormatContext for de/encryption support, patch by Reimar
bcoudurier
parents:
1756
diff
changeset
|
410 |
d8c6b719a070
add key field to AVFormatContext for de/encryption support, patch by Reimar
bcoudurier
parents:
1756
diff
changeset
|
411 const uint8_t *key; |
d8c6b719a070
add key field to AVFormatContext for de/encryption support, patch by Reimar
bcoudurier
parents:
1756
diff
changeset
|
412 int keylen; |
0 | 413 } AVFormatContext; |
414 | |
415 typedef struct AVPacketList { | |
416 AVPacket pkt; | |
417 struct AVPacketList *next; | |
418 } AVPacketList; | |
419 | |
420 extern AVInputFormat *first_iformat; | |
421 extern AVOutputFormat *first_oformat; | |
422 | |
583 | 423 enum CodecID av_guess_image2_codec(const char *filename); |
17
e1200dd82537
added simple still image format support to simplify image and imagepipe video formats
bellard
parents:
5
diff
changeset
|
424 |
0 | 425 /* XXX: use automatic init with either ELF sections or C file parser */ |
426 /* modules */ | |
427 | |
428 #include "rtp.h" | |
429 | |
430 #include "rtsp.h" | |
431 | |
432 /* utils.c */ | |
433 void av_register_input_format(AVInputFormat *format); | |
434 void av_register_output_format(AVOutputFormat *format); | |
885 | 435 AVOutputFormat *guess_stream_format(const char *short_name, |
0 | 436 const char *filename, const char *mime_type); |
885 | 437 AVOutputFormat *guess_format(const char *short_name, |
0 | 438 const char *filename, const char *mime_type); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
439 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
440 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
441 * Guesses the codec id based upon muxer and filename. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
442 */ |
885 | 443 enum CodecID av_guess_codec(AVOutputFormat *fmt, const char *short_name, |
583 | 444 const char *filename, const char *mime_type, enum CodecType type); |
0 | 445 |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
446 /** |
1908
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
447 * Send a nice hexadecimal dump of a buffer to the specified file stream. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
448 * |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
449 * @param f The file stream pointer where the dump should be sent to. |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
450 * @param buf buffer |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
451 * @param size buffer size |
1908
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
452 * |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
453 * @see av_hex_dump_log, av_pkt_dump, av_pkt_dump_log |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
454 */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
455 void av_hex_dump(FILE *f, uint8_t *buf, int size); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
456 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
457 /** |
1908
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
458 * Send a nice hexadecimal dump of a buffer to the log. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
459 * |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
460 * @param avcl A pointer to an arbitrary struct of which the first field is a |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
461 * pointer to an AVClass struct. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
462 * @param level The importance level of the message, lower values signifying |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
463 * higher importance. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
464 * @param buf buffer |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
465 * @param size buffer size |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
466 * |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
467 * @see av_hex_dump, av_pkt_dump, av_pkt_dump_log |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
468 */ |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
469 void av_hex_dump_log(void *avcl, int level, uint8_t *buf, int size); |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
470 |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
471 /** |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
472 * Send a nice dump of a packet to the specified file stream. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
473 * |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
474 * @param f The file stream pointer where the dump should be sent to. |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
475 * @param pkt packet to dump |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
476 * @param dump_payload true if the payload must be displayed too |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
477 */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
478 void av_pkt_dump(FILE *f, AVPacket *pkt, int dump_payload); |
0 | 479 |
1908
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
480 /** |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
481 * Send a nice dump of a packet to the log. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
482 * |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
483 * @param avcl A pointer to an arbitrary struct of which the first field is a |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
484 * pointer to an AVClass struct. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
485 * @param level The importance level of the message, lower values signifying |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
486 * higher importance. |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
487 * @param pkt packet to dump |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
488 * @param dump_payload true if the payload must be displayed too |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
489 */ |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
490 void av_pkt_dump_log(void *avcl, int level, AVPacket *pkt, int dump_payload); |
174083eafc6c
Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents:
1906
diff
changeset
|
491 |
0 | 492 void av_register_all(void); |
493 | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
494 /** codec tag <-> codec id */ |
1679 | 495 enum CodecID av_codec_get_id(const struct AVCodecTag **tags, unsigned int tag); |
496 unsigned int av_codec_get_tag(const struct AVCodecTag **tags, enum CodecID id); | |
1677
2a85c82b8538
add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents:
1675
diff
changeset
|
497 |
0 | 498 /* media file input */ |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
499 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
500 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
501 * finds AVInputFormat based on input format's short name. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
502 */ |
0 | 503 AVInputFormat *av_find_input_format(const char *short_name); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
504 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
505 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
506 * Guess file format. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
507 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
508 * @param is_opened whether the file is already opened, determines whether |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
509 * demuxers with or without AVFMT_NOFILE are probed |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
510 */ |
0 | 511 AVInputFormat *av_probe_input_format(AVProbeData *pd, int is_opened); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
512 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
513 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
514 * Allocates all the structures needed to read an input stream. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
515 * This does not open the needed codecs for decoding the stream[s]. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
516 */ |
885 | 517 int av_open_input_stream(AVFormatContext **ic_ptr, |
518 ByteIOContext *pb, const char *filename, | |
293
62cec412a186
make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents:
274
diff
changeset
|
519 AVInputFormat *fmt, AVFormatParameters *ap); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
520 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
521 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
522 * Open a media file as input. The codec are not opened. Only the file |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
523 * header (if present) is read. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
524 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
525 * @param ic_ptr the opened media file handle is put here |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
526 * @param filename filename to open. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
527 * @param fmt if non NULL, force the file format to use |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
528 * @param buf_size optional buffer size (zero if default is OK) |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
529 * @param ap additionnal parameters needed when opening the file (NULL if default) |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
530 * @return 0 if OK. AVERROR_xxx otherwise. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
531 */ |
885 | 532 int av_open_input_file(AVFormatContext **ic_ptr, const char *filename, |
0 | 533 AVInputFormat *fmt, |
534 int buf_size, | |
535 AVFormatParameters *ap); | |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
536 /** no av_open for output, so applications will need this: */ |
370
845f9de2c883
av_log() patch by (Michel Bardiaux <mbardiaux at peaktime dot be>)
michael
parents:
369
diff
changeset
|
537 AVFormatContext *av_alloc_format_context(void); |
0 | 538 |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
539 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
540 * Read packets of a media file to get stream information. This |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
541 * is useful for file formats with no headers such as MPEG. This |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
542 * function also computes the real frame rate in case of mpeg2 repeat |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
543 * frame mode. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
544 * The logical file position is not changed by this function; |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
545 * examined packets may be buffered for later processing. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
546 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
547 * @param ic media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
548 * @return >=0 if OK. AVERROR_xxx if error. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
549 * @todo let user decide somehow what information is needed so we dont waste time geting stuff the user doesnt need |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
550 */ |
0 | 551 int av_find_stream_info(AVFormatContext *ic); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
552 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
553 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
554 * Read a transport packet from a media file. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
555 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
556 * This function is absolete and should never be used. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
557 * Use av_read_frame() instead. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
558 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
559 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
560 * @param pkt is filled |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
561 * @return 0 if OK. AVERROR_xxx if error. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
562 */ |
0 | 563 int av_read_packet(AVFormatContext *s, AVPacket *pkt); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
564 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
565 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
566 * Return the next frame of a stream. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
567 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
568 * The returned packet is valid |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
569 * until the next av_read_frame() or until av_close_input_file() and |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
570 * must be freed with av_free_packet. For video, the packet contains |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
571 * exactly one frame. For audio, it contains an integer number of |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
572 * frames if each frame has a known fixed size (e.g. PCM or ADPCM |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
573 * data). If the audio frames have a variable size (e.g. MPEG audio), |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
574 * then it contains one frame. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
575 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
576 * pkt->pts, pkt->dts and pkt->duration are always set to correct |
1844 | 577 * values in AVStream.timebase units (and guessed if the format cannot |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
578 * provided them). pkt->pts can be AV_NOPTS_VALUE if the video format |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
579 * has B frames, so it is better to rely on pkt->dts if you do not |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
580 * decompress the payload. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
581 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
582 * @return 0 if OK, < 0 if error or end of file. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
583 */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
584 int av_read_frame(AVFormatContext *s, AVPacket *pkt); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
585 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
586 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
587 * Seek to the key frame at timestamp. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
588 * 'timestamp' in 'stream_index'. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
589 * @param stream_index If stream_index is (-1), a default |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
590 * stream is selected, and timestamp is automatically converted |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
591 * from AV_TIME_BASE units to the stream specific time_base. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
592 * @param timestamp timestamp in AVStream.time_base units |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
593 * or if there is no stream specified then in AV_TIME_BASE units |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
594 * @param flags flags which select direction and seeking mode |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
595 * @return >= 0 on success |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
596 */ |
555 | 597 int av_seek_frame(AVFormatContext *s, int stream_index, int64_t timestamp, int flags); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
598 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
599 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
600 * start playing a network based stream (e.g. RTSP stream) at the |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
601 * current position |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
602 */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
603 int av_read_play(AVFormatContext *s); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
604 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
605 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
606 * Pause a network based stream (e.g. RTSP stream). |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
607 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
608 * Use av_read_play() to resume it. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
609 */ |
303
2833c2311b66
initial av_read_frame() and av_seek_frame() support
bellard
parents:
293
diff
changeset
|
610 int av_read_pause(AVFormatContext *s); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
611 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
612 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
613 * Close a media file (but not its codecs). |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
614 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
615 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
616 */ |
0 | 617 void av_close_input_file(AVFormatContext *s); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
618 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
619 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
620 * Add a new stream to a media file. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
621 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
622 * Can only be called in the read_header() function. If the flag |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
623 * AVFMTCTX_NOHEADER is in the format context, then new streams |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
624 * can be added in read_packet too. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
625 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
626 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
627 * @param id file format dependent stream id |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
628 */ |
0 | 629 AVStream *av_new_stream(AVFormatContext *s, int id); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
630 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
631 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
632 * Set the pts for a given stream. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
633 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
634 * @param s stream |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
635 * @param pts_wrap_bits number of bits effectively used by the pts |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
636 * (used for wrap control, 33 is the value for MPEG) |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
637 * @param pts_num numerator to convert to seconds (MPEG: 1) |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
638 * @param pts_den denominator to convert to seconds (MPEG: 90000) |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
639 */ |
462
b69898ffc92a
move time_base (pts_num/pts_den) from AVFormatContext -> AVStream
michael
parents:
437
diff
changeset
|
640 void av_set_pts_info(AVStream *s, int pts_wrap_bits, |
0 | 641 int pts_num, int pts_den); |
642 | |
555 | 643 #define AVSEEK_FLAG_BACKWARD 1 ///< seek backward |
644 #define AVSEEK_FLAG_BYTE 2 ///< seeking based on position in bytes | |
698 | 645 #define AVSEEK_FLAG_ANY 4 ///< seek to any frame, even non keyframes |
555 | 646 |
346
e154eb1b7149
caching of timestamps for mpeg-ps so seeking is faster
michael
parents:
338
diff
changeset
|
647 int av_find_default_stream_index(AVFormatContext *s); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
648 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
649 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
650 * Gets the index for a specific timestamp. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
651 * @param flags if AVSEEK_FLAG_BACKWARD then the returned index will correspond to |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
652 * the timestamp which is <= the requested one, if backward is 0 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
653 * then it will be >= |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
654 * if AVSEEK_FLAG_ANY seek to any frame, only keyframes otherwise |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
655 * @return < 0 if no such timestamp could be found |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
656 */ |
597
d814669d2c13
int / int64 fix by (Wolfram Gloger <wmglo @@@ dent:med:uni-muenchen:de>)
michael
parents:
594
diff
changeset
|
657 int av_index_search_timestamp(AVStream *st, int64_t timestamp, int flags); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
658 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
659 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
660 * Add a index entry into a sorted list updateing if it is already there. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
661 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
662 * @param timestamp timestamp in the timebase of the given stream |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
663 */ |
354
6770ca07abe2
store searched distance in index, so we dont waste time searching for keyframes where we already searched
michael
parents:
346
diff
changeset
|
664 int av_add_index_entry(AVStream *st, |
979 | 665 int64_t pos, int64_t timestamp, int size, int distance, int flags); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
666 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
667 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
668 * Does a binary search using av_index_search_timestamp() and AVCodec.read_timestamp(). |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
669 * this isnt supposed to be called directly by a user application, but by demuxers |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
670 * @param target_ts target timestamp in the time base of the given stream |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
671 * @param stream_index stream number |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
672 */ |
555 | 673 int av_seek_frame_binary(AVFormatContext *s, int stream_index, int64_t target_ts, int flags); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
674 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
675 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
676 * Updates cur_dts of all streams based on given timestamp and AVStream. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
677 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
678 * Stream ref_st unchanged, others set cur_dts in their native timebase |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
679 * only needed for timestamp wrapping or if (dts not set and pts!=dts) |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
680 * @param timestamp new dts expressed in time_base of param ref_st |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
681 * @param ref_st reference stream giving time_base of param timestamp |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
682 */ |
1185
13dc486b272b
Try to find out correct start time to make seeking faster and add some
reimar
parents:
1175
diff
changeset
|
683 void av_update_cur_dts(AVFormatContext *s, AVStream *ref_st, int64_t timestamp); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
684 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
685 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
686 * Does a binary search using read_timestamp(). |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
687 * this isnt supposed to be called directly by a user application, but by demuxers |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
688 * @param target_ts target timestamp in the time base of the given stream |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
689 * @param stream_index stream number |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
690 */ |
1496
7e288adde245
split av_seek_frame_binary() so the code becomes idependant of AVInputFormat and AVIndex
michael
parents:
1486
diff
changeset
|
691 int64_t av_gen_search(AVFormatContext *s, int stream_index, int64_t target_ts, int64_t pos_min, int64_t pos_max, int64_t pos_limit, int64_t ts_min, int64_t ts_max, int flags, int64_t *ts_ret, int64_t (*read_timestamp)(struct AVFormatContext *, int , int64_t *, int64_t )); |
346
e154eb1b7149
caching of timestamps for mpeg-ps so seeking is faster
michael
parents:
338
diff
changeset
|
692 |
1858
7ce72baa2ce5
Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents:
1844
diff
changeset
|
693 /** media file output */ |
17
e1200dd82537
added simple still image format support to simplify image and imagepipe video formats
bellard
parents:
5
diff
changeset
|
694 int av_set_parameters(AVFormatContext *s, AVFormatParameters *ap); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
695 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
696 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
697 * allocate the stream private data and write the stream header to an |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
698 * output media file |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
699 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
700 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
701 * @return 0 if OK. AVERROR_xxx if error. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
702 */ |
0 | 703 int av_write_header(AVFormatContext *s); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
704 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
705 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
706 * Write a packet to an output media file. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
707 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
708 * The packet shall contain one audio or video frame. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
709 * The packet must be correctly interleaved according to the container specification, |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
710 * if not then av_interleaved_write_frame must be used |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
711 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
712 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
713 * @param pkt the packet, which contains the stream_index, buf/buf_size, dts/pts, ... |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
714 * @return < 0 if error, = 0 if OK, 1 if end of stream wanted. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
715 */ |
468 | 716 int av_write_frame(AVFormatContext *s, AVPacket *pkt); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
717 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
718 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
719 * Writes a packet to an output media file ensuring correct interleaving. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
720 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
721 * The packet must contain one audio or video frame. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
722 * If the packets are already correctly interleaved the application should |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
723 * call av_write_frame() instead as its slightly faster, its also important |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
724 * to keep in mind that completly non interleaved input will need huge amounts |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
725 * of memory to interleave with this, so its prefereable to interleave at the |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
726 * demuxer level |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
727 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
728 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
729 * @param pkt the packet, which contains the stream_index, buf/buf_size, dts/pts, ... |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
730 * @return < 0 if error, = 0 if OK, 1 if end of stream wanted. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
731 */ |
470 | 732 int av_interleaved_write_frame(AVFormatContext *s, AVPacket *pkt); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
733 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
734 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
735 * Interleave a packet per DTS in an output media file. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
736 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
737 * Packets with pkt->destruct == av_destruct_packet will be freed inside this function, |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
738 * so they cannot be used after it, note calling av_free_packet() on them is still safe. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
739 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
740 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
741 * @param out the interleaved packet will be output here |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
742 * @param in the input packet |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
743 * @param flush 1 if no further packets are available as input and all |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
744 * remaining packets should be output |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
745 * @return 1 if a packet was output, 0 if no packet could be output, |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
746 * < 0 if an error occured |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
747 */ |
1251 | 748 int av_interleave_packet_per_dts(AVFormatContext *s, AVPacket *out, AVPacket *pkt, int flush); |
468 | 749 |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
750 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
751 * @brief Write the stream trailer to an output media file and |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
752 * free the file private data. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
753 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
754 * @param s media file handle |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
755 * @return 0 if OK. AVERROR_xxx if error. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
756 */ |
0 | 757 int av_write_trailer(AVFormatContext *s); |
758 | |
759 void dump_format(AVFormatContext *ic, | |
885 | 760 int index, |
0 | 761 const char *url, |
762 int is_output); | |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
763 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
764 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
765 * parses width and height out of string str. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
766 */ |
0 | 767 int parse_image_size(int *width_ptr, int *height_ptr, const char *str); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
768 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
769 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
770 * Converts frame rate from string to a fraction. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
771 */ |
168 | 772 int parse_frame_rate(int *frame_rate, int *frame_rate_base, const char *arg); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
773 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
774 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
775 * Converts date string to number of seconds since Jan 1st, 1970. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
776 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
777 * @code |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
778 * Syntax: |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
779 * - If not a duration: |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
780 * [{YYYY-MM-DD|YYYYMMDD}]{T| }{HH[:MM[:SS[.m...]]][Z]|HH[MM[SS[.m...]]][Z]} |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
781 * Time is localtime unless Z is suffixed to the end. In this case GMT |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
782 * Return the date in micro seconds since 1970 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
783 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
784 * - If a duration: |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
785 * HH[:MM[:SS[.m...]]] |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
786 * S+[.m...] |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
787 * @endcode |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
788 */ |
65 | 789 int64_t parse_date(const char *datestr, int duration); |
0 | 790 |
65 | 791 int64_t av_gettime(void); |
0 | 792 |
793 /* ffm specific for ffserver */ | |
794 #define FFM_PACKET_SIZE 4096 | |
795 offset_t ffm_read_write_index(int fd); | |
796 void ffm_write_write_index(int fd, offset_t pos); | |
797 void ffm_set_write_index(AVFormatContext *s, offset_t pos, offset_t file_size); | |
798 | |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
799 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
800 * Attempts to find a specific tag in a URL. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
801 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
802 * syntax: '?tag1=val1&tag2=val2...'. Little URL decoding is done. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
803 * Return 1 if found. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
804 */ |
0 | 805 int find_info_tag(char *arg, int arg_size, const char *tag1, const char *info); |
806 | |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
807 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
808 * Returns in 'buf' the path with '%d' replaced by number. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
809 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
810 * Also handles the '%0nd' format where 'n' is the total number |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
811 * of digits and '%%'. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
812 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
813 * @param buf destination buffer |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
814 * @param buf_size destination buffer size |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
815 * @param path numbered sequence string |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
816 * @number frame number |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
817 * @return 0 if OK, -1 if format error. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
818 */ |
1291
185190bdc185
Clarified API for numbered sequences, patch by Michel Bardiaux % mbardiaux A mediaxim P be %
gpoirier
parents:
1289
diff
changeset
|
819 int av_get_frame_filename(char *buf, int buf_size, |
185190bdc185
Clarified API for numbered sequences, patch by Michel Bardiaux % mbardiaux A mediaxim P be %
gpoirier
parents:
1289
diff
changeset
|
820 const char *path, int number); |
1840
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
821 |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
822 /** |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
823 * Check whether filename actually is a numbered sequence generator. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
824 * |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
825 * @param filename possible numbered sequence string |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
826 * @return 1 if a valid numbered sequence string, 0 otherwise. |
daaa79ca14f0
Move the libavformat public API comments to avformat.h. The comments are
takis
parents:
1795
diff
changeset
|
827 */ |
1291
185190bdc185
Clarified API for numbered sequences, patch by Michel Bardiaux % mbardiaux A mediaxim P be %
gpoirier
parents:
1289
diff
changeset
|
828 int av_filename_number_test(const char *filename); |
0 | 829 |
830 /* grab specific */ | |
831 int video_grab_init(void); | |
832 int audio_init(void); | |
833 | |
29 | 834 /* DV1394 */ |
835 int dv1394_init(void); | |
571 | 836 int dc1394_init(void); |
0 | 837 |
838 #ifdef HAVE_AV_CONFIG_H | |
230
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
839 |
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
840 #include "os_support.h" |
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
841 |
0 | 842 int strstart(const char *str, const char *val, const char **ptr); |
843 int stristart(const char *str, const char *val, const char **ptr); | |
844 void pstrcpy(char *buf, int buf_size, const char *str); | |
845 char *pstrcat(char *buf, int buf_size, const char *s); | |
846 | |
151 | 847 void __dynarray_add(unsigned long **tab_ptr, int *nb_ptr, unsigned long elem); |
848 | |
255 | 849 #ifdef __GNUC__ |
151 | 850 #define dynarray_add(tab, nb_ptr, elem)\ |
851 do {\ | |
852 typeof(tab) _tab = (tab);\ | |
853 typeof(elem) _elem = (elem);\ | |
854 (void)sizeof(**_tab == _elem); /* check that types are compatible */\ | |
855 __dynarray_add((unsigned long **)_tab, nb_ptr, (unsigned long)_elem);\ | |
856 } while(0) | |
255 | 857 #else |
858 #define dynarray_add(tab, nb_ptr, elem)\ | |
859 do {\ | |
860 __dynarray_add((unsigned long **)(tab), nb_ptr, (unsigned long)(elem));\ | |
861 } while(0) | |
862 #endif | |
151 | 863 |
230
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
864 time_t mktimegm(struct tm *tm); |
515
ad72189eec07
* replacing calls to not-always-available gmtime_r with our own code.
romansh
parents:
511
diff
changeset
|
865 struct tm *brktimegm(time_t secs, struct tm *tm); |
885 | 866 const char *small_strptime(const char *p, const char *fmt, |
230
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
867 struct tm *dt); |
9f4f4ca9f7b5
simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents:
225
diff
changeset
|
868 |
0 | 869 struct in_addr; |
870 int resolve_host(struct in_addr *sin_addr, const char *hostname); | |
871 | |
872 void url_split(char *proto, int proto_size, | |
511
056991ab9f10
HTTP Authentication Patch by (Petr Doubek <doubek at vision dot ee dot ethz dot ch>)
michael
parents:
497
diff
changeset
|
873 char *authorization, int authorization_size, |
0 | 874 char *hostname, int hostname_size, |
875 int *port_ptr, | |
876 char *path, int path_size, | |
877 const char *url); | |
878 | |
879 int match_ext(const char *filename, const char *extensions); | |
880 | |
881 #endif /* HAVE_AV_CONFIG_H */ | |
882 | |
39 | 883 #ifdef __cplusplus |
884 } | |
885 #endif | |
886 | |
0 | 887 #endif /* AVFORMAT_H */ |
708 | 888 |