2 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
3 * 2000 Wim Taymans <wtay@chello.be>
5 * gstpluginfeature.c: Abstract base class for all plugin features
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
23 #include "gst_private.h"
24 #include "gstpluginfeature.h"
25 #include "gstplugin.h"
27 static void gst_plugin_feature_class_init (GstPluginFeatureClass *klass);
28 static void gst_plugin_feature_init (GstPluginFeature *feature);
30 #ifndef GST_DISABLE_REGISTRY
31 static xmlNodePtr gst_plugin_feature_save_thyself (GstObject *object, xmlNodePtr parent);
32 static void gst_plugin_feature_restore_thyself (GstObject *object, xmlNodePtr parent);
33 #endif /* GST_DISABLE_REGISTRY */
35 static GstObjectClass *parent_class = NULL;
36 //static guint gst_plugin_feature_signals[LAST_SIGNAL] = { 0 };
39 gst_plugin_feature_get_type (void)
41 static GType plugin_feature_type = 0;
43 if (!plugin_feature_type) {
44 static const GTypeInfo plugin_feature_info = {
45 sizeof (GstObjectClass),
48 (GClassInitFunc) gst_plugin_feature_class_init,
53 (GInstanceInitFunc) gst_plugin_feature_init,
56 plugin_feature_type = g_type_register_static (GST_TYPE_OBJECT, "GstPluginFeature",
57 &plugin_feature_info, G_TYPE_FLAG_ABSTRACT);
59 return plugin_feature_type;
63 gst_plugin_feature_class_init (GstPluginFeatureClass *klass)
65 GObjectClass *gobject_class;
66 GstObjectClass *gstobject_class;
68 gobject_class = (GObjectClass*) klass;
69 gstobject_class = (GstObjectClass*) klass;
71 parent_class = g_type_class_ref (GST_TYPE_OBJECT);
73 #ifndef GST_DISABLE_REGISTRY
74 gstobject_class->save_thyself = GST_DEBUG_FUNCPTR (gst_plugin_feature_save_thyself);
75 gstobject_class->restore_thyself = GST_DEBUG_FUNCPTR (gst_plugin_feature_restore_thyself);
76 #endif /* GST_DISABLE_REGISTRY */
80 gst_plugin_feature_init (GstPluginFeature *feature)
82 feature->manager = NULL;
85 #ifndef GST_DISABLE_REGISTRY
87 gst_plugin_feature_save_thyself (GstObject *object, xmlNodePtr parent)
89 g_return_val_if_fail (GST_IS_PLUGIN_FEATURE (object), parent);
91 xmlNewChild (parent, NULL, "name", GST_OBJECT_NAME (object));
97 gst_plugin_feature_restore_thyself (GstObject *object, xmlNodePtr parent)
99 xmlNodePtr field = parent->xmlChildrenNode;
101 g_return_if_fail (GST_IS_PLUGIN_FEATURE (object));
104 if (!strcmp (field->name, "name")) {
105 gst_object_set_name (object, xmlNodeGetContent (field));
111 #endif /* GST_DISABLE_REGISTRY */
114 * gst_plugin_feature_ensure_loaded:
115 * @feature: the plugin feature to check
117 * Check if the plugin containing the feature is loaded,
118 * if not, the plugin will be loaded.
120 * Returns: a boolean indicating the feature is loaded.
123 gst_plugin_feature_ensure_loaded (GstPluginFeature *feature)
125 GstPlugin *plugin = (GstPlugin *) (feature->manager);
127 if (plugin && !gst_plugin_is_loaded (plugin)) {
128 GST_DEBUG (GST_CAT_PLUGIN_LOADING, "loading plugin %s for feature\n", plugin->name);
130 return gst_plugin_load_plugin (plugin);
136 * gst_plugin_feature_unload_thyself:
137 * @feature: the plugin feature to check
139 * Unload the given feature. This will decrease the refcount
140 * in the plugin and will eventually unload the plugin
143 gst_plugin_feature_unload_thyself (GstPluginFeature *feature)
145 GstPluginFeatureClass *oclass;
147 g_return_if_fail (feature != NULL);
148 g_return_if_fail (GST_IS_PLUGIN_FEATURE (feature));
150 oclass = (GstPluginFeatureClass *)G_OBJECT_GET_CLASS (feature);
152 if (oclass->unload_thyself)
153 oclass->unload_thyself (feature);