]> git.sesse.net Git - ffmpeg/blob - libavutil/opt.c
Merge commit '8feac29cc46270cc89d6016340e7bac780877131'
[ffmpeg] / 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
41 #include <float.h>
42
43 #if FF_API_FIND_OPT
44 //FIXME order them and do a bin search
45 const AVOption *av_find_opt(void *v, const char *name, const char *unit, int mask, int flags)
46 {
47     const AVOption *o = NULL;
48
49     while ((o = av_next_option(v, o))) {
50         if (!strcmp(o->name, name) && (!unit || (o->unit && !strcmp(o->unit, unit))) && (o->flags & mask) == flags)
51             return o;
52     }
53     return NULL;
54 }
55 #endif
56
57 #if FF_API_OLD_AVOPTIONS
58 const AVOption *av_next_option(void *obj, const AVOption *last)
59 {
60     return av_opt_next(obj, last);
61 }
62 #endif
63
64 const AVOption *av_opt_next(void *obj, const AVOption *last)
65 {
66     AVClass *class = *(AVClass**)obj;
67     if (!last && class && class->option && class->option[0].name)
68         return class->option;
69     if (last && last[1].name)
70         return ++last;
71     return NULL;
72 }
73
74 static int read_number(const AVOption *o, void *dst, double *num, int *den, int64_t *intnum)
75 {
76     switch (o->type) {
77     case AV_OPT_TYPE_FLAGS:     *intnum = *(unsigned int*)dst;return 0;
78     case AV_OPT_TYPE_PIXEL_FMT:
79     case AV_OPT_TYPE_SAMPLE_FMT:
80     case AV_OPT_TYPE_INT:       *intnum = *(int         *)dst;return 0;
81     case AV_OPT_TYPE_CHANNEL_LAYOUT:
82     case AV_OPT_TYPE_DURATION:
83     case AV_OPT_TYPE_INT64:     *intnum = *(int64_t     *)dst;return 0;
84     case AV_OPT_TYPE_FLOAT:     *num    = *(float       *)dst;return 0;
85     case AV_OPT_TYPE_DOUBLE:    *num    = *(double      *)dst;return 0;
86     case AV_OPT_TYPE_RATIONAL:  *intnum = ((AVRational*)dst)->num;
87                                 *den    = ((AVRational*)dst)->den;
88                                                         return 0;
89     case AV_OPT_TYPE_CONST:     *num    = o->default_val.dbl; return 0;
90     }
91     return AVERROR(EINVAL);
92 }
93
94 static int write_number(void *obj, const AVOption *o, void *dst, double num, int den, int64_t intnum)
95 {
96     if (o->type != AV_OPT_TYPE_FLAGS &&
97         (o->max * den < num * intnum || o->min * den > num * intnum)) {
98         av_log(obj, AV_LOG_ERROR, "Value %f for parameter '%s' out of range [%g - %g]\n",
99                num*intnum/den, o->name, o->min, o->max);
100         return AVERROR(ERANGE);
101     }
102     if (o->type == AV_OPT_TYPE_FLAGS) {
103         double d = num*intnum/den;
104         if (d < -1.5 || d > 0xFFFFFFFF+0.5 || (llrint(d*256) & 255)) {
105             av_log(obj, AV_LOG_ERROR,
106                    "Value %f for parameter '%s' is not a valid set of 32bit integer flags\n",
107                    num*intnum/den, o->name);
108             return AVERROR(ERANGE);
109         }
110     }
111
112     switch (o->type) {
113     case AV_OPT_TYPE_FLAGS:
114     case AV_OPT_TYPE_PIXEL_FMT:
115     case AV_OPT_TYPE_SAMPLE_FMT:
116     case AV_OPT_TYPE_INT:   *(int       *)dst= llrint(num/den)*intnum; break;
117     case AV_OPT_TYPE_DURATION:
118     case AV_OPT_TYPE_CHANNEL_LAYOUT:
119     case AV_OPT_TYPE_INT64: *(int64_t   *)dst= llrint(num/den)*intnum; break;
120     case AV_OPT_TYPE_FLOAT: *(float     *)dst= num*intnum/den;         break;
121     case AV_OPT_TYPE_DOUBLE:*(double    *)dst= num*intnum/den;         break;
122     case AV_OPT_TYPE_RATIONAL:
123         if ((int)num == num) *(AVRational*)dst= (AVRational){num*intnum, den};
124         else                 *(AVRational*)dst= av_d2q(num*intnum/den, 1<<24);
125         break;
126     default:
127         return AVERROR(EINVAL);
128     }
129     return 0;
130 }
131
132 static const double const_values[] = {
133     M_PI,
134     M_E,
135     FF_QP2LAMBDA,
136     0
137 };
138
139 static const char * const const_names[] = {
140     "PI",
141     "E",
142     "QP2LAMBDA",
143     0
144 };
145
146 static int hexchar2int(char c) {
147     if (c >= '0' && c <= '9') return c - '0';
148     if (c >= 'a' && c <= 'f') return c - 'a' + 10;
149     if (c >= 'A' && c <= 'F') return c - 'A' + 10;
150     return -1;
151 }
152
153 static int set_string_binary(void *obj, const AVOption *o, const char *val, uint8_t **dst)
154 {
155     int *lendst = (int *)(dst + 1);
156     uint8_t *bin, *ptr;
157     int len = strlen(val);
158
159     av_freep(dst);
160     *lendst = 0;
161
162     if (len & 1)
163         return AVERROR(EINVAL);
164     len /= 2;
165
166     ptr = bin = av_malloc(len);
167     while (*val) {
168         int a = hexchar2int(*val++);
169         int b = hexchar2int(*val++);
170         if (a < 0 || b < 0) {
171             av_free(bin);
172             return AVERROR(EINVAL);
173         }
174         *ptr++ = (a << 4) | b;
175     }
176     *dst = bin;
177     *lendst = len;
178
179     return 0;
180 }
181
182 static int set_string(void *obj, const AVOption *o, const char *val, uint8_t **dst)
183 {
184     av_freep(dst);
185     *dst = av_strdup(val);
186     return 0;
187 }
188
189 #define DEFAULT_NUMVAL(opt) ((opt->type == AV_OPT_TYPE_INT64 || \
190                               opt->type == AV_OPT_TYPE_CONST || \
191                               opt->type == AV_OPT_TYPE_FLAGS || \
192                               opt->type == AV_OPT_TYPE_INT) ? \
193                              opt->default_val.i64 : opt->default_val.dbl)
194
195 static int set_string_number(void *obj, void *target_obj, const AVOption *o, const char *val, void *dst)
196 {
197     int ret = 0, notfirst = 0;
198     int num, den;
199     char c;
200
201     if (sscanf(val, "%d%*1[:/]%d%c", &num, &den, &c) == 2) {
202         if ((ret = write_number(obj, o, dst, 1, den, num)) >= 0)
203             return ret;
204         ret = 0;
205     }
206
207     for (;;) {
208         int i, den = 1;
209         char buf[256];
210         int cmd = 0;
211         double d, num = 1;
212         int64_t intnum = 1;
213
214         i = 0;
215         if (*val == '+' || *val == '-') {
216             if (o->type == AV_OPT_TYPE_FLAGS)
217                 cmd = *(val++);
218             else if (!notfirst)
219                 buf[i++] = *val;
220         }
221
222         for (; i < sizeof(buf) - 1 && val[i] && val[i] != '+' && val[i] != '-'; i++)
223             buf[i] = val[i];
224         buf[i] = 0;
225
226         {
227             const AVOption *o_named = av_opt_find(target_obj, buf, o->unit, 0, 0);
228             if (o_named && o_named->type == AV_OPT_TYPE_CONST)
229                 d = DEFAULT_NUMVAL(o_named);
230             else if (!strcmp(buf, "default")) d = DEFAULT_NUMVAL(o);
231             else if (!strcmp(buf, "max"    )) d = o->max;
232             else if (!strcmp(buf, "min"    )) d = o->min;
233             else if (!strcmp(buf, "none"   )) d = 0;
234             else if (!strcmp(buf, "all"    )) d = ~0;
235             else {
236                 int res = av_expr_parse_and_eval(&d, buf, const_names, 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         } else {
248             read_number(o, dst, &num, &den, &intnum);
249             if      (cmd == '+') d = notfirst*num*intnum/den + d;
250             else if (cmd == '-') d = notfirst*num*intnum/den - d;
251         }
252
253         if ((ret = write_number(obj, o, dst, d, 1, 1)) < 0)
254             return ret;
255         val += i;
256         if (!*val)
257             return 0;
258         notfirst = 1;
259     }
260
261     return 0;
262 }
263
264 static int set_string_image_size(void *obj, const AVOption *o, const char *val, int *dst)
265 {
266     int ret;
267
268     if (!val || !strcmp(val, "none")) {
269         dst[0] =
270         dst[1] = 0;
271         return 0;
272     }
273     ret = av_parse_video_size(dst, dst + 1, val);
274     if (ret < 0)
275         av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as image size\n", val);
276     return ret;
277 }
278
279 static int set_string_video_rate(void *obj, const AVOption *o, const char *val, AVRational *dst)
280 {
281     int ret;
282     if (!val) {
283         ret = AVERROR(EINVAL);
284     } else {
285         ret = av_parse_video_rate(dst, val);
286     }
287     if (ret < 0)
288         av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as video rate\n", val);
289     return ret;
290 }
291
292 static int set_string_color(void *obj, const AVOption *o, const char *val, uint8_t *dst)
293 {
294     int ret;
295
296     if (!val) {
297         return 0;
298     } else {
299         ret = av_parse_color(dst, val, -1, obj);
300         if (ret < 0)
301             av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as color\n", val);
302         return ret;
303     }
304     return 0;
305 }
306
307 static int set_string_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst,
308                           int fmt_nb, int ((*get_fmt)(const char *)), const char *desc)
309 {
310     int fmt, min, max;
311
312     if (!val || !strcmp(val, "none")) {
313         fmt = -1;
314     } else {
315         fmt = get_fmt(val);
316         if (fmt == -1) {
317             char *tail;
318             fmt = strtol(val, &tail, 0);
319             if (*tail || (unsigned)fmt >= fmt_nb) {
320                 av_log(obj, AV_LOG_ERROR,
321                        "Unable to parse option value \"%s\" as %s\n", val, desc);
322                 return AVERROR(EINVAL);
323             }
324         }
325     }
326
327     min = FFMAX(o->min, -1);
328     max = FFMIN(o->max, fmt_nb-1);
329
330     if (fmt < min || fmt > max) {
331         av_log(obj, AV_LOG_ERROR,
332                "Value %d for parameter '%s' out of %s format range [%d - %d]\n",
333                fmt, o->name, desc, min, max);
334         return AVERROR(ERANGE);
335     }
336
337     *(int *)dst = fmt;
338     return 0;
339 }
340
341 static int set_string_pixel_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst)
342 {
343     return set_string_fmt(obj, o, val, dst,
344                           AV_PIX_FMT_NB, av_get_pix_fmt, "pixel format");
345 }
346
347 static int set_string_sample_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst)
348 {
349     return set_string_fmt(obj, o, val, dst,
350                           AV_SAMPLE_FMT_NB, av_get_sample_fmt, "sample format");
351 }
352
353 #if FF_API_OLD_AVOPTIONS
354 int av_set_string3(void *obj, const char *name, const char *val, int alloc, const AVOption **o_out)
355 {
356     const AVOption *o = av_opt_find(obj, name, NULL, 0, 0);
357     if (o_out)
358         *o_out = o;
359     return av_opt_set(obj, name, val, 0);
360 }
361 #endif
362
363 int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
364 {
365     int ret = 0;
366     void *dst, *target_obj;
367     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
368     if (!o || !target_obj)
369         return AVERROR_OPTION_NOT_FOUND;
370     if (!val && (o->type != AV_OPT_TYPE_STRING &&
371                  o->type != AV_OPT_TYPE_PIXEL_FMT && o->type != AV_OPT_TYPE_SAMPLE_FMT &&
372                  o->type != AV_OPT_TYPE_IMAGE_SIZE && o->type != AV_OPT_TYPE_VIDEO_RATE &&
373                  o->type != AV_OPT_TYPE_DURATION && o->type != AV_OPT_TYPE_COLOR &&
374                  o->type != AV_OPT_TYPE_CHANNEL_LAYOUT))
375         return AVERROR(EINVAL);
376
377     if (o->flags & AV_OPT_FLAG_READONLY)
378         return AVERROR(EINVAL);
379
380     dst = ((uint8_t*)target_obj) + o->offset;
381     switch (o->type) {
382     case AV_OPT_TYPE_STRING:   return set_string(obj, o, val, dst);
383     case AV_OPT_TYPE_BINARY:   return set_string_binary(obj, o, val, dst);
384     case AV_OPT_TYPE_FLAGS:
385     case AV_OPT_TYPE_INT:
386     case AV_OPT_TYPE_INT64:
387     case AV_OPT_TYPE_FLOAT:
388     case AV_OPT_TYPE_DOUBLE:
389     case AV_OPT_TYPE_RATIONAL: return set_string_number(obj, target_obj, o, val, dst);
390     case AV_OPT_TYPE_IMAGE_SIZE: return set_string_image_size(obj, o, val, dst);
391     case AV_OPT_TYPE_VIDEO_RATE: return set_string_video_rate(obj, o, val, dst);
392     case AV_OPT_TYPE_PIXEL_FMT:  return set_string_pixel_fmt(obj, o, val, dst);
393     case AV_OPT_TYPE_SAMPLE_FMT: return set_string_sample_fmt(obj, o, val, dst);
394     case AV_OPT_TYPE_DURATION:
395         if (!val) {
396             *(int64_t *)dst = 0;
397             return 0;
398         } else {
399             if ((ret = av_parse_time(dst, val, 1)) < 0)
400                 av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as duration\n", val);
401             return ret;
402         }
403         break;
404     case AV_OPT_TYPE_COLOR:      return set_string_color(obj, o, val, dst);
405     case AV_OPT_TYPE_CHANNEL_LAYOUT:
406         if (!val || !strcmp(val, "none")) {
407             *(int64_t *)dst = 0;
408         } else {
409 #if FF_API_GET_CHANNEL_LAYOUT_COMPAT
410             int64_t cl = ff_get_channel_layout(val, 0);
411 #else
412             int64_t cl = av_get_channel_layout(val);
413 #endif
414             if (!cl) {
415                 av_log(obj, AV_LOG_ERROR, "Unable to parse option value \"%s\" as channel layout\n", val);
416                 ret = AVERROR(EINVAL);
417             }
418             *(int64_t *)dst = cl;
419             return ret;
420         }
421         break;
422     }
423
424     av_log(obj, AV_LOG_ERROR, "Invalid option type.\n");
425     return AVERROR(EINVAL);
426 }
427
428 #define OPT_EVAL_NUMBER(name, opttype, vartype)\
429     int av_opt_eval_ ## name(void *obj, const AVOption *o, const char *val, vartype *name ## _out)\
430     {\
431         if (!o || o->type != opttype || o->flags & AV_OPT_FLAG_READONLY)\
432             return AVERROR(EINVAL);\
433         return set_string_number(obj, obj, o, val, name ## _out);\
434     }
435
436 OPT_EVAL_NUMBER(flags,  AV_OPT_TYPE_FLAGS,    int)
437 OPT_EVAL_NUMBER(int,    AV_OPT_TYPE_INT,      int)
438 OPT_EVAL_NUMBER(int64,  AV_OPT_TYPE_INT64,    int64_t)
439 OPT_EVAL_NUMBER(float,  AV_OPT_TYPE_FLOAT,    float)
440 OPT_EVAL_NUMBER(double, AV_OPT_TYPE_DOUBLE,   double)
441 OPT_EVAL_NUMBER(q,      AV_OPT_TYPE_RATIONAL, AVRational)
442
443 static int set_number(void *obj, const char *name, double num, int den, int64_t intnum,
444                                   int search_flags)
445 {
446     void *dst, *target_obj;
447     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
448
449     if (!o || !target_obj)
450         return AVERROR_OPTION_NOT_FOUND;
451
452     if (o->flags & AV_OPT_FLAG_READONLY)
453         return AVERROR(EINVAL);
454
455     dst = ((uint8_t*)target_obj) + o->offset;
456     return write_number(obj, o, dst, num, den, intnum);
457 }
458
459 #if FF_API_OLD_AVOPTIONS
460 const AVOption *av_set_double(void *obj, const char *name, double n)
461 {
462     const AVOption *o = av_opt_find(obj, name, NULL, 0, 0);
463     if (set_number(obj, name, n, 1, 1, 0) < 0)
464         return NULL;
465     return o;
466 }
467
468 const AVOption *av_set_q(void *obj, const char *name, AVRational n)
469 {
470     const AVOption *o = av_opt_find(obj, name, NULL, 0, 0);
471     if (set_number(obj, name, n.num, n.den, 1, 0) < 0)
472         return NULL;
473     return o;
474 }
475
476 const AVOption *av_set_int(void *obj, const char *name, int64_t n)
477 {
478     const AVOption *o = av_opt_find(obj, name, NULL, 0, 0);
479     if (set_number(obj, name, 1, 1, n, 0) < 0)
480         return NULL;
481     return o;
482 }
483 #endif
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     const AVClass *class = *(AVClass **)obj;
577
578     if (!o || !target_obj)
579         return AVERROR_OPTION_NOT_FOUND;
580     if (o->type != type) {
581         av_log(obj, AV_LOG_ERROR,
582                "The value set by option '%s' is not a %s format", name, desc);
583         return AVERROR(EINVAL);
584     }
585
586 #if LIBAVUTIL_VERSION_MAJOR < 54
587     if (class->version && class->version < AV_VERSION_INT(52, 11, 100)) {
588         min = -1;
589         max = nb_fmts-1;
590     } else
591 #endif
592     {
593         min = FFMAX(o->min, -1);
594         max = FFMIN(o->max, nb_fmts-1);
595     }
596     if (fmt < min || fmt > max) {
597         av_log(obj, AV_LOG_ERROR,
598                "Value %d for parameter '%s' out of %s format range [%d - %d]\n",
599                fmt, name, desc, min, max);
600         return AVERROR(ERANGE);
601     }
602     *(int *)(((uint8_t *)target_obj) + o->offset) = fmt;
603     return 0;
604 }
605
606 int av_opt_set_pixel_fmt(void *obj, const char *name, enum AVPixelFormat fmt, int search_flags)
607 {
608     return set_format(obj, name, fmt, search_flags, AV_OPT_TYPE_PIXEL_FMT, "pixel", AV_PIX_FMT_NB);
609 }
610
611 int av_opt_set_sample_fmt(void *obj, const char *name, enum AVSampleFormat fmt, int search_flags)
612 {
613     return set_format(obj, name, fmt, search_flags, AV_OPT_TYPE_SAMPLE_FMT, "sample", AV_SAMPLE_FMT_NB);
614 }
615
616 int av_opt_set_channel_layout(void *obj, const char *name, int64_t cl, int search_flags)
617 {
618     void *target_obj;
619     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
620
621     if (!o || !target_obj)
622         return AVERROR_OPTION_NOT_FOUND;
623     if (o->type != AV_OPT_TYPE_CHANNEL_LAYOUT) {
624         av_log(obj, AV_LOG_ERROR,
625                "The value set by option '%s' is not a channel layout.\n", o->name);
626         return AVERROR(EINVAL);
627     }
628     *(int *)(((int64_t *)target_obj) + o->offset) = cl;
629     return 0;
630 }
631
632 #if FF_API_OLD_AVOPTIONS
633 /**
634  *
635  * @param buf a buffer which is used for returning non string values as strings, can be NULL
636  * @param buf_len allocated length in bytes of buf
637  */
638 const char *av_get_string(void *obj, const char *name, const AVOption **o_out, char *buf, int buf_len)
639 {
640     const AVOption *o = av_opt_find(obj, name, NULL, 0, AV_OPT_SEARCH_CHILDREN);
641     void *dst;
642     uint8_t *bin;
643     int len, i;
644     if (!o)
645         return NULL;
646     if (o->type != AV_OPT_TYPE_STRING && (!buf || !buf_len))
647         return NULL;
648
649     dst= ((uint8_t*)obj) + o->offset;
650     if (o_out) *o_out= o;
651
652     switch (o->type) {
653     case AV_OPT_TYPE_FLAGS:     snprintf(buf, buf_len, "0x%08X",*(int    *)dst);break;
654     case AV_OPT_TYPE_INT:       snprintf(buf, buf_len, "%d" , *(int    *)dst);break;
655     case AV_OPT_TYPE_INT64:     snprintf(buf, buf_len, "%"PRId64, *(int64_t*)dst);break;
656     case AV_OPT_TYPE_FLOAT:     snprintf(buf, buf_len, "%f" , *(float  *)dst);break;
657     case AV_OPT_TYPE_DOUBLE:    snprintf(buf, buf_len, "%f" , *(double *)dst);break;
658     case AV_OPT_TYPE_RATIONAL:  snprintf(buf, buf_len, "%d/%d", ((AVRational*)dst)->num, ((AVRational*)dst)->den);break;
659     case AV_OPT_TYPE_CONST:     snprintf(buf, buf_len, "%f" , o->default_val.dbl);break;
660     case AV_OPT_TYPE_STRING:    return *(void**)dst;
661     case AV_OPT_TYPE_BINARY:
662         len = *(int*)(((uint8_t *)dst) + sizeof(uint8_t *));
663         if (len >= (buf_len + 1)/2) return NULL;
664         bin = *(uint8_t**)dst;
665         for (i = 0; i < len; i++) snprintf(buf + i*2, 3, "%02X", bin[i]);
666         break;
667     default: return NULL;
668     }
669     return buf;
670 }
671 #endif
672
673 int av_opt_get(void *obj, const char *name, int search_flags, uint8_t **out_val)
674 {
675     void *dst, *target_obj;
676     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
677     uint8_t *bin, buf[128];
678     int len, i, ret;
679     int64_t i64;
680
681     if (!o || !target_obj || (o->offset<=0 && o->type != AV_OPT_TYPE_CONST))
682         return AVERROR_OPTION_NOT_FOUND;
683
684     dst = (uint8_t*)target_obj + o->offset;
685
686     buf[0] = 0;
687     switch (o->type) {
688     case AV_OPT_TYPE_FLAGS:     ret = snprintf(buf, sizeof(buf), "0x%08X",  *(int    *)dst);break;
689     case AV_OPT_TYPE_INT:       ret = snprintf(buf, sizeof(buf), "%d" ,     *(int    *)dst);break;
690     case AV_OPT_TYPE_INT64:     ret = snprintf(buf, sizeof(buf), "%"PRId64, *(int64_t*)dst);break;
691     case AV_OPT_TYPE_FLOAT:     ret = snprintf(buf, sizeof(buf), "%f" ,     *(float  *)dst);break;
692     case AV_OPT_TYPE_DOUBLE:    ret = snprintf(buf, sizeof(buf), "%f" ,     *(double *)dst);break;
693     case AV_OPT_TYPE_VIDEO_RATE:
694     case AV_OPT_TYPE_RATIONAL:  ret = snprintf(buf, sizeof(buf), "%d/%d",   ((AVRational*)dst)->num, ((AVRational*)dst)->den);break;
695     case AV_OPT_TYPE_CONST:     ret = snprintf(buf, sizeof(buf), "%f" ,     o->default_val.dbl);break;
696     case AV_OPT_TYPE_STRING:
697         if (*(uint8_t**)dst)
698             *out_val = av_strdup(*(uint8_t**)dst);
699         else
700             *out_val = av_strdup("");
701         return 0;
702     case AV_OPT_TYPE_BINARY:
703         len = *(int*)(((uint8_t *)dst) + sizeof(uint8_t *));
704         if ((uint64_t)len*2 + 1 > INT_MAX)
705             return AVERROR(EINVAL);
706         if (!(*out_val = av_malloc(len*2 + 1)))
707             return AVERROR(ENOMEM);
708         bin = *(uint8_t**)dst;
709         for (i = 0; i < len; i++)
710             snprintf(*out_val + i*2, 3, "%02X", bin[i]);
711         return 0;
712     case AV_OPT_TYPE_IMAGE_SIZE:
713         ret = snprintf(buf, sizeof(buf), "%dx%d", ((int *)dst)[0], ((int *)dst)[1]);
714         break;
715     case AV_OPT_TYPE_PIXEL_FMT:
716         ret = snprintf(buf, sizeof(buf), "%s", (char *)av_x_if_null(av_get_pix_fmt_name(*(enum AVPixelFormat *)dst), "none"));
717         break;
718     case AV_OPT_TYPE_SAMPLE_FMT:
719         ret = snprintf(buf, sizeof(buf), "%s", (char *)av_x_if_null(av_get_sample_fmt_name(*(enum AVSampleFormat *)dst), "none"));
720         break;
721     case AV_OPT_TYPE_DURATION:
722         i64 = *(int64_t *)dst;
723         ret = snprintf(buf, sizeof(buf), "%"PRIi64"d:%02d:%02d.%06d",
724                        i64 / 3600000000, (int)((i64 / 60000000) % 60),
725                        (int)((i64 / 1000000) % 60), (int)(i64 % 1000000));
726         break;
727     case AV_OPT_TYPE_COLOR:
728         ret = snprintf(buf, sizeof(buf), "0x%02x%02x%02x%02x", ((int *)dst)[0], ((int *)dst)[1], ((int *)dst)[2], ((int *)dst)[3]);
729         break;
730     case AV_OPT_TYPE_CHANNEL_LAYOUT:
731         i64 = *(int64_t *)dst;
732         ret = snprintf(buf, sizeof(buf), "0x%"PRIx64, i64);
733         break;
734     default:
735         return AVERROR(EINVAL);
736     }
737
738     if (ret >= sizeof(buf))
739         return AVERROR(EINVAL);
740     *out_val = av_strdup(buf);
741     return 0;
742 }
743
744 static int get_number(void *obj, const char *name, const AVOption **o_out, double *num, int *den, int64_t *intnum,
745                       int search_flags)
746 {
747     void *dst, *target_obj;
748     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
749     if (!o || !target_obj)
750         goto error;
751
752     dst = ((uint8_t*)target_obj) + o->offset;
753
754     if (o_out) *o_out= o;
755
756     return read_number(o, dst, num, den, intnum);
757
758 error:
759     *den=*intnum=0;
760     return -1;
761 }
762
763 #if FF_API_OLD_AVOPTIONS
764 double av_get_double(void *obj, const char *name, const AVOption **o_out)
765 {
766     int64_t intnum=1;
767     double num=1;
768     int den=1;
769
770     if (get_number(obj, name, o_out, &num, &den, &intnum, 0) < 0)
771         return NAN;
772     return num*intnum/den;
773 }
774
775 AVRational av_get_q(void *obj, const char *name, const AVOption **o_out)
776 {
777     int64_t intnum=1;
778     double num=1;
779     int den=1;
780
781     if (get_number(obj, name, o_out, &num, &den, &intnum, 0) < 0)
782         return (AVRational){0, 0};
783     if (num == 1.0 && (int)intnum == intnum)
784         return (AVRational){intnum, den};
785     else
786         return av_d2q(num*intnum/den, 1<<24);
787 }
788
789 int64_t av_get_int(void *obj, const char *name, const AVOption **o_out)
790 {
791     int64_t intnum=1;
792     double num=1;
793     int den=1;
794
795     if (get_number(obj, name, o_out, &num, &den, &intnum, 0) < 0)
796         return -1;
797     return num*intnum/den;
798 }
799 #endif
800
801 int av_opt_get_int(void *obj, const char *name, int search_flags, int64_t *out_val)
802 {
803     int64_t intnum = 1;
804     double     num = 1;
805     int   ret, den = 1;
806
807     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
808         return ret;
809     *out_val = num*intnum/den;
810     return 0;
811 }
812
813 int av_opt_get_double(void *obj, const char *name, int search_flags, double *out_val)
814 {
815     int64_t intnum = 1;
816     double     num = 1;
817     int   ret, den = 1;
818
819     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
820         return ret;
821     *out_val = num*intnum/den;
822     return 0;
823 }
824
825 int av_opt_get_q(void *obj, const char *name, int search_flags, AVRational *out_val)
826 {
827     int64_t intnum = 1;
828     double     num = 1;
829     int   ret, den = 1;
830
831     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
832         return ret;
833
834     if (num == 1.0 && (int)intnum == intnum)
835         *out_val = (AVRational){intnum, den};
836     else
837         *out_val = av_d2q(num*intnum/den, 1<<24);
838     return 0;
839 }
840
841 int av_opt_get_image_size(void *obj, const char *name, int search_flags, int *w_out, int *h_out)
842 {
843     void *dst, *target_obj;
844     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
845     if (!o || !target_obj)
846         return AVERROR_OPTION_NOT_FOUND;
847     if (o->type != AV_OPT_TYPE_IMAGE_SIZE) {
848         av_log(obj, AV_LOG_ERROR,
849                "The value for option '%s' is not an image size.\n", name);
850         return AVERROR(EINVAL);
851     }
852
853     dst = ((uint8_t*)target_obj) + o->offset;
854     if (w_out) *w_out = *(int *)dst;
855     if (h_out) *h_out = *((int *)dst+1);
856     return 0;
857 }
858
859 int av_opt_get_video_rate(void *obj, const char *name, int search_flags, AVRational *out_val)
860 {
861     int64_t intnum = 1;
862     double     num = 1;
863     int   ret, den = 1;
864
865     if ((ret = get_number(obj, name, NULL, &num, &den, &intnum, search_flags)) < 0)
866         return ret;
867
868     if (num == 1.0 && (int)intnum == intnum)
869         *out_val = (AVRational){intnum, den};
870     else
871         *out_val = av_d2q(num*intnum/den, 1<<24);
872     return 0;
873 }
874
875 static int get_format(void *obj, const char *name, int search_flags, int *out_fmt,
876                       enum AVOptionType type, const char *desc)
877 {
878     void *dst, *target_obj;
879     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
880     if (!o || !target_obj)
881         return AVERROR_OPTION_NOT_FOUND;
882     if (o->type != type) {
883         av_log(obj, AV_LOG_ERROR,
884                "The value for option '%s' is not a %s format.\n", desc, name);
885         return AVERROR(EINVAL);
886     }
887
888     dst = ((uint8_t*)target_obj) + o->offset;
889     *out_fmt = *(int *)dst;
890     return 0;
891 }
892
893 int av_opt_get_pixel_fmt(void *obj, const char *name, int search_flags, enum AVPixelFormat *out_fmt)
894 {
895     return get_format(obj, name, search_flags, out_fmt, AV_OPT_TYPE_PIXEL_FMT, "pixel");
896 }
897
898 int av_opt_get_sample_fmt(void *obj, const char *name, int search_flags, enum AVSampleFormat *out_fmt)
899 {
900     return get_format(obj, name, search_flags, out_fmt, AV_OPT_TYPE_SAMPLE_FMT, "sample");
901 }
902
903 int av_opt_get_channel_layout(void *obj, const char *name, int search_flags, int64_t *cl)
904 {
905     void *dst, *target_obj;
906     const AVOption *o = av_opt_find2(obj, name, NULL, 0, search_flags, &target_obj);
907     if (!o || !target_obj)
908         return AVERROR_OPTION_NOT_FOUND;
909     if (o->type != AV_OPT_TYPE_CHANNEL_LAYOUT) {
910         av_log(obj, AV_LOG_ERROR,
911                "The value for option '%s' is not a channel layout.\n", name);
912         return AVERROR(EINVAL);
913     }
914
915     dst = ((uint8_t*)target_obj) + o->offset;
916     *cl = *(int64_t *)dst;
917     return 0;
918 }
919
920 int av_opt_flag_is_set(void *obj, const char *field_name, const char *flag_name)
921 {
922     const AVOption *field = av_opt_find(obj, field_name, NULL, 0, 0);
923     const AVOption *flag  = av_opt_find(obj, flag_name,
924                                         field ? field->unit : NULL, 0, 0);
925     int64_t res;
926
927     if (!field || !flag || flag->type != AV_OPT_TYPE_CONST ||
928         av_opt_get_int(obj, field_name, 0, &res) < 0)
929         return 0;
930     return res & flag->default_val.i64;
931 }
932
933 static void log_value(void *av_log_obj, int level, double d)
934 {
935     if      (d == INT_MAX) {
936         av_log(av_log_obj, level, "INT_MAX");
937     } else if (d == INT_MIN) {
938         av_log(av_log_obj, level, "INT_MIN");
939     } else if (d == UINT32_MAX) {
940         av_log(av_log_obj, level, "UINT32_MAX");
941     } else if (d == (double)INT64_MAX) {
942         av_log(av_log_obj, level, "I64_MAX");
943     } else if (d == INT64_MIN) {
944         av_log(av_log_obj, level, "I64_MIN");
945     } else if (d == FLT_MAX) {
946         av_log(av_log_obj, level, "FLT_MAX");
947     } else if (d == FLT_MIN) {
948         av_log(av_log_obj, level, "FLT_MIN");
949     } else if (d == -FLT_MAX) {
950         av_log(av_log_obj, level, "-FLT_MAX");
951     } else if (d == -FLT_MIN) {
952         av_log(av_log_obj, level, "-FLT_MIN");
953     } else if (d == DBL_MAX) {
954         av_log(av_log_obj, level, "DBL_MAX");
955     } else if (d == DBL_MIN) {
956         av_log(av_log_obj, level, "DBL_MIN");
957     } else if (d == -DBL_MAX) {
958         av_log(av_log_obj, level, "-DBL_MAX");
959     } else if (d == -DBL_MIN) {
960         av_log(av_log_obj, level, "-DBL_MIN");
961     } else {
962         av_log(av_log_obj, level, "%g", d);
963     }
964 }
965
966 static void opt_list(void *obj, void *av_log_obj, const char *unit,
967                      int req_flags, int rej_flags)
968 {
969     const AVOption *opt=NULL;
970     AVOptionRanges *r;
971     int i;
972
973     while ((opt = av_opt_next(obj, opt))) {
974         if (!(opt->flags & req_flags) || (opt->flags & rej_flags))
975             continue;
976
977         /* Don't print CONST's on level one.
978          * Don't print anything but CONST's on level two.
979          * Only print items from the requested unit.
980          */
981         if (!unit && opt->type==AV_OPT_TYPE_CONST)
982             continue;
983         else if (unit && opt->type!=AV_OPT_TYPE_CONST)
984             continue;
985         else if (unit && opt->type==AV_OPT_TYPE_CONST && strcmp(unit, opt->unit))
986             continue;
987         else if (unit && opt->type == AV_OPT_TYPE_CONST)
988             av_log(av_log_obj, AV_LOG_INFO, "     %-15s ", opt->name);
989         else
990             av_log(av_log_obj, AV_LOG_INFO, "  %s%-17s ",
991                    (opt->flags & AV_OPT_FLAG_FILTERING_PARAM) ? "" : "-",
992                    opt->name);
993
994         switch (opt->type) {
995             case AV_OPT_TYPE_FLAGS:
996                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<flags>");
997                 break;
998             case AV_OPT_TYPE_INT:
999                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<int>");
1000                 break;
1001             case AV_OPT_TYPE_INT64:
1002                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<int64>");
1003                 break;
1004             case AV_OPT_TYPE_DOUBLE:
1005                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<double>");
1006                 break;
1007             case AV_OPT_TYPE_FLOAT:
1008                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<float>");
1009                 break;
1010             case AV_OPT_TYPE_STRING:
1011                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<string>");
1012                 break;
1013             case AV_OPT_TYPE_RATIONAL:
1014                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<rational>");
1015                 break;
1016             case AV_OPT_TYPE_BINARY:
1017                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<binary>");
1018                 break;
1019             case AV_OPT_TYPE_IMAGE_SIZE:
1020                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<image_size>");
1021                 break;
1022             case AV_OPT_TYPE_VIDEO_RATE:
1023                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<video_rate>");
1024                 break;
1025             case AV_OPT_TYPE_PIXEL_FMT:
1026                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<pix_fmt>");
1027                 break;
1028             case AV_OPT_TYPE_SAMPLE_FMT:
1029                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<sample_fmt>");
1030                 break;
1031             case AV_OPT_TYPE_DURATION:
1032                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<duration>");
1033                 break;
1034             case AV_OPT_TYPE_COLOR:
1035                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<color>");
1036                 break;
1037             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1038                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "<channel_layout>");
1039                 break;
1040             case AV_OPT_TYPE_CONST:
1041             default:
1042                 av_log(av_log_obj, AV_LOG_INFO, "%-12s ", "");
1043                 break;
1044         }
1045         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_ENCODING_PARAM) ? 'E' : '.');
1046         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_DECODING_PARAM) ? 'D' : '.');
1047         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_FILTERING_PARAM)? 'F' : '.');
1048         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_VIDEO_PARAM   ) ? 'V' : '.');
1049         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_AUDIO_PARAM   ) ? 'A' : '.');
1050         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_SUBTITLE_PARAM) ? 'S' : '.');
1051         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_EXPORT)         ? 'X' : '.');
1052         av_log(av_log_obj, AV_LOG_INFO, "%c", (opt->flags & AV_OPT_FLAG_READONLY)       ? 'R' : '.');
1053
1054         if (opt->help)
1055             av_log(av_log_obj, AV_LOG_INFO, " %s", opt->help);
1056
1057         if (av_opt_query_ranges(&r, obj, opt->name, AV_OPT_SEARCH_FAKE_OBJ) >= 0) {
1058             switch (opt->type) {
1059             case AV_OPT_TYPE_INT:
1060             case AV_OPT_TYPE_INT64:
1061             case AV_OPT_TYPE_DOUBLE:
1062             case AV_OPT_TYPE_FLOAT:
1063             case AV_OPT_TYPE_RATIONAL:
1064                 for (i = 0; i < r->nb_ranges; i++) {
1065                     av_log(av_log_obj, AV_LOG_INFO, " (from ");
1066                     log_value(av_log_obj, AV_LOG_INFO, r->range[i]->value_min);
1067                     av_log(av_log_obj, AV_LOG_INFO, " to ");
1068                     log_value(av_log_obj, AV_LOG_INFO, r->range[i]->value_max);
1069                     av_log(av_log_obj, AV_LOG_INFO, ")");
1070                 }
1071                 break;
1072             }
1073             av_opt_freep_ranges(&r);
1074         }
1075
1076         if (opt->type != AV_OPT_TYPE_CONST  &&
1077             opt->type != AV_OPT_TYPE_BINARY &&
1078                 !((opt->type == AV_OPT_TYPE_COLOR      ||
1079                    opt->type == AV_OPT_TYPE_IMAGE_SIZE ||
1080                    opt->type == AV_OPT_TYPE_STRING     ||
1081                    opt->type == AV_OPT_TYPE_VIDEO_RATE) &&
1082                   !opt->default_val.str)) {
1083             av_log(av_log_obj, AV_LOG_INFO, " (default ");
1084             switch (opt->type) {
1085             case AV_OPT_TYPE_FLAGS:
1086                 av_log(av_log_obj, AV_LOG_INFO, "%"PRIX64, opt->default_val.i64);
1087                 break;
1088             case AV_OPT_TYPE_DURATION:
1089             case AV_OPT_TYPE_INT:
1090             case AV_OPT_TYPE_INT64:
1091                 log_value(av_log_obj, AV_LOG_INFO, opt->default_val.i64);
1092                 break;
1093             case AV_OPT_TYPE_DOUBLE:
1094             case AV_OPT_TYPE_FLOAT:
1095                 log_value(av_log_obj, AV_LOG_INFO, opt->default_val.dbl);
1096                 break;
1097             case AV_OPT_TYPE_RATIONAL: {
1098                 AVRational q = av_d2q(opt->default_val.dbl, INT_MAX);
1099                 av_log(av_log_obj, AV_LOG_INFO, "%d/%d", q.num, q.den); }
1100                 break;
1101             case AV_OPT_TYPE_PIXEL_FMT:
1102                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(av_get_pix_fmt_name(opt->default_val.i64), "none"));
1103                 break;
1104             case AV_OPT_TYPE_SAMPLE_FMT:
1105                 av_log(av_log_obj, AV_LOG_INFO, "%s", (char *)av_x_if_null(av_get_sample_fmt_name(opt->default_val.i64), "none"));
1106                 break;
1107             case AV_OPT_TYPE_COLOR:
1108             case AV_OPT_TYPE_IMAGE_SIZE:
1109             case AV_OPT_TYPE_STRING:
1110             case AV_OPT_TYPE_VIDEO_RATE:
1111                 av_log(av_log_obj, AV_LOG_INFO, "\"%s\"", opt->default_val.str);
1112                 break;
1113             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1114                 av_log(av_log_obj, AV_LOG_INFO, "0x%"PRIx64, opt->default_val.i64);
1115                 break;
1116             }
1117             av_log(av_log_obj, AV_LOG_INFO, ")");
1118         }
1119
1120         av_log(av_log_obj, AV_LOG_INFO, "\n");
1121         if (opt->unit && opt->type != AV_OPT_TYPE_CONST) {
1122             opt_list(obj, av_log_obj, opt->unit, req_flags, rej_flags);
1123         }
1124     }
1125 }
1126
1127 int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
1128 {
1129     if (!obj)
1130         return -1;
1131
1132     av_log(av_log_obj, AV_LOG_INFO, "%s AVOptions:\n", (*(AVClass**)obj)->class_name);
1133
1134     opt_list(obj, av_log_obj, NULL, req_flags, rej_flags);
1135
1136     return 0;
1137 }
1138
1139 void av_opt_set_defaults(void *s)
1140 {
1141 #if FF_API_OLD_AVOPTIONS
1142     av_opt_set_defaults2(s, 0, 0);
1143 }
1144
1145 void av_opt_set_defaults2(void *s, int mask, int flags)
1146 {
1147 #endif
1148     const AVClass *class = *(AVClass **)s;
1149     const AVOption *opt = NULL;
1150     while ((opt = av_opt_next(s, opt)) != NULL) {
1151         void *dst = ((uint8_t*)s) + opt->offset;
1152 #if FF_API_OLD_AVOPTIONS
1153         if ((opt->flags & mask) != flags)
1154             continue;
1155 #endif
1156
1157         if (opt->flags & AV_OPT_FLAG_READONLY)
1158             continue;
1159
1160         switch (opt->type) {
1161             case AV_OPT_TYPE_CONST:
1162                 /* Nothing to be done here */
1163             break;
1164             case AV_OPT_TYPE_FLAGS:
1165             case AV_OPT_TYPE_INT:
1166             case AV_OPT_TYPE_INT64:
1167             case AV_OPT_TYPE_DURATION:
1168             case AV_OPT_TYPE_CHANNEL_LAYOUT:
1169                 write_number(s, opt, dst, 1, 1, opt->default_val.i64);
1170             break;
1171             case AV_OPT_TYPE_DOUBLE:
1172             case AV_OPT_TYPE_FLOAT: {
1173                 double val;
1174                 val = opt->default_val.dbl;
1175                 write_number(s, opt, dst, val, 1, 1);
1176             }
1177             break;
1178             case AV_OPT_TYPE_RATIONAL: {
1179                 AVRational val;
1180                 val = av_d2q(opt->default_val.dbl, INT_MAX);
1181                 write_number(s, opt, dst, 1, val.den, val.num);
1182             }
1183             break;
1184             case AV_OPT_TYPE_COLOR:
1185                 set_string_color(s, opt, opt->default_val.str, dst);
1186                 break;
1187             case AV_OPT_TYPE_STRING:
1188                 set_string(s, opt, opt->default_val.str, dst);
1189                 break;
1190             case AV_OPT_TYPE_IMAGE_SIZE:
1191                 set_string_image_size(s, opt, opt->default_val.str, dst);
1192                 break;
1193             case AV_OPT_TYPE_VIDEO_RATE:
1194                 set_string_video_rate(s, opt, opt->default_val.str, dst);
1195                 break;
1196             case AV_OPT_TYPE_PIXEL_FMT:
1197 #if LIBAVUTIL_VERSION_MAJOR < 54
1198                 if (class->version && class->version < AV_VERSION_INT(52, 10, 100))
1199                     av_opt_set(s, opt->name, opt->default_val.str, 0);
1200                 else
1201 #endif
1202                     write_number(s, opt, dst, 1, 1, opt->default_val.i64);
1203                 break;
1204             case AV_OPT_TYPE_SAMPLE_FMT:
1205 #if LIBAVUTIL_VERSION_MAJOR < 54
1206                 if (class->version && class->version < AV_VERSION_INT(52, 10, 100))
1207                     av_opt_set(s, opt->name, opt->default_val.str, 0);
1208                 else
1209 #endif
1210                     write_number(s, opt, dst, 1, 1, opt->default_val.i64);
1211                 break;
1212             case AV_OPT_TYPE_BINARY:
1213                 /* Cannot set default for binary */
1214             break;
1215             default:
1216                 av_log(s, AV_LOG_DEBUG, "AVOption type %d of option %s not implemented yet\n", opt->type, opt->name);
1217         }
1218     }
1219 }
1220
1221 /**
1222  * Store the value in the field in ctx that is named like key.
1223  * ctx must be an AVClass context, storing is done using AVOptions.
1224  *
1225  * @param buf the string to parse, buf will be updated to point at the
1226  * separator just after the parsed key/value pair
1227  * @param key_val_sep a 0-terminated list of characters used to
1228  * separate key from value
1229  * @param pairs_sep a 0-terminated list of characters used to separate
1230  * two pairs from each other
1231  * @return 0 if the key/value pair has been successfully parsed and
1232  * set, or a negative value corresponding to an AVERROR code in case
1233  * of error:
1234  * AVERROR(EINVAL) if the key/value pair cannot be parsed,
1235  * the error code issued by av_opt_set() if the key/value pair
1236  * cannot be set
1237  */
1238 static int parse_key_value_pair(void *ctx, const char **buf,
1239                                 const char *key_val_sep, const char *pairs_sep)
1240 {
1241     char *key = av_get_token(buf, key_val_sep);
1242     char *val;
1243     int ret;
1244
1245     if (!key)
1246         return AVERROR(ENOMEM);
1247
1248     if (*key && strspn(*buf, key_val_sep)) {
1249         (*buf)++;
1250         val = av_get_token(buf, pairs_sep);
1251         if (!val) {
1252             av_freep(&key);
1253             return AVERROR(ENOMEM);
1254         }
1255     } else {
1256         av_log(ctx, AV_LOG_ERROR, "Missing key or no key/value separator found after key '%s'\n", key);
1257         av_free(key);
1258         return AVERROR(EINVAL);
1259     }
1260
1261     av_log(ctx, AV_LOG_DEBUG, "Setting entry with key '%s' to value '%s'\n", key, val);
1262
1263     ret = av_opt_set(ctx, key, val, AV_OPT_SEARCH_CHILDREN);
1264     if (ret == AVERROR_OPTION_NOT_FOUND)
1265         av_log(ctx, AV_LOG_ERROR, "Key '%s' not found.\n", key);
1266
1267     av_free(key);
1268     av_free(val);
1269     return ret;
1270 }
1271
1272 int av_set_options_string(void *ctx, const char *opts,
1273                           const char *key_val_sep, const char *pairs_sep)
1274 {
1275     int ret, count = 0;
1276
1277     if (!opts)
1278         return 0;
1279
1280     while (*opts) {
1281         if ((ret = parse_key_value_pair(ctx, &opts, key_val_sep, pairs_sep)) < 0)
1282             return ret;
1283         count++;
1284
1285         if (*opts)
1286             opts++;
1287     }
1288
1289     return count;
1290 }
1291
1292 #define WHITESPACES " \n\t"
1293
1294 static int is_key_char(char c)
1295 {
1296     return (unsigned)((c | 32) - 'a') < 26 ||
1297            (unsigned)(c - '0') < 10 ||
1298            c == '-' || c == '_' || c == '/' || c == '.';
1299 }
1300
1301 /**
1302  * Read a key from a string.
1303  *
1304  * The key consists of is_key_char characters and must be terminated by a
1305  * character from the delim string; spaces are ignored.
1306  *
1307  * @return  0 for success (even with ellipsis), <0 for failure
1308  */
1309 static int get_key(const char **ropts, const char *delim, char **rkey)
1310 {
1311     const char *opts = *ropts;
1312     const char *key_start, *key_end;
1313
1314     key_start = opts += strspn(opts, WHITESPACES);
1315     while (is_key_char(*opts))
1316         opts++;
1317     key_end = opts;
1318     opts += strspn(opts, WHITESPACES);
1319     if (!*opts || !strchr(delim, *opts))
1320         return AVERROR(EINVAL);
1321     opts++;
1322     if (!(*rkey = av_malloc(key_end - key_start + 1)))
1323         return AVERROR(ENOMEM);
1324     memcpy(*rkey, key_start, key_end - key_start);
1325     (*rkey)[key_end - key_start] = 0;
1326     *ropts = opts;
1327     return 0;
1328 }
1329
1330 int av_opt_get_key_value(const char **ropts,
1331                          const char *key_val_sep, const char *pairs_sep,
1332                          unsigned flags,
1333                          char **rkey, char **rval)
1334 {
1335     int ret;
1336     char *key = NULL, *val;
1337     const char *opts = *ropts;
1338
1339     if ((ret = get_key(&opts, key_val_sep, &key)) < 0 &&
1340         !(flags & AV_OPT_FLAG_IMPLICIT_KEY))
1341         return AVERROR(EINVAL);
1342     if (!(val = av_get_token(&opts, pairs_sep))) {
1343         av_free(key);
1344         return AVERROR(ENOMEM);
1345     }
1346     *ropts = opts;
1347     *rkey  = key;
1348     *rval  = val;
1349     return 0;
1350 }
1351
1352 int av_opt_set_from_string(void *ctx, const char *opts,
1353                            const char *const *shorthand,
1354                            const char *key_val_sep, const char *pairs_sep)
1355 {
1356     int ret, count = 0;
1357     const char *dummy_shorthand = NULL;
1358     char *av_uninit(parsed_key), *av_uninit(value);
1359     const char *key;
1360
1361     if (!opts)
1362         return 0;
1363     if (!shorthand)
1364         shorthand = &dummy_shorthand;
1365
1366     while (*opts) {
1367         ret = av_opt_get_key_value(&opts, key_val_sep, pairs_sep,
1368                                    *shorthand ? AV_OPT_FLAG_IMPLICIT_KEY : 0,
1369                                    &parsed_key, &value);
1370         if (ret < 0) {
1371             if (ret == AVERROR(EINVAL))
1372                 av_log(ctx, AV_LOG_ERROR, "No option name near '%s'\n", opts);
1373             else
1374                 av_log(ctx, AV_LOG_ERROR, "Unable to parse '%s': %s\n", opts,
1375                        av_err2str(ret));
1376             return ret;
1377         }
1378         if (*opts)
1379             opts++;
1380         if (parsed_key) {
1381             key = parsed_key;
1382             while (*shorthand) /* discard all remaining shorthand */
1383                 shorthand++;
1384         } else {
1385             key = *(shorthand++);
1386         }
1387
1388         av_log(ctx, AV_LOG_DEBUG, "Setting '%s' to value '%s'\n", key, value);
1389         if ((ret = av_opt_set(ctx, key, value, 0)) < 0) {
1390             if (ret == AVERROR_OPTION_NOT_FOUND)
1391                 av_log(ctx, AV_LOG_ERROR, "Option '%s' not found\n", key);
1392             av_free(value);
1393             av_free(parsed_key);
1394             return ret;
1395         }
1396
1397         av_free(value);
1398         av_free(parsed_key);
1399         count++;
1400     }
1401     return count;
1402 }
1403
1404 void av_opt_free(void *obj)
1405 {
1406     const AVOption *o = NULL;
1407     while ((o = av_opt_next(obj, o)))
1408         if (o->type == AV_OPT_TYPE_STRING || o->type == AV_OPT_TYPE_BINARY)
1409             av_freep((uint8_t *)obj + o->offset);
1410 }
1411
1412 int av_opt_set_dict(void *obj, AVDictionary **options)
1413 {
1414     AVDictionaryEntry *t = NULL;
1415     AVDictionary    *tmp = NULL;
1416     int ret = 0;
1417
1418     while ((t = av_dict_get(*options, "", t, AV_DICT_IGNORE_SUFFIX))) {
1419         ret = av_opt_set(obj, t->key, t->value, 0);
1420         if (ret == AVERROR_OPTION_NOT_FOUND)
1421             av_dict_set(&tmp, t->key, t->value, 0);
1422         else if (ret < 0) {
1423             av_log(obj, AV_LOG_ERROR, "Error setting option %s to value %s.\n", t->key, t->value);
1424             break;
1425         }
1426         ret = 0;
1427     }
1428     av_dict_free(options);
1429     *options = tmp;
1430     return ret;
1431 }
1432
1433 const AVOption *av_opt_find(void *obj, const char *name, const char *unit,
1434                             int opt_flags, int search_flags)
1435 {
1436     return av_opt_find2(obj, name, unit, opt_flags, search_flags, NULL);
1437 }
1438
1439 const AVOption *av_opt_find2(void *obj, const char *name, const char *unit,
1440                              int opt_flags, int search_flags, void **target_obj)
1441 {
1442     const AVClass  *c;
1443     const AVOption *o = NULL;
1444
1445     if(!obj)
1446         return NULL;
1447
1448     c= *(AVClass**)obj;
1449
1450     if (!c)
1451         return NULL;
1452
1453     if (search_flags & AV_OPT_SEARCH_CHILDREN) {
1454         if (search_flags & AV_OPT_SEARCH_FAKE_OBJ) {
1455             const AVClass *child = NULL;
1456             while (child = av_opt_child_class_next(c, child))
1457                 if (o = av_opt_find2(&child, name, unit, opt_flags, search_flags, NULL))
1458                     return o;
1459         } else {
1460             void *child = NULL;
1461             while (child = av_opt_child_next(obj, child))
1462                 if (o = av_opt_find2(child, name, unit, opt_flags, search_flags, target_obj))
1463                     return o;
1464         }
1465     }
1466
1467     while (o = av_opt_next(obj, o)) {
1468         if (!strcmp(o->name, name) && (o->flags & opt_flags) == opt_flags &&
1469             ((!unit && o->type != AV_OPT_TYPE_CONST) ||
1470              (unit  && o->type == AV_OPT_TYPE_CONST && o->unit && !strcmp(o->unit, unit)))) {
1471             if (target_obj) {
1472                 if (!(search_flags & AV_OPT_SEARCH_FAKE_OBJ))
1473                     *target_obj = obj;
1474                 else
1475                     *target_obj = NULL;
1476             }
1477             return o;
1478         }
1479     }
1480     return NULL;
1481 }
1482
1483 void *av_opt_child_next(void *obj, void *prev)
1484 {
1485     const AVClass *c = *(AVClass**)obj;
1486     if (c->child_next)
1487         return c->child_next(obj, prev);
1488     return NULL;
1489 }
1490
1491 const AVClass *av_opt_child_class_next(const AVClass *parent, const AVClass *prev)
1492 {
1493     if (parent->child_class_next)
1494         return parent->child_class_next(prev);
1495     return NULL;
1496 }
1497
1498 void *av_opt_ptr(const AVClass *class, void *obj, const char *name)
1499 {
1500     const AVOption *opt= av_opt_find2(&class, name, NULL, 0, AV_OPT_SEARCH_FAKE_OBJ, NULL);
1501     if(!opt)
1502         return NULL;
1503     return (uint8_t*)obj + opt->offset;
1504 }
1505
1506 int av_opt_query_ranges(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
1507 {
1508     const AVClass *c = *(AVClass**)obj;
1509     int (*callback)(AVOptionRanges **, void *obj, const char *key, int flags) = NULL;
1510
1511     if (c->version > (52 << 16 | 11 << 8))
1512         callback = c->query_ranges;
1513
1514     if (!callback)
1515         callback = av_opt_query_ranges_default;
1516
1517     return callback(ranges_arg, obj, key, flags);
1518 }
1519
1520 int av_opt_query_ranges_default(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
1521 {
1522     AVOptionRanges *ranges = av_mallocz(sizeof(*ranges));
1523     AVOptionRange **range_array = av_mallocz(sizeof(void*));
1524     AVOptionRange *range = av_mallocz(sizeof(*range));
1525     const AVOption *field = av_opt_find(obj, key, NULL, 0, flags);
1526     int ret;
1527
1528     *ranges_arg = NULL;
1529
1530     if (!ranges || !range || !range_array || !field) {
1531         ret = AVERROR(ENOMEM);
1532         goto fail;
1533     }
1534
1535     ranges->range = range_array;
1536     ranges->range[0] = range;
1537     ranges->nb_ranges = 1;
1538     range->is_range = 1;
1539     range->value_min = field->min;
1540     range->value_max = field->max;
1541
1542     switch (field->type) {
1543     case AV_OPT_TYPE_INT:
1544     case AV_OPT_TYPE_INT64:
1545     case AV_OPT_TYPE_PIXEL_FMT:
1546     case AV_OPT_TYPE_SAMPLE_FMT:
1547     case AV_OPT_TYPE_FLOAT:
1548     case AV_OPT_TYPE_DOUBLE:
1549     case AV_OPT_TYPE_DURATION:
1550     case AV_OPT_TYPE_COLOR:
1551     case AV_OPT_TYPE_CHANNEL_LAYOUT:
1552         break;
1553     case AV_OPT_TYPE_STRING:
1554         range->component_min = 0;
1555         range->component_max = 0x10FFFF; // max unicode value
1556         range->value_min = -1;
1557         range->value_max = INT_MAX;
1558         break;
1559     case AV_OPT_TYPE_RATIONAL:
1560         range->component_min = INT_MIN;
1561         range->component_max = INT_MAX;
1562         break;
1563     case AV_OPT_TYPE_IMAGE_SIZE:
1564         range->component_min = 0;
1565         range->component_max = INT_MAX/128/8;
1566         range->value_min = 0;
1567         range->value_max = INT_MAX/8;
1568         break;
1569     case AV_OPT_TYPE_VIDEO_RATE:
1570         range->component_min = 1;
1571         range->component_max = INT_MAX;
1572         range->value_min = 1;
1573         range->value_max = INT_MAX;
1574         break;
1575     default:
1576         ret = AVERROR(ENOSYS);
1577         goto fail;
1578     }
1579
1580     *ranges_arg = ranges;
1581     return 0;
1582 fail:
1583     av_free(ranges);
1584     av_free(range);
1585     av_free(range_array);
1586     return ret;
1587 }
1588
1589 void av_opt_freep_ranges(AVOptionRanges **rangesp)
1590 {
1591     int i;
1592     AVOptionRanges *ranges = *rangesp;
1593
1594     for (i = 0; i < ranges->nb_ranges; i++) {
1595         AVOptionRange *range = ranges->range[i];
1596         av_freep(&range->str);
1597         av_freep(&ranges->range[i]);
1598     }
1599     av_freep(&ranges->range);
1600     av_freep(rangesp);
1601 }
1602
1603 #ifdef TEST
1604
1605 typedef struct TestContext
1606 {
1607     const AVClass *class;
1608     int num;
1609     int toggle;
1610     char *string;
1611     int flags;
1612     AVRational rational;
1613     AVRational video_rate;
1614     int w, h;
1615     enum AVPixelFormat pix_fmt;
1616     enum AVSampleFormat sample_fmt;
1617     int64_t duration;
1618     uint8_t color[4];
1619     int64_t channel_layout;
1620 } TestContext;
1621
1622 #define OFFSET(x) offsetof(TestContext, x)
1623
1624 #define TEST_FLAG_COOL 01
1625 #define TEST_FLAG_LAME 02
1626 #define TEST_FLAG_MU   04
1627
1628 static const AVOption test_options[]= {
1629 {"num",      "set num",        OFFSET(num),      AV_OPT_TYPE_INT,      {.i64 = 0},       0,        100                 },
1630 {"toggle",   "set toggle",     OFFSET(toggle),   AV_OPT_TYPE_INT,      {.i64 = 0},       0,        1                   },
1631 {"rational", "set rational",   OFFSET(rational), AV_OPT_TYPE_RATIONAL, {.dbl = 0},       0,        10                  },
1632 {"string",   "set string",     OFFSET(string),   AV_OPT_TYPE_STRING,   {.str = "default"}, CHAR_MIN, CHAR_MAX          },
1633 {"flags",    "set flags",      OFFSET(flags),    AV_OPT_TYPE_FLAGS,    {.i64 = 0},       0,        INT_MAX, 0, "flags" },
1634 {"cool",     "set cool flag ", 0,                AV_OPT_TYPE_CONST,    {.i64 = TEST_FLAG_COOL}, INT_MIN,  INT_MAX, 0, "flags" },
1635 {"lame",     "set lame flag ", 0,                AV_OPT_TYPE_CONST,    {.i64 = TEST_FLAG_LAME}, INT_MIN,  INT_MAX, 0, "flags" },
1636 {"mu",       "set mu flag ",   0,                AV_OPT_TYPE_CONST,    {.i64 = TEST_FLAG_MU},   INT_MIN,  INT_MAX, 0, "flags" },
1637 {"size",     "set size",       OFFSET(w),        AV_OPT_TYPE_IMAGE_SIZE,{0},             0,        0                   },
1638 {"pix_fmt",  "set pixfmt",     OFFSET(pix_fmt),  AV_OPT_TYPE_PIXEL_FMT, {.i64 = AV_PIX_FMT_NONE}, -1, INT_MAX},
1639 {"sample_fmt", "set samplefmt", OFFSET(sample_fmt), AV_OPT_TYPE_SAMPLE_FMT, {.i64 = AV_SAMPLE_FMT_NONE}, -1, INT_MAX},
1640 {"video_rate", "set videorate", OFFSET(video_rate), AV_OPT_TYPE_VIDEO_RATE,  {.str = "25"}, 0,     0                   },
1641 {"duration", "set duration",   OFFSET(duration), AV_OPT_TYPE_DURATION, {.i64 = 0}, 0, INT64_MAX},
1642 {"color", "set color",   OFFSET(color), AV_OPT_TYPE_COLOR, {.str = "pink"}, 0, 0},
1643 {"cl", "set channel layout", OFFSET(channel_layout), AV_OPT_TYPE_CHANNEL_LAYOUT, {.i64 = AV_CH_LAYOUT_HEXAGONAL}, 0, INT64_MAX},
1644 {NULL},
1645 };
1646
1647 static const char *test_get_name(void *ctx)
1648 {
1649     return "test";
1650 }
1651
1652 static const AVClass test_class = {
1653     "TestContext",
1654     test_get_name,
1655     test_options
1656 };
1657
1658 int main(void)
1659 {
1660     int i;
1661
1662     printf("\nTesting av_set_options_string()\n");
1663     {
1664         TestContext test_ctx = { 0 };
1665         static const char * const options[] = {
1666             "",
1667             ":",
1668             "=",
1669             "foo=:",
1670             ":=foo",
1671             "=foo",
1672             "foo=",
1673             "foo",
1674             "foo=val",
1675             "foo==val",
1676             "toggle=:",
1677             "string=:",
1678             "toggle=1 : foo",
1679             "toggle=100",
1680             "toggle==1",
1681             "flags=+mu-lame : num=42: toggle=0",
1682             "num=42 : string=blahblah",
1683             "rational=0 : rational=1/2 : rational=1/-1",
1684             "rational=-1/0",
1685             "size=1024x768",
1686             "size=pal",
1687             "size=bogus",
1688             "pix_fmt=yuv420p",
1689             "pix_fmt=2",
1690             "pix_fmt=bogus",
1691             "sample_fmt=s16",
1692             "sample_fmt=2",
1693             "sample_fmt=bogus",
1694             "video_rate=pal",
1695             "video_rate=25",
1696             "video_rate=30000/1001",
1697             "video_rate=30/1.001",
1698             "video_rate=bogus",
1699             "duration=bogus",
1700             "duration=123.45",
1701             "duration=1\\:23\\:45.67",
1702             "color=blue",
1703             "color=0x223300",
1704             "color=0x42FF07AA",
1705             "cl=stereo+downmix",
1706             "cl=foo",
1707         };
1708
1709         test_ctx.class = &test_class;
1710         av_opt_set_defaults(&test_ctx);
1711
1712         av_log_set_level(AV_LOG_DEBUG);
1713
1714         for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
1715             av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
1716             if (av_set_options_string(&test_ctx, options[i], "=", ":") < 0)
1717                 av_log(&test_ctx, AV_LOG_ERROR, "Error setting options string: '%s'\n", options[i]);
1718             printf("\n");
1719         }
1720         av_opt_free(&test_ctx);
1721     }
1722
1723     printf("\nTesting av_opt_set_from_string()\n");
1724     {
1725         TestContext test_ctx = { 0 };
1726         static const char * const options[] = {
1727             "",
1728             "5",
1729             "5:hello",
1730             "5:hello:size=pal",
1731             "5:size=pal:hello",
1732             ":",
1733             "=",
1734             " 5 : hello : size = pal ",
1735             "a_very_long_option_name_that_will_need_to_be_ellipsized_around_here=42"
1736         };
1737         static const char * const shorthand[] = { "num", "string", NULL };
1738
1739         test_ctx.class = &test_class;
1740         av_opt_set_defaults(&test_ctx);
1741
1742         av_log_set_level(AV_LOG_DEBUG);
1743
1744         for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
1745             av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
1746             if (av_opt_set_from_string(&test_ctx, options[i], shorthand, "=", ":") < 0)
1747                 av_log(&test_ctx, AV_LOG_ERROR, "Error setting options string: '%s'\n", options[i]);
1748             printf("\n");
1749         }
1750         av_opt_free(&test_ctx);
1751     }
1752
1753     return 0;
1754 }
1755
1756 #endif