From b62583b216f04d8b03346897c11f8e239104dd59 Mon Sep 17 00:00:00 2001 From: Stefan Kost Date: Mon, 16 Jun 2008 07:30:34 +0000 Subject: [PATCH] Final round of doc updates. Original commit message from CVS: * gst/rtpmanager/gstrtpjitterbuffer.c: * gst/speed/gstspeed.c: * gst/speexresample/gstspeexresample.c: * gst/videosignal/gstvideoanalyse.c: * gst/videosignal/gstvideodetect.c: * gst/videosignal/gstvideomark.c: * sys/dvb/gstdvbsrc.c: * sys/oss4/oss4-mixer.c: * sys/oss4/oss4-sink.c: * sys/oss4/oss4-source.c: * sys/wininet/gstwininetsrc.c: Final round of doc updates. --- ChangeLog | 15 ++++++++++++++ gst/rtpmanager/gstrtpjitterbuffer.c | 3 ++- gst/speed/gstspeed.c | 15 +++++--------- gst/speexresample/gstspeexresample.c | 11 ++++------ gst/videosignal/gstvideoanalyse.c | 21 ++++++++----------- gst/videosignal/gstvideodetect.c | 40 +++++++++++++++--------------------- gst/videosignal/gstvideomark.c | 36 +++++++++++++++----------------- sys/dvb/gstdvbsrc.c | 24 ++++++++-------------- sys/oss4/oss4-mixer.c | 5 ++--- sys/oss4/oss4-sink.c | 22 +++++++------------- sys/oss4/oss4-source.c | 12 ++++------- sys/wininet/gstwininetsrc.c | 6 ++---- 12 files changed, 91 insertions(+), 119 deletions(-) diff --git a/ChangeLog b/ChangeLog index c2a6e46..209858a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,20 @@ 2008-06-16 Stefan Kost + * gst/rtpmanager/gstrtpjitterbuffer.c: + * gst/speed/gstspeed.c: + * gst/speexresample/gstspeexresample.c: + * gst/videosignal/gstvideoanalyse.c: + * gst/videosignal/gstvideodetect.c: + * gst/videosignal/gstvideomark.c: + * sys/dvb/gstdvbsrc.c: + * sys/oss4/oss4-mixer.c: + * sys/oss4/oss4-sink.c: + * sys/oss4/oss4-source.c: + * sys/wininet/gstwininetsrc.c: + Final round of doc updates. + +2008-06-16 Stefan Kost + * gst/deinterlace/gstdeinterlace.c: * gst/rtpmanager/gstrtpbin.c: * gst/rtpmanager/gstrtpclient.c: diff --git a/gst/rtpmanager/gstrtpjitterbuffer.c b/gst/rtpmanager/gstrtpjitterbuffer.c index 771684c..a4ec5b4 100644 --- a/gst/rtpmanager/gstrtpjitterbuffer.c +++ b/gst/rtpmanager/gstrtpjitterbuffer.c @@ -320,7 +320,8 @@ gst_rtp_jitter_buffer_class_init (GstRtpJitterBufferClass * klass) * GstRtpJitterBuffer::clear-pt-map: * @buffer: the object which received the signal * - * Invalidate the clock-rate as obtained with the ::request-pt-map signal. + * Invalidate the clock-rate as obtained with the + * #GstRtpJitterBuffer::request-pt-map signal. */ gst_rtp_jitter_buffer_signals[SIGNAL_CLEAR_PT_MAP] = g_signal_new ("clear-pt-map", G_TYPE_FROM_CLASS (klass), diff --git a/gst/speed/gstspeed.c b/gst/speed/gstspeed.c index be80418..feeede5 100644 --- a/gst/speed/gstspeed.c +++ b/gst/speed/gstspeed.c @@ -21,23 +21,18 @@ /** * SECTION:element-speed * - * - * * Plays an audio stream at a different speed. - * - * + * * Do not use this element. Either use the 'pitch' element, or do a seek with * a non-1.0 rate parameter, this will have the same effect as using the speed * element (but relies on the decoder/demuxer to handle this correctly, also * requires a fairly up-to-date gst-plugins-base, as of February 2007). - * + * + * * Example launch line - * - * + * |[ * gst-launch filesrc location=test.ogg ! decodebin ! audioconvert ! speed speed=1.5 ! audioconvert ! audioresample ! autoaudiosink - * - * Plays an .ogg file at 1.5x speed. - * + * ]| Plays an .ogg file at 1.5x speed. * * * Last reviewed on 2007-02-26 (0.10.4.1) diff --git a/gst/speexresample/gstspeexresample.c b/gst/speexresample/gstspeexresample.c index 77fb8e2..096c6b9 100644 --- a/gst/speexresample/gstspeexresample.c +++ b/gst/speexresample/gstspeexresample.c @@ -22,19 +22,16 @@ /** * SECTION:element-speexresample * - * * speexresample resamples raw audio buffers to different sample rates using * a configurable windowing function to enhance quality. + * + * * Example launch line - * - * + * |[ * gst-launch -v filesrc location=sine.ogg ! oggdemux ! vorbisdec ! audioconvert ! speexresample ! audio/x-raw-int, rate=8000 ! alsasink - * - * Decode an Ogg/Vorbis downsample to 8Khz and play sound through alsa. + * ]| Decode an Ogg/Vorbis downsample to 8Khz and play sound through alsa. * To create the Ogg/Vorbis file refer to the documentation of vorbisenc. - * * - * */ #ifdef HAVE_CONFIG_H diff --git a/gst/videosignal/gstvideoanalyse.c b/gst/videosignal/gstvideoanalyse.c index 5678c5e..ee84be3 100644 --- a/gst/videosignal/gstvideoanalyse.c +++ b/gst/videosignal/gstvideoanalyse.c @@ -20,11 +20,10 @@ /** * SECTION:element-videoanalyse * - * - * - * This plugin analyses every video frame and if the message property is #TRUE, posts an element - * message with video statistics called "GstVideoAnalyse". + * This plugin analyses every video frame and if the #GstVideoAnalyse:message + * property is #TRUE, posts an element message with video statistics called + * "GstVideoAnalyse". + * * The message's structure contains these fields: * * @@ -69,15 +68,13 @@ * the brightness variance of the frame. * * - * - * + * + * + * * Example launch line - * - * + * |[ * gst-launch -m videotestsrc ! videoanalyse ! ffmpegcolorspace ! ximagesink - * - * This pipeline emits messages to the console for each frame that has been analysed. - * + * ]| This pipeline emits messages to the console for each frame that has been analysed. * * * Last reviewed on 2007-05-30 (0.10.5) diff --git a/gst/videosignal/gstvideodetect.c b/gst/videosignal/gstvideodetect.c index 90293f6..7e3b865 100644 --- a/gst/videosignal/gstvideodetect.c +++ b/gst/videosignal/gstvideodetect.c @@ -19,29 +19,24 @@ /** * SECTION:element-videodetect + * @see_also: #GstVideoMark * - * - * - * This plugin detects ::pattern-count squares in the bottom left corner of - * the video frames. The squares have a width and height of respectively - * ::pattern-width and ::patern-height. Even squares must be black and odd - * squares must be white. - * - * - * When the pattern has been found, ::pattern-data-count squares after the - * pattern squares are read as a bitarray. White squares represent a 1 bit and - * black squares a 0 bit. The bitarray will will included in the element message - * that is posted (see below). - * - * + * This plugin detects #GstVideoDetect:pattern-count squares in the bottom left + * corner of the video frames. The squares have a width and height of + * respectively #GstVideoDetect:pattern-width and #GstVideoDetect:pattern-height. + * Even squares must be black and odd squares must be white. + * + * When the pattern has been found, #GstVideoDetect:pattern-data-count squares + * after the pattern squares are read as a bitarray. White squares represent a 1 + * bit and black squares a 0 bit. The bitarray will will included in the element + * message that is posted (see below). + * * After the pattern has been found and the data pattern has been read, an * element message called "GstVideoDetect" will * be posted on the bus. If the pattern is no longer found in the frame, the * same element message is posted with the have-pattern field set to #FALSE. - * The message is only posted if the message - * property is #TRUE. - * - * + * The message is only posted if the #GstVideoDetect:message property is #TRUE. + * * The message's structure contains these fields: * * @@ -89,13 +84,12 @@ * * * - * + * + * * Example launch line - * - * + * |[ * gst-launch videotestsrc ! videodetect ! ffmpegcolorspace ! ximagesink - * - * + * ]| * * * Last reviewed on 2007-05-30 (0.10.5) diff --git a/gst/videosignal/gstvideomark.c b/gst/videosignal/gstvideomark.c index 1ec7577..1cd4242 100644 --- a/gst/videosignal/gstvideomark.c +++ b/gst/videosignal/gstvideomark.c @@ -19,30 +19,26 @@ /** * SECTION:element-videomark + * @see_also: #GstVideoDetect * + * This plugin produces #GstVideoMark::pattern-count squares in the bottom left + * corner of the video frames. The squares have a width and height of + * respectively #GstVideoMark:pattern-width and #GstVideoMark:pattern-height. + * Even squares will be black and odd squares will be white. + * + * After writing the pattern, #GstVideoMark:pattern-data-count squares after the + * pattern squares are produced as the bitarray given in + * #GstVideoMark:pattern-data. 1 bits will produce white squares and 0 bits will + * produce black squares. + * + * The element can be enabled with the #GstVideoMark:enabled property. It is + * mostly used together with the #GstVideoDetect plugin. + * * - * - * This plugin produces ::pattern-count squares in the bottom left corner of - * the video frames. The squares have a width and height of respectively - * ::pattern-width and ::patern-height. Even squares will be black and odd - * squares will be white. - * - * - * After writing the pattern, ::pattern-data-count squares after the - * pattern squares are produced as the bitarray given in ::pattern-data. 1 bits - * will produce white squares and 0 bits will produce black squares. - * - * - * The element can be enabled with the ::enabled property. It is mostly used - * together with the videodetect plugin. - * * Example launch line - * - * + * |[ * gst-launch videotestsrc ! videomark ! ximagesink - * - * Add the default black/white squares at the bottom left of the video frames. - * + * ]| Add the default black/white squares at the bottom left of the video frames. * * * Last reviewed on 2007-06-01 (0.10.6) diff --git a/sys/dvb/gstdvbsrc.c b/sys/dvb/gstdvbsrc.c index 72a7db7..5176ab6 100644 --- a/sys/dvb/gstdvbsrc.c +++ b/sys/dvb/gstdvbsrc.c @@ -61,28 +61,20 @@ static GstElementDetails dvbsrc_details = { /** * SECTION:element-dvbsrc * - * * dvbsrc can be used to capture video from DVB cards, DVB-T, DVB-S or DVB-T. + * * Example launch line - * - * + * |[ * gst-launch dvbsrc modulation="QAM 64" trans-mode=8k bandwidth=8MHz frequency=514000000 code-rate-lp=AUTO code-rate-hp=2/3 guard=4 hierarchy=0 ! flutsdemux crc-check=false name=demux ! queue max-size-buffers=0 max-size-time=0 ! flumpeg2vdec ! xvimagesink sync=false demux. ! queue max-size-buffers=0 max-size-time=0 ! flump3dec ! alsasink sync=false - * - * This pipeline captures a full transport stream from dvb card 0 that is a DVB-T card at tuned frequency 514000000 with other parameters as seen in the + * ]| Captures a full transport stream from dvb card 0 that is a DVB-T card at tuned frequency 514000000 with other parameters as seen in the * pipeline and outputs the first tv program on the transport stream. The reason the sinks have to be set to have sync=false is due to bug #340482. - * - * - * + * |[ * gst-launch dvbsrc modulation="QAM 64" trans-mode=8k bandwidth=8 frequency=514000000 code-rate-lp=AUTO code-rate-hp=2/3 guard=4 hierarchy=0 pids=256:257 ! flutsdemux crc-check=false name=demux es-pids=256:257 ! queue max-size-buffers=0 max-size-time=0 ! flumpeg2vdec ! xvimagesink sync=false demux. ! queue max-size-buffers=0 max-size-time=0 ! flump3dec ! alsasink sync=false - * - * This pipeline captures a partial transport stream from dvb card 0 that is a DVB-T card for a program at tuned frequency 514000000 and pids of 256:257 with other parameters as seen in the pipeline and outputs the program with the pids 256 and 257. The reason the sinks have to be set to - * have sync=false is due to bug #340482. - * - * - * + * ]| Captures a partial transport stream from dvb card 0 that is a DVB-T card for a program at tuned frequency 514000000 and pids of 256:257 with other parameters as seen in the pipeline and outputs the program with the pids 256 and 257. The reason the sinks have to be set to + * have sync=false is due to bug #340482 (FIXME: wrong bug number?). + * |[ * gst-launch dvbsrc polarity="h" frequency=11302000 srate=27500 diseqc-src=0 pids=102:103 ! queue max-size-buffers=0 max-size-time=0 ! flumpeg2vdec ! xvimagesink sync=false demux. ! queue max-size-buffers=0 max-size-time=0 ! flump3dec ! alsasink sync=false - * - * This pipeline captures a partial transport stream from dvb card 0 that is a DVB-S card for a program at tuned frequency 11302000 Hz, symbol rate of 27500 kHz and pids of 256:257 and outputs the program with the pids 256 and 257. The reason the sinks have to be set to have sync=false is due to bug #340482. + * ]| Captures a partial transport stream from dvb card 0 that is a DVB-S card for a program at tuned frequency 11302000 Hz, symbol rate of 27500 kHz and pids of 256:257 and outputs the program with the pids 256 and 257. The reason the sinks have to be set to have sync=false is due to bug #340482. * * */ diff --git a/sys/oss4/oss4-mixer.c b/sys/oss4/oss4-mixer.c index e54ecfd..6baa893 100644 --- a/sys/oss4/oss4-mixer.c +++ b/sys/oss4/oss4-mixer.c @@ -20,13 +20,12 @@ /** * SECTION:element-oss4mixer * - * - * * This element lets you adjust sound input and output levels with the * Open Sound System (OSS) version 4. It supports the GstMixer interface, which * can be used to obtain a list of available mixer tracks. Set the mixer * element to READY state before using the GstMixer interface on it. - * + * + * * Example pipelines * * oss4mixer can't be used in a sensible way in gst-launch. diff --git a/sys/oss4/oss4-sink.c b/sys/oss4/oss4-sink.c index 45cc2c5..a909759 100644 --- a/sys/oss4/oss4-sink.c +++ b/sys/oss4/oss4-sink.c @@ -19,32 +19,24 @@ /** * SECTION:element-oss4sink * - * - * * This element lets you output sound using the Open Sound System (OSS) * version 4. - * - * + * * Note that you should almost always use generic audio conversion elements * like audioconvert and audioresample in front of an audiosink to make sure * your pipeline works under all circumstances (those conversion elements will * act in passthrough-mode if no conversion is necessary). - * + * + * * Example pipelines - * - * + * |[ * gst-launch -v audiotestsrc ! audioconvert ! volume volume=0.1 ! oss4sink - * - * will output a sine wave (continuous beep sound) to your sound card (with + * ]| will output a sine wave (continuous beep sound) to your sound card (with * a very low volume as precaution). - * - * - * + * |[ * gst-launch -v filesrc location=music.ogg ! decodebin ! audioconvert ! audioresample ! oss4sink - * - * will play an Ogg/Vorbis audio file and output it using the Open Sound System + * ]| will play an Ogg/Vorbis audio file and output it using the Open Sound System * version 4. - * * * * Since: 0.10.7 diff --git a/sys/oss4/oss4-source.c b/sys/oss4/oss4-source.c index fd934bd..78fba4a 100644 --- a/sys/oss4/oss4-source.c +++ b/sys/oss4/oss4-source.c @@ -20,20 +20,16 @@ /** * SECTION:element-oss4src * - * - * * This element lets you record sound using the Open Sound System (OSS) * version 4. - * + * + * * Example pipelines - * - * + * |[ * gst-launch -v oss4src ! queue ! audioconvert ! vorbisenc ! oggmux ! filesink location=mymusic.ogg - * - * will record sound from your sound card using OSS4 and encode it to an + * ]| will record sound from your sound card using OSS4 and encode it to an * Ogg/Vorbis file (this will only work if your mixer settings are right * and the right inputs areenabled etc.) - * * * * Since: 0.10.7 diff --git a/sys/wininet/gstwininetsrc.c b/sys/wininet/gstwininetsrc.c index ea194d3..4f6d484 100644 --- a/sys/wininet/gstwininetsrc.c +++ b/sys/wininet/gstwininetsrc.c @@ -22,11 +22,9 @@ * * * Example launch line - * - * + * |[ * gst-launch-0.10 -v wininetsrc location="http://71.83.57.210:9000" ! application/x-icy,metadata-interval=0 ! icydemux ! mad ! audioconvert ! directsoundsink - * - * + * ]| receive mp3 audio over http and play it back. * */ -- 2.7.4