mirror of
https://github.com/ZDoom/qzdoom-gpl.git
synced 2024-12-12 13:12:14 +00:00
8d0c48bf81
- Removed movie volume from the sound menu and renamed some of the other options to give the MIDI device name more room to display itself. - Moved the midi device selection into the main sound menu. - Added FMOD as MIDI device -1, to replace the MIDI mapper. This is still the default device. By default, it uses exactly the same DLS instruments as the Microsoft GS Wavetable Synth. If you have another set DLS level 1 patch set you want to use, set the snd_midipatchfile cvar to specify where it should load the instruments from. - Changed the ProduceMIDI function to store its output into a TArray<BYTE>. An overloaded version wraps around it to continue to supply file-writing support for external Timidity++ usage. - Added an FMOD credits banner to comply with their non-commercial license. - Reimplemented the snd_buffersize cvar for the FMOD Ex sound system. Rather than a time in ms, this is now the length in samples of the DSP buffer. Also added the snd_buffercount cvar to offer complete control over the call to FMOD::System::setDSPBufferSize(). Note that with any snd_samplerate below about 44kHz, you will need to set snd_buffersize to avoid long latencies. - Reimplemented the snd_output cvar for the FMOD Ex sound system. - Changed snd_samplerate default to 0. This now means to use the default sample rate. - Made snd_output, snd_output_format, snd_speakermode, snd_resampler, and snd_hrtf available through the menu. - Split the HRTF effect selection into its own cvar: snd_hrtf. - Removed 96000 Hz option from the menu. It's still available through the cvar, if desired. - Fixed: If Windows sound init failed, retry with DirectSound. (Apparently, WASAPI doesn't work with more than two speakers and PCM-Float output at the same time.) - Fixed: Area sounds only played from the front speakers once you got within the 2D panning area. SVN r854 (trunk)
113 lines
4 KiB
C++
113 lines
4 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"
|
|
|
|
class SoundStream
|
|
{
|
|
public:
|
|
virtual ~SoundStream ();
|
|
|
|
enum
|
|
{ // For CreateStream
|
|
Mono = 1,
|
|
Bits8 = 2,
|
|
|
|
// For OpenStream
|
|
Loop = 4
|
|
};
|
|
|
|
virtual bool Play (bool looping, float volume, bool normalize) = 0;
|
|
virtual void Stop () = 0;
|
|
virtual void SetVolume (float volume) = 0;
|
|
virtual bool SetPaused (bool paused) = 0;
|
|
virtual unsigned int GetPosition () = 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
|
|
|
|
// 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) = 0;
|
|
virtual FSoundChan *StartSound3D (sfxinfo_t *sfx, float vol, float distscale, int pitch, int priority, float pos[3], float vel[3], int chanflags) = 0;
|
|
|
|
// Stops a sound channel.
|
|
virtual void StopSound (FSoundChan *chan) = 0;
|
|
|
|
// Pauses or resumes all sound effect channels.
|
|
virtual void SetSfxPaused (bool paused) = 0;
|
|
|
|
// Updates the volume, separation, and pitch of a sound channel.
|
|
virtual void UpdateSoundParams3D (FSoundChan *chan, float pos[3], float vel[3]) = 0;
|
|
|
|
// For use by I_PlayMovie
|
|
virtual void MovieDisableSound () = 0;
|
|
virtual void MovieResumeSound () = 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 void ResetEnvironment ();
|
|
};
|
|
|
|
extern SoundRenderer *GSnd;
|
|
|
|
void I_InitSound ();
|
|
void I_ShutdownSound ();
|
|
|
|
#endif
|