rgvolume

rgvolume — Apply ReplayGain volume adjustment

Synopsis

                    GstRgVolume;

Description

This element applies volume changes to streams as lined out in the proposed ReplayGain standard. It interprets the ReplayGain meta data tags and carries out the adjustment (by using a volume element internally). The relevant tags are:

  • GST_TAG_TRACK_GAIN
  • GST_TAG_TRACK_PEAK
  • GST_TAG_ALBUM_GAIN
  • GST_TAG_ALBUM_PEAK
  • GST_TAG_REFERENCE_LEVEL

The information carried by these tags must have been calculated beforehand by performing the ReplayGain analysis. This is implemented by the rganalysis element.

The signal compression/limiting recommendations outlined in the proposed standard are not implemented by this element. This has to be handled by separate elements because applications might want to have additional filters between the volume adjustment and the limiting stage. A basic limiter is included with this plugin: The rglimiter element applies -6 dB hard limiting as mentioned in the ReplayGain standard.

Example launch line

gst-launch filesrc location=filename.ext ! decodebin ! audioconvert \
    ! rgvolume ! audioconvert ! audioresample ! alsasink
Playback of a file

Synopsis

Element Information

plugin

replaygain

author

René Stadler <mail@renestadler.de>

class

Filter/Effect/Audio

Element Pads

name

sink

direction

sink

presence

always

details

audio/x-raw-float, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int)1234, width=(int)32

audio/x-raw-int, channels=(int)[ 1, 2147483647 ], rate=(int)[ 1, 2147483647 ], endianness=(int)1234, width=(int)16, depth=(int)16, signed=(boolean)true

name

src

direction

source

presence

always

details

audio/x-raw-float, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int)1234, width=(int)32

audio/x-raw-int, channels=(int)[ 1, 2147483647 ], rate=(int)[ 1, 2147483647 ], endianness=(int)1234, width=(int)16, depth=(int)16, signed=(boolean)true

Details

GstRgVolume

typedef struct {
  GstBin bin;
} GstRgVolume;

Opaque data structure.

See Also

GstRgLimiter, GstRgAnalysis