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
39 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
43 double d = strtod(numstr, &tail);
45 error= "Expected number for %s but found: %s\n";
46 else if (d < min || d > max)
47 error= "The value for %s was %s which is not within %f - %f\n";
48 else if(type == OPT_INT64 && (int64_t)d != d)
49 error= "Expected int64 for %s but found %s\n";
52 fprintf(stderr, error, context, numstr, min, max);
56 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
58 int64_t us = parse_date(timestr, is_duration);
59 if (us == INT64_MIN) {
60 fprintf(stderr, "Invalid %s specification for %s: %s\n",
61 is_duration ? "duration" : "date", context, timestr);
67 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
73 for(po = options; po->name != NULL; po++) {
75 if ((po->flags & mask) == value) {
80 av_strlcpy(buf, po->name, sizeof(buf));
81 if (po->flags & HAS_ARG) {
82 av_strlcat(buf, " ", sizeof(buf));
83 av_strlcat(buf, po->argname, sizeof(buf));
85 printf("-%-17s %s\n", buf, po->help);
90 static const OptionDef* find_option(const OptionDef *po, const char *name){
91 while (po->name != NULL) {
92 if (!strcmp(name, po->name))
99 void parse_options(int argc, char **argv, const OptionDef *options,
100 void (* parse_arg_function)(const char*))
102 const char *opt, *arg;
103 int optindex, handleoptions=1;
108 while (optindex < argc) {
109 opt = argv[optindex++];
111 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
112 if (opt[1] == '-' && opt[2] == '\0') {
116 po= find_option(options, opt + 1);
118 po= find_option(options, "default");
121 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
125 if (po->flags & HAS_ARG) {
126 arg = argv[optindex++];
128 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
132 if (po->flags & OPT_STRING) {
134 str = av_strdup(arg);
135 *po->u.str_arg = str;
136 } else if (po->flags & OPT_BOOL) {
138 } else if (po->flags & OPT_INT) {
139 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
140 } else if (po->flags & OPT_INT64) {
141 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
142 } else if (po->flags & OPT_FLOAT) {
143 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
144 } else if (po->flags & OPT_FUNC2) {
145 if(po->u.func2_arg(opt+1, arg)<0)
151 if (parse_arg_function)
152 parse_arg_function(opt);
157 void print_error(const char *filename, int err)
160 case AVERROR_NUMEXPECTED:
161 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
162 "Use '%%d' to specify the image number:\n"
163 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
164 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
167 case AVERROR_INVALIDDATA:
168 fprintf(stderr, "%s: Error while parsing header\n", filename);
171 fprintf(stderr, "%s: Unknown format\n", filename);
174 fprintf(stderr, "%s: I/O error occurred\n"
175 "Usually that means that input file is truncated and/or corrupted.\n",
178 case AVERROR(ENOMEM):
179 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
181 case AVERROR(ENOENT):
182 fprintf(stderr, "%s: no such file or directory\n", filename);
184 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
185 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
188 fprintf(stderr, "%s: Error while opening file\n", filename);
193 void show_banner(const char *program_name, int program_birth_year)
195 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
196 program_name, program_birth_year);
197 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
198 fprintf(stderr, " libavutil version: " AV_STRINGIFY(LIBAVUTIL_VERSION) "\n");
199 fprintf(stderr, " libavcodec version: " AV_STRINGIFY(LIBAVCODEC_VERSION) "\n");
200 fprintf(stderr, " libavformat version: " AV_STRINGIFY(LIBAVFORMAT_VERSION) "\n");
201 fprintf(stderr, " libavdevice version: " AV_STRINGIFY(LIBAVDEVICE_VERSION) "\n");
203 fprintf(stderr, " libavfilter version: " AV_STRINGIFY(LIBAVFILTER_VERSION) "\n");
205 fprintf(stderr, " built on " __DATE__ " " __TIME__);
207 fprintf(stderr, ", gcc: " __VERSION__ "\n");
209 fprintf(stderr, ", using a non-gcc compiler\n");
213 void show_version(const char *program_name) {
214 /* TODO: add function interface to avutil and avformat avdevice*/
215 printf("%s " FFMPEG_VERSION "\n", program_name);
216 printf("libavutil %d\n"
220 LIBAVUTIL_BUILD, avcodec_build(), LIBAVFORMAT_BUILD, LIBAVDEVICE_BUILD);
223 void show_license(void)
225 #ifdef CONFIG_NONFREE
227 "This version of FFmpeg has nonfree parts compiled in.\n"
228 "Therefore it is not legally redistributable.\n"
232 "FFmpeg is free software; you can redistribute it and/or modify\n"
233 "it under the terms of the GNU General Public License as published by\n"
234 "the Free Software Foundation; either version 2 of the License, or\n"
235 "(at your option) any later version.\n"
237 "FFmpeg is distributed in the hope that it will be useful,\n"
238 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
239 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
240 "GNU General Public License for more details.\n"
242 "You should have received a copy of the GNU General Public License\n"
243 "along with FFmpeg; if not, write to the Free Software\n"
244 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"
248 "FFmpeg is free software; you can redistribute it and/or\n"
249 "modify it under the terms of the GNU Lesser General Public\n"
250 "License as published by the Free Software Foundation; either\n"
251 "version 2.1 of the License, or (at your option) any later version.\n"
253 "FFmpeg is distributed in the hope that it will be useful,\n"
254 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
255 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
256 "Lesser General Public License for more details.\n"
258 "You should have received a copy of the GNU Lesser General Public\n"
259 "License along with FFmpeg; if not, write to the Free Software\n"
260 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"