audioconvert

audioconvert — Convert audio to different formats

Synopsis




            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.

Some format conversion are not carried out in an optimal way right now. E.g. converting from double to float would cause a loss of precision.

Example launch line

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.

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)

Element Information

plugin audioconvert
author Benjamin Otte <in7y118@public.uni-hamburg.de>
class Filter/Converter/Audio

Element Pads

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

Details

GstAudioConvert

typedef struct _GstAudioConvert 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)