# 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 <thomas at apestaart dot org>, Steven W. Smith, Dreamlab Technologies Ltd. <mathis.hofer@dreamlab.net>, Sebastian Dröge <sebastian.droege@collabora.co.uk></sebastian.droege@collabora.co.uk></mathis.hofer@dreamlab.net></thomas>

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