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     if (c->type == AVMEDIA_TYPE_VIDEO ||
1326         c->type == AVMEDIA_TYPE_AUDIO) {
1327         printf("    Threading capabilities: ");
1328         switch (c->capabilities & (AV_CODEC_CAP_FRAME_THREADS |
1329                                    AV_CODEC_CAP_SLICE_THREADS)) {
1330         case AV_CODEC_CAP_FRAME_THREADS |
1331              AV_CODEC_CAP_SLICE_THREADS: printf("frame and slice"); break;
1332         case AV_CODEC_CAP_FRAME_THREADS: printf("frame");           break;
1333         case AV_CODEC_CAP_SLICE_THREADS: printf("slice");           break;
1334         default:                      printf("no");              break;
1335         }
1336         printf("\n");
1337     }
1338
1339     if (c->supported_framerates) {
1340         const AVRational *fps = c->supported_framerates;
1341
1342         printf("    Supported framerates:");
1343         while (fps->num) {
1344             printf(" %d/%d", fps->num, fps->den);
1345             fps++;
1346         }
1347         printf("\n");
1348     }
1349     PRINT_CODEC_SUPPORTED(c, pix_fmts, enum AVPixelFormat, "pixel formats",
1350                           AV_PIX_FMT_NONE, GET_PIX_FMT_NAME);
1351     PRINT_CODEC_SUPPORTED(c, supported_samplerates, int, "sample rates", 0,
1352                           GET_SAMPLE_RATE_NAME);
1353     PRINT_CODEC_SUPPORTED(c, sample_fmts, enum AVSampleFormat, "sample formats",
1354                           AV_SAMPLE_FMT_NONE, GET_SAMPLE_FMT_NAME);
1355     PRINT_CODEC_SUPPORTED(c, channel_layouts, uint64_t, "channel layouts",
1356                           0, GET_CH_LAYOUT_DESC);
1357
1358     if (c->priv_class) {
1359         show_help_children(c->priv_class,
1360                            AV_OPT_FLAG_ENCODING_PARAM |
1361                            AV_OPT_FLAG_DECODING_PARAM);
1362     }
1363 }
1364
1365 static char get_media_type_char(enum AVMediaType type)
1366 {
1367     switch (type) {
1368         case AVMEDIA_TYPE_VIDEO:    return 'V';
1369         case AVMEDIA_TYPE_AUDIO:    return 'A';
1370         case AVMEDIA_TYPE_DATA:     return 'D';
1371         case AVMEDIA_TYPE_SUBTITLE: return 'S';
1372         case AVMEDIA_TYPE_ATTACHMENT:return 'T';
1373         default:                    return '?';
1374     }
1375 }
1376
1377 static const AVCodec *next_codec_for_id(enum AVCodecID id, const AVCodec *prev,
1378                                         int encoder)
1379 {
1380     while ((prev = av_codec_next(prev))) {
1381         if (prev->id == id &&
1382             (encoder ? av_codec_is_encoder(prev) : av_codec_is_decoder(prev)))
1383             return prev;
1384     }
1385     return NULL;
1386 }
1387
1388 static int compare_codec_desc(const void *a, const void *b)
1389 {
1390     const AVCodecDescriptor * const *da = a;
1391     const AVCodecDescriptor * const *db = b;
1392
1393     return (*da)->type != (*db)->type ? (*da)->type - (*db)->type :
1394            strcmp((*da)->name, (*db)->name);
1395 }
1396
1397 static unsigned get_codecs_sorted(const AVCodecDescriptor ***rcodecs)
1398 {
1399     const AVCodecDescriptor *desc = NULL;
1400     const AVCodecDescriptor **codecs;
1401     unsigned nb_codecs = 0, i = 0;
1402
1403     while ((desc = avcodec_descriptor_next(desc)))
1404         nb_codecs++;
1405     if (!(codecs = av_calloc(nb_codecs, sizeof(*codecs)))) {
1406         av_log(NULL, AV_LOG_ERROR, "Out of memory\n");
1407         exit_program(1);
1408     }
1409     desc = NULL;
1410     while ((desc = avcodec_descriptor_next(desc)))
1411         codecs[i++] = desc;
1412     av_assert0(i == nb_codecs);
1413     qsort(codecs, nb_codecs, sizeof(*codecs), compare_codec_desc);
1414     *rcodecs = codecs;
1415     return nb_codecs;
1416 }
1417
1418 static void print_codecs_for_id(enum AVCodecID id, int encoder)
1419 {
1420     const AVCodec *codec = NULL;
1421
1422     printf(" (%s: ", encoder ? "encoders" : "decoders");
1423
1424     while ((codec = next_codec_for_id(id, codec, encoder)))
1425         printf("%s ", codec->name);
1426
1427     printf(")");
1428 }
1429
1430 int show_codecs(void *optctx, const char *opt, const char *arg)
1431 {
1432     const AVCodecDescriptor **codecs;
1433     unsigned i, nb_codecs = get_codecs_sorted(&codecs);
1434
1435     printf("Codecs:\n"
1436            " D..... = Decoding supported\n"
1437            " .E.... = Encoding supported\n"
1438            " ..V... = Video codec\n"
1439            " ..A... = Audio codec\n"
1440            " ..S... = Subtitle codec\n"
1441            " ...I.. = Intra frame-only codec\n"
1442            " ....L. = Lossy compression\n"
1443            " .....S = Lossless compression\n"
1444            " -------\n");
1445     for (i = 0; i < nb_codecs; i++) {
1446         const AVCodecDescriptor *desc = codecs[i];
1447         const AVCodec *codec = NULL;
1448
1449         if (strstr(desc->name, "_deprecated"))
1450             continue;
1451
1452         printf(" ");
1453         printf(avcodec_find_decoder(desc->id) ? "D" : ".");
1454         printf(avcodec_find_encoder(desc->id) ? "E" : ".");
1455
1456         printf("%c", get_media_type_char(desc->type));
1457         printf((desc->props & AV_CODEC_PROP_INTRA_ONLY) ? "I" : ".");
1458         printf((desc->props & AV_CODEC_PROP_LOSSY)      ? "L" : ".");
1459         printf((desc->props & AV_CODEC_PROP_LOSSLESS)   ? "S" : ".");
1460
1461         printf(" %-20s %s", desc->name, desc->long_name ? desc->long_name : "");
1462
1463         /* print decoders/encoders when there's more than one or their
1464          * names are different from codec name */
1465         while ((codec = next_codec_for_id(desc->id, codec, 0))) {
1466             if (strcmp(codec->name, desc->name)) {
1467                 print_codecs_for_id(desc->id, 0);
1468                 break;
1469             }
1470         }
1471         codec = NULL;
1472         while ((codec = next_codec_for_id(desc->id, codec, 1))) {
1473             if (strcmp(codec->name, desc->name)) {
1474                 print_codecs_for_id(desc->id, 1);
1475                 break;
1476             }
1477         }
1478
1479         printf("\n");
1480     }
1481     av_free(codecs);
1482     return 0;
1483 }
1484
1485 static void print_codecs(int encoder)
1486 {
1487     const AVCodecDescriptor **codecs;
1488     unsigned i, nb_codecs = get_codecs_sorted(&codecs);
1489
1490     printf("%s:\n"
1491            " V..... = Video\n"
1492            " A..... = Audio\n"
1493            " S..... = Subtitle\n"
1494            " .F.... = Frame-level multithreading\n"
1495            " ..S... = Slice-level multithreading\n"
1496            " ...X.. = Codec is experimental\n"
1497            " ....B. = Supports draw_horiz_band\n"
1498            " .....D = Supports direct rendering method 1\n"
1499            " ------\n",
1500            encoder ? "Encoders" : "Decoders");
1501     for (i = 0; i < nb_codecs; i++) {
1502         const AVCodecDescriptor *desc = codecs[i];
1503         const AVCodec *codec = NULL;
1504
1505         while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
1506             printf(" %c", get_media_type_char(desc->type));
1507             printf((codec->capabilities & AV_CODEC_CAP_FRAME_THREADS) ? "F" : ".");
1508             printf((codec->capabilities & AV_CODEC_CAP_SLICE_THREADS) ? "S" : ".");
1509             printf((codec->capabilities & AV_CODEC_CAP_EXPERIMENTAL)  ? "X" : ".");
1510             printf((codec->capabilities & AV_CODEC_CAP_DRAW_HORIZ_BAND)?"B" : ".");
1511             printf((codec->capabilities & AV_CODEC_CAP_DR1)           ? "D" : ".");
1512
1513             printf(" %-20s %s", codec->name, codec->long_name ? codec->long_name : "");
1514             if (strcmp(codec->name, desc->name))
1515                 printf(" (codec %s)", desc->name);
1516
1517             printf("\n");
1518         }
1519     }
1520     av_free(codecs);
1521 }
1522
1523 int show_decoders(void *optctx, const char *opt, const char *arg)
1524 {
1525     print_codecs(0);
1526     return 0;
1527 }
1528
1529 int show_encoders(void *optctx, const char *opt, const char *arg)
1530 {
1531     print_codecs(1);
1532     return 0;
1533 }
1534
1535 int show_bsfs(void *optctx, const char *opt, const char *arg)
1536 {
1537     AVBitStreamFilter *bsf = NULL;
1538
1539     printf("Bitstream filters:\n");
1540     while ((bsf = av_bitstream_filter_next(bsf)))
1541         printf("%s\n", bsf->name);
1542     printf("\n");
1543     return 0;
1544 }
1545
1546 int show_protocols(void *optctx, const char *opt, const char *arg)
1547 {
1548     void *opaque = NULL;
1549     const char *name;
1550
1551     printf("Supported file protocols:\n"
1552            "Input:\n");
1553     while ((name = avio_enum_protocols(&opaque, 0)))
1554         printf("  %s\n", name);
1555     printf("Output:\n");
1556     while ((name = avio_enum_protocols(&opaque, 1)))
1557         printf("  %s\n", name);
1558     return 0;
1559 }
1560
1561 int show_filters(void *optctx, const char *opt, const char *arg)
1562 {
1563 #if CONFIG_AVFILTER
1564     const AVFilter *filter = NULL;
1565     char descr[64], *descr_cur;
1566     int i, j;
1567     const AVFilterPad *pad;
1568
1569     printf("Filters:\n"
1570            "  T.. = Timeline support\n"
1571            "  .S. = Slice threading\n"
1572            "  ..C = Command support\n"
1573            "  A = Audio input/output\n"
1574            "  V = Video input/output\n"
1575            "  N = Dynamic number and/or type of input/output\n"
1576            "  | = Source or sink filter\n");
1577     while ((filter = avfilter_next(filter))) {
1578         descr_cur = descr;
1579         for (i = 0; i < 2; i++) {
1580             if (i) {
1581                 *(descr_cur++) = '-';
1582                 *(descr_cur++) = '>';
1583             }
1584             pad = i ? filter->outputs : filter->inputs;
1585             for (j = 0; pad && avfilter_pad_get_name(pad, j); j++) {
1586                 if (descr_cur >= descr + sizeof(descr) - 4)
1587                     break;
1588                 *(descr_cur++) = get_media_type_char(avfilter_pad_get_type(pad, j));
1589             }
1590             if (!j)
1591                 *(descr_cur++) = ((!i && (filter->flags & AVFILTER_FLAG_DYNAMIC_INPUTS)) ||
1592                                   ( i && (filter->flags & AVFILTER_FLAG_DYNAMIC_OUTPUTS))) ? 'N' : '|';
1593         }
1594         *descr_cur = 0;
1595         printf(" %c%c%c %-16s %-10s %s\n",
1596                filter->flags & AVFILTER_FLAG_SUPPORT_TIMELINE ? 'T' : '.',
1597                filter->flags & AVFILTER_FLAG_SLICE_THREADS    ? 'S' : '.',
1598                filter->process_command                        ? 'C' : '.',
1599                filter->name, descr, filter->description);
1600     }
1601 #else
1602     printf("No filters available: libavfilter disabled\n");
1603 #endif
1604     return 0;
1605 }
1606
1607 int show_colors(void *optctx, const char *opt, const char *arg)
1608 {
1609     const char *name;
1610     const uint8_t *rgb;
1611     int i;
1612
1613     printf("%-32s #RRGGBB\n", "name");
1614
1615     for (i = 0; name = av_get_known_color_name(i, &rgb); i++)
1616         printf("%-32s #%02x%02x%02x\n", name, rgb[0], rgb[1], rgb[2]);
1617
1618     return 0;
1619 }
1620
1621 int show_pix_fmts(void *optctx, const char *opt, const char *arg)
1622 {
1623     const AVPixFmtDescriptor *pix_desc = NULL;
1624
1625     printf("Pixel formats:\n"
1626            "I.... = Supported Input  format for conversion\n"
1627            ".O... = Supported Output format for conversion\n"
1628            "..H.. = Hardware accelerated format\n"
1629            "...P. = Paletted format\n"
1630            "....B = Bitstream format\n"
1631            "FLAGS NAME            NB_COMPONENTS BITS_PER_PIXEL\n"
1632            "-----\n");
1633
1634 #if !CONFIG_SWSCALE
1635 #   define sws_isSupportedInput(x)  0
1636 #   define sws_isSupportedOutput(x) 0
1637 #endif
1638
1639     while ((pix_desc = av_pix_fmt_desc_next(pix_desc))) {
1640         enum AVPixelFormat pix_fmt = av_pix_fmt_desc_get_id(pix_desc);
1641         printf("%c%c%c%c%c %-16s       %d            %2d\n",
1642                sws_isSupportedInput (pix_fmt)              ? 'I' : '.',
1643                sws_isSupportedOutput(pix_fmt)              ? 'O' : '.',
1644                pix_desc->flags & AV_PIX_FMT_FLAG_HWACCEL   ? 'H' : '.',
1645                pix_desc->flags & AV_PIX_FMT_FLAG_PAL       ? 'P' : '.',
1646                pix_desc->flags & AV_PIX_FMT_FLAG_BITSTREAM ? 'B' : '.',
1647                pix_desc->name,
1648                pix_desc->nb_components,
1649                av_get_bits_per_pixel(pix_desc));
1650     }
1651     return 0;
1652 }
1653
1654 int show_layouts(void *optctx, const char *opt, const char *arg)
1655 {
1656     int i = 0;
1657     uint64_t layout, j;
1658     const char *name, *descr;
1659
1660     printf("Individual channels:\n"
1661            "NAME           DESCRIPTION\n");
1662     for (i = 0; i < 63; i++) {
1663         name = av_get_channel_name((uint64_t)1 << i);
1664         if (!name)
1665             continue;
1666         descr = av_get_channel_description((uint64_t)1 << i);
1667         printf("%-14s %s\n", name, descr);
1668     }
1669     printf("\nStandard channel layouts:\n"
1670            "NAME           DECOMPOSITION\n");
1671     for (i = 0; !av_get_standard_channel_layout(i, &layout, &name); i++) {
1672         if (name) {
1673             printf("%-14s ", name);
1674             for (j = 1; j; j <<= 1)
1675                 if ((layout & j))
1676                     printf("%s%s", (layout & (j - 1)) ? "+" : "", av_get_channel_name(j));
1677             printf("\n");
1678         }
1679     }
1680     return 0;
1681 }
1682
1683 int show_sample_fmts(void *optctx, const char *opt, const char *arg)
1684 {
1685     int i;
1686     char fmt_str[128];
1687     for (i = -1; i < AV_SAMPLE_FMT_NB; i++)
1688         printf("%s\n", av_get_sample_fmt_string(fmt_str, sizeof(fmt_str), i));
1689     return 0;
1690 }
1691
1692 static void show_help_codec(const char *name, int encoder)
1693 {
1694     const AVCodecDescriptor *desc;
1695     const AVCodec *codec;
1696
1697     if (!name) {
1698         av_log(NULL, AV_LOG_ERROR, "No codec name specified.\n");
1699         return;
1700     }
1701
1702     codec = encoder ? avcodec_find_encoder_by_name(name) :
1703                       avcodec_find_decoder_by_name(name);
1704
1705     if (codec)
1706         print_codec(codec);
1707     else if ((desc = avcodec_descriptor_get_by_name(name))) {
1708         int printed = 0;
1709
1710         while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
1711             printed = 1;
1712             print_codec(codec);
1713         }
1714
1715         if (!printed) {
1716             av_log(NULL, AV_LOG_ERROR, "Codec '%s' is known to FFmpeg, "
1717                    "but no %s for it are available. FFmpeg might need to be "
1718                    "recompiled with additional external libraries.\n",
1719                    name, encoder ? "encoders" : "decoders");
1720         }
1721     } else {
1722         av_log(NULL, AV_LOG_ERROR, "Codec '%s' is not recognized by FFmpeg.\n",
1723                name);
1724     }
1725 }
1726
1727 static void show_help_demuxer(const char *name)
1728 {
1729     const AVInputFormat *fmt = av_find_input_format(name);
1730
1731     if (!fmt) {
1732         av_log(NULL, AV_LOG_ERROR, "Unknown format '%s'.\n", name);
1733         return;
1734     }
1735
1736     printf("Demuxer %s [%s]:\n", fmt->name, fmt->long_name);
1737
1738     if (fmt->extensions)
1739         printf("    Common extensions: %s.\n", fmt->extensions);
1740
1741     if (fmt->priv_class)
1742         show_help_children(fmt->priv_class, AV_OPT_FLAG_DECODING_PARAM);
1743 }
1744
1745 static void show_help_muxer(const char *name)
1746 {
1747     const AVCodecDescriptor *desc;
1748     const AVOutputFormat *fmt = av_guess_format(name, NULL, NULL);
1749
1750     if (!fmt) {
1751         av_log(NULL, AV_LOG_ERROR, "Unknown format '%s'.\n", name);
1752         return;
1753     }
1754
1755     printf("Muxer %s [%s]:\n", fmt->name, fmt->long_name);
1756
1757     if (fmt->extensions)
1758         printf("    Common extensions: %s.\n", fmt->extensions);
1759     if (fmt->mime_type)
1760         printf("    Mime type: %s.\n", fmt->mime_type);
1761     if (fmt->video_codec != AV_CODEC_ID_NONE &&
1762         (desc = avcodec_descriptor_get(fmt->video_codec))) {
1763         printf("    Default video codec: %s.\n", desc->name);
1764     }
1765     if (fmt->audio_codec != AV_CODEC_ID_NONE &&
1766         (desc = avcodec_descriptor_get(fmt->audio_codec))) {
1767         printf("    Default audio codec: %s.\n", desc->name);
1768     }
1769     if (fmt->subtitle_codec != AV_CODEC_ID_NONE &&
1770         (desc = avcodec_descriptor_get(fmt->subtitle_codec))) {
1771         printf("    Default subtitle codec: %s.\n", desc->name);
1772     }
1773
1774     if (fmt->priv_class)
1775         show_help_children(fmt->priv_class, AV_OPT_FLAG_ENCODING_PARAM);
1776 }
1777
1778 #if CONFIG_AVFILTER
1779 static void show_help_filter(const char *name)
1780 {
1781 #if CONFIG_AVFILTER
1782     const AVFilter *f = avfilter_get_by_name(name);
1783     int i, count;
1784
1785     if (!name) {
1786         av_log(NULL, AV_LOG_ERROR, "No filter name specified.\n");
1787         return;
1788     } else if (!f) {
1789         av_log(NULL, AV_LOG_ERROR, "Unknown filter '%s'.\n", name);
1790         return;
1791     }
1792
1793     printf("Filter %s\n", f->name);
1794     if (f->description)
1795         printf("  %s\n", f->description);
1796
1797     if (f->flags & AVFILTER_FLAG_SLICE_THREADS)
1798         printf("    slice threading supported\n");
1799
1800     printf("    Inputs:\n");
1801     count = avfilter_pad_count(f->inputs);
1802     for (i = 0; i < count; i++) {
1803         printf("       #%d: %s (%s)\n", i, avfilter_pad_get_name(f->inputs, i),
1804                media_type_string(avfilter_pad_get_type(f->inputs, i)));
1805     }
1806     if (f->flags & AVFILTER_FLAG_DYNAMIC_INPUTS)
1807         printf("        dynamic (depending on the options)\n");
1808     else if (!count)
1809         printf("        none (source filter)\n");
1810
1811     printf("    Outputs:\n");
1812     count = avfilter_pad_count(f->outputs);
1813     for (i = 0; i < count; i++) {
1814         printf("       #%d: %s (%s)\n", i, avfilter_pad_get_name(f->outputs, i),
1815                media_type_string(avfilter_pad_get_type(f->outputs, i)));
1816     }
1817     if (f->flags & AVFILTER_FLAG_DYNAMIC_OUTPUTS)
1818         printf("        dynamic (depending on the options)\n");
1819     else if (!count)
1820         printf("        none (sink filter)\n");
1821
1822     if (f->priv_class)
1823         show_help_children(f->priv_class, AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_FILTERING_PARAM |
1824                                           AV_OPT_FLAG_AUDIO_PARAM);
1825     if (f->flags & AVFILTER_FLAG_SUPPORT_TIMELINE)
1826         printf("This filter has support for timeline through the 'enable' option.\n");
1827 #else
1828     av_log(NULL, AV_LOG_ERROR, "Build without libavfilter; "
1829            "can not to satisfy request\n");
1830 #endif
1831 }
1832 #endif
1833
1834 int show_help(void *optctx, const char *opt, const char *arg)
1835 {
1836     char *topic, *par;
1837     av_log_set_callback(log_callback_help);
1838
1839     topic = av_strdup(arg ? arg : "");
1840     if (!topic)
1841         return AVERROR(ENOMEM);
1842     par = strchr(topic, '=');
1843     if (par)
1844         *par++ = 0;
1845
1846     if (!*topic) {
1847         show_help_default(topic, par);
1848     } else if (!strcmp(topic, "decoder")) {
1849         show_help_codec(par, 0);
1850     } else if (!strcmp(topic, "encoder")) {
1851         show_help_codec(par, 1);
1852     } else if (!strcmp(topic, "demuxer")) {
1853         show_help_demuxer(par);
1854     } else if (!strcmp(topic, "muxer")) {
1855         show_help_muxer(par);
1856 #if CONFIG_AVFILTER
1857     } else if (!strcmp(topic, "filter")) {
1858         show_help_filter(par);
1859 #endif
1860     } else {
1861         show_help_default(topic, par);
1862     }
1863
1864     av_freep(&topic);
1865     return 0;
1866 }
1867
1868 int read_yesno(void)
1869 {
1870     int c = getchar();
1871     int yesno = (av_toupper(c) == 'Y');
1872
1873     while (c != '\n' && c != EOF)
1874         c = getchar();
1875
1876     return yesno;
1877 }
1878
1879 FILE *get_preset_file(char *filename, size_t filename_size,
1880                       const char *preset_name, int is_path,
1881                       const char *codec_name)
1882 {
1883     FILE *f = NULL;
1884     int i;
1885     const char *base[3] = { getenv("FFMPEG_DATADIR"),
1886                             getenv("HOME"),
1887                             FFMPEG_DATADIR, };
1888
1889     if (is_path) {
1890         av_strlcpy(filename, preset_name, filename_size);
1891         f = fopen(filename, "r");
1892     } else {
1893 #ifdef _WIN32
1894         char datadir[MAX_PATH], *ls;
1895         base[2] = NULL;
1896
1897         if (GetModuleFileNameA(GetModuleHandleA(NULL), datadir, sizeof(datadir) - 1))
1898         {
1899             for (ls = datadir; ls < datadir + strlen(datadir); ls++)
1900                 if (*ls == '\\') *ls = '/';
1901
1902             if (ls = strrchr(datadir, '/'))
1903             {
1904                 *ls = 0;
1905                 strncat(datadir, "/ffpresets",  sizeof(datadir) - 1 - strlen(datadir));
1906                 base[2] = datadir;
1907             }
1908         }
1909 #endif
1910         for (i = 0; i < 3 && !f; i++) {
1911             if (!base[i])
1912                 continue;
1913             snprintf(filename, filename_size, "%s%s/%s.ffpreset", base[i],
1914                      i != 1 ? "" : "/.ffmpeg", preset_name);
1915             f = fopen(filename, "r");
1916             if (!f && codec_name) {
1917                 snprintf(filename, filename_size,
1918                          "%s%s/%s-%s.ffpreset",
1919                          base[i], i != 1 ? "" : "/.ffmpeg", codec_name,
1920                          preset_name);
1921                 f = fopen(filename, "r");
1922             }
1923         }
1924     }
1925
1926     return f;
1927 }
1928
1929 int check_stream_specifier(AVFormatContext *s, AVStream *st, const char *spec)
1930 {
1931     int ret = avformat_match_stream_specifier(s, st, spec);
1932     if (ret < 0)
1933         av_log(s, AV_LOG_ERROR, "Invalid stream specifier: %s.\n", spec);
1934     return ret;
1935 }
1936
1937 AVDictionary *filter_codec_opts(AVDictionary *opts, enum AVCodecID codec_id,
1938                                 AVFormatContext *s, AVStream *st, AVCodec *codec)
1939 {
1940     AVDictionary    *ret = NULL;
1941     AVDictionaryEntry *t = NULL;
1942     int            flags = s->oformat ? AV_OPT_FLAG_ENCODING_PARAM
1943                                       : AV_OPT_FLAG_DECODING_PARAM;
1944     char          prefix = 0;
1945     const AVClass    *cc = avcodec_get_class();
1946
1947     if (!codec)
1948         codec            = s->oformat ? avcodec_find_encoder(codec_id)
1949                                       : avcodec_find_decoder(codec_id);
1950
1951     switch (st->codec->codec_type) {
1952     case AVMEDIA_TYPE_VIDEO:
1953         prefix  = 'v';
1954         flags  |= AV_OPT_FLAG_VIDEO_PARAM;
1955         break;
1956     case AVMEDIA_TYPE_AUDIO:
1957         prefix  = 'a';
1958         flags  |= AV_OPT_FLAG_AUDIO_PARAM;
1959         break;
1960     case AVMEDIA_TYPE_SUBTITLE:
1961         prefix  = 's';
1962         flags  |= AV_OPT_FLAG_SUBTITLE_PARAM;
1963         break;
1964     }
1965
1966     while (t = av_dict_get(opts, "", t, AV_DICT_IGNORE_SUFFIX)) {
1967         char *p = strchr(t->key, ':');
1968
1969         /* check stream specification in opt name */
1970         if (p)
1971             switch (check_stream_specifier(s, st, p + 1)) {
1972             case  1: *p = 0; break;
1973             case  0:         continue;
1974             default:         exit_program(1);
1975             }
1976
1977         if (av_opt_find(&cc, t->key, NULL, flags, AV_OPT_SEARCH_FAKE_OBJ) ||
1978             !codec ||
1979             (codec->priv_class &&
1980              av_opt_find(&codec->priv_class, t->key, NULL, flags,
1981                          AV_OPT_SEARCH_FAKE_OBJ)))
1982             av_dict_set(&ret, t->key, t->value, 0);
1983         else if (t->key[0] == prefix &&
1984                  av_opt_find(&cc, t->key + 1, NULL, flags,
1985                              AV_OPT_SEARCH_FAKE_OBJ))
1986             av_dict_set(&ret, t->key + 1, t->value, 0);
1987
1988         if (p)
1989             *p = ':';
1990     }
1991     return ret;
1992 }
1993
1994 AVDictionary **setup_find_stream_info_opts(AVFormatContext *s,
1995                                            AVDictionary *codec_opts)
1996 {
1997     int i;
1998     AVDictionary **opts;
1999
2000     if (!s->nb_streams)
2001         return NULL;
2002     opts = av_mallocz_array(s->nb_streams, sizeof(*opts));
2003     if (!opts) {
2004         av_log(NULL, AV_LOG_ERROR,
2005                "Could not alloc memory for stream options.\n");
2006         return NULL;
2007     }
2008     for (i = 0; i < s->nb_streams; i++)
2009         opts[i] = filter_codec_opts(codec_opts, s->streams[i]->codec->codec_id,
2010                                     s, s->streams[i], NULL);
2011     return opts;
2012 }
2013
2014 void *grow_array(void *array, int elem_size, int *size, int new_size)
2015 {
2016     if (new_size >= INT_MAX / elem_size) {
2017         av_log(NULL, AV_LOG_ERROR, "Array too big.\n");
2018         exit_program(1);
2019     }
2020     if (*size < new_size) {
2021         uint8_t *tmp = av_realloc_array(array, new_size, elem_size);
2022         if (!tmp) {
2023             av_log(NULL, AV_LOG_ERROR, "Could not alloc buffer.\n");
2024             exit_program(1);
2025         }
2026         memset(tmp + *size*elem_size, 0, (new_size-*size) * elem_size);
2027         *size = new_size;
2028         return tmp;
2029     }
2030     return array;
2031 }
2032
2033 double get_rotation(AVStream *st)
2034 {
2035     AVDictionaryEntry *rotate_tag = av_dict_get(st->metadata, "rotate", NULL, 0);
2036     uint8_t* displaymatrix = av_stream_get_side_data(st,
2037                                                      AV_PKT_DATA_DISPLAYMATRIX, NULL);
2038     double theta = 0;
2039
2040     if (rotate_tag && *rotate_tag->value && strcmp(rotate_tag->value, "0")) {
2041         char *tail;
2042         theta = av_strtod(rotate_tag->value, &tail);
2043         if (*tail)
2044             theta = 0;
2045     }
2046     if (displaymatrix && !theta)
2047         theta = -av_display_rotation_get((int32_t*) displaymatrix);
2048
2049     theta -= 360*floor(theta/360 + 0.9/360);
2050
2051     if (fabs(theta - 90*round(theta/90)) > 2)
2052         av_log(NULL, AV_LOG_WARNING, "Odd rotation angle.\n"
2053                "If you want to help, upload a sample "
2054                "of this file to ftp://upload.ffmpeg.org/incoming/ "
2055                "and contact the ffmpeg-devel mailing list. (ffmpeg-devel@ffmpeg.org)");
2056
2057     return theta;
2058 }
2059
2060 #if CONFIG_AVDEVICE
2061 static int print_device_sources(AVInputFormat *fmt, AVDictionary *opts)
2062 {
2063     int ret, i;
2064     AVDeviceInfoList *device_list = NULL;
2065
2066     if (!fmt || !fmt->priv_class  || !AV_IS_INPUT_DEVICE(fmt->priv_class->category))
2067         return AVERROR(EINVAL);
2068
2069     printf("Audo-detected sources for %s:\n", fmt->name);
2070     if (!fmt->get_device_list) {
2071         ret = AVERROR(ENOSYS);
2072         printf("Cannot list sources. Not implemented.\n");
2073         goto fail;
2074     }
2075
2076     if ((ret = avdevice_list_input_sources(fmt, NULL, opts, &device_list)) < 0) {
2077         printf("Cannot list sources.\n");
2078         goto fail;
2079     }
2080
2081     for (i = 0; i < device_list->nb_devices; i++) {
2082         printf("%s %s [%s]\n", device_list->default_device == i ? "*" : " ",
2083                device_list->devices[i]->device_name, device_list->devices[i]->device_description);
2084     }
2085
2086   fail:
2087     avdevice_free_list_devices(&device_list);
2088     return ret;
2089 }
2090
2091 static int print_device_sinks(AVOutputFormat *fmt, AVDictionary *opts)
2092 {
2093     int ret, i;
2094     AVDeviceInfoList *device_list = NULL;
2095
2096     if (!fmt || !fmt->priv_class  || !AV_IS_OUTPUT_DEVICE(fmt->priv_class->category))
2097         return AVERROR(EINVAL);
2098
2099     printf("Audo-detected sinks for %s:\n", fmt->name);
2100     if (!fmt->get_device_list) {
2101         ret = AVERROR(ENOSYS);
2102         printf("Cannot list sinks. Not implemented.\n");
2103         goto fail;
2104     }
2105
2106     if ((ret = avdevice_list_output_sinks(fmt, NULL, opts, &device_list)) < 0) {
2107         printf("Cannot list sinks.\n");
2108         goto fail;
2109     }
2110
2111     for (i = 0; i < device_list->nb_devices; i++) {
2112         printf("%s %s [%s]\n", device_list->default_device == i ? "*" : " ",
2113                device_list->devices[i]->device_name, device_list->devices[i]->device_description);
2114     }
2115
2116   fail:
2117     avdevice_free_list_devices(&device_list);
2118     return ret;
2119 }
2120
2121 static int show_sinks_sources_parse_arg(const char *arg, char **dev, AVDictionary **opts)
2122 {
2123     int ret;
2124     if (arg) {
2125         char *opts_str = NULL;
2126         av_assert0(dev && opts);
2127         *dev = av_strdup(arg);
2128         if (!*dev)
2129             return AVERROR(ENOMEM);
2130         if ((opts_str = strchr(*dev, ','))) {
2131             *(opts_str++) = '\0';
2132             if (opts_str[0] && ((ret = av_dict_parse_string(opts, opts_str, "=", ":", 0)) < 0)) {
2133                 av_freep(dev);
2134                 return ret;
2135             }
2136         }
2137     } else
2138         printf("\nDevice name is not provided.\n"
2139                 "You can pass devicename[,opt1=val1[,opt2=val2...]] as an argument.\n\n");
2140     return 0;
2141 }
2142
2143 int show_sources(void *optctx, const char *opt, const char *arg)
2144 {
2145     AVInputFormat *fmt = NULL;
2146     char *dev = NULL;
2147     AVDictionary *opts = NULL;
2148     int ret = 0;
2149     int error_level = av_log_get_level();
2150
2151     av_log_set_level(AV_LOG_ERROR);
2152
2153     if ((ret = show_sinks_sources_parse_arg(arg, &dev, &opts)) < 0)
2154         goto fail;
2155
2156     do {
2157         fmt = av_input_audio_device_next(fmt);
2158         if (fmt) {
2159             if (!strcmp(fmt->name, "lavfi"))
2160                 continue; //it's pointless to probe lavfi
2161             if (dev && !av_match_name(dev, fmt->name))
2162                 continue;
2163             print_device_sources(fmt, opts);
2164         }
2165     } while (fmt);
2166     do {
2167         fmt = av_input_video_device_next(fmt);
2168         if (fmt) {
2169             if (dev && !av_match_name(dev, fmt->name))
2170                 continue;
2171             print_device_sources(fmt, opts);
2172         }
2173     } while (fmt);
2174   fail:
2175     av_dict_free(&opts);
2176     av_free(dev);
2177     av_log_set_level(error_level);
2178     return ret;
2179 }
2180
2181 int show_sinks(void *optctx, const char *opt, const char *arg)
2182 {
2183     AVOutputFormat *fmt = NULL;
2184     char *dev = NULL;
2185     AVDictionary *opts = NULL;
2186     int ret = 0;
2187     int error_level = av_log_get_level();
2188
2189     av_log_set_level(AV_LOG_ERROR);
2190
2191     if ((ret = show_sinks_sources_parse_arg(arg, &dev, &opts)) < 0)
2192         goto fail;
2193
2194     do {
2195         fmt = av_output_audio_device_next(fmt);
2196         if (fmt) {
2197             if (dev && !av_match_name(dev, fmt->name))
2198                 continue;
2199             print_device_sinks(fmt, opts);
2200         }
2201     } while (fmt);
2202     do {
2203         fmt = av_output_video_device_next(fmt);
2204         if (fmt) {
2205             if (dev && !av_match_name(dev, fmt->name))
2206                 continue;
2207             print_device_sinks(fmt, opts);
2208         }
2209     } while (fmt);
2210   fail:
2211     av_dict_free(&opts);
2212     av_free(dev);
2213     av_log_set_level(error_level);
2214     return ret;
2215 }
2216
2217 #endif