playback: document DEINTERLACE flag
[platform/upstream/gstreamer.git] / gst-libs / gst / pbutils / gstdiscoverer.c
1 /* GStreamer
2  * Copyright (C) 2009 Edward Hervey <edward.hervey@collabora.co.uk>
3  *               2009 Nokia Corporation
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Library General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Library General Public License for more details.
14  *
15  * You should have received a copy of the GNU Library General Public
16  * License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18  * Boston, MA 02111-1307, USA.
19  */
20
21 /**
22  * SECTION:gstdiscoverer
23  * @short_description: Utility for discovering information on URIs.
24  *
25  * The #GstDiscoverer is a utility object which allows to get as much
26  * information as possible from one or many URIs.
27  *
28  * It provides two APIs, allowing usage in blocking or non-blocking mode.
29  *
30  * The blocking mode just requires calling gst_discoverer_discover_uri()
31  * with the URI one wishes to discover.
32  *
33  * The non-blocking mode requires a running #GMainLoop in the default
34  * #GMainContext, where one connects to the various signals, appends the
35  * URIs to be processed (through gst_discoverer_discover_uri_async()) and then
36  * asks for the discovery to begin (through gst_discoverer_start()).
37  *
38  * All the information is returned in a #GstDiscovererInfo structure.
39  *
40  * Since: 0.10.31
41  */
42
43 #ifdef HAVE_CONFIG_H
44 #include "config.h"
45 #endif
46
47 #include "pbutils.h"
48 #include "pbutils-marshal.h"
49 #include "pbutils-private.h"
50
51 #include "gst/glib-compat-private.h"
52
53 GST_DEBUG_CATEGORY_STATIC (discoverer_debug);
54 #define GST_CAT_DEFAULT discoverer_debug
55
56 static GQuark _CAPS_QUARK;
57 static GQuark _TAGS_QUARK;
58 static GQuark _MISSING_PLUGIN_QUARK;
59 static GQuark _STREAM_TOPOLOGY_QUARK;
60 static GQuark _TOPOLOGY_PAD_QUARK;
61
62
63 typedef struct
64 {
65   GstDiscoverer *dc;
66   GstPad *pad;
67   GstElement *queue;
68   GstElement *sink;
69   GstTagList *tags;
70 } PrivateStream;
71
72 struct _GstDiscovererPrivate
73 {
74   gboolean async;
75
76   /* allowed time to discover each uri in nanoseconds */
77   GstClockTime timeout;
78
79   /* list of pending URI to process (current excluded) */
80   GList *pending_uris;
81
82   GMutex *lock;
83
84   /* TRUE if processing a URI */
85   gboolean processing;
86
87   /* TRUE if discoverer has been started */
88   gboolean running;
89
90   /* current items */
91   GstDiscovererInfo *current_info;
92   GError *current_error;
93   GstStructure *current_topology;
94
95   /* List of private streams */
96   GList *streams;
97
98   /* Global elements */
99   GstBin *pipeline;
100   GstElement *uridecodebin;
101   GstBus *bus;
102
103   GType decodebin2_type;
104
105   /* Custom main context variables */
106   GMainContext *ctx;
107   guint sourceid;
108   guint timeoutid;
109
110   /* reusable queries */
111   GstQuery *seeking_query;
112
113   /* Handler ids for various callbacks */
114   gulong pad_added_id;
115   gulong pad_remove_id;
116   gulong element_added_id;
117   gulong bus_cb_id;
118 };
119
120 #define DISCO_LOCK(dc) g_mutex_lock (dc->priv->lock);
121 #define DISCO_UNLOCK(dc) g_mutex_unlock (dc->priv->lock);
122
123 static void
124 _do_init (void)
125 {
126   GST_DEBUG_CATEGORY_INIT (discoverer_debug, "discoverer", 0, "Discoverer");
127
128   _CAPS_QUARK = g_quark_from_static_string ("caps");
129   _TAGS_QUARK = g_quark_from_static_string ("tags");
130   _MISSING_PLUGIN_QUARK = g_quark_from_static_string ("missing-plugin");
131   _STREAM_TOPOLOGY_QUARK = g_quark_from_static_string ("stream-topology");
132   _TOPOLOGY_PAD_QUARK = g_quark_from_static_string ("pad");
133 };
134
135 G_DEFINE_TYPE_EXTENDED (GstDiscoverer, gst_discoverer, G_TYPE_OBJECT, 0,
136     _do_init ());
137
138 enum
139 {
140   SIGNAL_FINISHED,
141   SIGNAL_STARTING,
142   SIGNAL_DISCOVERED,
143   LAST_SIGNAL
144 };
145
146 #define DEFAULT_PROP_TIMEOUT 15 * GST_SECOND
147
148 enum
149 {
150   PROP_0,
151   PROP_TIMEOUT
152 };
153
154 static guint gst_discoverer_signals[LAST_SIGNAL] = { 0 };
155
156 static void gst_discoverer_set_timeout (GstDiscoverer * dc,
157     GstClockTime timeout);
158 static gboolean async_timeout_cb (GstDiscoverer * dc);
159
160 static void discoverer_bus_cb (GstBus * bus, GstMessage * msg,
161     GstDiscoverer * dc);
162 static void uridecodebin_pad_added_cb (GstElement * uridecodebin, GstPad * pad,
163     GstDiscoverer * dc);
164 static void uridecodebin_pad_removed_cb (GstElement * uridecodebin,
165     GstPad * pad, GstDiscoverer * dc);
166
167 static void gst_discoverer_dispose (GObject * dc);
168 static void gst_discoverer_set_property (GObject * object, guint prop_id,
169     const GValue * value, GParamSpec * pspec);
170 static void gst_discoverer_get_property (GObject * object, guint prop_id,
171     GValue * value, GParamSpec * pspec);
172
173 static void
174 gst_discoverer_class_init (GstDiscovererClass * klass)
175 {
176   GObjectClass *gobject_class = (GObjectClass *) klass;
177
178   gobject_class->dispose = gst_discoverer_dispose;
179
180   gobject_class->set_property = gst_discoverer_set_property;
181   gobject_class->get_property = gst_discoverer_get_property;
182
183   g_type_class_add_private (klass, sizeof (GstDiscovererPrivate));
184
185   /* properties */
186   /**
187    * GstDiscoverer:timeout
188    *
189    * The duration (in nanoseconds) after which the discovery of an individual
190    * URI will timeout.
191    *
192    * If the discovery of a URI times out, the %GST_DISCOVERER_TIMEOUT will be
193    * set on the result flags.
194    */
195   g_object_class_install_property (gobject_class, PROP_TIMEOUT,
196       g_param_spec_uint64 ("timeout", "timeout", "Timeout",
197           GST_SECOND, 3600 * GST_SECOND, DEFAULT_PROP_TIMEOUT,
198           G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
199
200   /* signals */
201   /**
202    * GstDiscoverer::finished:
203    * @discoverer: the #GstDiscoverer
204    *
205    * Will be emitted when all pending URIs have been processed.
206    */
207   gst_discoverer_signals[SIGNAL_FINISHED] =
208       g_signal_new ("finished", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
209       G_STRUCT_OFFSET (GstDiscovererClass, finished),
210       NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
211
212   /**
213    * GstDiscoverer::starting:
214    * @discoverer: the #GstDiscoverer
215    *
216    * Will be emitted when the discover starts analyzing the pending URIs
217    */
218   gst_discoverer_signals[SIGNAL_STARTING] =
219       g_signal_new ("starting", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
220       G_STRUCT_OFFSET (GstDiscovererClass, starting),
221       NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
222
223   /**
224    * GstDiscoverer::discovered:
225    * @discoverer: the #GstDiscoverer
226    * @info: the results #GstDiscovererInfo
227    * @error: (type GLib.Error): #GError, which will be non-NULL if an error
228    *                            occurred during discovery
229    *
230    * Will be emitted when all information on a URI could be discovered.
231    */
232   gst_discoverer_signals[SIGNAL_DISCOVERED] =
233       g_signal_new ("discovered", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
234       G_STRUCT_OFFSET (GstDiscovererClass, discovered),
235       NULL, NULL, pbutils_marshal_VOID__POINTER_BOXED,
236       G_TYPE_NONE, 2, GST_TYPE_DISCOVERER_INFO, GST_TYPE_G_ERROR);
237 }
238
239 static void
240 uridecodebin_element_added_cb (GstElement * uridecodebin,
241     GstElement * child, GstDiscoverer * dc)
242 {
243   GST_DEBUG ("New element added to uridecodebin : %s",
244       GST_ELEMENT_NAME (child));
245
246   if (G_OBJECT_TYPE (child) == dc->priv->decodebin2_type) {
247     g_object_set (child, "post-stream-topology", TRUE, NULL);
248   }
249 }
250
251 static void
252 gst_discoverer_init (GstDiscoverer * dc)
253 {
254   GstElement *tmp;
255   GstFormat format = GST_FORMAT_TIME;
256
257   dc->priv = G_TYPE_INSTANCE_GET_PRIVATE (dc, GST_TYPE_DISCOVERER,
258       GstDiscovererPrivate);
259
260   dc->priv->timeout = DEFAULT_PROP_TIMEOUT;
261   dc->priv->async = FALSE;
262
263   dc->priv->lock = g_mutex_new ();
264
265   GST_LOG ("Creating pipeline");
266   dc->priv->pipeline = (GstBin *) gst_pipeline_new ("Discoverer");
267   GST_LOG_OBJECT (dc, "Creating uridecodebin");
268   dc->priv->uridecodebin =
269       gst_element_factory_make ("uridecodebin", "discoverer-uri");
270   if (G_UNLIKELY (dc->priv->uridecodebin == NULL)) {
271     GST_ERROR ("Can't create uridecodebin");
272     return;
273   }
274   GST_LOG_OBJECT (dc, "Adding uridecodebin to pipeline");
275   gst_bin_add (dc->priv->pipeline, dc->priv->uridecodebin);
276
277   dc->priv->pad_added_id =
278       g_signal_connect_object (dc->priv->uridecodebin, "pad-added",
279       G_CALLBACK (uridecodebin_pad_added_cb), dc, 0);
280   dc->priv->pad_remove_id =
281       g_signal_connect_object (dc->priv->uridecodebin, "pad-removed",
282       G_CALLBACK (uridecodebin_pad_removed_cb), dc, 0);
283
284   GST_LOG_OBJECT (dc, "Getting pipeline bus");
285   dc->priv->bus = gst_pipeline_get_bus ((GstPipeline *) dc->priv->pipeline);
286
287   dc->priv->bus_cb_id =
288       g_signal_connect_object (dc->priv->bus, "message",
289       G_CALLBACK (discoverer_bus_cb), dc, 0);
290
291   GST_DEBUG_OBJECT (dc, "Done initializing Discoverer");
292
293   /* This is ugly. We get the GType of decodebin2 so we can quickly detect
294    * when a decodebin2 is added to uridecodebin so we can set the
295    * post-stream-topology setting to TRUE */
296   dc->priv->element_added_id =
297       g_signal_connect_object (dc->priv->uridecodebin, "element-added",
298       G_CALLBACK (uridecodebin_element_added_cb), dc, 0);
299   tmp = gst_element_factory_make ("decodebin2", NULL);
300   dc->priv->decodebin2_type = G_OBJECT_TYPE (tmp);
301   gst_object_unref (tmp);
302
303   /* create queries */
304   dc->priv->seeking_query = gst_query_new_seeking (format);
305 }
306
307 static void
308 discoverer_reset (GstDiscoverer * dc)
309 {
310   GST_DEBUG_OBJECT (dc, "Resetting");
311
312   if (dc->priv->pending_uris) {
313     g_list_foreach (dc->priv->pending_uris, (GFunc) g_free, NULL);
314     g_list_free (dc->priv->pending_uris);
315     dc->priv->pending_uris = NULL;
316   }
317
318   if (dc->priv->pipeline)
319     gst_element_set_state ((GstElement *) dc->priv->pipeline, GST_STATE_NULL);
320 }
321
322 #define DISCONNECT_SIGNAL(o,i) G_STMT_START{           \
323   if ((i) && g_signal_handler_is_connected ((o), (i))) \
324     g_signal_handler_disconnect ((o), (i));            \
325   (i) = 0;                                             \
326 }G_STMT_END
327
328 static void
329 gst_discoverer_dispose (GObject * obj)
330 {
331   GstDiscoverer *dc = (GstDiscoverer *) obj;
332
333   GST_DEBUG_OBJECT (dc, "Disposing");
334
335   discoverer_reset (dc);
336
337   if (G_LIKELY (dc->priv->pipeline)) {
338     /* Workaround for bug #118536 */
339     DISCONNECT_SIGNAL (dc->priv->uridecodebin, dc->priv->pad_added_id);
340     DISCONNECT_SIGNAL (dc->priv->uridecodebin, dc->priv->pad_remove_id);
341     DISCONNECT_SIGNAL (dc->priv->uridecodebin, dc->priv->element_added_id);
342     DISCONNECT_SIGNAL (dc->priv->bus, dc->priv->bus_cb_id);
343
344     /* pipeline was set to NULL in _reset */
345     gst_object_unref (dc->priv->pipeline);
346     gst_object_unref (dc->priv->bus);
347
348     dc->priv->pipeline = NULL;
349     dc->priv->uridecodebin = NULL;
350     dc->priv->bus = NULL;
351   }
352
353   gst_discoverer_stop (dc);
354
355   if (dc->priv->lock) {
356     g_mutex_free (dc->priv->lock);
357     dc->priv->lock = NULL;
358   }
359
360   if (dc->priv->seeking_query) {
361     gst_query_unref (dc->priv->seeking_query);
362     dc->priv->seeking_query = NULL;
363   }
364
365   G_OBJECT_CLASS (gst_discoverer_parent_class)->dispose (obj);
366 }
367
368 static void
369 gst_discoverer_set_property (GObject * object, guint prop_id,
370     const GValue * value, GParamSpec * pspec)
371 {
372   GstDiscoverer *dc = (GstDiscoverer *) object;
373
374   switch (prop_id) {
375     case PROP_TIMEOUT:
376       gst_discoverer_set_timeout (dc, g_value_get_uint64 (value));
377       break;
378     default:
379       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
380       break;
381   }
382 }
383
384 static void
385 gst_discoverer_get_property (GObject * object, guint prop_id,
386     GValue * value, GParamSpec * pspec)
387 {
388   GstDiscoverer *dc = (GstDiscoverer *) object;
389
390   switch (prop_id) {
391     case PROP_TIMEOUT:
392       DISCO_LOCK (dc);
393       g_value_set_uint64 (value, dc->priv->timeout);
394       DISCO_UNLOCK (dc);
395       break;
396     default:
397       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
398       break;
399   }
400 }
401
402 static void
403 gst_discoverer_set_timeout (GstDiscoverer * dc, GstClockTime timeout)
404 {
405   GST_DEBUG_OBJECT (dc, "timeout : %" GST_TIME_FORMAT, GST_TIME_ARGS (timeout));
406
407   /* FIXME : update current pending timeout if we're running */
408   DISCO_LOCK (dc);
409   dc->priv->timeout = timeout;
410   DISCO_UNLOCK (dc);
411 }
412
413 static gboolean
414 _event_probe (GstPad * pad, GstEvent * event, PrivateStream * ps)
415 {
416   if (GST_EVENT_TYPE (event) == GST_EVENT_TAG) {
417     GstTagList *tl = NULL, *tmp;
418
419     gst_event_parse_tag (event, &tl);
420     GST_DEBUG_OBJECT (pad, "tags %" GST_PTR_FORMAT, tl);
421     DISCO_LOCK (ps->dc);
422     /* If preroll is complete, drop these tags - the collected information is
423      * possibly already being processed and adding more tags would be racy */
424     if (G_LIKELY (ps->dc->priv->processing)) {
425       GST_DEBUG_OBJECT (pad, "private stream %p old tags %" GST_PTR_FORMAT, ps,
426           ps->tags);
427       tmp = gst_tag_list_merge (ps->tags, tl, GST_TAG_MERGE_APPEND);
428       if (ps->tags)
429         gst_tag_list_free (ps->tags);
430       ps->tags = tmp;
431       GST_DEBUG_OBJECT (pad, "private stream %p new tags %" GST_PTR_FORMAT, ps,
432           tmp);
433     } else
434       GST_DEBUG_OBJECT (pad, "Dropping tags since preroll is done");
435     DISCO_UNLOCK (ps->dc);
436   }
437
438   return TRUE;
439 }
440
441 static GstStaticCaps subtitle_caps = GST_STATIC_CAPS ("text/plain; "
442     "text/x-pango-markup; subpicture/x-pgs; subpicture/x-dvb; "
443     "application/x-subtitle-unknown; application/x-ssa; application/x-ass; "
444     "subtitle/x-kate; application/x-kate; video/x-dvd-subpicture");
445
446 static gboolean
447 is_subtitle_caps (const GstCaps * caps)
448 {
449   GstCaps *subs_caps;
450   gboolean ret;
451
452   subs_caps = gst_static_caps_get (&subtitle_caps);
453   ret = gst_caps_can_intersect (caps, subs_caps);
454   gst_caps_unref (subs_caps);
455
456   return ret;
457 }
458
459 static void
460 uridecodebin_pad_added_cb (GstElement * uridecodebin, GstPad * pad,
461     GstDiscoverer * dc)
462 {
463   PrivateStream *ps;
464   GstPad *sinkpad = NULL;
465   GstCaps *caps;
466
467   GST_DEBUG_OBJECT (dc, "pad %s:%s", GST_DEBUG_PAD_NAME (pad));
468
469   ps = g_slice_new0 (PrivateStream);
470
471   ps->dc = dc;
472   ps->pad = pad;
473   ps->queue = gst_element_factory_make ("queue", NULL);
474   ps->sink = gst_element_factory_make ("fakesink", NULL);
475
476   if (G_UNLIKELY (ps->queue == NULL || ps->sink == NULL))
477     goto error;
478
479   g_object_set (ps->sink, "silent", TRUE, NULL);
480   g_object_set (ps->queue, "max-size-buffers", 1, "silent", TRUE, NULL);
481
482   caps = gst_pad_get_caps_reffed (pad);
483
484   if (is_subtitle_caps (caps)) {
485     /* Subtitle streams are sparse and may not provide any information - don't
486      * wait for data to preroll */
487     g_object_set (ps->sink, "async", FALSE, NULL);
488   }
489
490   gst_caps_unref (caps);
491
492   gst_bin_add_many (dc->priv->pipeline, ps->queue, ps->sink, NULL);
493
494   if (!gst_element_link_pads_full (ps->queue, "src", ps->sink, "sink",
495           GST_PAD_LINK_CHECK_NOTHING))
496     goto error;
497   if (!gst_element_sync_state_with_parent (ps->sink))
498     goto error;
499   if (!gst_element_sync_state_with_parent (ps->queue))
500     goto error;
501
502   sinkpad = gst_element_get_static_pad (ps->queue, "sink");
503   if (sinkpad == NULL)
504     goto error;
505   if (gst_pad_link_full (pad, sinkpad,
506           GST_PAD_LINK_CHECK_NOTHING) != GST_PAD_LINK_OK)
507     goto error;
508   gst_object_unref (sinkpad);
509
510   /* Add an event probe */
511   gst_pad_add_event_probe (pad, G_CALLBACK (_event_probe), ps);
512
513   DISCO_LOCK (dc);
514   dc->priv->streams = g_list_append (dc->priv->streams, ps);
515   DISCO_UNLOCK (dc);
516
517   GST_DEBUG_OBJECT (dc, "Done handling pad");
518
519   return;
520
521 error:
522   GST_ERROR_OBJECT (dc, "Error while handling pad");
523   if (sinkpad)
524     gst_object_unref (sinkpad);
525   if (ps->queue)
526     gst_object_unref (ps->queue);
527   if (ps->sink)
528     gst_object_unref (ps->sink);
529   g_slice_free (PrivateStream, ps);
530   return;
531 }
532
533 static void
534 uridecodebin_pad_removed_cb (GstElement * uridecodebin, GstPad * pad,
535     GstDiscoverer * dc)
536 {
537   GList *tmp;
538   PrivateStream *ps;
539   GstPad *sinkpad;
540
541   GST_DEBUG_OBJECT (dc, "pad %s:%s", GST_DEBUG_PAD_NAME (pad));
542
543   /* Find the PrivateStream */
544   DISCO_LOCK (dc);
545   for (tmp = dc->priv->streams; tmp; tmp = tmp->next) {
546     ps = (PrivateStream *) tmp->data;
547     if (ps->pad == pad)
548       break;
549   }
550
551   if (tmp == NULL) {
552     DISCO_UNLOCK (dc);
553     GST_DEBUG ("The removed pad wasn't controlled by us !");
554     return;
555   }
556
557   dc->priv->streams = g_list_delete_link (dc->priv->streams, tmp);
558   DISCO_UNLOCK (dc);
559
560   gst_element_set_state (ps->sink, GST_STATE_NULL);
561   gst_element_set_state (ps->queue, GST_STATE_NULL);
562   gst_element_unlink (ps->queue, ps->sink);
563
564   sinkpad = gst_element_get_static_pad (ps->queue, "sink");
565   gst_pad_unlink (pad, sinkpad);
566   gst_object_unref (sinkpad);
567
568   /* references removed here */
569   gst_bin_remove_many (dc->priv->pipeline, ps->sink, ps->queue, NULL);
570
571   if (ps->tags) {
572     gst_tag_list_free (ps->tags);
573   }
574
575   g_slice_free (PrivateStream, ps);
576
577   GST_DEBUG ("Done handling pad");
578 }
579
580 static GstStructure *
581 collect_stream_information (GstDiscoverer * dc, PrivateStream * ps, guint idx)
582 {
583   GstCaps *caps;
584   GstStructure *st;
585   gchar *stname;
586
587   stname = g_strdup_printf ("stream-%02d", idx);
588   st = gst_structure_empty_new (stname);
589   g_free (stname);
590
591   /* Get caps */
592   caps = gst_pad_get_negotiated_caps (ps->pad);
593   if (!caps) {
594     GST_WARNING ("Couldn't get negotiated caps from %s:%s",
595         GST_DEBUG_PAD_NAME (ps->pad));
596     caps = gst_pad_get_caps (ps->pad);
597   }
598   if (caps) {
599     GST_DEBUG ("Got caps %" GST_PTR_FORMAT, caps);
600     gst_structure_id_set (st, _CAPS_QUARK, GST_TYPE_CAPS, caps, NULL);
601
602     gst_caps_unref (caps);
603   }
604   if (ps->tags)
605     gst_structure_id_set (st, _TAGS_QUARK, GST_TYPE_STRUCTURE, ps->tags, NULL);
606
607   return st;
608 }
609
610 /* Parses a set of caps and tags in st and populates a GstDiscovererStreamInfo
611  * structure (parent, if !NULL, otherwise it allocates one)
612  */
613 static GstDiscovererStreamInfo *
614 collect_information (GstDiscoverer * dc, const GstStructure * st,
615     GstDiscovererStreamInfo * parent)
616 {
617   GstCaps *caps;
618   GstStructure *caps_st, *tags_st;
619   const gchar *name;
620   int tmp, tmp2;
621   guint utmp;
622
623   if (!st || !gst_structure_id_has_field (st, _CAPS_QUARK)) {
624     GST_WARNING ("Couldn't find caps !");
625     if (parent)
626       return parent;
627     else
628       return (GstDiscovererStreamInfo *)
629           gst_mini_object_new (GST_TYPE_DISCOVERER_STREAM_INFO);
630   }
631
632   gst_structure_id_get (st, _CAPS_QUARK, GST_TYPE_CAPS, &caps, NULL);
633   caps_st = gst_caps_get_structure (caps, 0);
634   name = gst_structure_get_name (caps_st);
635
636   if (g_str_has_prefix (name, "audio/")) {
637     GstDiscovererAudioInfo *info;
638
639     if (parent)
640       info = (GstDiscovererAudioInfo *) parent;
641     else {
642       info = (GstDiscovererAudioInfo *)
643           gst_mini_object_new (GST_TYPE_DISCOVERER_AUDIO_INFO);
644       info->parent.caps = caps;
645     }
646
647     if (gst_structure_get_int (caps_st, "rate", &tmp))
648       info->sample_rate = (guint) tmp;
649
650     if (gst_structure_get_int (caps_st, "channels", &tmp))
651       info->channels = (guint) tmp;
652
653     if (gst_structure_get_int (caps_st, "depth", &tmp))
654       info->depth = (guint) tmp;
655
656     if (gst_structure_id_has_field (st, _TAGS_QUARK)) {
657       gst_structure_id_get (st, _TAGS_QUARK,
658           GST_TYPE_STRUCTURE, &tags_st, NULL);
659       if (gst_structure_get_uint (tags_st, GST_TAG_BITRATE, &utmp) ||
660           gst_structure_get_uint (tags_st, GST_TAG_NOMINAL_BITRATE, &utmp))
661         info->bitrate = utmp;
662
663       if (gst_structure_get_uint (tags_st, GST_TAG_MAXIMUM_BITRATE, &utmp))
664         info->max_bitrate = utmp;
665
666       /* FIXME: Is it worth it to remove the tags we've parsed? */
667       info->parent.tags = gst_tag_list_merge (info->parent.tags,
668           (GstTagList *) tags_st, GST_TAG_MERGE_REPLACE);
669
670       gst_structure_free (tags_st);
671     }
672
673     if (!info->language && ((GstDiscovererStreamInfo *) info)->tags) {
674       gchar *language;
675       if (gst_tag_list_get_string (((GstDiscovererStreamInfo *) info)->tags,
676               GST_TAG_LANGUAGE_CODE, &language)) {
677         info->language = language;
678       }
679     }
680
681     return (GstDiscovererStreamInfo *) info;
682
683   } else if (g_str_has_prefix (name, "video/") ||
684       g_str_has_prefix (name, "image/")) {
685     GstDiscovererVideoInfo *info;
686
687     if (parent)
688       info = (GstDiscovererVideoInfo *) parent;
689     else {
690       info = (GstDiscovererVideoInfo *)
691           gst_mini_object_new (GST_TYPE_DISCOVERER_VIDEO_INFO);
692       info->parent.caps = caps;
693     }
694
695     if (gst_structure_get_int (caps_st, "width", &tmp) &&
696         gst_structure_get_int (caps_st, "height", &tmp2)) {
697       info->width = (guint) tmp;
698       info->height = (guint) tmp2;
699     }
700
701     if (gst_structure_get_int (caps_st, "depth", &tmp))
702       info->depth = (guint) tmp;
703
704     if (gst_structure_get_fraction (caps_st, "pixel-aspect-ratio", &tmp, &tmp2)) {
705       info->par_num = tmp;
706       info->par_denom = tmp2;
707     } else {
708       info->par_num = 1;
709       info->par_denom = 1;
710     }
711
712     if (gst_structure_get_fraction (caps_st, "framerate", &tmp, &tmp2)) {
713       info->framerate_num = tmp;
714       info->framerate_denom = tmp2;
715     }
716
717     if (!gst_structure_get_boolean (caps_st, "interlaced", &info->interlaced))
718       info->interlaced = FALSE;
719
720     if (gst_structure_id_has_field (st, _TAGS_QUARK)) {
721       gst_structure_id_get (st, _TAGS_QUARK,
722           GST_TYPE_STRUCTURE, &tags_st, NULL);
723       if (gst_structure_get_uint (tags_st, GST_TAG_BITRATE, &utmp) ||
724           gst_structure_get_uint (tags_st, GST_TAG_NOMINAL_BITRATE, &utmp))
725         info->bitrate = utmp;
726
727       if (gst_structure_get_uint (tags_st, GST_TAG_MAXIMUM_BITRATE, &utmp))
728         info->max_bitrate = utmp;
729
730       /* FIXME: Is it worth it to remove the tags we've parsed? */
731       info->parent.tags = gst_tag_list_merge (info->parent.tags,
732           (GstTagList *) tags_st, GST_TAG_MERGE_REPLACE);
733       gst_structure_free (tags_st);
734     }
735
736     return (GstDiscovererStreamInfo *) info;
737
738   } else if (is_subtitle_caps (caps)) {
739     GstDiscovererSubtitleInfo *info;
740
741     if (parent)
742       info = (GstDiscovererSubtitleInfo *) parent;
743     else {
744       info = (GstDiscovererSubtitleInfo *)
745           gst_mini_object_new (GST_TYPE_DISCOVERER_SUBTITLE_INFO);
746       info->parent.caps = caps;
747     }
748
749     if (gst_structure_id_has_field (st, _TAGS_QUARK)) {
750       const gchar *language;
751
752       gst_structure_id_get (st, _TAGS_QUARK,
753           GST_TYPE_STRUCTURE, &tags_st, NULL);
754
755       language = gst_structure_get_string (caps_st, GST_TAG_LANGUAGE_CODE);
756       if (language)
757         info->language = g_strdup (language);
758
759       /* FIXME: Is it worth it to remove the tags we've parsed? */
760       info->parent.tags = gst_tag_list_merge (info->parent.tags,
761           (GstTagList *) tags_st, GST_TAG_MERGE_REPLACE);
762       gst_structure_free (tags_st);
763
764     }
765
766     if (!info->language && ((GstDiscovererStreamInfo *) info)->tags) {
767       gchar *language;
768       if (gst_tag_list_get_string (((GstDiscovererStreamInfo *) info)->tags,
769               GST_TAG_LANGUAGE_CODE, &language)) {
770         info->language = language;
771       }
772     }
773
774     return (GstDiscovererStreamInfo *) info;
775
776   } else {
777     /* None of the above - populate what information we can */
778     GstDiscovererStreamInfo *info;
779
780     if (parent)
781       info = parent;
782     else {
783       info = (GstDiscovererStreamInfo *)
784           gst_mini_object_new (GST_TYPE_DISCOVERER_STREAM_INFO);
785       info->caps = caps;
786     }
787
788     if (gst_structure_id_get (st, _TAGS_QUARK,
789             GST_TYPE_STRUCTURE, &tags_st, NULL)) {
790       info->tags = gst_tag_list_merge (info->tags, (GstTagList *) tags_st,
791           GST_TAG_MERGE_REPLACE);
792       gst_structure_free (tags_st);
793     }
794
795     return info;
796   }
797
798 }
799
800 static GstStructure *
801 find_stream_for_node (GstDiscoverer * dc, const GstStructure * topology)
802 {
803   GstPad *pad;
804   GstPad *target_pad = NULL;
805   GstStructure *st = NULL;
806   PrivateStream *ps;
807   guint i;
808   GList *tmp;
809
810   if (!gst_structure_id_has_field (topology, _TOPOLOGY_PAD_QUARK)) {
811     GST_DEBUG ("Could not find pad for node %" GST_PTR_FORMAT "\n", topology);
812     return NULL;
813   }
814
815   gst_structure_id_get (topology, _TOPOLOGY_PAD_QUARK,
816       GST_TYPE_PAD, &pad, NULL);
817
818   if (!dc->priv->streams)
819     return NULL;
820
821   for (i = 0, tmp = dc->priv->streams; tmp; tmp = tmp->next, i++) {
822     ps = (PrivateStream *) tmp->data;
823
824     target_pad = gst_ghost_pad_get_target (GST_GHOST_PAD (ps->pad));
825     gst_object_unref (target_pad);
826
827     if (target_pad == pad)
828       break;
829   }
830
831   if (tmp)
832     st = collect_stream_information (dc, ps, i);
833
834   gst_object_unref (pad);
835
836   return st;
837 }
838
839 static gboolean
840 child_is_raw_stream (GstCaps * parent, GstCaps * child)
841 {
842   GstStructure *st1, *st2;
843   const gchar *name1, *name2;
844
845   st1 = gst_caps_get_structure (parent, 0);
846   name1 = gst_structure_get_name (st1);
847   st2 = gst_caps_get_structure (child, 0);
848   name2 = gst_structure_get_name (st2);
849
850   if ((g_str_has_prefix (name1, "audio/") &&
851           g_str_has_prefix (name2, "audio/x-raw")) ||
852       ((g_str_has_prefix (name1, "video/") ||
853               g_str_has_prefix (name1, "image/")) &&
854           g_str_has_prefix (name2, "video/x-raw"))) {
855     /* child is the "raw" sub-stream corresponding to parent */
856     return TRUE;
857   }
858
859   if (is_subtitle_caps (parent))
860     return TRUE;
861
862   return FALSE;
863 }
864
865 /* If a parent is non-NULL, collected stream information will be appended to it
866  * (and where the information exists, it will be overriden)
867  */
868 static GstDiscovererStreamInfo *
869 parse_stream_topology (GstDiscoverer * dc, const GstStructure * topology,
870     GstDiscovererStreamInfo * parent)
871 {
872   GstDiscovererStreamInfo *res = NULL;
873   GstCaps *caps = NULL;
874   const GValue *nval = NULL;
875
876   GST_DEBUG ("parsing: %" GST_PTR_FORMAT, topology);
877
878   nval = gst_structure_get_value (topology, "next");
879
880   if (nval == NULL || GST_VALUE_HOLDS_STRUCTURE (nval)) {
881     GstStructure *st = find_stream_for_node (dc, topology);
882     gboolean add_to_list = TRUE;
883
884     if (st) {
885       res = collect_information (dc, st, parent);
886       gst_structure_free (st);
887     } else {
888       /* Didn't find a stream structure, so let's just use the caps we have */
889       res = collect_information (dc, topology, parent);
890     }
891
892     if (nval == NULL) {
893       /* FIXME : aggregate with information from main streams */
894       GST_DEBUG ("Coudn't find 'next' ! might be the last entry");
895     } else {
896       GstCaps *caps;
897       const GstStructure *st;
898
899       st = gst_value_get_structure (nval);
900
901       GST_DEBUG ("next is a structure %" GST_PTR_FORMAT, st);
902
903       if (!parent)
904         parent = res;
905
906       if (gst_structure_id_get (st, _CAPS_QUARK, GST_TYPE_CAPS, &caps, NULL)) {
907         if (gst_caps_can_intersect (parent->caps, caps)) {
908           /* We sometimes get an extra sub-stream from the parser. If this is
909            * the case, we just replace the parent caps with this stream's caps
910            * since they might contain more information */
911           gst_caps_unref (parent->caps);
912           parent->caps = caps;
913
914           parse_stream_topology (dc, st, parent);
915           add_to_list = FALSE;
916
917         } else if (child_is_raw_stream (parent->caps, caps)) {
918           /* This is the "raw" stream corresponding to the parent. This
919            * contains more information than the parent, tags etc. */
920           parse_stream_topology (dc, st, parent);
921           add_to_list = FALSE;
922           gst_caps_unref (caps);
923
924         } else {
925           GstDiscovererStreamInfo *next = parse_stream_topology (dc, st, NULL);
926           res->next = next;
927           next->previous = res;
928         }
929       }
930     }
931
932     if (add_to_list) {
933       dc->priv->current_info->stream_list =
934           g_list_append (dc->priv->current_info->stream_list, res);
935     }
936
937   } else if (GST_VALUE_HOLDS_LIST (nval)) {
938     guint i, len;
939     GstDiscovererContainerInfo *cont;
940     GstTagList *tags;
941
942     if (!gst_structure_id_get (topology, _CAPS_QUARK,
943             GST_TYPE_CAPS, &caps, NULL))
944       GST_WARNING ("Couldn't find caps !");
945
946     len = gst_value_list_get_size (nval);
947     GST_DEBUG ("next is a list of %d entries", len);
948
949     cont = (GstDiscovererContainerInfo *)
950         gst_mini_object_new (GST_TYPE_DISCOVERER_CONTAINER_INFO);
951     cont->parent.caps = caps;
952     res = (GstDiscovererStreamInfo *) cont;
953
954     if (gst_structure_id_has_field (topology, _TAGS_QUARK)) {
955       GstTagList *tmp;
956
957       gst_structure_id_get (topology, _TAGS_QUARK,
958           GST_TYPE_STRUCTURE, &tags, NULL);
959
960       GST_DEBUG ("Merge tags %" GST_PTR_FORMAT, tags);
961
962       tmp =
963           gst_tag_list_merge (cont->parent.tags, (GstTagList *) tags,
964           GST_TAG_MERGE_APPEND);
965       gst_tag_list_free (tags);
966       if (cont->parent.tags)
967         gst_tag_list_free (cont->parent.tags);
968       cont->parent.tags = tmp;
969       GST_DEBUG ("Container info tags %" GST_PTR_FORMAT, tmp);
970     }
971
972     for (i = 0; i < len; i++) {
973       const GValue *subv = gst_value_list_get_value (nval, i);
974       const GstStructure *subst = gst_value_get_structure (subv);
975       GstDiscovererStreamInfo *substream;
976
977       GST_DEBUG ("%d %" GST_PTR_FORMAT, i, subst);
978
979       substream = parse_stream_topology (dc, subst, NULL);
980
981       substream->previous = res;
982       cont->streams =
983           g_list_append (cont->streams,
984           gst_discoverer_stream_info_ref (substream));
985     }
986   }
987
988   return res;
989 }
990
991 /* Called when pipeline is pre-rolled */
992 static void
993 discoverer_collect (GstDiscoverer * dc)
994 {
995   GST_DEBUG ("Collecting information");
996
997   /* Stop the timeout handler if present */
998   if (dc->priv->timeoutid) {
999     g_source_remove (dc->priv->timeoutid);
1000     dc->priv->timeoutid = 0;
1001   }
1002
1003   if (dc->priv->streams) {
1004     /* FIXME : Make this querying optional */
1005     if (TRUE) {
1006       GstElement *pipeline = (GstElement *) dc->priv->pipeline;
1007       GstFormat format = GST_FORMAT_TIME;
1008       gint64 dur;
1009
1010       GST_DEBUG ("Attempting to query duration");
1011
1012       if (gst_element_query_duration (pipeline, &format, &dur)) {
1013         if (format == GST_FORMAT_TIME) {
1014           GST_DEBUG ("Got duration %" GST_TIME_FORMAT, GST_TIME_ARGS (dur));
1015           dc->priv->current_info->duration = (guint64) dur;
1016         }
1017       }
1018
1019       if (dc->priv->seeking_query) {
1020         if (gst_element_query (pipeline, dc->priv->seeking_query)) {
1021           gboolean seekable;
1022
1023           gst_query_parse_seeking (dc->priv->seeking_query, &format,
1024               &seekable, NULL, NULL);
1025           if (format == GST_FORMAT_TIME) {
1026             GST_DEBUG ("Got seekable %d", seekable);
1027             dc->priv->current_info->seekable = seekable;
1028           }
1029         }
1030       }
1031     }
1032
1033     if (dc->priv->current_topology)
1034       dc->priv->current_info->stream_info = parse_stream_topology (dc,
1035           dc->priv->current_topology, NULL);
1036
1037     /*
1038      * Images need some special handling. They do not have a duration, have
1039      * caps named image/<foo> (th exception being MJPEG video which is also
1040      * type image/jpeg), and should consist of precisely one stream (actually
1041      * initially there are 2, the image and raw stream, but we squash these
1042      * while parsing the stream topology). At some point, if we find that these
1043      * conditions are not sufficient, we can count the number of decoders and
1044      * parsers in the chain, and if there's more than one decoder, or any
1045      * parser at all, we should not mark this as an image.
1046      */
1047     if (dc->priv->current_info->duration == 0 &&
1048         dc->priv->current_info->stream_info != NULL &&
1049         dc->priv->current_info->stream_info->next == NULL) {
1050       GstStructure *st =
1051           gst_caps_get_structure (dc->priv->current_info->stream_info->caps, 0);
1052
1053       if (g_str_has_prefix (gst_structure_get_name (st), "image/"))
1054         ((GstDiscovererVideoInfo *) dc->priv->current_info->stream_info)->
1055             is_image = TRUE;
1056     }
1057   }
1058
1059   if (dc->priv->async) {
1060     GST_DEBUG ("Emitting 'discoverered'");
1061     g_signal_emit (dc, gst_discoverer_signals[SIGNAL_DISCOVERED], 0,
1062         dc->priv->current_info, dc->priv->current_error);
1063     /* Clients get a copy of current_info since it is a boxed type */
1064     gst_discoverer_info_unref (dc->priv->current_info);
1065   }
1066 }
1067
1068 static void
1069 get_async_cb (gpointer cb_data, GSource * source, GSourceFunc * func,
1070     gpointer * data)
1071 {
1072   *func = (GSourceFunc) async_timeout_cb;
1073   *data = cb_data;
1074 }
1075
1076 /* Wrapper since GSourceCallbackFuncs don't expect a return value from ref() */
1077 static void
1078 _void_g_object_ref (gpointer object)
1079 {
1080   g_object_ref (G_OBJECT (object));
1081 }
1082
1083 static void
1084 handle_current_async (GstDiscoverer * dc)
1085 {
1086   GSource *source;
1087   static GSourceCallbackFuncs cb_funcs = {
1088     _void_g_object_ref,
1089     g_object_unref,
1090     get_async_cb,
1091   };
1092
1093   /* Attach a timeout to the main context */
1094   source = g_timeout_source_new (dc->priv->timeout / GST_MSECOND);
1095   g_source_set_callback_indirect (source, g_object_ref (dc), &cb_funcs);
1096   dc->priv->timeoutid = g_source_attach (source, dc->priv->ctx);
1097   g_source_unref (source);
1098 }
1099
1100
1101 /* Returns TRUE if processing should stop */
1102 static gboolean
1103 handle_message (GstDiscoverer * dc, GstMessage * msg)
1104 {
1105   gboolean done = FALSE;
1106
1107   GST_DEBUG_OBJECT (GST_MESSAGE_SRC (msg), "got a %s message",
1108       GST_MESSAGE_TYPE_NAME (msg));
1109
1110   switch (GST_MESSAGE_TYPE (msg)) {
1111     case GST_MESSAGE_ERROR:{
1112       GError *gerr;
1113       gchar *debug;
1114
1115       gst_message_parse_error (msg, &gerr, &debug);
1116       GST_WARNING_OBJECT (GST_MESSAGE_SRC (msg),
1117           "Got an error [debug:%s], [message:%s]", debug, gerr->message);
1118       dc->priv->current_error = gerr;
1119       g_free (debug);
1120
1121       /* We need to stop */
1122       done = TRUE;
1123
1124       GST_DEBUG ("Setting result to ERROR");
1125       dc->priv->current_info->result = GST_DISCOVERER_ERROR;
1126     }
1127       break;
1128
1129     case GST_MESSAGE_EOS:
1130       GST_DEBUG ("Got EOS !");
1131       done = TRUE;
1132       break;
1133
1134     case GST_MESSAGE_ASYNC_DONE:
1135       if (GST_MESSAGE_SRC (msg) == (GstObject *) dc->priv->pipeline) {
1136         GST_DEBUG ("Finished changing state asynchronously");
1137         done = TRUE;
1138
1139       }
1140       break;
1141
1142     case GST_MESSAGE_ELEMENT:
1143     {
1144       GQuark sttype = gst_structure_get_name_id (msg->structure);
1145       GST_DEBUG_OBJECT (GST_MESSAGE_SRC (msg),
1146           "structure %" GST_PTR_FORMAT, msg->structure);
1147       if (sttype == _MISSING_PLUGIN_QUARK) {
1148         GST_DEBUG_OBJECT (GST_MESSAGE_SRC (msg),
1149             "Setting result to MISSING_PLUGINS");
1150         dc->priv->current_info->result = GST_DISCOVERER_MISSING_PLUGINS;
1151         dc->priv->current_info->misc = gst_structure_copy (msg->structure);
1152       } else if (sttype == _STREAM_TOPOLOGY_QUARK) {
1153         dc->priv->current_topology = gst_structure_copy (msg->structure);
1154       }
1155     }
1156       break;
1157
1158     case GST_MESSAGE_TAG:
1159     {
1160       GstTagList *tl, *tmp;
1161
1162       gst_message_parse_tag (msg, &tl);
1163       GST_DEBUG_OBJECT (GST_MESSAGE_SRC (msg), "Got tags %" GST_PTR_FORMAT, tl);
1164       /* Merge with current tags */
1165       tmp =
1166           gst_tag_list_merge (dc->priv->current_info->tags, tl,
1167           GST_TAG_MERGE_APPEND);
1168       gst_tag_list_free (tl);
1169       if (dc->priv->current_info->tags)
1170         gst_tag_list_free (dc->priv->current_info->tags);
1171       dc->priv->current_info->tags = tmp;
1172       GST_DEBUG_OBJECT (GST_MESSAGE_SRC (msg), "Current info %p, tags %"
1173           GST_PTR_FORMAT, dc->priv->current_info, tmp);
1174     }
1175       break;
1176
1177     default:
1178       break;
1179   }
1180
1181   return done;
1182 }
1183
1184
1185 static void
1186 handle_current_sync (GstDiscoverer * dc)
1187 {
1188   GTimer *timer;
1189   gdouble deadline = ((gdouble) dc->priv->timeout) / GST_SECOND;
1190   GstMessage *msg;
1191   gboolean done = FALSE;
1192
1193   timer = g_timer_new ();
1194   g_timer_start (timer);
1195
1196   do {
1197     /* poll bus with timeout */
1198     /* FIXME : make the timeout more fine-tuned */
1199     if ((msg = gst_bus_timed_pop (dc->priv->bus, GST_SECOND / 2))) {
1200       done = handle_message (dc, msg);
1201       gst_message_unref (msg);
1202     }
1203
1204   } while (!done && (g_timer_elapsed (timer, NULL) < deadline));
1205
1206   /* return result */
1207   if (!done) {
1208     GST_DEBUG ("we timed out! Setting result to TIMEOUT");
1209     dc->priv->current_info->result = GST_DISCOVERER_TIMEOUT;
1210   }
1211
1212   GST_DEBUG ("Done");
1213
1214   g_timer_stop (timer);
1215   g_timer_destroy (timer);
1216 }
1217
1218 static void
1219 _setup_locked (GstDiscoverer * dc)
1220 {
1221   GstStateChangeReturn ret;
1222
1223   GST_DEBUG ("Setting up");
1224
1225   /* Pop URI off the pending URI list */
1226   dc->priv->current_info =
1227       (GstDiscovererInfo *) gst_mini_object_new (GST_TYPE_DISCOVERER_INFO);
1228   dc->priv->current_info->uri = (gchar *) dc->priv->pending_uris->data;
1229   dc->priv->pending_uris =
1230       g_list_delete_link (dc->priv->pending_uris, dc->priv->pending_uris);
1231
1232   /* set uri on uridecodebin */
1233   g_object_set (dc->priv->uridecodebin, "uri", dc->priv->current_info->uri,
1234       NULL);
1235
1236   GST_DEBUG ("Current is now %s", dc->priv->current_info->uri);
1237
1238   dc->priv->processing = TRUE;
1239
1240   /* set pipeline to PAUSED */
1241   DISCO_UNLOCK (dc);
1242   GST_DEBUG ("Setting pipeline to PAUSED");
1243   ret =
1244       gst_element_set_state ((GstElement *) dc->priv->pipeline,
1245       GST_STATE_PAUSED);
1246   DISCO_LOCK (dc);
1247
1248   GST_DEBUG_OBJECT (dc, "Pipeline going to PAUSED : %s",
1249       gst_element_state_change_return_get_name (ret));
1250 }
1251
1252 static void
1253 discoverer_cleanup (GstDiscoverer * dc)
1254 {
1255   GST_DEBUG ("Cleaning up");
1256
1257   gst_bus_set_flushing (dc->priv->bus, TRUE);
1258   gst_element_set_state ((GstElement *) dc->priv->pipeline, GST_STATE_READY);
1259   gst_bus_set_flushing (dc->priv->bus, FALSE);
1260
1261   DISCO_LOCK (dc);
1262   if (dc->priv->current_error)
1263     g_error_free (dc->priv->current_error);
1264   dc->priv->current_error = NULL;
1265   if (dc->priv->current_topology) {
1266     gst_structure_free (dc->priv->current_topology);
1267     dc->priv->current_topology = NULL;
1268   }
1269
1270   dc->priv->current_info = NULL;
1271
1272   /* Try popping the next uri */
1273   if (dc->priv->async) {
1274     if (dc->priv->pending_uris != NULL) {
1275       _setup_locked (dc);
1276       DISCO_UNLOCK (dc);
1277       /* Start timeout */
1278       handle_current_async (dc);
1279     } else {
1280       /* We're done ! */
1281       DISCO_UNLOCK (dc);
1282       g_signal_emit (dc, gst_discoverer_signals[SIGNAL_FINISHED], 0);
1283     }
1284   } else
1285     DISCO_UNLOCK (dc);
1286
1287   GST_DEBUG ("out");
1288 }
1289
1290 static void
1291 discoverer_bus_cb (GstBus * bus, GstMessage * msg, GstDiscoverer * dc)
1292 {
1293   if (dc->priv->processing) {
1294     if (handle_message (dc, msg)) {
1295       GST_DEBUG ("Stopping asynchronously");
1296       /* Serialise with _event_probe() */
1297       DISCO_LOCK (dc);
1298       dc->priv->processing = FALSE;
1299       DISCO_UNLOCK (dc);
1300       discoverer_collect (dc);
1301       discoverer_cleanup (dc);
1302     }
1303   }
1304 }
1305
1306 static gboolean
1307 async_timeout_cb (GstDiscoverer * dc)
1308 {
1309   if (!g_source_is_destroyed (g_main_current_source ())) {
1310     dc->priv->timeoutid = 0;
1311     GST_DEBUG ("Setting result to TIMEOUT");
1312     dc->priv->current_info->result = GST_DISCOVERER_TIMEOUT;
1313     dc->priv->processing = FALSE;
1314     discoverer_collect (dc);
1315     discoverer_cleanup (dc);
1316   }
1317   return FALSE;
1318 }
1319
1320 /* If there is a pending URI, it will pop it from the list of pending
1321  * URIs and start the discovery on it.
1322  *
1323  * Returns GST_DISCOVERER_OK if the next URI was popped and is processing,
1324  * else a error flag.
1325  */
1326 static GstDiscovererResult
1327 start_discovering (GstDiscoverer * dc)
1328 {
1329   GstDiscovererResult res = GST_DISCOVERER_OK;
1330
1331   GST_DEBUG ("Starting");
1332
1333   DISCO_LOCK (dc);
1334   if (dc->priv->pending_uris == NULL) {
1335     GST_WARNING ("No URI to process");
1336     res = GST_DISCOVERER_URI_INVALID;
1337     DISCO_UNLOCK (dc);
1338     goto beach;
1339   }
1340
1341   if (dc->priv->current_info != NULL) {
1342     GST_WARNING ("Already processing a file");
1343     res = GST_DISCOVERER_BUSY;
1344     DISCO_UNLOCK (dc);
1345     goto beach;
1346   }
1347
1348   g_signal_emit (dc, gst_discoverer_signals[SIGNAL_STARTING], 0);
1349
1350   _setup_locked (dc);
1351
1352   DISCO_UNLOCK (dc);
1353
1354   if (dc->priv->async)
1355     handle_current_async (dc);
1356   else
1357     handle_current_sync (dc);
1358
1359 beach:
1360   return res;
1361 }
1362
1363
1364 /**
1365  * gst_discoverer_start:
1366  * @discoverer: A #GstDiscoverer
1367  *
1368  * Allow asynchronous discovering of URIs to take place.
1369  * A #GMainLoop must be available for #GstDiscoverer to properly work in
1370  * asynchronous mode.
1371  *
1372  * Since: 0.10.31
1373  */
1374 void
1375 gst_discoverer_start (GstDiscoverer * discoverer)
1376 {
1377   GSource *source;
1378   GMainContext *ctx = NULL;
1379
1380   GST_DEBUG_OBJECT (discoverer, "Starting...");
1381
1382   if (discoverer->priv->async) {
1383     GST_DEBUG_OBJECT (discoverer, "We were already started");
1384     return;
1385   }
1386
1387   discoverer->priv->async = TRUE;
1388   discoverer->priv->running = TRUE;
1389
1390   ctx = g_main_context_get_thread_default ();
1391
1392   /* Connect to bus signals */
1393   if (ctx == NULL)
1394     ctx = g_main_context_default ();
1395
1396   source = gst_bus_create_watch (discoverer->priv->bus);
1397   g_source_set_callback (source, (GSourceFunc) gst_bus_async_signal_func,
1398       NULL, NULL);
1399   discoverer->priv->sourceid = g_source_attach (source, ctx);
1400   g_source_unref (source);
1401   discoverer->priv->ctx = g_main_context_ref (ctx);
1402
1403   start_discovering (discoverer);
1404   GST_DEBUG_OBJECT (discoverer, "Started");
1405 }
1406
1407 /**
1408  * gst_discoverer_stop:
1409  * @discoverer: A #GstDiscoverer
1410  *
1411  * Stop the discovery of any pending URIs and clears the list of
1412  * pending URIS (if any).
1413  *
1414  * Since: 0.10.31
1415  */
1416 void
1417 gst_discoverer_stop (GstDiscoverer * discoverer)
1418 {
1419   GST_DEBUG_OBJECT (discoverer, "Stopping...");
1420
1421   if (!discoverer->priv->async) {
1422     GST_DEBUG_OBJECT (discoverer,
1423         "We were already stopped, or running synchronously");
1424     return;
1425   }
1426
1427   DISCO_LOCK (discoverer);
1428   if (discoverer->priv->processing) {
1429     /* We prevent any further processing by setting the bus to
1430      * flushing and setting the pipeline to READY.
1431      * _reset() will take care of the rest of the cleanup */
1432     if (discoverer->priv->bus)
1433       gst_bus_set_flushing (discoverer->priv->bus, TRUE);
1434     if (discoverer->priv->pipeline)
1435       gst_element_set_state ((GstElement *) discoverer->priv->pipeline,
1436           GST_STATE_READY);
1437   }
1438   discoverer->priv->running = FALSE;
1439   DISCO_UNLOCK (discoverer);
1440
1441   /* Remove timeout handler */
1442   if (discoverer->priv->timeoutid) {
1443     g_source_remove (discoverer->priv->timeoutid);
1444     discoverer->priv->timeoutid = 0;
1445   }
1446   /* Remove signal watch */
1447   if (discoverer->priv->sourceid) {
1448     g_source_remove (discoverer->priv->sourceid);
1449     discoverer->priv->sourceid = 0;
1450   }
1451   /* Unref main context */
1452   if (discoverer->priv->ctx) {
1453     g_main_context_unref (discoverer->priv->ctx);
1454     discoverer->priv->ctx = NULL;
1455   }
1456   discoverer_reset (discoverer);
1457
1458   discoverer->priv->async = FALSE;
1459
1460   GST_DEBUG_OBJECT (discoverer, "Stopped");
1461 }
1462
1463 /**
1464  * gst_discoverer_discover_uri_async:
1465  * @discoverer: A #GstDiscoverer
1466  * @uri: the URI to add.
1467  *
1468  * Appends the given @uri to the list of URIs to discoverer. The actual
1469  * discovery of the @uri will only take place if gst_discoverer_start() has
1470  * been called.
1471  *
1472  * A copy of @uri will be made internally, so the caller can safely g_free()
1473  * afterwards.
1474  *
1475  * Returns: %TRUE if the @uri was successfully appended to the list of pending
1476  * uris, else %FALSE
1477  *
1478  * Since: 0.10.31
1479  */
1480 gboolean
1481 gst_discoverer_discover_uri_async (GstDiscoverer * discoverer,
1482     const gchar * uri)
1483 {
1484   gboolean can_run;
1485
1486   GST_DEBUG_OBJECT (discoverer, "uri : %s", uri);
1487
1488   DISCO_LOCK (discoverer);
1489   can_run = (discoverer->priv->pending_uris == NULL);
1490   discoverer->priv->pending_uris =
1491       g_list_append (discoverer->priv->pending_uris, g_strdup (uri));
1492   DISCO_UNLOCK (discoverer);
1493
1494   if (can_run)
1495     start_discovering (discoverer);
1496
1497   return TRUE;
1498 }
1499
1500
1501 /* Synchronous mode */
1502 /**
1503  * gst_discoverer_discover_uri:
1504  * @discoverer: A #GstDiscoverer
1505  * @uri: The URI to run on.
1506  * @err: (out) (allow-none): If an error occurred, this field will be filled in.
1507  *
1508  * Synchronously discovers the given @uri.
1509  *
1510  * A copy of @uri will be made internally, so the caller can safely g_free()
1511  * afterwards.
1512  *
1513  * Returns: (transfer full): the result of the scanning. Can be %NULL if an
1514  * error occurred.
1515  *
1516  * Since: 0.10.31
1517  */
1518 GstDiscovererInfo *
1519 gst_discoverer_discover_uri (GstDiscoverer * discoverer, const gchar * uri,
1520     GError ** err)
1521 {
1522   GstDiscovererResult res = 0;
1523   GstDiscovererInfo *info;
1524
1525   GST_DEBUG_OBJECT (discoverer, "uri:%s", uri);
1526
1527   DISCO_LOCK (discoverer);
1528   if (G_UNLIKELY (discoverer->priv->current_info)) {
1529     DISCO_UNLOCK (discoverer);
1530     GST_WARNING_OBJECT (discoverer, "Already handling a uri");
1531     return NULL;
1532   }
1533
1534   discoverer->priv->pending_uris =
1535       g_list_append (discoverer->priv->pending_uris, g_strdup (uri));
1536   DISCO_UNLOCK (discoverer);
1537
1538   res = start_discovering (discoverer);
1539   discoverer_collect (discoverer);
1540
1541   /* Get results */
1542   if (err) {
1543     if (discoverer->priv->current_error)
1544       *err = g_error_copy (discoverer->priv->current_error);
1545     else
1546       *err = NULL;
1547   }
1548   if (res != GST_DISCOVERER_OK) {
1549     GST_DEBUG ("Setting result to %d (was %d)", res,
1550         discoverer->priv->current_info->result);
1551     discoverer->priv->current_info->result = res;
1552   }
1553   info = discoverer->priv->current_info;
1554
1555   discoverer_cleanup (discoverer);
1556
1557   return info;
1558 }
1559
1560 /**
1561  * gst_discoverer_new:
1562  * @timeout: timeout per file, in nanoseconds. Allowed are values between
1563  *     one second (#GST_SECOND) and one hour (3600 * #GST_SECOND)
1564  * @err: a pointer to a #GError. can be %NULL
1565  *
1566  * Creates a new #GstDiscoverer with the provided timeout.
1567  *
1568  * Returns: (transfer full): The new #GstDiscoverer.
1569  * If an error occurred when creating the discoverer, @err will be set
1570  * accordingly and %NULL will be returned. If @err is set, the caller must
1571  * free it when no longer needed using g_error_free().
1572  *
1573  * Since: 0.10.31
1574  */
1575 GstDiscoverer *
1576 gst_discoverer_new (GstClockTime timeout, GError ** err)
1577 {
1578   GstDiscoverer *res;
1579
1580   res = g_object_new (GST_TYPE_DISCOVERER, "timeout", timeout, NULL);
1581   if (res->priv->uridecodebin == NULL) {
1582     if (err)
1583       *err = g_error_new (GST_CORE_ERROR, GST_CORE_ERROR_MISSING_PLUGIN,
1584           "Couldn't create 'uridecodebin' element");
1585     gst_object_unref (res);
1586     res = NULL;
1587   }
1588   return res;
1589 }