/* 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
*
* Boston, MA 02111-1307, USA.
*/
-/* #define DEBUG_ENABLED */
#include "gst_private.h"
#include "gstelement.h"
-#include "gstregistry.h"
-#include "gstlog.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);
};
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)
{
gstobject_class = (GstObjectClass*)klass;
gstpluginfeature_class = (GstPluginFeatureClass*) klass;
- parent_class = g_type_class_ref (GST_TYPE_PLUGIN_FEATURE);
+ parent_class = g_type_class_peek_parent (klass);
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;
-}
+ factory->uri_type = GST_URI_UNKNOWN;
+ factory->uri_protocols = NULL;
+
+ factory->interfaces = NULL;
+}
/**
* gst_element_factory_find:
* @name: name of factory to find
return GST_ELEMENT_FACTORY (feature);
/* this should be an ERROR */
- GST_DEBUG (GST_CAT_ELEMENT_FACTORY,"no such elementfactory \"%s\"", name);
+ GST_DEBUG ("no such elementfactory \"%s\"", name);
return NULL;
}
-static void
-gst_element_details_free (GstElementDetails *dp)
+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)
{
- g_return_if_fail (dp);
-
- if (dp->longname)
- g_free (dp->longname);
- if (dp->klass)
- g_free (dp->klass);
- if (dp->description)
- g_free (dp->description);
- if (dp->version)
- g_free (dp->version);
- if (dp->author)
- g_free (dp->author);
- if (dp->copyright)
- g_free (dp->copyright);
- g_free (dp);
+ __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_element_factory_new:
- * @name: name of new elementfactory
- * @type: GType 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_element_factory_new (const gchar *name, GType type,
- GstElementDetails *details)
+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, NULL);
- g_return_val_if_fail (type, NULL);
- g_return_val_if_fail (details, NULL);
+ 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)
+ if (!factory) {
+ klass = GST_ELEMENT_CLASS (g_type_class_ref (type));
factory = GST_ELEMENT_FACTORY (g_object_new (GST_TYPE_ELEMENT_FACTORY, NULL));
-
- if (factory->details_dynamic) {
- gst_element_details_free (factory->details);
- factory->details_dynamic = FALSE;
+ 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->details = details;
+ factory->type = type;
+ __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;
+ }
- if (!factory->type)
- factory->type = type;
- else if (factory->type != type)
- g_critical ("`%s' requested type change (!)", name);
+ 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));
- GST_PLUGIN_FEATURE (factory)->name = g_strdup (name);
+ return TRUE;
- return factory;
+error:
+ gst_element_factory_cleanup (factory);
+ return FALSE;
}
-
/**
* gst_element_factory_create:
* @factory: factory to instantiate
* 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 *
+GstElement*
gst_element_factory_create (GstElementFactory *factory,
const gchar *name)
{
g_return_val_if_fail (factory != NULL, NULL);
- if (!gst_plugin_feature_ensure_loaded (GST_PLUGIN_FEATURE (factory)))
+ if (!gst_plugin_feature_ensure_loaded (GST_PLUGIN_FEATURE (factory))) {
+ GST_INFO ("could not load element factory for element \"%s\"", name);
return NULL;
+ }
- GST_DEBUG (GST_CAT_ELEMENT_FACTORY,
- "creating element from factory \"%s\" (name \"%s\", type %d)",
- GST_PLUGIN_FEATURE_NAME (factory), name, (gint) factory->type);
+ GST_LOG_OBJECT (factory, "creating element (name \"%s\", type %d)",
+ GST_STR_NULL (name), (gint) factory->type);
if (factory->type == 0) {
g_critical ("Factory for `%s' has no type",
return 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;
+ }
+
/* create an instance of the element */
element = GST_ELEMENT (g_object_new (factory->type, NULL));
g_assert (element != NULL);
- /* attempt to set the elemenfactory class pointer if necessary */
- oclass = GST_ELEMENT_CLASS (G_OBJECT_GET_CLASS (element));
- if (oclass->elementfactory == NULL) {
- GST_DEBUG (GST_CAT_ELEMENT_FACTORY, "class %s", GST_PLUGIN_FEATURE_NAME (factory));
- oclass->elementfactory = factory;
-
- /* copy pad template pointers to the element class,
- * allow for custom padtemplates */
- oclass->padtemplates = g_list_concat (oclass->padtemplates,
- g_list_copy (factory->padtemplates));
- oclass->numpadtemplates += factory->numpadtemplates;
- }
+ g_type_class_unref (oclass);
gst_object_set_name (GST_OBJECT (element), name);
return element;
}
-
/**
* gst_element_factory_make:
* @factoryname: a named factory to instantiate
* 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)
+ * Returns: new #GstElement or NULL if unable to create element
*/
GstElement*
gst_element_factory_make (const gchar *factoryname, const gchar *name)
g_return_val_if_fail (factoryname != NULL, NULL);
- GST_DEBUG (GST_CAT_ELEMENT_FACTORY, "gstelementfactory: make \"%s\" \"%s\"",
- factoryname, name);
+ 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 (GST_CAT_ELEMENT_FACTORY,"no such element factory \"%s\"!",
+ GST_INFO ("no such element factory \"%s\"!",
factoryname);
return NULL;
}
element = gst_element_factory_create (factory, name);
if (element == NULL) {
- GST_INFO (GST_CAT_ELEMENT_FACTORY,
- "couldn't create instance of element factory \"%s\"!",
- factoryname);
+ 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_make_or_warn:
- * @factoryname: a named factory to instantiate
- * @name: name of new element
+ * gst_element_factory_get_element_type:
+ * @factory: factory to get managed #GType from
+ *
+ * Get the #GType for elements managed by this factory
*
- * Create a new element of the type defined by the given element factory
- * using #gst_element_factory_make.
- * Will use g_warning if the element could not be created.
+ * 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);
+
+ return factory->type;
+}
+/**
+ * gst_element_factory_get_longname:
+ * @factory: a #GstElementFactory
+ *
+ * Gets the longname for this factory
*
- * Returns: new #GstElement (or NULL if unable to create element)
+ * Returns: the longname
*/
-GstElement*
-gst_element_factory_make_or_warn (const gchar *factoryname, const gchar *name)
+G_CONST_RETURN gchar *
+gst_element_factory_get_longname (GstElementFactory *factory)
{
- GstElement *element = gst_element_factory_make (factoryname, name);
+ g_return_val_if_fail (GST_IS_ELEMENT_FACTORY (factory), NULL);
- if (element == NULL)
- g_warning ("Could not create element from factory %s !\n", factoryname);
+ 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);
- return element;
+ 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);
+
+ 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);
+
+ 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);
+
+ return factory->numpadtemplates;
}
-
/**
- * gst_element_factory_add_pad_template :
- * @elementfactory: factory to add the src id to
- * @templ: the padtemplate to add
+ * __gst_element_factory_add_interface:
+ * @elementfactory: The elementfactory to add the interface to
+ * @interfacename: Name of the interface
*
- * Add the given padtemplate to this elementfactory.
+ * Adds the given interfacename to the list of implemented interfaces of the
+ * element.
*/
void
-gst_element_factory_add_pad_template (GstElementFactory *factory,
- GstPadTemplate *templ)
+__gst_element_factory_add_interface (GstElementFactory *elementfactory, const gchar *interfacename)
{
- GList *padtemplates;
+ 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 */
- g_return_if_fail(factory != NULL);
- g_return_if_fail(templ != NULL);
-
- padtemplates = factory->padtemplates;
+ 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);
- gst_object_ref (GST_OBJECT (templ));
+ 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);
- while (padtemplates) {
- GstPadTemplate *oldtempl = GST_PAD_TEMPLATE (padtemplates->data);
-
- if (!strcmp (oldtempl->name_template, templ->name_template)) {
- gst_object_unref (GST_OBJECT (oldtempl));
- padtemplates->data = templ;
- return;
- }
-
- padtemplates = g_list_next (padtemplates);
- }
- factory->padtemplates = g_list_append (factory->padtemplates, templ);
- factory->numpadtemplates++;
+ 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);
+ return factory->uri_protocols;
+}
/**
* gst_element_factory_can_src_caps :
* @factory: factory to query
*/
gboolean
gst_element_factory_can_src_caps (GstElementFactory *factory,
- GstCaps *caps)
+ const GstCaps *caps)
{
GList *templates;
return FALSE;
}
-
/**
* gst_element_factory_can_sink_caps :
* @factory: factory to query
*/
gboolean
gst_element_factory_can_sink_caps (GstElementFactory *factory,
- GstCaps *caps)
+ const GstCaps *caps)
{
GList *templates;
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)
{
factory = GST_ELEMENT_FACTORY (feature);
- factory->type = 0;
+ if (factory->type) {
+ g_type_class_unref (g_type_class_peek (factory->type));
+ factory->type = 0;
+ }
}