-/* Gnome-Streamer
- * Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu>
+/* GStreamer
+ * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
+ * 2000 Wim Taymans <wtay@chello.be>
+ * 2003 Benjamin Otte <in7y118@public.uni-hamburg.de>
+ *
+ * gstelementfactory.c: GstElementFactory object, support routines
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* Boston, MA 02111-1307, USA.
*/
-#include <gst/gstelement.h>
-#include <gst/gstplugin.h>
+#include "gst_private.h"
+
+#include "gstelement.h"
+#include "gstregistrypool.h"
+#include "gstinfo.h"
+#include "gsturi.h"
+
+GST_DEBUG_CATEGORY_STATIC (element_factory_debug);
+#define GST_CAT_DEFAULT element_factory_debug
+
+static void gst_element_factory_class_init (GstElementFactoryClass *klass);
+static void gst_element_factory_init (GstElementFactory *factory);
+
+static void gst_element_factory_unload_thyself (GstPluginFeature *feature);
+
+static GstPluginFeatureClass *parent_class = NULL;
+/* static guint gst_element_factory_signals[LAST_SIGNAL] = { 0 }; */
+
+GType
+gst_element_factory_get_type (void)
+{
+ static GType elementfactory_type = 0;
+
+ if (!elementfactory_type) {
+ static const GTypeInfo elementfactory_info = {
+ sizeof (GstElementFactoryClass),
+ NULL,
+ NULL,
+ (GClassInitFunc) gst_element_factory_class_init,
+ NULL,
+ NULL,
+ sizeof(GstElementFactory),
+ 0,
+ (GInstanceInitFunc) gst_element_factory_init,
+ NULL
+ };
+ elementfactory_type = g_type_register_static (GST_TYPE_PLUGIN_FEATURE,
+ "GstElementFactory", &elementfactory_info, 0);
+ GST_DEBUG_CATEGORY_INIT (element_factory_debug, "GST_ELEMENT_FACTORY",
+ GST_DEBUG_BOLD | GST_DEBUG_FG_WHITE | GST_DEBUG_BG_RED,
+ "element factories keep information about installed elements");
+ }
+ return elementfactory_type;
+}
+static void
+gst_element_factory_class_init (GstElementFactoryClass *klass)
+{
+ GObjectClass *gobject_class;
+ GstObjectClass *gstobject_class;
+ GstPluginFeatureClass *gstpluginfeature_class;
+ gobject_class = (GObjectClass*)klass;
+ gstobject_class = (GstObjectClass*)klass;
+ gstpluginfeature_class = (GstPluginFeatureClass*) klass;
-/* global list of registered elementfactories */
-GList* _gst_elementfactories;
+ parent_class = g_type_class_peek_parent (klass);
-void _gst_elementfactory_initialize() {
- _gst_elementfactories = NULL;
+ gstpluginfeature_class->unload_thyself = GST_DEBUG_FUNCPTR (gst_element_factory_unload_thyself);
}
+static void
+gst_element_factory_init (GstElementFactory *factory)
+{
+ factory->padtemplates = NULL;
+ factory->numpadtemplates = 0;
-/**
- * gst_elementfactory_register:
- * @elementfactory: factory to register
- *
- * Adds the elementfactory to the global list, so it can be retrieved by
- * name.
- */
-void gst_elementfactory_register(GstElementFactory *elementfactory) {
- g_return_if_fail(elementfactory != NULL);
+ factory->uri_type = GST_URI_UNKNOWN;
+ factory->uri_protocols = NULL;
- _gst_elementfactories = g_list_prepend(_gst_elementfactories,elementfactory);
+ factory->interfaces = NULL;
}
-
/**
- * gst_elementfactory_find:
+ * gst_element_factory_find:
* @name: name of factory to find
*
- * Search for an elementfactory of the given name.
+ * Search for an element factory of the given name.
*
* Returns: #GstElementFactory if found, NULL otherwise
*/
-GstElementFactory *gst_elementfactory_find(gchar *name) {
- GList *walk = _gst_elementfactories;
- GstElementFactory *factory;
+GstElementFactory*
+gst_element_factory_find (const gchar *name)
+{
+ GstPluginFeature *feature;
- while (walk) {
- factory = (GstElementFactory *)(walk->data);
- if (!strcmp(name,factory->name))
- return factory;
- walk = g_list_next(walk);
- }
+ g_return_val_if_fail(name != NULL, NULL);
+ feature = gst_registry_pool_find_feature (name, GST_TYPE_ELEMENT_FACTORY);
+ if (feature)
+ return GST_ELEMENT_FACTORY (feature);
+
+ /* this should be an ERROR */
+ GST_DEBUG ("no such elementfactory \"%s\"", name);
return NULL;
}
-/**
- * gst_elementfactory_get_list:
- *
- * Get the global list of elementfactories.
- *
- * Returns: <type>GList</type> of type #GstElementFactory
- */
-GList *gst_elementfactory_get_list() {
- return _gst_elementfactories;
+void
+__gst_element_details_clear (GstElementDetails *dp)
+{
+ g_free (dp->longname);
+ dp->longname = NULL;
+ g_free (dp->klass);
+ dp->klass = NULL;
+ g_free (dp->description);
+ dp->description = NULL;
+ g_free (dp->author);
+ dp->author = NULL;
}
+void
+__gst_element_details_set (GstElementDetails *dest, const GstElementDetails *src)
+{
+ dest->longname = g_strdup (src->longname);
+ dest->klass = g_strdup (src->klass);
+ dest->description = g_strdup (src->description);
+ dest->author = g_strdup (src->author);
+}
+void
+__gst_element_details_copy (GstElementDetails *dest, const GstElementDetails *src)
+{
+ __gst_element_details_clear (dest);
+ __gst_element_details_set (dest, src);
+}
+static void
+gst_element_factory_cleanup (GstElementFactory *factory)
+{
+ __gst_element_details_clear (&factory->details);
+ if (factory->type) {
+ g_type_class_unref (g_type_class_peek (factory->type));
+ factory->type = 0;
+ }
-
+ g_list_foreach (factory->padtemplates, (GFunc) g_object_unref, NULL);
+ g_list_free (factory->padtemplates);
+ factory->padtemplates = NULL;
+ factory->numpadtemplates = 0;
+ factory->uri_type = GST_URI_UNKNOWN;
+ if (factory->uri_protocols) {
+ g_strfreev (factory->uri_protocols);
+ factory->uri_protocols = NULL;
+ }
+
+ g_list_foreach (factory->interfaces, (GFunc) g_free, NULL);
+ g_list_free (factory->interfaces);
+ factory->interfaces = NULL;
+}
/**
- * gst_elementfactory_new:
- * @name: name of new elementfactory
- * @type: GtkType of new element
- * @details: #GstElementDetails structure with element details
+ * gst_element_register:
+ * @plugin:
+ * @name: name of elements of this type
+ * @rank: rank of element (higher rank means more importance when autoplugging)
+ * @type: GType of element to register
*
* Create a new elementfactory capable of insantiating objects of the
* given type.
*
- * Returns: new elementfactory
+ * Returns: TRUE, if the registering succeeded, FALSE on error
*/
-GstElementFactory *gst_elementfactory_new(gchar *name,GtkType type,
- GstElementDetails *details) {
- GstElementFactory *factory = g_new0(GstElementFactory, 1);
- factory->name = g_strdup(name);
+gboolean
+gst_element_register (GstPlugin *plugin, const gchar *name, guint rank, GType type)
+{
+ GstElementFactory *factory;
+ GType *interfaces;
+ guint n_interfaces, i;
+ GstElementClass *klass;
+
+ g_return_val_if_fail (name != NULL, FALSE);
+ g_return_val_if_fail (g_type_is_a (type, GST_TYPE_ELEMENT), FALSE);
+
+ factory = gst_element_factory_find (name);
+
+ if (!factory) {
+ klass = GST_ELEMENT_CLASS (g_type_class_ref (type));
+ factory = GST_ELEMENT_FACTORY (g_object_new (GST_TYPE_ELEMENT_FACTORY, NULL));
+ gst_plugin_feature_set_name (GST_PLUGIN_FEATURE (factory), name);
+ GST_LOG_OBJECT (factory, "Created new elementfactory for type %s", g_type_name (type));
+ } else {
+ g_return_val_if_fail (factory->type == 0, FALSE);
+ klass = GST_ELEMENT_CLASS (g_type_class_ref (type));
+ gst_element_factory_cleanup (factory);
+ GST_LOG_OBJECT (factory, "Reuse existing elementfactory for type %s", g_type_name (type));
+ }
+
factory->type = type;
- factory->details = details;
- factory->src_types = NULL;
- factory->sink_types = NULL;
- return factory;
-}
+ __gst_element_details_copy (&factory->details, &klass->details);
+ factory->padtemplates = g_list_copy (klass->padtemplates);
+ g_list_foreach (factory->padtemplates, (GFunc) g_object_ref, NULL);
+ factory->numpadtemplates = klass->numpadtemplates;
+
+ /* special stuff for URI handling */
+ if (g_type_is_a (type, GST_TYPE_URI_HANDLER)) {
+ GstURIHandlerInterface *iface = (GstURIHandlerInterface *)
+ g_type_interface_peek (klass, GST_TYPE_URI_HANDLER);
+ if (!iface || !iface->get_type || !iface->get_protocols)
+ goto error;
+ factory->uri_type = iface->get_type ();
+ if (!GST_URI_TYPE_IS_VALID (factory->uri_type))
+ goto error;
+ factory->uri_protocols = g_strdupv (iface->get_protocols ());
+ if (!factory->uri_protocols)
+ goto error;
+ }
+
+ interfaces = g_type_interfaces (type, &n_interfaces);
+ for (i = 0; i < n_interfaces; i++) {
+ __gst_element_factory_add_interface (factory, g_type_name (interfaces[i]));
+ }
+ g_free (interfaces);
+
+ gst_plugin_feature_set_rank (GST_PLUGIN_FEATURE (factory), rank);
+ gst_plugin_add_feature (plugin, GST_PLUGIN_FEATURE (factory));
+
+ return TRUE;
+error:
+ gst_element_factory_cleanup (factory);
+ return FALSE;
+}
/**
- * gst_elementfactory_create:
+ * gst_element_factory_create:
* @factory: factory to instantiate
* @name: name of new element
*
* Create a new element of the type defined by the given elementfactory.
- * It wll be given the name supplied, since all elements require a name as
+ * It will be given the name supplied, since all elements require a name as
* their first argument.
*
- * Returns: new #GstElement
+ * Returns: new #GstElement or NULL if the element couldn't be created
*/
-GstElement *gst_elementfactory_create(GstElementFactory *factory,
- gchar *name) {
+GstElement*
+gst_element_factory_create (GstElementFactory *factory,
+ const gchar *name)
+{
GstElement *element;
GstElementClass *oclass;
- g_return_val_if_fail(factory != NULL, NULL);
+ g_return_val_if_fail (factory != NULL, NULL);
- factory = gst_plugin_load_elementfactory(factory->name);
+ if (!gst_plugin_feature_ensure_loaded (GST_PLUGIN_FEATURE (factory))) {
+ GST_INFO ("could not load element factory for element \"%s\"", name);
+ return NULL;
+ }
- g_return_val_if_fail(factory->type != 0, NULL);
+ GST_LOG_OBJECT (factory, "creating element (name \"%s\", type %d)",
+ GST_STR_NULL (name), (gint) factory->type);
- // create an instance of the element
- element = GST_ELEMENT(gtk_type_new(factory->type));
- g_assert(element != NULL);
+ if (factory->type == 0) {
+ g_critical ("Factory for `%s' has no type",
+ GST_PLUGIN_FEATURE_NAME (factory));
+ return NULL;
+ }
- // attempt to set the elemenfactory class pointer if necessary
- oclass = GST_ELEMENT_CLASS(GTK_OBJECT(element)->klass);
- if (oclass->elementfactory == NULL)
+ oclass = GST_ELEMENT_CLASS (g_type_class_ref (factory->type));
+ if (oclass->elementfactory == NULL) {
+ GST_DEBUG ("class %s", GST_PLUGIN_FEATURE_NAME (factory));
oclass->elementfactory = factory;
+ }
- gst_element_set_name(GST_ELEMENT(element),name);
+ /* create an instance of the element */
+ element = GST_ELEMENT (g_object_new (factory->type, NULL));
+ g_assert (element != NULL);
+
+ g_type_class_unref (oclass);
+
+ gst_object_set_name (GST_OBJECT (element), name);
return element;
}
-
-GstElement *gst_elementfactory_make(gchar *factoryname,gchar *name) {
+/**
+ * gst_element_factory_make:
+ * @factoryname: a named factory to instantiate
+ * @name: name of new element
+ *
+ * Create a new element of the type defined by the given element factory.
+ * If name is NULL, then the element will receive a guaranteed unique name,
+ * consisting of the element factory name and a number.
+ * If name is given, it will be given the name supplied.
+ *
+ * Returns: new #GstElement or NULL if unable to create element
+ */
+GstElement*
+gst_element_factory_make (const gchar *factoryname, const gchar *name)
+{
GstElementFactory *factory;
GstElement *element;
- gst_plugin_load_elementfactory(factoryname);
- factory = gst_elementfactory_find(factoryname);
- if (factory == NULL) return NULL;
- element = gst_elementfactory_create(factory,name);
+ g_return_val_if_fail (factoryname != NULL, NULL);
+
+ GST_LOG ("gstelementfactory: make \"%s\" \"%s\"",
+ factoryname, GST_STR_NULL (name));
+
+ /* gst_plugin_load_element_factory (factoryname); */
+ factory = gst_element_factory_find (factoryname);
+ if (factory == NULL) {
+ GST_INFO ("no such element factory \"%s\"!",
+ factoryname);
+ return NULL;
+ }
+ element = gst_element_factory_create (factory, name);
+ if (element == NULL) {
+ GST_INFO_OBJECT (factory, "couldn't create instance!");
+ return NULL;
+ }
+
return element;
}
+void
+__gst_element_factory_add_pad_template (GstElementFactory *factory,
+ GstPadTemplate *templ)
+{
+ g_return_if_fail (factory != NULL);
+ g_return_if_fail (templ != NULL);
+
+ gst_object_ref (GST_OBJECT (templ));
+ gst_object_sink (GST_OBJECT (templ));
+
+ factory->padtemplates = g_list_append (factory->padtemplates, templ);
+ factory->numpadtemplates++;
+}
+/**
+ * gst_element_factory_get_element_type:
+ * @factory: factory to get managed #GType from
+ *
+ * Get the #GType for elements managed by this factory
+ *
+ * Returns: the #GType for elements managed by this factory
+ */
+GType
+gst_element_factory_get_element_type (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), 0);
-void gst_elementfactory_add_src(GstElementFactory *elementfactory, guint16 id) {
- guint type = id;
+ return factory->type;
+}
+/**
+ * gst_element_factory_get_longname:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the longname for this factory
+ *
+ * Returns: the longname
+ */
+G_CONST_RETURN gchar *
+gst_element_factory_get_longname (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
- elementfactory->src_types = g_list_prepend(elementfactory->src_types, GUINT_TO_POINTER(type));
+ return factory->details.longname;
}
+/**
+ * gst_element_factory_get_class:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the class for this factory.
+ *
+ * Returns: the class
+ */
+G_CONST_RETURN gchar *
+gst_element_factory_get_klass (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
-void gst_elementfactory_add_sink(GstElementFactory *elementfactory, guint16 id) {
- guint type = id;
+ return factory->details.klass;
+}
+/**
+ * gst_element_factory_get_description:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the description for this factory.
+ *
+ * Returns: the description
+ */
+G_CONST_RETURN gchar *
+gst_element_factory_get_description (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
- elementfactory->sink_types = g_list_prepend(elementfactory->sink_types, GUINT_TO_POINTER(type));
+ return factory->details.description;
}
+/**
+ * gst_element_factory_get_author:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the author for this factory.
+ *
+ * Returns: the author
+ */
+G_CONST_RETURN gchar *
+gst_element_factory_get_author (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
-xmlNodePtr gst_elementfactory_save_thyself(GstElementFactory *factory, xmlNodePtr parent) {
- GList *types;
- xmlNodePtr subtree;
+ return factory->details.author;
+}
+/**
+ * gst_element_factory_get_num_pad_templates:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the number of pad_templates in this factory.
+ *
+ * Returns: the number of pad_templates
+ */
+guint
+gst_element_factory_get_num_pad_templates (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), 0);
- xmlNewChild(parent,NULL,"name",factory->name);
- xmlNewChild(parent,NULL,"longname", factory->details->longname);
- xmlNewChild(parent,NULL,"class", factory->details->class);
- xmlNewChild(parent,NULL,"description", factory->details->description);
- xmlNewChild(parent,NULL,"version", factory->details->version);
- xmlNewChild(parent,NULL,"author", factory->details->author);
- xmlNewChild(parent,NULL,"copyright", factory->details->copyright);
+ return factory->numpadtemplates;
+}
+/**
+ * __gst_element_factory_add_interface:
+ * @elementfactory: The elementfactory to add the interface to
+ * @interfacename: Name of the interface
+ *
+ * Adds the given interfacename to the list of implemented interfaces of the
+ * element.
+ */
+void
+__gst_element_factory_add_interface (GstElementFactory *elementfactory, const gchar *interfacename)
+{
+ g_return_if_fail (GST_IS_ELEMENT_FACTORY (elementfactory));
+ g_return_if_fail (interfacename != NULL);
+ g_return_if_fail (interfacename[0] != '\0'); /* no empty string */
+
+ elementfactory->interfaces = g_list_prepend (elementfactory->interfaces, g_strdup (interfacename));
+}
+/**
+ * gst_element_factory_get_pad_templates:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the #GList of padtemplates for this factory.
+ *
+ * Returns: the padtemplates
+ */
+G_CONST_RETURN GList *
+gst_element_factory_get_pad_templates (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
+
+ return factory->padtemplates;
+}
+/**
+ * gst_element_factory_get_uri_type:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the type of URIs the element supports or GST_URI_UNKNOWN if none.
+ *
+ * Returns: type of URIs this element supports
+ */
+guint
+gst_element_factory_get_uri_type (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), GST_URI_UNKNOWN);
+
+ return factory->uri_type;
+}
+/**
+ * gst_element_factory_get_uri_protocols:
+ * @factory: a #GstElementFactory
+ *
+ * Gets a NULL-terminated array of protocols this element supports or NULL, if
+ * no protocols are supported. You may not change the contents of the returned
+ * array as it is still ownt by the element factory. Use g_strdupv() if you want to.
+ *
+ * Returns: the supported protocols or NULL
+ */
+gchar **
+gst_element_factory_get_uri_protocols (GstElementFactory *factory)
+{
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
- types = factory->src_types;
- if (types) {
- subtree = xmlNewChild(parent,NULL,"sources",NULL);
- while (types) {
- guint16 typeid = GPOINTER_TO_UINT(types->data);
- GstType *type = gst_type_find_by_id(typeid);
+ return factory->uri_protocols;
+}
+/**
+ * gst_element_factory_can_src_caps :
+ * @factory: factory to query
+ * @caps: the caps to check
+ *
+ * Checks if the factory can source the given capability.
+ *
+ * Returns: true if it can src the capabilities
+ */
+gboolean
+gst_element_factory_can_src_caps (GstElementFactory *factory,
+ const GstCaps *caps)
+{
+ GList *templates;
- gst_type_save_thyself(type, subtree);
+ g_return_val_if_fail(factory != NULL, FALSE);
+ g_return_val_if_fail(caps != NULL, FALSE);
- types = g_list_next(types);
- }
- }
- types = factory->sink_types;
- if (types) {
- subtree = xmlNewChild(parent,NULL,"sinks",NULL);
- while (types) {
- guint16 typeid = GPOINTER_TO_UINT(types->data);
- GstType *type = gst_type_find_by_id(typeid);
+ templates = factory->padtemplates;
- gst_type_save_thyself(type, subtree);
+ while (templates) {
+ GstPadTemplate *template = (GstPadTemplate *)templates->data;
- types = g_list_next(types);
+ if (template->direction == GST_PAD_SRC) {
+ if (gst_caps_is_always_compatible (GST_PAD_TEMPLATE_CAPS (template), caps))
+ return TRUE;
}
+ templates = g_list_next (templates);
}
- return parent;
+ return FALSE;
}
+/**
+ * gst_element_factory_can_sink_caps :
+ * @factory: factory to query
+ * @caps: the caps to check
+ *
+ * Checks if the factory can sink the given capability.
+ *
+ * Returns: true if it can sink the capabilities
+ */
+gboolean
+gst_element_factory_can_sink_caps (GstElementFactory *factory,
+ const GstCaps *caps)
+{
+ GList *templates;
-GstElementFactory *gst_elementfactory_load_thyself(xmlNodePtr parent) {
- GstElementFactory *factory = g_new0(GstElementFactory, 1);
- xmlNodePtr children = parent->childs;
- factory->details = g_new0(GstElementDetails, 1);
- factory->sink_types = NULL;
- factory->src_types = NULL;
+ g_return_val_if_fail(factory != NULL, FALSE);
+ g_return_val_if_fail(caps != NULL, FALSE);
- while (children) {
- if (!strcmp(children->name, "name")) {
- factory->name = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "longname")) {
- factory->details->longname = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "class")) {
- factory->details->class = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "description")) {
- factory->details->description = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "version")) {
- factory->details->version = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "author")) {
- factory->details->author = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "copyright")) {
- factory->details->copyright = g_strdup(xmlNodeGetContent(children));
- }
- if (!strcmp(children->name, "sources")) {
- guint16 typeid = gst_type_load_thyself(children);
+ templates = factory->padtemplates;
- gst_type_add_src(typeid, factory);
- }
- if (!strcmp(children->name, "sinks")) {
- guint16 typeid = gst_type_load_thyself(children);
+ while (templates) {
+ GstPadTemplate *template = (GstPadTemplate *)templates->data;
- gst_type_add_sink(typeid, factory);
+ if (template->direction == GST_PAD_SINK) {
+ if (gst_caps_is_always_compatible (caps, GST_PAD_TEMPLATE_CAPS (template)))
+ return TRUE;
}
-
- children = children->next;
+ templates = g_list_next (templates);
}
- return factory;
+ return FALSE;
}
+static void
+gst_element_factory_unload_thyself (GstPluginFeature *feature)
+{
+ GstElementFactory *factory;
+ factory = GST_ELEMENT_FACTORY (feature);
+
+ if (factory->type) {
+ g_type_class_unref (g_type_class_peek (factory->type));
+ factory->type = 0;
+ }
+}