cmdutils.c
01310af2
 /*
  * Various utilities for command line tools
  * Copyright (c) 2000-2003 Fabrice Bellard
  *
b78e7197
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
01310af2
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
b78e7197
  * version 2.1 of the License, or (at your option) any later version.
01310af2
  *
b78e7197
  * FFmpeg is distributed in the hope that it will be useful,
01310af2
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
b78e7197
  * License along with FFmpeg; if not, write to the Free Software
5509bffa
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
01310af2
  */
364a9607
 
0f4e8165
 #include <string.h>
 #include <stdlib.h>
 #include <errno.h>
7c84b8bc
 #include <math.h>
0f4e8165
 
2cd39dbf
 /* Include only the enabled headers since some compilers (namely, Sun
    Studio) will not omit unused inline functions and create undefined
    references to libraries that are not being built. */
 
63d026b1
 #include "config.h"
245976da
 #include "libavformat/avformat.h"
 #include "libavfilter/avfilter.h"
 #include "libavdevice/avdevice.h"
db6d50c7
 #include "libswscale/swscale.h"
1981deaf
 #include "libpostproc/postprocess.h"
245976da
 #include "libavutil/avstring.h"
85663ef3
 #include "libavcodec/opt.h"
01310af2
 #include "cmdutils.h"
86074ed1
 #include "version.h"
da2dc39e
 #if CONFIG_NETWORK
245976da
 #include "libavformat/network.h"
da2dc39e
 #endif
01310af2
 
c367d067
 #undef exit
 
85663ef3
 const char **opt_names;
 static int opt_name_count;
 AVCodecContext *avctx_opts[CODEC_TYPE_NB];
 AVFormatContext *avformat_opts;
 struct SwsContext *sws_opts;
086ab001
 
ef4c0bb1
 const int this_year = 2009;
 
086ab001
 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
 {
     char *tail;
     const char *error;
     double d = strtod(numstr, &tail);
     if (*tail)
         error= "Expected number for %s but found: %s\n";
     else if (d < min || d > max)
         error= "The value for %s was %s which is not within %f - %f\n";
     else if(type == OPT_INT64 && (int64_t)d != d)
         error= "Expected int64 for %s but found %s\n";
     else
         return d;
     fprintf(stderr, error, context, numstr, min, max);
     exit(1);
 }
 
7542157d
 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
 {
     int64_t us = parse_date(timestr, is_duration);
     if (us == INT64_MIN) {
         fprintf(stderr, "Invalid %s specification for %s: %s\n",
                 is_duration ? "duration" : "date", context, timestr);
         exit(1);
     }
     return us;
 }
 
02d504a7
 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
01310af2
 {
     const OptionDef *po;
02d504a7
     int first;
01310af2
 
02d504a7
     first = 1;
     for(po = options; po->name != NULL; po++) {
         char buf[64];
         if ((po->flags & mask) == value) {
             if (first) {
                 printf("%s", msg);
                 first = 0;
             }
f7d78f36
             av_strlcpy(buf, po->name, sizeof(buf));
02d504a7
             if (po->flags & HAS_ARG) {
f7d78f36
                 av_strlcat(buf, " ", sizeof(buf));
                 av_strlcat(buf, po->argname, sizeof(buf));
01310af2
             }
02d504a7
             printf("-%-17s  %s\n", buf, po->help);
01310af2
         }
     }
 }
 
fccfc475
 static const OptionDef* find_option(const OptionDef *po, const char *name){
8bbf6db9
     while (po->name != NULL) {
         if (!strcmp(name, po->name))
             break;
         po++;
     }
     return po;
 }
 
60a9966e
 void parse_options(int argc, char **argv, const OptionDef *options,
                    void (* parse_arg_function)(const char*))
01310af2
 {
     const char *opt, *arg;
b0d7bc1e
     int optindex, handleoptions=1;
01310af2
     const OptionDef *po;
 
     /* parse options */
     optindex = 1;
     while (optindex < argc) {
         opt = argv[optindex++];
115329f1
 
84bf226b
         if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
3749076c
             if (opt[1] == '-' && opt[2] == '\0') {
                 handleoptions = 0;
                 continue;
             }
8bbf6db9
             po= find_option(options, opt + 1);
             if (!po->name)
                 po= find_option(options, "default");
01310af2
             if (!po->name) {
8bbf6db9
 unknown_opt:
01310af2
                 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
                 exit(1);
             }
             arg = NULL;
             if (po->flags & HAS_ARG) {
                 arg = argv[optindex++];
                 if (!arg) {
                     fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
                     exit(1);
                 }
             }
             if (po->flags & OPT_STRING) {
                 char *str;
02d504a7
                 str = av_strdup(arg);
01310af2
                 *po->u.str_arg = str;
             } else if (po->flags & OPT_BOOL) {
                 *po->u.int_arg = 1;
26d4f26b
             } else if (po->flags & OPT_INT) {
7c84b8bc
                 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
ffdf9a1f
             } else if (po->flags & OPT_INT64) {
7c84b8bc
                 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
1f631450
             } else if (po->flags & OPT_FLOAT) {
1f3d74d3
                 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
8bbf6db9
             } else if (po->flags & OPT_FUNC2) {
                 if(po->u.func2_arg(opt+1, arg)<0)
                     goto unknown_opt;
01310af2
             } else {
bb270c08
                 po->u.func_arg(arg);
01310af2
             }
a0b3bcd9
             if(po->flags & OPT_EXIT)
                 exit(0);
01310af2
         } else {
60a9966e
             if (parse_arg_function)
                 parse_arg_function(opt);
01310af2
         }
     }
 }
 
85663ef3
 int opt_default(const char *opt, const char *arg){
     int type;
5c3383e5
     int ret= 0;
85663ef3
     const AVOption *o= NULL;
     int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
 
5c3383e5
     for(type=0; type<CODEC_TYPE_NB && ret>= 0; type++){
85663ef3
         const AVOption *o2 = av_find_opt(avctx_opts[0], opt, NULL, opt_types[type], opt_types[type]);
         if(o2)
5c3383e5
             ret = av_set_string3(avctx_opts[type], opt, arg, 1, &o);
85663ef3
     }
     if(!o)
5c3383e5
         ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
85663ef3
     if(!o)
5c3383e5
         ret = av_set_string3(sws_opts, opt, arg, 1, &o);
85663ef3
     if(!o){
         if(opt[0] == 'a')
5c3383e5
             ret = av_set_string3(avctx_opts[CODEC_TYPE_AUDIO], opt+1, arg, 1, &o);
85663ef3
         else if(opt[0] == 'v')
5c3383e5
             ret = av_set_string3(avctx_opts[CODEC_TYPE_VIDEO], opt+1, arg, 1, &o);
85663ef3
         else if(opt[0] == 's')
5c3383e5
             ret = av_set_string3(avctx_opts[CODEC_TYPE_SUBTITLE], opt+1, arg, 1, &o);
     }
     if (o && ret < 0) {
         fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
         exit(1);
85663ef3
     }
     if(!o)
         return -1;
 
 //    av_log(NULL, AV_LOG_ERROR, "%s:%s: %f 0x%0X\n", opt, arg, av_get_double(avctx_opts, opt, NULL), (int)av_get_int(avctx_opts, opt, NULL));
 
     //FIXME we should always use avctx_opts, ... for storing options so there will not be any need to keep track of what i set over this
     opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
     opt_names[opt_name_count++]= o->name;
 
     if(avctx_opts[0]->debug || avformat_opts->debug)
         av_log_set_level(AV_LOG_DEBUG);
     return 0;
 }
 
 void set_context_opts(void *ctx, void *opts_ctx, int flags)
 {
     int i;
     for(i=0; i<opt_name_count; i++){
         char buf[256];
         const AVOption *opt;
         const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
         /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
         if(str && ((opt->flags & flags) == flags))
f16dd7e6
             av_set_string3(ctx, opt_names[i], str, 1, NULL);
85663ef3
     }
 }
 
01310af2
 void print_error(const char *filename, int err)
 {
     switch(err) {
     case AVERROR_NUMEXPECTED:
         fprintf(stderr, "%s: Incorrect image filename syntax.\n"
                 "Use '%%d' to specify the image number:\n"
                 "  for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
115329f1
                 "  for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
01310af2
                 filename);
         break;
     case AVERROR_INVALIDDATA:
         fprintf(stderr, "%s: Error while parsing header\n", filename);
         break;
     case AVERROR_NOFMT:
         fprintf(stderr, "%s: Unknown format\n", filename);
         break;
6f3e0b21
     case AVERROR(EIO):
d9526386
         fprintf(stderr, "%s: I/O error occurred\n"
bb270c08
                 "Usually that means that input file is truncated and/or corrupted.\n",
                 filename);
45ce5ddb
         break;
769e10f0
     case AVERROR(ENOMEM):
d9526386
         fprintf(stderr, "%s: memory allocation error occurred\n", filename);
45ce5ddb
         break;
24fddf48
     case AVERROR(ENOENT):
0ba0c8de
         fprintf(stderr, "%s: no such file or directory\n", filename);
         break;
b250f9c6
 #if CONFIG_NETWORK
18ec0460
     case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
         fprintf(stderr, "%s: Unsupported network protocol\n", filename);
         break;
0b705fa4
 #endif
01310af2
     default:
         fprintf(stderr, "%s: Error while opening file\n", filename);
         break;
     }
 }
f35917b2
 
9a109272
 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
     version= libname##_version(); \
     fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? "  " : "", #libname, \
             LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
             version >> 16, version >> 8 & 0xff, version & 0xff);
 
88b77ef1
 static void print_all_lib_versions(FILE* outstream, int indent)
9a109272
 {
     unsigned int version;
e9df66a7
     PRINT_LIB_VERSION(outstream, avutil,   AVUTIL,   indent);
     PRINT_LIB_VERSION(outstream, avcodec,  AVCODEC,  indent);
9a109272
     PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
     PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
b250f9c6
 #if CONFIG_AVFILTER
9a109272
     PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
 #endif
b250f9c6
 #if CONFIG_SWSCALE
e9df66a7
     PRINT_LIB_VERSION(outstream, swscale,  SWSCALE,  indent);
db6d50c7
 #endif
b250f9c6
 #if CONFIG_POSTPROC
1981deaf
     PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
 #endif
9a109272
 }
 
ea9c581f
 void show_banner(void)
86074ed1
 {
ef4c0bb1
     fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-%d Fabrice Bellard, et al.\n",
             program_name, program_birth_year, this_year);
86074ed1
     fprintf(stderr, "  configuration: " FFMPEG_CONFIGURATION "\n");
9a109272
     print_all_lib_versions(stderr, 1);
86074ed1
     fprintf(stderr, "  built on " __DATE__ " " __TIME__);
 #ifdef __GNUC__
     fprintf(stderr, ", gcc: " __VERSION__ "\n");
 #else
     fprintf(stderr, ", using a non-gcc compiler\n");
 #endif
 }
 
64555bd9
 void show_version(void) {
86074ed1
     printf("%s " FFMPEG_VERSION "\n", program_name);
9a109272
     print_all_lib_versions(stdout, 0);
86074ed1
 }
 
f35917b2
 void show_license(void)
 {
7ead693b
     printf(
dd2089df
 #if CONFIG_NONFREE
304ba23a
     "This version of %s has nonfree parts compiled in.\n"
     "Therefore it is not legally redistributable.\n",
     program_name
dd2089df
 #elif CONFIG_GPLV3
     "%s is free software; you can redistribute it and/or modify\n"
     "it under the terms of the GNU General Public License as published by\n"
     "the Free Software Foundation; either version 3 of the License, or\n"
     "(at your option) any later version.\n"
     "\n"
     "%s is distributed in the hope that it will be useful,\n"
     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
     "GNU General Public License for more details.\n"
     "\n"
     "You should have received a copy of the GNU General Public License\n"
     "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
     program_name, program_name, program_name
7ead693b
 #elif CONFIG_GPL
304ba23a
     "%s is free software; you can redistribute it and/or modify\n"
f35917b2
     "it under the terms of the GNU General Public License as published by\n"
     "the Free Software Foundation; either version 2 of the License, or\n"
     "(at your option) any later version.\n"
     "\n"
304ba23a
     "%s is distributed in the hope that it will be useful,\n"
f35917b2
     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
     "GNU General Public License for more details.\n"
     "\n"
     "You should have received a copy of the GNU General Public License\n"
304ba23a
     "along with %s; if not, write to the Free Software\n"
     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
     program_name, program_name, program_name
dd2089df
 #elif CONFIG_LGPLV3
     "%s is free software; you can redistribute it and/or modify\n"
     "it under the terms of the GNU Lesser General Public License as published by\n"
     "the Free Software Foundation; either version 3 of the License, or\n"
     "(at your option) any later version.\n"
     "\n"
     "%s is distributed in the hope that it will be useful,\n"
     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
     "GNU Lesser General Public License for more details.\n"
     "\n"
     "You should have received a copy of the GNU Lesser General Public License\n"
     "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
     program_name, program_name, program_name
f35917b2
 #else
304ba23a
     "%s is free software; you can redistribute it and/or\n"
f35917b2
     "modify it under the terms of the GNU Lesser General Public\n"
     "License as published by the Free Software Foundation; either\n"
     "version 2.1 of the License, or (at your option) any later version.\n"
     "\n"
304ba23a
     "%s is distributed in the hope that it will be useful,\n"
f35917b2
     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\n"
     "Lesser General Public License for more details.\n"
     "\n"
     "You should have received a copy of the GNU Lesser General Public\n"
304ba23a
     "License along with %s; if not, write to the Free Software\n"
     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
     program_name, program_name, program_name
f35917b2
 #endif
dd2089df
     );
f35917b2
 }
ba9880c1
 
 void show_formats(void)
 {
     AVInputFormat *ifmt=NULL;
     AVOutputFormat *ofmt=NULL;
     URLProtocol *up=NULL;
     AVCodec *p=NULL, *p2;
     AVBitStreamFilter *bsf=NULL;
     const char *last_name;
 
     printf("File formats:\n");
     last_name= "000";
     for(;;){
         int decode=0;
         int encode=0;
         const char *name=NULL;
         const char *long_name=NULL;
 
         while((ofmt= av_oformat_next(ofmt))) {
             if((name == NULL || strcmp(ofmt->name, name)<0) &&
                 strcmp(ofmt->name, last_name)>0){
                 name= ofmt->name;
                 long_name= ofmt->long_name;
                 encode=1;
             }
         }
         while((ifmt= av_iformat_next(ifmt))) {
             if((name == NULL || strcmp(ifmt->name, name)<0) &&
                 strcmp(ifmt->name, last_name)>0){
                 name= ifmt->name;
                 long_name= ifmt->long_name;
                 encode=0;
             }
             if(name && strcmp(ifmt->name, name)==0)
                 decode=1;
         }
         if(name==NULL)
             break;
         last_name= name;
 
         printf(
             " %s%s %-15s %s\n",
             decode ? "D":" ",
             encode ? "E":" ",
             name,
             long_name ? long_name:" ");
     }
     printf("\n");
 
     printf("Codecs:\n");
     last_name= "000";
     for(;;){
         int decode=0;
         int encode=0;
         int cap=0;
         const char *type_str;
 
         p2=NULL;
         while((p= av_codec_next(p))) {
             if((p2==NULL || strcmp(p->name, p2->name)<0) &&
                 strcmp(p->name, last_name)>0){
                 p2= p;
                 decode= encode= cap=0;
             }
             if(p2 && strcmp(p->name, p2->name)==0){
                 if(p->decode) decode=1;
                 if(p->encode) encode=1;
                 cap |= p->capabilities;
             }
         }
         if(p2==NULL)
             break;
         last_name= p2->name;
 
         switch(p2->type) {
         case CODEC_TYPE_VIDEO:
             type_str = "V";
             break;
         case CODEC_TYPE_AUDIO:
             type_str = "A";
             break;
         case CODEC_TYPE_SUBTITLE:
             type_str = "S";
             break;
         default:
             type_str = "?";
             break;
         }
         printf(
             " %s%s%s%s%s%s %-15s %s",
             decode ? "D": (/*p2->decoder ? "d":*/" "),
             encode ? "E":" ",
             type_str,
             cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
             cap & CODEC_CAP_DR1 ? "D":" ",
             cap & CODEC_CAP_TRUNCATED ? "T":" ",
             p2->name,
             p2->long_name ? p2->long_name : "");
        /* if(p2->decoder && decode==0)
             printf(" use %s for decoding", p2->decoder->name);*/
         printf("\n");
     }
     printf("\n");
 
     printf("Bitstream filters:\n");
     while((bsf = av_bitstream_filter_next(bsf)))
         printf(" %s", bsf->name);
     printf("\n");
 
     printf("Supported file protocols:\n");
     while((up = av_protocol_next(up)))
         printf(" %s:", up->name);
     printf("\n");
 
     printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
     printf("\n");
     printf(
 "Note, the names of encoders and decoders do not always match, so there are\n"
 "several cases where the above table shows encoder only or decoder only entries\n"
 "even though both encoding and decoding are supported. For example, the h263\n"
 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
 "worse.\n");
 }