2 * Copyright (C) <2007> Wim Taymans <wim.taymans@gmail.com>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * SECTION:element-uridecodebin
23 * Decodes data from a URI into raw media. It selects a source element that can
24 * handle the given #GstURIDecodeBin:uri scheme and connects it to a decodebin.
27 /* FIXME 0.11: suppress warnings for deprecated API such as GValueArray
28 * with newer GLib versions (>= 2.31.0) */
29 #define GLIB_DISABLE_DEPRECATION_WARNINGS
38 #include <gst/gst-i18n-plugin.h>
39 #include <gst/pbutils/missing-plugins.h>
41 #include "gstplay-enum.h"
42 #include "gstrawcaps.h"
43 #include "gstplayback.h"
45 /* From gstdecodebin2.c */
46 gint _decode_bin_compare_factories_func (gconstpointer p1, gconstpointer p2);
48 #define GST_TYPE_URI_DECODE_BIN \
49 (gst_uri_decode_bin_get_type())
50 #define GST_URI_DECODE_BIN(obj) \
51 (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_URI_DECODE_BIN,GstURIDecodeBin))
52 #define GST_URI_DECODE_BIN_CLASS(klass) \
53 (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_URI_DECODE_BIN,GstURIDecodeBinClass))
54 #define GST_IS_URI_DECODE_BIN(obj) \
55 (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_URI_DECODE_BIN))
56 #define GST_IS_URI_DECODE_BIN_CLASS(klass) \
57 (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_URI_DECODE_BIN))
58 #define GST_URI_DECODE_BIN_CAST(obj) ((GstURIDecodeBin *) (obj))
60 typedef struct _GstURIDecodeBin GstURIDecodeBin;
61 typedef struct _GstURIDecodeBinClass GstURIDecodeBinClass;
63 #define GST_URI_DECODE_BIN_GET_LOCK(dec) (((GstURIDecodeBin*)(dec))->lock)
64 #define GST_URI_DECODE_BIN_LOCK(dec) (g_mutex_lock(GST_URI_DECODE_BIN_GET_LOCK(dec)))
65 #define GST_URI_DECODE_BIN_UNLOCK(dec) (g_mutex_unlock(GST_URI_DECODE_BIN_GET_LOCK(dec)))
67 typedef struct _GstURIDecodeBinStream
71 } GstURIDecodeBinStream;
76 * uridecodebin element struct
78 struct _GstURIDecodeBin
80 GstBin parent_instance;
82 GMutex *lock; /* lock for constructing */
84 GMutex *factories_lock;
85 guint32 factories_cookie;
86 GList *factories; /* factories we can use for selecting elements */
89 guint64 connection_speed;
96 guint64 buffer_duration; /* When buffering, buffer duration (ns) */
97 guint buffer_size; /* When buffering, buffer size (bytes) */
99 gboolean use_buffering;
103 GstElement *typefind;
104 guint have_type_id; /* have-type signal id from typefind */
106 GSList *pending_decodebins;
110 /* for dynamic sources */
111 guint src_np_sig_id; /* new-pad signal id */
112 guint src_nmp_sig_id; /* no-more-pads signal id */
115 gboolean async_pending; /* async-start has been emitted */
117 gboolean expose_allstreams; /* Whether to expose unknow type streams or not */
119 guint64 ring_buffer_max_size; /* 0 means disabled */
122 struct _GstURIDecodeBinClass
124 GstBinClass parent_class;
126 /* signal fired when we found a pad that we cannot decode */
127 void (*unknown_type) (GstElement * element, GstPad * pad, GstCaps * caps);
129 /* signal fired to know if we continue trying to decode the given caps */
130 gboolean (*autoplug_continue) (GstElement * element, GstPad * pad,
132 /* signal fired to get a list of factories to try to autoplug */
133 GValueArray *(*autoplug_factories) (GstElement * element, GstPad * pad,
135 /* signal fired to sort the factories */
136 GValueArray *(*autoplug_sort) (GstElement * element, GstPad * pad,
137 GstCaps * caps, GValueArray * factories);
138 /* signal fired to select from the proposed list of factories */
139 GstAutoplugSelectResult (*autoplug_select) (GstElement * element,
140 GstPad * pad, GstCaps * caps, GstElementFactory * factory);
142 /* emitted when all data is decoded */
143 void (*drained) (GstElement * element);
146 static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src_%u",
149 GST_STATIC_CAPS_ANY);
151 static GstStaticCaps default_raw_caps = GST_STATIC_CAPS (DEFAULT_RAW_CAPS);
153 GST_DEBUG_CATEGORY_STATIC (gst_uri_decode_bin_debug);
154 #define GST_CAT_DEFAULT gst_uri_decode_bin_debug
160 SIGNAL_AUTOPLUG_CONTINUE,
161 SIGNAL_AUTOPLUG_FACTORIES,
162 SIGNAL_AUTOPLUG_SELECT,
164 SIGNAL_AUTOPLUG_SORT,
170 #define DEFAULT_PROP_URI NULL
171 #define DEFAULT_PROP_SOURCE NULL
172 #define DEFAULT_CONNECTION_SPEED 0
173 #define DEFAULT_CAPS (gst_static_caps_get (&default_raw_caps))
174 #define DEFAULT_SUBTITLE_ENCODING NULL
175 #define DEFAULT_BUFFER_DURATION -1
176 #define DEFAULT_BUFFER_SIZE -1
177 #define DEFAULT_DOWNLOAD FALSE
178 #define DEFAULT_USE_BUFFERING FALSE
179 #define DEFAULT_EXPOSE_ALL_STREAMS TRUE
180 #define DEFAULT_RING_BUFFER_MAX_SIZE 0
187 PROP_CONNECTION_SPEED,
189 PROP_SUBTITLE_ENCODING,
191 PROP_BUFFER_DURATION,
194 PROP_EXPOSE_ALL_STREAMS,
195 PROP_RING_BUFFER_MAX_SIZE,
199 static guint gst_uri_decode_bin_signals[LAST_SIGNAL] = { 0 };
201 GType gst_uri_decode_bin_get_type (void);
202 #define gst_uri_decode_bin_parent_class parent_class
203 G_DEFINE_TYPE (GstURIDecodeBin, gst_uri_decode_bin, GST_TYPE_BIN);
205 static void remove_decoders (GstURIDecodeBin * bin, gboolean force);
206 static void gst_uri_decode_bin_set_property (GObject * object, guint prop_id,
207 const GValue * value, GParamSpec * pspec);
208 static void gst_uri_decode_bin_get_property (GObject * object, guint prop_id,
209 GValue * value, GParamSpec * pspec);
210 static void gst_uri_decode_bin_finalize (GObject * obj);
212 static void handle_message (GstBin * bin, GstMessage * msg);
214 static gboolean gst_uri_decode_bin_query (GstElement * element,
216 static GstStateChangeReturn gst_uri_decode_bin_change_state (GstElement *
217 element, GstStateChange transition);
220 _gst_boolean_accumulator (GSignalInvocationHint * ihint,
221 GValue * return_accu, const GValue * handler_return, gpointer dummy)
225 myboolean = g_value_get_boolean (handler_return);
226 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
227 g_value_set_boolean (return_accu, myboolean);
229 /* stop emission if FALSE */
234 _gst_array_accumulator (GSignalInvocationHint * ihint,
235 GValue * return_accu, const GValue * handler_return, gpointer dummy)
239 array = g_value_get_boxed (handler_return);
240 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
241 g_value_set_boxed (return_accu, array);
247 _gst_select_accumulator (GSignalInvocationHint * ihint,
248 GValue * return_accu, const GValue * handler_return, gpointer dummy)
250 GstAutoplugSelectResult res;
252 res = g_value_get_enum (handler_return);
253 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
254 g_value_set_enum (return_accu, res);
260 _gst_array_hasvalue_accumulator (GSignalInvocationHint * ihint,
261 GValue * return_accu, const GValue * handler_return, gpointer dummy)
265 array = g_value_get_boxed (handler_return);
266 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
267 g_value_set_boxed (return_accu, array);
276 gst_uri_decode_bin_autoplug_continue (GstElement * element, GstPad * pad,
279 /* by default we always continue */
283 /* Must be called with factories lock! */
285 gst_uri_decode_bin_update_factories_list (GstURIDecodeBin * dec)
289 cookie = gst_registry_get_feature_list_cookie (gst_registry_get ());
290 if (!dec->factories || dec->factories_cookie != cookie) {
292 gst_plugin_feature_list_free (dec->factories);
294 gst_element_factory_list_get_elements
295 (GST_ELEMENT_FACTORY_TYPE_DECODABLE, GST_RANK_MARGINAL);
297 g_list_sort (dec->factories, _decode_bin_compare_factories_func);
298 dec->factories_cookie = cookie;
303 gst_uri_decode_bin_autoplug_factories (GstElement * element, GstPad * pad,
308 GstURIDecodeBin *dec = GST_URI_DECODE_BIN_CAST (element);
310 GST_DEBUG_OBJECT (element, "finding factories");
312 /* return all compatible factories for caps */
313 g_mutex_lock (dec->factories_lock);
314 gst_uri_decode_bin_update_factories_list (dec);
316 gst_element_factory_list_filter (dec->factories, caps, GST_PAD_SINK,
318 g_mutex_unlock (dec->factories_lock);
320 result = g_value_array_new (g_list_length (list));
321 for (tmp = list; tmp; tmp = tmp->next) {
322 GstElementFactory *factory = GST_ELEMENT_FACTORY_CAST (tmp->data);
325 g_value_init (&val, G_TYPE_OBJECT);
326 g_value_set_object (&val, factory);
327 g_value_array_append (result, &val);
328 g_value_unset (&val);
330 gst_plugin_feature_list_free (list);
332 GST_DEBUG_OBJECT (element, "autoplug-factories returns %p", result);
338 gst_uri_decode_bin_autoplug_sort (GstElement * element, GstPad * pad,
339 GstCaps * caps, GValueArray * factories)
344 static GstAutoplugSelectResult
345 gst_uri_decode_bin_autoplug_select (GstElement * element, GstPad * pad,
346 GstCaps * caps, GstElementFactory * factory)
348 GST_DEBUG_OBJECT (element, "default autoplug-select returns TRY");
351 return GST_AUTOPLUG_SELECT_TRY;
355 gst_uri_decode_bin_class_init (GstURIDecodeBinClass * klass)
357 GObjectClass *gobject_class;
358 GstElementClass *gstelement_class;
359 GstBinClass *gstbin_class;
361 gobject_class = G_OBJECT_CLASS (klass);
362 gstelement_class = GST_ELEMENT_CLASS (klass);
363 gstbin_class = GST_BIN_CLASS (klass);
365 gobject_class->set_property = gst_uri_decode_bin_set_property;
366 gobject_class->get_property = gst_uri_decode_bin_get_property;
367 gobject_class->finalize = gst_uri_decode_bin_finalize;
369 g_object_class_install_property (gobject_class, PROP_URI,
370 g_param_spec_string ("uri", "URI", "URI to decode",
371 DEFAULT_PROP_URI, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
373 g_object_class_install_property (gobject_class, PROP_SOURCE,
374 g_param_spec_object ("source", "Source", "Source object used",
375 GST_TYPE_ELEMENT, G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
377 g_object_class_install_property (gobject_class, PROP_CONNECTION_SPEED,
378 g_param_spec_uint64 ("connection-speed", "Connection Speed",
379 "Network connection speed in kbps (0 = unknown)",
380 0, G_MAXUINT64 / 1000, DEFAULT_CONNECTION_SPEED,
381 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
383 g_object_class_install_property (gobject_class, PROP_CAPS,
384 g_param_spec_boxed ("caps", "Caps",
385 "The caps on which to stop decoding. (NULL = default)",
386 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
388 g_object_class_install_property (gobject_class, PROP_SUBTITLE_ENCODING,
389 g_param_spec_string ("subtitle-encoding", "subtitle encoding",
390 "Encoding to assume if input subtitles are not in UTF-8 encoding. "
391 "If not set, the GST_SUBTITLE_ENCODING environment variable will "
392 "be checked for an encoding to use. If that is not set either, "
393 "ISO-8859-15 will be assumed.", NULL,
394 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
396 g_object_class_install_property (gobject_class, PROP_BUFFER_SIZE,
397 g_param_spec_int ("buffer-size", "Buffer size (bytes)",
398 "Buffer size when buffering streams (-1 default value)",
399 -1, G_MAXINT, DEFAULT_BUFFER_SIZE,
400 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
401 g_object_class_install_property (gobject_class, PROP_BUFFER_DURATION,
402 g_param_spec_int64 ("buffer-duration", "Buffer duration (ns)",
403 "Buffer duration when buffering streams (-1 default value)",
404 -1, G_MAXINT64, DEFAULT_BUFFER_DURATION,
405 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
408 * GstURIDecodeBin::download:
410 * For certain media type, enable download buffering.
412 g_object_class_install_property (gobject_class, PROP_DOWNLOAD,
413 g_param_spec_boolean ("download", "Download",
414 "Attempt download buffering when buffering network streams",
415 DEFAULT_DOWNLOAD, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
417 * GstURIDecodeBin::use-buffering:
419 * Emit BUFFERING messages based on low-/high-percent thresholds of the
420 * demuxed or parsed data.
421 * When download buffering is activated and used for the current media
422 * type, this property does nothing. Otherwise perform buffering on the
423 * demuxed or parsed media.
427 g_object_class_install_property (gobject_class, PROP_USE_BUFFERING,
428 g_param_spec_boolean ("use-buffering", "Use Buffering",
429 "Perform buffering on demuxed/parsed media",
430 DEFAULT_USE_BUFFERING, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
433 * GstURIDecodeBin::expose-all-streams
435 * Expose streams of unknown type.
437 * If set to %FALSE, then only the streams that can be decoded to the final
438 * caps (see 'caps' property) will have a pad exposed. Streams that do not
439 * match those caps but could have been decoded will not have decoder plugged
440 * in internally and will not have a pad exposed.
444 g_object_class_install_property (gobject_class, PROP_EXPOSE_ALL_STREAMS,
445 g_param_spec_boolean ("expose-all-streams", "Expose All Streams",
446 "Expose all streams, including those of unknown type or that don't match the 'caps' property",
447 DEFAULT_EXPOSE_ALL_STREAMS,
448 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
451 * GstURIDecodeBin::ring-buffer-max-size
453 * The maximum size of the ring buffer in kilobytes. If set to 0, the ring
454 * buffer is disabled. Default is 0.
458 g_object_class_install_property (gobject_class, PROP_RING_BUFFER_MAX_SIZE,
459 g_param_spec_uint64 ("ring-buffer-max-size",
460 "Max. ring buffer size (bytes)",
461 "Max. amount of data in the ring buffer (bytes, 0 = ring buffer disabled)",
462 0, G_MAXUINT, DEFAULT_RING_BUFFER_MAX_SIZE,
463 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
466 * GstURIDecodeBin::unknown-type:
467 * @bin: The uridecodebin.
468 * @pad: the new pad containing caps that cannot be resolved to a 'final'.
470 * @caps: the #GstCaps of the pad that cannot be resolved.
472 * This signal is emitted when a pad for which there is no further possible
473 * decoding is added to the uridecodebin.
475 gst_uri_decode_bin_signals[SIGNAL_UNKNOWN_TYPE] =
476 g_signal_new ("unknown-type", G_TYPE_FROM_CLASS (klass),
477 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstURIDecodeBinClass, unknown_type),
478 NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 2,
479 GST_TYPE_PAD, GST_TYPE_CAPS);
482 * GstURIDecodeBin::autoplug-continue:
483 * @bin: The uridecodebin.
485 * @caps: The #GstCaps found.
487 * This signal is emitted whenever uridecodebin finds a new stream. It is
488 * emitted before looking for any elements that can handle that stream.
491 * Invocation of signal handlers stops after the first signal handler
492 * returns #FALSE. Signal handlers are invoked in the order they were
496 * Returns: #TRUE if you wish uridecodebin to look for elements that can
497 * handle the given @caps. If #FALSE, those caps will be considered as
498 * final and the pad will be exposed as such (see 'pad-added' signal of
501 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE] =
502 g_signal_new ("autoplug-continue", G_TYPE_FROM_CLASS (klass),
503 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstURIDecodeBinClass,
504 autoplug_continue), _gst_boolean_accumulator, NULL,
505 g_cclosure_marshal_generic, G_TYPE_BOOLEAN, 2, GST_TYPE_PAD,
509 * GstURIDecodeBin::autoplug-factories:
510 * @bin: The uridecodebin.
512 * @caps: The #GstCaps found.
514 * This function is emitted when an array of possible factories for @caps on
515 * @pad is needed. Uridecodebin will by default return an array with all
516 * compatible factories, sorted by rank.
518 * If this function returns NULL, @pad will be exposed as a final caps.
520 * If this function returns an empty array, the pad will be considered as
521 * having an unhandled type media type.
524 * Only the signal handler that is connected first will ever by invoked.
525 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
526 * signal, they will never be invoked!
529 * Returns: a #GValueArray* with a list of factories to try. The factories are
530 * by default tried in the returned order or based on the index returned by
533 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES] =
534 g_signal_new ("autoplug-factories", G_TYPE_FROM_CLASS (klass),
535 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstURIDecodeBinClass,
536 autoplug_factories), _gst_array_accumulator, NULL,
537 g_cclosure_marshal_generic, G_TYPE_VALUE_ARRAY, 2,
538 GST_TYPE_PAD, GST_TYPE_CAPS);
541 * GstURIDecodeBin::autoplug-sort:
542 * @bin: The uridecodebin.
544 * @caps: The #GstCaps.
545 * @factories: A #GValueArray of possible #GstElementFactory to use.
547 * Once decodebin has found the possible #GstElementFactory objects to try
548 * for @caps on @pad, this signal is emited. The purpose of the signal is for
549 * the application to perform additional sorting or filtering on the element
552 * The callee should copy and modify @factories or return #NULL if the
553 * order should not change.
556 * Invocation of signal handlers stops after one signal handler has
557 * returned something else than #NULL. Signal handlers are invoked in
558 * the order they were connected in.
559 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
560 * signal, they will never be invoked!
563 * Returns: A new sorted array of #GstElementFactory objects.
567 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_SORT] =
568 g_signal_new ("autoplug-sort", G_TYPE_FROM_CLASS (klass),
569 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstURIDecodeBinClass, autoplug_sort),
570 _gst_array_hasvalue_accumulator, NULL,
571 g_cclosure_marshal_generic, G_TYPE_VALUE_ARRAY, 3, GST_TYPE_PAD,
572 GST_TYPE_CAPS, G_TYPE_VALUE_ARRAY | G_SIGNAL_TYPE_STATIC_SCOPE);
575 * GstURIDecodeBin::autoplug-select:
576 * @bin: The uridecodebin.
578 * @caps: The #GstCaps.
579 * @factory: A #GstElementFactory to use.
581 * This signal is emitted once uridecodebin has found all the possible
582 * #GstElementFactory that can be used to handle the given @caps. For each of
583 * those factories, this signal is emitted.
585 * The signal handler should return a #GST_TYPE_AUTOPLUG_SELECT_RESULT enum
586 * value indicating what decodebin should do next.
588 * A value of #GST_AUTOPLUG_SELECT_TRY will try to autoplug an element from
591 * A value of #GST_AUTOPLUG_SELECT_EXPOSE will expose @pad without plugging
594 * A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the
598 * Only the signal handler that is connected first will ever by invoked.
599 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
600 * signal, they will never be invoked!
603 * Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required
604 * operation. The default handler will always return
605 * #GST_AUTOPLUG_SELECT_TRY.
607 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT] =
608 g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass),
609 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstURIDecodeBinClass,
610 autoplug_select), _gst_select_accumulator, NULL,
611 g_cclosure_marshal_generic,
612 GST_TYPE_AUTOPLUG_SELECT_RESULT, 3, GST_TYPE_PAD, GST_TYPE_CAPS,
613 GST_TYPE_ELEMENT_FACTORY);
616 * GstURIDecodeBin::drained:
618 * This signal is emitted when the data for the current uri is played.
620 gst_uri_decode_bin_signals[SIGNAL_DRAINED] =
621 g_signal_new ("drained", G_TYPE_FROM_CLASS (klass),
623 G_STRUCT_OFFSET (GstURIDecodeBinClass, drained), NULL, NULL,
624 g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE);
627 * GstURIDecodeBin::source-setup:
628 * @bin: the uridecodebin.
629 * @source: source element
631 * This signal is emitted after the source element has been created, so
632 * it can be configured by setting additional properties (e.g. set a
633 * proxy server for an http source, or set the device and read speed for
634 * an audio cd source). This is functionally equivalent to connecting to
635 * the notify::source signal, but more convenient.
639 gst_uri_decode_bin_signals[SIGNAL_SOURCE_SETUP] =
640 g_signal_new ("source-setup", G_TYPE_FROM_CLASS (klass),
641 G_SIGNAL_RUN_LAST, 0, NULL, NULL,
642 g_cclosure_marshal_generic, G_TYPE_NONE, 1, GST_TYPE_ELEMENT);
644 gst_element_class_add_pad_template (gstelement_class,
645 gst_static_pad_template_get (&srctemplate));
646 gst_element_class_set_static_metadata (gstelement_class,
647 "URI Decoder", "Generic/Bin/Decoder",
648 "Autoplug and decode an URI to raw media",
649 "Wim Taymans <wim.taymans@gmail.com>");
651 gstelement_class->query = GST_DEBUG_FUNCPTR (gst_uri_decode_bin_query);
652 gstelement_class->change_state =
653 GST_DEBUG_FUNCPTR (gst_uri_decode_bin_change_state);
655 gstbin_class->handle_message = GST_DEBUG_FUNCPTR (handle_message);
657 klass->autoplug_continue =
658 GST_DEBUG_FUNCPTR (gst_uri_decode_bin_autoplug_continue);
659 klass->autoplug_factories =
660 GST_DEBUG_FUNCPTR (gst_uri_decode_bin_autoplug_factories);
661 klass->autoplug_sort = GST_DEBUG_FUNCPTR (gst_uri_decode_bin_autoplug_sort);
662 klass->autoplug_select =
663 GST_DEBUG_FUNCPTR (gst_uri_decode_bin_autoplug_select);
667 gst_uri_decode_bin_init (GstURIDecodeBin * dec)
669 /* first filter out the interesting element factories */
670 dec->factories_lock = g_mutex_new ();
672 dec->lock = g_mutex_new ();
674 dec->uri = g_strdup (DEFAULT_PROP_URI);
675 dec->connection_speed = DEFAULT_CONNECTION_SPEED;
676 dec->caps = DEFAULT_CAPS;
677 dec->encoding = g_strdup (DEFAULT_SUBTITLE_ENCODING);
679 dec->buffer_duration = DEFAULT_BUFFER_DURATION;
680 dec->buffer_size = DEFAULT_BUFFER_SIZE;
681 dec->download = DEFAULT_DOWNLOAD;
682 dec->use_buffering = DEFAULT_USE_BUFFERING;
683 dec->expose_allstreams = DEFAULT_EXPOSE_ALL_STREAMS;
684 dec->ring_buffer_max_size = DEFAULT_RING_BUFFER_MAX_SIZE;
686 GST_OBJECT_FLAG_SET (dec, GST_ELEMENT_FLAG_SOURCE);
690 gst_uri_decode_bin_finalize (GObject * obj)
692 GstURIDecodeBin *dec = GST_URI_DECODE_BIN (obj);
694 remove_decoders (dec, TRUE);
695 g_mutex_free (dec->lock);
696 g_mutex_free (dec->factories_lock);
698 g_free (dec->encoding);
700 gst_plugin_feature_list_free (dec->factories);
702 gst_caps_unref (dec->caps);
704 G_OBJECT_CLASS (parent_class)->finalize (obj);
708 gst_uri_decode_bin_set_encoding (GstURIDecodeBin * dec, const gchar * encoding)
712 GST_URI_DECODE_BIN_LOCK (dec);
714 /* set property first */
715 GST_OBJECT_LOCK (dec);
716 g_free (dec->encoding);
717 dec->encoding = g_strdup (encoding);
718 GST_OBJECT_UNLOCK (dec);
720 /* set the property on all decodebins now */
721 for (walk = dec->decodebins; walk; walk = g_slist_next (walk)) {
722 GObject *decodebin = G_OBJECT (walk->data);
724 g_object_set (decodebin, "subtitle-encoding", encoding, NULL);
726 GST_URI_DECODE_BIN_UNLOCK (dec);
730 gst_uri_decode_bin_set_property (GObject * object, guint prop_id,
731 const GValue * value, GParamSpec * pspec)
733 GstURIDecodeBin *dec = GST_URI_DECODE_BIN (object);
737 GST_OBJECT_LOCK (dec);
739 dec->uri = g_value_dup_string (value);
740 GST_OBJECT_UNLOCK (dec);
742 case PROP_CONNECTION_SPEED:
743 GST_OBJECT_LOCK (dec);
744 dec->connection_speed = g_value_get_uint64 (value) * 1000;
745 GST_OBJECT_UNLOCK (dec);
748 GST_OBJECT_LOCK (dec);
750 gst_caps_unref (dec->caps);
751 dec->caps = g_value_dup_boxed (value);
752 GST_OBJECT_UNLOCK (dec);
754 case PROP_SUBTITLE_ENCODING:
755 gst_uri_decode_bin_set_encoding (dec, g_value_get_string (value));
757 case PROP_BUFFER_SIZE:
758 dec->buffer_size = g_value_get_int (value);
760 case PROP_BUFFER_DURATION:
761 dec->buffer_duration = g_value_get_int64 (value);
764 dec->download = g_value_get_boolean (value);
766 case PROP_USE_BUFFERING:
767 dec->use_buffering = g_value_get_boolean (value);
769 case PROP_EXPOSE_ALL_STREAMS:
770 dec->expose_allstreams = g_value_get_boolean (value);
772 case PROP_RING_BUFFER_MAX_SIZE:
773 dec->ring_buffer_max_size = g_value_get_uint64 (value);
776 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
782 gst_uri_decode_bin_get_property (GObject * object, guint prop_id,
783 GValue * value, GParamSpec * pspec)
785 GstURIDecodeBin *dec = GST_URI_DECODE_BIN (object);
789 GST_OBJECT_LOCK (dec);
790 g_value_set_string (value, dec->uri);
791 GST_OBJECT_UNLOCK (dec);
794 GST_OBJECT_LOCK (dec);
795 g_value_set_object (value, dec->source);
796 GST_OBJECT_UNLOCK (dec);
798 case PROP_CONNECTION_SPEED:
799 GST_OBJECT_LOCK (dec);
800 g_value_set_uint64 (value, dec->connection_speed / 1000);
801 GST_OBJECT_UNLOCK (dec);
804 GST_OBJECT_LOCK (dec);
805 g_value_set_boxed (value, dec->caps);
806 GST_OBJECT_UNLOCK (dec);
808 case PROP_SUBTITLE_ENCODING:
809 GST_OBJECT_LOCK (dec);
810 g_value_set_string (value, dec->encoding);
811 GST_OBJECT_UNLOCK (dec);
813 case PROP_BUFFER_SIZE:
814 GST_OBJECT_LOCK (dec);
815 g_value_set_int (value, dec->buffer_size);
816 GST_OBJECT_UNLOCK (dec);
818 case PROP_BUFFER_DURATION:
819 GST_OBJECT_LOCK (dec);
820 g_value_set_int64 (value, dec->buffer_duration);
821 GST_OBJECT_UNLOCK (dec);
824 g_value_set_boolean (value, dec->download);
826 case PROP_USE_BUFFERING:
827 g_value_set_boolean (value, dec->use_buffering);
829 case PROP_EXPOSE_ALL_STREAMS:
830 g_value_set_boolean (value, dec->expose_allstreams);
832 case PROP_RING_BUFFER_MAX_SIZE:
833 g_value_set_uint64 (value, dec->ring_buffer_max_size);
836 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
842 do_async_start (GstURIDecodeBin * dbin)
846 dbin->async_pending = TRUE;
848 message = gst_message_new_async_start (GST_OBJECT_CAST (dbin));
849 GST_BIN_CLASS (parent_class)->handle_message (GST_BIN_CAST (dbin), message);
853 do_async_done (GstURIDecodeBin * dbin)
857 if (dbin->async_pending) {
858 GST_DEBUG_OBJECT (dbin, "posting ASYNC_DONE");
860 gst_message_new_async_done (GST_OBJECT_CAST (dbin),
861 GST_CLOCK_TIME_NONE);
862 GST_BIN_CLASS (parent_class)->handle_message (GST_BIN_CAST (dbin), message);
864 dbin->async_pending = FALSE;
868 #define DEFAULT_QUEUE_SIZE (3 * GST_SECOND)
869 #define DEFAULT_QUEUE_MIN_THRESHOLD ((DEFAULT_QUEUE_SIZE * 30) / 100)
870 #define DEFAULT_QUEUE_THRESHOLD ((DEFAULT_QUEUE_SIZE * 95) / 100)
873 unknown_type_cb (GstElement * element, GstPad * pad, GstCaps * caps,
874 GstURIDecodeBin * decoder)
878 capsstr = gst_caps_to_string (caps);
879 GST_ELEMENT_WARNING (decoder, STREAM, CODEC_NOT_FOUND,
880 (_("No decoder available for type \'%s\'."), capsstr), (NULL));
884 /* add a streaminfo that indicates that the stream is handled by the
885 * given element. This usually means that a stream without actual data is
886 * produced but one that is sunken by an element. Examples of this are:
887 * cdaudio, a hardware decoder/sink, dvd meta bins etc...
890 add_element_stream (GstElement * element, GstURIDecodeBin * decoder)
892 g_warning ("add element stream");
895 /* when the decoder element signals that no more pads will be generated, we
896 * can commit the current group.
899 no_more_pads_full (GstElement * element, gboolean subs,
900 GstURIDecodeBin * decoder)
905 GST_DEBUG_OBJECT (element, "no more pads, %d pending", decoder->pending);
907 GST_URI_DECODE_BIN_LOCK (decoder);
908 final = (decoder->pending == 0);
910 /* nothing pending, we can exit */
914 /* the object has no pending no_more_pads */
915 if (!g_object_get_data (G_OBJECT (element), "pending"))
917 g_object_set_data (G_OBJECT (element), "pending", NULL);
920 final = (decoder->pending == 0);
923 GST_URI_DECODE_BIN_UNLOCK (decoder);
926 gst_element_no_more_pads (GST_ELEMENT_CAST (decoder));
932 no_more_pads (GstElement * element, GstURIDecodeBin * decoder)
934 no_more_pads_full (element, FALSE, decoder);
938 source_no_more_pads (GstElement * element, GstURIDecodeBin * bin)
940 GST_DEBUG_OBJECT (bin, "No more pads in source element %s.",
941 GST_ELEMENT_NAME (element));
943 g_signal_handler_disconnect (element, bin->src_np_sig_id);
944 bin->src_np_sig_id = 0;
945 g_signal_handler_disconnect (element, bin->src_nmp_sig_id);
946 bin->src_nmp_sig_id = 0;
948 no_more_pads_full (element, FALSE, bin);
952 configure_stream_buffering (GstURIDecodeBin * decoder)
954 GstElement *queue = NULL;
959 /* automatic configuration enabled ? */
960 if (decoder->buffer_size != -1)
963 GST_URI_DECODE_BIN_LOCK (decoder);
965 queue = gst_object_ref (decoder->queue);
967 g_hash_table_iter_init (&iter, decoder->streams);
968 while (g_hash_table_iter_next (&iter, &key, &value)) {
969 GstURIDecodeBinStream *stream = value;
971 if (stream->bitrate && bitrate >= 0)
972 bitrate += stream->bitrate;
976 GST_URI_DECODE_BIN_UNLOCK (decoder);
978 GST_DEBUG_OBJECT (decoder, "overall bitrate %d", bitrate);
986 /* all streams have a bitrate;
987 * configure queue size based on queue duration using combined bitrate */
988 g_object_get (queue, "max-size-time", &time, NULL);
989 GST_DEBUG_OBJECT (decoder, "queue buffering time %" GST_TIME_FORMAT,
990 GST_TIME_ARGS (time));
992 bytes = gst_util_uint64_scale (time, bitrate, 8 * GST_SECOND);
993 GST_DEBUG_OBJECT (decoder, "corresponds to buffer size %d", bytes);
994 g_object_set (queue, "max-size-bytes", bytes, NULL);
998 gst_object_unref (queue);
1001 static GstPadProbeReturn
1002 decoded_pad_event_probe (GstPad * pad, GstPadProbeInfo * info,
1005 GstEvent *event = GST_PAD_PROBE_INFO_EVENT (info);
1006 GstURIDecodeBin *decoder = user_data;
1008 GST_LOG_OBJECT (pad, "%s, decoder %p", GST_EVENT_TYPE_NAME (event), decoder);
1010 /* look for a bitrate tag */
1011 switch (GST_EVENT_TYPE (event)) {
1016 GstURIDecodeBinStream *stream;
1018 gst_event_parse_tag (event, &list);
1019 if (!gst_tag_list_get_uint_index (list, GST_TAG_NOMINAL_BITRATE, 0,
1021 gst_tag_list_get_uint_index (list, GST_TAG_BITRATE, 0, &bitrate);
1023 GST_DEBUG_OBJECT (pad, "found bitrate %u", bitrate);
1025 GST_URI_DECODE_BIN_LOCK (decoder);
1026 stream = g_hash_table_lookup (decoder->streams, pad);
1027 GST_URI_DECODE_BIN_UNLOCK (decoder);
1029 stream->bitrate = bitrate;
1030 /* no longer need this probe now */
1031 gst_pad_remove_probe (pad, stream->probe_id);
1032 /* configure buffer if possible */
1033 configure_stream_buffering (decoder);
1043 return GST_PAD_PROBE_OK;
1046 /* Called by the signal handlers when a decodebin has found a new raw pad */
1048 new_decoded_pad_added_cb (GstElement * element, GstPad * pad,
1049 GstURIDecodeBin * decoder)
1052 GstPadTemplate *pad_tmpl;
1054 GstURIDecodeBinStream *stream;
1056 GST_DEBUG_OBJECT (element, "new decoded pad, name: <%s>", GST_PAD_NAME (pad));
1058 GST_URI_DECODE_BIN_LOCK (decoder);
1059 padname = g_strdup_printf ("src_%u", decoder->numpads);
1061 GST_URI_DECODE_BIN_UNLOCK (decoder);
1063 pad_tmpl = gst_static_pad_template_get (&srctemplate);
1064 newpad = gst_ghost_pad_new_from_template (padname, pad, pad_tmpl);
1065 gst_object_unref (pad_tmpl);
1068 /* store ref to the ghostpad so we can remove it */
1069 g_object_set_data (G_OBJECT (pad), "uridecodebin.ghostpad", newpad);
1071 /* add event probe to monitor tags */
1072 stream = g_slice_alloc0 (sizeof (GstURIDecodeBinStream));
1074 gst_pad_add_probe (pad, GST_PAD_PROBE_TYPE_EVENT_DOWNSTREAM,
1075 decoded_pad_event_probe, decoder, NULL);
1076 GST_URI_DECODE_BIN_LOCK (decoder);
1077 g_hash_table_insert (decoder->streams, pad, stream);
1078 GST_URI_DECODE_BIN_UNLOCK (decoder);
1080 gst_pad_set_active (newpad, TRUE);
1081 gst_element_add_pad (GST_ELEMENT_CAST (decoder), newpad);
1084 static GstPadProbeReturn
1085 source_pad_event_probe (GstPad * pad, GstPadProbeInfo * info,
1088 GstEvent *event = GST_PAD_PROBE_INFO_EVENT (info);
1089 GstURIDecodeBin *decoder = user_data;
1091 GST_LOG_OBJECT (pad, "%s, decoder %p", GST_EVENT_TYPE_NAME (event), decoder);
1093 if (GST_EVENT_TYPE (event) == GST_EVENT_EOS) {
1094 GST_DEBUG_OBJECT (pad, "we received EOS");
1096 g_signal_emit (decoder,
1097 gst_uri_decode_bin_signals[SIGNAL_DRAINED], 0, NULL);
1099 /* never drop events */
1100 return GST_PAD_PROBE_OK;
1103 /* called when we found a raw pad on the source element. We need to set up a
1104 * padprobe to detect EOS before exposing the pad. */
1106 expose_decoded_pad (GstElement * element, GstPad * pad,
1107 GstURIDecodeBin * decoder)
1109 gst_pad_add_probe (pad, GST_PAD_PROBE_TYPE_EVENT_DOWNSTREAM,
1110 source_pad_event_probe, decoder, NULL);
1112 new_decoded_pad_added_cb (element, pad, decoder);
1116 pad_removed_cb (GstElement * element, GstPad * pad, GstURIDecodeBin * decoder)
1120 GST_DEBUG_OBJECT (element, "pad removed name: <%s:%s>",
1121 GST_DEBUG_PAD_NAME (pad));
1123 /* we only care about srcpads */
1124 if (!GST_PAD_IS_SRC (pad))
1127 if (!(ghost = g_object_get_data (G_OBJECT (pad), "uridecodebin.ghostpad")))
1130 /* unghost the pad */
1131 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (ghost), NULL);
1133 /* deactivate and remove */
1134 gst_pad_set_active (pad, FALSE);
1135 gst_element_remove_pad (GST_ELEMENT_CAST (decoder), ghost);
1142 GST_WARNING_OBJECT (element, "no ghost pad found");
1147 /* helper function to lookup stuff in lists */
1149 array_has_value (const gchar * values[], const gchar * value)
1153 for (i = 0; values[i]; i++) {
1154 if (g_str_has_prefix (value, values[i]))
1161 array_has_uri_value (const gchar * values[], const gchar * value)
1165 for (i = 0; values[i]; i++) {
1166 if (!g_ascii_strncasecmp (value, values[i], strlen (values[i])))
1172 /* list of URIs that we consider to be streams and that need buffering.
1173 * We have no mechanism yet to figure this out with a query. */
1174 static const gchar *stream_uris[] = { "http://", "https://", "mms://",
1175 "mmsh://", "mmsu://", "mmst://", "fd://", "myth://", "ssh://",
1176 "ftp://", "sftp://",
1180 /* list of URIs that need a queue because they are pretty bursty */
1181 static const gchar *queue_uris[] = { "cdda://", NULL };
1183 /* blacklisted URIs, we know they will always fail. */
1184 static const gchar *blacklisted_uris[] = { NULL };
1186 /* mime types that we don't consider to be media types */
1188 static const gchar *no_media_mimes[] = {
1189 "application/x-executable", "application/x-bzip", "application/x-gzip",
1190 "application/zip", "application/x-compress", NULL
1194 /* media types we can download */
1195 static const gchar *download_media[] = {
1196 "video/quicktime", "video/mj2", "audio/x-m4a", "application/x-3gp",
1197 "video/x-flv", "video/x-msvideo", "video/webm", NULL
1200 #define IS_STREAM_URI(uri) (array_has_uri_value (stream_uris, uri))
1201 #define IS_QUEUE_URI(uri) (array_has_uri_value (queue_uris, uri))
1202 #define IS_BLACKLISTED_URI(uri) (array_has_uri_value (blacklisted_uris, uri))
1203 #define IS_NO_MEDIA_MIME(mime) (array_has_value (no_media_mimes, mime))
1204 #define IS_DOWNLOAD_MEDIA(media) (array_has_value (download_media, media))
1207 * Generate and configure a source element.
1210 gen_source_element (GstURIDecodeBin * decoder)
1212 GObjectClass *source_class;
1219 GST_LOG_OBJECT (decoder, "finding source for %s", decoder->uri);
1221 if (!gst_uri_is_valid (decoder->uri))
1224 if (IS_BLACKLISTED_URI (decoder->uri))
1225 goto uri_blacklisted;
1228 gst_element_make_from_uri (GST_URI_SRC, decoder->uri, "source", NULL);
1232 GST_LOG_OBJECT (decoder, "found source type %s", G_OBJECT_TYPE_NAME (source));
1234 decoder->is_stream = IS_STREAM_URI (decoder->uri);
1235 GST_LOG_OBJECT (decoder, "source is stream: %d", decoder->is_stream);
1237 decoder->need_queue = IS_QUEUE_URI (decoder->uri);
1238 GST_LOG_OBJECT (decoder, "source needs queue: %d", decoder->need_queue);
1240 source_class = G_OBJECT_GET_CLASS (source);
1242 /* make HTTP sources send extra headers so we get icecast
1243 * metadata in case the stream is an icecast stream */
1244 if (!strncmp (decoder->uri, "http://", 7)) {
1245 pspec = g_object_class_find_property (source_class, "iradio-mode");
1247 if (pspec && G_PARAM_SPEC_VALUE_TYPE (pspec) == G_TYPE_STRING) {
1248 GST_LOG_OBJECT (decoder, "configuring iradio-mode");
1249 g_object_set (source, "iradio-mode", TRUE, NULL);
1253 pspec = g_object_class_find_property (source_class, "connection-speed");
1254 if (pspec != NULL) {
1255 guint64 speed = decoder->connection_speed / 1000;
1256 gboolean wrong_type = FALSE;
1258 if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_UINT) {
1259 GParamSpecUInt *pspecuint = G_PARAM_SPEC_UINT (pspec);
1261 speed = CLAMP (speed, pspecuint->minimum, pspecuint->maximum);
1262 } else if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_INT) {
1263 GParamSpecInt *pspecint = G_PARAM_SPEC_INT (pspec);
1265 speed = CLAMP (speed, pspecint->minimum, pspecint->maximum);
1266 } else if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_UINT64) {
1267 GParamSpecUInt64 *pspecuint = G_PARAM_SPEC_UINT64 (pspec);
1269 speed = CLAMP (speed, pspecuint->minimum, pspecuint->maximum);
1270 } else if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_INT64) {
1271 GParamSpecInt64 *pspecint = G_PARAM_SPEC_INT64 (pspec);
1273 speed = CLAMP (speed, pspecint->minimum, pspecint->maximum);
1275 GST_WARNING_OBJECT (decoder,
1276 "The connection speed property %" G_GUINT64_FORMAT
1277 " of type %s is not usefull not setting it", speed,
1278 g_type_name (G_PARAM_SPEC_TYPE (pspec)));
1282 if (wrong_type == FALSE) {
1283 g_object_set (source, "connection-speed", speed, NULL);
1285 GST_DEBUG_OBJECT (decoder,
1286 "setting connection-speed=%" G_GUINT64_FORMAT " to source element",
1291 pspec = g_object_class_find_property (source_class, "subtitle-encoding");
1292 if (pspec != NULL && G_PARAM_SPEC_VALUE_TYPE (pspec) == G_TYPE_STRING) {
1293 GST_DEBUG_OBJECT (decoder,
1294 "setting subtitle-encoding=%s to source element", decoder->encoding);
1295 g_object_set (source, "subtitle-encoding", decoder->encoding, NULL);
1302 GST_ELEMENT_ERROR (decoder, RESOURCE, NOT_FOUND,
1303 (_("No URI specified to play from.")), (NULL));
1308 GST_ELEMENT_ERROR (decoder, RESOURCE, NOT_FOUND,
1309 (_("Invalid URI \"%s\"."), decoder->uri), (NULL));
1314 GST_ELEMENT_ERROR (decoder, RESOURCE, FAILED,
1315 (_("This stream type cannot be played yet.")), (NULL));
1320 gchar *prot = gst_uri_get_protocol (decoder->uri);
1322 /* whoops, could not create the source element, dig a little deeper to
1323 * figure out what might be wrong. */
1328 gst_missing_uri_source_message_new (GST_ELEMENT_CAST (decoder), prot);
1329 gst_element_post_message (GST_ELEMENT_CAST (decoder), msg);
1331 GST_ELEMENT_ERROR (decoder, CORE, MISSING_PLUGIN,
1332 (_("No URI handler implemented for \"%s\"."), prot), (NULL));
1344 * @all_raw: pointer to hold the result
1346 * check if the caps of the pad are all raw. The caps are all raw if
1347 * all of its structures contain audio/x-raw or video/x-raw.
1349 * Returns: %FALSE @pad has no caps. Else TRUE and @all_raw set t the result.
1352 has_all_raw_caps (GstPad * pad, GstCaps * rawcaps, gboolean * all_raw)
1354 GstCaps *caps, *intersection;
1356 gboolean res = FALSE;
1358 caps = gst_pad_query_caps (pad, NULL);
1362 GST_DEBUG_OBJECT (pad, "have caps %" GST_PTR_FORMAT, caps);
1364 capssize = gst_caps_get_size (caps);
1365 /* no caps, skip and move to the next pad */
1366 if (capssize == 0 || gst_caps_is_empty (caps) || gst_caps_is_any (caps))
1369 intersection = gst_caps_intersect (caps, rawcaps);
1370 *all_raw = !gst_caps_is_empty (intersection)
1371 && (gst_caps_get_size (intersection) == capssize);
1372 gst_caps_unref (intersection);
1377 gst_caps_unref (caps);
1382 post_missing_plugin_error (GstElement * dec, const gchar * element_name)
1386 msg = gst_missing_element_message_new (dec, element_name);
1387 gst_element_post_message (dec, msg);
1389 GST_ELEMENT_ERROR (dec, CORE, MISSING_PLUGIN,
1390 (_("Missing element '%s' - check your GStreamer installation."),
1391 element_name), (NULL));
1396 * @decoder: a #GstURIDecodeBin
1397 * @is_raw: are all pads raw data
1398 * @have_out: does the source have output
1399 * @is_dynamic: is this a dynamic source
1400 * @use_queue: put a queue before raw output pads
1402 * Check the source of @decoder and collect information about it.
1404 * @is_raw will be set to TRUE if the source only produces raw pads. When this
1405 * function returns, all of the raw pad of the source will be added
1408 * @have_out: will be set to TRUE if the source has output pads.
1410 * @is_dynamic: TRUE if the element will create (more) pads dynamically later
1413 * Returns: FALSE if a fatal error occured while scanning.
1416 analyse_source (GstURIDecodeBin * decoder, gboolean * is_raw,
1417 gboolean * have_out, gboolean * is_dynamic, gboolean use_queue)
1419 GstIterator *pads_iter;
1420 gboolean done = FALSE;
1421 gboolean res = TRUE;
1424 GValue item = { 0, };
1428 *is_dynamic = FALSE;
1430 g_object_get (decoder, "caps", &rawcaps, NULL);
1432 rawcaps = DEFAULT_CAPS;
1434 pads_iter = gst_element_iterate_src_pads (decoder->source);
1436 switch (gst_iterator_next (pads_iter, &item)) {
1437 case GST_ITERATOR_ERROR:
1440 case GST_ITERATOR_DONE:
1443 case GST_ITERATOR_RESYNC:
1444 /* reset results and resync */
1447 *is_dynamic = FALSE;
1448 gst_iterator_resync (pads_iter);
1450 case GST_ITERATOR_OK:
1451 pad = g_value_get_object (&item);
1452 /* we now officially have an ouput pad */
1455 /* if FALSE, this pad has no caps and we continue with the next pad. */
1456 if (!has_all_raw_caps (pad, rawcaps, is_raw)) {
1457 g_value_reset (&item);
1461 /* caps on source pad are all raw, we can add the pad */
1463 GstElement *outelem;
1468 /* insert a queue element right before the raw pad */
1469 outelem = gst_element_factory_make ("queue2", NULL);
1473 gst_bin_add (GST_BIN_CAST (decoder), outelem);
1475 sinkpad = gst_element_get_static_pad (outelem, "sink");
1476 gst_pad_link (pad, sinkpad);
1477 gst_object_unref (sinkpad);
1479 /* save queue pointer so we can remove it later */
1480 decoder->queue = outelem;
1482 /* get the new raw srcpad */
1483 pad = gst_element_get_static_pad (outelem, "src");
1485 outelem = decoder->source;
1487 expose_decoded_pad (outelem, pad, decoder);
1489 g_value_reset (&item);
1493 g_value_unset (&item);
1494 gst_iterator_free (pads_iter);
1495 gst_caps_unref (rawcaps);
1498 GstElementClass *elemclass;
1501 /* element has no output pads, check for padtemplates that list SOMETIMES
1503 elemclass = GST_ELEMENT_GET_CLASS (decoder->source);
1505 walk = gst_element_class_get_pad_template_list (elemclass);
1506 while (walk != NULL) {
1507 GstPadTemplate *templ;
1509 templ = (GstPadTemplate *) walk->data;
1510 if (GST_PAD_TEMPLATE_DIRECTION (templ) == GST_PAD_SRC) {
1511 if (GST_PAD_TEMPLATE_PRESENCE (templ) == GST_PAD_SOMETIMES)
1515 walk = g_list_next (walk);
1522 post_missing_plugin_error (GST_ELEMENT_CAST (decoder), "queue2");
1524 g_value_unset (&item);
1525 gst_iterator_free (pads_iter);
1526 gst_caps_unref (rawcaps);
1532 /* Remove all decodebin from ourself
1533 * If force is FALSE, then the decodebin instances will be stored in
1534 * pending_decodebins for re-use later on.
1535 * If force is TRUE, then all decodebin instances will be unreferenced
1536 * and cleared, including the pending ones. */
1538 remove_decoders (GstURIDecodeBin * bin, gboolean force)
1542 for (walk = bin->decodebins; walk; walk = g_slist_next (walk)) {
1543 GstElement *decoder = GST_ELEMENT_CAST (walk->data);
1545 GST_DEBUG_OBJECT (bin, "removing old decoder element");
1547 gst_element_set_state (decoder, GST_STATE_NULL);
1548 gst_bin_remove (GST_BIN_CAST (bin), decoder);
1552 gst_element_set_state (decoder, GST_STATE_READY);
1553 /* add it to our list of pending decodebins */
1554 g_object_ref (decoder);
1555 gst_bin_remove (GST_BIN_CAST (bin), decoder);
1556 /* restore some properties we might have changed */
1557 g_object_set (decoder, "sink-caps", NULL, NULL);
1558 caps = DEFAULT_CAPS;
1559 g_object_set (decoder, "caps", caps, NULL);
1560 gst_caps_unref (caps);
1561 /* make it freshly floating again */
1562 g_object_force_floating (G_OBJECT (decoder));
1564 bin->pending_decodebins =
1565 g_slist_prepend (bin->pending_decodebins, decoder);
1568 g_slist_free (bin->decodebins);
1569 bin->decodebins = NULL;
1573 for (tmp = bin->pending_decodebins; tmp; tmp = tmp->next) {
1574 gst_element_set_state ((GstElement *) tmp->data, GST_STATE_NULL);
1575 gst_object_unref ((GstElement *) tmp->data);
1577 g_slist_free (bin->pending_decodebins);
1578 bin->pending_decodebins = NULL;
1582 /* Don't loose the SOURCE flag */
1583 GST_OBJECT_FLAG_SET (bin, GST_ELEMENT_FLAG_SOURCE);
1587 proxy_unknown_type_signal (GstElement * element, GstPad * pad, GstCaps * caps,
1588 GstURIDecodeBin * dec)
1590 GST_DEBUG_OBJECT (dec, "unknown-type signaled");
1593 gst_uri_decode_bin_signals[SIGNAL_UNKNOWN_TYPE], 0, pad, caps);
1597 proxy_autoplug_continue_signal (GstElement * element, GstPad * pad,
1598 GstCaps * caps, GstURIDecodeBin * dec)
1603 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, pad, caps,
1606 GST_DEBUG_OBJECT (dec, "autoplug-continue returned %d", result);
1611 static GValueArray *
1612 proxy_autoplug_factories_signal (GstElement * element, GstPad * pad,
1613 GstCaps * caps, GstURIDecodeBin * dec)
1615 GValueArray *result;
1618 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES], 0, pad, caps,
1621 GST_DEBUG_OBJECT (dec, "autoplug-factories returned %p", result);
1626 static GValueArray *
1627 proxy_autoplug_sort_signal (GstElement * element, GstPad * pad,
1628 GstCaps * caps, GValueArray * factories, GstURIDecodeBin * dec)
1630 GValueArray *result;
1633 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_SORT], 0, pad, caps,
1634 factories, &result);
1636 GST_DEBUG_OBJECT (dec, "autoplug-sort returned %p", result);
1641 static GstAutoplugSelectResult
1642 proxy_autoplug_select_signal (GstElement * element, GstPad * pad,
1643 GstCaps * caps, GstElementFactory * factory, GstURIDecodeBin * dec)
1645 GstAutoplugSelectResult result;
1648 gst_uri_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT], 0, pad, caps, factory,
1651 GST_DEBUG_OBJECT (dec, "autoplug-select returned %d", result);
1657 proxy_drained_signal (GstElement * element, GstURIDecodeBin * dec)
1659 GST_DEBUG_OBJECT (dec, "drained signaled");
1661 g_signal_emit (dec, gst_uri_decode_bin_signals[SIGNAL_DRAINED], 0, NULL);
1664 /* make a decodebin and connect to all the signals */
1666 make_decoder (GstURIDecodeBin * decoder)
1668 GstElement *decodebin;
1670 /* re-use pending decodebin */
1671 if (decoder->pending_decodebins) {
1672 GSList *first = decoder->pending_decodebins;
1673 GST_LOG_OBJECT (decoder, "re-using pending decodebin");
1674 decodebin = (GstElement *) first->data;
1675 decoder->pending_decodebins =
1676 g_slist_delete_link (decoder->pending_decodebins, first);
1678 GST_LOG_OBJECT (decoder, "making new decodebin");
1680 /* now create the decoder element */
1681 decodebin = gst_element_factory_make ("decodebin", NULL);
1687 if (decodebin->numsinkpads == 0)
1690 /* connect signals to proxy */
1691 g_signal_connect (decodebin, "unknown-type",
1692 G_CALLBACK (proxy_unknown_type_signal), decoder);
1693 g_signal_connect (decodebin, "autoplug-continue",
1694 G_CALLBACK (proxy_autoplug_continue_signal), decoder);
1695 g_signal_connect (decodebin, "autoplug-factories",
1696 G_CALLBACK (proxy_autoplug_factories_signal), decoder);
1697 g_signal_connect (decodebin, "autoplug-sort",
1698 G_CALLBACK (proxy_autoplug_sort_signal), decoder);
1699 g_signal_connect (decodebin, "autoplug-select",
1700 G_CALLBACK (proxy_autoplug_select_signal), decoder);
1701 g_signal_connect (decodebin, "drained",
1702 G_CALLBACK (proxy_drained_signal), decoder);
1704 /* set up callbacks to create the links between decoded data
1705 * and video/audio/subtitle rendering/output. */
1706 g_signal_connect (decodebin,
1707 "pad-added", G_CALLBACK (new_decoded_pad_added_cb), decoder);
1708 g_signal_connect (decodebin,
1709 "pad-removed", G_CALLBACK (pad_removed_cb), decoder);
1710 g_signal_connect (decodebin, "no-more-pads",
1711 G_CALLBACK (no_more_pads), decoder);
1712 g_signal_connect (decodebin,
1713 "unknown-type", G_CALLBACK (unknown_type_cb), decoder);
1716 /* configure caps if we have any */
1718 g_object_set (decodebin, "caps", decoder->caps, NULL);
1720 /* Propagate expose-all-streams and connection-speed properties */
1721 g_object_set (decodebin, "expose-all-streams", decoder->expose_allstreams,
1722 "connection-speed", decoder->connection_speed / 1000, NULL);
1724 if (!decoder->is_stream) {
1725 /* propagate the use-buffering property but only when we are not already
1726 * doing stream buffering with queue2. FIXME, we might want to do stream
1727 * buffering with the multiqueue buffering instead of queue2. */
1728 g_object_set (decodebin, "use-buffering", decoder->use_buffering, NULL);
1730 if (decoder->use_buffering) {
1734 /* configure sizes when buffering */
1735 if ((max_bytes = decoder->buffer_size) == -1)
1736 max_bytes = 2 * 1024 * 1024;
1737 if ((max_time = decoder->buffer_duration) == -1)
1738 max_time = 2 * GST_SECOND;
1740 g_object_set (decodebin, "max-size-bytes", max_bytes, "max-size-buffers",
1741 (guint) 0, "max-size-time", max_time, NULL);
1745 g_object_set_data (G_OBJECT (decodebin), "pending", GINT_TO_POINTER (1));
1746 g_object_set (decodebin, "subtitle-encoding", decoder->encoding, NULL);
1748 GST_LOG_OBJECT (decoder, "have %d pending dynamic objects", decoder->pending);
1750 gst_bin_add (GST_BIN_CAST (decoder), decodebin);
1752 decoder->decodebins = g_slist_prepend (decoder->decodebins, decodebin);
1759 post_missing_plugin_error (GST_ELEMENT_CAST (decoder), "decodebin");
1760 GST_ELEMENT_ERROR (decoder, CORE, MISSING_PLUGIN, (NULL),
1761 ("No decodebin element, check your installation"));
1766 gst_object_unref (decodebin);
1767 GST_ELEMENT_ERROR (decoder, CORE, MISSING_PLUGIN, (NULL),
1768 ("No typefind element, decodebin is unusable, check your installation"));
1773 /* signaled when we have a stream and we need to configure the download
1774 * buffering or regular buffering */
1776 type_found (GstElement * typefind, guint probability,
1777 GstCaps * caps, GstURIDecodeBin * decoder)
1779 GstElement *dec_elem, *queue;
1781 const gchar *media_type;
1783 GST_DEBUG_OBJECT (decoder, "typefind found caps %" GST_PTR_FORMAT, caps);
1785 s = gst_caps_get_structure (caps, 0);
1786 media_type = gst_structure_get_name (s);
1788 /* remember if we need download buffering */
1789 decoder->is_download = IS_DOWNLOAD_MEDIA (media_type) && decoder->download;
1790 /* only enable download buffering if the upstream duration is known */
1791 if (decoder->is_download) {
1794 decoder->is_download =
1795 (gst_element_query_duration (typefind, GST_FORMAT_BYTES, &dur)
1799 dec_elem = make_decoder (decoder);
1803 queue = gst_element_factory_make ("queue2", NULL);
1807 g_object_set (queue, "use-buffering", TRUE, NULL);
1808 g_object_set (queue, "ring-buffer-max-size", decoder->ring_buffer_max_size,
1811 GST_DEBUG_OBJECT (decoder, "check media-type %s, %d", media_type,
1814 if (decoder->is_download) {
1815 gchar *temp_template, *filename;
1816 const gchar *tmp_dir, *prgname;
1818 tmp_dir = g_get_user_cache_dir ();
1819 prgname = g_get_prgname ();
1820 if (prgname == NULL)
1821 prgname = "GStreamer";
1823 filename = g_strdup_printf ("%s-XXXXXX", prgname);
1825 /* build our filename */
1826 temp_template = g_build_filename (tmp_dir, filename, NULL);
1828 GST_DEBUG_OBJECT (decoder, "enable download buffering in %s (%s, %s, %s)",
1829 temp_template, tmp_dir, prgname, filename);
1831 /* configure progressive download for selected media types */
1832 g_object_set (queue, "temp-template", temp_template, NULL);
1835 g_free (temp_template);
1838 /* Disable max-size-buffers */
1839 g_object_set (queue, "max-size-buffers", 0, NULL);
1841 /* If buffer size or duration are set, set them on the queue2 element */
1842 if (decoder->buffer_size != -1)
1843 g_object_set (queue, "max-size-bytes", decoder->buffer_size, NULL);
1844 if (decoder->buffer_duration != -1)
1845 g_object_set (queue, "max-size-time", decoder->buffer_duration, NULL);
1847 gst_bin_add (GST_BIN_CAST (decoder), queue);
1849 if (!gst_element_link_pads (typefind, "src", queue, "sink"))
1850 goto could_not_link;
1852 /* to force caps on the decodebin element and avoid reparsing stuff by
1853 * typefind. It also avoids a deadlock in the way typefind activates pads in
1854 * the state change */
1855 g_object_set (dec_elem, "sink-caps", caps, NULL);
1857 if (!gst_element_link_pads (queue, "src", dec_elem, "sink"))
1858 goto could_not_link;
1860 /* PLAYING in one go might fail (see bug #632782) */
1861 gst_element_set_state (dec_elem, GST_STATE_PAUSED);
1862 gst_element_set_state (dec_elem, GST_STATE_PLAYING);
1863 gst_element_set_state (queue, GST_STATE_PLAYING);
1865 do_async_done (decoder);
1872 /* error was posted */
1877 GST_ELEMENT_ERROR (decoder, CORE, NEGOTIATION,
1878 (NULL), ("Can't link typefind to decodebin element"));
1883 post_missing_plugin_error (GST_ELEMENT_CAST (decoder), "queue2");
1888 /* setup a streaming source. This will first plug a typefind element to the
1889 * source. After we find the type, we decide to plug a queue2 and continue to
1890 * plug a decodebin starting from the found caps */
1892 setup_streaming (GstURIDecodeBin * decoder)
1894 GstElement *typefind;
1896 /* now create the decoder element */
1897 typefind = gst_element_factory_make ("typefind", NULL);
1901 gst_bin_add (GST_BIN_CAST (decoder), typefind);
1903 if (!gst_element_link_pads (decoder->source, NULL, typefind, "sink"))
1904 goto could_not_link;
1906 decoder->typefind = typefind;
1908 /* connect a signal to find out when the typefind element found
1910 decoder->have_type_id =
1911 g_signal_connect (decoder->typefind, "have-type",
1912 G_CALLBACK (type_found), decoder);
1914 do_async_start (decoder);
1921 post_missing_plugin_error (GST_ELEMENT_CAST (decoder), "typefind");
1922 GST_ELEMENT_ERROR (decoder, CORE, MISSING_PLUGIN, (NULL),
1923 ("No typefind element, check your installation"));
1928 GST_ELEMENT_ERROR (decoder, CORE, NEGOTIATION,
1929 (NULL), ("Can't link source to typefind element"));
1930 gst_bin_remove (GST_BIN_CAST (decoder), typefind);
1931 /* Don't loose the SOURCE flag */
1932 GST_OBJECT_FLAG_SET (decoder, GST_ELEMENT_FLAG_SOURCE);
1938 free_stream (gpointer value)
1940 g_slice_free (GstURIDecodeBinStream, value);
1943 /* remove source and all related elements */
1945 remove_source (GstURIDecodeBin * bin)
1947 GstElement *source = bin->source;
1950 GST_DEBUG_OBJECT (bin, "removing old src element");
1951 gst_element_set_state (source, GST_STATE_NULL);
1953 if (bin->src_np_sig_id) {
1954 g_signal_handler_disconnect (source, bin->src_np_sig_id);
1955 bin->src_np_sig_id = 0;
1957 if (bin->src_nmp_sig_id) {
1958 g_signal_handler_disconnect (source, bin->src_nmp_sig_id);
1959 bin->src_nmp_sig_id = 0;
1961 gst_bin_remove (GST_BIN_CAST (bin), source);
1965 GST_DEBUG_OBJECT (bin, "removing old queue element");
1966 gst_element_set_state (bin->queue, GST_STATE_NULL);
1967 gst_bin_remove (GST_BIN_CAST (bin), bin->queue);
1970 if (bin->typefind) {
1971 GST_DEBUG_OBJECT (bin, "removing old typefind element");
1972 gst_element_set_state (bin->typefind, GST_STATE_NULL);
1973 gst_bin_remove (GST_BIN_CAST (bin), bin->typefind);
1974 bin->typefind = NULL;
1977 g_hash_table_destroy (bin->streams);
1978 bin->streams = NULL;
1980 /* Don't loose the SOURCE flag */
1981 GST_OBJECT_FLAG_SET (bin, GST_ELEMENT_FLAG_SOURCE);
1984 /* is called when a dynamic source element created a new pad. */
1986 source_new_pad (GstElement * element, GstPad * pad, GstURIDecodeBin * bin)
1988 GstElement *decoder;
1992 GST_URI_DECODE_BIN_LOCK (bin);
1993 GST_DEBUG_OBJECT (bin, "Found new pad %s.%s in source element %s",
1994 GST_DEBUG_PAD_NAME (pad), GST_ELEMENT_NAME (element));
1996 g_object_get (bin, "caps", &rawcaps, NULL);
1998 rawcaps = DEFAULT_CAPS;
2000 /* if this is a pad with all raw caps, we can expose it */
2001 if (has_all_raw_caps (pad, rawcaps, &is_raw) && is_raw) {
2002 /* it's all raw, create output pads. */
2003 GST_URI_DECODE_BIN_UNLOCK (bin);
2004 gst_caps_unref (rawcaps);
2005 expose_decoded_pad (element, pad, bin);
2008 gst_caps_unref (rawcaps);
2010 /* not raw, create decoder */
2011 decoder = make_decoder (bin);
2015 /* and link to decoder */
2016 if (!gst_element_link_pads (bin->source, NULL, decoder, "sink"))
2017 goto could_not_link;
2019 GST_DEBUG_OBJECT (bin, "linked decoder to new pad");
2021 gst_element_set_state (decoder, GST_STATE_PLAYING);
2022 GST_URI_DECODE_BIN_UNLOCK (bin);
2029 /* error was posted */
2030 GST_URI_DECODE_BIN_UNLOCK (bin);
2035 GST_ELEMENT_ERROR (bin, CORE, NEGOTIATION,
2036 (NULL), ("Can't link source to decoder element"));
2037 GST_URI_DECODE_BIN_UNLOCK (bin);
2043 is_live_source (GstElement * source)
2045 GObjectClass *source_class = NULL;
2046 gboolean is_live = FALSE;
2049 source_class = G_OBJECT_GET_CLASS (source);
2050 pspec = g_object_class_find_property (source_class, "is-live");
2051 if (!pspec || G_PARAM_SPEC_VALUE_TYPE (pspec) != G_TYPE_BOOLEAN)
2054 g_object_get (G_OBJECT (source), "is-live", &is_live, NULL);
2059 /* construct and run the source and decoder elements until we found
2060 * all the streams or until a preroll queue has been filled.
2063 setup_source (GstURIDecodeBin * decoder)
2065 gboolean is_raw, have_out, is_dynamic;
2067 GST_DEBUG_OBJECT (decoder, "setup source");
2069 /* delete old src */
2070 remove_source (decoder);
2072 decoder->pending = 0;
2074 /* create and configure an element that can handle the uri */
2075 if (!(decoder->source = gen_source_element (decoder)))
2078 /* state will be merged later - if file is not found, error will be
2079 * handled by the application right after. */
2080 gst_bin_add (GST_BIN_CAST (decoder), decoder->source);
2082 /* notify of the new source used */
2083 g_object_notify (G_OBJECT (decoder), "source");
2085 g_signal_emit (decoder, gst_uri_decode_bin_signals[SIGNAL_SOURCE_SETUP],
2086 0, decoder->source);
2088 if (is_live_source (decoder->source))
2089 decoder->is_stream = FALSE;
2091 /* remove the old decoders now, if any */
2092 remove_decoders (decoder, FALSE);
2094 /* stream admin setup */
2095 decoder->streams = g_hash_table_new_full (NULL, NULL, NULL, free_stream);
2097 /* see if the source element emits raw audio/video all by itself,
2098 * if so, we can create streams for the pads and be done with it.
2099 * Also check that is has source pads, if not, we assume it will
2100 * do everything itself. */
2101 if (!analyse_source (decoder, &is_raw, &have_out, &is_dynamic,
2102 decoder->need_queue))
2103 goto invalid_source;
2106 GST_DEBUG_OBJECT (decoder, "Source provides all raw data");
2107 /* source provides raw data, we added the pads and we can now signal a
2108 * no_more pads because we are done. */
2109 gst_element_no_more_pads (GST_ELEMENT_CAST (decoder));
2112 if (!have_out && !is_dynamic) {
2113 GST_DEBUG_OBJECT (decoder, "Source has no output pads");
2114 /* create a stream to indicate that this uri is handled by a self
2115 * contained element. We are now done. */
2116 add_element_stream (decoder->source, decoder);
2120 GST_DEBUG_OBJECT (decoder, "Source has dynamic output pads");
2121 /* connect a handler for the new-pad signal */
2122 decoder->src_np_sig_id =
2123 g_signal_connect (decoder->source, "pad-added",
2124 G_CALLBACK (source_new_pad), decoder);
2125 decoder->src_nmp_sig_id =
2126 g_signal_connect (decoder->source, "no-more-pads",
2127 G_CALLBACK (source_no_more_pads), decoder);
2128 g_object_set_data (G_OBJECT (decoder->source), "pending",
2129 GINT_TO_POINTER (1));
2132 if (decoder->is_stream) {
2133 GST_DEBUG_OBJECT (decoder, "Setting up streaming");
2134 /* do the stream things here */
2135 if (!setup_streaming (decoder))
2136 goto streaming_failed;
2138 GstElement *dec_elem;
2140 /* no streaming source, we can link now */
2141 GST_DEBUG_OBJECT (decoder, "Plugging decodebin to source");
2143 dec_elem = make_decoder (decoder);
2147 if (!gst_element_link_pads (decoder->source, NULL, dec_elem, "sink"))
2148 goto could_not_link;
2156 /* error message was already posted */
2161 GST_ELEMENT_ERROR (decoder, CORE, FAILED,
2162 (_("Source element is invalid.")), (NULL));
2167 /* message was posted */
2172 /* message was posted */
2177 GST_ELEMENT_ERROR (decoder, CORE, NEGOTIATION,
2178 (NULL), ("Can't link source to decoder element"));
2184 value_list_append_structure_list (GValue * list_val, GstStructure ** first,
2185 GList * structure_list)
2189 for (l = structure_list; l != NULL; l = l->next) {
2190 GValue val = { 0, };
2193 *first = gst_structure_copy ((GstStructure *) l->data);
2195 g_value_init (&val, GST_TYPE_STRUCTURE);
2196 g_value_take_boxed (&val, gst_structure_copy ((GstStructure *) l->data));
2197 gst_value_list_append_value (list_val, &val);
2198 g_value_unset (&val);
2202 /* if it's a redirect message with multiple redirect locations we might
2203 * want to pick a different 'best' location depending on the required
2204 * bitrates and the connection speed */
2206 handle_redirect_message (GstURIDecodeBin * dec, GstMessage * msg)
2208 const GValue *locations_list, *location_val;
2209 GstMessage *new_msg;
2210 GstStructure *new_structure = NULL;
2211 GList *l_good = NULL, *l_neutral = NULL, *l_bad = NULL;
2212 GValue new_list = { 0, };
2214 const GstStructure *structure;
2216 GST_DEBUG_OBJECT (dec, "redirect message: %" GST_PTR_FORMAT, msg);
2217 GST_DEBUG_OBJECT (dec, "connection speed: %" G_GUINT64_FORMAT,
2218 dec->connection_speed);
2220 structure = gst_message_get_structure (msg);
2221 if (dec->connection_speed == 0 || structure == NULL)
2224 locations_list = gst_structure_get_value (structure, "locations");
2225 if (locations_list == NULL)
2228 size = gst_value_list_get_size (locations_list);
2232 /* maintain existing order as much as possible, just sort references
2233 * with too high a bitrate to the end (the assumption being that if
2234 * bitrates are given they are given for all interesting streams and
2235 * that the you-need-at-least-version-xyz redirect has the same bitrate
2236 * as the lowest referenced redirect alternative) */
2237 for (i = 0; i < size; ++i) {
2238 const GstStructure *s;
2241 location_val = gst_value_list_get_value (locations_list, i);
2242 s = (const GstStructure *) g_value_get_boxed (location_val);
2243 if (!gst_structure_get_int (s, "minimum-bitrate", &bitrate) || bitrate <= 0) {
2244 GST_DEBUG_OBJECT (dec, "no bitrate: %" GST_PTR_FORMAT, s);
2245 l_neutral = g_list_append (l_neutral, (gpointer) s);
2246 } else if (bitrate > dec->connection_speed) {
2247 GST_DEBUG_OBJECT (dec, "bitrate too high: %" GST_PTR_FORMAT, s);
2248 l_bad = g_list_append (l_bad, (gpointer) s);
2249 } else if (bitrate <= dec->connection_speed) {
2250 GST_DEBUG_OBJECT (dec, "bitrate OK: %" GST_PTR_FORMAT, s);
2251 l_good = g_list_append (l_good, (gpointer) s);
2255 g_value_init (&new_list, GST_TYPE_LIST);
2256 value_list_append_structure_list (&new_list, &new_structure, l_good);
2257 value_list_append_structure_list (&new_list, &new_structure, l_neutral);
2258 value_list_append_structure_list (&new_list, &new_structure, l_bad);
2259 gst_structure_set_value (new_structure, "locations", &new_list);
2260 g_value_unset (&new_list);
2262 g_list_free (l_good);
2263 g_list_free (l_neutral);
2264 g_list_free (l_bad);
2266 new_msg = gst_message_new_element (msg->src, new_structure);
2267 gst_message_unref (msg);
2269 GST_DEBUG_OBJECT (dec, "new redirect message: %" GST_PTR_FORMAT, new_msg);
2274 handle_message (GstBin * bin, GstMessage * msg)
2276 if (GST_MESSAGE_TYPE (msg) == GST_MESSAGE_ELEMENT
2277 && gst_message_has_name (msg, "redirect")) {
2278 /* sort redirect messages based on the connection speed. This simplifies
2279 * the user of this element as it can in most cases just pick the first item
2280 * of the sorted list as a good redirection candidate. It can of course
2281 * choose something else from the list if it has a better way. */
2282 msg = handle_redirect_message (GST_URI_DECODE_BIN (bin), msg);
2284 GST_BIN_CLASS (parent_class)->handle_message (bin, msg);
2287 /* generic struct passed to all query fold methods
2288 * FIXME, move to core.
2299 typedef void (*QueryInitFunction) (GstURIDecodeBin * dec, QueryFold * fold);
2300 typedef void (*QueryDoneFunction) (GstURIDecodeBin * dec, QueryFold * fold);
2302 /* for duration/position we collect all durations/positions and take
2303 * the MAX of all valid results */
2305 decoder_query_init (GstURIDecodeBin * dec, QueryFold * fold)
2309 fold->seekable = TRUE;
2314 decoder_query_duration_fold (const GValue * item, GValue * ret,
2317 GstPad *pad = g_value_get_object (item);
2319 if (gst_pad_query (pad, fold->query)) {
2322 g_value_set_boolean (ret, TRUE);
2324 gst_query_parse_duration (fold->query, NULL, &duration);
2326 GST_DEBUG_OBJECT (item, "got duration %" G_GINT64_FORMAT, duration);
2328 if (duration > fold->max)
2329 fold->max = duration;
2335 decoder_query_duration_done (GstURIDecodeBin * dec, QueryFold * fold)
2339 gst_query_parse_duration (fold->query, &format, NULL);
2340 /* store max in query result */
2341 gst_query_set_duration (fold->query, format, fold->max);
2343 GST_DEBUG ("max duration %" G_GINT64_FORMAT, fold->max);
2347 decoder_query_position_fold (const GValue * item, GValue * ret,
2350 GstPad *pad = g_value_get_object (item);
2352 if (gst_pad_query (pad, fold->query)) {
2355 g_value_set_boolean (ret, TRUE);
2357 gst_query_parse_position (fold->query, NULL, &position);
2359 GST_DEBUG_OBJECT (item, "got position %" G_GINT64_FORMAT, position);
2361 if (position > fold->max)
2362 fold->max = position;
2369 decoder_query_position_done (GstURIDecodeBin * dec, QueryFold * fold)
2373 gst_query_parse_position (fold->query, &format, NULL);
2374 /* store max in query result */
2375 gst_query_set_position (fold->query, format, fold->max);
2377 GST_DEBUG_OBJECT (dec, "max position %" G_GINT64_FORMAT, fold->max);
2381 decoder_query_latency_fold (const GValue * item, GValue * ret, QueryFold * fold)
2383 GstPad *pad = g_value_get_object (item);
2385 if (gst_pad_query (pad, fold->query)) {
2386 GstClockTime min, max;
2389 g_value_set_boolean (ret, TRUE);
2391 gst_query_parse_latency (fold->query, &live, &min, &max);
2393 GST_DEBUG_OBJECT (item,
2394 "got latency min %" GST_TIME_FORMAT ", max %" GST_TIME_FORMAT
2395 ", live %d", GST_TIME_ARGS (min), GST_TIME_ARGS (max), live);
2397 /* for the combined latency we collect the MAX of all min latencies and
2398 * the MIN of all max latencies */
2399 if (min > fold->min)
2401 if (fold->max == -1)
2403 else if (max < fold->max)
2405 if (fold->live == FALSE)
2413 decoder_query_latency_done (GstURIDecodeBin * dec, QueryFold * fold)
2415 /* store max in query result */
2416 gst_query_set_latency (fold->query, fold->live, fold->min, fold->max);
2418 GST_DEBUG_OBJECT (dec,
2419 "latency min %" GST_TIME_FORMAT ", max %" GST_TIME_FORMAT
2420 ", live %d", GST_TIME_ARGS (fold->min), GST_TIME_ARGS (fold->max),
2424 /* we are seekable if all srcpads are seekable */
2426 decoder_query_seeking_fold (const GValue * item, GValue * ret, QueryFold * fold)
2428 GstPad *pad = g_value_get_object (item);
2430 if (gst_pad_query (pad, fold->query)) {
2433 g_value_set_boolean (ret, TRUE);
2434 gst_query_parse_seeking (fold->query, NULL, &seekable, NULL, NULL);
2436 GST_DEBUG_OBJECT (item, "got seekable %d", seekable);
2438 if (fold->seekable == TRUE)
2439 fold->seekable = seekable;
2446 decoder_query_seeking_done (GstURIDecodeBin * dec, QueryFold * fold)
2450 gst_query_parse_seeking (fold->query, &format, NULL, NULL, NULL);
2451 gst_query_set_seeking (fold->query, format, fold->seekable, 0, -1);
2453 GST_DEBUG_OBJECT (dec, "seekable %d", fold->seekable);
2456 /* generic fold, return first valid result */
2458 decoder_query_generic_fold (const GValue * item, GValue * ret, QueryFold * fold)
2460 GstPad *pad = g_value_get_object (item);
2463 if ((res = gst_pad_query (pad, fold->query))) {
2464 g_value_set_boolean (ret, TRUE);
2465 GST_DEBUG_OBJECT (item, "answered query %p", fold->query);
2468 /* and stop as soon as we have a valid result */
2473 /* we're a bin, the default query handler iterates sink elements, which we don't
2474 * have normally. We should just query all source pads.
2477 gst_uri_decode_bin_query (GstElement * element, GstQuery * query)
2479 GstURIDecodeBin *decoder;
2480 gboolean res = FALSE;
2482 GstIteratorFoldFunction fold_func;
2483 QueryInitFunction fold_init = NULL;
2484 QueryDoneFunction fold_done = NULL;
2485 QueryFold fold_data;
2488 decoder = GST_URI_DECODE_BIN (element);
2490 switch (GST_QUERY_TYPE (query)) {
2491 case GST_QUERY_DURATION:
2492 /* iterate and collect durations */
2493 fold_func = (GstIteratorFoldFunction) decoder_query_duration_fold;
2494 fold_init = decoder_query_init;
2495 fold_done = decoder_query_duration_done;
2497 case GST_QUERY_POSITION:
2498 /* iterate and collect durations */
2499 fold_func = (GstIteratorFoldFunction) decoder_query_position_fold;
2500 fold_init = decoder_query_init;
2501 fold_done = decoder_query_position_done;
2503 case GST_QUERY_LATENCY:
2504 /* iterate and collect durations */
2505 fold_func = (GstIteratorFoldFunction) decoder_query_latency_fold;
2506 fold_init = decoder_query_init;
2507 fold_done = decoder_query_latency_done;
2509 case GST_QUERY_SEEKING:
2510 /* iterate and collect durations */
2511 fold_func = (GstIteratorFoldFunction) decoder_query_seeking_fold;
2512 fold_init = decoder_query_init;
2513 fold_done = decoder_query_seeking_done;
2516 fold_func = (GstIteratorFoldFunction) decoder_query_generic_fold;
2520 fold_data.query = query;
2522 g_value_init (&ret, G_TYPE_BOOLEAN);
2523 g_value_set_boolean (&ret, FALSE);
2525 iter = gst_element_iterate_src_pads (element);
2526 GST_DEBUG_OBJECT (element, "Sending query %p (type %d) to src pads",
2527 query, GST_QUERY_TYPE (query));
2530 fold_init (decoder, &fold_data);
2533 GstIteratorResult ires;
2535 ires = gst_iterator_fold (iter, fold_func, &ret, &fold_data);
2538 case GST_ITERATOR_RESYNC:
2539 gst_iterator_resync (iter);
2541 fold_init (decoder, &fold_data);
2542 g_value_set_boolean (&ret, FALSE);
2544 case GST_ITERATOR_OK:
2545 case GST_ITERATOR_DONE:
2546 res = g_value_get_boolean (&ret);
2547 if (fold_done != NULL && res)
2548 fold_done (decoder, &fold_data);
2556 gst_iterator_free (iter);
2561 static GstStateChangeReturn
2562 gst_uri_decode_bin_change_state (GstElement * element,
2563 GstStateChange transition)
2565 GstStateChangeReturn ret;
2566 GstURIDecodeBin *decoder;
2568 decoder = GST_URI_DECODE_BIN (element);
2570 switch (transition) {
2571 case GST_STATE_CHANGE_READY_TO_PAUSED:
2572 if (!setup_source (decoder))
2579 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
2581 switch (transition) {
2582 case GST_STATE_CHANGE_READY_TO_PAUSED:
2583 GST_DEBUG ("ready to paused");
2584 if (ret == GST_STATE_CHANGE_FAILURE)
2587 case GST_STATE_CHANGE_PAUSED_TO_READY:
2588 GST_DEBUG ("paused to ready");
2589 remove_decoders (decoder, FALSE);
2590 remove_source (decoder);
2591 do_async_done (decoder);
2593 case GST_STATE_CHANGE_READY_TO_NULL:
2594 GST_DEBUG ("ready to null");
2595 remove_decoders (decoder, TRUE);
2596 remove_source (decoder);
2606 return GST_STATE_CHANGE_FAILURE;
2610 /* clean up leftover groups */
2611 return GST_STATE_CHANGE_FAILURE;
2616 gst_uri_decode_bin_plugin_init (GstPlugin * plugin)
2618 GST_DEBUG_CATEGORY_INIT (gst_uri_decode_bin_debug, "uridecodebin", 0,
2619 "URI decoder element");
2621 return gst_element_register (plugin, "uridecodebin", GST_RANK_NONE,
2622 GST_TYPE_URI_DECODE_BIN);