Go to the documentation of this file.
46 #define TYPE_BASE(type) ((type) & ~AV_OPT_TYPE_FLAG_ARRAY)
54 if (!last &&
class &&
class->option &&
class->option[0].name)
56 if (last && last[1].
name)
114 return (d && d->
sep) ? d->
sep :
',';
125 return (
unsigned *)((
const void *
const *)parray + 1);
151 for (
unsigned i = 0;
i < *count;
i++)
168 void **ptgt,
const AVOption **po,
void **pdst)
180 if (require_type && (o->
type != require_type)) {
182 "Tried to set option '%s' of type %s from value of type %s, "
189 unsigned *state_flags =
NULL;
198 class->state_flags_offset)
199 state_flags = (
unsigned*)((uint8_t*)tgt +
class->state_flags_offset);
201 if (!state_flags && obj != tgt) {
207 class->state_flags_offset)
208 state_flags = (
unsigned*)((uint8_t*)obj +
class->state_flags_offset);
213 "so cannot be set after the object has been initialized\n",
215 #if LIBAVUTIL_VERSION_MAJOR >= 60
229 *pdst = ((uint8_t *)tgt) + o->
offset;
237 if ((!
r.num || !
r.den) && d)
246 *intnum = *(
unsigned int*)
dst;
256 *intnum = *(
int *)
dst;
259 *intnum = *(
unsigned int *)
dst;
267 *num = *(
float *)
dst;
270 *num = *(
double *)
dst;
288 (!den || o->
max * den < num * intnum || o->
min * den > num * intnum)) {
289 num = den ? num * intnum / den : (num && intnum ?
INFINITY :
NAN);
295 double d = num*intnum/den;
296 if (d < -1.5 || d > 0xFFFFFFFF+0.5 || (
llrint(d*256) & 255)) {
298 "Value %f for parameter '%s' is not a valid set of 32bit integer flags\n",
299 num*intnum/den, o->
name);
315 *(
int *)
dst =
llrint(num / den) * intnum;
319 double d = num / den;
320 if (intnum == 1 && d == (
double)INT64_MAX) {
326 double d = num / den;
331 if (intnum == 1 && d == (
double)UINT64_MAX) {
332 *(uint64_t *)
dst = UINT64_MAX;
333 }
else if (d > INT64_MAX + 1ULL) {
334 *(uint64_t *)
dst = (
llrint(d - (INT64_MAX + 1ULL)) + (INT64_MAX + 1ULL))*intnum;
340 *(
float *)
dst = num * intnum / den;
343 *(
double *)
dst = num * intnum / den;
347 if ((
int) num == num)
359 if (
c >=
'0' &&
c <=
'9')
361 if (
c >=
'a' &&
c <=
'f')
363 if (
c >=
'A' &&
c <=
'F')
370 int *lendst = (
int *)(
dst + 1);
390 if (
a < 0 ||
b < 0) {
394 *ptr++ = (
a << 4) |
b;
411 #define DEFAULT_NUMVAL(opt) ((opt->type == AV_OPT_TYPE_INT64 || \
412 opt->type == AV_OPT_TYPE_UINT64 || \
413 opt->type == AV_OPT_TYPE_CONST || \
414 opt->type == AV_OPT_TYPE_FLAGS || \
415 opt->type == AV_OPT_TYPE_UINT || \
416 opt->type == AV_OPT_TYPE_INT) \
417 ? opt->default_val.i64 \
418 : opt->default_val.dbl)
428 if (sscanf(
val,
"%d%*1[:/]%d%c", &num, &den, &
c) == 2) {
443 if (*
val ==
'+' || *
val ==
'-')
445 for (;
i <
sizeof(buf) - 1 &&
val[
i] &&
val[
i] !=
'+' &&
val[
i] !=
'-';
i++)
499 intnum = *(
unsigned int*)
dst;
518 if (!
val || !strcmp(
val,
"none")) {
556 return val ?
"true" :
"false";
566 if (!strcmp(
val,
"auto")) {
574 n = strtol(
val, &end, 10);
575 if (
val + strlen(
val) != end)
579 if (n < o->
min || n > o->
max)
591 int fmt_nb,
int ((*get_fmt)(
const char *)),
const char *
desc)
595 if (!
val || !strcmp(
val,
"none")) {
601 fmt = strtol(
val, &tail, 0);
602 if (*tail || (
unsigned)fmt >= fmt_nb) {
604 "Unable to parse option value \"%s\" as %s\n",
val,
desc);
614 if(
min == 0 &&
max == 0) {
619 if (fmt < min || fmt >
max) {
621 "Value %d for parameter '%s' out of %s format range [%d - %d]\n",
671 const char *
val,
void *
dst)
681 const char *
val,
void *
dst)
731 if (usecs < o->
min || usecs > o->
max) {
733 usecs / 1000000.0, o->
name, o->
min / 1000000.0, o->
max / 1000000.0);
757 const char *
val,
void *
dst)
765 unsigned nb_elems = 0;
781 "Cannot assign more than %u elements to array option %s\n",
787 for (; *
val;
val++, p++) {
788 if (*
val ==
'\\' &&
val[1])
790 else if (*
val == sep) {
806 memset(
tmp, 0, elem_size);
817 if (arr && nb_elems < arr->size_min) {
819 "Cannot assign fewer than %u elements to array option %s\n",
825 *((
void **)
dst) = elems;
837 void *
dst, *target_obj;
849 #define OPT_EVAL_NUMBER(name, opttype, vartype) \
850 int av_opt_eval_ ## name(void *obj, const AVOption *o, \
851 const char *val, vartype *name ## _out) \
853 if (!o || o->type != opttype || o->flags & AV_OPT_FLAG_READONLY) \
854 return AVERROR(EINVAL); \
855 return set_string_number(obj, obj, o, val, name ## _out); \
867 int search_flags,
int require_type)
911 lendst = (
int *)(
dst + 1);
935 "Invalid negative size value %dx%d for size '%s'\n",
w,
h, o->
name);
964 if (fmt < min || fmt >
max) {
966 "Value %d for parameter '%s' out of %s format range [%d - %d]\n",
1020 if (d < 0 && d != INT64_MIN) {
1027 else if (d == INT64_MIN)
1029 else if (d > (
int64_t)3600*1000000)
1030 snprintf(buf,
size,
"%"PRId64
":%02d:%02d.%06d", d / 3600000000,
1031 (
int)((d / 60000000) % 60),
1032 (
int)((d / 1000000) % 60),
1033 (
int)(d % 1000000));
1034 else if (d > 60*1000000)
1036 (
int)(d / 60000000),
1037 (
int)((d / 1000000) % 60),
1038 (
int)(d % 1000000));
1042 (
int)(d % 1000000));
1043 e = buf + strlen(buf);
1044 while (e > buf && e[-1] ==
'0')
1046 if (e > buf && e[-1] ==
'.')
1051 const void *
dst,
int search_flags)
1088 if (*(uint8_t **)
dst) {
1096 return *pbuf ? 0 :
AVERROR(ENOMEM);
1105 len = *(
int *)(((uint8_t *)
dst) +
sizeof(uint8_t *));
1106 if ((uint64_t)
len * 2 + 1 > INT_MAX)
1114 bin = *(uint8_t **)
dst;
1115 for (
int i = 0;
i <
len;
i++)
1131 ret = strlen(*pbuf);
1135 ret =
snprintf(*pbuf, buf_len,
"0x%02x%02x%02x%02x",
1136 (
int)((uint8_t *)
dst)[0], (
int)((uint8_t *)
dst)[1],
1137 (
int)((uint8_t *)
dst)[2], (
int)((uint8_t *)
dst)[3]);
1160 uint8_t *str =
NULL;
1166 for (
unsigned i = 0;
i < count;
i++) {
1167 uint8_t buf[128], *
out = buf;
1175 out_len = strlen(
out);
1176 if (out_len > SIZE_MAX / 2 - !!
i ||
1177 !!
i + out_len * 2 > SIZE_MAX - str_len - 1) {
1190 str[str_len++] = sep;
1193 for (
unsigned j = 0; j < out_len; j++) {
1195 if (
val == sep ||
val ==
'\\')
1196 str[str_len++] =
'\\';
1197 str[str_len++] =
val;
1217 void *
dst, *target_obj;
1219 uint8_t *
out, buf[128];
1228 dst = (uint8_t *)target_obj + o->
offset;
1252 if (
ret >=
sizeof(buf))
1255 return *out_val ? 0 :
AVERROR(ENOMEM);
1261 void *
dst, *target_obj;
1263 if (!o || !target_obj)
1268 dst = ((uint8_t *)target_obj) + o->
offset;
1284 *out_val = num * intnum / den;
1296 *out_val = num * intnum / den;
1309 if (num == 1.0 && (
int)intnum == intnum)
1318 void *
dst, *target_obj;
1320 if (!o || !target_obj)
1324 "The value for option '%s' is not a image size.\n",
name);
1328 dst = ((uint8_t*)target_obj) + o->
offset;
1329 if (w_out) *w_out = *(
int *)
dst;
1330 if (h_out) *h_out = *((
int *)
dst+1);
1342 void *
dst, *target_obj;
1344 if (!o || !target_obj)
1348 "The value for option '%s' is not a %s format.\n",
desc,
name);
1352 dst = ((uint8_t*)target_obj) + o->
offset;
1353 *out_fmt = *(
int *)
dst;
1369 void *
dst, *target_obj;
1371 if (!o || !target_obj)
1375 "The value for option '%s' is not a channel layout.\n",
name);
1379 dst = ((uint8_t*)target_obj) + o->
offset;
1389 if (!o || !target_obj)
1409 return res &
flag->default_val.i64;
1416 }
else if (
i == INT_MIN) {
1418 }
else if (
i == UINT32_MAX) {
1420 }
else if (
i == INT64_MAX) {
1422 }
else if (
i == INT64_MIN) {
1433 }
else if (d == INT_MIN) {
1435 }
else if (d == UINT32_MAX) {
1437 }
else if (d == (
double)INT64_MAX) {
1439 }
else if (d == INT64_MIN) {
1441 }
else if (d == FLT_MAX) {
1443 }
else if (d == FLT_MIN) {
1445 }
else if (d == -FLT_MAX) {
1447 }
else if (d == -FLT_MIN) {
1449 }
else if (d == DBL_MAX) {
1451 }
else if (d == DBL_MIN) {
1453 }
else if (d == -DBL_MAX) {
1455 }
else if (d == -DBL_MIN) {
1528 if (arr && arr->
def)
1534 switch (opt->
type) {
1591 static void opt_list(
void *obj,
void *av_log_obj,
const char *unit,
1592 int req_flags,
int rej_flags,
enum AVOptionType parent_type)
1599 if (!(opt->
flags & req_flags) || (opt->
flags & rej_flags))
1619 log_type(av_log_obj, opt, parent_type);
1638 switch (opt->
type) {
1646 for (
i = 0;
i <
r->nb_ranges;
i++) {
1666 int av_opt_show2(
void *obj,
void *av_log_obj,
int req_flags,
int rej_flags)
1673 opt_list(obj, av_log_obj,
NULL, req_flags, rej_flags, -1);
1700 (sep < 'a' || sep >
'z') &&
1701 (sep < 'A' || sep >
'Z') &&
1702 (sep < '0' || sep >
'9'));
1704 if (arr && arr->
def)
1710 switch (opt->
type) {
1784 const char *key_val_sep,
const char *pairs_sep)
1793 if (*
key && strspn(*buf, key_val_sep)) {
1818 const char *key_val_sep,
const char *pairs_sep)
1837 #define WHITESPACES " \n\t\r"
1841 return (
unsigned)((
c | 32) -
'a') < 26 ||
1842 (unsigned)(
c -
'0') < 10 ||
1843 c ==
'-' ||
c ==
'_' ||
c ==
'/' ||
c ==
'.';
1854 static int get_key(
const char **ropts,
const char *delim,
char **rkey)
1856 const char *
opts = *ropts;
1857 const char *key_start, *key_end;
1864 if (!*
opts || !strchr(delim, *
opts))
1867 if (!(*rkey =
av_malloc(key_end - key_start + 1)))
1869 memcpy(*rkey, key_start, key_end - key_start);
1870 (*rkey)[key_end - key_start] = 0;
1876 const char *key_val_sep,
const char *pairs_sep,
1878 char **rkey,
char **rval)
1882 const char *
opts = *ropts;
1898 const char *
const *shorthand,
1899 const char *key_val_sep,
const char *pairs_sep)
1902 const char *dummy_shorthand =
NULL;
1908 shorthand = &dummy_shorthand;
1911 char *parsed_key, *
value;
1914 &parsed_key, &
value);
1930 key = *(shorthand++);
1953 void *pitem = (uint8_t *)obj + o->
offset;
1992 int opt_flags,
int search_flags)
1998 int opt_flags,
int search_flags,
void **target_obj)
2021 if (o =
av_opt_find2(child,
name, unit, opt_flags, search_flags, target_obj))
2027 if (!strcmp(o->
name,
name) && (o->
flags & opt_flags) == opt_flags &&
2046 return c->child_next(obj, prev);
2065 return (uint8_t*)obj + opt->
offset;
2070 void *
dst,
const void *
src)
2073 const char *src_str = *(
const char *
const *)
src;
2074 char **dstp = (
char **)
dst;
2075 if (*dstp != src_str)
2083 const uint8_t *
const *src8 = (
const uint8_t *
const *)
src;
2084 uint8_t **dst8 = (uint8_t **)
dst;
2085 int len = *(
const int *)(src8 + 1);
2089 if (
len && !*dst8) {
2090 *(
int *)(dst8 + 1) = 0;
2093 *(
int *)(dst8 + 1) =
len;
2099 if (sdict != *ddictp)
2118 void **pdst,
const void *
const *psrc)
2124 if (*pdst == *psrc) {
2135 for (
unsigned i = 0;
i < nb_elems;
i++) {
2165 void *field_dst = (uint8_t *)
dst + o->
offset;
2166 void *field_src = (uint8_t *)
src + o->
offset;
2178 unsigned int *out_val)
2180 void *target_obj, *parray;
2184 if (!o || !target_obj)
2189 parray = (uint8_t *)target_obj + o->
offset;
2196 unsigned int start_elem,
unsigned int nb_elems,
2205 unsigned array_size;
2210 if (!o || !target_obj)
2216 parray = (uint8_t *)target_obj + o->
offset;
2219 if (start_elem >= array_size ||
2220 array_size - start_elem < nb_elems)
2223 for (
unsigned i = 0;
i < nb_elems;
i++) {
2225 void *
dst = (uint8_t*)out_val +
i * elem_size_out;
2232 uint8_t buf[128], *
out = buf;
2260 *(
int64_t*)
dst = (num == den) ? intnum : num * intnum / den;
2263 *(
double*)
dst = num * intnum / den;
2278 for (
unsigned i = 0;
i < nb_elems;
i++)
2284 unsigned int start_elem,
unsigned int nb_elems,
2295 unsigned *array_size, new_size;
2312 if (start_elem > *array_size)
2317 if (*array_size - start_elem < nb_elems)
2320 new_size = *array_size - nb_elems;
2322 if (start_elem >= UINT_MAX - nb_elems)
2325 new_size =
FFMAX(*array_size, start_elem + nb_elems);
2327 if (nb_elems >= UINT_MAX - *array_size)
2330 new_size = *array_size + nb_elems;
2335 (arr->
size_min && new_size < arr->size_min)))
2340 void *
array = *(
void**)parray;
2342 for (
unsigned i = 0;
i < nb_elems;
i++) {
2350 elem_size * (*array_size - start_elem - nb_elems));
2356 *(
void**)parray =
array;
2360 *array_size = new_size;
2368 new_elems =
av_calloc(nb_elems, elem_size);
2373 for (
unsigned i = 0;
i < nb_elems;
i++) {
2375 const void *
src = (uint8_t*)
val +
i * elem_size_val;
2391 (!den || o->
max * den < num * intnum || o->
min * den > num * intnum)) {
2392 num = den ? num * intnum / den : (num && intnum ?
INFINITY :
NAN);
2394 "parameter '%s': value %f out of range [%g - %g]\n",
2429 if (start_elem == 0 && nb_elems == new_size) {
2432 *(
void**)parray = new_elems;
2433 *array_size = nb_elems;
2446 for (
unsigned i = start_elem;
i <
FFMIN(start_elem + nb_elems, *array_size);
i++)
2452 elem_size * (*array_size - start_elem));
2455 memcpy((uint8_t*)
array + elem_size * start_elem, new_elems, elem_size * nb_elems);
2460 *(
void**)parray =
array;
2461 *array_size = new_size;
2483 (*ranges_arg)->nb_components =
ret;
2498 if (!ranges || !
range || !range_array || !
field) {
2503 ranges->
range = range_array;
2507 range->is_range = 1;
2511 switch (
field->type) {
2525 range->component_min = 0;
2526 range->component_max = 0x10FFFF;
2527 range->value_min = -1;
2528 range->value_max = INT_MAX;
2531 range->component_min = INT_MIN;
2532 range->component_max = INT_MAX;
2535 range->component_min = 0;
2536 range->component_max = INT_MAX/128/8;
2537 range->value_min = 0;
2538 range->value_max = INT_MAX/8;
2541 range->component_min = 1;
2542 range->component_max = INT_MAX;
2543 range->value_min = 1;
2544 range->value_max = INT_MAX;
2551 *ranges_arg = ranges;
2636 str = *(
char **)
dst;
2656 int opt_size = *(
int *)((
void **)
dst + 1);
2657 void *opt_ptr = *(
void **)
dst;
2666 ret = !memcmp(opt_ptr,
tmp.data,
tmp.size);
2683 }
while (en1 && en2 && !strcmp(en1->
key, en2->
key) && !strcmp(en1->
value, en2->
value));
2685 return (!en1 && !en2);
2692 return (
w == *(
int *)
dst) && (
h == *((
int *)
dst+1));
2701 uint8_t
color[4] = {0, 0, 0, 0};
2728 AVBPrint *bprint,
const char key_val_sep,
const char pairs_sep)
2734 const char special_chars[] = {pairs_sep, key_val_sep,
'\0'};
2739 key_val_sep, pairs_sep);
2749 else if (((o->
flags & opt_flags) != opt_flags))
2771 const char key_val_sep,
const char pairs_sep)
2776 if (pairs_sep ==
'\0' || key_val_sep ==
'\0' || pairs_sep == key_val_sep ||
2777 pairs_sep ==
'\\' || key_val_sep ==
'\\') {
2789 key_val_sep, pairs_sep);
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
static int set_string_bool(void *obj, const AVOption *o, const char *val, int *dst)
#define OPT_EVAL_NUMBER(name, opttype, vartype)
int av_opt_get_dict_val(void *obj, const char *name, int search_flags, AVDictionary **out_val)
#define AV_LOG_WARNING
Something somehow does not look correct.
#define AV_BPRINT_SIZE_UNLIMITED
int av_opt_set_image_size(void *obj, const char *name, int w, int h, int search_flags)
union AVOption::@454 default_val
Native access only, except when documented otherwise.
AVPixelFormat
Pixel format.
static void log_default(void *obj, void *av_log_obj, const AVOption *opt)
static void log_int_value(void *av_log_obj, int level, int64_t i)
int nb_components
Number of componentes.
void av_opt_set_defaults(void *s)
Set the values of all AVOption fields to their default values.
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
int av_opt_flag_is_set(void *obj, const char *field_name, const char *flag_name)
Check whether a particular flag is set in a flags field.
@ AV_OPT_TYPE_SAMPLE_FMT
Underlying C type is enum AVSampleFormat.
static int get_pix_fmt(const char *name)
const AVClass * av_opt_child_class_iterate(const AVClass *parent, void **iter)
Iterate over potential AVOptions-enabled children of parent.
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
char sep
Separator between array elements in string representations of this option, used by av_opt_set() and a...
AVOptionType
An option type determines:
May be set as default_val for AV_OPT_TYPE_FLAG_ARRAY options.
static int set_string_sample_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst)
int av_parse_color(uint8_t *rgba_color, const char *color_string, int slen, void *log_ctx)
Put the RGBA values that correspond to color_string in rgba_color.
@ AV_OPT_TYPE_VIDEO_RATE
Underlying C type is AVRational.
@ AV_OPT_FLAG_IMPLICIT_KEY
Accept to parse a value without a key; the key will then be returned as NULL.
const AVOptionArrayDef * arr
Used for AV_OPT_TYPE_FLAG_ARRAY options.
static const char * get_opt_const_name(void *obj, const char *unit, int64_t value)
int nb_ranges
Number of ranges per component.
int av_opt_set_double(void *obj, const char *name, double val, int search_flags)
int av_opt_set_from_string(void *ctx, const char *opts, const char *const *shorthand, const char *key_val_sep, const char *pairs_sep)
Parse the key-value pairs list in opts.
static int is_key_char(char c)
static int set_string_channel_layout(void *obj, const AVOption *o, const char *val, void *dst)
@ AV_OPT_TYPE_DURATION
Underlying C type is int64_t.
const AVOption * av_opt_find2(void *obj, const char *name, const char *unit, int opt_flags, int search_flags, void **target_obj)
Look for an option in an object.
const char * help
short English help text
int flags
A combination of AV_OPT_FLAG_*.
const struct AVClass *(* child_class_iterate)(void **iter)
Iterate over the AVClasses corresponding to potential AVOptions-enabled children.
static int opt_copy_array(void *logctx, const AVOption *o, void **pdst, const void *const *psrc)
@ AV_OPT_TYPE_RATIONAL
Underlying C type is AVRational.
static int set_number(void *obj, const char *name, double num, int den, int64_t intnum, int search_flags, int require_type)
static unsigned * opt_array_pcount(const void *parray)
size_t av_strlcatf(char *dst, size_t size, const char *fmt,...)
int av_opt_serialize(void *obj, int opt_flags, int flags, char **buffer, const char key_val_sep, const char pairs_sep)
Serialize object's options.
static const double const_values[]
@ AV_PIX_FMT_NB
number of pixel formats, DO NOT USE THIS if you want to link with shared libav* because the number of...
void * av_memdup(const void *p, size_t size)
Duplicate a buffer with av_malloc().
static AVRational double_to_rational(double d)
#define AV_OPT_SERIALIZE_SEARCH_CHILDREN
Serialize options in possible children of the given object.
@ AV_OPT_TYPE_BINARY
Underlying C type is a uint8_t* that is either NULL or points to an array allocated with the av_mallo...
int av_opt_is_set_to_default(void *obj, const AVOption *o)
Check if given option is set to its default value.
int offset
Native access only.
int av_opt_get_key_value(const char **ropts, const char *key_val_sep, const char *pairs_sep, unsigned flags, char **rkey, char **rval)
Extract a key-value pair from the beginning of a string.
static const char * get_bool_name(int val)
void av_opt_free(void *obj)
Free all allocated objects in obj.
#define AVERROR_OPTION_NOT_FOUND
Option not found.
static double val(void *priv, double ch)
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf type
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
#define AV_OPT_SERIALIZE_SKIP_DEFAULTS
Serialize options that are not set to default values only.
#define AV_OPT_FLAG_AUDIO_PARAM
static void opt_free_array(const AVOption *o, void *parray, unsigned *count)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
#define FF_ARRAY_ELEMS(a)
int av_channel_layout_describe(const AVChannelLayout *channel_layout, char *buf, size_t buf_size)
Get a human-readable string describing the channel layout properties.
const char * def
Native access only.
#define AV_OPT_ARRAY_REPLACE
May be used with av_opt_set_array() to signal that new elements should replace the existing ones in t...
static int opt_copy_elem(void *logctx, enum AVOptionType type, void *dst, const void *src)
void * av_realloc_array(void *ptr, size_t nmemb, size_t size)
@ AV_OPT_TYPE_DOUBLE
Underlying C type is double.
#define AV_OPT_FLAG_CHILD_CONSTS
Set if option constants can also reside in child objects.
int av_opt_set_dict_val(void *obj, const char *name, const AVDictionary *val, int search_flags)
int av_opt_set_pixel_fmt(void *obj, const char *name, enum AVPixelFormat fmt, int search_flags)
@ AV_OPT_TYPE_INT64
Underlying C type is int64_t.
#define av_assert0(cond)
assert() equivalent, that is always enabled.
int av_set_options_string(void *ctx, const char *opts, const char *key_val_sep, const char *pairs_sep)
Parse the key/value pairs list in opts.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
int av_opt_get_array_size(void *obj, const char *name, int search_flags, unsigned int *out_val)
For an array-type option, get the number of elements in the array.
#define AV_VERSION_INT(a, b, c)
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this field
int av_opt_set_array(void *obj, const char *name, int search_flags, unsigned int start_elem, unsigned int nb_elems, enum AVOptionType val_type, const void *val)
Add, replace, or remove elements for an array option.
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
#define AV_OPT_FLAG_BSF_PARAM
A generic parameter which can be set by the user for bit stream filtering.
int av_opt_get_pixel_fmt(void *obj, const char *name, int search_flags, enum AVPixelFormat *out_fmt)
static void callback(void *priv_data, int index, uint8_t *buf, int buf_size, int64_t time, enum dshowDeviceType devtype)
int av_opt_get_video_rate(void *obj, const char *name, int search_flags, AVRational *out_val)
unsigned size_max
Maximum number of elements in the array, 0 when unlimited.
static void log_type(void *av_log_obj, const AVOption *o, enum AVOptionType parent_type)
Describe the class of an AVClass context structure.
int av_opt_set_video_rate(void *obj, const char *name, AVRational val, int search_flags)
int av_opt_set_bin(void *obj, const char *name, const uint8_t *val, int len, int search_flags)
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
#define AV_DICT_MULTIKEY
Allow to store several equal keys in the dictionary.
static int opt_set_elem(void *obj, void *target_obj, const AVOption *o, const char *val, void *dst)
static void log_value(void *av_log_obj, int level, double d)
void av_bprint_escape(AVBPrint *dstbuf, const char *src, const char *special_chars, enum AVEscapeMode mode, int flags)
Escape the content in src and append it to dstbuf.
int av_opt_get_double(void *obj, const char *name, int search_flags, double *out_val)
Rational number (pair of numerator and denominator).
static int set_format(void *obj, const char *name, int fmt, int search_flags, enum AVOptionType type, const char *desc, int nb_fmts)
@ AV_OPT_TYPE_COLOR
Underlying C type is uint8_t[4].
@ AV_OPT_TYPE_IMAGE_SIZE
Underlying C type is two consecutive integers.
#define LIBAVUTIL_VERSION_MAJOR
@ AV_OPT_TYPE_DICT
Underlying C type is AVDictionary*.
int av_opt_get_sample_fmt(void *obj, const char *name, int search_flags, enum AVSampleFormat *out_fmt)
@ AV_CLASS_STATE_INITIALIZED
Object initialization has finished and it is now in the 'runtime' stage.
#define AV_OPT_SEARCH_FAKE_OBJ
The obj passed to av_opt_find() is fake – only a double pointer to AVClass instead of a required poin...
int av_parse_time(int64_t *timeval, const char *timestr, int duration)
Parse timestr and return in *time a corresponding number of microseconds.
AVOptionRange ** range
Array of option ranges.
static void opt_list(void *obj, void *av_log_obj, const char *unit, int req_flags, int rej_flags, enum AVOptionType parent_type)
double min
minimum valid value for the option
int av_opt_get_array(void *obj, const char *name, int search_flags, unsigned int start_elem, unsigned int nb_elems, enum AVOptionType out_type, void *out_val)
For an array-type option, retrieve the values of one or more array elements.
@ AV_OPT_TYPE_UINT
Underlying C type is unsigned int.
@ AV_OPT_TYPE_CHLAYOUT
Underlying C type is AVChannelLayout.
int av_opt_get_int(void *obj, const char *name, int search_flags, int64_t *out_val)
#define AV_OPT_FLAG_ENCODING_PARAM
A generic parameter which can be set by the user for muxing or encoding.
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
int av_opt_set_int(void *obj, const char *name, int64_t val, int search_flags)
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
static int opt_is_pod(enum AVOptionType type)
#define AV_OPT_FLAG_FILTERING_PARAM
A generic parameter which can be set by the user for filtering.
const AVOption * av_opt_find(void *obj, const char *name, const char *unit, int opt_flags, int search_flags)
Look for an option in an object.
A single allowed range of values, or a single allowed value.
@ AV_SAMPLE_FMT_NB
Number of sample formats. DO NOT USE if linking dynamically.
int av_expr_parse_and_eval(double *d, const char *s, const char *const *const_names, const double *const_values, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), void *opaque, int log_offset, void *log_ctx)
Parse and evaluate an expression.
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
An AVChannelLayout holds information about the channel layout of audio data.
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
@ AV_OPT_TYPE_FLAG_ARRAY
May be combined with another regular option type to declare an array option.
int av_opt_set_chlayout(void *obj, const char *name, const AVChannelLayout *channel_layout, int search_flags)
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
int av_reallocp(void *ptr, size_t size)
Allocate, reallocate, or free a block of memory through a pointer to a pointer.
static int set_string_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst, int fmt_nb, int((*get_fmt)(const char *)), const char *desc)
static int read_number(const AVOption *o, const void *dst, double *num, int *den, int64_t *intnum)
static int parse_key_value_pair(void *ctx, const char **buf, const char *key_val_sep, const char *pairs_sep)
Store the value in the field in ctx that is named like key.
static int hexchar2int(char c)
static const struct @452 opt_type_desc[]
The reader does not expect b to be semantically here and if the code is changed by maybe adding a a division or other the signedness will almost certainly be mistaken To avoid this confusion a new type was SUINT is the C unsigned type but it holds a signed int to use the same example SUINT a
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values.
int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
Show the obj options.
int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str)
Parse str and put in width_ptr and height_ptr the detected values.
static int set_string_video_rate(void *obj, const AVOption *o, const char *val, AVRational *dst)
static int get_sample_fmt(const char *name)
int av_channel_layout_compare(const AVChannelLayout *chl, const AVChannelLayout *chl1)
Check whether two channel layouts are semantically the same, i.e.
#define AV_LOG_INFO
Standard information.
#define DEFAULT_NUMVAL(opt)
static void * opt_array_pelem(const AVOption *o, void *array, unsigned idx)
static int get_number(void *obj, const char *name, double *num, int *den, int64_t *intnum, int search_flags)
@ AV_OPT_TYPE_FLOAT
Underlying C type is float.
#define AV_OPT_FLAG_READONLY
The option may not be set through the AVOptions API, only read.
int av_parse_video_rate(AVRational *rate, const char *arg)
Parse str and store the detected values in *rate.
#define AV_OPT_FLAG_DEPRECATED
Set if option is deprecated, users should refer to AVOption.help text for more information.
const AVOption * av_opt_next(const void *obj, const AVOption *last)
Iterate over all AVOptions belonging to obj.
int av_channel_layout_from_string(AVChannelLayout *channel_layout, const char *str)
Initialize a channel layout from a given string description.
#define i(width, name, range_min, range_max)
static int set_string_pixel_fmt(void *obj, const AVOption *o, const char *val, uint8_t *dst)
int av_opt_set_dict2(void *obj, AVDictionary **options, int search_flags)
Set all the options from a given dictionary on an object.
enum AVSampleFormat av_get_sample_fmt(const char *name)
Return a sample format corresponding to name, or AV_SAMPLE_FMT_NONE on error.
#define AV_OPT_FLAG_SUBTITLE_PARAM
static char * get_opt_flags_string(void *obj, const char *unit, int64_t value)
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
AVSampleFormat
Audio sample formats.
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default value
AVRational av_d2q(double d, int max)
Convert a double precision floating point number to a rational.
#define AV_OPT_FLAG_VIDEO_PARAM
static int set_string(void *obj, const AVOption *o, const char *val, uint8_t **dst)
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
#define AV_OPT_MULTI_COMPONENT_RANGE
Allows av_opt_query_ranges and av_opt_query_ranges_default to return more than one component for cert...
List of AVOptionRange structs.
void * av_calloc(size_t nmemb, size_t size)
static int get_key(const char **ropts, const char *delim, char **rkey)
Read a key from a string.
static int av_cmp_q(AVRational a, AVRational b)
Compare two rationals.
static int array[MAX_W *MAX_W]
static int set_string_color(void *obj, const AVOption *o, const char *val, uint8_t *dst)
static const char *const const_names[]
static int set_string_dict(void *obj, const AVOption *o, const char *val, uint8_t **dst)
enum AVPixelFormat av_get_pix_fmt(const char *name)
Return the pixel format corresponding to name.
static uint8_t opt_array_sep(const AVOption *o)
static int set_string_binary(void *obj, const AVOption *o, const char *val, uint8_t **dst)
static int opt_serialize(void *obj, int opt_flags, int flags, int *cnt, AVBPrint *bprint, const char key_val_sep, const char pairs_sep)
the frame and frame reference mechanism is intended to as much as expensive copies of that data while still allowing the filters to produce correct results The data is stored in buffers represented by AVFrame structures Several references can point to the same frame buffer
#define AV_OPT_FLAG_RUNTIME_PARAM
A generic parameter which can be set by the user at runtime.
@ AV_OPT_TYPE_INT
Underlying C type is int.
char * av_get_token(const char **buf, const char *term)
Unescape the given string until a non escaped terminating char, and return the token corresponding to...
void av_channel_layout_uninit(AVChannelLayout *channel_layout)
Free any allocated data in the channel layout and reset the channel count to 0.
int av_match_name(const char *name, const char *names)
Match instances of a name in a comma-separated list of names.
int av_dict_parse_string(AVDictionary **pm, const char *str, const char *key_val_sep, const char *pairs_sep, int flags)
Parse the key/value pairs list and add the parsed entries to a dictionary.
int av_opt_get_chlayout(void *obj, const char *name, int search_flags, AVChannelLayout *cl)
#define AV_OPT_SERIALIZE_OPT_FLAGS_EXACT
Serialize options that exactly match opt_flags only.
void * av_opt_child_next(void *obj, void *prev)
Iterate over AVOptions-enabled children of obj.
@ AV_OPT_TYPE_PIXEL_FMT
Underlying C type is enum AVPixelFormat.
void av_opt_set_defaults2(void *s, int mask, int flags)
Set the values of all AVOption fields to their default values.
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
int av_opt_query_ranges_default(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
Get a default list of allowed ranges for the given option.
int av_opt_query_ranges(AVOptionRanges **ranges_arg, void *obj, const char *key, int flags)
Get a list of allowed ranges for the given option.
char * av_strdup(const char *s)
Duplicate a string.
#define AV_OPT_FLAG_DECODING_PARAM
A generic parameter which can be set by the user for demuxing or decoding.
unsigned size_min
Minimum number of elements in the array.
#define AV_OPT_ALLOW_NULL
In av_opt_get, return NULL if the option has a pointer type and is set to NULL, rather than returning...
const char * unit
The logical unit to which the option belongs.
void av_opt_freep_ranges(AVOptionRanges **rangesp)
Free an AVOptionRanges struct and set it to NULL.
static int set_string_number(void *obj, void *target_obj, const AVOption *o, const char *val, void *dst)
static int opt_set_array(void *obj, void *target_obj, const AVOption *o, const char *val, void *dst)
#define AV_OPT_FLAG_EXPORT
The option is intended for exporting values to the caller.
@ AV_OPT_TYPE_BOOL
Underlying C type is int.
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
int av_dict_get_string(const AVDictionary *m, char **buffer, const char key_val_sep, const char pairs_sep)
Get dictionary entries as a string.
int av_dict_copy(AVDictionary **dst, const AVDictionary *src, int flags)
Copy entries from one AVDictionary struct into another.
static void format_duration(char *buf, size_t size, int64_t d)
@ AV_ESCAPE_MODE_BACKSLASH
Use backslash escaping.
@ AV_OPT_TYPE_FLAGS
Underlying C type is unsigned int.
#define flags(name, subs,...)
static int set_string_image_size(void *obj, const AVOption *o, const char *val, int *dst)
int av_opt_get(void *obj, const char *name, int search_flags, uint8_t **out_val)
int av_opt_set_dict(void *obj, AVDictionary **options)
Set all the options from a given dictionary on an object.
int av_opt_get_image_size(void *obj, const char *name, int search_flags, int *w_out, int *h_out)
@ AV_OPT_TYPE_STRING
Underlying C type is a uint8_t* that is either NULL or points to a C string allocated with the av_mal...
int av_opt_set_q(void *obj, const char *name, AVRational val, int search_flags)
int av_opt_set_sample_fmt(void *obj, const char *name, enum AVSampleFormat fmt, int search_flags)
void av_bprint_append_data(AVBPrint *buf, const char *data, unsigned size)
Append data to a print buffer.
double max
maximum valid value for the option
@ AV_OPT_TYPE_CONST
Special option type for declaring named constants.
const AVDictionaryEntry * av_dict_iterate(const AVDictionary *m, const AVDictionaryEntry *prev)
Iterate over a dictionary.
static void opt_free_elem(enum AVOptionType type, void *ptr)
int av_opt_is_set_to_default_by_name(void *obj, const char *name, int search_flags)
Check if given option is set to its default value.
static int opt_set_init(void *obj, const char *name, int search_flags, int require_type, void **ptgt, const AVOption **po, void **pdst)
Perform common setup for option-setting functions.
static int opt_get_elem(const AVOption *o, uint8_t **pbuf, size_t buf_len, const void *dst, int search_flags)
static void * av_x_if_null(const void *p, const void *x)
Return x default pointer in case p is NULL.
static int get_format(void *obj, const char *name, int search_flags, int *out_fmt, enum AVOptionType type, const char *desc)
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
static int opt_get_array(const AVOption *o, void *dst, uint8_t **out_val)
void * av_opt_ptr(const AVClass *class, void *obj, const char *name)
Gets a pointer to the requested field in a struct.
static int write_number(void *obj, const AVOption *o, void *dst, double num, int den, int64_t intnum)
@ AV_OPT_TYPE_UINT64
Underlying C type is uint64_t.
int av_opt_get_q(void *obj, const char *name, int search_flags, AVRational *out_val)