annotate avformat.h @ 4156:ccc2608599a5 libavformat

Revert deprecation of AVFrac structure. Attempts to replace AVFrac have turned out to be unsatisfying and confidence in AVFrac has been restored.
author diego
date Mon, 05 Jan 2009 22:10:16 +0000
parents bd4d3fee45d0
children 017e68062073
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
3852
1b6245500d8c Globally rename the header inclusion guard names.
stefano
parents: 3766
diff changeset
21 #ifndef AVFORMAT_AVFORMAT_H
1b6245500d8c Globally rename the header inclusion guard names.
stefano
parents: 3766
diff changeset
22 #define AVFORMAT_AVFORMAT_H
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
23
3087
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
24 #define LIBAVFORMAT_VERSION_MAJOR 52
4004
677bcb3b65cd raw dnxhd de/muxer
bcoudurier
parents: 3973
diff changeset
25 #define LIBAVFORMAT_VERSION_MINOR 23
3900
4703ed97ea9d bump lavf micro version to allow checking for the matroska/ASS bugfix in r15211
aurel
parents: 3880
diff changeset
26 #define LIBAVFORMAT_VERSION_MICRO 1
3054
6892d95d4e03 Clean up lib* version definitions
mru
parents: 2984
diff changeset
27
3087
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
28 #define LIBAVFORMAT_VERSION_INT AV_VERSION_INT(LIBAVFORMAT_VERSION_MAJOR, \
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
29 LIBAVFORMAT_VERSION_MINOR, \
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
30 LIBAVFORMAT_VERSION_MICRO)
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
31 #define LIBAVFORMAT_VERSION AV_VERSION(LIBAVFORMAT_VERSION_MAJOR, \
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
32 LIBAVFORMAT_VERSION_MINOR, \
00058259d6a7 less preprocessor magic in version number macros
mru
parents: 3065
diff changeset
33 LIBAVFORMAT_VERSION_MICRO)
829
e3a3fe90b62f A.B.C versions
michael
parents: 820
diff changeset
34 #define LIBAVFORMAT_BUILD LIBAVFORMAT_VERSION_INT
218
7fc8e8ee081a bump version numbers to 0.4.8
al3x
parents: 211
diff changeset
35
829
e3a3fe90b62f A.B.C versions
michael
parents: 820
diff changeset
36 #define LIBAVFORMAT_IDENT "Lavf" AV_STRINGIFY(LIBAVFORMAT_VERSION)
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
37
3701
5cf9918994ed Implement avformat_version().
stefano
parents: 3698
diff changeset
38 /**
5cf9918994ed Implement avformat_version().
stefano
parents: 3698
diff changeset
39 * Returns the LIBAVFORMAT_VERSION_INT constant.
5cf9918994ed Implement avformat_version().
stefano
parents: 3698
diff changeset
40 */
5cf9918994ed Implement avformat_version().
stefano
parents: 3698
diff changeset
41 unsigned avformat_version(void);
5cf9918994ed Implement avformat_version().
stefano
parents: 3698
diff changeset
42
230
9f4f4ca9f7b5 simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents: 225
diff changeset
43 #include <time.h>
314
8756dec3281f * *FILE needs <stdio.h>
kabi
parents: 303
diff changeset
44 #include <stdio.h> /* FILE */
3065
3c3b2bcd3c38 Install headers in $prefix/include/$libname
mru
parents: 3058
diff changeset
45 #include "libavcodec/avcodec.h"
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
46
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
47 #include "avio.h"
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
48
4150
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
49
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
50 /*
4152
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
51 * Public Metadata API.
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
52 * The metadata API allows libavformat to export metadata tags to a client
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
53 * application using a sequence of key/value pairs.
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
54 * Important concepts to keep in mind:
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
55 * 1. Keys are unique; there can never be 2 tags with the same key. This is
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
56 * also meant semantically, i.e., a demuxer should not knowingly produce
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
57 * several keys that are literally different but semantically identical.
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
58 * E.g., key=Author5, key=Author6. In this example, all authors must be
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
59 * placed in the same tag.
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
60 * 2. Metadata is flat, not hierarchical; there are no subtags. If you
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
61 * want to store, e.g., the email address of the child of producer Alice
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
62 * and actor Bob, that could have key=alice_and_bobs_childs_email_address.
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
63 * 3. A tag whose value is localized for a particular language is appended
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
64 * with a dash character ('-') and the ISO 639 3-letter language code.
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
65 * For example: Author-ger=Michael, Author-eng=Mike
41ba5bf14f00 Ministry of English Composition treatment for the new metadata API
melanson
parents: 4150
diff changeset
66 * The original/default language is in the unqualified "Author" tag.
4150
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
67 * A demuxer should set a default if it sets any translated tag.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
68 */
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
69
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
70 #define AV_METADATA_IGNORE_CASE 1
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
71 #define AV_METADATA_IGNORE_SUFFIX 2
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
72
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
73 typedef struct {
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
74 char *key;
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
75 char *value;
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
76 }AVMetadataTag;
4150
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
77
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
78 struct AVMetadata;
4150
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
79
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
80 /**
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
81 * gets a metadata element with matching key.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
82 * @param prev set to the previous matching element to find the next.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
83 * @param flags allows case as well as suffix insensitive comparissions.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
84 * @return found tag or NULL, changing key or value leads to undefined behavior.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
85 */
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
86 AVMetadataTag *
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
87 av_metadata_get(struct AVMetadata *m, const char *key, const AVMetadataTag *prev, int flags);
4150
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
88
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
89 /**
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
90 * sets the given tag in m, overwriting an existing tag.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
91 * @param tag tag to add to m, key and value will be av_strduped.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
92 * @return >= 0 if success otherwise error code that is <0.
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
93 */
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
94 int av_metadata_set(struct AVMetadata **m, AVMetadataTag tag);
4150
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
95
6f4c0d5f1e23 Move metadata API from avcodec to avformat.
michael
parents: 4149
diff changeset
96
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
97 /* packet functions */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
98
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
99 typedef struct AVPacket {
3333
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
100 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
101 * Presentation timestamp in time_base units.
3333
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
102 * This is the time at which the decompressed packet will be presented
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
103 * to the user.
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
104 * Can be AV_NOPTS_VALUE if it is not stored in the file.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
105 * pts MUST be larger or equal to dts as presentation cannot happen before
3333
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
106 * decompression, unless one wants to view hex dumps. Some formats misuse
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
107 * the terms dts and pts/cts to mean something different, these timestamps
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
108 * must be converted to true pts/dts before they are stored in AVPacket.
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
109 */
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
110 int64_t pts;
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
111 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
112 * Decompression timestamp in time_base units.
3333
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
113 * This is the time at which the packet is decompressed.
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
114 * Can be AV_NOPTS_VALUE if it is not stored in the file.
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
115 */
8bec7ae8f0bb Document pts/dts.
michael
parents: 3330
diff changeset
116 int64_t dts;
65
a58a8a53eb46 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 64
diff changeset
117 uint8_t *data;
53
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
118 int size;
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
119 int stream_index;
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
120 int flags;
3878
ed2a8a769982 Try to clarify the semantics of AVPacket.duration.
michael
parents: 3852
diff changeset
121 /**
ed2a8a769982 Try to clarify the semantics of AVPacket.duration.
michael
parents: 3852
diff changeset
122 * Duration of this packet in time_base units, 0 if unknown.
ed2a8a769982 Try to clarify the semantics of AVPacket.duration.
michael
parents: 3852
diff changeset
123 * Equals next_pts - this_pts in presentation order.
ed2a8a769982 Try to clarify the semantics of AVPacket.duration.
michael
parents: 3852
diff changeset
124 */
ed2a8a769982 Try to clarify the semantics of AVPacket.duration.
michael
parents: 3852
diff changeset
125 int duration;
53
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
126 void (*destruct)(struct AVPacket *);
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
127 void *priv;
775
c5077fdab490 AVPacket.pos
michael
parents: 743
diff changeset
128 int64_t pos; ///< byte position in stream, -1 if unknown
3879
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
129
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
130 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
131 * Time difference in stream time base units from the pts of this
3918
4b8eb4f03ac5 Clarify convergence_duration.
michael
parents: 3900
diff changeset
132 * packet to the point at which the output from the decoder has converged
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
133 * independent from the availability of previous frames. That is, the
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
134 * frames are virtually identical no matter if decoding started from
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
135 * the very first frame or from this keyframe.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
136 * Is AV_NOPTS_VALUE if unknown.
3918
4b8eb4f03ac5 Clarify convergence_duration.
michael
parents: 3900
diff changeset
137 * This field is not the display duration of the current packet.
3879
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
138 *
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
139 * The purpose of this field is to allow seeking in streams that have no
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
140 * keyframes in the conventional sense. It corresponds to the
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
141 * recovery point SEI in H.264 and match_time_delta in NUT. It is also
3879
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
142 * essential for some types of subtitle streams to ensure that all
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
143 * subtitles are correctly displayed after seeking.
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
144 */
3f4d2a22bd1b Add AVPacket.convergence_duration.
michael
parents: 3878
diff changeset
145 int64_t convergence_duration;
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
146 } AVPacket;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
147 #define PKT_FLAG_KEY 0x0001
53
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
148
535
8430e4610971 uninitalized variables
michael
parents: 533
diff changeset
149 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
150
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
151 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
152 * Default packet destructor.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
153 */
797
f5a231a9a2f1 support changing in bitstream global headers into extradata style and back
michael
parents: 795
diff changeset
154 void av_destruct_packet(AVPacket *pkt);
535
8430e4610971 uninitalized variables
michael
parents: 533
diff changeset
155
2140
5b2736d3ac57 Doxygenize av_init_packet
ramiro
parents: 2139
diff changeset
156 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
157 * Initialize optional fields of a packet with default values.
2140
5b2736d3ac57 Doxygenize av_init_packet
ramiro
parents: 2139
diff changeset
158 *
5b2736d3ac57 Doxygenize av_init_packet
ramiro
parents: 2139
diff changeset
159 * @param pkt packet
5b2736d3ac57 Doxygenize av_init_packet
ramiro
parents: 2139
diff changeset
160 */
2139
12a46571c0c9 Export av_init_packet
ramiro
parents: 2088
diff changeset
161 void av_init_packet(AVPacket *pkt);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
162
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
163 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
164 * Allocate the payload of a packet and initialize its fields with
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
165 * default values.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
166 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
167 * @param pkt packet
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
168 * @param size wanted payload size
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
169 * @return 0 if OK, AVERROR_xxx otherwise
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
170 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
171 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
172
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
173 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
174 * Allocate and read the payload of a packet and initialize its fields with
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
175 * default values.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
176 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
177 * @param pkt packet
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
178 * @param size desired payload size
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
179 * @return >0 (read size) if OK, AVERROR_xxx otherwise
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
180 */
775
c5077fdab490 AVPacket.pos
michael
parents: 743
diff changeset
181 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
182
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
183 /**
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
184 * @warning This is a hack - the packet memory allocation stuff is broken. The
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
185 * packet is allocated if it was not really allocated.
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
186 */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
187 int av_dup_packet(AVPacket *pkt);
53
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
188
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
189 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
190 * Free a packet.
53
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
191 *
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
192 * @param pkt packet to free
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
193 */
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
194 static inline void av_free_packet(AVPacket *pkt)
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
195 {
163
470456bd0065 av_free_packet SEGV fix by (Arthur van Hoff (javanator))
michaelni
parents: 159
diff changeset
196 if (pkt && pkt->destruct) {
887
d70e50f1495f COSMETICS: tabs --> spaces, some prettyprinting
diego
parents: 885
diff changeset
197 pkt->destruct(pkt);
163
470456bd0065 av_free_packet SEGV fix by (Arthur van Hoff (javanator))
michaelni
parents: 159
diff changeset
198 }
53
fb671d87824e zero copy packet handling for DV1394 by Max Krasnyansky
bellard
parents: 52
diff changeset
199 }
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
200
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
201 /*************************************************/
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
202 /* fractional numbers for exact pts handling */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
203
2065
64bd1b09cef2 patch so that the deprecated items show up correctly
benoit
parents: 2061
diff changeset
204 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
205 * The exact value of the fractional number is: 'val + num / den'.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
206 * num is assumed to be 0 <= num < den.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
207 * @deprecated Use AVRational instead.
2065
64bd1b09cef2 patch so that the deprecated items show up correctly
benoit
parents: 2061
diff changeset
208 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
209 typedef struct AVFrac {
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
210 int64_t val, num, den;
4156
ccc2608599a5 Revert deprecation of AVFrac structure. Attempts to replace AVFrac have turned
diego
parents: 4154
diff changeset
211 } AVFrac;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
212
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
213 /*************************************************/
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
214 /* input/output formats */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
215
1677
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
216 struct AVCodecTag;
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
217
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
218 struct AVFormatContext;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
219
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
220 /** This structure contains the data a format has to probe a file. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
221 typedef struct AVProbeData {
64
b0e0eb595e29 * static,const,compiler warning cleanup
kabi
parents: 53
diff changeset
222 const char *filename;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
223 unsigned char *buf;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
224 int buf_size;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
225 } AVProbeData;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
226
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
227 #define AVPROBE_SCORE_MAX 100 ///< Maximum score, half of that is used for file-extension-based detection.
2001
1a3c9056982a allocate 32 extra bytes at the end of the probe buffer and remove most probe buf_size checks
michael
parents: 1986
diff changeset
228 #define AVPROBE_PADDING_SIZE 32 ///< extra allocated bytes at the end of the probe buffer
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
229
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
230 typedef struct AVFormatParameters {
743
af4e24d6310c switch to native time bases
michael
parents: 726
diff changeset
231 AVRational time_base;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
232 int sample_rate;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
233 int channels;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
234 int width;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
235 int height;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
236 enum PixelFormat pix_fmt;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
237 int channel; /**< Used to select DV channel. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
238 const char *standard; /**< TV standard, NTSC, PAL, SECAM */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
239 unsigned int mpeg2ts_raw:1; /**< Force raw MPEG-2 transport stream output, if possible. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
240 unsigned int mpeg2ts_compute_pcr:1; /**< Compute exact PCR for each transport
3553
c3b9334f46ae One-bit bitfields should probably be unsigned. Unfortunately, it is left
takis
parents: 3445
diff changeset
241 stream packet (only meaningful if
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
242 mpeg2ts_raw is TRUE). */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
243 unsigned int initial_pause:1; /**< Do not begin to play the stream
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
244 immediately (RTSP only). */
3553
c3b9334f46ae One-bit bitfields should probably be unsigned. Unfortunately, it is left
takis
parents: 3445
diff changeset
245 unsigned int prealloced_context:1;
2833
578a0c783eae Remove *_codec_id from AVFormatParameters with the next major version bump.
michael
parents: 2832
diff changeset
246 #if LIBAVFORMAT_VERSION_INT < (53<<16)
583
7793767ffe35 move p*m from image/lavf -> image2/lavc
michael
parents: 571
diff changeset
247 enum CodecID video_codec_id;
7793767ffe35 move p*m from image/lavf -> image2/lavc
michael
parents: 571
diff changeset
248 enum CodecID audio_codec_id;
2833
578a0c783eae Remove *_codec_id from AVFormatParameters with the next major version bump.
michael
parents: 2832
diff changeset
249 #endif
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
250 } AVFormatParameters;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
251
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
252 //! Demuxer will use url_fopen, no opened file should be provided by the caller.
1675
b8656dd86312 Attempt to better document AVFMT_NOFILE.
reimar
parents: 1663
diff changeset
253 #define AVFMT_NOFILE 0x0001
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
254 #define AVFMT_NEEDNUMBER 0x0002 /**< Needs '%d' in filename. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
255 #define AVFMT_SHOW_IDS 0x0008 /**< Show format stream IDs numbers. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
256 #define AVFMT_RAWPICTURE 0x0020 /**< Format wants AVPicture structure for
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
257 raw picture data. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
258 #define AVFMT_GLOBALHEADER 0x0040 /**< Format wants global header. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
259 #define AVFMT_NOTIMESTAMPS 0x0080 /**< Format does not need / have any timestamps. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
260 #define AVFMT_GENERIC_INDEX 0x0100 /**< Use generic index building code. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
261 #define AVFMT_TS_DISCONT 0x0200 /**< Format allows timestamp discontinuities. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
262
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
263 typedef struct AVOutputFormat {
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
264 const char *name;
3424
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
265 /**
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
266 * Descriptive name for the format, meant to be more human-readable
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
267 * than \p name. You \e should use the NULL_IF_CONFIG_SMALL() macro
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
268 * to define it.
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
269 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
270 const char *long_name;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
271 const char *mime_type;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
272 const char *extensions; /**< comma-separated filename extensions */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
273 /** Size of private data so that it can be allocated in the wrapper. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
274 int priv_data_size;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
275 /* output support */
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
276 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
277 enum CodecID video_codec; /**< default video codec */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
278 int (*write_header)(struct AVFormatContext *);
468
60f897e8dd2d pass AVPacket into av_write_frame()
michael
parents: 464
diff changeset
279 int (*write_packet)(struct AVFormatContext *, AVPacket *pkt);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
280 int (*write_trailer)(struct AVFormatContext *);
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
281 /** can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER, AVFMT_GLOBALHEADER */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
282 int flags;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
283 /** 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
284 int (*set_parameters)(struct AVFormatContext *, AVFormatParameters *);
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
285 int (*interleave_packet)(struct AVFormatContext *, AVPacket *out,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
286 AVPacket *in, int flush);
1677
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
287
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
288 /**
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
289 * List of supported codec_id-codec_tag pairs, ordered by "better
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
290 * choice first". The arrays are all CODEC_ID_NONE terminated.
1677
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
291 */
3766
f062deeedb8d Change codec_tag type from const struct AVCodecTag ** to const struct AVCodecTag * const *
reimar
parents: 3758
diff changeset
292 const struct AVCodecTag * const *codec_tag;
1677
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
293
2280
69270eb6b20c add proper support for subtitles muxing/stream copying
aurel
parents: 2241
diff changeset
294 enum CodecID subtitle_codec; /**< default subtitle codec */
69270eb6b20c add proper support for subtitles muxing/stream copying
aurel
parents: 2241
diff changeset
295
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
296 /* private fields */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
297 struct AVOutputFormat *next;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
298 } AVOutputFormat;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
299
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
300 typedef struct AVInputFormat {
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
301 const char *name;
3424
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
302 /**
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
303 * Descriptive name for the format, meant to be more human-readable
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
304 * than \p name. You \e should use the NULL_IF_CONFIG_SMALL() macro
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
305 * to define it.
7a0230981402 Make long_names in lavf/lavdev optional depending on CONFIG_SMALL.
diego
parents: 3334
diff changeset
306 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
307 const char *long_name;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
308 /** Size of private data so that it can be allocated in the wrapper. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
309 int priv_data_size;
2367
43a4290a6d77 mention AVPROBE_PADDING_SIZE at the read_probe() doxy
michael
parents: 2317
diff changeset
310 /**
2815
64cf0a2303ac cosmetics: comment typo fixes
diego
parents: 2813
diff changeset
311 * Tell if a given file has a chance of being parsed by this format.
64cf0a2303ac cosmetics: comment typo fixes
diego
parents: 2813
diff changeset
312 * The buffer provided is guaranteed to be AVPROBE_PADDING_SIZE bytes
64cf0a2303ac cosmetics: comment typo fixes
diego
parents: 2813
diff changeset
313 * big so you do not have to check for that unless you need more.
2367
43a4290a6d77 mention AVPROBE_PADDING_SIZE at the read_probe() doxy
michael
parents: 2317
diff changeset
314 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
315 int (*read_probe)(AVProbeData *);
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
316 /** Read the format header and initialize the AVFormatContext
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
317 structure. Return 0 if OK. 'ap' if non-NULL contains
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
318 additional parameters. Only used in raw format right
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
319 now. 'av_new_stream' should be called to create new streams. */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
320 int (*read_header)(struct AVFormatContext *,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
321 AVFormatParameters *ap);
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
322 /** Read one packet and put it in 'pkt'. pts and flags are also
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
323 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
324 AVFMTCTX_NOHEADER is used. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
325 int (*read_packet)(struct AVFormatContext *, AVPacket *pkt);
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
326 /** Close the stream. The AVFormatContext and AVStreams are not
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
327 freed by this function */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
328 int (*read_close)(struct AVFormatContext *);
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
329 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
330 * Seek to a given timestamp relative to the frames in
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
331 * stream component stream_index.
555
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
332 * @param stream_index must not be -1
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
333 * @param flags selects which direction should be preferred if no exact
555
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
334 * match is available
2203
a81bd08b5ff2 * clarifying the AVInputFormat::read_seek return value
romansh
parents: 2190
diff changeset
335 * @return >= 0 on success (but not necessarily the new offset)
555
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
336 */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
337 int (*read_seek)(struct AVFormatContext *,
555
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
338 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
339 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
340 * Gets the next timestamp in stream[stream_index].time_base units.
3175
55ce214a13ea typo: occured --> occurred
diego
parents: 3172
diff changeset
341 * @return the timestamp or AV_NOPTS_VALUE if an error occurred
437
50bae308f71e moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents: 420
diff changeset
342 */
50bae308f71e moving nearly identical binary search code from nut/mpeg/asf to utils.c
michael
parents: 420
diff changeset
343 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
344 int64_t *pos, int64_t pos_limit);
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
345 /** Can use flags: AVFMT_NOFILE, AVFMT_NEEDNUMBER. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
346 int flags;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
347 /** If extensions are defined, then no probe is done. You should
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
348 usually not use extension format guessing because it is not
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
349 reliable enough */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
350 const char *extensions;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
351 /** General purpose read-only value that the format can use. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
352 int value;
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
353
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
354 /** Start/resume playing - only meaningful if using a network-based format
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
355 (RTSP). */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
356 int (*read_play)(struct AVFormatContext *);
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
357
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
358 /** Pause playing - only meaningful if using a network-based format
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
359 (RTSP). */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
360 int (*read_pause)(struct AVFormatContext *);
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
361
3766
f062deeedb8d Change codec_tag type from const struct AVCodecTag ** to const struct AVCodecTag * const *
reimar
parents: 3758
diff changeset
362 const struct AVCodecTag * const *codec_tag;
1677
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
363
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
364 /* private fields */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
365 struct AVInputFormat *next;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
366 } AVInputFormat;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
367
2023
a3e79d6e4e3c add an enum for need_parsing
aurel
parents: 2020
diff changeset
368 enum AVStreamParseType {
a3e79d6e4e3c add an enum for need_parsing
aurel
parents: 2020
diff changeset
369 AVSTREAM_PARSE_NONE,
a3e79d6e4e3c add an enum for need_parsing
aurel
parents: 2020
diff changeset
370 AVSTREAM_PARSE_FULL, /**< full parsing and repack */
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
371 AVSTREAM_PARSE_HEADERS, /**< Only parse headers, do not repack. */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
372 AVSTREAM_PARSE_TIMESTAMPS, /**< full parsing and interpolation of timestamps for frames not starting on a packet boundary */
2023
a3e79d6e4e3c add an enum for need_parsing
aurel
parents: 2020
diff changeset
373 };
a3e79d6e4e3c add an enum for need_parsing
aurel
parents: 2020
diff changeset
374
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
375 typedef struct AVIndexEntry {
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
376 int64_t pos;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
377 int64_t timestamp;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
378 #define AVINDEX_KEYFRAME 0x0001
979
d2e5dfdf4def add size to AVIndex
michael
parents: 961
diff changeset
379 int flags:2;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
380 int size:30; //Yeah, trying to keep the size of this small to reduce memory requirements (it is 24 vs. 32 bytes due to possible 8-byte alignment).
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
381 int min_distance; /**< Minimum 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
382 } AVIndexEntry;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
383
3120
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
384 #define AV_DISPOSITION_DEFAULT 0x0001
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
385 #define AV_DISPOSITION_DUB 0x0002
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
386 #define AV_DISPOSITION_ORIGINAL 0x0004
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
387 #define AV_DISPOSITION_COMMENT 0x0008
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
388 #define AV_DISPOSITION_LYRICS 0x0010
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
389 #define AV_DISPOSITION_KARAOKE 0x0020
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
390
2846
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
391 /**
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
392 * Stream structure.
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
393 * New fields can be added to the end with minor version bumps.
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
394 * Removal, reordering and changes to existing fields require a major
2846
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
395 * version bump.
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
396 * sizeof(AVStream) must not be used outside libav*.
2846
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
397 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
398 typedef struct AVStream {
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
399 int index; /**< stream index in AVFormatContext */
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
400 int id; /**< format-specific stream ID */
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
401 AVCodecContext *codec; /**< codec context */
793
977417187c64 AVStream.nb_frames and docs for r_frame_rate
michael
parents: 790
diff changeset
402 /**
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
403 * Real base frame rate of the stream.
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
404 * This is the lowest frame rate with which all timestamps can be
2141
ramiro
parents: 2140
diff changeset
405 * represented accurately (it is the least common multiple of all
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
406 * frame rates in the stream). Note, this value is just a guess!
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
407 * For example if the time base is 1/90000 and all frames have either
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
408 * approximately 3600 or 1800 timer ticks, then r_frame_rate will be 50/1.
793
977417187c64 AVStream.nb_frames and docs for r_frame_rate
michael
parents: 790
diff changeset
409 */
977417187c64 AVStream.nb_frames and docs for r_frame_rate
michael
parents: 790
diff changeset
410 AVRational r_frame_rate;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
411 void *priv_data;
2300
9c8cfadff191 correct initial timestamps which have AV_NOPTS_VALUE
michael
parents: 2284
diff changeset
412
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
413 /* internal data used in av_find_stream_info() */
2300
9c8cfadff191 correct initial timestamps which have AV_NOPTS_VALUE
michael
parents: 2284
diff changeset
414 int64_t first_dts;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
415 /** encoding: pts generation when outputting stream */
2241
914aeda381e6 avoid deprecation warnings for AVFrac from avformat.h
mru
parents: 2220
diff changeset
416 struct AVFrac pts;
844
35e372e6a6c3 time_base description by Rich Felker | dalias, aerifal cx
michael
parents: 842
diff changeset
417
35e372e6a6c3 time_base description by Rich Felker | dalias, aerifal cx
michael
parents: 842
diff changeset
418 /**
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
419 * This is the fundamental unit of time (in seconds) in terms
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
420 * of which frame timestamps are represented. For fixed-fps content,
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
421 * time base should be 1/frame rate and timestamp increments should be 1.
844
35e372e6a6c3 time_base description by Rich Felker | dalias, aerifal cx
michael
parents: 842
diff changeset
422 */
462
b69898ffc92a move time_base (pts_num/pts_den) from AVFormatContext -> AVStream
michael
parents: 437
diff changeset
423 AVRational time_base;
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
424 int pts_wrap_bits; /**< number of bits in pts (used for wrapping control) */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
425 /* ffmpeg.c private use */
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
426 int stream_copy; /**< If set, just copy stream. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
427 enum AVDiscard discard; ///< Selects which packets can be discarded at will and do not need to be demuxed.
650
c129846f7f02 support discarding of uninterresting packets
michael
parents: 639
diff changeset
428 //FIXME move stuff to a flags field?
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
429 /** Quality, as it has been removed from AVCodecContext and put in AVVideoFrame.
2164
3804e39efbfd misc spelling fixes
diego
parents: 2163
diff changeset
430 * MN: dunno if that is the right place for it */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
431 float quality;
2386
2beaa59babad elaborate a little on AVStream.start_time, it seems the comment is not clear
michael
parents: 2374
diff changeset
432 /**
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
433 * Decoding: pts of the first frame of the stream, in stream time base.
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
434 * Only set this if you are absolutely 100% sure that the value you set
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
435 * it to really is the pts of the first frame.
2396
28f19eb568a2 mention that start_time maybe AV_NOPTS_VALUE (from patch by neilb suse de)
michael
parents: 2386
diff changeset
436 * This may be undefined (AV_NOPTS_VALUE).
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
437 * @note The ASF header does NOT contain a correct start_time the ASF
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
438 * demuxer must NOT set this.
2386
2beaa59babad elaborate a little on AVStream.start_time, it seems the comment is not clear
michael
parents: 2374
diff changeset
439 */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
440 int64_t start_time;
2397
e5086ec7a4d4 more verbose doxy for duration (from patch by neilb suse de)
michael
parents: 2396
diff changeset
441 /**
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
442 * Decoding: duration of the stream, in stream time base.
2397
e5086ec7a4d4 more verbose doxy for duration (from patch by neilb suse de)
michael
parents: 2396
diff changeset
443 * If a source file does not specify a duration, but does specify
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
444 * a bitrate, this value will be estimated from bitrate and file size.
2397
e5086ec7a4d4 more verbose doxy for duration (from patch by neilb suse de)
michael
parents: 2396
diff changeset
445 */
186
2265d21a04c8 added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents: 184
diff changeset
446 int64_t duration;
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
447
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
448 char language[4]; /** ISO 639 3-letter language code (empty string if undefined) */
784
5f3e609d7361 optional ISO 639 3 letter language field
bellard
parents: 775
diff changeset
449
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
450 /* av_read_frame() support */
2023
a3e79d6e4e3c add an enum for need_parsing
aurel
parents: 2020
diff changeset
451 enum AVStreamParseType need_parsing;
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
452 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
453
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
454 int64_t cur_dts;
3058
33ecae58665a revert 12156
michael
parents: 3055
diff changeset
455 int last_IP_duration;
33ecae58665a revert 12156
michael
parents: 3055
diff changeset
456 int64_t last_IP_pts;
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
457 /* av_seek_frame() support */
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
458 AVIndexEntry *index_entries; /**< Only used if the format does not
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
459 support seeking natively. */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
460 int nb_index_entries;
1332
7474cc6383d4 fix some signedness warnings
mru
parents: 1322
diff changeset
461 unsigned int index_entries_allocated_size;
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
462
793
977417187c64 AVStream.nb_frames and docs for r_frame_rate
michael
parents: 790
diff changeset
463 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
464
3711
a2bdb3bfeb99 increase MAX_REORDER_DELAY and pts_buffer size to 16, max for h264 atm
bcoudurier
parents: 3701
diff changeset
465 #if LIBAVFORMAT_VERSION_INT < (53<<16)
a2bdb3bfeb99 increase MAX_REORDER_DELAY and pts_buffer size to 16, max for h264 atm
bcoudurier
parents: 3701
diff changeset
466 int64_t unused[4+1];
a2bdb3bfeb99 increase MAX_REORDER_DELAY and pts_buffer size to 16, max for h264 atm
bcoudurier
parents: 3701
diff changeset
467 #endif
2973
910ac68ab3b5 Add support for Matroska attachments.
aurel
parents: 2955
diff changeset
468
910ac68ab3b5 Add support for Matroska attachments.
aurel
parents: 2955
diff changeset
469 char *filename; /**< source filename of the stream */
3120
ea5623a8efde Add 'disposition' bitfield to AVStream and use it for both muxing and demuxing
eugeni
parents: 3087
diff changeset
470
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
471 int disposition; /**< AV_DISPOSITION_* bit field */
3568
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
472
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
473 AVProbeData probe_data;
3711
a2bdb3bfeb99 increase MAX_REORDER_DELAY and pts_buffer size to 16, max for h264 atm
bcoudurier
parents: 3701
diff changeset
474 #define MAX_REORDER_DELAY 16
a2bdb3bfeb99 increase MAX_REORDER_DELAY and pts_buffer size to 16, max for h264 atm
bcoudurier
parents: 3701
diff changeset
475 int64_t pts_buffer[MAX_REORDER_DELAY+1];
3758
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
476
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
477 /**
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
478 * sample aspect ratio (0 if unknown)
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
479 * - encoding: Set by user.
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
480 * - decoding: Set by libavformat.
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
481 */
e966560661e5 export sample_aspect_ratio read by the demuxer in a separate field
aurel
parents: 3724
diff changeset
482 AVRational sample_aspect_ratio;
4153
74f56dba37d3 add metadata in AVStream, AVProgram and AVChapter
aurel
parents: 4152
diff changeset
483
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
484 struct AVMetadata *metadata;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
485 } AVStream;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
486
2573
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
487 #define AV_PROGRAM_RUNNING 1
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
488
2846
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
489 /**
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
490 * New fields can be added to the end with minor version bumps.
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
491 * Removal, reordering and changes to existing fields require a major
2846
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
492 * version bump.
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
493 * sizeof(AVProgram) must not be used outside libav*.
2846
625c2c60f585 Document a few more structure change rules with relation to ABI/API.
michael
parents: 2844
diff changeset
494 */
2573
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
495 typedef struct AVProgram {
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
496 int id;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
497 char *provider_name; ///< network name for DVB streams
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
498 char *name; ///< service name for DVB streams
2573
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
499 int flags;
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
500 enum AVDiscard discard; ///< selects which program to discard and which to feed to the caller
2650
4e3d38c8896c API extension: AVProgram now has an array (stream_index) containing the indexes of the streams in AVFormatContext
nicodvb
parents: 2620
diff changeset
501 unsigned int *stream_index;
4e3d38c8896c API extension: AVProgram now has an array (stream_index) containing the indexes of the streams in AVFormatContext
nicodvb
parents: 2620
diff changeset
502 unsigned int nb_stream_indexes;
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
503 struct AVMetadata *metadata;
2573
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
504 } AVProgram;
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
505
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
506 #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
507 (streams are added dynamically) */
62cec412a186 make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents: 274
diff changeset
508
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
509 typedef struct AVChapter {
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
510 int id; ///< unique ID to identify the chapter
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
511 AVRational time_base; ///< time base in which the start/end timestamps are specified
3322
97f7b77a969b clarify start/end timebase
michael
parents: 3321
diff changeset
512 int64_t start, end; ///< chapter start/end time in time_base units
3321
b847faf64408 align comments
michael
parents: 3320
diff changeset
513 char *title; ///< chapter title
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
514 struct AVMetadata *metadata;
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
515 } AVChapter;
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
516
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
517 #define MAX_STREAMS 20
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
518
2844
440267faee3c Document structure change rules with relation to ABI/API.
michael
parents: 2836
diff changeset
519 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
520 * Format I/O context.
2844
440267faee3c Document structure change rules with relation to ABI/API.
michael
parents: 2836
diff changeset
521 * New fields can be added to the end with minor version bumps.
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
522 * Removal, reordering and changes to existing fields require a major
2844
440267faee3c Document structure change rules with relation to ABI/API.
michael
parents: 2836
diff changeset
523 * version bump.
2851
979a885a7686 comment typo fixes
diego
parents: 2850
diff changeset
524 * sizeof(AVFormatContext) must not be used outside libav*.
2844
440267faee3c Document structure change rules with relation to ABI/API.
michael
parents: 2836
diff changeset
525 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
526 typedef struct AVFormatContext {
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
527 const AVClass *av_class; /**< Set by av_alloc_format_context. */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
528 /* Can only be iformat or oformat, not both at the same time. */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
529 struct AVInputFormat *iformat;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
530 struct AVOutputFormat *oformat;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
531 void *priv_data;
2771
d52c718e83f9 Use dynamically allocated ByteIOContext in AVFormatContext
andoma
parents: 2749
diff changeset
532 ByteIOContext *pb;
1663
a7508607760c Make nb_streams unsigned to avoid an ugly cast.
diego
parents: 1602
diff changeset
533 unsigned int nb_streams;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
534 AVStream *streams[MAX_STREAMS];
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
535 char filename[1024]; /**< input or output filename */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
536 /* stream info */
420
e440fb884442 * making it possible to specify recording date and time in a stream
romansh
parents: 384
diff changeset
537 int64_t timestamp;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
538 char title[512];
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
539 char author[512];
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
540 char copyright[512];
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
541 char comment[512];
234
b99548e3ab84 ID3 parsing and generation in MP3 format
bellard
parents: 230
diff changeset
542 char album[512];
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
543 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
544 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
545 char genre[32]; /**< ID3 genre */
234
b99548e3ab84 ID3 parsing and generation in MP3 format
bellard
parents: 230
diff changeset
546
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
547 int ctx_flags; /**< Format-specific flags, see AVFMTCTX_xx */
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
548 /* 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
549 /** This buffer is only needed when packets were already buffered but
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
550 not decoded, for example to get the codec parameters in MPEG
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
551 streams. */
186
2265d21a04c8 added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents: 184
diff changeset
552 struct AVPacketList *packet_buffer;
2265d21a04c8 added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents: 184
diff changeset
553
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
554 /** 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
555 AV_TIME_BASE fractional seconds. NEVER set this value directly:
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
556 It is deduced from the AVStream values. */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
557 int64_t start_time;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
558 /** 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
559 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
560 AVStream values. */
2265d21a04c8 added stream start time and duration API - AV_NOPTS_VALUE is no longer zero
bellard
parents: 184
diff changeset
561 int64_t duration;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
562 /** 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
563 int64_t file_size;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
564 /** 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
565 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
566 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
567 int bit_rate;
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
568
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
569 /* av_read_frame() support */
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
570 AVStream *cur_st;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
571 const uint8_t *cur_ptr;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
572 int cur_len;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
573 AVPacket cur_pkt;
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
574
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
575 /* av_seek_frame() support */
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
576 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
577 int index_built;
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
578
551
ef359bf133cc user selectable packet_size and mux_rate
michael
parents: 549
diff changeset
579 int mux_rate;
ef359bf133cc user selectable packet_size and mux_rate
michael
parents: 549
diff changeset
580 int packet_size;
566
c1e54abaa87e user setable preload and max_mux_delay
michael
parents: 565
diff changeset
581 int preload;
c1e54abaa87e user setable preload and max_mux_delay
michael
parents: 565
diff changeset
582 int max_delay;
790
80aec794c2ed Animated GIF looping patch by (Todd Kirby // ffmpeg.php gmail com)
michael
parents: 784
diff changeset
583
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
584 #define AVFMT_NOOUTPUTLOOP -1
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
585 #define AVFMT_INFINITEOUTPUTLOOP 0
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
586 /** 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
587 int loop_output;
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
588
841
ba7631ba33a7 support fixing missing pts by parsing future frames
michael
parents: 829
diff changeset
589 int flags;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
590 #define AVFMT_FLAG_GENPTS 0x0001 ///< Generate pts if missing even if it requires parsing future frames.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
591 #define AVFMT_FLAG_IGNIDX 0x0002 ///< Ignore index.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
592 #define AVFMT_FLAG_NONBLOCK 0x0004 ///< Do not block when reading packets from input.
1175
8b53c0f3e7ad add loop_input to AVFormatContext, getting rid of old hack
mru
parents: 1167
diff changeset
593
8b53c0f3e7ad add loop_input to AVFormatContext, getting rid of old hack
mru
parents: 1167
diff changeset
594 int loop_input;
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
595 /** 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
596 unsigned int probesize;
1720
1a8d1f66c867 make av_find_stream_info() duration user selectable
michael
parents: 1679
diff changeset
597
1a8d1f66c867 make av_find_stream_info() duration user selectable
michael
parents: 1679
diff changeset
598 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
599 * Maximum time (in AV_TIME_BASE units) during which the input should
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
600 * be analyzed in av_find_stream_info().
1720
1a8d1f66c867 make av_find_stream_info() duration user selectable
michael
parents: 1679
diff changeset
601 */
1a8d1f66c867 make av_find_stream_info() duration user selectable
michael
parents: 1679
diff changeset
602 int max_analyze_duration;
1778
d8c6b719a070 add key field to AVFormatContext for de/encryption support, patch by Reimar
bcoudurier
parents: 1756
diff changeset
603
d8c6b719a070 add key field to AVFormatContext for de/encryption support, patch by Reimar
bcoudurier
parents: 1756
diff changeset
604 const uint8_t *key;
d8c6b719a070 add key field to AVFormatContext for de/encryption support, patch by Reimar
bcoudurier
parents: 1756
diff changeset
605 int keylen;
2573
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
606
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
607 unsigned int nb_programs;
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
608 AVProgram **programs;
2832
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
609
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
610 /**
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
611 * Forced video codec_id.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
612 * Demuxing: Set by user.
2832
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
613 */
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
614 enum CodecID video_codec_id;
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
615 /**
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
616 * Forced audio codec_id.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
617 * Demuxing: Set by user.
2832
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
618 */
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
619 enum CodecID audio_codec_id;
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
620 /**
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
621 * Forced subtitle codec_id.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
622 * Demuxing: Set by user.
2832
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
623 */
8ac5fe1c5549 Allow overriding codec_ids.
michael
parents: 2815
diff changeset
624 enum CodecID subtitle_codec_id;
2932
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
625
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
626 /**
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
627 * Maximum amount of memory in bytes to use per stream for the index.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
628 * If the needed index exceeds this size, entries will be discarded as
2932
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
629 * needed to maintain a smaller size. This can lead to slower or less
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
630 * accurate seeking (depends on demuxer).
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
631 * Demuxers for which a full in-memory index is mandatory will ignore
2932
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
632 * this.
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
633 * muxing : unused
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
634 * demuxing: set by user
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
635 */
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
636 unsigned int max_index_size;
3128
b5e2ce291882 Introduce max_picture_buffer variable in AVFormatContext,
ramiro
parents: 3120
diff changeset
637
b5e2ce291882 Introduce max_picture_buffer variable in AVFormatContext,
ramiro
parents: 3120
diff changeset
638 /**
3129
96814e704e8b Typo + grammar
ramiro
parents: 3128
diff changeset
639 * Maximum amount of memory in bytes to use for buffering frames
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
640 * obtained from realtime capture devices.
3128
b5e2ce291882 Introduce max_picture_buffer variable in AVFormatContext,
ramiro
parents: 3120
diff changeset
641 */
b5e2ce291882 Introduce max_picture_buffer variable in AVFormatContext,
ramiro
parents: 3120
diff changeset
642 unsigned int max_picture_buffer;
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
643
3329
8426e474011f nb_chapters should be unsigned
michael
parents: 3328
diff changeset
644 unsigned int nb_chapters;
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
645 AVChapter **chapters;
3445
4a1ecbbf5725 Make timestamp debugging work nicer.
michael
parents: 3440
diff changeset
646
4a1ecbbf5725 Make timestamp debugging work nicer.
michael
parents: 3440
diff changeset
647 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
648 * Flags to enable debugging.
3445
4a1ecbbf5725 Make timestamp debugging work nicer.
michael
parents: 3440
diff changeset
649 */
4a1ecbbf5725 Make timestamp debugging work nicer.
michael
parents: 3440
diff changeset
650 int debug;
4a1ecbbf5725 Make timestamp debugging work nicer.
michael
parents: 3440
diff changeset
651 #define FF_FDEBUG_TS 0x0001
3568
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
652
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
653 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
654 * Raw packets from the demuxer, prior to parsing and decoding.
3568
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
655 * This buffer is used for buffering packets until the codec can
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
656 * be identified, as parsing cannot be done without knowing the
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
657 * codec.
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
658 */
c24546b44906 New codec probing system try #1.
michael
parents: 3556
diff changeset
659 struct AVPacketList *raw_packet_buffer;
3698
b7e347127897 Maintain pointer to end of AVFormatContext.packet_buffer list
mru
parents: 3617
diff changeset
660 struct AVPacketList *raw_packet_buffer_end;
b7e347127897 Maintain pointer to end of AVFormatContext.packet_buffer list
mru
parents: 3617
diff changeset
661
b7e347127897 Maintain pointer to end of AVFormatContext.packet_buffer list
mru
parents: 3617
diff changeset
662 struct AVPacketList *packet_buffer_end;
4149
1f857a4519bd Generic metadata API.
michael
parents: 4147
diff changeset
663
4154
bd4d3fee45d0 rename AVMetaData to AVMetadata and meta_data to metadata
aurel
parents: 4153
diff changeset
664 struct AVMetadata *metadata;
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
665 } AVFormatContext;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
666
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
667 typedef struct AVPacketList {
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
668 AVPacket pkt;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
669 struct AVPacketList *next;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
670 } AVPacketList;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
671
2812
173b5cb7efde av_*_next() API for libavformat
michael
parents: 2788
diff changeset
672 #if LIBAVFORMAT_VERSION_INT < (53<<16)
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
673 extern AVInputFormat *first_iformat;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
674 extern AVOutputFormat *first_oformat;
2812
173b5cb7efde av_*_next() API for libavformat
michael
parents: 2788
diff changeset
675 #endif
173b5cb7efde av_*_next() API for libavformat
michael
parents: 2788
diff changeset
676
173b5cb7efde av_*_next() API for libavformat
michael
parents: 2788
diff changeset
677 AVInputFormat *av_iformat_next(AVInputFormat *f);
173b5cb7efde av_*_next() API for libavformat
michael
parents: 2788
diff changeset
678 AVOutputFormat *av_oformat_next(AVOutputFormat *f);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
679
583
7793767ffe35 move p*m from image/lavf -> image2/lavc
michael
parents: 571
diff changeset
680 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
681
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
682 /* XXX: use automatic init with either ELF sections or C file parser */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
683 /* modules */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
684
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
685 /* utils.c */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
686 void av_register_input_format(AVInputFormat *format);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
687 void av_register_output_format(AVOutputFormat *format);
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
688 AVOutputFormat *guess_stream_format(const char *short_name,
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
689 const char *filename,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
690 const char *mime_type);
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
691 AVOutputFormat *guess_format(const char *short_name,
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
692 const char *filename,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
693 const char *mime_type);
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
694
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
695 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
696 * Guesses the codec ID based upon muxer and filename.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
697 */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
698 enum CodecID av_guess_codec(AVOutputFormat *fmt, const char *short_name,
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
699 const char *filename, const char *mime_type,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
700 enum CodecType type);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
701
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
702 /**
1908
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
703 * 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
704 *
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
705 * @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
706 * @param buf buffer
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
707 * @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
708 *
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
709 * @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
710 */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
711 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
712
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
713 /**
1908
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
714 * 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
715 *
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
716 * @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
717 * 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
718 * @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
719 * higher importance.
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
720 * @param buf buffer
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
721 * @param size buffer size
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
722 *
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
723 * @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
724 */
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
725 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
726
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
727 /**
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
728 * 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
729 *
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
730 * @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
731 * @param pkt packet to dump
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
732 * @param dump_payload True if the payload must be displayed, too.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
733 */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
734 void av_pkt_dump(FILE *f, AVPacket *pkt, int dump_payload);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
735
1908
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
736 /**
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
737 * 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
738 *
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
739 * @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
740 * 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
741 * @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
742 * higher importance.
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
743 * @param pkt packet to dump
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
744 * @param dump_payload True if the payload must be displayed, too.
1908
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
745 */
174083eafc6c Introduce two new logging functions av_hex_dump_log() and av_pkt_dump_log()
takis
parents: 1906
diff changeset
746 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
747
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
748 void av_register_all(void);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
749
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
750 /** codec tag <-> codec id */
4019
a2539db62994 Fix argument constness for the av_codec_get_id() and
stefano
parents: 4004
diff changeset
751 enum CodecID av_codec_get_id(const struct AVCodecTag * const *tags, unsigned int tag);
a2539db62994 Fix argument constness for the av_codec_get_id() and
stefano
parents: 4004
diff changeset
752 unsigned int av_codec_get_tag(const struct AVCodecTag * const *tags, enum CodecID id);
1677
2a85c82b8538 add codec_id <-> codec_tag tables to AVIn/OutputFormat
michael
parents: 1675
diff changeset
753
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
754 /* media file input */
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
755
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
756 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
757 * Finds AVInputFormat based on the short name of the input format.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
758 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
759 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
760
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
761 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
762 * Guess file format.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
763 *
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
764 * @param is_opened Whether the file is already opened; determines whether
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
765 * demuxers with or without AVFMT_NOFILE are probed.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
766 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
767 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
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 * 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
771 * 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
772 */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
773 int av_open_input_stream(AVFormatContext **ic_ptr,
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
774 ByteIOContext *pb, const char *filename,
293
62cec412a186 make AVFMT_NOHEADER flag dynamic - added av_open_input_stream()
bellard
parents: 274
diff changeset
775 AVInputFormat *fmt, AVFormatParameters *ap);
1840
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 /**
2141
ramiro
parents: 2140
diff changeset
778 * Open a media file as input. The codecs are not opened. Only the file
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
779 * header (if present) is read.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
780 *
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
781 * @param ic_ptr The opened media file handle is put here.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
782 * @param filename filename to open
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
783 * @param fmt If non-NULL, force the file format to use.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
784 * @param buf_size optional buffer size (zero if default is OK)
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
785 * @param ap Additional parameters needed when opening the file
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
786 * (NULL if default).
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
787 * @return 0 if OK, AVERROR_xxx otherwise
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
788 */
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
789 int av_open_input_file(AVFormatContext **ic_ptr, const char *filename,
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
790 AVInputFormat *fmt,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
791 int buf_size,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
792 AVFormatParameters *ap);
2813
9d53cc092c55 document how to free the result of av_alloc_format_context()
michael
parents: 2812
diff changeset
793 /**
9d53cc092c55 document how to free the result of av_alloc_format_context()
michael
parents: 2812
diff changeset
794 * Allocate an AVFormatContext.
2815
64cf0a2303ac cosmetics: comment typo fixes
diego
parents: 2813
diff changeset
795 * Can be freed with av_free() but do not forget to free everything you
2813
9d53cc092c55 document how to free the result of av_alloc_format_context()
michael
parents: 2812
diff changeset
796 * explicitly allocated as well!
9d53cc092c55 document how to free the result of av_alloc_format_context()
michael
parents: 2812
diff changeset
797 */
370
845f9de2c883 av_log() patch by (Michel Bardiaux <mbardiaux at peaktime dot be>)
michael
parents: 369
diff changeset
798 AVFormatContext *av_alloc_format_context(void);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
799
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
800 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
801 * 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
802 * is useful for file formats with no headers such as MPEG. This
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
803 * function also computes the real frame rate in case of MPEG-2 repeat
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
804 * frame mode.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
805 * 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
806 * 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
807 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
808 * @param ic media file handle
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
809 * @return >=0 if OK, AVERROR_xxx on error
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
810 * @todo Let the user decide somehow what information is needed so that
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
811 * we do not waste time getting stuff the user does not need.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
812 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
813 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
814
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
815 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
816 * 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
817 *
2141
ramiro
parents: 2140
diff changeset
818 * This function is obsolete and should never be used.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
819 * Use av_read_frame() instead.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
820 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
821 * @param s media file handle
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
822 * @param pkt is filled
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
823 * @return 0 if OK, AVERROR_xxx on error
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
824 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
825 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
826
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
827 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
828 * 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
829 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
830 * The returned packet is valid
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
831 * 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
832 * 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
833 * 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
834 * 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
835 * 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
836 * then it contains one frame.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
837 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
838 * pkt->pts, pkt->dts and pkt->duration are always set to correct
1844
2c91663b3bc6 Correct wrong avformat documentation.
takis
parents: 1840
diff changeset
839 * values in AVStream.timebase units (and guessed if the format cannot
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
840 * provide them). pkt->pts can be AV_NOPTS_VALUE if the video format
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
841 * has B-frames, so it is better to rely on pkt->dts if you do not
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
842 * decompress the payload.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
843 *
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
844 * @return 0 if OK, < 0 on error or end of file
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
845 */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
846 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
847
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
848 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
849 * 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
850 * 'timestamp' in 'stream_index'.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
851 * @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
852 * 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
853 * from AV_TIME_BASE units to the stream specific time_base.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
854 * @param timestamp Timestamp in AVStream.time_base units
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
855 * or, if no stream is specified, in AV_TIME_BASE units.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
856 * @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
857 * @return >= 0 on success
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
858 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
859 int av_seek_frame(AVFormatContext *s, int stream_index, int64_t timestamp,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
860 int flags);
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
861
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
862 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
863 * Start playing a network based stream (e.g. RTSP stream) at the
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
864 * current position.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
865 */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
866 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
867
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
868 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
869 * 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
870 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
871 * 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
872 */
303
2833c2311b66 initial av_read_frame() and av_seek_frame() support
bellard
parents: 293
diff changeset
873 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
874
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
875 /**
2835
b158768c5352 Add a av_close_input_stream function
reimar
parents: 2834
diff changeset
876 * Free a AVFormatContext allocated by av_open_input_stream.
b158768c5352 Add a av_close_input_stream function
reimar
parents: 2834
diff changeset
877 * @param s context to free
b158768c5352 Add a av_close_input_stream function
reimar
parents: 2834
diff changeset
878 */
b158768c5352 Add a av_close_input_stream function
reimar
parents: 2834
diff changeset
879 void av_close_input_stream(AVFormatContext *s);
b158768c5352 Add a av_close_input_stream function
reimar
parents: 2834
diff changeset
880
b158768c5352 Add a av_close_input_stream function
reimar
parents: 2834
diff changeset
881 /**
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
882 * 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
883 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
884 * @param s media file handle
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
885 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
886 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
887
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
888 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
889 * 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
890 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
891 * 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
892 * 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
893 * 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
894 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
895 * @param s media file handle
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
896 * @param id file-format-dependent stream ID
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
897 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
898 AVStream *av_new_stream(AVFormatContext *s, int id);
2573
2842354cb9a4 Added definition and utility functions to handle AVProgram(s) in AVFormatContext
nicodvb
parents: 2559
diff changeset
899 AVProgram *av_new_program(AVFormatContext *s, int id);
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
900
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
901 /**
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
902 * Add a new chapter.
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
903 * This function is NOT part of the public API
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
904 * and should ONLY be used by demuxers.
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
905 *
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
906 * @param s media file handle
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
907 * @param id unique ID for this chapter
3334
7a823a401282 Pass time_base as argument to new_chapter() as well.
michael
parents: 3333
diff changeset
908 * @param start chapter start time in time_base units
7a823a401282 Pass time_base as argument to new_chapter() as well.
michael
parents: 3333
diff changeset
909 * @param end chapter end time in time_base units
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
910 * @param title chapter title
3330
374e74567a4e Make ff_new_chapter() return AVChapter instead of int so its consistant with
michael
parents: 3329
diff changeset
911 *
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
912 * @return AVChapter or NULL on error
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
913 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
914 AVChapter *ff_new_chapter(AVFormatContext *s, int id, AVRational time_base,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
915 int64_t start, int64_t end, const char *title);
3314
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
916
724f338005d4 add support for chapters definition in lavf
aurel
parents: 3249
diff changeset
917 /**
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
918 * 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
919 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
920 * @param s stream
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
921 * @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
922 * (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
923 * @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
924 * @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
925 */
462
b69898ffc92a move time_base (pts_num/pts_den) from AVFormatContext -> AVStream
michael
parents: 437
diff changeset
926 void av_set_pts_info(AVStream *s, int pts_wrap_bits,
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
927 int pts_num, int pts_den);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
928
555
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
929 #define AVSEEK_FLAG_BACKWARD 1 ///< seek backward
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
930 #define AVSEEK_FLAG_BYTE 2 ///< seeking based on position in bytes
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
931 #define AVSEEK_FLAG_ANY 4 ///< seek to any frame, even non-keyframes
555
0a997108f384 use native timebase for seeking
michael
parents: 554
diff changeset
932
346
e154eb1b7149 caching of timestamps for mpeg-ps so seeking is faster
michael
parents: 338
diff changeset
933 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
934
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
935 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
936 * Gets the index for a specific timestamp.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
937 * @param flags if AVSEEK_FLAG_BACKWARD then the returned index will correspond
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
938 * to the timestamp which is <= the requested one, if backward
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
939 * is 0, then it will be >=
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
940 * 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
941 * @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
942 */
597
d814669d2c13 int / int64 fix by (Wolfram Gloger <wmglo @@@ dent:med:uni-muenchen:de>)
michael
parents: 594
diff changeset
943 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
944
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
945 /**
2932
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
946 * Ensures the index uses less memory than the maximum specified in
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
947 * AVFormatContext.max_index_size, by discarding entries if it grows
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
948 * too large.
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
949 * This function is not part of the public API and should only be called
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
950 * by demuxers.
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
951 */
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
952 void ff_reduce_index(AVFormatContext *s, int stream_index);
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
953
f5de41d943e2 user specifyable maximum amount of memory to use for the index.
michael
parents: 2876
diff changeset
954 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
955 * Add an index entry into a sorted list. Update the entry if the list
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
956 * already contains it.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
957 *
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
958 * @param timestamp timestamp in the time base of the given stream
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
959 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
960 int av_add_index_entry(AVStream *st, int64_t pos, int64_t timestamp,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
961 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
962
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
963 /**
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
964 * Does a binary search using av_index_search_timestamp() and
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
965 * AVCodec.read_timestamp().
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
966 * This is not supposed to be called directly by a user application,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
967 * but by demuxers.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
968 * @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
969 * @param stream_index stream number
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
970 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
971 int av_seek_frame_binary(AVFormatContext *s, int stream_index,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
972 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
973
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
974 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
975 * Updates cur_dts of all streams based on the given timestamp and AVStream.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
976 *
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
977 * Stream ref_st unchanged, others set cur_dts in their native time base.
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
978 * Only needed for timestamp wrapping or if (dts not set and pts!=dts).
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
979 * @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
980 * @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
981 */
1185
13dc486b272b Try to find out correct start time to make seeking faster and add some
reimar
parents: 1175
diff changeset
982 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
983
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
984 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
985 * Does a binary search using read_timestamp().
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
986 * This is not supposed to be called directly by a user application,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
987 * but by demuxers.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
988 * @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
989 * @param stream_index stream number
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
990 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
991 int64_t av_gen_search(AVFormatContext *s, int stream_index,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
992 int64_t target_ts, int64_t pos_min,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
993 int64_t pos_max, int64_t pos_limit,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
994 int64_t ts_min, int64_t ts_max,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
995 int flags, int64_t *ts_ret,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
996 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
997
1858
7ce72baa2ce5 Doxygenize the existing comments in avformat.h. The contents of the comments
takis
parents: 1844
diff changeset
998 /** media file output */
17
e1200dd82537 added simple still image format support to simplify image and imagepipe video formats
bellard
parents: 5
diff changeset
999 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
1000
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1001 /**
2164
3804e39efbfd misc spelling fixes
diego
parents: 2163
diff changeset
1002 * Allocate the stream private data and write the stream header to an
3804e39efbfd misc spelling fixes
diego
parents: 2163
diff changeset
1003 * output media file.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1004 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1005 * @param s media file handle
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1006 * @return 0 if OK, AVERROR_xxx on error
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1007 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1008 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
1009
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1010 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1011 * 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
1012 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1013 * The packet shall contain one audio or video frame.
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1014 * The packet must be correctly interleaved according to the container
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1015 * specification, if not then av_interleaved_write_frame must be used.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1016 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1017 * @param s media file handle
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1018 * @param pkt The packet, which contains the stream_index, buf/buf_size,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1019 dts/pts, ...
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1020 * @return < 0 on error, = 0 if OK, 1 if end of stream wanted
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1021 */
468
60f897e8dd2d pass AVPacket into av_write_frame()
michael
parents: 464
diff changeset
1022 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
1023
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1024 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1025 * 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
1026 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1027 * 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
1028 * If the packets are already correctly interleaved the application should
2165
eac986610f47 misc typo fixes
diego
parents: 2164
diff changeset
1029 * call av_write_frame() instead as it is slightly faster. It is also important
eac986610f47 misc typo fixes
diego
parents: 2164
diff changeset
1030 * to keep in mind that completely non-interleaved input will need huge amounts
eac986610f47 misc typo fixes
diego
parents: 2164
diff changeset
1031 * of memory to interleave with this, so it is preferable to interleave at the
eac986610f47 misc typo fixes
diego
parents: 2164
diff changeset
1032 * demuxer level.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1033 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1034 * @param s media file handle
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1035 * @param pkt The packet, which contains the stream_index, buf/buf_size,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1036 dts/pts, ...
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1037 * @return < 0 on error, = 0 if OK, 1 if end of stream wanted
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1038 */
470
334e08488ad1 correctly interleave packets during encoding
michael
parents: 468
diff changeset
1039 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
1040
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1041 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1042 * Interleave a packet per dts in an output media file.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1043 *
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1044 * Packets with pkt->destruct == av_destruct_packet will be freed inside this
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1045 * function, so they cannot be used after it, note calling av_free_packet()
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1046 * on them is still safe.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1047 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1048 * @param s media file handle
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1049 * @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
1050 * @param in the input packet
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1051 * @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
1052 * remaining packets should be output
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1053 * @return 1 if a packet was output, 0 if no packet could be output,
3175
55ce214a13ea typo: occured --> occurred
diego
parents: 3172
diff changeset
1054 * < 0 if an error occurred
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1055 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1056 int av_interleave_packet_per_dts(AVFormatContext *s, AVPacket *out,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1057 AVPacket *pkt, int flush);
468
60f897e8dd2d pass AVPacket into av_write_frame()
michael
parents: 464
diff changeset
1058
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1059 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1060 * @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
1061 * free the file private data.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1062 *
3880
5245e7006f4c Change doxygen comment: Clarify when av_write_trailer should be called.
reimar
parents: 3879
diff changeset
1063 * May only be called after a successful call to av_write_header.
5245e7006f4c Change doxygen comment: Clarify when av_write_trailer should be called.
reimar
parents: 3879
diff changeset
1064 *
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1065 * @param s media file handle
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1066 * @return 0 if OK, AVERROR_xxx on error
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1067 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1068 int av_write_trailer(AVFormatContext *s);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1069
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1070 void dump_format(AVFormatContext *ic,
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
1071 int index,
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1072 const char *url,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1073 int is_output);
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1074
4147
b3d75fa26b5c Drop the deprecated parse_image_size() and parse_frame_rate() functions
stefano
parents: 4019
diff changeset
1075 #if LIBAVFORMAT_VERSION_MAJOR < 53
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1076 /**
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1077 * Parses width and height out of string str.
2163
6c0176688fae Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 2148
diff changeset
1078 * @deprecated Use av_parse_video_frame_size instead.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1079 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1080 attribute_deprecated int parse_image_size(int *width_ptr, int *height_ptr,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1081 const char *str);
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1082
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1083 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1084 * Converts frame rate from string to a fraction.
2163
6c0176688fae Move the video size and rate abbreviations system from libavformat to libavcodec
benoit
parents: 2148
diff changeset
1085 * @deprecated Use av_parse_video_frame_rate instead.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1086 */
3949
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1087 attribute_deprecated int parse_frame_rate(int *frame_rate, int *frame_rate_base,
8d94741841b2 cosmetics: Break overly long lines, one grammar fix.
diego
parents: 3948
diff changeset
1088 const char *arg);
4147
b3d75fa26b5c Drop the deprecated parse_image_size() and parse_frame_rate() functions
stefano
parents: 4019
diff changeset
1089 #endif
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1090
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1091 /**
2559
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1092 * Parses \p datestr and returns a corresponding number of microseconds.
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1093 * @param datestr String representing a date or a duration.
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1094 * - If a date the syntax is:
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1095 * @code
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1096 * [{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
1097 * @endcode
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1098 * Time is local time unless Z is appended, in which case it is
2559
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1099 * interpreted as UTC.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1100 * If the year-month-day part is not specified it takes the current
2559
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1101 * year-month-day.
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1102 * Returns the number of microseconds since 1st of January, 1970 up to
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1103 * the time of the parsed date or INT64_MIN if \p datestr cannot be
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1104 * successfully parsed.
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1105 * - If a duration the syntax is:
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1106 * @code
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1107 * [-]HH[:MM[:SS[.m...]]]
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1108 * [-]S+[.m...]
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1109 * @endcode
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1110 * Returns the number of microseconds contained in a time interval
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1111 * with the specified duration or INT64_MIN if \p datestr cannot be
2788
f66d29c833a6 succes --> success typo
diego
parents: 2784
diff changeset
1112 * successfully parsed.
2559
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1113 * @param duration Flag which tells how to interpret \p datestr, if
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1114 * not zero \p datestr is interpreted as a duration, otherwise as a
c57d3d6c8f44 Make parse_date return INT64_MIN in case of unparsable input.
benoit
parents: 2548
diff changeset
1115 * date.
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1116 */
65
a58a8a53eb46 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 64
diff changeset
1117 int64_t parse_date(const char *datestr, int duration);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1118
3947
a324a7aa8a5b Move doxygen comments for av_gettime from utils.c to avformat.h.
diego
parents: 3918
diff changeset
1119 /** Gets the current time in microseconds. */
65
a58a8a53eb46 * UINTX -> uintx_t INTX -> intx_t
kabi
parents: 64
diff changeset
1120 int64_t av_gettime(void);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1121
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1122 /* ffm-specific for ffserver */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1123 #define FFM_PACKET_SIZE 4096
3973
549a09cf23fe Remove offset_t typedef and use int64_t directly instead.
diego
parents: 3970
diff changeset
1124 int64_t ffm_read_write_index(int fd);
549a09cf23fe Remove offset_t typedef and use int64_t directly instead.
diego
parents: 3970
diff changeset
1125 void ffm_write_write_index(int fd, int64_t pos);
549a09cf23fe Remove offset_t typedef and use int64_t directly instead.
diego
parents: 3970
diff changeset
1126 void ffm_set_write_index(AVFormatContext *s, int64_t pos, int64_t file_size);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1127
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1128 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1129 * 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
1130 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1131 * 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
1132 * Return 1 if found.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1133 */
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1134 int find_info_tag(char *arg, int arg_size, const char *tag1, const char *info);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1135
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1136 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1137 * Returns in 'buf' the path with '%d' replaced by number.
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1138 *
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1139 * 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
1140 * of digits and '%%'.
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1141 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1142 * @param buf destination buffer
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1143 * @param buf_size destination buffer size
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1144 * @param path numbered sequence string
2749
2a6baeedf776 Fix Doxygen parameter
takis
parents: 2745
diff changeset
1145 * @param number frame number
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1146 * @return 0 if OK, -1 on format error
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1147 */
1291
185190bdc185 Clarified API for numbered sequences, patch by Michel Bardiaux % mbardiaux A mediaxim P be %
gpoirier
parents: 1289
diff changeset
1148 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
1149 const char *path, int number);
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1150
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1151 /**
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1152 * 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
1153 *
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1154 * @param filename possible numbered sequence string
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1155 * @return 1 if a valid numbered sequence string, 0 otherwise
1840
daaa79ca14f0 Move the libavformat public API comments to avformat.h. The comments are
takis
parents: 1795
diff changeset
1156 */
1291
185190bdc185 Clarified API for numbered sequences, patch by Michel Bardiaux % mbardiaux A mediaxim P be %
gpoirier
parents: 1289
diff changeset
1157 int av_filename_number_test(const char *filename);
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1158
2284
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1159 /**
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1160 * Generate an SDP for an RTP session.
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1161 *
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1162 * @param ac array of AVFormatContexts describing the RTP streams. If the
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1163 * array is composed by only one context, such context can contain
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1164 * multiple AVStreams (one AVStream per RTP stream). Otherwise,
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1165 * all the contexts in the array (an AVCodecContext per RTP stream)
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1166 * must contain only one AVStream.
2317
2adc9f64ecfb Change avf_sdp_create() to get a pre-allocated buffer as input, and to
lucabe
parents: 2300
diff changeset
1167 * @param n_files number of AVCodecContexts contained in ac
2adc9f64ecfb Change avf_sdp_create() to get a pre-allocated buffer as input, and to
lucabe
parents: 2300
diff changeset
1168 * @param buff buffer where the SDP will be stored (must be allocated by
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1169 * the caller)
2317
2adc9f64ecfb Change avf_sdp_create() to get a pre-allocated buffer as input, and to
lucabe
parents: 2300
diff changeset
1170 * @param size the size of the buffer
3948
134f8658e2d9 spelling/wording/grammar
diego
parents: 3947
diff changeset
1171 * @return 0 if OK, AVERROR_xxx on error
2284
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1172 */
2317
2adc9f64ecfb Change avf_sdp_create() to get a pre-allocated buffer as input, and to
lucabe
parents: 2300
diff changeset
1173 int avf_sdp_create(AVFormatContext *ac[], int n_files, char *buff, int size);
2284
59d84b0f7d30 Introduce an SDP generator
lucabe
parents: 2280
diff changeset
1174
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1175 #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
1176
3249
bda0941921fe Avoid using reserved __names.
michael
parents: 3189
diff changeset
1177 void ff_dynarray_add(unsigned long **tab_ptr, int *nb_ptr, unsigned long elem);
151
ec4d9190d3b1 dynamic array functions
bellard
parents: 146
diff changeset
1178
255
302d133294d3 Fix compilation with ccc
mellum
parents: 244
diff changeset
1179 #ifdef __GNUC__
151
ec4d9190d3b1 dynamic array functions
bellard
parents: 146
diff changeset
1180 #define dynarray_add(tab, nb_ptr, elem)\
ec4d9190d3b1 dynamic array functions
bellard
parents: 146
diff changeset
1181 do {\
3970
c265c84caa81 Use __typeof__ instead of GCC-specific typeof keyword.
gpoirier
parents: 3949
diff changeset
1182 __typeof__(tab) _tab = (tab);\
c265c84caa81 Use __typeof__ instead of GCC-specific typeof keyword.
gpoirier
parents: 3949
diff changeset
1183 __typeof__(elem) _elem = (elem);\
151
ec4d9190d3b1 dynamic array functions
bellard
parents: 146
diff changeset
1184 (void)sizeof(**_tab == _elem); /* check that types are compatible */\
3249
bda0941921fe Avoid using reserved __names.
michael
parents: 3189
diff changeset
1185 ff_dynarray_add((unsigned long **)_tab, nb_ptr, (unsigned long)_elem);\
151
ec4d9190d3b1 dynamic array functions
bellard
parents: 146
diff changeset
1186 } while(0)
255
302d133294d3 Fix compilation with ccc
mellum
parents: 244
diff changeset
1187 #else
302d133294d3 Fix compilation with ccc
mellum
parents: 244
diff changeset
1188 #define dynarray_add(tab, nb_ptr, elem)\
302d133294d3 Fix compilation with ccc
mellum
parents: 244
diff changeset
1189 do {\
3249
bda0941921fe Avoid using reserved __names.
michael
parents: 3189
diff changeset
1190 ff_dynarray_add((unsigned long **)(tab), nb_ptr, (unsigned long)(elem));\
255
302d133294d3 Fix compilation with ccc
mellum
parents: 244
diff changeset
1191 } while(0)
302d133294d3 Fix compilation with ccc
mellum
parents: 244
diff changeset
1192 #endif
151
ec4d9190d3b1 dynamic array functions
bellard
parents: 146
diff changeset
1193
230
9f4f4ca9f7b5 simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents: 225
diff changeset
1194 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
1195 struct tm *brktimegm(time_t secs, struct tm *tm);
885
da1d5db0ce5c COSMETICS: Remove all trailing whitespace.
diego
parents: 879
diff changeset
1196 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
1197 struct tm *dt);
9f4f4ca9f7b5 simpler strptime - added os_support.[ch] - moved localtime_r to os_support.c
bellard
parents: 225
diff changeset
1198
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1199 struct in_addr;
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1200 int resolve_host(struct in_addr *sin_addr, const char *hostname);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1201
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1202 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
1203 char *authorization, int authorization_size,
0
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1204 char *hostname, int hostname_size,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1205 int *port_ptr,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1206 char *path, int path_size,
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1207 const char *url);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1208
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1209 int match_ext(const char *filename, const char *extensions);
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1210
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1211 #endif /* HAVE_AV_CONFIG_H */
05318cf2e886 renamed libav to libavformat
bellard
parents:
diff changeset
1212
3852
1b6245500d8c Globally rename the header inclusion guard names.
stefano
parents: 3766
diff changeset
1213 #endif /* AVFORMAT_AVFORMAT_H */