Struct gstreamer::TypeFind

pub struct TypeFind(/* private fields */);

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

Implementations

impl TypeFind

pub fn register<F>( plugin: Option<&Plugin>, name: &str, rank: Rank, extensions: Option<&str>, possible_caps: Option<&Caps>, func: F, ) -> Result<(), BoolError>

where F: Fn(&mut TypeFind) + Send + Sync + 'static,

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.

plugin

A Plugin, or None for a static typefind function

name

The name for registering

rank

The rank (or importance) of this typefind function

func

The GstTypeFindFunction to use

extensions

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

possible_caps

Optionally the caps that could be returned when typefinding succeeds

data_notify

a GDestroyNotify that will be called on data when the plugin is unloaded.

Returns

true on success, false otherwise

pub fn peek(&mut self, offset: i64, size: u32) -> Option<&[u8]>

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.

offset

The offset

size

The number of bytes to return

Returns

the requested data, or None if that data is not available.

pub fn suggest(&mut self, probability: TypeFindProbability, caps: &Caps)

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

probability

The probability in percent that the suggestion is right

caps

The fixed Caps to suggest

pub fn length(&mut self) -> Option<u64>

Get the length of the data stream.

Returns

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

Trait Implementations

impl Debug for TypeFind

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.