audiotestsrc

audiotestsrc

Properties

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

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstBaseSrc
                    ╰── GstAudioTestSrc

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

1
gst-launch-1.0 audiotestsrc ! audioconvert ! autoaudiosink

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

1
gst-launch-1.0 audiotestsrc wave=2 freq=200 ! tee name=t ! queue ! audioconvert ! autoaudiosink t. ! queue ! audioconvert ! libvisual_lv_scope ! videoconvert ! autovideosink

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, format=(string){ 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, S8, U8 }, layout=(string)interleaved, rate=(int)[ 1, 2147483647 ], channels=(int)[ 1, 2147483647 ]

Functions

Types and Values

struct GstAudioTestSrc

struct GstAudioTestSrc;

audiotestsrc object structure.


enum GstAudioTestSrcWave

Different types of supported sound waves.

Members

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.

 

GST_AUDIO_TEST_SRC_WAVE_RED_NOISE

red (brownian) noise

 

GST_AUDIO_TEST_SRC_WAVE_BLUE_NOISE

spectraly inverted pink noise

 

GST_AUDIO_TEST_SRC_WAVE_VIOLET_NOISE

spectraly inverted red (brownian) noise

 

Property Details

The “can-activate-pull” property

  “can-activate-pull”        gboolean

Can activate in pull mode.

Flags: Read / Write

Default value: FALSE


The “can-activate-push” property

  “can-activate-push”        gboolean

Can activate in push mode.

Flags: Read / Write

Default value: TRUE


The “freq” property

  “freq”                     gdouble

Frequency of test signal. The sample rate needs to be at least 4 times higher.

Flags: Read / Write

Allowed values: [0,5.36871e+08]

Default value: 440


The “is-live” property

  “is-live”                  gboolean

Whether to act as a live source.

Flags: Read / Write

Default value: FALSE


The “samplesperbuffer” property

  “samplesperbuffer”         gint

Number of samples in each outgoing buffer.

Flags: Read / Write

Allowed values: >= 1

Default value: 1024


The “timestamp-offset” property

  “timestamp-offset”         gint64

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

Flags: Read / Write

Default value: 0


The “volume” property

  “volume”                   gdouble

Volume of test signal.

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.8


The “wave” property

  “wave”                     GstAudioTestSrcWave

Oscillator waveform.

Flags: Read / Write

Default value: Sine