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 "libavutil/pixdesc.h"
39 #include "libavutil/eval.h"
40 #include "libavcodec/opt.h"
41 #include "libavcore/avcore.h"
45 #include "libavformat/network.h"
47 #if HAVE_SYS_RESOURCE_H
48 #include <sys/resource.h>
51 const char **opt_names;
52 static int opt_name_count;
53 AVCodecContext *avcodec_opts[AVMEDIA_TYPE_NB];
54 AVFormatContext *avformat_opts;
55 struct SwsContext *sws_opts;
57 const int this_year = 2010;
59 void log_callback_help(void* ptr, int level, const char* fmt, va_list vl)
61 vfprintf(stdout, fmt, vl);
64 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
68 double d = av_strtod(numstr, &tail);
70 error= "Expected number for %s but found: %s\n";
71 else if (d < min || d > max)
72 error= "The value for %s was %s which is not within %f - %f\n";
73 else if(type == OPT_INT64 && (int64_t)d != d)
74 error= "Expected int64 for %s but found %s\n";
77 fprintf(stderr, error, context, numstr, min, max);
81 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
83 int64_t us = parse_date(timestr, is_duration);
84 if (us == INT64_MIN) {
85 fprintf(stderr, "Invalid %s specification for %s: %s\n",
86 is_duration ? "duration" : "date", context, timestr);
92 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
98 for(po = options; po->name != NULL; po++) {
100 if ((po->flags & mask) == value) {
105 av_strlcpy(buf, po->name, sizeof(buf));
106 if (po->flags & HAS_ARG) {
107 av_strlcat(buf, " ", sizeof(buf));
108 av_strlcat(buf, po->argname, sizeof(buf));
110 printf("-%-17s %s\n", buf, po->help);
115 static const OptionDef* find_option(const OptionDef *po, const char *name){
116 while (po->name != NULL) {
117 if (!strcmp(name, po->name))
124 void parse_options(int argc, char **argv, const OptionDef *options,
125 void (* parse_arg_function)(const char*))
127 const char *opt, *arg;
128 int optindex, handleoptions=1;
133 while (optindex < argc) {
134 opt = argv[optindex++];
136 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
138 if (opt[1] == '-' && opt[2] == '\0') {
143 po= find_option(options, opt);
144 if (!po->name && opt[0] == 'n' && opt[1] == 'o') {
145 /* handle 'no' bool option */
146 po = find_option(options, opt + 2);
147 if (!(po->name && (po->flags & OPT_BOOL)))
152 po= find_option(options, "default");
155 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
159 if (po->flags & HAS_ARG) {
160 arg = argv[optindex++];
162 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
166 if (po->flags & OPT_STRING) {
168 str = av_strdup(arg);
169 *po->u.str_arg = str;
170 } else if (po->flags & OPT_BOOL) {
171 *po->u.int_arg = bool_val;
172 } else if (po->flags & OPT_INT) {
173 *po->u.int_arg = parse_number_or_die(opt, arg, OPT_INT64, INT_MIN, INT_MAX);
174 } else if (po->flags & OPT_INT64) {
175 *po->u.int64_arg = parse_number_or_die(opt, arg, OPT_INT64, INT64_MIN, INT64_MAX);
176 } else if (po->flags & OPT_FLOAT) {
177 *po->u.float_arg = parse_number_or_die(opt, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
178 } else if (po->flags & OPT_FUNC2) {
179 if (po->u.func2_arg(opt, arg) < 0) {
180 fprintf(stderr, "%s: failed to set value '%s' for option '%s'\n", argv[0], arg, opt);
186 if(po->flags & OPT_EXIT)
189 if (parse_arg_function)
190 parse_arg_function(opt);
195 int opt_default(const char *opt, const char *arg){
198 const AVOption *o= NULL;
199 int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
201 for(type=0; *avcodec_opts && type<AVMEDIA_TYPE_NB && ret>= 0; type++){
202 const AVOption *o2 = av_find_opt(avcodec_opts[0], opt, NULL, opt_types[type], opt_types[type]);
204 ret = av_set_string3(avcodec_opts[type], opt, arg, 1, &o);
206 if(!o && avformat_opts)
207 ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
209 ret = av_set_string3(sws_opts, opt, arg, 1, &o);
212 ret = av_set_string3(avcodec_opts[AVMEDIA_TYPE_AUDIO], opt+1, arg, 1, &o);
213 else if(opt[0] == 'v')
214 ret = av_set_string3(avcodec_opts[AVMEDIA_TYPE_VIDEO], opt+1, arg, 1, &o);
215 else if(opt[0] == 's')
216 ret = av_set_string3(avcodec_opts[AVMEDIA_TYPE_SUBTITLE], opt+1, arg, 1, &o);
219 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
223 fprintf(stderr, "Unrecognized option '%s'\n", opt);
227 // 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));
229 //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
230 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
231 opt_names[opt_name_count++]= o->name;
233 if ((*avcodec_opts && avcodec_opts[0]->debug) || (avformat_opts && avformat_opts->debug))
234 av_log_set_level(AV_LOG_DEBUG);
238 int opt_loglevel(const char *opt, const char *arg)
240 const struct { const char *name; int level; } log_levels[] = {
241 { "quiet" , AV_LOG_QUIET },
242 { "panic" , AV_LOG_PANIC },
243 { "fatal" , AV_LOG_FATAL },
244 { "error" , AV_LOG_ERROR },
245 { "warning", AV_LOG_WARNING },
246 { "info" , AV_LOG_INFO },
247 { "verbose", AV_LOG_VERBOSE },
248 { "debug" , AV_LOG_DEBUG },
254 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
255 if (!strcmp(log_levels[i].name, arg)) {
256 av_log_set_level(log_levels[i].level);
261 level = strtol(arg, &tail, 10);
263 fprintf(stderr, "Invalid loglevel \"%s\". "
264 "Possible levels are numbers or:\n", arg);
265 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
266 fprintf(stderr, "\"%s\"\n", log_levels[i].name);
269 av_log_set_level(level);
273 int opt_timelimit(const char *opt, const char *arg)
276 int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
277 struct rlimit rl = { lim, lim + 1 };
278 if (setrlimit(RLIMIT_CPU, &rl))
281 fprintf(stderr, "Warning: -%s not implemented on this OS\n", opt);
286 void set_context_opts(void *ctx, void *opts_ctx, int flags)
289 for(i=0; i<opt_name_count; i++){
292 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
293 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
294 if(str && ((opt->flags & flags) == flags))
295 av_set_string3(ctx, opt_names[i], str, 1, NULL);
299 void print_error(const char *filename, int err)
302 const char *errbuf_ptr = errbuf;
304 if (av_strerror(err, errbuf, sizeof(errbuf)) < 0)
305 errbuf_ptr = strerror(AVUNERROR(err));
306 fprintf(stderr, "%s: %s\n", filename, errbuf_ptr);
309 static int warned_cfg = 0;
312 #define SHOW_VERSION 2
313 #define SHOW_CONFIG 4
315 #define PRINT_LIB_INFO(outstream,libname,LIBNAME,flags) \
316 if (CONFIG_##LIBNAME) { \
317 const char *indent = flags & INDENT? " " : ""; \
318 if (flags & SHOW_VERSION) { \
319 unsigned int version = libname##_version(); \
320 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", \
322 LIB##LIBNAME##_VERSION_MAJOR, \
323 LIB##LIBNAME##_VERSION_MINOR, \
324 LIB##LIBNAME##_VERSION_MICRO, \
325 version >> 16, version >> 8 & 0xff, version & 0xff); \
327 if (flags & SHOW_CONFIG) { \
328 const char *cfg = libname##_configuration(); \
329 if (strcmp(FFMPEG_CONFIGURATION, cfg)) { \
332 "%sWARNING: library configuration mismatch\n", \
336 fprintf(stderr, "%s%-11s configuration: %s\n", \
337 indent, #libname, cfg); \
342 static void print_all_libs_info(FILE* outstream, int flags)
344 PRINT_LIB_INFO(outstream, avutil, AVUTIL, flags);
345 PRINT_LIB_INFO(outstream, avcore, AVCORE, flags);
346 PRINT_LIB_INFO(outstream, avcodec, AVCODEC, flags);
347 PRINT_LIB_INFO(outstream, avformat, AVFORMAT, flags);
348 PRINT_LIB_INFO(outstream, avdevice, AVDEVICE, flags);
349 PRINT_LIB_INFO(outstream, avfilter, AVFILTER, flags);
350 PRINT_LIB_INFO(outstream, swscale, SWSCALE, flags);
351 PRINT_LIB_INFO(outstream, postproc, POSTPROC, flags);
354 void show_banner(void)
356 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-%d the FFmpeg developers\n",
357 program_name, program_birth_year, this_year);
358 fprintf(stderr, " built on %s %s with %s %s\n",
359 __DATE__, __TIME__, CC_TYPE, CC_VERSION);
360 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
361 print_all_libs_info(stderr, INDENT|SHOW_CONFIG);
362 print_all_libs_info(stderr, INDENT|SHOW_VERSION);
365 void show_version(void) {
366 printf("%s " FFMPEG_VERSION "\n", program_name);
367 print_all_libs_info(stdout, SHOW_VERSION);
370 void show_license(void)
374 "This version of %s has nonfree parts compiled in.\n"
375 "Therefore it is not legally redistributable.\n",
378 "%s is free software; you can redistribute it and/or modify\n"
379 "it under the terms of the GNU General Public License as published by\n"
380 "the Free Software Foundation; either version 3 of the License, or\n"
381 "(at your option) any later version.\n"
383 "%s is distributed in the hope that it will be useful,\n"
384 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
385 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
386 "GNU General Public License for more details.\n"
388 "You should have received a copy of the GNU General Public License\n"
389 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
390 program_name, program_name, program_name
392 "%s is free software; you can redistribute it and/or modify\n"
393 "it under the terms of the GNU General Public License as published by\n"
394 "the Free Software Foundation; either version 2 of the License, or\n"
395 "(at your option) any later version.\n"
397 "%s is distributed in the hope that it will be useful,\n"
398 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
399 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
400 "GNU General Public License for more details.\n"
402 "You should have received a copy of the GNU General Public License\n"
403 "along with %s; if not, write to the Free Software\n"
404 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
405 program_name, program_name, program_name
407 "%s is free software; you can redistribute it and/or modify\n"
408 "it under the terms of the GNU Lesser General Public License as published by\n"
409 "the Free Software Foundation; either version 3 of the License, or\n"
410 "(at your option) any later version.\n"
412 "%s is distributed in the hope that it will be useful,\n"
413 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
414 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
415 "GNU Lesser General Public License for more details.\n"
417 "You should have received a copy of the GNU Lesser General Public License\n"
418 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
419 program_name, program_name, program_name
421 "%s is free software; you can redistribute it and/or\n"
422 "modify it under the terms of the GNU Lesser General Public\n"
423 "License as published by the Free Software Foundation; either\n"
424 "version 2.1 of the License, or (at your option) any later version.\n"
426 "%s is distributed in the hope that it will be useful,\n"
427 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
428 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
429 "Lesser General Public License for more details.\n"
431 "You should have received a copy of the GNU Lesser General Public\n"
432 "License along with %s; if not, write to the Free Software\n"
433 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
434 program_name, program_name, program_name
439 void list_fmts(void (*get_fmt_string)(char *buf, int buf_size, int fmt), int nb_fmts)
443 for (i=-1; i < nb_fmts; i++) {
444 get_fmt_string (fmt_str, sizeof(fmt_str), i);
445 fprintf(stdout, "%s\n", fmt_str);
449 void show_formats(void)
451 AVInputFormat *ifmt=NULL;
452 AVOutputFormat *ofmt=NULL;
453 const char *last_name;
457 " D. = Demuxing supported\n"
458 " .E = Muxing supported\n"
464 const char *name=NULL;
465 const char *long_name=NULL;
467 while((ofmt= av_oformat_next(ofmt))) {
468 if((name == NULL || strcmp(ofmt->name, name)<0) &&
469 strcmp(ofmt->name, last_name)>0){
471 long_name= ofmt->long_name;
475 while((ifmt= av_iformat_next(ifmt))) {
476 if((name == NULL || strcmp(ifmt->name, name)<0) &&
477 strcmp(ifmt->name, last_name)>0){
479 long_name= ifmt->long_name;
482 if(name && strcmp(ifmt->name, name)==0)
494 long_name ? long_name:" ");
498 void show_codecs(void)
500 AVCodec *p=NULL, *p2;
501 const char *last_name;
504 " D..... = Decoding supported\n"
505 " .E.... = Encoding supported\n"
506 " ..V... = Video codec\n"
507 " ..A... = Audio codec\n"
508 " ..S... = Subtitle codec\n"
509 " ...S.. = Supports draw_horiz_band\n"
510 " ....D. = Supports direct rendering method 1\n"
511 " .....T = Supports weird frame truncation\n"
518 const char *type_str;
521 while((p= av_codec_next(p))) {
522 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
523 strcmp(p->name, last_name)>0){
525 decode= encode= cap=0;
527 if(p2 && strcmp(p->name, p2->name)==0){
528 if(p->decode) decode=1;
529 if(p->encode) encode=1;
530 cap |= p->capabilities;
538 case AVMEDIA_TYPE_VIDEO:
541 case AVMEDIA_TYPE_AUDIO:
544 case AVMEDIA_TYPE_SUBTITLE:
552 " %s%s%s%s%s%s %-15s %s",
553 decode ? "D": (/*p2->decoder ? "d":*/" "),
556 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
557 cap & CODEC_CAP_DR1 ? "D":" ",
558 cap & CODEC_CAP_TRUNCATED ? "T":" ",
560 p2->long_name ? p2->long_name : "");
561 /* if(p2->decoder && decode==0)
562 printf(" use %s for decoding", p2->decoder->name);*/
567 "Note, the names of encoders and decoders do not always match, so there are\n"
568 "several cases where the above table shows encoder only or decoder only entries\n"
569 "even though both encoding and decoding are supported. For example, the h263\n"
570 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
576 AVBitStreamFilter *bsf=NULL;
578 printf("Bitstream filters:\n");
579 while((bsf = av_bitstream_filter_next(bsf)))
580 printf("%s\n", bsf->name);
584 void show_protocols(void)
586 URLProtocol *up=NULL;
588 printf("Supported file protocols:\n"
589 "I.. = Input supported\n"
590 ".O. = Output supported\n"
591 "..S = Seek supported\n"
594 while((up = av_protocol_next(up)))
595 printf("%c%c%c %s\n",
596 up->url_read ? 'I' : '.',
597 up->url_write ? 'O' : '.',
598 up->url_seek ? 'S' : '.',
602 void show_filters(void)
604 AVFilter av_unused(**filter) = NULL;
606 printf("Filters:\n");
608 while ((filter = av_filter_next(filter)) && *filter)
609 printf("%-16s %s\n", (*filter)->name, (*filter)->description);
613 void show_pix_fmts(void)
615 enum PixelFormat pix_fmt;
619 "I.... = Supported Input format for conversion\n"
620 ".O... = Supported Output format for conversion\n"
621 "..H.. = Hardware accelerated format\n"
622 "...P. = Paletted format\n"
623 "....B = Bitstream format\n"
624 "FLAGS NAME NB_COMPONENTS BITS_PER_PIXEL\n"
628 # define sws_isSupportedInput(x) 0
629 # define sws_isSupportedOutput(x) 0
632 for (pix_fmt = 0; pix_fmt < PIX_FMT_NB; pix_fmt++) {
633 const AVPixFmtDescriptor *pix_desc = &av_pix_fmt_descriptors[pix_fmt];
634 printf("%c%c%c%c%c %-16s %d %2d\n",
635 sws_isSupportedInput (pix_fmt) ? 'I' : '.',
636 sws_isSupportedOutput(pix_fmt) ? 'O' : '.',
637 pix_desc->flags & PIX_FMT_HWACCEL ? 'H' : '.',
638 pix_desc->flags & PIX_FMT_PAL ? 'P' : '.',
639 pix_desc->flags & PIX_FMT_BITSTREAM ? 'B' : '.',
641 pix_desc->nb_components,
642 av_get_bits_per_pixel(pix_desc));
649 int yesno = (toupper(c) == 'Y');
651 while (c != '\n' && c != EOF)
657 int read_file(const char *filename, char **bufptr, size_t *size)
659 FILE *f = fopen(filename, "rb");
662 fprintf(stderr, "Cannot read file '%s': %s\n", filename, strerror(errno));
663 return AVERROR(errno);
665 fseek(f, 0, SEEK_END);
667 fseek(f, 0, SEEK_SET);
668 *bufptr = av_malloc(*size + 1);
670 fprintf(stderr, "Could not allocate file buffer\n");
672 return AVERROR(ENOMEM);
674 fread(*bufptr, 1, *size, f);
675 (*bufptr)[*size++] = '\0';
681 void init_pts_correction(PtsCorrectionContext *ctx)
683 ctx->num_faulty_pts = ctx->num_faulty_dts = 0;
684 ctx->last_pts = ctx->last_dts = INT64_MIN;
687 int64_t guess_correct_pts(PtsCorrectionContext *ctx, int64_t reordered_pts, int64_t dts)
689 int64_t pts = AV_NOPTS_VALUE;
691 if (dts != AV_NOPTS_VALUE) {
692 ctx->num_faulty_dts += dts <= ctx->last_dts;
695 if (reordered_pts != AV_NOPTS_VALUE) {
696 ctx->num_faulty_pts += reordered_pts <= ctx->last_pts;
697 ctx->last_pts = reordered_pts;
699 if ((ctx->num_faulty_pts<=ctx->num_faulty_dts || dts == AV_NOPTS_VALUE)
700 && reordered_pts != AV_NOPTS_VALUE)