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"
44 #include "libavformat/network.h"
46 #if HAVE_SYS_RESOURCE_H
47 #include <sys/resource.h>
50 const char **opt_names;
51 static int opt_name_count;
52 AVCodecContext *avcodec_opts[AVMEDIA_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 = av_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: failed to set 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<AVMEDIA_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[AVMEDIA_TYPE_AUDIO], opt+1, arg, 1, &o);
207 else if(opt[0] == 'v')
208 ret = av_set_string3(avcodec_opts[AVMEDIA_TYPE_VIDEO], opt+1, arg, 1, &o);
209 else if(opt[0] == 's')
210 ret = av_set_string3(avcodec_opts[AVMEDIA_TYPE_SUBTITLE], opt+1, arg, 1, &o);
213 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
217 fprintf(stderr, "Unrecognized option '%s'\n", opt);
221 // 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));
223 //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
224 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
225 opt_names[opt_name_count++]= o->name;
227 if(avcodec_opts[0]->debug || avformat_opts->debug)
228 av_log_set_level(AV_LOG_DEBUG);
232 int opt_loglevel(const char *opt, const char *arg)
234 const struct { const char *name; int level; } log_levels[] = {
235 { "quiet" , AV_LOG_QUIET },
236 { "panic" , AV_LOG_PANIC },
237 { "fatal" , AV_LOG_FATAL },
238 { "error" , AV_LOG_ERROR },
239 { "warning", AV_LOG_WARNING },
240 { "info" , AV_LOG_INFO },
241 { "verbose", AV_LOG_VERBOSE },
242 { "debug" , AV_LOG_DEBUG },
248 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
249 if (!strcmp(log_levels[i].name, arg)) {
250 av_log_set_level(log_levels[i].level);
255 level = strtol(arg, &tail, 10);
257 fprintf(stderr, "Invalid loglevel \"%s\". "
258 "Possible levels are numbers or:\n", arg);
259 for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
260 fprintf(stderr, "\"%s\"\n", log_levels[i].name);
263 av_log_set_level(level);
267 int opt_timelimit(const char *opt, const char *arg)
270 int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
271 struct rlimit rl = { lim, lim + 1 };
272 if (setrlimit(RLIMIT_CPU, &rl))
275 fprintf(stderr, "Warning: -%s not implemented on this OS\n", opt);
280 void set_context_opts(void *ctx, void *opts_ctx, int flags)
283 for(i=0; i<opt_name_count; i++){
286 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
287 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
288 if(str && ((opt->flags & flags) == flags))
289 av_set_string3(ctx, opt_names[i], str, 1, NULL);
293 void print_error(const char *filename, int err)
296 const char *errbuf_ptr = errbuf;
298 if (av_strerror(err, errbuf, sizeof(errbuf)) < 0)
299 errbuf_ptr = strerror(AVUNERROR(err));
300 fprintf(stderr, "%s: %s\n", filename, errbuf_ptr);
303 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
304 if (CONFIG_##LIBNAME) { \
305 unsigned int version = libname##_version(); \
306 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", \
307 indent? " " : "", #libname, \
308 LIB##LIBNAME##_VERSION_MAJOR, \
309 LIB##LIBNAME##_VERSION_MINOR, \
310 LIB##LIBNAME##_VERSION_MICRO, \
311 version >> 16, version >> 8 & 0xff, version & 0xff); \
314 static void print_all_lib_versions(FILE* outstream, int indent)
316 PRINT_LIB_VERSION(outstream, avutil, AVUTIL, indent);
317 PRINT_LIB_VERSION(outstream, avcodec, AVCODEC, indent);
318 PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
319 PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
320 PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
321 PRINT_LIB_VERSION(outstream, swscale, SWSCALE, indent);
322 PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
325 static void maybe_print_config(const char *lib, const char *cfg)
327 static int warned_cfg;
329 if (strcmp(FFMPEG_CONFIGURATION, cfg)) {
331 fprintf(stderr, " WARNING: library configuration mismatch\n");
334 fprintf(stderr, " %-11s configuration: %s\n", lib, cfg);
338 #define PRINT_LIB_CONFIG(lib, tag, cfg) do { \
340 maybe_print_config(tag, cfg); \
343 void show_banner(void)
345 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-%d the FFmpeg developers\n",
346 program_name, program_birth_year, this_year);
347 fprintf(stderr, " built on %s %s with %s %s\n",
348 __DATE__, __TIME__, CC_TYPE, CC_VERSION);
349 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
350 PRINT_LIB_CONFIG(AVUTIL, "libavutil", avutil_configuration());
351 PRINT_LIB_CONFIG(AVCODEC, "libavcodec", avcodec_configuration());
352 PRINT_LIB_CONFIG(AVFORMAT, "libavformat", avformat_configuration());
353 PRINT_LIB_CONFIG(AVDEVICE, "libavdevice", avdevice_configuration());
354 PRINT_LIB_CONFIG(AVFILTER, "libavfilter", avfilter_configuration());
355 PRINT_LIB_CONFIG(SWSCALE, "libswscale", swscale_configuration());
356 PRINT_LIB_CONFIG(POSTPROC, "libpostproc", postproc_configuration());
357 print_all_lib_versions(stderr, 1);
360 void show_version(void) {
361 printf("%s " FFMPEG_VERSION "\n", program_name);
362 print_all_lib_versions(stdout, 0);
365 void show_license(void)
369 "This version of %s has nonfree parts compiled in.\n"
370 "Therefore it is not legally redistributable.\n",
373 "%s is free software; you can redistribute it and/or modify\n"
374 "it under the terms of the GNU General Public License as published by\n"
375 "the Free Software Foundation; either version 3 of the License, or\n"
376 "(at your option) any later version.\n"
378 "%s is distributed in the hope that it will be useful,\n"
379 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
380 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
381 "GNU General Public License for more details.\n"
383 "You should have received a copy of the GNU General Public License\n"
384 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
385 program_name, program_name, program_name
387 "%s is free software; you can redistribute it and/or modify\n"
388 "it under the terms of the GNU General Public License as published by\n"
389 "the Free Software Foundation; either version 2 of the License, or\n"
390 "(at your option) any later version.\n"
392 "%s is distributed in the hope that it will be useful,\n"
393 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
394 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
395 "GNU General Public License for more details.\n"
397 "You should have received a copy of the GNU General Public License\n"
398 "along with %s; if not, write to the Free Software\n"
399 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
400 program_name, program_name, program_name
402 "%s is free software; you can redistribute it and/or modify\n"
403 "it under the terms of the GNU Lesser General Public License as published by\n"
404 "the Free Software Foundation; either version 3 of the License, or\n"
405 "(at your option) any later version.\n"
407 "%s is distributed in the hope that it will be useful,\n"
408 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
409 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
410 "GNU Lesser General Public License for more details.\n"
412 "You should have received a copy of the GNU Lesser General Public License\n"
413 "along with %s. If not, see <http://www.gnu.org/licenses/>.\n",
414 program_name, program_name, program_name
416 "%s is free software; you can redistribute it and/or\n"
417 "modify it under the terms of the GNU Lesser General Public\n"
418 "License as published by the Free Software Foundation; either\n"
419 "version 2.1 of the License, or (at your option) any later version.\n"
421 "%s is distributed in the hope that it will be useful,\n"
422 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
423 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
424 "Lesser General Public License for more details.\n"
426 "You should have received a copy of the GNU Lesser General Public\n"
427 "License along with %s; if not, write to the Free Software\n"
428 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
429 program_name, program_name, program_name
434 void list_fmts(void (*get_fmt_string)(char *buf, int buf_size, int fmt), int nb_fmts)
438 for (i=-1; i < nb_fmts; i++) {
439 get_fmt_string (fmt_str, sizeof(fmt_str), i);
440 fprintf(stdout, "%s\n", fmt_str);
444 void show_formats(void)
446 AVInputFormat *ifmt=NULL;
447 AVOutputFormat *ofmt=NULL;
448 const char *last_name;
452 " D. = Demuxing supported\n"
453 " .E = Muxing supported\n"
459 const char *name=NULL;
460 const char *long_name=NULL;
462 while((ofmt= av_oformat_next(ofmt))) {
463 if((name == NULL || strcmp(ofmt->name, name)<0) &&
464 strcmp(ofmt->name, last_name)>0){
466 long_name= ofmt->long_name;
470 while((ifmt= av_iformat_next(ifmt))) {
471 if((name == NULL || strcmp(ifmt->name, name)<0) &&
472 strcmp(ifmt->name, last_name)>0){
474 long_name= ifmt->long_name;
477 if(name && strcmp(ifmt->name, name)==0)
489 long_name ? long_name:" ");
493 void show_codecs(void)
495 AVCodec *p=NULL, *p2;
496 const char *last_name;
499 " D..... = Decoding supported\n"
500 " .E.... = Encoding supported\n"
501 " ..V... = Video codec\n"
502 " ..A... = Audio codec\n"
503 " ..S... = Subtitle codec\n"
504 " ...S.. = Supports draw_horiz_band\n"
505 " ....D. = Supports direct rendering method 1\n"
506 " .....T = Supports weird frame truncation\n"
513 const char *type_str;
516 while((p= av_codec_next(p))) {
517 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
518 strcmp(p->name, last_name)>0){
520 decode= encode= cap=0;
522 if(p2 && strcmp(p->name, p2->name)==0){
523 if(p->decode) decode=1;
524 if(p->encode) encode=1;
525 cap |= p->capabilities;
533 case AVMEDIA_TYPE_VIDEO:
536 case AVMEDIA_TYPE_AUDIO:
539 case AVMEDIA_TYPE_SUBTITLE:
547 " %s%s%s%s%s%s %-15s %s",
548 decode ? "D": (/*p2->decoder ? "d":*/" "),
551 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
552 cap & CODEC_CAP_DR1 ? "D":" ",
553 cap & CODEC_CAP_TRUNCATED ? "T":" ",
555 p2->long_name ? p2->long_name : "");
556 /* if(p2->decoder && decode==0)
557 printf(" use %s for decoding", p2->decoder->name);*/
562 "Note, the names of encoders and decoders do not always match, so there are\n"
563 "several cases where the above table shows encoder only or decoder only entries\n"
564 "even though both encoding and decoding are supported. For example, the h263\n"
565 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
571 AVBitStreamFilter *bsf=NULL;
573 printf("Bitstream filters:\n");
574 while((bsf = av_bitstream_filter_next(bsf)))
575 printf("%s\n", bsf->name);
579 void show_protocols(void)
581 URLProtocol *up=NULL;
583 printf("Supported file protocols:\n");
584 while((up = av_protocol_next(up)))
585 printf("%s\n", up->name);
588 void show_filters(void)
590 AVFilter av_unused(**filter) = NULL;
592 printf("Filters:\n");
594 while ((filter = av_filter_next(filter)) && *filter)
595 printf("%-16s %s\n", (*filter)->name, (*filter)->description);
599 void show_pix_fmts(void)
601 enum PixelFormat pix_fmt;
605 "I.... = Supported Input format for conversion\n"
606 ".O... = Supported Output format for conversion\n"
607 "..H.. = Hardware accelerated format\n"
608 "...P. = Paletted format\n"
609 "....B = Bitstream format\n"
610 "FLAGS NAME NB_COMPONENTS BITS_PER_PIXEL\n"
614 # define sws_isSupportedInput(x) 0
615 # define sws_isSupportedOutput(x) 0
618 for (pix_fmt = 0; pix_fmt < PIX_FMT_NB; pix_fmt++) {
619 const AVPixFmtDescriptor *pix_desc = &av_pix_fmt_descriptors[pix_fmt];
620 printf("%c%c%c%c%c %-16s %d %2d\n",
621 sws_isSupportedInput (pix_fmt) ? 'I' : '.',
622 sws_isSupportedOutput(pix_fmt) ? 'O' : '.',
623 pix_desc->flags & PIX_FMT_HWACCEL ? 'H' : '.',
624 pix_desc->flags & PIX_FMT_PAL ? 'P' : '.',
625 pix_desc->flags & PIX_FMT_BITSTREAM ? 'B' : '.',
627 pix_desc->nb_components,
628 av_get_bits_per_pixel(pix_desc));
635 int yesno = (toupper(c) == 'Y');
637 while (c != '\n' && c != EOF)
643 int read_file(const char *filename, char **bufptr, size_t *size)
645 FILE *f = fopen(filename, "rb");
648 fprintf(stderr, "Cannot read file '%s': %s\n", filename, strerror(errno));
649 return AVERROR(errno);
651 fseek(f, 0, SEEK_END);
653 fseek(f, 0, SEEK_SET);
654 *bufptr = av_malloc(*size + 1);
656 fprintf(stderr, "Could not allocate file buffer\n");
658 return AVERROR(ENOMEM);
660 fread(*bufptr, 1, *size, f);
661 (*bufptr)[*size++] = '\0';