From: Steve Baker <steve@stevebaker.org>
Date: Fri, 31 May 2002 08:17:15 +0000 (+0000)
Subject: add a rank to elementfactory for autoplugging
X-Git-Tag: BRANCH-RELEASE-0_4_0-ROOT~127
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=5d902beab8441a313268871e7d9cbd9e0579d7b4;p=platform%2Fupstream%2Fgstreamer.git

add a rank to elementfactory for autoplugging

Original commit message from CVS:
add a rank to elementfactory for autoplugging
---

diff --git a/gst/gstelement.h b/gst/gstelement.h
index 59b986a..c86bf09 100644
--- a/gst/gstelement.h
+++ b/gst/gstelement.h
@@ -304,6 +304,11 @@ struct _GstElementDetails {
 #define GST_IS_ELEMENT_FACTORY(obj) 		(G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_ELEMENT_FACTORY))
 #define GST_IS_ELEMENT_FACTORY_CLASS(klass) 	(G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_ELEMENT_FACTORY))
 
+#define GST_ELEMENT_RANK_PRIMARY    256
+#define GST_ELEMENT_RANK_SECONDARY  128
+#define GST_ELEMENT_RANK_MARGINAL   64
+#define GST_ELEMENT_RANK_NONE       0
+
 struct _GstElementFactory {
   GstPluginFeature feature;
 
@@ -315,6 +320,8 @@ struct _GstElementFactory {
 
   GList *padtemplates;
   guint16 numpadtemplates;
+
+  guint16 rank;			/* used by autoplug to prioritise elements to try */
 };
 
 struct _GstElementFactoryClass {
@@ -340,6 +347,8 @@ GstElement*		gst_element_factory_create		(GstElementFactory *factory,
 /* FIXME this name is wrong, probably so is the one above it */
 GstElement*		gst_element_factory_make		(const gchar *factoryname, const gchar *name);
 
+void			gst_element_factory_set_rank		(GstElementFactory *factory, guint16 rank);
+
 G_END_DECLS
 
 
diff --git a/gst/gstelementfactory.c b/gst/gstelementfactory.c
index 8505d04..a706cbf 100644
--- a/gst/gstelementfactory.c
+++ b/gst/gstelementfactory.c
@@ -360,6 +360,22 @@ gst_element_factory_can_sink_caps (GstElementFactory *factory,
   return FALSE;
 }
 
+/**
+ * gst_element_factory_set_rank  :
+ * @factory: factory to rank
+ * @rank: rank value - higher number means more priority rank
+ *
+ * Specifies a rank for the element so that 
+ * autoplugging uses the most appropriate elements.
+ *
+ */
+void
+gst_element_factory_set_rank (GstElementFactory *factory, guint16 rank)
+{
+  g_return_if_fail(factory != NULL);
+  factory->rank = rank;
+}
+
 static void
 gst_element_factory_unload_thyself (GstPluginFeature *feature)
 {