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 controls rolloff and stopband attenuation. The Hamming window provides a faster rolloff but a bit worse stopband attenuation, the other way around for the Blackman window.

This element has the advantage over the Chebyshev lowpass and highpass filter that it has 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.

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

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──GstBaseTransform
                    ╰──GstAudioFilter
                        ╰──GstAudioFXBaseFIRFilter
                            ╰──audiowsinclimit

Factory details

Authors: – Thomas Vander Stichele , Steven W. Smith, Dreamlab Technologies Ltd. , Sebastian Dröge

Classification: – Filter/Effect/Audio

Rank – none

Plugin – audiofx

Package – GStreamer Good Plug-ins

Pad Templates

sink

audio/x-raw:
         format: { F32LE, F64LE }
           rate: [ 1, 2147483647 ]
       channels: [ 1, 2147483647 ]
         layout: interleaved

Presence – always

Direction – sink

Object type – GstPad

src

audio/x-raw:
         format: { F32LE, F64LE }
           rate: [ 1, 2147483647 ]
       channels: [ 1, 2147483647 ]
         layout: interleaved

Presence – always

Direction – src

Object type – GstPad

Properties

cutoff 

“cutoff” gfloat

Cut-off Frequency (Hz)

Flags : Read / Write

Default value : 0

length 

“length” gint

Filter kernel length, will be rounded to the next odd number

Flags : Read / Write

Default value : 101

mode 

“mode” Audio-wsinc-limit-mode *

Low pass or high pass mode

Flags : Read / Write

Default value : low-pass (0)

window 

“window” Audio-wsinc-limit-window *

Window function to use

Flags : Read / Write

Default value : hamming (0)

Named constants

Audio-wsinc-limit-mode

Members

low-pass (0) – Low pass (default)
high-pass (1) – High pass

Audio-wsinc-limit-window

Members

hamming (0) – Hamming window (default)
blackman (1) – Blackman window
gaussian (2) – Gaussian window
cosine (3) – Cosine window
hann (4) – Hann window

The results of the search are