Top |
GObject ╰── GInitiallyUnowned ╰── GstObject ╰── GstElement ╰── GstBaseTransform ╰── GstAudioFilter ╰── GstAudioDynamic
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.
1 2 3 |
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 |
plugin |
audiofx |
author |
Sebastian Dröge <slomo@circular-chaos.org> |
class |
Filter/Effect/Audio |
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 } |
“characteristics”
property “characteristics” GstAudioDynamicCharacteristics
Selects whether the ratio should be applied smooth (soft-knee) or hard (hard-knee).
Flags: Read / Write
Default value: Hard Knee (default)
“mode”
property “mode” GstAudioDynamicMode
Selects whether the filter should work on loud samples (compressor) orquiet samples (expander).
Flags: Read / Write
Default value: Compressor (default)
“ratio”
property“ratio” gfloat
Ratio that should be applied.
Flags: Read / Write
Allowed values: >= 0
Default value: 1
“threshold”
property“threshold” gfloat
Threshold until the filter is activated.
Flags: Read / Write
Allowed values: [0,1]
Default value: 0