2 * Various utilities for command line tools
3 * Copyright (c) 2000-2003 Fabrice Bellard
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
28 #include "libavformat/avformat.h"
29 #include "libavfilter/avfilter.h"
30 #include "libavdevice/avdevice.h"
31 #include "libavutil/avstring.h"
35 #include "libavformat/network.h"
41 double parse_number_or_die(const char *context
, const char *numstr
, int type
, double min
, double max
)
45 double d
= strtod(numstr
, &tail
);
47 error
= "Expected number for %s but found: %s\n";
48 else if (d
< min
|| d
> max
)
49 error
= "The value for %s was %s which is not within %f - %f\n";
50 else if(type
== OPT_INT64
&& (int64_t)d
!= d
)
51 error
= "Expected int64 for %s but found %s\n";
54 fprintf(stderr
, error
, context
, numstr
, min
, max
);
58 int64_t parse_time_or_die(const char *context
, const char *timestr
, int is_duration
)
60 int64_t us
= parse_date(timestr
, is_duration
);
61 if (us
== INT64_MIN
) {
62 fprintf(stderr
, "Invalid %s specification for %s: %s\n",
63 is_duration
? "duration" : "date", context
, timestr
);
69 void show_help_options(const OptionDef
*options
, const char *msg
, int mask
, int value
)
75 for(po
= options
; po
->name
!= NULL
; po
++) {
77 if ((po
->flags
& mask
) == value
) {
82 av_strlcpy(buf
, po
->name
, sizeof(buf
));
83 if (po
->flags
& HAS_ARG
) {
84 av_strlcat(buf
, " ", sizeof(buf
));
85 av_strlcat(buf
, po
->argname
, sizeof(buf
));
87 printf("-%-17s %s\n", buf
, po
->help
);
92 static const OptionDef
* find_option(const OptionDef
*po
, const char *name
){
93 while (po
->name
!= NULL
) {
94 if (!strcmp(name
, po
->name
))
101 void parse_options(int argc
, char **argv
, const OptionDef
*options
,
102 void (* parse_arg_function
)(const char*))
104 const char *opt
, *arg
;
105 int optindex
, handleoptions
=1;
110 while (optindex
< argc
) {
111 opt
= argv
[optindex
++];
113 if (handleoptions
&& opt
[0] == '-' && opt
[1] != '\0') {
114 if (opt
[1] == '-' && opt
[2] == '\0') {
118 po
= find_option(options
, opt
+ 1);
120 po
= find_option(options
, "default");
123 fprintf(stderr
, "%s: unrecognized option '%s'\n", argv
[0], opt
);
127 if (po
->flags
& HAS_ARG
) {
128 arg
= argv
[optindex
++];
130 fprintf(stderr
, "%s: missing argument for option '%s'\n", argv
[0], opt
);
134 if (po
->flags
& OPT_STRING
) {
136 str
= av_strdup(arg
);
137 *po
->u
.str_arg
= str
;
138 } else if (po
->flags
& OPT_BOOL
) {
140 } else if (po
->flags
& OPT_INT
) {
141 *po
->u
.int_arg
= parse_number_or_die(opt
+1, arg
, OPT_INT64
, INT_MIN
, INT_MAX
);
142 } else if (po
->flags
& OPT_INT64
) {
143 *po
->u
.int64_arg
= parse_number_or_die(opt
+1, arg
, OPT_INT64
, INT64_MIN
, INT64_MAX
);
144 } else if (po
->flags
& OPT_FLOAT
) {
145 *po
->u
.float_arg
= parse_number_or_die(opt
+1, arg
, OPT_FLOAT
, -1.0/0.0, 1.0/0.0);
146 } else if (po
->flags
& OPT_FUNC2
) {
147 if(po
->u
.func2_arg(opt
+1, arg
)<0)
152 if(po
->flags
& OPT_EXIT
)
155 if (parse_arg_function
)
156 parse_arg_function(opt
);
161 void print_error(const char *filename
, int err
)
164 case AVERROR_NUMEXPECTED
:
165 fprintf(stderr
, "%s: Incorrect image filename syntax.\n"
166 "Use '%%d' to specify the image number:\n"
167 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
168 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
171 case AVERROR_INVALIDDATA
:
172 fprintf(stderr
, "%s: Error while parsing header\n", filename
);
175 fprintf(stderr
, "%s: Unknown format\n", filename
);
178 fprintf(stderr
, "%s: I/O error occurred\n"
179 "Usually that means that input file is truncated and/or corrupted.\n",
182 case AVERROR(ENOMEM
):
183 fprintf(stderr
, "%s: memory allocation error occurred\n", filename
);
185 case AVERROR(ENOENT
):
186 fprintf(stderr
, "%s: no such file or directory\n", filename
);
188 #ifdef CONFIG_NETWORK
189 case AVERROR(FF_NETERROR(EPROTONOSUPPORT
)):
190 fprintf(stderr
, "%s: Unsupported network protocol\n", filename
);
194 fprintf(stderr
, "%s: Error while opening file\n", filename
);
199 void show_banner(void)
201 fprintf(stderr
, "%s version " FFMPEG_VERSION
", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
202 program_name
, program_birth_year
);
203 fprintf(stderr
, " configuration: " FFMPEG_CONFIGURATION
"\n");
204 fprintf(stderr
, " libavutil version: " AV_STRINGIFY(LIBAVUTIL_VERSION
) "\n");
205 fprintf(stderr
, " libavcodec version: " AV_STRINGIFY(LIBAVCODEC_VERSION
) "\n");
206 fprintf(stderr
, " libavformat version: " AV_STRINGIFY(LIBAVFORMAT_VERSION
) "\n");
207 fprintf(stderr
, " libavdevice version: " AV_STRINGIFY(LIBAVDEVICE_VERSION
) "\n");
209 fprintf(stderr
, " libavfilter version: " AV_STRINGIFY(LIBAVFILTER_VERSION
) "\n");
211 fprintf(stderr
, " built on " __DATE__
" " __TIME__
);
213 fprintf(stderr
, ", gcc: " __VERSION__
"\n");
215 fprintf(stderr
, ", using a non-gcc compiler\n");
219 void show_version(void) {
220 /* TODO: add function interface to avutil and avformat avdevice*/
221 printf("%s " FFMPEG_VERSION
"\n", program_name
);
222 printf("libavutil %d\n"
226 LIBAVUTIL_BUILD
, avcodec_build(), LIBAVFORMAT_BUILD
, LIBAVDEVICE_BUILD
);
229 void show_license(void)
231 #ifdef CONFIG_NONFREE
233 "This version of %s has nonfree parts compiled in.\n"
234 "Therefore it is not legally redistributable.\n",
239 "%s is free software; you can redistribute it and/or modify\n"
240 "it under the terms of the GNU General Public License as published by\n"
241 "the Free Software Foundation; either version 2 of the License, or\n"
242 "(at your option) any later version.\n"
244 "%s is distributed in the hope that it will be useful,\n"
245 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
246 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
247 "GNU General Public License for more details.\n"
249 "You should have received a copy of the GNU General Public License\n"
250 "along with %s; if not, write to the Free Software\n"
251 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
252 program_name
, program_name
, program_name
256 "%s is free software; you can redistribute it and/or\n"
257 "modify it under the terms of the GNU Lesser General Public\n"
258 "License as published by the Free Software Foundation; either\n"
259 "version 2.1 of the License, or (at your option) any later version.\n"
261 "%s is distributed in the hope that it will be useful,\n"
262 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
263 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
264 "Lesser General Public License for more details.\n"
266 "You should have received a copy of the GNU Lesser General Public\n"
267 "License along with %s; if not, write to the Free Software\n"
268 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
269 program_name
, program_name
, program_name
274 void show_formats(void)
276 AVInputFormat
*ifmt
=NULL
;
277 AVOutputFormat
*ofmt
=NULL
;
278 URLProtocol
*up
=NULL
;
279 AVCodec
*p
=NULL
, *p2
;
280 AVBitStreamFilter
*bsf
=NULL
;
281 const char *last_name
;
283 printf("File formats:\n");
288 const char *name
=NULL
;
289 const char *long_name
=NULL
;
291 while((ofmt
= av_oformat_next(ofmt
))) {
292 if((name
== NULL
|| strcmp(ofmt
->name
, name
)<0) &&
293 strcmp(ofmt
->name
, last_name
)>0){
295 long_name
= ofmt
->long_name
;
299 while((ifmt
= av_iformat_next(ifmt
))) {
300 if((name
== NULL
|| strcmp(ifmt
->name
, name
)<0) &&
301 strcmp(ifmt
->name
, last_name
)>0){
303 long_name
= ifmt
->long_name
;
306 if(name
&& strcmp(ifmt
->name
, name
)==0)
318 long_name
? long_name
:" ");
328 const char *type_str
;
331 while((p
= av_codec_next(p
))) {
332 if((p2
==NULL
|| strcmp(p
->name
, p2
->name
)<0) &&
333 strcmp(p
->name
, last_name
)>0){
335 decode
= encode
= cap
=0;
337 if(p2
&& strcmp(p
->name
, p2
->name
)==0){
338 if(p
->decode
) decode
=1;
339 if(p
->encode
) encode
=1;
340 cap
|= p
->capabilities
;
348 case CODEC_TYPE_VIDEO
:
351 case CODEC_TYPE_AUDIO
:
354 case CODEC_TYPE_SUBTITLE
:
362 " %s%s%s%s%s%s %-15s %s",
363 decode
? "D": (/*p2->decoder ? "d":*/" "),
366 cap
& CODEC_CAP_DRAW_HORIZ_BAND
? "S":" ",
367 cap
& CODEC_CAP_DR1
? "D":" ",
368 cap
& CODEC_CAP_TRUNCATED
? "T":" ",
370 p2
->long_name
? p2
->long_name
: "");
371 /* if(p2->decoder && decode==0)
372 printf(" use %s for decoding", p2->decoder->name);*/
377 printf("Bitstream filters:\n");
378 while((bsf
= av_bitstream_filter_next(bsf
)))
379 printf(" %s", bsf
->name
);
382 printf("Supported file protocols:\n");
383 while((up
= av_protocol_next(up
)))
384 printf(" %s:", up
->name
);
387 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
390 "Note, the names of encoders and decoders do not always match, so there are\n"
391 "several cases where the above table shows encoder only or decoder only entries\n"
392 "even though both encoding and decoding are supported. For example, the h263\n"
393 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"