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 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
200 version= libname##_version(); \
201 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? " " : "", #libname, \
202 LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
203 version >> 16, version >> 8 & 0xff, version & 0xff);
205 void print_all_lib_versions(FILE* outstream
, int indent
)
207 unsigned int version
;
208 PRINT_LIB_VERSION(outstream
, avutil
, AVUTIL
, indent
);
209 PRINT_LIB_VERSION(outstream
, avcodec
, AVCODEC
, indent
);
210 PRINT_LIB_VERSION(outstream
, avformat
, AVFORMAT
, indent
);
211 PRINT_LIB_VERSION(outstream
, avdevice
, AVDEVICE
, indent
);
213 PRINT_LIB_VERSION(outstream
, avfilter
, AVFILTER
, indent
);
217 void show_banner(void)
219 fprintf(stderr
, "%s version " FFMPEG_VERSION
", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
220 program_name
, program_birth_year
);
221 fprintf(stderr
, " configuration: " FFMPEG_CONFIGURATION
"\n");
222 print_all_lib_versions(stderr
, 1);
223 fprintf(stderr
, " built on " __DATE__
" " __TIME__
);
225 fprintf(stderr
, ", gcc: " __VERSION__
"\n");
227 fprintf(stderr
, ", using a non-gcc compiler\n");
231 void show_version(void) {
232 printf("%s " FFMPEG_VERSION
"\n", program_name
);
233 print_all_lib_versions(stdout
, 0);
236 void show_license(void)
238 #ifdef CONFIG_NONFREE
240 "This version of %s has nonfree parts compiled in.\n"
241 "Therefore it is not legally redistributable.\n",
246 "%s is free software; you can redistribute it and/or modify\n"
247 "it under the terms of the GNU General Public License as published by\n"
248 "the Free Software Foundation; either version 2 of the License, or\n"
249 "(at your option) any later version.\n"
251 "%s is distributed in the hope that it will be useful,\n"
252 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
253 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
254 "GNU General Public License for more details.\n"
256 "You should have received a copy of the GNU General Public License\n"
257 "along with %s; if not, write to the Free Software\n"
258 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
259 program_name
, program_name
, program_name
263 "%s is free software; you can redistribute it and/or\n"
264 "modify it under the terms of the GNU Lesser General Public\n"
265 "License as published by the Free Software Foundation; either\n"
266 "version 2.1 of the License, or (at your option) any later version.\n"
268 "%s is distributed in the hope that it will be useful,\n"
269 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
270 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
271 "Lesser General Public License for more details.\n"
273 "You should have received a copy of the GNU Lesser General Public\n"
274 "License along with %s; if not, write to the Free Software\n"
275 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
276 program_name
, program_name
, program_name
281 void show_formats(void)
283 AVInputFormat
*ifmt
=NULL
;
284 AVOutputFormat
*ofmt
=NULL
;
285 URLProtocol
*up
=NULL
;
286 AVCodec
*p
=NULL
, *p2
;
287 AVBitStreamFilter
*bsf
=NULL
;
288 const char *last_name
;
290 printf("File formats:\n");
295 const char *name
=NULL
;
296 const char *long_name
=NULL
;
298 while((ofmt
= av_oformat_next(ofmt
))) {
299 if((name
== NULL
|| strcmp(ofmt
->name
, name
)<0) &&
300 strcmp(ofmt
->name
, last_name
)>0){
302 long_name
= ofmt
->long_name
;
306 while((ifmt
= av_iformat_next(ifmt
))) {
307 if((name
== NULL
|| strcmp(ifmt
->name
, name
)<0) &&
308 strcmp(ifmt
->name
, last_name
)>0){
310 long_name
= ifmt
->long_name
;
313 if(name
&& strcmp(ifmt
->name
, name
)==0)
325 long_name
? long_name
:" ");
335 const char *type_str
;
338 while((p
= av_codec_next(p
))) {
339 if((p2
==NULL
|| strcmp(p
->name
, p2
->name
)<0) &&
340 strcmp(p
->name
, last_name
)>0){
342 decode
= encode
= cap
=0;
344 if(p2
&& strcmp(p
->name
, p2
->name
)==0){
345 if(p
->decode
) decode
=1;
346 if(p
->encode
) encode
=1;
347 cap
|= p
->capabilities
;
355 case CODEC_TYPE_VIDEO
:
358 case CODEC_TYPE_AUDIO
:
361 case CODEC_TYPE_SUBTITLE
:
369 " %s%s%s%s%s%s %-15s %s",
370 decode
? "D": (/*p2->decoder ? "d":*/" "),
373 cap
& CODEC_CAP_DRAW_HORIZ_BAND
? "S":" ",
374 cap
& CODEC_CAP_DR1
? "D":" ",
375 cap
& CODEC_CAP_TRUNCATED
? "T":" ",
377 p2
->long_name
? p2
->long_name
: "");
378 /* if(p2->decoder && decode==0)
379 printf(" use %s for decoding", p2->decoder->name);*/
384 printf("Bitstream filters:\n");
385 while((bsf
= av_bitstream_filter_next(bsf
)))
386 printf(" %s", bsf
->name
);
389 printf("Supported file protocols:\n");
390 while((up
= av_protocol_next(up
)))
391 printf(" %s:", up
->name
);
394 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
397 "Note, the names of encoders and decoders do not always match, so there are\n"
398 "several cases where the above table shows encoder only or decoder only entries\n"
399 "even though both encoding and decoding are supported. For example, the h263\n"
400 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"