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
27 /* Include only the enabled headers since some compilers (namely, Sun
28 Studio) will not omit unused inline functions and create undefined
29 references to libraries that are not being built. */
32 #include "libavformat/avformat.h"
33 #include "libavfilter/avfilter.h"
34 #include "libavdevice/avdevice.h"
35 #include "libswscale/swscale.h"
36 #include "libpostproc/postprocess.h"
37 #include "libavutil/avstring.h"
38 #include "libavcodec/opt.h"
42 #include "libavformat/network.h"
44 #if HAVE_SYS_RESOURCE_H
45 #include <sys/resource.h>
50 const char **opt_names;
51 static int opt_name_count;
52 AVCodecContext *avcodec_opts[CODEC_TYPE_NB];
53 AVFormatContext *avformat_opts;
54 struct SwsContext *sws_opts;
56 const int this_year = 2010;
58 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
62 double d = strtod(numstr, &tail);
64 error= "Expected number for %s but found: %s\n";
65 else if (d < min || d > max)
66 error= "The value for %s was %s which is not within %f - %f\n";
67 else if(type == OPT_INT64 && (int64_t)d != d)
68 error= "Expected int64 for %s but found %s\n";
71 fprintf(stderr, error, context, numstr, min, max);
75 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
77 int64_t us = parse_date(timestr, is_duration);
78 if (us == INT64_MIN) {
79 fprintf(stderr, "Invalid %s specification for %s: %s\n",
80 is_duration ? "duration" : "date", context, timestr);
86 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
92 for(po = options; po->name != NULL; po++) {
94 if ((po->flags & mask) == value) {
99 av_strlcpy(buf, po->name, sizeof(buf));
100 if (po->flags & HAS_ARG) {
101 av_strlcat(buf, " ", sizeof(buf));
102 av_strlcat(buf, po->argname, sizeof(buf));
104 printf("-%-17s %s\n", buf, po->help);
109 static const OptionDef* find_option(const OptionDef *po, const char *name){
110 while (po->name != NULL) {
111 if (!strcmp(name, po->name))
118 void parse_options(int argc, char **argv, const OptionDef *options,
119 void (* parse_arg_function)(const char*))
121 const char *opt, *arg;
122 int optindex, handleoptions=1;
127 while (optindex < argc) {
128 opt = argv[optindex++];
130 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
132 if (opt[1] == '-' && opt[2] == '\0') {
137 po= find_option(options, opt);
138 if (!po->name && opt[0] == 'n' && opt[1] == 'o') {
139 /* handle 'no' bool option */
140 po = find_option(options, opt + 2);
141 if (!(po->name && (po->flags & OPT_BOOL)))
146 po= find_option(options, "default");
149 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
153 if (po->flags & HAS_ARG) {
154 arg = argv[optindex++];
156 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
160 if (po->flags & OPT_STRING) {
162 str = av_strdup(arg);
163 *po->u.str_arg = str;
164 } else if (po->flags & OPT_BOOL) {
165 *po->u.int_arg = bool_val;
166 } else if (po->flags & OPT_INT) {
167 *po->u.int_arg = parse_number_or_die(opt, arg, OPT_INT64, INT_MIN, INT_MAX);
168 } else if (po->flags & OPT_INT64) {
169 *po->u.int64_arg = parse_number_or_die(opt, arg, OPT_INT64, INT64_MIN, INT64_MAX);
170 } else if (po->flags & OPT_FLOAT) {
171 *po->u.float_arg = parse_number_or_die(opt, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
172 } else if (po->flags & OPT_FUNC2) {
173 if(po->u.func2_arg(opt, arg)<0)
178 if(po->flags & OPT_EXIT)
181 if (parse_arg_function)
182 parse_arg_function(opt);
187 int opt_default(const char *opt, const char *arg){
190 const AVOption *o= NULL;
191 int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
193 for(type=0; type<CODEC_TYPE_NB && ret>= 0; type++){
194 const AVOption *o2 = av_find_opt(avcodec_opts[0], opt, NULL, opt_types[type], opt_types[type]);
196 ret = av_set_string3(avcodec_opts[type], opt, arg, 1, &o);
199 ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
201 ret = av_set_string3(sws_opts, opt, arg, 1, &o);
204 ret = av_set_string3(avcodec_opts[CODEC_TYPE_AUDIO], opt+1, arg, 1, &o);
205 else if(opt[0] == 'v')
206 ret = av_set_string3(avcodec_opts[CODEC_TYPE_VIDEO], opt+1, arg, 1, &o);
207 else if(opt[0] == 's')
208 ret = av_set_string3(avcodec_opts[CODEC_TYPE_SUBTITLE], opt+1, arg, 1, &o);
211 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
217 // av_log(NULL, AV_LOG_ERROR, "%s:%s: %f 0x%0X\n", opt, arg, av_get_double(avcodec_opts, opt, NULL), (int)av_get_int(avcodec_opts, opt, NULL));
219 //FIXME we should always use avcodec_opts, ... for storing options so there will not be any need to keep track of what i set over this
220 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
221 opt_names[opt_name_count++]= o->name;
223 if(avcodec_opts[0]->debug || avformat_opts->debug)
224 av_log_set_level(AV_LOG_DEBUG);
228 int opt_loglevel(const char *opt, const char *arg)
230 const struct { const char *name; int level; } log_levels[] = {
231 { "quiet" , AV_LOG_QUIET },
232 { "panic" , AV_LOG_PANIC },
233 { "fatal" , AV_LOG_FATAL },
234 { "error" , AV_LOG_ERROR },
235 { "warning", AV_LOG_WARNING },
236 { "info" , AV_LOG_INFO },
237 { "verbose", AV_LOG_VERBOSE },
238 { "debug" , AV_LOG_DEBUG },
244 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
245 if (!strcmp(log_levels[i].name, arg)) {
246 av_log_set_level(log_levels[i].level);
251 level = strtol(arg, &tail, 10);
253 fprintf(stderr, "Invalid loglevel \"%s\". "
254 "Possible levels are numbers or:\n", arg);
255 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
256 fprintf(stderr, "\"%s\"\n", log_levels[i].name);
259 av_log_set_level(level);
263 int opt_timelimit(const char *opt, const char *arg)
265 #if HAVE_SYS_RESOURCE_H
266 int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
267 struct rlimit rl = { lim, lim + 1 };
268 if (setrlimit(RLIMIT_CPU, &rl))
271 fprintf(stderr, "Warning: -%s not implemented on this OS\n", opt);
276 void set_context_opts(void *ctx, void *opts_ctx, int flags)
279 for(i=0; i<opt_name_count; i++){
282 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
283 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
284 if(str && ((opt->flags & flags) == flags))
285 av_set_string3(ctx, opt_names[i], str, 1, NULL);
289 void print_error(const char *filename, int err)
292 case AVERROR_NUMEXPECTED:
293 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
294 "Use '%%d' to specify the image number:\n"
295 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
296 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
299 case AVERROR_INVALIDDATA:
300 fprintf(stderr, "%s: Error while parsing header\n", filename);
303 fprintf(stderr, "%s: Unknown format\n", filename);
306 fprintf(stderr, "%s: I/O error occurred\n"
307 "Usually that means that input file is truncated and/or corrupted.\n",
310 case AVERROR(ENOMEM):
311 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
313 case AVERROR(ENOENT):
314 fprintf(stderr, "%s: no such file or directory\n", filename);
317 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
318 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
322 fprintf(stderr, "%s: Error while opening file\n", filename);
327 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
328 if (CONFIG_##LIBNAME) { \
329 unsigned int version = libname##_version(); \
330 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", \
331 indent? " " : "", #libname, \
332 LIB##LIBNAME##_VERSION_MAJOR, \
333 LIB##LIBNAME##_VERSION_MINOR, \
334 LIB##LIBNAME##_VERSION_MICRO, \
335 version >> 16, version >> 8 & 0xff, version & 0xff); \
338 static void print_all_lib_versions(FILE* outstream, int indent)
340 PRINT_LIB_VERSION(outstream, avutil, AVUTIL, indent);
341 PRINT_LIB_VERSION(outstream, avcodec, AVCODEC, indent);
342 PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
343 PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
344 PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
345 PRINT_LIB_VERSION(outstream, swscale, SWSCALE, indent);
346 PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
349 static void maybe_print_config(const char *lib, const char *cfg)
351 static int warned_cfg;
353 if (strcmp(FFMPEG_CONFIGURATION, cfg)) {
355 fprintf(stderr, " WARNING: library configuration mismatch\n");
358 fprintf(stderr, " %-11s configuration: %s\n", lib, cfg);
362 #define PRINT_LIB_CONFIG(lib, tag, cfg) do { \
364 maybe_print_config(tag, cfg); \
367 void show_banner(void)
369 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-%d Fabrice Bellard, et al.\n",
370 program_name, program_birth_year, this_year);
371 fprintf(stderr, " built on %s %s with %s %s\n",
372 __DATE__, __TIME__, CC_TYPE, CC_VERSION);
373 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
374 PRINT_LIB_CONFIG(AVUTIL, "libavutil", avutil_configuration());
375 PRINT_LIB_CONFIG(AVCODEC, "libavcodec", avcodec_configuration());
376 PRINT_LIB_CONFIG(AVFORMAT, "libavformat", avformat_configuration());
377 PRINT_LIB_CONFIG(AVDEVICE, "libavdevice", avdevice_configuration());
378 PRINT_LIB_CONFIG(AVFILTER, "libavfilter", avfilter_configuration());
379 PRINT_LIB_CONFIG(SWSCALE, "libswscale", swscale_configuration());
380 PRINT_LIB_CONFIG(POSTPROC, "libpostproc", postproc_configuration());
381 print_all_lib_versions(stderr, 1);
384 void show_version(void) {
385 printf("%s " FFMPEG_VERSION "\n", program_name);
386 print_all_lib_versions(stdout, 0);
389 void show_license(void)
393 "This version of %s has nonfree parts compiled in.\n"
394 "Therefore it is not legally redistributable.\n",
397 "%s is free software; you can redistribute it and/or modify\n"
398 "it under the terms of the GNU General Public License as published by\n"
399 "the Free Software Foundation; either version 3 of the License, or\n"
400 "(at your option) any later version.\n"
402 "%s is distributed in the hope that it will be useful,\n"
403 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
404 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
405 "GNU General Public License for more details.\n"
407 "You should have received a copy of the GNU General Public License\n"
408 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
409 program_name, program_name, program_name
411 "%s is free software; you can redistribute it and/or modify\n"
412 "it under the terms of the GNU General Public License as published by\n"
413 "the Free Software Foundation; either version 2 of the License, or\n"
414 "(at your option) any later version.\n"
416 "%s is distributed in the hope that it will be useful,\n"
417 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
418 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
419 "GNU General Public License for more details.\n"
421 "You should have received a copy of the GNU General Public License\n"
422 "along with %s; if not, write to the Free Software\n"
423 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
424 program_name, program_name, program_name
426 "%s is free software; you can redistribute it and/or modify\n"
427 "it under the terms of the GNU Lesser General Public License as published by\n"
428 "the Free Software Foundation; either version 3 of the License, or\n"
429 "(at your option) any later version.\n"
431 "%s is distributed in the hope that it will be useful,\n"
432 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
433 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
434 "GNU Lesser General Public License for more details.\n"
436 "You should have received a copy of the GNU Lesser General Public License\n"
437 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
438 program_name, program_name, program_name
440 "%s is free software; you can redistribute it and/or\n"
441 "modify it under the terms of the GNU Lesser General Public\n"
442 "License as published by the Free Software Foundation; either\n"
443 "version 2.1 of the License, or (at your option) any later version.\n"
445 "%s is distributed in the hope that it will be useful,\n"
446 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
447 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
448 "Lesser General Public License for more details.\n"
450 "You should have received a copy of the GNU Lesser General Public\n"
451 "License along with %s; if not, write to the Free Software\n"
452 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
453 program_name, program_name, program_name
458 void list_fmts(void (*get_fmt_string)(char *buf, int buf_size, int fmt), int nb_fmts)
462 for (i=-1; i < nb_fmts; i++) {
463 get_fmt_string (fmt_str, sizeof(fmt_str), i);
464 fprintf(stdout, "%s\n", fmt_str);
468 void show_formats(void)
470 AVInputFormat *ifmt=NULL;
471 AVOutputFormat *ofmt=NULL;
472 const char *last_name;
476 " D. = Demuxing supported\n"
477 " .E = Muxing supported\n"
483 const char *name=NULL;
484 const char *long_name=NULL;
486 while((ofmt= av_oformat_next(ofmt))) {
487 if((name == NULL || strcmp(ofmt->name, name)<0) &&
488 strcmp(ofmt->name, last_name)>0){
490 long_name= ofmt->long_name;
494 while((ifmt= av_iformat_next(ifmt))) {
495 if((name == NULL || strcmp(ifmt->name, name)<0) &&
496 strcmp(ifmt->name, last_name)>0){
498 long_name= ifmt->long_name;
501 if(name && strcmp(ifmt->name, name)==0)
513 long_name ? long_name:" ");
517 void show_codecs(void)
519 AVCodec *p=NULL, *p2;
520 const char *last_name;
523 " D..... = Decoding supported\n"
524 " .E.... = Encoding supported\n"
525 " ..V... = Video codec\n"
526 " ..A... = Audio codec\n"
527 " ..S... = Subtitle codec\n"
528 " ...S.. = Supports draw_horiz_band\n"
529 " ....D. = Supports direct rendering method 1\n"
530 " .....T = Supports weird frame truncation\n"
537 const char *type_str;
540 while((p= av_codec_next(p))) {
541 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
542 strcmp(p->name, last_name)>0){
544 decode= encode= cap=0;
546 if(p2 && strcmp(p->name, p2->name)==0){
547 if(p->decode) decode=1;
548 if(p->encode) encode=1;
549 cap |= p->capabilities;
557 case CODEC_TYPE_VIDEO:
560 case CODEC_TYPE_AUDIO:
563 case CODEC_TYPE_SUBTITLE:
571 " %s%s%s%s%s%s %-15s %s",
572 decode ? "D": (/*p2->decoder ? "d":*/" "),
575 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
576 cap & CODEC_CAP_DR1 ? "D":" ",
577 cap & CODEC_CAP_TRUNCATED ? "T":" ",
579 p2->long_name ? p2->long_name : "");
580 /* if(p2->decoder && decode==0)
581 printf(" use %s for decoding", p2->decoder->name);*/
586 "Note, the names of encoders and decoders do not always match, so there are\n"
587 "several cases where the above table shows encoder only or decoder only entries\n"
588 "even though both encoding and decoding are supported. For example, the h263\n"
589 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
595 AVBitStreamFilter *bsf=NULL;
597 printf("Bitstream filters:\n");
598 while((bsf = av_bitstream_filter_next(bsf)))
599 printf("%s\n", bsf->name);
603 void show_protocols(void)
605 URLProtocol *up=NULL;
607 printf("Supported file protocols:\n");
608 while((up = av_protocol_next(up)))
609 printf("%s\n", up->name);
612 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
615 void show_filters(void)
617 AVFilter av_unused(**filter) = NULL;
619 printf("Filters:\n");
621 while ((filter = av_filter_next(filter)) && *filter)
622 printf("%-16s %s\n", (*filter)->name, (*filter)->description);
626 void show_pix_fmts(void)
628 list_fmts(avcodec_pix_fmt_string, PIX_FMT_NB);
634 int yesno = (toupper(c) == 'Y');
636 while (c != '\n' && c != EOF)