GI.Gst.Objects.ElementFactory

ElementFactory is used to create instances of elements. A GstElementFactory can be added to a Plugin as it is also a PluginFeature.

Use the elementFactoryFind and elementFactoryCreate functions to create element instances or use elementFactoryMake as a convenient shortcut.

The following code example shows you how to create a GstFileSrc element.

<example> <title>Using an element factory</title> <programlisting language="c"> include &lt;gst/gst.h&gt;

GstElement *src; GstElementFactory *srcfactory;

gst_init (&amp;argc, &amp;argv);

srcfactory = gst_element_factory_find ("filesrc"); g_return_if_fail (srcfactory != NULL); src = gst_element_factory_create (srcfactory, "src"); g_return_if_fail (src != NULL); ... </programlisting> </example>

Exported types

newtype ElementFactory

Constructors

ElementFactory (ManagedPtr ElementFactory)

Instances

GObject ElementFactory

Methods

gobjectType :: ElementFactory -> IO GType

IsObject ElementFactory

IsPluginFeature ElementFactory

IsObject ElementFactory

IsElementFactory ElementFactory

((~) * info (ResolveElementFactoryMethod t ElementFactory), MethodInfo * info ElementFactory p) => IsLabel t (ElementFactory -> p)

Methods

fromLabel :: Proxy# Symbol t -> ElementFactory -> p

((~) * info (ResolveElementFactoryMethod t ElementFactory), MethodInfo * info ElementFactory p) => IsLabelProxy t (ElementFactory -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> ElementFactory -> p

HasAttributeList * ElementFactory

type AttributeList ElementFactory

type AttributeList ElementFactory

type SignalList ElementFactory

type SignalList ElementFactory

class GObject o => IsElementFactory o

Instances

(GObject a, UnknownAncestorError Constraint ElementFactory a) => IsElementFactory a

IsElementFactory ElementFactory

toElementFactory :: IsElementFactory o => o -> IO ElementFactory

noElementFactory :: Maybe ElementFactory

Methods

canSinkAllCaps

data ElementFactoryCanSinkAllCapsMethodInfo

Instances

((~) * signature (Caps -> m Bool), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryCanSinkAllCapsMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryCanSinkAllCapsMethodInfo a -> signature -> s

elementFactoryCanSinkAllCaps

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: factory to query

-> Caps

caps: the caps to check

-> m Bool

Returns: True if the caps are fully compatible.

Checks if the factory can sink all possible capabilities.

canSinkAnyCaps

data ElementFactoryCanSinkAnyCapsMethodInfo

Instances

((~) * signature (Caps -> m Bool), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryCanSinkAnyCapsMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryCanSinkAnyCapsMethodInfo a -> signature -> s

elementFactoryCanSinkAnyCaps

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: factory to query

-> Caps

caps: the caps to check

-> m Bool

Returns: True if the caps have a common subset.

Checks if the factory can sink any possible capability.

canSrcAllCaps

data ElementFactoryCanSrcAllCapsMethodInfo

Instances

((~) * signature (Caps -> m Bool), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryCanSrcAllCapsMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryCanSrcAllCapsMethodInfo a -> signature -> s

elementFactoryCanSrcAllCaps

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: factory to query

-> Caps

caps: the caps to check

-> m Bool

Returns: True if the caps are fully compatible.

Checks if the factory can src all possible capabilities.

canSrcAnyCaps

data ElementFactoryCanSrcAnyCapsMethodInfo

Instances

((~) * signature (Caps -> m Bool), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryCanSrcAnyCapsMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryCanSrcAnyCapsMethodInfo a -> signature -> s

elementFactoryCanSrcAnyCaps

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: factory to query

-> Caps

caps: the caps to check

-> m Bool

Returns: True if the caps have a common subset.

Checks if the factory can src any possible capability.

create

data ElementFactoryCreateMethodInfo

Instances

((~) * signature (Maybe Text -> m (Maybe Element)), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryCreateMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryCreateMethodInfo a -> signature -> s

elementFactoryCreate

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: factory to instantiate

-> Maybe Text

name: name of new element, or Nothing to automatically create a unique name

-> m (Maybe Element)

Returns: new Element or Nothing if the element couldn't be created

Create a new element of the type defined by the given elementfactory. It will be given the name supplied, since all elements require a name as their first argument.

find

elementFactoryFind

Arguments

:: (HasCallStack, MonadIO m)

=> Text

name: name of factory to find

-> m (Maybe ElementFactory)

Returns: ElementFactory if found, Nothing otherwise

Search for an element factory of the given name. Refs the returned element factory; caller is responsible for unreffing.

getElementType

data ElementFactoryGetElementTypeMethodInfo

Instances

((~) * signature (m GType), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetElementTypeMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetElementTypeMethodInfo a -> signature -> s

elementFactoryGetElementType

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: factory to get managed GType from

-> m GType

Returns: the GType for elements managed by this factory or 0 if the factory is not loaded.

Get the GType for elements managed by this factory. The type can only be retrieved if the element factory is loaded, which can be assured with pluginFeatureLoad.

getMetadata

data ElementFactoryGetMetadataMethodInfo

Instances

((~) * signature (Text -> m (Maybe Text)), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetMetadataMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetMetadataMethodInfo a -> signature -> s

elementFactoryGetMetadata

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> Text

key: a key

-> m (Maybe Text)

Returns: the metadata with key on factory or Nothing when there was no metadata with the given key.

Get the metadata on factory with key.

getMetadataKeys

data ElementFactoryGetMetadataKeysMethodInfo

Instances

((~) * signature (m (Maybe [Text])), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetMetadataKeysMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetMetadataKeysMethodInfo a -> signature -> s

elementFactoryGetMetadataKeys

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> m (Maybe [Text])

Returns: a Nothing-terminated array of key strings, or Nothing when there is no metadata. Free with strfreev when no longer needed.

Get the available keys for the metadata on factory.

getNumPadTemplates

data ElementFactoryGetNumPadTemplatesMethodInfo

Instances

((~) * signature (m Word32), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetNumPadTemplatesMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetNumPadTemplatesMethodInfo a -> signature -> s

elementFactoryGetNumPadTemplates

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> m Word32

Returns: the number of pad_templates

Gets the number of pad_templates in this factory.

getStaticPadTemplates

data ElementFactoryGetStaticPadTemplatesMethodInfo

Instances

((~) * signature (m [StaticPadTemplate]), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetStaticPadTemplatesMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetStaticPadTemplatesMethodInfo a -> signature -> s

elementFactoryGetStaticPadTemplates

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> m [StaticPadTemplate]

Returns: the static pad templates

Gets the List of StaticPadTemplate for this factory.

getUriProtocols

data ElementFactoryGetUriProtocolsMethodInfo

Instances

((~) * signature (m [Text]), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetUriProtocolsMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetUriProtocolsMethodInfo a -> signature -> s

elementFactoryGetUriProtocols

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> m [Text]

Returns: the supported protocols or Nothing

Gets a Nothing-terminated array of protocols this element supports or Nothing if no protocols are supported. You may not change the contents of the returned array, as it is still owned by the element factory. Use g_strdupv() to make a copy of the protocol string array if you need to.

getUriType

data ElementFactoryGetUriTypeMethodInfo

Instances

((~) * signature (m URIType), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryGetUriTypeMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryGetUriTypeMethodInfo a -> signature -> s

elementFactoryGetUriType

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> m URIType

Returns: type of URIs this element supports

Gets the type of URIs the element supports or GST_URI_UNKNOWN if none.

hasInterface

data ElementFactoryHasInterfaceMethodInfo

Instances

((~) * signature (Text -> m Bool), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryHasInterfaceMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryHasInterfaceMethodInfo a -> signature -> s

elementFactoryHasInterface

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> Text

interfacename: an interface name

-> m Bool

Returns: True when factory implement the interface.

Check if factory implements the interface with name interfacename.

listFilter

elementFactoryListFilter

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> [a]

list: a List of ElementFactory to filter

-> Caps

caps: a Caps

-> PadDirection

direction: a PadDirection to filter on

-> Bool

subsetonly: whether to filter on caps subsets or not.

-> m [ElementFactory]

Returns: a List of ElementFactory elements that match the given requisites. Use gst_plugin_feature_list_free after usage.

Filter out all the elementfactories in list that can handle caps in the given direction.

If subsetonly is True, then only the elements whose pads templates are a complete superset of caps will be returned. Else any element whose pad templates caps can intersect with caps will be returned.

listGetElements

elementFactoryListGetElements

Arguments

:: (HasCallStack, MonadIO m)

=> Word64

type: a GstElementFactoryListType

-> Rank

minrank: Minimum rank

-> m [ElementFactory]

Returns: a List of ElementFactory elements. Use pluginFeatureListFree after usage.

Get a list of factories that match the given type. Only elements with a rank greater or equal to minrank will be returned. The list of factories is returned by decreasing rank.

listIsType

data ElementFactoryListIsTypeMethodInfo

Instances

((~) * signature (Word64 -> m Bool), MonadIO m, IsElementFactory a) => MethodInfo * ElementFactoryListIsTypeMethodInfo a signature

Methods

overloadedMethod :: MethodProxy ElementFactoryListIsTypeMethodInfo a -> signature -> s

elementFactoryListIsType

Arguments

:: (HasCallStack, MonadIO m, IsElementFactory a)

=> a

factory: a ElementFactory

-> Word64

type: a GstElementFactoryListType

-> m Bool

Returns: True if factory is of type.

Check if factory is of the given types.

make

elementFactoryMake

Arguments

:: (HasCallStack, MonadIO m)

=> Text

factoryname: a named factory to instantiate

-> Maybe Text

name: name of new element, or Nothing to automatically create a unique name

-> m (Maybe Element)

Returns: new Element or Nothing if unable to create element

Create a new element of the type defined by the given element factory. If name is Nothing, then the element will receive a guaranteed unique name, consisting of the element factory name and a number. If name is given, it will be given the name supplied.