LIBS/FSOUND.H

   1 /*
   2   Упрощенное управление звуком для DOS4GW
   3   Версия 1.1
   4   (C) Алексей Волынсков, 1996
   5 */
   6
   7 #pragma library("fsound.lib")
   8
   9 #ifdef __cplusplus
  10 extern "C" {
  11 #endif
  12
  13 // частота таймера
  14 #define TIMER_FREQ 1193180L
  15
  16 // 1/f доля секунды в еденицах таймера (см. timer)
  17 // например: for(timer=0;timer<tlength(25);); // пауза на 1/25 секунды
  18 #define tlength(f) (TIMER_FREQ/f)
  19
  20 // тип драйвера
  21 enum{
  22   ST_NONE=-1,   // нет карты
  23   ST_DAC,       // побайтовый ЦАП
  24   ST_DMA        // DMA-карта
  25 };
  26
  27 // заголовок инструмента (DMI)
  28 typedef struct{
  29   unsigned long  len,    // длина в байтах
  30                  rate,   // частота в Герцах
  31                  lstart, // начало повтора в байтах от начала данных
  32                  llen;   // длина повтора в байтах
  33 }snd;
  34
  35 // установить драйвер n
  36 // (см. snddrv.h)
  37 void set_snd_drv(short n);
  38
  39 // проверить наличие звуковой карты
  40 // возвращает 0, если карты нет
  41 int S_detect(void);
  42
  43 // включить драйвер
  44 void S_init(void);
  45
  46 // выключить драйвер
  47 void S_done(void);
  48
  49 // проиграть звук s
  50 void S_play(snd *s);
  51
  52 // проиграть звук s длины l, повторяя c ls длиной ll
  53 void S_playraw(char *s,int l,int ls,int ll);
  54
  55 // остановить звук
  56 void S_stop(void);
  57
  58 // проигрывается ли звук?
  59 // возвращает 0, если нет
  60 int S_issound(void);
  61
  62 // загрузить звук из файла f (чистый 8-битовый звук)
  63 // и установить его частоту r (Гц), начало и длину повтора ls и ll
  64 // (если ll==0, то звук не повторяется)
  65 // (если ll==1, то звук повторяется полностью)
  66 snd *load_snd(char *f,unsigned r,unsigned ls,unsigned ll);
  67
  68 // загрузить звук из файла f (формат DMI)
  69 snd *load_dmi(char *f);
  70
  71 // включить драйвер таймера
  72 // обычно включается при вызове S_init()
  73 void T_init(void);
  74
  75 // выключить драйвер таймера
  76 // обычно выключается при вызове S_done()
  77 void T_done(void);
  78
  79 // порт, DMA, IRQ
  80 extern unsigned short snd_port,snd_dma,snd_irq;
  81
  82 // тип карты (см. выше)
  83 extern short snd_type;
  84
  85 // название карты
  86 extern char *snd_name;
  87
  88 // частота смешанного звука в Герцах
  89 extern unsigned short sfreq;
  90
  91 // таймер
  92 extern volatile int timer;
  93
  94 #ifdef __cplusplus
  95 }
  96 #endif