|  |  |  | GStreamer 0.10 Core Reference Manual |  | 
|---|
| GstRegistryGstRegistry — Abstract base class for management of GstPlugin objects | 
#include <gst/gst.h>
            GstRegistry;
GstRegistry* gst_registry_get_default       (void);
GList*      gst_registry_get_feature_list   (GstRegistry *registry,
                                             GType type);
GList*      gst_registry_get_feature_list_by_plugin
                                            (GstRegistry *registry,
                                             const gchar *name);
GList*      gst_registry_get_path_list      (GstRegistry *registry);
GList*      gst_registry_get_plugin_list    (GstRegistry *registry);
gboolean    gst_registry_add_plugin         (GstRegistry *registry,
                                             GstPlugin *plugin);
void        gst_registry_remove_plugin      (GstRegistry *registry,
                                             GstPlugin *plugin);
GList*      gst_registry_plugin_filter      (GstRegistry *registry,
                                             GstPluginFilter filter,
                                             gboolean first,
                                             gpointer user_data);
GList*      gst_registry_feature_filter     (GstRegistry *registry,
                                             GstPluginFeatureFilter filter,
                                             gboolean first,
                                             gpointer user_data);
GstPlugin*  gst_registry_find_plugin        (GstRegistry *registry,
                                             const gchar *name);
GstPluginFeature* gst_registry_find_feature (GstRegistry *registry,
                                             const gchar *name,
                                             GType type);
GstPluginFeature* gst_registry_lookup_feature
                                            (GstRegistry *registry,
                                             const char *name);
void        gst_registry_scan_path          (GstRegistry *registry,
                                             const gchar *path);
gboolean    gst_registry_xml_read_cache     (GstRegistry *registry,
                                             const char *location);
gboolean    gst_registry_xml_write_cache    (GstRegistry *registry,
                                             const char *location);
GstPlugin*  gst_registry_lookup             (GstRegistry *registry,
                                             const char *filename);
void        gst_registry_remove_feature     (GstRegistry *registry,
                                             GstPluginFeature *feature);
gboolean    gst_registry_add_feature        (GstRegistry *registry,
                                             GstPluginFeature *feature);
gboolean    gst_default_registry_check_feature_version
                                            (const gchar *feature_name,
                                             guint min_major,
                                             guint min_minor,
                                             guint min_micro);
#define     gst_default_registry_get_path_list()
#define     gst_default_registry_add_plugin (plugin)
#define     gst_default_registry_add_path   (path)
#define     gst_default_registry_find_plugin(name)
#define     gst_default_registry_find_feature(name,type)
#define     gst_default_registry_get_plugin_list()
#define     gst_default_registry_feature_filter(filter,first,user_data)
One registry holds the metadata of a set of plugins. All registries build the GstRegistryPool.
GstRegistry* gst_registry_get_default (void);
Retrieves the default registry. The caller does not own a reference on the registry, as it is alive as long as GStreamer is initialized.
| Returns : | The default GstRegistry. | 
GList* gst_registry_get_feature_list (GstRegistry *registry, GType type);
Retrieves a GList of GstPluginFeature of type.
| registry: | a GstRegistry | 
| type: | a GType. | 
| Returns : | a GList of GstPluginFeature of type. gst_plugin_feature_list_free
after usage.
MT safe. | 
GList* gst_registry_get_feature_list_by_plugin (GstRegistry *registry, const gchar *name);
Retrieves a GList of features of the plugin with name name.
| registry: | a GstRegistry. | 
| name: | a plugin name. | 
| Returns : | a GList of GstPluginFeature. gst_plugin_feature_list_free()after usage. | 
GList* gst_registry_get_path_list (GstRegistry *registry);
Get the list of paths for the given registry.
| registry: | the registry to get the pathlist of | 
| Returns : | A Glist of paths as strings. g_list_free after use. MT safe. | 
GList* gst_registry_get_plugin_list (GstRegistry *registry);
Get a copy of all plugins registered in the given registry. The refcount of each element in the list in incremented.
gboolean gst_registry_add_plugin (GstRegistry *registry, GstPlugin *plugin);
Add the plugin to the registry. The plugin-added signal will be emitted.
This function will sink plugin.
| registry: | the registry to add the plugin to | 
| plugin: | the plugin to add | 
| Returns : | TRUE on success. MT safe. | 
void gst_registry_remove_plugin (GstRegistry *registry, GstPlugin *plugin);
Remove the plugin from the registry.
MT safe.
| registry: | the registry to remove the plugin from | 
| plugin: | the plugin to remove | 
GList* gst_registry_plugin_filter (GstRegistry *registry, GstPluginFilter filter, gboolean first, gpointer user_data);
Runs a filter against all plugins in the registry and returns a GList with
the results. If the first flag is set, only the first match is
returned (as a list with a single object).
Every plugin is reffed; use gst_plugin_list_free() after use, which
will unref again.
| registry: | registry to query | 
| filter: | the filter to use | 
| first: | only return first match | 
| user_data: | user data passed to the filter function | 
| Returns : | a GList of GstPlugin. Use gst_plugin_list_free()after usage.
MT safe. | 
GList* gst_registry_feature_filter (GstRegistry *registry, GstPluginFeatureFilter filter, gboolean first, gpointer user_data);
Runs a filter against all features of the plugins in the registry and returns a GList with the results. If the first flag is set, only the first match is returned (as a list with a single object).
| registry: | registry to query | 
| filter: | the filter to use | 
| first: | only return first match | 
| user_data: | user data passed to the filter function | 
| Returns : | a GList of plugin features, gst_plugin_feature_list_free after use. MT safe. | 
GstPlugin* gst_registry_find_plugin (GstRegistry *registry, const gchar *name);
Find the plugin with the given name in the registry. The plugin will be reffed; caller is responsible for unreffing.
| registry: | the registry to search | 
| name: | the plugin name to find | 
| Returns : | The plugin with the given name or NULL if the plugin was not found. gst_object_unref()after usage.
MT safe. | 
GstPluginFeature* gst_registry_find_feature (GstRegistry *registry, const gchar *name, GType type);
Find the pluginfeature with the given name and type in the registry.
| registry: | the registry to search | 
| name: | the pluginfeature name to find | 
| type: | the pluginfeature type to find | 
| Returns : | The pluginfeature with the given name and type or NULL
if the plugin was not found. gst_object_unref()after usage.
MT safe. | 
GstPluginFeature* gst_registry_lookup_feature (GstRegistry *registry, const char *name);
Find a GstPluginFeature with name in registry.
| registry: | a GstRegistry | 
| name: | a GstPluginFeature name | 
| Returns : | a GstPluginFeature with its refcount incremented, use gst_object_unref()after usage.
MT safe. | 
void gst_registry_scan_path (GstRegistry *registry, const gchar *path);
Add the given path to the registry. The syntax of the path is specific to the registry. If the path has already been added, do nothing.
| registry: | the registry to add the path to | 
| path: | the path to add to the registry | 
gboolean gst_registry_xml_read_cache (GstRegistry *registry, const char *location);
Read the contents of the XML cache file at location 
location into registry.
| registry: | a GstRegistry | 
| location: | a filename | 
| Returns : | TRUE on success. | 
gboolean gst_registry_xml_write_cache (GstRegistry *registry, const char *location);
Write registry in an XML format at the location given by
location. Directories are automatically created.
| registry: | a GstRegistry | 
| location: | a filename | 
| Returns : | TRUE on success. | 
GstPlugin* gst_registry_lookup (GstRegistry *registry, const char *filename);
Look up a plugin in the given registry with the given filename. If found, plugin is reffed.
| registry: | the registry to look up in | 
| filename: | the name of the file to look up | 
| Returns : | the GstPlugin if found, or NULL if not. gst_object_unref()after usage. | 
void gst_registry_remove_feature (GstRegistry *registry, GstPluginFeature *feature);
Remove the feature from the registry.
MT safe.
| registry: | the registry to remove the feature from | 
| feature: | the feature to remove | 
gboolean gst_registry_add_feature (GstRegistry *registry, GstPluginFeature *feature);
Add the feature to the registry. The feature-added signal will be emitted.
This function sinks feature.
| registry: | the registry to add the plugin to | 
| feature: | the feature to add | 
| Returns : | TRUE on success. MT safe. | 
gboolean gst_default_registry_check_feature_version (const gchar *feature_name, guint min_major, guint min_minor, guint min_micro);
Checks whether a plugin feature by the given name exists in the default registry and whether its version is at least the version required.
| feature_name: | the name of the feature (e.g. "oggdemux") | 
| min_major: | the minimum major version number | 
| min_minor: | the minimum minor version number | 
| min_micro: | the minimum micro version number | 
| Returns : | TRUE if the feature could be found and the version is the same as the required version or newer, and FALSE otherwise. | 
#define gst_default_registry_get_path_list()
Get the list of paths for the default registry.
#define gst_default_registry_add_plugin(plugin)
Add the plugin to the default registry. The plugin-added signal will be emitted.
| plugin: | the plugin to add | 
#define gst_default_registry_add_path(path)
Add the given path to the default registry. The syntax of the path is specific to the registry. If the path has already been added, do nothing.
| path: | the path to add to the registry | 
#define gst_default_registry_find_plugin(name)
Find the plugin with the given name in the default registry. The plugin will be reffed; caller is responsible for unreffing.
| name: | the plugin name to find | 
#define gst_default_registry_find_feature(name,type)
Find the pluginfeature with the given name and type in the default registry.
| name: | the pluginfeature name to find | 
| type: | the pluginfeature type to find | 
#define gst_default_registry_get_plugin_list()
Get a copy of all plugins registered in the default registry.
#define gst_default_registry_feature_filter(filter,first,user_data)
Runs a filter against all features of the plugins in the default registry and returns a GList with the results. If the first flag is set, only the first match is returned (as a list with a single object).
| filter: | the filter to use | 
| first: | only return first match | 
| user_data: | user data passed to the filter function | 
| << GstQuery | GstSegment >> |