Media Discoverer

Description

Media discoverer interface

flu_discoverer_info_free ()

void flu_discoverer_info_free (FluDiscovererInfo *info);

Free a FluDiscovererInfo instance.

Since: 1.0

Parameters

info

The FluDiscovererInfo instance to free

flu_discoverer_new ()

FluDiscoverer * flu_discoverer_new (void);

Since: 1.0

Returns

The newly created discoverer

flu_discoverer_ref ()

FluDiscoverer * flu_discoverer_ref (FluDiscoverer *thiz);

Add a reference to a FluDiscoverer

Since: 1.1

Parameters

thiz

The discoverer to be referenced

Returns

The same object, for programming convenience.

[transfer full]

flu_discoverer_unref ()

void flu_discoverer_unref (FluDiscoverer *thiz);

Remove a reference from a FluDiscoverer

Since: 1.1

Parameters

thiz

The discoverer to unreference

flu_discoverer_info_get ()

gboolean flu_discoverer_info_get (FluDiscoverer *thiz, const gchar *media_uri, FluDiscovererInfo **info, FluStreamVideoFrameFormat default_cover_format, GError **error);

Extract information from a media.

Since: 1.1

Parameters

thiz

The FluDiscoverer instance

media_uri

URI of the media to analyze

info

Pass the address of a pointer to a FluDiscovererInfo structure. On success, this pointer will be filled back with the address of a new FluDiscovererInfo instance containing all information about the analyzed media. On failure, the pointer will be filled back with NULL. If the returned value points to a valid FluDiscovererInfo instance, you will need to free it up using the flu_discoverer_info_free() function.

default_cover_format

Specify the default format for covers information. In case that analyzed media doesn't contain any embedded cover information but contains at least one video stream, a thumbnail will be extracted from this stream in the specified default format and used as cover information.

error

Pass the address of a GError pointer to store back detailed information about any error that may occur while analyzing the media. You can pass NULL to ignore detailed error reporting. If the returned value points to a valid GError instance, you will need to free it up using g_error_free().

Returns

TRUE if successful, FALSE otherwise

Types and Values

FluDiscovererInfo

typedef struct { FluMediaInfo media_info; GList *video_streams_info; GList *audio_streams_info; GList *text_streams_info; GList *data_streams_info; } FluDiscovererInfo;

Comprehensive information about a media and all its streams.

FluDiscoverer

typedef struct { } FluDiscoverer;

An opaque structure representing a media discoverer instance.