diff options
author | Thibault Saunier <tsaunier@igalia.com> | 2018-10-22 11:39:24 +0200 |
---|---|---|
committer | Thibault Saunier <tsaunier@igalia.com> | 2019-05-13 10:24:40 -0400 |
commit | 0a6a62aa7652f0b5a689d4cecbc031b763c2000a (patch) | |
tree | b997ae369140d0711df167b672149cd1319a3cf0 /gst/audiofx | |
parent | 135e12565b5b79ea5d2d2f15b569060ce2c64b76 (diff) |
docs: Port all docstring to gtk-doc markdown
Diffstat (limited to 'gst/audiofx')
-rw-r--r-- | gst/audiofx/audioamplify.c | 6 | ||||
-rw-r--r-- | gst/audiofx/audiochebband.c | 12 | ||||
-rw-r--r-- | gst/audiofx/audiocheblimit.c | 12 | ||||
-rw-r--r-- | gst/audiofx/audiodynamic.c | 6 | ||||
-rw-r--r-- | gst/audiofx/audioecho.c | 6 | ||||
-rw-r--r-- | gst/audiofx/audiofirfilter.c | 10 | ||||
-rw-r--r-- | gst/audiofx/audioiirfilter.c | 10 | ||||
-rw-r--r-- | gst/audiofx/audioinvert.c | 6 | ||||
-rw-r--r-- | gst/audiofx/audiokaraoke.c | 6 | ||||
-rw-r--r-- | gst/audiofx/audiopanorama.c | 8 | ||||
-rw-r--r-- | gst/audiofx/audiowsincband.c | 6 | ||||
-rw-r--r-- | gst/audiofx/audiowsinclimit.c | 6 | ||||
-rw-r--r-- | gst/audiofx/gstscaletempo.c | 9 |
13 files changed, 49 insertions, 54 deletions
diff --git a/gst/audiofx/audioamplify.c b/gst/audiofx/audioamplify.c index 726ce0e3a..f96093a8f 100644 --- a/gst/audiofx/audioamplify.c +++ b/gst/audiofx/audioamplify.c @@ -21,18 +21,18 @@ /** * SECTION:element-audioamplify + * @title: audioamplify * * Amplifies an audio stream by a given factor and allows the selection of different clipping modes. * The difference between the clipping modes is best evaluated by testing. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc wave=saw ! audioamplify amplification=1.5 ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audioamplify amplification=1.5 clipping-method=wrap-negative ! alsasink * gst-launch-1.0 audiotestsrc wave=saw ! audioconvert ! audioamplify amplification=1.5 clipping-method=wrap-positive ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiochebband.c b/gst/audiofx/audiochebband.c index 78febe9e3..0751963ee 100644 --- a/gst/audiofx/audiochebband.c +++ b/gst/audiofx/audiochebband.c @@ -34,6 +34,7 @@ /** * SECTION:element-audiochebband + * @title: audiochebband * * Attenuates all frequencies outside (bandpass) or inside (bandreject) of a frequency * band. The number of poles and the ripple parameter control the rolloff. @@ -51,19 +52,16 @@ * * As a special case, a Chebyshev type 1 filter with no ripple is a Butterworth filter. * - * <note> - * Be warned that a too large number of poles can produce noise. The most poles are possible with - * a cutoff frequency at a quarter of the sampling rate. - * </note> + * > Be warned that a too large number of poles can produce noise. The most poles are possible with + * > a cutoff frequency at a quarter of the sampling rate. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc freq=1500 ! audioconvert ! audiochebband mode=band-pass lower-frequency=1000 upper-frequency=6000 poles=4 ! audioconvert ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiochebband mode=band-reject lower-frequency=1000 upper-frequency=4000 ripple=0.2 ! audioconvert ! alsasink * gst-launch-1.0 audiotestsrc wave=white-noise ! audioconvert ! audiochebband mode=band-pass lower-frequency=1000 upper-frequency=4000 type=2 ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiocheblimit.c b/gst/audiofx/audiocheblimit.c index e27888666..c02b62e5a 100644 --- a/gst/audiofx/audiocheblimit.c +++ b/gst/audiofx/audiocheblimit.c @@ -30,6 +30,7 @@ /** * SECTION:element-audiocheblimit + * @title: audiocheblimit * * Attenuates all frequencies above the cutoff frequency (low-pass) or all frequencies below the * cutoff frequency (high-pass). The number of poles and the ripple parameter control the rolloff. @@ -47,19 +48,16 @@ * * As a special case, a Chebyshev type 1 filter with no ripple is a Butterworth filter. * - * <note><para> - * Be warned that a too large number of poles can produce noise. The most poles are possible with - * a cutoff frequency at a quarter of the sampling rate. - * </para></note> + * > Be warned that a too large number of poles can produce noise. The most poles are possible with + * > a cutoff frequency at a quarter of the sampling rate. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc freq=1500 ! audioconvert ! audiocheblimit mode=low-pass cutoff=1000 poles=4 ! audioconvert ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiocheblimit mode=high-pass cutoff=400 ripple=0.2 ! audioconvert ! alsasink * gst-launch-1.0 audiotestsrc wave=white-noise ! audioconvert ! audiocheblimit mode=low-pass cutoff=800 type=2 ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiodynamic.c b/gst/audiofx/audiodynamic.c index 9b3a62c89..215577cb9 100644 --- a/gst/audiofx/audiodynamic.c +++ b/gst/audiofx/audiodynamic.c @@ -20,20 +20,20 @@ /** * SECTION:element-audiodynamic + * @title: audiodynamic * * This element can act as a compressor or expander. A compressor changes the * amplitude of all samples above a specific threshold with a specific ratio, * a expander does the same for all samples below a specific threshold. If * soft-knee mode is selected the ratio is applied smoothly. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc wave=saw ! audiodynamic characteristics=soft-knee mode=compressor threshold=0.5 ratio=0.5 ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiodynamic characteristics=hard-knee mode=expander threshold=0.2 ratio=4.0 ! alsasink * gst-launch-1.0 audiotestsrc wave=saw ! audioconvert ! audiodynamic ! audioconvert ! alsasink * ]| - * </refsect2> + * */ /* TODO: Implement attack and release parameters */ diff --git a/gst/audiofx/audioecho.c b/gst/audiofx/audioecho.c index c65bef1b7..948abf7ca 100644 --- a/gst/audiofx/audioecho.c +++ b/gst/audiofx/audioecho.c @@ -20,6 +20,7 @@ /** * SECTION:element-audioecho + * @title: audioecho * * audioecho adds an echo or (simple) reverb effect to an audio stream. The echo * delay, intensity and the percentage of feedback can be configured. @@ -38,14 +39,13 @@ * channels that are configured surround channels for the delay are * selected using the surround-channels mask property. * - * <refsect2> - * <title>Example launch lines</title> + * ## Example launch lines * |[ * gst-launch-1.0 autoaudiosrc ! audioconvert ! audioecho delay=500000000 intensity=0.6 feedback=0.4 ! audioconvert ! autoaudiosink * gst-launch-1.0 filesrc location="melo1.ogg" ! decodebin ! audioconvert ! audioecho delay=50000000 intensity=0.6 feedback=0.4 ! audioconvert ! autoaudiosink * gst-launch-1.0 audiotestsrc ! audioconvert ! audio/x-raw,channels=4 ! audioecho surround-delay=true delay=500000000 ! audioconvert ! autoaudiosink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiofirfilter.c b/gst/audiofx/audiofirfilter.c index 0ab32f375..1e3a2abaa 100644 --- a/gst/audiofx/audiofirfilter.c +++ b/gst/audiofx/audiofirfilter.c @@ -21,6 +21,7 @@ /** * SECTION:element-audiofirfilter + * @title: audiofirfilter * * audiofirfilter implements a generic audio <ulink url="http://en.wikipedia.org/wiki/Finite_impulse_response">FIR filter</ulink>. Before usage the * "kernel" property has to be set to the filter kernel that should be @@ -37,12 +38,11 @@ * "rate-changed" signal can be used. This should be done for most * FIR filters as they're depending on the sampling rate. * - * <refsect2> - * <title>Example application</title> - * <informalexample><programlisting language="C"> + * ## Example application + * <programlisting language="C"> * <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" parse="text" href="../../../../tests/examples/audiofx/firfilter-example.c" /> - * </programlisting></informalexample> - * </refsect2> + * ]| + * */ /* FIXME 0.11: suppress warnings for deprecated API such as GValueArray diff --git a/gst/audiofx/audioiirfilter.c b/gst/audiofx/audioiirfilter.c index eb4f20ce8..81b0bbca8 100644 --- a/gst/audiofx/audioiirfilter.c +++ b/gst/audiofx/audioiirfilter.c @@ -21,6 +21,7 @@ /** * SECTION:element-audioiirfilter + * @title: audioiirfilter * * audioiirfilter implements a generic audio <ulink url="http://en.wikipedia.org/wiki/Infinite_impulse_response">IIR filter</ulink>. Before usage the * "a" and "b" properties have to be set to the filter coefficients that @@ -33,12 +34,11 @@ * "rate-changed" signal can be used. This should be done for most * IIR filters as they're depending on the sampling rate. * - * <refsect2> - * <title>Example application</title> - * <informalexample><programlisting language="C"> + * ## Example application + * <programlisting language="C"> * <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" parse="text" href="../../../../tests/examples/audiofx/iirfilter-example.c" /> - * </programlisting></informalexample> - * </refsect2> + * ]| + * */ /* FIXME 0.11: suppress warnings for deprecated API such as GValueArray diff --git a/gst/audiofx/audioinvert.c b/gst/audiofx/audioinvert.c index a68dd1071..eeb3e784b 100644 --- a/gst/audiofx/audioinvert.c +++ b/gst/audiofx/audioinvert.c @@ -21,19 +21,19 @@ /** * SECTION:element-audioinvert + * @title: audioinvert * * Swaps upper and lower half of audio samples. Mixing an inverted sample on top of * the original with a slight delay can produce effects that sound like resonance. * Creating a stereo sample from a mono source, with one channel inverted produces wide-stereo sounds. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc wave=saw ! audioinvert degree=0.4 ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audioinvert degree=0.4 ! alsasink * gst-launch-1.0 audiotestsrc wave=saw ! audioconvert ! audioinvert degree=0.4 ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiokaraoke.c b/gst/audiofx/audiokaraoke.c index 76697ca17..0d0292603 100644 --- a/gst/audiofx/audiokaraoke.c +++ b/gst/audiofx/audiokaraoke.c @@ -20,16 +20,16 @@ /** * SECTION:element-audiokaraoke + * @title: audiokaraoke * * Remove the voice from audio by filtering the center channel. * This plugin is useful for karaoke applications. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 filesrc location=song.ogg ! oggdemux ! vorbisdec ! audiokaraoke ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiopanorama.c b/gst/audiofx/audiopanorama.c index b901464ae..fe1f2a1cf 100644 --- a/gst/audiofx/audiopanorama.c +++ b/gst/audiofx/audiopanorama.c @@ -21,19 +21,19 @@ /** * SECTION:element-audiopanorama + * @title: audiopanorama * * Stereo panorama effect with controllable pan position. One can choose between the default psychoacoustic panning method, * which keeps the same perceived loudness, and a simple panning method that just controls the volume on one channel. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc wave=saw ! audiopanorama panorama=-1.00 ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiopanorama panorama=-1.00 ! alsasink * gst-launch-1.0 audiotestsrc wave=saw ! audioconvert ! audiopanorama panorama=-1.00 ! audioconvert ! alsasink * gst-launch-1.0 audiotestsrc wave=saw ! audioconvert ! audiopanorama method=simple panorama=-0.50 ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H @@ -185,7 +185,7 @@ gst_audio_panorama_class_init (GstAudioPanoramaClass * klass) * * Panning method: psychoacoustic mode keeps the same perceived loudness, * while simple mode just controls the volume of one channel. It's merely - * a matter of taste which method should be chosen. + * a matter of taste which method should be chosen. */ g_object_class_install_property (gobject_class, PROP_METHOD, g_param_spec_enum ("method", "Panning method", diff --git a/gst/audiofx/audiowsincband.c b/gst/audiofx/audiowsincband.c index 3a66d410d..6159bb8cb 100644 --- a/gst/audiofx/audiowsincband.c +++ b/gst/audiofx/audiowsincband.c @@ -32,6 +32,7 @@ /** * SECTION:element-audiowsincband + * @title: audiowsincband * * Attenuates all frequencies outside (bandpass) or inside (bandreject) of a frequency * band. The length parameter controls the rolloff, the window parameter @@ -42,14 +43,13 @@ * a much better rolloff when using a larger kernel size and almost linear phase. The only * disadvantage is the much slower execution time with larger kernels. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc freq=1500 ! audioconvert ! audiowsincband mode=band-pass lower-frequency=3000 upper-frequency=10000 length=501 window=blackman ! audioconvert ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiowsincband mode=band-reject lower-frequency=59 upper-frequency=61 length=10001 window=hamming ! audioconvert ! alsasink * gst-launch-1.0 audiotestsrc wave=white-noise ! audioconvert ! audiowsincband mode=band-pass lower-frequency=1000 upper-frequency=2000 length=31 ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/audiowsinclimit.c b/gst/audiofx/audiowsinclimit.c index 38eb00717..54bb90332 100644 --- a/gst/audiofx/audiowsinclimit.c +++ b/gst/audiofx/audiowsinclimit.c @@ -32,6 +32,7 @@ /** * SECTION:element-audiowsinclimit + * @title: audiowsinclimit * * Attenuates all frequencies above the cutoff frequency (low-pass) or all frequencies below the * cutoff frequency (high-pass). The length parameter controls the rolloff, the window parameter @@ -42,14 +43,13 @@ * a much better rolloff when using a larger kernel size and almost linear phase. The only * disadvantage is the much slower execution time with larger kernels. * - * <refsect2> - * <title>Example launch line</title> + * ## Example launch line * |[ * gst-launch-1.0 audiotestsrc freq=1500 ! audioconvert ! audiowsinclimit mode=low-pass cutoff=1000 length=501 ! audioconvert ! alsasink * gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiowsinclimit mode=high-pass cutoff=15000 length=501 ! audioconvert ! alsasink * gst-launch-1.0 audiotestsrc wave=white-noise ! audioconvert ! audiowsinclimit mode=low-pass cutoff=1000 length=10001 window=blackman ! audioconvert ! alsasink * ]| - * </refsect2> + * */ #ifdef HAVE_CONFIG_H diff --git a/gst/audiofx/gstscaletempo.c b/gst/audiofx/gstscaletempo.c index 83ee8fe24..f83e8a51a 100644 --- a/gst/audiofx/gstscaletempo.c +++ b/gst/audiofx/gstscaletempo.c @@ -20,6 +20,7 @@ /** * SECTION:element-scaletempo + * @title: scaletempo * * Scale tempo while maintaining pitch * (WSOLA-like technique with cross correlation) @@ -27,9 +28,8 @@ * * Use Sceletempo to apply playback rates without the chipmunk effect. * - * <refsect2> - * <title>Example pipelines</title> - * <para> + * ## Example pipelines + * * |[ * filesrc location=media.ext ! decodebin name=d \ * d. ! queue ! audioconvert ! audioresample ! scaletempo ! audioconvert ! audioresample ! autoaudiosink \ @@ -54,8 +54,7 @@ * correlation (roughly a dot-product). Scaletempo consumes most of its CPU * cycles here. One can use the #GstScaletempo:search propery to tune how far * the algoritm looks. - * </para> - * </refsect2> + * */ /* |