audiotestsrc

## audiotestsrc audiotestsrc — Creates audio test signals of given frequency and volume |

## Synopsis

                        GstAudioTestSrc;
    enum                GstAudioTestSrcWave;

## Object Hierarchy

      GObject
       +----GstObject
             +----GstElement
                   +----GstBaseSrc
                         +----GstAudioTestSrc

## Properties

      "freq"                     gdouble               : Read / Write
      "is-live"                  gboolean              : Read / Write
      "samplesperbuffer"         gint                  : Read / Write
      "timestamp-offset"         gint64                : Read / Write
      "volume"                   gdouble               : Read / Write
      "wave"                     GstAudioTestSrcWave   : Read / Write
      "can-activate-pull"        gboolean              : Read / Write
      "can-activate-push"        gboolean              : Read / Write

## Description

AudioTestSrc can be used to generate basic audio signals. It support several different waveforms and allows to set the base frequency and volume.

### Example launch line

    gst-launch audiotestsrc ! audioconvert ! alsasink

This pipeline produces a sine with default frequency, 440 Hz, and the default volume, 0.8 (relative to a maximum 1.0).

    gst-launch audiotestsrc wave=2 freq=200 ! audioconvert ! tee name=t ! queue ! alsasink t. ! queue ! libvisual_lv_scope ! ffmpegcolorspace ! xvimagesink

In this example a saw wave is generated. The wave is shown using a scope visualizer from libvisual, allowing you to visually verify that the saw wave is correct.

## Synopsis

### Element Information

plugin | audiotestsrc
author | Stefan Kost <ensonic@users.sf.net>
class | Source/Audio

### Element Pads

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

## Synopsis

### Element Information

plugin | audiotestsrc
author | Stefan Kost <ensonic@users.sf.net>
class | Source/Audio

### Element Pads

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

## Details

### GstAudioTestSrc

    typedef struct _GstAudioTestSrc GstAudioTestSrc;

audiotestsrc object structure.

### enum GstAudioTestSrcWave

    typedef enum {
      GST_AUDIO_TEST_SRC_WAVE_SINE,
      GST_AUDIO_TEST_SRC_WAVE_SQUARE,
      GST_AUDIO_TEST_SRC_WAVE_SAW,
      GST_AUDIO_TEST_SRC_WAVE_TRIANGLE,
      GST_AUDIO_TEST_SRC_WAVE_SILENCE,
      GST_AUDIO_TEST_SRC_WAVE_WHITE_NOISE,
      GST_AUDIO_TEST_SRC_WAVE_PINK_NOISE,
      GST_AUDIO_TEST_SRC_WAVE_SINE_TAB,
      GST_AUDIO_TEST_SRC_WAVE_TICKS,
      GST_AUDIO_TEST_SRC_WAVE_GAUSSIAN_WHITE_NOISE
    } GstAudioTestSrcWave;

Different types of supported sound waves.

`GST_AUDIO_TEST_SRC_WAVE_SINE` | a sine wave
`GST_AUDIO_TEST_SRC_WAVE_SQUARE` | a square wave
`GST_AUDIO_TEST_SRC_WAVE_SAW` | a saw wave
`GST_AUDIO_TEST_SRC_WAVE_TRIANGLE` | a tringle wave
`GST_AUDIO_TEST_SRC_WAVE_SILENCE` | silence
`GST_AUDIO_TEST_SRC_WAVE_WHITE_NOISE` | white uniform noise
`GST_AUDIO_TEST_SRC_WAVE_PINK_NOISE` | pink noise
`GST_AUDIO_TEST_SRC_WAVE_SINE_TAB` | sine wave using a table
`GST_AUDIO_TEST_SRC_WAVE_TICKS` | periodic ticks
`GST_AUDIO_TEST_SRC_WAVE_GAUSSIAN_WHITE_NOISE` | white (zero mean) Gaussian noise; volume sets the standard deviation of the noise in units of the range of values of the sample type, e.g. volume=0.1 produces noise with a standard deviation of 0.1*32767=3277 with 16-bit integer samples, or 0.1*1.0=0.1 with floating-point samples.

## Property Details

### The `"freq"` property

      "freq"                     gdouble               : Read / Write

Frequency of test signal.

Allowed values: [0,20000]

Default value: 440

### The `"is-live"` property

      "is-live"                  gboolean              : Read / Write

Whether to act as a live source.

Default value: FALSE

### The `"samplesperbuffer"` property

      "samplesperbuffer"         gint                  : Read / Write

Number of samples in each outgoing buffer.

Allowed values: >= 1

Default value: 1024

### The `"timestamp-offset"` property

      "timestamp-offset"         gint64                : Read / Write

An offset added to timestamps set on buffers (in ns).

Default value: 0

### The `"volume"` property

      "volume"                   gdouble               : Read / Write

Volume of test signal.

Allowed values: [0,1]

Default value: 0.8

### The `"wave"` property

      "wave"                     GstAudioTestSrcWave   : Read / Write

Oscillator waveform.

Default value: Sine

### The `"can-activate-pull"` property

      "can-activate-pull"        gboolean              : Read / Write

Can activate in pull mode.

Default value: FALSE

### The `"can-activate-push"` property

      "can-activate-push"        gboolean              : Read / Write

Can activate in push mode.

Default value: TRUE