ss_gen.h

   1 /*
   2
   3     PROGRAM_NAME PROGRAM_VERSION - PROGRAM_DESCRIPTION
   4
   5     Copyright (C) 2003 Angel Ortega <angel@triptico.com>
   6
   7     This program is free software; you can redistribute it and/or
   8     modify it under the terms of the GNU General Public License
   9     as published by the Free Software Foundation; either version 2
  10     of the License, or (at your option) any later version.
  11
  12     This program is distributed in the hope that it will be useful,
  13     but WITHOUT ANY WARRANTY; without even the implied warranty of
  14     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15     GNU General Public License for more details.
  16
  17     You should have received a copy of the GNU General Public License
  18     along with this program; if not, write to the Free Software
  19     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  20
  21     http://www.triptico.com
  22
  23 */
  24
  25 /*
  26
  27 generator modes:
  28
  29 GEN_MODE_PLAYING - Generator is generating sound after a call
  30         to generator_play(). If sound is not looped, jumps
  31         to GEN_MODE_STOPPED when the cursor reaches loop_end.
  32
  33 GEN_MODE_RELEASED - Generator is generating the sustain of a sound
  34         after a call to generator_release(). When the sustain
  35         ends, jumps to GEN_MODE_FREE.
  36
  37 GEN_MODE_STOPPED - Generator was playing a non-looped sound and the
  38         cursor got beyond loop_end. No sound is being generated.
  39         Waiting for a call to generator_release() to enter
  40         GEN_MODE_FREE immediately.
  41
  42 GEN_MODE_FREE - Generator is free to be used.
  43
  44 */
  45
  46 #define GEN_MODE_PLAYING        3
  47 #define GEN_MODE_RELEASED       2
  48 #define GEN_MODE_STOPPED        1
  49 #define GEN_MODE_FREE           0
  50
  51 struct generator
  52 {
  53         int mode;               /* GEN_MODE_* */
  54
  55         float * lwave;          /* left channel wave */
  56         float * rwave;          /* right channel wave */
  57         int size;               /* size in samples */
  58         double loop_start;      /* start of loop (-1, no loop) */
  59         double loop_end;        /* end of loop */
  60         double inc;             /* increment (frequency) */
  61         float lvol;             /* left volume */
  62         float rvol;             /* right volume */
  63
  64         double cursor;          /* offset of next sample */
  65
  66         int sustain;            /* number of samples to play after release */
  67         float dlvol;            /* delta of left volume (sustain) */
  68         float drvol;            /* delta of right volume (sustain) */
  69
  70         int portamento;         /* number of samples of portamento */
  71         double dest_inc;        /* final portamento inc */
  72         double dinc;            /* delta of inc */
  73 };
  74
  75
  76 int generator_play(struct generator * g, float * lwave, float * rwave,
  77         int size, double inc, int loop_start, int loop_end,
  78         float lvol, float rvol, int sustain);
  79
  80 int generator_release(struct generator * g);
  81
  82 void generator(struct generator * g, float * left, float * right);
  83
  84 int generator_portamento(struct generator * g, int portamento,
  85         double dest_inc);