GstDiscoverer

typedef struct _GstDiscoverer GstDiscoverer;

The GstDiscoverer structure.

Since 0.10.31

gst_discoverer_new ()

GstDiscoverer *     gst_discoverer_new                  (GstClockTime timeout,
                                                         GError **err);

Creates a new GstDiscoverer with the provided timeout.

Since 0.10.31

gst_discoverer_start ()

void                gst_discoverer_start                (GstDiscoverer *discoverer);

Allow asynchronous discovering of URIs to take place. A GMainLoop must be available for GstDiscoverer to properly work in asynchronous mode.

Since 0.10.31

gst_discoverer_stop ()

void                gst_discoverer_stop                 (GstDiscoverer *discoverer);

Stop the discovery of any pending URIs and clears the list of pending URIS (if any).

Since 0.10.31

gst_discoverer_discover_uri ()

GstDiscovererInfo * gst_discoverer_discover_uri         (GstDiscoverer *discoverer,
                                                         const gchar *uri,
                                                         GError **err);

Synchronously discovers the given uri.

A copy of uri will be made internally, so the caller can safely g_free() afterwards.

Since 0.10.31

gst_discoverer_discover_uri_async ()

gboolean            gst_discoverer_discover_uri_async   (GstDiscoverer *discoverer,
                                                         const gchar *uri);

Appends the given uri to the list of URIs to discoverer. The actual discovery of the uri will only take place if gst_discoverer_start() has been called.

A copy of uri will be made internally, so the caller can safely g_free() afterwards.

Since 0.10.31

GstDiscovererInfo

typedef struct _GstDiscovererInfo GstDiscovererInfo;

Structure containing the information of a URI analyzed by GstDiscoverer.

Since 0.10.31

enum GstDiscovererResult

typedef enum {
  GST_DISCOVERER_OK               = 0,
  GST_DISCOVERER_URI_INVALID      = 1,
  GST_DISCOVERER_ERROR            = 2,
  GST_DISCOVERER_TIMEOUT          = 3,
  GST_DISCOVERER_BUSY             = 4,
  GST_DISCOVERER_MISSING_PLUGINS  = 5
} GstDiscovererResult;

Result values for the discovery process.

Since 0.10.31

gst_discoverer_info_get_duration ()

GstClockTime        gst_discoverer_info_get_duration    (const GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_misc ()

const GstStructure* gst_discoverer_info_get_misc        (const GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_result ()

GstDiscovererResult  gst_discoverer_info_get_result     (const GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_stream_info ()

GstDiscovererStreamInfo* gst_discoverer_info_get_stream_info
                                                        (GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_stream_list ()

GList*              gst_discoverer_info_get_stream_list (GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_tags ()

const GstTagList*   gst_discoverer_info_get_tags        (const GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_uri ()

const gchar*        gst_discoverer_info_get_uri         (const GstDiscovererInfo *info);

Since 0.10.31

gst_discoverer_info_get_seekable ()

gboolean            gst_discoverer_info_get_seekable    (const GstDiscovererInfo *info);

Since 0.10.32

gst_discoverer_info_ref()

#define gst_discoverer_info_ref(info) (gst_mini_object_ref((GstMiniObject*)info))

Increments the reference count of info.

Since 0.10.31

gst_discoverer_info_unref()

#define gst_discoverer_info_unref(info) (gst_mini_object_unref((GstMiniObject*)info))

Decrements the reference count of info.

Since 0.10.31

GstDiscovererStreamInfo

typedef struct _GstDiscovererStreamInfo GstDiscovererStreamInfo;

Base structure for information concerning a media stream. Depending on the stream type, one can find more media-specific information in GstDiscovererAudioInfo, GstDiscovererVideoInfo, and GstDiscovererContainerInfo.

The GstDiscovererStreamInfo represents the topology of the stream. Siblings can be iterated over with gst_discoverer_stream_info_get_next() and gst_discoverer_stream_info_get_previous(). Children (sub-streams) of a stream can be accessed using the GstDiscovererContainerInfo API.

As a simple example, if you run GstDiscoverer on an AVI file with one audio and one video stream, you will get a GstDiscovererContainerInfo corresponding to the AVI container, which in turn will have a GstDiscovererAudioInfo sub-stream and a GstDiscovererVideoInfo sub-stream for the audio and video streams respectively.

Since 0.10.31

GstDiscovererContainerInfo

typedef struct _GstDiscovererContainerInfo GstDiscovererContainerInfo;

GstDiscovererStreamInfo specific to container streams.

Since 0.10.31

GstDiscovererAudioInfo

typedef struct _GstDiscovererAudioInfo GstDiscovererAudioInfo;

GstDiscovererStreamInfo specific to audio streams.

Since 0.10.31

GstDiscovererVideoInfo

typedef struct _GstDiscovererVideoInfo GstDiscovererVideoInfo;

GstDiscovererStreamInfo specific to video streams (this includes images).

Since 0.10.31

gst_discoverer_stream_info_get_caps ()

GstCaps*            gst_discoverer_stream_info_get_caps (GstDiscovererStreamInfo *info);

Since 0.10.31

gst_discoverer_stream_info_get_misc ()

const GstStructure* gst_discoverer_stream_info_get_misc (GstDiscovererStreamInfo *info);

Since 0.10.31

gst_discoverer_stream_info_get_next ()

GstDiscovererStreamInfo* gst_discoverer_stream_info_get_next
                                                        (GstDiscovererStreamInfo *info);

Since 0.10.31

gst_discoverer_stream_info_get_previous ()

GstDiscovererStreamInfo* gst_discoverer_stream_info_get_previous
                                                        (GstDiscovererStreamInfo *info);

Since 0.10.31

gst_discoverer_stream_info_get_tags ()

const GstTagList*   gst_discoverer_stream_info_get_tags (GstDiscovererStreamInfo *info);

Since 0.10.31

gst_discoverer_stream_info_ref()

#define gst_discoverer_stream_info_ref(info) ((GstDiscovererStreamInfo*) gst_mini_object_ref((GstMiniObject*) info))

Increments the reference count of info.

Since 0.10.31

gst_discoverer_stream_info_unref()

#define gst_discoverer_stream_info_unref(info) (gst_mini_object_unref((GstMiniObject*) info))

Decrements the reference count of info.

Since 0.10.31

gst_discoverer_stream_info_list_free ()

void                gst_discoverer_stream_info_list_free
                                                        (GList *infos);

Decrements the reference count of all contained GstDiscovererStreamInfo and fress the GList.

gst_discoverer_stream_info_get_stream_type_nick ()

const gchar *       gst_discoverer_stream_info_get_stream_type_nick
                                                        (GstDiscovererStreamInfo *info);

Since 0.10.31

gst_discoverer_info_get_audio_streams ()

GList *             gst_discoverer_info_get_audio_streams
                                                        (GstDiscovererInfo *info);

Finds all the GstDiscovererAudioInfo contained in info

Since 0.10.31

gst_discoverer_info_get_container_streams ()

GList *             gst_discoverer_info_get_container_streams
                                                        (GstDiscovererInfo *info);

Finds all the GstDiscovererContainerInfo contained in info

Since 0.10.31

gst_discoverer_info_get_streams ()

GList *             gst_discoverer_info_get_streams     (GstDiscovererInfo *info,
                                                         GType streamtype);

Finds the GstDiscovererStreamInfo contained in info that match the given streamtype.

Since 0.10.31

gst_discoverer_info_get_video_streams ()

GList *             gst_discoverer_info_get_video_streams
                                                        (GstDiscovererInfo *info);

Finds all the GstDiscovererVideoInfo contained in info

Since 0.10.31

gst_discoverer_audio_info_get_bitrate ()

guint               gst_discoverer_audio_info_get_bitrate
                                                        (const GstDiscovererAudioInfo *info);

Since 0.10.31

gst_discoverer_audio_info_get_channels ()

guint               gst_discoverer_audio_info_get_channels
                                                        (const GstDiscovererAudioInfo *info);

Since 0.10.31

gst_discoverer_audio_info_get_depth ()

guint               gst_discoverer_audio_info_get_depth (const GstDiscovererAudioInfo *info);

Since 0.10.31

gst_discoverer_audio_info_get_max_bitrate ()

guint               gst_discoverer_audio_info_get_max_bitrate
                                                        (const GstDiscovererAudioInfo *info);

Since 0.10.31

gst_discoverer_audio_info_get_sample_rate ()

guint               gst_discoverer_audio_info_get_sample_rate
                                                        (const GstDiscovererAudioInfo *info);

Since 0.10.31

gst_discoverer_container_info_get_streams ()

GList *             gst_discoverer_container_info_get_streams
                                                        (GstDiscovererContainerInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_bitrate ()

guint               gst_discoverer_video_info_get_bitrate
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_depth ()

guint               gst_discoverer_video_info_get_depth (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_framerate_denom ()

guint               gst_discoverer_video_info_get_framerate_denom
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_framerate_num ()

guint               gst_discoverer_video_info_get_framerate_num
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_height ()

guint               gst_discoverer_video_info_get_height
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_is_interlaced ()

gboolean            gst_discoverer_video_info_is_interlaced
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_is_image ()

gboolean            gst_discoverer_video_info_is_image  (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_max_bitrate ()

guint               gst_discoverer_video_info_get_max_bitrate
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_par_denom ()

guint               gst_discoverer_video_info_get_par_denom
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_par_num ()

guint               gst_discoverer_video_info_get_par_num
                                                        (const GstDiscovererVideoInfo *info);

Since 0.10.31

gst_discoverer_video_info_get_width ()

guint               gst_discoverer_video_info_get_width (const GstDiscovererVideoInfo *info);

Since 0.10.31

The "timeout" property

  "timeout"                  guint64               : Read / Write / Construct

The duration (in nanoseconds) after which the discovery of an individual URI will timeout.

If the discovery of a URI times out, the GST_DISCOVERER_TIMEOUT will be set on the result flags.

Allowed values: [1000000000,3600000000000]

Default value: 15000000000

The "discovered" signal

void                user_function                      (GstDiscoverer     *discoverer,
                                                        GstDiscovererInfo *info,
                                                        GstGError         *error,
                                                        gpointer           user_data)       : Run Last

Will be emitted when all information on a URI could be discovered.

The "finished" signal

void                user_function                      (GstDiscoverer *discoverer,
                                                        gpointer       user_data)       : Run Last

Will be emitted when all pending URIs have been processed.

The "starting" signal

void                user_function                      (GstDiscoverer *discoverer,
                                                        gpointer       user_data)       : Run Last

Will be emitted when the discover starts analyzing the pending URIs