2 * Various utilities for command line tools
3 * Copyright (c) 2000-2003 Fabrice Bellard
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
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. */
32 #include "libavformat/avformat.h"
34 #include "libavfilter/avfilter.h"
36 #include "libavdevice/avdevice.h"
37 #include "libswscale/swscale.h"
39 #include "libpostproc/postprocess.h"
41 #include "libavutil/avstring.h"
42 #include "libavcodec/opt.h"
46 #include "libavformat/network.h"
51 const char **opt_names;
52 static int opt_name_count;
53 AVCodecContext *avctx_opts[CODEC_TYPE_NB];
54 AVFormatContext *avformat_opts;
55 struct SwsContext *sws_opts;
57 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
61 double d = strtod(numstr, &tail);
63 error= "Expected number for %s but found: %s\n";
64 else if (d < min || d > max)
65 error= "The value for %s was %s which is not within %f - %f\n";
66 else if(type == OPT_INT64 && (int64_t)d != d)
67 error= "Expected int64 for %s but found %s\n";
70 fprintf(stderr, error, context, numstr, min, max);
74 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
76 int64_t us = parse_date(timestr, is_duration);
77 if (us == INT64_MIN) {
78 fprintf(stderr, "Invalid %s specification for %s: %s\n",
79 is_duration ? "duration" : "date", context, timestr);
85 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
91 for(po = options; po->name != NULL; po++) {
93 if ((po->flags & mask) == value) {
98 av_strlcpy(buf, po->name, sizeof(buf));
99 if (po->flags & HAS_ARG) {
100 av_strlcat(buf, " ", sizeof(buf));
101 av_strlcat(buf, po->argname, sizeof(buf));
103 printf("-%-17s %s\n", buf, po->help);
108 static const OptionDef* find_option(const OptionDef *po, const char *name){
109 while (po->name != NULL) {
110 if (!strcmp(name, po->name))
117 void parse_options(int argc, char **argv, const OptionDef *options,
118 void (* parse_arg_function)(const char*))
120 const char *opt, *arg;
121 int optindex, handleoptions=1;
126 while (optindex < argc) {
127 opt = argv[optindex++];
129 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
130 if (opt[1] == '-' && opt[2] == '\0') {
134 po= find_option(options, opt + 1);
136 po= find_option(options, "default");
139 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
143 if (po->flags & HAS_ARG) {
144 arg = argv[optindex++];
146 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
150 if (po->flags & OPT_STRING) {
152 str = av_strdup(arg);
153 *po->u.str_arg = str;
154 } else if (po->flags & OPT_BOOL) {
156 } else if (po->flags & OPT_INT) {
157 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
158 } else if (po->flags & OPT_INT64) {
159 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
160 } else if (po->flags & OPT_FLOAT) {
161 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
162 } else if (po->flags & OPT_FUNC2) {
163 if(po->u.func2_arg(opt+1, arg)<0)
168 if(po->flags & OPT_EXIT)
171 if (parse_arg_function)
172 parse_arg_function(opt);
177 int opt_default(const char *opt, const char *arg){
180 const AVOption *o= NULL;
181 int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
183 for(type=0; type<CODEC_TYPE_NB && ret>= 0; type++){
184 const AVOption *o2 = av_find_opt(avctx_opts[0], opt, NULL, opt_types[type], opt_types[type]);
186 ret = av_set_string3(avctx_opts[type], opt, arg, 1, &o);
189 ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
191 ret = av_set_string3(sws_opts, opt, arg, 1, &o);
194 ret = av_set_string3(avctx_opts[CODEC_TYPE_AUDIO], opt+1, arg, 1, &o);
195 else if(opt[0] == 'v')
196 ret = av_set_string3(avctx_opts[CODEC_TYPE_VIDEO], opt+1, arg, 1, &o);
197 else if(opt[0] == 's')
198 ret = av_set_string3(avctx_opts[CODEC_TYPE_SUBTITLE], opt+1, arg, 1, &o);
201 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
207 // av_log(NULL, AV_LOG_ERROR, "%s:%s: %f 0x%0X\n", opt, arg, av_get_double(avctx_opts, opt, NULL), (int)av_get_int(avctx_opts, opt, NULL));
209 //FIXME we should always use avctx_opts, ... for storing options so there will not be any need to keep track of what i set over this
210 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
211 opt_names[opt_name_count++]= o->name;
213 if(avctx_opts[0]->debug || avformat_opts->debug)
214 av_log_set_level(AV_LOG_DEBUG);
218 void set_context_opts(void *ctx, void *opts_ctx, int flags)
221 for(i=0; i<opt_name_count; i++){
224 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
225 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
226 if(str && ((opt->flags & flags) == flags))
227 av_set_string3(ctx, opt_names[i], str, 1, NULL);
231 void print_error(const char *filename, int err)
234 case AVERROR_NUMEXPECTED:
235 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
236 "Use '%%d' to specify the image number:\n"
237 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
238 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
241 case AVERROR_INVALIDDATA:
242 fprintf(stderr, "%s: Error while parsing header\n", filename);
245 fprintf(stderr, "%s: Unknown format\n", filename);
248 fprintf(stderr, "%s: I/O error occurred\n"
249 "Usually that means that input file is truncated and/or corrupted.\n",
252 case AVERROR(ENOMEM):
253 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
255 case AVERROR(ENOENT):
256 fprintf(stderr, "%s: no such file or directory\n", filename);
259 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
260 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
264 fprintf(stderr, "%s: Error while opening file\n", filename);
269 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
270 version= libname##_version(); \
271 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? " " : "", #libname, \
272 LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
273 version >> 16, version >> 8 & 0xff, version & 0xff);
275 static void print_all_lib_versions(FILE* outstream, int indent)
277 unsigned int version;
278 PRINT_LIB_VERSION(outstream, avutil, AVUTIL, indent);
279 PRINT_LIB_VERSION(outstream, avcodec, AVCODEC, indent);
280 PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
281 PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
283 PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
286 PRINT_LIB_VERSION(outstream, swscale, SWSCALE, indent);
289 PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
293 void show_banner(void)
295 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-2009 Fabrice Bellard, et al.\n",
296 program_name, program_birth_year);
297 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
298 print_all_lib_versions(stderr, 1);
299 fprintf(stderr, " built on " __DATE__ " " __TIME__);
301 fprintf(stderr, ", gcc: " __VERSION__ "\n");
303 fprintf(stderr, ", using a non-gcc compiler\n");
307 void show_version(void) {
308 printf("%s " FFMPEG_VERSION "\n", program_name);
309 print_all_lib_versions(stdout, 0);
312 void show_license(void)
316 "This version of %s has nonfree parts compiled in.\n"
317 "Therefore it is not legally redistributable.\n",
322 "%s is free software; you can redistribute it and/or modify\n"
323 "it under the terms of the GNU General Public License as published by\n"
324 "the Free Software Foundation; either version 2 of the License, or\n"
325 "(at your option) any later version.\n"
327 "%s is distributed in the hope that it will be useful,\n"
328 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
329 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
330 "GNU General Public License for more details.\n"
332 "You should have received a copy of the GNU General Public License\n"
333 "along with %s; if not, write to the Free Software\n"
334 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
335 program_name, program_name, program_name
339 "%s is free software; you can redistribute it and/or\n"
340 "modify it under the terms of the GNU Lesser General Public\n"
341 "License as published by the Free Software Foundation; either\n"
342 "version 2.1 of the License, or (at your option) any later version.\n"
344 "%s is distributed in the hope that it will be useful,\n"
345 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
346 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
347 "Lesser General Public License for more details.\n"
349 "You should have received a copy of the GNU Lesser General Public\n"
350 "License along with %s; if not, write to the Free Software\n"
351 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
352 program_name, program_name, program_name
357 void show_formats(void)
359 AVInputFormat *ifmt=NULL;
360 AVOutputFormat *ofmt=NULL;
361 URLProtocol *up=NULL;
362 AVCodec *p=NULL, *p2;
363 AVBitStreamFilter *bsf=NULL;
364 const char *last_name;
366 printf("File formats:\n");
371 const char *name=NULL;
372 const char *long_name=NULL;
374 while((ofmt= av_oformat_next(ofmt))) {
375 if((name == NULL || strcmp(ofmt->name, name)<0) &&
376 strcmp(ofmt->name, last_name)>0){
378 long_name= ofmt->long_name;
382 while((ifmt= av_iformat_next(ifmt))) {
383 if((name == NULL || strcmp(ifmt->name, name)<0) &&
384 strcmp(ifmt->name, last_name)>0){
386 long_name= ifmt->long_name;
389 if(name && strcmp(ifmt->name, name)==0)
401 long_name ? long_name:" ");
411 const char *type_str;
414 while((p= av_codec_next(p))) {
415 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
416 strcmp(p->name, last_name)>0){
418 decode= encode= cap=0;
420 if(p2 && strcmp(p->name, p2->name)==0){
421 if(p->decode) decode=1;
422 if(p->encode) encode=1;
423 cap |= p->capabilities;
431 case CODEC_TYPE_VIDEO:
434 case CODEC_TYPE_AUDIO:
437 case CODEC_TYPE_SUBTITLE:
445 " %s%s%s%s%s%s %-15s %s",
446 decode ? "D": (/*p2->decoder ? "d":*/" "),
449 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
450 cap & CODEC_CAP_DR1 ? "D":" ",
451 cap & CODEC_CAP_TRUNCATED ? "T":" ",
453 p2->long_name ? p2->long_name : "");
454 /* if(p2->decoder && decode==0)
455 printf(" use %s for decoding", p2->decoder->name);*/
460 printf("Bitstream filters:\n");
461 while((bsf = av_bitstream_filter_next(bsf)))
462 printf(" %s", bsf->name);
465 printf("Supported file protocols:\n");
466 while((up = av_protocol_next(up)))
467 printf(" %s:", up->name);
470 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
473 "Note, the names of encoders and decoders do not always match, so there are\n"
474 "several cases where the above table shows encoder only or decoder only entries\n"
475 "even though both encoding and decoding are supported. For example, the h263\n"
476 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"