2 * Copyright (C) <2006> Edward Hervey <edward@fluendo.com>
3 * Copyright (C) <2009> Sebastian Dröge <sebastian.droege@collabora.co.uk>
4 * Copyright (C) <2011> Hewlett-Packard Development Company, L.P.
5 * Author: Sebastian Dröge <sebastian.droege@collabora.co.uk>, Collabora Ltd.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
20 * Boston, MA 02110-1301, USA.
24 * SECTION:element-decodebin
26 * #GstBin that auto-magically constructs a decoding pipeline using available
27 * decoders and demuxers via auto-plugging.
29 * decodebin is considered stable now and replaces the old #decodebin element.
30 * #uridecodebin uses decodebin internally and is often more convenient to
31 * use, as it creates a suitable source element as well.
34 /* Implementation notes:
36 * The following section describes how decodebin works internally.
38 * The first part of decodebin is its typefind element, which tries
39 * to determine the media type of the input stream. If the type is found
40 * autoplugging starts.
42 * decodebin internally organizes the elements it autoplugged into GstDecodeChains
43 * and GstDecodeGroups. A decode chain is a single chain of decoding, this
44 * means that if decodebin every autoplugs an element with two+ srcpads
45 * (e.g. a demuxer) this will end the chain and everything following this
46 * demuxer will be put into decode groups below the chain. Otherwise,
47 * if an element has a single srcpad that outputs raw data the decode chain
48 * is ended too and a GstDecodePad is stored and blocked.
50 * A decode group combines a number of chains that are created by a
51 * demuxer element. All those chains are connected through a multiqueue to
52 * the demuxer. A new group for the same demuxer is only created if the
53 * demuxer has signaled no-more-pads, in which case all following pads
54 * create a new chain in the new group.
56 * This continues until the top-level decode chain is complete. A decode
57 * chain is complete if it either ends with a blocked endpad, if autoplugging
58 * stopped because no suitable plugins could be found or if the active group
59 * is complete. A decode group on the other hand is complete if all child
60 * chains are complete.
62 * If this happens at some point, all endpads of all active groups are exposed.
63 * For this decodebin adds the endpads, signals no-more-pads and then unblocks
64 * them. Now playback starts.
66 * If one of the chains that end on a endpad receives EOS decodebin checks
67 * if all chains and groups are drained. In that case everything goes into EOS.
68 * If there is a chain where the active group is drained but there exist next
69 * groups, the active group is hidden (endpads are removed) and the next group
70 * is exposed. This means that in some cases more pads may be created even
71 * after the initial no-more-pads signal. This happens for example with
72 * so-called "chained oggs", most commonly found among ogg/vorbis internet
75 * Note 1: If we're talking about blocked endpads this really means that the
76 * *target* pads of the endpads are blocked. Pads that are exposed to the outside
77 * should never ever be blocked!
79 * Note 2: If a group is complete and the parent's chain demuxer adds new pads
80 * but never signaled no-more-pads this additional pads will be ignored!
84 /* FIXME 0.11: suppress warnings for deprecated API such as GValueArray
85 * with newer GLib versions (>= 2.31.0) */
86 #define GLIB_DISABLE_DEPRECATION_WARNINGS
92 #include <gst/gst-i18n-plugin.h>
96 #include <gst/pbutils/pbutils.h>
98 #include "gstplay-enum.h"
99 #include "gstplayback.h"
100 #include "gstrawcaps.h"
102 /* Also used by gsturidecodebin.c */
103 gint _decode_bin_compare_factories_func (gconstpointer p1, gconstpointer p2);
105 /* generic templates */
106 static GstStaticPadTemplate decoder_bin_sink_template =
107 GST_STATIC_PAD_TEMPLATE ("sink",
110 GST_STATIC_CAPS_ANY);
112 static GstStaticPadTemplate decoder_bin_src_template =
113 GST_STATIC_PAD_TEMPLATE ("src_%u",
116 GST_STATIC_CAPS_ANY);
118 GST_DEBUG_CATEGORY_STATIC (gst_decode_bin_debug);
119 #define GST_CAT_DEFAULT gst_decode_bin_debug
121 typedef struct _GstPendingPad GstPendingPad;
122 typedef struct _GstDecodeElement GstDecodeElement;
123 typedef struct _GstDecodeChain GstDecodeChain;
124 typedef struct _GstDecodeGroup GstDecodeGroup;
125 typedef struct _GstDecodePad GstDecodePad;
126 typedef GstGhostPadClass GstDecodePadClass;
127 typedef struct _GstDecodeBin GstDecodeBin;
128 typedef struct _GstDecodeBinClass GstDecodeBinClass;
130 #define GST_TYPE_DECODE_BIN (gst_decode_bin_get_type())
131 #define GST_DECODE_BIN_CAST(obj) ((GstDecodeBin*)(obj))
132 #define GST_DECODE_BIN(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DECODE_BIN,GstDecodeBin))
133 #define GST_DECODE_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_DECODE_BIN,GstDecodeBinClass))
134 #define GST_IS_DECODE_BIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DECODE_BIN))
135 #define GST_IS_DECODE_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_DECODE_BIN))
140 * The opaque #GstDecodeBin data structure
144 GstBin bin; /* we extend GstBin */
147 GstCaps *caps; /* caps on which to stop decoding */
148 gchar *encoding; /* encoding of subtitles */
149 gboolean use_buffering; /* configure buffering on multiqueues */
152 guint max_size_bytes;
153 guint max_size_buffers;
154 guint64 max_size_time;
155 gboolean post_stream_topology;
156 guint64 connection_speed;
158 GstElement *typefind; /* this holds the typefind object */
160 GMutex expose_lock; /* Protects exposal and removal of groups */
161 GstDecodeChain *decode_chain; /* Top level decode chain */
162 guint nbpads; /* unique identifier for source pads */
164 GMutex factories_lock;
165 guint32 factories_cookie; /* Cookie from last time when factories was updated */
166 GList *factories; /* factories we can use for selecting elements */
168 GMutex subtitle_lock; /* Protects changes to subtitles and encoding */
169 GList *subtitles; /* List of elements with subtitle-encoding,
170 * protected by above mutex! */
172 gboolean have_type; /* if we received the have_type signal */
173 guint have_type_id; /* signal id for have-type from typefind */
175 gboolean async_pending; /* async-start has been emitted */
177 GMutex dyn_lock; /* lock protecting pad blocking */
178 gboolean shutdown; /* if we are shutting down */
179 GList *blocked_pads; /* pads that have set to block */
181 gboolean expose_allstreams; /* Whether to expose unknow type streams or not */
183 GList *filtered; /* elements for which error messages are filtered */
186 struct _GstDecodeBinClass
188 GstBinClass parent_class;
190 /* signal fired when we found a pad that we cannot decode */
191 void (*unknown_type) (GstElement * element, GstPad * pad, GstCaps * caps);
193 /* signal fired to know if we continue trying to decode the given caps */
194 gboolean (*autoplug_continue) (GstElement * element, GstPad * pad,
196 /* signal fired to get a list of factories to try to autoplug */
197 GValueArray *(*autoplug_factories) (GstElement * element, GstPad * pad,
199 /* signal fired to sort the factories */
200 GValueArray *(*autoplug_sort) (GstElement * element, GstPad * pad,
201 GstCaps * caps, GValueArray * factories);
202 /* signal fired to select from the proposed list of factories */
203 GstAutoplugSelectResult (*autoplug_select) (GstElement * element,
204 GstPad * pad, GstCaps * caps, GstElementFactory * factory);
206 /* fired when the last group is drained */
207 void (*drained) (GstElement * element);
214 SIGNAL_AUTOPLUG_CONTINUE,
215 SIGNAL_AUTOPLUG_FACTORIES,
216 SIGNAL_AUTOPLUG_SELECT,
217 SIGNAL_AUTOPLUG_SORT,
222 /* automatic sizes, while prerolling we buffer up to 2MB, we ignore time
223 * and buffers in this case. */
224 #define AUTO_PREROLL_SIZE_BYTES 2 * 1024 * 1024
225 #define AUTO_PREROLL_SIZE_BUFFERS 0
226 #define AUTO_PREROLL_NOT_SEEKABLE_SIZE_TIME 10 * GST_SECOND
227 #define AUTO_PREROLL_SEEKABLE_SIZE_TIME 0
229 /* whan playing, keep a max of 2MB of data but try to keep the number of buffers
230 * as low as possible (try to aim for 5 buffers) */
231 #define AUTO_PLAY_SIZE_BYTES 2 * 1024 * 1024
232 #define AUTO_PLAY_SIZE_BUFFERS 5
233 #define AUTO_PLAY_SIZE_TIME 0
235 #define DEFAULT_SUBTITLE_ENCODING NULL
236 #define DEFAULT_USE_BUFFERING FALSE
237 #define DEFAULT_LOW_PERCENT 10
238 #define DEFAULT_HIGH_PERCENT 99
239 /* by default we use the automatic values above */
240 #define DEFAULT_MAX_SIZE_BYTES 0
241 #define DEFAULT_MAX_SIZE_BUFFERS 0
242 #define DEFAULT_MAX_SIZE_TIME 0
243 #define DEFAULT_POST_STREAM_TOPOLOGY FALSE
244 #define DEFAULT_EXPOSE_ALL_STREAMS TRUE
245 #define DEFAULT_CONNECTION_SPEED 0
252 PROP_SUBTITLE_ENCODING,
258 PROP_MAX_SIZE_BUFFERS,
260 PROP_POST_STREAM_TOPOLOGY,
261 PROP_EXPOSE_ALL_STREAMS,
262 PROP_CONNECTION_SPEED,
266 static GstBinClass *parent_class;
267 static guint gst_decode_bin_signals[LAST_SIGNAL] = { 0 };
269 static GstStaticCaps default_raw_caps = GST_STATIC_CAPS (DEFAULT_RAW_CAPS);
271 static void do_async_start (GstDecodeBin * dbin);
272 static void do_async_done (GstDecodeBin * dbin);
274 static void type_found (GstElement * typefind, guint probability,
275 GstCaps * caps, GstDecodeBin * decode_bin);
277 static void decodebin_set_queue_size (GstDecodeBin * dbin,
278 GstElement * multiqueue, gboolean preroll, gboolean seekable);
280 static gboolean gst_decode_bin_autoplug_continue (GstElement * element,
281 GstPad * pad, GstCaps * caps);
282 static GValueArray *gst_decode_bin_autoplug_factories (GstElement *
283 element, GstPad * pad, GstCaps * caps);
284 static GValueArray *gst_decode_bin_autoplug_sort (GstElement * element,
285 GstPad * pad, GstCaps * caps, GValueArray * factories);
286 static GstAutoplugSelectResult gst_decode_bin_autoplug_select (GstElement *
287 element, GstPad * pad, GstCaps * caps, GstElementFactory * factory);
289 static void gst_decode_bin_set_property (GObject * object, guint prop_id,
290 const GValue * value, GParamSpec * pspec);
291 static void gst_decode_bin_get_property (GObject * object, guint prop_id,
292 GValue * value, GParamSpec * pspec);
293 static void gst_decode_bin_set_caps (GstDecodeBin * dbin, GstCaps * caps);
294 static GstCaps *gst_decode_bin_get_caps (GstDecodeBin * dbin);
295 static void caps_notify_cb (GstPad * pad, GParamSpec * unused,
296 GstDecodeChain * chain);
298 static GstPad *find_sink_pad (GstElement * element);
299 static GstStateChangeReturn gst_decode_bin_change_state (GstElement * element,
300 GstStateChange transition);
301 static void gst_decode_bin_handle_message (GstBin * bin, GstMessage * message);
303 static gboolean check_upstream_seekable (GstDecodeBin * dbin, GstPad * pad);
305 #define EXPOSE_LOCK(dbin) G_STMT_START { \
306 GST_LOG_OBJECT (dbin, \
307 "expose locking from thread %p", \
309 g_mutex_lock (&GST_DECODE_BIN_CAST(dbin)->expose_lock); \
310 GST_LOG_OBJECT (dbin, \
311 "expose locked from thread %p", \
315 #define EXPOSE_UNLOCK(dbin) G_STMT_START { \
316 GST_LOG_OBJECT (dbin, \
317 "expose unlocking from thread %p", \
319 g_mutex_unlock (&GST_DECODE_BIN_CAST(dbin)->expose_lock); \
322 #define DYN_LOCK(dbin) G_STMT_START { \
323 GST_LOG_OBJECT (dbin, \
324 "dynlocking from thread %p", \
326 g_mutex_lock (&GST_DECODE_BIN_CAST(dbin)->dyn_lock); \
327 GST_LOG_OBJECT (dbin, \
328 "dynlocked from thread %p", \
332 #define DYN_UNLOCK(dbin) G_STMT_START { \
333 GST_LOG_OBJECT (dbin, \
334 "dynunlocking from thread %p", \
336 g_mutex_unlock (&GST_DECODE_BIN_CAST(dbin)->dyn_lock); \
339 #define SUBTITLE_LOCK(dbin) G_STMT_START { \
340 GST_LOG_OBJECT (dbin, \
341 "subtitle locking from thread %p", \
343 g_mutex_lock (&GST_DECODE_BIN_CAST(dbin)->subtitle_lock); \
344 GST_LOG_OBJECT (dbin, \
345 "subtitle lock from thread %p", \
349 #define SUBTITLE_UNLOCK(dbin) G_STMT_START { \
350 GST_LOG_OBJECT (dbin, \
351 "subtitle unlocking from thread %p", \
353 g_mutex_unlock (&GST_DECODE_BIN_CAST(dbin)->subtitle_lock); \
356 struct _GstPendingPad
359 GstDecodeChain *chain;
360 gulong event_probe_id;
363 struct _GstDecodeElement
366 GstElement *capsfilter; /* Optional capsfilter for Parser/Convert */
371 * Streams belonging to the same group/chain of a media file
373 * When changing something here lock the parent chain!
375 struct _GstDecodeGroup
378 GstDecodeChain *parent;
380 GstElement *multiqueue; /* Used for linking all child chains */
381 gulong overrunsig; /* the overrun signal for multiqueue */
383 gboolean overrun; /* TRUE if the multiqueue signaled overrun. This
384 * means that we should really expose the group */
386 gboolean no_more_pads; /* TRUE if the demuxer signaled no-more-pads */
387 gboolean drained; /* TRUE if the all children are drained */
389 GList *children; /* List of GstDecodeChains in this group */
391 GList *reqpads; /* List of RequestPads for multiqueue, there is
392 * exactly one RequestPad per child chain */
395 struct _GstDecodeChain
397 GstDecodeGroup *parent;
400 GMutex lock; /* Protects this chain and its groups */
402 GstPad *pad; /* srcpad that caused creation of this chain */
404 gboolean drained; /* TRUE if the all children are drained */
405 gboolean demuxer; /* TRUE if elements->data is a demuxer */
406 gboolean seekable; /* TRUE if this chain ends on a demuxer and is seekable */
407 GList *elements; /* All elements in this group, first
408 is the latest and most downstream element */
410 /* Note: there are only groups if the last element of this chain
411 * is a demuxer, otherwise the chain will end with an endpad.
412 * The other way around this means, that endpad only exists if this
413 * chain doesn't end with a demuxer! */
415 GstDecodeGroup *active_group; /* Currently active group */
416 GList *next_groups; /* head is newest group, tail is next group.
417 a new group will be created only if the head
418 group had no-more-pads. If it's only exposed
419 all new pads will be ignored! */
420 GList *pending_pads; /* Pads that have no fixed caps yet */
422 GstDecodePad *endpad; /* Pad of this chain that could be exposed */
423 gboolean deadend; /* This chain is incomplete and can't be completed,
424 e.g. no suitable decoder could be found
425 e.g. stream got EOS without buffers
427 GstCaps *endcaps; /* Caps that were used when linking to the endpad
428 or that resulted in the deadend
431 /* FIXME: This should be done directly via a thread! */
432 GList *old_groups; /* Groups that should be freed later */
435 static void gst_decode_chain_free (GstDecodeChain * chain);
436 static GstDecodeChain *gst_decode_chain_new (GstDecodeBin * dbin,
437 GstDecodeGroup * group, GstPad * pad);
438 static void gst_decode_group_hide (GstDecodeGroup * group);
439 static void gst_decode_group_free (GstDecodeGroup * group);
440 static GstDecodeGroup *gst_decode_group_new (GstDecodeBin * dbin,
441 GstDecodeChain * chain);
442 static gboolean gst_decode_chain_is_complete (GstDecodeChain * chain);
443 static gboolean gst_decode_chain_expose (GstDecodeChain * chain,
444 GList ** endpads, gboolean * missing_plugin);
445 static gboolean gst_decode_chain_is_drained (GstDecodeChain * chain);
446 static gboolean gst_decode_group_is_complete (GstDecodeGroup * group);
447 static GstPad *gst_decode_group_control_demuxer_pad (GstDecodeGroup * group,
449 static gboolean gst_decode_group_is_drained (GstDecodeGroup * group);
451 static gboolean gst_decode_bin_expose (GstDecodeBin * dbin);
453 #define CHAIN_MUTEX_LOCK(chain) G_STMT_START { \
454 GST_LOG_OBJECT (chain->dbin, \
455 "locking chain %p from thread %p", \
456 chain, g_thread_self ()); \
457 g_mutex_lock (&chain->lock); \
458 GST_LOG_OBJECT (chain->dbin, \
459 "locked chain %p from thread %p", \
460 chain, g_thread_self ()); \
463 #define CHAIN_MUTEX_UNLOCK(chain) G_STMT_START { \
464 GST_LOG_OBJECT (chain->dbin, \
465 "unlocking chain %p from thread %p", \
466 chain, g_thread_self ()); \
467 g_mutex_unlock (&chain->lock); \
472 * GstPad private used for source pads of chains
478 GstDecodeChain *chain;
480 gboolean blocked; /* the *target* pad is blocked */
481 gboolean exposed; /* the pad is exposed */
482 gboolean drained; /* an EOS has been seen on the pad */
487 GType gst_decode_pad_get_type (void);
488 G_DEFINE_TYPE (GstDecodePad, gst_decode_pad, GST_TYPE_GHOST_PAD);
489 #define GST_TYPE_DECODE_PAD (gst_decode_pad_get_type ())
490 #define GST_DECODE_PAD(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DECODE_PAD,GstDecodePad))
492 static GstDecodePad *gst_decode_pad_new (GstDecodeBin * dbin, GstPad * pad,
493 GstDecodeChain * chain);
494 static void gst_decode_pad_activate (GstDecodePad * dpad,
495 GstDecodeChain * chain);
496 static void gst_decode_pad_unblock (GstDecodePad * dpad);
497 static void gst_decode_pad_set_blocked (GstDecodePad * dpad, gboolean blocked);
499 static void gst_pending_pad_free (GstPendingPad * ppad);
500 static GstPadProbeReturn pad_event_cb (GstPad * pad, GstPadProbeInfo * info,
503 /********************************
504 * Standard GObject boilerplate *
505 ********************************/
507 static void gst_decode_bin_class_init (GstDecodeBinClass * klass);
508 static void gst_decode_bin_init (GstDecodeBin * decode_bin);
509 static void gst_decode_bin_dispose (GObject * object);
510 static void gst_decode_bin_finalize (GObject * object);
513 gst_decode_bin_get_type (void)
515 static GType gst_decode_bin_type = 0;
517 if (!gst_decode_bin_type) {
518 static const GTypeInfo gst_decode_bin_info = {
519 sizeof (GstDecodeBinClass),
522 (GClassInitFunc) gst_decode_bin_class_init,
525 sizeof (GstDecodeBin),
527 (GInstanceInitFunc) gst_decode_bin_init,
531 gst_decode_bin_type =
532 g_type_register_static (GST_TYPE_BIN, "GstDecodeBin",
533 &gst_decode_bin_info, 0);
536 return gst_decode_bin_type;
540 _gst_boolean_accumulator (GSignalInvocationHint * ihint,
541 GValue * return_accu, const GValue * handler_return, gpointer dummy)
545 myboolean = g_value_get_boolean (handler_return);
546 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
547 g_value_set_boolean (return_accu, myboolean);
549 /* stop emission if FALSE */
553 /* we collect the first result */
555 _gst_array_accumulator (GSignalInvocationHint * ihint,
556 GValue * return_accu, const GValue * handler_return, gpointer dummy)
560 array = g_value_get_boxed (handler_return);
561 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
562 g_value_set_boxed (return_accu, array);
568 _gst_select_accumulator (GSignalInvocationHint * ihint,
569 GValue * return_accu, const GValue * handler_return, gpointer dummy)
571 GstAutoplugSelectResult res;
573 res = g_value_get_enum (handler_return);
574 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
575 g_value_set_enum (return_accu, res);
581 _gst_array_hasvalue_accumulator (GSignalInvocationHint * ihint,
582 GValue * return_accu, const GValue * handler_return, gpointer dummy)
586 array = g_value_get_boxed (handler_return);
587 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
588 g_value_set_boxed (return_accu, array);
597 gst_decode_bin_class_init (GstDecodeBinClass * klass)
599 GObjectClass *gobject_klass;
600 GstElementClass *gstelement_klass;
601 GstBinClass *gstbin_klass;
603 gobject_klass = (GObjectClass *) klass;
604 gstelement_klass = (GstElementClass *) klass;
605 gstbin_klass = (GstBinClass *) klass;
607 parent_class = g_type_class_peek_parent (klass);
609 gobject_klass->dispose = gst_decode_bin_dispose;
610 gobject_klass->finalize = gst_decode_bin_finalize;
611 gobject_klass->set_property = gst_decode_bin_set_property;
612 gobject_klass->get_property = gst_decode_bin_get_property;
615 * GstDecodeBin::unknown-type:
616 * @bin: The decodebin.
617 * @pad: The new pad containing caps that cannot be resolved to a 'final'
619 * @caps: The #GstCaps of the pad that cannot be resolved.
621 * This signal is emitted when a pad for which there is no further possible
622 * decoding is added to the decodebin.
624 gst_decode_bin_signals[SIGNAL_UNKNOWN_TYPE] =
625 g_signal_new ("unknown-type", G_TYPE_FROM_CLASS (klass),
626 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, unknown_type),
627 NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 2,
628 GST_TYPE_PAD, GST_TYPE_CAPS);
631 * GstDecodeBin::autoplug-continue:
632 * @bin: The decodebin.
634 * @caps: The #GstCaps found.
636 * This signal is emitted whenever decodebin finds a new stream. It is
637 * emitted before looking for any elements that can handle that stream.
640 * Invocation of signal handlers stops after the first signal handler
641 * returns #FALSE. Signal handlers are invoked in the order they were
645 * Returns: #TRUE if you wish decodebin to look for elements that can
646 * handle the given @caps. If #FALSE, those caps will be considered as
647 * final and the pad will be exposed as such (see 'pad-added' signal of
650 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE] =
651 g_signal_new ("autoplug-continue", G_TYPE_FROM_CLASS (klass),
652 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_continue),
653 _gst_boolean_accumulator, NULL, g_cclosure_marshal_generic,
654 G_TYPE_BOOLEAN, 2, GST_TYPE_PAD, GST_TYPE_CAPS);
657 * GstDecodeBin::autoplug-factories:
658 * @bin: The decodebin.
660 * @caps: The #GstCaps found.
662 * This function is emited when an array of possible factories for @caps on
663 * @pad is needed. Decodebin will by default return an array with all
664 * compatible factories, sorted by rank.
666 * If this function returns NULL, @pad will be exposed as a final caps.
668 * If this function returns an empty array, the pad will be considered as
669 * having an unhandled type media type.
672 * Only the signal handler that is connected first will ever by invoked.
673 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
674 * signal, they will never be invoked!
677 * Returns: a #GValueArray* with a list of factories to try. The factories are
678 * by default tried in the returned order or based on the index returned by
681 gst_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES] =
682 g_signal_new ("autoplug-factories", G_TYPE_FROM_CLASS (klass),
683 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass,
684 autoplug_factories), _gst_array_accumulator, NULL,
685 g_cclosure_marshal_generic, G_TYPE_VALUE_ARRAY, 2,
686 GST_TYPE_PAD, GST_TYPE_CAPS);
689 * GstDecodeBin::autoplug-sort:
690 * @bin: The decodebin.
692 * @caps: The #GstCaps.
693 * @factories: A #GValueArray of possible #GstElementFactory to use.
695 * Once decodebin has found the possible #GstElementFactory objects to try
696 * for @caps on @pad, this signal is emited. The purpose of the signal is for
697 * the application to perform additional sorting or filtering on the element
700 * The callee should copy and modify @factories or return #NULL if the
701 * order should not change.
704 * Invocation of signal handlers stops after one signal handler has
705 * returned something else than #NULL. Signal handlers are invoked in
706 * the order they were connected in.
707 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
708 * signal, they will never be invoked!
711 * Returns: A new sorted array of #GstElementFactory objects.
713 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SORT] =
714 g_signal_new ("autoplug-sort", G_TYPE_FROM_CLASS (klass),
715 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_sort),
716 _gst_array_hasvalue_accumulator, NULL,
717 g_cclosure_marshal_generic, G_TYPE_VALUE_ARRAY, 3, GST_TYPE_PAD,
718 GST_TYPE_CAPS, G_TYPE_VALUE_ARRAY | G_SIGNAL_TYPE_STATIC_SCOPE);
721 * GstDecodeBin::autoplug-select:
722 * @bin: The decodebin.
724 * @caps: The #GstCaps.
725 * @factory: A #GstElementFactory to use.
727 * This signal is emitted once decodebin has found all the possible
728 * #GstElementFactory that can be used to handle the given @caps. For each of
729 * those factories, this signal is emitted.
731 * The signal handler should return a #GST_TYPE_AUTOPLUG_SELECT_RESULT enum
732 * value indicating what decodebin should do next.
734 * A value of #GST_AUTOPLUG_SELECT_TRY will try to autoplug an element from
737 * A value of #GST_AUTOPLUG_SELECT_EXPOSE will expose @pad without plugging
740 * A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the
744 * Only the signal handler that is connected first will ever by invoked.
745 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
746 * signal, they will never be invoked!
749 * Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required
750 * operation. the default handler will always return
751 * #GST_AUTOPLUG_SELECT_TRY.
753 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT] =
754 g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass),
755 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_select),
756 _gst_select_accumulator, NULL,
757 g_cclosure_marshal_generic,
758 GST_TYPE_AUTOPLUG_SELECT_RESULT, 3, GST_TYPE_PAD, GST_TYPE_CAPS,
759 GST_TYPE_ELEMENT_FACTORY);
762 * GstDecodeBin::drained
763 * @bin: The decodebin
765 * This signal is emitted once decodebin has finished decoding all the data.
769 gst_decode_bin_signals[SIGNAL_DRAINED] =
770 g_signal_new ("drained", G_TYPE_FROM_CLASS (klass),
771 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, drained),
772 NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 0, G_TYPE_NONE);
774 g_object_class_install_property (gobject_klass, PROP_CAPS,
775 g_param_spec_boxed ("caps", "Caps", "The caps on which to stop decoding.",
776 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
778 g_object_class_install_property (gobject_klass, PROP_SUBTITLE_ENCODING,
779 g_param_spec_string ("subtitle-encoding", "subtitle encoding",
780 "Encoding to assume if input subtitles are not in UTF-8 encoding. "
781 "If not set, the GST_SUBTITLE_ENCODING environment variable will "
782 "be checked for an encoding to use. If that is not set either, "
783 "ISO-8859-15 will be assumed.", NULL,
784 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
786 g_object_class_install_property (gobject_klass, PROP_SINK_CAPS,
787 g_param_spec_boxed ("sink-caps", "Sink Caps",
788 "The caps of the input data. (NULL = use typefind element)",
789 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
792 * GstDecodeBin::use-buffering
794 * Activate buffering in decodebin. This will instruct the multiqueues behind
795 * decoders to emit BUFFERING messages.
799 g_object_class_install_property (gobject_klass, PROP_USE_BUFFERING,
800 g_param_spec_boolean ("use-buffering", "Use Buffering",
801 "Emit GST_MESSAGE_BUFFERING based on low-/high-percent thresholds",
802 DEFAULT_USE_BUFFERING, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
805 * GstDecodeBin:low-percent
807 * Low threshold percent for buffering to start.
811 g_object_class_install_property (gobject_klass, PROP_LOW_PERCENT,
812 g_param_spec_int ("low-percent", "Low percent",
813 "Low threshold for buffering to start", 0, 100,
814 DEFAULT_LOW_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
816 * GstDecodeBin:high-percent
818 * High threshold percent for buffering to finish.
822 g_object_class_install_property (gobject_klass, PROP_HIGH_PERCENT,
823 g_param_spec_int ("high-percent", "High percent",
824 "High threshold for buffering to finish", 0, 100,
825 DEFAULT_HIGH_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
828 * GstDecodeBin:max-size-bytes
830 * Max amount of bytes in the queue (0=automatic).
834 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_BYTES,
835 g_param_spec_uint ("max-size-bytes", "Max. size (bytes)",
836 "Max. amount of bytes in the queue (0=automatic)",
837 0, G_MAXUINT, DEFAULT_MAX_SIZE_BYTES,
838 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
840 * GstDecodeBin:max-size-buffers
842 * Max amount of buffers in the queue (0=automatic).
846 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_BUFFERS,
847 g_param_spec_uint ("max-size-buffers", "Max. size (buffers)",
848 "Max. number of buffers in the queue (0=automatic)",
849 0, G_MAXUINT, DEFAULT_MAX_SIZE_BUFFERS,
850 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
852 * GstDecodeBin:max-size-time
854 * Max amount of time in the queue (in ns, 0=automatic).
858 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_TIME,
859 g_param_spec_uint64 ("max-size-time", "Max. size (ns)",
860 "Max. amount of data in the queue (in ns, 0=automatic)",
862 DEFAULT_MAX_SIZE_TIME, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
865 * GstDecodeBin::post-stream-topology
867 * Post stream-topology messages on the bus every time the topology changes.
871 g_object_class_install_property (gobject_klass, PROP_POST_STREAM_TOPOLOGY,
872 g_param_spec_boolean ("post-stream-topology", "Post Stream Topology",
873 "Post stream-topology messages",
874 DEFAULT_POST_STREAM_TOPOLOGY,
875 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
878 * GstDecodeBin::expose-all-streams
880 * Expose streams of unknown type.
882 * If set to %FALSE, then only the streams that can be decoded to the final
883 * caps (see 'caps' property) will have a pad exposed. Streams that do not
884 * match those caps but could have been decoded will not have decoder plugged
885 * in internally and will not have a pad exposed.
889 g_object_class_install_property (gobject_klass, PROP_EXPOSE_ALL_STREAMS,
890 g_param_spec_boolean ("expose-all-streams", "Expose All Streams",
891 "Expose all streams, including those of unknown type or that don't match the 'caps' property",
892 DEFAULT_EXPOSE_ALL_STREAMS,
893 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
896 * GstDecodeBin2::connection-speed
898 * Network connection speed in kbps (0 = unknownw)
902 g_object_class_install_property (gobject_klass, PROP_CONNECTION_SPEED,
903 g_param_spec_uint64 ("connection-speed", "Connection Speed",
904 "Network connection speed in kbps (0 = unknown)",
905 0, G_MAXUINT64 / 1000, DEFAULT_CONNECTION_SPEED,
906 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
910 klass->autoplug_continue =
911 GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_continue);
912 klass->autoplug_factories =
913 GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_factories);
914 klass->autoplug_sort = GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_sort);
915 klass->autoplug_select = GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_select);
917 gst_element_class_add_pad_template (gstelement_klass,
918 gst_static_pad_template_get (&decoder_bin_sink_template));
919 gst_element_class_add_pad_template (gstelement_klass,
920 gst_static_pad_template_get (&decoder_bin_src_template));
922 gst_element_class_set_static_metadata (gstelement_klass,
923 "Decoder Bin", "Generic/Bin/Decoder",
924 "Autoplug and decode to raw media",
925 "Edward Hervey <edward.hervey@collabora.co.uk>, "
926 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
928 gstelement_klass->change_state =
929 GST_DEBUG_FUNCPTR (gst_decode_bin_change_state);
931 gstbin_klass->handle_message =
932 GST_DEBUG_FUNCPTR (gst_decode_bin_handle_message);
934 g_type_class_ref (GST_TYPE_DECODE_PAD);
938 _decode_bin_compare_factories_func (gconstpointer p1, gconstpointer p2)
940 GstPluginFeature *f1, *f2;
942 gboolean is_parser1, is_parser2;
944 f1 = (GstPluginFeature *) p1;
945 f2 = (GstPluginFeature *) p2;
947 is_parser1 = gst_element_factory_list_is_type (GST_ELEMENT_FACTORY_CAST (f1),
948 GST_ELEMENT_FACTORY_TYPE_PARSER);
949 is_parser2 = gst_element_factory_list_is_type (GST_ELEMENT_FACTORY_CAST (f2),
950 GST_ELEMENT_FACTORY_TYPE_PARSER);
953 /* We want all parsers first as we always want to plug parsers
955 if (is_parser1 && !is_parser2)
957 else if (!is_parser1 && is_parser2)
960 /* And if it's a both a parser we first sort by rank
961 * and then by factory name */
962 diff = gst_plugin_feature_get_rank (f2) - gst_plugin_feature_get_rank (f1);
966 diff = strcmp (GST_OBJECT_NAME (f2), GST_OBJECT_NAME (f1));
971 /* Must be called with factories lock! */
973 gst_decode_bin_update_factories_list (GstDecodeBin * dbin)
977 cookie = gst_registry_get_feature_list_cookie (gst_registry_get ());
978 if (!dbin->factories || dbin->factories_cookie != cookie) {
980 gst_plugin_feature_list_free (dbin->factories);
982 gst_element_factory_list_get_elements
983 (GST_ELEMENT_FACTORY_TYPE_DECODABLE, GST_RANK_MARGINAL);
985 g_list_sort (dbin->factories, _decode_bin_compare_factories_func);
986 dbin->factories_cookie = cookie;
991 gst_decode_bin_init (GstDecodeBin * decode_bin)
993 GST_OBJECT_FLAG_SET (decode_bin, GST_BIN_FLAG_NO_RESYNC);
995 /* first filter out the interesting element factories */
996 g_mutex_init (&decode_bin->factories_lock);
998 /* we create the typefind element only once */
999 decode_bin->typefind = gst_element_factory_make ("typefind", "typefind");
1000 if (!decode_bin->typefind) {
1001 g_warning ("can't find typefind element, decodebin will not work");
1005 GstPadTemplate *pad_tmpl;
1007 /* add the typefind element */
1008 if (!gst_bin_add (GST_BIN (decode_bin), decode_bin->typefind)) {
1009 g_warning ("Could not add typefind element, decodebin will not work");
1010 gst_object_unref (decode_bin->typefind);
1011 decode_bin->typefind = NULL;
1014 /* get the sinkpad */
1015 pad = gst_element_get_static_pad (decode_bin->typefind, "sink");
1017 /* get the pad template */
1018 pad_tmpl = gst_static_pad_template_get (&decoder_bin_sink_template);
1020 /* ghost the sink pad to ourself */
1021 gpad = gst_ghost_pad_new_from_template ("sink", pad, pad_tmpl);
1022 gst_pad_set_active (gpad, TRUE);
1023 gst_element_add_pad (GST_ELEMENT (decode_bin), gpad);
1025 gst_object_unref (pad_tmpl);
1026 gst_object_unref (pad);
1028 /* connect a signal to find out when the typefind element found
1030 decode_bin->have_type_id =
1031 g_signal_connect (G_OBJECT (decode_bin->typefind), "have-type",
1032 G_CALLBACK (type_found), decode_bin);
1035 g_mutex_init (&decode_bin->expose_lock);
1036 decode_bin->decode_chain = NULL;
1038 g_mutex_init (&decode_bin->dyn_lock);
1039 decode_bin->shutdown = FALSE;
1040 decode_bin->blocked_pads = NULL;
1042 g_mutex_init (&decode_bin->subtitle_lock);
1044 decode_bin->encoding = g_strdup (DEFAULT_SUBTITLE_ENCODING);
1045 decode_bin->caps = gst_static_caps_get (&default_raw_caps);
1046 decode_bin->use_buffering = DEFAULT_USE_BUFFERING;
1047 decode_bin->low_percent = DEFAULT_LOW_PERCENT;
1048 decode_bin->high_percent = DEFAULT_HIGH_PERCENT;
1050 decode_bin->max_size_bytes = DEFAULT_MAX_SIZE_BYTES;
1051 decode_bin->max_size_buffers = DEFAULT_MAX_SIZE_BUFFERS;
1052 decode_bin->max_size_time = DEFAULT_MAX_SIZE_TIME;
1054 decode_bin->expose_allstreams = DEFAULT_EXPOSE_ALL_STREAMS;
1055 decode_bin->connection_speed = DEFAULT_CONNECTION_SPEED;
1059 gst_decode_bin_dispose (GObject * object)
1061 GstDecodeBin *decode_bin;
1063 decode_bin = GST_DECODE_BIN (object);
1065 if (decode_bin->factories)
1066 gst_plugin_feature_list_free (decode_bin->factories);
1067 decode_bin->factories = NULL;
1069 if (decode_bin->decode_chain)
1070 gst_decode_chain_free (decode_bin->decode_chain);
1071 decode_bin->decode_chain = NULL;
1073 if (decode_bin->caps)
1074 gst_caps_unref (decode_bin->caps);
1075 decode_bin->caps = NULL;
1077 g_free (decode_bin->encoding);
1078 decode_bin->encoding = NULL;
1080 g_list_free (decode_bin->subtitles);
1081 decode_bin->subtitles = NULL;
1083 G_OBJECT_CLASS (parent_class)->dispose (object);
1087 gst_decode_bin_finalize (GObject * object)
1089 GstDecodeBin *decode_bin;
1091 decode_bin = GST_DECODE_BIN (object);
1093 g_mutex_clear (&decode_bin->expose_lock);
1094 g_mutex_clear (&decode_bin->dyn_lock);
1095 g_mutex_clear (&decode_bin->subtitle_lock);
1096 g_mutex_clear (&decode_bin->factories_lock);
1098 G_OBJECT_CLASS (parent_class)->finalize (object);
1102 * Changes the caps on which decodebin will stop decoding.
1103 * Will unref the previously set one. The refcount of the given caps will be
1105 * @caps can be NULL.
1110 gst_decode_bin_set_caps (GstDecodeBin * dbin, GstCaps * caps)
1112 GST_DEBUG_OBJECT (dbin, "Setting new caps: %" GST_PTR_FORMAT, caps);
1114 GST_OBJECT_LOCK (dbin);
1115 gst_caps_replace (&dbin->caps, caps);
1116 GST_OBJECT_UNLOCK (dbin);
1120 * Returns the currently configured caps on which decodebin will stop decoding.
1121 * The returned caps (if not NULL), will have its refcount incremented.
1126 gst_decode_bin_get_caps (GstDecodeBin * dbin)
1130 GST_DEBUG_OBJECT (dbin, "Getting currently set caps");
1132 GST_OBJECT_LOCK (dbin);
1135 gst_caps_ref (caps);
1136 GST_OBJECT_UNLOCK (dbin);
1142 gst_decode_bin_set_sink_caps (GstDecodeBin * dbin, GstCaps * caps)
1144 GST_DEBUG_OBJECT (dbin, "Setting new caps: %" GST_PTR_FORMAT, caps);
1146 g_object_set (dbin->typefind, "force-caps", caps, NULL);
1150 gst_decode_bin_get_sink_caps (GstDecodeBin * dbin)
1154 GST_DEBUG_OBJECT (dbin, "Getting currently set caps");
1156 g_object_get (dbin->typefind, "force-caps", &caps, NULL);
1162 gst_decode_bin_set_subs_encoding (GstDecodeBin * dbin, const gchar * encoding)
1166 GST_DEBUG_OBJECT (dbin, "Setting new encoding: %s", GST_STR_NULL (encoding));
1168 SUBTITLE_LOCK (dbin);
1169 g_free (dbin->encoding);
1170 dbin->encoding = g_strdup (encoding);
1172 /* set the subtitle encoding on all added elements */
1173 for (walk = dbin->subtitles; walk; walk = g_list_next (walk)) {
1174 g_object_set (G_OBJECT (walk->data), "subtitle-encoding", dbin->encoding,
1177 SUBTITLE_UNLOCK (dbin);
1181 gst_decode_bin_get_subs_encoding (GstDecodeBin * dbin)
1185 GST_DEBUG_OBJECT (dbin, "Getting currently set encoding");
1187 SUBTITLE_LOCK (dbin);
1188 encoding = g_strdup (dbin->encoding);
1189 SUBTITLE_UNLOCK (dbin);
1195 gst_decode_bin_set_property (GObject * object, guint prop_id,
1196 const GValue * value, GParamSpec * pspec)
1200 dbin = GST_DECODE_BIN (object);
1204 gst_decode_bin_set_caps (dbin, g_value_get_boxed (value));
1206 case PROP_SUBTITLE_ENCODING:
1207 gst_decode_bin_set_subs_encoding (dbin, g_value_get_string (value));
1209 case PROP_SINK_CAPS:
1210 gst_decode_bin_set_sink_caps (dbin, g_value_get_boxed (value));
1212 case PROP_USE_BUFFERING:
1213 dbin->use_buffering = g_value_get_boolean (value);
1215 case PROP_LOW_PERCENT:
1216 dbin->low_percent = g_value_get_int (value);
1218 case PROP_HIGH_PERCENT:
1219 dbin->high_percent = g_value_get_int (value);
1221 case PROP_MAX_SIZE_BYTES:
1222 dbin->max_size_bytes = g_value_get_uint (value);
1224 case PROP_MAX_SIZE_BUFFERS:
1225 dbin->max_size_buffers = g_value_get_uint (value);
1227 case PROP_MAX_SIZE_TIME:
1228 dbin->max_size_time = g_value_get_uint64 (value);
1230 case PROP_POST_STREAM_TOPOLOGY:
1231 dbin->post_stream_topology = g_value_get_boolean (value);
1233 case PROP_EXPOSE_ALL_STREAMS:
1234 dbin->expose_allstreams = g_value_get_boolean (value);
1236 case PROP_CONNECTION_SPEED:
1237 GST_OBJECT_LOCK (dbin);
1238 dbin->connection_speed = g_value_get_uint64 (value) * 1000;
1239 GST_OBJECT_UNLOCK (dbin);
1242 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1248 gst_decode_bin_get_property (GObject * object, guint prop_id,
1249 GValue * value, GParamSpec * pspec)
1253 dbin = GST_DECODE_BIN (object);
1256 g_value_take_boxed (value, gst_decode_bin_get_caps (dbin));
1258 case PROP_SUBTITLE_ENCODING:
1259 g_value_take_string (value, gst_decode_bin_get_subs_encoding (dbin));
1261 case PROP_SINK_CAPS:
1262 g_value_take_boxed (value, gst_decode_bin_get_sink_caps (dbin));
1264 case PROP_USE_BUFFERING:
1265 g_value_set_boolean (value, dbin->use_buffering);
1267 case PROP_LOW_PERCENT:
1268 g_value_set_int (value, dbin->low_percent);
1270 case PROP_HIGH_PERCENT:
1271 g_value_set_int (value, dbin->high_percent);
1273 case PROP_MAX_SIZE_BYTES:
1274 g_value_set_uint (value, dbin->max_size_bytes);
1276 case PROP_MAX_SIZE_BUFFERS:
1277 g_value_set_uint (value, dbin->max_size_buffers);
1279 case PROP_MAX_SIZE_TIME:
1280 g_value_set_uint64 (value, dbin->max_size_time);
1282 case PROP_POST_STREAM_TOPOLOGY:
1283 g_value_set_boolean (value, dbin->post_stream_topology);
1285 case PROP_EXPOSE_ALL_STREAMS:
1286 g_value_set_boolean (value, dbin->expose_allstreams);
1288 case PROP_CONNECTION_SPEED:
1289 GST_OBJECT_LOCK (dbin);
1290 g_value_set_uint64 (value, dbin->connection_speed / 1000);
1291 GST_OBJECT_UNLOCK (dbin);
1294 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1301 * Default autoplug signal handlers
1304 gst_decode_bin_autoplug_continue (GstElement * element, GstPad * pad,
1307 GST_DEBUG_OBJECT (element, "autoplug-continue returns TRUE");
1309 /* by default we always continue */
1313 static GValueArray *
1314 gst_decode_bin_autoplug_factories (GstElement * element, GstPad * pad,
1318 GValueArray *result;
1319 GstDecodeBin *dbin = GST_DECODE_BIN_CAST (element);
1321 GST_DEBUG_OBJECT (element, "finding factories");
1323 /* return all compatible factories for caps */
1324 g_mutex_lock (&dbin->factories_lock);
1325 gst_decode_bin_update_factories_list (dbin);
1327 gst_element_factory_list_filter (dbin->factories, caps, GST_PAD_SINK,
1329 g_mutex_unlock (&dbin->factories_lock);
1331 result = g_value_array_new (g_list_length (list));
1332 for (tmp = list; tmp; tmp = tmp->next) {
1333 GstElementFactory *factory = GST_ELEMENT_FACTORY_CAST (tmp->data);
1334 GValue val = { 0, };
1336 g_value_init (&val, G_TYPE_OBJECT);
1337 g_value_set_object (&val, factory);
1338 g_value_array_append (result, &val);
1339 g_value_unset (&val);
1341 gst_plugin_feature_list_free (list);
1343 GST_DEBUG_OBJECT (element, "autoplug-factories returns %p", result);
1348 static GValueArray *
1349 gst_decode_bin_autoplug_sort (GstElement * element, GstPad * pad,
1350 GstCaps * caps, GValueArray * factories)
1355 static GstAutoplugSelectResult
1356 gst_decode_bin_autoplug_select (GstElement * element, GstPad * pad,
1357 GstCaps * caps, GstElementFactory * factory)
1359 GST_DEBUG_OBJECT (element, "default autoplug-select returns TRY");
1362 return GST_AUTOPLUG_SELECT_TRY;
1369 static gboolean are_final_caps (GstDecodeBin * dbin, GstCaps * caps);
1370 static gboolean is_demuxer_element (GstElement * srcelement);
1372 static gboolean connect_pad (GstDecodeBin * dbin, GstElement * src,
1373 GstDecodePad * dpad, GstPad * pad, GstCaps * caps, GValueArray * factories,
1374 GstDecodeChain * chain);
1375 static gboolean connect_element (GstDecodeBin * dbin, GstElement * element,
1376 GstDecodeChain * chain);
1377 static void expose_pad (GstDecodeBin * dbin, GstElement * src,
1378 GstDecodePad * dpad, GstPad * pad, GstCaps * caps, GstDecodeChain * chain);
1380 static void pad_added_cb (GstElement * element, GstPad * pad,
1381 GstDecodeChain * chain);
1382 static void pad_removed_cb (GstElement * element, GstPad * pad,
1383 GstDecodeChain * chain);
1384 static void no_more_pads_cb (GstElement * element, GstDecodeChain * chain);
1386 static GstDecodeGroup *gst_decode_chain_get_current_group (GstDecodeChain *
1389 /* called when a new pad is discovered. It will perform some basic actions
1390 * before trying to link something to it.
1392 * - Check the caps, don't do anything when there are no caps or when they have
1394 * - signal AUTOPLUG_CONTINUE to check if we need to continue autoplugging this
1396 * - if the caps are non-fixed, setup a handler to continue autoplugging when
1397 * the caps become fixed (connect to notify::caps).
1398 * - get list of factories to autoplug.
1399 * - continue autoplugging to one of the factories.
1402 analyze_new_pad (GstDecodeBin * dbin, GstElement * src, GstPad * pad,
1403 GstCaps * caps, GstDecodeChain * chain)
1405 gboolean apcontinue = TRUE;
1406 GValueArray *factories = NULL, *result = NULL;
1408 GstElementFactory *factory;
1409 const gchar *classification;
1410 gboolean is_parser_converter = FALSE;
1413 GST_DEBUG_OBJECT (dbin, "Pad %s:%s caps:%" GST_PTR_FORMAT,
1414 GST_DEBUG_PAD_NAME (pad), caps);
1417 && src != ((GstDecodeElement *) chain->elements->data)->element
1418 && src != ((GstDecodeElement *) chain->elements->data)->capsfilter) {
1419 GST_ERROR_OBJECT (dbin, "New pad from not the last element in this chain");
1423 if (chain->endpad) {
1424 GST_ERROR_OBJECT (dbin, "New pad in a chain that is already complete");
1428 if (chain->demuxer) {
1429 GstDecodeGroup *group;
1430 GstDecodeChain *oldchain = chain;
1432 /* we are adding a new pad for a demuxer (see is_demuxer_element(),
1433 * start a new chain for it */
1434 CHAIN_MUTEX_LOCK (oldchain);
1435 group = gst_decode_chain_get_current_group (chain);
1436 if (group && !g_list_find (group->children, chain)) {
1437 chain = gst_decode_chain_new (dbin, group, pad);
1438 group->children = g_list_prepend (group->children, chain);
1440 CHAIN_MUTEX_UNLOCK (oldchain);
1442 GST_WARNING_OBJECT (dbin, "No current group");
1447 if ((caps == NULL) || gst_caps_is_empty (caps))
1450 if (gst_caps_is_any (caps))
1453 dpad = gst_decode_pad_new (dbin, pad, chain);
1455 /* 1. Emit 'autoplug-continue' the result will tell us if this pads needs
1456 * further autoplugging. Only do this for fixed caps, for unfixed caps
1457 * we will later come here again from the notify::caps handler. The
1458 * problem with unfixed caps is that we can reliably tell if the output
1459 * is e.g. accepted by a sink because only parts of the possible final
1460 * caps might be accepted by the sink. */
1461 if (gst_caps_is_fixed (caps))
1462 g_signal_emit (G_OBJECT (dbin),
1463 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, dpad, caps,
1468 /* 1.a if autoplug-continue is FALSE or caps is a raw format, goto pad_is_final */
1469 if ((!apcontinue) || are_final_caps (dbin, caps))
1472 /* 1.b For Parser/Converter that can output different stream formats
1473 * we insert a capsfilter with the sorted caps of all possible next
1474 * elements and continue with the capsfilter srcpad */
1475 factory = gst_element_get_factory (src);
1477 gst_element_factory_get_metadata (factory, GST_ELEMENT_METADATA_KLASS);
1478 is_parser_converter = (strstr (classification, "Parser")
1479 && strstr (classification, "Converter"));
1481 /* 1.c when the caps are not fixed yet, we can't be sure what element to
1482 * connect. We delay autoplugging until the caps are fixed */
1483 if (!is_parser_converter && !gst_caps_is_fixed (caps))
1486 /* 1.d else get the factories and if there's no compatible factory goto
1488 g_signal_emit (G_OBJECT (dbin),
1489 gst_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES], 0, dpad, caps,
1492 /* NULL means that we can expose the pad */
1493 if (factories == NULL)
1496 /* if the array is empty, we have a type for which we have no decoder */
1497 if (factories->n_values == 0) {
1498 if (!dbin->expose_allstreams) {
1499 GstCaps *raw = gst_static_caps_get (&default_raw_caps);
1501 /* If the caps are raw, this just means we don't want to expose them */
1502 if (gst_caps_can_intersect (raw, caps)) {
1503 g_value_array_free (factories);
1504 gst_caps_unref (raw);
1505 gst_object_unref (dpad);
1506 goto discarded_type;
1508 gst_caps_unref (raw);
1511 /* if not we have a unhandled type with no compatible factories */
1512 g_value_array_free (factories);
1513 gst_object_unref (dpad);
1517 /* 1.e sort some more. */
1518 g_signal_emit (G_OBJECT (dbin),
1519 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SORT], 0, dpad, caps, factories,
1522 g_value_array_free (factories);
1526 /* At this point we have a potential decoder, but we might not need it
1527 * if it doesn't match the output caps */
1528 if (!dbin->expose_allstreams && gst_caps_is_fixed (caps)) {
1531 gboolean dontuse = FALSE;
1533 GST_DEBUG ("Checking if we can abort early");
1535 /* 1.f Do an early check to see if the candidates are potential decoders, but
1536 * due to the fact that they decode to a mediatype that is not final we don't
1539 for (i = 0; i < factories->n_values && !dontuse; i++) {
1540 GstElementFactory *factory =
1541 g_value_get_object (g_value_array_get_nth (factories, i));
1544 /* We are only interested in skipping decoders */
1545 if (strstr (gst_element_factory_get_metadata (factory,
1546 GST_ELEMENT_METADATA_KLASS), "Decoder")) {
1548 GST_DEBUG ("Trying factory %s",
1549 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1551 /* Check the source pad template caps to see if they match raw caps but don't match
1553 for (tmps = gst_element_factory_get_static_pad_templates (factory);
1554 tmps && !dontuse; tmps = tmps->next) {
1555 GstStaticPadTemplate *st = (GstStaticPadTemplate *) tmps->data;
1556 if (st->direction != GST_PAD_SRC)
1558 tcaps = gst_static_pad_template_get_caps (st);
1562 /* Emit autoplug-continue to see if the caps are considered to be raw caps */
1563 g_signal_emit (G_OBJECT (dbin),
1564 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, dpad, tcaps,
1567 /* If autoplug-continue returns TRUE and the caps are not final, don't use them */
1568 if (apcontinue && !are_final_caps (dbin, tcaps))
1570 gst_caps_unref (tcaps);
1576 gst_object_unref (dpad);
1577 g_value_array_free (factories);
1578 goto discarded_type;
1582 /* 1.g now get the factory template caps and insert the capsfilter if this
1583 * is a parser/converter
1585 if (is_parser_converter) {
1586 GstCaps *filter_caps;
1589 GstDecodeElement *delem;
1591 g_assert (chain->elements != NULL);
1592 delem = (GstDecodeElement *) chain->elements->data;
1594 filter_caps = gst_caps_new_empty ();
1595 for (i = 0; i < factories->n_values; i++) {
1596 GstElementFactory *factory =
1597 g_value_get_object (g_value_array_get_nth (factories, i));
1598 GstCaps *tcaps, *intersection;
1601 GST_DEBUG ("Trying factory %s",
1602 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1604 if (gst_element_get_factory (src) == factory) {
1605 GST_DEBUG ("Skipping factory");
1609 for (tmps = gst_element_factory_get_static_pad_templates (factory); tmps;
1610 tmps = tmps->next) {
1611 GstStaticPadTemplate *st = (GstStaticPadTemplate *) tmps->data;
1612 if (st->direction != GST_PAD_SINK || st->presence != GST_PAD_ALWAYS)
1614 tcaps = gst_static_pad_template_get_caps (st);
1616 gst_caps_intersect_full (tcaps, caps, GST_CAPS_INTERSECT_FIRST);
1617 filter_caps = gst_caps_merge (filter_caps, intersection);
1618 gst_caps_unref (tcaps);
1622 /* Append the parser caps to prevent any not-negotiated errors */
1623 filter_caps = gst_caps_merge (filter_caps, gst_caps_ref (caps));
1625 delem->capsfilter = gst_element_factory_make ("capsfilter", NULL);
1626 g_object_set (G_OBJECT (delem->capsfilter), "caps", filter_caps, NULL);
1627 gst_caps_unref (filter_caps);
1628 gst_element_set_state (delem->capsfilter, GST_STATE_PAUSED);
1629 gst_bin_add (GST_BIN_CAST (dbin), gst_object_ref (delem->capsfilter));
1631 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1632 p = gst_element_get_static_pad (delem->capsfilter, "sink");
1633 gst_pad_link_full (pad, p, GST_PAD_LINK_CHECK_NOTHING);
1634 gst_object_unref (p);
1635 p = gst_element_get_static_pad (delem->capsfilter, "src");
1636 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), p);
1639 if (!gst_caps_is_fixed (caps)) {
1640 g_value_array_free (factories);
1645 /* 1.h else continue autoplugging something from the list. */
1646 GST_LOG_OBJECT (pad, "Let's continue discovery on this pad");
1647 res = connect_pad (dbin, src, dpad, pad, caps, factories, chain);
1649 /* Need to unref the capsfilter srcpad here if
1650 * we inserted a capsfilter */
1651 if (is_parser_converter)
1652 gst_object_unref (pad);
1654 gst_object_unref (dpad);
1655 g_value_array_free (factories);
1664 GST_LOG_OBJECT (dbin, "Pad is final. autoplug-continue:%d", apcontinue);
1665 expose_pad (dbin, src, dpad, pad, caps, chain);
1666 gst_object_unref (dpad);
1672 GST_LOG_OBJECT (pad, "Known type, but discarded because not final caps");
1673 chain->deadend = TRUE;
1674 chain->endcaps = gst_caps_ref (caps);
1676 /* Try to expose anything */
1678 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
1679 gst_decode_bin_expose (dbin);
1681 EXPOSE_UNLOCK (dbin);
1682 do_async_done (dbin);
1689 GST_LOG_OBJECT (pad, "Unknown type, posting message and firing signal");
1691 chain->deadend = TRUE;
1692 chain->endcaps = gst_caps_ref (caps);
1694 gst_element_post_message (GST_ELEMENT_CAST (dbin),
1695 gst_missing_decoder_message_new (GST_ELEMENT_CAST (dbin), caps));
1697 g_signal_emit (G_OBJECT (dbin),
1698 gst_decode_bin_signals[SIGNAL_UNKNOWN_TYPE], 0, pad, caps);
1700 /* Try to expose anything */
1702 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
1703 gst_decode_bin_expose (dbin);
1705 EXPOSE_UNLOCK (dbin);
1707 if (src == dbin->typefind) {
1710 if (caps && !gst_caps_is_empty (caps)) {
1711 desc = gst_pb_utils_get_decoder_description (caps);
1712 GST_ELEMENT_ERROR (dbin, STREAM, CODEC_NOT_FOUND,
1713 (_("A %s plugin is required to play this stream, "
1714 "but not installed."), desc),
1715 ("No decoder to handle media type '%s'",
1716 gst_structure_get_name (gst_caps_get_structure (caps, 0))));
1719 GST_ELEMENT_ERROR (dbin, STREAM, TYPE_NOT_FOUND,
1720 (_("Could not determine type of stream")),
1721 ("Stream caps %" GST_PTR_FORMAT, caps));
1723 do_async_done (dbin);
1729 GST_DEBUG_OBJECT (pad, "pad has non-fixed caps delay autoplugging");
1730 gst_object_unref (dpad);
1731 goto setup_caps_delay;
1735 GST_DEBUG_OBJECT (pad, "pad has ANY caps, delaying auto-pluggin");
1736 goto setup_caps_delay;
1740 GstPendingPad *ppad;
1742 /* connect to caps notification */
1743 CHAIN_MUTEX_LOCK (chain);
1744 GST_LOG_OBJECT (dbin, "Chain %p has now %d dynamic pads", chain,
1745 g_list_length (chain->pending_pads));
1746 ppad = g_slice_new0 (GstPendingPad);
1747 ppad->pad = gst_object_ref (pad);
1748 ppad->chain = chain;
1749 ppad->event_probe_id =
1750 gst_pad_add_probe (pad, GST_PAD_PROBE_TYPE_EVENT_DOWNSTREAM,
1751 pad_event_cb, ppad, NULL);
1752 chain->pending_pads = g_list_prepend (chain->pending_pads, ppad);
1753 g_signal_connect (G_OBJECT (pad), "notify::caps",
1754 G_CALLBACK (caps_notify_cb), chain);
1755 CHAIN_MUTEX_UNLOCK (chain);
1757 /* If we're here because we have a Parser/Converter
1758 * we have to unref the pad */
1759 if (is_parser_converter)
1760 gst_object_unref (pad);
1767 add_error_filter (GstDecodeBin * dbin, GstElement * element)
1769 GST_OBJECT_LOCK (dbin);
1770 dbin->filtered = g_list_prepend (dbin->filtered, element);
1771 GST_OBJECT_UNLOCK (dbin);
1775 remove_error_filter (GstDecodeBin * dbin, GstElement * element)
1777 GST_OBJECT_LOCK (dbin);
1778 dbin->filtered = g_list_remove (dbin->filtered, element);
1779 GST_OBJECT_UNLOCK (dbin);
1784 * Try to connect the given pad to an element created from one of the factories,
1787 * Note that dpad is ghosting pad, and so pad is linked; be sure to unset dpad's
1788 * target before trying to link pad.
1790 * Returns TRUE if an element was properly created and linked
1793 connect_pad (GstDecodeBin * dbin, GstElement * src, GstDecodePad * dpad,
1794 GstPad * pad, GstCaps * caps, GValueArray * factories,
1795 GstDecodeChain * chain)
1797 gboolean res = FALSE;
1798 GstPad *mqpad = NULL;
1799 gboolean is_demuxer = chain->parent && !chain->elements; /* First pad after the demuxer */
1801 g_return_val_if_fail (factories != NULL, FALSE);
1802 g_return_val_if_fail (factories->n_values > 0, FALSE);
1804 GST_DEBUG_OBJECT (dbin,
1805 "pad %s:%s , chain:%p, %d factories, caps %" GST_PTR_FORMAT,
1806 GST_DEBUG_PAD_NAME (pad), chain, factories->n_values, caps);
1808 /* 1. is element demuxer or parser */
1810 GST_LOG_OBJECT (src,
1811 "is a demuxer, connecting the pad through multiqueue '%s'",
1812 GST_OBJECT_NAME (chain->parent->multiqueue));
1814 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1815 if (!(mqpad = gst_decode_group_control_demuxer_pad (chain->parent, pad)))
1817 src = chain->parent->multiqueue;
1819 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
1822 /* 2. Try to create an element and link to it */
1823 while (factories->n_values > 0) {
1824 GstAutoplugSelectResult ret;
1825 GstElementFactory *factory;
1826 GstDecodeElement *delem;
1827 GstElement *element;
1832 /* Set dpad target to pad again, it might've been unset
1833 * below but we came back here because something failed
1835 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
1837 /* take first factory */
1838 factory = g_value_get_object (g_value_array_get_nth (factories, 0));
1839 /* Remove selected factory from the list. */
1840 g_value_array_remove (factories, 0);
1842 GST_LOG_OBJECT (src, "trying factory %" GST_PTR_FORMAT, factory);
1844 /* Check if the caps are really supported by the factory. The
1845 * factory list is non-empty-subset filtered while caps
1846 * are only accepted by a pad if they are a subset of the
1849 * FIXME: Only do this for fixed caps here. Non-fixed caps
1850 * can happen if a Parser/Converter was autoplugged before
1851 * this. We then assume that it will be able to convert to
1852 * everything that the decoder would want.
1854 * A subset check will fail here because the parser caps
1855 * will be generic and while the decoder will only
1856 * support a subset of the parser caps.
1858 if (gst_caps_is_fixed (caps)) {
1859 const GList *templs;
1860 gboolean skip = FALSE;
1862 templs = gst_element_factory_get_static_pad_templates (factory);
1865 GstStaticPadTemplate *templ = (GstStaticPadTemplate *) templs->data;
1867 if (templ->direction == GST_PAD_SINK) {
1868 GstCaps *templcaps = gst_static_caps_get (&templ->static_caps);
1870 if (!gst_caps_is_subset (caps, templcaps)) {
1871 GST_DEBUG_OBJECT (src,
1872 "caps %" GST_PTR_FORMAT " not subset of %" GST_PTR_FORMAT, caps,
1874 gst_caps_unref (templcaps);
1879 gst_caps_unref (templcaps);
1881 templs = g_list_next (templs);
1887 /* If the factory is for a parser we first check if the factory
1888 * was already used for the current chain. If it was used already
1889 * we would otherwise create an infinite loop here because the
1890 * parser apparently accepts its own output as input.
1891 * This is only done for parsers because it's perfectly valid
1892 * to have other element classes after each other because a
1893 * parser is the only one that does not change the data. A
1894 * valid example for this would be multiple id3demux in a row.
1896 if (strstr (gst_element_factory_get_metadata (factory,
1897 GST_ELEMENT_METADATA_KLASS), "Parser")) {
1898 gboolean skip = FALSE;
1901 CHAIN_MUTEX_LOCK (chain);
1902 for (l = chain->elements; l; l = l->next) {
1903 GstDecodeElement *delem = (GstDecodeElement *) l->data;
1904 GstElement *otherelement = delem->element;
1906 if (gst_element_get_factory (otherelement) == factory) {
1911 CHAIN_MUTEX_UNLOCK (chain);
1913 GST_DEBUG_OBJECT (dbin,
1914 "Skipping factory '%s' because it was already used in this chain",
1915 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE_CAST (factory)));
1920 /* emit autoplug-select to see what we should do with it. */
1921 g_signal_emit (G_OBJECT (dbin),
1922 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT],
1923 0, dpad, caps, factory, &ret);
1926 case GST_AUTOPLUG_SELECT_TRY:
1927 GST_DEBUG_OBJECT (dbin, "autoplug select requested try");
1929 case GST_AUTOPLUG_SELECT_EXPOSE:
1930 GST_DEBUG_OBJECT (dbin, "autoplug select requested expose");
1931 /* expose the pad, we don't have the source element */
1932 expose_pad (dbin, src, dpad, pad, caps, chain);
1935 case GST_AUTOPLUG_SELECT_SKIP:
1936 GST_DEBUG_OBJECT (dbin, "autoplug select requested skip");
1939 GST_WARNING_OBJECT (dbin, "autoplug select returned unhandled %d", ret);
1943 /* 2.0. Unlink pad */
1944 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1946 /* 2.1. Try to create an element */
1947 if ((element = gst_element_factory_create (factory, NULL)) == NULL) {
1948 GST_WARNING_OBJECT (dbin, "Could not create an element from %s",
1949 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1953 /* Filter errors, this will prevent the element from causing the pipeline
1954 * to error while we test it using READY state. */
1955 add_error_filter (dbin, element);
1957 /* ... add it ... */
1958 if (!(gst_bin_add (GST_BIN_CAST (dbin), element))) {
1959 GST_WARNING_OBJECT (dbin, "Couldn't add %s to the bin",
1960 GST_ELEMENT_NAME (element));
1961 remove_error_filter (dbin, element);
1962 gst_object_unref (element);
1966 /* Find its sink pad. */
1967 if (!(sinkpad = find_sink_pad (element))) {
1968 GST_WARNING_OBJECT (dbin, "Element %s doesn't have a sink pad",
1969 GST_ELEMENT_NAME (element));
1970 remove_error_filter (dbin, element);
1971 gst_bin_remove (GST_BIN (dbin), element);
1975 /* ... and try to link */
1976 if ((gst_pad_link (pad, sinkpad)) != GST_PAD_LINK_OK) {
1977 GST_WARNING_OBJECT (dbin, "Link failed on pad %s:%s",
1978 GST_DEBUG_PAD_NAME (sinkpad));
1979 remove_error_filter (dbin, element);
1980 gst_object_unref (sinkpad);
1981 gst_bin_remove (GST_BIN (dbin), element);
1985 /* ... activate it ... */
1986 if ((gst_element_set_state (element,
1987 GST_STATE_READY)) == GST_STATE_CHANGE_FAILURE) {
1988 GST_WARNING_OBJECT (dbin, "Couldn't set %s to READY",
1989 GST_ELEMENT_NAME (element));
1990 remove_error_filter (dbin, element);
1991 gst_object_unref (sinkpad);
1992 gst_bin_remove (GST_BIN (dbin), element);
1996 /* Stop filtering errors. */
1997 remove_error_filter (dbin, element);
1999 /* check if we still accept the caps on the pad after setting
2000 * the element to READY */
2001 if (!gst_pad_query_accept_caps (sinkpad, caps)) {
2002 GST_WARNING_OBJECT (dbin, "Element %s does not accept caps",
2003 GST_ELEMENT_NAME (element));
2004 gst_element_set_state (element, GST_STATE_NULL);
2005 gst_object_unref (sinkpad);
2006 gst_bin_remove (GST_BIN (dbin), element);
2010 gst_object_unref (sinkpad);
2011 GST_LOG_OBJECT (dbin, "linked on pad %s:%s", GST_DEBUG_PAD_NAME (pad));
2013 CHAIN_MUTEX_LOCK (chain);
2014 delem = g_slice_new (GstDecodeElement);
2015 delem->element = gst_object_ref (element);
2016 delem->capsfilter = NULL;
2017 chain->elements = g_list_prepend (chain->elements, delem);
2018 chain->demuxer = is_demuxer_element (element);
2019 CHAIN_MUTEX_UNLOCK (chain);
2021 /* Set connection-speed property if needed */
2022 if (chain->demuxer == TRUE) {
2025 if ((pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (element),
2026 "connection-speed"))) {
2027 guint64 speed = dbin->connection_speed / 1000;
2028 gboolean wrong_type = FALSE;
2030 if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_UINT) {
2031 GParamSpecUInt *pspecuint = G_PARAM_SPEC_UINT (pspec);
2033 speed = CLAMP (speed, pspecuint->minimum, pspecuint->maximum);
2034 } else if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_INT) {
2035 GParamSpecInt *pspecint = G_PARAM_SPEC_INT (pspec);
2037 speed = CLAMP (speed, pspecint->minimum, pspecint->maximum);
2038 } else if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_UINT64) {
2039 GParamSpecUInt64 *pspecuint = G_PARAM_SPEC_UINT64 (pspec);
2041 speed = CLAMP (speed, pspecuint->minimum, pspecuint->maximum);
2042 } else if (G_PARAM_SPEC_TYPE (pspec) == G_TYPE_PARAM_INT64) {
2043 GParamSpecInt64 *pspecint = G_PARAM_SPEC_INT64 (pspec);
2045 speed = CLAMP (speed, pspecint->minimum, pspecint->maximum);
2047 GST_WARNING_OBJECT (dbin,
2048 "The connection speed property %" G_GUINT64_FORMAT " of type %s"
2049 " is not usefull not setting it", speed,
2050 g_type_name (G_PARAM_SPEC_TYPE (pspec)));
2054 if (wrong_type == FALSE) {
2055 GST_DEBUG_OBJECT (dbin, "setting connection-speed=%" G_GUINT64_FORMAT
2056 " to demuxer element", speed);
2058 g_object_set (element, "connection-speed", speed, NULL);
2063 /* link this element further */
2064 connect_element (dbin, element, chain);
2066 /* try to configure the subtitle encoding property when we can */
2067 pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (element),
2068 "subtitle-encoding");
2069 if (pspec && G_PARAM_SPEC_VALUE_TYPE (pspec) == G_TYPE_STRING) {
2070 SUBTITLE_LOCK (dbin);
2071 GST_DEBUG_OBJECT (dbin,
2072 "setting subtitle-encoding=%s to element", dbin->encoding);
2073 g_object_set (G_OBJECT (element), "subtitle-encoding", dbin->encoding,
2075 SUBTITLE_UNLOCK (dbin);
2081 /* Bring the element to the state of the parent */
2082 if ((gst_element_set_state (element,
2083 GST_STATE_PAUSED)) == GST_STATE_CHANGE_FAILURE) {
2084 GstDecodeElement *dtmp = NULL;
2085 GstElement *tmp = NULL;
2087 GST_WARNING_OBJECT (dbin, "Couldn't set %s to PAUSED",
2088 GST_ELEMENT_NAME (element));
2090 /* Remove all elements in this chain that were just added. No
2091 * other thread could've added elements in the meantime */
2092 CHAIN_MUTEX_LOCK (chain);
2096 dtmp = chain->elements->data;
2097 tmp = dtmp->element;
2099 /* Disconnect any signal handlers that might be connected
2100 * in connect_element() or analyze_pad() */
2101 g_signal_handlers_disconnect_by_func (tmp, pad_added_cb, chain);
2102 g_signal_handlers_disconnect_by_func (tmp, pad_removed_cb, chain);
2103 g_signal_handlers_disconnect_by_func (tmp, no_more_pads_cb, chain);
2105 for (l = chain->pending_pads; l;) {
2106 GstPendingPad *pp = l->data;
2109 if (GST_PAD_PARENT (pp->pad) != tmp) {
2114 g_signal_handlers_disconnect_by_func (pp->pad, caps_notify_cb, chain);
2115 gst_pad_remove_probe (pp->pad, pp->event_probe_id);
2116 gst_object_unref (pp->pad);
2117 g_slice_free (GstPendingPad, pp);
2119 /* Remove element from the list, update list head and go to the
2120 * next element in the list */
2122 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2126 if (dtmp->capsfilter) {
2127 gst_bin_remove (GST_BIN (dbin), dtmp->capsfilter);
2128 gst_element_set_state (dtmp->capsfilter, GST_STATE_NULL);
2129 gst_object_unref (dtmp->capsfilter);
2132 gst_bin_remove (GST_BIN (dbin), tmp);
2133 gst_element_set_state (tmp, GST_STATE_NULL);
2135 gst_object_unref (tmp);
2136 g_slice_free (GstDecodeElement, dtmp);
2138 chain->elements = g_list_delete_link (chain->elements, chain->elements);
2139 } while (tmp != element);
2140 CHAIN_MUTEX_UNLOCK (chain);
2145 SUBTITLE_LOCK (dbin);
2146 /* we added the element now, add it to the list of subtitle-encoding
2147 * elements when we can set the property */
2148 dbin->subtitles = g_list_prepend (dbin->subtitles, element);
2149 SUBTITLE_UNLOCK (dbin);
2158 gst_object_unref (mqpad);
2164 get_pad_caps (GstPad * pad)
2168 /* first check the pad caps, if this is set, we are positively sure it is
2169 * fixed and exactly what the element will produce. */
2170 caps = gst_pad_get_current_caps (pad);
2172 /* then use the getcaps function if we don't have caps. These caps might not
2173 * be fixed in some cases, in which case analyze_new_pad will set up a
2174 * notify::caps signal to continue autoplugging. */
2176 caps = gst_pad_query_caps (pad, NULL);
2182 connect_element (GstDecodeBin * dbin, GstElement * element,
2183 GstDecodeChain * chain)
2186 gboolean res = TRUE;
2187 gboolean dynamic = FALSE;
2188 GList *to_connect = NULL;
2190 GST_DEBUG_OBJECT (dbin, "Attempting to connect element %s [chain:%p] further",
2191 GST_ELEMENT_NAME (element), chain);
2193 /* 1. Loop over pad templates, grabbing existing pads along the way */
2194 for (pads = GST_ELEMENT_GET_CLASS (element)->padtemplates; pads;
2195 pads = g_list_next (pads)) {
2196 GstPadTemplate *templ = GST_PAD_TEMPLATE (pads->data);
2197 const gchar *templ_name;
2199 /* we are only interested in source pads */
2200 if (GST_PAD_TEMPLATE_DIRECTION (templ) != GST_PAD_SRC)
2203 templ_name = GST_PAD_TEMPLATE_NAME_TEMPLATE (templ);
2204 GST_DEBUG_OBJECT (dbin, "got a source pad template %s", templ_name);
2206 /* figure out what kind of pad this is */
2207 switch (GST_PAD_TEMPLATE_PRESENCE (templ)) {
2208 case GST_PAD_ALWAYS:
2210 /* get the pad that we need to autoplug */
2211 GstPad *pad = gst_element_get_static_pad (element, templ_name);
2214 GST_DEBUG_OBJECT (dbin, "got the pad for always template %s",
2216 /* here is the pad, we need to autoplug it */
2217 to_connect = g_list_prepend (to_connect, pad);
2219 /* strange, pad is marked as always but it's not
2220 * there. Fix the element */
2221 GST_WARNING_OBJECT (dbin,
2222 "could not get the pad for always template %s", templ_name);
2226 case GST_PAD_SOMETIMES:
2228 /* try to get the pad to see if it is already created or
2230 GstPad *pad = gst_element_get_static_pad (element, templ_name);
2233 GST_DEBUG_OBJECT (dbin, "got the pad for sometimes template %s",
2235 /* the pad is created, we need to autoplug it */
2236 to_connect = g_list_prepend (to_connect, pad);
2238 GST_DEBUG_OBJECT (dbin,
2239 "did not get the sometimes pad of template %s", templ_name);
2240 /* we have an element that will create dynamic pads */
2245 case GST_PAD_REQUEST:
2246 /* ignore request pads */
2247 GST_DEBUG_OBJECT (dbin, "ignoring request padtemplate %s", templ_name);
2252 /* 2. if there are more potential pads, connect to relevant signals */
2254 GST_LOG_OBJECT (dbin, "Adding signals to element %s in chain %p",
2255 GST_ELEMENT_NAME (element), chain);
2256 g_signal_connect (G_OBJECT (element), "pad-added",
2257 G_CALLBACK (pad_added_cb), chain);
2258 g_signal_connect (G_OBJECT (element), "pad-removed",
2259 G_CALLBACK (pad_removed_cb), chain);
2260 g_signal_connect (G_OBJECT (element), "no-more-pads",
2261 G_CALLBACK (no_more_pads_cb), chain);
2264 /* 3. for every available pad, connect it */
2265 for (pads = to_connect; pads; pads = g_list_next (pads)) {
2266 GstPad *pad = GST_PAD_CAST (pads->data);
2269 caps = get_pad_caps (pad);
2270 analyze_new_pad (dbin, element, pad, caps, chain);
2272 gst_caps_unref (caps);
2274 gst_object_unref (pad);
2276 g_list_free (to_connect);
2283 * Expose the given pad on the chain as a decoded pad.
2286 expose_pad (GstDecodeBin * dbin, GstElement * src, GstDecodePad * dpad,
2287 GstPad * pad, GstCaps * caps, GstDecodeChain * chain)
2289 GstPad *mqpad = NULL;
2291 GST_DEBUG_OBJECT (dbin, "pad %s:%s, chain:%p",
2292 GST_DEBUG_PAD_NAME (pad), chain);
2294 /* If this is the first pad for this chain, there are no other elements
2295 * and the source element is not the multiqueue we must link through the
2298 * This is the case if a demuxer directly exposed a raw pad.
2300 if (chain->parent && !chain->elements && src != chain->parent->multiqueue) {
2301 GST_LOG_OBJECT (src, "connecting the pad through multiqueue");
2303 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
2304 if (!(mqpad = gst_decode_group_control_demuxer_pad (chain->parent, pad)))
2307 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
2310 gst_decode_pad_activate (dpad, chain);
2311 chain->endpad = gst_object_ref (dpad);
2312 chain->endcaps = gst_caps_ref (caps);
2315 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2316 gst_decode_bin_expose (dbin);
2318 EXPOSE_UNLOCK (dbin);
2321 gst_object_unref (mqpad);
2327 /* check_upstream_seekable:
2329 * Check if upstream is seekable.
2332 check_upstream_seekable (GstDecodeBin * dbin, GstPad * pad)
2335 gint64 start = -1, stop = -1;
2336 gboolean seekable = FALSE;
2338 query = gst_query_new_seeking (GST_FORMAT_BYTES);
2339 if (!gst_pad_peer_query (pad, query)) {
2340 GST_DEBUG_OBJECT (dbin, "seeking query failed");
2341 gst_query_unref (query);
2345 gst_query_parse_seeking (query, NULL, &seekable, &start, &stop);
2347 gst_query_unref (query);
2349 /* try harder to query upstream size if we didn't get it the first time */
2350 if (seekable && stop == -1) {
2351 GST_DEBUG_OBJECT (dbin, "doing duration query to fix up unset stop");
2352 gst_pad_peer_query_duration (pad, GST_FORMAT_BYTES, &stop);
2355 /* if upstream doesn't know the size, it's likely that it's not seekable in
2356 * practice even if it technically may be seekable */
2357 if (seekable && (start != 0 || stop <= start)) {
2358 GST_DEBUG_OBJECT (dbin, "seekable but unknown start/stop -> disable");
2362 GST_DEBUG_OBJECT (dbin, "upstream seekable: %d", seekable);
2367 type_found (GstElement * typefind, guint probability,
2368 GstCaps * caps, GstDecodeBin * decode_bin)
2370 GstPad *pad, *sink_pad;
2372 GST_DEBUG_OBJECT (decode_bin, "typefind found caps %" GST_PTR_FORMAT, caps);
2374 /* If the typefinder (but not something else) finds text/plain - i.e. that's
2375 * the top-level type of the file - then error out.
2377 if (gst_structure_has_name (gst_caps_get_structure (caps, 0), "text/plain")) {
2378 GST_ELEMENT_ERROR (decode_bin, STREAM, WRONG_TYPE,
2379 (_("This appears to be a text file")),
2380 ("decodebin cannot decode plain text files"));
2384 /* FIXME: we can only deal with one type, we don't yet support dynamically changing
2385 * caps from the typefind element */
2386 if (decode_bin->have_type || decode_bin->decode_chain)
2389 decode_bin->have_type = TRUE;
2391 pad = gst_element_get_static_pad (typefind, "src");
2392 sink_pad = gst_element_get_static_pad (typefind, "sink");
2394 /* need some lock here to prevent race with shutdown state change
2395 * which might yank away e.g. decode_chain while building stuff here.
2396 * In typical cases, STREAM_LOCK is held and handles that, it need not
2397 * be held (if called from a proxied setcaps), so grab it anyway */
2398 GST_PAD_STREAM_LOCK (sink_pad);
2399 decode_bin->decode_chain = gst_decode_chain_new (decode_bin, NULL, pad);
2400 analyze_new_pad (decode_bin, typefind, pad, caps, decode_bin->decode_chain);
2401 GST_PAD_STREAM_UNLOCK (sink_pad);
2403 gst_object_unref (sink_pad);
2404 gst_object_unref (pad);
2410 static GstPadProbeReturn
2411 pad_event_cb (GstPad * pad, GstPadProbeInfo * info, gpointer data)
2413 GstEvent *event = GST_PAD_PROBE_INFO_EVENT (info);
2414 GstPendingPad *ppad = (GstPendingPad *) data;
2415 GstDecodeChain *chain = ppad->chain;
2416 GstDecodeBin *dbin = chain->dbin;
2421 switch (GST_EVENT_TYPE (event)) {
2423 GST_DEBUG_OBJECT (dbin, "Received EOS on a non final pad, this stream "
2425 chain->deadend = TRUE;
2426 /* we don't set the endcaps because NULL endcaps means early EOS */
2428 if (gst_decode_chain_is_complete (dbin->decode_chain))
2429 gst_decode_bin_expose (dbin);
2430 EXPOSE_UNLOCK (dbin);
2435 return GST_PAD_PROBE_OK;
2439 pad_added_cb (GstElement * element, GstPad * pad, GstDecodeChain * chain)
2446 GST_DEBUG_OBJECT (pad, "pad added, chain:%p", chain);
2448 caps = get_pad_caps (pad);
2449 analyze_new_pad (dbin, element, pad, caps, chain);
2451 gst_caps_unref (caps);
2454 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2455 GST_LOG_OBJECT (dbin,
2456 "That was the last dynamic object, now attempting to expose the group");
2457 if (!gst_decode_bin_expose (dbin))
2458 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
2460 EXPOSE_UNLOCK (dbin);
2464 pad_removed_cb (GstElement * element, GstPad * pad, GstDecodeChain * chain)
2468 GST_LOG_OBJECT (pad, "pad removed, chain:%p", chain);
2470 /* In fact, we don't have to do anything here, the active group will be
2471 * removed when the group's multiqueue is drained */
2472 CHAIN_MUTEX_LOCK (chain);
2473 for (l = chain->pending_pads; l; l = l->next) {
2474 GstPendingPad *ppad = l->data;
2475 GstPad *opad = ppad->pad;
2478 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2479 gst_pending_pad_free (ppad);
2480 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2484 CHAIN_MUTEX_UNLOCK (chain);
2488 no_more_pads_cb (GstElement * element, GstDecodeChain * chain)
2490 GstDecodeGroup *group = NULL;
2492 GST_LOG_OBJECT (element, "got no more pads");
2494 CHAIN_MUTEX_LOCK (chain);
2495 if (!chain->elements
2496 || ((GstDecodeElement *) chain->elements->data)->element != element) {
2497 GST_LOG_OBJECT (chain->dbin, "no-more-pads from old chain element '%s'",
2498 GST_OBJECT_NAME (element));
2499 CHAIN_MUTEX_UNLOCK (chain);
2501 } else if (!chain->demuxer) {
2502 GST_LOG_OBJECT (chain->dbin, "no-more-pads from a non-demuxer element '%s'",
2503 GST_OBJECT_NAME (element));
2504 CHAIN_MUTEX_UNLOCK (chain);
2508 /* when we received no_more_pads, we can complete the pads of the chain */
2509 if (!chain->next_groups && chain->active_group) {
2510 group = chain->active_group;
2511 } else if (chain->next_groups) {
2512 group = chain->next_groups->data;
2515 GST_ERROR_OBJECT (chain->dbin, "can't find group for element");
2516 CHAIN_MUTEX_UNLOCK (chain);
2520 GST_DEBUG_OBJECT (element, "Setting group %p to complete", group);
2522 group->no_more_pads = TRUE;
2523 /* this group has prerolled enough to not need more pads,
2524 * we can probably set its buffering state to playing now */
2525 GST_DEBUG_OBJECT (group->dbin, "Setting group %p multiqueue to "
2526 "'playing' buffering mode", group);
2527 decodebin_set_queue_size (group->dbin, group->multiqueue, FALSE,
2528 (group->parent ? group->parent->seekable : TRUE));
2529 CHAIN_MUTEX_UNLOCK (chain);
2531 EXPOSE_LOCK (chain->dbin);
2532 if (gst_decode_chain_is_complete (chain->dbin->decode_chain)) {
2533 gst_decode_bin_expose (chain->dbin);
2535 EXPOSE_UNLOCK (chain->dbin);
2539 caps_notify_cb (GstPad * pad, GParamSpec * unused, GstDecodeChain * chain)
2541 GstElement *element;
2544 GST_LOG_OBJECT (pad, "Notified caps for pad %s:%s", GST_DEBUG_PAD_NAME (pad));
2546 /* Disconnect this; if we still need it, we'll reconnect to this in
2547 * analyze_new_pad */
2548 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2550 element = GST_ELEMENT_CAST (gst_pad_get_parent (pad));
2552 CHAIN_MUTEX_LOCK (chain);
2553 for (l = chain->pending_pads; l; l = l->next) {
2554 GstPendingPad *ppad = l->data;
2555 if (ppad->pad == pad) {
2556 gst_pending_pad_free (ppad);
2557 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2561 CHAIN_MUTEX_UNLOCK (chain);
2563 pad_added_cb (element, pad, chain);
2565 gst_object_unref (element);
2568 /* Decide whether an element is a demuxer based on the
2569 * klass and number/type of src pad templates it has */
2571 is_demuxer_element (GstElement * srcelement)
2573 GstElementFactory *srcfactory;
2574 GstElementClass *elemclass;
2577 gint potential_src_pads = 0;
2579 srcfactory = gst_element_get_factory (srcelement);
2581 gst_element_factory_get_metadata (srcfactory, GST_ELEMENT_METADATA_KLASS);
2583 /* Can't be a demuxer unless it has Demux in the klass name */
2584 if (!strstr (klass, "Demux"))
2587 /* Walk the src pad templates and count how many the element
2589 elemclass = GST_ELEMENT_GET_CLASS (srcelement);
2591 walk = gst_element_class_get_pad_template_list (elemclass);
2592 while (walk != NULL) {
2593 GstPadTemplate *templ;
2595 templ = (GstPadTemplate *) walk->data;
2596 if (GST_PAD_TEMPLATE_DIRECTION (templ) == GST_PAD_SRC) {
2597 switch (GST_PAD_TEMPLATE_PRESENCE (templ)) {
2598 case GST_PAD_ALWAYS:
2599 case GST_PAD_SOMETIMES:
2600 if (strstr (GST_PAD_TEMPLATE_NAME_TEMPLATE (templ), "%"))
2601 potential_src_pads += 2; /* Might make multiple pads */
2603 potential_src_pads += 1;
2605 case GST_PAD_REQUEST:
2606 potential_src_pads += 2;
2610 walk = g_list_next (walk);
2613 if (potential_src_pads < 2)
2619 /* Returns TRUE if the caps are compatible with the caps specified in the 'caps'
2620 * property (which by default are the raw caps)
2622 * The decodebin_lock should be taken !
2625 are_final_caps (GstDecodeBin * dbin, GstCaps * caps)
2629 GST_LOG_OBJECT (dbin, "Checking with caps %" GST_PTR_FORMAT, caps);
2631 /* lock for getting the caps */
2632 GST_OBJECT_LOCK (dbin);
2633 res = gst_caps_can_intersect (dbin->caps, caps);
2634 GST_OBJECT_UNLOCK (dbin);
2636 GST_LOG_OBJECT (dbin, "Caps are %sfinal caps", res ? "" : "not ");
2642 * GstDecodeChain functions
2645 /* gst_decode_chain_get_current_group:
2647 * Returns the current group of this chain, to which
2648 * new chains should be attached or NULL if the last
2649 * group didn't have no-more-pads.
2651 * Not MT-safe: Call with parent chain lock!
2653 static GstDecodeGroup *
2654 gst_decode_chain_get_current_group (GstDecodeChain * chain)
2656 GstDecodeGroup *group;
2658 if (!chain->next_groups && chain->active_group
2659 && chain->active_group->overrun && !chain->active_group->no_more_pads) {
2660 GST_WARNING_OBJECT (chain->dbin,
2661 "Currently active group %p is exposed"
2662 " and wants to add a new pad without having signaled no-more-pads",
2663 chain->active_group);
2667 if (chain->next_groups && (group = chain->next_groups->data) && group->overrun
2668 && !group->no_more_pads) {
2669 GST_WARNING_OBJECT (chain->dbin,
2670 "Currently newest pending group %p "
2671 "had overflow but didn't signal no-more-pads", group);
2675 /* Now we know that we can really return something useful */
2676 if (!chain->active_group) {
2677 chain->active_group = group = gst_decode_group_new (chain->dbin, chain);
2678 } else if (!chain->active_group->overrun
2679 && !chain->active_group->no_more_pads) {
2680 group = chain->active_group;
2681 } else if (chain->next_groups && (group = chain->next_groups->data)
2682 && !group->overrun && !group->no_more_pads) {
2683 /* group = chain->next_groups->data */
2685 group = gst_decode_group_new (chain->dbin, chain);
2686 chain->next_groups = g_list_prepend (chain->next_groups, group);
2692 static void gst_decode_group_free_internal (GstDecodeGroup * group,
2696 gst_decode_chain_free_internal (GstDecodeChain * chain, gboolean hide)
2700 CHAIN_MUTEX_LOCK (chain);
2702 GST_DEBUG_OBJECT (chain->dbin, "%s chain %p", (hide ? "Hiding" : "Freeing"),
2705 if (chain->active_group) {
2706 gst_decode_group_free_internal (chain->active_group, hide);
2708 chain->active_group = NULL;
2711 for (l = chain->next_groups; l; l = l->next) {
2712 gst_decode_group_free_internal ((GstDecodeGroup *) l->data, hide);
2717 g_list_free (chain->next_groups);
2718 chain->next_groups = NULL;
2722 for (l = chain->old_groups; l; l = l->next) {
2723 GstDecodeGroup *group = l->data;
2725 gst_decode_group_free (group);
2727 g_list_free (chain->old_groups);
2728 chain->old_groups = NULL;
2731 for (l = chain->pending_pads; l; l = l->next) {
2732 GstPendingPad *ppad = l->data;
2733 GstPad *pad = ppad->pad;
2735 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2736 gst_pending_pad_free (ppad);
2739 g_list_free (chain->pending_pads);
2740 chain->pending_pads = NULL;
2742 for (l = chain->elements; l; l = l->next) {
2743 GstDecodeElement *delem = l->data;
2744 GstElement *element = delem->element;
2746 g_signal_handlers_disconnect_by_func (element, pad_added_cb, chain);
2747 g_signal_handlers_disconnect_by_func (element, pad_removed_cb, chain);
2748 g_signal_handlers_disconnect_by_func (element, no_more_pads_cb, chain);
2750 if (delem->capsfilter) {
2751 if (GST_OBJECT_PARENT (delem->capsfilter) ==
2752 GST_OBJECT_CAST (chain->dbin))
2753 gst_bin_remove (GST_BIN_CAST (chain->dbin), delem->capsfilter);
2755 gst_element_set_state (delem->capsfilter, GST_STATE_NULL);
2759 if (GST_OBJECT_PARENT (element) == GST_OBJECT_CAST (chain->dbin))
2760 gst_bin_remove (GST_BIN_CAST (chain->dbin), element);
2762 gst_element_set_state (element, GST_STATE_NULL);
2765 SUBTITLE_LOCK (chain->dbin);
2766 /* remove possible subtitle element */
2767 chain->dbin->subtitles = g_list_remove (chain->dbin->subtitles, element);
2768 SUBTITLE_UNLOCK (chain->dbin);
2771 if (delem->capsfilter) {
2772 gst_object_unref (delem->capsfilter);
2773 delem->capsfilter = NULL;
2776 gst_object_unref (element);
2779 g_slice_free (GstDecodeElement, delem);
2783 g_list_free (chain->elements);
2784 chain->elements = NULL;
2787 if (chain->endpad) {
2788 if (chain->endpad->exposed) {
2789 gst_element_remove_pad (GST_ELEMENT_CAST (chain->dbin),
2790 GST_PAD_CAST (chain->endpad));
2793 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (chain->endpad), NULL);
2794 chain->endpad->exposed = FALSE;
2796 gst_object_unref (chain->endpad);
2797 chain->endpad = NULL;
2802 gst_object_unref (chain->pad);
2806 if (chain->endcaps) {
2807 gst_caps_unref (chain->endcaps);
2808 chain->endcaps = NULL;
2811 GST_DEBUG_OBJECT (chain->dbin, "%s chain %p", (hide ? "Hidden" : "Freed"),
2813 CHAIN_MUTEX_UNLOCK (chain);
2815 g_mutex_clear (&chain->lock);
2816 g_slice_free (GstDecodeChain, chain);
2820 /* gst_decode_chain_free:
2822 * Completely frees and removes the chain and all
2823 * child groups from decodebin.
2825 * MT-safe, don't hold the chain lock or any child chain's lock
2826 * when calling this!
2829 gst_decode_chain_free (GstDecodeChain * chain)
2831 gst_decode_chain_free_internal (chain, FALSE);
2834 /* gst_decode_chain_new:
2836 * Creates a new decode chain and initializes it.
2838 * It's up to the caller to add it to the list of child chains of
2841 static GstDecodeChain *
2842 gst_decode_chain_new (GstDecodeBin * dbin, GstDecodeGroup * parent,
2845 GstDecodeChain *chain = g_slice_new0 (GstDecodeChain);
2847 GST_DEBUG_OBJECT (dbin, "Creating new chain %p with parent group %p", chain,
2851 chain->parent = parent;
2852 g_mutex_init (&chain->lock);
2853 chain->pad = gst_object_ref (pad);
2859 * GstDecodeGroup functions
2862 /* The overrun callback is used to expose groups that have not yet had their
2863 * no_more_pads called while the (large) multiqueue overflowed. When this
2864 * happens we must assume that the no_more_pads will not arrive anymore and we
2865 * must expose the pads that we have.
2868 multi_queue_overrun_cb (GstElement * queue, GstDecodeGroup * group)
2874 GST_LOG_OBJECT (dbin, "multiqueue '%s' (%p) is full", GST_OBJECT_NAME (queue),
2877 group->overrun = TRUE;
2878 /* this group has prerolled enough to not need more pads,
2879 * we can probably set its buffering state to playing now */
2880 GST_DEBUG_OBJECT (group->dbin, "Setting group %p multiqueue to "
2881 "'playing' buffering mode", group);
2882 decodebin_set_queue_size (group->dbin, group->multiqueue, FALSE,
2883 (group->parent ? group->parent->seekable : TRUE));
2885 /* FIXME: We should make sure that everything gets exposed now
2886 * even if child chains are not complete because the will never
2887 * be complete! Ignore any non-complete chains when exposing
2888 * and never expose them later
2892 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2893 if (!gst_decode_bin_expose (dbin))
2894 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
2896 EXPOSE_UNLOCK (group->dbin);
2900 gst_decode_group_free_internal (GstDecodeGroup * group, gboolean hide)
2904 GST_DEBUG_OBJECT (group->dbin, "%s group %p", (hide ? "Hiding" : "Freeing"),
2906 for (l = group->children; l; l = l->next) {
2907 GstDecodeChain *chain = (GstDecodeChain *) l->data;
2909 gst_decode_chain_free_internal (chain, hide);
2914 g_list_free (group->children);
2915 group->children = NULL;
2919 for (l = group->reqpads; l; l = l->next) {
2920 GstPad *pad = l->data;
2922 gst_element_release_request_pad (group->multiqueue, pad);
2923 gst_object_unref (pad);
2926 g_list_free (group->reqpads);
2927 group->reqpads = NULL;
2930 if (group->multiqueue) {
2931 if (group->overrunsig) {
2932 g_signal_handler_disconnect (group->multiqueue, group->overrunsig);
2933 group->overrunsig = 0;
2936 if (GST_OBJECT_PARENT (group->multiqueue) == GST_OBJECT_CAST (group->dbin))
2937 gst_bin_remove (GST_BIN_CAST (group->dbin), group->multiqueue);
2939 gst_element_set_state (group->multiqueue, GST_STATE_NULL);
2940 gst_object_unref (group->multiqueue);
2941 group->multiqueue = NULL;
2945 GST_DEBUG_OBJECT (group->dbin, "%s group %p", (hide ? "Hided" : "Freed"),
2948 g_slice_free (GstDecodeGroup, group);
2951 /* gst_decode_group_free:
2953 * Completely frees and removes the decode group and all
2956 * Never call this from any streaming thread!
2958 * Not MT-safe, call with parent's chain lock!
2961 gst_decode_group_free (GstDecodeGroup * group)
2963 gst_decode_group_free_internal (group, FALSE);
2966 /* gst_decode_group_hide:
2968 * Hide the decode group only, this means that
2969 * all child endpads are removed from decodebin
2970 * and all signals are unconnected.
2972 * No element is set to NULL state and completely
2975 * Can be called from streaming threads.
2977 * Not MT-safe, call with parent's chain lock!
2980 gst_decode_group_hide (GstDecodeGroup * group)
2982 gst_decode_group_free_internal (group, TRUE);
2985 /* configure queue sizes, this depends on the buffering method and if we are
2986 * playing or prerolling. */
2988 decodebin_set_queue_size (GstDecodeBin * dbin, GstElement * multiqueue,
2989 gboolean preroll, gboolean seekable)
2991 guint max_bytes, max_buffers;
2994 if (preroll || dbin->use_buffering) {
2995 /* takes queue limits, initially we only queue up up to the max bytes limit,
2996 * with a default of 2MB. we use the same values for buffering mode. */
2997 if ((max_bytes = dbin->max_size_bytes) == 0)
2998 max_bytes = AUTO_PREROLL_SIZE_BYTES;
2999 if ((max_buffers = dbin->max_size_buffers) == 0)
3000 max_buffers = AUTO_PREROLL_SIZE_BUFFERS;
3001 if ((max_time = dbin->max_size_time) == 0)
3002 max_time = seekable ? AUTO_PREROLL_SEEKABLE_SIZE_TIME :
3003 AUTO_PREROLL_NOT_SEEKABLE_SIZE_TIME;
3005 /* update runtime limits. At runtime, we try to keep the amount of buffers
3006 * in the queues as low as possible (but at least 5 buffers). */
3007 if ((max_bytes = dbin->max_size_bytes) == 0)
3008 max_bytes = AUTO_PLAY_SIZE_BYTES;
3009 if ((max_buffers = dbin->max_size_buffers) == 0)
3010 max_buffers = AUTO_PLAY_SIZE_BUFFERS;
3011 if ((max_time = dbin->max_size_time) == 0)
3012 max_time = AUTO_PLAY_SIZE_TIME;
3015 g_object_set (multiqueue,
3016 "max-size-bytes", max_bytes, "max-size-time", max_time,
3017 "max-size-buffers", max_buffers, NULL);
3020 /* gst_decode_group_new:
3021 * @dbin: Parent decodebin
3022 * @parent: Parent chain or %NULL
3024 * Creates a new GstDecodeGroup. It is up to the caller to add it to the list
3027 static GstDecodeGroup *
3028 gst_decode_group_new (GstDecodeBin * dbin, GstDecodeChain * parent)
3030 GstDecodeGroup *group = g_slice_new0 (GstDecodeGroup);
3034 GST_DEBUG_OBJECT (dbin, "Creating new group %p with parent chain %p", group,
3038 group->parent = parent;
3040 mq = group->multiqueue = gst_element_factory_make ("multiqueue", NULL);
3041 if (G_UNLIKELY (!group->multiqueue))
3042 goto missing_multiqueue;
3044 /* default is for use-buffering is FALSE */
3045 if (dbin->use_buffering) {
3047 "use-buffering", TRUE,
3048 "low-percent", dbin->low_percent,
3049 "high-percent", dbin->high_percent, NULL);
3052 /* configure queue sizes for preroll */
3054 if (parent && parent->demuxer) {
3055 GstElement *element =
3056 ((GstDecodeElement *) parent->elements->data)->element;
3057 GstPad *pad = gst_element_get_static_pad (element, "sink");
3059 seekable = parent->seekable = check_upstream_seekable (dbin, pad);
3060 gst_object_unref (pad);
3063 decodebin_set_queue_size (dbin, mq, TRUE, seekable);
3065 group->overrunsig = g_signal_connect (G_OBJECT (mq), "overrun",
3066 G_CALLBACK (multi_queue_overrun_cb), group);
3068 gst_bin_add (GST_BIN (dbin), gst_object_ref (mq));
3069 gst_element_set_state (mq, GST_STATE_PAUSED);
3076 gst_element_post_message (GST_ELEMENT_CAST (dbin),
3077 gst_missing_element_message_new (GST_ELEMENT_CAST (dbin),
3079 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL), ("no multiqueue!"));
3080 g_slice_free (GstDecodeGroup, group);
3085 /* gst_decode_group_control_demuxer_pad
3087 * Adds a new demuxer srcpad to the given group.
3089 * Returns the srcpad of the multiqueue corresponding the given pad.
3090 * Returns NULL if there was an error.
3093 gst_decode_group_control_demuxer_pad (GstDecodeGroup * group, GstPad * pad)
3096 GstPad *srcpad, *sinkpad;
3097 GstIterator *it = NULL;
3098 GValue item = { 0, };
3102 GST_LOG_OBJECT (dbin, "group:%p pad %s:%s", group, GST_DEBUG_PAD_NAME (pad));
3106 if (G_UNLIKELY (!group->multiqueue))
3109 if (!(sinkpad = gst_element_get_request_pad (group->multiqueue, "sink_%u"))) {
3110 GST_ERROR_OBJECT (dbin, "Couldn't get sinkpad from multiqueue");
3114 if ((gst_pad_link (pad, sinkpad) != GST_PAD_LINK_OK)) {
3115 GST_ERROR_OBJECT (dbin, "Couldn't link demuxer and multiqueue");
3119 it = gst_pad_iterate_internal_links (sinkpad);
3121 if (!it || (gst_iterator_next (it, &item)) != GST_ITERATOR_OK
3122 || ((srcpad = g_value_dup_object (&item)) == NULL)) {
3123 GST_ERROR_OBJECT (dbin,
3124 "Couldn't get srcpad from multiqueue for sinkpad %" GST_PTR_FORMAT,
3128 CHAIN_MUTEX_LOCK (group->parent);
3129 group->reqpads = g_list_prepend (group->reqpads, gst_object_ref (sinkpad));
3130 CHAIN_MUTEX_UNLOCK (group->parent);
3133 if (G_IS_VALUE (&item))
3134 g_value_unset (&item);
3136 gst_iterator_free (it);
3137 gst_object_unref (sinkpad);
3141 gst_element_release_request_pad (group->multiqueue, sinkpad);
3145 /* gst_decode_group_is_complete:
3147 * Checks if the group is complete, this means that
3148 * a) overrun of the multiqueue or no-more-pads happened
3149 * b) all child chains are complete
3151 * Not MT-safe, always call with decodebin expose lock
3154 gst_decode_group_is_complete (GstDecodeGroup * group)
3157 gboolean complete = TRUE;
3159 if (!group->overrun && !group->no_more_pads) {
3164 for (l = group->children; l; l = l->next) {
3165 GstDecodeChain *chain = l->data;
3167 if (!gst_decode_chain_is_complete (chain)) {
3174 GST_DEBUG_OBJECT (group->dbin, "Group %p is complete: %d", group, complete);
3178 /* gst_decode_chain_is_complete:
3180 * Returns TRUE if the chain is complete, this means either
3181 * a) This chain is a dead end, i.e. we have no suitable plugins
3182 * b) This chain ends in an endpad and this is blocked or exposed
3184 * Not MT-safe, always call with decodebin expose lock
3187 gst_decode_chain_is_complete (GstDecodeChain * chain)
3189 gboolean complete = FALSE;
3191 CHAIN_MUTEX_LOCK (chain);
3192 if (chain->deadend) {
3197 if (chain->endpad && (chain->endpad->blocked || chain->endpad->exposed)) {
3202 if (chain->demuxer) {
3203 if (chain->active_group
3204 && gst_decode_group_is_complete (chain->active_group)) {
3211 CHAIN_MUTEX_UNLOCK (chain);
3212 GST_DEBUG_OBJECT (chain->dbin, "Chain %p is complete: %d", chain, complete);
3217 drain_and_switch_chains (GstDecodeChain * chain, GstDecodePad * drainpad,
3218 gboolean * last_group, gboolean * drained, gboolean * switched);
3219 /* drain_and_switch_chains/groups:
3221 * CALL WITH CHAIN LOCK (or group parent) TAKEN !
3223 * Goes down the chains/groups until it finds the chain
3224 * to which the drainpad belongs.
3226 * It marks that pad/chain as drained and then will figure
3227 * out which group to switch to or not.
3229 * last_chain will be set to TRUE if the group to which the
3230 * pad belongs is the last one.
3232 * drained will be set to TRUE if the chain/group is drained.
3234 * Returns: TRUE if the chain contained the target pad */
3236 drain_and_switch_group (GstDecodeGroup * group, GstDecodePad * drainpad,
3237 gboolean * last_group, gboolean * drained, gboolean * switched)
3239 gboolean handled = FALSE;
3242 GST_DEBUG ("Checking group %p (target pad %s:%s)",
3243 group, GST_DEBUG_PAD_NAME (drainpad));
3245 /* Definitely can't be in drained groups */
3246 if (G_UNLIKELY (group->drained)) {
3250 /* Figure out if all our chains are drained with the
3251 * new information */
3252 group->drained = TRUE;
3253 for (tmp = group->children; tmp; tmp = tmp->next) {
3254 GstDecodeChain *chain = (GstDecodeChain *) tmp->data;
3255 gboolean subdrained = FALSE;
3258 drain_and_switch_chains (chain, drainpad, last_group, &subdrained,
3261 group->drained = FALSE;
3265 GST_DEBUG ("group %p (last_group:%d, drained:%d, switched:%d, handled:%d)",
3266 group, *last_group, group->drained, *switched, handled);
3267 *drained = group->drained;
3272 drain_and_switch_chains (GstDecodeChain * chain, GstDecodePad * drainpad,
3273 gboolean * last_group, gboolean * drained, gboolean * switched)
3275 gboolean handled = FALSE;
3276 GstDecodeBin *dbin = chain->dbin;
3278 GST_DEBUG ("Checking chain %p (target pad %s:%s)",
3279 chain, GST_DEBUG_PAD_NAME (drainpad));
3281 CHAIN_MUTEX_LOCK (chain);
3283 /* Definitely can't be in drained chains */
3284 if (G_UNLIKELY (chain->drained)) {
3288 if (chain->endpad) {
3289 /* Check if we're reached the target endchain */
3290 if (chain == drainpad->chain) {
3291 GST_DEBUG ("Found the target chain");
3292 drainpad->drained = TRUE;
3296 chain->drained = chain->endpad->drained;
3300 /* We known there are groups to switch to */
3301 if (chain->next_groups)
3302 *last_group = FALSE;
3304 /* Check the active group */
3305 if (chain->active_group) {
3306 gboolean subdrained = FALSE;
3307 handled = drain_and_switch_group (chain->active_group, drainpad,
3308 last_group, &subdrained, switched);
3310 /* The group is drained, see if we can switch to another */
3311 if (handled && subdrained && !*switched) {
3312 if (chain->next_groups) {
3313 /* Switch to next group */
3314 GST_DEBUG_OBJECT (dbin, "Hiding current group %p", chain->active_group);
3315 gst_decode_group_hide (chain->active_group);
3317 g_list_prepend (chain->old_groups, chain->active_group);
3318 GST_DEBUG_OBJECT (dbin, "Switching to next group %p",
3319 chain->next_groups->data);
3320 chain->active_group = chain->next_groups->data;
3321 chain->next_groups =
3322 g_list_delete_link (chain->next_groups, chain->next_groups);
3324 chain->drained = FALSE;
3326 GST_DEBUG ("Group %p was the last in chain %p", chain->active_group,
3328 chain->drained = TRUE;
3329 /* We're drained ! */
3335 CHAIN_MUTEX_UNLOCK (chain);
3337 GST_DEBUG ("Chain %p (handled:%d, last_group:%d, drained:%d, switched:%d)",
3338 chain, handled, *last_group, chain->drained, *switched);
3340 *drained = chain->drained;
3343 g_signal_emit (dbin, gst_decode_bin_signals[SIGNAL_DRAINED], 0, NULL);
3348 /* check if the group is drained, meaning all pads have seen an EOS
3351 gst_decode_pad_handle_eos (GstDecodePad * pad)
3353 gboolean last_group = TRUE;
3354 gboolean switched = FALSE;
3355 gboolean drained = FALSE;
3356 GstDecodeChain *chain = pad->chain;
3357 GstDecodeBin *dbin = chain->dbin;
3359 GST_LOG_OBJECT (dbin, "pad %p", pad);
3360 drain_and_switch_chains (dbin->decode_chain, pad, &last_group, &drained,
3364 /* If we resulted in a group switch, expose what's needed */
3366 if (gst_decode_chain_is_complete (dbin->decode_chain))
3367 gst_decode_bin_expose (dbin);
3368 EXPOSE_UNLOCK (dbin);
3374 /* gst_decode_group_is_drained:
3376 * Check is this group is drained and cache this result.
3377 * The group is drained if all child chains are drained.
3379 * Not MT-safe, call with group->parent's lock */
3381 gst_decode_group_is_drained (GstDecodeGroup * group)
3384 gboolean drained = TRUE;
3386 if (group->drained) {
3391 for (l = group->children; l; l = l->next) {
3392 GstDecodeChain *chain = l->data;
3394 CHAIN_MUTEX_LOCK (chain);
3395 if (!gst_decode_chain_is_drained (chain))
3397 CHAIN_MUTEX_UNLOCK (chain);
3401 group->drained = drained;
3404 GST_DEBUG_OBJECT (group->dbin, "Group %p is drained: %d", group, drained);
3408 /* gst_decode_chain_is_drained:
3410 * Check is the chain is drained, which means that
3413 * a) it's endpad is drained
3414 * b) there are no pending pads, the active group is drained
3415 * and there are no next groups
3417 * Not MT-safe, call with chain lock
3420 gst_decode_chain_is_drained (GstDecodeChain * chain)
3422 gboolean drained = FALSE;
3424 if (chain->endpad) {
3425 drained = chain->endpad->drained;
3429 if (chain->pending_pads) {
3434 if (chain->active_group && gst_decode_group_is_drained (chain->active_group)
3435 && !chain->next_groups) {
3441 GST_DEBUG_OBJECT (chain->dbin, "Chain %p is drained: %d", chain, drained);
3446 * GCompareFunc to use with lists of GstPad.
3447 * Sorts pads by mime type.
3448 * First video (raw, then non-raw), then audio (raw, then non-raw),
3451 * Return: negative if a<b, 0 if a==b, positive if a>b
3454 sort_end_pads (GstDecodePad * da, GstDecodePad * db)
3457 GstCaps *capsa, *capsb;
3458 GstStructure *sa, *sb;
3459 const gchar *namea, *nameb;
3463 capsa = get_pad_caps (GST_PAD_CAST (da));
3464 capsb = get_pad_caps (GST_PAD_CAST (db));
3466 sa = gst_caps_get_structure ((const GstCaps *) capsa, 0);
3467 sb = gst_caps_get_structure ((const GstCaps *) capsb, 0);
3469 namea = gst_structure_get_name (sa);
3470 nameb = gst_structure_get_name (sb);
3472 if (g_strrstr (namea, "video/x-raw"))
3474 else if (g_strrstr (namea, "video/"))
3476 else if (g_strrstr (namea, "audio/x-raw"))
3478 else if (g_strrstr (namea, "audio/"))
3483 if (g_strrstr (nameb, "video/x-raw"))
3485 else if (g_strrstr (nameb, "video/"))
3487 else if (g_strrstr (nameb, "audio/x-raw"))
3489 else if (g_strrstr (nameb, "audio/"))
3494 gst_caps_unref (capsa);
3495 gst_caps_unref (capsb);
3500 /* if otherwise the same, sort by stream-id */
3501 ida = gst_pad_get_stream_id (GST_PAD_CAST (da));
3502 idb = gst_pad_get_stream_id (GST_PAD_CAST (db));
3503 ret = (ida) ? ((idb) ? strcmp (ida, idb) : -1) : 1;
3511 _gst_element_get_linked_caps (GstElement * src, GstElement * sink,
3517 gboolean done = FALSE;
3518 GstCaps *caps = NULL;
3519 GValue item = { 0, };
3521 it = gst_element_iterate_src_pads (src);
3523 switch (gst_iterator_next (it, &item)) {
3524 case GST_ITERATOR_OK:
3525 pad = g_value_get_object (&item);
3526 peer = gst_pad_get_peer (pad);
3528 parent = gst_pad_get_parent_element (peer);
3529 if (parent == sink) {
3530 caps = gst_pad_get_current_caps (pad);
3532 gst_object_ref (pad);
3539 gst_object_unref (parent);
3540 gst_object_unref (peer);
3542 g_value_reset (&item);
3544 case GST_ITERATOR_RESYNC:
3545 gst_iterator_resync (it);
3547 case GST_ITERATOR_ERROR:
3548 case GST_ITERATOR_DONE:
3553 g_value_unset (&item);
3554 gst_iterator_free (it);
3559 static GQuark topology_structure_name = 0;
3560 static GQuark topology_caps = 0;
3561 static GQuark topology_next = 0;
3562 static GQuark topology_pad = 0;
3563 static GQuark topology_element_srcpad = 0;
3565 /* FIXME: Invent gst_structure_take_structure() to prevent all the
3566 * structure copying for nothing
3568 static GstStructure *
3569 gst_decode_chain_get_topology (GstDecodeChain * chain)
3571 GstStructure *s, *u;
3575 if (G_UNLIKELY ((chain->endpad || chain->deadend)
3576 && (chain->endcaps == NULL))) {
3577 GST_WARNING ("End chain without valid caps !");
3581 u = gst_structure_new_id_empty (topology_structure_name);
3583 /* Now at the last element */
3584 if ((chain->elements || !chain->active_group) &&
3585 (chain->endpad || chain->deadend)) {
3586 s = gst_structure_new_id_empty (topology_structure_name);
3587 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, chain->endcaps,
3590 if (chain->endpad) {
3591 gst_structure_id_set (u, topology_pad, GST_TYPE_PAD, chain->endpad, NULL);
3592 gst_structure_id_set (u, topology_element_srcpad, GST_TYPE_PAD,
3593 chain->endpad, NULL);
3595 gst_structure_id_set (s, topology_next, GST_TYPE_STRUCTURE, u, NULL);
3596 gst_structure_free (u);
3598 } else if (chain->active_group) {
3599 GValue list = { 0, };
3600 GValue item = { 0, };
3602 g_value_init (&list, GST_TYPE_LIST);
3603 g_value_init (&item, GST_TYPE_STRUCTURE);
3604 for (l = chain->active_group->children; l; l = l->next) {
3605 s = gst_decode_chain_get_topology (l->data);
3607 gst_value_set_structure (&item, s);
3608 gst_value_list_append_value (&list, &item);
3609 g_value_reset (&item);
3610 gst_structure_free (s);
3613 gst_structure_id_set_value (u, topology_next, &list);
3614 g_value_unset (&list);
3615 g_value_unset (&item);
3618 /* Get caps between all elements in this chain */
3619 l = (chain->elements && chain->elements->next) ? chain->elements : NULL;
3620 for (; l && l->next; l = l->next) {
3621 GstDecodeElement *delem, *delem_next;
3622 GstElement *elem, *elem_next;
3627 elem = delem->element;
3628 delem_next = l->next->data;
3629 elem_next = delem_next->element;
3632 caps = _gst_element_get_linked_caps (elem_next, elem, &srcpad);
3635 s = gst_structure_new_id_empty (topology_structure_name);
3636 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, caps, NULL);
3637 gst_caps_unref (caps);
3639 gst_structure_id_set (s, topology_next, GST_TYPE_STRUCTURE, u, NULL);
3640 gst_structure_free (u);
3645 gst_structure_id_set (u, topology_element_srcpad, GST_TYPE_PAD, srcpad,
3647 gst_object_unref (srcpad);
3651 /* Caps that resulted in this chain */
3652 caps = gst_pad_get_current_caps (chain->pad);
3654 caps = get_pad_caps (chain->pad);
3655 if (G_UNLIKELY (!gst_caps_is_fixed (caps))) {
3656 GST_ERROR_OBJECT (chain->pad,
3657 "Couldn't get fixed caps, got %" GST_PTR_FORMAT, caps);
3658 gst_caps_unref (caps);
3662 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, caps, NULL);
3663 gst_structure_id_set (u, topology_element_srcpad, GST_TYPE_PAD, chain->pad,
3665 gst_caps_unref (caps);
3671 gst_decode_bin_post_topology_message (GstDecodeBin * dbin)
3676 s = gst_decode_chain_get_topology (dbin->decode_chain);
3678 msg = gst_message_new_element (GST_OBJECT (dbin), s);
3679 gst_element_post_message (GST_ELEMENT (dbin), msg);
3682 /* Must only be called if the toplevel chain is complete and blocked! */
3683 /* Not MT-safe, call with decodebin expose lock! */
3685 gst_decode_bin_expose (GstDecodeBin * dbin)
3687 GList *tmp, *endpads = NULL;
3688 gboolean missing_plugin = FALSE;
3689 gboolean already_exposed = TRUE;
3691 GST_DEBUG_OBJECT (dbin, "Exposing currently active chains/groups");
3693 /* Don't expose if we're currently shutting down */
3695 if (G_UNLIKELY (dbin->shutdown == TRUE)) {
3696 GST_WARNING_OBJECT (dbin, "Currently, shutting down, aborting exposing");
3702 /* Get the pads that we're going to expose and mark things as exposed */
3703 if (!gst_decode_chain_expose (dbin->decode_chain, &endpads, &missing_plugin)) {
3704 g_list_foreach (endpads, (GFunc) gst_object_unref, NULL);
3705 g_list_free (endpads);
3706 GST_ERROR_OBJECT (dbin, "Broken chain/group tree");
3707 g_return_val_if_reached (FALSE);
3710 if (endpads == NULL) {
3711 if (missing_plugin) {
3712 GST_WARNING_OBJECT (dbin, "No suitable plugins found");
3713 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL),
3714 ("no suitable plugins found"));
3716 /* in this case, the stream ended without buffers,
3717 * just post a warning */
3718 GST_WARNING_OBJECT (dbin, "All streams finished without buffers");
3719 GST_ELEMENT_ERROR (dbin, STREAM, FAILED, (NULL),
3720 ("all streams without buffers"));
3725 /* Check if this was called when everything was exposed already */
3726 for (tmp = endpads; tmp && already_exposed; tmp = tmp->next) {
3727 GstDecodePad *dpad = tmp->data;
3729 already_exposed &= dpad->exposed;
3730 if (!already_exposed)
3733 if (already_exposed) {
3734 GST_DEBUG_OBJECT (dbin, "Everything was exposed already!");
3735 g_list_foreach (endpads, (GFunc) gst_object_unref, NULL);
3736 g_list_free (endpads);
3740 /* Set all already exposed pads to blocked */
3741 for (tmp = endpads; tmp; tmp = tmp->next) {
3742 GstDecodePad *dpad = tmp->data;
3744 if (dpad->exposed) {
3745 GST_DEBUG_OBJECT (dpad, "blocking exposed pad");
3746 gst_decode_pad_set_blocked (dpad, TRUE);
3750 /* re-order pads : video, then audio, then others */
3751 endpads = g_list_sort (endpads, (GCompareFunc) sort_end_pads);
3754 for (tmp = endpads; tmp; tmp = tmp->next) {
3755 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3758 /* 1. rewrite name */
3759 padname = g_strdup_printf ("src_%u", dbin->nbpads);
3761 GST_DEBUG_OBJECT (dbin, "About to expose dpad %s as %s",
3762 GST_OBJECT_NAME (dpad), padname);
3763 gst_object_set_name (GST_OBJECT (dpad), padname);
3766 /* 2. activate and add */
3768 && !gst_element_add_pad (GST_ELEMENT (dbin), GST_PAD_CAST (dpad))) {
3769 /* not really fatal, we can try to add the other pads */
3770 g_warning ("error adding pad to decodebin");
3773 dpad->exposed = TRUE;
3775 /* 3. emit signal */
3776 GST_INFO_OBJECT (dpad, "added new decoded pad");
3779 /* 4. Signal no-more-pads. This allows the application to hook stuff to the
3781 GST_LOG_OBJECT (dbin, "signaling no-more-pads");
3782 gst_element_no_more_pads (GST_ELEMENT (dbin));
3784 /* 5. Send a custom element message with the stream topology */
3785 if (dbin->post_stream_topology)
3786 gst_decode_bin_post_topology_message (dbin);
3788 /* 6. Unblock internal pads. The application should have connected stuff now
3789 * so that streaming can continue. */
3790 for (tmp = endpads; tmp; tmp = tmp->next) {
3791 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3793 GST_DEBUG_OBJECT (dpad, "unblocking");
3794 gst_decode_pad_unblock (dpad);
3795 GST_DEBUG_OBJECT (dpad, "unblocked");
3796 gst_object_unref (dpad);
3798 g_list_free (endpads);
3800 do_async_done (dbin);
3801 GST_DEBUG_OBJECT (dbin, "Exposed everything");
3805 /* gst_decode_chain_expose:
3807 * Check if the chain can be exposed and add all endpads
3808 * to the endpads list.
3810 * Also update the active group's multiqueue to the
3813 * Not MT-safe, call with decodebin expose lock! *
3816 gst_decode_chain_expose (GstDecodeChain * chain, GList ** endpads,
3817 gboolean * missing_plugin)
3819 GstDecodeGroup *group;
3823 if (chain->deadend) {
3825 *missing_plugin = TRUE;
3829 if (chain->endpad) {
3830 if (!chain->endpad->blocked && !chain->endpad->exposed)
3832 *endpads = g_list_prepend (*endpads, gst_object_ref (chain->endpad));
3836 group = chain->active_group;
3839 if (!group->no_more_pads && !group->overrun)
3844 /* configure queues for playback */
3845 decodebin_set_queue_size (dbin, group->multiqueue, FALSE, TRUE);
3847 /* we can now disconnect any overrun signal, which is used to expose the
3849 if (group->overrunsig) {
3850 GST_LOG_OBJECT (dbin, "Disconnecting overrun");
3851 g_signal_handler_disconnect (group->multiqueue, group->overrunsig);
3852 group->overrunsig = 0;
3855 for (l = group->children; l; l = l->next) {
3856 GstDecodeChain *childchain = l->data;
3858 if (!gst_decode_chain_expose (childchain, endpads, missing_plugin))
3865 /*************************
3866 * GstDecodePad functions
3867 *************************/
3870 gst_decode_pad_class_init (GstDecodePadClass * klass)
3875 gst_decode_pad_init (GstDecodePad * pad)
3878 pad->blocked = FALSE;
3879 pad->exposed = FALSE;
3880 pad->drained = FALSE;
3881 gst_object_ref_sink (pad);
3884 static GstPadProbeReturn
3885 source_pad_blocked_cb (GstPad * pad, GstPadProbeInfo * info, gpointer user_data)
3887 GstDecodePad *dpad = user_data;
3888 GstDecodeChain *chain;
3891 if (GST_PAD_PROBE_INFO_TYPE (info) & GST_PAD_PROBE_TYPE_EVENT_DOWNSTREAM) {
3892 GST_LOG_OBJECT (pad, "Seeing event '%s'",
3893 GST_EVENT_TYPE_NAME (GST_PAD_PROBE_INFO_EVENT (info)));
3895 if (GST_EVENT_TYPE (GST_PAD_PROBE_INFO_EVENT (info)) == GST_EVENT_CAPS) {
3896 /* manually push event to ghost pad to avoid exposing pads
3897 * that don't have the sticky caps event */
3898 gst_pad_push_event (GST_PAD_CAST (dpad),
3899 gst_event_ref (GST_PAD_PROBE_INFO_EVENT (info)));
3900 } else if ((GST_EVENT_IS_STICKY (GST_PAD_PROBE_INFO_EVENT (info))
3901 || !GST_EVENT_IS_SERIALIZED (GST_PAD_PROBE_INFO_EVENT (info)))) {
3902 /* do not block on sticky or out of band events otherwise the allocation query
3903 from demuxer might block the loop thread */
3904 GST_LOG_OBJECT (pad, "Letting event through");
3905 return GST_PAD_PROBE_PASS;
3908 chain = dpad->chain;
3911 GST_LOG_OBJECT (dpad, "blocked: dpad->chain:%p", chain);
3913 dpad->blocked = TRUE;
3916 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
3917 if (!gst_decode_bin_expose (dbin))
3918 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
3920 EXPOSE_UNLOCK (dbin);
3922 /* If we unblocked due to a caps event, let it go through */
3923 if ((GST_PAD_PROBE_INFO_TYPE (info) & GST_PAD_PROBE_TYPE_EVENT_DOWNSTREAM) &&
3924 (GST_EVENT_TYPE (GST_PAD_PROBE_INFO_EVENT (info)) == GST_EVENT_CAPS))
3925 return GST_PAD_PROBE_PASS;
3927 return GST_PAD_PROBE_OK;
3930 static GstPadProbeReturn
3931 source_pad_event_probe (GstPad * pad, GstPadProbeInfo * info,
3934 GstEvent *event = GST_PAD_PROBE_INFO_EVENT (info);
3935 GstDecodePad *dpad = user_data;
3936 gboolean res = TRUE;
3938 GST_LOG_OBJECT (pad, "%s dpad:%p", GST_EVENT_TYPE_NAME (event), dpad);
3940 if (GST_EVENT_TYPE (event) == GST_EVENT_EOS) {
3941 GST_DEBUG_OBJECT (pad, "we received EOS");
3943 /* Check if all pads are drained.
3944 * * If there is no next group, we will let the EOS go through.
3945 * * If there is a next group but the current group isn't completely
3946 * drained, we will drop the EOS event.
3947 * * If there is a next group to expose and this was the last non-drained
3948 * pad for that group, we will remove the ghostpad of the current group
3949 * first, which unlinks the peer and so drops the EOS. */
3950 res = gst_decode_pad_handle_eos (dpad);
3953 return GST_PAD_PROBE_OK;
3955 return GST_PAD_PROBE_DROP;
3959 gst_decode_pad_set_blocked (GstDecodePad * dpad, gboolean blocked)
3961 GstDecodeBin *dbin = dpad->dbin;
3966 GST_DEBUG_OBJECT (dpad, "blocking pad: %d", blocked);
3968 opad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (dpad));
3972 /* do not block if shutting down.
3973 * we do not consider/expect it blocked further below, but use other trick */
3974 if (!blocked || !dbin->shutdown) {
3976 if (dpad->block_id == 0)
3978 gst_pad_add_probe (opad, GST_PAD_PROBE_TYPE_BLOCK_DOWNSTREAM,
3979 source_pad_blocked_cb, gst_object_ref (dpad),
3980 (GDestroyNotify) gst_object_unref);
3982 if (dpad->block_id != 0) {
3983 gst_pad_remove_probe (opad, dpad->block_id);
3986 dpad->blocked = FALSE;
3991 if (dbin->shutdown) {
3992 /* deactivate to force flushing state to prevent NOT_LINKED errors */
3993 gst_pad_set_active (GST_PAD_CAST (dpad), FALSE);
3994 /* note that deactivating the target pad would have no effect here,
3995 * since elements are typically connected first (and pads exposed),
3996 * and only then brought to PAUSED state (so pads activated) */
3998 gst_object_ref (dpad);
3999 dbin->blocked_pads = g_list_prepend (dbin->blocked_pads, dpad);
4004 if ((l = g_list_find (dbin->blocked_pads, dpad))) {
4005 gst_object_unref (dpad);
4006 dbin->blocked_pads = g_list_delete_link (dbin->blocked_pads, l);
4009 gst_object_unref (opad);
4015 gst_decode_pad_add_drained_check (GstDecodePad * dpad)
4017 gst_pad_add_probe (GST_PAD_CAST (dpad), GST_PAD_PROBE_TYPE_EVENT_DOWNSTREAM,
4018 source_pad_event_probe, dpad, NULL);
4022 gst_decode_pad_activate (GstDecodePad * dpad, GstDecodeChain * chain)
4024 g_return_if_fail (chain != NULL);
4026 dpad->chain = chain;
4027 gst_pad_set_active (GST_PAD_CAST (dpad), TRUE);
4028 gst_decode_pad_set_blocked (dpad, TRUE);
4029 gst_decode_pad_add_drained_check (dpad);
4033 gst_decode_pad_unblock (GstDecodePad * dpad)
4035 gst_decode_pad_set_blocked (dpad, FALSE);
4038 /*gst_decode_pad_new:
4040 * Creates a new GstDecodePad for the given pad.
4042 static GstDecodePad *
4043 gst_decode_pad_new (GstDecodeBin * dbin, GstPad * pad, GstDecodeChain * chain)
4046 GstPadTemplate *pad_tmpl;
4048 GST_DEBUG_OBJECT (dbin, "making new decodepad");
4049 pad_tmpl = gst_static_pad_template_get (&decoder_bin_src_template);
4051 g_object_new (GST_TYPE_DECODE_PAD, "direction", GST_PAD_DIRECTION (pad),
4052 "template", pad_tmpl, NULL);
4053 gst_ghost_pad_construct (GST_GHOST_PAD_CAST (dpad));
4054 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
4055 dpad->chain = chain;
4057 gst_object_unref (pad_tmpl);
4063 gst_pending_pad_free (GstPendingPad * ppad)
4066 g_assert (ppad->pad);
4068 if (ppad->event_probe_id != 0)
4069 gst_pad_remove_probe (ppad->pad, ppad->event_probe_id);
4070 gst_object_unref (ppad->pad);
4071 g_slice_free (GstPendingPad, ppad);
4075 * Element add/remove
4079 do_async_start (GstDecodeBin * dbin)
4081 GstMessage *message;
4083 dbin->async_pending = TRUE;
4085 message = gst_message_new_async_start (GST_OBJECT_CAST (dbin));
4086 parent_class->handle_message (GST_BIN_CAST (dbin), message);
4090 do_async_done (GstDecodeBin * dbin)
4092 GstMessage *message;
4094 if (dbin->async_pending) {
4096 gst_message_new_async_done (GST_OBJECT_CAST (dbin),
4097 GST_CLOCK_TIME_NONE);
4098 parent_class->handle_message (GST_BIN_CAST (dbin), message);
4100 dbin->async_pending = FALSE;
4105 * convenience functions
4110 * Returns the first sink pad of the given element, or NULL if it doesn't have
4115 find_sink_pad (GstElement * element)
4119 GValue item = { 0, };
4121 it = gst_element_iterate_sink_pads (element);
4123 if ((gst_iterator_next (it, &item)) == GST_ITERATOR_OK)
4124 pad = g_value_dup_object (&item);
4125 g_value_unset (&item);
4126 gst_iterator_free (it);
4131 /* call with dyn_lock held */
4133 unblock_pads (GstDecodeBin * dbin)
4137 GST_LOG_OBJECT (dbin, "unblocking pads");
4139 for (tmp = dbin->blocked_pads; tmp; tmp = tmp->next) {
4140 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
4143 opad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (dpad));
4147 GST_DEBUG_OBJECT (dpad, "unblocking");
4148 if (dpad->block_id != 0) {
4149 gst_pad_remove_probe (opad, dpad->block_id);
4152 dpad->blocked = FALSE;
4153 /* make flushing, prevent NOT_LINKED */
4154 GST_PAD_SET_FLUSHING (GST_PAD_CAST (dpad));
4155 gst_object_unref (dpad);
4156 gst_object_unref (opad);
4157 GST_DEBUG_OBJECT (dpad, "unblocked");
4160 /* clear, no more blocked pads */
4161 g_list_free (dbin->blocked_pads);
4162 dbin->blocked_pads = NULL;
4165 static GstStateChangeReturn
4166 gst_decode_bin_change_state (GstElement * element, GstStateChange transition)
4168 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
4169 GstDecodeBin *dbin = GST_DECODE_BIN (element);
4171 switch (transition) {
4172 case GST_STATE_CHANGE_NULL_TO_READY:
4173 if (dbin->typefind == NULL)
4174 goto missing_typefind;
4176 case GST_STATE_CHANGE_READY_TO_PAUSED:
4177 /* Make sure we've cleared all existing chains */
4178 if (dbin->decode_chain) {
4179 gst_decode_chain_free (dbin->decode_chain);
4180 dbin->decode_chain = NULL;
4183 GST_LOG_OBJECT (dbin, "clearing shutdown flag");
4184 dbin->shutdown = FALSE;
4186 dbin->have_type = FALSE;
4187 ret = GST_STATE_CHANGE_ASYNC;
4188 do_async_start (dbin);
4190 case GST_STATE_CHANGE_PAUSED_TO_READY:
4192 GST_LOG_OBJECT (dbin, "setting shutdown flag");
4193 dbin->shutdown = TRUE;
4194 unblock_pads (dbin);
4201 GstStateChangeReturn bret;
4203 bret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
4204 if (G_UNLIKELY (bret == GST_STATE_CHANGE_FAILURE))
4205 goto activate_failed;
4206 else if (G_UNLIKELY (bret == GST_STATE_CHANGE_NO_PREROLL)) {
4207 do_async_done (dbin);
4211 switch (transition) {
4212 case GST_STATE_CHANGE_PAUSED_TO_READY:
4213 do_async_done (dbin);
4214 if (dbin->decode_chain) {
4215 gst_decode_chain_free (dbin->decode_chain);
4216 dbin->decode_chain = NULL;
4219 case GST_STATE_CHANGE_READY_TO_NULL:
4229 gst_element_post_message (element,
4230 gst_missing_element_message_new (element, "typefind"));
4231 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL), ("no typefind!"));
4232 return GST_STATE_CHANGE_FAILURE;
4236 GST_DEBUG_OBJECT (element,
4237 "element failed to change states -- activation problem?");
4238 return GST_STATE_CHANGE_FAILURE;
4243 gst_decode_bin_handle_message (GstBin * bin, GstMessage * msg)
4245 GstDecodeBin *dbin = GST_DECODE_BIN (bin);
4246 gboolean drop = FALSE;
4248 if (GST_MESSAGE_TYPE (msg) == GST_MESSAGE_ERROR) {
4249 GST_OBJECT_LOCK (dbin);
4250 drop = (g_list_find (dbin->filtered, GST_MESSAGE_SRC (msg)) != NULL);
4251 GST_OBJECT_UNLOCK (dbin);
4255 gst_message_unref (msg);
4257 GST_BIN_CLASS (parent_class)->handle_message (bin, msg);
4261 gst_decode_bin_plugin_init (GstPlugin * plugin)
4263 GST_DEBUG_CATEGORY_INIT (gst_decode_bin_debug, "decodebin", 0, "decoder bin");
4265 /* Register some quarks here for the stream topology message */
4266 topology_structure_name = g_quark_from_static_string ("stream-topology");
4267 topology_caps = g_quark_from_static_string ("caps");
4268 topology_next = g_quark_from_static_string ("next");
4269 topology_pad = g_quark_from_static_string ("pad");
4270 topology_element_srcpad = g_quark_from_static_string ("element-srcpad");
4272 return gst_element_register (plugin, "decodebin", GST_RANK_NONE,
4273 GST_TYPE_DECODE_BIN);