GI.Gst.Structs.TypeFind

The following functions allow you to detect the media type of an unknown stream.

Exported types

newtype TypeFind

Constructors

TypeFind (ManagedPtr TypeFind)

Instances

WrappedPtr TypeFind

Methods

wrappedPtrCalloc :: IO (Ptr TypeFind)

wrappedPtrCopy :: TypeFind -> IO TypeFind

wrappedPtrFree :: Maybe (FunPtr (Ptr TypeFind -> IO ()))

(~) AttrOpTag tag AttrSet => Constructible TypeFind tag

Methods

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

newZeroTypeFind :: MonadIO m => m TypeFind

Construct a TypeFind struct initialized to zero.

noTypeFind :: Maybe TypeFind

Methods

getLength

typeFindGetLength

Arguments

:: (HasCallStack, MonadIO m)

=> TypeFind

find: The TypeFind the function was called with

-> m Word64

Returns: The length of the data stream, or 0 if it is not available.

Get the length of the data stream.

peek

typeFindPeek

Arguments

:: (HasCallStack, MonadIO m)

=> TypeFind

find: The TypeFind object the function was called with

-> Int64

offset: The offset

-> m (Maybe ByteString)

Returns: the requested data, or Nothing if that data is not available.

Returns the size bytes of the stream to identify beginning at offset. If offset is a positive number, the offset is relative to the beginning of the stream, if offset is a negative number the offset is relative to the end of the stream. The returned memory is valid until the typefinding function returns and must not be freed.

register

typeFindRegister

Arguments

:: (HasCallStack, MonadIO m, IsPlugin a)

=> Maybe a

plugin: A Plugin, or Nothing for a static typefind function

-> Text

name: The name for registering

-> Word32

rank: The rank (or importance) of this typefind function

-> TypeFindFunction

func: The TypeFindFunction to use

-> Maybe Text

extensions: Optional comma-separated list of extensions that could belong to this type

-> Caps

possibleCaps: Optionally the caps that could be returned when typefinding succeeds

-> m Bool

Returns: True on success, False otherwise

Registers a new typefind function to be used for typefinding. After registering this function will be available for typefinding. This function is typically called during an element's plugin initialization.

suggest

typeFindSuggest

Arguments

:: (HasCallStack, MonadIO m)

=> TypeFind

find: The TypeFind object the function was called with

-> Word32

probability: The probability in percent that the suggestion is right

-> Caps

caps: The fixed Caps to suggest

-> m ()

If a TypeFindFunction calls this function it suggests the caps with the given probability. A TypeFindFunction may supply different suggestions in one call. It is up to the caller of the TypeFindFunction to interpret these values.

Properties

data

clearTypeFindData :: MonadIO m => TypeFind -> m ()

getTypeFindData :: MonadIO m => TypeFind -> m (Ptr ())

setTypeFindData :: MonadIO m => TypeFind -> Ptr () -> m ()

getLength

clearTypeFindGetLength :: MonadIO m => TypeFind -> m ()

getTypeFindGetLength :: MonadIO m => TypeFind -> m (Maybe TypeFindGetLengthFieldCallback)

setTypeFindGetLength :: MonadIO m => TypeFind -> FunPtr C_TypeFindGetLengthFieldCallback -> m ()

peek

clearTypeFindPeek :: MonadIO m => TypeFind -> m ()

getTypeFindPeek :: MonadIO m => TypeFind -> m (Maybe TypeFindPeekFieldCallback)

setTypeFindPeek :: MonadIO m => TypeFind -> FunPtr C_TypeFindPeekFieldCallback -> m ()

suggest

clearTypeFindSuggest :: MonadIO m => TypeFind -> m ()

getTypeFindSuggest :: MonadIO m => TypeFind -> m (Maybe TypeFindSuggestFieldCallback)

setTypeFindSuggest :: MonadIO m => TypeFind -> FunPtr C_TypeFindSuggestFieldCallback -> m ()