home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / PROG / MK1_23.ZIP / MIDKIT.H < prev    next >
Encoding:
C/C++ Source or Header  |  1995-08-16  |  4.7 KB  |  136 lines
  1. #ifndef MIDKIT_H
  2. #define MIDKIT_H
  3. #include <stdio.h>
  4. #include "mtypes.h"
  5.  
  6. #ifdef __cplusplus
  7. extern "C" {
  8. #endif
  9.  
  10. // use these defines when checking for setero, or 16 bit sound.
  11. // look at midwav.c for an example....
  12. #define STEREO    1
  13. #define BITS16    2
  14.  
  15. // use these defines, when initiating the MID-KIT system
  16. // MK_Init variables...
  17. #define MK_AUTO 1
  18. #define MK_DIGI 2
  19. #define MK_MIDI 4
  20.  
  21.  
  22. // this is the structure, for a MID-KIT .MKI  ( Mid-Kit Instrument)
  23. typedef struct 
  24. {
  25.   char            ibk_header[4];         // a  general midi .ibk 
  26.   unsigned char   inst[129][16]; 
  27.   char            perc_header[4];        // the percsussion .ibk
  28.   unsigned char   perc[4][16]; 
  29. } mki_file;
  30.  
  31. // this structure is for .MKS files (Mid-Kit Song).
  32. typedef struct 
  33. { char   header[14];
  34.   char   track_header[30][8];
  35.   char   *track[30];
  36.   int    num_tracks;
  37.   long   delta_ticks;
  38. } mks_file;
  39.  
  40. // this is the structure for the digital samples, study it careflly.
  41. typedef struct GHOLD{
  42.         UBYTE kick;                     // =1 -> sample has to be restarted
  43.         UBYTE active;                   // =1 -> sample is playing
  44.         UWORD flags;                    // 16/8 bits looping/one-shot
  45.         WORD  handle;                   // identifies the sample
  46.         ULONG start;                    // start index
  47.         ULONG size;                     // samplesize
  48.         ULONG reppos;                   // loop start
  49.         ULONG repend;                   // loop end
  50.         ULONG frq;                      // current frequency
  51.         UBYTE vol;                      // current volume
  52.         UBYTE pan;                      // current panning position
  53.  
  54.         UWORD iter;                     // iteration variabele
  55.         ULONG current;                  // current index in the sample
  56.         ULONG increment;                // fixed-point increment value
  57.         void *lvoltab;                  // left volume table
  58.         void *rvoltab;                  // right volume table
  59. } GHOLD;
  60. // access this array, for changing the flag bits (defined in mtypes.h).
  61. // also controls the looping etc.  Depends on what flags are set for each
  62. // voice (0-31)
  63. extern GHOLD ghld[32];
  64.  
  65. extern UWORD mk_mixfreq;
  66. extern UWORD mk_dmabufsize;
  67. extern UWORD mk_mode;
  68. extern UBYTE mk_numchn;        // number of channels mid-kit is open at...
  69. extern BYTE midi_playing;      // variable set, when song is playing
  70. extern BYTE digi_playing;
  71. extern WORD MK_MusicVol;
  72. extern ULONG MK_Timer;         // updates every 72.8 timer per second
  73.                                // use it for timing in your games...
  74.  
  75. extern UWORD sb_int;           // interrupt vector that belongs to sb_irq
  76. extern UWORD sb_ver;           // DSP version number
  77. extern UWORD sb_port;          // sb base port
  78. extern UBYTE sb_irq;           // sb irq
  79. extern UBYTE sb_lodma;         // 8 bit dma channel (1.0/2.0/pro)
  80. extern UBYTE sb_hidma;         // 16 bit dma channel (16/16asp)
  81. extern UBYTE sb_dma;           // current dma channel
  82. extern UWORD fm_addr;          // current fm port
  83. extern UBYTE MK_AutoDetect;
  84. extern BYTE MK_fm_found;       // This variable is set, if found FM cap..
  85. extern BYTE MK_digi_found;     // This variable is set if found DIGITAL cap...
  86.  
  87.  
  88.  
  89. // Sample load routines
  90. WORD MK_SampleLoad(FILE *fp,ULONG size,ULONG reppos,ULONG repend,UWORD flags);
  91. void MK_SampleUnLoad(WORD handle);
  92.  
  93. BOOL MK_Init(UBYTE flag,int num_voices);
  94. void MK_Exit(void);
  95. void MK_PlayStart(void);
  96. void MK_PlayStop(void);
  97. void MK_Update(void);
  98. // timer routines
  99. void MK_StartTimer(void);
  100. void MK_StopTimer(void);
  101.  
  102. //  Wave play routines
  103. void MK_VoiceSetVolume(UBYTE voice,UBYTE ivol);
  104. void MK_VoiceSetFrequency(UBYTE voice,ULONG frq);
  105. void MK_VoiceSetPanning(UBYTE voice,ULONG pan);
  106. void MK_VoiceStop(UBYTE voice);
  107. BOOL MK_VoiceActive(UBYTE voice);
  108. void MK_VoicePlay(UBYTE voice,
  109.                   WORD handle,
  110.                   ULONG start,
  111.                   ULONG size,
  112.                   ULONG reppos,
  113.                   ULONG repend,
  114.                   UWORD flags);
  115.  
  116. void SL_Init(FILE *fp,UWORD infmt,UWORD outfmt);
  117. void SL_Load(void *buffer,ULONG length);
  118.  
  119. // mki, and mks routines
  120. int  MK_LoadMKI(mki_file *file2);
  121. int  MK_LoadMKS(char *name, mks_file *mks);
  122. void MK_PlayMKS(mks_file *mks, mki_file *mki);
  123. int  MK_SetMusicVol(WORD vol);
  124. int  MK_FreeMKS(mks_file *mks);
  125. void MK_StopMKS(void);
  126. void MK_UpdateTick(void);  
  127. void MK_UserHandler(void);                      // you must define this
  128.                                                 // function in yuor program.    
  129.                                                 // it's called every 72.8 time/s
  130.  
  131. #ifdef __cplusplus
  132. }
  133. #endif
  134. #endif
  135.  
  136.