PluginFeature#

class PluginFeature(**properties: Any)#

Superclasses: Object, InitiallyUnowned, Object

Subclasses: DeviceProviderFactory, DynamicTypeFactory, ElementFactory, TracerFactory, TypeFindFactory

This is a base class for anything that can be added to a Plugin.

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.

classmethod list_debug() → None#

Debug the plugin feature names in list.

classmethod list_free() → None#

Unrefs each member of list, then frees the list.

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;
classmethod rank_compare_func(p2: Any = 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:

p2 – a PluginFeature

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