FFmpeg
opt.c
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 #include <limits.h>
20 #include <stdio.h>
21 
22 #include "libavutil/common.h"
23 #include "libavutil/channel_layout.h"
24 #include "libavutil/error.h"
25 #include "libavutil/log.h"
26 #include "libavutil/mem.h"
27 #include "libavutil/rational.h"
28 #include "libavutil/opt.h"
29 #include "libavutil/pixdesc.h"
30 
31 typedef struct TestContext {
32  const AVClass *class;
33  struct ChildContext *child;
34  int num;
35  int toggle;
36  char *string;
37  int flags;
38  AVRational rational;
39  AVRational video_rate;
40  int w, h;
41  enum AVPixelFormat pix_fmt;
42  enum AVSampleFormat sample_fmt;
43  int64_t duration;
44  uint8_t color[4];
45  AVChannelLayout channel_layout;
46  void *binary;
47  int binary_size;
48  void *binary1;
49  int binary_size1;
50  void *binary2;
51  int binary_size2;
52  int64_t num64;
53  float flt;
54  double dbl;
55  char *escape;
56  int bool1;
57  int bool2;
58  int bool3;
59  AVDictionary *dict1;
60  AVDictionary *dict2;
61 
62  int **array_int;
63  unsigned nb_array_int;
64 
65  char **array_str;
66  unsigned nb_array_str;
67 
68  AVDictionary **array_dict;
69  unsigned nb_array_dict;
70 } TestContext;
71 
72 #define OFFSET(x) offsetof(TestContext, x)
73 
74 #define TEST_FLAG_COOL 01
75 #define TEST_FLAG_LAME 02
76 #define TEST_FLAG_MU 04
77 
78 static const AVOptionArrayDef array_str = {
79  .sep = '|',
80  .def = "str0|str\\|1|str\\\\2",
81 };
82 
83 static const AVOptionArrayDef array_dict = {
84  // there are three levels of escaping - C string, array option, dict - so 8 backslashes are needed to get a literal one inside a dict key/val
85  .def = "k00=v\\\\\\\\00:k01=v\\,01,k10=v\\\\=1\\\\:0",
86 };
87 
88 static const AVOption test_options[]= {
89  {"num", "set num", OFFSET(num), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 100, 1 },
90  {"toggle", "set toggle", OFFSET(toggle), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, 1 },
91  {"rational", "set rational", OFFSET(rational), AV_OPT_TYPE_RATIONAL, { .dbl = 1 }, 0, 10, 1 },
92  {"string", "set string", OFFSET(string), AV_OPT_TYPE_STRING, { .str = "default" }, CHAR_MIN, CHAR_MAX, 1 },
93  {"escape", "set escape str", OFFSET(escape), AV_OPT_TYPE_STRING, { .str = "\\=," }, CHAR_MIN, CHAR_MAX, 1 },
94  {"flags", "set flags", OFFSET(flags), AV_OPT_TYPE_FLAGS, { .i64 = 1 }, 0, INT_MAX, 1, .unit = "flags" },
95  {"cool", "set cool flag", 0, AV_OPT_TYPE_CONST, { .i64 = TEST_FLAG_COOL }, INT_MIN, INT_MAX, 1, .unit = "flags" },
96  {"lame", "set lame flag", 0, AV_OPT_TYPE_CONST, { .i64 = TEST_FLAG_LAME }, INT_MIN, INT_MAX, 1, .unit = "flags" },
97  {"mu", "set mu flag", 0, AV_OPT_TYPE_CONST, { .i64 = TEST_FLAG_MU }, INT_MIN, INT_MAX, 1, .unit = "flags" },
98  {"size", "set size", OFFSET(w), AV_OPT_TYPE_IMAGE_SIZE, { .str="200x300" }, 0, 0, 1 },
99  {"pix_fmt", "set pixfmt", OFFSET(pix_fmt), AV_OPT_TYPE_PIXEL_FMT, { .i64 = AV_PIX_FMT_0BGR }, -1, INT_MAX, 1 },
100  {"sample_fmt", "set samplefmt", OFFSET(sample_fmt), AV_OPT_TYPE_SAMPLE_FMT, { .i64 = AV_SAMPLE_FMT_S16 }, -1, INT_MAX, 1 },
101  {"video_rate", "set videorate", OFFSET(video_rate), AV_OPT_TYPE_VIDEO_RATE, { .str = "25" }, 0, INT_MAX, 1 },
102  {"duration", "set duration", OFFSET(duration), AV_OPT_TYPE_DURATION, { .i64 = 1000 }, 0, INT64_MAX, 1 },
103  {"color", "set color", OFFSET(color), AV_OPT_TYPE_COLOR, { .str = "pink" }, 0, 0, 1 },
104  {"cl", "set channel layout", OFFSET(channel_layout), AV_OPT_TYPE_CHLAYOUT, { .str = "hexagonal" }, 0, 0, 1 },
105  {"bin", "set binary value", OFFSET(binary), AV_OPT_TYPE_BINARY, { .str="62696e00" }, 0, 0, 1 },
106  {"bin1", "set binary value", OFFSET(binary1), AV_OPT_TYPE_BINARY, { .str=NULL }, 0, 0, 1 },
107  {"bin2", "set binary value", OFFSET(binary2), AV_OPT_TYPE_BINARY, { .str="" }, 0, 0, 1 },
108  {"num64", "set num 64bit", OFFSET(num64), AV_OPT_TYPE_INT64, { .i64 = 1 }, 0, 100, 1 },
109  {"flt", "set float", OFFSET(flt), AV_OPT_TYPE_FLOAT, { .dbl = 1.0 / 3 }, 0, 100, 1 },
110  {"dbl", "set double", OFFSET(dbl), AV_OPT_TYPE_DOUBLE, { .dbl = 1.0 / 3 }, 0, 100, 1 },
111  {"bool1", "set boolean value", OFFSET(bool1), AV_OPT_TYPE_BOOL, { .i64 = -1 }, -1, 1, 1 },
112  {"bool2", "set boolean value", OFFSET(bool2), AV_OPT_TYPE_BOOL, { .i64 = 1 }, -1, 1, 1 },
113  {"bool3", "set boolean value", OFFSET(bool3), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, 1 },
114  {"dict1", "set dictionary value", OFFSET(dict1), AV_OPT_TYPE_DICT, { .str = NULL}, 0, 0, 1 },
115  {"dict2", "set dictionary value", OFFSET(dict2), AV_OPT_TYPE_DICT, { .str = "happy=':-)'"}, 0, 0, 1 },
116  {"array_int", "array of ints", OFFSET(array_int), AV_OPT_TYPE_INT | AV_OPT_TYPE_FLAG_ARRAY, .max = INT_MAX, .flags = AV_OPT_FLAG_RUNTIME_PARAM },
117  {"array_str", "array of strings", OFFSET(array_str), AV_OPT_TYPE_STRING | AV_OPT_TYPE_FLAG_ARRAY, { .arr = &array_str }, .flags = AV_OPT_FLAG_RUNTIME_PARAM },
118  {"array_dict", "array of dicts", OFFSET(array_dict), AV_OPT_TYPE_DICT | AV_OPT_TYPE_FLAG_ARRAY, { .arr = &array_dict }, .flags = AV_OPT_FLAG_RUNTIME_PARAM },
119  { NULL },
120 };
121 
122 static const char *test_get_name(void *ctx)
123 {
124  return "test";
125 }
126 
127 typedef struct ChildContext {
128  const AVClass *class;
129  int64_t child_num64;
130  int child_num;
131 } ChildContext;
132 
133 #undef OFFSET
134 #define OFFSET(x) offsetof(ChildContext, x)
135 
136 static const AVOption child_options[]= {
137  {"child_num64", "set num 64bit", OFFSET(child_num64), AV_OPT_TYPE_INT64, { .i64 = 0 }, 0, 100, 1 },
138  {"child_num", "set child_num", OFFSET(child_num), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 100, 1 },
139  { NULL },
140 };
141 
142 static const char *child_get_name(void *ctx)
143 {
144  return "child";
145 }
146 
147 static const AVClass child_class = {
148  .class_name = "ChildContext",
149  .item_name = child_get_name,
150  .option = child_options,
151  .version = LIBAVUTIL_VERSION_INT,
152 };
153 
154 static void *test_child_next(void *obj, void *prev)
155 {
156  TestContext *test_ctx = obj;
157  if (!prev)
158  return test_ctx->child;
159  return NULL;
160 }
161 
162 static const AVClass test_class = {
163  .class_name = "TestContext",
164  .item_name = test_get_name,
165  .option = test_options,
166  .child_next = test_child_next,
167  .version = LIBAVUTIL_VERSION_INT,
168 };
169 
170 static void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
171 {
172  vfprintf(stdout, fmt, vl);
173 }
174 
175 int main(void)
176 {
177  int i;
178 
179  av_log_set_level(AV_LOG_DEBUG);
180  av_log_set_callback(log_callback_help);
181 
182  printf("Testing default values\n");
183  {
184  TestContext test_ctx = { 0 };
185  test_ctx.class = &test_class;
186  av_opt_set_defaults(&test_ctx);
187 
188  printf("num=%d\n", test_ctx.num);
189  printf("toggle=%d\n", test_ctx.toggle);
190  printf("string=%s\n", test_ctx.string);
191  printf("escape=%s\n", test_ctx.escape);
192  printf("flags=%d\n", test_ctx.flags);
193  printf("rational=%d/%d\n", test_ctx.rational.num, test_ctx.rational.den);
194  printf("video_rate=%d/%d\n", test_ctx.video_rate.num, test_ctx.video_rate.den);
195  printf("width=%d height=%d\n", test_ctx.w, test_ctx.h);
196  printf("pix_fmt=%s\n", av_get_pix_fmt_name(test_ctx.pix_fmt));
197  printf("sample_fmt=%s\n", av_get_sample_fmt_name(test_ctx.sample_fmt));
198  printf("duration=%"PRId64"\n", test_ctx.duration);
199  printf("color=%d %d %d %d\n", test_ctx.color[0], test_ctx.color[1], test_ctx.color[2], test_ctx.color[3]);
200  printf("channel_layout=%"PRId64"=%"PRId64"\n", test_ctx.channel_layout.u.mask, (int64_t)AV_CH_LAYOUT_HEXAGONAL);
201  if (test_ctx.binary)
202  printf("binary=%x %x %x %x\n", ((uint8_t*)test_ctx.binary)[0], ((uint8_t*)test_ctx.binary)[1], ((uint8_t*)test_ctx.binary)[2], ((uint8_t*)test_ctx.binary)[3]);
203  printf("binary_size=%d\n", test_ctx.binary_size);
204  printf("num64=%"PRId64"\n", test_ctx.num64);
205  printf("flt=%.6f\n", test_ctx.flt);
206  printf("dbl=%.6f\n", test_ctx.dbl);
207 
208  for (unsigned i = 0; i < test_ctx.nb_array_str; i++)
209  printf("array_str[%u]=%s\n", i, test_ctx.array_str[i]);
210 
211  for (unsigned i = 0; i < test_ctx.nb_array_dict; i++) {
212  AVDictionary *d = test_ctx.array_dict[i];
213  const AVDictionaryEntry *e = NULL;
214 
215  while ((e = av_dict_iterate(d, e)))
216  printf("array_dict[%u]: %s\t%s\n", i, e->key, e->value);
217  }
218 
219  av_opt_show2(&test_ctx, NULL, -1, 0);
220 
221  av_opt_free(&test_ctx);
222  }
223 
224  printf("\nTesting av_opt_is_set_to_default()\n");
225  {
226  int ret;
227  TestContext test_ctx = { 0 };
228  const AVOption *o = NULL;
229  test_ctx.class = &test_class;
230 
231  av_log_set_level(AV_LOG_QUIET);
232 
233  while (o = av_opt_next(&test_ctx, o)) {
234  ret = av_opt_is_set_to_default_by_name(&test_ctx, o->name, 0);
235  printf("name:%10s default:%d error:%s\n", o->name, !!ret, ret < 0 ? av_err2str(ret) : "");
236  }
237  av_opt_set_defaults(&test_ctx);
238  while (o = av_opt_next(&test_ctx, o)) {
239  ret = av_opt_is_set_to_default_by_name(&test_ctx, o->name, 0);
240  printf("name:%10s default:%d error:%s\n", o->name, !!ret, ret < 0 ? av_err2str(ret) : "");
241  }
242  av_opt_free(&test_ctx);
243  }
244 
245  printf("\nTesting av_opt_get/av_opt_set()\n");
246  {
247  TestContext test_ctx = { 0 };
248  TestContext test2_ctx = { 0 };
249  const AVOption *o = NULL;
250  char *val = NULL;
251  int ret;
252 
253  test_ctx.class = &test_class;
254  test2_ctx.class = &test_class;
255 
256  av_log_set_level(AV_LOG_QUIET);
257 
258  av_opt_set_defaults(&test_ctx);
259 
260  while (o = av_opt_next(&test_ctx, o)) {
261  char *value1 = NULL;
262  char *value2 = NULL;
263  int ret1 = AVERROR_BUG;
264  int ret2 = AVERROR_BUG;
265  int ret3 = AVERROR_BUG;
266 
267  if (o->type == AV_OPT_TYPE_CONST)
268  continue;
269 
270  ret1 = av_opt_get(&test_ctx, o->name, 0, (uint8_t **)&value1);
271  if (ret1 >= 0) {
272  ret2 = av_opt_set(&test2_ctx, o->name, value1, 0);
273  if (ret2 >= 0)
274  ret3 = av_opt_get(&test2_ctx, o->name, 0, (uint8_t **)&value2);
275  }
276 
277  printf("name: %-11s get: %-16s set: %-16s get: %-16s %s\n", o->name,
278  ret1 >= 0 ? value1 : av_err2str(ret1),
279  ret2 >= 0 ? "OK" : av_err2str(ret2),
280  ret3 >= 0 ? value2 : av_err2str(ret3),
281  ret1 >= 0 && ret2 >= 0 && ret3 >= 0 && !strcmp(value1, value2) ? "OK" : "Mismatch");
282  av_free(value1);
283  av_free(value2);
284  }
285 
286  // av_opt_set(NULL) with an array option resets it
287  ret = av_opt_set(&test_ctx, "array_dict", NULL, 0);
288  printf("av_opt_set(\"array_dict\", NULL) -> %d\n", ret);
289  printf("array_dict=%sNULL; nb_array_dict=%u\n",
290  test_ctx.array_dict ? "non-" : "", test_ctx.nb_array_dict);
291 
292  // av_opt_get() on an empty array should return a NULL string
293  ret = av_opt_get(&test_ctx, "array_dict", AV_OPT_ALLOW_NULL, (uint8_t**)&val);
294  printf("av_opt_get(\"array_dict\") -> %s\n", val ? val : "NULL");
295 
296  av_opt_free(&test_ctx);
297  av_opt_free(&test2_ctx);
298  }
299 
300  printf("\nTest av_opt_serialize()\n");
301  {
302  TestContext test_ctx = { 0 };
303  char *buf;
304  test_ctx.class = &test_class;
305 
306  av_log_set_level(AV_LOG_QUIET);
307 
308  av_opt_set_defaults(&test_ctx);
309  if (av_opt_serialize(&test_ctx, 0, 0, &buf, '=', ',') >= 0) {
310  printf("%s\n", buf);
311  av_opt_free(&test_ctx);
312  memset(&test_ctx, 0, sizeof(test_ctx));
313  test_ctx.class = &test_class;
314  av_set_options_string(&test_ctx, buf, "=", ",");
315  av_free(buf);
316  if (av_opt_serialize(&test_ctx, 0, 0, &buf, '=', ',') >= 0) {
317  ChildContext child_ctx = { 0 };
318  printf("%s\n", buf);
319  av_free(buf);
320  child_ctx.class = &child_class;
321  test_ctx.child = &child_ctx;
322  if (av_opt_serialize(&test_ctx, 0,
323  AV_OPT_SERIALIZE_SKIP_DEFAULTS|AV_OPT_SERIALIZE_SEARCH_CHILDREN,
324  &buf, '=', ',') >= 0) {
325  printf("%s\n", buf);
326  av_free(buf);
327  }
328  av_opt_free(&child_ctx);
329  test_ctx.child = NULL;
330  }
331  }
332  av_opt_free(&test_ctx);
333  }
334 
335  printf("\nTesting av_set_options_string()\n");
336  {
337  TestContext test_ctx = { 0 };
338  static const char * const options[] = {
339  "",
340  ":",
341  "=",
342  "foo=:",
343  ":=foo",
344  "=foo",
345  "foo=",
346  "foo",
347  "foo=val",
348  "foo==val",
349  "toggle=:",
350  "string=:",
351  "toggle=1 : foo",
352  "toggle=100",
353  "toggle==1",
354  "flags=+mu-lame : num=42: toggle=0",
355  "num=42 : string=blahblah",
356  "rational=0 : rational=1/2 : rational=1/-1",
357  "rational=-1/0",
358  "size=1024x768",
359  "size=pal",
360  "size=bogus",
361  "pix_fmt=yuv420p",
362  "pix_fmt=2",
363  "pix_fmt=bogus",
364  "sample_fmt=s16",
365  "sample_fmt=2",
366  "sample_fmt=bogus",
367  "video_rate=pal",
368  "video_rate=25",
369  "video_rate=30000/1001",
370  "video_rate=30/1.001",
371  "video_rate=bogus",
372  "duration=bogus",
373  "duration=123.45",
374  "duration=1\\:23\\:45.67",
375  "color=blue",
376  "color=0x223300",
377  "color=0x42FF07AA",
378  "cl=FL+FR",
379  "cl=foo",
380  "bin=boguss",
381  "bin=111",
382  "bin=ffff",
383  "num64=bogus",
384  "num64=44",
385  "num64=44.4",
386  "num64=-1",
387  "num64=101",
388  "flt=bogus",
389  "flt=2",
390  "flt=2.2",
391  "flt=-1",
392  "flt=101",
393  "dbl=bogus",
394  "dbl=2",
395  "dbl=2.2",
396  "dbl=-1",
397  "dbl=101",
398  "bool1=true",
399  "bool2=auto",
400  "dict1='happy=\\:-):sad=\\:-('",
401  "array_int=0,32,2147483647",
402  "array_int=2147483648", // out of range, should fail
403  };
404 
405  test_ctx.class = &test_class;
406  av_opt_set_defaults(&test_ctx);
407 
408  av_log_set_level(AV_LOG_QUIET);
409 
410  for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
411  int silence_log = !strcmp(options[i], "rational=-1/0"); // inf formating differs between platforms
412  av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
413  if (silence_log)
414  av_log_set_callback(NULL);
415  if (av_set_options_string(&test_ctx, options[i], "=", ":") < 0)
416  printf("Error '%s'\n", options[i]);
417  else
418  printf("OK '%s'\n", options[i]);
419  av_log_set_callback(log_callback_help);
420  }
421  av_opt_free(&test_ctx);
422  }
423 
424  printf("\nTesting av_opt_set_from_string()\n");
425  {
426  TestContext test_ctx = { 0 };
427  static const char * const options[] = {
428  "",
429  "5",
430  "5:hello",
431  "5:hello:size=pal",
432  "5:size=pal:hello",
433  ":",
434  "=",
435  " 5 : hello : size = pal ",
436  "a_very_long_option_name_that_will_need_to_be_ellipsized_around_here=42"
437  };
438  static const char * const shorthand[] = { "num", "string", NULL };
439 
440  test_ctx.class = &test_class;
441  av_opt_set_defaults(&test_ctx);
442 
443  av_log_set_level(AV_LOG_QUIET);
444 
445  for (i=0; i < FF_ARRAY_ELEMS(options); i++) {
446  av_log(&test_ctx, AV_LOG_DEBUG, "Setting options string '%s'\n", options[i]);
447  if (av_opt_set_from_string(&test_ctx, options[i], shorthand, "=", ":") < 0)
448  printf("Error '%s'\n", options[i]);
449  else
450  printf("OK '%s'\n", options[i]);
451  }
452  av_opt_free(&test_ctx);
453  }
454 
455  printf("\nTesting av_opt_find2()\n");
456  {
457  TestContext test_ctx = { 0 };
458  ChildContext child_ctx = { 0 };
459  void *target;
460  const AVOption *opt;
461 
462  test_ctx.class = &test_class;
463  child_ctx.class = &child_class;
464  test_ctx.child = &child_ctx;
465 
466  av_log_set_level(AV_LOG_QUIET);
467 
468  // Should succeed. num exists and has opt_flags 1
469  opt = av_opt_find2(&test_ctx, "num", NULL, 1, 0, &target);
470  if (opt && target == &test_ctx)
471  printf("OK '%s'\n", opt->name);
472  else
473  printf("Error 'num'\n");
474 
475  // Should fail. num64 exists but has opt_flags 1, not 2
476  opt = av_opt_find(&test_ctx, "num64", NULL, 2, 0);
477  if (opt)
478  printf("OK '%s'\n", opt->name);
479  else
480  printf("Error 'num64'\n");
481 
482  // Should fail. child_num exists but in a child object we're not searching
483  opt = av_opt_find(&test_ctx, "child_num", NULL, 0, 0);
484  if (opt)
485  printf("OK '%s'\n", opt->name);
486  else
487  printf("Error 'child_num'\n");
488 
489  // Should succeed. child_num exists in a child object we're searching
490  opt = av_opt_find2(&test_ctx, "child_num", NULL, 0, AV_OPT_SEARCH_CHILDREN, &target);
491  if (opt && target == &child_ctx)
492  printf("OK '%s'\n", opt->name);
493  else
494  printf("Error 'child_num'\n");
495 
496  // Should fail. foo doesn't exist
497  opt = av_opt_find(&test_ctx, "foo", NULL, 0, 0);
498  if (opt)
499  printf("OK '%s'\n", opt->name);
500  else
501  printf("Error 'foo'\n");
502  }
503 
504  return 0;
505 }
AV_OPT_SEARCH_CHILDREN
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
Definition: opt.h:522
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:71
level
uint8_t level
Definition: svq3.c:205
av_opt_set_defaults
void av_opt_set_defaults(void *s)
Set the values of all AVOption fields to their default values.
Definition: opt.c:1640
opt.h
TestContext::video_rate
AVRational video_rate
Definition: opt.c:39
AV_OPT_TYPE_SAMPLE_FMT
@ AV_OPT_TYPE_SAMPLE_FMT
Definition: opt.h:247
color
Definition: vf_paletteuse.c:512
AVOptionArrayDef::sep
char sep
Separator between array elements in string representations of this option, used by av_opt_set() and a...
Definition: opt.h:340
AV_LOG_QUIET
#define AV_LOG_QUIET
Print no output.
Definition: log.h:162
AVOptionArrayDef
May be set as default_val for AV_OPT_TYPE_FLAG_ARRAY options.
Definition: opt.h:312
TestContext::color
uint8_t color[4]
Definition: opt.c:44
AV_OPT_TYPE_VIDEO_RATE
@ AV_OPT_TYPE_VIDEO_RATE
offset must point to AVRational
Definition: opt.h:248
rational.h
ChildContext::class
const AVClass * class
Definition: opt.c:128
pixdesc.h
TestContext::binary_size
int binary_size
Definition: opt.c:47
w
uint8_t w
Definition: llviddspenc.c:38
AV_CH_LAYOUT_HEXAGONAL
#define AV_CH_LAYOUT_HEXAGONAL
Definition: channel_layout.h:220
av_opt_set_from_string
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.
Definition: opt.c:1858
AVOption
AVOption.
Definition: opt.h:346
test_get_name
static const char * test_get_name(void *ctx)
Definition: opt.c:122
main
int main(void)
Definition: opt.c:175
AV_OPT_TYPE_DURATION
@ AV_OPT_TYPE_DURATION
Definition: opt.h:249
av_opt_find2
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.
Definition: opt.c:1958
TEST_FLAG_LAME
#define TEST_FLAG_LAME
Definition: opt.c:75
TestContext::string
char * string
Definition: opt.c:36
AVDictionary
Definition: dict.c:34
AVChannelLayout::mask
uint64_t mask
This member must be used for AV_CHANNEL_ORDER_NATIVE, and may be used for AV_CHANNEL_ORDER_AMBISONIC ...
Definition: channel_layout.h:335
AV_OPT_TYPE_RATIONAL
@ AV_OPT_TYPE_RATIONAL
Definition: opt.h:240
TestContext::toggle
int toggle
Definition: opt.c:35
av_opt_serialize
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.
Definition: opt.c:2432
array_str
static const AVOptionArrayDef array_str
Definition: opt.c:78
TestContext::num64
int64_t num64
Definition: opt.c:52
AV_OPT_SERIALIZE_SEARCH_CHILDREN
#define AV_OPT_SERIALIZE_SEARCH_CHILDREN
Serialize options in possible children of the given object.
Definition: opt.h:932
TestContext::binary_size2
int binary_size2
Definition: opt.c:51
AV_OPT_TYPE_BINARY
@ AV_OPT_TYPE_BINARY
offset must point to a pointer immediately followed by an int for the length
Definition: opt.h:241
TestContext::duration
int64_t duration
Definition: opt.c:43
av_opt_free
void av_opt_free(void *obj)
Free all allocated objects in obj.
Definition: opt.c:1910
TestContext::flags
int flags
Definition: opt.c:37
val
static double val(void *priv, double ch)
Definition: aeval.c:78
av_opt_set
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
Definition: opt.c:740
AV_OPT_SERIALIZE_SKIP_DEFAULTS
#define AV_OPT_SERIALIZE_SKIP_DEFAULTS
Serialize options that are not set to default values only.
Definition: opt.h:930
AVRational::num
int num
Numerator.
Definition: rational.h:59
TestContext::dbl
double dbl
Definition: opt.c:54
FF_ARRAY_ELEMS
#define FF_ARRAY_ELEMS(a)
Definition: sinewin_tablegen.c:29
TestContext::binary
void * binary
Definition: opt.c:46
TestContext::class
const AVClass * class
Definition: opt.c:32
duration
int64_t duration
Definition: movenc.c:65
AVOptionArrayDef::def
const char * def
Native access only.
Definition: opt.h:319
TestContext::h
int h
Definition: opt.c:40
pix_fmt
static enum AVPixelFormat pix_fmt
Definition: demux_decode.c:41
AVDictionaryEntry::key
char * key
Definition: dict.h:90
AV_OPT_TYPE_DOUBLE
@ AV_OPT_TYPE_DOUBLE
Definition: opt.h:237
AV_OPT_TYPE_INT64
@ AV_OPT_TYPE_INT64
Definition: opt.h:236
av_set_options_string
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.
Definition: opt.c:1778
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:201
ctx
AVFormatContext * ctx
Definition: movenc.c:49
limits.h
child_options
static const AVOption child_options[]
Definition: opt.c:136
ChildContext::child_num
int child_num
Definition: opt.c:130
av_get_sample_fmt_name
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.
Definition: samplefmt.c:51
TestContext::bool1
int bool1
Definition: opt.c:56
child_get_name
static const char * child_get_name(void *ctx)
Definition: opt.c:142
TestContext::bool2
int bool2
Definition: opt.c:57
AVChannelLayout::u
union AVChannelLayout::@379 u
Details about which channels are present in this layout.
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
TestContext
Definition: opt.c:31
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
NULL
#define NULL
Definition: coverity.c:32
TEST_FLAG_COOL
#define TEST_FLAG_COOL
Definition: opt.c:74
TestContext::num
int num
Definition: opt.c:34
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AV_OPT_TYPE_COLOR
@ AV_OPT_TYPE_COLOR
Definition: opt.h:250
child_class
static const AVClass child_class
Definition: opt.c:147
AV_OPT_TYPE_IMAGE_SIZE
@ AV_OPT_TYPE_IMAGE_SIZE
offset must point to two consecutive integers
Definition: opt.h:245
AV_OPT_TYPE_DICT
@ AV_OPT_TYPE_DICT
Definition: opt.h:242
TestContext::pix_fmt
enum AVPixelFormat pix_fmt
Definition: opt.c:41
TestContext::flt
float flt
Definition: opt.c:53
AV_OPT_TYPE_CHLAYOUT
@ AV_OPT_TYPE_CHLAYOUT
Definition: opt.h:252
TestContext::w
int w
Definition: opt.c:40
TestContext::binary2
void * binary2
Definition: opt.c:50
TestContext::rational
AVRational rational
Definition: opt.c:38
error.h
options
const OptionDef options[]
av_opt_find
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.
Definition: opt.c:1952
av_log_set_callback
void av_log_set_callback(void(*callback)(void *, int, const char *, va_list))
Set the logging callback.
Definition: log.c:462
AVChannelLayout
An AVChannelLayout holds information about the channel layout of audio data.
Definition: channel_layout.h:303
AV_OPT_TYPE_FLAG_ARRAY
@ AV_OPT_TYPE_FLAG_ARRAY
May be combined with another regular option type to declare an array option.
Definition: opt.h:263
av_err2str
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition: error.h:122
OFFSET
#define OFFSET(x)
Definition: opt.c:134
TestContext::dict2
AVDictionary * dict2
Definition: opt.c:60
TEST_FLAG_MU
#define TEST_FLAG_MU
Definition: opt.c:76
printf
printf("static const uint8_t my_array[100] = {\n")
AVOption::name
const char * name
Definition: opt.h:347
ChildContext
Definition: teeproto.c:31
av_opt_show2
int av_opt_show2(void *obj, void *av_log_obj, int req_flags, int rej_flags)
Show the obj options.
Definition: opt.c:1628
AV_OPT_TYPE_FLOAT
@ AV_OPT_TYPE_FLOAT
Definition: opt.h:238
TestContext::escape
char * escape
Definition: opt.c:55
array_dict
static const AVOptionArrayDef array_dict
Definition: opt.c:83
ChildContext::child_num64
int64_t child_num64
Definition: opt.c:129
av_opt_next
const AVOption * av_opt_next(const void *obj, const AVOption *last)
Iterate over all AVOptions belonging to obj.
Definition: opt.c:48
av_log_set_level
void av_log_set_level(int level)
Set the log level.
Definition: log.c:447
TestContext::nb_array_int
unsigned nb_array_int
Definition: opt.c:63
TestContext::channel_layout
AVChannelLayout channel_layout
Definition: opt.c:45
log.h
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:256
TestContext::binary_size1
int binary_size1
Definition: opt.c:49
common.h
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:55
AV_SAMPLE_FMT_S16
@ AV_SAMPLE_FMT_S16
signed 16 bits
Definition: samplefmt.h:58
TestContext::nb_array_str
unsigned nb_array_str
Definition: opt.c:66
ret
ret
Definition: filter_design.txt:187
AV_PIX_FMT_0BGR
@ AV_PIX_FMT_0BGR
packed BGR 8:8:8, 32bpp, XBGRXBGR... X=unused/undefined
Definition: pixfmt.h:264
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:71
AVOption::type
enum AVOptionType type
Definition: opt.h:362
channel_layout.h
AVRational::den
int den
Denominator.
Definition: rational.h:60
AV_OPT_FLAG_RUNTIME_PARAM
#define AV_OPT_FLAG_RUNTIME_PARAM
A generic parameter which can be set by the user at runtime.
Definition: opt.h:294
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:235
log_callback_help
static void log_callback_help(void *ptr, int level, const char *fmt, va_list vl)
Definition: opt.c:170
TestContext::child
struct ChildContext * child
Definition: opt.c:33
AV_OPT_TYPE_PIXEL_FMT
@ AV_OPT_TYPE_PIXEL_FMT
Definition: opt.h:246
TestContext::array_dict
AVDictionary ** array_dict
Definition: opt.c:68
test_child_next
static void * test_child_next(void *obj, void *prev)
Definition: opt.c:154
mem.h
AV_OPT_ALLOW_NULL
#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...
Definition: opt.h:536
test_class
static const AVClass test_class
Definition: opt.c:162
av_free
#define av_free(p)
Definition: tableprint_vlc.h:33
AVDictionaryEntry
Definition: dict.h:89
TestContext::array_int
int ** array_int
Definition: opt.c:62
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:251
TestContext::binary1
void * binary1
Definition: opt.c:48
TestContext::nb_array_dict
unsigned nb_array_dict
Definition: opt.c:69
TestContext::dict1
AVDictionary * dict1
Definition: opt.c:59
TestContext::bool3
int bool3
Definition: opt.c:58
d
d
Definition: ffmpeg_filter.c:424
AV_OPT_TYPE_FLAGS
@ AV_OPT_TYPE_FLAGS
Definition: opt.h:234
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:474
AVERROR_BUG
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
Definition: error.h:52
av_opt_get
int av_opt_get(void *obj, const char *name, int search_flags, uint8_t **out_val)
Definition: opt.c:1147
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AVDictionaryEntry::value
char * value
Definition: dict.h:91
AV_OPT_TYPE_STRING
@ AV_OPT_TYPE_STRING
Definition: opt.h:239
TestContext::array_str
char ** array_str
Definition: opt.c:65
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Definition: opt.h:244
test_options
static const AVOption test_options[]
Definition: opt.c:88
TestContext::sample_fmt
enum AVSampleFormat sample_fmt
Definition: opt.c:42
av_dict_iterate
const AVDictionaryEntry * av_dict_iterate(const AVDictionary *m, const AVDictionaryEntry *prev)
Iterate over a dictionary.
Definition: dict.c:44
av_opt_is_set_to_default_by_name
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.
Definition: opt.c:2377
av_get_pix_fmt_name
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.
Definition: pixdesc.c:2885
Generated on Mon Apr 29 2024 19:22:49 for FFmpeg by   doxygen 1.8.17