Media Discoverer: Fluendo SDK Reference Manual

Media Discoverer

Media Discoverer — Media discoverer interface

Functions

void	flu_discoverer_info_free ()
FluDiscoverer *	flu_discoverer_new ()
FluDiscoverer *	flu_discoverer_ref ()
void	flu_discoverer_unref ()
gboolean	flu_discoverer_info_get ()

Types and Values

	FluDiscovererInfo
	FluDiscoverer

Description

Media discoverer interface

Functions

flu_discoverer_info_free ()

void
flu_discoverer_info_free (FluDiscovererInfo *info);

Free a FluDiscovererInfo instance.

Parameters

info

The FluDiscovererInfo instance to free

flu_discoverer_new ()

FluDiscoverer *
flu_discoverer_new (void);

Returns

The newly created discoverer

flu_discoverer_ref ()

FluDiscoverer *
flu_discoverer_ref (FluDiscoverer *thiz);

Add a reference to a FluDiscoverer

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

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.

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.	[out][transfer none]
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.

Members

FluMediaInfo `media_info`;	media container information
GList *`video_streams_info`;	information about each video stream embedded in the media.	[element-type FluStreamInfo]
GList *`audio_streams_info`;	information about each audio stream embedded in the media.	[element-type FluStreamInfo]
GList *`text_streams_info`;	information about each text stream embedded in the media.	[element-type FluStreamInfo]
GList *`data_streams_info`;	information about each data stream embedded in the media.	[element-type FluStreamInfo]

FluDiscoverer

typedef struct {
} FluDiscoverer;

An opaque structure representing a media discoverer instance.