= class Gst::Registry
Abstract class for managing plugins.

== Class Methods
--- Gst::Registry.add(aRegistry, aPriority) 
    Add the registry to the pool with the given priority (as a Fixnum).

--- Gst::Registry.add_plugin(aPlugin) 
    Add the plugin to the global pool of plugins.

--- Gst::Registry.each { |aRegistryObject| block } 
    Calls the block for each registries in the pool, passing a reference to
    the Gst::Registry as parameter.
    
    Always returns nil.

--- Gst::Registry.each_feature(aFeatureType) { |aPluginFeature| block } 
    Calls the block for each plugin features of the given type in the pool, 
    passing a reference to the Gst::PluginFeature as parameter.
    
    Valid class types are:
        * Gst::AutoplugFactory;
        * Gst::ElementFactory;
        * Gst::IndexFactory;
        * Gst::SchedulerFactory;
       * Gst::TypeFactory.
    
    Always returns nil.

--- Gst::Registry.each_plugin { |aPlugin| block } 
    Calls the block for each plugin in the pool, passing a reference to
    the Gst::Plugin as parameter.
    
    Always returns nil.

--- Gst::Registry.find_feature(aName, aFeatureType) 
    Find the plugin feature with the given name and type from the pool of 
    registries, as a Gst::PluginFeature reference.  
    
    Returns nil if the named plugin feature is not found.
    
    Valid class types are:
        * Gst::AutoplugFactory;
        * Gst::ElementFactory;
        * Gst::IndexFactory;
        * Gst::SchedulerFactory;
       * Gst::TypeFactory.

--- Gst::Registry.find_plugin(aNameString) 
    Find the plugin with the given name in the registry. 
    If founds, returns a reference to the Gst::Plugin object, otherwise
    returns nil.

--- Gst::Registry.get_features(aFeatureType) 
    Get a list of all plugin features of the given type in the pool, as
    an array of Gst::PluginFeature objects.
    
    Valid class types are:
        * Gst::AutoplugFactory;
        * Gst::ElementFactory;
        * Gst::IndexFactory;
        * Gst::SchedulerFactory;
       * Gst::TypeFactory.

--- Gst::Registry.get_prefered(someFlags) 
    Get the prefered registry with the given flags.
    Valid flags are:
        * Gst::Registry::READABLE;
        * Gst::Registry::WRITABLE;
        * Gst::Registry::EXISTS;
        * Gst::Registry::REMOVE;
        * Gst::Registry::DELAYED_LOADING.

--- Gst::Registry.load_all 
    Load all the registries in the pool. 
    Registries with the Gst::Registry::DELAYED_LOADING flag on will not be loaded.

--- Gst::Registry.plugins 
    Get a list of all plugins in the pool, in an array of Gst::Plugin objects.

--- Gst::Registry.registries 
    Gets a list of all registries in the pool, in an Array
    of Gst::Registry objects.

--- Gst::Registry.remove(aRegistry) 
    Remove the registry from the pool.


== Instance Methods
--- add_path(aPath) 
    Add the given path (as a String) to the registry. 
    The syntax of the path is specific to the registry. 
    If the path has already been added, do nothing.

--- add_plugin(aPlugin) 
    Add a plugin (as a Gst::Plugin reference) to the registry. 
    The 'plugin-added' signal will be emitted.
    
    Returns true on success, false otherwise.

--- clear_paths 
    Clear the paths of the registry.

--- details 
    Gets some details about the registry, as a String.  
    Returns nil if the registry has no details.

--- each_path { |aString| block } 
    Calls the block for each path of the registry, passing a reference to
    the path String as parameter.
    
    Always returns nil.

--- find_feature(aName, aFeatureType) 
    Find the plugin feature with the given name and type in the registry,
    as a Gst::PluginFeature reference.  Returns nil if the named plugin 
    feature is not found.
    
    Valid class types are:
        * Gst::AutoplugFactory;
        * Gst::ElementFactory;
        * Gst::IndexFactory;
        * Gst::SchedulerFactory;
       * Gst::TypeFactory.

--- find_plugin(aName) 
    Find the plugin with the given name (as a String) in the registry.
    Returns a reference to a Gst::Plugin object if found, 
    otherwise returns nil.

--- load 
    Load the registry.  Returns true on success, otherwise false.

--- load_plugin(aPlugin) 
    Bring the plugin (as a Gst::Plugin reference) from the registry into 
    memory.
    
    Returns a Fixnum code indicating the result, which may be:
        * Gst::Registry::OK;
        * Gst::Registry::LOAD_ERROR;
        * Gst::Registry::SAVE_ERROR;
        * Gst::Registry::PLUGIN_LOAD_ERROR;
        * Gst::Registry::PLUGIN_SIGNATURE_ERROR.

--- loaded? 
    Checks if the registry is currently loaded.

--- name 
    Gets the name of the registry, as a String.

--- paths 
    Gets a list of paths of the registry, in an Array of String objects.

--- rebuild 
    Rebuild the registry.  Returns true on success, otherwise false.

--- remove_plugin(aPlugin) 
    Remove a plugin (as a Gst::Plugin reference) from the registry.

--- save 
    Save the contents of the registry.  Returns true on success, 
    otherwise false.

--- unload 
    Unload the registry.  Returns true on success, otherwise false.

--- unload_plugin(aPlugin) 
    Unload a plugin (as a Gst::Plugin reference) from the registry.
    
    Returns a Fixnum code indicating the result, which may be:
        * Gst::Registry::OK;
        * Gst::Registry::LOAD_ERROR;
        * Gst::Registry::SAVE_ERROR;
        * Gst::Registry::PLUGIN_LOAD_ERROR;
        * Gst::Registry::PLUGIN_SIGNATURE_ERROR.

--- update_plugin(aPlugin) 
    Unload a plugin (as a Gst::Plugin reference) in the registry.
    
    Returns a Fixnum code indicating the result, which may be:
        * Gst::Registry::OK;
        * Gst::Registry::LOAD_ERROR;
        * Gst::Registry::SAVE_ERROR;
        * Gst::Registry::PLUGIN_LOAD_ERROR;
        * Gst::Registry::PLUGIN_SIGNATURE_ERROR.


== Constants
--- DELAYED_LOADING
    The registry will be loaded on demand.

--- EXISTS
    The registry exists.

--- LOAD_ERROR
    There was a load error.

--- OK
    The registry reported no error.

--- PLUGIN_LOAD_ERROR
    There was an error loading a plugin.

--- PLUGIN_SIGNATURE_ERROR
    There was an error saving a plugin.

--- READABLE
    The registry can be read.

--- REMOTE
    The registry is remote and might be slower.

--- SAVE_ERROR
    There was an error saving the registry.

--- WRITABLE
    The registry can be written to.


== Signals
--- plugin-added

- ((<lrz>))
