GI.Gst.Structs.Meta

The Meta structure should be included as the first member of a Buffer metadata structure. The structure defines the API of the metadata and should be accessible to all elements using the metadata.

A metadata API is registered with metaApiTypeRegister which takes a name for the metadata API and some tags associated with the metadata. With metaApiTypeHasTag one can check if a certain metadata API contains a given tag.

Multiple implementations of a metadata API can be registered. To implement a metadata API, metaRegister should be used. This function takes all parameters needed to create, free and transform metadata along with the size of the metadata. The function returns a MetaInfo structure that contains the information for the implementation of the API.

A specific implementation can be retrieved by name with metaGetInfo.

See Buffer for how the metadata can be added, retrieved and removed from buffers.

Exported types

newtype Meta

Memory-managed wrapper type.

Constructors

Meta (ManagedPtr Meta)

Instances

Eq Meta

Defined in GI.Gst.Structs.Meta

Methods

(==) :: Meta -> Meta -> Bool

(/=) :: Meta -> Meta -> Bool

BoxedPtr Meta

Defined in GI.Gst.Structs.Meta

Methods

boxedPtrCopy :: Meta -> IO Meta

boxedPtrFree :: Meta -> IO ()

CallocPtr Meta

Defined in GI.Gst.Structs.Meta

Methods

boxedPtrCalloc :: IO (Ptr Meta)

ManagedPtrNewtype Meta

Defined in GI.Gst.Structs.Meta

Methods

toManagedPtr :: Meta -> ManagedPtr Meta

tag ~ 'AttrSet => Constructible Meta tag

Defined in GI.Gst.Structs.Meta

Methods

new :: MonadIO m => (ManagedPtr Meta -> Meta) -> [AttrOp Meta tag] -> m Meta

newZeroMeta :: MonadIO m => m Meta

Construct a Meta struct initialized to zero.

Methods

Click to display all available methods, including inherited ones

Methods

compareSeqnum.

Getters

getSeqnum.

Setters

None.

apiTypeGetTags

metaApiTypeGetTags

Arguments

:: (HasCallStack, MonadIO m)

=> GType

api: an API

-> m [Text]

Returns: an array of tags as strings.

No description available in the introspection data.

Since: 1.2

apiTypeHasTag

metaApiTypeHasTag

Arguments

:: (HasCallStack, MonadIO m)

=> GType

api: an API

-> Word32

tag: the tag to check

-> m Bool

Returns: True if api was registered with tag.

Check if api was registered with tag.

apiTypeRegister

metaApiTypeRegister

Arguments

:: (HasCallStack, MonadIO m)

=> Text

api: an API to register

-> [Text]

tags: tags for api

-> m GType

Returns: a unique GType for api.

Register and return a GType for the api and associate it with tags.

compareSeqnum

metaCompareSeqnum

Arguments

:: (HasCallStack, MonadIO m)

=> Meta

meta1: a Meta

-> Meta

meta2: a Meta

-> m Int32

Returns: a negative number if meta1 comes before meta2, 0 if both metas have an equal sequence number, or a positive integer if meta1 comes after meta2.

Meta sequence number compare function. Can be used as CompareFunc or a CompareDataFunc.

Since: 1.16

getInfo

metaGetInfo

Arguments

:: (HasCallStack, MonadIO m)

=> Text

impl: the name

-> m (Maybe MetaInfo)

Returns: a MetaInfo with impl, or Nothing when no such metainfo exists.

Lookup a previously registered meta info structure by its implementation name impl.

getSeqnum

metaGetSeqnum

Arguments

:: (HasCallStack, MonadIO m)

=> Meta

meta: a Meta

-> m Word64

Gets seqnum for this meta.

Since: 1.16

register

metaRegister

Arguments

:: (HasCallStack, MonadIO m)

=> GType

api: the type of the Meta API

-> Text

impl: the name of the Meta implementation

-> Word64

size: the size of the Meta structure

-> MetaInitFunction

initFunc: a MetaInitFunction

-> MetaFreeFunction

freeFunc: a MetaFreeFunction

-> MetaTransformFunction

transformFunc: a MetaTransformFunction

-> m MetaInfo

Returns: a MetaInfo that can be used to access metadata.

Register a new Meta implementation.

The same info can be retrieved later with metaGetInfo by using impl as the key.

registerCustom

metaRegisterCustom

Arguments

:: (HasCallStack, MonadIO m)

=> Text

name: the name of the Meta implementation

-> [Text]

tags: tags for api

-> Maybe CustomMetaTransformFunction

transformFunc: a MetaTransformFunction

-> m MetaInfo

Returns: a MetaInfo that can be used to access metadata.

Register a new custom Meta implementation, backed by an opaque structure holding a Structure.

The registered info can be retrieved later with metaGetInfo by using name as the key.

The backing Structure can be retrieved with customMetaGetStructure, its mutability is conditioned by the writability of the buffer the meta is attached to.

When transformFunc is Nothing, the meta and its backing Structure will always be copied when the transform operation is copy, other operations are discarded, copy regions are ignored.

Since: 1.20

Properties

flags

extra flags for the metadata

getMetaFlags :: MonadIO m => Meta -> m [MetaFlags]

Get the value of the “flags” field. When overloading is enabled, this is equivalent to

get meta #flags

setMetaFlags :: MonadIO m => Meta -> [MetaFlags] -> m ()

Set the value of the “flags” field. When overloading is enabled, this is equivalent to

set meta [ #flags := value ]

info

pointer to the MetaInfo

clearMetaInfo :: MonadIO m => Meta -> m ()

Set the value of the “info” field to Nothing. When overloading is enabled, this is equivalent to

clear #info

getMetaInfo :: MonadIO m => Meta -> m (Maybe MetaInfo)

Get the value of the “info” field. When overloading is enabled, this is equivalent to

get meta #info

setMetaInfo :: MonadIO m => Meta -> Ptr MetaInfo -> m ()

Set the value of the “info” field. When overloading is enabled, this is equivalent to

set meta [ #info := value ]