gi-gst-1.0.22: GStreamer bindings
CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellNone
LanguageHaskell2010

GI.Gst.Objects.PluginFeature

Description

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

Synopsis

Exported types

class (GObject o, IsDescendantOf PluginFeature o) => IsPluginFeature o Source #

Type class for types which can be safely cast to PluginFeature, for instance with toPluginFeature.

Instances

Instances details
(GObject o, IsDescendantOf PluginFeature o) => IsPluginFeature o Source # 
Instance details

Defined in GI.Gst.Objects.PluginFeature

toPluginFeature :: (MonadIO m, IsPluginFeature o) => o -> m PluginFeature Source #

Cast to PluginFeature, for types for which this is known to be safe. For general casts, use castTo.

Methods

Overloaded methods

checkVersion

pluginFeatureCheckVersion Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> a

feature: a feature

-> Word32

minMajor: minimum required major version

-> Word32

minMinor: minimum required minor version

-> Word32

minMicro: minimum required micro version

-> m Bool

Returns: True if the plugin feature has at least the required version, otherwise False.

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

getPlugin

pluginFeatureGetPlugin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> a

feature: a feature

-> m (Maybe Plugin)

Returns: the plugin that provides this feature, or Nothing. Unref with objectUnref when no longer needed.

Get the plugin that provides this feature.

getPluginName

pluginFeatureGetPluginName Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> a

feature: a feature

-> m (Maybe Text)

Returns: the name of the plugin that provides this feature, or Nothing if the feature is not associated with a plugin.

Get the name of the plugin that provides this feature.

Since: 1.2

getRank

pluginFeatureGetRank Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> a

feature: a feature

-> m Word32

Returns: The rank of the feature

Gets the rank of a plugin feature.

listCopy

pluginFeatureListCopy Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> [a]

list: list of PluginFeature

-> m [PluginFeature]

Returns: a copy of list, with each feature's reference count incremented.

Copies the list of features. Caller should call gstPluginFeatureListFree when done with the list.

listDebug

pluginFeatureListDebug Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> [a]

list: a List of plugin features

-> m () 

Debug the plugin feature names in list.

listFree

pluginFeatureListFree Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> [a]

list: list of PluginFeature

-> m () 

Unrefs each member of list, then frees the list.

load

pluginFeatureLoad Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> a

feature: the plugin feature to check

-> m (Maybe PluginFeature)

Returns: a reference to the loaded feature, or Nothing on error

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:

C code

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;

rankCompareFunc

pluginFeatureRankCompareFunc Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> Ptr ()

p1: a PluginFeature

-> Ptr ()

p2: a PluginFeature

-> m Int32

Returns: negative value if the rank of p1 > the rank of p2 or the ranks are equal but the name of p1 comes before the name of p2; zero if the rank and names are equal; positive value if the rank of p1 < the rank of p2 or the ranks are equal but the name of p2 comes before the name of p1

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

setRank

pluginFeatureSetRank Source #

Arguments

:: (HasCallStack, MonadIO m, IsPluginFeature a) 
=> a

feature: feature to rank

-> Word32

rank: rank value - higher number means more priority rank

-> m () 

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