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. */
31 #include <ffmpeg-config.h>
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"
42 #include "libavformat/network.h"
47 const char **opt_names;
48 static int opt_name_count;
49 AVCodecContext *avcodec_opts[CODEC_TYPE_NB];
50 AVFormatContext *avformat_opts;
51 struct SwsContext *sws_opts;
53 const int this_year = 2009;
55 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
59 double d = strtod(numstr, &tail);
61 error= "Expected number for %s but found: %s\n";
62 else if (d < min || d > max)
63 error= "The value for %s was %s which is not within %f - %f\n";
64 else if(type == OPT_INT64 && (int64_t)d != d)
65 error= "Expected int64 for %s but found %s\n";
68 fprintf(stderr, error, context, numstr, min, max);
72 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
74 int64_t us = parse_date(timestr, is_duration);
75 if (us == INT64_MIN) {
76 fprintf(stderr, "Invalid %s specification for %s: %s\n",
77 is_duration ? "duration" : "date", context, timestr);
83 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
89 for(po = options; po->name != NULL; po++) {
91 if ((po->flags & mask) == value) {
96 av_strlcpy(buf, po->name, sizeof(buf));
97 if (po->flags & HAS_ARG) {
98 av_strlcat(buf, " ", sizeof(buf));
99 av_strlcat(buf, po->argname, sizeof(buf));
101 printf("-%-17s %s\n", buf, po->help);
106 static const OptionDef* find_option(const OptionDef *po, const char *name){
107 while (po->name != NULL) {
108 if (!strcmp(name, po->name))
115 void parse_options(int argc, char **argv, const OptionDef *options,
116 void (* parse_arg_function)(const char*))
118 const char *opt, *arg;
119 int optindex, handleoptions=1;
124 while (optindex < argc) {
125 opt = argv[optindex++];
127 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
128 if (opt[1] == '-' && opt[2] == '\0') {
132 po= find_option(options, opt + 1);
134 po= find_option(options, "default");
137 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
141 if (po->flags & HAS_ARG) {
142 arg = argv[optindex++];
144 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
148 if (po->flags & OPT_STRING) {
150 str = av_strdup(arg);
151 *po->u.str_arg = str;
152 } else if (po->flags & OPT_BOOL) {
154 } else if (po->flags & OPT_INT) {
155 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
156 } else if (po->flags & OPT_INT64) {
157 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
158 } else if (po->flags & OPT_FLOAT) {
159 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
160 } else if (po->flags & OPT_FUNC2) {
161 if(po->u.func2_arg(opt+1, arg)<0)
166 if(po->flags & OPT_EXIT)
169 if (parse_arg_function)
170 parse_arg_function(opt);
175 int opt_default(const char *opt, const char *arg){
178 const AVOption *o= NULL;
179 int opt_types[]={AV_OPT_FLAG_VIDEO_PARAM, AV_OPT_FLAG_AUDIO_PARAM, 0, AV_OPT_FLAG_SUBTITLE_PARAM, 0};
181 for(type=0; type<CODEC_TYPE_NB && ret>= 0; type++){
182 const AVOption *o2 = av_find_opt(avcodec_opts[0], opt, NULL, opt_types[type], opt_types[type]);
184 ret = av_set_string3(avcodec_opts[type], opt, arg, 1, &o);
187 ret = av_set_string3(avformat_opts, opt, arg, 1, &o);
189 ret = av_set_string3(sws_opts, opt, arg, 1, &o);
192 ret = av_set_string3(avcodec_opts[CODEC_TYPE_AUDIO], opt+1, arg, 1, &o);
193 else if(opt[0] == 'v')
194 ret = av_set_string3(avcodec_opts[CODEC_TYPE_VIDEO], opt+1, arg, 1, &o);
195 else if(opt[0] == 's')
196 ret = av_set_string3(avcodec_opts[CODEC_TYPE_SUBTITLE], opt+1, arg, 1, &o);
199 fprintf(stderr, "Invalid value '%s' for option '%s'\n", arg, opt);
205 // av_log(NULL, AV_LOG_ERROR, "%s:%s: %f 0x%0X\n", opt, arg, av_get_double(avcodec_opts, opt, NULL), (int)av_get_int(avcodec_opts, opt, NULL));
207 //FIXME we should always use avcodec_opts, ... for storing options so there will not be any need to keep track of what i set over this
208 opt_names= av_realloc(opt_names, sizeof(void*)*(opt_name_count+1));
209 opt_names[opt_name_count++]= o->name;
211 if(avcodec_opts[0]->debug || avformat_opts->debug)
212 av_log_set_level(AV_LOG_DEBUG);
216 void set_context_opts(void *ctx, void *opts_ctx, int flags)
219 for(i=0; i<opt_name_count; i++){
222 const char *str= av_get_string(opts_ctx, opt_names[i], &opt, buf, sizeof(buf));
223 /* if an option with name opt_names[i] is present in opts_ctx then str is non-NULL */
224 if(str && ((opt->flags & flags) == flags))
225 av_set_string3(ctx, opt_names[i], str, 1, NULL);
229 void print_error(const char *filename, int err)
232 case AVERROR_NUMEXPECTED:
233 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
234 "Use '%%d' to specify the image number:\n"
235 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
236 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
239 case AVERROR_INVALIDDATA:
240 fprintf(stderr, "%s: Error while parsing header\n", filename);
243 fprintf(stderr, "%s: Unknown format\n", filename);
246 fprintf(stderr, "%s: I/O error occurred\n"
247 "Usually that means that input file is truncated and/or corrupted.\n",
250 case AVERROR(ENOMEM):
251 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
253 case AVERROR(ENOENT):
254 fprintf(stderr, "%s: no such file or directory\n", filename);
257 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
258 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
262 fprintf(stderr, "%s: Error while opening file\n", filename);
267 #define PRINT_LIB_VERSION(outstream,libname,LIBNAME,indent) \
268 version= libname##_version(); \
269 fprintf(outstream, "%slib%-10s %2d.%2d.%2d / %2d.%2d.%2d\n", indent? " " : "", #libname, \
270 LIB##LIBNAME##_VERSION_MAJOR, LIB##LIBNAME##_VERSION_MINOR, LIB##LIBNAME##_VERSION_MICRO, \
271 version >> 16, version >> 8 & 0xff, version & 0xff);
273 static void print_all_lib_versions(FILE* outstream, int indent)
275 unsigned int version;
276 PRINT_LIB_VERSION(outstream, avutil, AVUTIL, indent);
277 PRINT_LIB_VERSION(outstream, avcodec, AVCODEC, indent);
278 PRINT_LIB_VERSION(outstream, avformat, AVFORMAT, indent);
279 PRINT_LIB_VERSION(outstream, avdevice, AVDEVICE, indent);
281 PRINT_LIB_VERSION(outstream, avfilter, AVFILTER, indent);
283 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 print_all_lib_versions(stderr, 1);
294 fprintf(stderr, " built on " __DATE__ " " __TIME__);
296 fprintf(stderr, ", gcc: " __VERSION__ "\n");
298 fprintf(stderr, ", using a non-gcc compiler\n");
302 void show_version(void) {
303 printf("%s " FFMPEG_VERSION "\n", program_name);
304 print_all_lib_versions(stdout, 0);
307 void show_license(void)
311 "This version of %s has nonfree parts compiled in.\n"
312 "Therefore it is not legally redistributable.\n",
317 "%s is free software; you can redistribute it and/or modify\n"
318 "it under the terms of the GNU General Public License as published by\n"
319 "the Free Software Foundation; either version 2 of the License, or\n"
320 "(at your option) any later version.\n"
322 "%s is distributed in the hope that it will be useful,\n"
323 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
324 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
325 "GNU General Public License for more details.\n"
327 "You should have received a copy of the GNU General Public License\n"
328 "along with %s; if not, write to the Free Software\n"
329 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
330 program_name, program_name, program_name
334 "%s is free software; you can redistribute it and/or\n"
335 "modify it under the terms of the GNU Lesser General Public\n"
336 "License as published by the Free Software Foundation; either\n"
337 "version 2.1 of the License, or (at your option) any later version.\n"
339 "%s is distributed in the hope that it will be useful,\n"
340 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
341 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
342 "Lesser General Public License for more details.\n"
344 "You should have received a copy of the GNU Lesser General Public\n"
345 "License along with %s; if not, write to the Free Software\n"
346 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n",
347 program_name, program_name, program_name
352 void show_formats(void)
354 AVInputFormat *ifmt=NULL;
355 AVOutputFormat *ofmt=NULL;
356 URLProtocol *up=NULL;
357 AVCodec *p=NULL, *p2;
358 AVBitStreamFilter *bsf=NULL;
359 const char *last_name;
361 printf("File formats:\n");
366 const char *name=NULL;
367 const char *long_name=NULL;
369 while((ofmt= av_oformat_next(ofmt))) {
370 if((name == NULL || strcmp(ofmt->name, name)<0) &&
371 strcmp(ofmt->name, last_name)>0){
373 long_name= ofmt->long_name;
377 while((ifmt= av_iformat_next(ifmt))) {
378 if((name == NULL || strcmp(ifmt->name, name)<0) &&
379 strcmp(ifmt->name, last_name)>0){
381 long_name= ifmt->long_name;
384 if(name && strcmp(ifmt->name, name)==0)
396 long_name ? long_name:" ");
406 const char *type_str;
409 while((p= av_codec_next(p))) {
410 if((p2==NULL || strcmp(p->name, p2->name)<0) &&
411 strcmp(p->name, last_name)>0){
413 decode= encode= cap=0;
415 if(p2 && strcmp(p->name, p2->name)==0){
416 if(p->decode) decode=1;
417 if(p->encode) encode=1;
418 cap |= p->capabilities;
426 case CODEC_TYPE_VIDEO:
429 case CODEC_TYPE_AUDIO:
432 case CODEC_TYPE_SUBTITLE:
440 " %s%s%s%s%s%s %-15s %s",
441 decode ? "D": (/*p2->decoder ? "d":*/" "),
444 cap & CODEC_CAP_DRAW_HORIZ_BAND ? "S":" ",
445 cap & CODEC_CAP_DR1 ? "D":" ",
446 cap & CODEC_CAP_TRUNCATED ? "T":" ",
448 p2->long_name ? p2->long_name : "");
449 /* if(p2->decoder && decode==0)
450 printf(" use %s for decoding", p2->decoder->name);*/
455 printf("Bitstream filters:\n");
456 while((bsf = av_bitstream_filter_next(bsf)))
457 printf(" %s", bsf->name);
460 printf("Supported file protocols:\n");
461 while((up = av_protocol_next(up)))
462 printf(" %s:", up->name);
465 printf("Frame size, frame rate abbreviations:\n ntsc pal qntsc qpal sntsc spal film ntsc-film sqcif qcif cif 4cif\n");
468 "Note, the names of encoders and decoders do not always match, so there are\n"
469 "several cases where the above table shows encoder only or decoder only entries\n"
470 "even though both encoding and decoding are supported. For example, the h263\n"
471 "decoder corresponds to the h263 and h263p encoders, for file formats it is even\n"
478 int yesno = (toupper(c) == 'Y');
480 while (c != '\n' && c != EOF)