audioconvert

audioconvert — Convert audio to different formats

Synopsis

struct              GstAudioConvert;
enum                GstAudioConvertDithering;
enum                GstAudioConvertNoiseShaping;

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----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,format=S8,channels=2 ! 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, format=(string){ S8, U8, S16LE, S16BE, U16LE, U16BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S32LE, S32BE, U32LE, U32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, F32LE, F32BE, F64LE, F64BE }, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], layout=(string)interleaved

name

src

direction

source

presence

always

details

audio/x-raw, format=(string){ S8, U8, S16LE, S16BE, U16LE, U16BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S32LE, S32BE, U32LE, U32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, F32LE, F32BE, F64LE, F64BE }, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ], layout=(string)interleaved

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)