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
38 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
42 double d = strtod(numstr, &tail);
44 error= "Expected number for %s but found: %s\n";
45 else if (d < min || d > max)
46 error= "The value for %s was %s which is not within %f - %f\n";
47 else if(type == OPT_INT64 && (int64_t)d != d)
48 error= "Expected int64 for %s but found %s\n";
51 fprintf(stderr, error, context, numstr, min, max);
55 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
57 int64_t us = parse_date(timestr, is_duration);
58 if (us == INT64_MIN) {
59 fprintf(stderr, "Invalid %s specification for %s: %s\n",
60 is_duration ? "duration" : "date", context, timestr);
66 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
72 for(po = options; po->name != NULL; po++) {
74 if ((po->flags & mask) == value) {
79 av_strlcpy(buf, po->name, sizeof(buf));
80 if (po->flags & HAS_ARG) {
81 av_strlcat(buf, " ", sizeof(buf));
82 av_strlcat(buf, po->argname, sizeof(buf));
84 printf("-%-17s %s\n", buf, po->help);
89 static const OptionDef* find_option(const OptionDef *po, const char *name){
90 while (po->name != NULL) {
91 if (!strcmp(name, po->name))
98 void parse_options(int argc, char **argv, const OptionDef *options,
99 void (* parse_arg_function)(const char*))
101 const char *opt, *arg;
102 int optindex, handleoptions=1;
107 while (optindex < argc) {
108 opt = argv[optindex++];
110 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
111 if (opt[1] == '-' && opt[2] == '\0') {
115 po= find_option(options, opt + 1);
117 po= find_option(options, "default");
120 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
124 if (po->flags & HAS_ARG) {
125 arg = argv[optindex++];
127 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
131 if (po->flags & OPT_STRING) {
133 str = av_strdup(arg);
134 *po->u.str_arg = str;
135 } else if (po->flags & OPT_BOOL) {
137 } else if (po->flags & OPT_INT) {
138 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
139 } else if (po->flags & OPT_INT64) {
140 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
141 } else if (po->flags & OPT_FLOAT) {
142 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
143 } else if (po->flags & OPT_FUNC2) {
144 if(po->u.func2_arg(opt+1, arg)<0)
150 if (parse_arg_function)
151 parse_arg_function(opt);
156 void print_error(const char *filename, int err)
159 case AVERROR_NUMEXPECTED:
160 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
161 "Use '%%d' to specify the image number:\n"
162 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
163 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
166 case AVERROR_INVALIDDATA:
167 fprintf(stderr, "%s: Error while parsing header\n", filename);
170 fprintf(stderr, "%s: Unknown format\n", filename);
173 fprintf(stderr, "%s: I/O error occurred\n"
174 "Usually that means that input file is truncated and/or corrupted.\n",
177 case AVERROR(ENOMEM):
178 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
180 case AVERROR(ENOENT):
181 fprintf(stderr, "%s: no such file or directory\n", filename);
184 fprintf(stderr, "%s: Error while opening file\n", filename);
189 void show_banner(const char *program_name, int program_birth_year)
191 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
192 program_name, program_birth_year);
193 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
194 fprintf(stderr, " libavutil version: " AV_STRINGIFY(LIBAVUTIL_VERSION) "\n");
195 fprintf(stderr, " libavcodec version: " AV_STRINGIFY(LIBAVCODEC_VERSION) "\n");
196 fprintf(stderr, " libavformat version: " AV_STRINGIFY(LIBAVFORMAT_VERSION) "\n");
197 fprintf(stderr, " libavdevice version: " AV_STRINGIFY(LIBAVDEVICE_VERSION) "\n");
199 fprintf(stderr, " libavfilter version: " AV_STRINGIFY(LIBAVFILTER_VERSION) "\n");
201 fprintf(stderr, " built on " __DATE__ " " __TIME__);
203 fprintf(stderr, ", gcc: " __VERSION__ "\n");
205 fprintf(stderr, ", using a non-gcc compiler\n");
209 void show_version(const char *program_name) {
210 /* TODO: add function interface to avutil and avformat avdevice*/
211 printf("%s " FFMPEG_VERSION "\n", program_name);
212 printf("libavutil %d\n"
216 LIBAVUTIL_BUILD, avcodec_build(), LIBAVFORMAT_BUILD, LIBAVDEVICE_BUILD);
219 void show_license(void)
221 #ifdef CONFIG_NONFREE
223 "This version of FFmpeg has nonfree parts compiled in.\n"
224 "Therefore it is not legally redistributable.\n"
228 "FFmpeg is free software; you can redistribute it and/or modify\n"
229 "it under the terms of the GNU General Public License as published by\n"
230 "the Free Software Foundation; either version 2 of the License, or\n"
231 "(at your option) any later version.\n"
233 "FFmpeg is distributed in the hope that it will be useful,\n"
234 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
235 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
236 "GNU General Public License for more details.\n"
238 "You should have received a copy of the GNU General Public License\n"
239 "along with FFmpeg; if not, write to the Free Software\n"
240 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"
244 "FFmpeg is free software; you can redistribute it and/or\n"
245 "modify it under the terms of the GNU Lesser General Public\n"
246 "License as published by the Free Software Foundation; either\n"
247 "version 2.1 of the License, or (at your option) any later version.\n"
249 "FFmpeg is distributed in the hope that it will be useful,\n"
250 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
251 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
252 "Lesser General Public License for more details.\n"
254 "You should have received a copy of the GNU Lesser General Public\n"
255 "License along with FFmpeg; if not, write to the Free Software\n"
256 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"