ruby-****@sourc*****
ruby-****@sourc*****
2003年 8月 26日 (火) 03:42:10 JST
------------------------- REMOTE_ADDR = 81.249.77.79 REMOTE_HOST = URL = http://ruby-gnome2.sourceforge.jp/?Gst%3A%3ARegistry ------------------------- = 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>))