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., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
24 * SECTION:element-decodebin2
26 * #GstBin that auto-magically constructs a decoding pipeline using available
27 * decoders and demuxers via auto-plugging.
29 * decodebin2 is considered stable now and replaces the old #decodebin element.
30 * #uridecodebin uses decodebin2 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 decodebin2 works internally.
38 * The first part of decodebin2 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 * decodebin2 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 decodebin2 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 decodebin2 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 decodebin2 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!
88 /* FIXME 0.11: suppress warnings for deprecated API such as GStaticRecMutex
89 * with newer GLib versions (>= 2.31.0) */
90 #define GLIB_DISABLE_DEPRECATION_WARNINGS
92 #include <gst/gst-i18n-plugin.h>
96 #include <gst/pbutils/pbutils.h>
98 #include "gstplay-marshal.h"
99 #include "gstplay-enum.h"
100 #include "gstplayback.h"
101 #include "gstrawcaps.h"
103 #include "gst/glib-compat-private.h"
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%d",
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 _GstDecodeBin GstDecodeBin2;
129 typedef struct _GstDecodeBinClass GstDecodeBinClass;
131 #define GST_TYPE_DECODE_BIN (gst_decode_bin_get_type())
132 #define GST_DECODE_BIN_CAST(obj) ((GstDecodeBin*)(obj))
133 #define GST_DECODE_BIN(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DECODE_BIN,GstDecodeBin))
134 #define GST_DECODE_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_DECODE_BIN,GstDecodeBinClass))
135 #define GST_IS_DECODE_BIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DECODE_BIN))
136 #define GST_IS_DECODE_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_DECODE_BIN))
141 * The opaque #DecodeBin2 data structure
145 GstBin bin; /* we extend GstBin */
148 GstCaps *caps; /* caps on which to stop decoding */
149 gchar *encoding; /* encoding of subtitles */
150 gboolean use_buffering; /* configure buffering on multiqueues */
153 guint max_size_bytes;
154 guint max_size_buffers;
155 guint64 max_size_time;
156 gboolean post_stream_topology;
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 gint 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 we fire when a new pad has been decoded into raw audio/video */
191 void (*new_decoded_pad) (GstElement * element, GstPad * pad, gboolean last);
192 /* signal we fire when a pad has been removed */
193 void (*removed_decoded_pad) (GstElement * element, GstPad * pad);
194 /* signal fired when we found a pad that we cannot decode */
195 void (*unknown_type) (GstElement * element, GstPad * pad, GstCaps * caps);
197 /* signal fired to know if we continue trying to decode the given caps */
198 gboolean (*autoplug_continue) (GstElement * element, GstPad * pad,
200 /* signal fired to get a list of factories to try to autoplug */
201 GValueArray *(*autoplug_factories) (GstElement * element, GstPad * pad,
203 /* signal fired to sort the factories */
204 GValueArray *(*autoplug_sort) (GstElement * element, GstPad * pad,
205 GstCaps * caps, GValueArray * factories);
206 /* signal fired to select from the proposed list of factories */
207 GstAutoplugSelectResult (*autoplug_select) (GstElement * element,
208 GstPad * pad, GstCaps * caps, GstElementFactory * factory);
210 /* fired when the last group is drained */
211 void (*drained) (GstElement * element);
217 SIGNAL_NEW_DECODED_PAD,
218 SIGNAL_REMOVED_DECODED_PAD,
220 SIGNAL_AUTOPLUG_CONTINUE,
221 SIGNAL_AUTOPLUG_FACTORIES,
222 SIGNAL_AUTOPLUG_SELECT,
223 SIGNAL_AUTOPLUG_SORT,
228 /* automatic sizes, while prerolling we buffer up to 2MB, we ignore time
229 * and buffers in this case. */
230 #define AUTO_PREROLL_SIZE_BYTES 2 * 1024 * 1024
231 #define AUTO_PREROLL_SIZE_BUFFERS 0
232 #define AUTO_PREROLL_NOT_SEEKABLE_SIZE_TIME 10 * GST_SECOND
233 #define AUTO_PREROLL_SEEKABLE_SIZE_TIME 0
235 /* whan playing, keep a max of 2MB of data but try to keep the number of buffers
236 * as low as possible (try to aim for 5 buffers) */
237 #define AUTO_PLAY_SIZE_BYTES 2 * 1024 * 1024
238 #define AUTO_PLAY_SIZE_BUFFERS 5
239 #define AUTO_PLAY_SIZE_TIME 0
241 #define DEFAULT_SUBTITLE_ENCODING NULL
242 #define DEFAULT_USE_BUFFERING FALSE
243 #define DEFAULT_LOW_PERCENT 10
244 #define DEFAULT_HIGH_PERCENT 99
245 /* by default we use the automatic values above */
246 #define DEFAULT_MAX_SIZE_BYTES 0
247 #define DEFAULT_MAX_SIZE_BUFFERS 0
248 #define DEFAULT_MAX_SIZE_TIME 0
249 #define DEFAULT_POST_STREAM_TOPOLOGY FALSE
250 #define DEFAULT_EXPOSE_ALL_STREAMS TRUE
257 PROP_SUBTITLE_ENCODING,
263 PROP_MAX_SIZE_BUFFERS,
265 PROP_POST_STREAM_TOPOLOGY,
266 PROP_EXPOSE_ALL_STREAMS,
270 static GstBinClass *parent_class;
271 static guint gst_decode_bin_signals[LAST_SIGNAL] = { 0 };
273 static GstStaticCaps default_raw_caps = GST_STATIC_CAPS (DEFAULT_RAW_CAPS);
275 static void do_async_start (GstDecodeBin * dbin);
276 static void do_async_done (GstDecodeBin * dbin);
278 static void type_found (GstElement * typefind, guint probability,
279 GstCaps * caps, GstDecodeBin * decode_bin);
281 static void decodebin_set_queue_size (GstDecodeBin * dbin,
282 GstElement * multiqueue, gboolean preroll, gboolean seekable);
284 static gboolean gst_decode_bin_autoplug_continue (GstElement * element,
285 GstPad * pad, GstCaps * caps);
286 static GValueArray *gst_decode_bin_autoplug_factories (GstElement *
287 element, GstPad * pad, GstCaps * caps);
288 static GValueArray *gst_decode_bin_autoplug_sort (GstElement * element,
289 GstPad * pad, GstCaps * caps, GValueArray * factories);
290 static GstAutoplugSelectResult gst_decode_bin_autoplug_select (GstElement *
291 element, GstPad * pad, GstCaps * caps, GstElementFactory * factory);
293 static void gst_decode_bin_set_property (GObject * object, guint prop_id,
294 const GValue * value, GParamSpec * pspec);
295 static void gst_decode_bin_get_property (GObject * object, guint prop_id,
296 GValue * value, GParamSpec * pspec);
297 static void gst_decode_bin_set_caps (GstDecodeBin * dbin, GstCaps * caps);
298 static GstCaps *gst_decode_bin_get_caps (GstDecodeBin * dbin);
299 static void caps_notify_cb (GstPad * pad, GParamSpec * unused,
300 GstDecodeChain * chain);
302 static GstPad *find_sink_pad (GstElement * element);
303 static GstStateChangeReturn gst_decode_bin_change_state (GstElement * element,
304 GstStateChange transition);
305 static void gst_decode_bin_handle_message (GstBin * bin, GstMessage * message);
307 static gboolean check_upstream_seekable (GstDecodeBin * dbin, GstPad * pad);
309 #define EXPOSE_LOCK(dbin) G_STMT_START { \
310 GST_LOG_OBJECT (dbin, \
311 "expose locking from thread %p", \
313 g_mutex_lock (GST_DECODE_BIN_CAST(dbin)->expose_lock); \
314 GST_LOG_OBJECT (dbin, \
315 "expose locked from thread %p", \
319 #define EXPOSE_UNLOCK(dbin) G_STMT_START { \
320 GST_LOG_OBJECT (dbin, \
321 "expose unlocking from thread %p", \
323 g_mutex_unlock (GST_DECODE_BIN_CAST(dbin)->expose_lock); \
326 #define DYN_LOCK(dbin) G_STMT_START { \
327 GST_LOG_OBJECT (dbin, \
328 "dynlocking from thread %p", \
330 g_mutex_lock (GST_DECODE_BIN_CAST(dbin)->dyn_lock); \
331 GST_LOG_OBJECT (dbin, \
332 "dynlocked from thread %p", \
336 #define DYN_UNLOCK(dbin) G_STMT_START { \
337 GST_LOG_OBJECT (dbin, \
338 "dynunlocking from thread %p", \
340 g_mutex_unlock (GST_DECODE_BIN_CAST(dbin)->dyn_lock); \
343 #define SUBTITLE_LOCK(dbin) G_STMT_START { \
344 GST_LOG_OBJECT (dbin, \
345 "subtitle locking from thread %p", \
347 g_mutex_lock (GST_DECODE_BIN_CAST(dbin)->subtitle_lock); \
348 GST_LOG_OBJECT (dbin, \
349 "subtitle lock from thread %p", \
353 #define SUBTITLE_UNLOCK(dbin) G_STMT_START { \
354 GST_LOG_OBJECT (dbin, \
355 "subtitle unlocking from thread %p", \
357 g_mutex_unlock (GST_DECODE_BIN_CAST(dbin)->subtitle_lock); \
360 struct _GstPendingPad
363 GstDecodeChain *chain;
364 gulong event_probe_id;
367 struct _GstDecodeElement
370 GstElement *capsfilter; /* Optional capsfilter for Parser/Convert */
375 * Streams belonging to the same group/chain of a media file
377 * When changing something here lock the parent chain!
379 struct _GstDecodeGroup
382 GstDecodeChain *parent;
384 GstElement *multiqueue; /* Used for linking all child chains */
385 gulong overrunsig; /* the overrun signal for multiqueue */
387 gboolean overrun; /* TRUE if the multiqueue signaled overrun. This
388 * means that we should really expose the group */
390 gboolean no_more_pads; /* TRUE if the demuxer signaled no-more-pads */
391 gboolean drained; /* TRUE if the all children are drained */
393 GList *children; /* List of GstDecodeChains in this group */
395 GList *reqpads; /* List of RequestPads for multiqueue, there is
396 * exactly one RequestPad per child chain */
399 struct _GstDecodeChain
401 GstDecodeGroup *parent;
404 GMutex *lock; /* Protects this chain and its groups */
406 GstPad *pad; /* srcpad that caused creation of this chain */
408 gboolean drained; /* TRUE if the all children are drained */
409 gboolean demuxer; /* TRUE if elements->data is a demuxer */
410 gboolean seekable; /* TRUE if this chain ends on a demuxer and is seekable */
411 GList *elements; /* All elements in this group, first
412 is the latest and most downstream element */
414 /* Note: there are only groups if the last element of this chain
415 * is a demuxer, otherwise the chain will end with an endpad.
416 * The other way around this means, that endpad only exists if this
417 * chain doesn't end with a demuxer! */
419 GstDecodeGroup *active_group; /* Currently active group */
420 GList *next_groups; /* head is newest group, tail is next group.
421 a new group will be created only if the head
422 group had no-more-pads. If it's only exposed
423 all new pads will be ignored! */
424 GList *pending_pads; /* Pads that have no fixed caps yet */
426 GstDecodePad *endpad; /* Pad of this chain that could be exposed */
427 gboolean deadend; /* This chain is incomplete and can't be completed,
428 e.g. no suitable decoder could be found
429 e.g. stream got EOS without buffers
431 GstCaps *endcaps; /* Caps that were used when linking to the endpad
432 or that resulted in the deadend
435 /* FIXME: This should be done directly via a thread! */
436 GList *old_groups; /* Groups that should be freed later */
439 static void gst_decode_chain_free (GstDecodeChain * chain);
440 static GstDecodeChain *gst_decode_chain_new (GstDecodeBin * dbin,
441 GstDecodeGroup * group, GstPad * pad);
442 static void gst_decode_group_hide (GstDecodeGroup * group);
443 static void gst_decode_group_free (GstDecodeGroup * group);
444 static GstDecodeGroup *gst_decode_group_new (GstDecodeBin * dbin,
445 GstDecodeChain * chain);
446 static gboolean gst_decode_chain_is_complete (GstDecodeChain * chain);
447 static gboolean gst_decode_chain_expose (GstDecodeChain * chain,
448 GList ** endpads, gboolean * missing_plugin);
449 static gboolean gst_decode_chain_is_drained (GstDecodeChain * chain);
450 static gboolean gst_decode_group_is_complete (GstDecodeGroup * group);
451 static GstPad *gst_decode_group_control_demuxer_pad (GstDecodeGroup * group,
453 static gboolean gst_decode_group_is_drained (GstDecodeGroup * group);
455 static gboolean gst_decode_bin_expose (GstDecodeBin * dbin);
457 #define CHAIN_MUTEX_LOCK(chain) G_STMT_START { \
458 GST_LOG_OBJECT (chain->dbin, \
459 "locking chain %p from thread %p", \
460 chain, g_thread_self ()); \
461 g_mutex_lock (chain->lock); \
462 GST_LOG_OBJECT (chain->dbin, \
463 "locked chain %p from thread %p", \
464 chain, g_thread_self ()); \
467 #define CHAIN_MUTEX_UNLOCK(chain) G_STMT_START { \
468 GST_LOG_OBJECT (chain->dbin, \
469 "unlocking chain %p from thread %p", \
470 chain, g_thread_self ()); \
471 g_mutex_unlock (chain->lock); \
476 * GstPad private used for source pads of chains
482 GstDecodeChain *chain;
484 gboolean blocked; /* the *target* pad is blocked */
485 gboolean exposed; /* the pad is exposed */
486 gboolean drained; /* an EOS has been seen on the pad */
489 GType gst_decode_pad_get_type (void);
490 G_DEFINE_TYPE (GstDecodePad, gst_decode_pad, GST_TYPE_GHOST_PAD);
491 #define GST_TYPE_DECODE_PAD (gst_decode_pad_get_type ())
492 #define GST_DECODE_PAD(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DECODE_PAD,GstDecodePad))
494 static GstDecodePad *gst_decode_pad_new (GstDecodeBin * dbin, GstPad * pad,
495 GstDecodeChain * chain);
496 static void gst_decode_pad_activate (GstDecodePad * dpad,
497 GstDecodeChain * chain);
498 static void gst_decode_pad_unblock (GstDecodePad * dpad);
499 static void gst_decode_pad_set_blocked (GstDecodePad * dpad, gboolean blocked);
501 static void gst_pending_pad_free (GstPendingPad * ppad);
502 static gboolean pad_event_cb (GstPad * pad, GstEvent * event, gpointer data);
504 /********************************
505 * Standard GObject boilerplate *
506 ********************************/
508 static void gst_decode_bin_class_init (GstDecodeBinClass * klass);
509 static void gst_decode_bin_init (GstDecodeBin * decode_bin);
510 static void gst_decode_bin_dispose (GObject * object);
511 static void gst_decode_bin_finalize (GObject * object);
514 gst_decode_bin_get_type (void)
516 static GType gst_decode_bin_type = 0;
518 if (!gst_decode_bin_type) {
519 static const GTypeInfo gst_decode_bin_info = {
520 sizeof (GstDecodeBinClass),
523 (GClassInitFunc) gst_decode_bin_class_init,
526 sizeof (GstDecodeBin),
528 (GInstanceInitFunc) gst_decode_bin_init,
532 gst_decode_bin_type =
533 g_type_register_static (GST_TYPE_BIN, "GstDecodeBin2",
534 &gst_decode_bin_info, 0);
537 return gst_decode_bin_type;
541 _gst_boolean_accumulator (GSignalInvocationHint * ihint,
542 GValue * return_accu, const GValue * handler_return, gpointer dummy)
546 myboolean = g_value_get_boolean (handler_return);
547 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
548 g_value_set_boolean (return_accu, myboolean);
550 /* stop emission if FALSE */
554 /* we collect the first result */
556 _gst_array_accumulator (GSignalInvocationHint * ihint,
557 GValue * return_accu, const GValue * handler_return, gpointer dummy)
561 array = g_value_get_boxed (handler_return);
562 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
563 g_value_set_boxed (return_accu, array);
569 _gst_select_accumulator (GSignalInvocationHint * ihint,
570 GValue * return_accu, const GValue * handler_return, gpointer dummy)
572 GstAutoplugSelectResult res;
574 res = g_value_get_enum (handler_return);
575 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
576 g_value_set_enum (return_accu, res);
582 _gst_array_hasvalue_accumulator (GSignalInvocationHint * ihint,
583 GValue * return_accu, const GValue * handler_return, gpointer dummy)
587 array = g_value_get_boxed (handler_return);
588 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
589 g_value_set_boxed (return_accu, array);
598 gst_decode_bin_class_init (GstDecodeBinClass * klass)
600 GObjectClass *gobject_klass;
601 GstElementClass *gstelement_klass;
602 GstBinClass *gstbin_klass;
604 gobject_klass = (GObjectClass *) klass;
605 gstelement_klass = (GstElementClass *) klass;
606 gstbin_klass = (GstBinClass *) klass;
608 parent_class = g_type_class_peek_parent (klass);
610 gobject_klass->dispose = gst_decode_bin_dispose;
611 gobject_klass->finalize = gst_decode_bin_finalize;
612 gobject_klass->set_property = gst_decode_bin_set_property;
613 gobject_klass->get_property = gst_decode_bin_get_property;
616 * GstDecodeBin2::new-decoded-pad:
617 * @bin: The decodebin.
618 * @pad: The newly created pad.
619 * @islast: #TRUE if this is the last pad to be added. Deprecated.
621 * This signal gets emitted as soon as a new pad of the same type as one of
622 * the valid 'raw' types is added.
624 * Deprecated: Use GstElement::pad-added instead of this signal.
627 gst_decode_bin_signals[SIGNAL_NEW_DECODED_PAD] =
628 g_signal_new ("new-decoded-pad", G_TYPE_FROM_CLASS (klass),
630 G_STRUCT_OFFSET (GstDecodeBinClass, new_decoded_pad), NULL, NULL,
631 gst_play_marshal_VOID__OBJECT_BOOLEAN, G_TYPE_NONE, 2, GST_TYPE_PAD,
635 * GstDecodeBin2::removed-decoded-pad:
636 * @bin: The decodebin.
637 * @pad: The pad that was removed.
639 * This signal is emitted when a 'final' caps pad has been removed.
641 * Deprecated: Use GstElement::pad-removed instead of this signal.
644 gst_decode_bin_signals[SIGNAL_REMOVED_DECODED_PAD] =
645 g_signal_new ("removed-decoded-pad", G_TYPE_FROM_CLASS (klass),
647 G_STRUCT_OFFSET (GstDecodeBinClass, removed_decoded_pad), NULL, NULL,
648 gst_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GST_TYPE_PAD);
651 * GstDecodeBin2::unknown-type:
652 * @bin: The decodebin.
653 * @pad: The new pad containing caps that cannot be resolved to a 'final'
655 * @caps: The #GstCaps of the pad that cannot be resolved.
657 * This signal is emitted when a pad for which there is no further possible
658 * decoding is added to the decodebin.
660 gst_decode_bin_signals[SIGNAL_UNKNOWN_TYPE] =
661 g_signal_new ("unknown-type", G_TYPE_FROM_CLASS (klass),
662 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, unknown_type),
663 NULL, NULL, gst_marshal_VOID__OBJECT_BOXED, G_TYPE_NONE, 2,
664 GST_TYPE_PAD, GST_TYPE_CAPS);
667 * GstDecodeBin2::autoplug-continue:
668 * @bin: The decodebin.
670 * @caps: The #GstCaps found.
672 * This signal is emitted whenever decodebin2 finds a new stream. It is
673 * emitted before looking for any elements that can handle that stream.
676 * Invocation of signal handlers stops after the first signal handler
677 * returns #FALSE. Signal handlers are invoked in the order they were
681 * Returns: #TRUE if you wish decodebin2 to look for elements that can
682 * handle the given @caps. If #FALSE, those caps will be considered as
683 * final and the pad will be exposed as such (see 'new-decoded-pad'
686 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE] =
687 g_signal_new ("autoplug-continue", G_TYPE_FROM_CLASS (klass),
688 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_continue),
689 _gst_boolean_accumulator, NULL, gst_play_marshal_BOOLEAN__OBJECT_BOXED,
690 G_TYPE_BOOLEAN, 2, GST_TYPE_PAD, GST_TYPE_CAPS);
693 * GstDecodeBin2::autoplug-factories:
694 * @bin: The decodebin.
696 * @caps: The #GstCaps found.
698 * This function is emitted when an array of possible factories for @caps on
699 * @pad is needed. Decodebin2 will by default return an array with all
700 * compatible factories, sorted by rank.
702 * If this function returns NULL, @pad will be exposed as a final caps.
704 * If this function returns an empty array, the pad will be considered as
705 * having an unhandled type media type.
708 * Only the signal handler that is connected first will ever by invoked.
709 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
710 * signal, they will never be invoked!
713 * Returns: a #GValueArray* with a list of factories to try. The factories are
714 * by default tried in the returned order or based on the index returned by
717 gst_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES] =
718 g_signal_new ("autoplug-factories", G_TYPE_FROM_CLASS (klass),
719 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass,
720 autoplug_factories), _gst_array_accumulator, NULL,
721 gst_play_marshal_BOXED__OBJECT_BOXED, G_TYPE_VALUE_ARRAY, 2,
722 GST_TYPE_PAD, GST_TYPE_CAPS);
725 * GstDecodeBin2::autoplug-sort:
726 * @bin: The decodebin.
728 * @caps: The #GstCaps.
729 * @factories: A #GValueArray of possible #GstElementFactory to use.
731 * Once decodebin2 has found the possible #GstElementFactory objects to try
732 * for @caps on @pad, this signal is emitted. The purpose of the signal is for
733 * the application to perform additional sorting or filtering on the element
736 * The callee should copy and modify @factories or return #NULL if the
737 * order should not change.
740 * Invocation of signal handlers stops after one signal handler has
741 * returned something else than #NULL. Signal handlers are invoked in
742 * the order they were connected in.
743 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
744 * signal, they will never be invoked!
747 * Returns: A new sorted array of #GstElementFactory objects.
749 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SORT] =
750 g_signal_new ("autoplug-sort", G_TYPE_FROM_CLASS (klass),
751 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_sort),
752 _gst_array_hasvalue_accumulator, NULL,
753 gst_play_marshal_BOXED__OBJECT_BOXED_BOXED, G_TYPE_VALUE_ARRAY, 3,
754 GST_TYPE_PAD, GST_TYPE_CAPS, G_TYPE_VALUE_ARRAY);
757 * GstDecodeBin2::autoplug-select:
758 * @bin: The decodebin.
760 * @caps: The #GstCaps.
761 * @factory: A #GstElementFactory to use.
763 * This signal is emitted once decodebin2 has found all the possible
764 * #GstElementFactory that can be used to handle the given @caps. For each of
765 * those factories, this signal is emitted.
767 * The signal handler should return a #GST_TYPE_AUTOPLUG_SELECT_RESULT enum
768 * value indicating what decodebin2 should do next.
770 * A value of #GST_AUTOPLUG_SELECT_TRY will try to autoplug an element from
773 * A value of #GST_AUTOPLUG_SELECT_EXPOSE will expose @pad without plugging
776 * A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the
780 * Only the signal handler that is connected first will ever by invoked.
781 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
782 * signal, they will never be invoked!
785 * Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required
786 * operation. the default handler will always return
787 * #GST_AUTOPLUG_SELECT_TRY.
789 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT] =
790 g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass),
791 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_select),
792 _gst_select_accumulator, NULL,
793 gst_play_marshal_ENUM__OBJECT_BOXED_OBJECT,
794 GST_TYPE_AUTOPLUG_SELECT_RESULT, 3, GST_TYPE_PAD, GST_TYPE_CAPS,
795 GST_TYPE_ELEMENT_FACTORY);
798 * GstDecodeBin2::drained
799 * @bin: The decodebin
801 * This signal is emitted once decodebin2 has finished decoding all the data.
805 gst_decode_bin_signals[SIGNAL_DRAINED] =
806 g_signal_new ("drained", G_TYPE_FROM_CLASS (klass),
807 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, drained),
808 NULL, NULL, gst_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
810 g_object_class_install_property (gobject_klass, PROP_CAPS,
811 g_param_spec_boxed ("caps", "Caps", "The caps on which to stop decoding.",
812 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
814 g_object_class_install_property (gobject_klass, PROP_SUBTITLE_ENCODING,
815 g_param_spec_string ("subtitle-encoding", "subtitle encoding",
816 "Encoding to assume if input subtitles are not in UTF-8 encoding. "
817 "If not set, the GST_SUBTITLE_ENCODING environment variable will "
818 "be checked for an encoding to use. If that is not set either, "
819 "ISO-8859-15 will be assumed.", NULL,
820 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
822 g_object_class_install_property (gobject_klass, PROP_SINK_CAPS,
823 g_param_spec_boxed ("sink-caps", "Sink Caps",
824 "The caps of the input data. (NULL = use typefind element)",
825 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
828 * GstDecodeBin2::use-buffering
830 * Activate buffering in decodebin2. This will instruct the multiqueues behind
831 * decoders to emit BUFFERING messages.
835 g_object_class_install_property (gobject_klass, PROP_USE_BUFFERING,
836 g_param_spec_boolean ("use-buffering", "Use Buffering",
837 "Emit GST_MESSAGE_BUFFERING based on low-/high-percent thresholds",
838 DEFAULT_USE_BUFFERING, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
841 * GstDecodebin2:low-percent
843 * Low threshold percent for buffering to start.
847 g_object_class_install_property (gobject_klass, PROP_LOW_PERCENT,
848 g_param_spec_int ("low-percent", "Low percent",
849 "Low threshold for buffering to start", 0, 100,
850 DEFAULT_LOW_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
852 * GstDecodebin2:high-percent
854 * High threshold percent for buffering to finish.
858 g_object_class_install_property (gobject_klass, PROP_HIGH_PERCENT,
859 g_param_spec_int ("high-percent", "High percent",
860 "High threshold for buffering to finish", 0, 100,
861 DEFAULT_HIGH_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
864 * GstDecodebin2:max-size-bytes
866 * Max amount of bytes in the queue (0=automatic).
870 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_BYTES,
871 g_param_spec_uint ("max-size-bytes", "Max. size (bytes)",
872 "Max. amount of bytes in the queue (0=automatic)",
873 0, G_MAXUINT, DEFAULT_MAX_SIZE_BYTES,
874 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
876 * GstDecodebin2:max-size-buffers
878 * Max amount of buffers in the queue (0=automatic).
882 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_BUFFERS,
883 g_param_spec_uint ("max-size-buffers", "Max. size (buffers)",
884 "Max. number of buffers in the queue (0=automatic)",
885 0, G_MAXUINT, DEFAULT_MAX_SIZE_BUFFERS,
886 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
888 * GstDecodebin2:max-size-time
890 * Max amount of time in the queue (in ns, 0=automatic).
894 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_TIME,
895 g_param_spec_uint64 ("max-size-time", "Max. size (ns)",
896 "Max. amount of data in the queue (in ns, 0=automatic)",
898 DEFAULT_MAX_SIZE_TIME, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
901 * GstDecodeBin2::post-stream-topology
903 * Post stream-topology messages on the bus every time the topology changes.
907 g_object_class_install_property (gobject_klass, PROP_POST_STREAM_TOPOLOGY,
908 g_param_spec_boolean ("post-stream-topology", "Post Stream Topology",
909 "Post stream-topology messages",
910 DEFAULT_POST_STREAM_TOPOLOGY,
911 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
914 * GstDecodeBin2::expose-all-streams
916 * Expose streams of unknown type.
918 * If set to %FALSE, then only the streams that can be decoded to the final
919 * caps (see 'caps' property) will have a pad exposed. Streams that do not
920 * match those caps but could have been decoded will not have decoder plugged
921 * in internally and will not have a pad exposed.
925 g_object_class_install_property (gobject_klass, PROP_EXPOSE_ALL_STREAMS,
926 g_param_spec_boolean ("expose-all-streams", "Expose All Streams",
927 "Expose all streams, including those of unknown type or that don't match the 'caps' property",
928 DEFAULT_EXPOSE_ALL_STREAMS,
929 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
933 klass->autoplug_continue =
934 GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_continue);
935 klass->autoplug_factories =
936 GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_factories);
937 klass->autoplug_sort = GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_sort);
938 klass->autoplug_select = GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_select);
940 gst_element_class_add_static_pad_template (gstelement_klass,
941 &decoder_bin_sink_template);
942 gst_element_class_add_static_pad_template (gstelement_klass,
943 &decoder_bin_src_template);
945 gst_element_class_set_details_simple (gstelement_klass,
946 "Decoder Bin", "Generic/Bin/Decoder",
947 "Autoplug and decode to raw media",
948 "Edward Hervey <edward.hervey@collabora.co.uk>, "
949 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
951 gstelement_klass->change_state =
952 GST_DEBUG_FUNCPTR (gst_decode_bin_change_state);
954 gstbin_klass->handle_message =
955 GST_DEBUG_FUNCPTR (gst_decode_bin_handle_message);
958 /* Must be called with factories lock! */
960 gst_decode_bin_update_factories_list (GstDecodeBin * dbin)
963 || dbin->factories_cookie !=
964 gst_default_registry_get_feature_list_cookie ()) {
966 gst_plugin_feature_list_free (dbin->factories);
968 gst_element_factory_list_get_elements
969 (GST_ELEMENT_FACTORY_TYPE_DECODABLE, GST_RANK_MARGINAL);
970 dbin->factories_cookie = gst_default_registry_get_feature_list_cookie ();
975 gst_decode_bin_init (GstDecodeBin * decode_bin)
977 /* first filter out the interesting element factories */
978 decode_bin->factories_lock = g_mutex_new ();
980 /* we create the typefind element only once */
981 decode_bin->typefind = gst_element_factory_make ("typefind", "typefind");
982 if (!decode_bin->typefind) {
983 g_warning ("can't find typefind element, decodebin will not work");
987 GstPadTemplate *pad_tmpl;
989 /* add the typefind element */
990 if (!gst_bin_add (GST_BIN (decode_bin), decode_bin->typefind)) {
991 g_warning ("Could not add typefind element, decodebin will not work");
992 gst_object_unref (decode_bin->typefind);
993 decode_bin->typefind = NULL;
996 /* get the sinkpad */
997 pad = gst_element_get_static_pad (decode_bin->typefind, "sink");
999 /* get the pad template */
1000 pad_tmpl = gst_static_pad_template_get (&decoder_bin_sink_template);
1002 /* ghost the sink pad to ourself */
1003 gpad = gst_ghost_pad_new_from_template ("sink", pad, pad_tmpl);
1004 gst_pad_set_active (gpad, TRUE);
1005 gst_element_add_pad (GST_ELEMENT (decode_bin), gpad);
1007 gst_object_unref (pad_tmpl);
1008 gst_object_unref (pad);
1010 /* connect a signal to find out when the typefind element found
1012 decode_bin->have_type_id =
1013 g_signal_connect (G_OBJECT (decode_bin->typefind), "have-type",
1014 G_CALLBACK (type_found), decode_bin);
1017 decode_bin->expose_lock = g_mutex_new ();
1018 decode_bin->decode_chain = NULL;
1020 decode_bin->dyn_lock = g_mutex_new ();
1021 decode_bin->shutdown = FALSE;
1022 decode_bin->blocked_pads = NULL;
1024 decode_bin->subtitle_lock = g_mutex_new ();
1026 decode_bin->encoding = g_strdup (DEFAULT_SUBTITLE_ENCODING);
1027 decode_bin->caps = gst_static_caps_get (&default_raw_caps);
1028 decode_bin->use_buffering = DEFAULT_USE_BUFFERING;
1029 decode_bin->low_percent = DEFAULT_LOW_PERCENT;
1030 decode_bin->high_percent = DEFAULT_HIGH_PERCENT;
1032 decode_bin->max_size_bytes = DEFAULT_MAX_SIZE_BYTES;
1033 decode_bin->max_size_buffers = DEFAULT_MAX_SIZE_BUFFERS;
1034 decode_bin->max_size_time = DEFAULT_MAX_SIZE_TIME;
1036 decode_bin->expose_allstreams = DEFAULT_EXPOSE_ALL_STREAMS;
1040 gst_decode_bin_dispose (GObject * object)
1042 GstDecodeBin *decode_bin;
1044 decode_bin = GST_DECODE_BIN (object);
1046 if (decode_bin->factories)
1047 gst_plugin_feature_list_free (decode_bin->factories);
1048 decode_bin->factories = NULL;
1050 if (decode_bin->decode_chain)
1051 gst_decode_chain_free (decode_bin->decode_chain);
1052 decode_bin->decode_chain = NULL;
1054 if (decode_bin->caps)
1055 gst_caps_unref (decode_bin->caps);
1056 decode_bin->caps = NULL;
1058 g_free (decode_bin->encoding);
1059 decode_bin->encoding = NULL;
1061 g_list_free (decode_bin->subtitles);
1062 decode_bin->subtitles = NULL;
1064 G_OBJECT_CLASS (parent_class)->dispose (object);
1068 gst_decode_bin_finalize (GObject * object)
1070 GstDecodeBin *decode_bin;
1072 decode_bin = GST_DECODE_BIN (object);
1074 if (decode_bin->expose_lock) {
1075 g_mutex_free (decode_bin->expose_lock);
1076 decode_bin->expose_lock = NULL;
1079 if (decode_bin->dyn_lock) {
1080 g_mutex_free (decode_bin->dyn_lock);
1081 decode_bin->dyn_lock = NULL;
1084 if (decode_bin->subtitle_lock) {
1085 g_mutex_free (decode_bin->subtitle_lock);
1086 decode_bin->subtitle_lock = NULL;
1089 if (decode_bin->factories_lock) {
1090 g_mutex_free (decode_bin->factories_lock);
1091 decode_bin->factories_lock = NULL;
1094 G_OBJECT_CLASS (parent_class)->finalize (object);
1098 * Changes the caps on which decodebin will stop decoding.
1099 * Will unref the previously set one. The refcount of the given caps will be
1101 * @caps can be NULL.
1106 gst_decode_bin_set_caps (GstDecodeBin * dbin, GstCaps * caps)
1108 GST_DEBUG_OBJECT (dbin, "Setting new caps: %" GST_PTR_FORMAT, caps);
1110 GST_OBJECT_LOCK (dbin);
1111 gst_caps_replace (&dbin->caps, caps);
1112 GST_OBJECT_UNLOCK (dbin);
1116 * Returns the currently configured caps on which decodebin will stop decoding.
1117 * The returned caps (if not NULL), will have its refcount incremented.
1122 gst_decode_bin_get_caps (GstDecodeBin * dbin)
1126 GST_DEBUG_OBJECT (dbin, "Getting currently set caps");
1128 GST_OBJECT_LOCK (dbin);
1131 gst_caps_ref (caps);
1132 GST_OBJECT_UNLOCK (dbin);
1138 gst_decode_bin_set_sink_caps (GstDecodeBin * dbin, GstCaps * caps)
1140 GST_DEBUG_OBJECT (dbin, "Setting new caps: %" GST_PTR_FORMAT, caps);
1142 g_object_set (dbin->typefind, "force-caps", caps, NULL);
1146 gst_decode_bin_get_sink_caps (GstDecodeBin * dbin)
1150 GST_DEBUG_OBJECT (dbin, "Getting currently set caps");
1152 g_object_get (dbin->typefind, "force-caps", &caps, NULL);
1158 gst_decode_bin_set_subs_encoding (GstDecodeBin * dbin, const gchar * encoding)
1162 GST_DEBUG_OBJECT (dbin, "Setting new encoding: %s", GST_STR_NULL (encoding));
1164 SUBTITLE_LOCK (dbin);
1165 g_free (dbin->encoding);
1166 dbin->encoding = g_strdup (encoding);
1168 /* set the subtitle encoding on all added elements */
1169 for (walk = dbin->subtitles; walk; walk = g_list_next (walk)) {
1170 g_object_set (G_OBJECT (walk->data), "subtitle-encoding", dbin->encoding,
1173 SUBTITLE_UNLOCK (dbin);
1177 gst_decode_bin_get_subs_encoding (GstDecodeBin * dbin)
1181 GST_DEBUG_OBJECT (dbin, "Getting currently set encoding");
1183 SUBTITLE_LOCK (dbin);
1184 encoding = g_strdup (dbin->encoding);
1185 SUBTITLE_UNLOCK (dbin);
1191 gst_decode_bin_set_property (GObject * object, guint prop_id,
1192 const GValue * value, GParamSpec * pspec)
1196 dbin = GST_DECODE_BIN (object);
1200 gst_decode_bin_set_caps (dbin, g_value_get_boxed (value));
1202 case PROP_SUBTITLE_ENCODING:
1203 gst_decode_bin_set_subs_encoding (dbin, g_value_get_string (value));
1205 case PROP_SINK_CAPS:
1206 gst_decode_bin_set_sink_caps (dbin, g_value_get_boxed (value));
1208 case PROP_USE_BUFFERING:
1209 dbin->use_buffering = g_value_get_boolean (value);
1211 case PROP_LOW_PERCENT:
1212 dbin->low_percent = g_value_get_int (value);
1214 case PROP_HIGH_PERCENT:
1215 dbin->high_percent = g_value_get_int (value);
1217 case PROP_MAX_SIZE_BYTES:
1218 dbin->max_size_bytes = g_value_get_uint (value);
1220 case PROP_MAX_SIZE_BUFFERS:
1221 dbin->max_size_buffers = g_value_get_uint (value);
1223 case PROP_MAX_SIZE_TIME:
1224 dbin->max_size_time = g_value_get_uint64 (value);
1226 case PROP_POST_STREAM_TOPOLOGY:
1227 dbin->post_stream_topology = g_value_get_boolean (value);
1229 case PROP_EXPOSE_ALL_STREAMS:
1230 dbin->expose_allstreams = g_value_get_boolean (value);
1233 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1239 gst_decode_bin_get_property (GObject * object, guint prop_id,
1240 GValue * value, GParamSpec * pspec)
1244 dbin = GST_DECODE_BIN (object);
1247 g_value_take_boxed (value, gst_decode_bin_get_caps (dbin));
1249 case PROP_SUBTITLE_ENCODING:
1250 g_value_take_string (value, gst_decode_bin_get_subs_encoding (dbin));
1252 case PROP_SINK_CAPS:
1253 g_value_take_boxed (value, gst_decode_bin_get_sink_caps (dbin));
1255 case PROP_USE_BUFFERING:
1256 g_value_set_boolean (value, dbin->use_buffering);
1258 case PROP_LOW_PERCENT:
1259 g_value_set_int (value, dbin->low_percent);
1261 case PROP_HIGH_PERCENT:
1262 g_value_set_int (value, dbin->high_percent);
1264 case PROP_MAX_SIZE_BYTES:
1265 g_value_set_uint (value, dbin->max_size_bytes);
1267 case PROP_MAX_SIZE_BUFFERS:
1268 g_value_set_uint (value, dbin->max_size_buffers);
1270 case PROP_MAX_SIZE_TIME:
1271 g_value_set_uint64 (value, dbin->max_size_time);
1273 case PROP_POST_STREAM_TOPOLOGY:
1274 g_value_set_boolean (value, dbin->post_stream_topology);
1276 case PROP_EXPOSE_ALL_STREAMS:
1277 g_value_set_boolean (value, dbin->expose_allstreams);
1280 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1287 * Default autoplug signal handlers
1290 gst_decode_bin_autoplug_continue (GstElement * element, GstPad * pad,
1293 GST_DEBUG_OBJECT (element, "autoplug-continue returns TRUE");
1295 /* by default we always continue */
1299 static GValueArray *
1300 gst_decode_bin_autoplug_factories (GstElement * element, GstPad * pad,
1304 GValueArray *result;
1305 GstDecodeBin *dbin = GST_DECODE_BIN_CAST (element);
1307 GST_DEBUG_OBJECT (element, "finding factories");
1309 /* return all compatible factories for caps */
1310 g_mutex_lock (dbin->factories_lock);
1311 gst_decode_bin_update_factories_list (dbin);
1313 gst_element_factory_list_filter (dbin->factories, caps, GST_PAD_SINK,
1315 g_mutex_unlock (dbin->factories_lock);
1317 result = g_value_array_new (g_list_length (list));
1318 for (tmp = list; tmp; tmp = tmp->next) {
1319 GstElementFactory *factory = GST_ELEMENT_FACTORY_CAST (tmp->data);
1320 GValue val = { 0, };
1322 g_value_init (&val, G_TYPE_OBJECT);
1323 g_value_set_object (&val, factory);
1324 g_value_array_append (result, &val);
1325 g_value_unset (&val);
1327 gst_plugin_feature_list_free (list);
1329 GST_DEBUG_OBJECT (element, "autoplug-factories returns %p", result);
1334 static GValueArray *
1335 gst_decode_bin_autoplug_sort (GstElement * element, GstPad * pad,
1336 GstCaps * caps, GValueArray * factories)
1341 static GstAutoplugSelectResult
1342 gst_decode_bin_autoplug_select (GstElement * element, GstPad * pad,
1343 GstCaps * caps, GstElementFactory * factory)
1345 GST_DEBUG_OBJECT (element, "default autoplug-select returns TRY");
1348 return GST_AUTOPLUG_SELECT_TRY;
1355 static gboolean are_final_caps (GstDecodeBin * dbin, GstCaps * caps);
1356 static gboolean is_demuxer_element (GstElement * srcelement);
1358 static gboolean connect_pad (GstDecodeBin * dbin, GstElement * src,
1359 GstDecodePad * dpad, GstPad * pad, GstCaps * caps, GValueArray * factories,
1360 GstDecodeChain * chain);
1361 static gboolean connect_element (GstDecodeBin * dbin, GstElement * element,
1362 GstDecodeChain * chain);
1363 static void expose_pad (GstDecodeBin * dbin, GstElement * src,
1364 GstDecodePad * dpad, GstPad * pad, GstCaps * caps, GstDecodeChain * chain);
1366 static void pad_added_cb (GstElement * element, GstPad * pad,
1367 GstDecodeChain * chain);
1368 static void pad_removed_cb (GstElement * element, GstPad * pad,
1369 GstDecodeChain * chain);
1370 static void no_more_pads_cb (GstElement * element, GstDecodeChain * chain);
1372 static GstDecodeGroup *gst_decode_chain_get_current_group (GstDecodeChain *
1375 /* called when a new pad is discovered. It will perform some basic actions
1376 * before trying to link something to it.
1378 * - Check the caps, don't do anything when there are no caps or when they have
1380 * - signal AUTOPLUG_CONTINUE to check if we need to continue autoplugging this
1382 * - if the caps are non-fixed, setup a handler to continue autoplugging when
1383 * the caps become fixed (connect to notify::caps).
1384 * - get list of factories to autoplug.
1385 * - continue autoplugging to one of the factories.
1388 analyze_new_pad (GstDecodeBin * dbin, GstElement * src, GstPad * pad,
1389 GstCaps * caps, GstDecodeChain * chain)
1391 gboolean apcontinue = TRUE;
1392 GValueArray *factories = NULL, *result = NULL;
1394 GstElementFactory *factory;
1395 const gchar *classification;
1396 gboolean is_parser_converter = FALSE;
1399 GST_DEBUG_OBJECT (dbin, "Pad %s:%s caps:%" GST_PTR_FORMAT,
1400 GST_DEBUG_PAD_NAME (pad), caps);
1403 && src != ((GstDecodeElement *) chain->elements->data)->element
1404 && src != ((GstDecodeElement *) chain->elements->data)->capsfilter) {
1405 GST_ERROR_OBJECT (dbin, "New pad from not the last element in this chain");
1409 if (chain->endpad) {
1410 GST_ERROR_OBJECT (dbin, "New pad in a chain that is already complete");
1414 if (chain->demuxer) {
1415 GstDecodeGroup *group;
1416 GstDecodeChain *oldchain = chain;
1418 /* we are adding a new pad for a demuxer (see is_demuxer_element(),
1419 * start a new chain for it */
1420 CHAIN_MUTEX_LOCK (oldchain);
1421 group = gst_decode_chain_get_current_group (chain);
1423 chain = gst_decode_chain_new (dbin, group, pad);
1424 group->children = g_list_prepend (group->children, chain);
1426 CHAIN_MUTEX_UNLOCK (oldchain);
1428 GST_WARNING_OBJECT (dbin, "No current group");
1433 if ((caps == NULL) || gst_caps_is_empty (caps))
1436 if (gst_caps_is_any (caps))
1439 dpad = gst_decode_pad_new (dbin, pad, chain);
1441 /* 1. Emit 'autoplug-continue' the result will tell us if this pads needs
1442 * further autoplugging. Only do this for fixed caps, for unfixed caps
1443 * we will later come here again from the notify::caps handler. The
1444 * problem with unfixed caps is that we can reliably tell if the output
1445 * is e.g. accepted by a sink because only parts of the possible final
1446 * caps might be accepted by the sink. */
1447 if (gst_caps_is_fixed (caps))
1448 g_signal_emit (G_OBJECT (dbin),
1449 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, dpad, caps,
1454 /* 1.a if autoplug-continue is FALSE or caps is a raw format, goto pad_is_final */
1455 if ((!apcontinue) || are_final_caps (dbin, caps))
1458 /* 1.b For Parser/Converter that can output different stream formats
1459 * we insert a capsfilter with the sorted caps of all possible next
1460 * elements and continue with the capsfilter srcpad */
1461 factory = gst_element_get_factory (src);
1462 classification = gst_element_factory_get_klass (factory);
1463 is_parser_converter = (strstr (classification, "Parser")
1464 && strstr (classification, "Converter"));
1466 /* 1.c when the caps are not fixed yet, we can't be sure what element to
1467 * connect. We delay autoplugging until the caps are fixed */
1468 if (!is_parser_converter && !gst_caps_is_fixed (caps))
1471 /* 1.d else get the factories and if there's no compatible factory goto
1473 g_signal_emit (G_OBJECT (dbin),
1474 gst_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES], 0, dpad, caps,
1477 /* NULL means that we can expose the pad */
1478 if (factories == NULL)
1481 /* if the array is empty, we have a type for which we have no decoder */
1482 if (factories->n_values == 0) {
1483 if (!dbin->expose_allstreams) {
1484 GstCaps *raw = gst_static_caps_get (&default_raw_caps);
1486 /* If the caps are raw, this just means we don't want to expose them */
1487 if (gst_caps_can_intersect (raw, caps)) {
1488 g_value_array_free (factories);
1489 gst_caps_unref (raw);
1490 gst_object_unref (dpad);
1491 goto discarded_type;
1493 gst_caps_unref (raw);
1496 /* if not we have a unhandled type with no compatible factories */
1497 g_value_array_free (factories);
1498 gst_object_unref (dpad);
1502 /* 1.e sort some more. */
1503 g_signal_emit (G_OBJECT (dbin),
1504 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SORT], 0, dpad, caps, factories,
1507 g_value_array_free (factories);
1511 /* At this point we have a potential decoder, but we might not need it
1512 * if it doesn't match the output caps */
1513 if (!dbin->expose_allstreams && gst_caps_is_fixed (caps)) {
1516 gboolean dontuse = FALSE;
1518 GST_DEBUG ("Checking if we can abort early");
1520 /* 1.f Do an early check to see if the candidates are potential decoders, but
1521 * due to the fact that they decode to a mediatype that is not final we don't
1524 for (i = 0; i < factories->n_values && !dontuse; i++) {
1525 GstElementFactory *factory =
1526 g_value_get_object (g_value_array_get_nth (factories, i));
1529 /* We are only interested in skipping decoders */
1530 if (strstr (gst_element_factory_get_klass (factory), "Decoder")) {
1532 GST_DEBUG ("Trying factory %s",
1533 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1535 /* Check the source pad template caps to see if they match raw caps but don't match
1537 for (tmps = gst_element_factory_get_static_pad_templates (factory);
1538 tmps && !dontuse; tmps = tmps->next) {
1539 GstStaticPadTemplate *st = (GstStaticPadTemplate *) tmps->data;
1540 if (st->direction != GST_PAD_SRC)
1542 tcaps = gst_static_pad_template_get_caps (st);
1546 /* Emit autoplug-continue to see if the caps are considered to be raw caps */
1547 g_signal_emit (G_OBJECT (dbin),
1548 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, dpad, tcaps,
1551 /* If autoplug-continue returns TRUE and the caps are not final, don't use them */
1552 if (apcontinue && !are_final_caps (dbin, tcaps))
1554 gst_caps_unref (tcaps);
1560 gst_object_unref (dpad);
1561 g_value_array_free (factories);
1562 goto discarded_type;
1566 /* 1.g now get the factory template caps and insert the capsfilter if this
1567 * is a parser/converter
1569 if (is_parser_converter) {
1570 GstCaps *filter_caps;
1573 GstDecodeElement *delem;
1575 g_assert (chain->elements != NULL);
1576 delem = (GstDecodeElement *) chain->elements->data;
1578 filter_caps = gst_caps_new_empty ();
1579 for (i = 0; i < factories->n_values; i++) {
1580 GstElementFactory *factory =
1581 g_value_get_object (g_value_array_get_nth (factories, i));
1582 GstCaps *tcaps, *intersection;
1585 GST_DEBUG ("Trying factory %s",
1586 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1588 if (gst_element_get_factory (src) == factory) {
1589 GST_DEBUG ("Skipping factory");
1593 for (tmps = gst_element_factory_get_static_pad_templates (factory); tmps;
1594 tmps = tmps->next) {
1595 GstStaticPadTemplate *st = (GstStaticPadTemplate *) tmps->data;
1596 if (st->direction != GST_PAD_SINK || st->presence != GST_PAD_ALWAYS)
1598 tcaps = gst_static_pad_template_get_caps (st);
1600 gst_caps_intersect_full (tcaps, caps, GST_CAPS_INTERSECT_FIRST);
1601 gst_caps_merge (filter_caps, intersection);
1602 gst_caps_unref (tcaps);
1606 /* Append the parser caps to prevent any not-negotiated errors */
1607 gst_caps_merge (filter_caps, gst_caps_copy (caps));
1609 delem->capsfilter = gst_element_factory_make ("capsfilter", NULL);
1610 g_object_set (G_OBJECT (delem->capsfilter), "caps", filter_caps, NULL);
1611 gst_caps_unref (filter_caps);
1612 gst_element_set_state (delem->capsfilter, GST_STATE_PAUSED);
1613 gst_bin_add (GST_BIN_CAST (dbin), gst_object_ref (delem->capsfilter));
1615 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1616 p = gst_element_get_static_pad (delem->capsfilter, "sink");
1617 gst_pad_link_full (pad, p, GST_PAD_LINK_CHECK_NOTHING);
1618 gst_object_unref (p);
1619 p = gst_element_get_static_pad (delem->capsfilter, "src");
1620 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), p);
1623 if (!gst_caps_is_fixed (caps)) {
1624 g_value_array_free (factories);
1629 /* 1.h else continue autoplugging something from the list. */
1630 GST_LOG_OBJECT (pad, "Let's continue discovery on this pad");
1631 res = connect_pad (dbin, src, dpad, pad, caps, factories, chain);
1633 /* Need to unref the capsfilter srcpad here if
1634 * we inserted a capsfilter */
1635 if (is_parser_converter)
1636 gst_object_unref (pad);
1638 gst_object_unref (dpad);
1639 g_value_array_free (factories);
1648 GST_LOG_OBJECT (dbin, "Pad is final. autoplug-continue:%d", apcontinue);
1649 expose_pad (dbin, src, dpad, pad, caps, chain);
1650 gst_object_unref (dpad);
1656 GST_LOG_OBJECT (pad, "Known type, but discarded because not final caps");
1657 chain->deadend = TRUE;
1658 chain->endcaps = gst_caps_ref (caps);
1660 /* Try to expose anything */
1662 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
1663 gst_decode_bin_expose (dbin);
1665 EXPOSE_UNLOCK (dbin);
1666 do_async_done (dbin);
1673 GST_LOG_OBJECT (pad, "Unknown type, posting message and firing signal");
1675 chain->deadend = TRUE;
1676 chain->endcaps = gst_caps_ref (caps);
1678 gst_element_post_message (GST_ELEMENT_CAST (dbin),
1679 gst_missing_decoder_message_new (GST_ELEMENT_CAST (dbin), caps));
1681 g_signal_emit (G_OBJECT (dbin),
1682 gst_decode_bin_signals[SIGNAL_UNKNOWN_TYPE], 0, pad, caps);
1684 /* Try to expose anything */
1686 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
1687 gst_decode_bin_expose (dbin);
1689 EXPOSE_UNLOCK (dbin);
1691 if (src == dbin->typefind) {
1694 if (caps && !gst_caps_is_empty (caps)) {
1695 desc = gst_pb_utils_get_decoder_description (caps);
1696 GST_ELEMENT_ERROR (dbin, STREAM, CODEC_NOT_FOUND,
1697 (_("A %s plugin is required to play this stream, "
1698 "but not installed."), desc),
1699 ("No decoder to handle media type '%s'",
1700 gst_structure_get_name (gst_caps_get_structure (caps, 0))));
1703 GST_ELEMENT_ERROR (dbin, STREAM, TYPE_NOT_FOUND,
1704 (_("Could not determine type of stream")),
1705 ("Stream caps %" GST_PTR_FORMAT, caps));
1707 do_async_done (dbin);
1713 GST_DEBUG_OBJECT (pad, "pad has non-fixed caps delay autoplugging");
1714 gst_object_unref (dpad);
1715 goto setup_caps_delay;
1719 GST_WARNING_OBJECT (pad,
1720 "pad has ANY caps, not able to autoplug to anything");
1721 goto setup_caps_delay;
1725 GstPendingPad *ppad;
1727 /* connect to caps notification */
1728 CHAIN_MUTEX_LOCK (chain);
1729 GST_LOG_OBJECT (dbin, "Chain %p has now %d dynamic pads", chain,
1730 g_list_length (chain->pending_pads));
1731 ppad = g_slice_new0 (GstPendingPad);
1732 ppad->pad = gst_object_ref (pad);
1733 ppad->chain = chain;
1734 ppad->event_probe_id =
1735 gst_pad_add_event_probe (pad, (GCallback) pad_event_cb, ppad);
1736 chain->pending_pads = g_list_prepend (chain->pending_pads, ppad);
1737 g_signal_connect (G_OBJECT (pad), "notify::caps",
1738 G_CALLBACK (caps_notify_cb), chain);
1739 CHAIN_MUTEX_UNLOCK (chain);
1741 /* If we're here because we have a Parser/Converter
1742 * we have to unref the pad */
1743 if (is_parser_converter)
1744 gst_object_unref (pad);
1751 add_error_filter (GstDecodeBin * dbin, GstElement * element)
1753 GST_OBJECT_LOCK (dbin);
1754 dbin->filtered = g_list_prepend (dbin->filtered, element);
1755 GST_OBJECT_UNLOCK (dbin);
1759 remove_error_filter (GstDecodeBin * dbin, GstElement * element)
1761 GST_OBJECT_LOCK (dbin);
1762 dbin->filtered = g_list_remove (dbin->filtered, element);
1763 GST_OBJECT_UNLOCK (dbin);
1768 * Try to connect the given pad to an element created from one of the factories,
1771 * Note that dpad is ghosting pad, and so pad is linked; be sure to unset dpad's
1772 * target before trying to link pad.
1774 * Returns TRUE if an element was properly created and linked
1777 connect_pad (GstDecodeBin * dbin, GstElement * src, GstDecodePad * dpad,
1778 GstPad * pad, GstCaps * caps, GValueArray * factories,
1779 GstDecodeChain * chain)
1781 gboolean res = FALSE;
1782 GstPad *mqpad = NULL;
1783 gboolean is_demuxer = chain->parent && !chain->elements; /* First pad after the demuxer */
1785 g_return_val_if_fail (factories != NULL, FALSE);
1786 g_return_val_if_fail (factories->n_values > 0, FALSE);
1788 GST_DEBUG_OBJECT (dbin, "pad %s:%s , chain:%p",
1789 GST_DEBUG_PAD_NAME (pad), chain);
1791 /* 1. is element demuxer or parser */
1793 GST_LOG_OBJECT (src,
1794 "is a demuxer, connecting the pad through multiqueue '%s'",
1795 GST_OBJECT_NAME (chain->parent->multiqueue));
1797 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1798 if (!(mqpad = gst_decode_group_control_demuxer_pad (chain->parent, pad)))
1800 src = chain->parent->multiqueue;
1802 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
1805 /* 2. Try to create an element and link to it */
1806 while (factories->n_values > 0) {
1807 GstAutoplugSelectResult ret;
1808 GstElementFactory *factory;
1809 GstDecodeElement *delem;
1810 GstElement *element;
1814 /* Set dpad target to pad again, it might've been unset
1815 * below but we came back here because something failed
1817 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
1819 /* take first factory */
1820 factory = g_value_get_object (g_value_array_get_nth (factories, 0));
1821 /* Remove selected factory from the list. */
1822 g_value_array_remove (factories, 0);
1824 /* If the factory is for a parser we first check if the factory
1825 * was already used for the current chain. If it was used already
1826 * we would otherwise create an infinite loop here because the
1827 * parser apparently accepts its own output as input.
1828 * This is only done for parsers because it's perfectly valid
1829 * to have other element classes after each other because a
1830 * parser is the only one that does not change the data. A
1831 * valid example for this would be multiple id3demux in a row.
1833 if (strstr (gst_element_factory_get_klass (factory), "Parser")) {
1834 gboolean skip = FALSE;
1837 CHAIN_MUTEX_LOCK (chain);
1838 for (l = chain->elements; l; l = l->next) {
1839 GstDecodeElement *delem = (GstDecodeElement *) l->data;
1840 GstElement *otherelement = delem->element;
1842 if (gst_element_get_factory (otherelement) == factory) {
1847 CHAIN_MUTEX_UNLOCK (chain);
1849 GST_DEBUG_OBJECT (dbin,
1850 "Skipping factory '%s' because it was already used in this chain",
1851 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE_CAST (factory)));
1856 /* emit autoplug-select to see what we should do with it. */
1857 g_signal_emit (G_OBJECT (dbin),
1858 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT],
1859 0, dpad, caps, factory, &ret);
1862 case GST_AUTOPLUG_SELECT_TRY:
1863 GST_DEBUG_OBJECT (dbin, "autoplug select requested try");
1865 case GST_AUTOPLUG_SELECT_EXPOSE:
1866 GST_DEBUG_OBJECT (dbin, "autoplug select requested expose");
1867 /* expose the pad, we don't have the source element */
1868 expose_pad (dbin, src, dpad, pad, caps, chain);
1871 case GST_AUTOPLUG_SELECT_SKIP:
1872 GST_DEBUG_OBJECT (dbin, "autoplug select requested skip");
1875 GST_WARNING_OBJECT (dbin, "autoplug select returned unhandled %d", ret);
1879 /* 2.0. Unlink pad */
1880 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1882 /* 2.1. Try to create an element */
1883 if ((element = gst_element_factory_create (factory, NULL)) == NULL) {
1884 GST_WARNING_OBJECT (dbin, "Could not create an element from %s",
1885 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1889 /* Filter errors, this will prevent the element from causing the pipeline
1890 * to error while we test it using READY state. */
1891 add_error_filter (dbin, element);
1893 /* ... add it ... */
1894 if (!(gst_bin_add (GST_BIN_CAST (dbin), element))) {
1895 GST_WARNING_OBJECT (dbin, "Couldn't add %s to the bin",
1896 GST_ELEMENT_NAME (element));
1897 remove_error_filter (dbin, element);
1898 gst_object_unref (element);
1902 /* Find its sink pad. */
1903 if (!(sinkpad = find_sink_pad (element))) {
1904 GST_WARNING_OBJECT (dbin, "Element %s doesn't have a sink pad",
1905 GST_ELEMENT_NAME (element));
1906 remove_error_filter (dbin, element);
1907 gst_bin_remove (GST_BIN (dbin), element);
1911 /* ... and try to link */
1912 if ((gst_pad_link (pad, sinkpad)) != GST_PAD_LINK_OK) {
1913 GST_WARNING_OBJECT (dbin, "Link failed on pad %s:%s",
1914 GST_DEBUG_PAD_NAME (sinkpad));
1915 remove_error_filter (dbin, element);
1916 gst_object_unref (sinkpad);
1917 gst_bin_remove (GST_BIN (dbin), element);
1921 /* ... activate it ... */
1922 if ((gst_element_set_state (element,
1923 GST_STATE_READY)) == GST_STATE_CHANGE_FAILURE) {
1924 GST_WARNING_OBJECT (dbin, "Couldn't set %s to READY",
1925 GST_ELEMENT_NAME (element));
1926 remove_error_filter (dbin, element);
1927 gst_object_unref (sinkpad);
1928 gst_bin_remove (GST_BIN (dbin), element);
1932 /* Stop filtering errors. */
1933 remove_error_filter (dbin, element);
1935 gst_object_unref (sinkpad);
1936 GST_LOG_OBJECT (dbin, "linked on pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1938 CHAIN_MUTEX_LOCK (chain);
1939 delem = g_slice_new (GstDecodeElement);
1940 delem->element = gst_object_ref (element);
1941 delem->capsfilter = NULL;
1942 chain->elements = g_list_prepend (chain->elements, delem);
1943 chain->demuxer = is_demuxer_element (element);
1944 CHAIN_MUTEX_UNLOCK (chain);
1946 /* link this element further */
1947 connect_element (dbin, element, chain);
1949 /* try to configure the subtitle encoding property when we can */
1950 if (g_object_class_find_property (G_OBJECT_GET_CLASS (element),
1951 "subtitle-encoding")) {
1952 SUBTITLE_LOCK (dbin);
1953 GST_DEBUG_OBJECT (dbin,
1954 "setting subtitle-encoding=%s to element", dbin->encoding);
1955 g_object_set (G_OBJECT (element), "subtitle-encoding", dbin->encoding,
1957 SUBTITLE_UNLOCK (dbin);
1962 /* Bring the element to the state of the parent */
1963 if ((gst_element_set_state (element,
1964 GST_STATE_PAUSED)) == GST_STATE_CHANGE_FAILURE) {
1965 GstDecodeElement *dtmp = NULL;
1966 GstElement *tmp = NULL;
1968 GST_WARNING_OBJECT (dbin, "Couldn't set %s to PAUSED",
1969 GST_ELEMENT_NAME (element));
1971 /* Remove all elements in this chain that were just added. No
1972 * other thread could've added elements in the meantime */
1973 CHAIN_MUTEX_LOCK (chain);
1977 dtmp = chain->elements->data;
1978 tmp = dtmp->element;
1980 /* Disconnect any signal handlers that might be connected
1981 * in connect_element() or analyze_pad() */
1982 g_signal_handlers_disconnect_by_func (tmp, pad_added_cb, chain);
1983 g_signal_handlers_disconnect_by_func (tmp, pad_removed_cb, chain);
1984 g_signal_handlers_disconnect_by_func (tmp, no_more_pads_cb, chain);
1986 for (l = chain->pending_pads; l;) {
1987 GstPendingPad *pp = l->data;
1990 if (GST_PAD_PARENT (pp->pad) != tmp) {
1995 g_signal_handlers_disconnect_by_func (pp->pad, caps_notify_cb, chain);
1996 gst_pad_remove_event_probe (pp->pad, pp->event_probe_id);
1997 gst_object_unref (pp->pad);
1998 g_slice_free (GstPendingPad, pp);
2000 /* Remove element from the list, update list head and go to the
2001 * next element in the list */
2003 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2007 if (dtmp->capsfilter) {
2008 gst_bin_remove (GST_BIN (dbin), dtmp->capsfilter);
2009 gst_element_set_state (dtmp->capsfilter, GST_STATE_NULL);
2010 gst_object_unref (dtmp->capsfilter);
2013 gst_bin_remove (GST_BIN (dbin), tmp);
2014 gst_element_set_state (tmp, GST_STATE_NULL);
2016 gst_object_unref (tmp);
2017 g_slice_free (GstDecodeElement, dtmp);
2019 chain->elements = g_list_delete_link (chain->elements, chain->elements);
2020 } while (tmp != element);
2021 CHAIN_MUTEX_UNLOCK (chain);
2026 SUBTITLE_LOCK (dbin);
2027 /* we added the element now, add it to the list of subtitle-encoding
2028 * elements when we can set the property */
2029 dbin->subtitles = g_list_prepend (dbin->subtitles, element);
2030 SUBTITLE_UNLOCK (dbin);
2039 gst_object_unref (mqpad);
2045 get_pad_caps (GstPad * pad)
2049 /* first check the pad caps, if this is set, we are positively sure it is
2050 * fixed and exactly what the element will produce. */
2051 GST_OBJECT_LOCK (pad);
2052 if ((caps = GST_PAD_CAPS (pad)))
2053 gst_caps_ref (caps);
2054 GST_OBJECT_UNLOCK (pad);
2056 /* then use the getcaps function if we don't have caps. These caps might not
2057 * be fixed in some cases, in which case analyze_new_pad will set up a
2058 * notify::caps signal to continue autoplugging. */
2060 caps = gst_pad_get_caps_reffed (pad);
2066 connect_element (GstDecodeBin * dbin, GstElement * element,
2067 GstDecodeChain * chain)
2070 gboolean res = TRUE;
2071 gboolean dynamic = FALSE;
2072 GList *to_connect = NULL;
2074 GST_DEBUG_OBJECT (dbin, "Attempting to connect element %s [chain:%p] further",
2075 GST_ELEMENT_NAME (element), chain);
2077 /* 1. Loop over pad templates, grabbing existing pads along the way */
2078 for (pads = GST_ELEMENT_GET_CLASS (element)->padtemplates; pads;
2079 pads = g_list_next (pads)) {
2080 GstPadTemplate *templ = GST_PAD_TEMPLATE (pads->data);
2081 const gchar *templ_name;
2083 /* we are only interested in source pads */
2084 if (GST_PAD_TEMPLATE_DIRECTION (templ) != GST_PAD_SRC)
2087 templ_name = GST_PAD_TEMPLATE_NAME_TEMPLATE (templ);
2088 GST_DEBUG_OBJECT (dbin, "got a source pad template %s", templ_name);
2090 /* figure out what kind of pad this is */
2091 switch (GST_PAD_TEMPLATE_PRESENCE (templ)) {
2092 case GST_PAD_ALWAYS:
2094 /* get the pad that we need to autoplug */
2095 GstPad *pad = gst_element_get_static_pad (element, templ_name);
2098 GST_DEBUG_OBJECT (dbin, "got the pad for always template %s",
2100 /* here is the pad, we need to autoplug it */
2101 to_connect = g_list_prepend (to_connect, pad);
2103 /* strange, pad is marked as always but it's not
2104 * there. Fix the element */
2105 GST_WARNING_OBJECT (dbin,
2106 "could not get the pad for always template %s", templ_name);
2110 case GST_PAD_SOMETIMES:
2112 /* try to get the pad to see if it is already created or
2114 GstPad *pad = gst_element_get_static_pad (element, templ_name);
2117 GST_DEBUG_OBJECT (dbin, "got the pad for sometimes template %s",
2119 /* the pad is created, we need to autoplug it */
2120 to_connect = g_list_prepend (to_connect, pad);
2122 GST_DEBUG_OBJECT (dbin,
2123 "did not get the sometimes pad of template %s", templ_name);
2124 /* we have an element that will create dynamic pads */
2129 case GST_PAD_REQUEST:
2130 /* ignore request pads */
2131 GST_DEBUG_OBJECT (dbin, "ignoring request padtemplate %s", templ_name);
2136 /* 2. if there are more potential pads, connect to relevant signals */
2138 GST_LOG_OBJECT (dbin, "Adding signals to element %s in chain %p",
2139 GST_ELEMENT_NAME (element), chain);
2140 g_signal_connect (G_OBJECT (element), "pad-added",
2141 G_CALLBACK (pad_added_cb), chain);
2142 g_signal_connect (G_OBJECT (element), "pad-removed",
2143 G_CALLBACK (pad_removed_cb), chain);
2144 g_signal_connect (G_OBJECT (element), "no-more-pads",
2145 G_CALLBACK (no_more_pads_cb), chain);
2148 /* 3. for every available pad, connect it */
2149 for (pads = to_connect; pads; pads = g_list_next (pads)) {
2150 GstPad *pad = GST_PAD_CAST (pads->data);
2153 caps = get_pad_caps (pad);
2154 analyze_new_pad (dbin, element, pad, caps, chain);
2156 gst_caps_unref (caps);
2158 gst_object_unref (pad);
2160 g_list_free (to_connect);
2167 * Expose the given pad on the chain as a decoded pad.
2170 expose_pad (GstDecodeBin * dbin, GstElement * src, GstDecodePad * dpad,
2171 GstPad * pad, GstCaps * caps, GstDecodeChain * chain)
2173 GstPad *mqpad = NULL;
2175 GST_DEBUG_OBJECT (dbin, "pad %s:%s, chain:%p",
2176 GST_DEBUG_PAD_NAME (pad), chain);
2178 /* If this is the first pad for this chain, there are no other elements
2179 * and the source element is not the multiqueue we must link through the
2182 * This is the case if a demuxer directly exposed a raw pad.
2184 if (chain->parent && !chain->elements && src != chain->parent->multiqueue) {
2185 GST_LOG_OBJECT (src, "connecting the pad through multiqueue");
2187 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
2188 if (!(mqpad = gst_decode_group_control_demuxer_pad (chain->parent, pad)))
2191 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
2194 gst_decode_pad_activate (dpad, chain);
2195 chain->endpad = gst_object_ref (dpad);
2196 chain->endcaps = gst_caps_ref (caps);
2199 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2200 gst_decode_bin_expose (dbin);
2202 EXPOSE_UNLOCK (dbin);
2205 gst_object_unref (mqpad);
2211 /* check_upstream_seekable:
2213 * Check if upstream is seekable.
2216 check_upstream_seekable (GstDecodeBin * dbin, GstPad * pad)
2219 gint64 start = -1, stop = -1;
2220 gboolean seekable = FALSE;
2222 query = gst_query_new_seeking (GST_FORMAT_BYTES);
2223 if (!gst_pad_peer_query (pad, query)) {
2224 GST_DEBUG_OBJECT (dbin, "seeking query failed");
2225 gst_query_unref (query);
2229 gst_query_parse_seeking (query, NULL, &seekable, &start, &stop);
2231 gst_query_unref (query);
2233 /* try harder to query upstream size if we didn't get it the first time */
2234 if (seekable && stop == -1) {
2235 GstFormat fmt = GST_FORMAT_BYTES;
2237 GST_DEBUG_OBJECT (dbin, "doing duration query to fix up unset stop");
2238 gst_pad_query_peer_duration (pad, &fmt, &stop);
2241 /* if upstream doesn't know the size, it's likely that it's not seekable in
2242 * practice even if it technically may be seekable */
2243 if (seekable && (start != 0 || stop <= start)) {
2244 GST_DEBUG_OBJECT (dbin, "seekable but unknown start/stop -> disable");
2248 GST_DEBUG_OBJECT (dbin, "upstream seekable: %d", seekable);
2253 type_found (GstElement * typefind, guint probability,
2254 GstCaps * caps, GstDecodeBin * decode_bin)
2256 GstPad *pad, *sink_pad;
2258 GST_DEBUG_OBJECT (decode_bin, "typefind found caps %" GST_PTR_FORMAT, caps);
2260 /* If the typefinder (but not something else) finds text/plain - i.e. that's
2261 * the top-level type of the file - then error out.
2263 if (gst_structure_has_name (gst_caps_get_structure (caps, 0), "text/plain")) {
2264 GST_ELEMENT_ERROR (decode_bin, STREAM, WRONG_TYPE,
2265 (_("This appears to be a text file")),
2266 ("decodebin2 cannot decode plain text files"));
2270 #ifdef GST_EXT_DECODEBIN2_QUEUESIZE
2271 if (gst_structure_has_name (gst_caps_get_structure (caps, 0), "application/x-hls") ||
2272 gst_structure_has_name (gst_caps_get_structure (caps, 0), "application/x-ss")) {
2273 GST_DEBUG_OBJECT (decode_bin, "decodebin2 got hls/ss caps.. set queue max-size-time to 1 sec");
2274 decode_bin->max_size_time = 1 * GST_SECOND;
2278 /* FIXME: we can only deal with one type, we don't yet support dynamically changing
2279 * caps from the typefind element */
2280 if (decode_bin->have_type || decode_bin->decode_chain)
2283 decode_bin->have_type = TRUE;
2285 pad = gst_element_get_static_pad (typefind, "src");
2286 sink_pad = gst_element_get_static_pad (typefind, "sink");
2288 /* need some lock here to prevent race with shutdown state change
2289 * which might yank away e.g. decode_chain while building stuff here.
2290 * In typical cases, STREAM_LOCK is held and handles that, it need not
2291 * be held (if called from a proxied setcaps), so grab it anyway */
2292 GST_PAD_STREAM_LOCK (sink_pad);
2293 decode_bin->decode_chain = gst_decode_chain_new (decode_bin, NULL, pad);
2294 analyze_new_pad (decode_bin, typefind, pad, caps, decode_bin->decode_chain);
2295 GST_PAD_STREAM_UNLOCK (sink_pad);
2297 gst_object_unref (sink_pad);
2298 gst_object_unref (pad);
2305 pad_event_cb (GstPad * pad, GstEvent * event, gpointer data)
2307 GstPendingPad *ppad = (GstPendingPad *) data;
2308 GstDecodeChain *chain = ppad->chain;
2309 GstDecodeBin *dbin = chain->dbin;
2314 switch (GST_EVENT_TYPE (event)) {
2316 GST_DEBUG_OBJECT (dbin, "Received EOS on a non final pad, this stream "
2318 chain->deadend = TRUE;
2319 /* we don't set the endcaps because NULL endcaps means early EOS */
2321 if (gst_decode_chain_is_complete (dbin->decode_chain))
2322 gst_decode_bin_expose (dbin);
2323 EXPOSE_UNLOCK (dbin);
2332 pad_added_cb (GstElement * element, GstPad * pad, GstDecodeChain * chain)
2339 GST_DEBUG_OBJECT (pad, "pad added, chain:%p", chain);
2341 caps = get_pad_caps (pad);
2342 analyze_new_pad (dbin, element, pad, caps, chain);
2344 gst_caps_unref (caps);
2347 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2348 GST_LOG_OBJECT (dbin,
2349 "That was the last dynamic object, now attempting to expose the group");
2350 if (!gst_decode_bin_expose (dbin))
2351 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
2353 EXPOSE_UNLOCK (dbin);
2357 pad_removed_cb (GstElement * element, GstPad * pad, GstDecodeChain * chain)
2361 GST_LOG_OBJECT (pad, "pad removed, chain:%p", chain);
2363 /* In fact, we don't have to do anything here, the active group will be
2364 * removed when the group's multiqueue is drained */
2365 CHAIN_MUTEX_LOCK (chain);
2366 for (l = chain->pending_pads; l; l = l->next) {
2367 GstPendingPad *ppad = l->data;
2368 GstPad *opad = ppad->pad;
2371 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2372 gst_pending_pad_free (ppad);
2373 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2377 CHAIN_MUTEX_UNLOCK (chain);
2381 no_more_pads_cb (GstElement * element, GstDecodeChain * chain)
2383 GstDecodeGroup *group = NULL;
2385 GST_LOG_OBJECT (element, "got no more pads");
2387 CHAIN_MUTEX_LOCK (chain);
2388 if (!chain->elements
2389 || ((GstDecodeElement *) chain->elements->data)->element != element) {
2390 GST_LOG_OBJECT (chain->dbin, "no-more-pads from old chain element '%s'",
2391 GST_OBJECT_NAME (element));
2392 CHAIN_MUTEX_UNLOCK (chain);
2394 } else if (!chain->demuxer) {
2395 GST_LOG_OBJECT (chain->dbin, "no-more-pads from a non-demuxer element '%s'",
2396 GST_OBJECT_NAME (element));
2397 CHAIN_MUTEX_UNLOCK (chain);
2401 /* when we received no_more_pads, we can complete the pads of the chain */
2402 if (!chain->next_groups && chain->active_group) {
2403 group = chain->active_group;
2404 } else if (chain->next_groups) {
2405 group = chain->next_groups->data;
2408 GST_ERROR_OBJECT (chain->dbin, "can't find group for element");
2409 CHAIN_MUTEX_UNLOCK (chain);
2413 GST_DEBUG_OBJECT (element, "Setting group %p to complete", group);
2415 group->no_more_pads = TRUE;
2416 /* this group has prerolled enough to not need more pads,
2417 * we can probably set its buffering state to playing now */
2418 GST_DEBUG_OBJECT (group->dbin, "Setting group %p multiqueue to "
2419 "'playing' buffering mode", group);
2420 decodebin_set_queue_size (group->dbin, group->multiqueue, FALSE,
2421 (group->parent ? group->parent->seekable : TRUE));
2422 CHAIN_MUTEX_UNLOCK (chain);
2424 EXPOSE_LOCK (chain->dbin);
2425 if (gst_decode_chain_is_complete (chain->dbin->decode_chain)) {
2426 gst_decode_bin_expose (chain->dbin);
2428 EXPOSE_UNLOCK (chain->dbin);
2432 caps_notify_cb (GstPad * pad, GParamSpec * unused, GstDecodeChain * chain)
2434 GstElement *element;
2437 GST_LOG_OBJECT (pad, "Notified caps for pad %s:%s", GST_DEBUG_PAD_NAME (pad));
2439 /* Disconnect this; if we still need it, we'll reconnect to this in
2440 * analyze_new_pad */
2441 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2443 element = GST_ELEMENT_CAST (gst_pad_get_parent (pad));
2445 CHAIN_MUTEX_LOCK (chain);
2446 for (l = chain->pending_pads; l; l = l->next) {
2447 GstPendingPad *ppad = l->data;
2448 if (ppad->pad == pad) {
2449 gst_pending_pad_free (ppad);
2450 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2454 CHAIN_MUTEX_UNLOCK (chain);
2456 pad_added_cb (element, pad, chain);
2458 gst_object_unref (element);
2461 /* Decide whether an element is a demuxer based on the
2462 * klass and number/type of src pad templates it has */
2464 is_demuxer_element (GstElement * srcelement)
2466 GstElementFactory *srcfactory;
2467 GstElementClass *elemclass;
2470 gint potential_src_pads = 0;
2472 srcfactory = gst_element_get_factory (srcelement);
2473 klass = gst_element_factory_get_klass (srcfactory);
2475 /* Can't be a demuxer unless it has Demux in the klass name */
2476 if (!strstr (klass, "Demux"))
2479 /* Walk the src pad templates and count how many the element
2481 elemclass = GST_ELEMENT_GET_CLASS (srcelement);
2483 walk = gst_element_class_get_pad_template_list (elemclass);
2484 while (walk != NULL) {
2485 GstPadTemplate *templ;
2487 templ = (GstPadTemplate *) walk->data;
2488 if (GST_PAD_TEMPLATE_DIRECTION (templ) == GST_PAD_SRC) {
2489 switch (GST_PAD_TEMPLATE_PRESENCE (templ)) {
2490 case GST_PAD_ALWAYS:
2491 case GST_PAD_SOMETIMES:
2492 if (strstr (GST_PAD_TEMPLATE_NAME_TEMPLATE (templ), "%"))
2493 potential_src_pads += 2; /* Might make multiple pads */
2495 potential_src_pads += 1;
2497 case GST_PAD_REQUEST:
2498 potential_src_pads += 2;
2502 walk = g_list_next (walk);
2505 if (potential_src_pads < 2)
2511 /* Returns TRUE if the caps are compatible with the caps specified in the 'caps'
2512 * property (which by default are the raw caps)
2514 * The decodebin_lock should be taken !
2517 are_final_caps (GstDecodeBin * dbin, GstCaps * caps)
2521 GST_LOG_OBJECT (dbin, "Checking with caps %" GST_PTR_FORMAT, caps);
2523 /* lock for getting the caps */
2524 GST_OBJECT_LOCK (dbin);
2525 res = gst_caps_can_intersect (dbin->caps, caps);
2526 GST_OBJECT_UNLOCK (dbin);
2528 GST_LOG_OBJECT (dbin, "Caps are %sfinal caps", res ? "" : "not ");
2534 * GstDecodeChain functions
2537 /* gst_decode_chain_get_current_group:
2539 * Returns the current group of this chain, to which
2540 * new chains should be attached or NULL if the last
2541 * group didn't have no-more-pads.
2543 * Not MT-safe: Call with parent chain lock!
2545 static GstDecodeGroup *
2546 gst_decode_chain_get_current_group (GstDecodeChain * chain)
2548 GstDecodeGroup *group;
2550 if (!chain->next_groups && chain->active_group
2551 && chain->active_group->overrun && !chain->active_group->no_more_pads) {
2552 GST_WARNING_OBJECT (chain->dbin,
2553 "Currently active group %p is exposed"
2554 " and wants to add a new pad without having signaled no-more-pads",
2555 chain->active_group);
2559 if (chain->next_groups && (group = chain->next_groups->data) && group->overrun
2560 && !group->no_more_pads) {
2561 GST_WARNING_OBJECT (chain->dbin,
2562 "Currently newest pending group %p "
2563 "had overflow but didn't signal no-more-pads", group);
2567 /* Now we know that we can really return something useful */
2568 if (!chain->active_group) {
2569 chain->active_group = group = gst_decode_group_new (chain->dbin, chain);
2570 } else if (!chain->active_group->overrun
2571 && !chain->active_group->no_more_pads) {
2572 group = chain->active_group;
2573 } else if (chain->next_groups && (group = chain->next_groups->data)
2574 && !group->overrun && !group->no_more_pads) {
2575 /* group = chain->next_groups->data */
2577 group = gst_decode_group_new (chain->dbin, chain);
2578 chain->next_groups = g_list_prepend (chain->next_groups, group);
2584 static void gst_decode_group_free_internal (GstDecodeGroup * group,
2588 gst_decode_chain_free_internal (GstDecodeChain * chain, gboolean hide)
2592 CHAIN_MUTEX_LOCK (chain);
2594 GST_DEBUG_OBJECT (chain->dbin, "%s chain %p", (hide ? "Hiding" : "Freeing"),
2597 if (chain->active_group) {
2598 gst_decode_group_free_internal (chain->active_group, hide);
2600 chain->active_group = NULL;
2603 for (l = chain->next_groups; l; l = l->next) {
2604 gst_decode_group_free_internal ((GstDecodeGroup *) l->data, hide);
2609 g_list_free (chain->next_groups);
2610 chain->next_groups = NULL;
2614 for (l = chain->old_groups; l; l = l->next) {
2615 GstDecodeGroup *group = l->data;
2617 gst_decode_group_free (group);
2619 g_list_free (chain->old_groups);
2620 chain->old_groups = NULL;
2623 for (l = chain->pending_pads; l; l = l->next) {
2624 GstPendingPad *ppad = l->data;
2625 GstPad *pad = ppad->pad;
2627 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2628 gst_pending_pad_free (ppad);
2631 g_list_free (chain->pending_pads);
2632 chain->pending_pads = NULL;
2634 for (l = chain->elements; l; l = l->next) {
2635 GstDecodeElement *delem = l->data;
2636 GstElement *element = delem->element;
2638 g_signal_handlers_disconnect_by_func (element, pad_added_cb, chain);
2639 g_signal_handlers_disconnect_by_func (element, pad_removed_cb, chain);
2640 g_signal_handlers_disconnect_by_func (element, no_more_pads_cb, chain);
2642 if (delem->capsfilter) {
2643 if (GST_OBJECT_PARENT (delem->capsfilter) ==
2644 GST_OBJECT_CAST (chain->dbin))
2645 gst_bin_remove (GST_BIN_CAST (chain->dbin), delem->capsfilter);
2647 gst_element_set_state (delem->capsfilter, GST_STATE_NULL);
2651 if (GST_OBJECT_PARENT (element) == GST_OBJECT_CAST (chain->dbin))
2652 gst_bin_remove (GST_BIN_CAST (chain->dbin), element);
2654 gst_element_set_state (element, GST_STATE_NULL);
2657 SUBTITLE_LOCK (chain->dbin);
2658 /* remove possible subtitle element */
2659 chain->dbin->subtitles = g_list_remove (chain->dbin->subtitles, element);
2660 SUBTITLE_UNLOCK (chain->dbin);
2663 if (delem->capsfilter) {
2664 gst_object_unref (delem->capsfilter);
2665 delem->capsfilter = NULL;
2668 gst_object_unref (element);
2671 g_slice_free (GstDecodeElement, delem);
2675 g_list_free (chain->elements);
2676 chain->elements = NULL;
2679 if (chain->endpad) {
2680 if (chain->endpad->exposed) {
2681 gst_element_remove_pad (GST_ELEMENT_CAST (chain->dbin),
2682 GST_PAD_CAST (chain->endpad));
2683 g_signal_emit (G_OBJECT (chain->dbin),
2684 gst_decode_bin_signals[SIGNAL_REMOVED_DECODED_PAD], 0, chain->endpad);
2687 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (chain->endpad), NULL);
2688 chain->endpad->exposed = FALSE;
2690 gst_object_unref (chain->endpad);
2691 chain->endpad = NULL;
2696 gst_object_unref (chain->pad);
2700 if (chain->endcaps) {
2701 gst_caps_unref (chain->endcaps);
2702 chain->endcaps = NULL;
2705 GST_DEBUG_OBJECT (chain->dbin, "%s chain %p", (hide ? "Hidden" : "Freed"),
2707 CHAIN_MUTEX_UNLOCK (chain);
2709 g_mutex_free (chain->lock);
2710 g_slice_free (GstDecodeChain, chain);
2714 /* gst_decode_chain_free:
2716 * Completely frees and removes the chain and all
2717 * child groups from decodebin2.
2719 * MT-safe, don't hold the chain lock or any child chain's lock
2720 * when calling this!
2723 gst_decode_chain_free (GstDecodeChain * chain)
2725 gst_decode_chain_free_internal (chain, FALSE);
2728 /* gst_decode_chain_new:
2730 * Creates a new decode chain and initializes it.
2732 * It's up to the caller to add it to the list of child chains of
2735 static GstDecodeChain *
2736 gst_decode_chain_new (GstDecodeBin * dbin, GstDecodeGroup * parent,
2739 GstDecodeChain *chain = g_slice_new0 (GstDecodeChain);
2741 GST_DEBUG_OBJECT (dbin, "Creating new chain %p with parent group %p", chain,
2745 chain->parent = parent;
2746 chain->lock = g_mutex_new ();
2747 chain->pad = gst_object_ref (pad);
2753 * GstDecodeGroup functions
2756 /* The overrun callback is used to expose groups that have not yet had their
2757 * no_more_pads called while the (large) multiqueue overflowed. When this
2758 * happens we must assume that the no_more_pads will not arrive anymore and we
2759 * must expose the pads that we have.
2762 multi_queue_overrun_cb (GstElement * queue, GstDecodeGroup * group)
2768 GST_LOG_OBJECT (dbin, "multiqueue '%s' (%p) is full", GST_OBJECT_NAME (queue),
2771 group->overrun = TRUE;
2772 /* this group has prerolled enough to not need more pads,
2773 * we can probably set its buffering state to playing now */
2774 GST_DEBUG_OBJECT (group->dbin, "Setting group %p multiqueue to "
2775 "'playing' buffering mode", group);
2776 decodebin_set_queue_size (group->dbin, group->multiqueue, FALSE,
2777 (group->parent ? group->parent->seekable : TRUE));
2779 /* FIXME: We should make sure that everything gets exposed now
2780 * even if child chains are not complete because the will never
2781 * be complete! Ignore any non-complete chains when exposing
2782 * and never expose them later
2786 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2787 if (!gst_decode_bin_expose (dbin))
2788 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
2790 EXPOSE_UNLOCK (group->dbin);
2794 gst_decode_group_free_internal (GstDecodeGroup * group, gboolean hide)
2798 GST_DEBUG_OBJECT (group->dbin, "%s group %p", (hide ? "Hiding" : "Freeing"),
2800 for (l = group->children; l; l = l->next) {
2801 GstDecodeChain *chain = (GstDecodeChain *) l->data;
2803 gst_decode_chain_free_internal (chain, hide);
2808 g_list_free (group->children);
2809 group->children = NULL;
2813 for (l = group->reqpads; l; l = l->next) {
2814 GstPad *pad = l->data;
2816 gst_element_release_request_pad (group->multiqueue, pad);
2817 gst_object_unref (pad);
2820 g_list_free (group->reqpads);
2821 group->reqpads = NULL;
2824 if (group->multiqueue) {
2825 if (group->overrunsig) {
2826 g_signal_handler_disconnect (group->multiqueue, group->overrunsig);
2827 group->overrunsig = 0;
2830 if (GST_OBJECT_PARENT (group->multiqueue) == GST_OBJECT_CAST (group->dbin))
2831 gst_bin_remove (GST_BIN_CAST (group->dbin), group->multiqueue);
2833 gst_element_set_state (group->multiqueue, GST_STATE_NULL);
2834 gst_object_unref (group->multiqueue);
2835 group->multiqueue = NULL;
2839 GST_DEBUG_OBJECT (group->dbin, "%s group %p", (hide ? "Hided" : "Freed"),
2842 g_slice_free (GstDecodeGroup, group);
2845 /* gst_decode_group_free:
2847 * Completely frees and removes the decode group and all
2850 * Never call this from any streaming thread!
2852 * Not MT-safe, call with parent's chain lock!
2855 gst_decode_group_free (GstDecodeGroup * group)
2857 gst_decode_group_free_internal (group, FALSE);
2860 /* gst_decode_group_hide:
2862 * Hide the decode group only, this means that
2863 * all child endpads are removed from decodebin2
2864 * and all signals are unconnected.
2866 * No element is set to NULL state and completely
2869 * Can be called from streaming threads.
2871 * Not MT-safe, call with parent's chain lock!
2874 gst_decode_group_hide (GstDecodeGroup * group)
2876 gst_decode_group_free_internal (group, TRUE);
2879 /* configure queue sizes, this depends on the buffering method and if we are
2880 * playing or prerolling. */
2882 decodebin_set_queue_size (GstDecodeBin * dbin, GstElement * multiqueue,
2883 gboolean preroll, gboolean seekable)
2885 guint max_bytes, max_buffers;
2888 if (preroll || dbin->use_buffering) {
2889 /* takes queue limits, initially we only queue up up to the max bytes limit,
2890 * with a default of 2MB. we use the same values for buffering mode. */
2891 if ((max_bytes = dbin->max_size_bytes) == 0)
2892 max_bytes = AUTO_PREROLL_SIZE_BYTES;
2893 if ((max_buffers = dbin->max_size_buffers) == 0)
2894 max_buffers = AUTO_PREROLL_SIZE_BUFFERS;
2895 if ((max_time = dbin->max_size_time) == 0)
2896 max_time = seekable ? AUTO_PREROLL_SEEKABLE_SIZE_TIME :
2897 AUTO_PREROLL_NOT_SEEKABLE_SIZE_TIME;
2899 /* update runtime limits. At runtime, we try to keep the amount of buffers
2900 * in the queues as low as possible (but at least 5 buffers). */
2901 if ((max_bytes = dbin->max_size_bytes) == 0)
2902 max_bytes = AUTO_PLAY_SIZE_BYTES;
2903 if ((max_buffers = dbin->max_size_buffers) == 0)
2904 max_buffers = AUTO_PLAY_SIZE_BUFFERS;
2905 if ((max_time = dbin->max_size_time) == 0)
2906 max_time = AUTO_PLAY_SIZE_TIME;
2909 g_object_set (multiqueue,
2910 "max-size-bytes", max_bytes, "max-size-time", max_time,
2911 "max-size-buffers", max_buffers, NULL);
2914 /* gst_decode_group_new:
2915 * @dbin: Parent decodebin
2916 * @parent: Parent chain or %NULL
2918 * Creates a new GstDecodeGroup. It is up to the caller to add it to the list
2921 static GstDecodeGroup *
2922 gst_decode_group_new (GstDecodeBin * dbin, GstDecodeChain * parent)
2924 GstDecodeGroup *group = g_slice_new0 (GstDecodeGroup);
2927 #ifdef GST_EXT_DECODEBIN2_MODIFICATION
2928 gboolean smooth_stream_demuxer_last = FALSE;
2931 GST_DEBUG_OBJECT (dbin, "Creating new group %p with parent chain %p", group,
2935 group->parent = parent;
2937 mq = group->multiqueue = gst_element_factory_make ("multiqueue", NULL);
2938 if (G_UNLIKELY (!group->multiqueue))
2939 goto missing_multiqueue;
2941 #ifdef GST_EXT_DECODEBIN2_MODIFICATION
2942 /*Check if last parent elment is smooth streaming demuxer.*/
2943 if (parent && parent->demuxer)
2945 GstElement *element =
2946 ((GstDecodeElement *) parent->elements->data)->element;
2947 if(g_strrstr(GST_ELEMENT_NAME(element), "dashdemux"))
2948 smooth_stream_demuxer_last = TRUE;
2951 /* default is for use-buffering is FALSE
2952 We should disable buffering in multiqueue after smooth streaming
2953 demuxers like dashdemux because they are fake demuxers.*/
2954 if (dbin->use_buffering && !smooth_stream_demuxer_last)
2956 /* default is for use-buffering is FALSE */
2957 if (dbin->use_buffering)
2961 "use-buffering", TRUE,
2962 "low-percent", dbin->low_percent,
2963 "high-percent", dbin->high_percent, NULL);
2966 /* configure queue sizes for preroll */
2968 if (parent && parent->demuxer) {
2969 GstElement *element =
2970 ((GstDecodeElement *) parent->elements->data)->element;
2971 GstPad *pad = gst_element_get_static_pad (element, "sink");
2973 seekable = parent->seekable = check_upstream_seekable (dbin, pad);
2974 gst_object_unref (pad);
2977 decodebin_set_queue_size (dbin, mq, TRUE, seekable);
2979 group->overrunsig = g_signal_connect (G_OBJECT (mq), "overrun",
2980 G_CALLBACK (multi_queue_overrun_cb), group);
2982 gst_bin_add (GST_BIN (dbin), gst_object_ref (mq));
2983 gst_element_set_state (mq, GST_STATE_PAUSED);
2990 gst_element_post_message (GST_ELEMENT_CAST (dbin),
2991 gst_missing_element_message_new (GST_ELEMENT_CAST (dbin),
2993 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL), ("no multiqueue!"));
2994 g_slice_free (GstDecodeGroup, group);
2999 /* gst_decode_group_control_demuxer_pad
3001 * Adds a new demuxer srcpad to the given group.
3003 * Returns the srcpad of the multiqueue corresponding the given pad.
3004 * Returns NULL if there was an error.
3007 gst_decode_group_control_demuxer_pad (GstDecodeGroup * group, GstPad * pad)
3010 GstPad *srcpad, *sinkpad;
3011 GstIterator *it = NULL;
3015 GST_LOG_OBJECT (dbin, "group:%p pad %s:%s", group, GST_DEBUG_PAD_NAME (pad));
3019 if (G_UNLIKELY (!group->multiqueue))
3022 if (!(sinkpad = gst_element_get_request_pad (group->multiqueue, "sink%d"))) {
3023 GST_ERROR_OBJECT (dbin, "Couldn't get sinkpad from multiqueue");
3027 if ((gst_pad_link (pad, sinkpad) != GST_PAD_LINK_OK)) {
3028 GST_ERROR_OBJECT (dbin, "Couldn't link demuxer and multiqueue");
3032 it = gst_pad_iterate_internal_links (sinkpad);
3034 if (!it || (gst_iterator_next (it, (gpointer) & srcpad)) != GST_ITERATOR_OK
3035 || srcpad == NULL) {
3036 GST_ERROR_OBJECT (dbin,
3037 "Couldn't get srcpad from multiqueue for sinkpad %" GST_PTR_FORMAT,
3042 CHAIN_MUTEX_LOCK (group->parent);
3043 group->reqpads = g_list_prepend (group->reqpads, gst_object_ref (sinkpad));
3044 CHAIN_MUTEX_UNLOCK (group->parent);
3048 gst_iterator_free (it);
3049 gst_object_unref (sinkpad);
3053 gst_element_release_request_pad (group->multiqueue, sinkpad);
3057 /* gst_decode_group_is_complete:
3059 * Checks if the group is complete, this means that
3060 * a) overrun of the multiqueue or no-more-pads happened
3061 * b) all child chains are complete
3063 * Not MT-safe, always call with decodebin expose lock
3066 gst_decode_group_is_complete (GstDecodeGroup * group)
3069 gboolean complete = TRUE;
3071 if (!group->overrun && !group->no_more_pads) {
3076 for (l = group->children; l; l = l->next) {
3077 GstDecodeChain *chain = l->data;
3079 if (!gst_decode_chain_is_complete (chain)) {
3086 GST_DEBUG_OBJECT (group->dbin, "Group %p is complete: %d", group, complete);
3090 /* gst_decode_chain_is_complete:
3092 * Returns TRUE if the chain is complete, this means either
3093 * a) This chain is a dead end, i.e. we have no suitable plugins
3094 * b) This chain ends in an endpad and this is blocked or exposed
3096 * Not MT-safe, always call with decodebin expose lock
3099 gst_decode_chain_is_complete (GstDecodeChain * chain)
3101 gboolean complete = FALSE;
3103 CHAIN_MUTEX_LOCK (chain);
3104 if (chain->deadend) {
3109 if (chain->endpad && (chain->endpad->blocked || chain->endpad->exposed)) {
3114 if (chain->demuxer) {
3115 if (chain->active_group
3116 && gst_decode_group_is_complete (chain->active_group)) {
3123 CHAIN_MUTEX_UNLOCK (chain);
3124 GST_DEBUG_OBJECT (chain->dbin, "Chain %p is complete: %d", chain, complete);
3129 drain_and_switch_chains (GstDecodeChain * chain, GstDecodePad * drainpad,
3130 gboolean * last_group, gboolean * drained, gboolean * switched);
3131 /* drain_and_switch_chains/groups:
3133 * CALL WITH CHAIN LOCK (or group parent) TAKEN !
3135 * Goes down the chains/groups until it finds the chain
3136 * to which the drainpad belongs.
3138 * It marks that pad/chain as drained and then will figure
3139 * out which group to switch to or not.
3141 * last_chain will be set to TRUE if the group to which the
3142 * pad belongs is the last one.
3144 * drained will be set to TRUE if the chain/group is drained.
3146 * Returns: TRUE if the chain contained the target pad */
3148 drain_and_switch_group (GstDecodeGroup * group, GstDecodePad * drainpad,
3149 gboolean * last_group, gboolean * drained, gboolean * switched)
3151 gboolean handled = FALSE;
3154 GST_DEBUG ("Checking group %p (target pad %s:%s)",
3155 group, GST_DEBUG_PAD_NAME (drainpad));
3157 /* Definitely can't be in drained groups */
3158 if (G_UNLIKELY (group->drained)) {
3162 /* Figure out if all our chains are drained with the
3163 * new information */
3164 group->drained = TRUE;
3165 for (tmp = group->children; tmp; tmp = tmp->next) {
3166 GstDecodeChain *chain = (GstDecodeChain *) tmp->data;
3167 gboolean subdrained = FALSE;
3170 drain_and_switch_chains (chain, drainpad, last_group, &subdrained,
3173 group->drained = FALSE;
3177 GST_DEBUG ("group %p (last_group:%d, drained:%d, switched:%d, handled:%d)",
3178 group, *last_group, group->drained, *switched, handled);
3179 *drained = group->drained;
3184 drain_and_switch_chains (GstDecodeChain * chain, GstDecodePad * drainpad,
3185 gboolean * last_group, gboolean * drained, gboolean * switched)
3187 gboolean handled = FALSE;
3188 GstDecodeBin *dbin = chain->dbin;
3190 GST_DEBUG ("Checking chain %p (target pad %s:%s)",
3191 chain, GST_DEBUG_PAD_NAME (drainpad));
3193 CHAIN_MUTEX_LOCK (chain);
3195 /* Definitely can't be in drained chains */
3196 if (G_UNLIKELY (chain->drained)) {
3200 if (chain->endpad) {
3201 /* Check if we're reached the target endchain */
3202 if (chain == drainpad->chain) {
3203 GST_DEBUG ("Found the target chain");
3204 drainpad->drained = TRUE;
3208 chain->drained = chain->endpad->drained;
3212 /* We known there are groups to switch to */
3213 if (chain->next_groups)
3214 *last_group = FALSE;
3216 /* Check the active group */
3217 if (chain->active_group) {
3218 gboolean subdrained = FALSE;
3219 handled = drain_and_switch_group (chain->active_group, drainpad,
3220 last_group, &subdrained, switched);
3222 /* The group is drained, see if we can switch to another */
3223 if (handled && subdrained && !*switched) {
3224 if (chain->next_groups) {
3225 /* Switch to next group */
3226 GST_DEBUG_OBJECT (dbin, "Hiding current group %p", chain->active_group);
3227 gst_decode_group_hide (chain->active_group);
3229 g_list_prepend (chain->old_groups, chain->active_group);
3230 GST_DEBUG_OBJECT (dbin, "Switching to next group %p",
3231 chain->next_groups->data);
3232 chain->active_group = chain->next_groups->data;
3233 chain->next_groups =
3234 g_list_delete_link (chain->next_groups, chain->next_groups);
3236 chain->drained = FALSE;
3238 GST_DEBUG ("Group %p was the last in chain %p", chain->active_group,
3240 chain->drained = TRUE;
3241 /* We're drained ! */
3247 CHAIN_MUTEX_UNLOCK (chain);
3249 GST_DEBUG ("Chain %p (handled:%d, last_group:%d, drained:%d, switched:%d)",
3250 chain, handled, *last_group, chain->drained, *switched);
3252 *drained = chain->drained;
3255 g_signal_emit (dbin, gst_decode_bin_signals[SIGNAL_DRAINED], 0, NULL);
3260 /* check if the group is drained, meaning all pads have seen an EOS
3263 gst_decode_pad_handle_eos (GstDecodePad * pad)
3265 gboolean last_group = TRUE;
3266 gboolean switched = FALSE;
3267 gboolean drained = FALSE;
3268 GstDecodeChain *chain = pad->chain;
3269 GstDecodeBin *dbin = chain->dbin;
3271 GST_LOG_OBJECT (dbin, "pad %p", pad);
3272 drain_and_switch_chains (dbin->decode_chain, pad, &last_group, &drained,
3276 /* If we resulted in a group switch, expose what's needed */
3278 if (gst_decode_chain_is_complete (dbin->decode_chain))
3279 gst_decode_bin_expose (dbin);
3280 EXPOSE_UNLOCK (dbin);
3286 /* gst_decode_group_is_drained:
3288 * Check is this group is drained and cache this result.
3289 * The group is drained if all child chains are drained.
3291 * Not MT-safe, call with group->parent's lock */
3293 gst_decode_group_is_drained (GstDecodeGroup * group)
3296 gboolean drained = TRUE;
3298 if (group->drained) {
3303 for (l = group->children; l; l = l->next) {
3304 GstDecodeChain *chain = l->data;
3306 CHAIN_MUTEX_LOCK (chain);
3307 if (!gst_decode_chain_is_drained (chain))
3309 CHAIN_MUTEX_UNLOCK (chain);
3313 group->drained = drained;
3316 GST_DEBUG_OBJECT (group->dbin, "Group %p is drained: %d", group, drained);
3320 /* gst_decode_chain_is_drained:
3322 * Check is the chain is drained, which means that
3325 * a) it's endpad is drained
3326 * b) there are no pending pads, the active group is drained
3327 * and there are no next groups
3329 * Not MT-safe, call with chain lock
3332 gst_decode_chain_is_drained (GstDecodeChain * chain)
3334 gboolean drained = FALSE;
3336 if (chain->endpad) {
3337 drained = chain->endpad->drained;
3341 if (chain->pending_pads) {
3346 if (chain->active_group && gst_decode_group_is_drained (chain->active_group)
3347 && !chain->next_groups) {
3353 GST_DEBUG_OBJECT (chain->dbin, "Chain %p is drained: %d", chain, drained);
3358 * GCompareFunc to use with lists of GstPad.
3359 * Sorts pads by mime type.
3360 * First video (raw, then non-raw), then audio (raw, then non-raw),
3363 * Return: negative if a<b, 0 if a==b, positive if a>b
3366 sort_end_pads (GstDecodePad * da, GstDecodePad * db)
3369 GstCaps *capsa, *capsb;
3370 GstStructure *sa, *sb;
3371 const gchar *namea, *nameb;
3373 capsa = get_pad_caps (GST_PAD_CAST (da));
3374 capsb = get_pad_caps (GST_PAD_CAST (db));
3376 sa = gst_caps_get_structure ((const GstCaps *) capsa, 0);
3377 sb = gst_caps_get_structure ((const GstCaps *) capsb, 0);
3379 namea = gst_structure_get_name (sa);
3380 nameb = gst_structure_get_name (sb);
3382 if (g_strrstr (namea, "video/x-raw-"))
3384 else if (g_strrstr (namea, "video/"))
3386 else if (g_strrstr (namea, "audio/x-raw"))
3388 else if (g_strrstr (namea, "audio/"))
3393 if (g_strrstr (nameb, "video/x-raw-"))
3395 else if (g_strrstr (nameb, "video/"))
3397 else if (g_strrstr (nameb, "audio/x-raw"))
3399 else if (g_strrstr (nameb, "audio/"))
3404 gst_caps_unref (capsa);
3405 gst_caps_unref (capsb);
3411 _gst_element_get_linked_caps (GstElement * src, GstElement * sink,
3417 gboolean done = FALSE;
3418 GstCaps *caps = NULL;
3420 it = gst_element_iterate_src_pads (src);
3422 switch (gst_iterator_next (it, (gpointer) & pad)) {
3423 case GST_ITERATOR_OK:
3424 peer = gst_pad_get_peer (pad);
3426 parent = gst_pad_get_parent_element (peer);
3427 if (parent == sink) {
3428 caps = gst_pad_get_negotiated_caps (pad);
3430 gst_object_ref (pad);
3437 gst_object_unref (parent);
3438 gst_object_unref (peer);
3440 gst_object_unref (pad);
3442 case GST_ITERATOR_RESYNC:
3443 gst_iterator_resync (it);
3445 case GST_ITERATOR_ERROR:
3446 case GST_ITERATOR_DONE:
3452 gst_iterator_free (it);
3457 static GQuark topology_structure_name = 0;
3458 static GQuark topology_caps = 0;
3459 static GQuark topology_next = 0;
3460 static GQuark topology_pad = 0;
3461 static GQuark topology_element_srcpad = 0;
3463 /* FIXME: Invent gst_structure_take_structure() to prevent all the
3464 * structure copying for nothing
3466 static GstStructure *
3467 gst_decode_chain_get_topology (GstDecodeChain * chain)
3469 GstStructure *s, *u;
3473 if (G_UNLIKELY ((chain->endpad || chain->deadend)
3474 && (chain->endcaps == NULL))) {
3475 GST_WARNING ("End chain without valid caps !");
3479 u = gst_structure_id_empty_new (topology_structure_name);
3481 /* Now at the last element */
3482 if ((chain->elements || !chain->active_group) &&
3483 (chain->endpad || chain->deadend)) {
3484 s = gst_structure_id_empty_new (topology_structure_name);
3485 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, chain->endcaps,
3488 if (chain->endpad) {
3489 gst_structure_id_set (u, topology_pad, GST_TYPE_PAD, chain->endpad, NULL);
3490 gst_structure_id_set (u, topology_element_srcpad, GST_TYPE_PAD,
3491 chain->endpad, NULL);
3493 gst_structure_id_set (s, topology_next, GST_TYPE_STRUCTURE, u, NULL);
3494 gst_structure_free (u);
3496 } else if (chain->active_group) {
3497 GValue list = { 0, };
3498 GValue item = { 0, };
3500 g_value_init (&list, GST_TYPE_LIST);
3501 g_value_init (&item, GST_TYPE_STRUCTURE);
3502 for (l = chain->active_group->children; l; l = l->next) {
3503 s = gst_decode_chain_get_topology (l->data);
3505 gst_value_set_structure (&item, s);
3506 gst_value_list_append_value (&list, &item);
3507 g_value_reset (&item);
3508 gst_structure_free (s);
3511 gst_structure_id_set_value (u, topology_next, &list);
3512 g_value_unset (&list);
3513 g_value_unset (&item);
3516 /* Get caps between all elements in this chain */
3517 l = (chain->elements && chain->elements->next) ? chain->elements : NULL;
3518 for (; l && l->next; l = l->next) {
3519 GstDecodeElement *delem, *delem_next;
3520 GstElement *elem, *elem_next;
3525 elem = delem->element;
3526 delem_next = l->next->data;
3527 elem_next = delem_next->element;
3530 caps = _gst_element_get_linked_caps (elem_next, elem, &srcpad);
3533 s = gst_structure_id_empty_new (topology_structure_name);
3534 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, caps, NULL);
3535 gst_caps_unref (caps);
3537 gst_structure_id_set (s, topology_next, GST_TYPE_STRUCTURE, u, NULL);
3538 gst_structure_free (u);
3543 gst_structure_id_set (u, topology_element_srcpad, GST_TYPE_PAD, srcpad,
3545 gst_object_unref (srcpad);
3549 /* Caps that resulted in this chain */
3550 caps = gst_pad_get_negotiated_caps (chain->pad);
3552 caps = get_pad_caps (chain->pad);
3553 if (G_UNLIKELY (!gst_caps_is_fixed (caps))) {
3554 GST_ERROR_OBJECT (chain->pad,
3555 "Couldn't get fixed caps, got %" GST_PTR_FORMAT, caps);
3556 gst_caps_unref (caps);
3560 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, caps, NULL);
3561 gst_structure_id_set (u, topology_element_srcpad, GST_TYPE_PAD, chain->pad,
3563 gst_caps_unref (caps);
3569 gst_decode_bin_post_topology_message (GstDecodeBin * dbin)
3574 s = gst_decode_chain_get_topology (dbin->decode_chain);
3576 msg = gst_message_new_element (GST_OBJECT (dbin), s);
3577 gst_element_post_message (GST_ELEMENT (dbin), msg);
3580 /* Must only be called if the toplevel chain is complete and blocked! */
3581 /* Not MT-safe, call with decodebin expose lock! */
3583 gst_decode_bin_expose (GstDecodeBin * dbin)
3585 GList *tmp, *endpads = NULL;
3586 gboolean missing_plugin = FALSE;
3587 gboolean already_exposed = TRUE;
3589 GST_DEBUG_OBJECT (dbin, "Exposing currently active chains/groups");
3591 /* Don't expose if we're currently shutting down */
3593 if (G_UNLIKELY (dbin->shutdown == TRUE)) {
3594 GST_WARNING_OBJECT (dbin, "Currently, shutting down, aborting exposing");
3600 /* Get the pads that we're going to expose and mark things as exposed */
3601 if (!gst_decode_chain_expose (dbin->decode_chain, &endpads, &missing_plugin)) {
3602 g_list_foreach (endpads, (GFunc) gst_object_unref, NULL);
3603 g_list_free (endpads);
3604 GST_ERROR_OBJECT (dbin, "Broken chain/group tree");
3605 g_return_val_if_reached (FALSE);
3608 if (endpads == NULL) {
3609 if (missing_plugin) {
3610 GST_WARNING_OBJECT (dbin, "No suitable plugins found");
3611 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL),
3612 ("no suitable plugins found"));
3614 /* in this case, the stream ended without buffers,
3615 * just post a warning */
3616 GST_WARNING_OBJECT (dbin, "All streams finished without buffers");
3617 GST_ELEMENT_ERROR (dbin, STREAM, FAILED, (NULL),
3618 ("all streams without buffers"));
3623 /* Check if this was called when everything was exposed already */
3624 for (tmp = endpads; tmp && already_exposed; tmp = tmp->next) {
3625 GstDecodePad *dpad = tmp->data;
3627 already_exposed &= dpad->exposed;
3628 if (!already_exposed)
3631 if (already_exposed) {
3632 GST_DEBUG_OBJECT (dbin, "Everything was exposed already!");
3633 g_list_foreach (endpads, (GFunc) gst_object_unref, NULL);
3634 g_list_free (endpads);
3638 /* Set all already exposed pads to blocked */
3639 for (tmp = endpads; tmp; tmp = tmp->next) {
3640 GstDecodePad *dpad = tmp->data;
3642 if (dpad->exposed) {
3643 GST_DEBUG_OBJECT (dpad, "blocking exposed pad");
3644 gst_decode_pad_set_blocked (dpad, TRUE);
3648 /* re-order pads : video, then audio, then others */
3649 endpads = g_list_sort (endpads, (GCompareFunc) sort_end_pads);
3652 for (tmp = endpads; tmp; tmp = tmp->next) {
3653 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3656 /* 1. rewrite name */
3657 padname = g_strdup_printf ("src%d", dbin->nbpads);
3659 GST_DEBUG_OBJECT (dbin, "About to expose dpad %s as %s",
3660 GST_OBJECT_NAME (dpad), padname);
3661 gst_object_set_name (GST_OBJECT (dpad), padname);
3664 /* 2. activate and add */
3666 && !gst_element_add_pad (GST_ELEMENT (dbin), GST_PAD_CAST (dpad))) {
3667 /* not really fatal, we can try to add the other pads */
3668 g_warning ("error adding pad to decodebin2");
3671 dpad->exposed = TRUE;
3673 /* 3. emit signal */
3674 GST_DEBUG_OBJECT (dbin, "emitting new-decoded-pad");
3675 g_signal_emit (G_OBJECT (dbin),
3676 gst_decode_bin_signals[SIGNAL_NEW_DECODED_PAD], 0, dpad,
3677 (tmp->next == NULL));
3678 GST_DEBUG_OBJECT (dbin, "emitted new-decoded-pad");
3681 /* 4. Signal no-more-pads. This allows the application to hook stuff to the
3683 GST_LOG_OBJECT (dbin, "signaling no-more-pads");
3684 gst_element_no_more_pads (GST_ELEMENT (dbin));
3686 /* 5. Send a custom element message with the stream topology */
3687 if (dbin->post_stream_topology)
3688 gst_decode_bin_post_topology_message (dbin);
3690 /* 6. Unblock internal pads. The application should have connected stuff now
3691 * so that streaming can continue. */
3692 for (tmp = endpads; tmp; tmp = tmp->next) {
3693 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3695 GST_DEBUG_OBJECT (dpad, "unblocking");
3696 gst_decode_pad_unblock (dpad);
3697 GST_DEBUG_OBJECT (dpad, "unblocked");
3698 gst_object_unref (dpad);
3700 g_list_free (endpads);
3702 do_async_done (dbin);
3703 GST_DEBUG_OBJECT (dbin, "Exposed everything");
3707 /* gst_decode_chain_expose:
3709 * Check if the chain can be exposed and add all endpads
3710 * to the endpads list.
3712 * Also update the active group's multiqueue to the
3715 * Not MT-safe, call with decodebin expose lock! *
3718 gst_decode_chain_expose (GstDecodeChain * chain, GList ** endpads,
3719 gboolean * missing_plugin)
3721 GstDecodeGroup *group;
3725 if (chain->deadend) {
3727 *missing_plugin = TRUE;
3731 if (chain->endpad) {
3732 if (!chain->endpad->blocked && !chain->endpad->exposed)
3734 *endpads = g_list_prepend (*endpads, gst_object_ref (chain->endpad));
3738 group = chain->active_group;
3741 if (!group->no_more_pads && !group->overrun)
3746 /* configure queues for playback */
3747 decodebin_set_queue_size (dbin, group->multiqueue, FALSE, TRUE);
3749 /* we can now disconnect any overrun signal, which is used to expose the
3751 if (group->overrunsig) {
3752 GST_LOG_OBJECT (dbin, "Disconnecting overrun");
3753 g_signal_handler_disconnect (group->multiqueue, group->overrunsig);
3754 group->overrunsig = 0;
3757 for (l = group->children; l; l = l->next) {
3758 GstDecodeChain *childchain = l->data;
3760 if (!gst_decode_chain_expose (childchain, endpads, missing_plugin))
3767 /*************************
3768 * GstDecodePad functions
3769 *************************/
3772 gst_decode_pad_class_init (GstDecodePadClass * klass)
3777 gst_decode_pad_init (GstDecodePad * pad)
3780 pad->blocked = FALSE;
3781 pad->exposed = FALSE;
3782 pad->drained = FALSE;
3783 gst_object_ref (pad);
3784 gst_object_sink (pad);
3788 source_pad_blocked_cb (GstPad * pad, gboolean blocked, GstDecodePad * dpad)
3790 GstDecodeChain *chain;
3793 chain = dpad->chain;
3796 GST_LOG_OBJECT (dpad, "blocked:%d, dpad->chain:%p", blocked, chain);
3798 dpad->blocked = blocked;
3800 if (dpad->blocked) {
3802 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
3803 if (!gst_decode_bin_expose (dbin))
3804 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
3806 EXPOSE_UNLOCK (dbin);
3811 source_pad_event_probe (GstPad * pad, GstEvent * event, GstDecodePad * dpad)
3813 gboolean res = TRUE;
3815 GST_LOG_OBJECT (pad, "%s dpad:%p", GST_EVENT_TYPE_NAME (event), dpad);
3817 if (GST_EVENT_TYPE (event) == GST_EVENT_EOS) {
3818 GST_DEBUG_OBJECT (pad, "we received EOS");
3820 /* Check if all pads are drained.
3821 * * If there is no next group, we will let the EOS go through.
3822 * * If there is a next group but the current group isn't completely
3823 * drained, we will drop the EOS event.
3824 * * If there is a next group to expose and this was the last non-drained
3825 * pad for that group, we will remove the ghostpad of the current group
3826 * first, which unlinks the peer and so drops the EOS. */
3827 res = gst_decode_pad_handle_eos (dpad);
3834 gst_decode_pad_set_blocked (GstDecodePad * dpad, gboolean blocked)
3836 GstDecodeBin *dbin = dpad->dbin;
3841 GST_DEBUG_OBJECT (dpad, "blocking pad: %d", blocked);
3843 opad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (dpad));
3847 /* do not block if shutting down.
3848 * we do not consider/expect it blocked further below, but use other trick */
3849 if (!blocked || !dbin->shutdown)
3850 gst_pad_set_blocked_async_full (opad, blocked,
3851 (GstPadBlockCallback) source_pad_blocked_cb, gst_object_ref (dpad),
3852 (GDestroyNotify) gst_object_unref);
3855 if (dbin->shutdown) {
3856 /* deactivate to force flushing state to prevent NOT_LINKED errors */
3857 gst_pad_set_active (GST_PAD_CAST (dpad), FALSE);
3858 /* note that deactivating the target pad would have no effect here,
3859 * since elements are typically connected first (and pads exposed),
3860 * and only then brought to PAUSED state (so pads activated) */
3862 gst_object_ref (dpad);
3863 dbin->blocked_pads = g_list_prepend (dbin->blocked_pads, dpad);
3868 if ((l = g_list_find (dbin->blocked_pads, dpad))) {
3869 gst_object_unref (dpad);
3870 dbin->blocked_pads = g_list_delete_link (dbin->blocked_pads, l);
3873 gst_object_unref (opad);
3879 gst_decode_pad_add_drained_check (GstDecodePad * dpad)
3881 gst_pad_add_event_probe (GST_PAD_CAST (dpad),
3882 G_CALLBACK (source_pad_event_probe), dpad);
3886 gst_decode_pad_activate (GstDecodePad * dpad, GstDecodeChain * chain)
3888 g_return_if_fail (chain != NULL);
3890 dpad->chain = chain;
3891 gst_pad_set_active (GST_PAD_CAST (dpad), TRUE);
3892 gst_decode_pad_set_blocked (dpad, TRUE);
3893 gst_decode_pad_add_drained_check (dpad);
3897 gst_decode_pad_unblock (GstDecodePad * dpad)
3899 gst_decode_pad_set_blocked (dpad, FALSE);
3902 /*gst_decode_pad_new:
3904 * Creates a new GstDecodePad for the given pad.
3906 static GstDecodePad *
3907 gst_decode_pad_new (GstDecodeBin * dbin, GstPad * pad, GstDecodeChain * chain)
3910 GstPadTemplate *pad_tmpl;
3912 GST_DEBUG_OBJECT (dbin, "making new decodepad");
3913 pad_tmpl = gst_static_pad_template_get (&decoder_bin_src_template);
3915 g_object_new (GST_TYPE_DECODE_PAD, "direction", GST_PAD_DIRECTION (pad),
3916 "template", pad_tmpl, NULL);
3917 gst_ghost_pad_construct (GST_GHOST_PAD_CAST (dpad));
3918 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
3919 dpad->chain = chain;
3921 gst_object_unref (pad_tmpl);
3927 gst_pending_pad_free (GstPendingPad * ppad)
3930 g_assert (ppad->pad);
3932 if (ppad->event_probe_id != 0)
3933 gst_pad_remove_event_probe (ppad->pad, ppad->event_probe_id);
3934 gst_object_unref (ppad->pad);
3935 g_slice_free (GstPendingPad, ppad);
3939 * Element add/remove
3943 do_async_start (GstDecodeBin * dbin)
3945 GstMessage *message;
3947 dbin->async_pending = TRUE;
3949 message = gst_message_new_async_start (GST_OBJECT_CAST (dbin), FALSE);
3950 parent_class->handle_message (GST_BIN_CAST (dbin), message);
3954 do_async_done (GstDecodeBin * dbin)
3956 GstMessage *message;
3958 if (dbin->async_pending) {
3959 message = gst_message_new_async_done (GST_OBJECT_CAST (dbin));
3960 parent_class->handle_message (GST_BIN_CAST (dbin), message);
3962 dbin->async_pending = FALSE;
3967 * convenience functions
3972 * Returns the first sink pad of the given element, or NULL if it doesn't have
3977 find_sink_pad (GstElement * element)
3983 it = gst_element_iterate_sink_pads (element);
3985 if ((gst_iterator_next (it, &point)) == GST_ITERATOR_OK)
3986 pad = (GstPad *) point;
3988 gst_iterator_free (it);
3993 /* call with dyn_lock held */
3995 unblock_pads (GstDecodeBin * dbin)
3999 GST_LOG_OBJECT (dbin, "unblocking pads");
4001 for (tmp = dbin->blocked_pads; tmp; tmp = tmp->next) {
4002 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
4005 opad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (dpad));
4009 GST_DEBUG_OBJECT (dpad, "unblocking");
4010 gst_pad_set_blocked_async_full (opad, FALSE,
4011 (GstPadBlockCallback) source_pad_blocked_cb, gst_object_ref (dpad),
4012 (GDestroyNotify) gst_object_unref);
4013 /* make flushing, prevent NOT_LINKED */
4014 GST_PAD_SET_FLUSHING (GST_PAD_CAST (dpad));
4015 gst_object_unref (dpad);
4016 gst_object_unref (opad);
4017 GST_DEBUG_OBJECT (dpad, "unblocked");
4020 /* clear, no more blocked pads */
4021 g_list_free (dbin->blocked_pads);
4022 dbin->blocked_pads = NULL;
4025 static GstStateChangeReturn
4026 gst_decode_bin_change_state (GstElement * element, GstStateChange transition)
4028 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
4029 GstDecodeBin *dbin = GST_DECODE_BIN (element);
4031 switch (transition) {
4032 case GST_STATE_CHANGE_NULL_TO_READY:
4033 if (dbin->typefind == NULL)
4034 goto missing_typefind;
4036 case GST_STATE_CHANGE_READY_TO_PAUSED:
4037 /* Make sure we've cleared all existing chains */
4038 if (dbin->decode_chain) {
4039 gst_decode_chain_free (dbin->decode_chain);
4040 dbin->decode_chain = NULL;
4043 GST_LOG_OBJECT (dbin, "clearing shutdown flag");
4044 dbin->shutdown = FALSE;
4046 dbin->have_type = FALSE;
4047 ret = GST_STATE_CHANGE_ASYNC;
4048 do_async_start (dbin);
4050 case GST_STATE_CHANGE_PAUSED_TO_READY:
4052 GST_LOG_OBJECT (dbin, "setting shutdown flag");
4053 dbin->shutdown = TRUE;
4054 unblock_pads (dbin);
4061 GstStateChangeReturn bret;
4063 bret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
4064 if (G_UNLIKELY (bret == GST_STATE_CHANGE_FAILURE))
4065 goto activate_failed;
4066 else if (G_UNLIKELY (bret == GST_STATE_CHANGE_NO_PREROLL)) {
4067 do_async_done (dbin);
4071 switch (transition) {
4072 case GST_STATE_CHANGE_PAUSED_TO_READY:
4073 do_async_done (dbin);
4074 if (dbin->decode_chain) {
4075 gst_decode_chain_free (dbin->decode_chain);
4076 dbin->decode_chain = NULL;
4079 case GST_STATE_CHANGE_READY_TO_NULL:
4089 gst_element_post_message (element,
4090 gst_missing_element_message_new (element, "typefind"));
4091 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL), ("no typefind!"));
4092 return GST_STATE_CHANGE_FAILURE;
4096 GST_DEBUG_OBJECT (element,
4097 "element failed to change states -- activation problem?");
4098 return GST_STATE_CHANGE_FAILURE;
4103 gst_decode_bin_handle_message (GstBin * bin, GstMessage * msg)
4105 GstDecodeBin *dbin = GST_DECODE_BIN (bin);
4106 gboolean drop = FALSE;
4108 if (GST_MESSAGE_TYPE (msg) == GST_MESSAGE_ERROR) {
4109 GST_OBJECT_LOCK (dbin);
4110 drop = (g_list_find (dbin->filtered, GST_MESSAGE_SRC (msg)) != NULL);
4111 GST_OBJECT_UNLOCK (dbin);
4115 gst_message_unref (msg);
4117 GST_BIN_CLASS (parent_class)->handle_message (bin, msg);
4121 gst_decode_bin_plugin_init (GstPlugin * plugin)
4123 GST_DEBUG_CATEGORY_INIT (gst_decode_bin_debug, "decodebin2", 0,
4127 GST_DEBUG ("binding text domain %s to locale dir %s", GETTEXT_PACKAGE,
4129 bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
4130 bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
4131 #endif /* ENABLE_NLS */
4133 /* Register some quarks here for the stream topology message */
4134 topology_structure_name = g_quark_from_static_string ("stream-topology");
4135 topology_caps = g_quark_from_static_string ("caps");
4136 topology_next = g_quark_from_static_string ("next");
4137 topology_pad = g_quark_from_static_string ("pad");
4138 topology_element_srcpad = g_quark_from_static_string ("element-srcpad");
4140 return gst_element_register (plugin, "decodebin2", GST_RANK_NONE,
4141 GST_TYPE_DECODE_BIN);