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