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