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