avutil/opt: display a better default value for int/int64 options
[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 const char *get_opt_const_name(void *obj, const char *unit, int64_t value)
932 {
933     const AVOption *opt = NULL;
934
935     if (!unit)
936         return NULL;
937     while ((opt = av_opt_next(obj, opt)))
938         if (opt->type == AV_OPT_TYPE_CONST && !strcmp(opt->unit, unit) &&
939             opt->default_val.i64 == value)
940             return opt->name;
941     return NULL;
942 }
943
944 static void opt_list(void *obj, void *av_log_obj, const char *unit,
945                      int req_flags, int rej_flags)
946 {
947     const AVOption *opt=NULL;
948     AVOptionRanges *r;
949     int i;
950
951     while ((opt = av_opt_next(obj, opt))) {
952         if (!(opt->flags & req_flags) || (opt->flags & rej_flags))
953             continue;
954
955         /* Don't print CONST's on level one.
956          * Don't print anything but CONST's on level two.
957          * Only print items from the requested unit.
958          */
959         if (!unit && opt->type==AV_OPT_TYPE_CONST)
960             continue;
961         else if (unit && opt->type!=AV_OPT_TYPE_CONST)
962             continue;
963         else if (unit && opt->type==AV_OPT_TYPE_CONST && strcmp(unit, opt->unit))
964             continue;
965         else if (unit && opt->type == AV_OPT_TYPE_CONST)
966             av_log(av_log_obj, AV_LOG_INFO, "     %-15s ", opt->name);
967         else
968             av_log(av_log_obj, AV_LOG_INFO, "  %s%-17s ",
969                    (opt->flags & AV_OPT_FLAG_FILTERING_PARAM) ? "" : "-",
970                    opt->name);
971
972         switch (opt->type) {
973             case AV_OPT_TYPE_FLAGS:
974                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<flags>");
975                 break;
976             case AV_OPT_TYPE_INT:
977                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<int>");
978                 break;
979             case AV_OPT_TYPE_INT64:
980                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<int64>");
981                 break;
982             case AV_OPT_TYPE_DOUBLE:
983                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<double>");
984                 break;
985             case AV_OPT_TYPE_FLOAT:
986                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<float>");
987                 break;
988             case AV_OPT_TYPE_STRING:
989                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<string>");
990                 break;
991             case AV_OPT_TYPE_RATIONAL:
992                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<rational>");
993                 break;
994             case AV_OPT_TYPE_BINARY:
995                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<binary>");
996                 break;
997             case AV_OPT_TYPE_IMAGE_SIZE:
998                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<image_size>");
999                 break;
1000             case AV_OPT_TYPE_VIDEO_RATE:
1001                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<video_rate>");
1002                 break;
1003             case AV_OPT_TYPE_PIXEL_FMT:
1004                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<pix_fmt>");
1005                 break;
1006             case AV_OPT_TYPE_SAMPLE_FMT:
1007                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<sample_fmt>");
1008                 break;
1009             case AV_OPT_TYPE_DURATION:
1010                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<duration>");
1011                 break;
1012             case AV_OPT_TYPE_COLOR:
1013                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<color>");
1014                 break;
1015             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1016                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<channel_layout>");
1017                 break;
1018             case AV_OPT_TYPE_BOOL:
1019                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<boolean>");
1020                 break;
1021             case AV_OPT_TYPE_CONST:
1022             default:
1023                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "");
1024                 break;
1025         }
1026         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_ENCODING_PARAM) ? 'E' : '.');
1027         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_DECODING_PARAM) ? 'D' : '.');
1028         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_FILTERING_PARAM)? 'F' : '.');
1029         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_VIDEO_PARAM   ) ? 'V' : '.');
1030         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_AUDIO_PARAM   ) ? 'A' : '.');
1031         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_SUBTITLE_PARAM) ? 'S' : '.');
1032         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_EXPORT)         ? 'X' : '.');
1033         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_READONLY)       ? 'R' : '.');
1034
1035         if (opt->help)
1036             av_log(av_log_obj, AV_LOG_INFO, " %s", opt->help);
1037
1038         if (av_opt_query_ranges(&r, obj, opt->name, AV_OPT_SEARCH_FAKE_OBJ) >= 0) {
1039             switch (opt->type) {
1040             case AV_OPT_TYPE_INT:
1041             case AV_OPT_TYPE_INT64:
1042             case AV_OPT_TYPE_DOUBLE:
1043             case AV_OPT_TYPE_FLOAT:
1044             case AV_OPT_TYPE_RATIONAL:
1045                 for (i = 0; i < r->nb_ranges; i++) {
1046                     av_log(av_log_obj, AV_LOG_INFO, " (from ");
1047                     log_value(av_log_obj, AV_LOG_INFO, r->range[i]->value_min);
1048                     av_log(av_log_obj, AV_LOG_INFO, " to ");
1049                     log_value(av_log_obj, AV_LOG_INFO, r->range[i]->value_max);
1050                     av_log(av_log_obj, AV_LOG_INFO, ")");
1051                 }
1052                 break;
1053             }
1054             av_opt_freep_ranges(&r);
1055         }
1056
1057         if (opt->type != AV_OPT_TYPE_CONST  &&
1058             opt->type != AV_OPT_TYPE_BINARY &&
1059                 !((opt->type == AV_OPT_TYPE_COLOR      ||
1060                    opt->type == AV_OPT_TYPE_IMAGE_SIZE ||
1061                    opt->type == AV_OPT_TYPE_STRING     ||
1062                    opt->type == AV_OPT_TYPE_VIDEO_RATE) &&
1063                   !opt->default_val.str)) {
1064             av_log(av_log_obj, AV_LOG_INFO, " (default ");
1065             switch (opt->type) {
1066             case AV_OPT_TYPE_BOOL:
1067                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(get_bool_name(opt->default_val.i64), "invalid"));
1068                 break;
1069             case AV_OPT_TYPE_FLAGS:
1070                 av_log(av_log_obj, AV_LOG_INFO, "%"PRIX64, opt->default_val.i64);
1071                 break;
1072             case AV_OPT_TYPE_DURATION:
1073                 log_value(av_log_obj, AV_LOG_INFO, opt->default_val.i64);
1074                 break;
1075             case AV_OPT_TYPE_INT:
1076             case AV_OPT_TYPE_INT64: {
1077                 const char *def_const = get_opt_const_name(obj, opt->unit, opt->default_val.i64);
1078                 if (def_const)
1079                     av_log(av_log_obj, AV_LOG_INFO, "%s", def_const);
1080                 else
1081                     log_value(av_log_obj, AV_LOG_INFO, opt->default_val.i64);
1082                 break;
1083             }
1084             case AV_OPT_TYPE_DOUBLE:
1085             case AV_OPT_TYPE_FLOAT:
1086                 log_value(av_log_obj, AV_LOG_INFO, opt->default_val.dbl);
1087                 break;
1088             case AV_OPT_TYPE_RATIONAL: {
1089                 AVRational q = av_d2q(opt->default_val.dbl, INT_MAX);
1090                 av_log(av_log_obj, AV_LOG_INFO, "%d/%d", q.num, q.den); }
1091                 break;
1092             case AV_OPT_TYPE_PIXEL_FMT:
1093                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(av_get_pix_fmt_name(opt->default_val.i64), "none"));
1094                 break;
1095             case AV_OPT_TYPE_SAMPLE_FMT:
1096                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(av_get_sample_fmt_name(opt->default_val.i64), "none"));
1097                 break;
1098             case AV_OPT_TYPE_COLOR:
1099             case AV_OPT_TYPE_IMAGE_SIZE:
1100             case AV_OPT_TYPE_STRING:
1101             case AV_OPT_TYPE_VIDEO_RATE:
1102                 av_log(av_log_obj, AV_LOG_INFO, "\"%s\"", opt->default_val.str);
1103                 break;
1104             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1105                 av_log(av_log_obj, AV_LOG_INFO, "0x%"PRIx64, opt->default_val.i64);
1106                 break;
1107             }
1108             av_log(av_log_obj, AV_LOG_INFO, ")");
1109         }
1110
1111         av_log(av_log_obj, AV_LOG_INFO, "\n");
1112         if (opt->unit && opt->type != AV_OPT_TYPE_CONST) {
1113             opt_list(obj, av_log_obj, opt->unit, req_flags, rej_flags);
1114         }
1115     }
1116 }
1117
1118 int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
1119 {
1120     if (!obj)
1121         return -1;
1122
1123     av_log(av_log_obj, AV_LOG_INFO, "%s AVOptions:\n", (*(AVClass**)obj)->class_name);
1124
1125     opt_list(obj, av_log_obj, NULL, req_flags, rej_flags);
1126
1127     return 0;
1128 }
1129
1130 void av_opt_set_defaults(void *s)
1131 {
1132     av_opt_set_defaults2(s, 0, 0);
1133 }
1134
1135 void av_opt_set_defaults2(void *s, int mask, int flags)
1136 {
1137     const AVOption *opt = NULL;
1138     while ((opt = av_opt_next(s, opt))) {
1139         void *dst = ((uint8_t*)s) + opt->offset;
1140
1141         if ((opt->flags & mask) != flags)
1142             continue;
1143
1144         if (opt->flags & AV_OPT_FLAG_READONLY)
1145             continue;
1146
1147         switch (opt->type) {
1148             case AV_OPT_TYPE_CONST:
1149                 /* Nothing to be done here */
1150             break;
1151             case AV_OPT_TYPE_BOOL:
1152             case AV_OPT_TYPE_FLAGS:
1153             case AV_OPT_TYPE_INT:
1154             case AV_OPT_TYPE_INT64:
1155             case AV_OPT_TYPE_DURATION:
1156             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1157             case AV_OPT_TYPE_PIXEL_FMT:
1158             case AV_OPT_TYPE_SAMPLE_FMT:
1159                 write_number(s, opt, dst, 1, 1, opt->default_val.i64);
1160                 break;
1161             case AV_OPT_TYPE_DOUBLE:
1162             case AV_OPT_TYPE_FLOAT: {
1163                 double val;
1164                 val = opt->default_val.dbl;
1165                 write_number(s, opt, dst, val, 1, 1);
1166             }
1167             break;
1168             case AV_OPT_TYPE_RATIONAL: {
1169                 AVRational val;
1170                 val = av_d2q(opt->default_val.dbl, INT_MAX);
1171                 write_number(s, opt, dst, 1, val.den, val.num);
1172             }
1173             break;
1174             case AV_OPT_TYPE_COLOR:
1175                 set_string_color(s, opt, opt->default_val.str, dst);
1176                 break;
1177             case AV_OPT_TYPE_STRING:
1178                 set_string(s, opt, opt->default_val.str, dst);
1179                 break;
1180             case AV_OPT_TYPE_IMAGE_SIZE:
1181                 set_string_image_size(s, opt, opt->default_val.str, dst);
1182                 break;
1183             case AV_OPT_TYPE_VIDEO_RATE:
1184                 set_string_video_rate(s, opt, opt->default_val.str, dst);
1185                 break;
1186             case AV_OPT_TYPE_BINARY:
1187                 set_string_binary(s, opt, opt->default_val.str, dst);
1188                 break;
1189             case AV_OPT_TYPE_DICT:
1190                 /* Cannot set defaults for these types */
1191             break;
1192             default:
1193                 av_log(s, AV_LOG_DEBUG, "AVOption type %d of option %s not implemented yet\n", opt->type, opt->name);
1194         }
1195     }
1196 }
1197
1198 /**
1199  * Store the value in the field in ctx that is named like key.
1200  * ctx must be an AVClass context, storing is done using AVOptions.
1201  *
1202  * @param buf the string to parse, buf will be updated to point at the
1203  * separator just after the parsed key/value pair
1204  * @param key_val_sep a 0-terminated list of characters used to
1205  * separate key from value
1206  * @param pairs_sep a 0-terminated list of characters used to separate
1207  * two pairs from each other
1208  * @return 0 if the key/value pair has been successfully parsed and
1209  * set, or a negative value corresponding to an AVERROR code in case
1210  * of error:
1211  * AVERROR(EINVAL) if the key/value pair cannot be parsed,
1212  * the error code issued by av_opt_set() if the key/value pair
1213  * cannot be set
1214  */
1215 static int parse_key_value_pair(void *ctx, const char **buf,
1216                                 const char *key_val_sep, const char *pairs_sep)
1217 {
1218     char *key = av_get_token(buf, key_val_sep);
1219     char *val;
1220     int ret;
1221
1222     if (!key)
1223         return AVERROR(ENOMEM);
1224
1225     if (*key && strspn(*buf, key_val_sep)) {
1226         (*buf)++;
1227         val = av_get_token(buf, pairs_sep);
1228         if (!val) {
1229             av_freep(&key);
1230             return AVERROR(ENOMEM);
1231         }
1232     } else {
1233         av_log(ctx, AV_LOG_ERROR, "Missing key or no key/value separator found after key '%s'\n", key);
1234         av_free(key);
1235         return AVERROR(EINVAL);
1236     }
1237
1238     av_log(ctx, AV_LOG_DEBUG, "Setting entry with key '%s' to value '%s'\n", key, val);
1239
1240     ret = av_opt_set(ctx, key, val, AV_OPT_SEARCH_CHILDREN);
1241     if (ret == AVERROR_OPTION_NOT_FOUND)
1242         av_log(ctx, AV_LOG_ERROR, "Key '%s' not found.\n", key);
1243
1244     av_free(key);
1245     av_free(val);
1246     return ret;
1247 }
1248
1249 int av_set_options_string(void *ctx, const char *opts,
1250                           const char *key_val_sep, const char *pairs_sep)
1251 {
1252     int ret, count = 0;
1253
1254     if (!opts)
1255         return 0;
1256
1257     while (*opts) {
1258         if ((ret = parse_key_value_pair(ctx, &opts, key_val_sep, pairs_sep)) < 0)
1259             return ret;
1260         count++;
1261
1262         if (*opts)
1263             opts++;
1264     }
1265
1266     return count;
1267 }
1268
1269 #define WHITESPACES " \n\t"
1270
1271 static int is_key_char(char c)
1272 {
1273     return (unsigned)((c | 32) - 'a') < 26 ||
1274            (unsigned)(c - '0') < 10 ||
1275            c == '-' || c == '_' || c == '/' || c == '.';
1276 }
1277
1278 /**
1279  * Read a key from a string.
1280  *
1281  * The key consists of is_key_char characters and must be terminated by a
1282  * character from the delim string; spaces are ignored.
1283  *
1284  * @return  0 for success (even with ellipsis), <0 for failure
1285  */
1286 static int get_key(const char **ropts, const char *delim, char **rkey)
1287 {
1288     const char *opts = *ropts;
1289     const char *key_start, *key_end;
1290
1291     key_start = opts += strspn(opts, WHITESPACES);
1292     while (is_key_char(*opts))
1293         opts++;
1294     key_end = opts;
1295     opts += strspn(opts, WHITESPACES);
1296     if (!*opts || !strchr(delim, *opts))
1297         return AVERROR(EINVAL);
1298     opts++;
1299     if (!(*rkey = av_malloc(key_end - key_start + 1)))
1300         return AVERROR(ENOMEM);
1301     memcpy(*rkey, key_start, key_end - key_start);
1302     (*rkey)[key_end - key_start] = 0;
1303     *ropts = opts;
1304     return 0;
1305 }
1306
1307 int av_opt_get_key_value(const char **ropts,
1308                          const char *key_val_sep, const char *pairs_sep,
1309                          unsigned flags,
1310                          char **rkey, char **rval)
1311 {
1312     int ret;
1313     char *key = NULL, *val;
1314     const char *opts = *ropts;
1315
1316     if ((ret = get_key(&opts, key_val_sep, &key)) < 0 &&
1317         !(flags & AV_OPT_FLAG_IMPLICIT_KEY))
1318         return AVERROR(EINVAL);
1319     if (!(val = av_get_token(&opts, pairs_sep))) {
1320         av_free(key);
1321         return AVERROR(ENOMEM);
1322     }
1323     *ropts = opts;
1324     *rkey  = key;
1325     *rval  = val;
1326     return 0;
1327 }
1328
1329 int av_opt_set_from_string(void *ctx, const char *opts,
1330                            const char *const *shorthand,
1331                            const char *key_val_sep, const char *pairs_sep)
1332 {
1333     int ret, count = 0;
1334     const char *dummy_shorthand = NULL;
1335     char *av_uninit(parsed_key), *av_uninit(value);
1336     const char *key;
1337
1338     if (!opts)
1339         return 0;
1340     if (!shorthand)
1341         shorthand = &dummy_shorthand;
1342
1343     while (*opts) {
1344         ret = av_opt_get_key_value(&opts, key_val_sep, pairs_sep,
1345                                    *shorthand ? AV_OPT_FLAG_IMPLICIT_KEY : 0,
1346                                    &parsed_key, &value);
1347         if (ret < 0) {
1348             if (ret == AVERROR(EINVAL))
1349                 av_log(ctx, AV_LOG_ERROR, "No option name near '%s'\n", opts);
1350             else
1351                 av_log(ctx, AV_LOG_ERROR, "Unable to parse '%s': %s\n", opts,
1352                        av_err2str(ret));
1353             return ret;
1354         }
1355         if (*opts)
1356             opts++;
1357         if (parsed_key) {
1358             key = parsed_key;
1359             while (*shorthand) /* discard all remaining shorthand */
1360                 shorthand++;
1361         } else {
1362             key = *(shorthand++);
1363         }
1364
1365         av_log(ctx, AV_LOG_DEBUG, "Setting '%s' to value '%s'\n", key, value);
1366         if ((ret = av_opt_set(ctx, key, value, 0)) < 0) {
1367             if (ret == AVERROR_OPTION_NOT_FOUND)
1368                 av_log(ctx, AV_LOG_ERROR, "Option '%s' not found\n", key);
1369             av_free(value);
1370             av_free(parsed_key);
1371             return ret;
1372         }
1373
1374         av_free(value);
1375         av_free(parsed_key);
1376         count++;
1377     }
1378     return count;
1379 }
1380
1381 void av_opt_free(void *obj)
1382 {
1383     const AVOption *o = NULL;
1384     while ((o = av_opt_next(obj, o))) {
1385         switch (o->type) {
1386         case AV_OPT_TYPE_STRING:
1387         case AV_OPT_TYPE_BINARY:
1388             av_freep((uint8_t *)obj + o->offset);
1389             break;
1390
1391         case AV_OPT_TYPE_DICT:
1392             av_dict_free((AVDictionary **)(((uint8_t *)obj) + o->offset));
1393             break;
1394
1395         default:
1396             break;
1397         }
1398     }
1399 }
1400
1401 int av_opt_set_dict2(void *obj, AVDictionary **options, int search_flags)
1402 {
1403     AVDictionaryEntry *t = NULL;
1404     AVDictionary    *tmp = NULL;
1405     int ret = 0;
1406
1407     if (!options)
1408         return 0;
1409
1410     while ((t = av_dict_get(*options, "", t, AV_DICT_IGNORE_SUFFIX))) {
1411         ret = av_opt_set(obj, t->key, t->value, search_flags);
1412         if (ret == AVERROR_OPTION_NOT_FOUND)
1413             av_dict_set(&tmp, t->key, t->value, 0);
1414         else if (ret < 0) {
1415             av_log(obj, AV_LOG_ERROR, "Error setting option %s to value %s.\n", t->key, t->value);
1416             break;
1417         }
1418         ret = 0;
1419     }
1420     av_dict_free(options);
1421     *options = tmp;
1422     return ret;
1423 }
1424
1425 int av_opt_set_dict(void *obj, AVDictionary **options)
1426 {
1427     return av_opt_set_dict2(obj, options, 0);
1428 }
1429
1430 const AVOption *av_opt_find(void *obj, const char *name, const char *unit,
1431                             int opt_flags, int search_flags)
1432 {
1433     return av_opt_find2(obj, name, unit, opt_flags, search_flags, NULL);
1434 }
1435
1436 const AVOption *av_opt_find2(void *obj, const char *name, const char *unit,
1437                              int opt_flags, int search_flags, void **target_obj)
1438 {
1439     const AVClass  *c;
1440     const AVOption *o = NULL;
1441
1442     if(!obj)
1443         return NULL;
1444
1445     c= *(AVClass**)obj;
1446
1447     if (!c)
1448         return NULL;
1449
1450     if (search_flags & AV_OPT_SEARCH_CHILDREN) {
1451         if (search_flags & AV_OPT_SEARCH_FAKE_OBJ) {
1452             const AVClass *child = NULL;
1453             while (child = av_opt_child_class_next(c, child))
1454                 if (o = av_opt_find2(&child, name, unit, opt_flags, search_flags, NULL))
1455                     return o;
1456         } else {
1457             void *child = NULL;
1458             while (child = av_opt_child_next(obj, child))
1459                 if (o = av_opt_find2(child, name, unit, opt_flags, search_flags, target_obj))
1460                     return o;
1461         }
1462     }
1463
1464     while (o = av_opt_next(obj, o)) {
1465         if (!strcmp(o->name, name) && (o->flags & opt_flags) == opt_flags &&
1466             ((!unit && o->type != AV_OPT_TYPE_CONST) ||
1467              (unit  && o->type == AV_OPT_TYPE_CONST && o->unit && !strcmp(o->unit, unit)))) {
1468             if (target_obj) {
1469                 if (!(search_flags & AV_OPT_SEARCH_FAKE_OBJ))
1470                     *target_obj = obj;
1471                 else
1472                     *target_obj = NULL;
1473             }
1474             return o;
1475         }
1476     }
1477     return NULL;
1478 }
1479
1480 void *av_opt_child_next(void *obj, void *prev)
1481 {
1482     const AVClass *c = *(AVClass**)obj;
1483     if (c->child_next)
1484         return c->child_next(obj, prev);
1485     return NULL;
1486 }
1487
1488 const AVClass *av_opt_child_class_next(const AVClass *parent, const AVClass *prev)
1489 {
1490     if (parent->child_class_next)
1491         return parent->child_class_next(prev);
1492     return NULL;
1493 }
1494
1495 void *av_opt_ptr(const AVClass *class, void *obj, const char *name)
1496 {
1497     const AVOption *opt= av_opt_find2(&class, name, NULL, 0, AV_OPT_SEARCH_FAKE_OBJ, NULL);
1498     if(!opt)
1499         return NULL;
1500     return (uint8_t*)obj + opt->offset;
1501 }
1502
1503 static int opt_size(enum AVOptionType type)
1504 {
1505     switch(type) {
1506     case AV_OPT_TYPE_BOOL:
1507     case AV_OPT_TYPE_INT:
1508     case AV_OPT_TYPE_FLAGS:     return sizeof(int);
1509     case AV_OPT_TYPE_DURATION:
1510     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1511     case AV_OPT_TYPE_INT64:     return sizeof(int64_t);
1512     case AV_OPT_TYPE_DOUBLE:    return sizeof(double);
1513     case AV_OPT_TYPE_FLOAT:     return sizeof(float);
1514     case AV_OPT_TYPE_STRING:    return sizeof(uint8_t*);
1515     case AV_OPT_TYPE_VIDEO_RATE:
1516     case AV_OPT_TYPE_RATIONAL:  return sizeof(AVRational);
1517     case AV_OPT_TYPE_BINARY:    return sizeof(uint8_t*) + sizeof(int);
1518     case AV_OPT_TYPE_IMAGE_SIZE:return sizeof(int[2]);
1519     case AV_OPT_TYPE_PIXEL_FMT: return sizeof(enum AVPixelFormat);
1520     case AV_OPT_TYPE_SAMPLE_FMT:return sizeof(enum AVSampleFormat);
1521     case AV_OPT_TYPE_COLOR:     return 4;
1522     }
1523     return 0;
1524 }
1525
1526 int av_opt_copy(void *dst, const void *src)
1527 {
1528     const AVOption *o = NULL;
1529     const AVClass *c;
1530     int ret = 0;
1531
1532     if (!src)
1533         return 0;
1534
1535     c = *(AVClass**)src;
1536     if (*(AVClass**)dst && c != *(AVClass**)dst)
1537         return AVERROR(EINVAL);
1538
1539     while ((o = av_opt_next(src, o))) {
1540         void *field_dst = ((uint8_t*)dst) + o->offset;
1541         void *field_src = ((uint8_t*)src) + o->offset;
1542         uint8_t **field_dst8 = (uint8_t**)field_dst;
1543         uint8_t **field_src8 = (uint8_t**)field_src;
1544
1545         if (o->type == AV_OPT_TYPE_STRING) {
1546             if (*field_dst8 != *field_src8)
1547                 av_freep(field_dst8);
1548             *field_dst8 = av_strdup(*field_src8);
1549             if (*field_src8 && !*field_dst8)
1550                 ret = AVERROR(ENOMEM);
1551         } else if (o->type == AV_OPT_TYPE_BINARY) {
1552             int len = *(int*)(field_src8 + 1);
1553             if (*field_dst8 != *field_src8)
1554                 av_freep(field_dst8);
1555             *field_dst8 = av_memdup(*field_src8, len);
1556             if (len && !*field_dst8) {
1557                 ret = AVERROR(ENOMEM);
1558                 len = 0;
1559             }
1560             *(int*)(field_dst8 + 1) = len;
1561         } else if (o->type == AV_OPT_TYPE_CONST) {
1562             // do nothing
1563         } else if (o->type == AV_OPT_TYPE_DICT) {
1564             AVDictionary **sdict = (AVDictionary **) field_src;
1565             AVDictionary **ddict = (AVDictionary **) field_dst;
1566             if (*sdict != *ddict)
1567                 av_dict_free(ddict);
1568             *ddict = NULL;
1569             av_dict_copy(ddict, *sdict, 0);
1570             if (av_dict_count(*sdict) != av_dict_count(*ddict))
1571                 ret = AVERROR(ENOMEM);
1572         } else {
1573             memcpy(field_dst, field_src, opt_size(o->type));
1574         }
1575     }
1576     return ret;
1577 }
1578
1579 int av_opt_query_ranges(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
1580 {
1581     int ret;
1582     const AVClass *c = *(AVClass**)obj;
1583     int (*callback)(AVOptionRanges **, void *obj, const char *key, int flags) = NULL;
1584
1585     if (c->version > (52 << 16 | 11 << 8))
1586         callback = c->query_ranges;
1587
1588     if (!callback)
1589         callback = av_opt_query_ranges_default;
1590
1591     ret = callback(ranges_arg, obj, key, flags);
1592     if (ret >= 0) {
1593         if (!(flags & AV_OPT_MULTI_COMPONENT_RANGE))
1594             ret = 1;
1595         (*ranges_arg)->nb_components = ret;
1596     }
1597     return ret;
1598 }
1599
1600 int av_opt_query_ranges_default(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
1601 {
1602     AVOptionRanges *ranges = av_mallocz(sizeof(*ranges));
1603     AVOptionRange **range_array = av_mallocz(sizeof(void*));
1604     AVOptionRange *range = av_mallocz(sizeof(*range));
1605     const AVOption *field = av_opt_find(obj, key, NULL, 0, flags);
1606     int ret;
1607
1608     *ranges_arg = NULL;
1609
1610     if (!ranges || !range || !range_array || !field) {
1611         ret = AVERROR(ENOMEM);
1612         goto fail;
1613     }
1614
1615     ranges->range = range_array;
1616     ranges->range[0] = range;
1617     ranges->nb_ranges = 1;
1618     ranges->nb_components = 1;
1619     range->is_range = 1;
1620     range->value_min = field->min;
1621     range->value_max = field->max;
1622
1623     switch (field->type) {
1624     case AV_OPT_TYPE_BOOL:
1625     case AV_OPT_TYPE_INT:
1626     case AV_OPT_TYPE_INT64:
1627     case AV_OPT_TYPE_PIXEL_FMT:
1628     case AV_OPT_TYPE_SAMPLE_FMT:
1629     case AV_OPT_TYPE_FLOAT:
1630     case AV_OPT_TYPE_DOUBLE:
1631     case AV_OPT_TYPE_DURATION:
1632     case AV_OPT_TYPE_COLOR:
1633     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1634         break;
1635     case AV_OPT_TYPE_STRING:
1636         range->component_min = 0;
1637         range->component_max = 0x10FFFF; // max unicode value
1638         range->value_min = -1;
1639         range->value_max = INT_MAX;
1640         break;
1641     case AV_OPT_TYPE_RATIONAL:
1642         range->component_min = INT_MIN;
1643         range->component_max = INT_MAX;
1644         break;
1645     case AV_OPT_TYPE_IMAGE_SIZE:
1646         range->component_min = 0;
1647         range->component_max = INT_MAX/128/8;
1648         range->value_min = 0;
1649         range->value_max = INT_MAX/8;
1650         break;
1651     case AV_OPT_TYPE_VIDEO_RATE:
1652         range->component_min = 1;
1653         range->component_max = INT_MAX;
1654         range->value_min = 1;
1655         range->value_max = INT_MAX;
1656         break;
1657     default:
1658         ret = AVERROR(ENOSYS);
1659         goto fail;
1660     }
1661
1662     *ranges_arg = ranges;
1663     return 1;
1664 fail:
1665     av_free(ranges);
1666     av_free(range);
1667     av_free(range_array);
1668     return ret;
1669 }
1670
1671 void av_opt_freep_ranges(AVOptionRanges **rangesp)
1672 {
1673     int i;
1674     AVOptionRanges *ranges = *rangesp;
1675
1676     if (!ranges)
1677         return;
1678
1679     for (i = 0; i < ranges->nb_ranges * ranges->nb_components; i++) {
1680         AVOptionRange *range = ranges->range[i];
1681         if (range) {
1682             av_freep(&range->str);
1683             av_freep(&ranges->range[i]);
1684         }
1685     }
1686     av_freep(&ranges->range);
1687     av_freep(rangesp);
1688 }
1689
1690 int av_opt_is_set_to_default(void *obj, const AVOption *o)
1691 {
1692     int64_t i64;
1693     double d, d2;
1694     float f;
1695     AVRational q;
1696     int ret, w, h;
1697     char *str;
1698     void *dst;
1699
1700     if (!o || !obj)
1701         return AVERROR(EINVAL);
1702
1703     dst = ((uint8_t*)obj) + o->offset;
1704
1705     switch (o->type) {
1706     case AV_OPT_TYPE_CONST:
1707         return 1;
1708     case AV_OPT_TYPE_BOOL:
1709     case AV_OPT_TYPE_FLAGS:
1710     case AV_OPT_TYPE_PIXEL_FMT:
1711     case AV_OPT_TYPE_SAMPLE_FMT:
1712     case AV_OPT_TYPE_INT:
1713     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1714     case AV_OPT_TYPE_DURATION:
1715     case AV_OPT_TYPE_INT64:
1716         read_number(o, dst, NULL, NULL, &i64);
1717         return o->default_val.i64 == i64;
1718     case AV_OPT_TYPE_STRING:
1719         str = *(char **)dst;
1720         if (str == o->default_val.str) //2 NULLs
1721             return 1;
1722         if (!str || !o->default_val.str) //1 NULL
1723             return 0;
1724         return !strcmp(str, o->default_val.str);
1725     case AV_OPT_TYPE_DOUBLE:
1726         read_number(o, dst, &d, NULL, NULL);
1727         return o->default_val.dbl == d;
1728     case AV_OPT_TYPE_FLOAT:
1729         read_number(o, dst, &d, NULL, NULL);
1730         f = o->default_val.dbl;
1731         d2 = f;
1732         return d2 == d;
1733     case AV_OPT_TYPE_RATIONAL:
1734         q = av_d2q(o->default_val.dbl, INT_MAX);
1735         return !av_cmp_q(*(AVRational*)dst, q);
1736     case AV_OPT_TYPE_BINARY: {
1737         struct {
1738             uint8_t *data;
1739             int size;
1740         } tmp = {0};
1741         int opt_size = *(int *)((void **)dst + 1);
1742         void *opt_ptr = *(void **)dst;
1743         if (!opt_size && (!o->default_val.str || !strlen(o->default_val.str)))
1744             return 1;
1745         if (!opt_size ||  !o->default_val.str || !strlen(o->default_val.str ))
1746             return 0;
1747         if (opt_size != strlen(o->default_val.str) / 2)
1748             return 0;
1749         ret = set_string_binary(NULL, NULL, o->default_val.str, &tmp.data);
1750         if (!ret)
1751             ret = !memcmp(opt_ptr, tmp.data, tmp.size);
1752         av_free(tmp.data);
1753         return ret;
1754     }
1755     case AV_OPT_TYPE_DICT:
1756         /* Binary and dict have not default support yet. Any pointer is not default. */
1757         return !!(*(void **)dst);
1758     case AV_OPT_TYPE_IMAGE_SIZE:
1759         if (!o->default_val.str || !strcmp(o->default_val.str, "none"))
1760             w = h = 0;
1761         else if ((ret = av_parse_video_size(&w, &h, o->default_val.str)) < 0)
1762             return ret;
1763         return (w == *(int *)dst) && (h == *((int *)dst+1));
1764     case AV_OPT_TYPE_VIDEO_RATE:
1765         q = (AVRational){0, 0};
1766         if (o->default_val.str) {
1767             if ((ret = av_parse_video_rate(&q, o->default_val.str)) < 0)
1768                 return ret;
1769         }
1770         return !av_cmp_q(*(AVRational*)dst, q);
1771     case AV_OPT_TYPE_COLOR: {
1772         uint8_t color[4] = {0, 0, 0, 0};
1773         if (o->default_val.str) {
1774             if ((ret = av_parse_color(color, o->default_val.str, -1, NULL)) < 0)
1775                 return ret;
1776         }
1777         return !memcmp(color, dst, sizeof(color));
1778     }
1779     default:
1780         av_log(obj, AV_LOG_WARNING, "Not supported option type: %d, option name: %s\n", o->type, o->name);
1781         break;
1782     }
1783     return AVERROR_PATCHWELCOME;
1784 }
1785
1786 int av_opt_is_set_to_default_by_name(void *obj, const char *name, int search_flags)
1787 {
1788     const AVOption *o;
1789     void *target;
1790     if (!obj)
1791         return AVERROR(EINVAL);
1792     o = av_opt_find2(obj, name, NULL, 0, search_flags, &target);
1793     if (!o)
1794         return AVERROR_OPTION_NOT_FOUND;
1795     return av_opt_is_set_to_default(target, o);
1796 }
1797
1798 int av_opt_serialize(void *obj, int opt_flags, int flags, char **buffer,
1799                      const char key_val_sep, const char pairs_sep)
1800 {
1801     const AVOption *o = NULL;
1802     uint8_t *buf;
1803     AVBPrint bprint;
1804     int ret, cnt = 0;
1805     const char special_chars[] = {pairs_sep, key_val_sep, '\0'};
1806
1807     if (pairs_sep == '\0' || key_val_sep == '\0' || pairs_sep == key_val_sep ||
1808         pairs_sep == '\\' || key_val_sep == '\\') {
1809         av_log(obj, AV_LOG_ERROR, "Invalid separator(s) found.");
1810         return AVERROR(EINVAL);
1811     }
1812
1813     if (!obj || !buffer)
1814         return AVERROR(EINVAL);
1815
1816     *buffer = NULL;
1817     av_bprint_init(&bprint, 64, AV_BPRINT_SIZE_UNLIMITED);
1818
1819     while (o = av_opt_next(obj, o)) {
1820         if (o->type == AV_OPT_TYPE_CONST)
1821             continue;
1822         if ((flags & AV_OPT_SERIALIZE_OPT_FLAGS_EXACT) && o->flags != opt_flags)
1823             continue;
1824         else if (((o->flags & opt_flags) != opt_flags))
1825             continue;
1826         if (flags & AV_OPT_SERIALIZE_SKIP_DEFAULTS && av_opt_is_set_to_default(obj, o) > 0)
1827             continue;
1828         if ((ret = av_opt_get(obj, o->name, 0, &buf)) < 0) {
1829             av_bprint_finalize(&bprint, NULL);
1830             return ret;
1831         }
1832         if (buf) {
1833             if (cnt++)
1834                 av_bprint_append_data(&bprint, &pairs_sep, 1);
1835             av_bprint_escape(&bprint, o->name, special_chars, AV_ESCAPE_MODE_BACKSLASH, 0);
1836             av_bprint_append_data(&bprint, &key_val_sep, 1);
1837             av_bprint_escape(&bprint, buf, special_chars, AV_ESCAPE_MODE_BACKSLASH, 0);
1838             av_freep(&buf);
1839         }
1840     }
1841     av_bprint_finalize(&bprint, buffer);
1842     return 0;
1843 }
1844
1845 #ifdef TEST
1846
1847 typedef struct TestContext
1848 {
1849     const AVClass *class;
1850     int num;
1851     int toggle;
1852     char *string;
1853     int flags;
1854     AVRational rational;
1855     AVRational video_rate;
1856     int w, h;
1857     enum AVPixelFormat pix_fmt;
1858     enum AVSampleFormat sample_fmt;
1859     int64_t duration;
1860     uint8_t color[4];
1861     int64_t channel_layout;
1862     void *binary;
1863     int binary_size;
1864     void *binary1;
1865     int binary_size1;
1866     void *binary2;
1867     int binary_size2;
1868     int64_t num64;
1869     float flt;
1870     double dbl;
1871     char *escape;
1872     int bool1;
1873     int bool2;
1874     int bool3;
1875 } TestContext;
1876
1877 #define OFFSET(x) offsetof(TestContext, x)
1878
1879 #define TEST_FLAG_COOL 01
1880 #define TEST_FLAG_LAME 02
1881 #define TEST_FLAG_MU   04
1882
1883 static const AVOption test_options[]= {
1884 {"num",      "set num",        OFFSET(num),      AV_OPT_TYPE_INT,      {.i64 = 0},       0,        100, 1              },
1885 {"toggle",   "set toggle",     OFFSET(toggle),   AV_OPT_TYPE_INT,      {.i64 = 1},       0,        1,   1              },
1886 {"rational", "set rational",   OFFSET(rational), AV_OPT_TYPE_RATIONAL, {.dbl = 1},       0,        10,  1              },
1887 {"string",   "set string",     OFFSET(string),   AV_OPT_TYPE_STRING,   {.str = "default"}, CHAR_MIN, CHAR_MAX, 1       },
1888 {"escape",   "set escape str", OFFSET(escape),   AV_OPT_TYPE_STRING,   {.str = "\\=,"}, CHAR_MIN, CHAR_MAX, 1          },
1889 {"flags",    "set flags",      OFFSET(flags),    AV_OPT_TYPE_FLAGS,    {.i64 = 1},       0,        INT_MAX, 1, "flags" },
1890 {"cool",     "set cool flag",  0,                AV_OPT_TYPE_CONST,    {.i64 = TEST_FLAG_COOL}, INT_MIN,  INT_MAX, 1, "flags" },
1891 {"lame",     "set lame flag",  0,                AV_OPT_TYPE_CONST,    {.i64 = TEST_FLAG_LAME}, INT_MIN,  INT_MAX, 1, "flags" },
1892 {"mu",       "set mu flag",    0,                AV_OPT_TYPE_CONST,    {.i64 = TEST_FLAG_MU},   INT_MIN,  INT_MAX, 1, "flags" },
1893 {"size",     "set size",       OFFSET(w),        AV_OPT_TYPE_IMAGE_SIZE,{.str="200x300"},             0,        0, 1},
1894 {"pix_fmt",  "set pixfmt",     OFFSET(pix_fmt),  AV_OPT_TYPE_PIXEL_FMT, {.i64 = AV_PIX_FMT_0BGR}, -1, INT_MAX, 1},
1895 {"sample_fmt", "set samplefmt", OFFSET(sample_fmt), AV_OPT_TYPE_SAMPLE_FMT, {.i64 = AV_SAMPLE_FMT_S16}, -1, INT_MAX, 1},
1896 {"video_rate", "set videorate", OFFSET(video_rate), AV_OPT_TYPE_VIDEO_RATE,  {.str = "25"}, 0,     0                   , 1},
1897 {"duration", "set duration",   OFFSET(duration), AV_OPT_TYPE_DURATION, {.i64 = 1000}, 0, INT64_MAX, 1},
1898 {"color", "set color",   OFFSET(color), AV_OPT_TYPE_COLOR, {.str = "pink"}, 0, 0, 1},
1899 {"cl", "set channel layout", OFFSET(channel_layout), AV_OPT_TYPE_CHANNEL_LAYOUT, {.i64 = AV_CH_LAYOUT_HEXAGONAL}, 0, INT64_MAX, 1},
1900 {"bin", "set binary value",    OFFSET(binary),   AV_OPT_TYPE_BINARY,   {.str="62696e00"}, 0,        0, 1 },
1901 {"bin1", "set binary value",   OFFSET(binary1),  AV_OPT_TYPE_BINARY,   {.str=NULL},       0,        0, 1 },
1902 {"bin2", "set binary value",   OFFSET(binary2),  AV_OPT_TYPE_BINARY,   {.str=""},         0,        0, 1 },
1903 {"num64",    "set num 64bit",  OFFSET(num64),    AV_OPT_TYPE_INT64,    {.i64 = 1},        0,        100, 1 },
1904 {"flt",      "set float",      OFFSET(flt),      AV_OPT_TYPE_FLOAT,    {.dbl = 1.0/3},    0,        100, 1},
1905 {"dbl",      "set double",     OFFSET(dbl),      AV_OPT_TYPE_DOUBLE,   {.dbl = 1.0/3},    0,        100, 1 },
1906 {"bool1", "set boolean value",  OFFSET(bool1),   AV_OPT_TYPE_BOOL,     {.i64 = -1},      -1,        1, 1 },
1907 {"bool2", "set boolean value",  OFFSET(bool2),   AV_OPT_TYPE_BOOL,     {.i64 = 1},       -1,        1, 1 },
1908 {"bool3", "set boolean value",  OFFSET(bool3),   AV_OPT_TYPE_BOOL,     {.i64 = 0},        0,        1, 1 },
1909 {NULL},
1910 };
1911
1912 static const char *test_get_name(void *ctx)
1913 {
1914     return "test";
1915 }
1916
1917 static const AVClass test_class = {
1918     "TestContext",
1919     test_get_name,
1920     test_options
1921 };
1922
1923 static void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
1924 {
1925     vfprintf(stdout, fmt, vl);
1926 }
1927
1928 int main(void)
1929 {
1930     int i;
1931
1932     av_log_set_level(AV_LOG_DEBUG);
1933     av_log_set_callback(log_callback_help);
1934
1935     printf("Testing default values\n");
1936     {
1937         TestContext test_ctx = { 0 };
1938         test_ctx.class = &test_class;
1939         av_opt_set_defaults(&test_ctx);
1940
1941         printf("num=%d\n", test_ctx.num);
1942         printf("toggle=%d\n", test_ctx.toggle);
1943         printf("string=%s\n", test_ctx.string);
1944         printf("escape=%s\n", test_ctx.escape);
1945         printf("flags=%d\n", test_ctx.flags);
1946         printf("rational=%d/%d\n", test_ctx.rational.num, test_ctx.rational.den);
1947         printf("video_rate=%d/%d\n", test_ctx.video_rate.num, test_ctx.video_rate.den);
1948         printf("width=%d height=%d\n", test_ctx.w, test_ctx.h);
1949         printf("pix_fmt=%s\n", av_get_pix_fmt_name(test_ctx.pix_fmt));
1950         printf("sample_fmt=%s\n", av_get_sample_fmt_name(test_ctx.sample_fmt));
1951         printf("duration=%"PRId64"\n", test_ctx.duration);
1952         printf("color=%d %d %d %d\n", test_ctx.color[0], test_ctx.color[1], test_ctx.color[2], test_ctx.color[3]);
1953         printf("channel_layout=%"PRId64"=%"PRId64"\n", test_ctx.channel_layout, (int64_t)AV_CH_LAYOUT_HEXAGONAL);
1954         if (test_ctx.binary)
1955             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]);
1956         printf("binary_size=%d\n", test_ctx.binary_size);
1957         printf("num64=%"PRId64"\n", test_ctx.num64);
1958         printf("flt=%.6f\n", test_ctx.flt);
1959         printf("dbl=%.6f\n", test_ctx.dbl);
1960
1961         av_opt_show2(&test_ctx, NULL, -1, 0);
1962
1963         av_opt_free(&test_ctx);
1964     }
1965
1966     printf("\nTesting av_opt_is_set_to_default()\n");
1967     {
1968         int ret;
1969         TestContext test_ctx = { 0 };
1970         const AVOption *o = NULL;
1971         test_ctx.class = &test_class;
1972
1973         av_log_set_level(AV_LOG_QUIET);
1974
1975         while (o = av_opt_next(&test_ctx, o)) {
1976             ret = av_opt_is_set_to_default_by_name(&test_ctx, o->name, 0);
1977             printf("name:%10s default:%d error:%s\n", o->name, !!ret, ret < 0 ? av_err2str(ret) : "");
1978         }
1979         av_opt_set_defaults(&test_ctx);
1980         while (o = av_opt_next(&test_ctx, o)) {
1981             ret = av_opt_is_set_to_default_by_name(&test_ctx, o->name, 0);
1982             printf("name:%10s default:%d error:%s\n", o->name, !!ret, ret < 0 ? av_err2str(ret) : "");
1983         }
1984         av_opt_free(&test_ctx);
1985     }
1986
1987     printf("\nTest av_opt_serialize()\n");
1988     {
1989         TestContext test_ctx = { 0 };
1990         char *buf;
1991         test_ctx.class = &test_class;
1992
1993         av_log_set_level(AV_LOG_QUIET);
1994
1995         av_opt_set_defaults(&test_ctx);
1996         if (av_opt_serialize(&test_ctx, 0, 0, &buf, '=', ',') >= 0) {
1997             printf("%s\n", buf);
1998             av_opt_free(&test_ctx);
1999             memset(&test_ctx, 0, sizeof(test_ctx));
2000             test_ctx.class = &test_class;
2001             av_set_options_string(&test_ctx, buf, "=", ",");
2002             av_free(buf);
2003             if (av_opt_serialize(&test_ctx, 0, 0, &buf, '=', ',') >= 0) {
2004                 printf("%s\n", buf);
2005                 av_free(buf);
2006             }
2007         }
2008         av_opt_free(&test_ctx);
2009     }
2010
2011     printf("\nTesting av_set_options_string()\n");
2012     {
2013         TestContext test_ctx = { 0 };
2014         static const char * const options[] = {
2015             "",
2016             ":",
2017             "=",
2018             "foo=:",
2019             ":=foo",
2020             "=foo",
2021             "foo=",
2022             "foo",
2023             "foo=val",
2024             "foo==val",
2025             "toggle=:",
2026             "string=:",
2027             "toggle=1 : foo",
2028             "toggle=100",
2029             "toggle==1",
2030             "flags=+mu-lame : num=42: toggle=0",
2031             "num=42 : string=blahblah",
2032             "rational=0 : rational=1/2 : rational=1/-1",
2033             "rational=-1/0",
2034             "size=1024x768",
2035             "size=pal",
2036             "size=bogus",
2037             "pix_fmt=yuv420p",
2038             "pix_fmt=2",
2039             "pix_fmt=bogus",
2040             "sample_fmt=s16",
2041             "sample_fmt=2",
2042             "sample_fmt=bogus",
2043             "video_rate=pal",
2044             "video_rate=25",
2045             "video_rate=30000/1001",
2046             "video_rate=30/1.001",
2047             "video_rate=bogus",
2048             "duration=bogus",
2049             "duration=123.45",
2050             "duration=1\\:23\\:45.67",
2051             "color=blue",
2052             "color=0x223300",
2053             "color=0x42FF07AA",
2054             "cl=stereo+downmix",
2055             "cl=foo",
2056             "bin=boguss",
2057             "bin=111",
2058             "bin=ffff",
2059             "num64=bogus",
2060             "num64=44",
2061             "num64=44.4",
2062             "num64=-1",
2063             "num64=101",
2064             "flt=bogus",
2065             "flt=2",
2066             "flt=2.2",
2067             "flt=-1",
2068             "flt=101",
2069             "dbl=bogus",
2070             "dbl=2",
2071             "dbl=2.2",
2072             "dbl=-1",
2073             "dbl=101",
2074             "bool1=true",
2075             "bool2=auto",
2076         };
2077
2078         test_ctx.class = &test_class;
2079         av_opt_set_defaults(&test_ctx);
2080
2081         av_log_set_level(AV_LOG_QUIET);
2082
2083         for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
2084             int silence_log = !strcmp(options[i], "rational=-1/0"); // inf formating differs between platforms
2085             av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
2086             if (silence_log)
2087                 av_log_set_callback(NULL);
2088             if (av_set_options_string(&test_ctx, options[i], "=", ":") < 0)
2089                 printf("Error '%s'\n", options[i]);
2090             else
2091                 printf("OK    '%s'\n", options[i]);
2092             av_log_set_callback(log_callback_help);
2093         }
2094         av_opt_free(&test_ctx);
2095     }
2096
2097     printf("\nTesting av_opt_set_from_string()\n");
2098     {
2099         TestContext test_ctx = { 0 };
2100         static const char * const options[] = {
2101             "",
2102             "5",
2103             "5:hello",
2104             "5:hello:size=pal",
2105             "5:size=pal:hello",
2106             ":",
2107             "=",
2108             " 5 : hello : size = pal ",
2109             "a_very_long_option_name_that_will_need_to_be_ellipsized_around_here=42"
2110         };
2111         static const char * const shorthand[] = { "num", "string", NULL };
2112
2113         test_ctx.class = &test_class;
2114         av_opt_set_defaults(&test_ctx);
2115
2116         av_log_set_level(AV_LOG_QUIET);
2117
2118         for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
2119             av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
2120             if (av_opt_set_from_string(&test_ctx, options[i], shorthand, "=", ":") < 0)
2121                 printf("Error '%s'\n", options[i]);
2122             else
2123                 printf("OK    '%s'\n", options[i]);
2124         }
2125         av_opt_free(&test_ctx);
2126     }
2127
2128     return 0;
2129 }
2130
2131 #endif