From: Mathieu Duponchelle <mathieu@centricular.com>
Date: Thu, 26 Oct 2017 16:05:31 +0000 (+0200)
Subject: audioconvert: document passing an empty mix-matrix
X-Git-Tag: 1.19.3~511^2~2091
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b0c184e189df5133913d2dc7d57de15010b65493;p=platform%2Fupstream%2Fgstreamer.git

audioconvert: document passing an empty mix-matrix
---

diff --git a/gst/audioconvert/gstaudioconvert.c b/gst/audioconvert/gstaudioconvert.c
index fa3d024..1f84917 100644
--- a/gst/audioconvert/gstaudioconvert.c
+++ b/gst/audioconvert/gstaudioconvert.c
@@ -75,6 +75,20 @@
  *
  * > If an empty mix matrix is specified, a (potentially truncated)
  * > identity matrix will be generated.
+ *
+ * ## Example empty matrix generation code
+ * |[
+ * GValue v = G_VALUE_INIT;
+ *
+ * g_value_init (&v2, GST_TYPE_ARRAY);
+ * g_object_set_property (G_OBJECT (audioconvert), "mix-matrix", &v);
+ * g_value_unset (&v);
+ * ]|
+ *
+ * ## Example empty matrix launch line
+ * |[
+ * gst-launch-1.0 -v audiotestsrc ! audio/x-raw,channels=8 ! audioconvert mix-matrix="<>" ! audio/x-raw,channels=16,channel-mask=\(bitmask\)0x0000000000000000 ! fakesink
+ * ]|
  */
 
 /*