Next: , Previous: GstPipeline, Up: Top


28 GstPluginFeature

Base class for contents of a GstPlugin

28.1 Overview

This is a base class for anything that can be added to a <gst-plugin>.

28.2 Usage

— Class: <gst-plugin-feature>

This <gobject> class defines no properties, other than those defined by its superclasses.

— Function: gst-plugin-feature-type-name-filter (self <gst-plugin-feature>) (data <gst-type-name-data*>)   (ret bool)
— Method: type-name-filter

Compares type and name of plugin feature. Can be used with gst-filter-run.

feature
the <gst-plugin-feature>
data
the type and name to check against
ret
TRUE if equal.
— Function: gst-plugin-feature-set-rank (self <gst-plugin-feature>) (rank unsigned-int)
— Method: set-rank

Specifies a rank for a plugin feature, so that autoplugging uses the most appropriate feature.

feature
feature to rank
rank
rank value - higher number means more priority rank
— Function: gst-plugin-feature-set-name (self <gst-plugin-feature>) (name mchars)
— Method: set-name

Sets the name of a plugin feature. The name uniquely identifies a feature within all features of the same type. Renaming a plugin feature is not allowed. A copy is made of the name so you should free the supplied name after calling this function.

feature
a feature
name
the name to set
— Function: gst-plugin-feature-get-rank (self <gst-plugin-feature>)   (ret unsigned-int)
— Method: get-rank

Gets the rank of a plugin feature.

feature
a feature
ret
The rank of the feature
— Function: gst-plugin-feature-get-name (self <gst-plugin-feature>)   (ret mchars)
— Method: get-name

Gets the name of a plugin feature.

feature
a feature
ret
the name
— Function: gst-plugin-feature-load (self <gst-plugin-feature>)   (ret <gst-plugin-feature>)
— Method: load

Loads the plugin containing feature if it's not already loaded. feature is unaffected; use the return value instead.

Normally this function is used like this:

          
          GstPluginFeature *loaded_feature;
          loaded_feature = gst_plugin_feature_load (feature);
          // presumably, we're no longer interested in the potentially-unloaded feature
          gst_object_unref (feature);
          feature = loaded_feature;
feature
the plugin feature to check
ret
A reference to the loaded feature, or NULL on error.
— Function: gst-plugin-feature-check-version (self <gst-plugin-feature>) (min_major unsigned-int) (min_minor unsigned-int) (min_micro unsigned-int)   (ret bool)
— Method: check-version

Checks whether the given plugin feature is at least the required version

feature
a feature
min-major
minimum required major version
min-minor
minimum required minor version
min-micro
minimum required micro version
ret
#t if the plugin feature has at least the required version, otherwise #f.