home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / PROG / SMIXW124.ZIP / SMIX.H < prev    next >
Encoding:
C/C++ Source or Header  |  1995-10-26  |  4.9 KB  |  102 lines
  1. /*      SMIXW is Copyright 1995 by Ethan Brodsky.  All rights reserved      */
  2.  
  3. /* ██ SMIX.H ██████████████████████████████████████████████████████████████ */
  4.  
  5. #define TRUE  1
  6. #define FALSE 0
  7.  
  8. #define ON  1
  9. #define OFF 0
  10.  
  11. typedef struct
  12.   {
  13.     signed   char *soundptr;
  14.     unsigned long soundsize;
  15.   } SOUND;
  16.  
  17. int  init_sb(int baseio, int irq, int dma, int dma16);
  18.   /* Initializes control parameters, resets DSP and installs int. handler   */
  19.   /*  Parameters:                                                           */
  20.   /*   baseio    Sound card base IO address                                 */
  21.   /*   irq       Sound card IRQ setting                                     */
  22.   /*   dma       Sound card 8-bit DMA channel                               */
  23.   /*   dma16     Sound card 16-bit DMA channel                              */
  24.   /*  Returns:                                                              */
  25.   /*   TRUE      Sound card successfully initialized                        */
  26.   /*   FALSE     Sound card could not be initialized                        */
  27.  
  28. void shutdown_sb(void);
  29.   /* Removes interrupt handler and resets DSP                               */
  30.  
  31.  
  32. void init_mixing(void);
  33.   /* Allocates internal buffers and starts digitized sound output           */
  34.  
  35. void shutdown_mixing(void);
  36.   /* Deallocates internal buffers and stops digitized sound output          */
  37.  
  38.  
  39. void open_sound_resource_file(char *filename);
  40.   /* Opens a resource file for loading sounds.  After this has been called, */
  41.   /* the Key parameter in the LoadSound function is used as a resource key  */
  42.   /* to locate the sound data in this file.                                 */
  43.   /*  Parameters:                                                           */
  44.   /*   FileName: File name of resource file                                 */
  45.  
  46. void close_sound_resource_file(void);
  47.   /* Close sound resource file.  If you have called this, the Key parameter */
  48.   /* to the LoadSound function will act as a filename instead of a resource */
  49.   /* key.                                                                   */
  50.  
  51.  
  52. void load_sound(SOUND **sound, char *key);
  53.   /* Allocates an memory buffer and loads a sound from a file               */
  54.   /*  Parameters:                                                           */
  55.   /*   sound     Pointer to pointer to unallocated sound data structure     */
  56.   /*   key       If a resource file has been opened then key is a resource  */
  57.   /*             identifier.  Use the same ID as you used when adding the   */
  58.   /*             sound resource with SNDLIB.  If a resource file is not     */
  59.   /*             opened, then key is the filename from which to load the    */
  60.   /*             sound data.                                                */
  61.  
  62. void free_sound(SOUND **sound);
  63.   /* Frees sound data structure and extended memory block                   */
  64.   /*  Parameters:                                                           */
  65.   /*   sound     Pointer to pointer to allocated sound data structure       */
  66.  
  67.  
  68. void start_sound(SOUND *sound, int index, unsigned char volume, int loop);
  69.   /* Starts playing a sound                                                 */
  70.   /*  Parameters:                                                           */
  71.   /*   sound     Pointer to sound data structure                            */
  72.   /*   index     A number to keep track of the sound with (Used to stop it) */
  73.   /*   loop      Indicates whether sound should be continuously looped      */
  74.  
  75. void stop_sound(int index);
  76.   /* Stops playing a sound                                                  */
  77.   /*  Parameters:                                                           */
  78.   /*   index     Index of sound to stop (All with given index are stopped)  */
  79.  
  80. int  sound_playing(int index);
  81.   /* Checks if a sound is still playing                                     */
  82.   /*  Parameters:                                                           */
  83.   /*   index     Index used when the sound was started                      */
  84.   /*  Returns:                                                              */
  85.   /*   TRUE      At least one sound with the specified index is playing     */
  86.   /*   FALSE     No sounds with the specified index are playing             */
  87.  
  88. void set_sound_volume(unsigned char new_volume);
  89.   /* Sets overall sound volume                                              */
  90.   /*  Parameters:                                                           */
  91.   /*   new_volume  New overall sound volume (0-255)                         */
  92.  
  93. extern volatile long intcount;         /* Current count of sound interrupts */
  94. extern volatile int  voicecount;       /* Number of voices currently in use */
  95.  
  96. extern float dspversion;
  97. extern int   autoinit;
  98. extern int   sixteenbit;
  99.  
  100. /* ████████████████████████████████████████████████████████████████████████ */
  101.  
  102.