source-engine/utils/hlfaceposer/snd_audio_source.h

125 lines
4.6 KiB
C
Raw Normal View History

2020-04-22 16:56:21 +00:00
//========= Copyright Valve Corporation, All rights reserved. ============//
//
// Purpose:
//
// $Workfile: $
// $Date: $
//
//-----------------------------------------------------------------------------
// $Log: $
//
// $NoKeywords: $
//=============================================================================//
#ifndef SND_AUDIO_SOURCE_H
#define SND_AUDIO_SOURCE_H
#pragma once
// 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;
typedef struct channel_s channel_t;
class CAudioSource;
class IAudioDevice
{
public:
// Add a virtual destructor to silence the clang warning.
// This is harmless but not important since the only derived class
// doesn't have a destructor.
virtual ~IAudioDevice() {}
virtual void MixBegin( void ) = 0;
virtual void Mix8Mono( channel_t *pChannel, char *pData, int outputOffset, int inputOffset, int rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0;
virtual void Mix8Stereo( channel_t *pChannel, char *pData, int outputOffset, int inputOffset, int rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0;
virtual void Mix16Mono( channel_t *pChannel, short *pData, int outputOffset, int inputOffset, int rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0;
virtual void Mix16Stereo( channel_t *pChannel, short *pData, int outputOffset, int inputOffset, int rateScaleFix, int outCount, int timecompress, bool forward = true ) = 0;
virtual int MaxSampleCount( void ) = 0;
};
//-----------------------------------------------------------------------------
// Purpose: This is an instance of an audio source.
// Mixers are attached to channels and reference an audio source.
// Mixers are specific to the sample format and source format.
// Mixers are never re-used, so they can track instance data like
// sample position, fractional sample, stream cache, faders, etc.
//-----------------------------------------------------------------------------
class CAudioMixer
{
public:
virtual ~CAudioMixer( void ) {}
// UNDONE: time compress
virtual bool MixDataToDevice( IAudioDevice *pDevice, channel_t *pChannel, int startSample, int sampleCount, int outputRate, bool forward = true ) = 0;
virtual void IncrementSamples( channel_t *pChannel, int startSample, int sampleCount,int outputRate, bool forward = true ) = 0;
virtual bool SkipSamples( channel_t *pChannel, int startSample, int sampleCount, int outputRate, bool forward = true ) = 0;
virtual CAudioSource *GetSource( void ) = 0;
virtual int GetSamplePosition( void ) = 0;
virtual int GetScrubPosition( void ) = 0;
virtual bool SetSamplePosition( int position, bool scrubbing = false ) = 0;
virtual void SetLoopPosition( int position ) = 0;
virtual int GetStartPosition( void ) = 0;
virtual bool GetActive( void ) = 0;
virtual void SetActive( bool active ) = 0;
virtual void SetModelIndex( int index ) = 0;
virtual int GetModelIndex( void ) const = 0;
virtual void SetDirection( bool forward ) = 0;
virtual bool GetDirection( void ) const = 0;
virtual void SetAutoDelete( bool autodelete ) = 0;
virtual bool GetAutoDelete( void ) const = 0;
virtual void SetVolume( float volume ) = 0;
virtual channel_t *GetChannel() = 0;
};
//-----------------------------------------------------------------------------
// Purpose: A source is an abstraction for a stream, cached file, or procedural
// source of audio.
//-----------------------------------------------------------------------------
class CSentence;
class CAudioSource
{
public:
CAudioSource( void );
virtual ~CAudioSource( void );
// Create an instance (mixer) of this audio source
virtual CAudioMixer *CreateMixer( void ) = 0;
virtual int GetOutputData( void **pData, int samplePosition, int sampleCount, bool forward = true ) = 0;
virtual int SampleRate( void ) = 0;
virtual int SampleSize( void ) = 0;
virtual int SampleCount( void ) = 0;
virtual float TrueSampleSize( void ) = 0;
virtual bool IsLooped( void ) = 0;
virtual bool IsStreaming( void ) = 0;
virtual float GetRunningLength( void ) = 0;
virtual int GetNumChannels() = 0;
virtual bool IsStereoWav( void ) = 0;
virtual CSentence *GetSentence( void ) { return NULL; };
};
extern CAudioSource *AudioSource_Create( const char *pName );
#endif // SND_AUDIO_SOURCE_H