/**
* SECTION:element-deinterleave
+ * @see_also: interleave
*
- * <refsect2>
- * <para>
* Splits one interleaved multichannel audio stream into many mono audio streams.
- * </para>
- * <para>
+ *
* This element handles all raw audio formats and supports changing the input caps as long as
* all downstream elements can handle the new caps and the number of channels and the channel
* positions stay the same. This restriction will be removed in later versions by adding or
* removing some source pads as required.
- * </para>
- * <para>
+ *
* In most cases a queue and an audioconvert element should be added after each source pad
* before further processing of the audio data.
- * </para>
+ *
+ * <refsect2>
* <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
* gst-launch-0.10 filesrc location=/path/to/file.mp3 ! decodebin ! audioconvert ! "audio/x-raw-int,channels=2 ! deinterleave name=d d.src0 ! queue ! audioconvert ! vorbisenc ! oggmux ! filesink location=channel1.ogg d.src1 ! queue ! audioconvert ! vorbisenc ! oggmux ! filesink location=channel2.ogg
- * </programlisting>
- * Decodes an MP3 file and encodes the left and right channel into separate Ogg Vorbis files.
- * </para>
- * <para>
- * <programlisting>
+ * ]| Decodes an MP3 file and encodes the left and right channel into separate
+ * Ogg Vorbis files.
+ * |[
* gst-launch-0.10 filesrc location=file.mp3 ! decodebin ! audioconvert ! "audio/x-raw-int,channels=2" ! deinterleave name=d interleave name=i ! audioconvert ! wavenc ! filesink location=test.wav d.src0 ! queue ! audioconvert ! i.sink1 d.src1 ! queue ! audioconvert ! i.sink0
- * </programlisting>
- * Decodes and deinterleaves a Stereo MP3 file into separate channels and then interleaves the channels
- * again to a WAV file with the channel with the channels exchanged.
- * </para>
+ * ]| Decodes and deinterleaves a Stereo MP3 file into separate channels and
+ * then interleaves the channels again to a WAV file with the channel with the
+ * channels exchanged.
* </refsect2>
*/
/**
* SECTION:element-interleave
+ * @see_also: deinterleave
*
- * <refsect2>
- * <para>
* Merges separate mono inputs into one interleaved stream.
- * </para>
- * <para>
+ *
* This element handles all raw floating point sample formats and all signed integer sample formats. The first
* caps on one of the sinkpads will set the caps of the output so usually an audioconvert element should be
* placed before every sinkpad of interleave.
- * </para>
- * <para>
+ *
* It's possible to change the number of channels while the pipeline is running by adding or removing
* some of the request pads but this will change the caps of the output buffers. Changing the input
* caps is _not_ supported yet.
- * </para>
- * <para>
+ *
* The channel number of every sinkpad in the out can be retrieved from the "channel" property of the pad.
- * </para>
+ *
+ * <refsect2>
* <title>Example launch line</title>
- * <para>
- * <programlisting>
+ * |[
* gst-launch-0.10 filesrc location=file.mp3 ! decodebin ! audioconvert ! "audio/x-raw-int,channels=2" ! deinterleave name=d interleave name=i ! audioconvert ! wavenc ! filesink location=test.wav d.src0 ! queue ! audioconvert ! i.sink1 d.src1 ! queue ! audioconvert ! i.sink0
- * </programlisting>
- * Decodes and deinterleaves a Stereo MP3 file into separate channels and then interleaves the channels
- * again to a WAV file with the channel with the channels exchanged.
- * </para>
- * <para>
- * <programlisting>
+ * ]| Decodes and deinterleaves a Stereo MP3 file into separate channels and
+ * then interleaves the channels again to a WAV file with the channel with the
+ * channels exchanged.
+ * |[
* gst-launch-0.10 interleave name=i ! audioconvert ! wavenc ! filesink location=file.wav filesrc location=file1.wav ! decodebin ! audioconvert ! "audio/x-raw-int,channels=1" ! queue ! i.sink0 filesrc location=file2.wav ! decodebin ! audioconvert ! "audio/x-raw-int,channels=1" ! queue ! i.sink1
- * </programlisting>
- * Interleaves two Mono WAV files to a single Stereo WAV file.
- * </para>
+ * ]| Interleaves two Mono WAV files to a single Stereo WAV file.
* </refsect2>
*/
projects / platform / upstream / gst-plugins-good.git / commitdiff