![]() |
![]() |
![]() |
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, constgchar *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, constgchar *name); GstPluginFeature* gst_registry_find_feature (GstRegistry *registry, constgchar *name,GType type); GstPluginFeature* gst_registry_lookup_feature (GstRegistry *registry, constchar *name);void gst_registry_scan_path (GstRegistry *registry, constgchar *path);gboolean gst_registry_xml_read_cache (GstRegistry *registry, constchar *location);gboolean gst_registry_xml_write_cache (GstRegistry *registry, constchar *location); GstPlugin* gst_registry_lookup (GstRegistry *registry, constchar *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 (constgchar *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
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 type
.
registry : |
a GstRegistry |
type : |
a |
Returns : | a type . gst_plugin_feature_list_free
after usage.
MT safe.
|
GList * gst_registry_get_feature_list_by_plugin (GstRegistry *registry, constgchar *name);
Retrieves a name
.
registry : |
a GstRegistry. |
name : |
a plugin name. |
Returns : | a 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.
registry : |
the registry to search |
Returns : | a |
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 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 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, constgchar *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, constgchar *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, constchar *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, constgchar *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, constchar *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, constchar *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, constchar *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 (constgchar *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 : | |
#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 >> |