Merge commit '3b08d9d932eef09403074d5af31e10d8011e840b'
[ffmpeg.git] / libavutil / opt.c
1 /*
2  * AVOptions
3  * Copyright (c) 2005 Michael Niedermayer <michaelni@gmx.at>
4  *
5  * This file is part of FFmpeg.
6  *
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.
11  *
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.
16  *
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
20  */
21
22 /**
23  * @file
24  * AVOptions
25  * @author Michael Niedermayer <michaelni@gmx.at>
26  */
27
28 #include "avutil.h"
29 #include "avassert.h"
30 #include "avstring.h"
31 #include "channel_layout.h"
32 #include "common.h"
33 #include "dict.h"
34 #include "eval.h"
35 #include "log.h"
36 #include "parseutils.h"
37 #include "pixdesc.h"
38 #include "mathematics.h"
39 #include "opt.h"
40 #include "samplefmt.h"
41 #include "bprint.h"
42
43 #include <float.h>
44
45 const AVOption *av_opt_next(const void *obj, const AVOption *last)
46 {
47     const AVClass *class;
48     if (!obj)
49         return NULL;
50     class = *(const AVClass**)obj;
51     if (!last && class && class->option && class->option[0].name)
52         return class->option;
53     if (last && last[1].name)
54         return ++last;
55     return NULL;
56 }
57
58 static int read_number(const AVOption *o, const void *dst, double *num, int *den, int64_t *intnum)
59 {
60     switch (o->type) {
61     case AV_OPT_TYPE_FLAGS:
62         *intnum = *(unsigned int*)dst;
63         return 0;
64     case AV_OPT_TYPE_PIXEL_FMT:
65         *intnum = *(enum AVPixelFormat *)dst;
66         return 0;
67     case AV_OPT_TYPE_SAMPLE_FMT:
68         *intnum = *(enum AVSampleFormat *)dst;
69         return 0;
70     case AV_OPT_TYPE_BOOL:
71     case AV_OPT_TYPE_INT:
72         *intnum = *(int *)dst;
73         return 0;
74     case AV_OPT_TYPE_CHANNEL_LAYOUT:
75     case AV_OPT_TYPE_DURATION:
76     case AV_OPT_TYPE_INT64:
77         *intnum = *(int64_t *)dst;
78         return 0;
79     case AV_OPT_TYPE_FLOAT:
80         *num = *(float *)dst;
81         return 0;
82     case AV_OPT_TYPE_DOUBLE:
83         *num = *(double *)dst;
84         return 0;
85     case AV_OPT_TYPE_RATIONAL:
86         *intnum = ((AVRational *)dst)->num;
87         *den    = ((AVRational *)dst)->den;
88         return 0;
89     case AV_OPT_TYPE_CONST:
90         *num = o->default_val.dbl;
91         return 0;
92     }
93     return AVERROR(EINVAL);
94 }
95
96 static int write_number(void *obj, const AVOption *o, void *dst, double num, int den, int64_t intnum)
97 {
98     if (o->type != AV_OPT_TYPE_FLAGS &&
99         (o->max * den < num * intnum || o->min * den > num * intnum)) {
100         num = den ? num * intnum / den : (num * intnum ? INFINITY : NAN);
101         av_log(obj, AV_LOG_ERROR, "Value %f for parameter '%s' out of range [%g - %g]\n",
102                num, o->name, o->min, o->max);
103         return AVERROR(ERANGE);
104     }
105     if (o->type == AV_OPT_TYPE_FLAGS) {
106         double d = num*intnum/den;
107         if (d < -1.5 || d > 0xFFFFFFFF+0.5 || (llrint(d*256) & 255)) {
108             av_log(obj, AV_LOG_ERROR,
109                    "Value %f for parameter '%s' is not a valid set of 32bit integer flags\n",
110                    num*intnum/den, o->name);
111             return AVERROR(ERANGE);
112         }
113     }
114
115     switch (o->type) {
116     case AV_OPT_TYPE_PIXEL_FMT:
117         *(enum AVPixelFormat *)dst = llrint(num / den) * intnum;
118         break;
119     case AV_OPT_TYPE_SAMPLE_FMT:
120         *(enum AVSampleFormat *)dst = llrint(num / den) * intnum;
121         break;
122     case AV_OPT_TYPE_BOOL:
123     case AV_OPT_TYPE_FLAGS:
124     case AV_OPT_TYPE_INT:
125         *(int *)dst = llrint(num / den) * intnum;
126         break;
127     case AV_OPT_TYPE_DURATION:
128     case AV_OPT_TYPE_CHANNEL_LAYOUT:
129     case AV_OPT_TYPE_INT64:
130         *(int64_t *)dst = llrint(num / den) * intnum;
131         break;
132     case AV_OPT_TYPE_FLOAT:
133         *(float *)dst = num * intnum / den;
134         break;
135     case AV_OPT_TYPE_DOUBLE:
136         *(double    *)dst = num * intnum / den;
137         break;
138     case AV_OPT_TYPE_RATIONAL:
139         if ((int) num == num)
140             *(AVRational *)dst = (AVRational) { num *intnum, den };
141         else
142             *(AVRational *)dst = av_d2q(num * intnum / den, 1 << 24);
143         break;
144     default:
145         return AVERROR(EINVAL);
146     }
147     return 0;
148 }
149
150 static int hexchar2int(char c) {
151     if (c >= '0' && c <= '9')
152         return c - '0';
153     if (c >= 'a' && c <= 'f')
154         return c - 'a' + 10;
155     if (c >= 'A' && c <= 'F')
156         return c - 'A' + 10;
157     return -1;
158 }
159
160 static int set_string_binary(void *obj, const AVOption *o, const char *val, uint8_t **dst)
161 {
162     int *lendst = (int *)(dst + 1);
163     uint8_t *bin, *ptr;
164     int len;
165
166     av_freep(dst);
167     *lendst = 0;
168
169     if (!val || !(len = strlen(val)))
170         return 0;
171
172     if (len & 1)
173         return AVERROR(EINVAL);
174     len /= 2;
175
176     ptr = bin = av_malloc(len);
177     if (!ptr)
178         return AVERROR(ENOMEM);
179     while (*val) {
180         int a = hexchar2int(*val++);
181         int b = hexchar2int(*val++);
182         if (a < 0 || b < 0) {
183             av_free(bin);
184             return AVERROR(EINVAL);
185         }
186         *ptr++ = (a << 4) | b;
187     }
188     *dst    = bin;
189     *lendst = len;
190
191     return 0;
192 }
193
194 static int set_string(void *obj, const AVOption *o, const char *val, uint8_t **dst)
195 {
196     av_freep(dst);
197     *dst = av_strdup(val);
198     return *dst ? 0 : AVERROR(ENOMEM);
199 }
200
201 #define DEFAULT_NUMVAL(opt) ((opt->type == AV_OPT_TYPE_INT64 || \
202                               opt->type == AV_OPT_TYPE_CONST || \
203                               opt->type == AV_OPT_TYPE_FLAGS || \
204                               opt->type == AV_OPT_TYPE_INT)     \
205                              ? opt->default_val.i64             \
206                              : opt->default_val.dbl)
207
208 static int set_string_number(void *obj, void *target_obj, const AVOption *o, const char *val, void *dst)
209 {
210     int ret = 0;
211     int num, den;
212     char c;
213
214     if (sscanf(val, "%d%*1[:/]%d%c", &num, &den, &c) == 2) {
215         if ((ret = write_number(obj, o, dst, 1, den, num)) >= 0)
216             return ret;
217         ret = 0;
218     }
219
220     for (;;) {
221         int i = 0;
222         char buf[256];
223         int cmd = 0;
224         double d;
225         int64_t intnum = 1;
226
227         if (o->type == AV_OPT_TYPE_FLAGS) {
228             if (*val == '+' || *val == '-')
229                 cmd = *(val++);
230             for (; i < sizeof(buf) - 1 && val[i] && val[i] != '+' && val[i] != '-'; i++)
231                 buf[i] = val[i];
232             buf[i] = 0;
233         }
234
235         {
236             const AVOption *o_named = av_opt_find(target_obj, i ? buf : val, o->unit, 0, 0);
237             int res;
238             int ci = 0;
239             double const_values[64];
240             const char * const_names[64];
241             if (o_named && o_named->type == AV_OPT_TYPE_CONST)
242                 d = DEFAULT_NUMVAL(o_named);
243             else {
244                 if (o->unit) {
245                     for (o_named = NULL; o_named = av_opt_next(target_obj, o_named); ) {
246                         if (o_named->type == AV_OPT_TYPE_CONST &&
247                             o_named->unit &&
248                             !strcmp(o_named->unit, o->unit)) {
249                             if (ci + 6 >= FF_ARRAY_ELEMS(const_values)) {
250                                 av_log(obj, AV_LOG_ERROR, "const_values array too small for %s\n", o->unit);
251                                 return AVERROR_PATCHWELCOME;
252                             }
253                             const_names [ci  ] = o_named->name;
254                             const_values[ci++] = DEFAULT_NUMVAL(o_named);
255                         }
256                     }
257                 }
258                 const_names [ci  ] = "default";
259                 const_values[ci++] = DEFAULT_NUMVAL(o);
260                 const_names [ci  ] = "max";
261                 const_values[ci++] = o->max;
262                 const_names [ci  ] = "min";
263                 const_values[ci++] = o->min;
264                 const_names [ci  ] = "none";
265                 const_values[ci++] = 0;
266                 const_names [ci  ] = "all";
267                 const_values[ci++] = ~0;
268                 const_names [ci] = NULL;
269                 const_values[ci] = 0;
270
271                 res = av_expr_parse_and_eval(&d, i ? buf : val, const_names,
272                                             const_values, NULL, NULL, NULL, NULL, NULL, 0, obj);
273                 if (res < 0) {
274                     av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\"\n", val);
275                     return res;
276                 }
277             }
278         }
279         if (o->type == AV_OPT_TYPE_FLAGS) {
280             read_number(o, dst, NULL, NULL, &intnum);
281             if (cmd == '+')
282                 d = intnum | (int64_t)d;
283             else if (cmd == '-')
284                 d = intnum &~(int64_t)d;
285         }
286
287         if ((ret = write_number(obj, o, dst, d, 1, 1)) < 0)
288             return ret;
289         val += i;
290         if (!i || !*val)
291             return 0;
292     }
293
294     return 0;
295 }
296
297 static int set_string_image_size(void *obj, const AVOption *o, const char *val, int *dst)
298 {
299     int ret;
300
301     if (!val || !strcmp(val, "none")) {
302         dst[0] =
303         dst[1] = 0;
304         return 0;
305     }
306     ret = av_parse_video_size(dst, dst + 1, val);
307     if (ret < 0)
308         av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as image size\n", val);
309     return ret;
310 }
311
312 static int set_string_video_rate(void *obj, const AVOption *o, const char *val, AVRational *dst)
313 {
314     int ret;
315     if (!val) {
316         ret = AVERROR(EINVAL);
317     } else {
318         ret = av_parse_video_rate(dst, val);
319     }
320     if (ret < 0)
321         av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as video rate\n", val);
322     return ret;
323 }
324
325 static int set_string_color(void *obj, const AVOption *o, const char *val, uint8_t *dst)
326 {
327     int ret;
328
329     if (!val) {
330         return 0;
331     } else {
332         ret = av_parse_color(dst, val, -1, obj);
333         if (ret < 0)
334             av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as color\n", val);
335         return ret;
336     }
337     return 0;
338 }
339
340 static const char *get_bool_name(int val)
341 {
342     if (val < 0)
343         return "auto";
344     return val ? "true" : "false";
345 }
346
347 static int set_string_bool(void *obj, const AVOption *o, const char *val, int *dst)
348 {
349     int n;
350
351     if (!val)
352         return 0;
353
354     if (!strcmp(val, "auto")) {
355         n = -1;
356     } else if (av_match_name(val, "true,y,yes,enable,enabled,on")) {
357         n = 1;
358     } else if (av_match_name(val, "false,n,no,disable,disabled,off")) {
359         n = 0;
360     } else {
361         char *end = NULL;
362         n = strtol(val, &end, 10);
363         if (val + strlen(val) != end)
364             goto fail;
365     }
366
367     if (n < o->min || n > o->max)
368         goto fail;
369
370     *dst = n;
371     return 0;
372
373 fail:
374     av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as boolean\n", val);
375     return AVERROR(EINVAL);
376 }
377
378 static int set_string_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst,
379                           int fmt_nb, int ((*get_fmt)(const char *)), const char *desc)
380 {
381     int fmt, min, max;
382
383     if (!val || !strcmp(val, "none")) {
384         fmt = -1;
385     } else {
386         fmt = get_fmt(val);
387         if (fmt == -1) {
388             char *tail;
389             fmt = strtol(val, &tail, 0);
390             if (*tail || (unsigned)fmt >= fmt_nb) {
391                 av_log(obj, AV_LOG_ERROR,
392                        "Unable to parse option value \"%s\" as %s\n", val, desc);
393                 return AVERROR(EINVAL);
394             }
395         }
396     }
397
398     min = FFMAX(o->min, -1);
399     max = FFMIN(o->max, fmt_nb-1);
400
401     // hack for compatibility with old ffmpeg
402     if(min == 0 && max == 0) {
403         min = -1;
404         max = fmt_nb-1;
405     }
406
407     if (fmt < min || fmt > max) {
408         av_log(obj, AV_LOG_ERROR,
409                "Value %d for parameter '%s' out of %s format range [%d - %d]\n",
410                fmt, o->name, desc, min, max);
411         return AVERROR(ERANGE);
412     }
413
414     *(int *)dst = fmt;
415     return 0;
416 }
417
418 static int set_string_pixel_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst)
419 {
420     return set_string_fmt(obj, o, val, dst,
421                           AV_PIX_FMT_NB, av_get_pix_fmt, "pixel format");
422 }
423
424 static int set_string_sample_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst)
425 {
426     return set_string_fmt(obj, o, val, dst,
427                           AV_SAMPLE_FMT_NB, av_get_sample_fmt, "sample format");
428 }
429
430 int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
431 {
432     int ret = 0;
433     void *dst, *target_obj;
434     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
435     if (!o || !target_obj)
436         return AVERROR_OPTION_NOT_FOUND;
437     if (!val && (o->type != AV_OPT_TYPE_STRING &&
438                  o->type != AV_OPT_TYPE_PIXEL_FMT && o->type != AV_OPT_TYPE_SAMPLE_FMT &&
439                  o->type != AV_OPT_TYPE_IMAGE_SIZE && o->type != AV_OPT_TYPE_VIDEO_RATE &&
440                  o->type != AV_OPT_TYPE_DURATION && o->type != AV_OPT_TYPE_COLOR &&
441                  o->type != AV_OPT_TYPE_CHANNEL_LAYOUT && o->type != AV_OPT_TYPE_BOOL))
442         return AVERROR(EINVAL);
443
444     if (o->flags & AV_OPT_FLAG_READONLY)
445         return AVERROR(EINVAL);
446
447     dst = ((uint8_t *)target_obj) + o->offset;
448     switch (o->type) {
449     case AV_OPT_TYPE_BOOL:
450         return set_string_bool(obj, o, val, dst);
451     case AV_OPT_TYPE_STRING:
452         return set_string(obj, o, val, dst);
453     case AV_OPT_TYPE_BINARY:
454         return set_string_binary(obj, o, val, dst);
455     case AV_OPT_TYPE_FLAGS:
456     case AV_OPT_TYPE_INT:
457     case AV_OPT_TYPE_INT64:
458     case AV_OPT_TYPE_FLOAT:
459     case AV_OPT_TYPE_DOUBLE:
460     case AV_OPT_TYPE_RATIONAL:
461         return set_string_number(obj, target_obj, o, val, dst);
462     case AV_OPT_TYPE_IMAGE_SIZE:
463         return set_string_image_size(obj, o, val, dst);
464     case AV_OPT_TYPE_VIDEO_RATE:
465         return set_string_video_rate(obj, o, val, dst);
466     case AV_OPT_TYPE_PIXEL_FMT:
467         return set_string_pixel_fmt(obj, o, val, dst);
468     case AV_OPT_TYPE_SAMPLE_FMT:
469         return set_string_sample_fmt(obj, o, val, dst);
470     case AV_OPT_TYPE_DURATION:
471         if (!val) {
472             *(int64_t *)dst = 0;
473             return 0;
474         } else {
475             if ((ret = av_parse_time(dst, val, 1)) < 0)
476                 av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as duration\n", val);
477             return ret;
478         }
479         break;
480     case AV_OPT_TYPE_COLOR:
481         return set_string_color(obj, o, val, dst);
482     case AV_OPT_TYPE_CHANNEL_LAYOUT:
483         if (!val || !strcmp(val, "none")) {
484             *(int64_t *)dst = 0;
485         } else {
486             int64_t cl = av_get_channel_layout(val);
487             if (!cl) {
488                 av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as channel layout\n", val);
489                 ret = AVERROR(EINVAL);
490             }
491             *(int64_t *)dst = cl;
492             return ret;
493         }
494         break;
495     }
496
497     av_log(obj, AV_LOG_ERROR, "Invalid option type.\n");
498     return AVERROR(EINVAL);
499 }
500
501 #define OPT_EVAL_NUMBER(name, opttype, vartype)                         \
502 int av_opt_eval_ ## name(void *obj, const AVOption *o,                  \
503                          const char *val, vartype *name ## _out)        \
504 {                                                                       \
505     if (!o || o->type != opttype || o->flags & AV_OPT_FLAG_READONLY)    \
506         return AVERROR(EINVAL);                                         \
507     return set_string_number(obj, obj, o, val, name ## _out);           \
508 }
509
510 OPT_EVAL_NUMBER(flags,  AV_OPT_TYPE_FLAGS,    int)
511 OPT_EVAL_NUMBER(int,    AV_OPT_TYPE_INT,      int)
512 OPT_EVAL_NUMBER(int64,  AV_OPT_TYPE_INT64,    int64_t)
513 OPT_EVAL_NUMBER(float,  AV_OPT_TYPE_FLOAT,    float)
514 OPT_EVAL_NUMBER(double, AV_OPT_TYPE_DOUBLE,   double)
515 OPT_EVAL_NUMBER(q,      AV_OPT_TYPE_RATIONAL, AVRational)
516
517 static int set_number(void *obj, const char *name, double num, int den, int64_t intnum,
518                       int search_flags)
519 {
520     void *dst, *target_obj;
521     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
522
523     if (!o || !target_obj)
524         return AVERROR_OPTION_NOT_FOUND;
525
526     if (o->flags & AV_OPT_FLAG_READONLY)
527         return AVERROR(EINVAL);
528
529     dst = ((uint8_t *)target_obj) + o->offset;
530     return write_number(obj, o, dst, num, den, intnum);
531 }
532
533 int av_opt_set_int(void *obj, const char *name, int64_t val, int search_flags)
534 {
535     return set_number(obj, name, 1, 1, val, search_flags);
536 }
537
538 int av_opt_set_double(void *obj, const char *name, double val, int search_flags)
539 {
540     return set_number(obj, name, val, 1, 1, search_flags);
541 }
542
543 int av_opt_set_q(void *obj, const char *name, AVRational val, int search_flags)
544 {
545     return set_number(obj, name, val.num, val.den, 1, search_flags);
546 }
547
548 int av_opt_set_bin(void *obj, const char *name, const uint8_t *val, int len, int search_flags)
549 {
550     void *target_obj;
551     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
552     uint8_t *ptr;
553     uint8_t **dst;
554     int *lendst;
555
556     if (!o || !target_obj)
557         return AVERROR_OPTION_NOT_FOUND;
558
559     if (o->type != AV_OPT_TYPE_BINARY || o->flags & AV_OPT_FLAG_READONLY)
560         return AVERROR(EINVAL);
561
562     ptr = len ? av_malloc(len) : NULL;
563     if (len && !ptr)
564         return AVERROR(ENOMEM);
565
566     dst    = (uint8_t **)(((uint8_t *)target_obj) + o->offset);
567     lendst = (int *)(dst + 1);
568
569     av_free(*dst);
570     *dst    = ptr;
571     *lendst = len;
572     if (len)
573         memcpy(ptr, val, len);
574
575     return 0;
576 }
577
578 int av_opt_set_image_size(void *obj, const char *name, int w, int h, int search_flags)
579 {
580     void *target_obj;
581     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
582
583     if (!o || !target_obj)
584         return AVERROR_OPTION_NOT_FOUND;
585     if (o->type != AV_OPT_TYPE_IMAGE_SIZE) {
586         av_log(obj, AV_LOG_ERROR,
587                "The value set by option '%s' is not an image size.\n", o->name);
588         return AVERROR(EINVAL);
589     }
590     if (w<0 || h<0) {
591         av_log(obj, AV_LOG_ERROR,
592                "Invalid negative size value %dx%d for size '%s'\n", w, h, o->name);
593         return AVERROR(EINVAL);
594     }
595     *(int *)(((uint8_t *)target_obj)             + o->offset) = w;
596     *(int *)(((uint8_t *)target_obj+sizeof(int)) + o->offset) = h;
597     return 0;
598 }
599
600 int av_opt_set_video_rate(void *obj, const char *name, AVRational val, int search_flags)
601 {
602     void *target_obj;
603     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
604
605     if (!o || !target_obj)
606         return AVERROR_OPTION_NOT_FOUND;
607     if (o->type != AV_OPT_TYPE_VIDEO_RATE) {
608         av_log(obj, AV_LOG_ERROR,
609                "The value set by option '%s' is not a video rate.\n", o->name);
610         return AVERROR(EINVAL);
611     }
612     if (val.num <= 0 || val.den <= 0)
613         return AVERROR(EINVAL);
614     return set_number(obj, name, val.num, val.den, 1, search_flags);
615 }
616
617 static int set_format(void *obj, const char *name, int fmt, int search_flags,
618                       enum AVOptionType type, const char *desc, int nb_fmts)
619 {
620     void *target_obj;
621     const AVOption *o = av_opt_find2(obj, name, NULL, 0,
622                                      search_flags, &target_obj);
623     int min, max;
624
625     if (!o || !target_obj)
626         return AVERROR_OPTION_NOT_FOUND;
627     if (o->type != type) {
628         av_log(obj, AV_LOG_ERROR,
629                "The value set by option '%s' is not a %s format", name, desc);
630         return AVERROR(EINVAL);
631     }
632
633     min = FFMAX(o->min, -1);
634     max = FFMIN(o->max, nb_fmts-1);
635
636     if (fmt < min || fmt > max) {
637         av_log(obj, AV_LOG_ERROR,
638                "Value %d for parameter '%s' out of %s format range [%d - %d]\n",
639                fmt, name, desc, min, max);
640         return AVERROR(ERANGE);
641     }
642     *(int *)(((uint8_t *)target_obj) + o->offset) = fmt;
643     return 0;
644 }
645
646 int av_opt_set_pixel_fmt(void *obj, const char *name, enum AVPixelFormat fmt, int search_flags)
647 {
648     return set_format(obj, name, fmt, search_flags, AV_OPT_TYPE_PIXEL_FMT, "pixel", AV_PIX_FMT_NB);
649 }
650
651 int av_opt_set_sample_fmt(void *obj, const char *name, enum AVSampleFormat fmt, int search_flags)
652 {
653     return set_format(obj, name, fmt, search_flags, AV_OPT_TYPE_SAMPLE_FMT, "sample", AV_SAMPLE_FMT_NB);
654 }
655
656 int av_opt_set_channel_layout(void *obj, const char *name, int64_t cl, int search_flags)
657 {
658     void *target_obj;
659     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
660
661     if (!o || !target_obj)
662         return AVERROR_OPTION_NOT_FOUND;
663     if (o->type != AV_OPT_TYPE_CHANNEL_LAYOUT) {
664         av_log(obj, AV_LOG_ERROR,
665                "The value set by option '%s' is not a channel layout.\n", o->name);
666         return AVERROR(EINVAL);
667     }
668     *(int64_t *)(((uint8_t *)target_obj) + o->offset) = cl;
669     return 0;
670 }
671
672 int av_opt_set_dict_val(void *obj, const char *name, const AVDictionary *val,
673                         int search_flags)
674 {
675     void *target_obj;
676     AVDictionary **dst;
677     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
678
679     if (!o || !target_obj)
680         return AVERROR_OPTION_NOT_FOUND;
681     if (o->flags & AV_OPT_FLAG_READONLY)
682         return AVERROR(EINVAL);
683
684     dst = (AVDictionary **)(((uint8_t *)target_obj) + o->offset);
685     av_dict_free(dst);
686     av_dict_copy(dst, val, 0);
687
688     return 0;
689 }
690
691 static void format_duration(char *buf, size_t size, int64_t d)
692 {
693     char *e;
694
695     av_assert0(size >= 25);
696     if (d < 0 && d != INT64_MIN) {
697         *(buf++) = '-';
698         size--;
699         d = -d;
700     }
701     if (d == INT64_MAX)
702         snprintf(buf, size, "INT64_MAX");
703     else if (d == INT64_MIN)
704         snprintf(buf, size, "INT64_MIN");
705     else if (d > (int64_t)3600*1000000)
706         snprintf(buf, size, "%"PRId64":%02d:%02d.%06d", d / 3600000000,
707                  (int)((d / 60000000) % 60),
708                  (int)((d / 1000000) % 60),
709                  (int)(d % 1000000));
710     else if (d > 60*1000000)
711         snprintf(buf, size, "%d:%02d.%06d",
712                  (int)(d / 60000000),
713                  (int)((d / 1000000) % 60),
714                  (int)(d % 1000000));
715     else
716         snprintf(buf, size, "%d.%06d",
717                  (int)(d / 1000000),
718                  (int)(d % 1000000));
719     e = buf + strlen(buf);
720     while (e > buf && e[-1] == '0')
721         *(--e) = 0;
722     if (e > buf && e[-1] == '.')
723         *(--e) = 0;
724 }
725
726 int av_opt_get(void *obj, const char *name, int search_flags, uint8_t **out_val)
727 {
728     void *dst, *target_obj;
729     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
730     uint8_t *bin, buf[128];
731     int len, i, ret;
732     int64_t i64;
733
734     if (!o || !target_obj || (o->offset<=0 && o->type != AV_OPT_TYPE_CONST))
735         return AVERROR_OPTION_NOT_FOUND;
736
737     dst = (uint8_t *)target_obj + o->offset;
738
739     buf[0] = 0;
740     switch (o->type) {
741     case AV_OPT_TYPE_BOOL:
742         ret = snprintf(buf, sizeof(buf), "%s", (char *)av_x_if_null(get_bool_name(*(int *)dst), "invalid"));
743         break;
744     case AV_OPT_TYPE_FLAGS:
745         ret = snprintf(buf, sizeof(buf), "0x%08X", *(int *)dst);
746         break;
747     case AV_OPT_TYPE_INT:
748         ret = snprintf(buf, sizeof(buf), "%d", *(int *)dst);
749         break;
750     case AV_OPT_TYPE_INT64:
751         ret = snprintf(buf, sizeof(buf), "%"PRId64, *(int64_t *)dst);
752         break;
753     case AV_OPT_TYPE_FLOAT:
754         ret = snprintf(buf, sizeof(buf), "%f", *(float *)dst);
755         break;
756     case AV_OPT_TYPE_DOUBLE:
757         ret = snprintf(buf, sizeof(buf), "%f", *(double *)dst);
758         break;
759     case AV_OPT_TYPE_VIDEO_RATE:
760     case AV_OPT_TYPE_RATIONAL:
761         ret = snprintf(buf, sizeof(buf), "%d/%d", ((AVRational *)dst)->num, ((AVRational *)dst)->den);
762         break;
763     case AV_OPT_TYPE_CONST:
764         ret = snprintf(buf, sizeof(buf), "%f", o->default_val.dbl);
765         break;
766     case AV_OPT_TYPE_STRING:
767         if (*(uint8_t **)dst) {
768             *out_val = av_strdup(*(uint8_t **)dst);
769         } else if (search_flags & AV_OPT_ALLOW_NULL) {
770             *out_val = NULL;
771             return 0;
772         } else {
773             *out_val = av_strdup("");
774         }
775         return *out_val ? 0 : AVERROR(ENOMEM);
776     case AV_OPT_TYPE_BINARY:
777         if (!*(uint8_t **)dst && (search_flags & AV_OPT_ALLOW_NULL)) {
778             *out_val = NULL;
779             return 0;
780         }
781         len = *(int *)(((uint8_t *)dst) + sizeof(uint8_t *));
782         if ((uint64_t)len * 2 + 1 > INT_MAX)
783             return AVERROR(EINVAL);
784         if (!(*out_val = av_malloc(len * 2 + 1)))
785             return AVERROR(ENOMEM);
786         if (!len) {
787             *out_val[0] = '\0';
788             return 0;
789         }
790         bin = *(uint8_t **)dst;
791         for (i = 0; i < len; i++)
792             snprintf(*out_val + i * 2, 3, "%02X", bin[i]);
793         return 0;
794     case AV_OPT_TYPE_IMAGE_SIZE:
795         ret = snprintf(buf, sizeof(buf), "%dx%d", ((int *)dst)[0], ((int *)dst)[1]);
796         break;
797     case AV_OPT_TYPE_PIXEL_FMT:
798         ret = snprintf(buf, sizeof(buf), "%s", (char *)av_x_if_null(av_get_pix_fmt_name(*(enum AVPixelFormat *)dst), "none"));
799         break;
800     case AV_OPT_TYPE_SAMPLE_FMT:
801         ret = snprintf(buf, sizeof(buf), "%s", (char *)av_x_if_null(av_get_sample_fmt_name(*(enum AVSampleFormat *)dst), "none"));
802         break;
803     case AV_OPT_TYPE_DURATION:
804         i64 = *(int64_t *)dst;
805         format_duration(buf, sizeof(buf), i64);
806         ret = strlen(buf); // no overflow possible, checked by an assert
807         break;
808     case AV_OPT_TYPE_COLOR:
809         ret = snprintf(buf, sizeof(buf), "0x%02x%02x%02x%02x",
810                        (int)((uint8_t *)dst)[0], (int)((uint8_t *)dst)[1],
811                        (int)((uint8_t *)dst)[2], (int)((uint8_t *)dst)[3]);
812         break;
813     case AV_OPT_TYPE_CHANNEL_LAYOUT:
814         i64 = *(int64_t *)dst;
815         ret = snprintf(buf, sizeof(buf), "0x%"PRIx64, i64);
816         break;
817     default:
818         return AVERROR(EINVAL);
819     }
820
821     if (ret >= sizeof(buf))
822         return AVERROR(EINVAL);
823     *out_val = av_strdup(buf);
824     return *out_val ? 0 : AVERROR(ENOMEM);
825 }
826
827 static int get_number(void *obj, const char *name, const AVOption **o_out, double *num, int *den, int64_t *intnum,
828                       int search_flags)
829 {
830     void *dst, *target_obj;
831     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
832     if (!o || !target_obj)
833         goto error;
834
835     dst = ((uint8_t *)target_obj) + o->offset;
836
837     if (o_out) *o_out= o;
838
839     return read_number(o, dst, num, den, intnum);
840
841 error:
842     *den    =
843     *intnum = 0;
844     return -1;
845 }
846
847 int av_opt_get_int(void *obj, const char *name, int search_flags, int64_t *out_val)
848 {
849     int64_t intnum = 1;
850     double num = 1;
851     int ret, den = 1;
852
853     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
854         return ret;
855     *out_val = num * intnum / den;
856     return 0;
857 }
858
859 int av_opt_get_double(void *obj, const char *name, int search_flags, double *out_val)
860 {
861     int64_t intnum = 1;
862     double num = 1;
863     int ret, den = 1;
864
865     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
866         return ret;
867     *out_val = num * intnum / den;
868     return 0;
869 }
870
871 int av_opt_get_q(void *obj, const char *name, int search_flags, AVRational *out_val)
872 {
873     int64_t intnum = 1;
874     double num = 1;
875     int ret, den = 1;
876
877     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
878         return ret;
879
880     if (num == 1.0 && (int)intnum == intnum)
881         *out_val = (AVRational){intnum, den};
882     else
883         *out_val = av_d2q(num*intnum/den, 1<<24);
884     return 0;
885 }
886
887 int av_opt_get_image_size(void *obj, const char *name, int search_flags, int *w_out, int *h_out)
888 {
889     void *dst, *target_obj;
890     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
891     if (!o || !target_obj)
892         return AVERROR_OPTION_NOT_FOUND;
893     if (o->type != AV_OPT_TYPE_IMAGE_SIZE) {
894         av_log(obj, AV_LOG_ERROR,
895                "The value for option '%s' is not an image size.\n", name);
896         return AVERROR(EINVAL);
897     }
898
899     dst = ((uint8_t*)target_obj) + o->offset;
900     if (w_out) *w_out = *(int *)dst;
901     if (h_out) *h_out = *((int *)dst+1);
902     return 0;
903 }
904
905 int av_opt_get_video_rate(void *obj, const char *name, int search_flags, AVRational *out_val)
906 {
907     int64_t intnum = 1;
908     double     num = 1;
909     int   ret, den = 1;
910
911     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
912         return ret;
913
914     if (num == 1.0 && (int)intnum == intnum)
915         *out_val = (AVRational) { intnum, den };
916     else
917         *out_val = av_d2q(num * intnum / den, 1 << 24);
918     return 0;
919 }
920
921 static int get_format(void *obj, const char *name, int search_flags, int *out_fmt,
922                       enum AVOptionType type, const char *desc)
923 {
924     void *dst, *target_obj;
925     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
926     if (!o || !target_obj)
927         return AVERROR_OPTION_NOT_FOUND;
928     if (o->type != type) {
929         av_log(obj, AV_LOG_ERROR,
930                "The value for option '%s' is not a %s format.\n", desc, name);
931         return AVERROR(EINVAL);
932     }
933
934     dst = ((uint8_t*)target_obj) + o->offset;
935     *out_fmt = *(int *)dst;
936     return 0;
937 }
938
939 int av_opt_get_pixel_fmt(void *obj, const char *name, int search_flags, enum AVPixelFormat *out_fmt)
940 {
941     return get_format(obj, name, search_flags, out_fmt, AV_OPT_TYPE_PIXEL_FMT, "pixel");
942 }
943
944 int av_opt_get_sample_fmt(void *obj, const char *name, int search_flags, enum AVSampleFormat *out_fmt)
945 {
946     return get_format(obj, name, search_flags, out_fmt, AV_OPT_TYPE_SAMPLE_FMT, "sample");
947 }
948
949 int av_opt_get_channel_layout(void *obj, const char *name, int search_flags, int64_t *cl)
950 {
951     void *dst, *target_obj;
952     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
953     if (!o || !target_obj)
954         return AVERROR_OPTION_NOT_FOUND;
955     if (o->type != AV_OPT_TYPE_CHANNEL_LAYOUT) {
956         av_log(obj, AV_LOG_ERROR,
957                "The value for option '%s' is not a channel layout.\n", name);
958         return AVERROR(EINVAL);
959     }
960
961     dst = ((uint8_t*)target_obj) + o->offset;
962     *cl = *(int64_t *)dst;
963     return 0;
964 }
965
966 int av_opt_get_dict_val(void *obj, const char *name, int search_flags, AVDictionary **out_val)
967 {
968     void *target_obj;
969     AVDictionary *src;
970     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
971
972     if (!o || !target_obj)
973         return AVERROR_OPTION_NOT_FOUND;
974     if (o->type != AV_OPT_TYPE_DICT)
975         return AVERROR(EINVAL);
976
977     src = *(AVDictionary **)(((uint8_t *)target_obj) + o->offset);
978     av_dict_copy(out_val, src, 0);
979
980     return 0;
981 }
982
983 int av_opt_flag_is_set(void *obj, const char *field_name, const char *flag_name)
984 {
985     const AVOption *field = av_opt_find(obj, field_name, NULL, 0, 0);
986     const AVOption *flag  = av_opt_find(obj, flag_name,
987                                         field ? field->unit : NULL, 0, 0);
988     int64_t res;
989
990     if (!field || !flag || flag->type != AV_OPT_TYPE_CONST ||
991         av_opt_get_int(obj, field_name, 0, &res) < 0)
992         return 0;
993     return res & flag->default_val.i64;
994 }
995
996 static void log_value(void *av_log_obj, int level, double d)
997 {
998     if      (d == INT_MAX) {
999         av_log(av_log_obj, level, "INT_MAX");
1000     } else if (d == INT_MIN) {
1001         av_log(av_log_obj, level, "INT_MIN");
1002     } else if (d == UINT32_MAX) {
1003         av_log(av_log_obj, level, "UINT32_MAX");
1004     } else if (d == (double)INT64_MAX) {
1005         av_log(av_log_obj, level, "I64_MAX");
1006     } else if (d == INT64_MIN) {
1007         av_log(av_log_obj, level, "I64_MIN");
1008     } else if (d == FLT_MAX) {
1009         av_log(av_log_obj, level, "FLT_MAX");
1010     } else if (d == FLT_MIN) {
1011         av_log(av_log_obj, level, "FLT_MIN");
1012     } else if (d == -FLT_MAX) {
1013         av_log(av_log_obj, level, "-FLT_MAX");
1014     } else if (d == -FLT_MIN) {
1015         av_log(av_log_obj, level, "-FLT_MIN");
1016     } else if (d == DBL_MAX) {
1017         av_log(av_log_obj, level, "DBL_MAX");
1018     } else if (d == DBL_MIN) {
1019         av_log(av_log_obj, level, "DBL_MIN");
1020     } else if (d == -DBL_MAX) {
1021         av_log(av_log_obj, level, "-DBL_MAX");
1022     } else if (d == -DBL_MIN) {
1023         av_log(av_log_obj, level, "-DBL_MIN");
1024     } else {
1025         av_log(av_log_obj, level, "%g", d);
1026     }
1027 }
1028
1029 static const char *get_opt_const_name(void *obj, const char *unit, int64_t value)
1030 {
1031     const AVOption *opt = NULL;
1032
1033     if (!unit)
1034         return NULL;
1035     while ((opt = av_opt_next(obj, opt)))
1036         if (opt->type == AV_OPT_TYPE_CONST && !strcmp(opt->unit, unit) &&
1037             opt->default_val.i64 == value)
1038             return opt->name;
1039     return NULL;
1040 }
1041
1042 static char *get_opt_flags_string(void *obj, const char *unit, int64_t value)
1043 {
1044     const AVOption *opt = NULL;
1045     char flags[512];
1046
1047     flags[0] = 0;
1048     if (!unit)
1049         return NULL;
1050     while ((opt = av_opt_next(obj, opt))) {
1051         if (opt->type == AV_OPT_TYPE_CONST && !strcmp(opt->unit, unit) &&
1052             opt->default_val.i64 & value) {
1053             if (flags[0])
1054                 av_strlcatf(flags, sizeof(flags), "+");
1055             av_strlcatf(flags, sizeof(flags), "%s", opt->name);
1056         }
1057     }
1058     if (flags[0])
1059         return av_strdup(flags);
1060     return NULL;
1061 }
1062
1063 static void opt_list(void *obj, void *av_log_obj, const char *unit,
1064                      int req_flags, int rej_flags)
1065 {
1066     const AVOption *opt = NULL;
1067     AVOptionRanges *r;
1068     int i;
1069
1070     while ((opt = av_opt_next(obj, opt))) {
1071         if (!(opt->flags & req_flags) || (opt->flags & rej_flags))
1072             continue;
1073
1074         /* Don't print CONST's on level one.
1075          * Don't print anything but CONST's on level two.
1076          * Only print items from the requested unit.
1077          */
1078         if (!unit && opt->type == AV_OPT_TYPE_CONST)
1079             continue;
1080         else if (unit && opt->type != AV_OPT_TYPE_CONST)
1081             continue;
1082         else if (unit && opt->type == AV_OPT_TYPE_CONST && strcmp(unit, opt->unit))
1083             continue;
1084         else if (unit && opt->type == AV_OPT_TYPE_CONST)
1085             av_log(av_log_obj, AV_LOG_INFO, "     %-15s ", opt->name);
1086         else
1087             av_log(av_log_obj, AV_LOG_INFO, "  %s%-17s ",
1088                    (opt->flags & AV_OPT_FLAG_FILTERING_PARAM) ? "" : "-",
1089                    opt->name);
1090
1091         switch (opt->type) {
1092             case AV_OPT_TYPE_FLAGS:
1093                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<flags>");
1094                 break;
1095             case AV_OPT_TYPE_INT:
1096                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<int>");
1097                 break;
1098             case AV_OPT_TYPE_INT64:
1099                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<int64>");
1100                 break;
1101             case AV_OPT_TYPE_DOUBLE:
1102                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<double>");
1103                 break;
1104             case AV_OPT_TYPE_FLOAT:
1105                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<float>");
1106                 break;
1107             case AV_OPT_TYPE_STRING:
1108                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<string>");
1109                 break;
1110             case AV_OPT_TYPE_RATIONAL:
1111                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<rational>");
1112                 break;
1113             case AV_OPT_TYPE_BINARY:
1114                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<binary>");
1115                 break;
1116             case AV_OPT_TYPE_IMAGE_SIZE:
1117                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<image_size>");
1118                 break;
1119             case AV_OPT_TYPE_VIDEO_RATE:
1120                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<video_rate>");
1121                 break;
1122             case AV_OPT_TYPE_PIXEL_FMT:
1123                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<pix_fmt>");
1124                 break;
1125             case AV_OPT_TYPE_SAMPLE_FMT:
1126                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<sample_fmt>");
1127                 break;
1128             case AV_OPT_TYPE_DURATION:
1129                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<duration>");
1130                 break;
1131             case AV_OPT_TYPE_COLOR:
1132                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<color>");
1133                 break;
1134             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1135                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<channel_layout>");
1136                 break;
1137             case AV_OPT_TYPE_BOOL:
1138                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<boolean>");
1139                 break;
1140             case AV_OPT_TYPE_CONST:
1141             default:
1142                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "");
1143                 break;
1144         }
1145         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_ENCODING_PARAM) ? 'E' : '.');
1146         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_DECODING_PARAM) ? 'D' : '.');
1147         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_FILTERING_PARAM)? 'F' : '.');
1148         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_VIDEO_PARAM   ) ? 'V' : '.');
1149         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_AUDIO_PARAM   ) ? 'A' : '.');
1150         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_SUBTITLE_PARAM) ? 'S' : '.');
1151         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_EXPORT)         ? 'X' : '.');
1152         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_READONLY)       ? 'R' : '.');
1153
1154         if (opt->help)
1155             av_log(av_log_obj, AV_LOG_INFO, " %s", opt->help);
1156
1157         if (av_opt_query_ranges(&r, obj, opt->name, AV_OPT_SEARCH_FAKE_OBJ) >= 0) {
1158             switch (opt->type) {
1159             case AV_OPT_TYPE_INT:
1160             case AV_OPT_TYPE_INT64:
1161             case AV_OPT_TYPE_DOUBLE:
1162             case AV_OPT_TYPE_FLOAT:
1163             case AV_OPT_TYPE_RATIONAL:
1164                 for (i = 0; i < r->nb_ranges; i++) {
1165                     av_log(av_log_obj, AV_LOG_INFO, " (from ");
1166                     log_value(av_log_obj, AV_LOG_INFO, r->range[i]->value_min);
1167                     av_log(av_log_obj, AV_LOG_INFO, " to ");
1168                     log_value(av_log_obj, AV_LOG_INFO, r->range[i]->value_max);
1169                     av_log(av_log_obj, AV_LOG_INFO, ")");
1170                 }
1171                 break;
1172             }
1173             av_opt_freep_ranges(&r);
1174         }
1175
1176         if (opt->type != AV_OPT_TYPE_CONST  &&
1177             opt->type != AV_OPT_TYPE_BINARY &&
1178                 !((opt->type == AV_OPT_TYPE_COLOR      ||
1179                    opt->type == AV_OPT_TYPE_IMAGE_SIZE ||
1180                    opt->type == AV_OPT_TYPE_STRING     ||
1181                    opt->type == AV_OPT_TYPE_VIDEO_RATE) &&
1182                   !opt->default_val.str)) {
1183             av_log(av_log_obj, AV_LOG_INFO, " (default ");
1184             switch (opt->type) {
1185             case AV_OPT_TYPE_BOOL:
1186                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(get_bool_name(opt->default_val.i64), "invalid"));
1187                 break;
1188             case AV_OPT_TYPE_FLAGS: {
1189                 char *def_flags = get_opt_flags_string(obj, opt->unit, opt->default_val.i64);
1190                 if (def_flags) {
1191                     av_log(av_log_obj, AV_LOG_INFO, "%s", def_flags);
1192                     av_freep(&def_flags);
1193                 } else {
1194                     av_log(av_log_obj, AV_LOG_INFO, "%"PRIX64, opt->default_val.i64);
1195                 }
1196                 break;
1197             }
1198             case AV_OPT_TYPE_DURATION: {
1199                 char buf[25];
1200                 format_duration(buf, sizeof(buf), opt->default_val.i64);
1201                 av_log(av_log_obj, AV_LOG_INFO, "%s", buf);
1202                 break;
1203             }
1204             case AV_OPT_TYPE_INT:
1205             case AV_OPT_TYPE_INT64: {
1206                 const char *def_const = get_opt_const_name(obj, opt->unit, opt->default_val.i64);
1207                 if (def_const)
1208                     av_log(av_log_obj, AV_LOG_INFO, "%s", def_const);
1209                 else
1210                     log_value(av_log_obj, AV_LOG_INFO, opt->default_val.i64);
1211                 break;
1212             }
1213             case AV_OPT_TYPE_DOUBLE:
1214             case AV_OPT_TYPE_FLOAT:
1215                 log_value(av_log_obj, AV_LOG_INFO, opt->default_val.dbl);
1216                 break;
1217             case AV_OPT_TYPE_RATIONAL: {
1218                 AVRational q = av_d2q(opt->default_val.dbl, INT_MAX);
1219                 av_log(av_log_obj, AV_LOG_INFO, "%d/%d", q.num, q.den); }
1220                 break;
1221             case AV_OPT_TYPE_PIXEL_FMT:
1222                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(av_get_pix_fmt_name(opt->default_val.i64), "none"));
1223                 break;
1224             case AV_OPT_TYPE_SAMPLE_FMT:
1225                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(av_get_sample_fmt_name(opt->default_val.i64), "none"));
1226                 break;
1227             case AV_OPT_TYPE_COLOR:
1228             case AV_OPT_TYPE_IMAGE_SIZE:
1229             case AV_OPT_TYPE_STRING:
1230             case AV_OPT_TYPE_VIDEO_RATE:
1231                 av_log(av_log_obj, AV_LOG_INFO, "\"%s\"", opt->default_val.str);
1232                 break;
1233             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1234                 av_log(av_log_obj, AV_LOG_INFO, "0x%"PRIx64, opt->default_val.i64);
1235                 break;
1236             }
1237             av_log(av_log_obj, AV_LOG_INFO, ")");
1238         }
1239
1240         av_log(av_log_obj, AV_LOG_INFO, "\n");
1241         if (opt->unit && opt->type != AV_OPT_TYPE_CONST)
1242             opt_list(obj, av_log_obj, opt->unit, req_flags, rej_flags);
1243     }
1244 }
1245
1246 int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
1247 {
1248     if (!obj)
1249         return -1;
1250
1251     av_log(av_log_obj, AV_LOG_INFO, "%s AVOptions:\n", (*(AVClass **)obj)->class_name);
1252
1253     opt_list(obj, av_log_obj, NULL, req_flags, rej_flags);
1254
1255     return 0;
1256 }
1257
1258 void av_opt_set_defaults(void *s)
1259 {
1260     av_opt_set_defaults2(s, 0, 0);
1261 }
1262
1263 void av_opt_set_defaults2(void *s, int mask, int flags)
1264 {
1265     const AVOption *opt = NULL;
1266     while ((opt = av_opt_next(s, opt))) {
1267         void *dst = ((uint8_t*)s) + opt->offset;
1268
1269         if ((opt->flags & mask) != flags)
1270             continue;
1271
1272         if (opt->flags & AV_OPT_FLAG_READONLY)
1273             continue;
1274
1275         switch (opt->type) {
1276             case AV_OPT_TYPE_CONST:
1277                 /* Nothing to be done here */
1278                 break;
1279             case AV_OPT_TYPE_BOOL:
1280             case AV_OPT_TYPE_FLAGS:
1281             case AV_OPT_TYPE_INT:
1282             case AV_OPT_TYPE_INT64:
1283             case AV_OPT_TYPE_DURATION:
1284             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1285             case AV_OPT_TYPE_PIXEL_FMT:
1286             case AV_OPT_TYPE_SAMPLE_FMT:
1287                 write_number(s, opt, dst, 1, 1, opt->default_val.i64);
1288                 break;
1289             case AV_OPT_TYPE_DOUBLE:
1290             case AV_OPT_TYPE_FLOAT: {
1291                 double val;
1292                 val = opt->default_val.dbl;
1293                 write_number(s, opt, dst, val, 1, 1);
1294             }
1295             break;
1296             case AV_OPT_TYPE_RATIONAL: {
1297                 AVRational val;
1298                 val = av_d2q(opt->default_val.dbl, INT_MAX);
1299                 write_number(s, opt, dst, 1, val.den, val.num);
1300             }
1301             break;
1302             case AV_OPT_TYPE_COLOR:
1303                 set_string_color(s, opt, opt->default_val.str, dst);
1304                 break;
1305             case AV_OPT_TYPE_STRING:
1306                 set_string(s, opt, opt->default_val.str, dst);
1307                 break;
1308             case AV_OPT_TYPE_IMAGE_SIZE:
1309                 set_string_image_size(s, opt, opt->default_val.str, dst);
1310                 break;
1311             case AV_OPT_TYPE_VIDEO_RATE:
1312                 set_string_video_rate(s, opt, opt->default_val.str, dst);
1313                 break;
1314             case AV_OPT_TYPE_BINARY:
1315                 set_string_binary(s, opt, opt->default_val.str, dst);
1316                 break;
1317             case AV_OPT_TYPE_DICT:
1318                 /* Cannot set defaults for these types */
1319             break;
1320         default:
1321             av_log(s, AV_LOG_DEBUG, "AVOption type %d of option %s not implemented yet\n",
1322                    opt->type, opt->name);
1323         }
1324     }
1325 }
1326
1327 /**
1328  * Store the value in the field in ctx that is named like key.
1329  * ctx must be an AVClass context, storing is done using AVOptions.
1330  *
1331  * @param buf the string to parse, buf will be updated to point at the
1332  * separator just after the parsed key/value pair
1333  * @param key_val_sep a 0-terminated list of characters used to
1334  * separate key from value
1335  * @param pairs_sep a 0-terminated list of characters used to separate
1336  * two pairs from each other
1337  * @return 0 if the key/value pair has been successfully parsed and
1338  * set, or a negative value corresponding to an AVERROR code in case
1339  * of error:
1340  * AVERROR(EINVAL) if the key/value pair cannot be parsed,
1341  * the error code issued by av_opt_set() if the key/value pair
1342  * cannot be set
1343  */
1344 static int parse_key_value_pair(void *ctx, const char **buf,
1345                                 const char *key_val_sep, const char *pairs_sep)
1346 {
1347     char *key = av_get_token(buf, key_val_sep);
1348     char *val;
1349     int ret;
1350
1351     if (!key)
1352         return AVERROR(ENOMEM);
1353
1354     if (*key && strspn(*buf, key_val_sep)) {
1355         (*buf)++;
1356         val = av_get_token(buf, pairs_sep);
1357         if (!val) {
1358             av_freep(&key);
1359             return AVERROR(ENOMEM);
1360         }
1361     } else {
1362         av_log(ctx, AV_LOG_ERROR, "Missing key or no key/value separator found after key '%s'\n", key);
1363         av_free(key);
1364         return AVERROR(EINVAL);
1365     }
1366
1367     av_log(ctx, AV_LOG_DEBUG, "Setting entry with key '%s' to value '%s'\n", key, val);
1368
1369     ret = av_opt_set(ctx, key, val, AV_OPT_SEARCH_CHILDREN);
1370     if (ret == AVERROR_OPTION_NOT_FOUND)
1371         av_log(ctx, AV_LOG_ERROR, "Key '%s' not found.\n", key);
1372
1373     av_free(key);
1374     av_free(val);
1375     return ret;
1376 }
1377
1378 int av_set_options_string(void *ctx, const char *opts,
1379                           const char *key_val_sep, const char *pairs_sep)
1380 {
1381     int ret, count = 0;
1382
1383     if (!opts)
1384         return 0;
1385
1386     while (*opts) {
1387         if ((ret = parse_key_value_pair(ctx, &opts, key_val_sep, pairs_sep)) < 0)
1388             return ret;
1389         count++;
1390
1391         if (*opts)
1392             opts++;
1393     }
1394
1395     return count;
1396 }
1397
1398 #define WHITESPACES " \n\t"
1399
1400 static int is_key_char(char c)
1401 {
1402     return (unsigned)((c | 32) - 'a') < 26 ||
1403            (unsigned)(c - '0') < 10 ||
1404            c == '-' || c == '_' || c == '/' || c == '.';
1405 }
1406
1407 /**
1408  * Read a key from a string.
1409  *
1410  * The key consists of is_key_char characters and must be terminated by a
1411  * character from the delim string; spaces are ignored.
1412  *
1413  * @return  0 for success (even with ellipsis), <0 for failure
1414  */
1415 static int get_key(const char **ropts, const char *delim, char **rkey)
1416 {
1417     const char *opts = *ropts;
1418     const char *key_start, *key_end;
1419
1420     key_start = opts += strspn(opts, WHITESPACES);
1421     while (is_key_char(*opts))
1422         opts++;
1423     key_end = opts;
1424     opts += strspn(opts, WHITESPACES);
1425     if (!*opts || !strchr(delim, *opts))
1426         return AVERROR(EINVAL);
1427     opts++;
1428     if (!(*rkey = av_malloc(key_end - key_start + 1)))
1429         return AVERROR(ENOMEM);
1430     memcpy(*rkey, key_start, key_end - key_start);
1431     (*rkey)[key_end - key_start] = 0;
1432     *ropts = opts;
1433     return 0;
1434 }
1435
1436 int av_opt_get_key_value(const char **ropts,
1437                          const char *key_val_sep, const char *pairs_sep,
1438                          unsigned flags,
1439                          char **rkey, char **rval)
1440 {
1441     int ret;
1442     char *key = NULL, *val;
1443     const char *opts = *ropts;
1444
1445     if ((ret = get_key(&opts, key_val_sep, &key)) < 0 &&
1446         !(flags & AV_OPT_FLAG_IMPLICIT_KEY))
1447         return AVERROR(EINVAL);
1448     if (!(val = av_get_token(&opts, pairs_sep))) {
1449         av_free(key);
1450         return AVERROR(ENOMEM);
1451     }
1452     *ropts = opts;
1453     *rkey  = key;
1454     *rval  = val;
1455     return 0;
1456 }
1457
1458 int av_opt_set_from_string(void *ctx, const char *opts,
1459                            const char *const *shorthand,
1460                            const char *key_val_sep, const char *pairs_sep)
1461 {
1462     int ret, count = 0;
1463     const char *dummy_shorthand = NULL;
1464     char *av_uninit(parsed_key), *av_uninit(value);
1465     const char *key;
1466
1467     if (!opts)
1468         return 0;
1469     if (!shorthand)
1470         shorthand = &dummy_shorthand;
1471
1472     while (*opts) {
1473         ret = av_opt_get_key_value(&opts, key_val_sep, pairs_sep,
1474                                    *shorthand ? AV_OPT_FLAG_IMPLICIT_KEY : 0,
1475                                    &parsed_key, &value);
1476         if (ret < 0) {
1477             if (ret == AVERROR(EINVAL))
1478                 av_log(ctx, AV_LOG_ERROR, "No option name near '%s'\n", opts);
1479             else
1480                 av_log(ctx, AV_LOG_ERROR, "Unable to parse '%s': %s\n", opts,
1481                        av_err2str(ret));
1482             return ret;
1483         }
1484         if (*opts)
1485             opts++;
1486         if (parsed_key) {
1487             key = parsed_key;
1488             while (*shorthand) /* discard all remaining shorthand */
1489                 shorthand++;
1490         } else {
1491             key = *(shorthand++);
1492         }
1493
1494         av_log(ctx, AV_LOG_DEBUG, "Setting '%s' to value '%s'\n", key, value);
1495         if ((ret = av_opt_set(ctx, key, value, 0)) < 0) {
1496             if (ret == AVERROR_OPTION_NOT_FOUND)
1497                 av_log(ctx, AV_LOG_ERROR, "Option '%s' not found\n", key);
1498             av_free(value);
1499             av_free(parsed_key);
1500             return ret;
1501         }
1502
1503         av_free(value);
1504         av_free(parsed_key);
1505         count++;
1506     }
1507     return count;
1508 }
1509
1510 void av_opt_free(void *obj)
1511 {
1512     const AVOption *o = NULL;
1513     while ((o = av_opt_next(obj, o))) {
1514         switch (o->type) {
1515         case AV_OPT_TYPE_STRING:
1516         case AV_OPT_TYPE_BINARY:
1517             av_freep((uint8_t *)obj + o->offset);
1518             break;
1519
1520         case AV_OPT_TYPE_DICT:
1521             av_dict_free((AVDictionary **)(((uint8_t *)obj) + o->offset));
1522             break;
1523
1524         default:
1525             break;
1526         }
1527     }
1528 }
1529
1530 int av_opt_set_dict2(void *obj, AVDictionary **options, int search_flags)
1531 {
1532     AVDictionaryEntry *t = NULL;
1533     AVDictionary    *tmp = NULL;
1534     int ret = 0;
1535
1536     if (!options)
1537         return 0;
1538
1539     while ((t = av_dict_get(*options, "", t, AV_DICT_IGNORE_SUFFIX))) {
1540         ret = av_opt_set(obj, t->key, t->value, search_flags);
1541         if (ret == AVERROR_OPTION_NOT_FOUND)
1542             ret = av_dict_set(&tmp, t->key, t->value, 0);
1543         if (ret < 0) {
1544             av_log(obj, AV_LOG_ERROR, "Error setting option %s to value %s.\n", t->key, t->value);
1545             av_dict_free(&tmp);
1546             return ret;
1547         }
1548         ret = 0;
1549     }
1550     av_dict_free(options);
1551     *options = tmp;
1552     return ret;
1553 }
1554
1555 int av_opt_set_dict(void *obj, AVDictionary **options)
1556 {
1557     return av_opt_set_dict2(obj, options, 0);
1558 }
1559
1560 const AVOption *av_opt_find(void *obj, const char *name, const char *unit,
1561                             int opt_flags, int search_flags)
1562 {
1563     return av_opt_find2(obj, name, unit, opt_flags, search_flags, NULL);
1564 }
1565
1566 const AVOption *av_opt_find2(void *obj, const char *name, const char *unit,
1567                              int opt_flags, int search_flags, void **target_obj)
1568 {
1569     const AVClass  *c;
1570     const AVOption *o = NULL;
1571
1572     if(!obj)
1573         return NULL;
1574
1575     c= *(AVClass**)obj;
1576
1577     if (!c)
1578         return NULL;
1579
1580     if (search_flags & AV_OPT_SEARCH_CHILDREN) {
1581         if (search_flags & AV_OPT_SEARCH_FAKE_OBJ) {
1582             const AVClass *child = NULL;
1583             while (child = av_opt_child_class_next(c, child))
1584                 if (o = av_opt_find2(&child, name, unit, opt_flags, search_flags, NULL))
1585                     return o;
1586         } else {
1587             void *child = NULL;
1588             while (child = av_opt_child_next(obj, child))
1589                 if (o = av_opt_find2(child, name, unit, opt_flags, search_flags, target_obj))
1590                     return o;
1591         }
1592     }
1593
1594     while (o = av_opt_next(obj, o)) {
1595         if (!strcmp(o->name, name) && (o->flags & opt_flags) == opt_flags &&
1596             ((!unit && o->type != AV_OPT_TYPE_CONST) ||
1597              (unit  && o->type == AV_OPT_TYPE_CONST && o->unit && !strcmp(o->unit, unit)))) {
1598             if (target_obj) {
1599                 if (!(search_flags & AV_OPT_SEARCH_FAKE_OBJ))
1600                     *target_obj = obj;
1601                 else
1602                     *target_obj = NULL;
1603             }
1604             return o;
1605         }
1606     }
1607     return NULL;
1608 }
1609
1610 void *av_opt_child_next(void *obj, void *prev)
1611 {
1612     const AVClass *c = *(AVClass **)obj;
1613     if (c->child_next)
1614         return c->child_next(obj, prev);
1615     return NULL;
1616 }
1617
1618 const AVClass *av_opt_child_class_next(const AVClass *parent, const AVClass *prev)
1619 {
1620     if (parent->child_class_next)
1621         return parent->child_class_next(prev);
1622     return NULL;
1623 }
1624
1625 void *av_opt_ptr(const AVClass *class, void *obj, const char *name)
1626 {
1627     const AVOption *opt= av_opt_find2(&class, name, NULL, 0, AV_OPT_SEARCH_FAKE_OBJ, NULL);
1628     if(!opt)
1629         return NULL;
1630     return (uint8_t*)obj + opt->offset;
1631 }
1632
1633 static int opt_size(enum AVOptionType type)
1634 {
1635     switch(type) {
1636     case AV_OPT_TYPE_BOOL:
1637     case AV_OPT_TYPE_INT:
1638     case AV_OPT_TYPE_FLAGS:
1639         return sizeof(int);
1640     case AV_OPT_TYPE_DURATION:
1641     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1642     case AV_OPT_TYPE_INT64:
1643         return sizeof(int64_t);
1644     case AV_OPT_TYPE_DOUBLE:
1645         return sizeof(double);
1646     case AV_OPT_TYPE_FLOAT:
1647         return sizeof(float);
1648     case AV_OPT_TYPE_STRING:
1649         return sizeof(uint8_t*);
1650     case AV_OPT_TYPE_VIDEO_RATE:
1651     case AV_OPT_TYPE_RATIONAL:
1652         return sizeof(AVRational);
1653     case AV_OPT_TYPE_BINARY:
1654         return sizeof(uint8_t*) + sizeof(int);
1655     case AV_OPT_TYPE_IMAGE_SIZE:
1656         return sizeof(int[2]);
1657     case AV_OPT_TYPE_PIXEL_FMT:
1658         return sizeof(enum AVPixelFormat);
1659     case AV_OPT_TYPE_SAMPLE_FMT:
1660         return sizeof(enum AVSampleFormat);
1661     case AV_OPT_TYPE_COLOR:
1662         return 4;
1663     }
1664     return AVERROR(EINVAL);
1665 }
1666
1667 int av_opt_copy(void *dst, const void *src)
1668 {
1669     const AVOption *o = NULL;
1670     const AVClass *c;
1671     int ret = 0;
1672
1673     if (!src)
1674         return AVERROR(EINVAL);
1675
1676     c = *(AVClass **)src;
1677     if (!c || c != *(AVClass **)dst)
1678         return AVERROR(EINVAL);
1679
1680     while ((o = av_opt_next(src, o))) {
1681         void *field_dst = (uint8_t *)dst + o->offset;
1682         void *field_src = (uint8_t *)src + o->offset;
1683         uint8_t **field_dst8 = (uint8_t **)field_dst;
1684         uint8_t **field_src8 = (uint8_t **)field_src;
1685
1686         if (o->type == AV_OPT_TYPE_STRING) {
1687             if (*field_dst8 != *field_src8)
1688                 av_freep(field_dst8);
1689             *field_dst8 = av_strdup(*field_src8);
1690             if (*field_src8 && !*field_dst8)
1691                 ret = AVERROR(ENOMEM);
1692         } else if (o->type == AV_OPT_TYPE_BINARY) {
1693             int len = *(int *)(field_src8 + 1);
1694             if (*field_dst8 != *field_src8)
1695                 av_freep(field_dst8);
1696             *field_dst8 = av_memdup(*field_src8, len);
1697             if (len && !*field_dst8) {
1698                 ret = AVERROR(ENOMEM);
1699                 len = 0;
1700             }
1701             *(int *)(field_dst8 + 1) = len;
1702         } else if (o->type == AV_OPT_TYPE_CONST) {
1703             // do nothing
1704         } else if (o->type == AV_OPT_TYPE_DICT) {
1705             AVDictionary **sdict = (AVDictionary **) field_src;
1706             AVDictionary **ddict = (AVDictionary **) field_dst;
1707             if (*sdict != *ddict)
1708                 av_dict_free(ddict);
1709             *ddict = NULL;
1710             av_dict_copy(ddict, *sdict, 0);
1711             if (av_dict_count(*sdict) != av_dict_count(*ddict))
1712                 ret = AVERROR(ENOMEM);
1713         } else {
1714             int size = opt_size(o->type);
1715             if (size < 0)
1716                 ret = size;
1717             else
1718                 memcpy(field_dst, field_src, size);
1719         }
1720     }
1721     return ret;
1722 }
1723
1724 int av_opt_query_ranges(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
1725 {
1726     int ret;
1727     const AVClass *c = *(AVClass**)obj;
1728     int (*callback)(AVOptionRanges **, void *obj, const char *key, int flags) = NULL;
1729
1730     if (c->version > (52 << 16 | 11 << 8))
1731         callback = c->query_ranges;
1732
1733     if (!callback)
1734         callback = av_opt_query_ranges_default;
1735
1736     ret = callback(ranges_arg, obj, key, flags);
1737     if (ret >= 0) {
1738         if (!(flags & AV_OPT_MULTI_COMPONENT_RANGE))
1739             ret = 1;
1740         (*ranges_arg)->nb_components = ret;
1741     }
1742     return ret;
1743 }
1744
1745 int av_opt_query_ranges_default(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
1746 {
1747     AVOptionRanges *ranges = av_mallocz(sizeof(*ranges));
1748     AVOptionRange **range_array = av_mallocz(sizeof(void*));
1749     AVOptionRange *range = av_mallocz(sizeof(*range));
1750     const AVOption *field = av_opt_find(obj, key, NULL, 0, flags);
1751     int ret;
1752
1753     *ranges_arg = NULL;
1754
1755     if (!ranges || !range || !range_array || !field) {
1756         ret = AVERROR(ENOMEM);
1757         goto fail;
1758     }
1759
1760     ranges->range = range_array;
1761     ranges->range[0] = range;
1762     ranges->nb_ranges = 1;
1763     ranges->nb_components = 1;
1764     range->is_range = 1;
1765     range->value_min = field->min;
1766     range->value_max = field->max;
1767
1768     switch (field->type) {
1769     case AV_OPT_TYPE_BOOL:
1770     case AV_OPT_TYPE_INT:
1771     case AV_OPT_TYPE_INT64:
1772     case AV_OPT_TYPE_PIXEL_FMT:
1773     case AV_OPT_TYPE_SAMPLE_FMT:
1774     case AV_OPT_TYPE_FLOAT:
1775     case AV_OPT_TYPE_DOUBLE:
1776     case AV_OPT_TYPE_DURATION:
1777     case AV_OPT_TYPE_COLOR:
1778     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1779         break;
1780     case AV_OPT_TYPE_STRING:
1781         range->component_min = 0;
1782         range->component_max = 0x10FFFF; // max unicode value
1783         range->value_min = -1;
1784         range->value_max = INT_MAX;
1785         break;
1786     case AV_OPT_TYPE_RATIONAL:
1787         range->component_min = INT_MIN;
1788         range->component_max = INT_MAX;
1789         break;
1790     case AV_OPT_TYPE_IMAGE_SIZE:
1791         range->component_min = 0;
1792         range->component_max = INT_MAX/128/8;
1793         range->value_min = 0;
1794         range->value_max = INT_MAX/8;
1795         break;
1796     case AV_OPT_TYPE_VIDEO_RATE:
1797         range->component_min = 1;
1798         range->component_max = INT_MAX;
1799         range->value_min = 1;
1800         range->value_max = INT_MAX;
1801         break;
1802     default:
1803         ret = AVERROR(ENOSYS);
1804         goto fail;
1805     }
1806
1807     *ranges_arg = ranges;
1808     return 1;
1809 fail:
1810     av_free(ranges);
1811     av_free(range);
1812     av_free(range_array);
1813     return ret;
1814 }
1815
1816 void av_opt_freep_ranges(AVOptionRanges **rangesp)
1817 {
1818     int i;
1819     AVOptionRanges *ranges = *rangesp;
1820
1821     if (!ranges)
1822         return;
1823
1824     for (i = 0; i < ranges->nb_ranges * ranges->nb_components; i++) {
1825         AVOptionRange *range = ranges->range[i];
1826         if (range) {
1827             av_freep(&range->str);
1828             av_freep(&ranges->range[i]);
1829         }
1830     }
1831     av_freep(&ranges->range);
1832     av_freep(rangesp);
1833 }
1834
1835 int av_opt_is_set_to_default(void *obj, const AVOption *o)
1836 {
1837     int64_t i64;
1838     double d, d2;
1839     float f;
1840     AVRational q;
1841     int ret, w, h;
1842     char *str;
1843     void *dst;
1844
1845     if (!o || !obj)
1846         return AVERROR(EINVAL);
1847
1848     dst = ((uint8_t*)obj) + o->offset;
1849
1850     switch (o->type) {
1851     case AV_OPT_TYPE_CONST:
1852         return 1;
1853     case AV_OPT_TYPE_BOOL:
1854     case AV_OPT_TYPE_FLAGS:
1855     case AV_OPT_TYPE_PIXEL_FMT:
1856     case AV_OPT_TYPE_SAMPLE_FMT:
1857     case AV_OPT_TYPE_INT:
1858     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1859     case AV_OPT_TYPE_DURATION:
1860     case AV_OPT_TYPE_INT64:
1861         read_number(o, dst, NULL, NULL, &i64);
1862         return o->default_val.i64 == i64;
1863     case AV_OPT_TYPE_STRING:
1864         str = *(char **)dst;
1865         if (str == o->default_val.str) //2 NULLs
1866             return 1;
1867         if (!str || !o->default_val.str) //1 NULL
1868             return 0;
1869         return !strcmp(str, o->default_val.str);
1870     case AV_OPT_TYPE_DOUBLE:
1871         read_number(o, dst, &d, NULL, NULL);
1872         return o->default_val.dbl == d;
1873     case AV_OPT_TYPE_FLOAT:
1874         read_number(o, dst, &d, NULL, NULL);
1875         f = o->default_val.dbl;
1876         d2 = f;
1877         return d2 == d;
1878     case AV_OPT_TYPE_RATIONAL:
1879         q = av_d2q(o->default_val.dbl, INT_MAX);
1880         return !av_cmp_q(*(AVRational*)dst, q);
1881     case AV_OPT_TYPE_BINARY: {
1882         struct {
1883             uint8_t *data;
1884             int size;
1885         } tmp = {0};
1886         int opt_size = *(int *)((void **)dst + 1);
1887         void *opt_ptr = *(void **)dst;
1888         if (!opt_size && (!o->default_val.str || !strlen(o->default_val.str)))
1889             return 1;
1890         if (!opt_size ||  !o->default_val.str || !strlen(o->default_val.str ))
1891             return 0;
1892         if (opt_size != strlen(o->default_val.str) / 2)
1893             return 0;
1894         ret = set_string_binary(NULL, NULL, o->default_val.str, &tmp.data);
1895         if (!ret)
1896             ret = !memcmp(opt_ptr, tmp.data, tmp.size);
1897         av_free(tmp.data);
1898         return ret;
1899     }
1900     case AV_OPT_TYPE_DICT:
1901         /* Binary and dict have not default support yet. Any pointer is not default. */
1902         return !!(*(void **)dst);
1903     case AV_OPT_TYPE_IMAGE_SIZE:
1904         if (!o->default_val.str || !strcmp(o->default_val.str, "none"))
1905             w = h = 0;
1906         else if ((ret = av_parse_video_size(&w, &h, o->default_val.str)) < 0)
1907             return ret;
1908         return (w == *(int *)dst) && (h == *((int *)dst+1));
1909     case AV_OPT_TYPE_VIDEO_RATE:
1910         q = (AVRational){0, 0};
1911         if (o->default_val.str) {
1912             if ((ret = av_parse_video_rate(&q, o->default_val.str)) < 0)
1913                 return ret;
1914         }
1915         return !av_cmp_q(*(AVRational*)dst, q);
1916     case AV_OPT_TYPE_COLOR: {
1917         uint8_t color[4] = {0, 0, 0, 0};
1918         if (o->default_val.str) {
1919             if ((ret = av_parse_color(color, o->default_val.str, -1, NULL)) < 0)
1920                 return ret;
1921         }
1922         return !memcmp(color, dst, sizeof(color));
1923     }
1924     default:
1925         av_log(obj, AV_LOG_WARNING, "Not supported option type: %d, option name: %s\n", o->type, o->name);
1926         break;
1927     }
1928     return AVERROR_PATCHWELCOME;
1929 }
1930
1931 int av_opt_is_set_to_default_by_name(void *obj, const char *name, int search_flags)
1932 {
1933     const AVOption *o;
1934     void *target;
1935     if (!obj)
1936         return AVERROR(EINVAL);
1937     o = av_opt_find2(obj, name, NULL, 0, search_flags, &target);
1938     if (!o)
1939         return AVERROR_OPTION_NOT_FOUND;
1940     return av_opt_is_set_to_default(target, o);
1941 }
1942
1943 int av_opt_serialize(void *obj, int opt_flags, int flags, char **buffer,
1944                      const char key_val_sep, const char pairs_sep)
1945 {
1946     const AVOption *o = NULL;
1947     uint8_t *buf;
1948     AVBPrint bprint;
1949     int ret, cnt = 0;
1950     const char special_chars[] = {pairs_sep, key_val_sep, '\0'};
1951
1952     if (pairs_sep == '\0' || key_val_sep == '\0' || pairs_sep == key_val_sep ||
1953         pairs_sep == '\\' || key_val_sep == '\\') {
1954         av_log(obj, AV_LOG_ERROR, "Invalid separator(s) found.");
1955         return AVERROR(EINVAL);
1956     }
1957
1958     if (!obj || !buffer)
1959         return AVERROR(EINVAL);
1960
1961     *buffer = NULL;
1962     av_bprint_init(&bprint, 64, AV_BPRINT_SIZE_UNLIMITED);
1963
1964     while (o = av_opt_next(obj, o)) {
1965         if (o->type == AV_OPT_TYPE_CONST)
1966             continue;
1967         if ((flags & AV_OPT_SERIALIZE_OPT_FLAGS_EXACT) && o->flags != opt_flags)
1968             continue;
1969         else if (((o->flags & opt_flags) != opt_flags))
1970             continue;
1971         if (flags & AV_OPT_SERIALIZE_SKIP_DEFAULTS && av_opt_is_set_to_default(obj, o) > 0)
1972             continue;
1973         if ((ret = av_opt_get(obj, o->name, 0, &buf)) < 0) {
1974             av_bprint_finalize(&bprint, NULL);
1975             return ret;
1976         }
1977         if (buf) {
1978             if (cnt++)
1979                 av_bprint_append_data(&bprint, &pairs_sep, 1);
1980             av_bprint_escape(&bprint, o->name, special_chars, AV_ESCAPE_MODE_BACKSLASH, 0);
1981             av_bprint_append_data(&bprint, &key_val_sep, 1);
1982             av_bprint_escape(&bprint, buf, special_chars, AV_ESCAPE_MODE_BACKSLASH, 0);
1983             av_freep(&buf);
1984         }
1985     }
1986     av_bprint_finalize(&bprint, buffer);
1987     return 0;
1988 }
1989
1990 #ifdef TEST
1991
1992 typedef struct TestContext {
1993     const AVClass *class;
1994     int num;
1995     int toggle;
1996     char *string;
1997     int flags;
1998     AVRational rational;
1999     AVRational video_rate;
2000     int w, h;
2001     enum AVPixelFormat pix_fmt;
2002     enum AVSampleFormat sample_fmt;
2003     int64_t duration;
2004     uint8_t color[4];
2005     int64_t channel_layout;
2006     void *binary;
2007     int binary_size;
2008     void *binary1;
2009     int binary_size1;
2010     void *binary2;
2011     int binary_size2;
2012     int64_t num64;
2013     float flt;
2014     double dbl;
2015     char *escape;
2016     int bool1;
2017     int bool2;
2018     int bool3;
2019 } TestContext;
2020
2021 #define OFFSET(x) offsetof(TestContext, x)
2022
2023 #define TEST_FLAG_COOL 01
2024 #define TEST_FLAG_LAME 02
2025 #define TEST_FLAG_MU   04
2026
2027 static const AVOption test_options[]= {
2028     {"num",        "set num",            OFFSET(num),            AV_OPT_TYPE_INT,            { .i64 = 0 },                      0,       100, 1 },
2029     {"toggle",     "set toggle",         OFFSET(toggle),         AV_OPT_TYPE_INT,            { .i64 = 1 },                      0,         1, 1 },
2030     {"rational",   "set rational",       OFFSET(rational),       AV_OPT_TYPE_RATIONAL,       { .dbl = 1 },                      0,        10, 1 },
2031     {"string",     "set string",         OFFSET(string),         AV_OPT_TYPE_STRING,         { .str = "default" },       CHAR_MIN,  CHAR_MAX, 1 },
2032     {"escape",     "set escape str",     OFFSET(escape),         AV_OPT_TYPE_STRING,         { .str = "\\=," },          CHAR_MIN,  CHAR_MAX, 1 },
2033     {"flags",      "set flags",          OFFSET(flags),          AV_OPT_TYPE_FLAGS,          { .i64 = 1 },                      0,   INT_MAX, 1, "flags" },
2034     {"cool",       "set cool flag",      0,                      AV_OPT_TYPE_CONST,          { .i64 = TEST_FLAG_COOL },   INT_MIN,   INT_MAX, 1, "flags" },
2035     {"lame",       "set lame flag",      0,                      AV_OPT_TYPE_CONST,          { .i64 = TEST_FLAG_LAME },   INT_MIN,   INT_MAX, 1, "flags" },
2036     {"mu",         "set mu flag",        0,                      AV_OPT_TYPE_CONST,          { .i64 = TEST_FLAG_MU },     INT_MIN,   INT_MAX, 1, "flags" },
2037     {"size",       "set size",           OFFSET(w),              AV_OPT_TYPE_IMAGE_SIZE,     { .str="200x300" },                0,         0, 1 },
2038     {"pix_fmt",    "set pixfmt",         OFFSET(pix_fmt),        AV_OPT_TYPE_PIXEL_FMT,      { .i64 = AV_PIX_FMT_0BGR },       -1,   INT_MAX, 1 },
2039     {"sample_fmt", "set samplefmt",      OFFSET(sample_fmt),     AV_OPT_TYPE_SAMPLE_FMT,     { .i64 = AV_SAMPLE_FMT_S16 },     -1,   INT_MAX, 1 },
2040     {"video_rate", "set videorate",      OFFSET(video_rate),     AV_OPT_TYPE_VIDEO_RATE,     { .str = "25" },                   0,         0, 1 },
2041     {"duration",   "set duration",       OFFSET(duration),       AV_OPT_TYPE_DURATION,       { .i64 = 1000 },                   0, INT64_MAX, 1 },
2042     {"color",      "set color",          OFFSET(color),          AV_OPT_TYPE_COLOR,          { .str = "pink" },                 0,         0, 1 },
2043     {"cl",         "set channel layout", OFFSET(channel_layout), AV_OPT_TYPE_CHANNEL_LAYOUT, { .i64 = AV_CH_LAYOUT_HEXAGONAL }, 0, INT64_MAX, 1 },
2044     {"bin",        "set binary value",   OFFSET(binary),         AV_OPT_TYPE_BINARY,         { .str="62696e00" },               0,         0, 1 },
2045     {"bin1",       "set binary value",   OFFSET(binary1),        AV_OPT_TYPE_BINARY,         { .str=NULL },                     0,         0, 1 },
2046     {"bin2",       "set binary value",   OFFSET(binary2),        AV_OPT_TYPE_BINARY,         { .str="" },                       0,         0, 1 },
2047     {"num64",      "set num 64bit",      OFFSET(num64),          AV_OPT_TYPE_INT64,          { .i64 = 1 },                      0,       100, 1 },
2048     {"flt",        "set float",          OFFSET(flt),            AV_OPT_TYPE_FLOAT,          { .dbl = 1.0 / 3 },                0,       100, 1 },
2049     {"dbl",        "set double",         OFFSET(dbl),            AV_OPT_TYPE_DOUBLE,         { .dbl = 1.0 / 3 },                0,       100, 1 },
2050     {"bool1",      "set boolean value",  OFFSET(bool1),          AV_OPT_TYPE_BOOL,           { .i64 = -1 },                    -1,         1, 1 },
2051     {"bool2",      "set boolean value",  OFFSET(bool2),          AV_OPT_TYPE_BOOL,           { .i64 = 1 },                     -1,         1, 1 },
2052     {"bool3",      "set boolean value",  OFFSET(bool3),          AV_OPT_TYPE_BOOL,           { .i64 = 0 },                      0,         1, 1 },
2053     { NULL },
2054 };
2055
2056 static const char *test_get_name(void *ctx)
2057 {
2058     return "test";
2059 }
2060
2061 static const AVClass test_class = {
2062     "TestContext",
2063     test_get_name,
2064     test_options
2065 };
2066
2067 static void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
2068 {
2069     vfprintf(stdout, fmt, vl);
2070 }
2071
2072 int main(void)
2073 {
2074     int i;
2075
2076     av_log_set_level(AV_LOG_DEBUG);
2077     av_log_set_callback(log_callback_help);
2078
2079     printf("Testing default values\n");
2080     {
2081         TestContext test_ctx = { 0 };
2082         test_ctx.class = &test_class;
2083         av_opt_set_defaults(&test_ctx);
2084
2085         printf("num=%d\n", test_ctx.num);
2086         printf("toggle=%d\n", test_ctx.toggle);
2087         printf("string=%s\n", test_ctx.string);
2088         printf("escape=%s\n", test_ctx.escape);
2089         printf("flags=%d\n", test_ctx.flags);
2090         printf("rational=%d/%d\n", test_ctx.rational.num, test_ctx.rational.den);
2091         printf("video_rate=%d/%d\n", test_ctx.video_rate.num, test_ctx.video_rate.den);
2092         printf("width=%d height=%d\n", test_ctx.w, test_ctx.h);
2093         printf("pix_fmt=%s\n", av_get_pix_fmt_name(test_ctx.pix_fmt));
2094         printf("sample_fmt=%s\n", av_get_sample_fmt_name(test_ctx.sample_fmt));
2095         printf("duration=%"PRId64"\n", test_ctx.duration);
2096         printf("color=%d %d %d %d\n", test_ctx.color[0], test_ctx.color[1], test_ctx.color[2], test_ctx.color[3]);
2097         printf("channel_layout=%"PRId64"=%"PRId64"\n", test_ctx.channel_layout, (int64_t)AV_CH_LAYOUT_HEXAGONAL);
2098         if (test_ctx.binary)
2099             printf("binary=%x %x %x %x\n", ((uint8_t*)test_ctx.binary)[0], ((uint8_t*)test_ctx.binary)[1], ((uint8_t*)test_ctx.binary)[2], ((uint8_t*)test_ctx.binary)[3]);
2100         printf("binary_size=%d\n", test_ctx.binary_size);
2101         printf("num64=%"PRId64"\n", test_ctx.num64);
2102         printf("flt=%.6f\n", test_ctx.flt);
2103         printf("dbl=%.6f\n", test_ctx.dbl);
2104
2105         av_opt_show2(&test_ctx, NULL, -1, 0);
2106
2107         av_opt_free(&test_ctx);
2108     }
2109
2110     printf("\nTesting av_opt_is_set_to_default()\n");
2111     {
2112         int ret;
2113         TestContext test_ctx = { 0 };
2114         const AVOption *o = NULL;
2115         test_ctx.class = &test_class;
2116
2117         av_log_set_level(AV_LOG_QUIET);
2118
2119         while (o = av_opt_next(&test_ctx, o)) {
2120             ret = av_opt_is_set_to_default_by_name(&test_ctx, o->name, 0);
2121             printf("name:%10s default:%d error:%s\n", o->name, !!ret, ret < 0 ? av_err2str(ret) : "");
2122         }
2123         av_opt_set_defaults(&test_ctx);
2124         while (o = av_opt_next(&test_ctx, o)) {
2125             ret = av_opt_is_set_to_default_by_name(&test_ctx, o->name, 0);
2126             printf("name:%10s default:%d error:%s\n", o->name, !!ret, ret < 0 ? av_err2str(ret) : "");
2127         }
2128         av_opt_free(&test_ctx);
2129     }
2130
2131     printf("\nTest av_opt_serialize()\n");
2132     {
2133         TestContext test_ctx = { 0 };
2134         char *buf;
2135         test_ctx.class = &test_class;
2136
2137         av_log_set_level(AV_LOG_QUIET);
2138
2139         av_opt_set_defaults(&test_ctx);
2140         if (av_opt_serialize(&test_ctx, 0, 0, &buf, '=', ',') >= 0) {
2141             printf("%s\n", buf);
2142             av_opt_free(&test_ctx);
2143             memset(&test_ctx, 0, sizeof(test_ctx));
2144             test_ctx.class = &test_class;
2145             av_set_options_string(&test_ctx, buf, "=", ",");
2146             av_free(buf);
2147             if (av_opt_serialize(&test_ctx, 0, 0, &buf, '=', ',') >= 0) {
2148                 printf("%s\n", buf);
2149                 av_free(buf);
2150             }
2151         }
2152         av_opt_free(&test_ctx);
2153     }
2154
2155     printf("\nTesting av_set_options_string()\n");
2156     {
2157         TestContext test_ctx = { 0 };
2158         static const char * const options[] = {
2159             "",
2160             ":",
2161             "=",
2162             "foo=:",
2163             ":=foo",
2164             "=foo",
2165             "foo=",
2166             "foo",
2167             "foo=val",
2168             "foo==val",
2169             "toggle=:",
2170             "string=:",
2171             "toggle=1 : foo",
2172             "toggle=100",
2173             "toggle==1",
2174             "flags=+mu-lame : num=42: toggle=0",
2175             "num=42 : string=blahblah",
2176             "rational=0 : rational=1/2 : rational=1/-1",
2177             "rational=-1/0",
2178             "size=1024x768",
2179             "size=pal",
2180             "size=bogus",
2181             "pix_fmt=yuv420p",
2182             "pix_fmt=2",
2183             "pix_fmt=bogus",
2184             "sample_fmt=s16",
2185             "sample_fmt=2",
2186             "sample_fmt=bogus",
2187             "video_rate=pal",
2188             "video_rate=25",
2189             "video_rate=30000/1001",
2190             "video_rate=30/1.001",
2191             "video_rate=bogus",
2192             "duration=bogus",
2193             "duration=123.45",
2194             "duration=1\\:23\\:45.67",
2195             "color=blue",
2196             "color=0x223300",
2197             "color=0x42FF07AA",
2198             "cl=stereo+downmix",
2199             "cl=foo",
2200             "bin=boguss",
2201             "bin=111",
2202             "bin=ffff",
2203             "num64=bogus",
2204             "num64=44",
2205             "num64=44.4",
2206             "num64=-1",
2207             "num64=101",
2208             "flt=bogus",
2209             "flt=2",
2210             "flt=2.2",
2211             "flt=-1",
2212             "flt=101",
2213             "dbl=bogus",
2214             "dbl=2",
2215             "dbl=2.2",
2216             "dbl=-1",
2217             "dbl=101",
2218             "bool1=true",
2219             "bool2=auto",
2220         };
2221
2222         test_ctx.class = &test_class;
2223         av_opt_set_defaults(&test_ctx);
2224
2225         av_log_set_level(AV_LOG_QUIET);
2226
2227         for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
2228             int silence_log = !strcmp(options[i], "rational=-1/0"); // inf formating differs between platforms
2229             av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
2230             if (silence_log)
2231                 av_log_set_callback(NULL);
2232             if (av_set_options_string(&test_ctx, options[i], "=", ":") < 0)
2233                 printf("Error '%s'\n", options[i]);
2234             else
2235                 printf("OK    '%s'\n", options[i]);
2236             av_log_set_callback(log_callback_help);
2237         }
2238         av_opt_free(&test_ctx);
2239     }
2240
2241     printf("\nTesting av_opt_set_from_string()\n");
2242     {
2243         TestContext test_ctx = { 0 };
2244         static const char * const options[] = {
2245             "",
2246             "5",
2247             "5:hello",
2248             "5:hello:size=pal",
2249             "5:size=pal:hello",
2250             ":",
2251             "=",
2252             " 5 : hello : size = pal ",
2253             "a_very_long_option_name_that_will_need_to_be_ellipsized_around_here=42"
2254         };
2255         static const char * const shorthand[] = { "num", "string", NULL };
2256
2257         test_ctx.class = &test_class;
2258         av_opt_set_defaults(&test_ctx);
2259
2260         av_log_set_level(AV_LOG_QUIET);
2261
2262         for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
2263             av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
2264             if (av_opt_set_from_string(&test_ctx, options[i], shorthand, "=", ":") < 0)
2265                 printf("Error '%s'\n", options[i]);
2266             else
2267                 printf("OK    '%s'\n", options[i]);
2268         }
2269         av_opt_free(&test_ctx);
2270     }
2271
2272     return 0;
2273 }
2274
2275 #endif