audioconvert

audioconvert — Convert audio to different formats

Properties

Types and Values

Object Hierarchy

    GObject
    ╰── GstObject
        ╰── GstElement
            ╰── GstBaseTransform
                ╰── GstAudioConvert

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 }

Functions

Types and Values

struct GstAudioConvert

struct GstAudioConvert;

The audioconvert object structure.


enum GstAudioConvertDithering

Set of available dithering methods when converting audio.

Members

DITHER_NONE

No dithering

 

DITHER_RPDF

Rectangular dithering

 

DITHER_TPDF

Triangular dithering (default)

 

DITHER_TPDF_HF

High frequency triangular dithering

 

enum GstAudioConvertNoiseShaping

Set of available noise shaping methods

Members

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

Selects between different dithering methods.

Flags: Read / Write

Default value: Triangular dithering (default)


The “noise-shaping” property

  “noise-shaping”            GstAudioConvertNoiseShaping

Selects between different noise shaping methods.

Flags: Read / Write

Default value: No noise shaping (default)