cmdutils: extend -h to allow printing codec details.
[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 Libav.
6  *
7  * Libav 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  * Libav 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 Libav; 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 "libavformat/avformat.h"
33 #include "libavfilter/avfilter.h"
34 #include "libavdevice/avdevice.h"
35 #include "libavresample/avresample.h"
36 #include "libswscale/swscale.h"
37 #include "libavutil/avassert.h"
38 #include "libavutil/avstring.h"
39 #include "libavutil/mathematics.h"
40 #include "libavutil/imgutils.h"
41 #include "libavutil/parseutils.h"
42 #include "libavutil/pixdesc.h"
43 #include "libavutil/eval.h"
44 #include "libavutil/dict.h"
45 #include "libavutil/opt.h"
46 #include "cmdutils.h"
47 #include "version.h"
48 #if CONFIG_NETWORK
49 #include "libavformat/network.h"
50 #endif
51 #if HAVE_SYS_RESOURCE_H
52 #include <sys/resource.h>
53 #endif
54
55 struct SwsContext *sws_opts;
56 AVDictionary *format_opts, *codec_opts;
57
58 static const int this_year = 2012;
59
60 void init_opts(void)
61 {
62 #if CONFIG_SWSCALE
63     sws_opts = sws_getContext(16, 16, 0, 16, 16, 0, SWS_BICUBIC,
64                               NULL, NULL, NULL);
65 #endif
66 }
67
68 void uninit_opts(void)
69 {
70 #if CONFIG_SWSCALE
71     sws_freeContext(sws_opts);
72     sws_opts = NULL;
73 #endif
74     av_dict_free(&format_opts);
75     av_dict_free(&codec_opts);
76 }
77
78 void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
79 {
80     vfprintf(stdout, fmt, vl);
81 }
82
83 double parse_number_or_die(const char *context, const char *numstr, int type,
84                            double min, double max)
85 {
86     char *tail;
87     const char *error;
88     double d = av_strtod(numstr, &tail);
89     if (*tail)
90         error = "Expected number for %s but found: %s\n";
91     else if (d < min || d > max)
92         error = "The value for %s was %s which is not within %f - %f\n";
93     else if (type == OPT_INT64 && (int64_t)d != d)
94         error = "Expected int64 for %s but found %s\n";
95     else if (type == OPT_INT && (int)d != d)
96         error = "Expected int for %s but found %s\n";
97     else
98         return d;
99     av_log(NULL, AV_LOG_FATAL, error, context, numstr, min, max);
100     exit_program(1);
101     return 0;
102 }
103
104 int64_t parse_time_or_die(const char *context, const char *timestr,
105                           int is_duration)
106 {
107     int64_t us;
108     if (av_parse_time(&us, timestr, is_duration) < 0) {
109         av_log(NULL, AV_LOG_FATAL, "Invalid %s specification for %s: %s\n",
110                is_duration ? "duration" : "date", context, timestr);
111         exit_program(1);
112     }
113     return us;
114 }
115
116 void show_help_options(const OptionDef *options, const char *msg, int req_flags,
117                        int rej_flags)
118 {
119     const OptionDef *po;
120     int first;
121
122     first = 1;
123     for (po = options; po->name != NULL; po++) {
124         char buf[64];
125
126         if (((po->flags & req_flags) != req_flags) ||
127             (po->flags & rej_flags))
128             continue;
129
130         if (first) {
131             printf("%s\n", msg);
132             first = 0;
133         }
134         av_strlcpy(buf, po->name, sizeof(buf));
135         if (po->argname) {
136             av_strlcat(buf, " ", sizeof(buf));
137             av_strlcat(buf, po->argname, sizeof(buf));
138         }
139         printf("-%-17s  %s\n", buf, po->help);
140     }
141     printf("\n");
142 }
143
144 void show_help_children(const AVClass *class, int flags)
145 {
146     const AVClass *child = NULL;
147     av_opt_show2(&class, NULL, flags, 0);
148     printf("\n");
149
150     while (child = av_opt_child_class_next(class, child))
151         show_help_children(child, flags);
152 }
153
154 static const OptionDef *find_option(const OptionDef *po, const char *name)
155 {
156     const char *p = strchr(name, ':');
157     int len = p ? p - name : strlen(name);
158
159     while (po->name != NULL) {
160         if (!strncmp(name, po->name, len) && strlen(po->name) == len)
161             break;
162         po++;
163     }
164     return po;
165 }
166
167 #if defined(_WIN32) && !defined(__MINGW32CE__)
168 #include <windows.h>
169 #include <shellapi.h>
170 /* Will be leaked on exit */
171 static char** win32_argv_utf8 = NULL;
172 static int win32_argc = 0;
173
174 /**
175  * Prepare command line arguments for executable.
176  * For Windows - perform wide-char to UTF-8 conversion.
177  * Input arguments should be main() function arguments.
178  * @param argc_ptr Arguments number (including executable)
179  * @param argv_ptr Arguments list.
180  */
181 static void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
182 {
183     char *argstr_flat;
184     wchar_t **argv_w;
185     int i, buffsize = 0, offset = 0;
186
187     if (win32_argv_utf8) {
188         *argc_ptr = win32_argc;
189         *argv_ptr = win32_argv_utf8;
190         return;
191     }
192
193     win32_argc = 0;
194     argv_w = CommandLineToArgvW(GetCommandLineW(), &win32_argc);
195     if (win32_argc <= 0 || !argv_w)
196         return;
197
198     /* determine the UTF-8 buffer size (including NULL-termination symbols) */
199     for (i = 0; i < win32_argc; i++)
200         buffsize += WideCharToMultiByte(CP_UTF8, 0, argv_w[i], -1,
201                                         NULL, 0, NULL, NULL);
202
203     win32_argv_utf8 = av_mallocz(sizeof(char *) * (win32_argc + 1) + buffsize);
204     argstr_flat     = (char *)win32_argv_utf8 + sizeof(char *) * (win32_argc + 1);
205     if (win32_argv_utf8 == NULL) {
206         LocalFree(argv_w);
207         return;
208     }
209
210     for (i = 0; i < win32_argc; i++) {
211         win32_argv_utf8[i] = &argstr_flat[offset];
212         offset += WideCharToMultiByte(CP_UTF8, 0, argv_w[i], -1,
213                                       &argstr_flat[offset],
214                                       buffsize - offset, NULL, NULL);
215     }
216     win32_argv_utf8[i] = NULL;
217     LocalFree(argv_w);
218
219     *argc_ptr = win32_argc;
220     *argv_ptr = win32_argv_utf8;
221 }
222 #else
223 static inline void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
224 {
225     /* nothing to do */
226 }
227 #endif /* WIN32 && !__MINGW32CE__ */
228
229 int parse_option(void *optctx, const char *opt, const char *arg,
230                  const OptionDef *options)
231 {
232     const OptionDef *po;
233     int bool_val = 1;
234     int *dstcount;
235     void *dst;
236
237     po = find_option(options, opt);
238     if (!po->name && opt[0] == 'n' && opt[1] == 'o') {
239         /* handle 'no' bool option */
240         po = find_option(options, opt + 2);
241         if ((po->name && (po->flags & OPT_BOOL)))
242             bool_val = 0;
243     }
244     if (!po->name)
245         po = find_option(options, "default");
246     if (!po->name) {
247         av_log(NULL, AV_LOG_ERROR, "Unrecognized option '%s'\n", opt);
248         return AVERROR(EINVAL);
249     }
250     if (po->flags & HAS_ARG && !arg) {
251         av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'\n", opt);
252         return AVERROR(EINVAL);
253     }
254
255     /* new-style options contain an offset into optctx, old-style address of
256      * a global var*/
257     dst = po->flags & (OPT_OFFSET | OPT_SPEC) ? (uint8_t *)optctx + po->u.off
258                                               : po->u.dst_ptr;
259
260     if (po->flags & OPT_SPEC) {
261         SpecifierOpt **so = dst;
262         char *p = strchr(opt, ':');
263
264         dstcount = (int *)(so + 1);
265         *so = grow_array(*so, sizeof(**so), dstcount, *dstcount + 1);
266         (*so)[*dstcount - 1].specifier = av_strdup(p ? p + 1 : "");
267         dst = &(*so)[*dstcount - 1].u;
268     }
269
270     if (po->flags & OPT_STRING) {
271         char *str;
272         str = av_strdup(arg);
273         *(char **)dst = str;
274     } else if (po->flags & OPT_BOOL) {
275         *(int *)dst = bool_val;
276     } else if (po->flags & OPT_INT) {
277         *(int *)dst = parse_number_or_die(opt, arg, OPT_INT64, INT_MIN, INT_MAX);
278     } else if (po->flags & OPT_INT64) {
279         *(int64_t *)dst = parse_number_or_die(opt, arg, OPT_INT64, INT64_MIN, INT64_MAX);
280     } else if (po->flags & OPT_TIME) {
281         *(int64_t *)dst = parse_time_or_die(opt, arg, 1);
282     } else if (po->flags & OPT_FLOAT) {
283         *(float *)dst = parse_number_or_die(opt, arg, OPT_FLOAT, -INFINITY, INFINITY);
284     } else if (po->flags & OPT_DOUBLE) {
285         *(double *)dst = parse_number_or_die(opt, arg, OPT_DOUBLE, -INFINITY, INFINITY);
286     } else if (po->u.func_arg) {
287         int ret = po->flags & OPT_FUNC2 ? po->u.func2_arg(optctx, opt, arg)
288                                         : po->u.func_arg(opt, arg);
289         if (ret < 0) {
290             av_log(NULL, AV_LOG_ERROR,
291                    "Failed to set value '%s' for option '%s'\n", arg, opt);
292             return ret;
293         }
294     }
295     if (po->flags & OPT_EXIT)
296         exit_program(0);
297     return !!(po->flags & HAS_ARG);
298 }
299
300 void parse_options(void *optctx, int argc, char **argv, const OptionDef *options,
301                    void (*parse_arg_function)(void *, const char*))
302 {
303     const char *opt;
304     int optindex, handleoptions = 1, ret;
305
306     /* perform system-dependent conversions for arguments list */
307     prepare_app_arguments(&argc, &argv);
308
309     /* parse options */
310     optindex = 1;
311     while (optindex < argc) {
312         opt = argv[optindex++];
313
314         if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
315             if (opt[1] == '-' && opt[2] == '\0') {
316                 handleoptions = 0;
317                 continue;
318             }
319             opt++;
320
321             if ((ret = parse_option(optctx, opt, argv[optindex], options)) < 0)
322                 exit_program(1);
323             optindex += ret;
324         } else {
325             if (parse_arg_function)
326                 parse_arg_function(optctx, opt);
327         }
328     }
329 }
330
331 int locate_option(int argc, char **argv, const OptionDef *options,
332                   const char *optname)
333 {
334     const OptionDef *po;
335     int i;
336
337     for (i = 1; i < argc; i++) {
338         const char *cur_opt = argv[i];
339
340         if (*cur_opt++ != '-')
341             continue;
342
343         po = find_option(options, cur_opt);
344         if (!po->name && cur_opt[0] == 'n' && cur_opt[1] == 'o')
345             po = find_option(options, cur_opt + 2);
346
347         if ((!po->name && !strcmp(cur_opt, optname)) ||
348              (po->name && !strcmp(optname, po->name)))
349             return i;
350
351         if (!po || po->flags & HAS_ARG)
352             i++;
353     }
354     return 0;
355 }
356
357 void parse_loglevel(int argc, char **argv, const OptionDef *options)
358 {
359     int idx = locate_option(argc, argv, options, "loglevel");
360     if (!idx)
361         idx = locate_option(argc, argv, options, "v");
362     if (idx && argv[idx + 1])
363         opt_loglevel("loglevel", argv[idx + 1]);
364 }
365
366 #define FLAGS (o->type == AV_OPT_TYPE_FLAGS) ? AV_DICT_APPEND : 0
367 int opt_default(const char *opt, const char *arg)
368 {
369     const AVOption *o;
370     char opt_stripped[128];
371     const char *p;
372     const AVClass *cc = avcodec_get_class(), *fc = avformat_get_class(), *sc = sws_get_class();
373
374     if (!(p = strchr(opt, ':')))
375         p = opt + strlen(opt);
376     av_strlcpy(opt_stripped, opt, FFMIN(sizeof(opt_stripped), p - opt + 1));
377
378     if ((o = av_opt_find(&cc, opt_stripped, NULL, 0,
379                          AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ)) ||
380         ((opt[0] == 'v' || opt[0] == 'a' || opt[0] == 's') &&
381          (o = av_opt_find(&cc, opt + 1, NULL, 0, AV_OPT_SEARCH_FAKE_OBJ))))
382         av_dict_set(&codec_opts, opt, arg, FLAGS);
383     else if ((o = av_opt_find(&fc, opt, NULL, 0,
384                               AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ)))
385         av_dict_set(&format_opts, opt, arg, FLAGS);
386     else if ((o = av_opt_find(&sc, opt, NULL, 0,
387                               AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
388         // XXX we only support sws_flags, not arbitrary sws options
389         int ret = av_opt_set(sws_opts, opt, arg, 0);
390         if (ret < 0) {
391             av_log(NULL, AV_LOG_ERROR, "Error setting option %s.\n", opt);
392             return ret;
393         }
394     }
395
396     if (o)
397         return 0;
398     av_log(NULL, AV_LOG_ERROR, "Unrecognized option '%s'\n", opt);
399     return AVERROR_OPTION_NOT_FOUND;
400 }
401
402 int opt_loglevel(const char *opt, const char *arg)
403 {
404     const struct { const char *name; int level; } log_levels[] = {
405         { "quiet"  , AV_LOG_QUIET   },
406         { "panic"  , AV_LOG_PANIC   },
407         { "fatal"  , AV_LOG_FATAL   },
408         { "error"  , AV_LOG_ERROR   },
409         { "warning", AV_LOG_WARNING },
410         { "info"   , AV_LOG_INFO    },
411         { "verbose", AV_LOG_VERBOSE },
412         { "debug"  , AV_LOG_DEBUG   },
413     };
414     char *tail;
415     int level;
416     int i;
417
418     for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
419         if (!strcmp(log_levels[i].name, arg)) {
420             av_log_set_level(log_levels[i].level);
421             return 0;
422         }
423     }
424
425     level = strtol(arg, &tail, 10);
426     if (*tail) {
427         av_log(NULL, AV_LOG_FATAL, "Invalid loglevel \"%s\". "
428                "Possible levels are numbers or:\n", arg);
429         for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
430             av_log(NULL, AV_LOG_FATAL, "\"%s\"\n", log_levels[i].name);
431         exit_program(1);
432     }
433     av_log_set_level(level);
434     return 0;
435 }
436
437 int opt_timelimit(const char *opt, const char *arg)
438 {
439 #if HAVE_SETRLIMIT
440     int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
441     struct rlimit rl = { lim, lim + 1 };
442     if (setrlimit(RLIMIT_CPU, &rl))
443         perror("setrlimit");
444 #else
445     av_log(NULL, AV_LOG_WARNING, "-%s not implemented on this OS\n", opt);
446 #endif
447     return 0;
448 }
449
450 void print_error(const char *filename, int err)
451 {
452     char errbuf[128];
453     const char *errbuf_ptr = errbuf;
454
455     if (av_strerror(err, errbuf, sizeof(errbuf)) < 0)
456         errbuf_ptr = strerror(AVUNERROR(err));
457     av_log(NULL, AV_LOG_ERROR, "%s: %s\n", filename, errbuf_ptr);
458 }
459
460 static int warned_cfg = 0;
461
462 #define INDENT        1
463 #define SHOW_VERSION  2
464 #define SHOW_CONFIG   4
465
466 #define PRINT_LIB_INFO(libname, LIBNAME, flags, level)                  \
467     if (CONFIG_##LIBNAME) {                                             \
468         const char *indent = flags & INDENT? "  " : "";                 \
469         if (flags & SHOW_VERSION) {                                     \
470             unsigned int version = libname##_version();                 \
471             av_log(NULL, level,                                         \
472                    "%slib%-10s %2d.%3d.%2d / %2d.%3d.%2d\n",            \
473                    indent, #libname,                                    \
474                    LIB##LIBNAME##_VERSION_MAJOR,                        \
475                    LIB##LIBNAME##_VERSION_MINOR,                        \
476                    LIB##LIBNAME##_VERSION_MICRO,                        \
477                    version >> 16, version >> 8 & 0xff, version & 0xff); \
478         }                                                               \
479         if (flags & SHOW_CONFIG) {                                      \
480             const char *cfg = libname##_configuration();                \
481             if (strcmp(LIBAV_CONFIGURATION, cfg)) {                     \
482                 if (!warned_cfg) {                                      \
483                     av_log(NULL, level,                                 \
484                             "%sWARNING: library configuration mismatch\n", \
485                             indent);                                    \
486                     warned_cfg = 1;                                     \
487                 }                                                       \
488                 av_log(NULL, level, "%s%-11s configuration: %s\n",      \
489                         indent, #libname, cfg);                         \
490             }                                                           \
491         }                                                               \
492     }                                                                   \
493
494 static void print_all_libs_info(int flags, int level)
495 {
496     PRINT_LIB_INFO(avutil,   AVUTIL,   flags, level);
497     PRINT_LIB_INFO(avcodec,  AVCODEC,  flags, level);
498     PRINT_LIB_INFO(avformat, AVFORMAT, flags, level);
499     PRINT_LIB_INFO(avdevice, AVDEVICE, flags, level);
500     PRINT_LIB_INFO(avfilter, AVFILTER, flags, level);
501     PRINT_LIB_INFO(avresample, AVRESAMPLE, flags, level);
502     PRINT_LIB_INFO(swscale,  SWSCALE,  flags, level);
503 }
504
505 void show_banner(void)
506 {
507     av_log(NULL, AV_LOG_INFO,
508            "%s version " LIBAV_VERSION ", Copyright (c) %d-%d the Libav developers\n",
509            program_name, program_birth_year, this_year);
510     av_log(NULL, AV_LOG_INFO, "  built on %s %s with %s\n",
511            __DATE__, __TIME__, CC_IDENT);
512     av_log(NULL, AV_LOG_VERBOSE, "  configuration: " LIBAV_CONFIGURATION "\n");
513     print_all_libs_info(INDENT|SHOW_CONFIG,  AV_LOG_VERBOSE);
514     print_all_libs_info(INDENT|SHOW_VERSION, AV_LOG_VERBOSE);
515 }
516
517 int show_version(const char *opt, const char *arg)
518 {
519     av_log_set_callback(log_callback_help);
520     printf("%s " LIBAV_VERSION "\n", program_name);
521     print_all_libs_info(SHOW_VERSION, AV_LOG_INFO);
522
523     return 0;
524 }
525
526 int show_license(const char *opt, const char *arg)
527 {
528     printf(
529 #if CONFIG_NONFREE
530     "This version of %s has nonfree parts compiled in.\n"
531     "Therefore it is not legally redistributable.\n",
532     program_name
533 #elif CONFIG_GPLV3
534     "%s is free software; you can redistribute it and/or modify\n"
535     "it under the terms of the GNU General Public License as published by\n"
536     "the Free Software Foundation; either version 3 of the License, or\n"
537     "(at your option) any later version.\n"
538     "\n"
539     "%s is distributed in the hope that it will be useful,\n"
540     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
541     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
542     "GNU General Public License for more details.\n"
543     "\n"
544     "You should have received a copy of the GNU General Public License\n"
545     "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
546     program_name, program_name, program_name
547 #elif CONFIG_GPL
548     "%s is free software; you can redistribute it and/or modify\n"
549     "it under the terms of the GNU General Public License as published by\n"
550     "the Free Software Foundation; either version 2 of the License, or\n"
551     "(at your option) any later version.\n"
552     "\n"
553     "%s is distributed in the hope that it will be useful,\n"
554     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
555     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
556     "GNU General Public License for more details.\n"
557     "\n"
558     "You should have received a copy of the GNU General Public License\n"
559     "along with %s; if not, write to the Free Software\n"
560     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
561     program_name, program_name, program_name
562 #elif CONFIG_LGPLV3
563     "%s is free software; you can redistribute it and/or modify\n"
564     "it under the terms of the GNU Lesser General Public License as published by\n"
565     "the Free Software Foundation; either version 3 of the License, or\n"
566     "(at your option) any later version.\n"
567     "\n"
568     "%s is distributed in the hope that it will be useful,\n"
569     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
570     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
571     "GNU Lesser General Public License for more details.\n"
572     "\n"
573     "You should have received a copy of the GNU Lesser General Public License\n"
574     "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
575     program_name, program_name, program_name
576 #else
577     "%s is free software; you can redistribute it and/or\n"
578     "modify it under the terms of the GNU Lesser General Public\n"
579     "License as published by the Free Software Foundation; either\n"
580     "version 2.1 of the License, or (at your option) any later version.\n"
581     "\n"
582     "%s is distributed in the hope that it will be useful,\n"
583     "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
584     "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\n"
585     "Lesser General Public License for more details.\n"
586     "\n"
587     "You should have received a copy of the GNU Lesser General Public\n"
588     "License along with %s; if not, write to the Free Software\n"
589     "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
590     program_name, program_name, program_name
591 #endif
592     );
593
594     return 0;
595 }
596
597 int show_formats(const char *opt, const char *arg)
598 {
599     AVInputFormat *ifmt  = NULL;
600     AVOutputFormat *ofmt = NULL;
601     const char *last_name;
602
603     printf("File formats:\n"
604            " D. = Demuxing supported\n"
605            " .E = Muxing supported\n"
606            " --\n");
607     last_name = "000";
608     for (;;) {
609         int decode = 0;
610         int encode = 0;
611         const char *name      = NULL;
612         const char *long_name = NULL;
613
614         while ((ofmt = av_oformat_next(ofmt))) {
615             if ((name == NULL || strcmp(ofmt->name, name) < 0) &&
616                 strcmp(ofmt->name, last_name) > 0) {
617                 name      = ofmt->name;
618                 long_name = ofmt->long_name;
619                 encode    = 1;
620             }
621         }
622         while ((ifmt = av_iformat_next(ifmt))) {
623             if ((name == NULL || strcmp(ifmt->name, name) < 0) &&
624                 strcmp(ifmt->name, last_name) > 0) {
625                 name      = ifmt->name;
626                 long_name = ifmt->long_name;
627                 encode    = 0;
628             }
629             if (name && strcmp(ifmt->name, name) == 0)
630                 decode = 1;
631         }
632         if (name == NULL)
633             break;
634         last_name = name;
635
636         printf(" %s%s %-15s %s\n",
637                decode ? "D" : " ",
638                encode ? "E" : " ",
639                name,
640             long_name ? long_name:" ");
641     }
642     return 0;
643 }
644
645 #define PRINT_CODEC_SUPPORTED(codec, field, type, list_name, term, get_name) \
646     if (codec->field) {                                                      \
647         const type *p = c->field;                                            \
648                                                                              \
649         printf("    Supported " list_name ":");                              \
650         while (*p != term) {                                                 \
651             get_name(*p);                                                    \
652             printf(" %s", name);                                             \
653             p++;                                                             \
654         }                                                                    \
655         printf("\n");                                                        \
656     }                                                                        \
657
658 static void print_codec(const AVCodec *c)
659 {
660     int encoder = av_codec_is_encoder(c);
661
662     printf("%s %s [%s]:\n", encoder ? "Encoder" : "Decoder", c->name,
663            c->long_name ? c->long_name : "");
664
665     if (c->type == AVMEDIA_TYPE_VIDEO) {
666         printf("    Threading capabilities: ");
667         switch (c->capabilities & (CODEC_CAP_FRAME_THREADS |
668                                    CODEC_CAP_SLICE_THREADS)) {
669         case CODEC_CAP_FRAME_THREADS |
670              CODEC_CAP_SLICE_THREADS: printf("frame and slice"); break;
671         case CODEC_CAP_FRAME_THREADS: printf("frame");           break;
672         case CODEC_CAP_SLICE_THREADS: printf("slice");           break;
673         default:                      printf("no");              break;
674         }
675         printf("\n");
676     }
677
678     if (c->supported_framerates) {
679         const AVRational *fps = c->supported_framerates;
680
681         printf("    Supported framerates:");
682         while (fps->num) {
683             printf(" %d/%d", fps->num, fps->den);
684             fps++;
685         }
686         printf("\n");
687     }
688     PRINT_CODEC_SUPPORTED(c, pix_fmts, enum PixelFormat, "pixel formats",
689                           PIX_FMT_NONE, GET_PIX_FMT_NAME);
690     PRINT_CODEC_SUPPORTED(c, supported_samplerates, int, "sample rates", 0,
691                           GET_SAMPLE_RATE_NAME);
692     PRINT_CODEC_SUPPORTED(c, sample_fmts, enum AVSampleFormat, "sample formats",
693                           AV_SAMPLE_FMT_NONE, GET_SAMPLE_FMT_NAME);
694     PRINT_CODEC_SUPPORTED(c, channel_layouts, uint64_t, "channel layouts",
695                           0, GET_CH_LAYOUT_DESC);
696
697     if (c->priv_class) {
698         show_help_children(c->priv_class,
699                            AV_OPT_FLAG_ENCODING_PARAM |
700                            AV_OPT_FLAG_DECODING_PARAM);
701     }
702 }
703
704 static char get_media_type_char(enum AVMediaType type)
705 {
706     switch (type) {
707         case AVMEDIA_TYPE_VIDEO:    return 'V';
708         case AVMEDIA_TYPE_AUDIO:    return 'A';
709         case AVMEDIA_TYPE_SUBTITLE: return 'S';
710         default:                    return '?';
711     }
712 }
713
714 static const AVCodec *next_codec_for_id(enum AVCodecID id, const AVCodec *prev,
715                                         int encoder)
716 {
717     while ((prev = av_codec_next(prev))) {
718         if (prev->id == id &&
719             (encoder ? av_codec_is_encoder(prev) : av_codec_is_decoder(prev)))
720             return prev;
721     }
722     return NULL;
723 }
724
725 static void print_codecs_for_id(enum AVCodecID id, int encoder)
726 {
727     const AVCodec *codec = NULL;
728
729     printf(" (%s: ", encoder ? "encoders" : "decoders");
730
731     while ((codec = next_codec_for_id(id, codec, encoder)))
732         printf("%s ", codec->name);
733
734     printf(")");
735 }
736
737 int show_codecs(const char *opt, const char *arg)
738 {
739     const AVCodecDescriptor *desc = NULL;
740
741     printf("Codecs:\n"
742            " D... = Decoding supported\n"
743            " .E.. = Encoding supported\n"
744            " ..V. = Video codec\n"
745            " ..A. = Audio codec\n"
746            " ..S. = Subtitle codec\n"
747            " ...I = Intra frame-only codec\n"
748            " -----\n");
749     while ((desc = avcodec_descriptor_next(desc))) {
750         const AVCodec *codec = NULL;
751
752         printf(avcodec_find_decoder(desc->id) ? "D" : ".");
753         printf(avcodec_find_encoder(desc->id) ? "E" : ".");
754
755         printf("%c", get_media_type_char(desc->type));
756         printf((desc->props & AV_CODEC_PROP_INTRA_ONLY) ? "I" : ".");
757
758         printf(" %-20s %s", desc->name, desc->long_name ? desc->long_name : "");
759
760         /* print decoders/encoders when there's more than one or their
761          * names are different from codec name */
762         while ((codec = next_codec_for_id(desc->id, codec, 0))) {
763             if (strcmp(codec->name, desc->name)) {
764                 print_codecs_for_id(desc->id, 0);
765                 break;
766             }
767         }
768         codec = NULL;
769         while ((codec = next_codec_for_id(desc->id, codec, 1))) {
770             if (strcmp(codec->name, desc->name)) {
771                 print_codecs_for_id(desc->id, 1);
772                 break;
773             }
774         }
775
776         printf("\n");
777     }
778     return 0;
779 }
780
781 static void print_codecs(int encoder)
782 {
783     const AVCodecDescriptor *desc = NULL;
784
785     printf("%s:\n"
786            " V... = Video\n"
787            " A... = Audio\n"
788            " S... = Subtitle\n"
789            " .F.. = Frame-level multithreading\n"
790            " ..S. = Slice-level multithreading\n"
791            " ...X = Codec is experimental\n"
792            " ---\n",
793            encoder ? "Encoders" : "Decoders");
794     while ((desc = avcodec_descriptor_next(desc))) {
795         const AVCodec *codec = NULL;
796
797         while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
798             printf("%c", get_media_type_char(desc->type));
799             printf((codec->capabilities & CODEC_CAP_FRAME_THREADS) ? "F" : ".");
800             printf((codec->capabilities & CODEC_CAP_SLICE_THREADS) ? "S" : ".");
801             printf((codec->capabilities & CODEC_CAP_EXPERIMENTAL)  ? "X" : ".");
802
803             printf(" %-20s %s", codec->name, codec->long_name ? codec->long_name : "");
804             if (strcmp(codec->name, desc->name))
805                 printf(" (codec %s)", desc->name);
806
807             printf("\n");
808         }
809     }
810 }
811
812 int show_decoders(const char *opt, const char *arg)
813 {
814     print_codecs(0);
815     return 0;
816 }
817
818 int show_encoders(const char *opt, const char *arg)
819 {
820     print_codecs(1);
821     return 0;
822 }
823
824 int show_bsfs(const char *opt, const char *arg)
825 {
826     AVBitStreamFilter *bsf = NULL;
827
828     printf("Bitstream filters:\n");
829     while ((bsf = av_bitstream_filter_next(bsf)))
830         printf("%s\n", bsf->name);
831     printf("\n");
832     return 0;
833 }
834
835 int show_protocols(const char *opt, const char *arg)
836 {
837     void *opaque = NULL;
838     const char *name;
839
840     printf("Supported file protocols:\n"
841            "Input:\n");
842     while ((name = avio_enum_protocols(&opaque, 0)))
843         printf("%s\n", name);
844     printf("Output:\n");
845     while ((name = avio_enum_protocols(&opaque, 1)))
846         printf("%s\n", name);
847     return 0;
848 }
849
850 int show_filters(const char *opt, const char *arg)
851 {
852     AVFilter av_unused(**filter) = NULL;
853
854     printf("Filters:\n");
855 #if CONFIG_AVFILTER
856     while ((filter = av_filter_next(filter)) && *filter)
857         printf("%-16s %s\n", (*filter)->name, (*filter)->description);
858 #endif
859     return 0;
860 }
861
862 int show_pix_fmts(const char *opt, const char *arg)
863 {
864     enum PixelFormat pix_fmt;
865
866     printf("Pixel formats:\n"
867            "I.... = Supported Input  format for conversion\n"
868            ".O... = Supported Output format for conversion\n"
869            "..H.. = Hardware accelerated format\n"
870            "...P. = Paletted format\n"
871            "....B = Bitstream format\n"
872            "FLAGS NAME            NB_COMPONENTS BITS_PER_PIXEL\n"
873            "-----\n");
874
875 #if !CONFIG_SWSCALE
876 #   define sws_isSupportedInput(x)  0
877 #   define sws_isSupportedOutput(x) 0
878 #endif
879
880     for (pix_fmt = 0; pix_fmt < PIX_FMT_NB; pix_fmt++) {
881         const AVPixFmtDescriptor *pix_desc = &av_pix_fmt_descriptors[pix_fmt];
882         printf("%c%c%c%c%c %-16s       %d            %2d\n",
883                sws_isSupportedInput (pix_fmt)      ? 'I' : '.',
884                sws_isSupportedOutput(pix_fmt)      ? 'O' : '.',
885                pix_desc->flags & PIX_FMT_HWACCEL   ? 'H' : '.',
886                pix_desc->flags & PIX_FMT_PAL       ? 'P' : '.',
887                pix_desc->flags & PIX_FMT_BITSTREAM ? 'B' : '.',
888                pix_desc->name,
889                pix_desc->nb_components,
890                av_get_bits_per_pixel(pix_desc));
891     }
892     return 0;
893 }
894
895 int show_sample_fmts(const char *opt, const char *arg)
896 {
897     int i;
898     char fmt_str[128];
899     for (i = -1; i < AV_SAMPLE_FMT_NB; i++)
900         printf("%s\n", av_get_sample_fmt_string(fmt_str, sizeof(fmt_str), i));
901     return 0;
902 }
903
904 static void show_help_codec(const char *name, int encoder)
905 {
906     const AVCodecDescriptor *desc;
907     const AVCodec *codec;
908
909     if (!name) {
910         av_log(NULL, AV_LOG_ERROR, "No codec name specified.\n");
911         return;
912     }
913
914     codec = encoder ? avcodec_find_encoder_by_name(name) :
915                       avcodec_find_decoder_by_name(name);
916
917     if (codec)
918         print_codec(codec);
919     else if ((desc = avcodec_descriptor_get_by_name(name))) {
920         int printed = 0;
921
922         while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
923             printed = 1;
924             print_codec(codec);
925         }
926
927         if (!printed) {
928             av_log(NULL, AV_LOG_ERROR, "Codec '%s' is known to Libav, "
929                    "but no %s for it are available. Libav might need to be "
930                    "recompiled with additional external libraries.\n",
931                    name, encoder ? "encoders" : "decoders");
932         }
933     } else {
934         av_log(NULL, AV_LOG_ERROR, "Codec '%s' is not recognized by Libav.\n",
935                name);
936     }
937 }
938
939 int show_help(const char *opt, const char *arg)
940 {
941     char *topic, *par;
942     av_log_set_callback(log_callback_help);
943
944     topic = av_strdup(arg ? arg : "");
945     par = strchr(topic, '=');
946     if (par)
947         *par++ = 0;
948
949     if (!*topic) {
950         show_help_default(topic, par);
951     } else if (!strcmp(topic, "decoder")) {
952         show_help_codec(par, 0);
953     } else if (!strcmp(topic, "encoder")) {
954         show_help_codec(par, 1);
955     } else {
956         show_help_default(topic, par);
957     }
958
959     av_freep(&topic);
960     return 0;
961 }
962
963 int read_yesno(void)
964 {
965     int c = getchar();
966     int yesno = (toupper(c) == 'Y');
967
968     while (c != '\n' && c != EOF)
969         c = getchar();
970
971     return yesno;
972 }
973
974 int cmdutils_read_file(const char *filename, char **bufptr, size_t *size)
975 {
976     int ret;
977     FILE *f = fopen(filename, "rb");
978
979     if (!f) {
980         av_log(NULL, AV_LOG_ERROR, "Cannot read file '%s': %s\n", filename,
981                strerror(errno));
982         return AVERROR(errno);
983     }
984     fseek(f, 0, SEEK_END);
985     *size = ftell(f);
986     fseek(f, 0, SEEK_SET);
987     *bufptr = av_malloc(*size + 1);
988     if (!*bufptr) {
989         av_log(NULL, AV_LOG_ERROR, "Could not allocate file buffer\n");
990         fclose(f);
991         return AVERROR(ENOMEM);
992     }
993     ret = fread(*bufptr, 1, *size, f);
994     if (ret < *size) {
995         av_free(*bufptr);
996         if (ferror(f)) {
997             av_log(NULL, AV_LOG_ERROR, "Error while reading file '%s': %s\n",
998                    filename, strerror(errno));
999             ret = AVERROR(errno);
1000         } else
1001             ret = AVERROR_EOF;
1002     } else {
1003         ret = 0;
1004         (*bufptr)[*size++] = '\0';
1005     }
1006
1007     fclose(f);
1008     return ret;
1009 }
1010
1011 void init_pts_correction(PtsCorrectionContext *ctx)
1012 {
1013     ctx->num_faulty_pts = ctx->num_faulty_dts = 0;
1014     ctx->last_pts = ctx->last_dts = INT64_MIN;
1015 }
1016
1017 int64_t guess_correct_pts(PtsCorrectionContext *ctx, int64_t reordered_pts,
1018                           int64_t dts)
1019 {
1020     int64_t pts = AV_NOPTS_VALUE;
1021
1022     if (dts != AV_NOPTS_VALUE) {
1023         ctx->num_faulty_dts += dts <= ctx->last_dts;
1024         ctx->last_dts = dts;
1025     }
1026     if (reordered_pts != AV_NOPTS_VALUE) {
1027         ctx->num_faulty_pts += reordered_pts <= ctx->last_pts;
1028         ctx->last_pts = reordered_pts;
1029     }
1030     if ((ctx->num_faulty_pts<=ctx->num_faulty_dts || dts == AV_NOPTS_VALUE)
1031         && reordered_pts != AV_NOPTS_VALUE)
1032         pts = reordered_pts;
1033     else
1034         pts = dts;
1035
1036     return pts;
1037 }
1038
1039 FILE *get_preset_file(char *filename, size_t filename_size,
1040                       const char *preset_name, int is_path,
1041                       const char *codec_name)
1042 {
1043     FILE *f = NULL;
1044     int i;
1045     const char *base[3] = { getenv("AVCONV_DATADIR"),
1046                             getenv("HOME"),
1047                             AVCONV_DATADIR, };
1048
1049     if (is_path) {
1050         av_strlcpy(filename, preset_name, filename_size);
1051         f = fopen(filename, "r");
1052     } else {
1053         for (i = 0; i < 3 && !f; i++) {
1054             if (!base[i])
1055                 continue;
1056             snprintf(filename, filename_size, "%s%s/%s.avpreset", base[i],
1057                      i != 1 ? "" : "/.avconv", preset_name);
1058             f = fopen(filename, "r");
1059             if (!f && codec_name) {
1060                 snprintf(filename, filename_size,
1061                          "%s%s/%s-%s.avpreset",
1062                          base[i], i != 1 ? "" : "/.avconv", codec_name,
1063                          preset_name);
1064                 f = fopen(filename, "r");
1065             }
1066         }
1067     }
1068
1069     return f;
1070 }
1071
1072 int check_stream_specifier(AVFormatContext *s, AVStream *st, const char *spec)
1073 {
1074     if (*spec <= '9' && *spec >= '0') /* opt:index */
1075         return strtol(spec, NULL, 0) == st->index;
1076     else if (*spec == 'v' || *spec == 'a' || *spec == 's' || *spec == 'd' ||
1077              *spec == 't') { /* opt:[vasdt] */
1078         enum AVMediaType type;
1079
1080         switch (*spec++) {
1081         case 'v': type = AVMEDIA_TYPE_VIDEO;      break;
1082         case 'a': type = AVMEDIA_TYPE_AUDIO;      break;
1083         case 's': type = AVMEDIA_TYPE_SUBTITLE;   break;
1084         case 'd': type = AVMEDIA_TYPE_DATA;       break;
1085         case 't': type = AVMEDIA_TYPE_ATTACHMENT; break;
1086         default:  av_assert0(0);
1087         }
1088         if (type != st->codec->codec_type)
1089             return 0;
1090         if (*spec++ == ':') { /* possibly followed by :index */
1091             int i, index = strtol(spec, NULL, 0);
1092             for (i = 0; i < s->nb_streams; i++)
1093                 if (s->streams[i]->codec->codec_type == type && index-- == 0)
1094                    return i == st->index;
1095             return 0;
1096         }
1097         return 1;
1098     } else if (*spec == 'p' && *(spec + 1) == ':') {
1099         int prog_id, i, j;
1100         char *endptr;
1101         spec += 2;
1102         prog_id = strtol(spec, &endptr, 0);
1103         for (i = 0; i < s->nb_programs; i++) {
1104             if (s->programs[i]->id != prog_id)
1105                 continue;
1106
1107             if (*endptr++ == ':') {
1108                 int stream_idx = strtol(endptr, NULL, 0);
1109                 return stream_idx >= 0 &&
1110                     stream_idx < s->programs[i]->nb_stream_indexes &&
1111                     st->index == s->programs[i]->stream_index[stream_idx];
1112             }
1113
1114             for (j = 0; j < s->programs[i]->nb_stream_indexes; j++)
1115                 if (st->index == s->programs[i]->stream_index[j])
1116                     return 1;
1117         }
1118         return 0;
1119     } else if (!*spec) /* empty specifier, matches everything */
1120         return 1;
1121
1122     av_log(s, AV_LOG_ERROR, "Invalid stream specifier: %s.\n", spec);
1123     return AVERROR(EINVAL);
1124 }
1125
1126 AVDictionary *filter_codec_opts(AVDictionary *opts, enum AVCodecID codec_id,
1127                                 AVFormatContext *s, AVStream *st, AVCodec *codec)
1128 {
1129     AVDictionary    *ret = NULL;
1130     AVDictionaryEntry *t = NULL;
1131     int            flags = s->oformat ? AV_OPT_FLAG_ENCODING_PARAM
1132                                       : AV_OPT_FLAG_DECODING_PARAM;
1133     char          prefix = 0;
1134     const AVClass    *cc = avcodec_get_class();
1135
1136     if (!codec)
1137         codec            = s->oformat ? avcodec_find_encoder(codec_id)
1138                                       : avcodec_find_decoder(codec_id);
1139     if (!codec)
1140         return NULL;
1141
1142     switch (codec->type) {
1143     case AVMEDIA_TYPE_VIDEO:
1144         prefix  = 'v';
1145         flags  |= AV_OPT_FLAG_VIDEO_PARAM;
1146         break;
1147     case AVMEDIA_TYPE_AUDIO:
1148         prefix  = 'a';
1149         flags  |= AV_OPT_FLAG_AUDIO_PARAM;
1150         break;
1151     case AVMEDIA_TYPE_SUBTITLE:
1152         prefix  = 's';
1153         flags  |= AV_OPT_FLAG_SUBTITLE_PARAM;
1154         break;
1155     }
1156
1157     while (t = av_dict_get(opts, "", t, AV_DICT_IGNORE_SUFFIX)) {
1158         char *p = strchr(t->key, ':');
1159
1160         /* check stream specification in opt name */
1161         if (p)
1162             switch (check_stream_specifier(s, st, p + 1)) {
1163             case  1: *p = 0; break;
1164             case  0:         continue;
1165             default:         return NULL;
1166             }
1167
1168         if (av_opt_find(&cc, t->key, NULL, flags, AV_OPT_SEARCH_FAKE_OBJ) ||
1169             (codec && codec->priv_class &&
1170              av_opt_find(&codec->priv_class, t->key, NULL, flags,
1171                          AV_OPT_SEARCH_FAKE_OBJ)))
1172             av_dict_set(&ret, t->key, t->value, 0);
1173         else if (t->key[0] == prefix &&
1174                  av_opt_find(&cc, t->key + 1, NULL, flags,
1175                              AV_OPT_SEARCH_FAKE_OBJ))
1176             av_dict_set(&ret, t->key + 1, t->value, 0);
1177
1178         if (p)
1179             *p = ':';
1180     }
1181     return ret;
1182 }
1183
1184 AVDictionary **setup_find_stream_info_opts(AVFormatContext *s,
1185                                            AVDictionary *codec_opts)
1186 {
1187     int i;
1188     AVDictionary **opts;
1189
1190     if (!s->nb_streams)
1191         return NULL;
1192     opts = av_mallocz(s->nb_streams * sizeof(*opts));
1193     if (!opts) {
1194         av_log(NULL, AV_LOG_ERROR,
1195                "Could not alloc memory for stream options.\n");
1196         return NULL;
1197     }
1198     for (i = 0; i < s->nb_streams; i++)
1199         opts[i] = filter_codec_opts(codec_opts, s->streams[i]->codec->codec_id,
1200                                     s, s->streams[i], NULL);
1201     return opts;
1202 }
1203
1204 void *grow_array(void *array, int elem_size, int *size, int new_size)
1205 {
1206     if (new_size >= INT_MAX / elem_size) {
1207         av_log(NULL, AV_LOG_ERROR, "Array too big.\n");
1208         exit_program(1);
1209     }
1210     if (*size < new_size) {
1211         uint8_t *tmp = av_realloc(array, new_size*elem_size);
1212         if (!tmp) {
1213             av_log(NULL, AV_LOG_ERROR, "Could not alloc buffer.\n");
1214             exit_program(1);
1215         }
1216         memset(tmp + *size*elem_size, 0, (new_size-*size) * elem_size);
1217         *size = new_size;
1218         return tmp;
1219     }
1220     return array;
1221 }
1222
1223 static int alloc_buffer(FrameBuffer **pool, AVCodecContext *s, FrameBuffer **pbuf)
1224 {
1225     FrameBuffer  *buf = av_mallocz(sizeof(*buf));
1226     int i, ret;
1227     const int pixel_size = av_pix_fmt_descriptors[s->pix_fmt].comp[0].step_minus1+1;
1228     int h_chroma_shift, v_chroma_shift;
1229     int edge = 32; // XXX should be avcodec_get_edge_width(), but that fails on svq1
1230     int w = s->width, h = s->height;
1231
1232     if (!buf)
1233         return AVERROR(ENOMEM);
1234
1235     if (!(s->flags & CODEC_FLAG_EMU_EDGE)) {
1236         w += 2*edge;
1237         h += 2*edge;
1238     }
1239
1240     avcodec_align_dimensions(s, &w, &h);
1241     if ((ret = av_image_alloc(buf->base, buf->linesize, w, h,
1242                               s->pix_fmt, 32)) < 0) {
1243         av_freep(&buf);
1244         return ret;
1245     }
1246     /* XXX this shouldn't be needed, but some tests break without this line
1247      * those decoders are buggy and need to be fixed.
1248      * the following tests fail:
1249      * cdgraphics, ansi, aasc, fraps-v1, qtrle-1bit
1250      */
1251     memset(buf->base[0], 128, ret);
1252
1253     avcodec_get_chroma_sub_sample(s->pix_fmt, &h_chroma_shift, &v_chroma_shift);
1254     for (i = 0; i < FF_ARRAY_ELEMS(buf->data); i++) {
1255         const int h_shift = i==0 ? 0 : h_chroma_shift;
1256         const int v_shift = i==0 ? 0 : v_chroma_shift;
1257         if (s->flags & CODEC_FLAG_EMU_EDGE)
1258             buf->data[i] = buf->base[i];
1259         else
1260             buf->data[i] = buf->base[i] +
1261                            FFALIGN((buf->linesize[i]*edge >> v_shift) +
1262                                    (pixel_size*edge >> h_shift), 32);
1263     }
1264     buf->w       = s->width;
1265     buf->h       = s->height;
1266     buf->pix_fmt = s->pix_fmt;
1267     buf->pool    = pool;
1268
1269     *pbuf = buf;
1270     return 0;
1271 }
1272
1273 int codec_get_buffer(AVCodecContext *s, AVFrame *frame)
1274 {
1275     FrameBuffer **pool = s->opaque;
1276     FrameBuffer *buf;
1277     int ret, i;
1278
1279     if (!*pool && (ret = alloc_buffer(pool, s, pool)) < 0)
1280         return ret;
1281
1282     buf              = *pool;
1283     *pool            = buf->next;
1284     buf->next        = NULL;
1285     if (buf->w != s->width || buf->h != s->height || buf->pix_fmt != s->pix_fmt) {
1286         av_freep(&buf->base[0]);
1287         av_free(buf);
1288         if ((ret = alloc_buffer(pool, s, &buf)) < 0)
1289             return ret;
1290     }
1291     buf->refcount++;
1292
1293     frame->opaque        = buf;
1294     frame->type          = FF_BUFFER_TYPE_USER;
1295     frame->extended_data = frame->data;
1296     frame->pkt_pts       = s->pkt ? s->pkt->pts : AV_NOPTS_VALUE;
1297     frame->width         = buf->w;
1298     frame->height        = buf->h;
1299     frame->format        = buf->pix_fmt;
1300     frame->sample_aspect_ratio = s->sample_aspect_ratio;
1301
1302     for (i = 0; i < FF_ARRAY_ELEMS(buf->data); i++) {
1303         frame->base[i]     = buf->base[i];  // XXX h264.c uses base though it shouldn't
1304         frame->data[i]     = buf->data[i];
1305         frame->linesize[i] = buf->linesize[i];
1306     }
1307
1308     return 0;
1309 }
1310
1311 static void unref_buffer(FrameBuffer *buf)
1312 {
1313     FrameBuffer **pool = buf->pool;
1314
1315     av_assert0(buf->refcount);
1316     buf->refcount--;
1317     if (!buf->refcount) {
1318         buf->next = *pool;
1319         *pool = buf;
1320     }
1321 }
1322
1323 void codec_release_buffer(AVCodecContext *s, AVFrame *frame)
1324 {
1325     FrameBuffer *buf = frame->opaque;
1326     int i;
1327
1328     for (i = 0; i < FF_ARRAY_ELEMS(frame->data); i++)
1329         frame->data[i] = NULL;
1330
1331     unref_buffer(buf);
1332 }
1333
1334 void filter_release_buffer(AVFilterBuffer *fb)
1335 {
1336     FrameBuffer *buf = fb->priv;
1337     av_free(fb);
1338     unref_buffer(buf);
1339 }
1340
1341 void free_buffer_pool(FrameBuffer **pool)
1342 {
1343     FrameBuffer *buf = *pool;
1344     while (buf) {
1345         *pool = buf->next;
1346         av_freep(&buf->base[0]);
1347         av_free(buf);
1348         buf = *pool;
1349     }
1350 }