API: add gst_type_find_suggest_simple(), #533740.

Original commit message from CVS:
* docs/gst/gstreamer-sections.txt:
* gst/gsttypefind.c: (gst_type_find_suggest_simple):
* gst/gsttypefind.h:
* win32/common/libgstreamer.def:
API: add gst_type_find_suggest_simple(), #533740.

diff --git a/ChangeLog b/ChangeLog
index 834cfa6..9a0260c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2008-05-19  Tim-Philipp Müller  <tim.muller at collabora co uk>
 
+       * docs/gst/gstreamer-sections.txt:
+       * gst/gsttypefind.c: (gst_type_find_suggest_simple):
+       * gst/gsttypefind.h:
+       * win32/common/libgstreamer.def:
+         API: add gst_type_find_suggest_simple(), #533740.
+
+2008-05-19  Tim-Philipp Müller  <tim.muller at collabora co uk>
+
        * libs/gst/base/gstbasesrc.c: (gst_base_src_start):
          Use right error code when typefinding fails, so we can use
          the default (translated) error messages.

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index 21296c5..9d81be9 100644 (file)
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -2144,6 +2144,7 @@ GstTypeFindFunction
 GstTypeFindProbability
 gst_type_find_peek
 gst_type_find_suggest
+gst_type_find_suggest_simple
 gst_type_find_get_length
 gst_type_find_register
 <SUBSECTION Standard>

diff --git a/gst/gsttypefind.c b/gst/gsttypefind.c
index 219b03b..683ccc9 100644 (file)
--- a/gst/gsttypefind.c
+++ b/gst/gsttypefind.c
@@ -157,6 +157,57 @@ gst_type_find_suggest (GstTypeFind * find, guint probability,
 }
 
 /**
+ * gst_type_find_suggest_simple:
+ * @find: The #GstTypeFind object the function was called with
+ * @probability: The probability in percent that the suggestion is right
+ * @media_type: the media type of the suggested caps
+ * @fieldname: first field of the suggested caps, or NULL
+ * @...: additional arguments to the suggested caps in the same format as the
+ *     arguments passed to gst_structure_new() (ie. triplets of field name,
+ *     field GType and field value)
+ *
+ * If a #GstTypeFindFunction calls this function it suggests the caps with the
+ * given probability. A #GstTypeFindFunction may supply different suggestions
+ * in one call. It is up to the caller of the #GstTypeFindFunction to interpret
+ * these values.
+ *
+ * This function is similar to gst_type_find_suggest(), only that instead of
+ * passing a #GstCaps argument you can create the caps on the fly in the same
+ * way as you can with gst_caps_new_simple().
+ *
+ * Make sure you terminate the list of arguments with a NULL argument and that
+ * the values passed have the correct type (in terms of width in bytes when
+ * passed to the vararg function - this applies particularly to gdouble and
+ * guint64 arguments).
+ *
+ * Since: 0.10.20
+ */
+void
+gst_type_find_suggest_simple (GstTypeFind * find, guint probability,
+    const char *media_type, const char *fieldname, ...)
+{
+  GstStructure *structure;
+  va_list var_args;
+  GstCaps *caps;
+
+  g_return_if_fail (find->suggest != NULL);
+  g_return_if_fail (probability <= 100);
+  g_return_if_fail (media_type != NULL);
+
+  caps = gst_caps_new_empty ();
+
+  va_start (var_args, fieldname);
+  structure = gst_structure_new_valist (media_type, fieldname, var_args);
+  va_end (var_args);
+
+  gst_caps_append_structure (caps, structure);
+  g_return_if_fail (gst_caps_is_fixed (caps));
+
+  find->suggest (find->data, probability, caps);
+  gst_caps_unref (caps);
+}
+
+/**
  * gst_type_find_get_length:
  * @find: The #GstTypeFind the function was called with
  *

diff --git a/gst/gsttypefind.h b/gst/gsttypefind.h
index 5b613d7..6e1f049 100644 (file)
--- a/gst/gsttypefind.h
+++ b/gst/gsttypefind.h
@@ -100,6 +100,11 @@ void      gst_type_find_suggest    (GstTypeFind   * find,
                                     guint           probability,
                                     const GstCaps * caps);
 
+void      gst_type_find_suggest_simple (GstTypeFind * find,
+                                        guint         probability,
+                                        const char  * media_type,
+                                        const char  * fieldname, ...);
+
 guint64   gst_type_find_get_length (GstTypeFind   * find);
 
 /* registration interface */

diff --git a/win32/common/libgstreamer.def b/win32/common/libgstreamer.def
index d60e562..9be809b 100644 (file)
--- a/win32/common/libgstreamer.def
+++ b/win32/common/libgstreamer.def
@@ -907,6 +907,7 @@ EXPORTS
        gst_type_find_probability_get_type
        gst_type_find_register
        gst_type_find_suggest
+       gst_type_find_suggest_simple
        gst_type_register_static_full
        gst_update_registry
        gst_uri_construct