AVOptions: add AV_OPT_SEARCH_FAKE_OBJ flag for av_opt_find().
authorAnton Khirnov <anton@khirnov.net>
Tue, 23 Aug 2011 05:11:26 +0000 (07:11 +0200)
committerAnton Khirnov <anton@khirnov.net>
Sat, 3 Sep 2011 18:52:21 +0000 (20:52 +0200)
It allows to search for options only with AVClass, without allocating
the corresponding context.

doc/APIchanges
libavcodec/options.c
libavformat/options.c
libavutil/avutil.h
libavutil/opt.h

index a31268195ffddf69fa8f4489a311409a98fe06ca..240e613dda23ae375ea62ad0b64f6c4e6e4112a1 100644 (file)
@@ -13,6 +13,9 @@ libavutil:   2011-04-18
 
 API changes, most recent first:
 
+2011-08-xx - xxxxxxx - lavu 51.10.0
+  Add AV_OPT_SEARCH_FAKE_OBJ flag for av_opt_find() function.
+
 2011-08-xx - xxxxxx - lavu 51.9.0
   Add av_fifo_peek2(), deprecate av_fifo_peek().
 
index a715dfafcb1d223ebc7065baf64ebd637440748f..97525634d819a7037111bd33d84a6816c77e2f71 100644 (file)
@@ -44,7 +44,7 @@ static const AVOption *opt_find(void *obj, const char *name, const char *unit, i
     AVCodecContext *s = obj;
     AVCodec        *c = NULL;
 
-    if (s->priv_data) {
+    if (!(search_flags & AV_OPT_SEARCH_FAKE_OBJ) && s->priv_data) {
         if (s->codec->priv_class)
             return av_opt_find(s->priv_data, name, unit, opt_flags, search_flags);
         return NULL;
index 3ca8c834807284046ebdf5abd8ddf23f284ec463..5ea0b181cbdbc468e6f94ef95bc4044c30611245 100644 (file)
@@ -38,7 +38,7 @@ static const AVOption *opt_find(void *obj, const char *name, const char *unit, i
     AVFormatContext   *s = obj;
     AVInputFormat  *ifmt = NULL;
     AVOutputFormat *ofmt = NULL;
-    if (s->priv_data) {
+    if (!(search_flags & AV_OPT_SEARCH_FAKE_OBJ) && s->priv_data) {
         if ((s->iformat && !s->iformat->priv_class) ||
             (s->oformat && !s->oformat->priv_class))
             return NULL;
index 484659a58ba86d9af40c13809d3f975375584fdd..24594107bc3cdaf256484f5894175ed2de21d0ec 100644 (file)
@@ -40,7 +40,7 @@
 #define AV_VERSION(a, b, c) AV_VERSION_DOT(a, b, c)
 
 #define LIBAVUTIL_VERSION_MAJOR 51
-#define LIBAVUTIL_VERSION_MINOR  9
+#define LIBAVUTIL_VERSION_MINOR 10
 #define LIBAVUTIL_VERSION_MICRO  0
 
 #define LIBAVUTIL_VERSION_INT   AV_VERSION_INT(LIBAVUTIL_VERSION_MAJOR, \
index 30aa54f5b6c021633d8c1c9249dcc1bd07d8d80c..21dac7c56952da2d5b777dcc0f84b95ae99da30f 100644 (file)
@@ -215,6 +215,13 @@ int av_opt_set_dict(void *obj, struct AVDictionary **options);
 
 #define AV_OPT_SEARCH_CHILDREN   0x0001 /**< Search in possible children of the
                                              given object first. */
+/**
+ *  The obj passed to av_opt_find() is fake -- only a double pointer to AVClass
+ *  instead of a required pointer to a struct containing AVClass. This is
+ *  useful for searching for options without needing to allocate the corresponding
+ *  object.
+ */
+#define AV_OPT_SEARCH_FAKE_OBJ   0x0002
 
 /**
  * Look for an option in an object. Consider only options which
@@ -222,6 +229,8 @@ int av_opt_set_dict(void *obj, struct AVDictionary **options);
  *
  * @param[in] obj A pointer to a struct whose first element is a
  *                pointer to an AVClass.
+ *                Alternatively a double pointer to an AVClass, if
+ *                AV_OPT_SEARCH_FAKE_OBJ search flag is set.
  * @param[in] name The name of the option to look for.
  * @param[in] unit When searching for named constants, name of the unit
  *                 it belongs to.