# 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.

## 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

## Hierarchy

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstElement
                    ╰──GstBaseTransform
                        ╰──GstAudioFilter
                            ╰──audioamplify

## Factory details

Authors: – Sebastian Dröge <slomo></slomo>

Classification: – `Filter/Effect/Audio`

Rank – none

Plugin – audiofx

Package – GStreamer Good Plug-ins

## Pad Templates

### `sink`

    audio/x-raw:
             format: { S8, S16LE, S32LE, F32LE, F64LE }
               rate: [ 1, 2147483647 ]
           channels: [ 1, 2147483647 ]
             layout: { (string)interleaved, (string)non-interleaved }

Presence – always

Direction – sink

Object type – GstPad

### `src`

    audio/x-raw:
             format: { S8, S16LE, S32LE, F32LE, F64LE }
               rate: [ 1, 2147483647 ]
           channels: [ 1, 2147483647 ]
             layout: { (string)interleaved, (string)non-interleaved }

Presence – always

Direction – src

Object type – GstPad

## Properties

### amplification

    “amplification” gfloat

Factor of amplification

Flags : Read / Write

Default value : 1

### clipping-method

    “clipping-method” Audio-amplify-clipping-method *

Clipping method: clip mode set values higher than the maximum to the maximum. The wrap-negative mode pushes those values back from the opposite side, wrap-positive pushes them back from the same side.

Flags : Read / Write

Default value : clip (0)

## Named constants

### Audio-amplify-clipping-method

#### Members

`clip` (0) – Normal clipping (default)
`wrap-negative` (1) – Push overdriven values back from the opposite side
`wrap-positive` (2) – Push overdriven values back from the same side
`none` (3) – No clipping

The results of the search are