## audioconvert audioconvert — Convert audio to different formats |

## Synopsis

    struct              GstAudioConvert;
    enum                GstAudioConvertDithering;
    enum                GstAudioConvertNoiseShaping;

## Object Hierarchy

      GObject
       +----GstObject
             +----GstElement
                   +----GstBaseTransform
                         +----GstAudioConvert

## Properties

      "dithering"                GstAudioConvertDithering  : Read / Write
      "noise-shaping"            GstAudioConvertNoiseShaping  : Read / Write

## Description

Audioconvert converts raw audio buffers between various possible formats. It supports integer to float conversion, width/depth conversion, signedness and endianness conversion and channel transformations.

### Example launch line

    1
    gst-launch -v -m audiotestsrc ! audioconvert ! audio/x-raw-int,channels=2,width=8,depth=8 ! level ! fakesink silent=TRUE

This pipeline converts audio to 8-bit. The level element shows that the output levels still match the one for a sine wave.

    1
    gst-launch -v -m audiotestsrc ! audioconvert ! vorbisenc ! fakesink silent=TRUE

The vorbis encoder takes float audio data instead of the integer data generated by audiotestsrc.

Last reviewed on 2006-03-02 (0.10.4)

## Synopsis

### Element Information

plugin | audioconvert
author | Benjamin Otte <otte@gnome.org>
class | Filter/Converter/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, 4321 }, width=(int)64
| audio/x-raw-float, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)32
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)32, depth=(int)[ 1, 32 ], signed=(boolean){ true, false }
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)24, depth=(int)[ 1, 24 ], signed=(boolean){ true, false }
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)16, depth=(int)[ 1, 16 ], signed=(boolean){ true, false }
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)8, depth=(int)[ 1, 8 ], signed=(boolean){ true, false }

name | src
direction | source
presence | always
details | audio/x-raw-float, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)64
| audio/x-raw-float, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)32
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)32, depth=(int)[ 1, 32 ], signed=(boolean){ true, false }
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)24, depth=(int)[ 1, 24 ], signed=(boolean){ true, false }
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)16, depth=(int)[ 1, 16 ], signed=(boolean){ true, false }
| audio/x-raw-int, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], endianness=(int){ 1234, 4321 }, width=(int)8, depth=(int)[ 1, 8 ], signed=(boolean){ true, false }

## Details

### struct GstAudioConvert

    struct GstAudioConvert;

The audioconvert object structure.

### enum GstAudioConvertDithering

    typedef enum
    {
      DITHER_NONE = 0,
      DITHER_RPDF,
      DITHER_TPDF,
      DITHER_TPDF_HF
    } GstAudioConvertDithering;

Set of available dithering methods when converting audio.

`DITHER_NONE` | No dithering
`DITHER_RPDF` | Rectangular dithering
`DITHER_TPDF` | Triangular dithering (default)
`DITHER_TPDF_HF` | High frequency triangular dithering

### enum GstAudioConvertNoiseShaping

    typedef enum
    {
      NOISE_SHAPING_NONE = 0,
      NOISE_SHAPING_ERROR_FEEDBACK,
      NOISE_SHAPING_SIMPLE,
      NOISE_SHAPING_MEDIUM,
      NOISE_SHAPING_HIGH
    } GstAudioConvertNoiseShaping;

Set of available noise shaping methods

`NOISE_SHAPING_NONE` | No noise shaping (default)
`NOISE_SHAPING_ERROR_FEEDBACK` | Error feedback
`NOISE_SHAPING_SIMPLE` | Simple 2-pole noise shaping
`NOISE_SHAPING_MEDIUM` | Medium 5-pole noise shaping
`NOISE_SHAPING_HIGH` | High 8-pole noise shaping

## Property Details

### The `"dithering"` property

      "dithering"                GstAudioConvertDithering  : Read / Write

Selects between different dithering methods.

Default value: Triangular dithering (default)

### The `"noise-shaping"` property

      "noise-shaping"            GstAudioConvertNoiseShaping  : Read / Write

Selects between different noise shaping methods.

Default value: No noise shaping (default)