diff options
Diffstat (limited to 'gst/interleave')
| -rw-r--r-- | gst/interleave/deinterleave.c | 30 | ||||
| -rw-r--r-- | gst/interleave/interleave.c | 32 |
2 files changed, 24 insertions, 38 deletions
diff --git a/gst/interleave/deinterleave.c b/gst/interleave/deinterleave.c index 6f2b0cef..4c81d39d 100644 --- a/gst/interleave/deinterleave.c +++ b/gst/interleave/deinterleave.c @@ -32,35 +32,29 @@ /** * 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> */ diff --git a/gst/interleave/interleave.c b/gst/interleave/interleave.c index 76843e45..831e928f 100644 --- a/gst/interleave/interleave.c +++ b/gst/interleave/interleave.c @@ -30,38 +30,30 @@ /** * 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> */ |