audiodynamic

audiodynamic — Compressor and Expander

Synopsis

struct              GstAudioDynamic;

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GstObject
               +----GstElement
                     +----GstBaseTransform
                           +----GstAudioFilter
                                 +----GstAudioDynamic

Properties

  "characteristics"          GstAudioDynamicCharacteristics  : Read / Write
  "mode"                     GstAudioDynamicMode   : Read / Write
  "ratio"                    gfloat                : Read / Write
  "threshold"                gfloat                : Read / Write

Description

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.

Example launch line

1
2
3
gst-launch-1.0 audiotestsrc wave=saw ! audiodynamic characteristics=soft-knee mode=compressor threshold=0.5 rate=0.5 ! alsasink
gst-launch-1.0 filesrc location="melo1.ogg" ! oggdemux ! vorbisdec ! audioconvert ! audiodynamic characteristics=hard-knee mode=expander threshold=0.2 rate=4.0 ! alsasink
gst-launch-1.0 audiotestsrc wave=saw ! audioconvert ! audiodynamic ! audioconvert ! alsasink

Synopsis

Element Information

plugin

audiofx

author

Sebastian Dröge <slomo@circular-chaos.org>

class

Filter/Effect/Audio

Element Pads

name

sink

direction

sink

presence

always

details

audio/x-raw, format=(string){ S16LE, F32LE }, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], layout=(string){ interleaved, non-interleaved }

name

src

direction

source

presence

always

details

audio/x-raw, format=(string){ S16LE, F32LE }, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], layout=(string){ interleaved, non-interleaved }

Details

struct GstAudioDynamic

struct GstAudioDynamic;

Property Details

The "characteristics" property

  "characteristics"          GstAudioDynamicCharacteristics  : Read / Write

Selects whether the ratio should be applied smooth (soft-knee) or hard (hard-knee).

Default value: Hard Knee (default)


The "mode" property

  "mode"                     GstAudioDynamicMode   : Read / Write

Selects whether the filter should work on loud samples (compressor) orquiet samples (expander).

Default value: Compressor (default)


The "ratio" property

  "ratio"                    gfloat                : Read / Write

Ratio that should be applied.

Allowed values: >= 0

Default value: 1


The "threshold" property

  "threshold"                gfloat                : Read / Write

Threshold until the filter is activated.

Allowed values: [0,1]

Default value: 0