PluginFeature

class PluginFeature(**properties: Any)

Superclasses: Object, InitiallyUnowned, Object

Subclasses: DeviceProviderFactory, DynamicTypeFactory, ElementFactory, TracerFactory, TypeFindFactory

Constructors:

PluginFeature(**properties)

Methods

class PluginFeature
check_version(min_major: int, min_minor: int, min_micro: int) → bool

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

Note: Since version 1.24 this function no longer returns True if the version is a git development version (e.g. 1.23.0.1) and the check is for the “next” micro version, that is it will no longer return True for e.g. 1.23.0.1 if the check is for 1.23.1. It is still possible to parse the nano version from the string and do this check that way if needed.

Parameters:

  • min_major – minimum required major version

  • min_minor – minimum required minor version

  • min_micro – minimum required micro version

get_plugin() → Plugin | None

Get the plugin that provides this feature.

get_plugin_name() → str | None

Get the name of the plugin that provides this feature.

Added in version 1.2.

get_rank() → int

Gets the rank of a plugin feature.

list_debug(list: list[PluginFeature]) → None

Debug the plugin feature names in list.

Parameters:

list – a GList of plugin features

list_free(list: list[PluginFeature]) → None

Unrefs each member of list, then frees the list.

Parameters:

list – list of PluginFeature

load() → PluginFeature | None

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;
rank_compare_func(p1: None, p2: None) → int

Compares the two given PluginFeature instances. This function can be used as a CompareFunc when sorting by rank and then by name.

Parameters:
set_rank(rank: int) → None

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

Parameters:

rank – rank value - higher number means more priority rank