From: Tim-Philipp Müller <tim@centricular.com>
Date: Fri, 14 Jul 2017 12:40:07 +0000 (+0100)
Subject: adder: document caps negotiation raciness and workaround
X-Git-Tag: 1.19.3~511^2~2183
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=cb5a2dcfbb7cce9f9ca77b60dd7cd557b1bd6cfd;p=platform%2Fupstream%2Fgstreamer.git

adder: document caps negotiation raciness and workaround

https://bugzilla.gnome.org/show_bug.cgi?id=777915
---

diff --git a/gst/adder/gstadder.c b/gst/adder/gstadder.c
index aa8848c..4eeb8ea 100644
--- a/gst/adder/gstadder.c
+++ b/gst/adder/gstadder.c
@@ -34,6 +34,12 @@
  * audio mixing element: It will sync input streams correctly and also handle
  * live inputs properly.
  *
+ * Caps negotiation is inherently racy with the adder element. You can set
+ * the "caps" property property to force adder to operate in a specific audio
+ * format, sample rate and channel count. In this case you may also need
+ * audioconvert and/or audioresample elements for each input stream before the
+ * adder element to make sure the input branch can produce the forced format.
+ *
  * ## Example launch line
  * |[
  * gst-launch-1.0 audiotestsrc freq=100 ! adder name=mix ! audioconvert ! autoaudiosink audiotestsrc freq=500 ! mix.