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 "libswscale/swscale.h"
32 #include "libpostproc/postprocess.h"
33 #include "libavutil/avstring.h"
37 #include "libavformat/network.h"
43 double parse_number_or_die(const char *context
, const char *numstr
, int type
, double min
, double max
)
47 double d
= strtod(numstr
, &tail
);
49 error
= "Expected number for %s but found: %s\n";
50 else if (d
< min
|| d
> max
)
51 error
= "The value for %s was %s which is not within %f - %f\n";
52 else if(type
== OPT_INT64
&& (int64_t)d
!= d
)
53 error
= "Expected int64 for %s but found %s\n";
56 fprintf(stderr
, error
, context
, numstr
, min
, max
);
60 int64_t parse_time_or_die(const char *context
, const char *timestr
, int is_duration
)
62 int64_t us
= parse_date(timestr
, is_duration
);
63 if (us
== INT64_MIN
) {
64 fprintf(stderr
, "Invalid %s specification for %s: %s\n",
65 is_duration
? "duration" : "date", context
, timestr
);
71 void show_help_options(const OptionDef
*options
, const char *msg
, int mask
, int value
)
77 for(po
= options
; po
->name
!= NULL
; po
++) {
79 if ((po
->flags
& mask
) == value
) {
84 av_strlcpy(buf
, po
->name
, sizeof(buf
));
85 if (po
->flags
& HAS_ARG
) {
86 av_strlcat(buf
, " ", sizeof(buf
));
87 av_strlcat(buf
, po
->argname
, sizeof(buf
));
89 printf("-%-17s %s\n", buf
, po
->help
);
94 static const OptionDef
* find_option(const OptionDef
*po
, const char *name
){
95 while (po
->name
!= NULL
) {
96 if (!strcmp(name
, po
->name
))
103 void parse_options(int argc
, char **argv
, const OptionDef
*options
,
104 void (* parse_arg_function
)(const char*))
106 const char *opt
, *arg
;
107 int optindex
, handleoptions
=1;
112 while (optindex
< argc
) {
113 opt
= argv
[optindex
++];
115 if (handleoptions
&& opt
[0] == '-' && opt
[1] != '\0') {
116 if (opt
[1] == '-' && opt
[2] == '\0') {
120 po
= find_option(options
, opt
+ 1);
122 po
= find_option(options
, "default");
125 fprintf(stderr
, "%s: unrecognized option '%s'\n", argv
[0], opt
);
129 if (po
->flags
& HAS_ARG
) {
130 arg
= argv
[optindex
++];
132 fprintf(stderr
, "%s: missing argument for option '%s'\n", argv
[0], opt
);
136 if (po
->flags
& OPT_STRING
) {
138 str
= av_strdup(arg
);
139 *po
->u
.str_arg
= str
;
140 } else if (po
->flags
& OPT_BOOL
) {
142 } else if (po
->flags
& OPT_INT
) {
143 *po
->u
.int_arg
= parse_number_or_die(opt
+1, arg
, OPT_INT64
, INT_MIN
, INT_MAX
);
144 } else if (po
->flags
& OPT_INT64
) {
145 *po
->u
.int64_arg
= parse_number_or_die(opt
+1, arg
, OPT_INT64
, INT64_MIN
, INT64_MAX
);
146 } else if (po
->flags
& OPT_FLOAT
) {
147 *po
->u
.float_arg
= parse_number_or_die(opt
+1, arg
, OPT_FLOAT
, -1.0/0.0, 1.0/0.0);
148 } else if (po
->flags
& OPT_FUNC2
) {
149 if(po
->u
.func2_arg(opt
+1, arg
)<0)
154 if(po
->flags
& OPT_EXIT
)
157 if (parse_arg_function
)
158 parse_arg_function(opt
);
163 void print_error(const char *filename
, int err
)
166 case AVERROR_NUMEXPECTED
:
167 fprintf(stderr
, "%s: Incorrect image filename syntax.\n"
168 "Use '%%d' to specify the image number:\n"
169 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
170 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
173 case AVERROR_INVALIDDATA
:
174 fprintf(stderr
, "%s: Error while parsing header\n", filename
);
177 fprintf(stderr
, "%s: Unknown format\n", filename
);
180 fprintf(stderr
, "%s: I/O error occurred\n"
181 "Usually that means that input file is truncated and/or corrupted.\n",
184 case AVERROR(ENOMEM
):
185 fprintf(stderr
, "%s: memory allocation error occurred\n", filename
);
187 case AVERROR(ENOENT
):
188 fprintf(stderr
, "%s: no such file or directory\n", filename
);
190 #ifdef CONFIG_NETWORK
191 case AVERROR(FF_NETERROR(EPROTONOSUPPORT
)):
192 fprintf(stderr
, "%s: Unsupported network protocol\n", filename
);
196 fprintf(stderr
, "%s: Error while opening file\n", filename
);
201 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
202 version= libname##_version(); \
203 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? " " : "", #libname, \
204 LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
205 version >> 16, version >> 8 & 0xff, version & 0xff);
207 void print_all_lib_versions(FILE* outstream
, int indent
)
209 unsigned int version
;
210 PRINT_LIB_VERSION(outstream
, avutil
, AVUTIL
, indent
);
211 PRINT_LIB_VERSION(outstream
, avcodec
, AVCODEC
, indent
);
212 PRINT_LIB_VERSION(outstream
, avformat
, AVFORMAT
, indent
);
213 PRINT_LIB_VERSION(outstream
, avdevice
, AVDEVICE
, indent
);
215 PRINT_LIB_VERSION(outstream
, avfilter
, AVFILTER
, indent
);
218 PRINT_LIB_VERSION(outstream
, swscale
, SWSCALE
, indent
);
221 PRINT_LIB_VERSION(outstream
, postproc
, POSTPROC
, indent
);
225 void show_banner(void)
227 fprintf(stderr
, "%s version " FFMPEG_VERSION
", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
228 program_name
, program_birth_year
);
229 fprintf(stderr
, " configuration: " FFMPEG_CONFIGURATION
"\n");
230 print_all_lib_versions(stderr
, 1);
231 fprintf(stderr
, " built on " __DATE__
" " __TIME__
);
233 fprintf(stderr
, ", gcc: " __VERSION__
"\n");
235 fprintf(stderr
, ", using a non-gcc compiler\n");
239 void show_version(void) {
240 printf("%s " FFMPEG_VERSION
"\n", program_name
);
241 print_all_lib_versions(stdout
, 0);
244 void show_license(void)
246 #ifdef CONFIG_NONFREE
248 "This version of %s has nonfree parts compiled in.\n"
249 "Therefore it is not legally redistributable.\n",
254 "%s is free software; you can redistribute it and/or modify\n"
255 "it under the terms of the GNU General Public License as published by\n"
256 "the Free Software Foundation; either version 2 of the License, or\n"
257 "(at your option) any later version.\n"
259 "%s is distributed in the hope that it will be useful,\n"
260 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
261 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
262 "GNU General Public License for more details.\n"
264 "You should have received a copy of the GNU General Public License\n"
265 "along with %s; if not, write to the Free Software\n"
266 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
267 program_name
, program_name
, program_name
271 "%s is free software; you can redistribute it and/or\n"
272 "modify it under the terms of the GNU Lesser General Public\n"
273 "License as published by the Free Software Foundation; either\n"
274 "version 2.1 of the License, or (at your option) any later version.\n"
276 "%s is distributed in the hope that it will be useful,\n"
277 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
278 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
279 "Lesser General Public License for more details.\n"
281 "You should have received a copy of the GNU Lesser General Public\n"
282 "License along with %s; if not, write to the Free Software\n"
283 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
284 program_name
, program_name
, program_name
289 void show_formats(void)
291 AVInputFormat
*ifmt
=NULL
;
292 AVOutputFormat
*ofmt
=NULL
;
293 URLProtocol
*up
=NULL
;
294 AVCodec
*p
=NULL
, *p2
;
295 AVBitStreamFilter
*bsf
=NULL
;
296 const char *last_name
;
298 printf("File formats:\n");
303 const char *name
=NULL
;
304 const char *long_name
=NULL
;
306 while((ofmt
= av_oformat_next(ofmt
))) {
307 if((name
== NULL
|| strcmp(ofmt
->name
, name
)<0) &&
308 strcmp(ofmt
->name
, last_name
)>0){
310 long_name
= ofmt
->long_name
;
314 while((ifmt
= av_iformat_next(ifmt
))) {
315 if((name
== NULL
|| strcmp(ifmt
->name
, name
)<0) &&
316 strcmp(ifmt
->name
, last_name
)>0){
318 long_name
= ifmt
->long_name
;
321 if(name
&& strcmp(ifmt
->name
, name
)==0)
333 long_name
? long_name
:" ");
343 const char *type_str
;
346 while((p
= av_codec_next(p
))) {
347 if((p2
==NULL
|| strcmp(p
->name
, p2
->name
)<0) &&
348 strcmp(p
->name
, last_name
)>0){
350 decode
= encode
= cap
=0;
352 if(p2
&& strcmp(p
->name
, p2
->name
)==0){
353 if(p
->decode
) decode
=1;
354 if(p
->encode
) encode
=1;
355 cap
|= p
->capabilities
;
363 case CODEC_TYPE_VIDEO
:
366 case CODEC_TYPE_AUDIO
:
369 case CODEC_TYPE_SUBTITLE
:
377 " %s%s%s%s%s%s %-15s %s",
378 decode
? "D": (/*p2->decoder ? "d":*/" "),
381 cap
& CODEC_CAP_DRAW_HORIZ_BAND
? "S":" ",
382 cap
& CODEC_CAP_DR1
? "D":" ",
383 cap
& CODEC_CAP_TRUNCATED
? "T":" ",
385 p2
->long_name
? p2
->long_name
: "");
386 /* if(p2->decoder && decode==0)
387 printf(" use %s for decoding", p2->decoder->name);*/
392 printf("Bitstream filters:\n");
393 while((bsf
= av_bitstream_filter_next(bsf
)))
394 printf(" %s", bsf
->name
);
397 printf("Supported file protocols:\n");
398 while((up
= av_protocol_next(up
)))
399 printf(" %s:", up
->name
);
402 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
405 "Note, the names of encoders and decoders do not always match, so there are\n"
406 "several cases where the above table shows encoder only or decoder only entries\n"
407 "even though both encoding and decoding are supported. For example, the h263\n"
408 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"