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"
33 #include "libavfilter/avfilter.h"
34 #include "libavdevice/avdevice.h"
35 #include "libswscale/swscale.h"
36 #include "libpostproc/postprocess.h"
37 #include "libavutil/avstring.h"
38 #include "libavcodec/opt.h"
41 #include "libavformat/network.h"
45 const char **opt_names;
46 static int opt_name_count;
47 AVCodecContext *avctx_opts[CODEC_TYPE_NB];
48 AVFormatContext *avformat_opts;
49 struct SwsContext *sws_opts;
51 const int this_year = 2009;
53 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
57 double d = strtod(numstr, &tail);
59 error= "Expected number for %s but found: %s\n";
60 else if (d < min || d > max)
61 error= "The value for %s was %s which is not within %f - %f\n";
62 else if(type == OPT_INT64 && (int64_t)d != d)
63 error= "Expected int64 for %s but found %s\n";
66 fprintf(stderr, error, context, numstr, min, max);
70 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
72 int64_t us = parse_date(timestr, is_duration);
73 if (us == INT64_MIN) {
74 fprintf(stderr, "Invalid %s specification for %s: %s\n",
75 is_duration ? "duration" : "date", context, timestr);
81 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
87 for(po = options; po->name != NULL; po++) {
89 if ((po->flags & mask) == value) {
94 av_strlcpy(buf, po->name, sizeof(buf));
95 if (po->flags & HAS_ARG) {
96 av_strlcat(buf, " ", sizeof(buf));
97 av_strlcat(buf, po->argname, sizeof(buf));
99 printf("-%-17s %s\n", buf, po->help);
104 static const OptionDef* find_option(const OptionDef *po, const char *name){
105 while (po->name != NULL) {
106 if (!strcmp(name, po->name))
113 void parse_options(int argc, char **argv, const OptionDef *options,
114 void (* parse_arg_function)(const char*))
116 const char *opt, *arg;
117 int optindex, handleoptions=1;
122 while (optindex < argc) {
123 opt = argv[optindex++];
125 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
126 if (opt[1] == '-' && opt[2] == '\0') {
130 po= find_option(options, opt + 1);
132 po= find_option(options, "default");
135 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
139 if (po->flags & HAS_ARG) {
140 arg = argv[optindex++];
142 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
146 if (po->flags & OPT_STRING) {
148 str = av_strdup(arg);
149 *po->u.str_arg = str;
150 } else if (po->flags & OPT_BOOL) {
152 } else if (po->flags & OPT_INT) {
153 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
154 } else if (po->flags & OPT_INT64) {
155 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
156 } else if (po->flags & OPT_FLOAT) {
157 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
158 } else if (po->flags & OPT_FUNC2) {
159 if(po->u.func2_arg(opt+1, arg)<0)
164 if(po->flags & OPT_EXIT)
167 if (parse_arg_function)
168 parse_arg_function(opt);
173 int opt_default(const char *opt, const char *arg){
176 const AVOption *o= NULL;
177 int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
179 for(type=0; type<CODEC_TYPE_NB && ret>= 0; type++){
180 const AVOption *o2 = av_find_opt(avctx_opts[0], opt, NULL, opt_types[type], opt_types[type]);
182 ret = av_set_string3(avctx_opts[type], opt, arg, 1, &o);
185 ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
187 ret = av_set_string3(sws_opts, opt, arg, 1, &o);
190 ret = av_set_string3(avctx_opts[CODEC_TYPE_AUDIO], opt+1, arg, 1, &o);
191 else if(opt[0] == 'v')
192 ret = av_set_string3(avctx_opts[CODEC_TYPE_VIDEO], opt+1, arg, 1, &o);
193 else if(opt[0] == 's')
194 ret = av_set_string3(avctx_opts[CODEC_TYPE_SUBTITLE], opt+1, arg, 1, &o);
197 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
203 // 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));
205 //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
206 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
207 opt_names[opt_name_count++]= o->name;
209 if(avctx_opts[0]->debug || avformat_opts->debug)
210 av_log_set_level(AV_LOG_DEBUG);
214 void set_context_opts(void *ctx, void *opts_ctx, int flags)
217 for(i=0; i<opt_name_count; i++){
220 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
221 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
222 if(str && ((opt->flags & flags) == flags))
223 av_set_string3(ctx, opt_names[i], str, 1, NULL);
227 void print_error(const char *filename, int err)
230 case AVERROR_NUMEXPECTED:
231 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
232 "Use '%%d' to specify the image number:\n"
233 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
234 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
237 case AVERROR_INVALIDDATA:
238 fprintf(stderr, "%s: Error while parsing header\n", filename);
241 fprintf(stderr, "%s: Unknown format\n", filename);
244 fprintf(stderr, "%s: I/O error occurred\n"
245 "Usually that means that input file is truncated and/or corrupted.\n",
248 case AVERROR(ENOMEM):
249 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
251 case AVERROR(ENOENT):
252 fprintf(stderr, "%s: no such file or directory\n", filename);
255 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
256 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
260 fprintf(stderr, "%s: Error while opening file\n", filename);
265 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
266 version= libname##_version(); \
267 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? " " : "", #libname, \
268 LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
269 version >> 16, version >> 8 & 0xff, version & 0xff);
271 static void print_all_lib_versions(FILE* outstream, int indent)
273 unsigned int version;
274 PRINT_LIB_VERSION(outstream, avutil, AVUTIL, indent);
275 PRINT_LIB_VERSION(outstream, avcodec, AVCODEC, indent);
276 PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
277 PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
279 PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
282 PRINT_LIB_VERSION(outstream, swscale, SWSCALE, indent);
285 PRINT_LIB_VERSION(outstream, postproc, POSTPROC, indent);
289 void show_banner(void)
291 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-%d Fabrice Bellard, et al.\n",
292 program_name, program_birth_year, this_year);
293 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
294 print_all_lib_versions(stderr, 1);
295 fprintf(stderr, " built on " __DATE__ " " __TIME__);
297 fprintf(stderr, ", gcc: " __VERSION__ "\n");
299 fprintf(stderr, ", using a non-gcc compiler\n");
303 void show_version(void) {
304 printf("%s " FFMPEG_VERSION "\n", program_name);
305 print_all_lib_versions(stdout, 0);
308 void show_license(void)
312 "This version of %s has nonfree parts compiled in.\n"
313 "Therefore it is not legally redistributable.\n",
318 "%s is free software; you can redistribute it and/or modify\n"
319 "it under the terms of the GNU General Public License as published by\n"
320 "the Free Software Foundation; either version 2 of the License, or\n"
321 "(at your option) any later version.\n"
323 "%s is distributed in the hope that it will be useful,\n"
324 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
325 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
326 "GNU General Public License for more details.\n"
328 "You should have received a copy of the GNU General Public License\n"
329 "along with %s; if not, write to the Free Software\n"
330 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
331 program_name, program_name, program_name
335 "%s is free software; you can redistribute it and/or\n"
336 "modify it under the terms of the GNU Lesser General Public\n"
337 "License as published by the Free Software Foundation; either\n"
338 "version 2.1 of the License, or (at your option) any later version.\n"
340 "%s is distributed in the hope that it will be useful,\n"
341 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
342 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
343 "Lesser General Public License for more details.\n"
345 "You should have received a copy of the GNU Lesser General Public\n"
346 "License along with %s; if not, write to the Free Software\n"
347 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
348 program_name, program_name, program_name
353 void show_formats(void)
355 AVInputFormat *ifmt=NULL;
356 AVOutputFormat *ofmt=NULL;
357 URLProtocol *up=NULL;
358 AVCodec *p=NULL, *p2;
359 AVBitStreamFilter *bsf=NULL;
360 const char *last_name;
362 printf("File formats:\n");
367 const char *name=NULL;
368 const char *long_name=NULL;
370 while((ofmt= av_oformat_next(ofmt))) {
371 if((name == NULL || strcmp(ofmt->name, name)<0) &&
372 strcmp(ofmt->name, last_name)>0){
374 long_name= ofmt->long_name;
378 while((ifmt= av_iformat_next(ifmt))) {
379 if((name == NULL || strcmp(ifmt->name, name)<0) &&
380 strcmp(ifmt->name, last_name)>0){
382 long_name= ifmt->long_name;
385 if(name && strcmp(ifmt->name, name)==0)
397 long_name ? long_name:" ");
407 const char *type_str;
410 while((p= av_codec_next(p))) {
411 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
412 strcmp(p->name, last_name)>0){
414 decode= encode= cap=0;
416 if(p2 && strcmp(p->name, p2->name)==0){
417 if(p->decode) decode=1;
418 if(p->encode) encode=1;
419 cap |= p->capabilities;
427 case CODEC_TYPE_VIDEO:
430 case CODEC_TYPE_AUDIO:
433 case CODEC_TYPE_SUBTITLE:
441 " %s%s%s%s%s%s %-15s %s",
442 decode ? "D": (/*p2->decoder ? "d":*/" "),
445 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
446 cap & CODEC_CAP_DR1 ? "D":" ",
447 cap & CODEC_CAP_TRUNCATED ? "T":" ",
449 p2->long_name ? p2->long_name : "");
450 /* if(p2->decoder && decode==0)
451 printf(" use %s for decoding", p2->decoder->name);*/
456 printf("Bitstream filters:\n");
457 while((bsf = av_bitstream_filter_next(bsf)))
458 printf(" %s", bsf->name);
461 printf("Supported file protocols:\n");
462 while((up = av_protocol_next(up)))
463 printf(" %s:", up->name);
466 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
469 "Note, the names of encoders and decoders do not always match, so there are\n"
470 "several cases where the above table shows encoder only or decoder only entries\n"
471 "even though both encoding and decoding are supported. For example, the h263\n"
472 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"