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 "time_internal.h"
33 #include "parseutils.h"
38 #define av_get_random_seed av_get_random_seed_deterministic
39 static uint32_t av_get_random_seed_deterministic(void);
41 #define av_gettime() 1331972053200000
45 int av_parse_ratio(AVRational *q, const char *str, int max,
46 int log_offset, void *log_ctx)
51 if (sscanf(str, "%d:%d%c", &q->num, &q->den, &c) != 2) {
53 ret = av_expr_parse_and_eval(&d, str, NULL, NULL,
54 NULL, NULL, NULL, NULL,
55 NULL, log_offset, log_ctx);
60 av_reduce(&q->num, &q->den, q->num, q->den, max);
66 typedef struct VideoSizeAbbr {
71 typedef struct VideoRateAbbr {
76 static const VideoSizeAbbr video_size_abbrs[] = {
79 { "qntsc", 352, 240 }, /* VCD compliant NTSC */
80 { "qpal", 352, 288 }, /* VCD compliant PAL */
81 { "sntsc", 640, 480 }, /* square pixel NTSC */
82 { "spal", 768, 576 }, /* square pixel PAL */
84 { "ntsc-film", 352, 240 },
89 { "16cif", 1408,1152 },
90 { "qqvga", 160, 120 },
95 { "uxga", 1600,1200 },
96 { "qxga", 2048,1536 },
97 { "sxga", 1280,1024 },
98 { "qsxga", 2560,2048 },
99 { "hsxga", 5120,4096 },
100 { "wvga", 852, 480 },
101 { "wxga", 1366, 768 },
102 { "wsxga", 1600,1024 },
103 { "wuxga", 1920,1200 },
104 { "woxga", 2560,1600 },
105 { "wqsxga", 3200,2048 },
106 { "wquxga", 3840,2400 },
107 { "whsxga", 6400,4096 },
108 { "whuxga", 7680,4800 },
111 { "hd480", 852, 480 },
112 { "hd720", 1280, 720 },
113 { "hd1080", 1920,1080 },
114 { "2k", 2048,1080 }, /* Digital Cinema System Specification */
115 { "2kdci", 2048,1080 },
116 { "2kflat", 1998,1080 },
117 { "2kscope", 2048, 858 },
118 { "4k", 4096,2160 }, /* Digital Cinema System Specification */
119 { "4kdci", 4096,2160 },
120 { "4kflat", 3996,2160 },
121 { "4kscope", 4096,1716 },
123 { "hqvga", 240,160 },
124 { "wqvga", 400,240 },
125 { "fwqvga", 432,240 },
128 { "uhd2160", 3840,2160 },
129 { "uhd4320", 7680,4320 },
132 static const VideoRateAbbr video_rate_abbrs[]= {
133 { "ntsc", { 30000, 1001 } },
134 { "pal", { 25, 1 } },
135 { "qntsc", { 30000, 1001 } }, /* VCD compliant NTSC */
136 { "qpal", { 25, 1 } }, /* VCD compliant PAL */
137 { "sntsc", { 30000, 1001 } }, /* square pixel NTSC */
138 { "spal", { 25, 1 } }, /* square pixel PAL */
139 { "film", { 24, 1 } },
140 { "ntsc-film", { 24000, 1001 } },
143 static const char *months[12] = {
144 "january", "february", "march", "april", "may", "june", "july", "august",
145 "september", "october", "november", "december"
148 int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str)
151 int n = FF_ARRAY_ELEMS(video_size_abbrs);
153 int width = 0, height = 0;
155 for (i = 0; i < n; i++) {
156 if (!strcmp(video_size_abbrs[i].abbr, str)) {
157 width = video_size_abbrs[i].width;
158 height = video_size_abbrs[i].height;
163 width = strtol(str, (void*)&p, 10);
166 height = strtol(p, (void*)&p, 10);
168 /* trailing extraneous data detected, like in 123x345foobar */
170 return AVERROR(EINVAL);
172 if (width <= 0 || height <= 0)
173 return AVERROR(EINVAL);
175 *height_ptr = height;
179 int av_parse_video_rate(AVRational *rate, const char *arg)
182 int n = FF_ARRAY_ELEMS(video_rate_abbrs);
184 /* First, we check our abbreviation table */
185 for (i = 0; i < n; ++i)
186 if (!strcmp(video_rate_abbrs[i].abbr, arg)) {
187 *rate = video_rate_abbrs[i].rate;
191 /* Then, we try to parse it as fraction */
192 if ((ret = av_parse_ratio_quiet(rate, arg, 1001000)) < 0)
194 if (rate->num <= 0 || rate->den <= 0)
195 return AVERROR(EINVAL);
199 typedef struct ColorEntry {
200 const char *name; ///< a string representing the name of the color
201 uint8_t rgb_color[3]; ///< RGB values for the color
204 static const ColorEntry color_table[] = {
205 { "AliceBlue", { 0xF0, 0xF8, 0xFF } },
206 { "AntiqueWhite", { 0xFA, 0xEB, 0xD7 } },
207 { "Aqua", { 0x00, 0xFF, 0xFF } },
208 { "Aquamarine", { 0x7F, 0xFF, 0xD4 } },
209 { "Azure", { 0xF0, 0xFF, 0xFF } },
210 { "Beige", { 0xF5, 0xF5, 0xDC } },
211 { "Bisque", { 0xFF, 0xE4, 0xC4 } },
212 { "Black", { 0x00, 0x00, 0x00 } },
213 { "BlanchedAlmond", { 0xFF, 0xEB, 0xCD } },
214 { "Blue", { 0x00, 0x00, 0xFF } },
215 { "BlueViolet", { 0x8A, 0x2B, 0xE2 } },
216 { "Brown", { 0xA5, 0x2A, 0x2A } },
217 { "BurlyWood", { 0xDE, 0xB8, 0x87 } },
218 { "CadetBlue", { 0x5F, 0x9E, 0xA0 } },
219 { "Chartreuse", { 0x7F, 0xFF, 0x00 } },
220 { "Chocolate", { 0xD2, 0x69, 0x1E } },
221 { "Coral", { 0xFF, 0x7F, 0x50 } },
222 { "CornflowerBlue", { 0x64, 0x95, 0xED } },
223 { "Cornsilk", { 0xFF, 0xF8, 0xDC } },
224 { "Crimson", { 0xDC, 0x14, 0x3C } },
225 { "Cyan", { 0x00, 0xFF, 0xFF } },
226 { "DarkBlue", { 0x00, 0x00, 0x8B } },
227 { "DarkCyan", { 0x00, 0x8B, 0x8B } },
228 { "DarkGoldenRod", { 0xB8, 0x86, 0x0B } },
229 { "DarkGray", { 0xA9, 0xA9, 0xA9 } },
230 { "DarkGreen", { 0x00, 0x64, 0x00 } },
231 { "DarkKhaki", { 0xBD, 0xB7, 0x6B } },
232 { "DarkMagenta", { 0x8B, 0x00, 0x8B } },
233 { "DarkOliveGreen", { 0x55, 0x6B, 0x2F } },
234 { "Darkorange", { 0xFF, 0x8C, 0x00 } },
235 { "DarkOrchid", { 0x99, 0x32, 0xCC } },
236 { "DarkRed", { 0x8B, 0x00, 0x00 } },
237 { "DarkSalmon", { 0xE9, 0x96, 0x7A } },
238 { "DarkSeaGreen", { 0x8F, 0xBC, 0x8F } },
239 { "DarkSlateBlue", { 0x48, 0x3D, 0x8B } },
240 { "DarkSlateGray", { 0x2F, 0x4F, 0x4F } },
241 { "DarkTurquoise", { 0x00, 0xCE, 0xD1 } },
242 { "DarkViolet", { 0x94, 0x00, 0xD3 } },
243 { "DeepPink", { 0xFF, 0x14, 0x93 } },
244 { "DeepSkyBlue", { 0x00, 0xBF, 0xFF } },
245 { "DimGray", { 0x69, 0x69, 0x69 } },
246 { "DodgerBlue", { 0x1E, 0x90, 0xFF } },
247 { "FireBrick", { 0xB2, 0x22, 0x22 } },
248 { "FloralWhite", { 0xFF, 0xFA, 0xF0 } },
249 { "ForestGreen", { 0x22, 0x8B, 0x22 } },
250 { "Fuchsia", { 0xFF, 0x00, 0xFF } },
251 { "Gainsboro", { 0xDC, 0xDC, 0xDC } },
252 { "GhostWhite", { 0xF8, 0xF8, 0xFF } },
253 { "Gold", { 0xFF, 0xD7, 0x00 } },
254 { "GoldenRod", { 0xDA, 0xA5, 0x20 } },
255 { "Gray", { 0x80, 0x80, 0x80 } },
256 { "Green", { 0x00, 0x80, 0x00 } },
257 { "GreenYellow", { 0xAD, 0xFF, 0x2F } },
258 { "HoneyDew", { 0xF0, 0xFF, 0xF0 } },
259 { "HotPink", { 0xFF, 0x69, 0xB4 } },
260 { "IndianRed", { 0xCD, 0x5C, 0x5C } },
261 { "Indigo", { 0x4B, 0x00, 0x82 } },
262 { "Ivory", { 0xFF, 0xFF, 0xF0 } },
263 { "Khaki", { 0xF0, 0xE6, 0x8C } },
264 { "Lavender", { 0xE6, 0xE6, 0xFA } },
265 { "LavenderBlush", { 0xFF, 0xF0, 0xF5 } },
266 { "LawnGreen", { 0x7C, 0xFC, 0x00 } },
267 { "LemonChiffon", { 0xFF, 0xFA, 0xCD } },
268 { "LightBlue", { 0xAD, 0xD8, 0xE6 } },
269 { "LightCoral", { 0xF0, 0x80, 0x80 } },
270 { "LightCyan", { 0xE0, 0xFF, 0xFF } },
271 { "LightGoldenRodYellow", { 0xFA, 0xFA, 0xD2 } },
272 { "LightGreen", { 0x90, 0xEE, 0x90 } },
273 { "LightGrey", { 0xD3, 0xD3, 0xD3 } },
274 { "LightPink", { 0xFF, 0xB6, 0xC1 } },
275 { "LightSalmon", { 0xFF, 0xA0, 0x7A } },
276 { "LightSeaGreen", { 0x20, 0xB2, 0xAA } },
277 { "LightSkyBlue", { 0x87, 0xCE, 0xFA } },
278 { "LightSlateGray", { 0x77, 0x88, 0x99 } },
279 { "LightSteelBlue", { 0xB0, 0xC4, 0xDE } },
280 { "LightYellow", { 0xFF, 0xFF, 0xE0 } },
281 { "Lime", { 0x00, 0xFF, 0x00 } },
282 { "LimeGreen", { 0x32, 0xCD, 0x32 } },
283 { "Linen", { 0xFA, 0xF0, 0xE6 } },
284 { "Magenta", { 0xFF, 0x00, 0xFF } },
285 { "Maroon", { 0x80, 0x00, 0x00 } },
286 { "MediumAquaMarine", { 0x66, 0xCD, 0xAA } },
287 { "MediumBlue", { 0x00, 0x00, 0xCD } },
288 { "MediumOrchid", { 0xBA, 0x55, 0xD3 } },
289 { "MediumPurple", { 0x93, 0x70, 0xD8 } },
290 { "MediumSeaGreen", { 0x3C, 0xB3, 0x71 } },
291 { "MediumSlateBlue", { 0x7B, 0x68, 0xEE } },
292 { "MediumSpringGreen", { 0x00, 0xFA, 0x9A } },
293 { "MediumTurquoise", { 0x48, 0xD1, 0xCC } },
294 { "MediumVioletRed", { 0xC7, 0x15, 0x85 } },
295 { "MidnightBlue", { 0x19, 0x19, 0x70 } },
296 { "MintCream", { 0xF5, 0xFF, 0xFA } },
297 { "MistyRose", { 0xFF, 0xE4, 0xE1 } },
298 { "Moccasin", { 0xFF, 0xE4, 0xB5 } },
299 { "NavajoWhite", { 0xFF, 0xDE, 0xAD } },
300 { "Navy", { 0x00, 0x00, 0x80 } },
301 { "OldLace", { 0xFD, 0xF5, 0xE6 } },
302 { "Olive", { 0x80, 0x80, 0x00 } },
303 { "OliveDrab", { 0x6B, 0x8E, 0x23 } },
304 { "Orange", { 0xFF, 0xA5, 0x00 } },
305 { "OrangeRed", { 0xFF, 0x45, 0x00 } },
306 { "Orchid", { 0xDA, 0x70, 0xD6 } },
307 { "PaleGoldenRod", { 0xEE, 0xE8, 0xAA } },
308 { "PaleGreen", { 0x98, 0xFB, 0x98 } },
309 { "PaleTurquoise", { 0xAF, 0xEE, 0xEE } },
310 { "PaleVioletRed", { 0xD8, 0x70, 0x93 } },
311 { "PapayaWhip", { 0xFF, 0xEF, 0xD5 } },
312 { "PeachPuff", { 0xFF, 0xDA, 0xB9 } },
313 { "Peru", { 0xCD, 0x85, 0x3F } },
314 { "Pink", { 0xFF, 0xC0, 0xCB } },
315 { "Plum", { 0xDD, 0xA0, 0xDD } },
316 { "PowderBlue", { 0xB0, 0xE0, 0xE6 } },
317 { "Purple", { 0x80, 0x00, 0x80 } },
318 { "Red", { 0xFF, 0x00, 0x00 } },
319 { "RosyBrown", { 0xBC, 0x8F, 0x8F } },
320 { "RoyalBlue", { 0x41, 0x69, 0xE1 } },
321 { "SaddleBrown", { 0x8B, 0x45, 0x13 } },
322 { "Salmon", { 0xFA, 0x80, 0x72 } },
323 { "SandyBrown", { 0xF4, 0xA4, 0x60 } },
324 { "SeaGreen", { 0x2E, 0x8B, 0x57 } },
325 { "SeaShell", { 0xFF, 0xF5, 0xEE } },
326 { "Sienna", { 0xA0, 0x52, 0x2D } },
327 { "Silver", { 0xC0, 0xC0, 0xC0 } },
328 { "SkyBlue", { 0x87, 0xCE, 0xEB } },
329 { "SlateBlue", { 0x6A, 0x5A, 0xCD } },
330 { "SlateGray", { 0x70, 0x80, 0x90 } },
331 { "Snow", { 0xFF, 0xFA, 0xFA } },
332 { "SpringGreen", { 0x00, 0xFF, 0x7F } },
333 { "SteelBlue", { 0x46, 0x82, 0xB4 } },
334 { "Tan", { 0xD2, 0xB4, 0x8C } },
335 { "Teal", { 0x00, 0x80, 0x80 } },
336 { "Thistle", { 0xD8, 0xBF, 0xD8 } },
337 { "Tomato", { 0xFF, 0x63, 0x47 } },
338 { "Turquoise", { 0x40, 0xE0, 0xD0 } },
339 { "Violet", { 0xEE, 0x82, 0xEE } },
340 { "Wheat", { 0xF5, 0xDE, 0xB3 } },
341 { "White", { 0xFF, 0xFF, 0xFF } },
342 { "WhiteSmoke", { 0xF5, 0xF5, 0xF5 } },
343 { "Yellow", { 0xFF, 0xFF, 0x00 } },
344 { "YellowGreen", { 0x9A, 0xCD, 0x32 } },
347 static int color_table_compare(const void *lhs, const void *rhs)
349 return av_strcasecmp(lhs, ((const ColorEntry *)rhs)->name);
352 #define ALPHA_SEP '@'
354 int av_parse_color(uint8_t *rgba_color, const char *color_string, int slen,
357 char *tail, color_string2[128];
358 const ColorEntry *entry;
359 int len, hex_offset = 0;
361 if (color_string[0] == '#') {
363 } else if (!strncmp(color_string, "0x", 2))
367 slen = strlen(color_string);
368 av_strlcpy(color_string2, color_string + hex_offset,
369 FFMIN(slen-hex_offset+1, sizeof(color_string2)));
370 if ((tail = strchr(color_string2, ALPHA_SEP)))
372 len = strlen(color_string2);
375 if (!av_strcasecmp(color_string2, "random") || !av_strcasecmp(color_string2, "bikeshed")) {
376 int rgba = av_get_random_seed();
377 rgba_color[0] = rgba >> 24;
378 rgba_color[1] = rgba >> 16;
379 rgba_color[2] = rgba >> 8;
380 rgba_color[3] = rgba;
381 } else if (hex_offset ||
382 strspn(color_string2, "0123456789ABCDEFabcdef") == len) {
384 unsigned int rgba = strtoul(color_string2, &tail, 16);
386 if (*tail || (len != 6 && len != 8)) {
387 av_log(log_ctx, AV_LOG_ERROR, "Invalid 0xRRGGBB[AA] color string: '%s'\n", color_string2);
388 return AVERROR(EINVAL);
391 rgba_color[3] = rgba;
394 rgba_color[0] = rgba >> 16;
395 rgba_color[1] = rgba >> 8;
396 rgba_color[2] = rgba;
398 entry = bsearch(color_string2,
400 FF_ARRAY_ELEMS(color_table),
402 color_table_compare);
404 av_log(log_ctx, AV_LOG_ERROR, "Cannot find color '%s'\n", color_string2);
405 return AVERROR(EINVAL);
407 memcpy(rgba_color, entry->rgb_color, 3);
412 const char *alpha_string = tail;
413 if (!strncmp(alpha_string, "0x", 2)) {
414 alpha = strtoul(alpha_string, &tail, 16);
416 double norm_alpha = strtod(alpha_string, &tail);
417 if (norm_alpha < 0.0 || norm_alpha > 1.0)
420 alpha = 255 * norm_alpha;
423 if (tail == alpha_string || *tail || alpha > 255 || alpha < 0) {
424 av_log(log_ctx, AV_LOG_ERROR, "Invalid alpha value specifier '%s' in '%s'\n",
425 alpha_string, color_string);
426 return AVERROR(EINVAL);
428 rgba_color[3] = alpha;
434 const char *av_get_known_color_name(int color_idx, const uint8_t **rgbp)
436 const ColorEntry *color;
438 if ((unsigned)color_idx >= FF_ARRAY_ELEMS(color_table))
441 color = &color_table[color_idx];
443 *rgbp = color->rgb_color;
448 /* get a positive number between n_min and n_max, for a maximum length
449 of len_max. Return -1 if error. */
450 static int date_get_num(const char **pp,
451 int n_min, int n_max, int len_max)
458 for(i = 0; i < len_max; i++) {
462 val = (val * 10) + c - '0';
465 /* no number read ? */
468 if (val < n_min || val > n_max)
474 static int date_get_month(const char **pp) {
476 for (; i < 12; i++) {
477 if (!av_strncasecmp(*pp, months[i], 3)) {
478 const char *mo_full = months[i] + 3;
479 int len = strlen(mo_full);
481 if (len > 0 && !av_strncasecmp(*pp, mo_full, len))
489 char *av_small_strptime(const char *p, const char *fmt, struct tm *dt)
493 while((c = *fmt++)) {
496 for (; *p && av_isspace(*p); p++);
507 val = date_get_num(&p, 0, c == 'H' ? 23 : INT_MAX, c == 'H' ? 2 : 4);
514 val = date_get_num(&p, 0, 59, 2);
520 val = date_get_num(&p, 0, 59, 2);
526 val = date_get_num(&p, 0, 9999, 4);
529 dt->tm_year = val - 1900;
532 val = date_get_num(&p, 1, 12, 2);
535 dt->tm_mon = val - 1;
538 val = date_get_num(&p, 1, 31, 2);
544 p = av_small_strptime(p, "%H:%M:%S", dt);
551 val = date_get_month(&p);
568 time_t av_timegm(struct tm *tm)
572 int y = tm->tm_year + 1900, m = tm->tm_mon + 1, d = tm->tm_mday;
580 (d + (153 * m - 457) / 5 + 365 * y + y / 4 - y / 100 + y / 400 - 719469);
582 t += 3600 * tm->tm_hour + 60 * tm->tm_min + tm->tm_sec;
587 int av_parse_time(int64_t *timeval, const char *timestr, int duration)
592 struct tm dt = { 0 }, tmbuf;
593 int today = 0, negative = 0, microseconds = 0, suffix = 1000000;
595 static const char * const date_fmt[] = {
599 static const char * const time_fmt[] = {
603 static const char * const tz_fmt[] = {
611 *timeval = INT64_MIN;
613 now64 = av_gettime();
614 now = now64 / 1000000;
616 if (!av_strcasecmp(timestr, "now")) {
621 /* parse the year-month-day part */
622 for (i = 0; i < FF_ARRAY_ELEMS(date_fmt); i++) {
623 q = av_small_strptime(p, date_fmt[i], &dt);
628 /* if the year-month-day part is missing, then take the
629 * current year-month-day time */
636 if (*p == 'T' || *p == 't')
639 while (av_isspace(*p))
642 /* parse the hour-minute-second part */
643 for (i = 0; i < FF_ARRAY_ELEMS(time_fmt); i++) {
644 q = av_small_strptime(p, time_fmt[i], &dt);
649 /* parse timestr as a duration */
654 /* parse timestr as HH:MM:SS */
655 q = av_small_strptime(p, "%J:%M:%S", &dt);
657 /* parse timestr as MM:SS */
658 q = av_small_strptime(p, "%M:%S", &dt);
663 /* parse timestr as S+ */
665 t = strtoll(p, &o, 10);
666 if (o == p) /* the parsing didn't succeed */
667 return AVERROR(EINVAL);
669 return AVERROR(ERANGE);
672 t = dt.tm_hour * 3600 + dt.tm_min * 60 + dt.tm_sec;
676 /* Now we have all the fields that we can get */
678 return AVERROR(EINVAL);
680 /* parse the .m... part */
684 for (n = 100000; n >= 1; n /= 10, q++) {
687 microseconds += n * (*q - '0');
689 while (av_isdigit(*q))
694 if (q[0] == 'm' && q[1] == 's') {
696 microseconds /= 1000;
698 } else if (q[0] == 'u' && q[1] == 's') {
702 } else if (*q == 's')
705 int is_utc = *q == 'Z' || *q == 'z';
708 if (!today && !is_utc && (*q == '+' || *q == '-')) {
709 struct tm tz = { 0 };
710 int sign = (*q == '+' ? -1 : 1);
713 for (i = 0; i < FF_ARRAY_ELEMS(tz_fmt); i++) {
714 q = av_small_strptime(p, tz_fmt[i], &tz);
719 return AVERROR(EINVAL);
720 tzoffset = sign * (tz.tm_hour * 60 + tz.tm_min) * 60;
723 if (today) { /* fill in today's date */
724 struct tm dt2 = is_utc ? *gmtime_r(&now, &tmbuf) : *localtime_r(&now, &tmbuf);
725 dt2.tm_hour = dt.tm_hour;
726 dt2.tm_min = dt.tm_min;
727 dt2.tm_sec = dt.tm_sec;
730 dt.tm_isdst = is_utc ? 0 : -1;
731 t = is_utc ? av_timegm(&dt) : mktime(&dt);
735 /* Check that we are at the end of the string */
737 return AVERROR(EINVAL);
739 if (INT64_MAX / suffix < t)
740 return AVERROR(ERANGE);
742 if (INT64_MAX - microseconds < t)
743 return AVERROR(ERANGE);
745 *timeval = negative ? -t : t;
749 int av_find_info_tag(char *arg, int arg_size, const char *tag1, const char *info)
759 while (*p != '\0' && *p != '=' && *p != '&') {
760 if ((q - tag) < sizeof(tag) - 1)
768 while (*p != '&' && *p != '\0') {
769 if ((q - arg) < arg_size - 1) {
779 if (!strcmp(tag, tag1))