2 * This file is part of FFmpeg.
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21 * misc parsing utilities
31 #include "random_seed.h"
32 #include "parseutils.h"
34 int av_parse_ratio(AVRational *q, const char *str, int max,
35 int log_offset, void *log_ctx)
41 if (sscanf(str, "%d:%d%c", &q->num, &q->den, &c) != 2) {
43 ret = av_expr_parse_and_eval(&d, str, NULL, NULL,
44 NULL, NULL, NULL, NULL,
45 NULL, log_offset, log_ctx);
51 gcd = av_gcd(FFABS(q->num), FFABS(q->den));
70 static const VideoSizeAbbr video_size_abbrs[] = {
73 { "qntsc", 352, 240 }, /* VCD compliant NTSC */
74 { "qpal", 352, 288 }, /* VCD compliant PAL */
75 { "sntsc", 640, 480 }, /* square pixel NTSC */
76 { "spal", 768, 576 }, /* square pixel PAL */
78 { "ntsc-film", 352, 240 },
83 { "16cif", 1408,1152 },
84 { "qqvga", 160, 120 },
89 { "uxga", 1600,1200 },
90 { "qxga", 2048,1536 },
91 { "sxga", 1280,1024 },
92 { "qsxga", 2560,2048 },
93 { "hsxga", 5120,4096 },
95 { "wxga", 1366, 768 },
96 { "wsxga", 1600,1024 },
97 { "wuxga", 1920,1200 },
98 { "woxga", 2560,1600 },
99 { "wqsxga", 3200,2048 },
100 { "wquxga", 3840,2400 },
101 { "whsxga", 6400,4096 },
102 { "whuxga", 7680,4800 },
105 { "hd480", 852, 480 },
106 { "hd720", 1280, 720 },
107 { "hd1080", 1920,1080 },
110 static const VideoRateAbbr video_rate_abbrs[]= {
111 { "ntsc", { 30000, 1001 } },
112 { "pal", { 25, 1 } },
113 { "qntsc", { 30000, 1001 } }, /* VCD compliant NTSC */
114 { "qpal", { 25, 1 } }, /* VCD compliant PAL */
115 { "sntsc", { 30000, 1001 } }, /* square pixel NTSC */
116 { "spal", { 25, 1 } }, /* square pixel PAL */
117 { "film", { 24, 1 } },
118 { "ntsc-film", { 24000, 1001 } },
121 int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str)
124 int n = FF_ARRAY_ELEMS(video_size_abbrs);
126 int width = 0, height = 0;
128 for (i = 0; i < n; i++) {
129 if (!strcmp(video_size_abbrs[i].abbr, str)) {
130 width = video_size_abbrs[i].width;
131 height = video_size_abbrs[i].height;
137 width = strtol(p, (void*)&p, 10);
140 height = strtol(p, (void*)&p, 10);
142 if (width <= 0 || height <= 0)
143 return AVERROR(EINVAL);
145 *height_ptr = height;
149 int av_parse_video_rate(AVRational *rate, const char *arg)
152 int n = FF_ARRAY_ELEMS(video_rate_abbrs);
154 /* First, we check our abbreviation table */
155 for (i = 0; i < n; ++i)
156 if (!strcmp(video_rate_abbrs[i].abbr, arg)) {
157 *rate = video_rate_abbrs[i].rate;
161 /* Then, we try to parse it as fraction */
162 if ((ret = av_parse_ratio_quiet(rate, arg, 1001000)) < 0)
164 if (rate->num <= 0 || rate->den <= 0)
165 return AVERROR(EINVAL);
170 const char *name; ///< a string representing the name of the color
171 uint8_t rgb_color[3]; ///< RGB values for the color
174 static const ColorEntry color_table[] = {
175 { "AliceBlue", { 0xF0, 0xF8, 0xFF } },
176 { "AntiqueWhite", { 0xFA, 0xEB, 0xD7 } },
177 { "Aqua", { 0x00, 0xFF, 0xFF } },
178 { "Aquamarine", { 0x7F, 0xFF, 0xD4 } },
179 { "Azure", { 0xF0, 0xFF, 0xFF } },
180 { "Beige", { 0xF5, 0xF5, 0xDC } },
181 { "Bisque", { 0xFF, 0xE4, 0xC4 } },
182 { "Black", { 0x00, 0x00, 0x00 } },
183 { "BlanchedAlmond", { 0xFF, 0xEB, 0xCD } },
184 { "Blue", { 0x00, 0x00, 0xFF } },
185 { "BlueViolet", { 0x8A, 0x2B, 0xE2 } },
186 { "Brown", { 0xA5, 0x2A, 0x2A } },
187 { "BurlyWood", { 0xDE, 0xB8, 0x87 } },
188 { "CadetBlue", { 0x5F, 0x9E, 0xA0 } },
189 { "Chartreuse", { 0x7F, 0xFF, 0x00 } },
190 { "Chocolate", { 0xD2, 0x69, 0x1E } },
191 { "Coral", { 0xFF, 0x7F, 0x50 } },
192 { "CornflowerBlue", { 0x64, 0x95, 0xED } },
193 { "Cornsilk", { 0xFF, 0xF8, 0xDC } },
194 { "Crimson", { 0xDC, 0x14, 0x3C } },
195 { "Cyan", { 0x00, 0xFF, 0xFF } },
196 { "DarkBlue", { 0x00, 0x00, 0x8B } },
197 { "DarkCyan", { 0x00, 0x8B, 0x8B } },
198 { "DarkGoldenRod", { 0xB8, 0x86, 0x0B } },
199 { "DarkGray", { 0xA9, 0xA9, 0xA9 } },
200 { "DarkGreen", { 0x00, 0x64, 0x00 } },
201 { "DarkKhaki", { 0xBD, 0xB7, 0x6B } },
202 { "DarkMagenta", { 0x8B, 0x00, 0x8B } },
203 { "DarkOliveGreen", { 0x55, 0x6B, 0x2F } },
204 { "Darkorange", { 0xFF, 0x8C, 0x00 } },
205 { "DarkOrchid", { 0x99, 0x32, 0xCC } },
206 { "DarkRed", { 0x8B, 0x00, 0x00 } },
207 { "DarkSalmon", { 0xE9, 0x96, 0x7A } },
208 { "DarkSeaGreen", { 0x8F, 0xBC, 0x8F } },
209 { "DarkSlateBlue", { 0x48, 0x3D, 0x8B } },
210 { "DarkSlateGray", { 0x2F, 0x4F, 0x4F } },
211 { "DarkTurquoise", { 0x00, 0xCE, 0xD1 } },
212 { "DarkViolet", { 0x94, 0x00, 0xD3 } },
213 { "DeepPink", { 0xFF, 0x14, 0x93 } },
214 { "DeepSkyBlue", { 0x00, 0xBF, 0xFF } },
215 { "DimGray", { 0x69, 0x69, 0x69 } },
216 { "DodgerBlue", { 0x1E, 0x90, 0xFF } },
217 { "FireBrick", { 0xB2, 0x22, 0x22 } },
218 { "FloralWhite", { 0xFF, 0xFA, 0xF0 } },
219 { "ForestGreen", { 0x22, 0x8B, 0x22 } },
220 { "Fuchsia", { 0xFF, 0x00, 0xFF } },
221 { "Gainsboro", { 0xDC, 0xDC, 0xDC } },
222 { "GhostWhite", { 0xF8, 0xF8, 0xFF } },
223 { "Gold", { 0xFF, 0xD7, 0x00 } },
224 { "GoldenRod", { 0xDA, 0xA5, 0x20 } },
225 { "Gray", { 0x80, 0x80, 0x80 } },
226 { "Green", { 0x00, 0x80, 0x00 } },
227 { "GreenYellow", { 0xAD, 0xFF, 0x2F } },
228 { "HoneyDew", { 0xF0, 0xFF, 0xF0 } },
229 { "HotPink", { 0xFF, 0x69, 0xB4 } },
230 { "IndianRed", { 0xCD, 0x5C, 0x5C } },
231 { "Indigo", { 0x4B, 0x00, 0x82 } },
232 { "Ivory", { 0xFF, 0xFF, 0xF0 } },
233 { "Khaki", { 0xF0, 0xE6, 0x8C } },
234 { "Lavender", { 0xE6, 0xE6, 0xFA } },
235 { "LavenderBlush", { 0xFF, 0xF0, 0xF5 } },
236 { "LawnGreen", { 0x7C, 0xFC, 0x00 } },
237 { "LemonChiffon", { 0xFF, 0xFA, 0xCD } },
238 { "LightBlue", { 0xAD, 0xD8, 0xE6 } },
239 { "LightCoral", { 0xF0, 0x80, 0x80 } },
240 { "LightCyan", { 0xE0, 0xFF, 0xFF } },
241 { "LightGoldenRodYellow", { 0xFA, 0xFA, 0xD2 } },
242 { "LightGrey", { 0xD3, 0xD3, 0xD3 } },
243 { "LightGreen", { 0x90, 0xEE, 0x90 } },
244 { "LightPink", { 0xFF, 0xB6, 0xC1 } },
245 { "LightSalmon", { 0xFF, 0xA0, 0x7A } },
246 { "LightSeaGreen", { 0x20, 0xB2, 0xAA } },
247 { "LightSkyBlue", { 0x87, 0xCE, 0xFA } },
248 { "LightSlateGray", { 0x77, 0x88, 0x99 } },
249 { "LightSteelBlue", { 0xB0, 0xC4, 0xDE } },
250 { "LightYellow", { 0xFF, 0xFF, 0xE0 } },
251 { "Lime", { 0x00, 0xFF, 0x00 } },
252 { "LimeGreen", { 0x32, 0xCD, 0x32 } },
253 { "Linen", { 0xFA, 0xF0, 0xE6 } },
254 { "Magenta", { 0xFF, 0x00, 0xFF } },
255 { "Maroon", { 0x80, 0x00, 0x00 } },
256 { "MediumAquaMarine", { 0x66, 0xCD, 0xAA } },
257 { "MediumBlue", { 0x00, 0x00, 0xCD } },
258 { "MediumOrchid", { 0xBA, 0x55, 0xD3 } },
259 { "MediumPurple", { 0x93, 0x70, 0xD8 } },
260 { "MediumSeaGreen", { 0x3C, 0xB3, 0x71 } },
261 { "MediumSlateBlue", { 0x7B, 0x68, 0xEE } },
262 { "MediumSpringGreen", { 0x00, 0xFA, 0x9A } },
263 { "MediumTurquoise", { 0x48, 0xD1, 0xCC } },
264 { "MediumVioletRed", { 0xC7, 0x15, 0x85 } },
265 { "MidnightBlue", { 0x19, 0x19, 0x70 } },
266 { "MintCream", { 0xF5, 0xFF, 0xFA } },
267 { "MistyRose", { 0xFF, 0xE4, 0xE1 } },
268 { "Moccasin", { 0xFF, 0xE4, 0xB5 } },
269 { "NavajoWhite", { 0xFF, 0xDE, 0xAD } },
270 { "Navy", { 0x00, 0x00, 0x80 } },
271 { "OldLace", { 0xFD, 0xF5, 0xE6 } },
272 { "Olive", { 0x80, 0x80, 0x00 } },
273 { "OliveDrab", { 0x6B, 0x8E, 0x23 } },
274 { "Orange", { 0xFF, 0xA5, 0x00 } },
275 { "OrangeRed", { 0xFF, 0x45, 0x00 } },
276 { "Orchid", { 0xDA, 0x70, 0xD6 } },
277 { "PaleGoldenRod", { 0xEE, 0xE8, 0xAA } },
278 { "PaleGreen", { 0x98, 0xFB, 0x98 } },
279 { "PaleTurquoise", { 0xAF, 0xEE, 0xEE } },
280 { "PaleVioletRed", { 0xD8, 0x70, 0x93 } },
281 { "PapayaWhip", { 0xFF, 0xEF, 0xD5 } },
282 { "PeachPuff", { 0xFF, 0xDA, 0xB9 } },
283 { "Peru", { 0xCD, 0x85, 0x3F } },
284 { "Pink", { 0xFF, 0xC0, 0xCB } },
285 { "Plum", { 0xDD, 0xA0, 0xDD } },
286 { "PowderBlue", { 0xB0, 0xE0, 0xE6 } },
287 { "Purple", { 0x80, 0x00, 0x80 } },
288 { "Red", { 0xFF, 0x00, 0x00 } },
289 { "RosyBrown", { 0xBC, 0x8F, 0x8F } },
290 { "RoyalBlue", { 0x41, 0x69, 0xE1 } },
291 { "SaddleBrown", { 0x8B, 0x45, 0x13 } },
292 { "Salmon", { 0xFA, 0x80, 0x72 } },
293 { "SandyBrown", { 0xF4, 0xA4, 0x60 } },
294 { "SeaGreen", { 0x2E, 0x8B, 0x57 } },
295 { "SeaShell", { 0xFF, 0xF5, 0xEE } },
296 { "Sienna", { 0xA0, 0x52, 0x2D } },
297 { "Silver", { 0xC0, 0xC0, 0xC0 } },
298 { "SkyBlue", { 0x87, 0xCE, 0xEB } },
299 { "SlateBlue", { 0x6A, 0x5A, 0xCD } },
300 { "SlateGray", { 0x70, 0x80, 0x90 } },
301 { "Snow", { 0xFF, 0xFA, 0xFA } },
302 { "SpringGreen", { 0x00, 0xFF, 0x7F } },
303 { "SteelBlue", { 0x46, 0x82, 0xB4 } },
304 { "Tan", { 0xD2, 0xB4, 0x8C } },
305 { "Teal", { 0x00, 0x80, 0x80 } },
306 { "Thistle", { 0xD8, 0xBF, 0xD8 } },
307 { "Tomato", { 0xFF, 0x63, 0x47 } },
308 { "Turquoise", { 0x40, 0xE0, 0xD0 } },
309 { "Violet", { 0xEE, 0x82, 0xEE } },
310 { "Wheat", { 0xF5, 0xDE, 0xB3 } },
311 { "White", { 0xFF, 0xFF, 0xFF } },
312 { "WhiteSmoke", { 0xF5, 0xF5, 0xF5 } },
313 { "Yellow", { 0xFF, 0xFF, 0x00 } },
314 { "YellowGreen", { 0x9A, 0xCD, 0x32 } },
317 static int color_table_compare(const void *lhs, const void *rhs)
319 return av_strcasecmp(lhs, ((const ColorEntry *)rhs)->name);
322 #define ALPHA_SEP '@'
324 int av_parse_color(uint8_t *rgba_color, const char *color_string, int slen,
327 char *tail, color_string2[128];
328 const ColorEntry *entry;
329 int len, hex_offset = 0;
331 if (color_string[0] == '#') {
333 } else if (!strncmp(color_string, "0x", 2))
337 slen = strlen(color_string);
338 av_strlcpy(color_string2, color_string + hex_offset,
339 FFMIN(slen-hex_offset+1, sizeof(color_string2)));
340 if ((tail = strchr(color_string2, ALPHA_SEP)))
342 len = strlen(color_string2);
345 if (!av_strcasecmp(color_string2, "random") || !av_strcasecmp(color_string2, "bikeshed")) {
346 int rgba = av_get_random_seed();
347 rgba_color[0] = rgba >> 24;
348 rgba_color[1] = rgba >> 16;
349 rgba_color[2] = rgba >> 8;
350 rgba_color[3] = rgba;
351 } else if (hex_offset ||
352 strspn(color_string2, "0123456789ABCDEFabcdef") == len) {
354 unsigned int rgba = strtoul(color_string2, &tail, 16);
356 if (*tail || (len != 6 && len != 8)) {
357 av_log(log_ctx, AV_LOG_ERROR, "Invalid 0xRRGGBB[AA] color string: '%s'\n", color_string2);
358 return AVERROR(EINVAL);
361 rgba_color[3] = rgba;
364 rgba_color[0] = rgba >> 16;
365 rgba_color[1] = rgba >> 8;
366 rgba_color[2] = rgba;
368 entry = bsearch(color_string2,
370 FF_ARRAY_ELEMS(color_table),
372 color_table_compare);
374 av_log(log_ctx, AV_LOG_ERROR, "Cannot find color '%s'\n", color_string2);
375 return AVERROR(EINVAL);
377 memcpy(rgba_color, entry->rgb_color, 3);
381 unsigned long int alpha;
382 const char *alpha_string = tail;
383 if (!strncmp(alpha_string, "0x", 2)) {
384 alpha = strtoul(alpha_string, &tail, 16);
386 alpha = 255 * strtod(alpha_string, &tail);
389 if (tail == alpha_string || *tail || alpha > 255) {
390 av_log(log_ctx, AV_LOG_ERROR, "Invalid alpha value specifier '%s' in '%s'\n",
391 alpha_string, color_string);
392 return AVERROR(EINVAL);
394 rgba_color[3] = alpha;
400 /* get a positive number between n_min and n_max, for a maximum length
401 of len_max. Return -1 if error. */
402 static int date_get_num(const char **pp,
403 int n_min, int n_max, int len_max)
410 for(i = 0; i < len_max; i++) {
414 val = (val * 10) + c - '0';
417 /* no number read ? */
420 if (val < n_min || val > n_max)
427 * Parse the input string p according to the format string fmt and
428 * store its results in the structure dt.
429 * This implementation supports only a subset of the formats supported
430 * by the standard strptime().
432 * @return a pointer to the first character not processed in this
433 * function call, or NULL in case the function fails to match all of
434 * the fmt string and therefore an error occurred
436 static const char *small_strptime(const char *p, const char *fmt, struct tm *dt)
444 } else if (c == '%') {
448 val = date_get_num(&p, 0, 23, 2);
454 val = date_get_num(&p, 0, 59, 2);
460 val = date_get_num(&p, 0, 59, 2);
466 val = date_get_num(&p, 0, 9999, 4);
469 dt->tm_year = val - 1900;
472 val = date_get_num(&p, 1, 12, 2);
475 dt->tm_mon = val - 1;
478 val = date_get_num(&p, 1, 31, 2);
497 time_t av_timegm(struct tm *tm)
501 int y = tm->tm_year + 1900, m = tm->tm_mon + 1, d = tm->tm_mday;
509 (d + (153 * m - 457) / 5 + 365 * y + y / 4 - y / 100 + y / 400 - 719469);
511 t += 3600 * tm->tm_hour + 60 * tm->tm_min + tm->tm_sec;
516 int av_parse_time(int64_t *timeval, const char *timestr, int duration)
520 struct tm dt = { 0 };
522 static const char * const date_fmt[] = {
526 static const char * const time_fmt[] = {
536 time_t now = time(0);
538 len = strlen(timestr);
540 lastch = timestr[len - 1];
543 is_utc = (lastch == 'z' || lastch == 'Z');
548 if (!av_strncasecmp(timestr, "now", len)) {
549 *timeval = (int64_t) now * 1000000;
553 /* parse the year-month-day part */
554 for (i = 0; i < FF_ARRAY_ELEMS(date_fmt); i++) {
555 q = small_strptime(p, date_fmt[i], &dt);
561 /* if the year-month-day part is missing, then take the
562 * current year-month-day time */
567 dt = *localtime(&now);
569 dt.tm_hour = dt.tm_min = dt.tm_sec = 0;
574 if (*p == 'T' || *p == 't' || *p == ' ')
577 /* parse the hour-minute-second part */
578 for (i = 0; i < FF_ARRAY_ELEMS(time_fmt); i++) {
579 q = small_strptime(p, time_fmt[i], &dt);
585 /* parse timestr as a duration */
590 /* parse timestr as HH:MM:SS */
591 q = small_strptime(p, time_fmt[0], &dt);
593 /* parse timestr as S+ */
594 dt.tm_sec = strtol(p, (void *)&q, 10);
596 /* the parsing didn't succeed */
597 *timeval = INT64_MIN;
598 return AVERROR(EINVAL);
605 /* Now we have all the fields that we can get */
607 *timeval = INT64_MIN;
608 return AVERROR(EINVAL);
612 t = dt.tm_hour * 3600 + dt.tm_min * 60 + dt.tm_sec;
614 dt.tm_isdst = -1; /* unknown */
624 /* parse the .m... part */
628 for (val = 0, n = 100000; n >= 1; n /= 10, q++) {
631 val += n * (*q - '0');
635 *timeval = negative ? -t : t;
639 int av_find_info_tag(char *arg, int arg_size, const char *tag1, const char *info)
649 while (*p != '\0' && *p != '=' && *p != '&') {
650 if ((q - tag) < sizeof(tag) - 1)
658 while (*p != '&' && *p != '\0') {
659 if ((q - arg) < arg_size - 1) {
669 if (!strcmp(tag, tag1))
684 printf("Testing av_parse_video_rate()\n");
687 const char *rates[] = {
715 for (i = 0; i < FF_ARRAY_ELEMS(rates); i++) {
717 AVRational q = (AVRational){0, 0};
718 ret = av_parse_video_rate(&q, rates[i]),
719 printf("'%s' -> %d/%d ret:%d\n",
720 rates[i], q.num, q.den, ret);
724 printf("\nTesting av_parse_color()\n");
728 const char *color_names[] = {
767 av_log_set_level(AV_LOG_DEBUG);
769 for (i = 0; i < FF_ARRAY_ELEMS(color_names); i++) {
770 if (av_parse_color(rgba, color_names[i], -1, NULL) >= 0)
771 printf("%s -> R(%d) G(%d) B(%d) A(%d)\n", color_names[i], rgba[0], rgba[1], rgba[2], rgba[3]);