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 #include <gst/audio/audio.h>
  28
  29 G_BEGIN_DECLS
  30
  31
  32 #define GST_TYPE_AUDIO_TEST_SRC \
  33   (gst_audio_test_src_get_type())
  34 #define GST_AUDIO_TEST_SRC(obj) \
  35   (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_AUDIO_TEST_SRC,GstAudioTestSrc))
  36 #define GST_AUDIO_TEST_SRC_CLASS(klass) \
  37   (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_AUDIO_TEST_SRC,GstAudioTestSrcClass))
  38 #define GST_IS_AUDIO_TEST_SRC(obj) \
  39   (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_AUDIO_TEST_SRC))
  40 #define GST_IS_AUDIO_TEST_SRC_CLASS(klass) \
  41   (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_AUDIO_TEST_SRC))
  42
  43 /**
  44  * GstAudioTestSrcWave:
  45  * @GST_AUDIO_TEST_SRC_WAVE_SINE: a sine wave
  46  * @GST_AUDIO_TEST_SRC_WAVE_SQUARE: a square wave
  47  * @GST_AUDIO_TEST_SRC_WAVE_SAW: a saw wave
  48  * @GST_AUDIO_TEST_SRC_WAVE_TRIANGLE: a tringle wave
  49  * @GST_AUDIO_TEST_SRC_WAVE_SILENCE: silence
  50  * @GST_AUDIO_TEST_SRC_WAVE_WHITE_NOISE: white uniform noise
  51  * @GST_AUDIO_TEST_SRC_WAVE_PINK_NOISE: pink noise
  52  * @GST_AUDIO_TEST_SRC_WAVE_SINE_TAB: sine wave using a table
  53  * @GST_AUDIO_TEST_SRC_WAVE_TICKS: periodic ticks
  54  * @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.
  55  * @GST_AUDIO_TEST_SRC_WAVE_RED_NOISE: red (brownian) noise
  56  * @GST_AUDIO_TEST_SRC_WAVE_BLUE_NOISE: spectraly inverted pink noise
  57  * @GST_AUDIO_TEST_SRC_WAVE_VIOLET_NOISE: spectraly inverted red (brownian) noise
  58  *
  59  * Different types of supported sound waves.
  60  */
  61 typedef enum {
  62   GST_AUDIO_TEST_SRC_WAVE_SINE,
  63   GST_AUDIO_TEST_SRC_WAVE_SQUARE,
  64   GST_AUDIO_TEST_SRC_WAVE_SAW,
  65   GST_AUDIO_TEST_SRC_WAVE_TRIANGLE,
  66   GST_AUDIO_TEST_SRC_WAVE_SILENCE,
  67   GST_AUDIO_TEST_SRC_WAVE_WHITE_NOISE,
  68   GST_AUDIO_TEST_SRC_WAVE_PINK_NOISE,
  69   GST_AUDIO_TEST_SRC_WAVE_SINE_TAB,
  70   GST_AUDIO_TEST_SRC_WAVE_TICKS,
  71   GST_AUDIO_TEST_SRC_WAVE_GAUSSIAN_WHITE_NOISE,
  72   GST_AUDIO_TEST_SRC_WAVE_RED_NOISE,
  73   GST_AUDIO_TEST_SRC_WAVE_BLUE_NOISE,
  74   GST_AUDIO_TEST_SRC_WAVE_VIOLET_NOISE
  75 } GstAudioTestSrcWave;
  76
  77 #define PINK_MAX_RANDOM_ROWS   (30)
  78 #define PINK_RANDOM_BITS       (16)
  79 #define PINK_RANDOM_SHIFT      ((sizeof(long)*8)-PINK_RANDOM_BITS)
  80
  81 typedef struct {
  82   glong      rows[PINK_MAX_RANDOM_ROWS];
  83   glong      running_sum;   /* Used to optimize summing of generators. */
  84   gint       index;         /* Incremented each sample. */
  85   gint       index_mask;    /* Index wrapped by ANDing with this mask. */
  86   gdouble    scalar;        /* Used to scale within range of -1.0 to +1.0 */
  87 } GstPinkNoise;
  88
  89 typedef struct {
  90   gdouble    state;         /* noise state */
  91 } GstRedNoise;
  92
  93 typedef struct _GstAudioTestSrc GstAudioTestSrc;
  94 typedef struct _GstAudioTestSrcClass GstAudioTestSrcClass;
  95
  96 typedef void (*ProcessFunc) (GstAudioTestSrc*, guint8 *);
  97
  98 /**
  99  * GstAudioTestSrc:
 100  *
 101  * audiotestsrc object structure.
 102  */
 103 struct _GstAudioTestSrc {
 104   GstBaseSrc parent;
 105
 106   ProcessFunc process;
 107
 108   /* parameters */
 109   GstAudioTestSrcWave wave;
 110   gdouble volume;
 111   gdouble freq;
 112
 113   /* audio parameters */
 114   GstAudioInfo info;
 115   gint samples_per_buffer;
 116
 117   /*< private >*/
 118   gboolean tags_pushed;                 /* send tags just once ? */
 119   GstClockTimeDiff timestamp_offset;    /* base offset */
 120   GstClockTime next_time;               /* next timestamp */
 121   gint64 next_sample;                   /* next sample to send */
 122   gint64 next_byte;                     /* next byte to send */
 123   gint64 sample_stop;
 124   gboolean check_seek_stop;
 125   gboolean eos_reached;
 126   gint generate_samples_per_buffer;     /* used to generate a partial buffer */
 127   gboolean can_activate_pull;
 128   gboolean reverse;                  /* play backwards */
 129
 130   /* waveform specific context data */
 131   GRand *gen;               /* random number generator */
 132   gdouble accumulator;                  /* phase angle */
 133   GstPinkNoise pink;
 134   GstRedNoise red;
 135   gdouble wave_table[1024];
 136 };
 137
 138 struct _GstAudioTestSrcClass {
 139   GstBaseSrcClass parent_class;
 140 };
 141
 142 GType gst_audio_test_src_get_type (void);
 143
 144 G_END_DECLS
 145
 146 #endif /* __GST_AUDIO_TEST_SRC_H__ */