mirror of
https://github.com/ZDoom/qzdoom-gpl.git
synced 2024-12-12 13:12:14 +00:00
d0b2c41270
the rest of the game is concerned, these sounds will never stop once they
have been started until they are explicitly stopped. If they are evicted
from their channels, the sound code will restart them as soon as possible.
This means that instead of this:
if (!S_IsActorPlayingSomething(actor, CHAN_WEAPON, -1))
{
S_Sound(actor, CHAN_WEAPON|CHAN_LOOP, soundid, 1, ATTN_NORM);
}
The following is now just as effective:
S_Sound(actor, CHAN_WEAPON|CHAN_LOOP, soundid, 1, ATTN_NORM);
There are also a couple of other ramifications presented by this change:
* The full state of the sound system (sans music) is now stored in save
games. Any sounds that were playing when you saved will still be
playing when you load. (Try saving while Korax is making a speech in
Hexen to hear it.)
* Using snd_reset will also preserve any playing sounds.
* Movie playback is disabled, probably forever. I did not want to
update the MovieDisable/ResumeSound stuff for the new eviction
tracking code. A properly updated movie player will use the VMR,
which doesn't need these functions, since it would pipe the sound
straight through the sound system like everything else, so I decided
to dump them now, which leaves the movie player in a totally unworkable
state.
June 26, 2008
- Changed S_Sound() to take the same floating point attenuation that the
internal S_StartSound() uses. Now ambient sounds can use the public
S_Sound() interface.
- Fixed: S_RelinkSound() compared the points of the channels against the
from actor's point, rather than checking the channels' mover.
- Changed Strife's animated doors so that their sounds originate from the
interior of the sector making them and not from the entire vertical height
of the map.
SVN r1055 (trunk)
130 lines
4.5 KiB
C++
130 lines
4.5 KiB
C++
/*
|
|
** i_sound.h
|
|
**
|
|
**---------------------------------------------------------------------------
|
|
** Copyright 1998-2006 Randy Heit
|
|
** All rights reserved.
|
|
**
|
|
** Redistribution and use in source and binary forms, with or without
|
|
** modification, are permitted provided that the following conditions
|
|
** are met:
|
|
**
|
|
** 1. Redistributions of source code must retain the above copyright
|
|
** notice, this list of conditions and the following disclaimer.
|
|
** 2. Redistributions in binary form must reproduce the above copyright
|
|
** notice, this list of conditions and the following disclaimer in the
|
|
** documentation and/or other materials provided with the distribution.
|
|
** 3. The name of the author may not be used to endorse or promote products
|
|
** derived from this software without specific prior written permission.
|
|
**
|
|
** THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
** IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
** OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
** IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
** INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
** NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
** THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
**---------------------------------------------------------------------------
|
|
**
|
|
*/
|
|
|
|
|
|
#ifndef __I_SOUND__
|
|
#define __I_SOUND__
|
|
|
|
#include "s_sound.h"
|
|
|
|
enum ECodecType
|
|
{
|
|
CODEC_Unknown,
|
|
CODEC_Vorbis,
|
|
};
|
|
|
|
class SoundStream
|
|
{
|
|
public:
|
|
virtual ~SoundStream ();
|
|
|
|
enum
|
|
{ // For CreateStream
|
|
Mono = 1,
|
|
Bits8 = 2,
|
|
Bits32 = 4,
|
|
Float = 8,
|
|
|
|
// For OpenStream
|
|
Loop = 16
|
|
};
|
|
|
|
virtual bool Play(bool looping, float volume) = 0;
|
|
virtual void Stop() = 0;
|
|
virtual void SetVolume(float volume) = 0;
|
|
virtual bool SetPaused(bool paused) = 0;
|
|
virtual unsigned int GetPosition() = 0;
|
|
virtual bool IsEnded() = 0;
|
|
virtual bool SetPosition(int pos);
|
|
virtual FString GetStats();
|
|
};
|
|
|
|
typedef bool (*SoundStreamCallback)(SoundStream *stream, void *buff, int len, void *userdata);
|
|
|
|
class SoundRenderer
|
|
{
|
|
public:
|
|
SoundRenderer ();
|
|
virtual ~SoundRenderer ();
|
|
|
|
virtual void SetSfxVolume (float volume) = 0;
|
|
virtual void SetMusicVolume (float volume) = 0;
|
|
virtual void LoadSound (sfxinfo_t *sfx) = 0; // load a sound from disk
|
|
virtual void UnloadSound (sfxinfo_t *sfx) = 0; // unloads a sound from memory
|
|
virtual unsigned int GetMSLength(sfxinfo_t *sfx) = 0; // Gets the length of a sound at its default frequency
|
|
virtual float GetOutputRate() = 0;
|
|
|
|
// Streaming sounds.
|
|
virtual SoundStream *CreateStream (SoundStreamCallback callback, int buffbytes, int flags, int samplerate, void *userdata) = 0;
|
|
virtual SoundStream *OpenStream (const char *filename, int flags, int offset, int length) = 0;
|
|
|
|
// Starts a sound.
|
|
virtual FSoundChan *StartSound (sfxinfo_t *sfx, float vol, int pitch, int chanflags, FSoundChan *reuse_chan) = 0;
|
|
virtual FSoundChan *StartSound3D (sfxinfo_t *sfx, float vol, float distscale, int pitch, int priority, float pos[3], float vel[3], sector_t *sector, int channum, int chanflags, FSoundChan *reuse_chan) = 0;
|
|
|
|
// Stops a sound channel.
|
|
virtual void StopSound (FSoundChan *chan) = 0;
|
|
|
|
// Returns position of sound on this channel, in samples.
|
|
virtual unsigned int GetPosition(FSoundChan *chan) = 0;
|
|
|
|
// Synchronizes following sound startups.
|
|
virtual void Sync (bool sync) = 0;
|
|
|
|
// Pauses or resumes all sound effect channels.
|
|
virtual void SetSfxPaused (bool paused) = 0;
|
|
|
|
// Pauses or resumes *every* channel, including environmental reverb.
|
|
virtual void SetInactive(bool inactive) = 0;
|
|
|
|
// Updates the volume, separation, and pitch of a sound channel.
|
|
virtual void UpdateSoundParams3D (FSoundChan *chan, float pos[3], float vel[3]) = 0;
|
|
|
|
virtual void UpdateListener () = 0;
|
|
virtual void UpdateSounds () = 0;
|
|
|
|
virtual bool IsValid () = 0;
|
|
virtual void PrintStatus () = 0;
|
|
virtual void PrintDriversList () = 0;
|
|
virtual FString GatherStats ();
|
|
virtual short *DecodeSample(int outlen, const void *coded, int sizebytes, ECodecType type);
|
|
|
|
virtual void DrawWaveDebug(int mode);
|
|
};
|
|
|
|
extern SoundRenderer *GSnd;
|
|
|
|
void I_InitSound ();
|
|
void I_ShutdownSound ();
|
|
|
|
#endif
|