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) {
174 fprintf(stderr, "%s: invalid value '%s' for option '%s'\n", argv[0], arg, opt);
180 if(po->flags & OPT_EXIT)
183 if (parse_arg_function)
184 parse_arg_function(opt);
189 int opt_default(const char *opt, const char *arg){
192 const AVOption *o= NULL;
193 int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
195 for(type=0; type<CODEC_TYPE_NB && ret>= 0; type++){
196 const AVOption *o2 = av_find_opt(avcodec_opts[0], opt, NULL, opt_types[type], opt_types[type]);
198 ret = av_set_string3(avcodec_opts[type], opt, arg, 1, &o);
201 ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
203 ret = av_set_string3(sws_opts, opt, arg, 1, &o);
206 ret = av_set_string3(avcodec_opts[CODEC_TYPE_AUDIO], opt+1, arg, 1, &o);
207 else if(opt[0] == 'v')
208 ret = av_set_string3(avcodec_opts[CODEC_TYPE_VIDEO], opt+1, arg, 1, &o);
209 else if(opt[0] == 's')
210 ret = av_set_string3(avcodec_opts[CODEC_TYPE_SUBTITLE], opt+1, arg, 1, &o);
213 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
219 // 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));
221 //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
222 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
223 opt_names[opt_name_count++]= o->name;
225 if(avcodec_opts[0]->debug || avformat_opts->debug)
226 av_log_set_level(AV_LOG_DEBUG);
230 int opt_loglevel(const char *opt, const char *arg)
232 const struct { const char *name; int level; } log_levels[] = {
233 { "quiet" , AV_LOG_QUIET },
234 { "panic" , AV_LOG_PANIC },
235 { "fatal" , AV_LOG_FATAL },
236 { "error" , AV_LOG_ERROR },
237 { "warning", AV_LOG_WARNING },
238 { "info" , AV_LOG_INFO },
239 { "verbose", AV_LOG_VERBOSE },
240 { "debug" , AV_LOG_DEBUG },
246 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
247 if (!strcmp(log_levels[i].name, arg)) {
248 av_log_set_level(log_levels[i].level);
253 level = strtol(arg, &tail, 10);
255 fprintf(stderr, "Invalid loglevel \"%s\". "
256 "Possible levels are numbers or:\n", arg);
257 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
258 fprintf(stderr, "\"%s\"\n", log_levels[i].name);
261 av_log_set_level(level);
265 int opt_timelimit(const char *opt, const char *arg)
267 #if HAVE_SYS_RESOURCE_H
268 int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
269 struct rlimit rl = { lim, lim + 1 };
270 if (setrlimit(RLIMIT_CPU, &rl))
273 fprintf(stderr, "Warning: -%s not implemented on this OS\n", opt);
278 void set_context_opts(void *ctx, void *opts_ctx, int flags)
281 for(i=0; i<opt_name_count; i++){
284 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
285 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
286 if(str && ((opt->flags & flags) == flags))
287 av_set_string3(ctx, opt_names[i], str, 1, NULL);
291 void print_error(const char *filename, int err)
294 case AVERROR_NUMEXPECTED:
295 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
296 "Use '%%d' to specify the image number:\n"
297 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
298 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
301 case AVERROR_INVALIDDATA:
302 fprintf(stderr, "%s: Error while parsing header\n", filename);
305 fprintf(stderr, "%s: Unknown format\n", filename);
308 fprintf(stderr, "%s: I/O error occurred\n"
309 "Usually that means that input file is truncated and/or corrupted.\n",
312 case AVERROR(ENOMEM):
313 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
315 case AVERROR(ENOENT):
316 fprintf(stderr, "%s: no such file or directory\n", filename);
319 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
320 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
324 fprintf(stderr, "%s: Error while opening file\n", filename);
329 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
330 if (CONFIG_##LIBNAME) { \
331 unsigned int version = libname##_version(); \
332 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", \
333 indent? " " : "", #libname, \
334 LIB##LIBNAME##_VERSION_MAJOR, \
335 LIB##LIBNAME##_VERSION_MINOR, \
336 LIB##LIBNAME##_VERSION_MICRO, \
337 version >> 16, version >> 8 & 0xff, version & 0xff); \
340 static void print_all_lib_versions(FILE* outstream, int indent)
342 PRINT_LIB_VERSION(outstream, avutil, AVUTIL, indent);
343 PRINT_LIB_VERSION(outstream, avcodec, AVCODEC, indent);
344 PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
345 PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
346 PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
347 PRINT_LIB_VERSION(outstream, swscale, SWSCALE, indent);
348 PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
351 static void maybe_print_config(const char *lib, const char *cfg)
353 static int warned_cfg;
355 if (strcmp(FFMPEG_CONFIGURATION, cfg)) {
357 fprintf(stderr, " WARNING: library configuration mismatch\n");
360 fprintf(stderr, " %-11s configuration: %s\n", lib, cfg);
364 #define PRINT_LIB_CONFIG(lib, tag, cfg) do { \
366 maybe_print_config(tag, cfg); \
369 void show_banner(void)
371 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-%d Fabrice Bellard, et al.\n",
372 program_name, program_birth_year, this_year);
373 fprintf(stderr, " built on %s %s with %s %s\n",
374 __DATE__, __TIME__, CC_TYPE, CC_VERSION);
375 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
376 PRINT_LIB_CONFIG(AVUTIL, "libavutil", avutil_configuration());
377 PRINT_LIB_CONFIG(AVCODEC, "libavcodec", avcodec_configuration());
378 PRINT_LIB_CONFIG(AVFORMAT, "libavformat", avformat_configuration());
379 PRINT_LIB_CONFIG(AVDEVICE, "libavdevice", avdevice_configuration());
380 PRINT_LIB_CONFIG(AVFILTER, "libavfilter", avfilter_configuration());
381 PRINT_LIB_CONFIG(SWSCALE, "libswscale", swscale_configuration());
382 PRINT_LIB_CONFIG(POSTPROC, "libpostproc", postproc_configuration());
383 print_all_lib_versions(stderr, 1);
386 void show_version(void) {
387 printf("%s " FFMPEG_VERSION "\n", program_name);
388 print_all_lib_versions(stdout, 0);
391 void show_license(void)
395 "This version of %s has nonfree parts compiled in.\n"
396 "Therefore it is not legally redistributable.\n",
399 "%s is free software; you can redistribute it and/or modify\n"
400 "it under the terms of the GNU General Public License as published by\n"
401 "the Free Software Foundation; either version 3 of the License, or\n"
402 "(at your option) any later version.\n"
404 "%s is distributed in the hope that it will be useful,\n"
405 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
406 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
407 "GNU General Public License for more details.\n"
409 "You should have received a copy of the GNU General Public License\n"
410 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
411 program_name, program_name, program_name
413 "%s is free software; you can redistribute it and/or modify\n"
414 "it under the terms of the GNU General Public License as published by\n"
415 "the Free Software Foundation; either version 2 of the License, or\n"
416 "(at your option) any later version.\n"
418 "%s is distributed in the hope that it will be useful,\n"
419 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
420 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
421 "GNU General Public License for more details.\n"
423 "You should have received a copy of the GNU General Public License\n"
424 "along with %s; if not, write to the Free Software\n"
425 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
426 program_name, program_name, program_name
428 "%s is free software; you can redistribute it and/or modify\n"
429 "it under the terms of the GNU Lesser General Public License as published by\n"
430 "the Free Software Foundation; either version 3 of the License, or\n"
431 "(at your option) any later version.\n"
433 "%s is distributed in the hope that it will be useful,\n"
434 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
435 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
436 "GNU Lesser General Public License for more details.\n"
438 "You should have received a copy of the GNU Lesser General Public License\n"
439 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
440 program_name, program_name, program_name
442 "%s is free software; you can redistribute it and/or\n"
443 "modify it under the terms of the GNU Lesser General Public\n"
444 "License as published by the Free Software Foundation; either\n"
445 "version 2.1 of the License, or (at your option) any later version.\n"
447 "%s is distributed in the hope that it will be useful,\n"
448 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
449 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
450 "Lesser General Public License for more details.\n"
452 "You should have received a copy of the GNU Lesser General Public\n"
453 "License along with %s; if not, write to the Free Software\n"
454 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
455 program_name, program_name, program_name
460 void list_fmts(void (*get_fmt_string)(char *buf, int buf_size, int fmt), int nb_fmts)
464 for (i=-1; i < nb_fmts; i++) {
465 get_fmt_string (fmt_str, sizeof(fmt_str), i);
466 fprintf(stdout, "%s\n", fmt_str);
470 void show_formats(void)
472 AVInputFormat *ifmt=NULL;
473 AVOutputFormat *ofmt=NULL;
474 const char *last_name;
478 " D. = Demuxing supported\n"
479 " .E = Muxing supported\n"
485 const char *name=NULL;
486 const char *long_name=NULL;
488 while((ofmt= av_oformat_next(ofmt))) {
489 if((name == NULL || strcmp(ofmt->name, name)<0) &&
490 strcmp(ofmt->name, last_name)>0){
492 long_name= ofmt->long_name;
496 while((ifmt= av_iformat_next(ifmt))) {
497 if((name == NULL || strcmp(ifmt->name, name)<0) &&
498 strcmp(ifmt->name, last_name)>0){
500 long_name= ifmt->long_name;
503 if(name && strcmp(ifmt->name, name)==0)
515 long_name ? long_name:" ");
519 void show_codecs(void)
521 AVCodec *p=NULL, *p2;
522 const char *last_name;
525 " D..... = Decoding supported\n"
526 " .E.... = Encoding supported\n"
527 " ..V... = Video codec\n"
528 " ..A... = Audio codec\n"
529 " ..S... = Subtitle codec\n"
530 " ...S.. = Supports draw_horiz_band\n"
531 " ....D. = Supports direct rendering method 1\n"
532 " .....T = Supports weird frame truncation\n"
539 const char *type_str;
542 while((p= av_codec_next(p))) {
543 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
544 strcmp(p->name, last_name)>0){
546 decode= encode= cap=0;
548 if(p2 && strcmp(p->name, p2->name)==0){
549 if(p->decode) decode=1;
550 if(p->encode) encode=1;
551 cap |= p->capabilities;
559 case CODEC_TYPE_VIDEO:
562 case CODEC_TYPE_AUDIO:
565 case CODEC_TYPE_SUBTITLE:
573 " %s%s%s%s%s%s %-15s %s",
574 decode ? "D": (/*p2->decoder ? "d":*/" "),
577 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
578 cap & CODEC_CAP_DR1 ? "D":" ",
579 cap & CODEC_CAP_TRUNCATED ? "T":" ",
581 p2->long_name ? p2->long_name : "");
582 /* if(p2->decoder && decode==0)
583 printf(" use %s for decoding", p2->decoder->name);*/
588 "Note, the names of encoders and decoders do not always match, so there are\n"
589 "several cases where the above table shows encoder only or decoder only entries\n"
590 "even though both encoding and decoding are supported. For example, the h263\n"
591 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
597 AVBitStreamFilter *bsf=NULL;
599 printf("Bitstream filters:\n");
600 while((bsf = av_bitstream_filter_next(bsf)))
601 printf("%s\n", bsf->name);
605 void show_protocols(void)
607 URLProtocol *up=NULL;
609 printf("Supported file protocols:\n");
610 while((up = av_protocol_next(up)))
611 printf("%s\n", up->name);
614 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
617 void show_filters(void)
619 AVFilter av_unused(**filter) = NULL;
621 printf("Filters:\n");
623 while ((filter = av_filter_next(filter)) && *filter)
624 printf("%-16s %s\n", (*filter)->name, (*filter)->description);
628 void show_pix_fmts(void)
630 list_fmts(avcodec_pix_fmt_string, PIX_FMT_NB);
636 int yesno = (toupper(c) == 'Y');
638 while (c != '\n' && c != EOF)