sys/src/games/doom/s_sound.h

   1 // Emacs style mode select   -*- C++ -*-
   2 //-----------------------------------------------------------------------------
   3 //
   4 // $Id:$
   5 //
   6 // Copyright (C) 1993-1996 by id Software, Inc.
   7 //
   8 // This source is available for distribution and/or modification
   9 // only under the terms of the DOOM Source Code License as
  10 // published by id Software. All rights reserved.
  11 //
  12 // The source is distributed in the hope that it will be useful,
  13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // FITNESS FOR A PARTICULAR PURPOSE. See the DOOM Source Code License
  15 // for more details.
  16 //
  17 // DESCRIPTION:
  18 //      The not so system specific sound interface.
  19 //
  20 //-----------------------------------------------------------------------------
  21
  22
  23 #ifndef __S_SOUND__
  24 #define __S_SOUND__
  25
  26
  27 #ifdef __GNUG__
  28 #pragma interface
  29 #endif
  30
  31
  32
  33 //
  34 // Initializes sound stuff, including volume
  35 // Sets channels, SFX and music volume,
  36 //  allocates channel buffer, sets S_sfx lookup.
  37 //
  38 void
  39 S_Init
  40 ( int           sfxVolume,
  41   int           musicVolume );
  42
  43
  44
  45
  46 //
  47 // Per level startup code.
  48 // Kills playing sounds at start of level,
  49 //  determines music if any, changes music.
  50 //
  51 void S_Start(void);
  52
  53
  54 //
  55 // Start sound for thing at <origin>
  56 //  using <sound_id> from sounds.h
  57 //
  58 void
  59 S_StartSound
  60 ( void*         origin,
  61   int           sound_id );
  62
  63
  64
  65 // Will start a sound at a given volume.
  66 void
  67 S_StartSoundAtVolume
  68 ( void*         origin,
  69   int           sound_id,
  70   int           volume );
  71
  72
  73 // Stop sound for thing at <origin>
  74 void S_StopSound(void* origin);
  75
  76
  77 // Start music using <music_id> from sounds.h
  78 void S_StartMusic(int music_id);
  79
  80 // Start music using <music_id> from sounds.h,
  81 //  and set whether looping
  82 void
  83 S_ChangeMusic
  84 ( int           music_id,
  85   int           looping );
  86
  87 // Stops the music fer sure.
  88 void S_StopMusic(void);
  89
  90 // Stop and resume music, during game PAUSE.
  91 void S_PauseSound(void);
  92 void S_ResumeSound(void);
  93
  94
  95 //
  96 // Updates music & sounds
  97 //
  98 void S_UpdateSounds(void* listener);
  99
 100 void S_SetMusicVolume(int volume);
 101 void S_SetSfxVolume(int volume);
 102
 103
 104 #endif
 105 //-----------------------------------------------------------------------------
 106 //
 107 // $Log:$
 108 //
 109 //-----------------------------------------------------------------------------