cmdutils.c

   1 /*
   2  * Various utilities for command line tools
   3  * Copyright (c) 2000-2003 Fabrice Bellard
   4  *
   5  * This file is part of FFmpeg.
   6  *
   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.
  11  *
  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.
  16  *
  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
  20  */
  21
  22 #include <string.h>
  23 #include <stdlib.h>
  24 #include <errno.h>
  25 #include <math.h>
  26
  27 #include "config.h"
  28 #include "libavformat/avformat.h"
  29 #include "libavfilter/avfilter.h"
  30 #include "libavdevice/avdevice.h"
  31 #include "libswscale/swscale.h"
  32 #include "libpostproc/postprocess.h"
  33 #include "libavutil/avstring.h"
  34 #include "cmdutils.h"
  35 #include "version.h"
  36 #ifdef CONFIG_NETWORK
  37 #include "libavformat/network.h"
  38 #endif
  39
  40 #undef exit
  41
  42
  43 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
  44 {
  45     char *tail;
  46     const char *error;
  47     double d = strtod(numstr, &tail);
  48     if (*tail)
  49         error= "Expected number for %s but found: %s\n";
  50     else if (d < min || d > max)
  51         error= "The value for %s was %s which is not within %f - %f\n";
  52     else if(type == OPT_INT64 && (int64_t)d != d)
  53         error= "Expected int64 for %s but found %s\n";
  54     else
  55         return d;
  56     fprintf(stderr, error, context, numstr, min, max);
  57     exit(1);
  58 }
  59
  60 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
  61 {
  62     int64_t us = parse_date(timestr, is_duration);
  63     if (us == INT64_MIN) {
  64         fprintf(stderr, "Invalid %s specification for %s: %s\n",
  65                 is_duration ? "duration" : "date", context, timestr);
  66         exit(1);
  67     }
  68     return us;
  69 }
  70
  71 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
  72 {
  73     const OptionDef *po;
  74     int first;
  75
  76     first = 1;
  77     for(po = options; po->name != NULL; po++) {
  78         char buf[64];
  79         if ((po->flags & mask) == value) {
  80             if (first) {
  81                 printf("%s", msg);
  82                 first = 0;
  83             }
  84             av_strlcpy(buf, po->name, sizeof(buf));
  85             if (po->flags & HAS_ARG) {
  86                 av_strlcat(buf, " ", sizeof(buf));
  87                 av_strlcat(buf, po->argname, sizeof(buf));
  88             }
  89             printf("-%-17s  %s\n", buf, po->help);
  90         }
  91     }
  92 }
  93
  94 static const OptionDef* find_option(const OptionDef *po, const char *name){
  95     while (po->name != NULL) {
  96         if (!strcmp(name, po->name))
  97             break;
  98         po++;
  99     }
 100     return po;
 101 }
 102
 103 void parse_options(int argc, char **argv, const OptionDef *options,
 104                    void (* parse_arg_function)(const char*))
 105 {
 106     const char *opt, *arg;
 107     int optindex, handleoptions=1;
 108     const OptionDef *po;
 109
 110     /* parse options */
 111     optindex = 1;
 112     while (optindex < argc) {
 113         opt = argv[optindex++];
 114
 115         if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
 116           if (opt[1] == '-' && opt[2] == '\0') {
 117             handleoptions = 0;
 118             continue;
 119           }
 120             po= find_option(options, opt + 1);
 121             if (!po->name)
 122                 po= find_option(options, "default");
 123             if (!po->name) {
 124 unknown_opt:
 125                 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
 126                 exit(1);
 127             }
 128             arg = NULL;
 129             if (po->flags & HAS_ARG) {
 130                 arg = argv[optindex++];
 131                 if (!arg) {
 132                     fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
 133                     exit(1);
 134                 }
 135             }
 136             if (po->flags & OPT_STRING) {
 137                 char *str;
 138                 str = av_strdup(arg);
 139                 *po->u.str_arg = str;
 140             } else if (po->flags & OPT_BOOL) {
 141                 *po->u.int_arg = 1;
 142             } else if (po->flags & OPT_INT) {
 143                 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
 144             } else if (po->flags & OPT_INT64) {
 145                 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
 146             } else if (po->flags & OPT_FLOAT) {
 147                 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
 148             } else if (po->flags & OPT_FUNC2) {
 149                 if(po->u.func2_arg(opt+1, arg)<0)
 150                     goto unknown_opt;
 151             } else {
 152                 po->u.func_arg(arg);
 153             }
 154             if(po->flags & OPT_EXIT)
 155                 exit(0);
 156         } else {
 157             if (parse_arg_function)
 158                 parse_arg_function(opt);
 159         }
 160     }
 161 }
 162
 163 void print_error(const char *filename, int err)
 164 {
 165     switch(err) {
 166     case AVERROR_NUMEXPECTED:
 167         fprintf(stderr, "%s: Incorrect image filename syntax.\n"
 168                 "Use '%%d' to specify the image number:\n"
 169                 "  for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
 170                 "  for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
 171                 filename);
 172         break;
 173     case AVERROR_INVALIDDATA:
 174         fprintf(stderr, "%s: Error while parsing header\n", filename);
 175         break;
 176     case AVERROR_NOFMT:
 177         fprintf(stderr, "%s: Unknown format\n", filename);
 178         break;
 179     case AVERROR(EIO):
 180         fprintf(stderr, "%s: I/O error occurred\n"
 181                 "Usually that means that input file is truncated and/or corrupted.\n",
 182                 filename);
 183         break;
 184     case AVERROR(ENOMEM):
 185         fprintf(stderr, "%s: memory allocation error occurred\n", filename);
 186         break;
 187     case AVERROR(ENOENT):
 188         fprintf(stderr, "%s: no such file or directory\n", filename);
 189         break;
 190 #ifdef CONFIG_NETWORK
 191     case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
 192         fprintf(stderr, "%s: Unsupported network protocol\n", filename);
 193         break;
 194 #endif
 195     default:
 196         fprintf(stderr, "%s: Error while opening file\n", filename);
 197         break;
 198     }
 199 }
 200
 201 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
 202     version= libname##_version(); \
 203     fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? "  " : "", #libname, \
 204             LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
 205             version >> 16, version >> 8 & 0xff, version & 0xff);
 206
 207 void print_all_lib_versions(FILE* outstream, int indent)
 208 {
 209     unsigned int version;
 210     PRINT_LIB_VERSION(outstream, avutil,   AVUTIL,   indent);
 211     PRINT_LIB_VERSION(outstream, avcodec,  AVCODEC,  indent);
 212     PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
 213     PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
 214 #if ENABLE_AVFILTER
 215     PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
 216 #endif
 217 #if ENABLE_SWSCALE
 218     PRINT_LIB_VERSION(outstream, swscale,  SWSCALE,  indent);
 219 #endif
 220 #if ENABLE_POSTPROC
 221     PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
 222 #endif
 223 }
 224
 225 void show_banner(void)
 226 {
 227     fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
 228             program_name, program_birth_year);
 229     fprintf(stderr, "  configuration: " FFMPEG_CONFIGURATION "\n");
 230     print_all_lib_versions(stderr, 1);
 231     fprintf(stderr, "  built on " __DATE__ " " __TIME__);
 232 #ifdef __GNUC__
 233     fprintf(stderr, ", gcc: " __VERSION__ "\n");
 234 #else
 235     fprintf(stderr, ", using a non-gcc compiler\n");
 236 #endif
 237 }
 238
 239 void show_version(void) {
 240     printf("%s " FFMPEG_VERSION "\n", program_name);
 241     print_all_lib_versions(stdout, 0);
 242 }
 243
 244 void show_license(void)
 245 {
 246 #ifdef CONFIG_NONFREE
 247     printf(
 248     "This version of %s has nonfree parts compiled in.\n"
 249     "Therefore it is not legally redistributable.\n",
 250     program_name
 251     );
 252 #elif CONFIG_GPL
 253     printf(
 254     "%s is free software; you can redistribute it and/or modify\n"
 255     "it under the terms of the GNU General Public License as published by\n"
 256     "the Free Software Foundation; either version 2 of the License, or\n"
 257     "(at your option) any later version.\n"
 258     "\n"
 259     "%s is distributed in the hope that it will be useful,\n"
 260     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
 261     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
 262     "GNU General Public License for more details.\n"
 263     "\n"
 264     "You should have received a copy of the GNU General Public License\n"
 265     "along with %s; if not, write to the Free Software\n"
 266     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
 267     program_name, program_name, program_name
 268     );
 269 #else
 270     printf(
 271     "%s is free software; you can redistribute it and/or\n"
 272     "modify it under the terms of the GNU Lesser General Public\n"
 273     "License as published by the Free Software Foundation; either\n"
 274     "version 2.1 of the License, or (at your option) any later version.\n"
 275     "\n"
 276     "%s is distributed in the hope that it will be useful,\n"
 277     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
 278     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\n"
 279     "Lesser General Public License for more details.\n"
 280     "\n"
 281     "You should have received a copy of the GNU Lesser General Public\n"
 282     "License along with %s; if not, write to the Free Software\n"
 283     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
 284     program_name, program_name, program_name
 285     );
 286 #endif
 287 }
 288
 289 void show_formats(void)
 290 {
 291     AVInputFormat *ifmt=NULL;
 292     AVOutputFormat *ofmt=NULL;
 293     URLProtocol *up=NULL;
 294     AVCodec *p=NULL, *p2;
 295     AVBitStreamFilter *bsf=NULL;
 296     const char *last_name;
 297
 298     printf("File formats:\n");
 299     last_name= "000";
 300     for(;;){
 301         int decode=0;
 302         int encode=0;
 303         const char *name=NULL;
 304         const char *long_name=NULL;
 305
 306         while((ofmt= av_oformat_next(ofmt))) {
 307             if((name == NULL || strcmp(ofmt->name, name)<0) &&
 308                 strcmp(ofmt->name, last_name)>0){
 309                 name= ofmt->name;
 310                 long_name= ofmt->long_name;
 311                 encode=1;
 312             }
 313         }
 314         while((ifmt= av_iformat_next(ifmt))) {
 315             if((name == NULL || strcmp(ifmt->name, name)<0) &&
 316                 strcmp(ifmt->name, last_name)>0){
 317                 name= ifmt->name;
 318                 long_name= ifmt->long_name;
 319                 encode=0;
 320             }
 321             if(name && strcmp(ifmt->name, name)==0)
 322                 decode=1;
 323         }
 324         if(name==NULL)
 325             break;
 326         last_name= name;
 327
 328         printf(
 329             " %s%s %-15s %s\n",
 330             decode ? "D":" ",
 331             encode ? "E":" ",
 332             name,
 333             long_name ? long_name:" ");
 334     }
 335     printf("\n");
 336
 337     printf("Codecs:\n");
 338     last_name= "000";
 339     for(;;){
 340         int decode=0;
 341         int encode=0;
 342         int cap=0;
 343         const char *type_str;
 344
 345         p2=NULL;
 346         while((p= av_codec_next(p))) {
 347             if((p2==NULL || strcmp(p->name, p2->name)<0) &&
 348                 strcmp(p->name, last_name)>0){
 349                 p2= p;
 350                 decode= encode= cap=0;
 351             }
 352             if(p2 && strcmp(p->name, p2->name)==0){
 353                 if(p->decode) decode=1;
 354                 if(p->encode) encode=1;
 355                 cap |= p->capabilities;
 356             }
 357         }
 358         if(p2==NULL)
 359             break;
 360         last_name= p2->name;
 361
 362         switch(p2->type) {
 363         case CODEC_TYPE_VIDEO:
 364             type_str = "V";
 365             break;
 366         case CODEC_TYPE_AUDIO:
 367             type_str = "A";
 368             break;
 369         case CODEC_TYPE_SUBTITLE:
 370             type_str = "S";
 371             break;
 372         default:
 373             type_str = "?";
 374             break;
 375         }
 376         printf(
 377             " %s%s%s%s%s%s %-15s %s",
 378             decode ? "D": (/*p2->decoder ? "d":*/" "),
 379             encode ? "E":" ",
 380             type_str,
 381             cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
 382             cap & CODEC_CAP_DR1 ? "D":" ",
 383             cap & CODEC_CAP_TRUNCATED ? "T":" ",
 384             p2->name,
 385             p2->long_name ? p2->long_name : "");
 386        /* if(p2->decoder && decode==0)
 387             printf(" use %s for decoding", p2->decoder->name);*/
 388         printf("\n");
 389     }
 390     printf("\n");
 391
 392     printf("Bitstream filters:\n");
 393     while((bsf = av_bitstream_filter_next(bsf)))
 394         printf(" %s", bsf->name);
 395     printf("\n");
 396
 397     printf("Supported file protocols:\n");
 398     while((up = av_protocol_next(up)))
 399         printf(" %s:", up->name);
 400     printf("\n");
 401
 402     printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
 403     printf("\n");
 404     printf(
 405 "Note, the names of encoders and decoders do not always match, so there are\n"
 406 "several cases where the above table shows encoder only or decoder only entries\n"
 407 "even though both encoding and decoding are supported. For example, the h263\n"
 408 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
 409 "worse.\n");
 410 }