//===== Copyright © 1996-2005, Valve Corporation, All rights reserved. ======// // // Purpose: // // $Workfile: $ // $Date: $ // $NoKeywords: $ //===========================================================================// #ifndef SND_DEVICE_H #define SND_DEVICE_H #ifdef _WIN32 #pragma once #endif #include "tier0/platform.h" //----------------------------------------------------------------------------- // 4.28 fixed point stuff for real-time resampling //----------------------------------------------------------------------------- #define FIX_BITS 28 #define FIX_SCALE (1 << FIX_BITS) #define FIX_MASK ((1 << FIX_BITS)-1) #define FIX_FLOAT(a) ((int)((a) * FIX_SCALE)) #define FIX(a) (((int)(a)) << FIX_BITS) #define FIX_INTPART(a) (((int)(a)) >> FIX_BITS) #define FIX_FRACTION(a,b) (FIX(a)/(b)) #define FIX_FRACPART(a) ((a) & FIX_MASK) typedef unsigned int fixedint; //----------------------------------------------------------------------------- // sound rate defines //----------------------------------------------------------------------------- #define SOUND_DMA_SPEED 44100 // hardware playback rate #define SOUND_11k 11025 // 11khz sample rate #define SOUND_22k 22050 // 22khz sample rate #define SOUND_44k 44100 // 44khz sample rate #define SOUND_ALL_RATES 1 // mix all sample rates //----------------------------------------------------------------------------- // Information about the channel //----------------------------------------------------------------------------- struct channel_t { int leftvol; int rightvol; float pitch; }; //----------------------------------------------------------------------------- // The audio device is responsible for mixing //----------------------------------------------------------------------------- abstract_class IAudioDevice { public: // This initializes the sound hardware. true on success, false on failure virtual bool Init( void ) = 0; // This releases all sound hardware virtual void Shutdown( void ) = 0; // device parameters virtual const char *DeviceName( void ) const = 0; virtual int DeviceChannels( void ) const = 0; // 1 = mono, 2 = stereo virtual int DeviceSampleBits( void ) const = 0; // bits per sample (8 or 16) virtual int DeviceSampleBytes( void ) const = 0; // above / 8 virtual int DeviceSampleRate( void ) const = 0; // Actual DMA speed virtual int DeviceSampleCount( void ) const = 0; // Total samples in buffer // Called each time a new paint buffer is mixed (may be multiple times per frame) virtual void MixBegin( void ) = 0; // Main mixing routines virtual void Mix8Mono( channel_t *pChannel, char *pData, int outputOffset, int inputOffset, fixedint rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0; virtual void Mix8Stereo( channel_t *pChannel, char *pData, int outputOffset, int inputOffset, fixedint rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0; virtual void Mix16Mono( channel_t *pChannel, short *pData, int outputOffset, int inputOffset, fixedint rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0; virtual void Mix16Stereo( channel_t *pChannel, short *pData, int outputOffset, int inputOffset, fixedint rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0; // Size of the paint buffer in samples virtual int PaintBufferSampleCount( void ) const = 0; // Adds a mixer to be mixed virtual void AddSource( CAudioMixer *pSource ) = 0; // Stops all sounds virtual void StopSounds( void ) = 0; // Updates sound mixing virtual void Update( float time ) = 0; // Resets the device virtual void Flush( void ) = 0; virtual int FindSourceIndex( CAudioMixer *pSource ) = 0; virtual CAudioMixer *GetMixerForSource( CAudioSource *source ) = 0; virtual void FreeChannel( int channelIndex ) = 0; }; #endif // SND_DEVICE_H