cmdutils.c 50.3 KB
Newer Older
Fabrice Bellard's avatar
Fabrice Bellard committed
1 2 3 4
/*
 * Various utilities for command line tools
 * Copyright (c) 2000-2003 Fabrice Bellard
 *
5 6 7
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
Fabrice Bellard's avatar
Fabrice Bellard committed
8 9
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
10
 * version 2.1 of the License, or (at your option) any later version.
Fabrice Bellard's avatar
Fabrice Bellard committed
11
 *
12
 * FFmpeg is distributed in the hope that it will be useful,
Fabrice Bellard's avatar
Fabrice Bellard committed
13 14 15 16 17
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * 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
Fabrice Bellard's avatar
Fabrice Bellard committed
20
 */
21

22 23 24
#include <string.h>
#include <stdlib.h>
#include <errno.h>
25
#include <math.h>
26

27 28 29 30
/* Include only the enabled headers since some compilers (namely, Sun
   Studio) will not omit unused inline functions and create undefined
   references to libraries that are not being built. */

31
#include "config.h"
32
#include "compat/va_copy.h"
33 34 35
#include "libavformat/avformat.h"
#include "libavfilter/avfilter.h"
#include "libavdevice/avdevice.h"
36
#include "libavresample/avresample.h"
37
#include "libswscale/swscale.h"
38
#include "libswresample/swresample.h"
39
#if CONFIG_POSTPROC
40
#include "libpostproc/postprocess.h"
41
#endif
42
#include "libavutil/avassert.h"
43
#include "libavutil/avstring.h"
44
#include "libavutil/mathematics.h"
45
#include "libavutil/imgutils.h"
46
#include "libavutil/parseutils.h"
47
#include "libavutil/pixdesc.h"
48
#include "libavutil/eval.h"
49
#include "libavutil/dict.h"
50
#include "libavutil/opt.h"
Fabrice Bellard's avatar
Fabrice Bellard committed
51
#include "cmdutils.h"
52
#include "version.h"
Ramiro Polla's avatar
Ramiro Polla committed
53
#if CONFIG_NETWORK
54
#include "libavformat/network.h"
Ramiro Polla's avatar
Ramiro Polla committed
55
#endif
Måns Rullgård's avatar
Måns Rullgård committed
56 57 58
#if HAVE_SYS_RESOURCE_H
#include <sys/resource.h>
#endif
Fabrice Bellard's avatar
Fabrice Bellard committed
59

60
struct SwsContext *sws_opts;
61
SwrContext *swr_opts;
62
AVDictionary *format_opts, *codec_opts;
63

64
const int this_year = 2012;
65

66 67
static FILE *report_file;

68 69
void init_opts(void)
{
70 71 72

    if(CONFIG_SWSCALE)
        sws_opts = sws_getContext(16, 16, 0, 16, 16, 0, SWS_BICUBIC,
73
                              NULL, NULL, NULL);
74 75 76

    if(CONFIG_SWRESAMPLE)
        swr_opts = swr_alloc();
77 78 79 80
}

void uninit_opts(void)
{
81
#if CONFIG_SWSCALE
82 83
    sws_freeContext(sws_opts);
    sws_opts = NULL;
84
#endif
85 86 87 88

    if(CONFIG_SWRESAMPLE)
        swr_free(&swr_opts);

89
    av_dict_free(&format_opts);
90
    av_dict_free(&codec_opts);
91 92
}

93
void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
94 95 96 97
{
    vfprintf(stdout, fmt, vl);
}

98 99 100 101 102 103 104 105 106 107 108 109 110 111
static void log_callback_report(void *ptr, int level, const char *fmt, va_list vl)
{
    va_list vl2;
    char line[1024];
    static int print_prefix = 1;

    va_copy(vl2, vl);
    av_log_default_callback(ptr, level, fmt, vl);
    av_log_format_line(ptr, level, fmt, vl2, line, sizeof(line), &print_prefix);
    va_end(vl2);
    fputs(line, report_file);
    fflush(report_file);
}

112 113
double parse_number_or_die(const char *context, const char *numstr, int type,
                           double min, double max)
114 115 116
{
    char *tail;
    const char *error;
117
    double d = av_strtod(numstr, &tail);
118
    if (*tail)
119
        error = "Expected number for %s but found: %s\n";
120
    else if (d < min || d > max)
121 122 123
        error = "The value for %s was %s which is not within %f - %f\n";
    else if (type == OPT_INT64 && (int64_t)d != d)
        error = "Expected int64 for %s but found %s\n";
124
    else if (type == OPT_INT && (int)d != d)
125
        error = "Expected int for %s but found %s\n";
126 127
    else
        return d;
128
    av_log(NULL, AV_LOG_FATAL, error, context, numstr, min, max);
129 130
    exit_program(1);
    return 0;
131 132
}

133 134
int64_t parse_time_or_die(const char *context, const char *timestr,
                          int is_duration)
135
{
136 137
    int64_t us;
    if (av_parse_time(&us, timestr, is_duration) < 0) {
138 139
        av_log(NULL, AV_LOG_FATAL, "Invalid %s specification for %s: %s\n",
               is_duration ? "duration" : "date", context, timestr);
140
        exit_program(1);
141 142 143 144
    }
    return us;
}

145
void show_help_options(const OptionDef *options, const char *msg, int req_flags,
146
                       int rej_flags, int alt_flags)
Fabrice Bellard's avatar
Fabrice Bellard committed
147 148
{
    const OptionDef *po;
149
    int first;
Fabrice Bellard's avatar
Fabrice Bellard committed
150

151
    first = 1;
152
    for (po = options; po->name != NULL; po++) {
153
        char buf[64];
154 155

        if (((po->flags & req_flags) != req_flags) ||
156
            (alt_flags && !(po->flags & alt_flags)) ||
157 158 159 160 161 162 163 164
            (po->flags & rej_flags))
            continue;

        if (first) {
            printf("%s\n", msg);
            first = 0;
        }
        av_strlcpy(buf, po->name, sizeof(buf));
165
        if (po->argname) {
166 167
            av_strlcat(buf, " ", sizeof(buf));
            av_strlcat(buf, po->argname, sizeof(buf));
Fabrice Bellard's avatar
Fabrice Bellard committed
168
        }
169
        printf("-%-17s  %s\n", buf, po->help);
Fabrice Bellard's avatar
Fabrice Bellard committed
170
    }
171
    printf("\n");
Fabrice Bellard's avatar
Fabrice Bellard committed
172 173
}

174 175 176
void show_help_children(const AVClass *class, int flags)
{
    const AVClass *child = NULL;
177 178 179 180
    if (class->option) {
        av_opt_show2(&class, NULL, flags, 0);
        printf("\n");
    }
181 182 183 184 185

    while (child = av_opt_child_class_next(class, child))
        show_help_children(child, flags);
}

186 187
static const OptionDef *find_option(const OptionDef *po, const char *name)
{
188 189 190
    const char *p = strchr(name, ':');
    int len = p ? p - name : strlen(name);

191
    while (po->name != NULL) {
192
        if (!strncmp(name, po->name, len) && strlen(po->name) == len)
193 194 195 196 197 198
            break;
        po++;
    }
    return po;
}

199
#if defined(_WIN32) && !defined(__MINGW32CE__)
200
#include <windows.h>
201
#include <shellapi.h>
202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234
/* Will be leaked on exit */
static char** win32_argv_utf8 = NULL;
static int win32_argc = 0;

/**
 * Prepare command line arguments for executable.
 * For Windows - perform wide-char to UTF-8 conversion.
 * Input arguments should be main() function arguments.
 * @param argc_ptr Arguments number (including executable)
 * @param argv_ptr Arguments list.
 */
static void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
{
    char *argstr_flat;
    wchar_t **argv_w;
    int i, buffsize = 0, offset = 0;

    if (win32_argv_utf8) {
        *argc_ptr = win32_argc;
        *argv_ptr = win32_argv_utf8;
        return;
    }

    win32_argc = 0;
    argv_w = CommandLineToArgvW(GetCommandLineW(), &win32_argc);
    if (win32_argc <= 0 || !argv_w)
        return;

    /* determine the UTF-8 buffer size (including NULL-termination symbols) */
    for (i = 0; i < win32_argc; i++)
        buffsize += WideCharToMultiByte(CP_UTF8, 0, argv_w[i], -1,
                                        NULL, 0, NULL, NULL);

235 236
    win32_argv_utf8 = av_mallocz(sizeof(char *) * (win32_argc + 1) + buffsize);
    argstr_flat     = (char *)win32_argv_utf8 + sizeof(char *) * (win32_argc + 1);
237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260
    if (win32_argv_utf8 == NULL) {
        LocalFree(argv_w);
        return;
    }

    for (i = 0; i < win32_argc; i++) {
        win32_argv_utf8[i] = &argstr_flat[offset];
        offset += WideCharToMultiByte(CP_UTF8, 0, argv_w[i], -1,
                                      &argstr_flat[offset],
                                      buffsize - offset, NULL, NULL);
    }
    win32_argv_utf8[i] = NULL;
    LocalFree(argv_w);

    *argc_ptr = win32_argc;
    *argv_ptr = win32_argv_utf8;
}
#else
static inline void prepare_app_arguments(int *argc_ptr, char ***argv_ptr)
{
    /* nothing to do */
}
#endif /* WIN32 && !__MINGW32CE__ */

261 262
int parse_option(void *optctx, const char *opt, const char *arg,
                 const OptionDef *options)
Fabrice Bellard's avatar
Fabrice Bellard committed
263 264
{
    const OptionDef *po;
265
    int bool_val = 1;
266
    int *dstcount;
267 268 269 270 271 272
    void *dst;

    po = find_option(options, opt);
    if (!po->name && opt[0] == 'n' && opt[1] == 'o') {
        /* handle 'no' bool option */
        po = find_option(options, opt + 2);
273 274
        if ((po->name && (po->flags & OPT_BOOL)))
            bool_val = 0;
275 276 277 278 279 280 281 282 283 284 285 286 287 288
    }
    if (!po->name)
        po = find_option(options, "default");
    if (!po->name) {
        av_log(NULL, AV_LOG_ERROR, "Unrecognized option '%s'\n", opt);
        return AVERROR(EINVAL);
    }
    if (po->flags & HAS_ARG && !arg) {
        av_log(NULL, AV_LOG_ERROR, "Missing argument for option '%s'\n", opt);
        return AVERROR(EINVAL);
    }

    /* new-style options contain an offset into optctx, old-style address of
     * a global var*/
289 290
    dst = po->flags & (OPT_OFFSET | OPT_SPEC) ? (uint8_t *)optctx + po->u.off
                                              : po->u.dst_ptr;
291 292 293 294 295

    if (po->flags & OPT_SPEC) {
        SpecifierOpt **so = dst;
        char *p = strchr(opt, ':');

296
        dstcount = (int *)(so + 1);
297 298 299 300
        *so = grow_array(*so, sizeof(**so), dstcount, *dstcount + 1);
        (*so)[*dstcount - 1].specifier = av_strdup(p ? p + 1 : "");
        dst = &(*so)[*dstcount - 1].u;
    }
301 302 303 304

    if (po->flags & OPT_STRING) {
        char *str;
        str = av_strdup(arg);
305
//         av_freep(dst);
306
        *(char **)dst = str;
307
    } else if (po->flags & OPT_BOOL) {
308
        *(int *)dst = bool_val;
309
    } else if (po->flags & OPT_INT) {
310
        *(int *)dst = parse_number_or_die(opt, arg, OPT_INT64, INT_MIN, INT_MAX);
311
    } else if (po->flags & OPT_INT64) {
312
        *(int64_t *)dst = parse_number_or_die(opt, arg, OPT_INT64, INT64_MIN, INT64_MAX);
313
    } else if (po->flags & OPT_TIME) {
314
        *(int64_t *)dst = parse_time_or_die(opt, arg, 1);
315
    } else if (po->flags & OPT_FLOAT) {
316
        *(float *)dst = parse_number_or_die(opt, arg, OPT_FLOAT, -INFINITY, INFINITY);
317
    } else if (po->flags & OPT_DOUBLE) {
318
        *(double *)dst = parse_number_or_die(opt, arg, OPT_DOUBLE, -INFINITY, INFINITY);
319
    } else if (po->u.func_arg) {
320
        int ret = po->u.func_arg(optctx, opt, arg);
321
        if (ret < 0) {
322 323
            av_log(NULL, AV_LOG_ERROR,
                   "Failed to set value '%s' for option '%s'\n", arg, opt);
324 325 326 327 328 329 330 331
            return ret;
        }
    }
    if (po->flags & OPT_EXIT)
        exit_program(0);
    return !!(po->flags & HAS_ARG);
}

332
void parse_options(void *optctx, int argc, char **argv, const OptionDef *options,
333
                   void (*parse_arg_function)(void *, const char*))
Fabrice Bellard's avatar
Fabrice Bellard committed
334
{
335 336
    const char *opt;
    int optindex, handleoptions = 1, ret;
Fabrice Bellard's avatar
Fabrice Bellard committed
337

338 339 340
    /* perform system-dependent conversions for arguments list */
    prepare_app_arguments(&argc, &argv);

Fabrice Bellard's avatar
Fabrice Bellard committed
341 342 343 344
    /* parse options */
    optindex = 1;
    while (optindex < argc) {
        opt = argv[optindex++];
345

346
        if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
Stefano Sabatini's avatar
Stefano Sabatini committed
347 348 349 350
            if (opt[1] == '-' && opt[2] == '\0') {
                handleoptions = 0;
                continue;
            }
351
            opt++;
352 353

            if ((ret = parse_option(optctx, opt, argv[optindex], options)) < 0)
354
                exit_program(1);
355
            optindex += ret;
Fabrice Bellard's avatar
Fabrice Bellard committed
356
        } else {
357
            if (parse_arg_function)
358
                parse_arg_function(optctx, opt);
Fabrice Bellard's avatar
Fabrice Bellard committed
359 360 361 362
        }
    }
}

363 364
int locate_option(int argc, char **argv, const OptionDef *options,
                  const char *optname)
365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388
{
    const OptionDef *po;
    int i;

    for (i = 1; i < argc; i++) {
        const char *cur_opt = argv[i];

        if (*cur_opt++ != '-')
            continue;

        po = find_option(options, cur_opt);
        if (!po->name && cur_opt[0] == 'n' && cur_opt[1] == 'o')
            po = find_option(options, cur_opt + 2);

        if ((!po->name && !strcmp(cur_opt, optname)) ||
             (po->name && !strcmp(optname, po->name)))
            return i;

        if (!po || po->flags & HAS_ARG)
            i++;
    }
    return 0;
}

389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412
static void dump_argument(const char *a)
{
    const unsigned char *p;

    for (p = a; *p; p++)
        if (!((*p >= '+' && *p <= ':') || (*p >= '@' && *p <= 'Z') ||
              *p == '_' || (*p >= 'a' && *p <= 'z')))
            break;
    if (!*p) {
        fputs(a, report_file);
        return;
    }
    fputc('"', report_file);
    for (p = a; *p; p++) {
        if (*p == '\\' || *p == '"' || *p == '$' || *p == '`')
            fprintf(report_file, "\\%c", *p);
        else if (*p < ' ' || *p > '~')
            fprintf(report_file, "\\x%02x", *p);
        else
            fputc(*p, report_file);
    }
    fputc('"', report_file);
}

413 414 415
void parse_loglevel(int argc, char **argv, const OptionDef *options)
{
    int idx = locate_option(argc, argv, options, "loglevel");
416 417
    if (!idx)
        idx = locate_option(argc, argv, options, "v");
418
    if (idx && argv[idx + 1])
419
        opt_loglevel(NULL, "loglevel", argv[idx + 1]);
420 421 422 423 424 425 426 427 428 429 430 431 432
    idx = locate_option(argc, argv, options, "report");
    if (idx || getenv("FFREPORT")) {
        opt_report("report");
        if (report_file) {
            int i;
            fprintf(report_file, "Command line:\n");
            for (i = 0; i < argc; i++) {
                dump_argument(argv[i]);
                fputc(i < argc - 1 ? ' ' : '\n', report_file);
            }
            fflush(report_file);
        }
    }
433 434
}

435
#define FLAGS (o->type == AV_OPT_TYPE_FLAGS) ? AV_DICT_APPEND : 0
436
int opt_default(void *optctx, const char *opt, const char *arg)
437
{
438
    const AVOption *o;
439 440
    char opt_stripped[128];
    const char *p;
441
    const AVClass *cc = avcodec_get_class(), *fc = avformat_get_class(), *sc, *swr_class;
442 443 444 445 446

    if (!(p = strchr(opt, ':')))
        p = opt + strlen(opt);
    av_strlcpy(opt_stripped, opt, FFMIN(sizeof(opt_stripped), p - opt + 1));

447
    if ((o = av_opt_find(&cc, opt_stripped, NULL, 0,
448 449
                         AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ)) ||
        ((opt[0] == 'v' || opt[0] == 'a' || opt[0] == 's') &&
450 451 452 453 454
         (o = av_opt_find(&cc, opt + 1, NULL, 0, AV_OPT_SEARCH_FAKE_OBJ))))
        av_dict_set(&codec_opts, opt, arg, FLAGS);
    else if ((o = av_opt_find(&fc, opt, NULL, 0,
                              AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ)))
        av_dict_set(&format_opts, opt, arg, FLAGS);
455
#if CONFIG_SWSCALE
456
    sc = sws_get_class();
457 458
    if (!o && (o = av_opt_find(&sc, opt, NULL, 0,
                         AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
459
        // XXX we only support sws_flags, not arbitrary sws options
460
        int ret = av_opt_set(sws_opts, opt, arg, 0);
461 462 463 464 465
        if (ret < 0) {
            av_log(NULL, AV_LOG_ERROR, "Error setting option %s.\n", opt);
            return ret;
        }
    }
466
#endif
467
#if CONFIG_SWRESAMPLE
468
    swr_class = swr_get_class();
469 470
    if (!o && (o = av_opt_find(&swr_class, opt, NULL, 0,
                               AV_OPT_SEARCH_CHILDREN | AV_OPT_SEARCH_FAKE_OBJ))) {
471 472 473 474 475 476
        int ret = av_opt_set(swr_opts, opt, arg, 0);
        if (ret < 0) {
            av_log(NULL, AV_LOG_ERROR, "Error setting option %s.\n", opt);
            return ret;
        }
    }
477
#endif
478

479
    if (o)
480
        return 0;
481
    av_log(NULL, AV_LOG_ERROR, "Unrecognized option '%s'\n", opt);
482 483
    return AVERROR_OPTION_NOT_FOUND;
}
484

485
int opt_loglevel(void *optctx, const char *opt, const char *arg)
486
{
487
    const struct { const char *name; int level; } log_levels[] = {
488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509
        { "quiet"  , AV_LOG_QUIET   },
        { "panic"  , AV_LOG_PANIC   },
        { "fatal"  , AV_LOG_FATAL   },
        { "error"  , AV_LOG_ERROR   },
        { "warning", AV_LOG_WARNING },
        { "info"   , AV_LOG_INFO    },
        { "verbose", AV_LOG_VERBOSE },
        { "debug"  , AV_LOG_DEBUG   },
    };
    char *tail;
    int level;
    int i;

    for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++) {
        if (!strcmp(log_levels[i].name, arg)) {
            av_log_set_level(log_levels[i].level);
            return 0;
        }
    }

    level = strtol(arg, &tail, 10);
    if (*tail) {
510 511
        av_log(NULL, AV_LOG_FATAL, "Invalid loglevel \"%s\". "
               "Possible levels are numbers or:\n", arg);
512
        for (i = 0; i < FF_ARRAY_ELEMS(log_levels); i++)
513
            av_log(NULL, AV_LOG_FATAL, "\"%s\"\n", log_levels[i].name);
514
        exit_program(1);
515 516 517 518 519
    }
    av_log_set_level(level);
    return 0;
}

520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551
int opt_report(const char *opt)
{
    char filename[64];
    time_t now;
    struct tm *tm;

    if (report_file) /* already opened */
        return 0;
    time(&now);
    tm = localtime(&now);
    snprintf(filename, sizeof(filename), "%s-%04d%02d%02d-%02d%02d%02d.log",
             program_name,
             tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday,
             tm->tm_hour, tm->tm_min, tm->tm_sec);
    report_file = fopen(filename, "w");
    if (!report_file) {
        av_log(NULL, AV_LOG_ERROR, "Failed to open report \"%s\": %s\n",
               filename, strerror(errno));
        return AVERROR(errno);
    }
    av_log_set_callback(log_callback_report);
    av_log(NULL, AV_LOG_INFO,
           "%s started on %04d-%02d-%02d at %02d:%02d:%02d\n"
           "Report written to \"%s\"\n",
           program_name,
           tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday,
           tm->tm_hour, tm->tm_min, tm->tm_sec,
           filename);
    av_log_set_level(FFMAX(av_log_get_level(), AV_LOG_VERBOSE));
    return 0;
}

552
int opt_max_alloc(void *optctx, const char *opt, const char *arg)
553 554 555 556 557 558 559 560 561 562 563 564 565
{
    char *tail;
    size_t max;

    max = strtol(arg, &tail, 10);
    if (*tail) {
        av_log(NULL, AV_LOG_FATAL, "Invalid max_alloc \"%s\".\n", arg);
        exit_program(1);
    }
    av_max_alloc(max);
    return 0;
}

566
int opt_cpuflags(void *optctx, const char *opt, const char *arg)
567
{
568
    int ret;
569
    unsigned flags = av_get_cpu_flags();
570

571
    if ((ret = av_parse_cpu_caps(&flags, arg)) < 0)
572
        return ret;
573 574 575 576 577

    av_force_cpu_flags(flags);
    return 0;
}

578
int opt_codec_debug(void *optctx, const char *opt, const char *arg)
579 580
{
    av_log_set_level(AV_LOG_DEBUG);
581
    return opt_default(NULL, opt, arg);
582 583
}

584
int opt_timelimit(void *optctx, const char *opt, const char *arg)
Måns Rullgård's avatar
Måns Rullgård committed
585
{
Måns Rullgård's avatar
Måns Rullgård committed
586
#if HAVE_SETRLIMIT
Måns Rullgård's avatar
Måns Rullgård committed
587 588 589 590 591
    int lim = parse_number_or_die(opt, arg, OPT_INT64, 0, INT_MAX);
    struct rlimit rl = { lim, lim + 1 };
    if (setrlimit(RLIMIT_CPU, &rl))
        perror("setrlimit");
#else
592
    av_log(NULL, AV_LOG_WARNING, "-%s not implemented on this OS\n", opt);
Måns Rullgård's avatar
Måns Rullgård committed
593 594 595 596
#endif
    return 0;
}

Fabrice Bellard's avatar
Fabrice Bellard committed
597 598
void print_error(const char *filename, int err)
{
599
    char errbuf[128];
600
    const char *errbuf_ptr = errbuf;
601

602 603
    if (av_strerror(err, errbuf, sizeof(errbuf)) < 0)
        errbuf_ptr = strerror(AVUNERROR(err));
604
    av_log(NULL, AV_LOG_ERROR, "%s: %s\n", filename, errbuf_ptr);
Fabrice Bellard's avatar
Fabrice Bellard committed
605
}
606

607 608
static int warned_cfg = 0;

609 610
#define INDENT        1
#define SHOW_VERSION  2
611
#define SHOW_CONFIG   4
612
#define SHOW_COPYRIGHT 8
613

614
#define PRINT_LIB_INFO(libname, LIBNAME, flags, level)                  \
615
    if (CONFIG_##LIBNAME) {                                             \
616
        const char *indent = flags & INDENT? "  " : "";                 \
617
        if (flags & SHOW_VERSION) {                                     \
Stefano Sabatini's avatar
Stefano Sabatini committed
618
            unsigned int version = libname##_version();                 \
619
            av_log(NULL, level,                                         \
620
                   "%slib%-11s %2d.%3d.%3d / %2d.%3d.%3d\n",            \
621 622 623 624 625
                   indent, #libname,                                    \
                   LIB##LIBNAME##_VERSION_MAJOR,                        \
                   LIB##LIBNAME##_VERSION_MINOR,                        \
                   LIB##LIBNAME##_VERSION_MICRO,                        \
                   version >> 16, version >> 8 & 0xff, version & 0xff); \
626
        }                                                               \
627 628
        if (flags & SHOW_CONFIG) {                                      \
            const char *cfg = libname##_configuration();                \
629
            if (strcmp(FFMPEG_CONFIGURATION, cfg)) {                    \
630
                if (!warned_cfg) {                                      \
631
                    av_log(NULL, level,                                 \
632
                            "%sWARNING: library configuration mismatch\n", \
633
                            indent);                                    \
634 635
                    warned_cfg = 1;                                     \
                }                                                       \
636
                av_log(NULL, level, "%s%-11s configuration: %s\n",      \
637
                        indent, #libname, cfg);                         \
638 639
            }                                                           \
        }                                                               \
640
    }                                                                   \
641

642
static void print_all_libs_info(int flags, int level)
643
{
644 645 646 647 648
    PRINT_LIB_INFO(avutil,   AVUTIL,   flags, level);
    PRINT_LIB_INFO(avcodec,  AVCODEC,  flags, level);
    PRINT_LIB_INFO(avformat, AVFORMAT, flags, level);
    PRINT_LIB_INFO(avdevice, AVDEVICE, flags, level);
    PRINT_LIB_INFO(avfilter, AVFILTER, flags, level);
649
//    PRINT_LIB_INFO(avresample, AVRESAMPLE, flags, level);
650
    PRINT_LIB_INFO(swscale,  SWSCALE,  flags, level);
651
    PRINT_LIB_INFO(swresample,SWRESAMPLE,  flags, level);
652
#if CONFIG_POSTPROC
653
    PRINT_LIB_INFO(postproc, POSTPROC, flags, level);
654
#endif
655 656
}

657 658 659 660 661 662 663 664 665
static void print_program_info(int flags, int level)
{
    const char *indent = flags & INDENT? "  " : "";

    av_log(NULL, level, "%s version " FFMPEG_VERSION, program_name);
    if (flags & SHOW_COPYRIGHT)
        av_log(NULL, level, " Copyright (c) %d-%d the FFmpeg developers",
               program_birth_year, this_year);
    av_log(NULL, level, "\n");
666 667 668
    av_log(NULL, level, "%sbuilt on %s %s with %s\n",
           indent, __DATE__, __TIME__, CC_IDENT);

669 670 671
    av_log(NULL, level, "%sconfiguration: " FFMPEG_CONFIGURATION "\n", indent);
}

672
void show_banner(int argc, char **argv, const OptionDef *options)
673
{
674 675 676 677
    int idx = locate_option(argc, argv, options, "version");
    if (idx)
        return;

678
    print_program_info (INDENT|SHOW_COPYRIGHT, AV_LOG_INFO);
679 680
    print_all_libs_info(INDENT|SHOW_CONFIG,  AV_LOG_INFO);
    print_all_libs_info(INDENT|SHOW_VERSION, AV_LOG_INFO);
681 682
}

683
int show_version(void *optctx, const char *opt, const char *arg)
684
{
685
    av_log_set_callback(log_callback_help);
686
    print_program_info (0           , AV_LOG_INFO);
687
    print_all_libs_info(SHOW_VERSION, AV_LOG_INFO);
688

689
    return 0;
690 691
}

692
int show_license(void *optctx, const char *opt, const char *arg)
693
{
694
    printf(
695
#if CONFIG_NONFREE
696 697 698
    "This version of %s has nonfree parts compiled in.\n"
    "Therefore it is not legally redistributable.\n",
    program_name
699 700 701 702 703 704 705 706 707 708 709 710 711 712
#elif CONFIG_GPLV3
    "%s is free software; you can redistribute it and/or modify\n"
    "it under the terms of the GNU General Public License as published by\n"
    "the Free Software Foundation; either version 3 of the License, or\n"
    "(at your option) any later version.\n"
    "\n"
    "%s is distributed in the hope that it will be useful,\n"
    "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
    "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
    "GNU General Public License for more details.\n"
    "\n"
    "You should have received a copy of the GNU General Public License\n"
    "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
    program_name, program_name, program_name
713
#elif CONFIG_GPL
714
    "%s is free software; you can redistribute it and/or modify\n"
715 716 717 718
    "it under the terms of the GNU General Public License as published by\n"
    "the Free Software Foundation; either version 2 of the License, or\n"
    "(at your option) any later version.\n"
    "\n"
719
    "%s is distributed in the hope that it will be useful,\n"
720 721 722 723 724
    "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
    "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
    "GNU General Public License for more details.\n"
    "\n"
    "You should have received a copy of the GNU General Public License\n"
725 726 727
    "along with %s; if not, write to the Free Software\n"
    "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
    program_name, program_name, program_name
728 729 730 731 732 733 734 735 736 737 738 739 740 741
#elif CONFIG_LGPLV3
    "%s is free software; you can redistribute it and/or modify\n"
    "it under the terms of the GNU Lesser General Public License as published by\n"
    "the Free Software Foundation; either version 3 of the License, or\n"
    "(at your option) any later version.\n"
    "\n"
    "%s is distributed in the hope that it will be useful,\n"
    "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
    "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n"
    "GNU Lesser General Public License for more details.\n"
    "\n"
    "You should have received a copy of the GNU Lesser General Public License\n"
    "along with %s.  If not, see <http://www.gnu.org/licenses/>.\n",
    program_name, program_name, program_name
742
#else
743
    "%s is free software; you can redistribute it and/or\n"
744 745 746 747
    "modify it under the terms of the GNU Lesser General Public\n"
    "License as published by the Free Software Foundation; either\n"
    "version 2.1 of the License, or (at your option) any later version.\n"
    "\n"
748
    "%s is distributed in the hope that it will be useful,\n"
749 750 751 752 753
    "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
    "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU\n"
    "Lesser General Public License for more details.\n"
    "\n"
    "You should have received a copy of the GNU Lesser General Public\n"
754 755 756
    "License along with %s; if not, write to the Free Software\n"
    "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
    program_name, program_name, program_name
757
#endif
758
    );
759

760
    return 0;
761
}
762

763
int show_formats(void *optctx, const char *opt, const char *arg)
764
{
765 766
    AVInputFormat *ifmt  = NULL;
    AVOutputFormat *ofmt = NULL;
767 768
    const char *last_name;

769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785
    printf("File formats:\n"
           " D. = Demuxing supported\n"
           " .E = Muxing supported\n"
           " --\n");
    last_name = "000";
    for (;;) {
        int decode = 0;
        int encode = 0;
        const char *name      = NULL;
        const char *long_name = NULL;

        while ((ofmt = av_oformat_next(ofmt))) {
            if ((name == NULL || strcmp(ofmt->name, name) < 0) &&
                strcmp(ofmt->name, last_name) > 0) {
                name      = ofmt->name;
                long_name = ofmt->long_name;
                encode    = 1;
786 787
            }
        }
788 789 790 791 792 793
        while ((ifmt = av_iformat_next(ifmt))) {
            if ((name == NULL || strcmp(ifmt->name, name) < 0) &&
                strcmp(ifmt->name, last_name) > 0) {
                name      = ifmt->name;
                long_name = ifmt->long_name;
                encode    = 0;
794
            }
795 796
            if (name && strcmp(ifmt->name, name) == 0)
                decode = 1;
797
        }
798
        if (name == NULL)
799
            break;
800
        last_name = name;
801

802 803 804 805
        printf(" %s%s %-15s %s\n",
               decode ? "D" : " ",
               encode ? "E" : " ",
               name,
806 807
            long_name ? long_name:" ");
    }
808
    return 0;
809
}
810

811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869
#define PRINT_CODEC_SUPPORTED(codec, field, type, list_name, term, get_name) \
    if (codec->field) {                                                      \
        const type *p = c->field;                                            \
                                                                             \
        printf("    Supported " list_name ":");                              \
        while (*p != term) {                                                 \
            get_name(*p);                                                    \
            printf(" %s", name);                                             \
            p++;                                                             \
        }                                                                    \
        printf("\n");                                                        \
    }                                                                        \

static void print_codec(const AVCodec *c)
{
    int encoder = av_codec_is_encoder(c);

    printf("%s %s [%s]:\n", encoder ? "Encoder" : "Decoder", c->name,
           c->long_name ? c->long_name : "");

    if (c->type == AVMEDIA_TYPE_VIDEO) {
        printf("    Threading capabilities: ");
        switch (c->capabilities & (CODEC_CAP_FRAME_THREADS |
                                   CODEC_CAP_SLICE_THREADS)) {
        case CODEC_CAP_FRAME_THREADS |
             CODEC_CAP_SLICE_THREADS: printf("frame and slice"); break;
        case CODEC_CAP_FRAME_THREADS: printf("frame");           break;
        case CODEC_CAP_SLICE_THREADS: printf("slice");           break;
        default:                      printf("no");              break;
        }
        printf("\n");
    }

    if (c->supported_framerates) {
        const AVRational *fps = c->supported_framerates;

        printf("    Supported framerates:");
        while (fps->num) {
            printf(" %d/%d", fps->num, fps->den);
            fps++;
        }
        printf("\n");
    }
    PRINT_CODEC_SUPPORTED(c, pix_fmts, enum PixelFormat, "pixel formats",
                          PIX_FMT_NONE, GET_PIX_FMT_NAME);
    PRINT_CODEC_SUPPORTED(c, supported_samplerates, int, "sample rates", 0,
                          GET_SAMPLE_RATE_NAME);
    PRINT_CODEC_SUPPORTED(c, sample_fmts, enum AVSampleFormat, "sample formats",
                          AV_SAMPLE_FMT_NONE, GET_SAMPLE_FMT_NAME);
    PRINT_CODEC_SUPPORTED(c, channel_layouts, uint64_t, "channel layouts",
                          0, GET_CH_LAYOUT_DESC);

    if (c->priv_class) {
        show_help_children(c->priv_class,
                           AV_OPT_FLAG_ENCODING_PARAM |
                           AV_OPT_FLAG_DECODING_PARAM);
    }
}

870 871
static char get_media_type_char(enum AVMediaType type)
{
872 873 874
    switch (type) {
        case AVMEDIA_TYPE_VIDEO:    return 'V';
        case AVMEDIA_TYPE_AUDIO:    return 'A';
875
        case AVMEDIA_TYPE_DATA:     return 'D';
876
        case AVMEDIA_TYPE_SUBTITLE: return 'S';
877
        case AVMEDIA_TYPE_ATTACHMENT:return 'T';
878 879
        default:                    return '?';
    }
880 881
}

882 883
static const AVCodec *next_codec_for_id(enum AVCodecID id, const AVCodec *prev,
                                        int encoder)
884
{
885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904
    while ((prev = av_codec_next(prev))) {
        if (prev->id == id &&
            (encoder ? av_codec_is_encoder(prev) : av_codec_is_decoder(prev)))
            return prev;
    }
    return NULL;
}

static void print_codecs_for_id(enum AVCodecID id, int encoder)
{
    const AVCodec *codec = NULL;

    printf(" (%s: ", encoder ? "encoders" : "decoders");

    while ((codec = next_codec_for_id(id, codec, encoder)))
        printf("%s ", codec->name);

    printf(")");
}

905
int show_codecs(void *optctx, const char *opt, const char *arg)
906
{
907 908
    const AVCodecDescriptor *desc = NULL;

909
    printf("Codecs:\n"
910 911 912 913 914 915 916 917 918
           " D..... = Decoding supported\n"
           " .E.... = Encoding supported\n"
           " ..V... = Video codec\n"
           " ..A... = Audio codec\n"
           " ..S... = Subtitle codec\n"
           " ...I.. = Intra frame-only codec\n"
           " ....L. = Lossy compression\n"
           " .....S = Lossless compression\n"
           " -------\n");
919 920 921
    while ((desc = avcodec_descriptor_next(desc))) {
        const AVCodec *codec = NULL;

922
        printf(" ");
923 924 925 926 927
        printf(avcodec_find_decoder(desc->id) ? "D" : ".");
        printf(avcodec_find_encoder(desc->id) ? "E" : ".");

        printf("%c", get_media_type_char(desc->type));
        printf((desc->props & AV_CODEC_PROP_INTRA_ONLY) ? "I" : ".");
928 929
        printf((desc->props & AV_CODEC_PROP_LOSSY)      ? "L" : ".");
        printf((desc->props & AV_CODEC_PROP_LOSSLESS)   ? "S" : ".");
930 931 932 933 934 935 936 937 938

        printf(" %-20s %s", desc->name, desc->long_name ? desc->long_name : "");

        /* print decoders/encoders when there's more than one or their
         * names are different from codec name */
        while ((codec = next_codec_for_id(desc->id, codec, 0))) {
            if (strcmp(codec->name, desc->name)) {
                print_codecs_for_id(desc->id, 0);
                break;
939
            }
940 941 942 943 944 945
        }
        codec = NULL;
        while ((codec = next_codec_for_id(desc->id, codec, 1))) {
            if (strcmp(codec->name, desc->name)) {
                print_codecs_for_id(desc->id, 1);
                break;
946 947 948 949 950
            }
        }

        printf("\n");
    }
951
    return 0;
952 953 954 955 956 957 958
}

static void print_codecs(int encoder)
{
    const AVCodecDescriptor *desc = NULL;

    printf("%s:\n"
959 960 961 962 963 964 965 966 967
           " V..... = Video\n"
           " A..... = Audio\n"
           " S..... = Subtitle\n"
           " .F.... = Frame-level multithreading\n"
           " ..S... = Slice-level multithreading\n"
           " ...X.. = Codec is experimental\n"
           " ....B. = Supports draw_horiz_band\n"
           " .....D = Supports direct rendering method 1\n"
           " ------\n",
968 969 970 971 972
           encoder ? "Encoders" : "Decoders");
    while ((desc = avcodec_descriptor_next(desc))) {
        const AVCodec *codec = NULL;

        while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
973
            printf(" %c", get_media_type_char(desc->type));
974 975 976
            printf((codec->capabilities & CODEC_CAP_FRAME_THREADS) ? "F" : ".");
            printf((codec->capabilities & CODEC_CAP_SLICE_THREADS) ? "S" : ".");
            printf((codec->capabilities & CODEC_CAP_EXPERIMENTAL)  ? "X" : ".");
977 978
            printf((codec->capabilities & CODEC_CAP_DRAW_HORIZ_BAND)?"B" : ".");
            printf((codec->capabilities & CODEC_CAP_DR1)           ? "D" : ".");
979 980 981 982 983 984 985 986 987 988

            printf(" %-20s %s", codec->name, codec->long_name ? codec->long_name : "");
            if (strcmp(codec->name, desc->name))
                printf(" (codec %s)", desc->name);

            printf("\n");
        }
    }
}

989
int show_decoders(void *optctx, const char *opt, const char *arg)
990 991 992 993 994
{
    print_codecs(0);
    return 0;
}

995
int show_encoders(void *optctx, const char *opt, const char *arg)
996 997
{
    print_codecs(1);
998
    return 0;
999 1000
}

1001
int show_bsfs(void *optctx, const char *opt, const char *arg)
1002
{
1003
    AVBitStreamFilter *bsf = NULL;
1004 1005

    printf("Bitstream filters:\n");
1006
    while ((bsf = av_bitstream_filter_next(bsf)))
1007
        printf("%s\n", bsf->name);
1008
    printf("\n");
1009
    return 0;
1010 1011
}

1012
int show_protocols(void *optctx, const char *opt, const char *arg)
1013
{
1014 1015
    void *opaque = NULL;
    const char *name;
1016

1017
    printf("Supported file protocols:\n"
1018 1019 1020 1021 1022 1023
           "Input:\n");
    while ((name = avio_enum_protocols(&opaque, 0)))
        printf("%s\n", name);
    printf("Output:\n");
    while ((name = avio_enum_protocols(&opaque, 1)))
        printf("%s\n", name);
1024
    return 0;
1025
}
1026

1027
int show_filters(void *optctx, const char *opt, const char *arg)
1028
{
1029
    AVFilter av_unused(**filter) = NULL;
1030 1031 1032
    char descr[64], *descr_cur;
    int i, j;
    const AVFilterPad *pad;
1033 1034

    printf("Filters:\n");
1035
#if CONFIG_AVFILTER
1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054
    while ((filter = av_filter_next(filter)) && *filter) {
        descr_cur = descr;
        for (i = 0; i < 2; i++) {
            if (i) {
                *(descr_cur++) = '-';
                *(descr_cur++) = '>';
            }
            pad = i ? (*filter)->outputs : (*filter)->inputs;
            for (j = 0; pad[j].name; j++) {
                if (descr_cur >= descr + sizeof(descr) - 4)
                    break;
                *(descr_cur++) = get_media_type_char(pad[j].type);
            }
            if (!j)
                *(descr_cur++) = '|';
        }
        *descr_cur = 0;
        printf("%-16s %-10s %s\n", (*filter)->name, descr, (*filter)->description);
    }
1055
#endif
1056
    return 0;
1057 1058
}

1059
int show_pix_fmts(void *optctx, const char *opt, const char *arg)
1060
{
1061 1062
    enum PixelFormat pix_fmt;

1063 1064 1065 1066 1067 1068 1069 1070
    printf("Pixel formats:\n"
           "I.... = Supported Input  format for conversion\n"
           ".O... = Supported Output format for conversion\n"
           "..H.. = Hardware accelerated format\n"
           "...P. = Paletted format\n"
           "....B = Bitstream format\n"
           "FLAGS NAME            NB_COMPONENTS BITS_PER_PIXEL\n"
           "-----\n");
1071

1072 1073 1074 1075 1076
#if !CONFIG_SWSCALE
#   define sws_isSupportedInput(x)  0
#   define sws_isSupportedOutput(x) 0
#endif

1077 1078
    for (pix_fmt = 0; pix_fmt < PIX_FMT_NB; pix_fmt++) {
        const AVPixFmtDescriptor *pix_desc = &av_pix_fmt_descriptors[pix_fmt];
1079 1080
        if(!pix_desc->name)
            continue;
1081 1082 1083 1084 1085 1086 1087 1088 1089 1090
        printf("%c%c%c%c%c %-16s       %d            %2d\n",
               sws_isSupportedInput (pix_fmt)      ? 'I' : '.',
               sws_isSupportedOutput(pix_fmt)      ? 'O' : '.',
               pix_desc->flags & PIX_FMT_HWACCEL   ? 'H' : '.',
               pix_desc->flags & PIX_FMT_PAL       ? 'P' : '.',
               pix_desc->flags & PIX_FMT_BITSTREAM ? 'B' : '.',
               pix_desc->name,
               pix_desc->nb_components,
               av_get_bits_per_pixel(pix_desc));
    }
1091
    return 0;
1092 1093
}

1094
int show_layouts(void *optctx, const char *opt, const char *arg)
1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122
{
    int i = 0;
    uint64_t layout, j;
    const char *name, *descr;

    printf("Individual channels:\n"
           "NAME        DESCRIPTION\n");
    for (i = 0; i < 63; i++) {
        name = av_get_channel_name((uint64_t)1 << i);
        if (!name)
            continue;
        descr = av_get_channel_description((uint64_t)1 << i);
        printf("%-12s%s\n", name, descr);
    }
    printf("\nStandard channel layouts:\n"
           "NAME        DECOMPOSITION\n");
    for (i = 0; !av_get_standard_channel_layout(i, &layout, &name); i++) {
        if (name) {
            printf("%-12s", name);
            for (j = 1; j; j <<= 1)
                if ((layout & j))
                    printf("%s%s", (layout & (j - 1)) ? "+" : "", av_get_channel_name(j));
            printf("\n");
        }
    }
    return 0;
}

1123
int show_sample_fmts(void *optctx, const char *opt, const char *arg)
1124 1125 1126 1127 1128 1129 1130 1131
{
    int i;
    char fmt_str[128];
    for (i = -1; i < AV_SAMPLE_FMT_NB; i++)
        printf("%s\n", av_get_sample_fmt_string(fmt_str, sizeof(fmt_str), i));
    return 0;
}

1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155
static void show_help_codec(const char *name, int encoder)
{
    const AVCodecDescriptor *desc;
    const AVCodec *codec;

    if (!name) {
        av_log(NULL, AV_LOG_ERROR, "No codec name specified.\n");
        return;
    }

    codec = encoder ? avcodec_find_encoder_by_name(name) :
                      avcodec_find_decoder_by_name(name);

    if (codec)
        print_codec(codec);
    else if ((desc = avcodec_descriptor_get_by_name(name))) {
        int printed = 0;

        while ((codec = next_codec_for_id(desc->id, codec, encoder))) {
            printed = 1;
            print_codec(codec);
        }

        if (!printed) {
1156 1157
            av_log(NULL, AV_LOG_ERROR, "Codec '%s' is known to FFmpeg, "
                   "but no %s for it are available. FFmpeg might need to be "
1158 1159 1160 1161
                   "recompiled with additional external libraries.\n",
                   name, encoder ? "encoders" : "decoders");
        }
    } else {
1162
        av_log(NULL, AV_LOG_ERROR, "Codec '%s' is not recognized by FFmpeg.\n",
1163 1164 1165 1166
               name);
    }
}

1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217
static void show_help_demuxer(const char *name)
{
    const AVInputFormat *fmt = av_find_input_format(name);

    if (!fmt) {
        av_log(NULL, AV_LOG_ERROR, "Unknown format '%s'.\n", name);
        return;
    }

    printf("Demuxer %s [%s]:\n", fmt->name, fmt->long_name);

    if (fmt->extensions)
        printf("    Common extensions: %s.\n", fmt->extensions);

    if (fmt->priv_class)
        show_help_children(fmt->priv_class, AV_OPT_FLAG_DECODING_PARAM);
}

static void show_help_muxer(const char *name)
{
    const AVCodecDescriptor *desc;
    const AVOutputFormat *fmt = av_guess_format(name, NULL, NULL);

    if (!fmt) {
        av_log(NULL, AV_LOG_ERROR, "Unknown format '%s'.\n", name);
        return;
    }

    printf("Muxer %s [%s]:\n", fmt->name, fmt->long_name);

    if (fmt->extensions)
        printf("    Common extensions: %s.\n", fmt->extensions);
    if (fmt->mime_type)
        printf("    Mime type: %s.\n", fmt->mime_type);
    if (fmt->video_codec != AV_CODEC_ID_NONE &&
        (desc = avcodec_descriptor_get(fmt->video_codec))) {
        printf("    Default video codec: %s.\n", desc->name);
    }
    if (fmt->audio_codec != AV_CODEC_ID_NONE &&
        (desc = avcodec_descriptor_get(fmt->audio_codec))) {
        printf("    Default audio codec: %s.\n", desc->name);
    }
    if (fmt->subtitle_codec != AV_CODEC_ID_NONE &&
        (desc = avcodec_descriptor_get(fmt->subtitle_codec))) {
        printf("    Default subtitle codec: %s.\n", desc->name);
    }

    if (fmt->priv_class)
        show_help_children(fmt->priv_class, AV_OPT_FLAG_ENCODING_PARAM);
}

1218
int show_help(void *optctx, const char *opt, const char *arg)
1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233
{
    char *topic, *par;
    av_log_set_callback(log_callback_help);

    topic = av_strdup(arg ? arg : "");
    par = strchr(topic, '=');
    if (par)
        *par++ = 0;

    if (!*topic) {
        show_help_default(topic, par);
    } else if (!strcmp(topic, "decoder")) {
        show_help_codec(par, 0);
    } else if (!strcmp(topic, "encoder")) {
        show_help_codec(par, 1);
1234 1235 1236 1237
    } else if (!strcmp(topic, "demuxer")) {
        show_help_demuxer(par);
    } else if (!strcmp(topic, "muxer")) {
        show_help_muxer(par);
1238 1239 1240 1241 1242 1243 1244 1245
    } else {
        show_help_default(topic, par);
    }

    av_freep(&topic);
    return 0;
}

1246 1247 1248 1249 1250 1251 1252 1253 1254 1255
int read_yesno(void)
{
    int c = getchar();
    int yesno = (toupper(c) == 'Y');

    while (c != '\n' && c != EOF)
        c = getchar();

    return yesno;
}
1256

1257
int cmdutils_read_file(const char *filename, char **bufptr, size_t *size)
1258
{
1259
    int ret;
1260
    FILE *f = fopen(filename, "rb");
1261 1262

    if (!f) {
1263 1264
        av_log(NULL, AV_LOG_ERROR, "Cannot read file '%s': %s\n", filename,
               strerror(errno));
1265 1266 1267 1268 1269 1270 1271
        return AVERROR(errno);
    }
    fseek(f, 0, SEEK_END);
    *size = ftell(f);
    fseek(f, 0, SEEK_SET);
    *bufptr = av_malloc(*size + 1);
    if (!*bufptr) {
1272
        av_log(NULL, AV_LOG_ERROR, "Could not allocate file buffer\n");
1273 1274 1275
        fclose(f);
        return AVERROR(ENOMEM);
    }
1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288
    ret = fread(*bufptr, 1, *size, f);
    if (ret < *size) {
        av_free(*bufptr);
        if (ferror(f)) {
            av_log(NULL, AV_LOG_ERROR, "Error while reading file '%s': %s\n",
                   filename, strerror(errno));
            ret = AVERROR(errno);
        } else
            ret = AVERROR_EOF;
    } else {
        ret = 0;
        (*bufptr)[*size++] = '\0';
    }
1289 1290

    fclose(f);
1291
    return ret;
1292
}
1293

1294
FILE *get_preset_file(char *filename, size_t filename_size,
1295 1296
                      const char *preset_name, int is_path,
                      const char *codec_name)
1297 1298 1299
{
    FILE *f = NULL;
    int i;
1300
    const char *base[3] = { getenv("FFMPEG_DATADIR"),
1301
                            getenv("HOME"),
1302
                            FFMPEG_DATADIR, };
1303 1304 1305 1306 1307

    if (is_path) {
        av_strlcpy(filename, preset_name, filename_size);
        f = fopen(filename, "r");
    } else {
Gianluigi Tiesi's avatar
Gianluigi Tiesi committed
1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324
#ifdef _WIN32
        char datadir[MAX_PATH], *ls;
        base[2] = NULL;

        if (GetModuleFileNameA(GetModuleHandleA(NULL), datadir, sizeof(datadir) - 1))
        {
            for (ls = datadir; ls < datadir + strlen(datadir); ls++)
                if (*ls == '\\') *ls = '/';

            if (ls = strrchr(datadir, '/'))
            {
                *ls = 0;
                strncat(datadir, "/ffpresets",  sizeof(datadir) - 1 - strlen(datadir));
                base[2] = datadir;
            }
        }
#endif
1325 1326 1327
        for (i = 0; i < 3 && !f; i++) {
            if (!base[i])
                continue;
1328
            snprintf(filename, filename_size, "%s%s/%s.ffpreset", base[i],
1329
                     i != 1 ? "" : "/.ffmpeg", preset_name);
1330 1331 1332
            f = fopen(filename, "r");
            if (!f && codec_name) {
                snprintf(filename, filename_size,
1333
                         "%s%s/%s-%s.ffpreset",
1334
                         base[i], i != 1 ? "" : "/.ffmpeg", codec_name,
1335
                         preset_name);
1336 1337 1338 1339 1340 1341 1342 1343
                f = fopen(filename, "r");
            }
        }
    }

    return f;
}

1344 1345
int check_stream_specifier(AVFormatContext *s, AVStream *st, const char *spec)
{
1346 1347 1348 1349
    int ret = avformat_match_stream_specifier(s, st, spec);
    if (ret < 0)
        av_log(s, AV_LOG_ERROR, "Invalid stream specifier: %s.\n", spec);
    return ret;
1350 1351
}

1352
AVDictionary *filter_codec_opts(AVDictionary *opts, enum AVCodecID codec_id,
1353
                                AVFormatContext *s, AVStream *st, AVCodec *codec)
1354 1355 1356
{
    AVDictionary    *ret = NULL;
    AVDictionaryEntry *t = NULL;
1357 1358
    int            flags = s->oformat ? AV_OPT_FLAG_ENCODING_PARAM
                                      : AV_OPT_FLAG_DECODING_PARAM;
1359
    char          prefix = 0;
1360
    const AVClass    *cc = avcodec_get_class();
1361

1362 1363 1364
    if (!codec)
        codec            = s->oformat ? avcodec_find_encoder(codec_id)
                                      : avcodec_find_decoder(codec_id);
1365 1366 1367 1368
    if (!codec)
        return NULL;

    switch (codec->type) {
1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380
    case AVMEDIA_TYPE_VIDEO:
        prefix  = 'v';
        flags  |= AV_OPT_FLAG_VIDEO_PARAM;
        break;
    case AVMEDIA_TYPE_AUDIO:
        prefix  = 'a';
        flags  |= AV_OPT_FLAG_AUDIO_PARAM;
        break;
    case AVMEDIA_TYPE_SUBTITLE:
        prefix  = 's';
        flags  |= AV_OPT_FLAG_SUBTITLE_PARAM;
        break;
1381 1382 1383
    }

    while (t = av_dict_get(opts, "", t, AV_DICT_IGNORE_SUFFIX)) {
1384 1385 1386 1387 1388 1389 1390 1391 1392 1393
        char *p = strchr(t->key, ':');

        /* check stream specification in opt name */
        if (p)
            switch (check_stream_specifier(s, st, p + 1)) {
            case  1: *p = 0; break;
            case  0:         continue;
            default:         return NULL;
            }

1394
        if (av_opt_find(&cc, t->key, NULL, flags, AV_OPT_SEARCH_FAKE_OBJ) ||
1395 1396 1397
            (codec && codec->priv_class &&
             av_opt_find(&codec->priv_class, t->key, NULL, flags,
                         AV_OPT_SEARCH_FAKE_OBJ)))
1398
            av_dict_set(&ret, t->key, t->value, 0);
1399 1400 1401 1402
        else if (t->key[0] == prefix &&
                 av_opt_find(&cc, t->key + 1, NULL, flags,
                             AV_OPT_SEARCH_FAKE_OBJ))
            av_dict_set(&ret, t->key + 1, t->value, 0);
1403 1404 1405

        if (p)
            *p = ':';
1406 1407 1408 1409
    }
    return ret;
}

1410 1411
AVDictionary **setup_find_stream_info_opts(AVFormatContext *s,
                                           AVDictionary *codec_opts)
1412 1413 1414 1415 1416 1417 1418 1419
{
    int i;
    AVDictionary **opts;

    if (!s->nb_streams)
        return NULL;
    opts = av_mallocz(s->nb_streams * sizeof(*opts));
    if (!opts) {
1420 1421
        av_log(NULL, AV_LOG_ERROR,
               "Could not alloc memory for stream options.\n");
1422 1423 1424
        return NULL;
    }
    for (i = 0; i < s->nb_streams; i++)
1425
        opts[i] = filter_codec_opts(codec_opts, s->streams[i]->codec->codec_id,
1426
                                    s, s->streams[i], NULL);
1427 1428 1429
    return opts;
}

1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447
void *grow_array(void *array, int elem_size, int *size, int new_size)
{
    if (new_size >= INT_MAX / elem_size) {
        av_log(NULL, AV_LOG_ERROR, "Array too big.\n");
        exit_program(1);
    }
    if (*size < new_size) {
        uint8_t *tmp = av_realloc(array, new_size*elem_size);
        if (!tmp) {
            av_log(NULL, AV_LOG_ERROR, "Could not alloc buffer.\n");
            exit_program(1);
        }
        memset(tmp + *size*elem_size, 0, (new_size-*size) * elem_size);
        *size = new_size;
        return tmp;
    }
    return array;
}
1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460

static int alloc_buffer(FrameBuffer **pool, AVCodecContext *s, FrameBuffer **pbuf)
{
    FrameBuffer  *buf = av_mallocz(sizeof(*buf));
    int i, ret;
    const int pixel_size = av_pix_fmt_descriptors[s->pix_fmt].comp[0].step_minus1+1;
    int h_chroma_shift, v_chroma_shift;
    int edge = 32; // XXX should be avcodec_get_edge_width(), but that fails on svq1
    int w = s->width, h = s->height;

    if (!buf)
        return AVERROR(ENOMEM);

1461 1462
    avcodec_align_dimensions(s, &w, &h);

1463 1464 1465 1466 1467 1468 1469 1470
    if (!(s->flags & CODEC_FLAG_EMU_EDGE)) {
        w += 2*edge;
        h += 2*edge;
    }

    if ((ret = av_image_alloc(buf->base, buf->linesize, w, h,
                              s->pix_fmt, 32)) < 0) {
        av_freep(&buf);
1471
        av_log(s, AV_LOG_ERROR, "alloc_buffer: av_image_alloc() failed\n");
1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484
        return ret;
    }
    /* XXX this shouldn't be needed, but some tests break without this line
     * those decoders are buggy and need to be fixed.
     * the following tests fail:
     * cdgraphics, ansi, aasc, fraps-v1, qtrle-1bit
     */
    memset(buf->base[0], 128, ret);

    avcodec_get_chroma_sub_sample(s->pix_fmt, &h_chroma_shift, &v_chroma_shift);
    for (i = 0; i < FF_ARRAY_ELEMS(buf->data); i++) {
        const int h_shift = i==0 ? 0 : h_chroma_shift;
        const int v_shift = i==0 ? 0 : v_chroma_shift;
1485
        if ((s->flags & CODEC_FLAG_EMU_EDGE) || !buf->linesize[i] || !buf->base[i])
1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506
            buf->data[i] = buf->base[i];
        else
            buf->data[i] = buf->base[i] +
                           FFALIGN((buf->linesize[i]*edge >> v_shift) +
                                   (pixel_size*edge >> h_shift), 32);
    }
    buf->w       = s->width;
    buf->h       = s->height;
    buf->pix_fmt = s->pix_fmt;
    buf->pool    = pool;

    *pbuf = buf;
    return 0;
}

int codec_get_buffer(AVCodecContext *s, AVFrame *frame)
{
    FrameBuffer **pool = s->opaque;
    FrameBuffer *buf;
    int ret, i;

1507 1508
    if(av_image_check_size(s->width, s->height, 0, s) || s->pix_fmt<0) {
        av_log(s, AV_LOG_ERROR, "codec_get_buffer: image parameters invalid\n");
1509
        return -1;
1510
    }
1511

1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523
    if (!*pool && (ret = alloc_buffer(pool, s, pool)) < 0)
        return ret;

    buf              = *pool;
    *pool            = buf->next;
    buf->next        = NULL;
    if (buf->w != s->width || buf->h != s->height || buf->pix_fmt != s->pix_fmt) {
        av_freep(&buf->base[0]);
        av_free(buf);
        if ((ret = alloc_buffer(pool, s, &buf)) < 0)
            return ret;
    }
1524
    av_assert0(!buf->refcount);
1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548
    buf->refcount++;

    frame->opaque        = buf;
    frame->type          = FF_BUFFER_TYPE_USER;
    frame->extended_data = frame->data;
    frame->pkt_pts       = s->pkt ? s->pkt->pts : AV_NOPTS_VALUE;
    frame->width         = buf->w;
    frame->height        = buf->h;
    frame->format        = buf->pix_fmt;
    frame->sample_aspect_ratio = s->sample_aspect_ratio;

    for (i = 0; i < FF_ARRAY_ELEMS(buf->data); i++) {
        frame->base[i]     = buf->base[i];  // XXX h264.c uses base though it shouldn't
        frame->data[i]     = buf->data[i];
        frame->linesize[i] = buf->linesize[i];
    }

    return 0;
}

static void unref_buffer(FrameBuffer *buf)
{
    FrameBuffer **pool = buf->pool;

1549
    av_assert0(buf->refcount > 0);
1550 1551
    buf->refcount--;
    if (!buf->refcount) {
1552 1553 1554 1555
        FrameBuffer *tmp;
        for(tmp= *pool; tmp; tmp= tmp->next)
            av_assert1(tmp != buf);

1556 1557 1558 1559 1560 1561 1562 1563 1564 1565
        buf->next = *pool;
        *pool = buf;
    }
}

void codec_release_buffer(AVCodecContext *s, AVFrame *frame)
{
    FrameBuffer *buf = frame->opaque;
    int i;

1566
    if(frame->type!=FF_BUFFER_TYPE_USER) {
1567
        avcodec_default_release_buffer(s, frame);
1568 1569
        return;
    }
1570

1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593
    for (i = 0; i < FF_ARRAY_ELEMS(frame->data); i++)
        frame->data[i] = NULL;

    unref_buffer(buf);
}

void filter_release_buffer(AVFilterBuffer *fb)
{
    FrameBuffer *buf = fb->priv;
    av_free(fb);
    unref_buffer(buf);
}

void free_buffer_pool(FrameBuffer **pool)
{
    FrameBuffer *buf = *pool;
    while (buf) {
        *pool = buf->next;
        av_freep(&buf->base[0]);
        av_free(buf);
        buf = *pool;
    }
}