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
28 #include "libavformat/avformat.h"
29 #include "libavfilter/avfilter.h"
30 #include "libavdevice/avdevice.h"
31 #include "libavutil/avstring.h"
35 #include "libavformat/network.h"
41 double parse_number_or_die(const char *context, const char *numstr, int type, double min, double max)
45 double d = strtod(numstr, &tail);
47 error= "Expected number for %s but found: %s\n";
48 else if (d < min || d > max)
49 error= "The value for %s was %s which is not within %f - %f\n";
50 else if(type == OPT_INT64 && (int64_t)d != d)
51 error= "Expected int64 for %s but found %s\n";
54 fprintf(stderr, error, context, numstr, min, max);
58 int64_t parse_time_or_die(const char *context, const char *timestr, int is_duration)
60 int64_t us = parse_date(timestr, is_duration);
61 if (us == INT64_MIN) {
62 fprintf(stderr, "Invalid %s specification for %s: %s\n",
63 is_duration ? "duration" : "date", context, timestr);
69 void show_help_options(const OptionDef *options, const char *msg, int mask, int value)
75 for(po = options; po->name != NULL; po++) {
77 if ((po->flags & mask) == value) {
82 av_strlcpy(buf, po->name, sizeof(buf));
83 if (po->flags & HAS_ARG) {
84 av_strlcat(buf, " ", sizeof(buf));
85 av_strlcat(buf, po->argname, sizeof(buf));
87 printf("-%-17s %s\n", buf, po->help);
92 static const OptionDef* find_option(const OptionDef *po, const char *name){
93 while (po->name != NULL) {
94 if (!strcmp(name, po->name))
101 void parse_options(int argc, char **argv, const OptionDef *options,
102 void (* parse_arg_function)(const char*))
104 const char *opt, *arg;
105 int optindex, handleoptions=1;
110 while (optindex < argc) {
111 opt = argv[optindex++];
113 if (handleoptions && opt[0] == '-' && opt[1] != '\0') {
114 if (opt[1] == '-' && opt[2] == '\0') {
118 po= find_option(options, opt + 1);
120 po= find_option(options, "default");
123 fprintf(stderr, "%s: unrecognized option '%s'\n", argv[0], opt);
127 if (po->flags & HAS_ARG) {
128 arg = argv[optindex++];
130 fprintf(stderr, "%s: missing argument for option '%s'\n", argv[0], opt);
134 if (po->flags & OPT_STRING) {
136 str = av_strdup(arg);
137 *po->u.str_arg = str;
138 } else if (po->flags & OPT_BOOL) {
140 } else if (po->flags & OPT_INT) {
141 *po->u.int_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT_MIN, INT_MAX);
142 } else if (po->flags & OPT_INT64) {
143 *po->u.int64_arg = parse_number_or_die(opt+1, arg, OPT_INT64, INT64_MIN, INT64_MAX);
144 } else if (po->flags & OPT_FLOAT) {
145 *po->u.float_arg = parse_number_or_die(opt+1, arg, OPT_FLOAT, -1.0/0.0, 1.0/0.0);
146 } else if (po->flags & OPT_FUNC2) {
147 if(po->u.func2_arg(opt+1, arg)<0)
152 if(po->flags & OPT_EXIT)
155 if (parse_arg_function)
156 parse_arg_function(opt);
161 void print_error(const char *filename, int err)
164 case AVERROR_NUMEXPECTED:
165 fprintf(stderr, "%s: Incorrect image filename syntax.\n"
166 "Use '%%d' to specify the image number:\n"
167 " for img1.jpg, img2.jpg, ..., use 'img%%d.jpg';\n"
168 " for img001.jpg, img002.jpg, ..., use 'img%%03d.jpg'.\n",
171 case AVERROR_INVALIDDATA:
172 fprintf(stderr, "%s: Error while parsing header\n", filename);
175 fprintf(stderr, "%s: Unknown format\n", filename);
178 fprintf(stderr, "%s: I/O error occurred\n"
179 "Usually that means that input file is truncated and/or corrupted.\n",
182 case AVERROR(ENOMEM):
183 fprintf(stderr, "%s: memory allocation error occurred\n", filename);
185 case AVERROR(ENOENT):
186 fprintf(stderr, "%s: no such file or directory\n", filename);
188 #ifdef CONFIG_NETWORK
189 case AVERROR(FF_NETERROR(EPROTONOSUPPORT)):
190 fprintf(stderr, "%s: Unsupported network protocol\n", filename);
194 fprintf(stderr, "%s: Error while opening file\n", filename);
199 void show_banner(const char *program_name, int program_birth_year)
201 fprintf(stderr, "%s version " FFMPEG_VERSION ", Copyright (c) %d-2008 Fabrice Bellard, et al.\n",
202 program_name, program_birth_year);
203 fprintf(stderr, " configuration: " FFMPEG_CONFIGURATION "\n");
204 fprintf(stderr, " libavutil version: " AV_STRINGIFY(LIBAVUTIL_VERSION) "\n");
205 fprintf(stderr, " libavcodec version: " AV_STRINGIFY(LIBAVCODEC_VERSION) "\n");
206 fprintf(stderr, " libavformat version: " AV_STRINGIFY(LIBAVFORMAT_VERSION) "\n");
207 fprintf(stderr, " libavdevice version: " AV_STRINGIFY(LIBAVDEVICE_VERSION) "\n");
209 fprintf(stderr, " libavfilter version: " AV_STRINGIFY(LIBAVFILTER_VERSION) "\n");
211 fprintf(stderr, " built on " __DATE__ " " __TIME__);
213 fprintf(stderr, ", gcc: " __VERSION__ "\n");
215 fprintf(stderr, ", using a non-gcc compiler\n");
219 void show_version(const char *program_name) {
220 /* TODO: add function interface to avutil and avformat avdevice*/
221 printf("%s " FFMPEG_VERSION "\n", program_name);
222 printf("libavutil %d\n"
226 LIBAVUTIL_BUILD, avcodec_build(), LIBAVFORMAT_BUILD, LIBAVDEVICE_BUILD);
229 void show_license(void)
231 #ifdef CONFIG_NONFREE
233 "This version of FFmpeg has nonfree parts compiled in.\n"
234 "Therefore it is not legally redistributable.\n"
238 "FFmpeg is free software; you can redistribute it and/or modify\n"
239 "it under the terms of the GNU General Public License as published by\n"
240 "the Free Software Foundation; either version 2 of the License, or\n"
241 "(at your option) any later version.\n"
243 "FFmpeg is distributed in the hope that it will be useful,\n"
244 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
245 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n"
246 "GNU General Public License for more details.\n"
248 "You should have received a copy of the GNU General Public License\n"
249 "along with FFmpeg; if not, write to the Free Software\n"
250 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"
254 "FFmpeg is free software; you can redistribute it and/or\n"
255 "modify it under the terms of the GNU Lesser General Public\n"
256 "License as published by the Free Software Foundation; either\n"
257 "version 2.1 of the License, or (at your option) any later version.\n"
259 "FFmpeg is distributed in the hope that it will be useful,\n"
260 "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
261 "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n"
262 "Lesser General Public License for more details.\n"
264 "You should have received a copy of the GNU Lesser General Public\n"
265 "License along with FFmpeg; if not, write to the Free Software\n"
266 "Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA\n"