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"
25 #include "gstpluginfeature.h"
26 #include "gstplugin.h"
27 #include "gstregistry.h"
32 static void gst_plugin_feature_class_init (GstPluginFeatureClass * klass);
33 static void gst_plugin_feature_init (GstPluginFeature * feature);
35 static GObjectClass *parent_class = NULL;
37 /* static guint gst_plugin_feature_signals[LAST_SIGNAL] = { 0 }; */
40 gst_plugin_feature_get_type (void)
42 static GType plugin_feature_type = 0;
44 if (!plugin_feature_type) {
45 static const GTypeInfo plugin_feature_info = {
46 sizeof (GObjectClass),
49 (GClassInitFunc) gst_plugin_feature_class_init,
54 (GInstanceInitFunc) gst_plugin_feature_init,
59 g_type_register_static (G_TYPE_OBJECT, "GstPluginFeature",
60 &plugin_feature_info, G_TYPE_FLAG_ABSTRACT);
62 return plugin_feature_type;
66 gst_plugin_feature_class_init (GstPluginFeatureClass * klass)
68 GObjectClass *gobject_class;
70 gobject_class = (GObjectClass *) klass;
72 parent_class = g_type_class_ref (G_TYPE_OBJECT);
76 gst_plugin_feature_init (GstPluginFeature * feature)
78 feature->manager = NULL;
82 * gst_plugin_feature_ensure_loaded:
83 * @feature: the plugin feature to check
85 * Check if the plugin containing the feature is loaded,
86 * if not, the plugin will be loaded.
88 * Returns: a boolean indicating the feature is loaded.
91 gst_plugin_feature_ensure_loaded (GstPluginFeature * feature)
94 static GStaticMutex mutex = G_STATIC_MUTEX_INIT;
96 g_return_val_if_fail (feature != NULL, FALSE);
97 g_return_val_if_fail (GST_IS_PLUGIN_FEATURE (feature), FALSE);
99 plugin = (GstPlugin *) (feature->manager);
100 g_static_mutex_lock (&mutex);
102 if (plugin && !gst_plugin_is_loaded (plugin)) {
103 #ifndef GST_DISABLE_REGISTRY
104 if (GST_IS_REGISTRY (plugin->manager)) {
105 GST_CAT_DEBUG (GST_CAT_PLUGIN_LOADING,
106 "loading plugin %s for feature", plugin->desc.name);
108 if (gst_registry_load_plugin (GST_REGISTRY (plugin->manager),
109 plugin) != GST_REGISTRY_OK) {
110 g_static_mutex_unlock (&mutex);
114 g_static_mutex_unlock (&mutex);
117 #else /* GST_DISABLE_REGISTRY */
118 g_static_mutex_unlock (&mutex);
123 g_static_mutex_unlock (&mutex);
128 * gst_plugin_feature_unload_thyself:
129 * @feature: the plugin feature to check
131 * Unload the given feature. This will decrease the refcount
132 * in the plugin and will eventually unload the plugin
135 gst_plugin_feature_unload_thyself (GstPluginFeature * feature)
137 GstPluginFeatureClass *oclass;
139 g_return_if_fail (feature != NULL);
140 g_return_if_fail (GST_IS_PLUGIN_FEATURE (feature));
142 oclass = GST_PLUGIN_FEATURE_GET_CLASS (feature);
144 if (oclass->unload_thyself)
145 oclass->unload_thyself (feature);
149 gst_plugin_feature_type_name_filter (GstPluginFeature * feature,
150 GstTypeNameData * data)
152 return ((data->type == 0 || data->type == G_OBJECT_TYPE (feature)) &&
154 || !strcmp (data->name, GST_PLUGIN_FEATURE_NAME (feature))));
158 * gst_plugin_feature_set_rank:
159 * @feature: feature to rank
160 * @rank: rank value - higher number means more priority rank
162 * Specifies a rank for a plugin feature, so that autoplugging uses
163 * the most appropriate feature.
166 gst_plugin_feature_set_rank (GstPluginFeature * feature, guint rank)
168 g_return_if_fail (feature != NULL);
169 g_return_if_fail (GST_IS_PLUGIN_FEATURE (feature));
171 feature->rank = rank;
175 * gst_plugin_feature_set_name:
176 * @feature: a feature
177 * @name: the name to set
179 * Sets the name of a plugin feature. The name uniquely identifies a feature
180 * within all features of the same type. Renaming a plugin feature is not
184 gst_plugin_feature_set_name (GstPluginFeature * feature, const gchar * name)
186 g_return_if_fail (GST_IS_PLUGIN_FEATURE (feature));
187 g_return_if_fail (name != NULL);
190 g_return_if_fail (strcmp (feature->name, name) == 0);
192 feature->name = g_strdup (name);
197 * gst_plugin_feature_get rank:
198 * @feature: a feature
200 * Gets the rank of a plugin feature.
202 * Returns: The rank of the feature
205 gst_plugin_feature_get_rank (GstPluginFeature * feature)
207 g_return_val_if_fail (GST_IS_PLUGIN_FEATURE (feature), GST_RANK_NONE);
209 return feature->rank;
213 * gst_plugin_feature_get_name:
214 * @feature: a feature
216 * Gets the name of a plugin feature.
220 G_CONST_RETURN gchar *
221 gst_plugin_feature_get_name (GstPluginFeature * feature)
223 g_return_val_if_fail (GST_IS_PLUGIN_FEATURE (feature), NULL);
225 return feature->name;