2 * Copyright (C) <2006> Edward Hervey <edward@fluendo.com>
3 * Copyright (C) <2009> Sebastian Dröge <sebastian.droege@collabora.co.uk>
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Library General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Library General Public License for more details.
15 * You should have received a copy of the GNU Library General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
22 * SECTION:element-decodebin2
24 * #GstBin that auto-magically constructs a decoding pipeline using available
25 * decoders and demuxers via auto-plugging.
27 * decodebin2 is considered stable now and replaces the old #decodebin element.
28 * #uridecodebin uses decodebin2 internally and is often more convenient to
29 * use, as it creates a suitable source element as well.
32 /* Implementation notes:
34 * The following section describes how decodebin2 works internally.
36 * The first part of decodebin2 is its typefind element, which tries
37 * to determine the media type of the input stream. If the type is found
38 * autoplugging starts.
40 * decodebin2 internally organizes the elements it autoplugged into GstDecodeChains
41 * and GstDecodeGroups. A decode chain is a single chain of decoding, this
42 * means that if decodebin2 every autoplugs an element with two+ srcpads
43 * (e.g. a demuxer) this will end the chain and everything following this
44 * demuxer will be put into decode groups below the chain. Otherwise,
45 * if an element has a single srcpad that outputs raw data the decode chain
46 * is ended too and a GstDecodePad is stored and blocked.
48 * A decode group combines a number of chains that are created by a
49 * demuxer element. All those chains are connected through a multiqueue to
50 * the demuxer. A new group for the same demuxer is only created if the
51 * demuxer has signaled no-more-pads, in which case all following pads
52 * create a new chain in the new group.
54 * This continues until the top-level decode chain is complete. A decode
55 * chain is complete if it either ends with a blocked endpad, if autoplugging
56 * stopped because no suitable plugins could be found or if the active group
57 * is complete. A decode group on the other hand is complete if all child
58 * chains are complete.
60 * If this happens at some point, all endpads of all active groups are exposed.
61 * For this decodebin2 adds the endpads, signals no-more-pads and then unblocks
62 * them. Now playback starts.
64 * If one of the chains that end on a endpad receives EOS decodebin2 checks
65 * if all chains and groups are drained. In that case everything goes into EOS.
66 * If there is a chain where the active group is drained but there exist next
67 * groups, the active group is hidden (endpads are removed) and the next group
68 * is exposed. This means that in some cases more pads may be created even
69 * after the initial no-more-pads signal. This happens for example with
70 * so-called "chained oggs", most commonly found among ogg/vorbis internet
73 * Note 1: If we're talking about blocked endpads this really means that the
74 * *target* pads of the endpads are blocked. Pads that are exposed to the outside
75 * should never ever be blocked!
77 * Note 2: If a group is complete and the parent's chain demuxer adds new pads
78 * but never signaled no-more-pads this additional pads will be ignored!
86 #include <gst/gst-i18n-plugin.h>
90 #include <gst/pbutils/pbutils.h>
92 #include "gstplay-marshal.h"
93 #include "gstplay-enum.h"
94 #include "gstplayback.h"
95 #include "gstrawcaps.h"
97 /* generic templates */
98 static GstStaticPadTemplate decoder_bin_sink_template =
99 GST_STATIC_PAD_TEMPLATE ("sink",
102 GST_STATIC_CAPS_ANY);
104 static GstStaticPadTemplate decoder_bin_src_template =
105 GST_STATIC_PAD_TEMPLATE ("src%d",
108 GST_STATIC_CAPS_ANY);
110 GST_DEBUG_CATEGORY_STATIC (gst_decode_bin_debug);
111 #define GST_CAT_DEFAULT gst_decode_bin_debug
113 typedef struct _GstPendingPad GstPendingPad;
114 typedef struct _GstDecodeChain GstDecodeChain;
115 typedef struct _GstDecodeGroup GstDecodeGroup;
116 typedef struct _GstDecodePad GstDecodePad;
117 typedef GstGhostPadClass GstDecodePadClass;
118 typedef struct _GstDecodeBin GstDecodeBin;
119 typedef struct _GstDecodeBin GstDecodeBin2;
120 typedef struct _GstDecodeBinClass GstDecodeBinClass;
122 #define GST_TYPE_DECODE_BIN (gst_decode_bin_get_type())
123 #define GST_DECODE_BIN_CAST(obj) ((GstDecodeBin*)(obj))
124 #define GST_DECODE_BIN(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DECODE_BIN,GstDecodeBin))
125 #define GST_DECODE_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_DECODE_BIN,GstDecodeBinClass))
126 #define GST_IS_DECODE_BIN(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_DECODE_BIN))
127 #define GST_IS_DECODE_BIN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_DECODE_BIN))
132 * The opaque #DecodeBin2 data structure
136 GstBin bin; /* we extend GstBin */
139 GstCaps *caps; /* caps on which to stop decoding */
140 gchar *encoding; /* encoding of subtitles */
141 gboolean use_buffering; /* configure buffering on multiqueues */
144 guint max_size_bytes;
145 guint max_size_buffers;
146 guint64 max_size_time;
147 gboolean post_stream_topology;
149 GstElement *typefind; /* this holds the typefind object */
151 GMutex *expose_lock; /* Protects exposal and removal of groups */
152 GstDecodeChain *decode_chain; /* Top level decode chain */
153 gint nbpads; /* unique identifier for source pads */
155 GMutex *factories_lock;
156 guint32 factories_cookie; /* Cookie from last time when factories was updated */
157 GList *factories; /* factories we can use for selecting elements */
159 GMutex *subtitle_lock; /* Protects changes to subtitles and encoding */
160 GList *subtitles; /* List of elements with subtitle-encoding,
161 * protected by above mutex! */
163 gboolean have_type; /* if we received the have_type signal */
164 guint have_type_id; /* signal id for have-type from typefind */
166 gboolean async_pending; /* async-start has been emited */
168 GMutex *dyn_lock; /* lock protecting pad blocking */
169 gboolean shutdown; /* if we are shutting down */
170 GList *blocked_pads; /* pads that have set to block */
172 gboolean expose_allstreams; /* Whether to expose unknow type streams or not */
175 struct _GstDecodeBinClass
177 GstBinClass parent_class;
179 /* signal we fire when a new pad has been decoded into raw audio/video */
180 void (*new_decoded_pad) (GstElement * element, GstPad * pad, gboolean last);
181 /* signal we fire when a pad has been removed */
182 void (*removed_decoded_pad) (GstElement * element, GstPad * pad);
183 /* signal fired when we found a pad that we cannot decode */
184 void (*unknown_type) (GstElement * element, GstPad * pad, GstCaps * caps);
186 /* signal fired to know if we continue trying to decode the given caps */
187 gboolean (*autoplug_continue) (GstElement * element, GstPad * pad,
189 /* signal fired to get a list of factories to try to autoplug */
190 GValueArray *(*autoplug_factories) (GstElement * element, GstPad * pad,
192 /* signal fired to sort the factories */
193 GValueArray *(*autoplug_sort) (GstElement * element, GstPad * pad,
194 GstCaps * caps, GValueArray * factories);
195 /* signal fired to select from the proposed list of factories */
196 GstAutoplugSelectResult (*autoplug_select) (GstElement * element,
197 GstPad * pad, GstCaps * caps, GstElementFactory * factory);
199 /* fired when the last group is drained */
200 void (*drained) (GstElement * element);
206 SIGNAL_NEW_DECODED_PAD,
207 SIGNAL_REMOVED_DECODED_PAD,
209 SIGNAL_AUTOPLUG_CONTINUE,
210 SIGNAL_AUTOPLUG_FACTORIES,
211 SIGNAL_AUTOPLUG_SELECT,
212 SIGNAL_AUTOPLUG_SORT,
217 /* automatic sizes, while prerolling we buffer up to 2MB, we ignore time
218 * and buffers in this case. */
219 #define AUTO_PREROLL_SIZE_BYTES 2 * 1024 * 1024
220 #define AUTO_PREROLL_SIZE_BUFFERS 0
221 #define AUTO_PREROLL_SIZE_TIME 0
223 /* whan playing, keep a max of 2MB of data but try to keep the number of buffers
224 * as low as possible (try to aim for 5 buffers) */
225 #define AUTO_PLAY_SIZE_BYTES 2 * 1024 * 1024
226 #define AUTO_PLAY_SIZE_BUFFERS 5
227 #define AUTO_PLAY_SIZE_TIME 0
229 #define DEFAULT_SUBTITLE_ENCODING NULL
230 #define DEFAULT_USE_BUFFERING FALSE
231 #define DEFAULT_LOW_PERCENT 10
232 #define DEFAULT_HIGH_PERCENT 99
233 /* by default we use the automatic values above */
234 #define DEFAULT_MAX_SIZE_BYTES 0
235 #define DEFAULT_MAX_SIZE_BUFFERS 0
236 #define DEFAULT_MAX_SIZE_TIME 0
237 #define DEFAULT_POST_STREAM_TOPOLOGY FALSE
238 #define DEFAULT_EXPOSE_ALL_STREAMS TRUE
245 PROP_SUBTITLE_ENCODING,
251 PROP_MAX_SIZE_BUFFERS,
253 PROP_POST_STREAM_TOPOLOGY,
254 PROP_EXPOSE_ALL_STREAMS,
258 static GstBinClass *parent_class;
259 static guint gst_decode_bin_signals[LAST_SIGNAL] = { 0 };
261 static GstStaticCaps default_raw_caps = GST_STATIC_CAPS (DEFAULT_RAW_CAPS);
263 static void do_async_start (GstDecodeBin * dbin);
264 static void do_async_done (GstDecodeBin * dbin);
266 static void type_found (GstElement * typefind, guint probability,
267 GstCaps * caps, GstDecodeBin * decode_bin);
269 static void decodebin_set_queue_size (GstDecodeBin * dbin,
270 GstElement * multiqueue, gboolean preroll);
272 static gboolean gst_decode_bin_autoplug_continue (GstElement * element,
273 GstPad * pad, GstCaps * caps);
274 static GValueArray *gst_decode_bin_autoplug_factories (GstElement *
275 element, GstPad * pad, GstCaps * caps);
276 static GValueArray *gst_decode_bin_autoplug_sort (GstElement * element,
277 GstPad * pad, GstCaps * caps, GValueArray * factories);
278 static GstAutoplugSelectResult gst_decode_bin_autoplug_select (GstElement *
279 element, GstPad * pad, GstCaps * caps, GstElementFactory * factory);
281 static void gst_decode_bin_set_property (GObject * object, guint prop_id,
282 const GValue * value, GParamSpec * pspec);
283 static void gst_decode_bin_get_property (GObject * object, guint prop_id,
284 GValue * value, GParamSpec * pspec);
285 static void gst_decode_bin_set_caps (GstDecodeBin * dbin, GstCaps * caps);
286 static GstCaps *gst_decode_bin_get_caps (GstDecodeBin * dbin);
287 static void caps_notify_cb (GstPad * pad, GParamSpec * unused,
288 GstDecodeChain * chain);
290 static GstPad *find_sink_pad (GstElement * element);
291 static GstStateChangeReturn gst_decode_bin_change_state (GstElement * element,
292 GstStateChange transition);
294 #define EXPOSE_LOCK(dbin) G_STMT_START { \
295 GST_LOG_OBJECT (dbin, \
296 "expose locking from thread %p", \
298 g_mutex_lock (GST_DECODE_BIN_CAST(dbin)->expose_lock); \
299 GST_LOG_OBJECT (dbin, \
300 "expose locked from thread %p", \
304 #define EXPOSE_UNLOCK(dbin) G_STMT_START { \
305 GST_LOG_OBJECT (dbin, \
306 "expose unlocking from thread %p", \
308 g_mutex_unlock (GST_DECODE_BIN_CAST(dbin)->expose_lock); \
311 #define DYN_LOCK(dbin) G_STMT_START { \
312 GST_LOG_OBJECT (dbin, \
313 "dynlocking from thread %p", \
315 g_mutex_lock (GST_DECODE_BIN_CAST(dbin)->dyn_lock); \
316 GST_LOG_OBJECT (dbin, \
317 "dynlocked from thread %p", \
321 #define DYN_UNLOCK(dbin) G_STMT_START { \
322 GST_LOG_OBJECT (dbin, \
323 "dynunlocking from thread %p", \
325 g_mutex_unlock (GST_DECODE_BIN_CAST(dbin)->dyn_lock); \
328 #define SUBTITLE_LOCK(dbin) G_STMT_START { \
329 GST_LOG_OBJECT (dbin, \
330 "subtitle locking from thread %p", \
332 g_mutex_lock (GST_DECODE_BIN_CAST(dbin)->subtitle_lock); \
333 GST_LOG_OBJECT (dbin, \
334 "subtitle lock from thread %p", \
338 #define SUBTITLE_UNLOCK(dbin) G_STMT_START { \
339 GST_LOG_OBJECT (dbin, \
340 "subtitle unlocking from thread %p", \
342 g_mutex_unlock (GST_DECODE_BIN_CAST(dbin)->subtitle_lock); \
345 struct _GstPendingPad
348 GstDecodeChain *chain;
349 gulong event_probe_id;
354 * Streams belonging to the same group/chain of a media file
356 * When changing something here lock the parent chain!
358 struct _GstDecodeGroup
361 GstDecodeChain *parent;
363 GstElement *multiqueue; /* Used for linking all child chains */
364 gulong overrunsig; /* the overrun signal for multiqueue */
366 gboolean overrun; /* TRUE if the multiqueue signaled overrun. This
367 * means that we should really expose the group */
369 gboolean no_more_pads; /* TRUE if the demuxer signaled no-more-pads */
370 gboolean drained; /* TRUE if the all children are drained */
372 GList *children; /* List of GstDecodeChains in this group */
374 GList *reqpads; /* List of RequestPads for multiqueue, there is
375 * exactly one RequestPad per child chain */
378 struct _GstDecodeChain
380 GstDecodeGroup *parent;
383 GMutex *lock; /* Protects this chain and its groups */
385 GstPad *pad; /* srcpad that caused creation of this chain */
387 gboolean demuxer; /* TRUE if elements->data is a demuxer */
388 GList *elements; /* All elements in this group, first
389 is the latest and most downstream element */
391 /* Note: there are only groups if the last element of this chain
392 * is a demuxer, otherwise the chain will end with an endpad.
393 * The other way around this means, that endpad only exists if this
394 * chain doesn't end with a demuxer! */
396 GstDecodeGroup *active_group; /* Currently active group */
397 GList *next_groups; /* head is newest group, tail is next group.
398 a new group will be created only if the head
399 group had no-more-pads. If it's only exposed
400 all new pads will be ignored! */
401 GList *pending_pads; /* Pads that have no fixed caps yet */
403 GstDecodePad *endpad; /* Pad of this chain that could be exposed */
404 gboolean deadend; /* This chain is incomplete and can't be completed,
405 e.g. no suitable decoder could be found
406 e.g. stream got EOS without buffers
408 GstCaps *endcaps; /* Caps that were used when linking to the endpad
409 or that resulted in the deadend
412 /* FIXME: This should be done directly via a thread! */
413 GList *old_groups; /* Groups that should be freed later */
416 static void gst_decode_chain_free (GstDecodeChain * chain);
417 static GstDecodeChain *gst_decode_chain_new (GstDecodeBin * dbin,
418 GstDecodeGroup * group, GstPad * pad);
419 static void gst_decode_group_hide (GstDecodeGroup * group);
420 static void gst_decode_group_free (GstDecodeGroup * group);
421 static GstDecodeGroup *gst_decode_group_new (GstDecodeBin * dbin,
422 GstDecodeChain * chain);
423 static gboolean gst_decode_chain_is_complete (GstDecodeChain * chain);
424 static void gst_decode_chain_handle_eos (GstDecodeChain * chain);
425 static gboolean gst_decode_chain_expose (GstDecodeChain * chain,
426 GList ** endpads, gboolean * missing_plugin);
427 static gboolean gst_decode_chain_is_drained (GstDecodeChain * chain);
428 static gboolean gst_decode_group_is_complete (GstDecodeGroup * group);
429 static GstPad *gst_decode_group_control_demuxer_pad (GstDecodeGroup * group,
431 static gboolean gst_decode_group_is_drained (GstDecodeGroup * group);
433 static gboolean gst_decode_bin_expose (GstDecodeBin * dbin);
435 #define CHAIN_MUTEX_LOCK(chain) G_STMT_START { \
436 GST_LOG_OBJECT (chain->dbin, \
437 "locking chain %p from thread %p", \
438 chain, g_thread_self ()); \
439 g_mutex_lock (chain->lock); \
440 GST_LOG_OBJECT (chain->dbin, \
441 "locked chain %p from thread %p", \
442 chain, g_thread_self ()); \
445 #define CHAIN_MUTEX_UNLOCK(chain) G_STMT_START { \
446 GST_LOG_OBJECT (chain->dbin, \
447 "unlocking chain %p from thread %p", \
448 chain, g_thread_self ()); \
449 g_mutex_unlock (chain->lock); \
454 * GstPad private used for source pads of chains
460 GstDecodeChain *chain;
462 gboolean blocked; /* the *target* pad is blocked */
463 gboolean exposed; /* the pad is exposed */
464 gboolean drained; /* an EOS has been seen on the pad */
467 GType gst_decode_pad_get_type (void);
468 G_DEFINE_TYPE (GstDecodePad, gst_decode_pad, GST_TYPE_GHOST_PAD);
469 #define GST_TYPE_DECODE_PAD (gst_decode_pad_get_type ())
470 #define GST_DECODE_PAD(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_DECODE_PAD,GstDecodePad))
472 static GstDecodePad *gst_decode_pad_new (GstDecodeBin * dbin, GstPad * pad,
473 GstDecodeChain * chain);
474 static void gst_decode_pad_activate (GstDecodePad * dpad,
475 GstDecodeChain * chain);
476 static void gst_decode_pad_unblock (GstDecodePad * dpad);
477 static void gst_decode_pad_set_blocked (GstDecodePad * dpad, gboolean blocked);
479 static void gst_pending_pad_free (GstPendingPad * ppad);
480 static gboolean pad_event_cb (GstPad * pad, GstEvent * event, gpointer data);
482 /********************************
483 * Standard GObject boilerplate *
484 ********************************/
486 static void gst_decode_bin_class_init (GstDecodeBinClass * klass);
487 static void gst_decode_bin_init (GstDecodeBin * decode_bin);
488 static void gst_decode_bin_dispose (GObject * object);
489 static void gst_decode_bin_finalize (GObject * object);
492 gst_decode_bin_get_type (void)
494 static GType gst_decode_bin_type = 0;
496 if (!gst_decode_bin_type) {
497 static const GTypeInfo gst_decode_bin_info = {
498 sizeof (GstDecodeBinClass),
501 (GClassInitFunc) gst_decode_bin_class_init,
504 sizeof (GstDecodeBin),
506 (GInstanceInitFunc) gst_decode_bin_init,
510 gst_decode_bin_type =
511 g_type_register_static (GST_TYPE_BIN, "GstDecodeBin2",
512 &gst_decode_bin_info, 0);
515 return gst_decode_bin_type;
519 _gst_boolean_accumulator (GSignalInvocationHint * ihint,
520 GValue * return_accu, const GValue * handler_return, gpointer dummy)
524 myboolean = g_value_get_boolean (handler_return);
525 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
526 g_value_set_boolean (return_accu, myboolean);
528 /* stop emission if FALSE */
532 /* we collect the first result */
534 _gst_array_accumulator (GSignalInvocationHint * ihint,
535 GValue * return_accu, const GValue * handler_return, gpointer dummy)
539 array = g_value_get_boxed (handler_return);
540 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
541 g_value_set_boxed (return_accu, array);
547 _gst_select_accumulator (GSignalInvocationHint * ihint,
548 GValue * return_accu, const GValue * handler_return, gpointer dummy)
550 GstAutoplugSelectResult res;
552 res = g_value_get_enum (handler_return);
553 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
554 g_value_set_enum (return_accu, res);
560 _gst_array_hasvalue_accumulator (GSignalInvocationHint * ihint,
561 GValue * return_accu, const GValue * handler_return, gpointer dummy)
565 array = g_value_get_boxed (handler_return);
566 if (!(ihint->run_type & G_SIGNAL_RUN_CLEANUP))
567 g_value_set_boxed (return_accu, array);
576 gst_decode_bin_class_init (GstDecodeBinClass * klass)
578 GObjectClass *gobject_klass;
579 GstElementClass *gstelement_klass;
581 gobject_klass = (GObjectClass *) klass;
582 gstelement_klass = (GstElementClass *) klass;
584 parent_class = g_type_class_peek_parent (klass);
586 gobject_klass->dispose = gst_decode_bin_dispose;
587 gobject_klass->finalize = gst_decode_bin_finalize;
588 gobject_klass->set_property = gst_decode_bin_set_property;
589 gobject_klass->get_property = gst_decode_bin_get_property;
592 * GstDecodeBin2::new-decoded-pad:
593 * @bin: The decodebin.
594 * @pad: The newly created pad.
595 * @islast: #TRUE if this is the last pad to be added. Deprecated.
597 * This signal gets emitted as soon as a new pad of the same type as one of
598 * the valid 'raw' types is added.
600 * Deprecated: Use GstElement::pad-added instead of this signal.
603 gst_decode_bin_signals[SIGNAL_NEW_DECODED_PAD] =
604 g_signal_new ("new-decoded-pad", G_TYPE_FROM_CLASS (klass),
606 G_STRUCT_OFFSET (GstDecodeBinClass, new_decoded_pad), NULL, NULL,
607 gst_play_marshal_VOID__OBJECT_BOOLEAN, G_TYPE_NONE, 2, GST_TYPE_PAD,
611 * GstDecodeBin2::removed-decoded-pad:
612 * @bin: The decodebin.
613 * @pad: The pad that was removed.
615 * This signal is emitted when a 'final' caps pad has been removed.
617 * Deprecated: Use GstElement::pad-removed instead of this signal.
620 gst_decode_bin_signals[SIGNAL_REMOVED_DECODED_PAD] =
621 g_signal_new ("removed-decoded-pad", G_TYPE_FROM_CLASS (klass),
623 G_STRUCT_OFFSET (GstDecodeBinClass, removed_decoded_pad), NULL, NULL,
624 gst_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GST_TYPE_PAD);
627 * GstDecodeBin2::unknown-type:
628 * @bin: The decodebin.
629 * @pad: The new pad containing caps that cannot be resolved to a 'final'
631 * @caps: The #GstCaps of the pad that cannot be resolved.
633 * This signal is emitted when a pad for which there is no further possible
634 * decoding is added to the decodebin.
636 gst_decode_bin_signals[SIGNAL_UNKNOWN_TYPE] =
637 g_signal_new ("unknown-type", G_TYPE_FROM_CLASS (klass),
638 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, unknown_type),
639 NULL, NULL, gst_marshal_VOID__OBJECT_BOXED, G_TYPE_NONE, 2,
640 GST_TYPE_PAD, GST_TYPE_CAPS);
643 * GstDecodeBin2::autoplug-continue:
644 * @bin: The decodebin.
646 * @caps: The #GstCaps found.
648 * This signal is emitted whenever decodebin2 finds a new stream. It is
649 * emitted before looking for any elements that can handle that stream.
652 * Invocation of signal handlers stops after the first signal handler
653 * returns #FALSE. Signal handlers are invoked in the order they were
657 * Returns: #TRUE if you wish decodebin2 to look for elements that can
658 * handle the given @caps. If #FALSE, those caps will be considered as
659 * final and the pad will be exposed as such (see 'new-decoded-pad'
662 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE] =
663 g_signal_new ("autoplug-continue", G_TYPE_FROM_CLASS (klass),
664 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_continue),
665 _gst_boolean_accumulator, NULL, gst_play_marshal_BOOLEAN__OBJECT_BOXED,
666 G_TYPE_BOOLEAN, 2, GST_TYPE_PAD, GST_TYPE_CAPS);
669 * GstDecodeBin2::autoplug-factories:
670 * @bin: The decodebin.
672 * @caps: The #GstCaps found.
674 * This function is emited when an array of possible factories for @caps on
675 * @pad is needed. Decodebin2 will by default return an array with all
676 * compatible factories, sorted by rank.
678 * If this function returns NULL, @pad will be exposed as a final caps.
680 * If this function returns an empty array, the pad will be considered as
681 * having an unhandled type media type.
684 * Only the signal handler that is connected first will ever by invoked.
685 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
686 * signal, they will never be invoked!
689 * Returns: a #GValueArray* with a list of factories to try. The factories are
690 * by default tried in the returned order or based on the index returned by
693 gst_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES] =
694 g_signal_new ("autoplug-factories", G_TYPE_FROM_CLASS (klass),
695 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass,
696 autoplug_factories), _gst_array_accumulator, NULL,
697 gst_play_marshal_BOXED__OBJECT_BOXED, G_TYPE_VALUE_ARRAY, 2,
698 GST_TYPE_PAD, GST_TYPE_CAPS);
701 * GstDecodeBin2::autoplug-sort:
702 * @bin: The decodebin.
704 * @caps: The #GstCaps.
705 * @factories: A #GValueArray of possible #GstElementFactory to use.
707 * Once decodebin2 has found the possible #GstElementFactory objects to try
708 * for @caps on @pad, this signal is emited. The purpose of the signal is for
709 * the application to perform additional sorting or filtering on the element
712 * The callee should copy and modify @factories or return #NULL if the
713 * order should not change.
716 * Invocation of signal handlers stops after one signal handler has
717 * returned something else than #NULL. Signal handlers are invoked in
718 * the order they were connected in.
719 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
720 * signal, they will never be invoked!
723 * Returns: A new sorted array of #GstElementFactory objects.
725 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SORT] =
726 g_signal_new ("autoplug-sort", G_TYPE_FROM_CLASS (klass),
727 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_sort),
728 _gst_array_hasvalue_accumulator, NULL,
729 gst_play_marshal_BOXED__OBJECT_BOXED_BOXED, G_TYPE_VALUE_ARRAY, 3,
730 GST_TYPE_PAD, GST_TYPE_CAPS, G_TYPE_VALUE_ARRAY);
733 * GstDecodeBin2::autoplug-select:
734 * @bin: The decodebin.
736 * @caps: The #GstCaps.
737 * @factory: A #GstElementFactory to use.
739 * This signal is emitted once decodebin2 has found all the possible
740 * #GstElementFactory that can be used to handle the given @caps. For each of
741 * those factories, this signal is emited.
743 * The signal handler should return a #GST_TYPE_AUTOPLUG_SELECT_RESULT enum
744 * value indicating what decodebin2 should do next.
746 * A value of #GST_AUTOPLUG_SELECT_TRY will try to autoplug an element from
749 * A value of #GST_AUTOPLUG_SELECT_EXPOSE will expose @pad without plugging
752 * A value of #GST_AUTOPLUG_SELECT_SKIP will skip @factory and move to the
756 * Only the signal handler that is connected first will ever by invoked.
757 * Don't connect signal handlers with the #G_CONNECT_AFTER flag to this
758 * signal, they will never be invoked!
761 * Returns: a #GST_TYPE_AUTOPLUG_SELECT_RESULT that indicates the required
762 * operation. the default handler will always return
763 * #GST_AUTOPLUG_SELECT_TRY.
765 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT] =
766 g_signal_new ("autoplug-select", G_TYPE_FROM_CLASS (klass),
767 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, autoplug_select),
768 _gst_select_accumulator, NULL,
769 gst_play_marshal_ENUM__OBJECT_BOXED_OBJECT,
770 GST_TYPE_AUTOPLUG_SELECT_RESULT, 3, GST_TYPE_PAD, GST_TYPE_CAPS,
771 GST_TYPE_ELEMENT_FACTORY);
774 * GstDecodeBin2::drained
775 * @bin: The decodebin
777 * This signal is emitted once decodebin2 has finished decoding all the data.
781 gst_decode_bin_signals[SIGNAL_DRAINED] =
782 g_signal_new ("drained", G_TYPE_FROM_CLASS (klass),
783 G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDecodeBinClass, drained),
784 NULL, NULL, gst_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
786 g_object_class_install_property (gobject_klass, PROP_CAPS,
787 g_param_spec_boxed ("caps", "Caps", "The caps on which to stop decoding.",
788 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
790 g_object_class_install_property (gobject_klass, PROP_SUBTITLE_ENCODING,
791 g_param_spec_string ("subtitle-encoding", "subtitle encoding",
792 "Encoding to assume if input subtitles are not in UTF-8 encoding. "
793 "If not set, the GST_SUBTITLE_ENCODING environment variable will "
794 "be checked for an encoding to use. If that is not set either, "
795 "ISO-8859-15 will be assumed.", NULL,
796 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
798 g_object_class_install_property (gobject_klass, PROP_SINK_CAPS,
799 g_param_spec_boxed ("sink-caps", "Sink Caps",
800 "The caps of the input data. (NULL = use typefind element)",
801 GST_TYPE_CAPS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
804 * GstDecodeBin2::use-buffering
806 * Activate buffering in decodebin2. This will instruct the multiqueues behind
807 * decoders to emit BUFFERING messages.
811 g_object_class_install_property (gobject_klass, PROP_USE_BUFFERING,
812 g_param_spec_boolean ("use-buffering", "Use Buffering",
813 "Emit GST_MESSAGE_BUFFERING based on low-/high-percent thresholds",
814 DEFAULT_USE_BUFFERING, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
817 * GstDecodebin2:low-percent
819 * Low threshold percent for buffering to start.
823 g_object_class_install_property (gobject_klass, PROP_LOW_PERCENT,
824 g_param_spec_int ("low-percent", "Low percent",
825 "Low threshold for buffering to start", 0, 100,
826 DEFAULT_LOW_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
828 * GstDecodebin2:high-percent
830 * High threshold percent for buffering to finish.
834 g_object_class_install_property (gobject_klass, PROP_HIGH_PERCENT,
835 g_param_spec_int ("high-percent", "High percent",
836 "High threshold for buffering to finish", 0, 100,
837 DEFAULT_HIGH_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
840 * GstDecodebin2:max-size-bytes
842 * Max amount amount of bytes in the queue (0=automatic).
846 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_BYTES,
847 g_param_spec_uint ("max-size-bytes", "Max. size (bytes)",
848 "Max. amount of bytes in the queue (0=automatic)",
849 0, G_MAXUINT, DEFAULT_MAX_SIZE_BYTES,
850 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
852 * GstDecodebin2:max-size-buffers
854 * Max amount amount of buffers in the queue (0=automatic).
858 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_BUFFERS,
859 g_param_spec_uint ("max-size-buffers", "Max. size (buffers)",
860 "Max. number of buffers in the queue (0=automatic)",
861 0, G_MAXUINT, DEFAULT_MAX_SIZE_BUFFERS,
862 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
864 * GstDecodebin2:max-size-time
866 * Max amount amount of time in the queue (in ns, 0=automatic).
870 g_object_class_install_property (gobject_klass, PROP_MAX_SIZE_TIME,
871 g_param_spec_uint64 ("max-size-time", "Max. size (ns)",
872 "Max. amount of data in the queue (in ns, 0=automatic)",
874 DEFAULT_MAX_SIZE_TIME, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
877 * GstDecodeBin2::post-stream-topology
879 * Post stream-topology messages on the bus every time the topology changes.
883 g_object_class_install_property (gobject_klass, PROP_POST_STREAM_TOPOLOGY,
884 g_param_spec_boolean ("post-stream-topology", "Post Stream Topology",
885 "Post stream-topology messages",
886 DEFAULT_POST_STREAM_TOPOLOGY,
887 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
890 * GstDecodeBin2::expose-all-streams
892 * Expose streams of unknown type.
894 * If set to %FALSE, then only the streams that can be decoded to the final
895 * caps (see 'caps' property) will have a pad exposed. Streams that do not
896 * match those caps but could have been decoded will not have decoder plugged
897 * in internally and will not have a pad exposed.
901 g_object_class_install_property (gobject_klass, PROP_EXPOSE_ALL_STREAMS,
902 g_param_spec_boolean ("expose-all-streams", "Expose All Streams",
903 "Expose all streams, including those of unknown type or that don't match the 'caps' property",
904 DEFAULT_EXPOSE_ALL_STREAMS,
905 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
909 klass->autoplug_continue =
910 GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_continue);
911 klass->autoplug_factories =
912 GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_factories);
913 klass->autoplug_sort = GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_sort);
914 klass->autoplug_select = GST_DEBUG_FUNCPTR (gst_decode_bin_autoplug_select);
916 gst_element_class_add_pad_template (gstelement_klass,
917 gst_static_pad_template_get (&decoder_bin_sink_template));
918 gst_element_class_add_pad_template (gstelement_klass,
919 gst_static_pad_template_get (&decoder_bin_src_template));
921 gst_element_class_set_details_simple (gstelement_klass,
922 "Decoder Bin", "Generic/Bin/Decoder",
923 "Autoplug and decode to raw media",
924 "Edward Hervey <edward.hervey@collabora.co.uk>, "
925 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
927 gstelement_klass->change_state =
928 GST_DEBUG_FUNCPTR (gst_decode_bin_change_state);
931 /* Must be called with factories lock! */
933 gst_decode_bin_update_factories_list (GstDecodeBin * dbin)
936 || dbin->factories_cookie !=
937 gst_default_registry_get_feature_list_cookie ()) {
939 gst_plugin_feature_list_free (dbin->factories);
941 gst_element_factory_list_get_elements
942 (GST_ELEMENT_FACTORY_TYPE_DECODABLE, GST_RANK_MARGINAL);
943 dbin->factories_cookie = gst_default_registry_get_feature_list_cookie ();
948 gst_decode_bin_init (GstDecodeBin * decode_bin)
950 /* first filter out the interesting element factories */
951 decode_bin->factories_lock = g_mutex_new ();
953 /* we create the typefind element only once */
954 decode_bin->typefind = gst_element_factory_make ("typefind", "typefind");
955 if (!decode_bin->typefind) {
956 g_warning ("can't find typefind element, decodebin will not work");
960 GstPadTemplate *pad_tmpl;
962 /* add the typefind element */
963 if (!gst_bin_add (GST_BIN (decode_bin), decode_bin->typefind)) {
964 g_warning ("Could not add typefind element, decodebin will not work");
965 gst_object_unref (decode_bin->typefind);
966 decode_bin->typefind = NULL;
969 /* get the sinkpad */
970 pad = gst_element_get_static_pad (decode_bin->typefind, "sink");
972 /* get the pad template */
973 pad_tmpl = gst_static_pad_template_get (&decoder_bin_sink_template);
975 /* ghost the sink pad to ourself */
976 gpad = gst_ghost_pad_new_from_template ("sink", pad, pad_tmpl);
977 gst_pad_set_active (gpad, TRUE);
978 gst_element_add_pad (GST_ELEMENT (decode_bin), gpad);
980 gst_object_unref (pad_tmpl);
981 gst_object_unref (pad);
983 /* connect a signal to find out when the typefind element found
985 decode_bin->have_type_id =
986 g_signal_connect (G_OBJECT (decode_bin->typefind), "have-type",
987 G_CALLBACK (type_found), decode_bin);
990 decode_bin->expose_lock = g_mutex_new ();
991 decode_bin->decode_chain = NULL;
993 decode_bin->dyn_lock = g_mutex_new ();
994 decode_bin->shutdown = FALSE;
995 decode_bin->blocked_pads = NULL;
997 decode_bin->subtitle_lock = g_mutex_new ();
999 decode_bin->encoding = g_strdup (DEFAULT_SUBTITLE_ENCODING);
1000 decode_bin->caps = gst_static_caps_get (&default_raw_caps);
1001 decode_bin->use_buffering = DEFAULT_USE_BUFFERING;
1002 decode_bin->low_percent = DEFAULT_LOW_PERCENT;
1003 decode_bin->high_percent = DEFAULT_HIGH_PERCENT;
1005 decode_bin->max_size_bytes = DEFAULT_MAX_SIZE_BYTES;
1006 decode_bin->max_size_buffers = DEFAULT_MAX_SIZE_BUFFERS;
1007 decode_bin->max_size_time = DEFAULT_MAX_SIZE_TIME;
1009 decode_bin->expose_allstreams = DEFAULT_EXPOSE_ALL_STREAMS;
1013 gst_decode_bin_dispose (GObject * object)
1015 GstDecodeBin *decode_bin;
1017 decode_bin = GST_DECODE_BIN (object);
1019 if (decode_bin->factories)
1020 gst_plugin_feature_list_free (decode_bin->factories);
1021 decode_bin->factories = NULL;
1023 if (decode_bin->decode_chain)
1024 gst_decode_chain_free (decode_bin->decode_chain);
1025 decode_bin->decode_chain = NULL;
1027 if (decode_bin->caps)
1028 gst_caps_unref (decode_bin->caps);
1029 decode_bin->caps = NULL;
1031 g_free (decode_bin->encoding);
1032 decode_bin->encoding = NULL;
1034 g_list_free (decode_bin->subtitles);
1035 decode_bin->subtitles = NULL;
1037 G_OBJECT_CLASS (parent_class)->dispose (object);
1041 gst_decode_bin_finalize (GObject * object)
1043 GstDecodeBin *decode_bin;
1045 decode_bin = GST_DECODE_BIN (object);
1047 if (decode_bin->expose_lock) {
1048 g_mutex_free (decode_bin->expose_lock);
1049 decode_bin->expose_lock = NULL;
1052 if (decode_bin->dyn_lock) {
1053 g_mutex_free (decode_bin->dyn_lock);
1054 decode_bin->dyn_lock = NULL;
1057 if (decode_bin->subtitle_lock) {
1058 g_mutex_free (decode_bin->subtitle_lock);
1059 decode_bin->subtitle_lock = NULL;
1062 if (decode_bin->factories_lock) {
1063 g_mutex_free (decode_bin->factories_lock);
1064 decode_bin->factories_lock = NULL;
1067 G_OBJECT_CLASS (parent_class)->finalize (object);
1071 * Changes the caps on which decodebin will stop decoding.
1072 * Will unref the previously set one. The refcount of the given caps will be
1074 * @caps can be NULL.
1079 gst_decode_bin_set_caps (GstDecodeBin * dbin, GstCaps * caps)
1081 GST_DEBUG_OBJECT (dbin, "Setting new caps: %" GST_PTR_FORMAT, caps);
1083 GST_OBJECT_LOCK (dbin);
1084 gst_caps_replace (&dbin->caps, caps);
1085 GST_OBJECT_UNLOCK (dbin);
1089 * Returns the currently configured caps on which decodebin will stop decoding.
1090 * The returned caps (if not NULL), will have its refcount incremented.
1095 gst_decode_bin_get_caps (GstDecodeBin * dbin)
1099 GST_DEBUG_OBJECT (dbin, "Getting currently set caps");
1101 GST_OBJECT_LOCK (dbin);
1104 gst_caps_ref (caps);
1105 GST_OBJECT_UNLOCK (dbin);
1111 gst_decode_bin_set_sink_caps (GstDecodeBin * dbin, GstCaps * caps)
1113 GST_DEBUG_OBJECT (dbin, "Setting new caps: %" GST_PTR_FORMAT, caps);
1115 g_object_set (dbin->typefind, "force-caps", caps, NULL);
1119 gst_decode_bin_get_sink_caps (GstDecodeBin * dbin)
1123 GST_DEBUG_OBJECT (dbin, "Getting currently set caps");
1125 g_object_get (dbin->typefind, "force-caps", &caps, NULL);
1131 gst_decode_bin_set_subs_encoding (GstDecodeBin * dbin, const gchar * encoding)
1135 GST_DEBUG_OBJECT (dbin, "Setting new encoding: %s", GST_STR_NULL (encoding));
1137 SUBTITLE_LOCK (dbin);
1138 g_free (dbin->encoding);
1139 dbin->encoding = g_strdup (encoding);
1141 /* set the subtitle encoding on all added elements */
1142 for (walk = dbin->subtitles; walk; walk = g_list_next (walk)) {
1143 g_object_set (G_OBJECT (walk->data), "subtitle-encoding", dbin->encoding,
1146 SUBTITLE_UNLOCK (dbin);
1150 gst_decode_bin_get_subs_encoding (GstDecodeBin * dbin)
1154 GST_DEBUG_OBJECT (dbin, "Getting currently set encoding");
1156 SUBTITLE_LOCK (dbin);
1157 encoding = g_strdup (dbin->encoding);
1158 SUBTITLE_UNLOCK (dbin);
1164 gst_decode_bin_set_property (GObject * object, guint prop_id,
1165 const GValue * value, GParamSpec * pspec)
1169 dbin = GST_DECODE_BIN (object);
1173 gst_decode_bin_set_caps (dbin, g_value_get_boxed (value));
1175 case PROP_SUBTITLE_ENCODING:
1176 gst_decode_bin_set_subs_encoding (dbin, g_value_get_string (value));
1178 case PROP_SINK_CAPS:
1179 gst_decode_bin_set_sink_caps (dbin, g_value_get_boxed (value));
1181 case PROP_USE_BUFFERING:
1182 dbin->use_buffering = g_value_get_boolean (value);
1184 case PROP_LOW_PERCENT:
1185 dbin->low_percent = g_value_get_int (value);
1187 case PROP_HIGH_PERCENT:
1188 dbin->high_percent = g_value_get_int (value);
1190 case PROP_MAX_SIZE_BYTES:
1191 dbin->max_size_bytes = g_value_get_uint (value);
1193 case PROP_MAX_SIZE_BUFFERS:
1194 dbin->max_size_buffers = g_value_get_uint (value);
1196 case PROP_MAX_SIZE_TIME:
1197 dbin->max_size_time = g_value_get_uint64 (value);
1199 case PROP_POST_STREAM_TOPOLOGY:
1200 dbin->post_stream_topology = g_value_get_boolean (value);
1202 case PROP_EXPOSE_ALL_STREAMS:
1203 dbin->expose_allstreams = g_value_get_boolean (value);
1206 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1212 gst_decode_bin_get_property (GObject * object, guint prop_id,
1213 GValue * value, GParamSpec * pspec)
1217 dbin = GST_DECODE_BIN (object);
1220 g_value_take_boxed (value, gst_decode_bin_get_caps (dbin));
1222 case PROP_SUBTITLE_ENCODING:
1223 g_value_take_string (value, gst_decode_bin_get_subs_encoding (dbin));
1225 case PROP_SINK_CAPS:
1226 g_value_take_boxed (value, gst_decode_bin_get_sink_caps (dbin));
1228 case PROP_USE_BUFFERING:
1229 g_value_set_boolean (value, dbin->use_buffering);
1231 case PROP_LOW_PERCENT:
1232 g_value_set_int (value, dbin->low_percent);
1234 case PROP_HIGH_PERCENT:
1235 g_value_set_int (value, dbin->high_percent);
1237 case PROP_MAX_SIZE_BYTES:
1238 g_value_set_uint (value, dbin->max_size_bytes);
1240 case PROP_MAX_SIZE_BUFFERS:
1241 g_value_set_uint (value, dbin->max_size_buffers);
1243 case PROP_MAX_SIZE_TIME:
1244 g_value_set_uint64 (value, dbin->max_size_time);
1246 case PROP_POST_STREAM_TOPOLOGY:
1247 g_value_set_boolean (value, dbin->post_stream_topology);
1249 case PROP_EXPOSE_ALL_STREAMS:
1250 g_value_set_boolean (value, dbin->expose_allstreams);
1253 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1260 * Default autoplug signal handlers
1263 gst_decode_bin_autoplug_continue (GstElement * element, GstPad * pad,
1266 GST_DEBUG_OBJECT (element, "autoplug-continue returns TRUE");
1268 /* by default we always continue */
1272 static GValueArray *
1273 gst_decode_bin_autoplug_factories (GstElement * element, GstPad * pad,
1277 GValueArray *result;
1278 GstDecodeBin *dbin = GST_DECODE_BIN_CAST (element);
1280 GST_DEBUG_OBJECT (element, "finding factories");
1282 /* return all compatible factories for caps */
1283 g_mutex_lock (dbin->factories_lock);
1284 gst_decode_bin_update_factories_list (dbin);
1286 gst_element_factory_list_filter (dbin->factories, caps, GST_PAD_SINK,
1288 g_mutex_unlock (dbin->factories_lock);
1290 result = g_value_array_new (g_list_length (list));
1291 for (tmp = list; tmp; tmp = tmp->next) {
1292 GstElementFactory *factory = GST_ELEMENT_FACTORY_CAST (tmp->data);
1293 GValue val = { 0, };
1295 g_value_init (&val, G_TYPE_OBJECT);
1296 g_value_set_object (&val, factory);
1297 g_value_array_append (result, &val);
1298 g_value_unset (&val);
1300 gst_plugin_feature_list_free (list);
1302 GST_DEBUG_OBJECT (element, "autoplug-factories returns %p", result);
1307 static GValueArray *
1308 gst_decode_bin_autoplug_sort (GstElement * element, GstPad * pad,
1309 GstCaps * caps, GValueArray * factories)
1314 static GstAutoplugSelectResult
1315 gst_decode_bin_autoplug_select (GstElement * element, GstPad * pad,
1316 GstCaps * caps, GstElementFactory * factory)
1318 GST_DEBUG_OBJECT (element, "default autoplug-select returns TRY");
1321 return GST_AUTOPLUG_SELECT_TRY;
1328 static gboolean are_final_caps (GstDecodeBin * dbin, GstCaps * caps);
1329 static gboolean is_demuxer_element (GstElement * srcelement);
1331 static gboolean connect_pad (GstDecodeBin * dbin, GstElement * src,
1332 GstDecodePad * dpad, GstPad * pad, GstCaps * caps, GValueArray * factories,
1333 GstDecodeChain * chain);
1334 static gboolean connect_element (GstDecodeBin * dbin, GstElement * element,
1335 GstDecodeChain * chain);
1336 static void expose_pad (GstDecodeBin * dbin, GstElement * src,
1337 GstDecodePad * dpad, GstPad * pad, GstCaps * caps, GstDecodeChain * chain);
1339 static void pad_added_cb (GstElement * element, GstPad * pad,
1340 GstDecodeChain * chain);
1341 static void pad_removed_cb (GstElement * element, GstPad * pad,
1342 GstDecodeChain * chain);
1343 static void no_more_pads_cb (GstElement * element, GstDecodeChain * chain);
1345 static GstDecodeGroup *gst_decode_chain_get_current_group (GstDecodeChain *
1348 /* called when a new pad is discovered. It will perform some basic actions
1349 * before trying to link something to it.
1351 * - Check the caps, don't do anything when there are no caps or when they have
1353 * - signal AUTOPLUG_CONTINUE to check if we need to continue autoplugging this
1355 * - if the caps are non-fixed, setup a handler to continue autoplugging when
1356 * the caps become fixed (connect to notify::caps).
1357 * - get list of factories to autoplug.
1358 * - continue autoplugging to one of the factories.
1361 analyze_new_pad (GstDecodeBin * dbin, GstElement * src, GstPad * pad,
1362 GstCaps * caps, GstDecodeChain * chain)
1364 gboolean apcontinue = TRUE;
1365 GValueArray *factories = NULL, *result = NULL;
1368 GST_DEBUG_OBJECT (dbin, "Pad %s:%s caps:%" GST_PTR_FORMAT,
1369 GST_DEBUG_PAD_NAME (pad), caps);
1371 if (chain->elements && src != chain->elements->data) {
1372 GST_ERROR_OBJECT (dbin, "New pad from not the last element in this chain");
1376 if (chain->endpad) {
1377 GST_ERROR_OBJECT (dbin, "New pad in a chain that is already complete");
1381 if (chain->demuxer) {
1382 GstDecodeGroup *group;
1383 GstDecodeChain *oldchain = chain;
1385 /* we are adding a new pad for a demuxer (see is_demuxer_element(),
1386 * start a new chain for it */
1387 CHAIN_MUTEX_LOCK (oldchain);
1388 group = gst_decode_chain_get_current_group (chain);
1390 chain = gst_decode_chain_new (dbin, group, pad);
1391 group->children = g_list_prepend (group->children, chain);
1393 CHAIN_MUTEX_UNLOCK (oldchain);
1395 GST_WARNING_OBJECT (dbin, "No current group");
1400 if ((caps == NULL) || gst_caps_is_empty (caps))
1403 if (gst_caps_is_any (caps))
1406 dpad = gst_decode_pad_new (dbin, pad, chain);
1408 /* 1. Emit 'autoplug-continue' the result will tell us if this pads needs
1409 * further autoplugging. */
1410 g_signal_emit (G_OBJECT (dbin),
1411 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, dpad, caps,
1414 /* 1.a if autoplug-continue is FALSE or caps is a raw format, goto pad_is_final */
1415 if ((!apcontinue) || are_final_caps (dbin, caps))
1418 /* 1.b when the caps are not fixed yet, we can't be sure what element to
1419 * connect. We delay autoplugging until the caps are fixed */
1420 if (!gst_caps_is_fixed (caps))
1423 /* 1.c else get the factories and if there's no compatible factory goto
1425 g_signal_emit (G_OBJECT (dbin),
1426 gst_decode_bin_signals[SIGNAL_AUTOPLUG_FACTORIES], 0, dpad, caps,
1429 /* NULL means that we can expose the pad */
1430 if (factories == NULL)
1433 /* if the array is empty, we have a type for which we have no decoder */
1434 if (factories->n_values == 0) {
1435 if (!dbin->expose_allstreams) {
1436 GstCaps *raw = gst_static_caps_get (&default_raw_caps);
1438 /* If the caps are raw, this just means we don't want to expose them */
1439 if (gst_caps_can_intersect (raw, caps)) {
1440 gst_caps_unref (raw);
1441 gst_object_unref (dpad);
1442 goto discarded_type;
1444 gst_caps_unref (raw);
1447 /* if not we have a unhandled type with no compatible factories */
1448 g_value_array_free (factories);
1449 gst_object_unref (dpad);
1453 /* 1.d sort some more. */
1454 g_signal_emit (G_OBJECT (dbin),
1455 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SORT], 0, dpad, caps, factories,
1458 g_value_array_free (factories);
1462 /* At this point we have a potential decoder, but we might not need it
1463 * if it doesn't match the output caps */
1464 if (!dbin->expose_allstreams) {
1467 gboolean dontuse = FALSE;
1469 GST_DEBUG ("Checking if we can abort early");
1471 /* 1.e Do an early check to see if the candidates are potential decoders, but
1472 * due to the fact that they decode to a mediatype that is not final we don't
1475 for (i = 0; i < factories->n_values && !dontuse; i++) {
1476 GstElementFactory *factory =
1477 g_value_get_object (g_value_array_get_nth (factories, 0));
1480 /* We are only interested in skipping decoders */
1481 if (strstr (gst_element_factory_get_klass (factory), "Decoder")) {
1483 GST_DEBUG ("Trying factory %s",
1484 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1486 /* Check the source pad template caps to see if they match raw caps but don't match
1488 for (tmps = gst_element_factory_get_static_pad_templates (factory);
1489 tmps && !dontuse; tmps = tmps->next) {
1490 GstStaticPadTemplate *st = (GstStaticPadTemplate *) tmps->data;
1491 if (st->direction != GST_PAD_SRC)
1493 tcaps = gst_static_pad_template_get_caps (st);
1497 /* Emit autoplug-continue to see if the caps are considered to be raw caps */
1498 g_signal_emit (G_OBJECT (dbin),
1499 gst_decode_bin_signals[SIGNAL_AUTOPLUG_CONTINUE], 0, dpad, tcaps,
1502 /* If autoplug-continue returns TRUE and the caps are not final, don't use them */
1503 if (apcontinue && !are_final_caps (dbin, tcaps))
1505 gst_caps_unref (tcaps);
1511 gst_object_unref (dpad);
1512 goto discarded_type;
1516 /* 1.f else continue autoplugging something from the list. */
1517 GST_LOG_OBJECT (pad, "Let's continue discovery on this pad");
1518 connect_pad (dbin, src, dpad, pad, caps, factories, chain);
1520 gst_object_unref (dpad);
1521 g_value_array_free (factories);
1527 GST_LOG_OBJECT (dbin, "Pad is final. autoplug-continue:%d", apcontinue);
1528 expose_pad (dbin, src, dpad, pad, caps, chain);
1529 gst_object_unref (dpad);
1535 GST_LOG_OBJECT (pad, "Known type, but discarded because not final caps");
1536 chain->deadend = TRUE;
1537 chain->endcaps = gst_caps_ref (caps);
1539 /* Try to expose anything */
1541 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
1542 gst_decode_bin_expose (dbin);
1544 EXPOSE_UNLOCK (dbin);
1545 do_async_done (dbin);
1552 GST_LOG_OBJECT (pad, "Unknown type, posting message and firing signal");
1554 chain->deadend = TRUE;
1555 chain->endcaps = gst_caps_ref (caps);
1557 gst_element_post_message (GST_ELEMENT_CAST (dbin),
1558 gst_missing_decoder_message_new (GST_ELEMENT_CAST (dbin), caps));
1560 g_signal_emit (G_OBJECT (dbin),
1561 gst_decode_bin_signals[SIGNAL_UNKNOWN_TYPE], 0, pad, caps);
1563 /* Try to expose anything */
1565 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
1566 gst_decode_bin_expose (dbin);
1568 EXPOSE_UNLOCK (dbin);
1570 if (src == dbin->typefind) {
1573 if (caps && !gst_caps_is_empty (caps)) {
1574 desc = gst_pb_utils_get_decoder_description (caps);
1575 GST_ELEMENT_ERROR (dbin, STREAM, CODEC_NOT_FOUND,
1576 (_("A %s plugin is required to play this stream, "
1577 "but not installed."), desc),
1578 ("No decoder to handle media type '%s'",
1579 gst_structure_get_name (gst_caps_get_structure (caps, 0))));
1582 GST_ELEMENT_ERROR (dbin, STREAM, TYPE_NOT_FOUND,
1583 (_("Could not determine type of stream")),
1584 ("Stream caps %" GST_PTR_FORMAT, caps));
1586 do_async_done (dbin);
1592 GST_DEBUG_OBJECT (pad, "pad has non-fixed caps delay autoplugging");
1593 gst_object_unref (dpad);
1594 goto setup_caps_delay;
1598 GST_WARNING_OBJECT (pad,
1599 "pad has ANY caps, not able to autoplug to anything");
1600 goto setup_caps_delay;
1604 GstPendingPad *ppad;
1606 /* connect to caps notification */
1607 CHAIN_MUTEX_LOCK (chain);
1608 GST_LOG_OBJECT (dbin, "Chain %p has now %d dynamic pads", chain,
1609 g_list_length (chain->pending_pads));
1610 ppad = g_slice_new0 (GstPendingPad);
1611 ppad->pad = gst_object_ref (pad);
1612 ppad->chain = chain;
1613 ppad->event_probe_id =
1614 gst_pad_add_event_probe (pad, (GCallback) pad_event_cb, ppad);
1615 chain->pending_pads = g_list_prepend (chain->pending_pads, ppad);
1616 CHAIN_MUTEX_UNLOCK (chain);
1617 g_signal_connect (G_OBJECT (pad), "notify::caps",
1618 G_CALLBACK (caps_notify_cb), chain);
1626 * Try to connect the given pad to an element created from one of the factories,
1629 * Note that dpad is ghosting pad, and so pad is linked; be sure to unset dpad's
1630 * target before trying to link pad.
1632 * Returns TRUE if an element was properly created and linked
1635 connect_pad (GstDecodeBin * dbin, GstElement * src, GstDecodePad * dpad,
1636 GstPad * pad, GstCaps * caps, GValueArray * factories,
1637 GstDecodeChain * chain)
1639 gboolean res = FALSE;
1640 GstPad *mqpad = NULL;
1641 gboolean is_demuxer = chain->parent && !chain->elements; /* First pad after the demuxer */
1643 g_return_val_if_fail (factories != NULL, FALSE);
1644 g_return_val_if_fail (factories->n_values > 0, FALSE);
1646 GST_DEBUG_OBJECT (dbin, "pad %s:%s , chain:%p",
1647 GST_DEBUG_PAD_NAME (pad), chain);
1649 /* 1. is element demuxer or parser */
1651 GST_LOG_OBJECT (src,
1652 "is a demuxer, connecting the pad through multiqueue '%s'",
1653 GST_OBJECT_NAME (chain->parent->multiqueue));
1655 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1656 if (!(mqpad = gst_decode_group_control_demuxer_pad (chain->parent, pad)))
1658 src = chain->parent->multiqueue;
1660 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
1663 /* 2. Try to create an element and link to it */
1664 while (factories->n_values > 0) {
1665 GstAutoplugSelectResult ret;
1666 GstElementFactory *factory;
1667 GstElement *element;
1671 /* Set dpad target to pad again, it might've been unset
1672 * below but we came back here because something failed
1674 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
1676 /* take first factory */
1677 factory = g_value_get_object (g_value_array_get_nth (factories, 0));
1678 /* Remove selected factory from the list. */
1679 g_value_array_remove (factories, 0);
1681 /* If the factory is for a parser we first check if the factory
1682 * was already used for the current chain. If it was used already
1683 * we would otherwise create an infinite loop here because the
1684 * parser apparently accepts its own output as input.
1685 * This is only done for parsers because it's perfectly valid
1686 * to have other element classes after each other because a
1687 * parser is the only one that does not change the data. A
1688 * valid example for this would be multiple id3demux in a row.
1690 if (strstr (gst_element_factory_get_klass (factory), "Parser")) {
1691 gboolean skip = FALSE;
1694 CHAIN_MUTEX_LOCK (chain);
1695 for (l = chain->elements; l; l = l->next) {
1696 GstElement *otherelement = GST_ELEMENT_CAST (l->data);
1698 if (gst_element_get_factory (otherelement) == factory) {
1703 CHAIN_MUTEX_UNLOCK (chain);
1705 GST_DEBUG_OBJECT (dbin,
1706 "Skipping factory '%s' because it was already used in this chain",
1707 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE_CAST (factory)));
1712 /* emit autoplug-select to see what we should do with it. */
1713 g_signal_emit (G_OBJECT (dbin),
1714 gst_decode_bin_signals[SIGNAL_AUTOPLUG_SELECT],
1715 0, dpad, caps, factory, &ret);
1718 case GST_AUTOPLUG_SELECT_TRY:
1719 GST_DEBUG_OBJECT (dbin, "autoplug select requested try");
1721 case GST_AUTOPLUG_SELECT_EXPOSE:
1722 GST_DEBUG_OBJECT (dbin, "autoplug select requested expose");
1723 /* expose the pad, we don't have the source element */
1724 expose_pad (dbin, src, dpad, pad, caps, chain);
1727 case GST_AUTOPLUG_SELECT_SKIP:
1728 GST_DEBUG_OBJECT (dbin, "autoplug select requested skip");
1731 GST_WARNING_OBJECT (dbin, "autoplug select returned unhandled %d", ret);
1735 /* 2.0. Unlink pad */
1736 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
1738 /* 2.1. Try to create an element */
1739 if ((element = gst_element_factory_create (factory, NULL)) == NULL) {
1740 GST_WARNING_OBJECT (dbin, "Could not create an element from %s",
1741 gst_plugin_feature_get_name (GST_PLUGIN_FEATURE (factory)));
1745 /* ... activate it ... We do this before adding it to the bin so that we
1746 * don't accidentally make it post error messages that will stop
1748 if ((gst_element_set_state (element,
1749 GST_STATE_READY)) == GST_STATE_CHANGE_FAILURE) {
1750 GST_WARNING_OBJECT (dbin, "Couldn't set %s to READY",
1751 GST_ELEMENT_NAME (element));
1752 gst_object_unref (element);
1756 /* 2.3. Find its sink pad, this should work after activating it. */
1757 if (!(sinkpad = find_sink_pad (element))) {
1758 GST_WARNING_OBJECT (dbin, "Element %s doesn't have a sink pad",
1759 GST_ELEMENT_NAME (element));
1760 gst_element_set_state (element, GST_STATE_NULL);
1761 gst_object_unref (element);
1765 /* 2.4 add it ... */
1766 if (!(gst_bin_add (GST_BIN_CAST (dbin), element))) {
1767 GST_WARNING_OBJECT (dbin, "Couldn't add %s to the bin",
1768 GST_ELEMENT_NAME (element));
1769 gst_object_unref (sinkpad);
1770 gst_element_set_state (element, GST_STATE_NULL);
1771 gst_object_unref (element);
1775 /* 2.5 ...and try to link */
1776 if ((gst_pad_link (pad, sinkpad)) != GST_PAD_LINK_OK) {
1777 GST_WARNING_OBJECT (dbin, "Link failed on pad %s:%s",
1778 GST_DEBUG_PAD_NAME (sinkpad));
1779 gst_element_set_state (element, GST_STATE_NULL);
1780 gst_object_unref (sinkpad);
1781 gst_bin_remove (GST_BIN (dbin), element);
1784 gst_object_unref (sinkpad);
1785 GST_LOG_OBJECT (dbin, "linked on pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1787 CHAIN_MUTEX_LOCK (chain);
1789 g_list_prepend (chain->elements, gst_object_ref (element));
1790 chain->demuxer = is_demuxer_element (element);
1791 CHAIN_MUTEX_UNLOCK (chain);
1793 /* link this element further */
1794 connect_element (dbin, element, chain);
1796 /* try to configure the subtitle encoding property when we can */
1797 if (g_object_class_find_property (G_OBJECT_GET_CLASS (element),
1798 "subtitle-encoding")) {
1799 SUBTITLE_LOCK (dbin);
1800 GST_DEBUG_OBJECT (dbin,
1801 "setting subtitle-encoding=%s to element", dbin->encoding);
1802 g_object_set (G_OBJECT (element), "subtitle-encoding", dbin->encoding,
1804 SUBTITLE_UNLOCK (dbin);
1809 /* Bring the element to the state of the parent */
1810 if ((gst_element_set_state (element,
1811 GST_STATE_PAUSED)) == GST_STATE_CHANGE_FAILURE) {
1812 GstElement *tmp = NULL;
1814 GST_WARNING_OBJECT (dbin, "Couldn't set %s to PAUSED",
1815 GST_ELEMENT_NAME (element));
1817 /* Remove all elements in this chain that were just added. No
1818 * other thread could've added elements in the meantime */
1819 CHAIN_MUTEX_LOCK (chain);
1823 tmp = chain->elements->data;
1825 /* Disconnect any signal handlers that might be connected
1826 * in connect_element() or analyze_pad() */
1827 g_signal_handlers_disconnect_by_func (tmp, pad_added_cb, chain);
1828 g_signal_handlers_disconnect_by_func (tmp, pad_removed_cb, chain);
1829 g_signal_handlers_disconnect_by_func (tmp, no_more_pads_cb, chain);
1831 for (l = chain->pending_pads; l;) {
1832 GstPendingPad *pp = l->data;
1835 if (GST_PAD_PARENT (pp->pad) != tmp) {
1840 g_signal_handlers_disconnect_by_func (pp->pad, caps_notify_cb, chain);
1841 gst_pad_remove_event_probe (pp->pad, pp->event_probe_id);
1842 gst_object_unref (pp->pad);
1843 g_slice_free (GstPendingPad, pp);
1845 /* Remove element from the list, update list head and go to the
1846 * next element in the list */
1848 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
1852 gst_bin_remove (GST_BIN (dbin), tmp);
1853 gst_element_set_state (tmp, GST_STATE_NULL);
1855 gst_object_unref (tmp);
1856 chain->elements = g_list_delete_link (chain->elements, chain->elements);
1857 } while (tmp != element);
1858 CHAIN_MUTEX_UNLOCK (chain);
1863 SUBTITLE_LOCK (dbin);
1864 /* we added the element now, add it to the list of subtitle-encoding
1865 * elements when we can set the property */
1866 dbin->subtitles = g_list_prepend (dbin->subtitles, element);
1867 SUBTITLE_UNLOCK (dbin);
1876 gst_object_unref (mqpad);
1882 get_pad_caps (GstPad * pad)
1886 /* first check the pad caps, if this is set, we are positively sure it is
1887 * fixed and exactly what the element will produce. */
1888 GST_OBJECT_LOCK (pad);
1889 if ((caps = GST_PAD_CAPS (pad)))
1890 gst_caps_ref (caps);
1891 GST_OBJECT_UNLOCK (pad);
1893 /* then use the getcaps function if we don't have caps. These caps might not
1894 * be fixed in some cases, in which case analyze_new_pad will set up a
1895 * notify::caps signal to continue autoplugging. */
1897 caps = gst_pad_get_caps_reffed (pad);
1903 connect_element (GstDecodeBin * dbin, GstElement * element,
1904 GstDecodeChain * chain)
1907 gboolean res = TRUE;
1908 gboolean dynamic = FALSE;
1909 GList *to_connect = NULL;
1911 GST_DEBUG_OBJECT (dbin, "Attempting to connect element %s [chain:%p] further",
1912 GST_ELEMENT_NAME (element), chain);
1914 /* 1. Loop over pad templates, grabbing existing pads along the way */
1915 for (pads = GST_ELEMENT_GET_CLASS (element)->padtemplates; pads;
1916 pads = g_list_next (pads)) {
1917 GstPadTemplate *templ = GST_PAD_TEMPLATE (pads->data);
1918 const gchar *templ_name;
1920 /* we are only interested in source pads */
1921 if (GST_PAD_TEMPLATE_DIRECTION (templ) != GST_PAD_SRC)
1924 templ_name = GST_PAD_TEMPLATE_NAME_TEMPLATE (templ);
1925 GST_DEBUG_OBJECT (dbin, "got a source pad template %s", templ_name);
1927 /* figure out what kind of pad this is */
1928 switch (GST_PAD_TEMPLATE_PRESENCE (templ)) {
1929 case GST_PAD_ALWAYS:
1931 /* get the pad that we need to autoplug */
1932 GstPad *pad = gst_element_get_static_pad (element, templ_name);
1935 GST_DEBUG_OBJECT (dbin, "got the pad for always template %s",
1937 /* here is the pad, we need to autoplug it */
1938 to_connect = g_list_prepend (to_connect, pad);
1940 /* strange, pad is marked as always but it's not
1941 * there. Fix the element */
1942 GST_WARNING_OBJECT (dbin,
1943 "could not get the pad for always template %s", templ_name);
1947 case GST_PAD_SOMETIMES:
1949 /* try to get the pad to see if it is already created or
1951 GstPad *pad = gst_element_get_static_pad (element, templ_name);
1954 GST_DEBUG_OBJECT (dbin, "got the pad for sometimes template %s",
1956 /* the pad is created, we need to autoplug it */
1957 to_connect = g_list_prepend (to_connect, pad);
1959 GST_DEBUG_OBJECT (dbin,
1960 "did not get the sometimes pad of template %s", templ_name);
1961 /* we have an element that will create dynamic pads */
1966 case GST_PAD_REQUEST:
1967 /* ignore request pads */
1968 GST_DEBUG_OBJECT (dbin, "ignoring request padtemplate %s", templ_name);
1973 /* 2. if there are more potential pads, connect to relevant signals */
1975 GST_LOG_OBJECT (dbin, "Adding signals to element %s in chain %p",
1976 GST_ELEMENT_NAME (element), chain);
1977 g_signal_connect (G_OBJECT (element), "pad-added",
1978 G_CALLBACK (pad_added_cb), chain);
1979 g_signal_connect (G_OBJECT (element), "pad-removed",
1980 G_CALLBACK (pad_removed_cb), chain);
1981 g_signal_connect (G_OBJECT (element), "no-more-pads",
1982 G_CALLBACK (no_more_pads_cb), chain);
1985 /* 3. for every available pad, connect it */
1986 for (pads = to_connect; pads; pads = g_list_next (pads)) {
1987 GstPad *pad = GST_PAD_CAST (pads->data);
1990 caps = get_pad_caps (pad);
1991 analyze_new_pad (dbin, element, pad, caps, chain);
1993 gst_caps_unref (caps);
1995 gst_object_unref (pad);
1997 g_list_free (to_connect);
2004 * Expose the given pad on the chain as a decoded pad.
2007 expose_pad (GstDecodeBin * dbin, GstElement * src, GstDecodePad * dpad,
2008 GstPad * pad, GstCaps * caps, GstDecodeChain * chain)
2010 GstPad *mqpad = NULL;
2012 GST_DEBUG_OBJECT (dbin, "pad %s:%s, chain:%p",
2013 GST_DEBUG_PAD_NAME (pad), chain);
2015 /* If this is the first pad for this chain, there are no other elements
2016 * and the source element is not the multiqueue we must link through the
2019 * This is the case if a demuxer directly exposed a raw pad.
2021 if (chain->parent && !chain->elements && src != chain->parent->multiqueue) {
2022 GST_LOG_OBJECT (src, "connecting the pad through multiqueue");
2024 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), NULL);
2025 if (!(mqpad = gst_decode_group_control_demuxer_pad (chain->parent, pad)))
2028 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
2031 gst_decode_pad_activate (dpad, chain);
2032 chain->endpad = gst_object_ref (dpad);
2033 chain->endcaps = gst_caps_ref (caps);
2036 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2037 gst_decode_bin_expose (dbin);
2039 EXPOSE_UNLOCK (dbin);
2042 gst_object_unref (mqpad);
2049 type_found (GstElement * typefind, guint probability,
2050 GstCaps * caps, GstDecodeBin * decode_bin)
2052 GstPad *pad, *sink_pad;
2054 GST_DEBUG_OBJECT (decode_bin, "typefind found caps %" GST_PTR_FORMAT, caps);
2056 /* If the typefinder (but not something else) finds text/plain - i.e. that's
2057 * the top-level type of the file - then error out.
2059 if (gst_structure_has_name (gst_caps_get_structure (caps, 0), "text/plain")) {
2060 GST_ELEMENT_ERROR (decode_bin, STREAM, WRONG_TYPE,
2061 (_("This appears to be a text file")),
2062 ("decodebin2 cannot decode plain text files"));
2066 /* FIXME: we can only deal with one type, we don't yet support dynamically changing
2067 * caps from the typefind element */
2068 if (decode_bin->have_type || decode_bin->decode_chain)
2071 decode_bin->have_type = TRUE;
2073 pad = gst_element_get_static_pad (typefind, "src");
2074 sink_pad = gst_element_get_static_pad (typefind, "sink");
2076 /* need some lock here to prevent race with shutdown state change
2077 * which might yank away e.g. decode_chain while building stuff here.
2078 * In typical cases, STREAM_LOCK is held and handles that, it need not
2079 * be held (if called from a proxied setcaps), so grab it anyway */
2080 GST_PAD_STREAM_LOCK (sink_pad);
2081 decode_bin->decode_chain = gst_decode_chain_new (decode_bin, NULL, pad);
2082 analyze_new_pad (decode_bin, typefind, pad, caps, decode_bin->decode_chain);
2083 GST_PAD_STREAM_UNLOCK (sink_pad);
2085 gst_object_unref (sink_pad);
2086 gst_object_unref (pad);
2093 pad_event_cb (GstPad * pad, GstEvent * event, gpointer data)
2095 GstPendingPad *ppad = (GstPendingPad *) data;
2096 GstDecodeChain *chain = ppad->chain;
2097 GstDecodeBin *dbin = chain->dbin;
2102 switch (GST_EVENT_TYPE (event)) {
2104 GST_DEBUG_OBJECT (dbin, "Received EOS on a non final pad, this stream "
2106 chain->deadend = TRUE;
2107 /* we don't set the endcaps because NULL endcaps means early EOS */
2109 if (gst_decode_chain_is_complete (dbin->decode_chain))
2110 gst_decode_bin_expose (dbin);
2111 EXPOSE_UNLOCK (dbin);
2120 pad_added_cb (GstElement * element, GstPad * pad, GstDecodeChain * chain)
2127 GST_DEBUG_OBJECT (pad, "pad added, chain:%p", chain);
2129 caps = get_pad_caps (pad);
2130 analyze_new_pad (dbin, element, pad, caps, chain);
2132 gst_caps_unref (caps);
2135 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2136 GST_LOG_OBJECT (dbin,
2137 "That was the last dynamic object, now attempting to expose the group");
2138 if (!gst_decode_bin_expose (dbin))
2139 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
2141 EXPOSE_UNLOCK (dbin);
2145 pad_removed_cb (GstElement * element, GstPad * pad, GstDecodeChain * chain)
2149 GST_LOG_OBJECT (pad, "pad removed, chain:%p", chain);
2151 /* In fact, we don't have to do anything here, the active group will be
2152 * removed when the group's multiqueue is drained */
2153 CHAIN_MUTEX_LOCK (chain);
2154 for (l = chain->pending_pads; l; l = l->next) {
2155 GstPendingPad *ppad = l->data;
2156 GstPad *opad = ppad->pad;
2159 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2160 gst_pending_pad_free (ppad);
2161 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2165 CHAIN_MUTEX_UNLOCK (chain);
2169 no_more_pads_cb (GstElement * element, GstDecodeChain * chain)
2171 GstDecodeGroup *group = NULL;
2173 GST_LOG_OBJECT (element, "got no more pads");
2175 CHAIN_MUTEX_LOCK (chain);
2176 if (!chain->elements || (GstElement *) chain->elements->data != element) {
2177 GST_LOG_OBJECT (chain->dbin, "no-more-pads from old chain element '%s'",
2178 GST_OBJECT_NAME (element));
2179 CHAIN_MUTEX_UNLOCK (chain);
2181 } else if (!chain->demuxer) {
2182 GST_LOG_OBJECT (chain->dbin, "no-more-pads from a non-demuxer element '%s'",
2183 GST_OBJECT_NAME (element));
2184 CHAIN_MUTEX_UNLOCK (chain);
2188 /* when we received no_more_pads, we can complete the pads of the chain */
2189 if (!chain->next_groups && chain->active_group) {
2190 group = chain->active_group;
2191 } else if (chain->next_groups) {
2192 group = chain->next_groups->data;
2195 GST_ERROR_OBJECT (chain->dbin, "can't find group for element");
2196 CHAIN_MUTEX_UNLOCK (chain);
2200 GST_DEBUG_OBJECT (element, "Setting group %p to complete", group);
2202 group->no_more_pads = TRUE;
2203 /* this group has prerolled enough to not need more pads,
2204 * we can probably set its buffering state to playing now */
2205 GST_DEBUG_OBJECT (group->dbin, "Setting group %p multiqueue to "
2206 "'playing' buffering mode", group);
2207 decodebin_set_queue_size (group->dbin, group->multiqueue, FALSE);
2208 CHAIN_MUTEX_UNLOCK (chain);
2210 EXPOSE_LOCK (chain->dbin);
2211 if (gst_decode_chain_is_complete (chain->dbin->decode_chain)) {
2212 gst_decode_bin_expose (chain->dbin);
2214 EXPOSE_UNLOCK (chain->dbin);
2218 caps_notify_cb (GstPad * pad, GParamSpec * unused, GstDecodeChain * chain)
2220 GstElement *element;
2223 GST_LOG_OBJECT (pad, "Notified caps for pad %s:%s", GST_DEBUG_PAD_NAME (pad));
2225 /* Disconnect this; if we still need it, we'll reconnect to this in
2226 * analyze_new_pad */
2227 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2229 element = GST_ELEMENT_CAST (gst_pad_get_parent (pad));
2231 CHAIN_MUTEX_LOCK (chain);
2232 for (l = chain->pending_pads; l; l = l->next) {
2233 GstPendingPad *ppad = l->data;
2234 if (ppad->pad == pad) {
2235 gst_pending_pad_free (ppad);
2236 chain->pending_pads = g_list_delete_link (chain->pending_pads, l);
2240 CHAIN_MUTEX_UNLOCK (chain);
2242 pad_added_cb (element, pad, chain);
2244 gst_object_unref (element);
2247 /* Decide whether an element is a demuxer based on the
2248 * klass and number/type of src pad templates it has */
2250 is_demuxer_element (GstElement * srcelement)
2252 GstElementFactory *srcfactory;
2253 GstElementClass *elemclass;
2256 gint potential_src_pads = 0;
2258 srcfactory = gst_element_get_factory (srcelement);
2259 klass = gst_element_factory_get_klass (srcfactory);
2261 /* Can't be a demuxer unless it has Demux in the klass name */
2262 if (!strstr (klass, "Demux"))
2265 /* Walk the src pad templates and count how many the element
2267 elemclass = GST_ELEMENT_GET_CLASS (srcelement);
2269 walk = gst_element_class_get_pad_template_list (elemclass);
2270 while (walk != NULL) {
2271 GstPadTemplate *templ;
2273 templ = (GstPadTemplate *) walk->data;
2274 if (GST_PAD_TEMPLATE_DIRECTION (templ) == GST_PAD_SRC) {
2275 switch (GST_PAD_TEMPLATE_PRESENCE (templ)) {
2276 case GST_PAD_ALWAYS:
2277 case GST_PAD_SOMETIMES:
2278 if (strstr (GST_PAD_TEMPLATE_NAME_TEMPLATE (templ), "%"))
2279 potential_src_pads += 2; /* Might make multiple pads */
2281 potential_src_pads += 1;
2283 case GST_PAD_REQUEST:
2284 potential_src_pads += 2;
2288 walk = g_list_next (walk);
2291 if (potential_src_pads < 2)
2297 /* Returns TRUE if the caps are compatible with the caps specified in the 'caps'
2298 * property (which by default are the raw caps)
2300 * The decodebin_lock should be taken !
2303 are_final_caps (GstDecodeBin * dbin, GstCaps * caps)
2307 GST_LOG_OBJECT (dbin, "Checking with caps %" GST_PTR_FORMAT, caps);
2309 /* lock for getting the caps */
2310 GST_OBJECT_LOCK (dbin);
2311 res = gst_caps_can_intersect (dbin->caps, caps);
2312 GST_OBJECT_UNLOCK (dbin);
2314 GST_LOG_OBJECT (dbin, "Caps are %sfinal caps", res ? "" : "not ");
2320 * GstDecodeChain functions
2323 /* gst_decode_chain_get_current_group:
2325 * Returns the current group of this chain, to which
2326 * new chains should be attached or NULL if the last
2327 * group didn't have no-more-pads.
2329 * Not MT-safe: Call with parent chain lock!
2331 static GstDecodeGroup *
2332 gst_decode_chain_get_current_group (GstDecodeChain * chain)
2334 GstDecodeGroup *group;
2336 if (!chain->next_groups && chain->active_group
2337 && chain->active_group->overrun && !chain->active_group->no_more_pads) {
2338 GST_WARNING_OBJECT (chain->dbin,
2339 "Currently active group %p is exposed"
2340 " and wants to add a new pad without having signaled no-more-pads",
2341 chain->active_group);
2345 if (chain->next_groups && (group = chain->next_groups->data) && group->overrun
2346 && !group->no_more_pads) {
2347 GST_WARNING_OBJECT (chain->dbin,
2348 "Currently newest pending group %p "
2349 "had overflow but didn't signal no-more-pads", group);
2353 /* Now we know that we can really return something useful */
2354 if (!chain->active_group) {
2355 chain->active_group = group = gst_decode_group_new (chain->dbin, chain);
2356 } else if (!chain->active_group->overrun
2357 && !chain->active_group->no_more_pads) {
2358 group = chain->active_group;
2359 } else if (chain->next_groups && (group = chain->next_groups->data)
2360 && !group->overrun && !group->no_more_pads) {
2361 /* group = chain->next_groups->data */
2363 group = gst_decode_group_new (chain->dbin, chain);
2364 chain->next_groups = g_list_prepend (chain->next_groups, group);
2370 static void gst_decode_group_free_internal (GstDecodeGroup * group,
2374 gst_decode_chain_free_internal (GstDecodeChain * chain, gboolean hide)
2378 CHAIN_MUTEX_LOCK (chain);
2380 GST_DEBUG_OBJECT (chain->dbin, "%s chain %p", (hide ? "Hiding" : "Freeing"),
2383 if (chain->active_group) {
2384 gst_decode_group_free_internal (chain->active_group, hide);
2386 chain->active_group = NULL;
2389 for (l = chain->next_groups; l; l = l->next) {
2390 gst_decode_group_free_internal ((GstDecodeGroup *) l->data, hide);
2395 g_list_free (chain->next_groups);
2396 chain->next_groups = NULL;
2400 for (l = chain->old_groups; l; l = l->next) {
2401 GstDecodeGroup *group = l->data;
2403 gst_decode_group_free (group);
2405 g_list_free (chain->old_groups);
2406 chain->old_groups = NULL;
2409 for (l = chain->pending_pads; l; l = l->next) {
2410 GstPendingPad *ppad = l->data;
2411 GstPad *pad = ppad->pad;
2413 g_signal_handlers_disconnect_by_func (pad, caps_notify_cb, chain);
2414 gst_pending_pad_free (ppad);
2417 g_list_free (chain->pending_pads);
2418 chain->pending_pads = NULL;
2420 for (l = chain->elements; l; l = l->next) {
2421 GstElement *element = GST_ELEMENT (l->data);
2423 g_signal_handlers_disconnect_by_func (element, pad_added_cb, chain);
2424 g_signal_handlers_disconnect_by_func (element, pad_removed_cb, chain);
2425 g_signal_handlers_disconnect_by_func (element, no_more_pads_cb, chain);
2427 if (GST_OBJECT_PARENT (element) == GST_OBJECT_CAST (chain->dbin))
2428 gst_bin_remove (GST_BIN_CAST (chain->dbin), element);
2430 gst_element_set_state (element, GST_STATE_NULL);
2433 SUBTITLE_LOCK (chain->dbin);
2434 /* remove possible subtitle element */
2435 chain->dbin->subtitles = g_list_remove (chain->dbin->subtitles, element);
2436 SUBTITLE_UNLOCK (chain->dbin);
2439 gst_object_unref (element);
2444 g_list_free (chain->elements);
2445 chain->elements = NULL;
2448 if (chain->endpad) {
2449 if (chain->endpad->exposed) {
2450 gst_element_remove_pad (GST_ELEMENT_CAST (chain->dbin),
2451 GST_PAD_CAST (chain->endpad));
2452 g_signal_emit (G_OBJECT (chain->dbin),
2453 gst_decode_bin_signals[SIGNAL_REMOVED_DECODED_PAD], 0, chain->endpad);
2456 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (chain->endpad), NULL);
2457 chain->endpad->exposed = FALSE;
2459 gst_object_unref (chain->endpad);
2460 chain->endpad = NULL;
2465 gst_object_unref (chain->pad);
2469 if (chain->endcaps) {
2470 gst_caps_unref (chain->endcaps);
2471 chain->endcaps = NULL;
2474 GST_DEBUG_OBJECT (chain->dbin, "%s chain %p", (hide ? "Hidden" : "Freed"),
2476 CHAIN_MUTEX_UNLOCK (chain);
2478 g_mutex_free (chain->lock);
2479 g_slice_free (GstDecodeChain, chain);
2483 /* gst_decode_chain_free:
2485 * Completely frees and removes the chain and all
2486 * child groups from decodebin2.
2488 * MT-safe, don't hold the chain lock or any child chain's lock
2489 * when calling this!
2492 gst_decode_chain_free (GstDecodeChain * chain)
2494 gst_decode_chain_free_internal (chain, FALSE);
2497 /* gst_decode_chain_new:
2499 * Creates a new decode chain and initializes it.
2501 * It's up to the caller to add it to the list of child chains of
2504 static GstDecodeChain *
2505 gst_decode_chain_new (GstDecodeBin * dbin, GstDecodeGroup * parent,
2508 GstDecodeChain *chain = g_slice_new0 (GstDecodeChain);
2510 GST_DEBUG_OBJECT (dbin, "Creating new chain %p with parent group %p", chain,
2514 chain->parent = parent;
2515 chain->lock = g_mutex_new ();
2516 chain->pad = gst_object_ref (pad);
2522 * GstDecodeGroup functions
2525 /* The overrun callback is used to expose groups that have not yet had their
2526 * no_more_pads called while the (large) multiqueue overflowed. When this
2527 * happens we must assume that the no_more_pads will not arrive anymore and we
2528 * must expose the pads that we have.
2531 multi_queue_overrun_cb (GstElement * queue, GstDecodeGroup * group)
2537 GST_LOG_OBJECT (dbin, "multiqueue '%s' (%p) is full", GST_OBJECT_NAME (queue),
2540 group->overrun = TRUE;
2542 /* FIXME: We should make sure that everything gets exposed now
2543 * even if child chains are not complete because the will never
2544 * be complete! Ignore any non-complete chains when exposing
2545 * and never expose them later
2549 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
2550 if (!gst_decode_bin_expose (dbin))
2551 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
2553 EXPOSE_UNLOCK (group->dbin);
2557 gst_decode_group_free_internal (GstDecodeGroup * group, gboolean hide)
2561 GST_DEBUG_OBJECT (group->dbin, "%s group %p", (hide ? "Hiding" : "Freeing"),
2563 for (l = group->children; l; l = l->next) {
2564 GstDecodeChain *chain = (GstDecodeChain *) l->data;
2566 gst_decode_chain_free_internal (chain, hide);
2571 g_list_free (group->children);
2572 group->children = NULL;
2576 for (l = group->reqpads; l; l = l->next) {
2577 GstPad *pad = l->data;
2579 gst_element_release_request_pad (group->multiqueue, pad);
2580 gst_object_unref (pad);
2583 g_list_free (group->reqpads);
2584 group->reqpads = NULL;
2587 if (group->multiqueue) {
2588 if (group->overrunsig) {
2589 g_signal_handler_disconnect (group->multiqueue, group->overrunsig);
2590 group->overrunsig = 0;
2593 if (GST_OBJECT_PARENT (group->multiqueue) == GST_OBJECT_CAST (group->dbin))
2594 gst_bin_remove (GST_BIN_CAST (group->dbin), group->multiqueue);
2596 gst_element_set_state (group->multiqueue, GST_STATE_NULL);
2597 gst_object_unref (group->multiqueue);
2598 group->multiqueue = NULL;
2602 GST_DEBUG_OBJECT (group->dbin, "%s group %p", (hide ? "Hided" : "Freed"),
2605 g_slice_free (GstDecodeGroup, group);
2608 /* gst_decode_group_free:
2610 * Completely frees and removes the decode group and all
2613 * Never call this from any streaming thread!
2615 * Not MT-safe, call with parent's chain lock!
2618 gst_decode_group_free (GstDecodeGroup * group)
2620 gst_decode_group_free_internal (group, FALSE);
2623 /* gst_decode_group_hide:
2625 * Hide the decode group only, this means that
2626 * all child endpads are removed from decodebin2
2627 * and all signals are unconnected.
2629 * No element is set to NULL state and completely
2632 * Can be called from streaming threads.
2634 * Not MT-safe, call with parent's chain lock!
2637 gst_decode_group_hide (GstDecodeGroup * group)
2639 gst_decode_group_free_internal (group, TRUE);
2642 /* configure queue sizes, this depends on the buffering method and if we are
2643 * playing or prerolling. */
2645 decodebin_set_queue_size (GstDecodeBin * dbin, GstElement * multiqueue,
2648 guint max_bytes, max_buffers;
2651 if (preroll || dbin->use_buffering) {
2652 /* takes queue limits, initially we only queue up up to the max bytes limit,
2653 * with a default of 2MB. we use the same values for buffering mode. */
2654 if ((max_bytes = dbin->max_size_bytes) == 0)
2655 max_bytes = AUTO_PREROLL_SIZE_BYTES;
2656 if ((max_buffers = dbin->max_size_buffers) == 0)
2657 max_buffers = AUTO_PREROLL_SIZE_BUFFERS;
2658 if ((max_time = dbin->max_size_time) == 0)
2659 max_time = AUTO_PREROLL_SIZE_TIME;
2661 /* update runtime limits. At runtime, we try to keep the amount of buffers
2662 * in the queues as low as possible (but at least 5 buffers). */
2663 if ((max_bytes = dbin->max_size_bytes) == 0)
2664 max_bytes = AUTO_PLAY_SIZE_BYTES;
2665 if ((max_buffers = dbin->max_size_buffers) == 0)
2666 max_buffers = AUTO_PLAY_SIZE_BUFFERS;
2667 if ((max_time = dbin->max_size_time) == 0)
2668 max_time = AUTO_PLAY_SIZE_TIME;
2671 g_object_set (multiqueue,
2672 "max-size-bytes", max_bytes, "max-size-time", max_time,
2673 "max-size-buffers", max_buffers, NULL);
2676 /* gst_decode_group_new:
2677 * @dbin: Parent decodebin
2678 * @parent: Parent chain or %NULL
2680 * Creates a new GstDecodeGroup. It is up to the caller to add it to the list
2683 static GstDecodeGroup *
2684 gst_decode_group_new (GstDecodeBin * dbin, GstDecodeChain * parent)
2686 GstDecodeGroup *group = g_slice_new0 (GstDecodeGroup);
2689 GST_DEBUG_OBJECT (dbin, "Creating new group %p with parent chain %p", group,
2693 group->parent = parent;
2695 mq = group->multiqueue = gst_element_factory_make ("multiqueue", NULL);
2696 if (G_UNLIKELY (!group->multiqueue))
2697 goto missing_multiqueue;
2699 g_object_set (mq, "use-buffering", dbin->use_buffering, NULL);
2700 if (dbin->use_buffering) {
2701 g_object_set (mq, "low-percent", dbin->low_percent, NULL);
2702 g_object_set (mq, "high-percent", dbin->high_percent, NULL);
2705 /* configure queue sizes for preroll */
2706 decodebin_set_queue_size (dbin, mq, TRUE);
2708 group->overrunsig = g_signal_connect (G_OBJECT (mq), "overrun",
2709 G_CALLBACK (multi_queue_overrun_cb), group);
2711 gst_bin_add (GST_BIN (dbin), gst_object_ref (mq));
2712 gst_element_set_state (mq, GST_STATE_PAUSED);
2719 gst_element_post_message (GST_ELEMENT_CAST (dbin),
2720 gst_missing_element_message_new (GST_ELEMENT_CAST (dbin),
2722 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL), ("no multiqueue!"));
2723 g_slice_free (GstDecodeGroup, group);
2728 /* gst_decode_group_control_demuxer_pad
2730 * Adds a new demuxer srcpad to the given group.
2732 * Returns the srcpad of the multiqueue corresponding the given pad.
2733 * Returns NULL if there was an error.
2736 gst_decode_group_control_demuxer_pad (GstDecodeGroup * group, GstPad * pad)
2739 GstPad *srcpad, *sinkpad;
2740 GstIterator *it = NULL;
2744 GST_LOG_OBJECT (dbin, "group:%p pad %s:%s", group, GST_DEBUG_PAD_NAME (pad));
2748 if (G_UNLIKELY (!group->multiqueue))
2751 if (!(sinkpad = gst_element_get_request_pad (group->multiqueue, "sink%d"))) {
2752 GST_ERROR_OBJECT (dbin, "Couldn't get sinkpad from multiqueue");
2756 if ((gst_pad_link (pad, sinkpad) != GST_PAD_LINK_OK)) {
2757 GST_ERROR_OBJECT (dbin, "Couldn't link demuxer and multiqueue");
2761 it = gst_pad_iterate_internal_links (sinkpad);
2763 if (!it || (gst_iterator_next (it, (gpointer) & srcpad)) != GST_ITERATOR_OK
2764 || srcpad == NULL) {
2765 GST_ERROR_OBJECT (dbin,
2766 "Couldn't get srcpad from multiqueue for sinkpad %" GST_PTR_FORMAT,
2771 CHAIN_MUTEX_LOCK (group->parent);
2772 group->reqpads = g_list_prepend (group->reqpads, gst_object_ref (sinkpad));
2773 CHAIN_MUTEX_UNLOCK (group->parent);
2777 gst_iterator_free (it);
2778 gst_object_unref (sinkpad);
2782 gst_element_release_request_pad (group->multiqueue, sinkpad);
2786 /* gst_decode_group_is_complete:
2788 * Checks if the group is complete, this means that
2789 * a) overrun of the multiqueue or no-more-pads happened
2790 * b) all child chains are complete
2792 * Not MT-safe, always call with decodebin expose lock
2795 gst_decode_group_is_complete (GstDecodeGroup * group)
2798 gboolean complete = TRUE;
2800 if (!group->overrun && !group->no_more_pads) {
2805 for (l = group->children; l; l = l->next) {
2806 GstDecodeChain *chain = l->data;
2808 if (!gst_decode_chain_is_complete (chain)) {
2815 GST_DEBUG_OBJECT (group->dbin, "Group %p is complete: %d", group, complete);
2819 /* gst_decode_chain_is_complete:
2821 * Returns TRUE if the chain is complete, this means either
2822 * a) This chain is a dead end, i.e. we have no suitable plugins
2823 * b) This chain ends in an endpad and this is blocked or exposed
2825 * Not MT-safe, always call with decodebin expose lock
2828 gst_decode_chain_is_complete (GstDecodeChain * chain)
2830 gboolean complete = FALSE;
2832 CHAIN_MUTEX_LOCK (chain);
2833 if (chain->deadend) {
2838 if (chain->endpad && (chain->endpad->blocked || chain->endpad->exposed)) {
2843 if (chain->demuxer) {
2844 if (chain->active_group
2845 && gst_decode_group_is_complete (chain->active_group)) {
2852 CHAIN_MUTEX_UNLOCK (chain);
2853 GST_DEBUG_OBJECT (chain->dbin, "Chain %p is complete: %d", chain, complete);
2857 /* check if the group is drained, meaning all pads have seen an EOS
2860 gst_decode_pad_handle_eos (GstDecodePad * pad)
2862 GstDecodeChain *chain = pad->chain;
2864 GST_LOG_OBJECT (pad->dbin, "chain : %p, pad %p", chain, pad);
2865 pad->drained = TRUE;
2866 gst_decode_chain_handle_eos (chain);
2869 /* gst_decode_chain_handle_eos:
2871 * Checks if there are next groups in any parent chain
2872 * to which we can switch or if everything is drained.
2874 * If there are groups to switch to, hide the current active
2875 * one and expose the new one.
2877 * MT-safe, don't call with chain lock!
2880 gst_decode_chain_handle_eos (GstDecodeChain * eos_chain)
2882 GstDecodeBin *dbin = eos_chain->dbin;
2883 GstDecodeGroup *group;
2884 GstDecodeChain *chain = eos_chain;
2887 g_return_if_fail (eos_chain->endpad);
2889 CHAIN_MUTEX_LOCK (chain);
2890 while ((group = chain->parent)) {
2891 CHAIN_MUTEX_UNLOCK (chain);
2892 chain = group->parent;
2893 CHAIN_MUTEX_LOCK (chain);
2895 if (gst_decode_group_is_drained (group)) {
2901 drained = chain->active_group ?
2902 gst_decode_group_is_drained (chain->active_group) : TRUE;
2904 /* Now either group == NULL and chain == dbin->decode_chain
2905 * or chain is the lowest chain that has a non-drained group */
2906 if (chain->active_group && drained && chain->next_groups) {
2907 GST_DEBUG_OBJECT (dbin, "Hiding current group %p", chain->active_group);
2908 gst_decode_group_hide (chain->active_group);
2909 chain->old_groups = g_list_prepend (chain->old_groups, chain->active_group);
2910 GST_DEBUG_OBJECT (dbin, "Switching to next group %p",
2911 chain->next_groups->data);
2912 chain->active_group = chain->next_groups->data;
2913 chain->next_groups =
2914 g_list_delete_link (chain->next_groups, chain->next_groups);
2915 CHAIN_MUTEX_UNLOCK (chain);
2917 if (gst_decode_chain_is_complete (dbin->decode_chain))
2918 gst_decode_bin_expose (dbin);
2919 EXPOSE_UNLOCK (dbin);
2920 } else if (!chain->active_group || drained) {
2921 g_assert (chain == dbin->decode_chain);
2922 CHAIN_MUTEX_UNLOCK (chain);
2924 GST_LOG_OBJECT (dbin, "all groups drained, fire signal");
2925 g_signal_emit (G_OBJECT (dbin), gst_decode_bin_signals[SIGNAL_DRAINED], 0,
2928 CHAIN_MUTEX_UNLOCK (chain);
2929 GST_DEBUG_OBJECT (dbin,
2930 "Current active group in chain %p is not drained yet", chain);
2934 /* gst_decode_group_is_drained:
2936 * Check is this group is drained and cache this result.
2937 * The group is drained if all child chains are drained.
2939 * Not MT-safe, call with group->parent's lock */
2941 gst_decode_group_is_drained (GstDecodeGroup * group)
2944 gboolean drained = TRUE;
2946 if (group->drained) {
2951 for (l = group->children; l; l = l->next) {
2952 GstDecodeChain *chain = l->data;
2954 CHAIN_MUTEX_LOCK (chain);
2955 if (!gst_decode_chain_is_drained (chain))
2957 CHAIN_MUTEX_UNLOCK (chain);
2961 group->drained = drained;
2964 GST_DEBUG_OBJECT (group->dbin, "Group %p is drained: %d", group, drained);
2968 /* gst_decode_chain_is_drained:
2970 * Check is the chain is drained, which means that
2973 * a) it's endpad is drained
2974 * b) there are no pending pads, the active group is drained
2975 * and there are no next groups
2977 * Not MT-safe, call with chain lock
2980 gst_decode_chain_is_drained (GstDecodeChain * chain)
2982 gboolean drained = FALSE;
2984 if (chain->endpad) {
2985 drained = chain->endpad->drained;
2989 if (chain->pending_pads) {
2994 if (chain->active_group && gst_decode_group_is_drained (chain->active_group)
2995 && !chain->next_groups) {
3001 GST_DEBUG_OBJECT (chain->dbin, "Chain %p is drained: %d", chain, drained);
3006 * GCompareFunc to use with lists of GstPad.
3007 * Sorts pads by mime type.
3008 * First video (raw, then non-raw), then audio (raw, then non-raw),
3011 * Return: negative if a<b, 0 if a==b, positive if a>b
3014 sort_end_pads (GstDecodePad * da, GstDecodePad * db)
3017 GstCaps *capsa, *capsb;
3018 GstStructure *sa, *sb;
3019 const gchar *namea, *nameb;
3021 capsa = get_pad_caps (GST_PAD_CAST (da));
3022 capsb = get_pad_caps (GST_PAD_CAST (db));
3024 sa = gst_caps_get_structure ((const GstCaps *) capsa, 0);
3025 sb = gst_caps_get_structure ((const GstCaps *) capsb, 0);
3027 namea = gst_structure_get_name (sa);
3028 nameb = gst_structure_get_name (sb);
3030 if (g_strrstr (namea, "video/x-raw-"))
3032 else if (g_strrstr (namea, "video/"))
3034 else if (g_strrstr (namea, "audio/x-raw"))
3036 else if (g_strrstr (namea, "audio/"))
3041 if (g_strrstr (nameb, "video/x-raw-"))
3043 else if (g_strrstr (nameb, "video/"))
3045 else if (g_strrstr (nameb, "audio/x-raw"))
3047 else if (g_strrstr (nameb, "audio/"))
3052 gst_caps_unref (capsa);
3053 gst_caps_unref (capsb);
3059 _gst_element_get_linked_caps (GstElement * src, GstElement * sink)
3064 gboolean done = FALSE;
3065 GstCaps *caps = NULL;
3067 it = gst_element_iterate_src_pads (src);
3069 switch (gst_iterator_next (it, (gpointer) & pad)) {
3070 case GST_ITERATOR_OK:
3071 peer = gst_pad_get_peer (pad);
3073 parent = gst_pad_get_parent_element (peer);
3074 if (parent == sink) {
3075 caps = gst_pad_get_negotiated_caps (pad);
3080 gst_object_unref (parent);
3081 gst_object_unref (peer);
3083 gst_object_unref (pad);
3085 case GST_ITERATOR_RESYNC:
3086 gst_iterator_resync (it);
3088 case GST_ITERATOR_ERROR:
3089 case GST_ITERATOR_DONE:
3095 gst_iterator_free (it);
3100 static GQuark topology_structure_name = 0;
3101 static GQuark topology_caps = 0;
3102 static GQuark topology_next = 0;
3103 static GQuark topology_pad = 0;
3105 /* FIXME: Invent gst_structure_take_structure() to prevent all the
3106 * structure copying for nothing
3108 static GstStructure *
3109 gst_decode_chain_get_topology (GstDecodeChain * chain)
3111 GstStructure *s, *u;
3115 if (G_UNLIKELY ((chain->endpad || chain->deadend)
3116 && (chain->endcaps == NULL))) {
3117 GST_WARNING ("End chain without valid caps !");
3121 u = gst_structure_id_empty_new (topology_structure_name);
3123 /* Now at the last element */
3124 if (chain->elements && (chain->endpad || chain->deadend)) {
3125 s = gst_structure_id_empty_new (topology_structure_name);
3126 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, chain->endcaps,
3130 gst_structure_id_set (u, topology_pad, GST_TYPE_PAD, chain->endpad, NULL);
3131 gst_structure_id_set (s, topology_next, GST_TYPE_STRUCTURE, u, NULL);
3132 gst_structure_free (u);
3134 } else if (chain->active_group) {
3135 GValue list = { 0, };
3136 GValue item = { 0, };
3138 g_value_init (&list, GST_TYPE_LIST);
3139 g_value_init (&item, GST_TYPE_STRUCTURE);
3140 for (l = chain->active_group->children; l; l = l->next) {
3141 s = gst_decode_chain_get_topology (l->data);
3143 gst_value_set_structure (&item, s);
3144 gst_value_list_append_value (&list, &item);
3145 g_value_reset (&item);
3146 gst_structure_free (s);
3149 gst_structure_id_set_value (u, topology_next, &list);
3150 g_value_unset (&list);
3151 g_value_unset (&item);
3154 /* Get caps between all elements in this chain */
3155 l = (chain->elements && chain->elements->next) ? chain->elements : NULL;
3156 for (; l && l->next; l = l->next) {
3157 GstCaps *caps = _gst_element_get_linked_caps (l->next->data, l->data);
3160 s = gst_structure_id_empty_new (topology_structure_name);
3161 gst_structure_id_set (u, topology_caps, GST_TYPE_CAPS, caps, NULL);
3162 gst_caps_unref (caps);
3164 gst_structure_id_set (s, topology_next, GST_TYPE_STRUCTURE, u, NULL);
3165 gst_structure_free (u);
3170 /* Caps that resulted in this chain */
3171 caps = gst_pad_get_negotiated_caps (chain->pad);
3173 caps = get_pad_caps (chain->pad);
3174 if (G_UNLIKELY (!gst_caps_is_fixed (caps))) {
3175 GST_ERROR_OBJECT (chain->pad,
3176 "Couldn't get fixed caps, got %" GST_PTR_FORMAT, caps);
3177 gst_caps_unref (caps);
3181 gst_structure_set (u, "caps", GST_TYPE_CAPS, caps, NULL);
3182 gst_caps_unref (caps);
3188 gst_decode_bin_post_topology_message (GstDecodeBin * dbin)
3193 s = gst_decode_chain_get_topology (dbin->decode_chain);
3195 msg = gst_message_new_element (GST_OBJECT (dbin), s);
3196 gst_element_post_message (GST_ELEMENT (dbin), msg);
3199 /* Must only be called if the toplevel chain is complete and blocked! */
3200 /* Not MT-safe, call with decodebin expose lock! */
3202 gst_decode_bin_expose (GstDecodeBin * dbin)
3204 GList *tmp, *endpads = NULL;
3205 gboolean missing_plugin = FALSE;
3206 gboolean already_exposed = TRUE;
3208 GST_DEBUG_OBJECT (dbin, "Exposing currently active chains/groups");
3210 /* Don't expose if we're currently shutting down */
3212 if (G_UNLIKELY (dbin->shutdown == TRUE)) {
3213 GST_WARNING_OBJECT (dbin, "Currently, shutting down, aborting exposing");
3219 /* Get the pads that we're going to expose and mark things as exposed */
3220 if (!gst_decode_chain_expose (dbin->decode_chain, &endpads, &missing_plugin)) {
3221 g_list_foreach (endpads, (GFunc) gst_object_unref, NULL);
3222 g_list_free (endpads);
3223 GST_ERROR_OBJECT (dbin, "Broken chain/group tree");
3224 g_return_val_if_reached (FALSE);
3227 if (endpads == NULL) {
3228 if (missing_plugin) {
3229 GST_WARNING_OBJECT (dbin, "No suitable plugins found");
3230 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL),
3231 ("no suitable plugins found"));
3233 /* in this case, the stream ended without buffers,
3234 * just post a warning */
3235 GST_WARNING_OBJECT (dbin, "All streams finished without buffers");
3236 GST_ELEMENT_ERROR (dbin, STREAM, FAILED, (NULL),
3237 ("all streams without buffers"));
3242 /* Check if this was called when everything was exposed already */
3243 for (tmp = endpads; tmp && already_exposed; tmp = tmp->next) {
3244 GstDecodePad *dpad = tmp->data;
3246 already_exposed &= dpad->exposed;
3247 if (!already_exposed)
3250 if (already_exposed) {
3251 GST_DEBUG_OBJECT (dbin, "Everything was exposed already!");
3252 g_list_foreach (endpads, (GFunc) gst_object_unref, NULL);
3253 g_list_free (endpads);
3257 /* Set all already exposed pads to blocked */
3258 for (tmp = endpads; tmp; tmp = tmp->next) {
3259 GstDecodePad *dpad = tmp->data;
3261 if (dpad->exposed) {
3262 GST_DEBUG_OBJECT (dpad, "blocking exposed pad");
3263 gst_decode_pad_set_blocked (dpad, TRUE);
3267 /* re-order pads : video, then audio, then others */
3268 endpads = g_list_sort (endpads, (GCompareFunc) sort_end_pads);
3271 for (tmp = endpads; tmp; tmp = tmp->next) {
3272 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3275 /* 1. rewrite name */
3276 padname = g_strdup_printf ("src%d", dbin->nbpads);
3278 GST_DEBUG_OBJECT (dbin, "About to expose dpad %s as %s",
3279 GST_OBJECT_NAME (dpad), padname);
3280 gst_object_set_name (GST_OBJECT (dpad), padname);
3283 /* 2. activate and add */
3285 && !gst_element_add_pad (GST_ELEMENT (dbin), GST_PAD_CAST (dpad))) {
3286 /* not really fatal, we can try to add the other pads */
3287 g_warning ("error adding pad to decodebin2");
3290 dpad->exposed = TRUE;
3292 /* 3. emit signal */
3293 GST_DEBUG_OBJECT (dbin, "emitting new-decoded-pad");
3294 g_signal_emit (G_OBJECT (dbin),
3295 gst_decode_bin_signals[SIGNAL_NEW_DECODED_PAD], 0, dpad,
3296 (tmp->next == NULL));
3297 GST_DEBUG_OBJECT (dbin, "emitted new-decoded-pad");
3300 /* 4. Signal no-more-pads. This allows the application to hook stuff to the
3302 GST_LOG_OBJECT (dbin, "signalling no-more-pads");
3303 gst_element_no_more_pads (GST_ELEMENT (dbin));
3305 /* 5. Send a custom element message with the stream topology */
3306 if (dbin->post_stream_topology)
3307 gst_decode_bin_post_topology_message (dbin);
3309 /* 6. Unblock internal pads. The application should have connected stuff now
3310 * so that streaming can continue. */
3311 for (tmp = endpads; tmp; tmp = tmp->next) {
3312 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3314 GST_DEBUG_OBJECT (dpad, "unblocking");
3315 gst_decode_pad_unblock (dpad);
3316 GST_DEBUG_OBJECT (dpad, "unblocked");
3317 gst_object_unref (dpad);
3319 g_list_free (endpads);
3321 do_async_done (dbin);
3322 GST_DEBUG_OBJECT (dbin, "Exposed everything");
3326 /* gst_decode_chain_expose:
3328 * Check if the chain can be exposed and add all endpads
3329 * to the endpads list.
3331 * Also update the active group's multiqueue to the
3334 * Not MT-safe, call with decodebin expose lock! *
3337 gst_decode_chain_expose (GstDecodeChain * chain, GList ** endpads,
3338 gboolean * missing_plugin)
3340 GstDecodeGroup *group;
3344 if (chain->deadend) {
3346 *missing_plugin = TRUE;
3350 if (chain->endpad) {
3351 if (!chain->endpad->blocked && !chain->endpad->exposed)
3353 *endpads = g_list_prepend (*endpads, gst_object_ref (chain->endpad));
3357 group = chain->active_group;
3360 if (!group->no_more_pads && !group->overrun)
3365 /* configure queues for playback */
3366 decodebin_set_queue_size (dbin, group->multiqueue, FALSE);
3368 /* we can now disconnect any overrun signal, which is used to expose the
3370 if (group->overrunsig) {
3371 GST_LOG_OBJECT (dbin, "Disconnecting overrun");
3372 g_signal_handler_disconnect (group->multiqueue, group->overrunsig);
3373 group->overrunsig = 0;
3376 for (l = group->children; l; l = l->next) {
3377 GstDecodeChain *childchain = l->data;
3379 if (!gst_decode_chain_expose (childchain, endpads, missing_plugin))
3386 /*************************
3387 * GstDecodePad functions
3388 *************************/
3391 gst_decode_pad_class_init (GstDecodePadClass * klass)
3396 gst_decode_pad_init (GstDecodePad * pad)
3399 pad->blocked = FALSE;
3400 pad->exposed = FALSE;
3401 pad->drained = FALSE;
3402 gst_object_ref_sink (pad);
3406 source_pad_blocked_cb (GstPad * pad, gboolean blocked, GstDecodePad * dpad)
3408 GstDecodeChain *chain;
3411 chain = dpad->chain;
3414 GST_LOG_OBJECT (dpad, "blocked:%d, dpad->chain:%p", blocked, chain);
3416 dpad->blocked = blocked;
3418 if (dpad->blocked) {
3420 if (gst_decode_chain_is_complete (dbin->decode_chain)) {
3421 if (!gst_decode_bin_expose (dbin))
3422 GST_WARNING_OBJECT (dbin, "Couldn't expose group");
3424 EXPOSE_UNLOCK (dbin);
3429 source_pad_event_probe (GstPad * pad, GstEvent * event, GstDecodePad * dpad)
3431 GST_LOG_OBJECT (pad, "%s dpad:%p", GST_EVENT_TYPE_NAME (event), dpad);
3433 if (GST_EVENT_TYPE (event) == GST_EVENT_EOS) {
3434 GST_DEBUG_OBJECT (pad, "we received EOS");
3436 /* Check if all pads are drained. If there is a next group to expose, we
3437 * will remove the ghostpad of the current group first, which unlinks the
3438 * peer and so drops the EOS. */
3439 gst_decode_pad_handle_eos (dpad);
3441 /* never drop events */
3446 gst_decode_pad_set_blocked (GstDecodePad * dpad, gboolean blocked)
3448 GstDecodeBin *dbin = dpad->dbin;
3453 GST_DEBUG_OBJECT (dpad, "blocking pad: %d", blocked);
3455 opad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (dpad));
3459 /* do not block if shutting down.
3460 * we do not consider/expect it blocked further below, but use other trick */
3461 if (!blocked || !dbin->shutdown)
3462 gst_pad_set_blocked_async_full (opad, blocked,
3463 (GstPadBlockCallback) source_pad_blocked_cb, gst_object_ref (dpad),
3464 (GDestroyNotify) gst_object_unref);
3467 if (dbin->shutdown) {
3468 /* deactivate to force flushing state to prevent NOT_LINKED errors */
3469 gst_pad_set_active (GST_PAD_CAST (dpad), FALSE);
3470 /* note that deactivating the target pad would have no effect here,
3471 * since elements are typically connected first (and pads exposed),
3472 * and only then brought to PAUSED state (so pads activated) */
3474 gst_object_ref (dpad);
3475 dbin->blocked_pads = g_list_prepend (dbin->blocked_pads, dpad);
3480 if ((l = g_list_find (dbin->blocked_pads, dpad))) {
3481 gst_object_unref (dpad);
3482 dbin->blocked_pads = g_list_delete_link (dbin->blocked_pads, l);
3485 gst_object_unref (opad);
3491 gst_decode_pad_add_drained_check (GstDecodePad * dpad)
3493 gst_pad_add_event_probe (GST_PAD_CAST (dpad),
3494 G_CALLBACK (source_pad_event_probe), dpad);
3498 gst_decode_pad_activate (GstDecodePad * dpad, GstDecodeChain * chain)
3500 g_return_if_fail (chain != NULL);
3502 dpad->chain = chain;
3503 gst_pad_set_active (GST_PAD_CAST (dpad), TRUE);
3504 gst_decode_pad_set_blocked (dpad, TRUE);
3505 gst_decode_pad_add_drained_check (dpad);
3509 gst_decode_pad_unblock (GstDecodePad * dpad)
3511 gst_decode_pad_set_blocked (dpad, FALSE);
3514 /*gst_decode_pad_new:
3516 * Creates a new GstDecodePad for the given pad.
3518 static GstDecodePad *
3519 gst_decode_pad_new (GstDecodeBin * dbin, GstPad * pad, GstDecodeChain * chain)
3522 GstPadTemplate *pad_tmpl;
3524 GST_DEBUG_OBJECT (dbin, "making new decodepad");
3525 pad_tmpl = gst_static_pad_template_get (&decoder_bin_src_template);
3527 g_object_new (GST_TYPE_DECODE_PAD, "direction", GST_PAD_DIRECTION (pad),
3528 "template", pad_tmpl, NULL);
3529 gst_ghost_pad_construct (GST_GHOST_PAD_CAST (dpad));
3530 gst_ghost_pad_set_target (GST_GHOST_PAD_CAST (dpad), pad);
3531 dpad->chain = chain;
3533 gst_object_unref (pad_tmpl);
3539 gst_pending_pad_free (GstPendingPad * ppad)
3542 g_assert (ppad->pad);
3544 if (ppad->event_probe_id != 0)
3545 gst_pad_remove_event_probe (ppad->pad, ppad->event_probe_id);
3546 gst_object_unref (ppad->pad);
3547 g_slice_free (GstPendingPad, ppad);
3551 * Element add/remove
3555 do_async_start (GstDecodeBin * dbin)
3557 GstMessage *message;
3559 dbin->async_pending = TRUE;
3561 message = gst_message_new_async_start (GST_OBJECT_CAST (dbin), FALSE);
3562 parent_class->handle_message (GST_BIN_CAST (dbin), message);
3566 do_async_done (GstDecodeBin * dbin)
3568 GstMessage *message;
3570 if (dbin->async_pending) {
3571 message = gst_message_new_async_done (GST_OBJECT_CAST (dbin));
3572 parent_class->handle_message (GST_BIN_CAST (dbin), message);
3574 dbin->async_pending = FALSE;
3579 * convenience functions
3584 * Returns the first sink pad of the given element, or NULL if it doesn't have
3589 find_sink_pad (GstElement * element)
3595 it = gst_element_iterate_sink_pads (element);
3597 if ((gst_iterator_next (it, &point)) == GST_ITERATOR_OK)
3598 pad = (GstPad *) point;
3600 gst_iterator_free (it);
3605 /* call with dyn_lock held */
3607 unblock_pads (GstDecodeBin * dbin)
3611 GST_LOG_OBJECT (dbin, "unblocking pads");
3613 for (tmp = dbin->blocked_pads; tmp; tmp = tmp->next) {
3614 GstDecodePad *dpad = (GstDecodePad *) tmp->data;
3617 opad = gst_ghost_pad_get_target (GST_GHOST_PAD_CAST (dpad));
3621 GST_DEBUG_OBJECT (dpad, "unblocking");
3622 gst_pad_set_blocked_async_full (opad, FALSE,
3623 (GstPadBlockCallback) source_pad_blocked_cb, gst_object_ref (dpad),
3624 (GDestroyNotify) gst_object_unref);
3625 /* make flushing, prevent NOT_LINKED */
3626 GST_PAD_SET_FLUSHING (GST_PAD_CAST (dpad));
3627 gst_object_unref (dpad);
3628 gst_object_unref (opad);
3629 GST_DEBUG_OBJECT (dpad, "unblocked");
3632 /* clear, no more blocked pads */
3633 g_list_free (dbin->blocked_pads);
3634 dbin->blocked_pads = NULL;
3637 static GstStateChangeReturn
3638 gst_decode_bin_change_state (GstElement * element, GstStateChange transition)
3640 GstStateChangeReturn ret = GST_STATE_CHANGE_SUCCESS;
3641 GstDecodeBin *dbin = GST_DECODE_BIN (element);
3643 switch (transition) {
3644 case GST_STATE_CHANGE_NULL_TO_READY:
3645 if (dbin->typefind == NULL)
3646 goto missing_typefind;
3648 case GST_STATE_CHANGE_READY_TO_PAUSED:
3649 /* Make sure we've cleared all existing chains */
3650 if (dbin->decode_chain) {
3651 gst_decode_chain_free (dbin->decode_chain);
3652 dbin->decode_chain = NULL;
3655 GST_LOG_OBJECT (dbin, "clearing shutdown flag");
3656 dbin->shutdown = FALSE;
3658 dbin->have_type = FALSE;
3659 ret = GST_STATE_CHANGE_ASYNC;
3660 do_async_start (dbin);
3662 case GST_STATE_CHANGE_PAUSED_TO_READY:
3664 GST_LOG_OBJECT (dbin, "setting shutdown flag");
3665 dbin->shutdown = TRUE;
3666 unblock_pads (dbin);
3673 GstStateChangeReturn bret;
3675 bret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
3676 if (G_UNLIKELY (bret == GST_STATE_CHANGE_FAILURE))
3677 goto activate_failed;
3678 else if (G_UNLIKELY (bret == GST_STATE_CHANGE_NO_PREROLL)) {
3679 do_async_done (dbin);
3683 switch (transition) {
3684 case GST_STATE_CHANGE_PAUSED_TO_READY:
3685 do_async_done (dbin);
3686 if (dbin->decode_chain) {
3687 gst_decode_chain_free (dbin->decode_chain);
3688 dbin->decode_chain = NULL;
3691 case GST_STATE_CHANGE_READY_TO_NULL:
3701 gst_element_post_message (element,
3702 gst_missing_element_message_new (element, "typefind"));
3703 GST_ELEMENT_ERROR (dbin, CORE, MISSING_PLUGIN, (NULL), ("no typefind!"));
3704 return GST_STATE_CHANGE_FAILURE;
3708 GST_DEBUG_OBJECT (element,
3709 "element failed to change states -- activation problem?");
3710 return GST_STATE_CHANGE_FAILURE;
3715 gst_decode_bin_plugin_init (GstPlugin * plugin)
3717 GST_DEBUG_CATEGORY_INIT (gst_decode_bin_debug, "decodebin2", 0,
3721 GST_DEBUG ("binding text domain %s to locale dir %s", GETTEXT_PACKAGE,
3723 bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
3724 bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
3725 #endif /* ENABLE_NLS */
3727 /* Register some quarks here for the stream topology message */
3728 topology_structure_name = g_quark_from_static_string ("stream-topology");
3729 topology_caps = g_quark_from_static_string ("caps");
3730 topology_next = g_quark_from_static_string ("next");
3731 topology_pad = g_quark_from_static_string ("pad");
3733 return gst_element_register (plugin, "decodebin2", GST_RANK_NONE,
3734 GST_TYPE_DECODE_BIN);