gst/audiotestsrc/gstaudiotestsrc.h

   1 /* GStreamer
   2  * Copyright (C) 2005 Stefan Kost <ensonic@users.sf.net>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 #ifndef __GST_AUDIO_TEST_SRC_H__
  21 #define __GST_AUDIO_TEST_SRC_H__
  22
  23
  24 #include <gst/gst.h>
  25 #include <gst/base/gstbasesrc.h>
  26
  27 G_BEGIN_DECLS
  28
  29
  30 #define GST_TYPE_AUDIO_TEST_SRC \
  31   (gst_audio_test_src_get_type())
  32 #define GST_AUDIO_TEST_SRC(obj) \
  33   (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_AUDIO_TEST_SRC,GstAudioTestSrc))
  34 #define GST_AUDIO_TEST_SRC_CLASS(klass) \
  35   (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_AUDIO_TEST_SRC,GstAudioTestSrcClass))
  36 #define GST_IS_AUDIO_TEST_SRC(obj) \
  37   (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_AUDIO_TEST_SRC))
  38 #define GST_IS_AUDIO_TEST_SRC_CLASS(klass) \
  39   (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_AUDIO_TEST_SRC))
  40
  41 /**
  42  * GstAudioTestSrcWave:
  43  * @GST_AUDIO_TEST_SRC_WAVE_SINE: a sine wave
  44  * @GST_AUDIO_TEST_SRC_WAVE_SQUARE: a square wave
  45  * @GST_AUDIO_TEST_SRC_WAVE_SAW: a saw wave
  46  * @GST_AUDIO_TEST_SRC_WAVE_TRIANGLE: a tringle wave
  47  * @GST_AUDIO_TEST_SRC_WAVE_SILENCE: silence
  48  * @GST_AUDIO_TEST_SRC_WAVE_WHITE_NOISE: white uniform noise
  49  * @GST_AUDIO_TEST_SRC_WAVE_PINK_NOISE: pink noise
  50  * @GST_AUDIO_TEST_SRC_WAVE_SINE_TAB: sine wave using a table
  51  * @GST_AUDIO_TEST_SRC_WAVE_TICKS: periodic ticks
  52  * @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.
  53  * @GST_AUDIO_TEST_SRC_WAVE_RED_NOISE: red (brownian) noise
  54  * @GST_AUDIO_TEST_SRC_WAVE_BLUE_NOISE: spectraly inverted pink noise
  55  * @GST_AUDIO_TEST_SRC_WAVE_VIOLET_NOISE: spectraly inverted red (brownian) noise
  56  *
  57  * Different types of supported sound waves.
  58  */
  59 typedef enum {
  60   GST_AUDIO_TEST_SRC_WAVE_SINE,
  61   GST_AUDIO_TEST_SRC_WAVE_SQUARE,
  62   GST_AUDIO_TEST_SRC_WAVE_SAW,
  63   GST_AUDIO_TEST_SRC_WAVE_TRIANGLE,
  64   GST_AUDIO_TEST_SRC_WAVE_SILENCE,
  65   GST_AUDIO_TEST_SRC_WAVE_WHITE_NOISE,
  66   GST_AUDIO_TEST_SRC_WAVE_PINK_NOISE,
  67   GST_AUDIO_TEST_SRC_WAVE_SINE_TAB,
  68   GST_AUDIO_TEST_SRC_WAVE_TICKS,
  69   GST_AUDIO_TEST_SRC_WAVE_GAUSSIAN_WHITE_NOISE,
  70   GST_AUDIO_TEST_SRC_WAVE_RED_NOISE,
  71   GST_AUDIO_TEST_SRC_WAVE_BLUE_NOISE,
  72   GST_AUDIO_TEST_SRC_WAVE_VIOLET_NOISE
  73 } GstAudioTestSrcWave;
  74
  75 #define PINK_MAX_RANDOM_ROWS   (30)
  76 #define PINK_RANDOM_BITS       (16)
  77 #define PINK_RANDOM_SHIFT      ((sizeof(long)*8)-PINK_RANDOM_BITS)
  78
  79 typedef struct {
  80   glong      rows[PINK_MAX_RANDOM_ROWS];
  81   glong      running_sum;   /* Used to optimize summing of generators. */
  82   gint       index;         /* Incremented each sample. */
  83   gint       index_mask;    /* Index wrapped by ANDing with this mask. */
  84   gdouble    scalar;        /* Used to scale within range of -1.0 to +1.0 */
  85 } GstPinkNoise;
  86
  87 typedef struct {
  88   gdouble    state;         /* noise state */
  89 } GstRedNoise;
  90
  91 typedef enum {
  92   GST_AUDIO_TEST_SRC_FORMAT_NONE = -1,
  93   GST_AUDIO_TEST_SRC_FORMAT_S16 = 0,
  94   GST_AUDIO_TEST_SRC_FORMAT_S32,
  95   GST_AUDIO_TEST_SRC_FORMAT_F32,
  96   GST_AUDIO_TEST_SRC_FORMAT_F64
  97 } GstAudioTestSrcFormat;
  98
  99 typedef struct _GstAudioTestSrc GstAudioTestSrc;
 100 typedef struct _GstAudioTestSrcClass GstAudioTestSrcClass;
 101
 102 typedef void (*ProcessFunc) (GstAudioTestSrc*, guint8 *);
 103
 104 /**
 105  * GstAudioTestSrc:
 106  *
 107  * audiotestsrc object structure.
 108  */
 109 struct _GstAudioTestSrc {
 110   GstBaseSrc parent;
 111
 112   ProcessFunc process;
 113
 114   /* parameters */
 115   GstAudioTestSrcWave wave;
 116   gdouble volume;
 117   gdouble freq;
 118
 119   /* audio parameters */
 120   gint channels;
 121   gint samplerate;
 122   gint samples_per_buffer;
 123   gint sample_size;
 124   GstAudioTestSrcFormat format;
 125
 126   /*< private >*/
 127   gboolean tags_pushed;                 /* send tags just once ? */
 128   GstClockTimeDiff timestamp_offset;    /* base offset */
 129   GstClockTime next_time;               /* next timestamp */
 130   gint64 next_sample;                   /* next sample to send */
 131   gint64 next_byte;                     /* next byte to send */
 132   gint64 sample_stop;
 133   gboolean check_seek_stop;
 134   gboolean eos_reached;
 135   gint generate_samples_per_buffer;     /* used to generate a partial buffer */
 136   gboolean can_activate_pull;
 137   gboolean reverse;                  /* play backwards */
 138
 139   /* waveform specific context data */
 140   GRand *gen;               /* random number generator */
 141   gdouble accumulator;                  /* phase angle */
 142   GstPinkNoise pink;
 143   GstRedNoise red;
 144   gdouble wave_table[1024];
 145 };
 146
 147 struct _GstAudioTestSrcClass {
 148   GstBaseSrcClass parent_class;
 149 };
 150
 151 GType gst_audio_test_src_get_type (void);
 152
 153 G_END_DECLS
 154
 155 #endif /* __GST_AUDIO_TEST_SRC_H__ */