2 * Copyright (C) 2003 Benjamin Otte <in7y118@public.uni-hamburg.de>
4 * gsttypefindelement.c: element that detects type of stream
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
22 * SECTION:element-typefind
24 * Determines the media-type of a stream. It applies typefind functions in the
25 * order of their rank. One the type has been deteted it sets its src pad caps
26 * to the found media type.
28 * Whenever a type is found the #GstTypeFindElement::have-type signal is
29 * emitted, either from the streaming thread or the application thread
30 * (the latter may happen when typefinding is done pull-based from the
31 * state change function).
33 * Plugins can register custom typefinders by using #GstTypeFindFactory.
36 /* FIXME: need a better solution for non-seekable streams */
39 * 1) get a list of all typefind functions sorted best to worst
40 * 2) if all elements have been called with all requested data goto 8
41 * 3) call all functions once with all available data
42 * 4) if a function returns a value >= PROP_MAXIMUM goto 8
43 * 5) all functions with a result > PROP_MINIMUM or functions that did not get
44 * all requested data (where peek returned NULL) stay in list
45 * 6) seek to requested offset of best function that still has open data
48 * 8) take best available result and use its caps
50 * The element has two scheduling modes:
52 * 1) chain based, it will collect buffers and run the typefind function on
53 * the buffer until something is found.
54 * 2) getrange based, it will proxy the getrange function to the sinkpad. It
55 * is assumed that the peer element is happy with whatever format we
58 * By default it tries to do pull based typefinding (this avoids joining
59 * received buffers and holding them back in store.)
61 * When the element has no connected srcpad, and the sinkpad can operate in
62 * getrange based mode, the element starts its own task to figure out the
65 * Most of the actual implementation is in libs/gst/base/gsttypefindhelper.c.
72 #include "gst/gst_private.h"
74 #include "gsttypefindelement.h"
75 #include "gst/gst-i18n-lib.h"
76 #include "gst/base/gsttypefindhelper.h"
78 #include <gst/gsttypefind.h>
79 #include <gst/gstutils.h>
80 #include <gst/gsterror.h>
82 GST_DEBUG_CATEGORY_STATIC (gst_type_find_element_debug);
83 #define GST_CAT_DEFAULT gst_type_find_element_debug
85 /* generic templates */
86 static GstStaticPadTemplate type_find_element_sink_template =
87 GST_STATIC_PAD_TEMPLATE ("sink",
92 static GstStaticPadTemplate type_find_element_src_template =
93 GST_STATIC_PAD_TEMPLATE ("src",
98 /* Require at least 2kB of data before we attempt typefinding in chain-mode.
99 * 128kB is massive overkill for the maximum, but doesn't do any harm */
100 #define TYPE_FIND_MIN_SIZE (2*1024)
101 #define TYPE_FIND_MAX_SIZE (128*1024)
103 /* TypeFind signals and args */
120 MODE_NORMAL, /* act as identity */
121 MODE_TYPEFIND, /* do typefinding */
122 MODE_ERROR /* had fatal error */
127 GST_DEBUG_CATEGORY_INIT (gst_type_find_element_debug, "typefind", \
128 GST_DEBUG_BG_YELLOW | GST_DEBUG_FG_GREEN, "type finding element");
129 #define gst_type_find_element_parent_class parent_class
130 G_DEFINE_TYPE_WITH_CODE (GstTypeFindElement, gst_type_find_element,
131 GST_TYPE_ELEMENT, _do_init);
133 static void gst_type_find_element_dispose (GObject * object);
134 static void gst_type_find_element_set_property (GObject * object,
135 guint prop_id, const GValue * value, GParamSpec * pspec);
136 static void gst_type_find_element_get_property (GObject * object,
137 guint prop_id, GValue * value, GParamSpec * pspec);
140 static const GstEventMask *gst_type_find_element_src_event_mask (GstPad * pad);
143 static gboolean gst_type_find_element_src_event (GstPad * pad,
144 GstObject * parent, GstEvent * event);
145 static gboolean gst_type_find_handle_src_query (GstPad * pad,
146 GstObject * parent, GstQuery * query);
148 static gboolean gst_type_find_element_sink_event (GstPad * pad,
149 GstObject * parent, GstEvent * event);
150 static gboolean gst_type_find_element_setcaps (GstTypeFindElement * typefind,
152 static GstFlowReturn gst_type_find_element_chain (GstPad * sinkpad,
153 GstObject * parent, GstBuffer * buffer);
154 static GstFlowReturn gst_type_find_element_getrange (GstPad * srcpad,
155 GstObject * parent, guint64 offset, guint length, GstBuffer ** buffer);
157 static GstStateChangeReturn
158 gst_type_find_element_change_state (GstElement * element,
159 GstStateChange transition);
160 static gboolean gst_type_find_element_activate_sink (GstPad * pad,
162 static gboolean gst_type_find_element_activate_sink_mode (GstPad * pad,
163 GstObject * parent, GstPadMode mode, gboolean active);
164 static gboolean gst_type_find_element_activate_src_mode (GstPad * pad,
165 GstObject * parent, GstPadMode mode, gboolean active);
167 gst_type_find_element_chain_do_typefinding (GstTypeFindElement * typefind,
168 gboolean check_avail);
169 static void gst_type_find_element_send_cached_events (GstTypeFindElement *
172 static void gst_type_find_element_loop (GstPad * pad);
174 static guint gst_type_find_element_signals[LAST_SIGNAL] = { 0 };
177 gst_type_find_element_have_type (GstTypeFindElement * typefind,
178 guint probability, const GstCaps * caps)
182 g_assert (caps != NULL);
184 GST_INFO_OBJECT (typefind, "found caps %" GST_PTR_FORMAT ", probability=%u",
187 GST_OBJECT_LOCK (typefind);
189 gst_caps_unref (typefind->caps);
190 typefind->caps = gst_caps_copy (caps);
191 copy = gst_caps_ref (typefind->caps);
192 GST_OBJECT_UNLOCK (typefind);
194 gst_pad_push_event (typefind->src, gst_event_new_caps (copy));
195 gst_caps_unref (copy);
199 gst_type_find_element_class_init (GstTypeFindElementClass * typefind_class)
201 GObjectClass *gobject_class = G_OBJECT_CLASS (typefind_class);
202 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (typefind_class);
204 gobject_class->set_property = gst_type_find_element_set_property;
205 gobject_class->get_property = gst_type_find_element_get_property;
206 gobject_class->dispose = gst_type_find_element_dispose;
208 g_object_class_install_property (gobject_class, PROP_CAPS,
209 g_param_spec_boxed ("caps", _("caps"),
210 _("detected capabilities in stream"), GST_TYPE_CAPS,
211 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
212 g_object_class_install_property (gobject_class, PROP_MINIMUM,
213 g_param_spec_uint ("minimum", _("minimum"),
214 "minimum probability required to accept caps", GST_TYPE_FIND_MINIMUM,
215 GST_TYPE_FIND_MAXIMUM, GST_TYPE_FIND_MINIMUM,
216 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
217 g_object_class_install_property (gobject_class, PROP_MAXIMUM,
218 g_param_spec_uint ("maximum", _("maximum"),
219 "probability to stop typefinding (deprecated; non-functional)",
220 GST_TYPE_FIND_MINIMUM, GST_TYPE_FIND_MAXIMUM, GST_TYPE_FIND_MAXIMUM,
221 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
222 g_object_class_install_property (gobject_class, PROP_FORCE_CAPS,
223 g_param_spec_boxed ("force-caps", _("force caps"),
224 _("force caps without doing a typefind"), GST_TYPE_CAPS,
225 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
227 * GstTypeFindElement::have-type:
228 * @typefind: the typefind instance
229 * @probability: the probability of the type found
230 * @caps: the caps of the type found
232 * This signal gets emitted when the type and its probability has
235 gst_type_find_element_signals[HAVE_TYPE] = g_signal_new ("have-type",
236 G_TYPE_FROM_CLASS (typefind_class), G_SIGNAL_RUN_FIRST,
237 G_STRUCT_OFFSET (GstTypeFindElementClass, have_type), NULL, NULL,
238 gst_marshal_VOID__UINT_BOXED, G_TYPE_NONE, 2,
239 G_TYPE_UINT, GST_TYPE_CAPS | G_SIGNAL_TYPE_STATIC_SCOPE);
241 typefind_class->have_type =
242 GST_DEBUG_FUNCPTR (gst_type_find_element_have_type);
244 gst_element_class_set_details_simple (gstelement_class,
247 "Finds the media type of a stream",
248 "Benjamin Otte <in7y118@public.uni-hamburg.de>");
249 gst_element_class_add_pad_template (gstelement_class,
250 gst_static_pad_template_get (&type_find_element_src_template));
251 gst_element_class_add_pad_template (gstelement_class,
252 gst_static_pad_template_get (&type_find_element_sink_template));
254 gstelement_class->change_state =
255 GST_DEBUG_FUNCPTR (gst_type_find_element_change_state);
259 gst_type_find_element_init (GstTypeFindElement * typefind)
263 gst_pad_new_from_static_template (&type_find_element_sink_template,
266 gst_pad_set_activate_function (typefind->sink,
267 GST_DEBUG_FUNCPTR (gst_type_find_element_activate_sink));
268 gst_pad_set_activatemode_function (typefind->sink,
269 GST_DEBUG_FUNCPTR (gst_type_find_element_activate_sink_mode));
270 gst_pad_set_chain_function (typefind->sink,
271 GST_DEBUG_FUNCPTR (gst_type_find_element_chain));
272 gst_pad_set_event_function (typefind->sink,
273 GST_DEBUG_FUNCPTR (gst_type_find_element_sink_event));
274 gst_element_add_pad (GST_ELEMENT (typefind), typefind->sink);
278 gst_pad_new_from_static_template (&type_find_element_src_template, "src");
280 gst_pad_set_activatemode_function (typefind->src,
281 GST_DEBUG_FUNCPTR (gst_type_find_element_activate_src_mode));
282 gst_pad_set_getrange_function (typefind->src,
283 GST_DEBUG_FUNCPTR (gst_type_find_element_getrange));
284 gst_pad_set_event_function (typefind->src,
285 GST_DEBUG_FUNCPTR (gst_type_find_element_src_event));
286 gst_pad_set_query_function (typefind->src,
287 GST_DEBUG_FUNCPTR (gst_type_find_handle_src_query));
288 gst_pad_use_fixed_caps (typefind->src);
289 gst_element_add_pad (GST_ELEMENT (typefind), typefind->src);
291 typefind->mode = MODE_TYPEFIND;
292 typefind->caps = NULL;
293 typefind->min_probability = 1;
294 typefind->max_probability = GST_TYPE_FIND_MAXIMUM;
296 typefind->adapter = gst_adapter_new ();
300 gst_type_find_element_dispose (GObject * object)
302 GstTypeFindElement *typefind = GST_TYPE_FIND_ELEMENT (object);
304 if (typefind->adapter) {
305 g_object_unref (typefind->adapter);
306 typefind->adapter = NULL;
309 if (typefind->force_caps) {
310 gst_caps_unref (typefind->force_caps);
311 typefind->force_caps = NULL;
314 G_OBJECT_CLASS (parent_class)->dispose (object);
318 gst_type_find_element_set_property (GObject * object, guint prop_id,
319 const GValue * value, GParamSpec * pspec)
321 GstTypeFindElement *typefind;
323 typefind = GST_TYPE_FIND_ELEMENT (object);
327 typefind->min_probability = g_value_get_uint (value);
330 typefind->max_probability = g_value_get_uint (value);
332 case PROP_FORCE_CAPS:
333 GST_OBJECT_LOCK (typefind);
334 if (typefind->force_caps)
335 gst_caps_unref (typefind->force_caps);
336 typefind->force_caps = g_value_dup_boxed (value);
337 GST_OBJECT_UNLOCK (typefind);
340 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
346 gst_type_find_element_get_property (GObject * object, guint prop_id,
347 GValue * value, GParamSpec * pspec)
349 GstTypeFindElement *typefind;
351 typefind = GST_TYPE_FIND_ELEMENT (object);
355 GST_OBJECT_LOCK (typefind);
356 g_value_set_boxed (value, typefind->caps);
357 GST_OBJECT_UNLOCK (typefind);
360 g_value_set_uint (value, typefind->min_probability);
363 g_value_set_uint (value, typefind->max_probability);
365 case PROP_FORCE_CAPS:
366 GST_OBJECT_LOCK (typefind);
367 g_value_set_boxed (value, typefind->force_caps);
368 GST_OBJECT_UNLOCK (typefind);
371 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
377 gst_type_find_handle_src_query (GstPad * pad, GstObject * parent,
380 GstTypeFindElement *typefind;
381 gboolean res = FALSE;
383 typefind = GST_TYPE_FIND_ELEMENT (parent);
385 res = gst_pad_peer_query (typefind->sink, query);
389 switch (GST_QUERY_TYPE (query)) {
390 case GST_QUERY_POSITION:
395 gst_query_parse_position (query, &format, &peer_pos);
397 GST_OBJECT_LOCK (typefind);
398 /* FIXME: this code assumes that there's no discont in the queue */
400 case GST_FORMAT_BYTES:
401 peer_pos -= gst_adapter_available (typefind->adapter);
407 GST_OBJECT_UNLOCK (typefind);
408 gst_query_set_position (query, format, peer_pos);
420 gst_type_find_element_seek (GstTypeFindElement * typefind, GstEvent * event)
423 GstSeekType cur_type, stop_type;
428 GstSegment seeksegment = { 0, };
430 gst_event_parse_seek (event, &rate, &format, &flags, &cur_type, &cur,
433 /* we can only seek on bytes */
434 if (format != GST_FORMAT_BYTES) {
435 GST_DEBUG_OBJECT (typefind, "Can only seek on BYTES");
439 /* copy segment, we need this because we still need the old
440 * segment when we close the current segment. */
441 memcpy (&seeksegment, &typefind->segment, sizeof (GstSegment));
443 GST_DEBUG_OBJECT (typefind, "configuring seek");
444 gst_segment_do_seek (&seeksegment, rate, format, flags,
445 cur_type, cur, stop_type, stop, NULL);
447 flush = ! !(flags & GST_SEEK_FLAG_FLUSH);
449 GST_DEBUG_OBJECT (typefind, "New segment %" GST_SEGMENT_FORMAT, &seeksegment);
452 GST_DEBUG_OBJECT (typefind, "Starting flush");
453 gst_pad_push_event (typefind->sink, gst_event_new_flush_start ());
454 gst_pad_push_event (typefind->src, gst_event_new_flush_start ());
456 GST_DEBUG_OBJECT (typefind, "Non-flushing seek, pausing task");
457 gst_pad_pause_task (typefind->sink);
460 /* now grab the stream lock so that streaming cannot continue, for
461 * non flushing seeks when the element is in PAUSED this could block
463 GST_DEBUG_OBJECT (typefind, "Waiting for streaming to stop");
464 GST_PAD_STREAM_LOCK (typefind->sink);
467 GST_DEBUG_OBJECT (typefind, "Stopping flush");
468 gst_pad_push_event (typefind->sink, gst_event_new_flush_stop (TRUE));
469 gst_pad_push_event (typefind->src, gst_event_new_flush_stop (TRUE));
472 /* now update the real segment info */
473 GST_DEBUG_OBJECT (typefind, "Committing new seek segment");
474 memcpy (&typefind->segment, &seeksegment, sizeof (GstSegment));
475 typefind->offset = typefind->segment.start;
477 /* notify start of new segment */
478 if (typefind->segment.flags & GST_SEEK_FLAG_SEGMENT) {
481 msg = gst_message_new_segment_start (GST_OBJECT (typefind),
482 GST_FORMAT_BYTES, typefind->segment.start);
483 gst_element_post_message (GST_ELEMENT (typefind), msg);
486 typefind->need_segment = TRUE;
488 /* restart our task since it might have been stopped when we did the
490 gst_pad_start_task (typefind->sink,
491 (GstTaskFunction) gst_type_find_element_loop, typefind->sink);
493 /* streaming can continue now */
494 GST_PAD_STREAM_UNLOCK (typefind->sink);
500 gst_type_find_element_src_event (GstPad * pad, GstObject * parent,
503 GstTypeFindElement *typefind = GST_TYPE_FIND_ELEMENT (parent);
505 if (typefind->mode != MODE_NORMAL) {
506 /* need to do more? */
507 gst_mini_object_unref (GST_MINI_OBJECT_CAST (event));
511 /* Only handle seeks here if driving the pipeline */
512 if (typefind->segment.format != GST_FORMAT_UNDEFINED &&
513 GST_EVENT_TYPE (event) == GST_EVENT_SEEK) {
514 return gst_type_find_element_seek (typefind, event);
516 return gst_pad_push_event (typefind->sink, event);
521 start_typefinding (GstTypeFindElement * typefind)
523 GST_DEBUG_OBJECT (typefind, "starting typefinding");
525 GST_OBJECT_LOCK (typefind);
527 gst_caps_replace (&typefind->caps, NULL);
528 GST_OBJECT_UNLOCK (typefind);
530 typefind->mode = MODE_TYPEFIND;
534 stop_typefinding (GstTypeFindElement * typefind)
537 gboolean push_cached_buffers;
541 gst_element_get_state (GST_ELEMENT (typefind), &state, NULL, 0);
543 push_cached_buffers = (state >= GST_STATE_PAUSED);
545 GST_DEBUG_OBJECT (typefind, "stopping typefinding%s",
546 push_cached_buffers ? " and pushing cached buffers" : "");
548 GST_OBJECT_LOCK (typefind);
549 avail = gst_adapter_available (typefind->adapter);
553 buffer = gst_adapter_take_buffer (typefind->adapter, avail);
554 GST_OBJECT_UNLOCK (typefind);
556 if (!push_cached_buffers) {
557 gst_buffer_unref (buffer);
559 GstPad *peer = gst_pad_get_peer (typefind->src);
561 typefind->mode = MODE_NORMAL;
563 /* make sure the user gets a meaningful error message in this case,
564 * which is not a core bug or bug of any kind (as the default error
565 * message emitted by gstpad.c otherwise would make you think) */
566 if (peer && GST_PAD_CHAINFUNC (peer) == NULL) {
567 GST_DEBUG_OBJECT (typefind, "upstream only supports push mode, while "
568 "downstream element only works in pull mode, erroring out");
569 GST_ELEMENT_ERROR (typefind, STREAM, FAILED,
570 ("%s cannot work in push mode. The operation is not supported "
571 "with this source element or protocol.",
572 G_OBJECT_TYPE_NAME (GST_PAD_PARENT (peer))),
573 ("Downstream pad %s:%s has no chainfunction, and the upstream "
574 "element does not support pull mode", GST_DEBUG_PAD_NAME (peer)));
575 typefind->mode = MODE_ERROR; /* make the chain function error out */
576 gst_buffer_unref (buffer);
578 gst_type_find_element_send_cached_events (typefind);
579 gst_pad_push (typefind->src, buffer);
582 gst_object_unref (peer);
589 GST_DEBUG_OBJECT (typefind, "we have no data to typefind");
590 GST_OBJECT_UNLOCK (typefind);
596 gst_type_find_element_sink_event (GstPad * pad, GstObject * parent,
599 gboolean res = FALSE;
600 GstTypeFindElement *typefind = GST_TYPE_FIND_ELEMENT (parent);
602 GST_DEBUG_OBJECT (typefind, "got %s event in mode %d",
603 GST_EVENT_TYPE_NAME (event), typefind->mode);
605 switch (typefind->mode) {
607 switch (GST_EVENT_TYPE (event)) {
612 /* first pass the caps event downstream */
613 res = gst_pad_push_event (typefind->src, gst_event_ref (event));
615 /* then parse and push out our data */
616 gst_event_parse_caps (event, &caps);
617 res = gst_type_find_element_setcaps (typefind, caps);
619 gst_event_unref (event);
624 GST_INFO_OBJECT (typefind, "Got EOS and no type found yet");
625 gst_type_find_element_chain_do_typefinding (typefind, FALSE);
627 res = gst_pad_push_event (typefind->src, event);
630 case GST_EVENT_FLUSH_STOP:
631 GST_OBJECT_LOCK (typefind);
632 g_list_foreach (typefind->cached_events,
633 (GFunc) gst_mini_object_unref, NULL);
634 g_list_free (typefind->cached_events);
635 typefind->cached_events = NULL;
636 gst_adapter_clear (typefind->adapter);
637 GST_OBJECT_UNLOCK (typefind);
639 case GST_EVENT_FLUSH_START:
640 res = gst_pad_push_event (typefind->src, event);
643 GST_DEBUG_OBJECT (typefind, "Saving %s event to send later",
644 GST_EVENT_TYPE_NAME (event));
645 GST_OBJECT_LOCK (typefind);
646 typefind->cached_events =
647 g_list_append (typefind->cached_events, event);
648 GST_OBJECT_UNLOCK (typefind);
654 res = gst_pad_push_event (typefind->src, event);
659 g_assert_not_reached ();
665 gst_type_find_element_send_cached_events (GstTypeFindElement * typefind)
667 GList *l, *cached_events;
669 GST_OBJECT_LOCK (typefind);
670 cached_events = typefind->cached_events;
671 typefind->cached_events = NULL;
672 GST_OBJECT_UNLOCK (typefind);
674 for (l = cached_events; l != NULL; l = l->next) {
675 GstEvent *event = GST_EVENT (l->data);
677 GST_DEBUG_OBJECT (typefind, "sending cached %s event",
678 GST_EVENT_TYPE_NAME (event));
679 gst_pad_push_event (typefind->src, event);
681 g_list_free (cached_events);
685 gst_type_find_element_setcaps (GstTypeFindElement * typefind, GstCaps * caps)
687 /* don't operate on ANY caps */
688 if (gst_caps_is_any (caps))
691 g_signal_emit (typefind, gst_type_find_element_signals[HAVE_TYPE], 0,
692 GST_TYPE_FIND_MAXIMUM, caps);
694 /* Shortcircuit typefinding if we get caps */
695 if (typefind->mode == MODE_TYPEFIND) {
699 GST_DEBUG_OBJECT (typefind, "Skipping typefinding, using caps from "
700 "upstream buffer: %" GST_PTR_FORMAT, caps);
701 typefind->mode = MODE_NORMAL;
703 gst_type_find_element_send_cached_events (typefind);
704 GST_OBJECT_LOCK (typefind);
705 avail = gst_adapter_available (typefind->adapter);
709 buffer = gst_adapter_take_buffer (typefind->adapter, avail);
710 GST_OBJECT_UNLOCK (typefind);
712 GST_DEBUG_OBJECT (typefind, "Pushing buffer: %" G_GSIZE_FORMAT, avail);
713 gst_pad_push (typefind->src, buffer);
720 GST_DEBUG_OBJECT (typefind, "no data to push");
721 GST_OBJECT_UNLOCK (typefind);
727 gst_type_find_get_extension (GstTypeFindElement * typefind, GstPad * pad)
734 query = gst_query_new_uri ();
736 /* try getting the caps with an uri query and from the extension */
737 if (!gst_pad_peer_query (pad, query))
738 goto peer_query_failed;
740 gst_query_parse_uri (query, &uri);
744 GST_DEBUG_OBJECT (typefind, "finding extension of %s", uri);
746 /* find the extension on the uri, this is everything after a '.' */
751 if (uri[find] == '.')
758 result = g_strdup (&uri[find + 1]);
760 GST_DEBUG_OBJECT (typefind, "found extension %s", result);
761 gst_query_unref (query);
769 GST_WARNING_OBJECT (typefind, "failed to query peer uri");
770 gst_query_unref (query);
775 GST_WARNING_OBJECT (typefind, "could not parse the peer uri");
776 gst_query_unref (query);
781 GST_WARNING_OBJECT (typefind, "could not find uri extension in %s", uri);
782 gst_query_unref (query);
789 gst_type_find_guess_by_extension (GstTypeFindElement * typefind, GstPad * pad,
790 GstTypeFindProbability * probability)
795 ext = gst_type_find_get_extension (typefind, pad);
799 caps = gst_type_find_helper_for_extension (GST_OBJECT_CAST (typefind), ext);
801 *probability = GST_TYPE_FIND_MAXIMUM;
809 gst_type_find_element_chain (GstPad * pad, GstObject * parent,
812 GstTypeFindElement *typefind;
813 GstFlowReturn res = GST_FLOW_OK;
815 typefind = GST_TYPE_FIND_ELEMENT (parent);
817 GST_LOG_OBJECT (typefind, "handling buffer in mode %d", typefind->mode);
819 switch (typefind->mode) {
821 /* we should already have called GST_ELEMENT_ERROR */
822 return GST_FLOW_ERROR;
824 /* don't take object lock as typefind->caps should not change anymore */
825 return gst_pad_push (typefind->src, buffer);
828 GST_OBJECT_LOCK (typefind);
829 gst_adapter_push (typefind->adapter, buffer);
830 GST_OBJECT_UNLOCK (typefind);
832 res = gst_type_find_element_chain_do_typefinding (typefind, TRUE);
834 if (typefind->mode == MODE_ERROR)
835 res = GST_FLOW_ERROR;
840 g_assert_not_reached ();
841 return GST_FLOW_ERROR;
848 gst_type_find_element_chain_do_typefinding (GstTypeFindElement * typefind,
849 gboolean check_avail)
851 GstTypeFindProbability probability;
855 gboolean have_min, have_max;
857 GST_OBJECT_LOCK (typefind);
858 avail = gst_adapter_available (typefind->adapter);
861 have_min = avail >= TYPE_FIND_MIN_SIZE;
862 have_max = avail >= TYPE_FIND_MAX_SIZE;
869 goto not_enough_data;
871 /* map all available data */
872 data = gst_adapter_map (typefind->adapter, avail);
873 caps = gst_type_find_helper_for_data (GST_OBJECT (typefind),
874 data, avail, &probability);
875 gst_adapter_unmap (typefind->adapter);
877 if (caps == NULL && have_max)
879 else if (caps == NULL)
883 if (probability < typefind->min_probability)
884 goto low_probability;
885 GST_OBJECT_UNLOCK (typefind);
887 /* probability is good enough too, so let's make it known ... emiting this
888 * signal calls our object handler which sets the caps. */
889 g_signal_emit (typefind, gst_type_find_element_signals[HAVE_TYPE], 0,
892 /* .. and send out the accumulated data */
893 stop_typefinding (typefind);
894 gst_caps_unref (caps);
900 GST_DEBUG_OBJECT (typefind, "not enough data for typefinding yet "
901 "(%" G_GSIZE_FORMAT " bytes)", avail);
902 GST_OBJECT_UNLOCK (typefind);
907 GST_OBJECT_UNLOCK (typefind);
908 GST_ELEMENT_ERROR (typefind, STREAM, TYPE_NOT_FOUND, (NULL), (NULL));
909 stop_typefinding (typefind);
910 return GST_FLOW_ERROR;
914 GST_DEBUG_OBJECT (typefind,
915 "no caps found with %" G_GSIZE_FORMAT " bytes of data, "
916 "waiting for more data", avail);
917 GST_OBJECT_UNLOCK (typefind);
922 GST_DEBUG_OBJECT (typefind, "found caps %" GST_PTR_FORMAT ", but "
923 "probability is %u which is lower than the required minimum of %u",
924 caps, probability, typefind->min_probability);
926 gst_caps_unref (caps);
931 GST_OBJECT_UNLOCK (typefind);
932 GST_DEBUG_OBJECT (typefind, "waiting for more data to try again");
938 gst_type_find_element_getrange (GstPad * srcpad, GstObject * parent,
939 guint64 offset, guint length, GstBuffer ** buffer)
941 GstTypeFindElement *typefind;
944 typefind = GST_TYPE_FIND_ELEMENT (parent);
946 ret = gst_pad_pull_range (typefind->sink, offset, length, buffer);
952 gst_type_find_element_activate_src_mode (GstPad * pad, GstObject * parent,
953 GstPadMode mode, gboolean active)
956 GstTypeFindElement *typefind;
958 typefind = GST_TYPE_FIND_ELEMENT (parent);
961 case GST_PAD_MODE_PULL:
962 res = gst_pad_activate_mode (typefind->sink, mode, active);
963 if (typefind->caps) {
965 GST_OBJECT_LOCK (typefind);
966 caps = gst_caps_ref (typefind->caps);
967 GST_OBJECT_UNLOCK (typefind);
968 gst_pad_push_event (typefind->src, gst_event_new_caps (caps));
969 gst_caps_unref (caps);
980 gst_type_find_element_loop (GstPad * pad)
982 GstTypeFindElement *typefind;
983 GstFlowReturn ret = GST_FLOW_OK;
985 typefind = GST_TYPE_FIND_ELEMENT (GST_PAD_PARENT (pad));
987 if (typefind->mode == MODE_TYPEFIND) {
989 GstCaps *found_caps = NULL;
990 GstTypeFindProbability probability = GST_TYPE_FIND_NONE;
992 GST_DEBUG_OBJECT (typefind, "find type in pull mode");
994 peer = gst_pad_get_peer (pad);
999 if (!gst_pad_query_duration (peer, GST_FORMAT_BYTES, &size)) {
1000 GST_WARNING_OBJECT (typefind, "Could not query upstream length!");
1001 gst_object_unref (peer);
1003 ret = GST_FLOW_ERROR;
1007 /* the size if 0, we cannot continue */
1009 /* keep message in sync with message in sink event handler */
1010 GST_ELEMENT_ERROR (typefind, STREAM, TYPE_NOT_FOUND,
1011 (_("Stream contains no data.")), ("Can't typefind empty stream"));
1012 gst_object_unref (peer);
1013 ret = GST_FLOW_ERROR;
1016 ext = gst_type_find_get_extension (typefind, pad);
1019 gst_type_find_helper_get_range (GST_OBJECT_CAST (peer),
1020 GST_OBJECT_PARENT (peer),
1021 (GstTypeFindHelperGetRangeFunction) (GST_PAD_GETRANGEFUNC (peer)),
1022 (guint64) size, ext, &probability);
1025 GST_DEBUG ("Found caps %" GST_PTR_FORMAT, found_caps);
1027 gst_object_unref (peer);
1030 if (!found_caps || probability < typefind->min_probability) {
1031 GST_DEBUG ("Trying to guess using extension");
1033 gst_type_find_guess_by_extension (typefind, pad, &probability);
1036 if (!found_caps || probability < typefind->min_probability) {
1037 GST_ELEMENT_ERROR (typefind, STREAM, TYPE_NOT_FOUND, (NULL), (NULL));
1038 gst_caps_replace (&found_caps, NULL);
1039 ret = GST_FLOW_ERROR;
1043 GST_DEBUG ("Emiting found caps %" GST_PTR_FORMAT, found_caps);
1044 g_signal_emit (typefind, gst_type_find_element_signals[HAVE_TYPE],
1045 0, probability, found_caps);
1046 typefind->mode = MODE_NORMAL;
1047 } else if (typefind->mode == MODE_NORMAL) {
1050 if (typefind->need_segment) {
1051 typefind->need_segment = FALSE;
1052 gst_pad_push_event (typefind->src,
1053 gst_event_new_segment (&typefind->segment));
1056 /* Pull 4k blocks and send downstream */
1057 ret = gst_pad_pull_range (typefind->sink, typefind->offset, 4096, &outbuf);
1058 if (ret != GST_FLOW_OK)
1061 typefind->offset += 4096;
1063 ret = gst_pad_push (typefind->src, outbuf);
1064 if (ret != GST_FLOW_OK)
1068 ret = GST_FLOW_ERROR;
1076 const gchar *reason = gst_flow_get_name (ret);
1077 gboolean push_eos = FALSE;
1079 GST_LOG_OBJECT (typefind, "pausing task, reason %s", reason);
1080 gst_pad_pause_task (typefind->sink);
1082 if (ret == GST_FLOW_EOS) {
1083 /* perform EOS logic */
1085 if (typefind->segment.flags & GST_SEEK_FLAG_SEGMENT) {
1088 /* for segment playback we need to post when (in stream time)
1089 * we stopped, this is either stop (when set) or the duration. */
1090 if ((stop = typefind->segment.stop) == -1)
1091 stop = typefind->offset;
1093 GST_LOG_OBJECT (typefind, "Sending segment done, at end of segment");
1094 gst_element_post_message (GST_ELEMENT (typefind),
1095 gst_message_new_segment_done (GST_OBJECT (typefind),
1096 GST_FORMAT_BYTES, stop));
1100 } else if (ret == GST_FLOW_NOT_LINKED || ret < GST_FLOW_EOS) {
1101 /* for fatal errors we post an error message */
1102 GST_ELEMENT_ERROR (typefind, STREAM, FAILED, (NULL),
1103 ("stream stopped, reason %s", reason));
1107 /* send EOS, and prevent hanging if no streams yet */
1108 GST_LOG_OBJECT (typefind, "Sending EOS, at end of stream");
1109 gst_pad_push_event (typefind->src, gst_event_new_eos ());
1116 gst_type_find_element_activate_sink_mode (GstPad * pad, GstObject * parent,
1117 GstPadMode mode, gboolean active)
1119 GstTypeFindElement *typefind;
1121 typefind = GST_TYPE_FIND_ELEMENT (parent);
1124 case GST_PAD_MODE_PULL:
1126 gst_segment_init (&typefind->segment, GST_FORMAT_BYTES);
1127 typefind->need_segment = TRUE;
1128 typefind->offset = 0;
1129 gst_pad_start_task (pad, (GstTaskFunction) gst_type_find_element_loop,
1132 gst_pad_stop_task (pad);
1136 case GST_PAD_MODE_PUSH:
1138 start_typefinding (typefind);
1140 stop_typefinding (typefind);
1150 gst_type_find_element_activate_sink (GstPad * pad, GstObject * parent)
1152 GstTypeFindElement *typefind;
1155 GstCaps *found_caps = NULL;
1156 GstTypeFindProbability probability = GST_TYPE_FIND_NONE;
1158 typefind = GST_TYPE_FIND_ELEMENT (parent);
1160 /* if we have force caps, use those */
1161 GST_OBJECT_LOCK (typefind);
1162 if (typefind->force_caps) {
1163 found_caps = gst_caps_ref (typefind->force_caps);
1164 probability = GST_TYPE_FIND_MAXIMUM;
1165 GST_OBJECT_UNLOCK (typefind);
1167 GST_DEBUG ("Emiting found caps %" GST_PTR_FORMAT, found_caps);
1168 g_signal_emit (typefind, gst_type_find_element_signals[HAVE_TYPE],
1169 0, probability, found_caps);
1170 typefind->mode = MODE_NORMAL;
1173 GST_OBJECT_UNLOCK (typefind);
1175 query = gst_query_new_scheduling ();
1177 if (!gst_pad_peer_query (pad, query)) {
1178 gst_query_unref (query);
1182 pull_mode = gst_query_has_scheduling_mode (query, GST_PAD_MODE_PULL);
1183 gst_query_unref (query);
1188 if (!gst_pad_activate_mode (pad, GST_PAD_MODE_PULL, TRUE))
1195 return gst_pad_activate_mode (pad, GST_PAD_MODE_PUSH, TRUE);
1199 static GstStateChangeReturn
1200 gst_type_find_element_change_state (GstElement * element,
1201 GstStateChange transition)
1203 GstStateChangeReturn ret;
1204 GstTypeFindElement *typefind;
1206 typefind = GST_TYPE_FIND_ELEMENT (element);
1209 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
1211 switch (transition) {
1212 case GST_STATE_CHANGE_PAUSED_TO_READY:
1213 case GST_STATE_CHANGE_READY_TO_NULL:
1214 GST_OBJECT_LOCK (typefind);
1215 gst_caps_replace (&typefind->caps, NULL);
1217 g_list_foreach (typefind->cached_events,
1218 (GFunc) gst_mini_object_unref, NULL);
1219 g_list_free (typefind->cached_events);
1220 typefind->cached_events = NULL;
1221 typefind->mode = MODE_TYPEFIND;
1222 GST_OBJECT_UNLOCK (typefind);