git.sesse.net Git - ffmpeg/blob - 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 <stdint.h>
  24 #include <stdlib.h>
  25 #include <errno.h>
  26 #include <math.h>
  27
  28 /* Include only the enabled headers since some compilers (namely, Sun
  29    Studio) will not omit unused inline functions and create undefined
  30    references to libraries that are not being built. */
  31
  32 #include "config.h"
  33 #include "compat/va_copy.h"
  34 #include "libavformat/avformat.h"
  35 #include "libavfilter/avfilter.h"
  36 #include "libavdevice/avdevice.h"
  37 #include "libavresample/avresample.h"
  38 #include "libswscale/swscale.h"
  39 #include "libswresample/swresample.h"
  40 #include "libpostproc/postprocess.h"
  41 #include "libavutil/avassert.h"
  42 #include "libavutil/avstring.h"
  43 #include "libavutil/bprint.h"
  44 #include "libavutil/display.h"
  45 #include "libavutil/mathematics.h"
  46 #include "libavutil/imgutils.h"
  47 #include "libavutil/libm.h"
  48 #include "libavutil/parseutils.h"
  49 #include "libavutil/pixdesc.h"
  50 #include "libavutil/eval.h"
  51 #include "libavutil/dict.h"
  52 #include "libavutil/opt.h"
  53 #include "libavutil/cpu.h"
  54 #include "libavutil/ffversion.h"
  55 #include "cmdutils.h"
  56 #if CONFIG_NETWORK
  57 #include "libavformat/network.h"
  58 #endif
  59 #if HAVE_SYS_RESOURCE_H
  60 #include <sys/time.h>
  61 #include <sys/resource.h>
  62 #endif
  63
  64 static int init_report(const char *env);
  65
  66 AVDictionary *sws_dict;
  67 AVDictionary *swr_opts;
  68 AVDictionary *format_opts, *codec_opts, *resample_opts;
  69
  70 static FILE *report_file;
  71 static int report_file_level = AV_LOG_DEBUG;
  72 int hide_banner = 0;
  73
  74 void init_opts(void)
  75 {
  76     av_dict_set(&sws_dict, "flags", "bicubic", 0);
  77 }
  78
  79 void uninit_opts(void)
  80 {
  81     av_dict_free(&swr_opts);
  82     av_dict_free(&sws_dict);
  83     av_dict_free(&format_opts);
  84     av_dict_free(&codec_opts);
  85     av_dict_free(&resample_opts);
  86 }
  87
  88 void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
  89 {
  90     vfprintf(stdout, fmt, vl);
  91 }
  92
  93 static void log_callback_report(void *ptr, int level, const char *fmt, va_list vl)
  94 {
  95     va_list vl2;
  96     char line[1024];
  97     static int print_prefix = 1;
  98
  99     va_copy(vl2, vl);
 100     av_log_default_callback(ptr, level, fmt, vl);
 101     av_log_format_line(ptr, level, fmt, vl2, line, sizeof(line), &print_prefix);
 102     va_end(vl2);
 103     if (report_file_level >= level) {
 104         fputs(line, report_file);
 105         fflush(report_file);
 106     }
 107 }
 108
 109 static void (*program_exit)(int ret);
 110
 111 void register_exit(void (*cb)(int ret))
 112 {
 113     program_exit = cb;
 114 }
 115
 116 void exit_program(int ret)
 117 {
 118     if (program_exit)
 119         program_exit(ret);
 120
 121     exit(ret);
 122 }
 123
 124 double parse_number_or_die(const char *context, const char *numstr, int type,
 125                            double min, double max)
 126 {
 127     char *tail;
 128     const char *error;
 129     double d = av_strtod(numstr, &tail);
 130     if (*tail)
 131         error = "Expected number for %s but found: %s\n";
 132     else if (d < min || d > max)
 133         error = "The value for %s was %s which is not within %f - %f\n";
 134     else if (type == OPT_INT64 && (int64_t)d != d)
 135         error = "Expected int64 for %s but found %s\n";
 136     else if (type == OPT_INT && (int)d != d)
 137         error = "Expected int for %s but found %s\n";
 138     else
 139         return d;
 140     av_log(NULL, AV_LOG_FATAL, error, context, numstr, min, max);
 141     exit_program(1);
 142     return 0;
 143 }
 144
 145 int64_t parse_time_or_die(const char *context, const char *timestr,
 146                           int is_duration)
 147 {
 148     int64_t us;
 149     if (av_parse_time(&us, timestr, is_duration) < 0) {
 150         av_log(NULL, AV_LOG_FATAL, "Invalid %s specification for %s: %s\n",
 151                is_duration ? "duration" : "date", context, timestr);
 152         exit_program(1);
 153     }
 154     return us;
 155 }
 156
 157 void show_help_options(const OptionDef *options, const char *msg, int req_flags,
 158                        int rej_flags, int alt_flags)
 159 {
 160     const OptionDef *po;
 161     int first;
 162
 163     first = 1;
 164     for (po = options; po->name; po++) {
 165         char buf[64];
 166
 167         if (((po->flags & req_flags) != req_flags) ||
 168             (alt_flags && !(po->flags & alt_flags)) ||
 169             (po->flags & rej_flags))
 170             continue;
 171
 172         if (first) {
 173             printf("%s\n", msg);
 174             first = 0;
 175         }
 176         av_strlcpy(buf, po->name, sizeof(buf));
 177         if (po->argname) {
 178             av_strlcat(buf, " ", sizeof(buf));
 179             av_strlcat(buf, po->argname, sizeof(buf));
 180         }
 181         printf("-%-17s  %s\n", buf, po->help);
 182     }
 183     printf("\n");
 184 }
 185
 186 void show_help_children(const AVClass *class, int flags)
 187 {
 188     const AVClass *child = NULL;
 189     if (class->option) {
 190         av_opt_show2(&class, NULL, flags, 0);
 191         printf("\n");
 192     }
 193
 194     while (child = av_opt_child_class_next(class, child))
 195         show_help_children(child, flags);
 196 }
 197
 198 static const OptionDef *find_option(const OptionDef *po, const char *name)
 199 {
 200     const char *p = strchr(name, ':');
 201     int len = p ? p - name : strlen(name);
 202
 203     while (po->name) {
 204         if (!strncmp(name, po->name, len) && strlen(po->name) == len)
 205             break;
 206         po++;
 207     }
 208     return po;
 209 }
 210
 211 /* _WIN32 means using the windows libc - cygwin doesn't define that
 212  * by default. HAVE_COMMANDLINETOARGVW is true on cygwin, while
 213  * it doesn't provide the actual command line via GetCommandLineW(). */
 214 #if HAVE_COMMANDLINETOARGVW && defined(_WIN32)
 215 #include <windows.h>
 216 #include <shellapi.h>
 217 /* Will be leaked on exit */
 218 static char** win32_argv_utf8 = NULL;
 219 static int win32_argc = 0;
 220
 221 /**
 222  * Prepare command line arguments for executable.
 223  * For Windows - perform wide-char to UTF-8 conversion.
 224  * Input arguments should be main() function arguments.
 225  * @param argc_ptr Arguments number (including executable)
 226  * @param argv_ptr Arguments list.
 227  */
 228 static void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
 229 {
 230     char *argstr_flat;
 231     wchar_t **argv_w;
 232     int i, buffsize = 0, offset = 0;
 233
 234     if (win32_argv_utf8) {
 235         *argc_ptr = win32_argc;
 236         *argv_ptr = win32_argv_utf8;
 237         return;
 238     }
 239
 240     win32_argc = 0;
 241     argv_w = CommandLineToArgvW(GetCommandLineW(), &win32_argc);
 242     if (win32_argc <= 0 || !argv_w)
 243         return;
 244
 245     /* determine the UTF-8 buffer size (including NULL-termination symbols) */
 246     for (i = 0; i < win32_argc; i++)
 247         buffsize += WideCharToMultiByte(CP_UTF8, 0, argv_w[i], -1,
 248                                         NULL, 0, NULL, NULL);
 249
 250     win32_argv_utf8 = av_mallocz(sizeof(char *) * (win32_argc + 1) + buffsize);
 251     argstr_flat     = (char *)win32_argv_utf8 + sizeof(char *) * (win32_argc + 1);
 252     if (!win32_argv_utf8) {
 253         LocalFree(argv_w);
 254         return;
 255     }
 256
 257     for (i = 0; i < win32_argc; i++) {
 258         win32_argv_utf8[i] = &argstr_flat[offset];
 259         offset += WideCharToMultiByte(CP_UTF8, 0, argv_w[i], -1,
 260                                       &argstr_flat[offset],
 261                                       buffsize - offset, NULL, NULL);
 262     }
 263     win32_argv_utf8[i] = NULL;
 264     LocalFree(argv_w);
 265
 266     *argc_ptr = win32_argc;
 267     *argv_ptr = win32_argv_utf8;
 268 }
 269 #else
 270 static inline void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
 271 {
 272     /* nothing to do */
 273 }
 274 #endif /* HAVE_COMMANDLINETOARGVW */
 275
 276 static int write_option(void *optctx, const OptionDef *po, const char *opt,
 277                         const char *arg)
 278 {
 279     /* new-style options contain an offset into optctx, old-style address of
 280      * a global var*/
 281     void *dst = po->flags & (OPT_OFFSET | OPT_SPEC) ?
 282                 (uint8_t *)optctx + po->u.off : po->u.dst_ptr;
 283     int *dstcount;
 284
 285     if (po->flags & OPT_SPEC) {
 286         SpecifierOpt **so = dst;
 287         char *p = strchr(opt, ':');
 288         char *str;
 289
 290         dstcount = (int *)(so + 1);
 291         *so = grow_array(*so, sizeof(**so), dstcount, *dstcount + 1);
 292         str = av_strdup(p ? p + 1 : "");
 293         if (!str)
 294             return AVERROR(ENOMEM);
 295         (*so)[*dstcount - 1].specifier = str;
 296         dst = &(*so)[*dstcount - 1].u;
 297     }
 298
 299     if (po->flags & OPT_STRING) {
 300         char *str;
 301         str = av_strdup(arg);
 302         av_freep(dst);
 303         if (!str)
 304             return AVERROR(ENOMEM);
 305         *(char **)dst = str;
 306     } else if (po->flags & OPT_BOOL || po->flags & OPT_INT) {
 307         *(int *)dst = parse_number_or_die(opt, arg, OPT_INT64, INT_MIN, INT_MAX);
 308     } else if (po->flags & OPT_INT64) {
 309         *(int64_t *)dst = parse_number_or_die(opt, arg, OPT_INT64, INT64_MIN, INT64_MAX);
 310     } else if (po->flags & OPT_TIME) {
 311         *(int64_t *)dst = parse_time_or_die(opt, arg, 1);
 312     } else if (po->flags & OPT_FLOAT) {
 313         *(float *)dst = parse_number_or_die(opt, arg, OPT_FLOAT, -INFINITY, INFINITY);
 314     } else if (po->flags & OPT_DOUBLE) {
 315         *(double *)dst = parse_number_or_die(opt, arg, OPT_DOUBLE, -INFINITY, INFINITY);
 316     } else if (po->u.func_arg) {
 317         int ret = po->u.func_arg(optctx, opt, arg);
 318         if (ret < 0) {
 319             av_log(NULL, AV_LOG_ERROR,
 320                    "Failed to set value '%s' for option '%s': %s\n",
 321                    arg, opt, av_err2str(ret));
 322             return ret;
 323         }
 324     }
 325     if (po->flags & OPT_EXIT)
 326         exit_program(0);
 327
 328     return 0;
 329 }
 330
 331 int parse_option(void *optctx, const char *opt, const char *arg,
 332                  const OptionDef *options)
 333 {
 334     const OptionDef *po;
 335     int ret;
 336
 337     po = find_option(options, opt);
 338     if (!po->name && opt[0] == 'n' && opt[1] == 'o') {
 339         /* handle 'no' bool option */
 340         po = find_option(options, opt + 2);
 341         if ((po->name && (po->flags & OPT_BOOL)))
 342             arg = "0";
 343     } else if (po->flags & OPT_BOOL)
 344         arg = "1";
 345
 346     if (!po->name)
 347         po = find_option(options, "default");
 348     if (!po->name) {
 349         av_log(NULL, AV_LOG_ERROR, "Unrecognized option '%s'\n", opt);
 350         return AVERROR(EINVAL);
 351     }
 352     if (po->flags & HAS_ARG && !arg) {
 353         av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'\n", opt);
 354         return AVERROR(EINVAL);
 355     }
 356
 357     ret = write_option(optctx, po, opt, arg);
 358     if (ret < 0)
 359         return ret;
 360
 361     return !!(po->flags & HAS_ARG);
 362 }
 363
 364 void parse_options(void *optctx, int argc, char **argv, const OptionDef *options,
 365                    void (*parse_arg_function)(void *, const char*))
 366 {
 367     const char *opt;
 368     int optindex, handleoptions = 1, ret;
 369
 370     /* perform system-dependent conversions for arguments list */
 371     prepare_app_arguments(&argc, &argv);
 372
 373     /* parse options */
 374     optindex = 1;
 375     while (optindex < argc) {
 376         opt = argv[optindex++];
 377
 378         if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
 379             if (opt[1] == '-' && opt[2] == '\0') {
 380                 handleoptions = 0;
 381                 continue;
 382             }
 383             opt++;
 384
 385             if ((ret = parse_option(optctx, opt, argv[optindex], options)) < 0)
 386                 exit_program(1);
 387             optindex += ret;
 388         } else {
 389             if (parse_arg_function)
 390                 parse_arg_function(optctx, opt);
 391         }
 392     }
 393 }
 394
 395 int parse_optgroup(void *optctx, OptionGroup *g)
 396 {
 397     int i, ret;
 398
 399     av_log(NULL, AV_LOG_DEBUG, "Parsing a group of options: %s %s.\n",
 400            g->group_def->name, g->arg);
 401
 402     for (i = 0; i < g->nb_opts; i++) {
 403         Option *o = &g->opts[i];
 404
 405         if (g->group_def->flags &&
 406             !(g->group_def->flags & o->opt->flags)) {
 407             av_log(NULL, AV_LOG_ERROR, "Option %s (%s) cannot be applied to "
 408                    "%s %s -- you are trying to apply an input option to an "
 409                    "output file or vice versa. Move this option before the "
 410                    "file it belongs to.\n", o->key, o->opt->help,
 411                    g->group_def->name, g->arg);
 412             return AVERROR(EINVAL);
 413         }
 414
 415         av_log(NULL, AV_LOG_DEBUG, "Applying option %s (%s) with argument %s.\n",
 416                o->key, o->opt->help, o->val);
 417
 418         ret = write_option(optctx, o->opt, o->key, o->val);
 419         if (ret < 0)
 420             return ret;
 421     }
 422
 423     av_log(NULL, AV_LOG_DEBUG, "Successfully parsed a group of options.\n");
 424
 425     return 0;
 426 }
 427
 428 int locate_option(int argc, char **argv, const OptionDef *options,
 429                   const char *optname)
 430 {
 431     const OptionDef *po;
 432     int i;
 433
 434     for (i = 1; i < argc; i++) {
 435         const char *cur_opt = argv[i];
 436
 437         if (*cur_opt++ != '-')
 438             continue;
 439
 440         po = find_option(options, cur_opt);
 441         if (!po->name && cur_opt[0] == 'n' && cur_opt[1] == 'o')
 442             po = find_option(options, cur_opt + 2);
 443
 444         if ((!po->name && !strcmp(cur_opt, optname)) ||
 445              (po->name && !strcmp(optname, po->name)))
 446             return i;
 447
 448         if (!po->name || po->flags & HAS_ARG)
 449             i++;
 450     }
 451     return 0;
 452 }
 453
 454 static void dump_argument(const char *a)
 455 {
 456     const unsigned char *p;
 457
 458     for (p = a; *p; p++)
 459         if (!((*p >= '+' && *p <= ':') || (*p >= '@' && *p <= 'Z') ||
 460               *p == '_' || (*p >= 'a' && *p <= 'z')))
 461             break;
 462     if (!*p) {
 463         fputs(a, report_file);
 464         return;
 465     }
 466     fputc('"', report_file);
 467     for (p = a; *p; p++) {
 468         if (*p == '\\' || *p == '"' || *p == '$' || *p == '`')
 469             fprintf(report_file, "\\%c", *p);
 470         else if (*p < ' ' || *p > '~')
 471             fprintf(report_file, "\\x%02x", *p);
 472         else
 473             fputc(*p, report_file);
 474     }
 475     fputc('"', report_file);
 476 }
 477
 478 static void check_options(const OptionDef *po)
 479 {
 480     while (po->name) {
 481         if (po->flags & OPT_PERFILE)
 482             av_assert0(po->flags & (OPT_INPUT | OPT_OUTPUT));
 483         po++;
 484     }
 485 }
 486
 487 void parse_loglevel(int argc, char **argv, const OptionDef *options)
 488 {
 489     int idx = locate_option(argc, argv, options, "loglevel");
 490     const char *env;
 491
 492     check_options(options);
 493
 494     if (!idx)
 495         idx = locate_option(argc, argv, options, "v");
 496     if (idx && argv[idx + 1])
 497         opt_loglevel(NULL, "loglevel", argv[idx + 1]);
 498     idx = locate_option(argc, argv, options, "report");
 499     if ((env = getenv("FFREPORT")) || idx) {
 500         init_report(env);
 501         if (report_file) {
 502             int i;
 503             fprintf(report_file, "Command line:\n");
 504             for (i = 0; i < argc; i++) {
 505                 dump_argument(argv[i]);
 506                 fputc(i < argc - 1 ? ' ' : '\n', report_file);
 507             }
 508             fflush(report_file);
 509         }
 510     }
 511     idx = locate_option(argc, argv, options, "hide_banner");
 512     if (idx)
 513         hide_banner = 1;
 514 }
 515
 516 static const AVOption *opt_find(void *obj, const char *name, const char *unit,
 517                             int opt_flags, int search_flags)
 518 {
 519     const AVOption *o = av_opt_find(obj, name, unit, opt_flags, search_flags);
 520     if(o && !o->flags)
 521         return NULL;
 522     return o;
 523 }
 524
 525 #define FLAGS (o->type == AV_OPT_TYPE_FLAGS && (arg[0]=='-' || arg[0]=='+')) ? AV_DICT_APPEND : 0
 526 int opt_default(void *optctx, const char *opt, const char *arg)
 527 {
 528     const AVOption *o;
 529     int consumed = 0;
 530     char opt_stripped[128];
 531     const char *p;
 532     const AVClass *cc = avcodec_get_class(), *fc = avformat_get_class();
 533 #if CONFIG_AVRESAMPLE
 534     const AVClass *rc = avresample_get_class();
 535 #endif
 536 #if CONFIG_SWSCALE
 537     const AVClass *sc = sws_get_class();
 538 #endif
 539 #if CONFIG_SWRESAMPLE
 540     const AVClass *swr_class = swr_get_class();
 541 #endif
 542
 543     if (!strcmp(opt, "debug") || !strcmp(opt, "fdebug"))
 544         av_log_set_level(AV_LOG_DEBUG);
 545
 546     if (!(p = strchr(opt, ':')))
 547         p = opt + strlen(opt);
 548     av_strlcpy(opt_stripped, opt, FFMIN(sizeof(opt_stripped), p - opt + 1));
 549
 550     if ((o = opt_find(&cc, opt_stripped, NULL, 0,
 551                          AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ)) ||
 552         ((opt[0] == 'v' || opt[0] == 'a' || opt[0] == 's') &&
 553          (o = opt_find(&cc, opt + 1, NULL, 0, AV_OPT_SEARCH_FAKE_OBJ)))) {
 554         av_dict_set(&codec_opts, opt, arg, FLAGS);
 555         consumed = 1;
 556     }
 557     if ((o = opt_find(&fc, opt, NULL, 0,
 558                          AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
 559         av_dict_set(&format_opts, opt, arg, FLAGS);
 560         if (consumed)
 561             av_log(NULL, AV_LOG_VERBOSE, "Routing option %s to both codec and muxer layer\n", opt);
 562         consumed = 1;
 563     }
 564 #if CONFIG_SWSCALE
 565     if (!consumed && (o = opt_find(&sc, opt, NULL, 0,
 566                          AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
 567         struct SwsContext *sws = sws_alloc_context();
 568         int ret = av_opt_set(sws, opt, arg, 0);
 569         sws_freeContext(sws);
 570         if (!strcmp(opt, "srcw") || !strcmp(opt, "srch") ||
 571             !strcmp(opt, "dstw") || !strcmp(opt, "dsth") ||
 572             !strcmp(opt, "src_format") || !strcmp(opt, "dst_format")) {
 573             av_log(NULL, AV_LOG_ERROR, "Directly using swscale dimensions/format options is not supported, please use the -s or -pix_fmt options\n");
 574             return AVERROR(EINVAL);
 575         }
 576         if (ret < 0) {
 577             av_log(NULL, AV_LOG_ERROR, "Error setting option %s.\n", opt);
 578             return ret;
 579         }
 580
 581         av_dict_set(&sws_dict, opt, arg, FLAGS);
 582
 583         consumed = 1;
 584     }
 585 #else
 586     if (!consumed && !strcmp(opt, "sws_flags")) {
 587         av_log(NULL, AV_LOG_WARNING, "Ignoring %s %s, due to disabled swscale\n", opt, arg);
 588         consumed = 1;
 589     }
 590 #endif
 591 #if CONFIG_SWRESAMPLE
 592     if (!consumed && (o=opt_find(&swr_class, opt, NULL, 0,
 593                                     AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
 594         struct SwrContext *swr = swr_alloc();
 595         int ret = av_opt_set(swr, opt, arg, 0);
 596         swr_free(&swr);
 597         if (ret < 0) {
 598             av_log(NULL, AV_LOG_ERROR, "Error setting option %s.\n", opt);
 599             return ret;
 600         }
 601         av_dict_set(&swr_opts, opt, arg, FLAGS);
 602         consumed = 1;
 603     }
 604 #endif
 605 #if CONFIG_AVRESAMPLE
 606     if ((o=opt_find(&rc, opt, NULL, 0,
 607                        AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
 608         av_dict_set(&resample_opts, opt, arg, FLAGS);
 609         consumed = 1;
 610     }
 611 #endif
 612
 613     if (consumed)
 614         return 0;
 615     return AVERROR_OPTION_NOT_FOUND;
 616 }
 617
 618 /*
 619  * Check whether given option is a group separator.
 620  *
 621  * @return index of the group definition that matched or -1 if none
 622  */
 623 static int match_group_separator(const OptionGroupDef *groups, int nb_groups,
 624                                  const char *opt)
 625 {
 626     int i;
 627
 628     for (i = 0; i < nb_groups; i++) {
 629         const OptionGroupDef *p = &groups[i];
 630         if (p->sep && !strcmp(p->sep, opt))
 631             return i;
 632     }
 633
 634     return -1;
 635 }
 636
 637 /*
 638  * Finish parsing an option group.
 639  *
 640  * @param group_idx which group definition should this group belong to
 641  * @param arg argument of the group delimiting option
 642  */
 643 static void finish_group(OptionParseContext *octx, int group_idx,
 644                          const char *arg)
 645 {
 646     OptionGroupList *l = &octx->groups[group_idx];
 647     OptionGroup *g;
 648
 649     GROW_ARRAY(l->groups, l->nb_groups);
 650     g = &l->groups[l->nb_groups - 1];
 651
 652     *g             = octx->cur_group;
 653     g->arg         = arg;
 654     g->group_def   = l->group_def;
 655     g->sws_dict    = sws_dict;
 656     g->swr_opts    = swr_opts;
 657     g->codec_opts  = codec_opts;
 658     g->format_opts = format_opts;
 659     g->resample_opts = resample_opts;
 660
 661     codec_opts  = NULL;
 662     format_opts = NULL;
 663     resample_opts = NULL;
 664     sws_dict    = NULL;
 665     swr_opts    = NULL;
 666     init_opts();
 667
 668     memset(&octx->cur_group, 0, sizeof(octx->cur_group));
 669 }
 670
 671 /*
 672  * Add an option instance to currently parsed group.
 673  */
 674 static void add_opt(OptionParseContext *octx, const OptionDef *opt,
 675                     const char *key, const char *val)
 676 {
 677     int global = !(opt->flags & (OPT_PERFILE | OPT_SPEC | OPT_OFFSET));
 678     OptionGroup *g = global ? &octx->global_opts : &octx->cur_group;
 679
 680     GROW_ARRAY(g->opts, g->nb_opts);
 681     g->opts[g->nb_opts - 1].opt = opt;
 682     g->opts[g->nb_opts - 1].key = key;
 683     g->opts[g->nb_opts - 1].val = val;
 684 }
 685
 686 static void init_parse_context(OptionParseContext *octx,
 687                                const OptionGroupDef *groups, int nb_groups)
 688 {
 689     static const OptionGroupDef global_group = { "global" };
 690     int i;
 691
 692     memset(octx, 0, sizeof(*octx));
 693
 694     octx->nb_groups = nb_groups;
 695     octx->groups    = av_mallocz_array(octx->nb_groups, sizeof(*octx->groups));
 696     if (!octx->groups)
 697         exit_program(1);
 698
 699     for (i = 0; i < octx->nb_groups; i++)
 700         octx->groups[i].group_def = &groups[i];
 701
 702     octx->global_opts.group_def = &global_group;
 703     octx->global_opts.arg       = "";
 704
 705     init_opts();
 706 }
 707
 708 void uninit_parse_context(OptionParseContext *octx)
 709 {
 710     int i, j;
 711
 712     for (i = 0; i < octx->nb_groups; i++) {
 713         OptionGroupList *l = &octx->groups[i];
 714
 715         for (j = 0; j < l->nb_groups; j++) {
 716             av_freep(&l->groups[j].opts);
 717             av_dict_free(&l->groups[j].codec_opts);
 718             av_dict_free(&l->groups[j].format_opts);
 719             av_dict_free(&l->groups[j].resample_opts);
 720
 721             av_dict_free(&l->groups[j].sws_dict);
 722             av_dict_free(&l->groups[j].swr_opts);
 723         }
 724         av_freep(&l->groups);
 725     }
 726     av_freep(&octx->groups);
 727
 728     av_freep(&octx->cur_group.opts);
 729     av_freep(&octx->global_opts.opts);
 730
 731     uninit_opts();
 732 }
 733
 734 int split_commandline(OptionParseContext *octx, int argc, char *argv[],
 735                       const OptionDef *options,
 736                       const OptionGroupDef *groups, int nb_groups)
 737 {
 738     int optindex = 1;
 739     int dashdash = -2;
 740
 741     /* perform system-dependent conversions for arguments list */
 742     prepare_app_arguments(&argc, &argv);
 743
 744     init_parse_context(octx, groups, nb_groups);
 745     av_log(NULL, AV_LOG_DEBUG, "Splitting the commandline.\n");
 746
 747     while (optindex < argc) {
 748         const char *opt = argv[optindex++], *arg;
 749         const OptionDef *po;
 750         int ret;
 751
 752         av_log(NULL, AV_LOG_DEBUG, "Reading option '%s' ...", opt);
 753
 754         if (opt[0] == '-' && opt[1] == '-' && !opt[2]) {
 755             dashdash = optindex;
 756             continue;
 757         }
 758         /* unnamed group separators, e.g. output filename */
 759         if (opt[0] != '-' || !opt[1] || dashdash+1 == optindex) {
 760             finish_group(octx, 0, opt);
 761             av_log(NULL, AV_LOG_DEBUG, " matched as %s.\n", groups[0].name);
 762             continue;
 763         }
 764         opt++;
 765
 766 #define GET_ARG(arg)                                                           \
 767 do {                                                                           \
 768     arg = argv[optindex++];                                                    \
 769     if (!arg) {                                                                \
 770         av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'.\n", opt);\
 771         return AVERROR(EINVAL);                                                \
 772     }                                                                          \
 773 } while (0)
 774
 775         /* named group separators, e.g. -i */
 776         if ((ret = match_group_separator(groups, nb_groups, opt)) >= 0) {
 777             GET_ARG(arg);
 778             finish_group(octx, ret, arg);
 779             av_log(NULL, AV_LOG_DEBUG, " matched as %s with argument '%s'.\n",
 780                    groups[ret].name, arg);
 781             continue;
 782         }
 783
 784         /* normal options */
 785         po = find_option(options, opt);
 786         if (po->name) {
 787             if (po->flags & OPT_EXIT) {
 788                 /* optional argument, e.g. -h */
 789                 arg = argv[optindex++];
 790             } else if (po->flags & HAS_ARG) {
 791                 GET_ARG(arg);
 792             } else {
 793                 arg = "1";
 794             }
 795
 796             add_opt(octx, po, opt, arg);
 797             av_log(NULL, AV_LOG_DEBUG, " matched as option '%s' (%s) with "
 798                    "argument '%s'.\n", po->name, po->help, arg);
 799             continue;
 800         }
 801
 802         /* AVOptions */
 803         if (argv[optindex]) {
 804             ret = opt_default(NULL, opt, argv[optindex]);
 805             if (ret >= 0) {
 806                 av_log(NULL, AV_LOG_DEBUG, " matched as AVOption '%s' with "
 807                        "argument '%s'.\n", opt, argv[optindex]);
 808                 optindex++;
 809                 continue;
 810             } else if (ret != AVERROR_OPTION_NOT_FOUND) {
 811                 av_log(NULL, AV_LOG_ERROR, "Error parsing option '%s' "
 812                        "with argument '%s'.\n", opt, argv[optindex]);
 813                 return ret;
 814             }
 815         }
 816
 817         /* boolean -nofoo options */
 818         if (opt[0] == 'n' && opt[1] == 'o' &&
 819             (po = find_option(options, opt + 2)) &&
 820             po->name && po->flags & OPT_BOOL) {
 821             add_opt(octx, po, opt, "0");
 822             av_log(NULL, AV_LOG_DEBUG, " matched as option '%s' (%s) with "
 823                    "argument 0.\n", po->name, po->help);
 824             continue;
 825         }
 826
 827         av_log(NULL, AV_LOG_ERROR, "Unrecognized option '%s'.\n", opt);
 828         return AVERROR_OPTION_NOT_FOUND;
 829     }
 830
 831     if (octx->cur_group.nb_opts || codec_opts || format_opts || resample_opts)
 832         av_log(NULL, AV_LOG_WARNING, "Trailing options were found on the "
 833                "commandline.\n");
 834
 835     av_log(NULL, AV_LOG_DEBUG, "Finished splitting the commandline.\n");
 836
 837     return 0;
 838 }
 839
 840 int opt_cpuflags(void *optctx, const char *opt, const char *arg)
 841 {
 842     int ret;
 843     unsigned flags = av_get_cpu_flags();
 844
 845     if ((ret = av_parse_cpu_caps(&flags, arg)) < 0)
 846         return ret;
 847
 848     av_force_cpu_flags(flags);
 849     return 0;
 850 }
 851
 852 int opt_loglevel(void *optctx, const char *opt, const char *arg)
 853 {
 854     const struct { const char *name; int level; } log_levels[] = {
 855         { "quiet"  , AV_LOG_QUIET   },
 856         { "panic"  , AV_LOG_PANIC   },
 857         { "fatal"  , AV_LOG_FATAL   },
 858         { "error"  , AV_LOG_ERROR   },
 859         { "warning", AV_LOG_WARNING },
 860         { "info"   , AV_LOG_INFO    },
 861         { "verbose", AV_LOG_VERBOSE },
 862         { "debug"  , AV_LOG_DEBUG   },
 863         { "trace"  , AV_LOG_TRACE   },
 864     };
 865     char *tail;
 866     int level;
 867     int flags;
 868     int i;
 869
 870     flags = av_log_get_flags();
 871     tail = strstr(arg, "repeat");
 872     if (tail)
 873         flags &= ~AV_LOG_SKIP_REPEATED;
 874     else
 875         flags |= AV_LOG_SKIP_REPEATED;
 876
 877     av_log_set_flags(flags);
 878     if (tail == arg)
 879         arg += 6 + (arg[6]=='+');
 880     if(tail && !*arg)
 881         return 0;
 882
 883     for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
 884         if (!strcmp(log_levels[i].name, arg)) {
 885             av_log_set_level(log_levels[i].level);
 886             return 0;
 887         }
 888     }
 889
 890     level = strtol(arg, &tail, 10);
 891     if (*tail) {
 892         av_log(NULL, AV_LOG_FATAL, "Invalid loglevel \"%s\". "
 893                "Possible levels are numbers or:\n", arg);
 894         for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
 895             av_log(NULL, AV_LOG_FATAL, "\"%s\"\n", log_levels[i].name);
 896         exit_program(1);
 897     }
 898     av_log_set_level(level);
 899     return 0;
 900 }
 901
 902 static void expand_filename_template(AVBPrint *bp, const char *template,
 903                                      struct tm *tm)
 904 {
 905     int c;
 906
 907     while ((c = *(template++))) {
 908         if (c == '%') {
 909             if (!(c = *(template++)))
 910                 break;
 911             switch (c) {
 912             case 'p':
 913                 av_bprintf(bp, "%s", program_name);
 914                 break;
 915             case 't':
 916                 av_bprintf(bp, "%04d%02d%02d-%02d%02d%02d",
 917                            tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday,
 918                            tm->tm_hour, tm->tm_min, tm->tm_sec);
 919                 break;
 920             case '%':
 921                 av_bprint_chars(bp, c, 1);
 922                 break;
 923             }
 924         } else {
 925             av_bprint_chars(bp, c, 1);
 926         }
 927     }
 928 }
 929
 930 static int init_report(const char *env)
 931 {
 932     char *filename_template = NULL;
 933     char *key, *val;
 934     int ret, count = 0;
 935     time_t now;
 936     struct tm *tm;
 937     AVBPrint filename;
 938
 939     if (report_file) /* already opened */
 940         return 0;
 941     time(&now);
 942     tm = localtime(&now);
 943
 944     while (env && *env) {
 945         if ((ret = av_opt_get_key_value(&env, "=", ":", 0, &key, &val)) < 0) {
 946             if (count)
 947                 av_log(NULL, AV_LOG_ERROR,
 948                        "Failed to parse FFREPORT environment variable: %s\n",
 949                        av_err2str(ret));
 950             break;
 951         }
 952         if (*env)
 953             env++;
 954         count++;
 955         if (!strcmp(key, "file")) {
 956             av_free(filename_template);
 957             filename_template = val;
 958             val = NULL;
 959         } else if (!strcmp(key, "level")) {
 960             char *tail;
 961             report_file_level = strtol(val, &tail, 10);
 962             if (*tail) {
 963                 av_log(NULL, AV_LOG_FATAL, "Invalid report file level\n");
 964                 exit_program(1);
 965             }
 966         } else {
 967             av_log(NULL, AV_LOG_ERROR, "Unknown key '%s' in FFREPORT\n", key);
 968         }
 969         av_free(val);
 970         av_free(key);
 971     }
 972
 973     av_bprint_init(&filename, 0, 1);
 974     expand_filename_template(&filename,
 975                              av_x_if_null(filename_template, "%p-%t.log"), tm);
 976     av_free(filename_template);
 977     if (!av_bprint_is_complete(&filename)) {
 978         av_log(NULL, AV_LOG_ERROR, "Out of memory building report file name\n");
 979         return AVERROR(ENOMEM);
 980     }
 981
 982     report_file = fopen(filename.str, "w");
 983     if (!report_file) {
 984         int ret = AVERROR(errno);
 985         av_log(NULL, AV_LOG_ERROR, "Failed to open report \"%s\": %s\n",
 986                filename.str, strerror(errno));
 987         return ret;
 988     }
 989     av_log_set_callback(log_callback_report);
 990     av_log(NULL, AV_LOG_INFO,
 991            "%s started on %04d-%02d-%02d at %02d:%02d:%02d\n"
 992            "Report written to \"%s\"\n",
 993            program_name,
 994            tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday,
 995            tm->tm_hour, tm->tm_min, tm->tm_sec,
 996            filename.str);
 997     av_bprint_finalize(&filename, NULL);
 998     return 0;
 999 }
1000
1001 int opt_report(const char *opt)
1002 {
1003     return init_report(NULL);
1004 }
1005
1006 int opt_max_alloc(void *optctx, const char *opt, const char *arg)
1007 {
1008     char *tail;
1009     size_t max;
1010
1011     max = strtol(arg, &tail, 10);
1012     if (*tail) {
1013         av_log(NULL, AV_LOG_FATAL, "Invalid max_alloc \"%s\".\n", arg);
1014         exit_program(1);
1015     }
1016     av_max_alloc(max);
1017     return 0;
1018 }
1019
1020 int opt_timelimit(void *optctx, const char *opt, const char *arg)
1021 {
1022 #if HAVE_SETRLIMIT
1023     int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
1024     struct rlimit rl = { lim, lim + 1 };
1025     if (setrlimit(RLIMIT_CPU, &rl))
1026         perror("setrlimit");
1027 #else
1028     av_log(NULL, AV_LOG_WARNING, "-%s not implemented on this OS\n", opt);
1029 #endif
1030     return 0;
1031 }
1032
1033 void print_error(const char *filename, int err)
1034 {
1035     char errbuf[128];
1036     const char *errbuf_ptr = errbuf;
1037
1038     if (av_strerror(err, errbuf, sizeof(errbuf)) < 0)
1039         errbuf_ptr = strerror(AVUNERROR(err));
1040     av_log(NULL, AV_LOG_ERROR, "%s: %s\n", filename, errbuf_ptr);
1041 }
1042
1043 static int warned_cfg = 0;
1044
1045 #define INDENT        1
1046 #define SHOW_VERSION  2
1047 #define SHOW_CONFIG   4
1048 #define SHOW_COPYRIGHT 8
1049
1050 #define PRINT_LIB_INFO(libname, LIBNAME, flags, level)                  \
1051     if (CONFIG_##LIBNAME) {                                             \
1052         const char *indent = flags & INDENT? "  " : "";                 \
1053         if (flags & SHOW_VERSION) {                                     \
1054             unsigned int version = libname##_version();                 \
1055             av_log(NULL, level,                                         \
1056                    "%slib%-11s %2d.%3d.%3d / %2d.%3d.%3d\n",            \
1057                    indent, #libname,                                    \
1058                    LIB##LIBNAME##_VERSION_MAJOR,                        \
1059                    LIB##LIBNAME##_VERSION_MINOR,                        \
1060                    LIB##LIBNAME##_VERSION_MICRO,                        \
1061                    version >> 16, version >> 8 & 0xff, version & 0xff); \
1062         }                                                               \
1063         if (flags & SHOW_CONFIG) {                                      \
1064             const char *cfg = libname##_configuration();                \
1065             if (strcmp(FFMPEG_CONFIGURATION, cfg)) {                    \
1066                 if (!warned_cfg) {                                      \
1067                     av_log(NULL, level,                                 \
1068                             "%sWARNING: library configuration mismatch\n", \
1069                             indent);                                    \
1070                     warned_cfg = 1;                                     \
1071                 }                                                       \
1072                 av_log(NULL, level, "%s%-11s configuration: %s\n",      \
1073                         indent, #libname, cfg);                         \
1074             }                                                           \
1075         }                                                               \
1076     }                                                                   \
1077
1078 static void print_all_libs_info(int flags, int level)
1079 {
1080     PRINT_LIB_INFO(avutil,   AVUTIL,   flags, level);
1081     PRINT_LIB_INFO(avcodec,  AVCODEC,  flags, level);
1082     PRINT_LIB_INFO(avformat, AVFORMAT, flags, level);
1083     PRINT_LIB_INFO(avdevice, AVDEVICE, flags, level);
1084     PRINT_LIB_INFO(avfilter, AVFILTER, flags, level);
1085     PRINT_LIB_INFO(avresample, AVRESAMPLE, flags, level);
1086     PRINT_LIB_INFO(swscale,  SWSCALE,  flags, level);
1087     PRINT_LIB_INFO(swresample,SWRESAMPLE,  flags, level);
1088     PRINT_LIB_INFO(postproc, POSTPROC, flags, level);
1089 }
1090
1091 static void print_program_info(int flags, int level)
1092 {
1093     const char *indent = flags & INDENT? "  " : "";
1094
1095     av_log(NULL, level, "%s version " FFMPEG_VERSION, program_name);
1096     if (flags & SHOW_COPYRIGHT)
1097         av_log(NULL, level, " Copyright (c) %d-%d the FFmpeg developers",
1098                program_birth_year, CONFIG_THIS_YEAR);
1099     av_log(NULL, level, "\n");
1100     av_log(NULL, level, "%sbuilt with %s\n", indent, CC_IDENT);
1101
1102     av_log(NULL, level, "%sconfiguration: " FFMPEG_CONFIGURATION "\n", indent);
1103 }
1104
1105 static void print_buildconf(int flags, int level)
1106 {
1107     const char *indent = flags & INDENT ? "  " : "";
1108     char str[] = { FFMPEG_CONFIGURATION };
1109     char *conflist, *remove_tilde, *splitconf;
1110
1111     // Change all the ' --' strings to '~--' so that
1112     // they can be identified as tokens.
1113     while ((conflist = strstr(str, " --")) != NULL) {
1114         strncpy(conflist, "~--", 3);
1115     }
1116
1117     // Compensate for the weirdness this would cause
1118     // when passing 'pkg-config --static'.
1119     while ((remove_tilde = strstr(str, "pkg-config~")) != NULL) {
1120         strncpy(remove_tilde, "pkg-config ", 11);
1121     }
1122
1123     splitconf = strtok(str, "~");
1124     av_log(NULL, level, "\n%sconfiguration:\n", indent);
1125     while (splitconf != NULL) {
1126         av_log(NULL, level, "%s%s%s\n", indent, indent, splitconf);
1127         splitconf = strtok(NULL, "~");
1128     }
1129 }
1130
1131 void show_banner(int argc, char **argv, const OptionDef *options)
1132 {
1133     int idx = locate_option(argc, argv, options, "version");
1134     if (hide_banner || idx)
1135         return;
1136
1137     print_program_info (INDENT|SHOW_COPYRIGHT, AV_LOG_INFO);
1138     print_all_libs_info(INDENT|SHOW_CONFIG,  AV_LOG_INFO);
1139     print_all_libs_info(INDENT|SHOW_VERSION, AV_LOG_INFO);
1140 }
1141
1142 int show_version(void *optctx, const char *opt, const char *arg)
1143 {
1144     av_log_set_callback(log_callback_help);
1145     print_program_info (SHOW_COPYRIGHT, AV_LOG_INFO);
1146     print_all_libs_info(SHOW_VERSION, AV_LOG_INFO);
1147
1148     return 0;
1149 }
1150
1151 int show_buildconf(void *optctx, const char *opt, const char *arg)
1152 {
1153     av_log_set_callback(log_callback_help);
1154     print_buildconf      (INDENT|0, AV_LOG_INFO);
1155
1156     return 0;
1157 }
1158
1159 int show_license(void *optctx, const char *opt, const char *arg)
1160 {
1161 #if CONFIG_NONFREE
1162     printf(
1163     "This version of %s has nonfree parts compiled in.\n"
1164     "Therefore it is not legally redistributable.\n",
1165     program_name );
1166 #elif CONFIG_GPLV3
1167     printf(
1168     "%s is free software; you can redistribute it and/or modify\n"
1169     "it under the terms of the GNU General Public License as published by\n"
1170     "the Free Software Foundation; either version 3 of the License, or\n"
1171     "(at your option) any later version.\n"
1172     "\n"
1173     "%s is distributed in the hope that it will be useful,\n"
1174     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
1175     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
1176     "GNU General Public License for more details.\n"
1177     "\n"
1178     "You should have received a copy of the GNU General Public License\n"
1179     "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
1180     program_name, program_name, program_name );
1181 #elif CONFIG_GPL
1182     printf(
1183     "%s is free software; you can redistribute it and/or modify\n"
1184     "it under the terms of the GNU General Public License as published by\n"
1185     "the Free Software Foundation; either version 2 of the License, or\n"
1186     "(at your option) any later version.\n"
1187     "\n"
1188     "%s is distributed in the hope that it will be useful,\n"
1189     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
1190     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
1191     "GNU General Public License for more details.\n"
1192     "\n"
1193     "You should have received a copy of the GNU General Public License\n"
1194     "along with %s; if not, write to the Free Software\n"
1195     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
1196     program_name, program_name, program_name );
1197 #elif CONFIG_LGPLV3
1198     printf(
1199     "%s is free software; you can redistribute it and/or modify\n"
1200     "it under the terms of the GNU Lesser General Public License as published by\n"
1201     "the Free Software Foundation; either version 3 of the License, or\n"
1202     "(at your option) any later version.\n"
1203     "\n"
1204     "%s is distributed in the hope that it will be useful,\n"
1205     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
1206     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
1207     "GNU Lesser General Public License for more details.\n"
1208     "\n"
1209     "You should have received a copy of the GNU Lesser General Public License\n"
1210     "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
1211     program_name, program_name, program_name );
1212 #else
1213     printf(
1214     "%s is free software; you can redistribute it and/or\n"
1215     "modify it under the terms of the GNU Lesser General Public\n"
1216     "License as published by the Free Software Foundation; either\n"
1217     "version 2.1 of the License, or (at your option) any later version.\n"
1218     "\n"
1219     "%s is distributed in the hope that it will be useful,\n"
1220     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
1221     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\n"
1222     "Lesser General Public License for more details.\n"
1223     "\n"
1224     "You should have received a copy of the GNU Lesser General Public\n"
1225     "License along with %s; if not, write to the Free Software\n"
1226     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
1227     program_name, program_name, program_name );
1228 #endif
1229
1230     return 0;
1231 }
1232
1233 static int is_device(const AVClass *avclass)
1234 {
1235     if (!avclass)
1236         return 0;
1237     return AV_IS_INPUT_DEVICE(avclass->category) || AV_IS_OUTPUT_DEVICE(avclass->category);
1238 }
1239
1240 static int show_formats_devices(void *optctx, const char *opt, const char *arg, int device_only)
1241 {
1242     AVInputFormat *ifmt  = NULL;
1243     AVOutputFormat *ofmt = NULL;
1244     const char *last_name;
1245     int is_dev;
1246
1247     printf("%s\n"
1248            " D. = Demuxing supported\n"
1249            " .E = Muxing supported\n"
1250            " --\n", device_only ? "Devices:" : "File formats:");
1251     last_name = "000";
1252     for (;;) {
1253         int decode = 0;
1254         int encode = 0;
1255         const char *name      = NULL;
1256         const char *long_name = NULL;
1257
1258         while ((ofmt = av_oformat_next(ofmt))) {
1259             is_dev = is_device(ofmt->priv_class);
1260             if (!is_dev && device_only)
1261                 continue;
1262             if ((!name || strcmp(ofmt->name, name) < 0) &&
1263                 strcmp(ofmt->name, last_name) > 0) {
1264                 name      = ofmt->name;
1265                 long_name = ofmt->long_name;
1266                 encode    = 1;
1267             }
1268         }
1269         while ((ifmt = av_iformat_next(ifmt))) {
1270             is_dev = is_device(ifmt->priv_class);
1271             if (!is_dev && device_only)
1272                 continue;
1273             if ((!name || strcmp(ifmt->name, name) < 0) &&
1274                 strcmp(ifmt->name, last_name) > 0) {
1275                 name      = ifmt->name;
1276                 long_name = ifmt->long_name;
1277                 encode    = 0;
1278             }
1279             if (name && strcmp(ifmt->name, name) == 0)
1280                 decode = 1;
1281         }
1282         if (!name)
1283             break;
1284         last_name = name;
1285
1286         printf(" %s%s %-15s %s\n",
1287                decode ? "D" : " ",
1288                encode ? "E" : " ",
1289                name,
1290             long_name ? long_name:" ");
1291     }
1292     return 0;
1293 }
1294
1295 int show_formats(void *optctx, const char *opt, const char *arg)
1296 {
1297     return show_formats_devices(optctx, opt, arg, 0);
1298 }
1299
1300 int show_devices(void *optctx, const char *opt, const char *arg)
1301 {
1302     return show_formats_devices(optctx, opt, arg, 1);
1303 }
1304
1305 #define PRINT_CODEC_SUPPORTED(codec, field, type, list_name, term, get_name) \
1306     if (codec->field) {                                                      \
1307         const type *p = codec->field;                                        \
1308                                                                              \
1309         printf("    Supported " list_name ":");                              \
1310         while (*p != term) {                                                 \
1311             get_name(*p);                                                    \
1312             printf(" %s", name);                                             \
1313             p++;                                                             \
1314         }                                                                    \
1315         printf("\n");                                                        \
1316     }                                                                        \
1317
1318 static void print_codec(const AVCodec *c)
1319 {
1320     int encoder = av_codec_is_encoder(c);
1321
1322     printf("%s %s [%s]:\n", encoder ? "Encoder" : "Decoder", c->name,
1323            c->long_name ? c->long_name : "");
1324
1325     printf("    General capabilities: ");
1326     if (c->capabilities & AV_CODEC_CAP_DRAW_HORIZ_BAND)
1327         printf("horizband ");
1328     if (c->capabilities & AV_CODEC_CAP_DR1)
1329         printf("dr1 ");
1330     if (c->capabilities & AV_CODEC_CAP_TRUNCATED)
1331         printf("trunc ");
1332     if (c->capabilities & AV_CODEC_CAP_DELAY)
1333         printf("delay ");
1334     if (c->capabilities & AV_CODEC_CAP_SMALL_LAST_FRAME)
1335         printf("small ");
1336     if (c->capabilities & AV_CODEC_CAP_SUBFRAMES)
1337         printf("subframes ");
1338     if (c->capabilities & AV_CODEC_CAP_EXPERIMENTAL)
1339         printf("exp ");
1340     if (c->capabilities & AV_CODEC_CAP_CHANNEL_CONF)
1341         printf("chconf ");
1342     if (c->capabilities & AV_CODEC_CAP_PARAM_CHANGE)
1343         printf("small ");
1344     if (c->capabilities & AV_CODEC_CAP_PARAM_CHANGE)
1345         printf("variable ");
1346     if (c->capabilities & (AV_CODEC_CAP_FRAME_THREADS |
1347                            AV_CODEC_CAP_SLICE_THREADS |
1348                            AV_CODEC_CAP_AUTO_THREADS))
1349         printf("threads ");
1350     if (!c->capabilities)
1351         printf("none");
1352     printf("\n");
1353
1354     if (c->type == AVMEDIA_TYPE_VIDEO ||
1355         c->type == AVMEDIA_TYPE_AUDIO) {
1356         printf("    Threading capabilities: ");
1357         switch (c->capabilities & (AV_CODEC_CAP_FRAME_THREADS |
1358                                    AV_CODEC_CAP_SLICE_THREADS |
1359                                    AV_CODEC_CAP_AUTO_THREADS)) {
1360         case AV_CODEC_CAP_FRAME_THREADS |
1361              AV_CODEC_CAP_SLICE_THREADS: printf("frame and slice"); break;
1362         case AV_CODEC_CAP_FRAME_THREADS: printf("frame");           break;
1363         case AV_CODEC_CAP_SLICE_THREADS: printf("slice");           break;
1364         case AV_CODEC_CAP_AUTO_THREADS : printf("auto");            break;
1365         default:                         printf("none");            break;
1366         }
1367         printf("\n");
1368     }
1369
1370     if (c->supported_framerates) {
1371         const AVRational *fps = c->supported_framerates;
1372
1373         printf("    Supported framerates:");
1374         while (fps->num) {
1375             printf(" %d/%d", fps->num, fps->den);
1376             fps++;
1377         }
1378         printf("\n");
1379     }
1380     PRINT_CODEC_SUPPORTED(c, pix_fmts, enum AVPixelFormat, "pixel formats",
1381                           AV_PIX_FMT_NONE, GET_PIX_FMT_NAME);
1382     PRINT_CODEC_SUPPORTED(c, supported_samplerates, int, "sample rates", 0,
1383                           GET_SAMPLE_RATE_NAME);
1384     PRINT_CODEC_SUPPORTED(c, sample_fmts, enum AVSampleFormat, "sample formats",
1385                           AV_SAMPLE_FMT_NONE, GET_SAMPLE_FMT_NAME);
1386     PRINT_CODEC_SUPPORTED(c, channel_layouts, uint64_t, "channel layouts",
1387                           0, GET_CH_LAYOUT_DESC);
1388
1389     if (c->priv_class) {
1390         show_help_children(c->priv_class,
1391                            AV_OPT_FLAG_ENCODING_PARAM |
1392                            AV_OPT_FLAG_DECODING_PARAM);
1393     }
1394 }
1395
1396 static char get_media_type_char(enum AVMediaType type)
1397 {
1398     switch (type) {
1399         case AVMEDIA_TYPE_VIDEO:    return 'V';
1400         case AVMEDIA_TYPE_AUDIO:    return 'A';
1401         case AVMEDIA_TYPE_DATA:     return 'D';
1402         case AVMEDIA_TYPE_SUBTITLE: return 'S';
1403         case AVMEDIA_TYPE_ATTACHMENT:return 'T';
1404         default:                    return '?';
1405     }
1406 }
1407
1408 static const AVCodec *next_codec_for_id(enum AVCodecID id, const AVCodec *prev,
1409                                         int encoder)
1410 {
1411     while ((prev = av_codec_next(prev))) {
1412         if (prev->id == id &&
1413             (encoder ? av_codec_is_encoder(prev) : av_codec_is_decoder(prev)))
1414             return prev;
1415     }
1416     return NULL;
1417 }
1418
1419 static int compare_codec_desc(const void *a, const void *b)
1420 {
1421     const AVCodecDescriptor * const *da = a;
1422     const AVCodecDescriptor * const *db = b;
1423
1424     return (*da)->type != (*db)->type ? (*da)->type - (*db)->type :
1425            strcmp((*da)->name, (*db)->name);
1426 }
1427
1428 static unsigned get_codecs_sorted(const AVCodecDescriptor ***rcodecs)
1429 {
1430     const AVCodecDescriptor *desc = NULL;
1431     const AVCodecDescriptor **codecs;
1432     unsigned nb_codecs = 0, i = 0;
1433
1434     while ((desc = avcodec_descriptor_next(desc)))
1435         nb_codecs++;
1436     if (!(codecs = av_calloc(nb_codecs, sizeof(*codecs)))) {
1437         av_log(NULL, AV_LOG_ERROR, "Out of memory\n");
1438         exit_program(1);
1439     }
1440     desc = NULL;
1441     while ((desc = avcodec_descriptor_next(desc)))
1442         codecs[i++] = desc;
1443     av_assert0(i == nb_codecs);
1444     qsort(codecs, nb_codecs, sizeof(*codecs), compare_codec_desc);
1445     *rcodecs = codecs;
1446     return nb_codecs;
1447 }
1448
1449 static void print_codecs_for_id(enum AVCodecID id, int encoder)
1450 {
1451     const AVCodec *codec = NULL;
1452
1453     printf(" (%s: ", encoder ? "encoders" : "decoders");
1454
1455     while ((codec = next_codec_for_id(id, codec, encoder)))
1456         printf("%s ", codec->name);
1457
1458     printf(")");
1459 }
1460
1461 int show_codecs(void *optctx, const char *opt, const char *arg)
1462 {
1463     const AVCodecDescriptor **codecs;
1464     unsigned i, nb_codecs = get_codecs_sorted(&codecs);
1465
1466     printf("Codecs:\n"
1467            " D..... = Decoding supported\n"
1468            " .E.... = Encoding supported\n"
1469            " ..V... = Video codec\n"
1470            " ..A... = Audio codec\n"
1471            " ..S... = Subtitle codec\n"
1472            " ...I.. = Intra frame-only codec\n"
1473            " ....L. = Lossy compression\n"
1474            " .....S = Lossless compression\n"
1475            " -------\n");
1476     for (i = 0; i < nb_codecs; i++) {
1477         const AVCodecDescriptor *desc = codecs[i];
1478         const AVCodec *codec = NULL;
1479
1480         if (strstr(desc->name, "_deprecated"))
1481             continue;
1482
1483         printf(" ");
1484         printf(avcodec_find_decoder(desc->id) ? "D" : ".");
1485         printf(avcodec_find_encoder(desc->id) ? "E" : ".");
1486
1487         printf("%c", get_media_type_char(desc->type));
1488         printf((desc->props & AV_CODEC_PROP_INTRA_ONLY) ? "I" : ".");
1489         printf((desc->props & AV_CODEC_PROP_LOSSY)      ? "L" : ".");
1490         printf((desc->props & AV_CODEC_PROP_LOSSLESS)   ? "S" : ".");
1491
1492         printf(" %-20s %s", desc->name, desc->long_name ? desc->long_name : "");
1493
1494         /* print decoders/encoders when there's more than one or their
1495          * names are different from codec name */
1496         while ((codec = next_codec_for_id(desc->id, codec, 0))) {
1497             if (strcmp(codec->name, desc->name)) {
1498                 print_codecs_for_id(desc->id, 0);
1499                 break;
1500             }
1501         }
1502         codec = NULL;
1503         while ((codec = next_codec_for_id(desc->id, codec, 1))) {
1504             if (strcmp(codec->name, desc->name)) {
1505                 print_codecs_for_id(desc->id, 1);
1506                 break;
1507             }
1508         }
1509
1510         printf("\n");
1511     }
1512     av_free(codecs);
1513     return 0;
1514 }
1515
1516 static void print_codecs(int encoder)
1517 {
1518     const AVCodecDescriptor **codecs;
1519     unsigned i, nb_codecs = get_codecs_sorted(&codecs);
1520
1521     printf("%s:\n"
1522            " V..... = Video\n"
1523            " A..... = Audio\n"
1524            " S..... = Subtitle\n"
1525            " .F.... = Frame-level multithreading\n"
1526            " ..S... = Slice-level multithreading\n"
1527            " ...X.. = Codec is experimental\n"
1528            " ....B. = Supports draw_horiz_band\n"
1529            " .....D = Supports direct rendering method 1\n"
1530            " ------\n",
1531            encoder ? "Encoders" : "Decoders");
1532     for (i = 0; i < nb_codecs; i++) {
1533         const AVCodecDescriptor *desc = codecs[i];
1534         const AVCodec *codec = NULL;
1535
1536         while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
1537             printf(" %c", get_media_type_char(desc->type));
1538             printf((codec->capabilities & AV_CODEC_CAP_FRAME_THREADS) ? "F" : ".");
1539             printf((codec->capabilities & AV_CODEC_CAP_SLICE_THREADS) ? "S" : ".");
1540             printf((codec->capabilities & AV_CODEC_CAP_EXPERIMENTAL)  ? "X" : ".");
1541             printf((codec->capabilities & AV_CODEC_CAP_DRAW_HORIZ_BAND)?"B" : ".");
1542             printf((codec->capabilities & AV_CODEC_CAP_DR1)           ? "D" : ".");
1543
1544             printf(" %-20s %s", codec->name, codec->long_name ? codec->long_name : "");
1545             if (strcmp(codec->name, desc->name))
1546                 printf(" (codec %s)", desc->name);
1547
1548             printf("\n");
1549         }
1550     }
1551     av_free(codecs);
1552 }
1553
1554 int show_decoders(void *optctx, const char *opt, const char *arg)
1555 {
1556     print_codecs(0);
1557     return 0;
1558 }
1559
1560 int show_encoders(void *optctx, const char *opt, const char *arg)
1561 {
1562     print_codecs(1);
1563     return 0;
1564 }
1565
1566 int show_bsfs(void *optctx, const char *opt, const char *arg)
1567 {
1568     AVBitStreamFilter *bsf = NULL;
1569
1570     printf("Bitstream filters:\n");
1571     while ((bsf = av_bitstream_filter_next(bsf)))
1572         printf("%s\n", bsf->name);
1573     printf("\n");
1574     return 0;
1575 }
1576
1577 int show_protocols(void *optctx, const char *opt, const char *arg)
1578 {
1579     void *opaque = NULL;
1580     const char *name;
1581
1582     printf("Supported file protocols:\n"
1583            "Input:\n");
1584     while ((name = avio_enum_protocols(&opaque, 0)))
1585         printf("  %s\n", name);
1586     printf("Output:\n");
1587     while ((name = avio_enum_protocols(&opaque, 1)))
1588         printf("  %s\n", name);
1589     return 0;
1590 }
1591
1592 int show_filters(void *optctx, const char *opt, const char *arg)
1593 {
1594 #if CONFIG_AVFILTER
1595     const AVFilter *filter = NULL;
1596     char descr[64], *descr_cur;
1597     int i, j;
1598     const AVFilterPad *pad;
1599
1600     printf("Filters:\n"
1601            "  T.. = Timeline support\n"
1602            "  .S. = Slice threading\n"
1603            "  ..C = Command support\n"
1604            "  A = Audio input/output\n"
1605            "  V = Video input/output\n"
1606            "  N = Dynamic number and/or type of input/output\n"
1607            "  | = Source or sink filter\n");
1608     while ((filter = avfilter_next(filter))) {
1609         descr_cur = descr;
1610         for (i = 0; i < 2; i++) {
1611             if (i) {
1612                 *(descr_cur++) = '-';
1613                 *(descr_cur++) = '>';
1614             }
1615             pad = i ? filter->outputs : filter->inputs;
1616             for (j = 0; pad && avfilter_pad_get_name(pad, j); j++) {
1617                 if (descr_cur >= descr + sizeof(descr) - 4)
1618                     break;
1619                 *(descr_cur++) = get_media_type_char(avfilter_pad_get_type(pad, j));
1620             }
1621             if (!j)
1622                 *(descr_cur++) = ((!i && (filter->flags & AVFILTER_FLAG_DYNAMIC_INPUTS)) ||
1623                                   ( i && (filter->flags & AVFILTER_FLAG_DYNAMIC_OUTPUTS))) ? 'N' : '|';
1624         }
1625         *descr_cur = 0;
1626         printf(" %c%c%c %-16s %-10s %s\n",
1627                filter->flags & AVFILTER_FLAG_SUPPORT_TIMELINE ? 'T' : '.',
1628                filter->flags & AVFILTER_FLAG_SLICE_THREADS    ? 'S' : '.',
1629                filter->process_command                        ? 'C' : '.',
1630                filter->name, descr, filter->description);
1631     }
1632 #else
1633     printf("No filters available: libavfilter disabled\n");
1634 #endif
1635     return 0;
1636 }
1637
1638 int show_colors(void *optctx, const char *opt, const char *arg)
1639 {
1640     const char *name;
1641     const uint8_t *rgb;
1642     int i;
1643
1644     printf("%-32s #RRGGBB\n", "name");
1645
1646     for (i = 0; name = av_get_known_color_name(i, &rgb); i++)
1647         printf("%-32s #%02x%02x%02x\n", name, rgb[0], rgb[1], rgb[2]);
1648
1649     return 0;
1650 }
1651
1652 int show_pix_fmts(void *optctx, const char *opt, const char *arg)
1653 {
1654     const AVPixFmtDescriptor *pix_desc = NULL;
1655
1656     printf("Pixel formats:\n"
1657            "I.... = Supported Input  format for conversion\n"
1658            ".O... = Supported Output format for conversion\n"
1659            "..H.. = Hardware accelerated format\n"
1660            "...P. = Paletted format\n"
1661            "....B = Bitstream format\n"
1662            "FLAGS NAME            NB_COMPONENTS BITS_PER_PIXEL\n"
1663            "-----\n");
1664
1665 #if !CONFIG_SWSCALE
1666 #   define sws_isSupportedInput(x)  0
1667 #   define sws_isSupportedOutput(x) 0
1668 #endif
1669
1670     while ((pix_desc = av_pix_fmt_desc_next(pix_desc))) {
1671         enum AVPixelFormat pix_fmt = av_pix_fmt_desc_get_id(pix_desc);
1672         printf("%c%c%c%c%c %-16s       %d            %2d\n",
1673                sws_isSupportedInput (pix_fmt)              ? 'I' : '.',
1674                sws_isSupportedOutput(pix_fmt)              ? 'O' : '.',
1675                pix_desc->flags & AV_PIX_FMT_FLAG_HWACCEL   ? 'H' : '.',
1676                pix_desc->flags & AV_PIX_FMT_FLAG_PAL       ? 'P' : '.',
1677                pix_desc->flags & AV_PIX_FMT_FLAG_BITSTREAM ? 'B' : '.',
1678                pix_desc->name,
1679                pix_desc->nb_components,
1680                av_get_bits_per_pixel(pix_desc));
1681     }
1682     return 0;
1683 }
1684
1685 int show_layouts(void *optctx, const char *opt, const char *arg)
1686 {
1687     int i = 0;
1688     uint64_t layout, j;
1689     const char *name, *descr;
1690
1691     printf("Individual channels:\n"
1692            "NAME           DESCRIPTION\n");
1693     for (i = 0; i < 63; i++) {
1694         name = av_get_channel_name((uint64_t)1 << i);
1695         if (!name)
1696             continue;
1697         descr = av_get_channel_description((uint64_t)1 << i);
1698         printf("%-14s %s\n", name, descr);
1699     }
1700     printf("\nStandard channel layouts:\n"
1701            "NAME           DECOMPOSITION\n");
1702     for (i = 0; !av_get_standard_channel_layout(i, &layout, &name); i++) {
1703         if (name) {
1704             printf("%-14s ", name);
1705             for (j = 1; j; j <<= 1)
1706                 if ((layout & j))
1707                     printf("%s%s", (layout & (j - 1)) ? "+" : "", av_get_channel_name(j));
1708             printf("\n");
1709         }
1710     }
1711     return 0;
1712 }
1713
1714 int show_sample_fmts(void *optctx, const char *opt, const char *arg)
1715 {
1716     int i;
1717     char fmt_str[128];
1718     for (i = -1; i < AV_SAMPLE_FMT_NB; i++)
1719         printf("%s\n", av_get_sample_fmt_string(fmt_str, sizeof(fmt_str), i));
1720     return 0;
1721 }
1722
1723 static void show_help_codec(const char *name, int encoder)
1724 {
1725     const AVCodecDescriptor *desc;
1726     const AVCodec *codec;
1727
1728     if (!name) {
1729         av_log(NULL, AV_LOG_ERROR, "No codec name specified.\n");
1730         return;
1731     }
1732
1733     codec = encoder ? avcodec_find_encoder_by_name(name) :
1734                       avcodec_find_decoder_by_name(name);
1735
1736     if (codec)
1737         print_codec(codec);
1738     else if ((desc = avcodec_descriptor_get_by_name(name))) {
1739         int printed = 0;
1740
1741         while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
1742             printed = 1;
1743             print_codec(codec);
1744         }
1745
1746         if (!printed) {
1747             av_log(NULL, AV_LOG_ERROR, "Codec '%s' is known to FFmpeg, "
1748                    "but no %s for it are available. FFmpeg might need to be "
1749                    "recompiled with additional external libraries.\n",
1750                    name, encoder ? "encoders" : "decoders");
1751         }
1752     } else {
1753         av_log(NULL, AV_LOG_ERROR, "Codec '%s' is not recognized by FFmpeg.\n",
1754                name);
1755     }
1756 }
1757
1758 static void show_help_demuxer(const char *name)
1759 {
1760     const AVInputFormat *fmt = av_find_input_format(name);
1761
1762     if (!fmt) {
1763         av_log(NULL, AV_LOG_ERROR, "Unknown format '%s'.\n", name);
1764         return;
1765     }
1766
1767     printf("Demuxer %s [%s]:\n", fmt->name, fmt->long_name);
1768
1769     if (fmt->extensions)
1770         printf("    Common extensions: %s.\n", fmt->extensions);
1771
1772     if (fmt->priv_class)
1773         show_help_children(fmt->priv_class, AV_OPT_FLAG_DECODING_PARAM);
1774 }
1775
1776 static void show_help_muxer(const char *name)
1777 {
1778     const AVCodecDescriptor *desc;
1779     const AVOutputFormat *fmt = av_guess_format(name, NULL, NULL);
1780
1781     if (!fmt) {
1782         av_log(NULL, AV_LOG_ERROR, "Unknown format '%s'.\n", name);
1783         return;
1784     }
1785
1786     printf("Muxer %s [%s]:\n", fmt->name, fmt->long_name);
1787
1788     if (fmt->extensions)
1789         printf("    Common extensions: %s.\n", fmt->extensions);
1790     if (fmt->mime_type)
1791         printf("    Mime type: %s.\n", fmt->mime_type);
1792     if (fmt->video_codec != AV_CODEC_ID_NONE &&
1793         (desc = avcodec_descriptor_get(fmt->video_codec))) {
1794         printf("    Default video codec: %s.\n", desc->name);
1795     }
1796     if (fmt->audio_codec != AV_CODEC_ID_NONE &&
1797         (desc = avcodec_descriptor_get(fmt->audio_codec))) {
1798         printf("    Default audio codec: %s.\n", desc->name);
1799     }
1800     if (fmt->subtitle_codec != AV_CODEC_ID_NONE &&
1801         (desc = avcodec_descriptor_get(fmt->subtitle_codec))) {
1802         printf("    Default subtitle codec: %s.\n", desc->name);
1803     }
1804
1805     if (fmt->priv_class)
1806         show_help_children(fmt->priv_class, AV_OPT_FLAG_ENCODING_PARAM);
1807 }
1808
1809 #if CONFIG_AVFILTER
1810 static void show_help_filter(const char *name)
1811 {
1812 #if CONFIG_AVFILTER
1813     const AVFilter *f = avfilter_get_by_name(name);
1814     int i, count;
1815
1816     if (!name) {
1817         av_log(NULL, AV_LOG_ERROR, "No filter name specified.\n");
1818         return;
1819     } else if (!f) {
1820         av_log(NULL, AV_LOG_ERROR, "Unknown filter '%s'.\n", name);
1821         return;
1822     }
1823
1824     printf("Filter %s\n", f->name);
1825     if (f->description)
1826         printf("  %s\n", f->description);
1827
1828     if (f->flags & AVFILTER_FLAG_SLICE_THREADS)
1829         printf("    slice threading supported\n");
1830
1831     printf("    Inputs:\n");
1832     count = avfilter_pad_count(f->inputs);
1833     for (i = 0; i < count; i++) {
1834         printf("       #%d: %s (%s)\n", i, avfilter_pad_get_name(f->inputs, i),
1835                media_type_string(avfilter_pad_get_type(f->inputs, i)));
1836     }
1837     if (f->flags & AVFILTER_FLAG_DYNAMIC_INPUTS)
1838         printf("        dynamic (depending on the options)\n");
1839     else if (!count)
1840         printf("        none (source filter)\n");
1841
1842     printf("    Outputs:\n");
1843     count = avfilter_pad_count(f->outputs);
1844     for (i = 0; i < count; i++) {
1845         printf("       #%d: %s (%s)\n", i, avfilter_pad_get_name(f->outputs, i),
1846                media_type_string(avfilter_pad_get_type(f->outputs, i)));
1847     }
1848     if (f->flags & AVFILTER_FLAG_DYNAMIC_OUTPUTS)
1849         printf("        dynamic (depending on the options)\n");
1850     else if (!count)
1851         printf("        none (sink filter)\n");
1852
1853     if (f->priv_class)
1854         show_help_children(f->priv_class, AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_FILTERING_PARAM |
1855                                           AV_OPT_FLAG_AUDIO_PARAM);
1856     if (f->flags & AVFILTER_FLAG_SUPPORT_TIMELINE)
1857         printf("This filter has support for timeline through the 'enable' option.\n");
1858 #else
1859     av_log(NULL, AV_LOG_ERROR, "Build without libavfilter; "
1860            "can not to satisfy request\n");
1861 #endif
1862 }
1863 #endif
1864
1865 int show_help(void *optctx, const char *opt, const char *arg)
1866 {
1867     char *topic, *par;
1868     av_log_set_callback(log_callback_help);
1869
1870     topic = av_strdup(arg ? arg : "");
1871     if (!topic)
1872         return AVERROR(ENOMEM);
1873     par = strchr(topic, '=');
1874     if (par)
1875         *par++ = 0;
1876
1877     if (!*topic) {
1878         show_help_default(topic, par);
1879     } else if (!strcmp(topic, "decoder")) {
1880         show_help_codec(par, 0);
1881     } else if (!strcmp(topic, "encoder")) {
1882         show_help_codec(par, 1);
1883     } else if (!strcmp(topic, "demuxer")) {
1884         show_help_demuxer(par);
1885     } else if (!strcmp(topic, "muxer")) {
1886         show_help_muxer(par);
1887 #if CONFIG_AVFILTER
1888     } else if (!strcmp(topic, "filter")) {
1889         show_help_filter(par);
1890 #endif
1891     } else {
1892         show_help_default(topic, par);
1893     }
1894
1895     av_freep(&topic);
1896     return 0;
1897 }
1898
1899 int read_yesno(void)
1900 {
1901     int c = getchar();
1902     int yesno = (av_toupper(c) == 'Y');
1903
1904     while (c != '\n' && c != EOF)
1905         c = getchar();
1906
1907     return yesno;
1908 }
1909
1910 FILE *get_preset_file(char *filename, size_t filename_size,
1911                       const char *preset_name, int is_path,
1912                       const char *codec_name)
1913 {
1914     FILE *f = NULL;
1915     int i;
1916     const char *base[3] = { getenv("FFMPEG_DATADIR"),
1917                             getenv("HOME"),
1918                             FFMPEG_DATADIR, };
1919
1920     if (is_path) {
1921         av_strlcpy(filename, preset_name, filename_size);
1922         f = fopen(filename, "r");
1923     } else {
1924 #ifdef _WIN32
1925         char datadir[MAX_PATH], *ls;
1926         base[2] = NULL;
1927
1928         if (GetModuleFileNameA(GetModuleHandleA(NULL), datadir, sizeof(datadir) - 1))
1929         {
1930             for (ls = datadir; ls < datadir + strlen(datadir); ls++)
1931                 if (*ls == '\\') *ls = '/';
1932
1933             if (ls = strrchr(datadir, '/'))
1934             {
1935                 *ls = 0;
1936                 strncat(datadir, "/ffpresets",  sizeof(datadir) - 1 - strlen(datadir));
1937                 base[2] = datadir;
1938             }
1939         }
1940 #endif
1941         for (i = 0; i < 3 && !f; i++) {
1942             if (!base[i])
1943                 continue;
1944             snprintf(filename, filename_size, "%s%s/%s.ffpreset", base[i],
1945                      i != 1 ? "" : "/.ffmpeg", preset_name);
1946             f = fopen(filename, "r");
1947             if (!f && codec_name) {
1948                 snprintf(filename, filename_size,
1949                          "%s%s/%s-%s.ffpreset",
1950                          base[i], i != 1 ? "" : "/.ffmpeg", codec_name,
1951                          preset_name);
1952                 f = fopen(filename, "r");
1953             }
1954         }
1955     }
1956
1957     return f;
1958 }
1959
1960 int check_stream_specifier(AVFormatContext *s, AVStream *st, const char *spec)
1961 {
1962     int ret = avformat_match_stream_specifier(s, st, spec);
1963     if (ret < 0)
1964         av_log(s, AV_LOG_ERROR, "Invalid stream specifier: %s.\n", spec);
1965     return ret;
1966 }
1967
1968 AVDictionary *filter_codec_opts(AVDictionary *opts, enum AVCodecID codec_id,
1969                                 AVFormatContext *s, AVStream *st, AVCodec *codec)
1970 {
1971     AVDictionary    *ret = NULL;
1972     AVDictionaryEntry *t = NULL;
1973     int            flags = s->oformat ? AV_OPT_FLAG_ENCODING_PARAM
1974                                       : AV_OPT_FLAG_DECODING_PARAM;
1975     char          prefix = 0;
1976     const AVClass    *cc = avcodec_get_class();
1977
1978     if (!codec)
1979         codec            = s->oformat ? avcodec_find_encoder(codec_id)
1980                                       : avcodec_find_decoder(codec_id);
1981
1982     switch (st->codec->codec_type) {
1983     case AVMEDIA_TYPE_VIDEO:
1984         prefix  = 'v';
1985         flags  |= AV_OPT_FLAG_VIDEO_PARAM;
1986         break;
1987     case AVMEDIA_TYPE_AUDIO:
1988         prefix  = 'a';
1989         flags  |= AV_OPT_FLAG_AUDIO_PARAM;
1990         break;
1991     case AVMEDIA_TYPE_SUBTITLE:
1992         prefix  = 's';
1993         flags  |= AV_OPT_FLAG_SUBTITLE_PARAM;
1994         break;
1995     }
1996
1997     while (t = av_dict_get(opts, "", t, AV_DICT_IGNORE_SUFFIX)) {
1998         char *p = strchr(t->key, ':');
1999
2000         /* check stream specification in opt name */
2001         if (p)
2002             switch (check_stream_specifier(s, st, p + 1)) {
2003             case  1: *p = 0; break;
2004             case  0:         continue;
2005             default:         exit_program(1);
2006             }
2007
2008         if (av_opt_find(&cc, t->key, NULL, flags, AV_OPT_SEARCH_FAKE_OBJ) ||
2009             !codec ||
2010             (codec->priv_class &&
2011              av_opt_find(&codec->priv_class, t->key, NULL, flags,
2012                          AV_OPT_SEARCH_FAKE_OBJ)))
2013             av_dict_set(&ret, t->key, t->value, 0);
2014         else if (t->key[0] == prefix &&
2015                  av_opt_find(&cc, t->key + 1, NULL, flags,
2016                              AV_OPT_SEARCH_FAKE_OBJ))
2017             av_dict_set(&ret, t->key + 1, t->value, 0);
2018
2019         if (p)
2020             *p = ':';
2021     }
2022     return ret;
2023 }
2024
2025 AVDictionary **setup_find_stream_info_opts(AVFormatContext *s,
2026                                            AVDictionary *codec_opts)
2027 {
2028     int i;
2029     AVDictionary **opts;
2030
2031     if (!s->nb_streams)
2032         return NULL;
2033     opts = av_mallocz_array(s->nb_streams, sizeof(*opts));
2034     if (!opts) {
2035         av_log(NULL, AV_LOG_ERROR,
2036                "Could not alloc memory for stream options.\n");
2037         return NULL;
2038     }
2039     for (i = 0; i < s->nb_streams; i++)
2040         opts[i] = filter_codec_opts(codec_opts, s->streams[i]->codec->codec_id,
2041                                     s, s->streams[i], NULL);
2042     return opts;
2043 }
2044
2045 void *grow_array(void *array, int elem_size, int *size, int new_size)
2046 {
2047     if (new_size >= INT_MAX / elem_size) {
2048         av_log(NULL, AV_LOG_ERROR, "Array too big.\n");
2049         exit_program(1);
2050     }
2051     if (*size < new_size) {
2052         uint8_t *tmp = av_realloc_array(array, new_size, elem_size);
2053         if (!tmp) {
2054             av_log(NULL, AV_LOG_ERROR, "Could not alloc buffer.\n");
2055             exit_program(1);
2056         }
2057         memset(tmp + *size*elem_size, 0, (new_size-*size) * elem_size);
2058         *size = new_size;
2059         return tmp;
2060     }
2061     return array;
2062 }
2063
2064 double get_rotation(AVStream *st)
2065 {
2066     AVDictionaryEntry *rotate_tag = av_dict_get(st->metadata, "rotate", NULL, 0);
2067     uint8_t* displaymatrix = av_stream_get_side_data(st,
2068                                                      AV_PKT_DATA_DISPLAYMATRIX, NULL);
2069     double theta = 0;
2070
2071     if (rotate_tag && *rotate_tag->value && strcmp(rotate_tag->value, "0")) {
2072         char *tail;
2073         theta = av_strtod(rotate_tag->value, &tail);
2074         if (*tail)
2075             theta = 0;
2076     }
2077     if (displaymatrix && !theta)
2078         theta = -av_display_rotation_get((int32_t*) displaymatrix);
2079
2080     theta -= 360*floor(theta/360 + 0.9/360);
2081
2082     if (fabs(theta - 90*round(theta/90)) > 2)
2083         av_log(NULL, AV_LOG_WARNING, "Odd rotation angle.\n"
2084                "If you want to help, upload a sample "
2085                "of this file to ftp://upload.ffmpeg.org/incoming/ "
2086                "and contact the ffmpeg-devel mailing list. (ffmpeg-devel@ffmpeg.org)");
2087
2088     return theta;
2089 }
2090
2091 #if CONFIG_AVDEVICE
2092 static int print_device_sources(AVInputFormat *fmt, AVDictionary *opts)
2093 {
2094     int ret, i;
2095     AVDeviceInfoList *device_list = NULL;
2096
2097     if (!fmt || !fmt->priv_class  || !AV_IS_INPUT_DEVICE(fmt->priv_class->category))
2098         return AVERROR(EINVAL);
2099
2100     printf("Audo-detected sources for %s:\n", fmt->name);
2101     if (!fmt->get_device_list) {
2102         ret = AVERROR(ENOSYS);
2103         printf("Cannot list sources. Not implemented.\n");
2104         goto fail;
2105     }
2106
2107     if ((ret = avdevice_list_input_sources(fmt, NULL, opts, &device_list)) < 0) {
2108         printf("Cannot list sources.\n");
2109         goto fail;
2110     }
2111
2112     for (i = 0; i < device_list->nb_devices; i++) {
2113         printf("%s %s [%s]\n", device_list->default_device == i ? "*" : " ",
2114                device_list->devices[i]->device_name, device_list->devices[i]->device_description);
2115     }
2116
2117   fail:
2118     avdevice_free_list_devices(&device_list);
2119     return ret;
2120 }
2121
2122 static int print_device_sinks(AVOutputFormat *fmt, AVDictionary *opts)
2123 {
2124     int ret, i;
2125     AVDeviceInfoList *device_list = NULL;
2126
2127     if (!fmt || !fmt->priv_class  || !AV_IS_OUTPUT_DEVICE(fmt->priv_class->category))
2128         return AVERROR(EINVAL);
2129
2130     printf("Audo-detected sinks for %s:\n", fmt->name);
2131     if (!fmt->get_device_list) {
2132         ret = AVERROR(ENOSYS);
2133         printf("Cannot list sinks. Not implemented.\n");
2134         goto fail;
2135     }
2136
2137     if ((ret = avdevice_list_output_sinks(fmt, NULL, opts, &device_list)) < 0) {
2138         printf("Cannot list sinks.\n");
2139         goto fail;
2140     }
2141
2142     for (i = 0; i < device_list->nb_devices; i++) {
2143         printf("%s %s [%s]\n", device_list->default_device == i ? "*" : " ",
2144                device_list->devices[i]->device_name, device_list->devices[i]->device_description);
2145     }
2146
2147   fail:
2148     avdevice_free_list_devices(&device_list);
2149     return ret;
2150 }
2151
2152 static int show_sinks_sources_parse_arg(const char *arg, char **dev, AVDictionary **opts)
2153 {
2154     int ret;
2155     if (arg) {
2156         char *opts_str = NULL;
2157         av_assert0(dev && opts);
2158         *dev = av_strdup(arg);
2159         if (!*dev)
2160             return AVERROR(ENOMEM);
2161         if ((opts_str = strchr(*dev, ','))) {
2162             *(opts_str++) = '\0';
2163             if (opts_str[0] && ((ret = av_dict_parse_string(opts, opts_str, "=", ":", 0)) < 0)) {
2164                 av_freep(dev);
2165                 return ret;
2166             }
2167         }
2168     } else
2169         printf("\nDevice name is not provided.\n"
2170                 "You can pass devicename[,opt1=val1[,opt2=val2...]] as an argument.\n\n");
2171     return 0;
2172 }
2173
2174 int show_sources(void *optctx, const char *opt, const char *arg)
2175 {
2176     AVInputFormat *fmt = NULL;
2177     char *dev = NULL;
2178     AVDictionary *opts = NULL;
2179     int ret = 0;
2180     int error_level = av_log_get_level();
2181
2182     av_log_set_level(AV_LOG_ERROR);
2183
2184     if ((ret = show_sinks_sources_parse_arg(arg, &dev, &opts)) < 0)
2185         goto fail;
2186
2187     do {
2188         fmt = av_input_audio_device_next(fmt);
2189         if (fmt) {
2190             if (!strcmp(fmt->name, "lavfi"))
2191                 continue; //it's pointless to probe lavfi
2192             if (dev && !av_match_name(dev, fmt->name))
2193                 continue;
2194             print_device_sources(fmt, opts);
2195         }
2196     } while (fmt);
2197     do {
2198         fmt = av_input_video_device_next(fmt);
2199         if (fmt) {
2200             if (dev && !av_match_name(dev, fmt->name))
2201                 continue;
2202             print_device_sources(fmt, opts);
2203         }
2204     } while (fmt);
2205   fail:
2206     av_dict_free(&opts);
2207     av_free(dev);
2208     av_log_set_level(error_level);
2209     return ret;
2210 }
2211
2212 int show_sinks(void *optctx, const char *opt, const char *arg)
2213 {
2214     AVOutputFormat *fmt = NULL;
2215     char *dev = NULL;
2216     AVDictionary *opts = NULL;
2217     int ret = 0;
2218     int error_level = av_log_get_level();
2219
2220     av_log_set_level(AV_LOG_ERROR);
2221
2222     if ((ret = show_sinks_sources_parse_arg(arg, &dev, &opts)) < 0)
2223         goto fail;
2224
2225     do {
2226         fmt = av_output_audio_device_next(fmt);
2227         if (fmt) {
2228             if (dev && !av_match_name(dev, fmt->name))
2229                 continue;
2230             print_device_sinks(fmt, opts);
2231         }
2232     } while (fmt);
2233     do {
2234         fmt = av_output_video_device_next(fmt);
2235         if (fmt) {
2236             if (dev && !av_match_name(dev, fmt->name))
2237                 continue;
2238             print_device_sinks(fmt, opts);
2239         }
2240     } while (fmt);
2241   fail:
2242     av_dict_free(&opts);
2243     av_free(dev);
2244     av_log_set_level(error_level);
2245     return ret;
2246 }
2247
2248 #endif